@timeax/digital-service-engine 0.2.0 → 0.2.2

package/dist/core/index.cjs

@@ -26,6 +26,7 @@ __export(core_exports, {
   createFallbackEditor: () => createFallbackEditor,
   createNodeIndex: () => createNodeIndex,
   filterServicesForVisibleGroup: () => filterServicesForVisibleGroup,
+  getAssignedServiceIds: () => getAssignedServiceIds,
   getEligibleFallbacks: () => getEligibleFallbacks,
   getFallbackRegistrationInfo: () => getFallbackRegistrationInfo,
   normalise: () => normalise,
@@ -1231,6 +1232,9 @@ function toFiniteNumber(v) {
   const n = Number(v);
   return Number.isFinite(n) ? n : NaN;
 }
+function isValidServiceIdRef(value) {
+  return typeof value === "number" && Number.isFinite(value) || typeof value === "string" && value.trim().length > 0;
+}
 function constraintFitOk(svcMap, candidate, constraints) {
   const cap = getServiceCapability(svcMap, candidate);
   if (!cap) return false;
@@ -1239,18 +1243,32 @@ function constraintFitOk(svcMap, candidate, constraints) {
   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];
-    }
+  var _a;
+  return (_a = getServiceCapabilityEntry(svcMap, candidate)) == null ? void 0 : _a.capability;
+}
+function getServiceCapabilityCanonicalRef(svcMap, candidate) {
+  const entry = getServiceCapabilityEntry(svcMap, candidate);
+  if (!entry) return void 0;
+  return getCanonicalServiceRef(entry.key, entry.capability);
+}
+function getServiceCapabilityAliases(svcMap, candidate) {
+  const entry = getServiceCapabilityEntry(svcMap, candidate);
+  if (!entry) return [];
+  return collectServiceRefAliases(entry.key, entry.capability);
+}
+function isSameServiceCapabilityRef(svcMap, left, right) {
+  if (!isValidServiceIdRef(left) || !isValidServiceIdRef(right)) return false;
+  const leftAliases = new Set(
+    getServiceCapabilityAliases(svcMap, left).map((value) => String(value))
+  );
+  if (!leftAliases.size) {
+    leftAliases.add(String(left));
   }
-  return void 0;
+  const rightAliases = getServiceCapabilityAliases(svcMap, right);
+  if (!rightAliases.length) {
+    return leftAliases.has(String(right));
+  }
+  return rightAliases.some((value) => leftAliases.has(String(value)));
 }
 function normalizeRatePolicy(policy) {
   var _a;
@@ -1286,18 +1304,84 @@ function rateOk(svcMap, candidate, primary, policy) {
   if (!Number.isFinite(cRate) || !Number.isFinite(pRate)) return false;
   return passesRatePolicy(policy.ratePolicy, pRate, cRate);
 }
+function getServiceCapabilityEntry(svcMap, candidate) {
+  if (candidate === void 0 || candidate === null) return void 0;
+  const direct = svcMap[candidate];
+  if (direct) {
+    return { key: String(candidate), capability: direct };
+  }
+  const byString = svcMap[String(candidate)];
+  if (byString) {
+    return { key: String(candidate), capability: byString };
+  }
+  if (typeof candidate === "string") {
+    const maybeNumber = Number(candidate);
+    if (Number.isFinite(maybeNumber)) {
+      const byNumber = svcMap[maybeNumber];
+      if (byNumber) {
+        return { key: String(maybeNumber), capability: byNumber };
+      }
+    }
+  }
+  const target = String(candidate);
+  for (const [key, capability] of Object.entries(svcMap != null ? svcMap : {})) {
+    if (collectServiceRefAliases(key, capability).some(
+      (alias) => String(alias) === target
+    )) {
+      return { key, capability };
+    }
+  }
+  return void 0;
+}
+function collectServiceRefAliases(key, capability) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  const push = (value) => {
+    if (!isValidServiceIdRef(value)) return;
+    const normalized = normalizeServiceRef(value);
+    if (!normalized) return;
+    const aliasKey = String(normalized);
+    if (seen.has(aliasKey)) return;
+    seen.add(aliasKey);
+    out.push(normalized);
+  };
+  push(getCanonicalServiceRef(key, capability));
+  push(capability.service);
+  push(capability.key);
+  push(capability.id);
+  return out;
+}
+function getCanonicalServiceRef(key, capability) {
+  const explicitRefs = [capability.service, capability.key, capability.id];
+  for (const ref of explicitRefs) {
+    if (!isValidServiceIdRef(ref)) continue;
+    if (String(ref) === key) {
+      return ref;
+    }
+  }
+  return normalizeServiceRef(key);
+}
+function normalizeServiceRef(value) {
+  if (!isValidServiceIdRef(value)) return void 0;
+  if (typeof value === "number") return value;
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  const asNumber = Number(trimmed);
+  if (Number.isFinite(asNumber) && String(asNumber) === trimmed) {
+    return asNumber;
+  }
+  return trimmed;
+}
 
 // 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
-  );
+  var _a, _b, _c;
+  const ratePolicy = normalizeRatePolicy(v.options.ratePolicy);
   for (const f of v.fields) {
     if (!isMultiField(f)) continue;
     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";
+    for (const o of (_a = f.options) != null ? _a : []) {
+      const role = (_c = (_b = o.pricing_role) != null ? _b : f.pricing_role) != null ? _c : "base";
       if (role !== "base") continue;
       const sid = o.service_id;
       if (!isServiceIdRef(sid)) continue;
@@ -2071,6 +2155,38 @@ function applyPolicies(errors, props, serviceMap, policies, fieldsVisibleUnder,
   }
 }
 
+// src/core/governance.ts
+var DEFAULT_FALLBACK_SETTINGS = {
+  requireConstraintFit: true,
+  ratePolicy: { kind: "lte_primary", pct: 5 },
+  selectionStrategy: "priority",
+  mode: "strict"
+};
+function resolveGlobalRatePolicy(options) {
+  return normalizeRatePolicy(options.ratePolicy);
+}
+function resolveFallbackSettings(options) {
+  var _a;
+  return {
+    ...DEFAULT_FALLBACK_SETTINGS,
+    ...(_a = options.fallbackSettings) != null ? _a : {}
+  };
+}
+function mergeValidatorOptions(defaults = {}, overrides = {}) {
+  var _a, _b, _c, _d;
+  const mergedFallbackSettings = {
+    ...(_a = defaults.fallbackSettings) != null ? _a : {},
+    ...(_b = overrides.fallbackSettings) != null ? _b : {}
+  };
+  return {
+    ...defaults,
+    ...overrides,
+    policies: (_c = overrides.policies) != null ? _c : defaults.policies,
+    ratePolicy: (_d = overrides.ratePolicy) != null ? _d : defaults.ratePolicy,
+    fallbackSettings: Object.keys(mergedFallbackSettings).length > 0 ? mergedFallbackSettings : void 0
+  };
+}
+
 // src/core/builder.ts
 var import_lodash_es2 = require("lodash-es");
 function createBuilder(opts = {}) {
@@ -2313,7 +2429,7 @@ var BuilderImpl = class {
     return out;
   }
   errors() {
-    return validate(this.props, this.options);
+    return validate(this.props, mergeValidatorOptions({}, this.options));
   }
   getOptions() {
     return (0, import_lodash_es2.cloneDeep)(this.options);
@@ -2600,11 +2716,14 @@ function readVisibilitySimOpts(ctx) {
   };
 }
 function validate(props, ctx = {}) {
-  var _a, _b, _c, _d;
+  var _a, _b, _c;
+  const options = mergeValidatorOptions({}, ctx);
+  const fallbackSettings = resolveFallbackSettings(options);
+  const ratePolicy = resolveGlobalRatePolicy(options);
   const errors = [];
-  const serviceMap = (_a = ctx.serviceMap) != null ? _a : {};
+  const serviceMap = (_a = options.serviceMap) != null ? _a : {};
   const selectedKeys = new Set(
-    (_b = ctx.selectedOptionKeys) != null ? _b : []
+    (_b = options.selectedOptionKeys) != null ? _b : []
   );
   const tags = Array.isArray(props.filters) ? props.filters : [];
   const fields = Array.isArray(props.fields) ? props.fields : [];
@@ -2614,8 +2733,12 @@ function validate(props, ctx = {}) {
   for (const f of fields) fieldById.set(f.id, f);
   const v = {
     props,
-    nodeMap: (_c = ctx.nodeMap) != null ? _c : buildNodeMap(props),
-    options: ctx,
+    nodeMap: (_c = options.nodeMap) != null ? _c : buildNodeMap(props),
+    options: {
+      ...options,
+      ratePolicy,
+      fallbackSettings
+    },
     errors,
     serviceMap,
     selectedKeys,
@@ -2630,7 +2753,7 @@ function validate(props, ctx = {}) {
   validateIdentity(v);
   validateOptionMaps(v);
   v.fieldsVisibleUnder = createFieldsVisibleUnder(v);
-  const visSim = readVisibilitySimOpts(ctx);
+  const visSim = readVisibilitySimOpts(options);
   validateVisibility(v, visSim);
   applyPolicies(
     v.errors,
@@ -2651,7 +2774,7 @@ function validate(props, ctx = {}) {
         builder,
         services: serviceMap,
         tagId: tag.id,
-        ratePolicy: (_d = ctx.fallbackSettings) == null ? void 0 : _d.ratePolicy,
+        ratePolicy,
         invalidFieldIds: v.invalidRateFieldIds
       });
       for (const diag of diags) {
@@ -2701,27 +2824,42 @@ var DEFAULT_SETTINGS = {
   mode: "strict"
 };
 function resolveServiceFallback(params) {
-  var _a, _b, _c, _d, _e;
+  var _a, _b;
   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 fallbackLists = listRegisteredFallbackCandidates(
+    (_b = params.fallbacks) != null ? _b : {},
+    primary,
+    nodeId,
+    services
+  );
+  const tried = /* @__PURE__ */ new Set();
   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;
+  for (const list of fallbackLists) {
+    for (const candidate of list) {
+      const candidateIdentity = getComparableServiceRefKey(
+        services,
+        candidate
+      );
+      if (tried.has(candidateIdentity)) continue;
+      tried.add(candidateIdentity);
+      const capability = getCap(services, candidate);
+      if (!capability) continue;
+      if (isSameServiceCapabilityRef(services, candidate, primary)) {
+        continue;
+      }
+      if (!passesRate(s.ratePolicy, primaryRate, capability.rate)) {
+        continue;
+      }
       if (s.requireConstraintFit && tagId) {
-        const ok = satisfiesTagConstraints(tagId, params, candCap);
-        if (!ok) continue;
+        const fitsConstraints = satisfiesTagConstraints(
+          tagId,
+          params,
+          capability
+        );
+        if (!fitsConstraints) continue;
       }
-      return cand;
+      return candidate;
     }
   }
   return null;
@@ -2731,7 +2869,7 @@ function collectFailedFallbacks(props, services, settings) {
   const s = { ...DEFAULT_SETTINGS, ...settings != null ? settings : {} };
   const out = [];
   const fb = (_a = props.fallbacks) != null ? _a : {};
-  const primaryRate = (p) => rateOf(services, p);
+  const primaryRate = (primary) => rateOf(services, primary);
   for (const [nodeId, list] of Object.entries((_b = fb.nodes) != null ? _b : {})) {
     const { primary, tagContexts } = primaryForNode(props, nodeId);
     if (!primary) {
@@ -2744,34 +2882,34 @@ function collectFailedFallbacks(props, services, settings) {
       });
       continue;
     }
-    for (const cand of list) {
-      const cap = getCap(services, cand);
-      if (!cap) {
+    for (const candidate of list) {
+      const capability = getCap(services, candidate);
+      if (!capability) {
         out.push({
           scope: "node",
           nodeId,
           primary,
-          candidate: cand,
+          candidate,
           reason: "unknown_service"
         });
         continue;
       }
-      if (String(cand) === String(primary)) {
+      if (isSameServiceCapabilityRef(services, candidate, primary)) {
         out.push({
           scope: "node",
           nodeId,
           primary,
-          candidate: cand,
+          candidate,
           reason: "cycle"
         });
         continue;
       }
-      if (!passesRate(s.ratePolicy, primaryRate(primary), cap.rate)) {
+      if (!passesRate(s.ratePolicy, primaryRate(primary), capability.rate)) {
         out.push({
           scope: "node",
           nodeId,
           primary,
-          candidate: cand,
+          candidate,
           reason: "rate_violation"
         });
         continue;
@@ -2781,58 +2919,55 @@ function collectFailedFallbacks(props, services, settings) {
           scope: "node",
           nodeId,
           primary,
-          candidate: cand,
+          candidate,
           reason: "no_tag_context"
         });
         continue;
       }
-      let anyPass = false;
-      let anyFail = false;
       for (const tagId of tagContexts) {
-        const ok = s.requireConstraintFit ? satisfiesTagConstraints(tagId, { services, props }, cap) : true;
-        if (ok) anyPass = true;
-        else {
-          anyFail = true;
-          out.push({
-            scope: "node",
-            nodeId,
-            primary,
-            candidate: cand,
-            tagContext: tagId,
-            reason: "constraint_mismatch"
-          });
-        }
+        const fitsConstraints = s.requireConstraintFit ? satisfiesTagConstraints(
+          tagId,
+          { services, props },
+          capability
+        ) : true;
+        if (fitsConstraints) continue;
+        out.push({
+          scope: "node",
+          nodeId,
+          primary,
+          candidate,
+          tagContext: tagId,
+          reason: "constraint_mismatch"
+        });
       }
-      void anyPass;
-      void anyFail;
     }
   }
   for (const [primary, list] of Object.entries((_c = fb.global) != null ? _c : {})) {
-    for (const cand of list) {
-      const cap = getCap(services, cand);
-      if (!cap) {
+    for (const candidate of list) {
+      const capability = getCap(services, candidate);
+      if (!capability) {
         out.push({
           scope: "global",
           primary,
-          candidate: cand,
+          candidate,
           reason: "unknown_service"
         });
         continue;
       }
-      if (String(cand) === String(primary)) {
+      if (isSameServiceCapabilityRef(services, candidate, primary)) {
         out.push({
           scope: "global",
           primary,
-          candidate: cand,
+          candidate,
           reason: "cycle"
         });
         continue;
       }
-      if (!passesRate(s.ratePolicy, primaryRate(primary), cap.rate)) {
+      if (!passesRate(s.ratePolicy, primaryRate(primary), capability.rate)) {
         out.push({
           scope: "global",
           primary,
-          candidate: cand,
+          candidate,
           reason: "rate_violation"
         });
       }
@@ -2841,52 +2976,61 @@ function collectFailedFallbacks(props, services, settings) {
   return out;
 }
 function rateOf(map, id) {
-  var _a;
+  var _a, _b;
   if (id === void 0 || id === null) return void 0;
-  const c = getCap(map, id);
-  return (_a = c == null ? void 0 : c.rate) != null ? _a : void 0;
+  return (_b = (_a = getCap(map, id)) == null ? void 0 : _a.rate) != null ? _b : void 0;
 }
-function passesRate(policy, primaryRate, candRate) {
-  if (typeof candRate !== "number" || !Number.isFinite(candRate))
+function passesRate(policy, primaryRate, candidateRate) {
+  if (typeof candidateRate !== "number" || !Number.isFinite(candidateRate)) {
     return false;
-  if (typeof primaryRate !== "number" || !Number.isFinite(primaryRate))
+  }
+  if (typeof primaryRate !== "number" || !Number.isFinite(primaryRate)) {
     return false;
-  return passesRatePolicy(normalizeRatePolicy(policy), primaryRate, candRate);
+  }
+  return passesRatePolicy(
+    normalizeRatePolicy(policy),
+    primaryRate,
+    candidateRate
+  );
 }
 function getCap(map, id) {
   return getServiceCapability(map, id);
 }
-function isCapFlagEnabled(cap, flagId) {
+function isCapFlagEnabled(capability, flagId) {
   var _a, _b;
-  const fromFlags = (_b = (_a = cap.flags) == null ? void 0 : _a[flagId]) == null ? void 0 : _b.enabled;
+  const fromFlags = (_b = (_a = capability.flags) == null ? void 0 : _a[flagId]) == null ? void 0 : _b.enabled;
   if (fromFlags === true) return true;
   if (fromFlags === false) return false;
-  const legacy = cap[flagId];
+  const legacy = capability[flagId];
   return legacy === true;
 }
-function satisfiesTagConstraints(tagId, ctx, cap) {
-  const tag = ctx.props.filters.find((t) => t.id === tagId);
-  const eff = tag == null ? void 0 : tag.constraints;
-  if (!eff) return true;
-  for (const [key, value] of Object.entries(eff)) {
-    if (value === true && !isCapFlagEnabled(cap, key)) {
+function satisfiesTagConstraints(tagId, ctx, capability) {
+  const tag = ctx.props.filters.find((item) => item.id === tagId);
+  const effectiveConstraints2 = tag == null ? void 0 : tag.constraints;
+  if (!effectiveConstraints2) return true;
+  for (const [key, value] of Object.entries(effectiveConstraints2)) {
+    if (value === true && !isCapFlagEnabled(capability, key)) {
       return false;
     }
   }
   return true;
 }
 function primaryForNode(props, nodeId) {
-  const tag = props.filters.find((t) => t.id === nodeId);
+  const tag = props.filters.find((item) => item.id === nodeId);
   if (tag) {
     return { primary: tag.service_id, tagContexts: [tag.id] };
   }
   const field = props.fields.find(
-    (f) => Array.isArray(f.options) && f.options.some((o) => o.id === nodeId)
+    (item) => Array.isArray(item.options) && item.options.some((option2) => option2.id === nodeId)
   );
-  if (!field) return { tagContexts: [], reasonNoPrimary: "no_parent_field" };
-  const opt = field.options.find((o) => o.id === nodeId);
-  const contexts = bindIdsToArray(field.bind_id);
-  return { primary: opt.service_id, tagContexts: contexts };
+  if (!field) {
+    return { tagContexts: [], reasonNoPrimary: "no_parent_field" };
+  }
+  const option = field.options.find((item) => item.id === nodeId);
+  return {
+    primary: option.service_id,
+    tagContexts: bindIdsToArray(field.bind_id)
+  };
 }
 function bindIdsToArray(bind) {
   if (!bind) return [];
@@ -2896,43 +3040,54 @@ function getEligibleFallbacks(params) {
   var _a, _b, _c, _d, _e, _f;
   const s = { ...DEFAULT_SETTINGS, ...(_a = params.settings) != null ? _a : {} };
   const { primary, nodeId, tagId, services } = params;
-  const fb = (_b = params.fallbacks) != null ? _b : {};
-  const excludes = new Set(((_c = params.exclude) != null ? _c : []).map(String));
-  excludes.add(String(primary));
-  const unique = (_d = params.unique) != null ? _d : true;
-  const lists = [];
-  if (nodeId && ((_e = fb.nodes) == null ? void 0 : _e[nodeId])) lists.push(fb.nodes[nodeId]);
-  if ((_f = fb.global) == null ? void 0 : _f[primary]) lists.push(fb.global[primary]);
-  if (!lists.length) return [];
+  const excludes = /* @__PURE__ */ new Set();
+  for (const ref of (_b = params.exclude) != null ? _b : []) {
+    addComparableServiceRef(excludes, services, ref);
+  }
+  addComparableServiceRef(excludes, services, primary);
+  const source = (_c = params.source) != null ? _c : "registered";
+  const candidateLists = source === "all_services" ? [listServicePoolCandidates(services)] : listRegisteredFallbackCandidates(
+    (_d = params.fallbacks) != null ? _d : {},
+    primary,
+    nodeId,
+    services
+  );
+  if (!candidateLists.length) return [];
   const primaryRate = rateOf(services, primary);
   const seen = /* @__PURE__ */ new Set();
   const eligible = [];
-  for (const list of lists) {
-    for (const cand of list) {
-      const key = String(cand);
-      if (excludes.has(key)) continue;
-      if (unique && seen.has(key)) continue;
-      seen.add(key);
-      const cap = getCap(services, cand);
-      if (!cap) continue;
-      if (!passesRate(s.ratePolicy, primaryRate, cap.rate)) continue;
+  for (const list of candidateLists) {
+    for (const candidate of list) {
+      if (hasComparableServiceRef(excludes, services, candidate)) continue;
+      const capability = getCap(services, candidate);
+      if (!capability) continue;
+      const candidateId = (_e = getServiceCapabilityCanonicalRef(services, candidate)) != null ? _e : candidate;
+      const candidateIdentity = getComparableServiceRefKey(
+        services,
+        candidateId
+      );
+      if (((_f = params.unique) != null ? _f : true) && seen.has(candidateIdentity)) continue;
+      seen.add(candidateIdentity);
+      if (!passesRate(s.ratePolicy, primaryRate, capability.rate)) {
+        continue;
+      }
       if (s.requireConstraintFit && tagId) {
-        const ok = satisfiesTagConstraints(
+        const fitsConstraints = satisfiesTagConstraints(
           tagId,
           { props: params.props, services },
-          cap
+          capability
         );
-        if (!ok) continue;
+        if (!fitsConstraints) continue;
       }
-      eligible.push(cand);
+      eligible.push(candidateId);
     }
   }
   if (s.selectionStrategy === "cheapest") {
-    eligible.sort((a, b) => {
+    eligible.sort((left, right) => {
       var _a2, _b2;
-      const ra = (_a2 = rateOf(services, a)) != null ? _a2 : Infinity;
-      const rb = (_b2 = rateOf(services, b)) != null ? _b2 : Infinity;
-      return ra - rb;
+      const leftRate = (_a2 = rateOf(services, left)) != null ? _a2 : Infinity;
+      const rightRate = (_b2 = rateOf(services, right)) != null ? _b2 : Infinity;
+      return leftRate - rightRate;
     });
   }
   if (typeof params.limit === "number" && params.limit >= 0) {
@@ -2940,10 +3095,104 @@ function getEligibleFallbacks(params) {
   }
   return eligible;
 }
+function getAssignedServiceIds(params) {
+  var _a, _b, _c, _d, _e;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  const push = (value) => {
+    if (!isValidServiceIdRef(value)) return;
+    const key = String(value);
+    if (seen.has(key)) return;
+    seen.add(key);
+    out.push(value);
+  };
+  const props = params.props;
+  if (props) {
+    for (const tag of (_a = props.filters) != null ? _a : []) {
+      push(tag.service_id);
+    }
+    for (const field of (_b = props.fields) != null ? _b : []) {
+      const fieldService = field.service_id;
+      if (field.button === true) {
+        push(fieldService);
+      }
+      for (const option of (_c = field.options) != null ? _c : []) {
+        if (option.pricing_role === "utility") continue;
+        push(option.service_id);
+      }
+    }
+  }
+  const snapshot = params.snapshot;
+  if (snapshot) {
+    for (const serviceId of (_d = snapshot.services) != null ? _d : []) {
+      push(serviceId);
+    }
+    for (const list of Object.values((_e = snapshot.serviceMap) != null ? _e : {})) {
+      for (const serviceId of list != null ? list : []) {
+        push(serviceId);
+      }
+    }
+  }
+  return out;
+}
 function getFallbackRegistrationInfo(props, nodeId) {
   const { primary, tagContexts } = primaryForNode(props, nodeId);
   return { primary, tagContexts };
 }
+function listRegisteredFallbackCandidates(fallbacks, primary, nodeId, services) {
+  var _a, _b;
+  const lists = [];
+  if (nodeId && ((_a = fallbacks.nodes) == null ? void 0 : _a[nodeId])) {
+    lists.push(fallbacks.nodes[nodeId]);
+  }
+  for (const [registeredPrimary, list] of Object.entries((_b = fallbacks.global) != null ? _b : {})) {
+    if (!isMatchingServiceRef(services, registeredPrimary, primary)) continue;
+    lists.push(list);
+  }
+  return lists;
+}
+function listServicePoolCandidates(services) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const [key, capability] of Object.entries(services != null ? services : {})) {
+    const candidate = getServicePoolCandidateId(key, capability);
+    if (!isValidServiceIdRef(candidate)) continue;
+    const identity = getComparableServiceRefKey(services, candidate);
+    if (seen.has(identity)) continue;
+    seen.add(identity);
+    out.push(candidate);
+  }
+  return out;
+}
+function getServicePoolCandidateId(key, capability) {
+  var _a;
+  return (_a = getServiceCapabilityCanonicalRef({ [key]: capability }, key)) != null ? _a : key;
+}
+function addComparableServiceRef(target, services, value) {
+  for (const ref of getComparableServiceRefs(services, value)) {
+    target.add(ref);
+  }
+}
+function hasComparableServiceRef(target, services, value) {
+  return getComparableServiceRefs(services, value).some((ref) => target.has(ref));
+}
+function getComparableServiceRefKey(services, value) {
+  if (!isValidServiceIdRef(value)) return "";
+  const canonical = getServiceCapabilityCanonicalRef(services, value);
+  return String(canonical != null ? canonical : value);
+}
+function getComparableServiceRefs(services, value) {
+  if (!isValidServiceIdRef(value)) return [];
+  const aliases = getServiceCapabilityAliases(services, value);
+  if (!aliases.length) {
+    return [String(value)];
+  }
+  return aliases.map((ref) => String(ref));
+}
+function isMatchingServiceRef(services, left, right) {
+  if (!services) return String(left) === String(right);
+  return isSameServiceCapabilityRef(services, left, right);
+}
 
 // src/core/tag-relations.ts
 var toId = (x) => typeof x === "string" ? x : x.id;
@@ -3562,18 +3811,23 @@ function compilePolicies(raw) {
 
 // src/core/service-filter.ts
 function filterServicesForVisibleGroup(input, deps) {
-  var _a, _b, _c, _d, _e, _f;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
   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 = {
-    requireConstraintFit: true,
-    ratePolicy: { kind: "lte_primary", pct: 5 },
-    selectionStrategy: "priority",
-    mode: "strict",
-    ...(_d = context.fallback) != null ? _d : {}
+    ...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 visibleServiceIds = context.selectedButtons === void 0 ? void 0 : collectVisibleServiceIds(
     deps.builder,
     context.tagId,
@@ -3598,11 +3852,11 @@ function filterServicesForVisibleGroup(input, deps) {
     const fitsConstraints = constraintFitOk(
       svcMap,
       cap.id,
-      (_e = context.effectiveConstraints) != null ? _e : {}
+      (_k = context.effectiveConstraints) != null ? _k : {}
     );
     const passesRate2 = primary == null ? true : rateOk(svcMap, id, primary, fb);
     const polRes = evaluatePoliciesRaw(
-      (_f = context.policies) != null ? _f : [],
+      policySource,
       [...context.usedServiceIds, id],
       svcMap,
       context.tagId,
@@ -4477,6 +4731,7 @@ function createFallbackEditor(options = {}) {
   const original = cloneFallbacks(options.fallbacks);
   let current = cloneFallbacks(options.fallbacks);
   const props = options.props;
+  const snapshot = options.snapshot;
   const services = (_a = options.services) != null ? _a : {};
   const settings = (_b = options.settings) != null ? _b : {};
   function state() {
@@ -4571,7 +4826,11 @@ function createFallbackEditor(options = {}) {
       const allowed2 = [];
       for (const candidate of normalized) {
         const reasons = [];
-        if (String(candidate) === String(context.primary)) {
+        if (isSameServiceCapabilityRef(
+          services,
+          candidate,
+          context.primary
+        )) {
           reasons.push("self_reference");
         }
         if (reasons.length) {
@@ -4659,7 +4918,19 @@ function createFallbackEditor(options = {}) {
     return writeScope(context, []);
   }
   function eligible(context, opt) {
+    var _a2, _b2;
     if (!props) return [];
+    const source = (_a2 = opt == null ? void 0 : opt.source) != null ? _a2 : "all_services";
+    const exclude = normalizeCandidateList(
+      [
+        ...(_b2 = opt == null ? void 0 : opt.exclude) != null ? _b2 : [],
+        ...source === "all_services" ? [
+          ...getAssignedServiceIds({ props, snapshot }),
+          ...getScope(context)
+        ] : []
+      ],
+      true
+    );
     if (context.scope === "global") {
       return getEligibleFallbacks({
         primary: context.primary,
@@ -4667,9 +4938,10 @@ function createFallbackEditor(options = {}) {
         fallbacks: current,
         settings,
         props,
-        exclude: opt == null ? void 0 : opt.exclude,
+        exclude,
         unique: opt == null ? void 0 : opt.unique,
-        limit: opt == null ? void 0 : opt.limit
+        limit: opt == null ? void 0 : opt.limit,
+        source
       });
     }
     const info = getFallbackRegistrationInfo(props, context.nodeId);
@@ -4677,14 +4949,19 @@ function createFallbackEditor(options = {}) {
     return getEligibleFallbacks({
       primary: info.primary,
       nodeId: context.nodeId,
-      tagId: info.tagContexts[0],
+      tagId: resolveNodeTagContext({
+        nodeId: context.nodeId,
+        snapshot,
+        fallbackTagContexts: info.tagContexts
+      }),
       services,
       fallbacks: current,
       settings,
       props,
-      exclude: opt == null ? void 0 : opt.exclude,
+      exclude,
       unique: opt == null ? void 0 : opt.unique,
-      limit: opt == null ? void 0 : opt.limit
+      limit: opt == null ? void 0 : opt.limit,
+      source
     });
   }
   function writeScope(context, nextList) {
@@ -4742,14 +5019,14 @@ function sameFallbacks(a, b) {
 function normalizeCandidateList(input, preserveOrder) {
   const out = [];
   for (const item of input != null ? input : []) {
-    if (!isValidServiceIdRef(item)) continue;
+    if (!isValidServiceIdRef2(item)) continue;
     const exists = out.some((x) => String(x) === String(item));
     if (exists) continue;
     out.push(item);
   }
   return preserveOrder ? out : out;
 }
-function isValidServiceIdRef(value) {
+function isValidServiceIdRef2(value) {
   return typeof value === "number" && Number.isFinite(value) || typeof value === "string" && value.trim().length > 0;
 }
 function clamp(n, min, max) {
@@ -4758,7 +5035,7 @@ function clamp(n, min, max) {
 function getNodeRegistrationInfo(props, nodeId) {
   const tag = props.filters.find((t) => t.id === nodeId);
   if (tag) {
-    if (!isValidServiceIdRef(tag.service_id)) {
+    if (!isValidServiceIdRef2(tag.service_id)) {
       return { ok: false, reasons: ["no_primary"] };
     }
     return {
@@ -4771,7 +5048,7 @@ function getNodeRegistrationInfo(props, nodeId) {
   if (!hit) {
     return { ok: false, reasons: ["node_not_found"] };
   }
-  if (!isValidServiceIdRef(hit.option.service_id)) {
+  if (!isValidServiceIdRef2(hit.option.service_id)) {
     return { ok: false, reasons: ["no_primary"] };
   }
   return {
@@ -4793,6 +5070,15 @@ function bindIdsToArray2(v) {
   if (Array.isArray(v)) return v.filter(Boolean);
   return v ? [v] : [];
 }
+function resolveNodeTagContext(params) {
+  var _a, _b, _c;
+  const nodeContexts = (_c = (_b = (_a = params.snapshot) == null ? void 0 : _a.meta) == null ? void 0 : _b.context) == null ? void 0 : _c.nodeContexts;
+  if (nodeContexts && Object.prototype.hasOwnProperty.call(nodeContexts, params.nodeId)) {
+    const tagId = nodeContexts[params.nodeId];
+    return typeof tagId === "string" && tagId.trim().length > 0 ? tagId : void 0;
+  }
+  return params.fallbackTagContexts[0];
+}
 function mapDiagReason(reason) {
   switch (String(reason)) {
     case "unknown_service":
@@ -4819,6 +5105,7 @@ function mapDiagReason(reason) {
   createFallbackEditor,
   createNodeIndex,
   filterServicesForVisibleGroup,
+  getAssignedServiceIds,
   getEligibleFallbacks,
   getFallbackRegistrationInfo,
   normalise,