@timeax/digital-service-engine 0.0.6 → 0.0.8

package/dist/core/index.js

@@ -13,6 +13,7 @@ function normalise(input, opts = {}) {
   const excludes_for_buttons = toStringArrayMap(
     obj.excludes_for_buttons
   );
+  const notices = toNoticeArray(obj.notices);
   let filters = rawFilters.map((t) => coerceTag(t, constraints));
   const fields = rawFields.map((f) => coerceField(f, defRole));
   if (!filters.some((t) => t.id === "t:root")) {
@@ -28,6 +29,7 @@ function normalise(input, opts = {}) {
     ...fallbacks && (isNonEmpty(fallbacks.nodes) || isNonEmpty(fallbacks.global)) && {
       fallbacks
     },
+    ...notices.length > 0 && { notices },
     schema_version: typeof obj.schema_version === "string" ? obj.schema_version : "1.0"
   };
   propagateConstraints(out, constraints);
@@ -99,7 +101,7 @@ function coerceTag(src, flagKeys) {
   const id = str(src.id);
   const label = str(src.label);
   const bind_id = str(src.bind_id) || (id == "t:root" ? void 0 : "t:root");
-  const service_id = toNumberOrUndefined(src.service_id);
+  const service_id = toServiceIdOrUndefined(src.service_id);
   const includes = toStringArray(src.includes);
   const excludes = toStringArray(src.excludes);
   let constraints = void 0;
@@ -148,7 +150,8 @@ function coerceField(src, defRole) {
   const component = type === "custom" ? str(src.component) || void 0 : void 0;
   const meta = src.meta && typeof src.meta === "object" ? { ...src.meta } : void 0;
   const button = srcHasOptions ? true : src.button === true;
-  const field_service_id_raw = toNumberOrUndefined(src.service_id);
+  const validation = normalizeFieldValidation(src.validation);
+  const field_service_id_raw = toServiceIdOrUndefined(src.service_id);
   const field_service_id = button && pricing_role !== "utility" && field_service_id_raw !== void 0 ? field_service_id_raw : void 0;
   const field = {
     id,
@@ -163,6 +166,7 @@ function coerceField(src, defRole) {
     ...ui && { ui },
     ...defaults && { defaults },
     ...meta && { meta },
+    ...validation && { validation },
     ...button ? { button } : {},
     ...field_service_id !== void 0 && { service_id: field_service_id }
   };
@@ -172,7 +176,7 @@ function coerceOption(src, inheritRole) {
   if (!src || typeof src !== "object") src = {};
   const id = str(src.id);
   const label = str(src.label);
-  const service_id = toNumberOrUndefined(src.service_id);
+  const service_id = toServiceIdOrUndefined(src.service_id);
   const value = typeof src.value === "string" || typeof src.value === "number" ? src.value : void 0;
   const pricing_role = src.pricing_role === "utility" || src.pricing_role === "base" ? src.pricing_role : inheritRole;
   const meta = src.meta && typeof src.meta === "object" ? src.meta : void 0;
@@ -244,10 +248,20 @@ function toStringArray(v) {
   if (!Array.isArray(v)) return [];
   return v.map((x) => String(x)).filter((s) => !!s && s.trim().length > 0);
 }
-function toNumberOrUndefined(v) {
+function toNoticeArray(v) {
+  if (!Array.isArray(v)) return [];
+  return v.filter((item) => item && typeof item === "object").map((item) => cloneDeep(item));
+}
+function toServiceIdOrUndefined(v) {
   if (v === null || v === void 0) return void 0;
-  const n = Number(v);
-  return Number.isFinite(n) ? n : void 0;
+  if (typeof v === "number") {
+    return Number.isFinite(v) ? v : void 0;
+  }
+  if (typeof v === "string") {
+    const trimmed = v.trim();
+    return trimmed.length > 0 ? trimmed : void 0;
+  }
+  return void 0;
 }
 function str(v) {
   if (typeof v === "string" && v.trim().length > 0) return v.trim();
@@ -271,14 +285,49 @@ function toServiceIdArray(v) {
     (x) => x !== "" && x !== null && x !== void 0
   );
 }
+function normalizeFieldValidationRule(input) {
+  if (!input || typeof input !== "object") return void 0;
+  const v = input;
+  const op = v.op;
+  if (op !== "eq" && op !== "neq" && op !== "gt" && op !== "gte" && op !== "lt" && op !== "lte" && op !== "between" && op !== "in" && op !== "nin" && op !== "truthy" && op !== "falsy" && op !== "match") {
+    return void 0;
+  }
+  const valueBy = v.valueBy === "value" || v.valueBy === "length" || v.valueBy === "eval" ? v.valueBy : void 0;
+  const out = {
+    op,
+    ...valueBy ? { valueBy } : {}
+  };
+  if ("value" in v) out.value = v.value;
+  if (typeof v.min === "number" && Number.isFinite(v.min)) out.min = v.min;
+  if (typeof v.max === "number" && Number.isFinite(v.max)) out.max = v.max;
+  if (Array.isArray(v.values)) out.values = [...v.values];
+  if (typeof v.pattern === "string" && v.pattern.trim()) out.pattern = v.pattern;
+  if (typeof v.flags === "string") out.flags = v.flags;
+  if (typeof v.message === "string" && v.message.trim()) out.message = v.message;
+  if (valueBy === "eval" && typeof v.code === "string" && v.code.trim()) {
+    out.code = v.code;
+  }
+  return out;
+}
+function normalizeFieldValidation(input) {
+  if (Array.isArray(input)) {
+    const rules = input.map(normalizeFieldValidationRule).filter(Boolean);
+    return rules.length ? rules : void 0;
+  }
+  const one = normalizeFieldValidationRule(input);
+  return one ? [one] : void 0;
+}
 
 // src/core/validate/shared.ts
 function isFiniteNumber(v) {
   return typeof v === "number" && Number.isFinite(v);
 }
+function isServiceIdRef(v) {
+  return typeof v === "string" && v.trim().length > 0 || typeof v === "number" && Number.isFinite(v);
+}
 function hasAnyServiceOption(f) {
   var _a;
-  return ((_a = f.options) != null ? _a : []).some((o) => isFiniteNumber(o.service_id));
+  return ((_a = f.options) != null ? _a : []).some((o) => isServiceIdRef(o.service_id));
 }
 function getByPath(obj, path) {
   if (!path) return void 0;
@@ -624,7 +673,7 @@ function runVisibilityRulesOnce(v) {
     const utilityOptionIds = [];
     for (const f of visible) {
       for (const o of (_c = f.options) != null ? _c : []) {
-        if (!isFiniteNumber(o.service_id)) continue;
+        if (!isServiceIdRef(o.service_id)) continue;
         const role = (_e = (_d = o.pricing_role) != null ? _d : f.pricing_role) != null ? _e : "base";
         if (role === "base") hasBase = true;
         else if (role === "utility") {
@@ -1052,7 +1101,7 @@ function validateUtilityMarkers(v) {
     const optsArr = Array.isArray(f.options) ? f.options : [];
     for (const o of optsArr) {
       const role = (_b = (_a = o.pricing_role) != null ? _a : f.pricing_role) != null ? _b : "base";
-      const hasService = isFiniteNumber(o.service_id);
+      const hasService = isServiceIdRef(o.service_id);
       const util = (_c = o.meta) == null ? void 0 : _c.utility;
       if (role === "utility" && hasService) {
         v.errors.push({
@@ -1138,39 +1187,119 @@ function isMultiField(f) {
   return t === "multiselect" || t === "checkbox" || metaMulti;
 }
 
+// src/utils/util.ts
+function toFiniteNumber(v) {
+  const n = Number(v);
+  return Number.isFinite(n) ? n : NaN;
+}
+function constraintFitOk(svcMap, candidate, constraints) {
+  const cap = getServiceCapability(svcMap, candidate);
+  if (!cap) return false;
+  if (constraints.dripfeed === true && !cap.dripfeed) return false;
+  if (constraints.refill === true && !cap.refill) return false;
+  return !(constraints.cancel === true && !cap.cancel);
+}
+function getServiceCapability(svcMap, candidate) {
+  if (candidate === void 0 || candidate === null) return void 0;
+  const direct = svcMap[candidate];
+  if (direct) return direct;
+  const byString = svcMap[String(candidate)];
+  if (byString) return byString;
+  if (typeof candidate === "string") {
+    const maybeNumber = Number(candidate);
+    if (Number.isFinite(maybeNumber)) {
+      return svcMap[maybeNumber];
+    }
+  }
+  return void 0;
+}
+function normalizeRatePolicy(policy) {
+  var _a;
+  if (!policy) return { kind: "lte_primary", pct: 5 };
+  if (policy.kind === "eq_primary") return policy;
+  const pct = Math.max(0, Number((_a = policy.pct) != null ? _a : 0));
+  return { ...policy, pct };
+}
+function passesRatePolicy(policy, primaryRate, candidateRate) {
+  if (!Number.isFinite(primaryRate) || !Number.isFinite(candidateRate)) {
+    return false;
+  }
+  const rp = normalizeRatePolicy(policy);
+  switch (rp.kind) {
+    case "eq_primary":
+      return candidateRate === primaryRate;
+    case "lte_primary": {
+      const floor = primaryRate * (1 - rp.pct / 100);
+      return candidateRate <= primaryRate && candidateRate >= floor;
+    }
+    case "within_pct":
+      return candidateRate <= primaryRate * (1 + rp.pct / 100);
+    case "at_least_pct_lower":
+      return candidateRate <= primaryRate * (1 - rp.pct / 100);
+  }
+}
+function rateOk(svcMap, candidate, primary, policy) {
+  const cand = getServiceCapability(svcMap, candidate);
+  const prim = getServiceCapability(svcMap, primary);
+  if (!cand || !prim) return false;
+  const cRate = toFiniteNumber(cand.rate);
+  const pRate = toFiniteNumber(prim.rate);
+  if (!Number.isFinite(cRate) || !Number.isFinite(pRate)) return false;
+  return passesRatePolicy(policy.ratePolicy, pRate, cRate);
+}
+
 // src/core/validate/steps/rates.ts
 function validateRates(v) {
   var _a, _b, _c, _d;
+  const ratePolicy = normalizeRatePolicy(
+    (_a = v.options.fallbackSettings) == null ? void 0 : _a.ratePolicy
+  );
   for (const f of v.fields) {
     if (!isMultiField(f)) continue;
-    const baseRates = /* @__PURE__ */ new Set();
-    const contributingOptionIds = /* @__PURE__ */ new Set();
-    for (const o of (_a = f.options) != null ? _a : []) {
-      const role = (_c = (_b = o.pricing_role) != null ? _b : f.pricing_role) != null ? _c : "base";
+    const baseRates = [];
+    for (const o of (_b = f.options) != null ? _b : []) {
+      const role = (_d = (_c = o.pricing_role) != null ? _c : f.pricing_role) != null ? _d : "base";
       if (role !== "base") continue;
       const sid = o.service_id;
-      if (!isFiniteNumber(sid)) continue;
-      const rate = (_d = v.serviceMap[sid]) == null ? void 0 : _d.rate;
-      if (isFiniteNumber(rate)) {
-        baseRates.add(Number(rate));
-        contributingOptionIds.add(o.id);
+      if (!isServiceIdRef(sid)) continue;
+      const cap = getServiceCapability(v.serviceMap, sid);
+      const rate = cap == null ? void 0 : cap.rate;
+      if (typeof rate === "number" && Number.isFinite(rate)) {
+        baseRates.push({
+          optionId: o.id,
+          serviceId: String(sid),
+          rate
+        });
       }
     }
-    if (baseRates.size > 1) {
+    if (baseRates.length <= 1) continue;
+    const primary = baseRates.reduce(
+      (best, current) => current.rate > best.rate ? current : best
+    );
+    const offenders = baseRates.filter(
+      (candidate) => candidate.optionId !== primary.optionId && !passesRatePolicy(ratePolicy, primary.rate, candidate.rate)
+    );
+    if (offenders.length > 0) {
+      v.invalidRateFieldIds.add(f.id);
       const affectedIds = [
         f.id,
-        ...Array.from(contributingOptionIds)
+        ...baseRates.map((entry) => entry.optionId)
       ];
       v.errors.push({
         code: "rate_mismatch_across_base",
         severity: "error",
-        message: `Base options under field "${f.id}" resolve to different service rates.`,
+        message: `Base options under field "${f.id}" violate rate policy "${ratePolicy.kind}".`,
         nodeId: f.id,
         details: withAffected(
           {
             fieldId: f.id,
-            rates: Array.from(baseRates.values()),
-            optionIds: Array.from(contributingOptionIds.values())
+            policy: ratePolicy.kind,
+            policyPct: "pct" in ratePolicy ? ratePolicy.pct : void 0,
+            primaryOptionId: primary.optionId,
+            primaryRate: primary.rate,
+            rates: baseRates.map((entry) => entry.rate),
+            optionIds: baseRates.map((entry) => entry.optionId),
+            offenderOptionIds: offenders.map((entry) => entry.optionId)
           },
           affectedIds.length > 1 ? affectedIds : void 0
         )
@@ -1232,8 +1361,8 @@ function validateConstraints(v) {
     const visible = v.fieldsVisibleUnder(t.id);
     for (const f of visible) {
       for (const o of (_a = f.options) != null ? _a : []) {
-        if (!isFiniteNumber(o.service_id)) continue;
-        const svc = v.serviceMap[o.service_id];
+        if (!isServiceIdRef(o.service_id)) continue;
+        const svc = getServiceCapability(v.serviceMap, o.service_id);
         if (!svc || typeof svc !== "object") continue;
         for (const [k, val] of Object.entries(eff)) {
           if (val === true && !isServiceFlagEnabled(svc, k)) {
@@ -1259,8 +1388,8 @@ function validateConstraints(v) {
   }
   for (const t of v.tags) {
     const sid = t.service_id;
-    if (!isFiniteNumber(sid)) continue;
-    const svc = v.serviceMap[Number(sid)];
+    if (!isServiceIdRef(sid)) continue;
+    const svc = getServiceCapability(v.serviceMap, sid);
     if (!svc || typeof svc !== "object") continue;
     const eff = effectiveConstraints(v, t.id);
     for (const [k, val] of Object.entries(eff)) {
@@ -1325,7 +1454,7 @@ function validateGlobalUtilityGuard(v) {
   let hasBase = false;
   for (const f of v.fields) {
     for (const o of (_a = f.options) != null ? _a : []) {
-      if (!isFiniteNumber(o.service_id)) continue;
+      if (!isServiceIdRef(o.service_id)) continue;
       const role = (_c = (_b = o.pricing_role) != null ? _b : f.pricing_role) != null ? _c : "base";
       if (role === "base") hasBase = true;
       else if (role === "utility") hasUtility = true;
@@ -1470,7 +1599,7 @@ function asArray(v) {
   if (v === void 0) return void 0;
   return Array.isArray(v) ? v : [v];
 }
-function isServiceIdRef(v) {
+function isServiceIdRef2(v) {
   return typeof v === "string" || typeof v === "number" && Number.isFinite(v);
 }
 function svcSnapshot(serviceMap, sid) {
@@ -1546,7 +1675,7 @@ function collectServiceItems(args) {
   if (args.mode === "global") {
     for (const t of (_b = args.tags) != null ? _b : []) {
       const sid = t.service_id;
-      if (!isServiceIdRef(sid)) continue;
+      if (!isServiceIdRef2(sid)) continue;
       addServiceRef({
         tagId: t.id,
         serviceId: sid,
@@ -1557,7 +1686,7 @@ function collectServiceItems(args) {
   } else if (args.mode === "visible_group") {
     const t = args.tag;
     const sid = t ? t.service_id : void 0;
-    if (t && isServiceIdRef(sid)) {
+    if (t && isServiceIdRef2(sid)) {
       addServiceRef({
         tagId: t.id,
         serviceId: sid,
@@ -1569,7 +1698,7 @@ function collectServiceItems(args) {
   const fields = (_c = args.fields) != null ? _c : [];
   for (const f of fields) {
     const fSid = f.service_id;
-    if (isServiceIdRef(fSid)) {
+    if (isServiceIdRef2(fSid)) {
       addServiceRef({
         tagId: args.tagId,
         fieldId: f.id,
@@ -1580,7 +1709,7 @@ function collectServiceItems(args) {
     }
     for (const o of (_d = f.options) != null ? _d : []) {
       const oSid = o.service_id;
-      if (!isServiceIdRef(oSid)) continue;
+      if (!isServiceIdRef2(oSid)) continue;
       const role = fieldRoleOf(f, o);
       addServiceRef({
         tagId: args.tagId,
@@ -1601,7 +1730,7 @@ function collectServiceItems(args) {
   const addFallbackNode = (nodeId, list) => {
     const arr = Array.isArray(list) ? list : [];
     for (const cand of arr) {
-      if (!isServiceIdRef(cand)) continue;
+      if (!isServiceIdRef2(cand)) continue;
       addServiceRef({
         tagId: args.tagId,
         nodeId,
@@ -1625,7 +1754,7 @@ function collectServiceItems(args) {
     });
     const arr = Array.isArray(list) ? list : [];
     for (const cand of arr) {
-      if (!isServiceIdRef(cand)) continue;
+      if (!isServiceIdRef2(cand)) continue;
       addServiceRef({
         tagId: args.tagId,
         nodeId: primaryKey,
@@ -1903,85 +2032,8 @@ function applyPolicies(errors, props, serviceMap, policies, fieldsVisibleUnder,
   }
 }
 
-// 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 errors = [];
-  const serviceMap = (_a = ctx.serviceMap) != null ? _a : {};
-  const selectedKeys = new Set(
-    (_b = ctx.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 = ctx.nodeMap) != null ? _c : buildNodeMap(props),
-    options: ctx,
-    errors,
-    serviceMap,
-    selectedKeys,
-    tags,
-    fields,
-    tagById,
-    fieldById,
-    fieldsVisibleUnder: (_tagId) => []
-  };
-  validateStructure(v);
-  validateIdentity(v);
-  validateOptionMaps(v);
-  v.fieldsVisibleUnder = createFieldsVisibleUnder(v);
-  const visSim = readVisibilitySimOpts(ctx);
-  validateVisibility(v, visSim);
-  applyPolicies(
-    v.errors,
-    v.props,
-    v.serviceMap,
-    v.options.policies,
-    v.fieldsVisibleUnder,
-    v.tags
-  );
-  validateServiceVsUserInput(v);
-  validateUtilityMarkers(v);
-  validateRates(v);
-  validateConstraints(v);
-  validateCustomFields(v);
-  validateGlobalUtilityGuard(v);
-  validateUnboundFields(v);
-  validateFallbacks(v);
-  return v.errors;
-}
-async function validateAsync(props, ctx = {}) {
-  await Promise.resolve();
-  if (typeof requestAnimationFrame === "function") {
-    await new Promise(
-      (resolve) => requestAnimationFrame(() => resolve())
-    );
-  } else {
-    await new Promise((resolve) => setTimeout(resolve, 0));
-  }
-  return validate(props, ctx);
-}
-
 // src/core/builder.ts
+import { cloneDeep as cloneDeep2 } from "lodash-es";
 function createBuilder(opts = {}) {
   return new BuilderImpl(opts);
 }
@@ -1995,12 +2047,8 @@ var BuilderImpl = class {
     this.tagById = /* @__PURE__ */ new Map();
     this.fieldById = /* @__PURE__ */ new Map();
     this.optionOwnerById = /* @__PURE__ */ new Map();
-    this.history = [];
-    this.future = [];
     this._nodemap = null;
-    var _a;
     this.options = { ...opts };
-    this.historyLimit = (_a = opts.historyLimit) != null ? _a : 50;
   }
   /* ───── lifecycle ─────────────────────────────────────────────────────── */
   isTagId(id) {
@@ -2017,8 +2065,6 @@ var BuilderImpl = class {
       defaultPricingRole: "base",
       constraints: this.getConstraints().map((item) => item.label)
     });
-    this.pushHistory(this.props);
-    this.future.length = 0;
     this.props = next;
     this.rebuildIndexes();
   }
@@ -2230,6 +2276,9 @@ var BuilderImpl = class {
   errors() {
     return validate(this.props, this.options);
   }
+  getOptions() {
+    return cloneDeep2(this.options);
+  }
   visibleFields(tagId, selectedKeys) {
     var _a;
     return visibleFieldIdsUnder(this.props, tagId, {
@@ -2242,23 +2291,6 @@ var BuilderImpl = class {
     if (!this._nodemap) this._nodemap = buildNodeMap(this.getProps());
     return this._nodemap;
   }
-  /* ───── history ─────────────────────────────────────────────────────── */
-  undo() {
-    if (this.history.length === 0) return false;
-    const prev = this.history.pop();
-    this.future.push(structuredCloneSafe(this.props));
-    this.props = prev;
-    this.rebuildIndexes();
-    return true;
-  }
-  redo() {
-    if (this.future.length === 0) return false;
-    const next = this.future.pop();
-    this.pushHistory(this.props);
-    this.props = next;
-    this.rebuildIndexes();
-    return true;
-  }
   /* ───── internals ──────────────────────────────────────────────────── */
   rebuildIndexes() {
     this.tagById.clear();
@@ -2274,99 +2306,429 @@ var BuilderImpl = class {
       }
     }
   }
-  pushHistory(state) {
-    if (!state || !state.filters.length && !state.fields.length) return;
-    this.history.push(structuredCloneSafe(state));
-    if (this.history.length > this.historyLimit) this.history.shift();
-  }
 };
-function structuredCloneSafe(v) {
-  if (typeof globalThis.structuredClone === "function") {
-    return globalThis.structuredClone(v);
-  }
-  return JSON.parse(JSON.stringify(v));
-}
 function toStringSet(v) {
   if (!v) return /* @__PURE__ */ new Set();
   if (v instanceof Set) return new Set(Array.from(v).map(String));
   return new Set(v.map(String));
 }
 
-// src/core/fallback.ts
-var DEFAULT_SETTINGS = {
-  requireConstraintFit: true,
-  ratePolicy: { kind: "lte_primary" },
-  selectionStrategy: "priority",
-  mode: "strict"
-};
-function resolveServiceFallback(params) {
-  var _a, _b, _c, _d, _e;
-  const s = { ...DEFAULT_SETTINGS, ...(_a = params.settings) != null ? _a : {} };
-  const { primary, nodeId, tagId, services } = params;
-  const fb = (_b = params.fallbacks) != null ? _b : {};
-  const tried = [];
-  const lists = [];
-  if (nodeId && ((_c = fb.nodes) == null ? void 0 : _c[nodeId])) lists.push(fb.nodes[nodeId]);
-  if ((_d = fb.global) == null ? void 0 : _d[primary]) lists.push(fb.global[primary]);
-  const primaryRate = rateOf(services, primary);
-  for (const list of lists) {
-    for (const cand of list) {
-      if (tried.includes(cand)) continue;
-      tried.push(cand);
-      const candCap = (_e = services[Number(cand)]) != null ? _e : services[cand];
-      if (!candCap) continue;
-      if (!passesRate(s.ratePolicy, primaryRate, candCap.rate)) continue;
-      if (s.requireConstraintFit && tagId) {
-        const ok = satisfiesTagConstraints(tagId, params, candCap);
-        if (!ok) continue;
+// 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;
       }
-      return cand;
+      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 null;
+  return diagnostics;
 }
-function collectFailedFallbacks(props, services, settings) {
-  var _a, _b, _c;
-  const s = { ...DEFAULT_SETTINGS, ...settings != null ? settings : {} };
-  const out = [];
-  const fb = (_a = props.fallbacks) != null ? _a : {};
-  const primaryRate = (p) => rateOf(services, p);
-  for (const [nodeId, list] of Object.entries((_b = fb.nodes) != null ? _b : {})) {
-    const { primary, tagContexts } = primaryForNode(props, nodeId);
-    if (!primary) {
-      out.push({
-        scope: "node",
-        nodeId,
-        primary: "",
-        candidate: "",
-        reason: "no_primary"
-      });
+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;
     }
-    for (const cand of list) {
-      const cap = getCap(services, cand);
-      if (!cap) {
-        out.push({
-          scope: "node",
-          nodeId,
-          primary,
-          candidate: cand,
-          reason: "unknown_service"
-        });
+    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;
       }
-      if (String(cand) === String(primary)) {
-        out.push({
-          scope: "node",
-          nodeId,
-          primary,
-          candidate: cand,
-          reason: "cycle"
-        });
+      const cap2 = getServiceCapability(services, option.service_id);
+      if (!cap2 || typeof cap2.rate !== "number" || !Number.isFinite(cap2.rate)) {
         continue;
       }
-      if (!passesRate(s.ratePolicy, primaryRate(primary), cap.rate)) {
-        out.push({
+      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, _d;
+  const errors = [];
+  const serviceMap = (_a = ctx.serviceMap) != null ? _a : {};
+  const selectedKeys = new Set(
+    (_b = ctx.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 = ctx.nodeMap) != null ? _c : buildNodeMap(props),
+    options: ctx,
+    errors,
+    serviceMap,
+    selectedKeys,
+    tags,
+    fields,
+    invalidRateFieldIds: /* @__PURE__ */ new Set(),
+    tagById,
+    fieldById,
+    fieldsVisibleUnder: (_tagId) => []
+  };
+  validateStructure(v);
+  validateIdentity(v);
+  validateOptionMaps(v);
+  v.fieldsVisibleUnder = createFieldsVisibleUnder(v);
+  const visSim = readVisibilitySimOpts(ctx);
+  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: (_d = ctx.fallbackSettings) == null ? void 0 : _d.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;
+}
+async function validateAsync(props, ctx = {}) {
+  await Promise.resolve();
+  if (typeof requestAnimationFrame === "function") {
+    await new Promise(
+      (resolve) => requestAnimationFrame(() => resolve())
+    );
+  } else {
+    await new Promise((resolve) => setTimeout(resolve, 0));
+  }
+  return validate(props, ctx);
+}
+
+// src/core/fallback.ts
+var DEFAULT_SETTINGS = {
+  requireConstraintFit: true,
+  ratePolicy: { kind: "lte_primary", pct: 5 },
+  selectionStrategy: "priority",
+  mode: "strict"
+};
+function resolveServiceFallback(params) {
+  var _a, _b, _c, _d, _e;
+  const s = { ...DEFAULT_SETTINGS, ...(_a = params.settings) != null ? _a : {} };
+  const { primary, nodeId, tagId, services } = params;
+  const fb = (_b = params.fallbacks) != null ? _b : {};
+  const tried = [];
+  const lists = [];
+  if (nodeId && ((_c = fb.nodes) == null ? void 0 : _c[nodeId])) lists.push(fb.nodes[nodeId]);
+  if ((_d = fb.global) == null ? void 0 : _d[primary]) lists.push(fb.global[primary]);
+  const primaryRate = rateOf(services, primary);
+  for (const list of lists) {
+    for (const cand of list) {
+      if (tried.includes(cand)) continue;
+      tried.push(cand);
+      const candCap = (_e = services[Number(cand)]) != null ? _e : services[cand];
+      if (!candCap) continue;
+      if (!passesRate(s.ratePolicy, primaryRate, candCap.rate)) continue;
+      if (s.requireConstraintFit && tagId) {
+        const ok = satisfiesTagConstraints(tagId, params, candCap);
+        if (!ok) continue;
+      }
+      return cand;
+    }
+  }
+  return null;
+}
+function collectFailedFallbacks(props, services, settings) {
+  var _a, _b, _c;
+  const s = { ...DEFAULT_SETTINGS, ...settings != null ? settings : {} };
+  const out = [];
+  const fb = (_a = props.fallbacks) != null ? _a : {};
+  const primaryRate = (p) => rateOf(services, p);
+  for (const [nodeId, list] of Object.entries((_b = fb.nodes) != null ? _b : {})) {
+    const { primary, tagContexts } = primaryForNode(props, nodeId);
+    if (!primary) {
+      out.push({
+        scope: "node",
+        nodeId,
+        primary: "",
+        candidate: "",
+        reason: "no_primary"
+      });
+      continue;
+    }
+    for (const cand of list) {
+      const cap = getCap(services, cand);
+      if (!cap) {
+        out.push({
+          scope: "node",
+          nodeId,
+          primary,
+          candidate: cand,
+          reason: "unknown_service"
+        });
+        continue;
+      }
+      if (String(cand) === String(primary)) {
+        out.push({
+          scope: "node",
+          nodeId,
+          primary,
+          candidate: cand,
+          reason: "cycle"
+        });
+        continue;
+      }
+      if (!passesRate(s.ratePolicy, primaryRate(primary), cap.rate)) {
+        out.push({
           scope: "node",
           nodeId,
           primary,
@@ -2450,27 +2812,10 @@ function passesRate(policy, primaryRate, candRate) {
     return false;
   if (typeof primaryRate !== "number" || !Number.isFinite(primaryRate))
     return false;
-  switch (policy.kind) {
-    case "lte_primary":
-      return candRate <= primaryRate;
-    case "within_pct":
-      return candRate <= primaryRate * (1 + policy.pct / 100);
-    case "at_least_pct_lower":
-      return candRate <= primaryRate * (1 - policy.pct / 100);
-  }
+  return passesRatePolicy(normalizeRatePolicy(policy), primaryRate, candRate);
 }
 function getCap(map, id) {
-  const direct = map[id];
-  if (direct) return direct;
-  const strKey = String(id);
-  const byStr = map[strKey];
-  if (byStr) return byStr;
-  const n = typeof id === "number" ? id : typeof id === "string" ? Number(id) : Number.NaN;
-  if (Number.isFinite(n)) {
-    const byNum = map[n];
-    if (byNum) return byNum;
-  }
-  return void 0;
+  return getServiceCapability(map, id);
 }
 function isCapFlagEnabled(cap, flagId) {
   var _a, _b;
@@ -2561,186 +2906,6 @@ function getFallbackRegistrationInfo(props, nodeId) {
   return { primary, tagContexts };
 }
 
-// src/core/rate-coherence.ts
-function validateRateCoherenceDeep(params) {
-  var _a, _b, _c, _d, _e, _f, _g;
-  const { builder, services, tagId } = params;
-  const ratePolicy = (_a = params.ratePolicy) != null ? _a : { kind: "lte_primary" };
-  const props = builder.getProps();
-  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 = [];
-  for (const f of baselineFields) {
-    if (!isButton(f)) continue;
-    if (Array.isArray(f.options) && f.options.length) {
-      for (const o of f.options) {
-        anchors.push({
-          kind: "option",
-          id: o.id,
-          fieldId: f.id,
-          label: (_d = o.label) != null ? _d : o.id,
-          service_id: numberOrUndefined(o.service_id)
-        });
-      }
-    } else {
-      anchors.push({
-        kind: "field",
-        id: f.id,
-        fieldId: f.id,
-        label: (_e = f.label) != null ? _e : f.id,
-        service_id: numberOrUndefined(f.service_id)
-      });
-    }
-  }
-  const diags = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const anchor of anchors) {
-    const selectedKeys = anchor.kind === "option" ? [`${anchor.fieldId}::${anchor.id}`] : [anchor.fieldId];
-    const vgFieldIds = builder.visibleFields(tagId, selectedKeys);
-    const vgFields = vgFieldIds.map((fid) => fieldById.get(fid)).filter(Boolean);
-    const baseCandidates = [];
-    for (const f of vgFields) {
-      if (!isButton(f)) continue;
-      if (Array.isArray(f.options) && f.options.length) {
-        for (const o of f.options) {
-          const sid = numberOrUndefined(o.service_id);
-          const role = normalizeRole(o.pricing_role, "base");
-          if (sid == null || role !== "base") continue;
-          const r = rateOf2(services, sid);
-          if (!isFiniteNumber2(r)) continue;
-          baseCandidates.push({
-            kind: "option",
-            id: o.id,
-            label: (_f = o.label) != null ? _f : o.id,
-            service_id: sid,
-            rate: r
-          });
-        }
-      } else {
-        const sid = numberOrUndefined(f.service_id);
-        const role = normalizeRole(f.pricing_role, "base");
-        if (sid == null || role !== "base") continue;
-        const r = rateOf2(services, sid);
-        if (!isFiniteNumber2(r)) continue;
-        baseCandidates.push({
-          kind: "field",
-          id: f.id,
-          label: (_g = f.label) != null ? _g : f.id,
-          service_id: sid,
-          rate: r
-        });
-      }
-    }
-    if (baseCandidates.length === 0) continue;
-    const anchorPrimary = anchor.service_id != null ? pickByServiceId(baseCandidates, anchor.service_id) : void 0;
-    const primary = anchorPrimary ? anchorPrimary : baseCandidates[0];
-    for (const cand of baseCandidates) {
-      if (sameService(primary, cand)) continue;
-      if (!rateOkWithPolicy(ratePolicy, cand.rate, primary.rate)) {
-        const key = dedupeKey(tagId, anchor, primary, cand, ratePolicy);
-        if (seen.has(key)) continue;
-        seen.add(key);
-        diags.push({
-          scope: "visible_group",
-          tagId,
-          primary,
-          offender: {
-            kind: cand.kind,
-            id: cand.id,
-            label: cand.label,
-            service_id: cand.service_id,
-            rate: cand.rate
-          },
-          policy: ratePolicy.kind,
-          policyPct: "pct" in ratePolicy ? ratePolicy.pct : void 0,
-          message: explainRateMismatch(
-            ratePolicy,
-            primary.rate,
-            cand.rate,
-            describeLabel(tag)
-          ),
-          simulationAnchor: {
-            kind: anchor.kind,
-            id: anchor.id,
-            fieldId: anchor.fieldId,
-            label: anchor.label
-          }
-        });
-      }
-    }
-  }
-  return diags;
-}
-function isButton(f) {
-  if (f.button === true) return true;
-  return Array.isArray(f.options) && f.options.length > 0;
-}
-function normalizeRole(role, d) {
-  return role === "utility" || role === "base" ? role : d;
-}
-function numberOrUndefined(v) {
-  const n = Number(v);
-  return Number.isFinite(n) ? n : void 0;
-}
-function isFiniteNumber2(v) {
-  return typeof v === "number" && Number.isFinite(v);
-}
-function rateOf2(map, id) {
-  var _a;
-  if (id === void 0 || id === null) return void 0;
-  const cap = (_a = map[Number(id)]) != null ? _a : map[id];
-  return cap == null ? void 0 : cap.rate;
-}
-function pickByServiceId(arr, sid) {
-  return arr.find((x) => x.service_id === sid);
-}
-function sameService(a, b) {
-  return a.service_id === b.service_id;
-}
-function rateOkWithPolicy(policy, candRate, primaryRate) {
-  var _a, _b;
-  const rp = policy != null ? policy : { kind: "lte_primary" };
-  switch (rp.kind) {
-    case "lte_primary":
-      return candRate <= primaryRate;
-    case "within_pct": {
-      const pct = Math.max(0, (_a = rp.pct) != null ? _a : 0);
-      return candRate <= primaryRate * (1 + pct / 100);
-    }
-    case "at_least_pct_lower": {
-      const pct = Math.max(0, (_b = rp.pct) != null ? _b : 0);
-      return candRate <= primaryRate * (1 - pct / 100);
-    }
-    default:
-      return candRate <= primaryRate;
-  }
-}
-function describeLabel(tag) {
-  var _a, _b;
-  const tagName = (_b = (_a = tag == null ? void 0 : tag.label) != null ? _a : tag == null ? void 0 : tag.id) != null ? _b : "tag";
-  return `${tagName}`;
-}
-function explainRateMismatch(policy, primary, candidate, where) {
-  switch (policy.kind) {
-    case "lte_primary":
-      return `Rate coherence failed (${where}): candidate ${candidate} must be \u2264 primary ${primary}.`;
-    case "within_pct":
-      return `Rate coherence failed (${where}): candidate ${candidate} must be within ${policy.pct}% of primary ${primary}.`;
-    case "at_least_pct_lower":
-      return `Rate coherence failed (${where}): candidate ${candidate} must be at least ${policy.pct}% lower than primary ${primary}.`;
-    default:
-      return `Rate coherence failed (${where}): candidate ${candidate} mismatches primary ${primary}.`;
-  }
-}
-function dedupeKey(tagId, anchor, primary, cand, rp) {
-  const rpKey = rp.kind + ("pct" in rp && typeof rp.pct === "number" ? `:${rp.pct}` : "");
-  return `${tagId}|${anchor.kind}:${anchor.id}|p${primary.service_id}|c${cand.service_id}:${cand.id}|${rpKey}`;
-}
-
 // src/core/tag-relations.ts
 var toId = (x) => typeof x === "string" ? x : x.id;
 var toBindList = (b) => {
@@ -3073,17 +3238,16 @@ function createNodeIndex(builder) {
     return node;
   };
   const getNode = (input) => {
-    var _a2, _b2, _c2, _d2, _e;
-    if (typeof input !== "string") {
-      if ("bind_id" in input && !("type" in input))
-        return (_a2 = getTag(input.id)) != null ? _a2 : mkUnknown(input.id);
-      if ("type" in input)
-        return (_b2 = getField(input.id)) != null ? _b2 : mkUnknown(input.id);
-      return (_c2 = getOption(input.id)) != null ? _c2 : mkUnknown(input.id);
-    }
-    const cached = nodeCache.get(input);
+    var _a2, _b2, _c2;
+    const id = typeof input === "object" ? input.id : input;
+    const cached = nodeCache.get(id);
     if (cached) return cached;
-    return (_e = (_d2 = nodeMap.get(input)) == null ? void 0 : _d2.node) != null ? _e : mkUnknown(input);
+    const node = nodeMap.get(id);
+    if (!node) return mkUnknown(id);
+    if (node.kind === "tag") return (_a2 = getTag(id)) != null ? _a2 : mkUnknown(id);
+    if (node.kind == "field") return (_b2 = getField(id)) != null ? _b2 : mkUnknown(id);
+    if (node.kind == "option") return (_c2 = getOption(id)) != null ? _c2 : mkUnknown(id);
+    return mkUnknown(id);
   };
   const mkUnknown = (id) => {
     const u = {
@@ -3104,6 +3268,451 @@ function createNodeIndex(builder) {
   };
 }
 
+// src/core/policy.ts
+var ALLOWED_SCOPES = /* @__PURE__ */ new Set([
+  "global",
+  "visible_group"
+]);
+var ALLOWED_SUBJECTS = /* @__PURE__ */ new Set(["services"]);
+var ALLOWED_OPS = /* @__PURE__ */ new Set([
+  "all_equal",
+  "unique",
+  "no_mix",
+  "all_true",
+  "any_true",
+  "max_count",
+  "min_count"
+]);
+var ALLOWED_ROLES = /* @__PURE__ */ new Set([
+  "base",
+  "utility",
+  "both"
+]);
+var ALLOWED_SEVERITIES = /* @__PURE__ */ new Set([
+  "error",
+  "warning"
+]);
+var ALLOWED_WHERE_OPS = /* @__PURE__ */ new Set(["eq", "neq", "in", "nin", "exists", "truthy", "falsy"]);
+function normaliseWhere(src, d, i, id) {
+  if (src === void 0) return void 0;
+  if (!Array.isArray(src)) {
+    d.push({
+      ruleIndex: i,
+      ruleId: id,
+      severity: "warning",
+      message: "filter.where must be an array; ignored.",
+      path: "filter.where"
+    });
+    return void 0;
+  }
+  const out = [];
+  src.forEach((raw, j) => {
+    const obj = raw && typeof raw === "object" ? raw : null;
+    const path = typeof (obj == null ? void 0 : obj.path) === "string" && obj.path.trim() ? obj.path.trim() : void 0;
+    if (!path) {
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "warning",
+        message: `filter.where[${j}].path must be a non-empty string; entry ignored.`,
+        path: `filter.where[${j}].path`
+      });
+      return;
+    }
+    if (!path.startsWith("service.")) {
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "warning",
+        message: `filter.where[${j}].path should start with "service." for subject "services".`,
+        path: `filter.where[${j}].path`
+      });
+    }
+    const opRaw = obj == null ? void 0 : obj.op;
+    const op = opRaw === void 0 ? "eq" : typeof opRaw === "string" && ALLOWED_WHERE_OPS.has(opRaw) ? opRaw : "eq";
+    if (opRaw !== void 0 && !(typeof opRaw === "string" && ALLOWED_WHERE_OPS.has(opRaw))) {
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "warning",
+        message: `Unknown filter.where[${j}].op; defaulted to "eq".`,
+        path: `filter.where[${j}].op`
+      });
+    }
+    const value = obj == null ? void 0 : obj.value;
+    if (op === "exists" || op === "truthy" || op === "falsy") {
+      if (value !== void 0) {
+        d.push({
+          ruleIndex: i,
+          ruleId: id,
+          severity: "warning",
+          message: `filter.where[${j}] op "${op}" does not use "value".`,
+          path: `filter.where[${j}].value`
+        });
+      }
+    } else if (op === "in" || op === "nin") {
+      if (!Array.isArray(value)) {
+        d.push({
+          ruleIndex: i,
+          ruleId: id,
+          severity: "warning",
+          message: `filter.where[${j}] op "${op}" expects an array "value".`,
+          path: `filter.where[${j}].value`
+        });
+      }
+    }
+    out.push({ path, op, value });
+  });
+  return out.length ? out : void 0;
+}
+function compilePolicies(raw) {
+  const diagnostics = [];
+  const policies = [];
+  if (!Array.isArray(raw)) {
+    diagnostics.push({
+      ruleIndex: -1,
+      severity: "error",
+      message: "Policies root must be an array."
+    });
+    return { policies, diagnostics };
+  }
+  raw.forEach((entry, i) => {
+    const d = [];
+    const src = entry && typeof entry === "object" ? entry : {};
+    let id = typeof src.id === "string" && src.id.trim() ? src.id.trim() : void 0;
+    if (!id) {
+      id = `policy_${i + 1}`;
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "warning",
+        message: 'Missing "id"; generated automatically.',
+        path: "id"
+      });
+    }
+    const label = typeof src.label === "string" && src.label.trim() ? src.label.trim() : id;
+    if (!(typeof src.label === "string" && src.label.trim())) {
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "warning",
+        message: 'Missing "label"; defaulted to rule id.',
+        path: "label"
+      });
+    }
+    let scope = ALLOWED_SCOPES.has(src.scope) ? src.scope : src.scope === void 0 ? "visible_group" : "visible_group";
+    if (src.scope !== void 0 && !ALLOWED_SCOPES.has(src.scope)) {
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "warning",
+        message: 'Unknown "scope"; defaulted to "visible_group".',
+        path: "scope"
+      });
+    }
+    let subject = ALLOWED_SUBJECTS.has(src.subject) ? src.subject : "services";
+    if (src.subject !== void 0 && !ALLOWED_SUBJECTS.has(src.subject)) {
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "warning",
+        message: 'Unknown "subject"; defaulted to "services".',
+        path: "subject"
+      });
+    }
+    const op = src.op;
+    if (!ALLOWED_OPS.has(op)) {
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "error",
+        message: `Invalid "op": ${String(op)}.`,
+        path: "op"
+      });
+    }
+    let projection = typeof src.projection === "string" && src.projection.trim() ? src.projection.trim() : "service.id";
+    if (subject === "services" && projection && !projection.startsWith("service.")) {
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "warning",
+        message: 'Projection should start with "service." for subject "services".',
+        path: "projection"
+      });
+    }
+    const filterSrc = src.filter && typeof src.filter === "object" ? src.filter : void 0;
+    const role = (filterSrc == null ? void 0 : filterSrc.role) && ALLOWED_ROLES.has(filterSrc.role) ? filterSrc.role : "both";
+    if ((filterSrc == null ? void 0 : filterSrc.role) && !ALLOWED_ROLES.has(filterSrc.role)) {
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "warning",
+        message: 'Unknown filter.role; defaulted to "both".',
+        path: "filter.role"
+      });
+    }
+    const filter = {
+      role,
+      tag_id: (filterSrc == null ? void 0 : filterSrc.tag_id) !== void 0 ? Array.isArray(filterSrc.tag_id) ? filterSrc.tag_id : [filterSrc.tag_id] : void 0,
+      field_id: (filterSrc == null ? void 0 : filterSrc.field_id) !== void 0 ? Array.isArray(filterSrc.field_id) ? filterSrc.field_id : [filterSrc.field_id] : void 0,
+      where: normaliseWhere(filterSrc == null ? void 0 : filterSrc.where, d, i, id)
+    };
+    const severity = ALLOWED_SEVERITIES.has(src.severity) ? src.severity : "error";
+    if (src.severity !== void 0 && !ALLOWED_SEVERITIES.has(src.severity)) {
+      d.push({
+        ruleIndex: i,
+        ruleId: id,
+        severity: "warning",
+        message: 'Unknown "severity"; defaulted to "error".',
+        path: "severity"
+      });
+    }
+    const value = src.value;
+    if (op === "max_count" || op === "min_count") {
+      if (!(typeof value === "number" && Number.isFinite(value))) {
+        d.push({
+          ruleIndex: i,
+          ruleId: id,
+          severity: "error",
+          message: `"${op}" requires numeric "value".`,
+          path: "value"
+        });
+      }
+    } else if (op === "all_true" || op === "any_true") {
+      if (value !== void 0) {
+        d.push({
+          ruleIndex: i,
+          ruleId: id,
+          severity: "warning",
+          message: `"${op}" ignores "value"; it checks all/any true.`,
+          path: "value"
+        });
+      }
+    } else {
+      if (value !== void 0) {
+        d.push({
+          ruleIndex: i,
+          ruleId: id,
+          severity: "warning",
+          message: `"${op}" does not use "value".`,
+          path: "value"
+        });
+      }
+    }
+    const hasFatal = d.some((x) => x.severity === "error");
+    if (!hasFatal) {
+      const rule = {
+        id,
+        label,
+        // ✅ now always present
+        scope,
+        subject,
+        filter,
+        projection,
+        op,
+        value,
+        severity,
+        message: typeof src.message === "string" ? src.message : void 0
+      };
+      policies.push(rule);
+    }
+    diagnostics.push(...d);
+  });
+  return { policies, diagnostics };
+}
+
+// src/core/service-filter.ts
+function filterServicesForVisibleGroup(input, deps) {
+  var _a, _b, _c, _d, _e, _f;
+  const svcMap = (_c = (_b = (_a = deps.builder).getServiceMap) == null ? void 0 : _b.call(_a)) != null ? _c : {};
+  const { context } = input;
+  const usedSet = new Set(context.usedServiceIds.map(String));
+  const primary = context.usedServiceIds[0];
+  const fb = {
+    requireConstraintFit: true,
+    ratePolicy: { kind: "lte_primary", pct: 5 },
+    selectionStrategy: "priority",
+    mode: "strict",
+    ...(_d = context.fallback) != null ? _d : {}
+  };
+  const visibleServiceIds = context.selectedButtons === void 0 ? void 0 : collectVisibleServiceIds(
+    deps.builder,
+    context.tagId,
+    context.selectedButtons
+  );
+  const checks = [];
+  let lastDiagnostics = void 0;
+  for (const id of input.candidates) {
+    if (usedSet.has(String(id))) continue;
+    const cap = getServiceCapability(svcMap, id);
+    if (!cap) {
+      checks.push({
+        id,
+        ok: false,
+        fitsConstraints: false,
+        passesRate: false,
+        passesPolicies: false,
+        reasons: ["missing_capability"]
+      });
+      continue;
+    }
+    const fitsConstraints = constraintFitOk(
+      svcMap,
+      cap.id,
+      (_e = context.effectiveConstraints) != null ? _e : {}
+    );
+    const passesRate2 = primary == null ? true : rateOk(svcMap, id, primary, fb);
+    const polRes = evaluatePoliciesRaw(
+      (_f = context.policies) != null ? _f : [],
+      [...context.usedServiceIds, id],
+      svcMap,
+      context.tagId,
+      visibleServiceIds
+    );
+    const passesPolicies = polRes.ok;
+    lastDiagnostics = polRes.diagnostics;
+    const reasons = [];
+    if (!fitsConstraints) reasons.push("constraint_mismatch");
+    if (!passesRate2) reasons.push("rate_policy");
+    if (!passesPolicies) reasons.push("policy_error");
+    checks.push({
+      id,
+      ok: fitsConstraints && passesRate2 && passesPolicies,
+      fitsConstraints,
+      passesRate: passesRate2,
+      passesPolicies,
+      policyErrors: polRes.errors.length ? polRes.errors : void 0,
+      policyWarnings: polRes.warnings.length ? polRes.warnings : void 0,
+      reasons,
+      cap,
+      rate: toFiniteNumber(cap.rate)
+    });
+  }
+  return {
+    checks,
+    diagnostics: lastDiagnostics && lastDiagnostics.length ? lastDiagnostics : void 0
+  };
+}
+function evaluatePoliciesRaw(raw, serviceIds, svcMap, tagId, visibleServiceIds) {
+  const compiled = compilePolicies(raw);
+  const evaluated = evaluateServicePolicies(
+    compiled.policies,
+    serviceIds,
+    svcMap,
+    tagId,
+    visibleServiceIds
+  );
+  return {
+    ...evaluated,
+    diagnostics: compiled.diagnostics
+  };
+}
+function evaluateServicePolicies(rules, svcIds, svcMap, tagId, visibleServiceIds) {
+  var _a, _b, _c;
+  const errors = [];
+  const warnings = [];
+  if (!rules || !rules.length) return { ok: true, errors, warnings };
+  const relevant = rules.filter(
+    (r) => r.subject === "services" && (r.scope === "visible_group" || r.scope === "global")
+  );
+  for (const r of relevant) {
+    const scoped = scopeServiceIdsForRule(svcIds, r, visibleServiceIds);
+    const ids = scoped.filter(
+      (id) => matchesRuleFilter(getServiceCapability(svcMap, id), r, tagId)
+    );
+    const projection = r.projection || "service.id";
+    const values = ids.map(
+      (id) => policyProjectValue(getServiceCapability(svcMap, id), projection)
+    );
+    let ok = true;
+    switch (r.op) {
+      case "all_equal":
+        ok = values.length <= 1 || values.every((v) => v === values[0]);
+        break;
+      case "unique": {
+        const uniq2 = new Set(values.map((v) => String(v)));
+        ok = uniq2.size === values.length;
+        break;
+      }
+      case "no_mix": {
+        const uniq2 = new Set(values.map((v) => String(v)));
+        ok = uniq2.size <= 1;
+        break;
+      }
+      case "all_true":
+        ok = values.every((v) => !!v);
+        break;
+      case "any_true":
+        ok = values.some((v) => !!v);
+        break;
+      case "max_count": {
+        const n = typeof r.value === "number" ? r.value : NaN;
+        ok = Number.isFinite(n) ? values.length <= n : true;
+        break;
+      }
+      case "min_count": {
+        const n = typeof r.value === "number" ? r.value : NaN;
+        ok = Number.isFinite(n) ? values.length >= n : true;
+        break;
+      }
+      default:
+        ok = true;
+    }
+    if (!ok) {
+      if (((_a = r.severity) != null ? _a : "error") === "error") {
+        errors.push((_b = r.id) != null ? _b : "policy_error");
+      } else {
+        warnings.push((_c = r.id) != null ? _c : "policy_warning");
+      }
+    }
+  }
+  return { ok: errors.length === 0, errors, warnings };
+}
+function scopeServiceIdsForRule(serviceIds, rule, visibleServiceIds) {
+  if (rule.scope !== "visible_group" || !visibleServiceIds) return serviceIds;
+  return serviceIds.filter((id) => visibleServiceIds.has(String(id)));
+}
+function collectVisibleServiceIds(builder, tagId, selectedButtons) {
+  var _a, _b, _c;
+  const out = /* @__PURE__ */ new Set();
+  const props = builder.getProps();
+  const tags = (_a = props.filters) != null ? _a : [];
+  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));
+  for (const field of fields) {
+    if (!visibleFieldIds.has(field.id)) continue;
+    if (field.service_id != null) {
+      out.add(String(field.service_id));
+    }
+    for (const option of (_c = field.options) != null ? _c : []) {
+      if (option.service_id != null) {
+        out.add(String(option.service_id));
+      }
+    }
+  }
+  return out;
+}
+function policyProjectValue(cap, projection) {
+  if (!cap) return void 0;
+  const key = projection.startsWith("service.") ? projection.slice(8) : projection;
+  return cap[key];
+}
+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;
+}
+function toStrSet(v) {
+  const arr = Array.isArray(v) ? v : [v];
+  const s = /* @__PURE__ */ new Set();
+  for (const x of arr) s.add(String(x));
+  return s;
+}
+
 // src/utils/prune-fallbacks.ts
 function pruneInvalidNodeFallbacks(props, services, settings) {
   var _a, _b;
@@ -3190,43 +3799,6 @@ function toBindArray(bind) {
   return Array.isArray(bind) ? bind.slice() : [bind];
 }
 
-// src/utils/util.ts
-function toFiniteNumber(v) {
-  const n = Number(v);
-  return Number.isFinite(n) ? n : NaN;
-}
-function constraintFitOk(svcMap, candidate, constraints) {
-  const cap = svcMap[Number(candidate)];
-  if (!cap) return false;
-  if (constraints.dripfeed === true && !cap.dripfeed) return false;
-  if (constraints.refill === true && !cap.refill) return false;
-  return !(constraints.cancel === true && !cap.cancel);
-}
-function rateOk(svcMap, candidate, primary, policy) {
-  var _a, _b, _c;
-  const cand = svcMap[Number(candidate)];
-  const prim = svcMap[Number(primary)];
-  if (!cand || !prim) return false;
-  const cRate = toFiniteNumber(cand.rate);
-  const pRate = toFiniteNumber(prim.rate);
-  if (!Number.isFinite(cRate) || !Number.isFinite(pRate)) return false;
-  const rp = (_a = policy.ratePolicy) != null ? _a : { kind: "lte_primary" };
-  switch (rp.kind) {
-    case "lte_primary":
-      return cRate <= pRate;
-    case "within_pct": {
-      const pct = Math.max(0, (_b = rp.pct) != null ? _b : 0);
-      return cRate <= pRate * (1 + pct / 100);
-    }
-    case "at_least_pct_lower": {
-      const pct = Math.max(0, (_c = rp.pct) != null ? _c : 0);
-      return cRate <= pRate * (1 - pct / 100);
-    }
-    default:
-      return false;
-  }
-}
-
 // src/utils/build-order-snapshot.ts
 function buildOrderSnapshot(props, builder, selection, services, settings = {}) {
   var _a, _b, _c, _d, _e, _f, _g, _h;
@@ -3236,7 +3808,7 @@ function buildOrderSnapshot(props, builder, selection, services, settings = {})
   ) ? settings.hostDefaultQuantity : 1;
   const fbSettings = {
     requireConstraintFit: true,
-    ratePolicy: { kind: "lte_primary" },
+    ratePolicy: { kind: "lte_primary", pct: 5 },
     selectionStrategy: "priority",
     mode: mode === "dev" ? "dev" : "strict",
     ...(_c = settings.fallback) != null ? _c : {}
@@ -3272,7 +3844,9 @@ function buildOrderSnapshot(props, builder, selection, services, settings = {})
   const qtyRes = resolveQuantity(
     visibleFieldIds,
     fieldById,
+    tagById,
     selection,
+    tagId,
     hostDefaultQty
   );
   const quantity = qtyRes.quantity;
@@ -3387,7 +3961,7 @@ function buildInputs(visibleFieldIds, fieldById, selection) {
   }
   return { formValues, selections };
 }
-function resolveQuantity(visibleFieldIds, fieldById, selection, hostDefault) {
+function resolveQuantity(visibleFieldIds, fieldById, tagById, selection, tagId, hostDefault) {
   var _a;
   for (const fid of visibleFieldIds) {
     const f = fieldById.get(fid);
@@ -3404,7 +3978,16 @@ function resolveQuantity(visibleFieldIds, fieldById, selection, hostDefault) {
         source: { kind: "field", id: f.id, rule }
       };
     }
+    break;
   }
+  const nodeDefault = resolveNodeDefaultQuantity(
+    visibleFieldIds,
+    fieldById,
+    tagById,
+    selection,
+    tagId
+  );
+  if (nodeDefault) return nodeDefault;
   return {
     quantity: hostDefault,
     source: { kind: "default", defaultedFromHost: true }
@@ -3417,9 +4000,37 @@ function readQuantityRule(v) {
     return void 0;
   const out = { valueBy: src.valueBy };
   if (src.code && typeof src.code === "string") out.code = src.code;
+  if (typeof src.multiply === "number" && Number.isFinite(src.multiply)) {
+    out.multiply = src.multiply;
+  }
+  if (typeof src.fallback === "number" && Number.isFinite(src.fallback)) {
+    out.fallback = src.fallback;
+  }
+  if (src.clamp && typeof src.clamp === "object") {
+    const min = typeof src.clamp.min === "number" && Number.isFinite(src.clamp.min) ? src.clamp.min : void 0;
+    const max = typeof src.clamp.max === "number" && Number.isFinite(src.clamp.max) ? src.clamp.max : void 0;
+    if (min !== void 0 || max !== void 0) {
+      out.clamp = {
+        ...min !== void 0 ? { min } : {},
+        ...max !== void 0 ? { max } : {}
+      };
+    }
+  }
   return out;
 }
 function evaluateQuantityRule(rule, raw) {
+  const evaluated = evaluateRawQuantityRule(rule, raw);
+  if (Number.isFinite(evaluated)) {
+    const adjusted = applyQuantityTransforms(evaluated, rule);
+    if (Number.isFinite(adjusted) && adjusted > 0) return adjusted;
+  }
+  if (typeof rule.fallback === "number" && Number.isFinite(rule.fallback)) {
+    const fallback = applyClamp(rule.fallback, rule.clamp);
+    if (Number.isFinite(fallback) && fallback > 0) return fallback;
+  }
+  return NaN;
+}
+function evaluateRawQuantityRule(rule, raw) {
   switch (rule.valueBy) {
     case "value": {
       const n = Number(Array.isArray(raw) ? raw[0] : raw);
@@ -3452,6 +4063,65 @@ function evaluateQuantityRule(rule, raw) {
       return NaN;
   }
 }
+function applyQuantityTransforms(value, rule) {
+  let next = value;
+  if (typeof rule.multiply === "number" && Number.isFinite(rule.multiply)) {
+    next *= rule.multiply;
+  }
+  return applyClamp(next, rule.clamp);
+}
+function applyClamp(value, clamp2) {
+  let next = value;
+  if ((clamp2 == null ? void 0 : clamp2.min) !== void 0) next = Math.max(next, clamp2.min);
+  if ((clamp2 == null ? void 0 : clamp2.max) !== void 0) next = Math.min(next, clamp2.max);
+  return next;
+}
+function resolveNodeDefaultQuantity(visibleFieldIds, fieldById, tagById, selection, tagId) {
+  var _a, _b, _c, _d;
+  const optionVisit = buildOptionVisitOrder(selection, fieldById);
+  for (const { fieldId, optionId } of optionVisit) {
+    if (!visibleFieldIds.includes(fieldId)) continue;
+    const field = fieldById.get(fieldId);
+    const option = (_a = field == null ? void 0 : field.options) == null ? void 0 : _a.find((item) => item.id === optionId);
+    const quantityDefault = readQuantityDefault(
+      (_b = option == null ? void 0 : option.meta) == null ? void 0 : _b.quantityDefault
+    );
+    if (quantityDefault !== void 0) {
+      return {
+        quantity: quantityDefault,
+        source: { kind: "option", id: optionId }
+      };
+    }
+  }
+  for (const fieldId of visibleFieldIds) {
+    const field = fieldById.get(fieldId);
+    if (!field) continue;
+    const isButtonStyle = field.button === true || Array.isArray(field.options) && field.options.length > 0;
+    if (!isButtonStyle) continue;
+    const quantityDefault = readQuantityDefault(
+      field.quantityDefault
+    );
+    if (quantityDefault !== void 0) {
+      return {
+        quantity: quantityDefault,
+        source: { kind: "field", id: field.id }
+      };
+    }
+  }
+  const tagQuantityDefault = readQuantityDefault(
+    (_d = (_c = tagById.get(tagId)) == null ? void 0 : _c.meta) == null ? void 0 : _d.quantityDefault
+  );
+  if (tagQuantityDefault !== void 0) {
+    return {
+      quantity: tagQuantityDefault,
+      source: { kind: "tag", id: tagId }
+    };
+  }
+  return void 0;
+}
+function readQuantityDefault(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
 function resolveServices(tagId, visibleFieldIds, selection, tagById, fieldById) {
   var _a;
   const serviceMap = {};
@@ -3570,7 +4240,7 @@ function pruneFallbacksConservative(fallbacks, env, svcMap, policy) {
         fallbacks.global
       )) {
         if (!present.has(String(primary))) continue;
-        const primId = isFiniteNumber3(primary) ? Number(primary) : primary;
+        const primId = isFiniteNumber2(primary) ? Number(primary) : primary;
         const kept = [];
         for (const cand of cands != null ? cands : []) {
           if (!rateOk(svcMap, cand, primId, policy)) continue;
@@ -3589,7 +4259,7 @@ function pruneFallbacksConservative(fallbacks, env, svcMap, policy) {
     };
   }
 }
-function isFiniteNumber3(v) {
+function isFiniteNumber2(v) {
   return typeof v === "number" && Number.isFinite(v);
 }
 function collectUtilityLineItems(visibleFieldIds, fieldById, selection, quantity) {
@@ -3644,9 +4314,14 @@ function readUtilityMarker(v) {
   if (src.mode !== "flat" && src.mode !== "per_quantity" && src.mode !== "per_value" && src.mode !== "percent")
     return void 0;
   const out = { mode: src.mode, rate: src.rate };
-  if (src.valueBy === "value" || src.valueBy === "length" || src.valueBy === "eval")
+  if (src.valueBy === "value" || src.valueBy === "length")
     out.valueBy = src.valueBy;
-  if (src.code && typeof src.code === "string") out.code = src.code;
+  if (src.percentBase === "service_total" || src.percentBase === "base_service" || src.percentBase === "all") {
+    out.percentBase = src.percentBase;
+  }
+  if (typeof src.label === "string" && src.label.trim()) {
+    out.label = src.label.trim();
+  }
   return out;
 }
 function buildUtilityItemFromMarker(nodeId, marker, quantity, value) {
@@ -3655,14 +4330,14 @@ function buildUtilityItemFromMarker(nodeId, marker, quantity, value) {
     nodeId,
     mode: marker.mode,
     rate: marker.rate,
+    ...marker.percentBase ? { percentBase: marker.percentBase } : {},
+    ...marker.label ? { label: marker.label } : {},
     inputs: { quantity }
   };
   if (marker.mode === "per_value") {
     base.inputs.valueBy = (_a = marker.valueBy) != null ? _a : "value";
     if (marker.valueBy === "length") {
       base.inputs.value = Array.isArray(value) ? value.length : typeof value === "string" ? value.length : 0;
-    } else if (marker.valueBy === "eval") {
-      base.inputs.evalCodeUsed = true;
     } else {
       base.inputs.value = Array.isArray(value) ? (_b = value[0]) != null ? _b : null : value != null ? value : null;
     }
@@ -3733,47 +4408,13 @@ function buildDevWarnings(props, svcMap, _tagId, _snapshotServiceMap, originalFa
   return out;
 }
 function toSnapshotPolicy(settings) {
-  var _a, _b, _c;
+  var _a;
   const requireConstraintFit = (_a = settings.requireConstraintFit) != null ? _a : true;
-  const rp = (_b = settings.ratePolicy) != null ? _b : { kind: "lte_primary" };
-  switch (rp.kind) {
-    case "lte_primary":
-      return {
-        ratePolicy: { kind: "lte_primary" },
-        requireConstraintFit
-      };
-    case "within_pct":
-      return {
-        ratePolicy: {
-          kind: "lte_primary",
-          thresholdPct: Math.max(0, (_c = rp.pct) != null ? _c : 0)
-        },
-        requireConstraintFit
-      };
-    case "at_least_pct_lower":
-      return {
-        ratePolicy: { kind: "lte_primary" },
-        requireConstraintFit
-      };
-    default:
-      return {
-        ratePolicy: { kind: "lte_primary" },
-        requireConstraintFit
-      };
-  }
+  const rp = normalizeRatePolicy(settings.ratePolicy);
+  return { ratePolicy: rp, requireConstraintFit };
 }
 function getCap2(map, id) {
-  const direct = map[id];
-  if (direct) return direct;
-  const strKey = String(id);
-  const byStr = map[strKey];
-  if (byStr) return byStr;
-  const n = typeof id === "number" ? id : typeof id === "string" ? Number(id) : Number.NaN;
-  if (Number.isFinite(n)) {
-    const byNum = map[n];
-    if (byNum) return byNum;
-  }
-  return void 0;
+  return getServiceCapability(map, id);
 }
 function resolveMinMax(servicesList, services) {
   let min = void 0;
@@ -4137,9 +4778,11 @@ export {
   createBuilder,
   createFallbackEditor,
   createNodeIndex,
+  filterServicesForVisibleGroup,
   getEligibleFallbacks,
   getFallbackRegistrationInfo,
   normalise,
+  normalizeFieldValidation,
   resolveServiceFallback,
   validate,
   validateAsync,