@timeax/digital-service-engine 0.2.3 → 0.2.5

package/dist/react/index.d.cts

@@ -78,6 +78,10 @@ type SnapshotContext = {
         requireConstraintFit: boolean;
     };
 };
+type OrderKindSource = {
+    nodeId: string;
+    nodeKind: "tag" | "field" | "option";
+};
 type OrderSnapshot = {
     version: "1";
     mode: "prod" | "dev";
@@ -104,6 +108,8 @@ type OrderSnapshot = {
     };
     min: number;
     max: number;
+    orderKind?: string | null;
+    orderKindSource?: OrderKindSource | null;
     services: Array<string | number>;
     serviceMap: Record<string, Array<string | number>>;
     fallbacks?: ServiceFallbacks;
@@ -181,7 +187,7 @@ type NodeRef$1 = {
 };
 type NodeMap = Map<string, NodeRef$1>;
 
-type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "rate_coherence_violation" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context" | "field_validation_invalid_rule" | "field_validation_invalid_op" | "field_validation_eval_missing_code" | "field_validation_between_missing_bounds" | "field_validation_match_missing_pattern";
+type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "rate_coherence_violation" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context" | "field_validation_invalid_rule" | "field_validation_invalid_op" | "field_validation_eval_missing_code" | "field_validation_between_missing_bounds" | "field_validation_match_missing_pattern" | "multiple_order_kinds_selected";
 type ValidationError = {
     code: ValidationCode;
     message: string;
@@ -505,6 +511,7 @@ type Tag = {
 };
 type ServiceProps = {
     order_for_tags?: Record<string, string[]>;
+    orderKinds?: Record<string, string>;
     filters: Tag[];
     fields: Field[];
     includes_for_buttons?: Record<string, string[]>;
@@ -1587,6 +1594,9 @@ declare class Editor {
     getFieldValidation(id: string): FieldValidationRule[] | undefined;
     setFieldValidation(id: string, rules: unknown): void;
     clearFieldValidation(id: string): void;
+    setOrderKind(nodeId: string, kind: string): void;
+    deleteOrderKind(nodeId: string): void;
+    pruneKind(kind: string): number;
     getCatalog(): ServiceCatalogState | undefined;
     setCatalog(next?: ServiceCatalogState): void;
     clearCatalog(): void;

package/dist/react/index.d.ts

@@ -78,6 +78,10 @@ type SnapshotContext = {
         requireConstraintFit: boolean;
     };
 };
+type OrderKindSource = {
+    nodeId: string;
+    nodeKind: "tag" | "field" | "option";
+};
 type OrderSnapshot = {
     version: "1";
     mode: "prod" | "dev";
@@ -104,6 +108,8 @@ type OrderSnapshot = {
     };
     min: number;
     max: number;
+    orderKind?: string | null;
+    orderKindSource?: OrderKindSource | null;
     services: Array<string | number>;
     serviceMap: Record<string, Array<string | number>>;
     fallbacks?: ServiceFallbacks;
@@ -181,7 +187,7 @@ type NodeRef$1 = {
 };
 type NodeMap = Map<string, NodeRef$1>;
 
-type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "rate_coherence_violation" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context" | "field_validation_invalid_rule" | "field_validation_invalid_op" | "field_validation_eval_missing_code" | "field_validation_between_missing_bounds" | "field_validation_match_missing_pattern";
+type ValidationCode = "root_missing" | "cycle_in_tags" | "bad_bind_reference" | "duplicate_id" | "duplicate_tag_label" | "duplicate_field_name" | "label_missing" | "duplicate_visible_label" | "bad_option_key" | "option_include_exclude_conflict" | "service_field_missing_service_id" | "user_input_field_has_service_option" | "rate_mismatch_across_base" | "rate_coherence_violation" | "utility_without_base" | "unsupported_constraint" | "constraint_contradiction" | "custom_component_missing" | "policy_violation" | "field_unbound" | "constraint_overridden" | "unsupported_constraint_option" | "custom_component_unresolvable" | "quantity_multiple_markers" | "utility_with_service_id" | "utility_missing_rate" | "utility_invalid_mode" | "fallback_bad_node" | "fallback_unknown_service" | "fallback_cycle" | "fallback_no_primary" | "fallback_rate_violation" | "fallback_constraint_mismatch" | "fallback_no_tag_context" | "field_validation_invalid_rule" | "field_validation_invalid_op" | "field_validation_eval_missing_code" | "field_validation_between_missing_bounds" | "field_validation_match_missing_pattern" | "multiple_order_kinds_selected";
 type ValidationError = {
     code: ValidationCode;
     message: string;
@@ -505,6 +511,7 @@ type Tag = {
 };
 type ServiceProps = {
     order_for_tags?: Record<string, string[]>;
+    orderKinds?: Record<string, string>;
     filters: Tag[];
     fields: Field[];
     includes_for_buttons?: Record<string, string[]>;
@@ -1587,6 +1594,9 @@ declare class Editor {
     getFieldValidation(id: string): FieldValidationRule[] | undefined;
     setFieldValidation(id: string, rules: unknown): void;
     clearFieldValidation(id: string): void;
+    setOrderKind(nodeId: string, kind: string): void;
+    deleteOrderKind(nodeId: string): void;
+    pruneKind(kind: string): number;
     getCatalog(): ServiceCatalogState | undefined;
     setCatalog(next?: ServiceCatalogState): void;
     clearCatalog(): void;

package/dist/react/index.js

@@ -666,6 +666,7 @@ function normalise(input, opts = {}) {
   const excludes_for_buttons = toStringArrayMap(
     obj.excludes_for_buttons
   );
+  const orderKinds = toStringMap(obj.orderKinds);
   const notices = toNoticeArray(obj.notices);
   let filters = rawFilters.map((t) => coerceTag(t, constraints));
   const fields = rawFields.map((f) => coerceField(f, defRole));
@@ -677,6 +678,7 @@ function normalise(input, opts = {}) {
     filters,
     fields,
     order_for_tags: obj.order_for_tags,
+    ...isNonEmpty(orderKinds) && { orderKinds },
     ...isNonEmpty(includes_for_buttons) && { includes_for_buttons },
     ...isNonEmpty(excludes_for_buttons) && { excludes_for_buttons },
     ...fallbacks && (isNonEmpty(fallbacks.nodes) || isNonEmpty(fallbacks.global)) && {
@@ -887,6 +889,15 @@ function normaliseBindId(bind) {
   }
   return void 0;
 }
+function toStringMap(src) {
+  if (!src || typeof src !== "object") return void 0;
+  const out = {};
+  for (const [k, v] of Object.entries(src)) {
+    if (!k || typeof v !== "string") continue;
+    out[k] = v;
+  }
+  return Object.keys(out).length ? out : void 0;
+}
 function toStringArrayMap(src) {
   if (!src || typeof src !== "object") return void 0;
   const out = {};
@@ -1705,6 +1716,129 @@ function validateOptionMaps(v) {
   }
 }
 
+// src/utils/order-kind.ts
+function normalizeSelectedTriggerKey(key, nodeMap) {
+  if (!key) return void 0;
+  const compositeIdx = key.indexOf("::");
+  if (compositeIdx !== -1) {
+    const fieldId = key.slice(0, compositeIdx).trim();
+    const optionId = key.slice(compositeIdx + 2).trim();
+    if (optionId) {
+      const optionRef = nodeMap.get(optionId);
+      if ((optionRef == null ? void 0 : optionRef.kind) === "option") {
+        return { nodeId: optionRef.id, nodeKind: "option" };
+      }
+    }
+    if (fieldId) {
+      const fieldRef = nodeMap.get(fieldId);
+      if ((fieldRef == null ? void 0 : fieldRef.kind) === "field") {
+        return { nodeId: fieldRef.id, nodeKind: "field" };
+      }
+    }
+    return void 0;
+  }
+  const ref = nodeMap.get(key);
+  if (!ref) return void 0;
+  if (ref.kind !== "field" && ref.kind !== "option") return void 0;
+  return { nodeId: ref.id, nodeKind: ref.kind };
+}
+function normalizeSelectedOrderKindTriggers(selectedTriggerKeys, nodeMap) {
+  if (!selectedTriggerKeys) return [];
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const rawKey of selectedTriggerKeys) {
+    const key = String(rawKey != null ? rawKey : "");
+    const normalized = normalizeSelectedTriggerKey(key, nodeMap);
+    if (!normalized) continue;
+    const dedupeKey = `${normalized.nodeKind}:${normalized.nodeId}`;
+    if (seen.has(dedupeKey)) continue;
+    seen.add(dedupeKey);
+    out.push(normalized);
+  }
+  return out;
+}
+function resolveOrderKind(params) {
+  var _a, _b;
+  const nodeMap = (_a = params.nodeMap) != null ? _a : buildNodeMap(params.props);
+  const orderKinds = (_b = params.props.orderKinds) != null ? _b : {};
+  const normalizedSelected = normalizeSelectedOrderKindTriggers(
+    params.selectedTriggerKeys,
+    nodeMap
+  );
+  const selectedKindToSource = /* @__PURE__ */ new Map();
+  const selectedNodeIdsForKinds = /* @__PURE__ */ new Map();
+  for (const trigger of normalizedSelected) {
+    const mappedKind = orderKinds[trigger.nodeId];
+    if (typeof mappedKind !== "string") continue;
+    if (!selectedKindToSource.has(mappedKind)) {
+      selectedKindToSource.set(mappedKind, {
+        nodeId: trigger.nodeId,
+        nodeKind: trigger.nodeKind
+      });
+    }
+    if (!selectedNodeIdsForKinds.has(mappedKind)) {
+      selectedNodeIdsForKinds.set(mappedKind, /* @__PURE__ */ new Set());
+    }
+    selectedNodeIdsForKinds.get(mappedKind).add(trigger.nodeId);
+  }
+  const selectedKinds = Array.from(selectedKindToSource.keys());
+  if (selectedKinds.length > 1) {
+    const conflictingNodeIds = Array.from(selectedNodeIdsForKinds.values()).flatMap((ids) => Array.from(ids)).filter((id, idx, arr) => arr.indexOf(id) === idx);
+    return {
+      kind: null,
+      source: null,
+      error: "multiple_order_kinds_selected",
+      conflictingKinds: selectedKinds,
+      conflictingNodeIds
+    };
+  }
+  if (selectedKinds.length === 1) {
+    const selectedKind = selectedKinds[0];
+    return {
+      kind: selectedKind,
+      source: selectedKindToSource.get(selectedKind)
+    };
+  }
+  const activeTagId = params.activeTagId;
+  if (activeTagId) {
+    const tagKind = orderKinds[activeTagId];
+    if (typeof tagKind === "string") {
+      return {
+        kind: tagKind,
+        source: { nodeId: activeTagId, nodeKind: "tag" }
+      };
+    }
+  }
+  return { kind: null, source: null };
+}
+
+// src/core/validate/steps/order-kinds.ts
+function validateOrderKinds(v) {
+  var _a, _b, _c;
+  const selectedTriggerKeys = Array.from((_a = v.selectedKeys) != null ? _a : []);
+  if (!selectedTriggerKeys.length) return;
+  const resolved = resolveOrderKind({
+    props: v.props,
+    selectedTriggerKeys,
+    nodeMap: v.nodeMap
+  });
+  if (resolved.error !== "multiple_order_kinds_selected") return;
+  const conflicts = (_b = resolved.conflictingKinds) != null ? _b : [];
+  const affected = (_c = resolved.conflictingNodeIds) != null ? _c : [];
+  v.errors.push({
+    code: "multiple_order_kinds_selected",
+    severity: "error",
+    message: "Multiple selected triggers resolve to different order kinds. Select triggers that resolve to a single order kind.",
+    details: withAffected(
+      {
+        conflictingKinds: conflicts,
+        conflictingNodeIds: affected
+      },
+      affected
+    )
+  });
+}
+
 // src/core/validate/steps/service-vs-input.ts
 function validateServiceVsUserInput(v) {
   for (const f of v.fields) {
@@ -3033,6 +3167,7 @@ var BuilderImpl = class {
     const out = {
       filters: this.props.filters.slice(),
       fields,
+      ...this.props.orderKinds ? { orderKinds: this.props.orderKinds } : {},
       ...includes_for_buttons && { includes_for_buttons },
       ...excludes_for_buttons && { excludes_for_buttons },
       schema_version: (_e = this.props.schema_version) != null ? _e : "1.0",
@@ -3365,6 +3500,7 @@ function validate(props, ctx = {}) {
   validateStructure(v);
   validateIdentity(v);
   validateOptionMaps(v);
+  validateOrderKinds(v);
   v.fieldsVisibleUnder = createFieldsVisibleUnder(v);
   const visSim = readVisibilitySimOpts(options);
   validateVisibility(v, visSim);
@@ -4713,6 +4849,13 @@ function buildOrderSnapshot(props, builder, selection, services, settings = {})
     fieldById
   );
   const { min, max } = resolveMinMax(servicesList, services);
+  const maybeNodeMap = typeof builder.getNodeMap === "function" ? builder.getNodeMap() : void 0;
+  const resolvedOrderKind = resolveOrderKind({
+    props,
+    activeTagId: tagId,
+    selectedTriggerKeys: selectedButtonKeys,
+    nodeMap: maybeNodeMap
+  });
   const prunedFallbacks = pruneFallbacksConservative(
     props.fallbacks,
     { tagId, constraints: tagConstraints, serviceMap, servicesList },
@@ -4768,6 +4911,8 @@ function buildOrderSnapshot(props, builder, selection, services, settings = {})
     },
     min,
     max: max != null ? max : min,
+    orderKind: resolvedOrderKind.kind,
+    orderKindSource: resolvedOrderKind.source,
     quantity,
     quantitySource,
     services: servicesList,
@@ -6789,6 +6934,88 @@ function normalizeQuantityRule(input) {
   return out;
 }
 
+// src/react/canvas/editor/editor-order-kinds.ts
+function normalizeKind(kind) {
+  const next = String(kind != null ? kind : "").trim();
+  if (!next) {
+    throw new Error("setOrderKind: kind must be a non-empty string");
+  }
+  return next;
+}
+function assertCanonicalNodeId(ctx, nodeId) {
+  const id = String(nodeId != null ? nodeId : "").trim();
+  if (!id) throw new Error("setOrderKind: nodeId is required");
+  if (id.includes("::")) {
+    throw new Error(
+      "setOrderKind: composite/internal trigger keys are not allowed; use canonical tag/field/option ids"
+    );
+  }
+  if (!ctx.isTagId(id) && !ctx.isFieldId(id) && !ctx.isOptionId(id)) {
+    throw new Error(
+      `setOrderKind: node id '${id}' is not a known tag, field, or option`
+    );
+  }
+  if (ctx.isFieldId(id)) {
+    const node = ctx.getNode(id);
+    if (node.kind !== "field" || !isActualButtonField(node.data)) {
+      throw new Error(
+        `setOrderKind: field '${id}' must be a button field without options`
+      );
+    }
+  }
+}
+function setOrderKind(ctx, nodeId, kind) {
+  const id = String(nodeId != null ? nodeId : "").trim();
+  const nextKind = normalizeKind(kind);
+  assertCanonicalNodeId(ctx, id);
+  ctx.exec({
+    name: "setOrderKind",
+    do: () => ctx.patchProps((p) => {
+      if (!p.orderKinds) p.orderKinds = {};
+      p.orderKinds[id] = nextKind;
+    }),
+    undo: () => ctx.undo()
+  });
+}
+function deleteOrderKind(ctx, nodeId) {
+  const id = String(nodeId != null ? nodeId : "").trim();
+  if (!id) return;
+  ctx.exec({
+    name: "deleteOrderKind",
+    do: () => ctx.patchProps((p) => {
+      if (!p.orderKinds || !Object.prototype.hasOwnProperty.call(p.orderKinds, id)) {
+        return;
+      }
+      delete p.orderKinds[id];
+      if (!Object.keys(p.orderKinds).length) {
+        delete p.orderKinds;
+      }
+    }),
+    undo: () => ctx.undo()
+  });
+}
+function pruneOrderKind(ctx, kind) {
+  const target = normalizeKind(kind);
+  let removedCount = 0;
+  ctx.exec({
+    name: "pruneOrderKind",
+    do: () => ctx.patchProps((p) => {
+      if (!p.orderKinds) return;
+      removedCount = 0;
+      for (const [nodeId, mapped] of Object.entries(p.orderKinds)) {
+        if (mapped !== target) continue;
+        delete p.orderKinds[nodeId];
+        removedCount++;
+      }
+      if (!Object.keys(p.orderKinds).length) {
+        delete p.orderKinds;
+      }
+    }),
+    undo: () => ctx.undo()
+  });
+  return removedCount;
+}
+
 // src/react/canvas/editor/editor-relations.ts
 function wouldCreateTagCycle(_ctx, p, parentId, childId) {
   var _a, _b;
@@ -7769,6 +7996,15 @@ var Editor = class {
   clearFieldValidation(id) {
     return clearFieldValidation(this.moduleCtx(), id);
   }
+  setOrderKind(nodeId, kind) {
+    return setOrderKind(this.moduleCtx(), nodeId, kind);
+  }
+  deleteOrderKind(nodeId) {
+    return deleteOrderKind(this.moduleCtx(), nodeId);
+  }
+  pruneKind(kind) {
+    return pruneOrderKind(this.moduleCtx(), kind);
+  }
   getCatalog() {
     return cloneDeep4(this.catalog);
   }