@timeax/digital-service-engine 0.2.3 → 0.2.5

package/dist/schema/index.d.cts

@@ -68,6 +68,10 @@ type SnapshotContext = {
         requireConstraintFit: boolean;
     };
 };
+type OrderKindSource = {
+    nodeId: string;
+    nodeKind: "tag" | "field" | "option";
+};
 type OrderSnapshot = {
     version: "1";
     mode: "prod" | "dev";
@@ -94,6 +98,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;
@@ -171,7 +177,7 @@ type NodeRef = {
 };
 type NodeMap = Map<string, NodeRef>;
 
-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;
@@ -627,6 +633,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[]>;
@@ -981,4 +988,4 @@ type EditorSnapshot = {
 /** Exported alias so the schema generator can target an array */
 type AdminPolicies = DynamicRule[];
 
-export { type AdminPolicies, type BaseFieldUI, type ButtonValue, type CanvasEvents, type CanvasOptions, type CanvasState, type CatalogGroupNode, type CatalogId, type CatalogNode, type CatalogNodeBase, type CatalogNodeKind, type CatalogServiceId, type CatalogSmartGroupNode, type CatalogSmartRule, type CatalogViewMode, type Command, type CommentAnchor, type CommentId, type CommentMessage, type CommentNode, type CommentThread, type ConnectKind, type ConstraintKey, type DgpServiceCapability, type DgpServiceMap, type DraftWire, type DynamicRule, type EdgeKind, type EdgeRoute, type EdgeView, type EditorEvents, type EditorOptions, type EditorSnapshot, type FallbackCandidateCheck, type FallbackCheckReason, type FallbackCheckResult, type FallbackDiagnostics, type FallbackEditor, type FallbackEditorOptions, type FallbackEditorServiceMap, type FallbackEditorServiceRecord, type FallbackEditorState, type FallbackEligibleSource, type FallbackMutationOptions, type FallbackRegistration, type FallbackRegistrationScope, type FallbackScopeRef, type FallbackSettings, type Field, type FieldOption, type FieldType, type FieldValidationOp, type FieldValidationRule, type FieldValidationValueBy, type FieldWithTypedDefaults, type FlagKey, type FlowNode, type GraphEdge, type GraphNode, type GraphSnapshot, type IdType, type LayoutState, type NodeIdRef, type NodeKind, type NodePos, type NodePositions, type NodeView, type NoticeKind, type NoticeSeverity, type NoticeTarget, type NoticeType, type OrderSnapshot, type PricingRole, type QuantityMark, type QuantityRule, type RatePolicy, type Scalar, type ServiceCatalogState, type ServiceEstimates, type ServiceFallback, type ServiceFallbacks, type ServiceFlag, type ServiceFlags, type ServiceIdRef, type ServiceProps, type ServicePropsNotice, type ServiceWhereClause, type ServiceWhereOp, type SnapshotContext, type SpeedEstimate, type Tag, type ThreadId, type TimeRangeEstimate, type Ui, type UiAnyOf, type UiArray, type UiBoolean, type UiNumber, type UiObject, type UiString, type UiValue, type UtilityLineItem, type UtilityMark, type UtilityMode, type ValidationCode, type ValidationError, type ValidatorOptions, type Viewport, type WithQuantityDefault, createFallbackEditor };
+export { type AdminPolicies, type BaseFieldUI, type ButtonValue, type CanvasEvents, type CanvasOptions, type CanvasState, type CatalogGroupNode, type CatalogId, type CatalogNode, type CatalogNodeBase, type CatalogNodeKind, type CatalogServiceId, type CatalogSmartGroupNode, type CatalogSmartRule, type CatalogViewMode, type Command, type CommentAnchor, type CommentId, type CommentMessage, type CommentNode, type CommentThread, type ConnectKind, type ConstraintKey, type DgpServiceCapability, type DgpServiceMap, type DraftWire, type DynamicRule, type EdgeKind, type EdgeRoute, type EdgeView, type EditorEvents, type EditorOptions, type EditorSnapshot, type FallbackCandidateCheck, type FallbackCheckReason, type FallbackCheckResult, type FallbackDiagnostics, type FallbackEditor, type FallbackEditorOptions, type FallbackEditorServiceMap, type FallbackEditorServiceRecord, type FallbackEditorState, type FallbackEligibleSource, type FallbackMutationOptions, type FallbackRegistration, type FallbackRegistrationScope, type FallbackScopeRef, type FallbackSettings, type Field, type FieldOption, type FieldType, type FieldValidationOp, type FieldValidationRule, type FieldValidationValueBy, type FieldWithTypedDefaults, type FlagKey, type FlowNode, type GraphEdge, type GraphNode, type GraphSnapshot, type IdType, type LayoutState, type NodeIdRef, type NodeKind, type NodePos, type NodePositions, type NodeView, type NoticeKind, type NoticeSeverity, type NoticeTarget, type NoticeType, type OrderKindSource, type OrderSnapshot, type PricingRole, type QuantityMark, type QuantityRule, type RatePolicy, type Scalar, type ServiceCatalogState, type ServiceEstimates, type ServiceFallback, type ServiceFallbacks, type ServiceFlag, type ServiceFlags, type ServiceIdRef, type ServiceProps, type ServicePropsNotice, type ServiceWhereClause, type ServiceWhereOp, type SnapshotContext, type SpeedEstimate, type Tag, type ThreadId, type TimeRangeEstimate, type Ui, type UiAnyOf, type UiArray, type UiBoolean, type UiNumber, type UiObject, type UiString, type UiValue, type UtilityLineItem, type UtilityMark, type UtilityMode, type ValidationCode, type ValidationError, type ValidatorOptions, type Viewport, type WithQuantityDefault, createFallbackEditor };

package/dist/schema/index.d.ts

@@ -68,6 +68,10 @@ type SnapshotContext = {
         requireConstraintFit: boolean;
     };
 };
+type OrderKindSource = {
+    nodeId: string;
+    nodeKind: "tag" | "field" | "option";
+};
 type OrderSnapshot = {
     version: "1";
     mode: "prod" | "dev";
@@ -94,6 +98,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;
@@ -171,7 +177,7 @@ type NodeRef = {
 };
 type NodeMap = Map<string, NodeRef>;
 
-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;
@@ -627,6 +633,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[]>;
@@ -981,4 +988,4 @@ type EditorSnapshot = {
 /** Exported alias so the schema generator can target an array */
 type AdminPolicies = DynamicRule[];
 
-export { type AdminPolicies, type BaseFieldUI, type ButtonValue, type CanvasEvents, type CanvasOptions, type CanvasState, type CatalogGroupNode, type CatalogId, type CatalogNode, type CatalogNodeBase, type CatalogNodeKind, type CatalogServiceId, type CatalogSmartGroupNode, type CatalogSmartRule, type CatalogViewMode, type Command, type CommentAnchor, type CommentId, type CommentMessage, type CommentNode, type CommentThread, type ConnectKind, type ConstraintKey, type DgpServiceCapability, type DgpServiceMap, type DraftWire, type DynamicRule, type EdgeKind, type EdgeRoute, type EdgeView, type EditorEvents, type EditorOptions, type EditorSnapshot, type FallbackCandidateCheck, type FallbackCheckReason, type FallbackCheckResult, type FallbackDiagnostics, type FallbackEditor, type FallbackEditorOptions, type FallbackEditorServiceMap, type FallbackEditorServiceRecord, type FallbackEditorState, type FallbackEligibleSource, type FallbackMutationOptions, type FallbackRegistration, type FallbackRegistrationScope, type FallbackScopeRef, type FallbackSettings, type Field, type FieldOption, type FieldType, type FieldValidationOp, type FieldValidationRule, type FieldValidationValueBy, type FieldWithTypedDefaults, type FlagKey, type FlowNode, type GraphEdge, type GraphNode, type GraphSnapshot, type IdType, type LayoutState, type NodeIdRef, type NodeKind, type NodePos, type NodePositions, type NodeView, type NoticeKind, type NoticeSeverity, type NoticeTarget, type NoticeType, type OrderSnapshot, type PricingRole, type QuantityMark, type QuantityRule, type RatePolicy, type Scalar, type ServiceCatalogState, type ServiceEstimates, type ServiceFallback, type ServiceFallbacks, type ServiceFlag, type ServiceFlags, type ServiceIdRef, type ServiceProps, type ServicePropsNotice, type ServiceWhereClause, type ServiceWhereOp, type SnapshotContext, type SpeedEstimate, type Tag, type ThreadId, type TimeRangeEstimate, type Ui, type UiAnyOf, type UiArray, type UiBoolean, type UiNumber, type UiObject, type UiString, type UiValue, type UtilityLineItem, type UtilityMark, type UtilityMode, type ValidationCode, type ValidationError, type ValidatorOptions, type Viewport, type WithQuantityDefault, createFallbackEditor };
+export { type AdminPolicies, type BaseFieldUI, type ButtonValue, type CanvasEvents, type CanvasOptions, type CanvasState, type CatalogGroupNode, type CatalogId, type CatalogNode, type CatalogNodeBase, type CatalogNodeKind, type CatalogServiceId, type CatalogSmartGroupNode, type CatalogSmartRule, type CatalogViewMode, type Command, type CommentAnchor, type CommentId, type CommentMessage, type CommentNode, type CommentThread, type ConnectKind, type ConstraintKey, type DgpServiceCapability, type DgpServiceMap, type DraftWire, type DynamicRule, type EdgeKind, type EdgeRoute, type EdgeView, type EditorEvents, type EditorOptions, type EditorSnapshot, type FallbackCandidateCheck, type FallbackCheckReason, type FallbackCheckResult, type FallbackDiagnostics, type FallbackEditor, type FallbackEditorOptions, type FallbackEditorServiceMap, type FallbackEditorServiceRecord, type FallbackEditorState, type FallbackEligibleSource, type FallbackMutationOptions, type FallbackRegistration, type FallbackRegistrationScope, type FallbackScopeRef, type FallbackSettings, type Field, type FieldOption, type FieldType, type FieldValidationOp, type FieldValidationRule, type FieldValidationValueBy, type FieldWithTypedDefaults, type FlagKey, type FlowNode, type GraphEdge, type GraphNode, type GraphSnapshot, type IdType, type LayoutState, type NodeIdRef, type NodeKind, type NodePos, type NodePositions, type NodeView, type NoticeKind, type NoticeSeverity, type NoticeTarget, type NoticeType, type OrderKindSource, type OrderSnapshot, type PricingRole, type QuantityMark, type QuantityRule, type RatePolicy, type Scalar, type ServiceCatalogState, type ServiceEstimates, type ServiceFallback, type ServiceFallbacks, type ServiceFlag, type ServiceFlags, type ServiceIdRef, type ServiceProps, type ServicePropsNotice, type ServiceWhereClause, type ServiceWhereOp, type SnapshotContext, type SpeedEstimate, type Tag, type ThreadId, type TimeRangeEstimate, type Ui, type UiAnyOf, type UiArray, type UiBoolean, type UiNumber, type UiObject, type UiString, type UiValue, type UtilityLineItem, type UtilityMark, type UtilityMode, type ValidationCode, type ValidationError, type ValidatorOptions, type Viewport, type WithQuantityDefault, createFallbackEditor };

package/dist/workspace/index.cjs

@@ -3527,6 +3527,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));
@@ -3538,6 +3539,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)) && {
@@ -3748,6 +3750,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 = {};
@@ -4566,6 +4577,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) {
@@ -5889,6 +6023,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",
@@ -6221,6 +6356,7 @@ function validate(props, ctx = {}) {
   validateStructure(v);
   validateIdentity(v);
   validateOptionMaps(v);
+  validateOrderKinds(v);
   v.fieldsVisibleUnder = createFieldsVisibleUnder(v);
   const visSim = readVisibilitySimOpts(options);
   validateVisibility(v, visSim);
@@ -8143,6 +8279,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;
@@ -9123,6 +9341,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 (0, import_lodash_es4.cloneDeep)(this.catalog);
   }