@timeax/digital-service-engine 0.3.5 → 0.3.6

package/dist/workspace/index.d.cts

@@ -59,7 +59,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" | "multiple_order_kinds_selected";
+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" | "bad_option_effect_key" | "bad_option_effect_target" | "bad_option_effect_option" | "option_include_exclude_conflict" | "visibility_dependency_cycle" | "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;
@@ -276,6 +276,22 @@ type FieldOption = {
     service_id?: ServiceIdRef;
     pricing_role?: PricingRole;
     meta?: Record<string, unknown> & UtilityMark & WithQuantityDefault;
+    children?: FieldOption[];
+};
+type OptionEffectForButton = {
+    /**
+     * If true, selecting this button/option may force the target field visible.
+     * If false/missing, the option filter only applies when the target field is already visible.
+     */
+    forceVisible?: boolean;
+    /**
+     * If present, only these option ids remain visible.
+     */
+    include?: string[];
+    /**
+     * Removed after include is applied.
+     */
+    exclude?: string[];
 };
 type Field = BaseFieldUI & {
     id: string;
@@ -329,6 +345,7 @@ type ServiceProps = {
     fields: Field[];
     includes_for_buttons?: Record<string, string[]>;
     excludes_for_buttons?: Record<string, string[]>;
+    option_effects_for_buttons?: Record<string, Record<string, OptionEffectForButton>>;
     schema_version?: string;
     fallbacks?: ServiceFallback;
     name?: string;
@@ -424,6 +441,12 @@ type CommentThread = {
     _sync?: "pending" | "synced" | "error";
 };
 
+type ResolvedVisibility = {
+    fieldIds: string[];
+    optionsByFieldId: Record<string, string[]>;
+    forcedFieldIds: string[];
+};
+
 /** Options you can set on the builder (used for validation/visibility) */
 type BuilderOptions = Omit<ValidatorOptions, "serviceMap"> & {
     serviceMap?: DgpServiceMap;
@@ -449,6 +472,8 @@ interface Builder {
      * NOTE: keys are “button ids”: either option.id or field.id for option-less buttons.
      */
     visibleFields(tagId: string, selectedOptionKeys?: string[]): string[];
+    /** Compute field ids plus option visibility under a tag. */
+    resolveVisibility(tagId: string, selectedOptionKeys?: string[]): ResolvedVisibility;
     /** Update builder options (validator context etc.) */
     setOptions(patch: Partial<BuilderOptions>): void;
     /** Access the current props (already normalised) */
@@ -570,6 +595,8 @@ type VisibleGroup = {
     tag?: Tag;
     fields: Field[];
     fieldIds: string[];
+    optionsByFieldId?: Record<string, string[]>;
+    forcedFieldIds?: string[];
     parentTags?: Tag[];
     childrenTags?: Tag[];
     /** In order of selection: tag base (unless overridden) then selected options */
@@ -619,11 +646,10 @@ declare class Selection {
      * What counts as a "button selection" (trigger key):
      * - field key where the field has button === true (e.g. "f:dripfeed")
      * - option key (e.g. "o:fast")
-     * - composite key "fieldId::optionId" (e.g. "f:speed::o:fast")
      *
      * Grouping:
      * - button-field trigger groups under its own fieldId
-     * - option/composite groups under the option's owning fieldId (from nodeMap)
+     * - option trigger groups under the option's owning fieldId (from nodeMap)
      *
      * Deterministic:
      * - preserves selection insertion order
@@ -634,7 +660,6 @@ declare class Selection {
      * Returns only selection keys that are valid "trigger buttons":
      * - field keys where field.button === true
      * - option keys
-     * - composite keys "fieldId::optionId" (validated by optionId)
      * Excludes tags and non-button fields.
      */
     selectedButtons(): string[];
@@ -644,6 +669,7 @@ declare class Selection {
     private computeGroupForTag;
     private addServiceByRole;
     private findOptionById;
+    private isSelectedOptionVisible;
 }
 
 type CatalogId = string;
@@ -1781,11 +1807,18 @@ type Adapter = {
     getInputPropsFromField?: (props: AdapterCtx) => any;
     toValue?: (value: any) => any;
 };
+type InputChildOptionCapability = {
+    supported?: boolean;
+    autoCreate?: boolean;
+    defaultLabel?: string;
+    defaultValue?: string | number;
+};
 type InputOptionCapability = {
     supported?: boolean;
     autoCreate?: boolean;
     defaultLabel?: string;
     defaultValue?: string | number;
+    children?: InputChildOptionCapability;
 };
 type InputMultiCapability = {
     supported?: boolean;
@@ -1926,6 +1959,14 @@ declare class Editor {
     clearFieldQuantityRule(id: string): void;
     include(receiverId: string, idOrIds: string | string[]): void;
     exclude(receiverId: string, idOrIds: string | string[]): void;
+    setOptionEffect(triggerId: string, targetFieldId: string, effect: OptionEffectForButton | undefined | null): void;
+    patchOptionEffect(triggerId: string, targetFieldId: string, patch: OptionEffectForButton): void;
+    clearOptionEffect(triggerId: string, targetFieldId: string): void;
+    clearOptionEffectsForTrigger(triggerId: string): void;
+    clearOptionEffectsForTarget(targetFieldId: string): void;
+    addOptionEffectOptions(triggerId: string, targetFieldId: string, kind: "include" | "exclude", optionIds: readonly string[]): void;
+    removeOptionEffectOptions(triggerId: string, targetFieldId: string, kind: "include" | "exclude", optionIds: readonly string[]): void;
+    setOptionEffectForceVisible(triggerId: string, targetFieldId: string, forceVisible: boolean | undefined): void;
     connect(kind: WireKind, fromId: string, toId: string): void;
     disconnect(kind: WireKind, fromId: string, toId: string): void;
     setConstraint(tagId: string, flag: string, value: boolean | undefined): void;

package/dist/workspace/index.d.ts

@@ -59,7 +59,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" | "multiple_order_kinds_selected";
+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" | "bad_option_effect_key" | "bad_option_effect_target" | "bad_option_effect_option" | "option_include_exclude_conflict" | "visibility_dependency_cycle" | "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;
@@ -276,6 +276,22 @@ type FieldOption = {
     service_id?: ServiceIdRef;
     pricing_role?: PricingRole;
     meta?: Record<string, unknown> & UtilityMark & WithQuantityDefault;
+    children?: FieldOption[];
+};
+type OptionEffectForButton = {
+    /**
+     * If true, selecting this button/option may force the target field visible.
+     * If false/missing, the option filter only applies when the target field is already visible.
+     */
+    forceVisible?: boolean;
+    /**
+     * If present, only these option ids remain visible.
+     */
+    include?: string[];
+    /**
+     * Removed after include is applied.
+     */
+    exclude?: string[];
 };
 type Field = BaseFieldUI & {
     id: string;
@@ -329,6 +345,7 @@ type ServiceProps = {
     fields: Field[];
     includes_for_buttons?: Record<string, string[]>;
     excludes_for_buttons?: Record<string, string[]>;
+    option_effects_for_buttons?: Record<string, Record<string, OptionEffectForButton>>;
     schema_version?: string;
     fallbacks?: ServiceFallback;
     name?: string;
@@ -424,6 +441,12 @@ type CommentThread = {
     _sync?: "pending" | "synced" | "error";
 };
 
+type ResolvedVisibility = {
+    fieldIds: string[];
+    optionsByFieldId: Record<string, string[]>;
+    forcedFieldIds: string[];
+};
+
 /** Options you can set on the builder (used for validation/visibility) */
 type BuilderOptions = Omit<ValidatorOptions, "serviceMap"> & {
     serviceMap?: DgpServiceMap;
@@ -449,6 +472,8 @@ interface Builder {
      * NOTE: keys are “button ids”: either option.id or field.id for option-less buttons.
      */
     visibleFields(tagId: string, selectedOptionKeys?: string[]): string[];
+    /** Compute field ids plus option visibility under a tag. */
+    resolveVisibility(tagId: string, selectedOptionKeys?: string[]): ResolvedVisibility;
     /** Update builder options (validator context etc.) */
     setOptions(patch: Partial<BuilderOptions>): void;
     /** Access the current props (already normalised) */
@@ -570,6 +595,8 @@ type VisibleGroup = {
     tag?: Tag;
     fields: Field[];
     fieldIds: string[];
+    optionsByFieldId?: Record<string, string[]>;
+    forcedFieldIds?: string[];
     parentTags?: Tag[];
     childrenTags?: Tag[];
     /** In order of selection: tag base (unless overridden) then selected options */
@@ -619,11 +646,10 @@ declare class Selection {
      * What counts as a "button selection" (trigger key):
      * - field key where the field has button === true (e.g. "f:dripfeed")
      * - option key (e.g. "o:fast")
-     * - composite key "fieldId::optionId" (e.g. "f:speed::o:fast")
      *
      * Grouping:
      * - button-field trigger groups under its own fieldId
-     * - option/composite groups under the option's owning fieldId (from nodeMap)
+     * - option trigger groups under the option's owning fieldId (from nodeMap)
      *
      * Deterministic:
      * - preserves selection insertion order
@@ -634,7 +660,6 @@ declare class Selection {
      * Returns only selection keys that are valid "trigger buttons":
      * - field keys where field.button === true
      * - option keys
-     * - composite keys "fieldId::optionId" (validated by optionId)
      * Excludes tags and non-button fields.
      */
     selectedButtons(): string[];
@@ -644,6 +669,7 @@ declare class Selection {
     private computeGroupForTag;
     private addServiceByRole;
     private findOptionById;
+    private isSelectedOptionVisible;
 }
 
 type CatalogId = string;
@@ -1781,11 +1807,18 @@ type Adapter = {
     getInputPropsFromField?: (props: AdapterCtx) => any;
     toValue?: (value: any) => any;
 };
+type InputChildOptionCapability = {
+    supported?: boolean;
+    autoCreate?: boolean;
+    defaultLabel?: string;
+    defaultValue?: string | number;
+};
 type InputOptionCapability = {
     supported?: boolean;
     autoCreate?: boolean;
     defaultLabel?: string;
     defaultValue?: string | number;
+    children?: InputChildOptionCapability;
 };
 type InputMultiCapability = {
     supported?: boolean;
@@ -1926,6 +1959,14 @@ declare class Editor {
     clearFieldQuantityRule(id: string): void;
     include(receiverId: string, idOrIds: string | string[]): void;
     exclude(receiverId: string, idOrIds: string | string[]): void;
+    setOptionEffect(triggerId: string, targetFieldId: string, effect: OptionEffectForButton | undefined | null): void;
+    patchOptionEffect(triggerId: string, targetFieldId: string, patch: OptionEffectForButton): void;
+    clearOptionEffect(triggerId: string, targetFieldId: string): void;
+    clearOptionEffectsForTrigger(triggerId: string): void;
+    clearOptionEffectsForTarget(targetFieldId: string): void;
+    addOptionEffectOptions(triggerId: string, targetFieldId: string, kind: "include" | "exclude", optionIds: readonly string[]): void;
+    removeOptionEffectOptions(triggerId: string, targetFieldId: string, kind: "include" | "exclude", optionIds: readonly string[]): void;
+    setOptionEffectForceVisible(triggerId: string, targetFieldId: string, forceVisible: boolean | undefined): void;
     connect(kind: WireKind, fromId: string, toId: string): void;
     disconnect(kind: WireKind, fromId: string, toId: string): void;
     setConstraint(tagId: string, flag: string, value: boolean | undefined): void;