@timeax/digital-service-engine 0.3.4 → 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;
@@ -186,6 +186,75 @@ interface BaseFieldUI {
     /** Host-defined prop names → runtime default values (untyped base) */
     defaults?: Record<string, unknown>;
 }
+type Ui = (UiString | UiNumber | UiBoolean | UiAnyOf | UiArray | UiObject) & {
+    description: string;
+    label: string;
+};
+/** string */
+interface UiString {
+    type: "string";
+    enum?: string[];
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+}
+/** number */
+interface UiNumber {
+    type: "number";
+    minimum?: number;
+    maximum?: number;
+    multipleOf?: number;
+}
+/** boolean */
+interface UiBoolean {
+    type: "boolean";
+}
+/** enumerated choices */
+interface UiAnyOf {
+    type: "anyOf";
+    multiple?: boolean;
+    items: Array<{
+        type: "string" | "number" | "boolean";
+        title?: string;
+        description?: string;
+        value: string | number | boolean;
+    }>;
+}
+/** arrays: homogeneous (item) or tuple (items) */
+interface UiArray {
+    type: "array";
+    label: string;
+    description: string;
+    item?: Ui;
+    items?: Ui[];
+    editable?: boolean;
+    /**
+     * Optional: allowed shapes for new items.
+     * Key = label shown in UI picker
+     * Value = schema for the new element
+     */
+    shape?: Record<string, Ui>;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+}
+/** objects: nested props */
+interface UiObject {
+    type: "object";
+    label: string;
+    description: string;
+    editable?: boolean;
+    fields: Record<string, Ui>;
+    /**
+     * Optional: allowed shapes for dynamically added keys.
+     * Key = human-readable name shown in UI picker
+     * Value = schema applied to the value of the new key
+     */
+    shape?: Record<string, Ui>;
+    required?: string[];
+    order?: string[];
+}
 type FieldValidationValueBy = "value" | "length" | "eval";
 type FieldValidationOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "between" | "in" | "nin" | "truthy" | "falsy" | "match";
 type FieldValidationRule = {
@@ -207,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;
@@ -260,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;
@@ -355,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;
@@ -380,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) */
@@ -501,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 */
@@ -550,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
@@ -565,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[];
@@ -575,6 +669,7 @@ declare class Selection {
     private computeGroupForTag;
     private addServiceByRole;
     private findOptionById;
+    private isSelectedOptionVisible;
 }
 
 type CatalogId = string;
@@ -1692,6 +1787,66 @@ type QuantityRule = {
     fallback?: number;
 };
 
+/** Matches your InputWrapper’s expectations */
+type InputKind = string;
+type InputVariant = "default" | (string & {});
+type AdapterCtx = {
+    field: Field;
+    props: ServiceProps;
+};
+type Adapter = {
+    valueProp?: string;
+    changeProp?: string;
+    errorProp?: string;
+    /** normalize what the host emitted into what we store in form-palette */
+    getValue?: (next: unknown, current: unknown, ctx: AdapterCtx) => unknown;
+    /** REQUIRED if field.options exists */
+    getSelectedOptions?: (next: unknown, current: unknown, ctx: AdapterCtx) => string[];
+    /** For option-less action buttons (button: true with no options) */
+    isActive?: (stored: unknown, ctx: AdapterCtx) => boolean;
+    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;
+    autoEnable?: boolean;
+};
+type InputDescriptor = {
+    Component: React__default.ComponentType<Record<string, unknown>>;
+    adapter?: Adapter;
+    defaultProps?: Record<string, unknown>;
+    ui?: Record<string, Ui>;
+    options?: InputOptionCapability;
+    multi?: InputMultiCapability;
+};
+type VariantMap = Map<InputVariant, InputDescriptor>;
+type RegistryStore = Map<InputKind, VariantMap>;
+type Registry = {
+    get(kind: InputKind, variant?: InputVariant): InputDescriptor | undefined;
+    register(kind: InputKind, descriptor: InputDescriptor, variant?: InputVariant): void;
+    unregister(kind: InputKind, variant?: InputVariant): void;
+    registerMany(entries: Array<{
+        kind: InputKind;
+        descriptor: InputDescriptor;
+        variant?: InputVariant;
+    }>): void;
+    /** low-level escape hatch */
+    _store: RegistryStore;
+};
+
 declare class Editor {
     private readonly builder;
     private readonly api;
@@ -1763,7 +1918,14 @@ declare class Editor {
         id?: string;
         label: string;
         type: Field["type"];
-    }): void;
+    }): string;
+    addFieldFromDescriptor(registry: Registry, partial: Omit<Field, "id" | "label" | "type"> & {
+        id?: string;
+        label: string;
+        type: Field["type"];
+    }, opts?: {
+        variant?: InputVariant;
+    }): string;
     updateField(id: string, patch: Partial<Field>): void;
     removeField(id: string): void;
     remove(id: string): void;
@@ -1782,6 +1944,7 @@ declare class Editor {
     setPricingRoleMany(ids: readonly string[], role: "base" | "utility"): void;
     clearFieldDefaultsMany(ids: readonly string[]): void;
     clearFieldValidationMany(ids: readonly string[]): void;
+    setFieldMulti(fieldId: string, enabled: boolean): void;
     autoCreateOptionsMany(ids: readonly string[], makeOption?: (fieldId: string) => {
         id?: string;
         label: string;
@@ -1796,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;
@@ -186,6 +186,75 @@ interface BaseFieldUI {
     /** Host-defined prop names → runtime default values (untyped base) */
     defaults?: Record<string, unknown>;
 }
+type Ui = (UiString | UiNumber | UiBoolean | UiAnyOf | UiArray | UiObject) & {
+    description: string;
+    label: string;
+};
+/** string */
+interface UiString {
+    type: "string";
+    enum?: string[];
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+}
+/** number */
+interface UiNumber {
+    type: "number";
+    minimum?: number;
+    maximum?: number;
+    multipleOf?: number;
+}
+/** boolean */
+interface UiBoolean {
+    type: "boolean";
+}
+/** enumerated choices */
+interface UiAnyOf {
+    type: "anyOf";
+    multiple?: boolean;
+    items: Array<{
+        type: "string" | "number" | "boolean";
+        title?: string;
+        description?: string;
+        value: string | number | boolean;
+    }>;
+}
+/** arrays: homogeneous (item) or tuple (items) */
+interface UiArray {
+    type: "array";
+    label: string;
+    description: string;
+    item?: Ui;
+    items?: Ui[];
+    editable?: boolean;
+    /**
+     * Optional: allowed shapes for new items.
+     * Key = label shown in UI picker
+     * Value = schema for the new element
+     */
+    shape?: Record<string, Ui>;
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+}
+/** objects: nested props */
+interface UiObject {
+    type: "object";
+    label: string;
+    description: string;
+    editable?: boolean;
+    fields: Record<string, Ui>;
+    /**
+     * Optional: allowed shapes for dynamically added keys.
+     * Key = human-readable name shown in UI picker
+     * Value = schema applied to the value of the new key
+     */
+    shape?: Record<string, Ui>;
+    required?: string[];
+    order?: string[];
+}
 type FieldValidationValueBy = "value" | "length" | "eval";
 type FieldValidationOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "between" | "in" | "nin" | "truthy" | "falsy" | "match";
 type FieldValidationRule = {
@@ -207,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;
@@ -260,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;
@@ -355,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;
@@ -380,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) */
@@ -501,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 */
@@ -550,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
@@ -565,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[];
@@ -575,6 +669,7 @@ declare class Selection {
     private computeGroupForTag;
     private addServiceByRole;
     private findOptionById;
+    private isSelectedOptionVisible;
 }
 
 type CatalogId = string;
@@ -1692,6 +1787,66 @@ type QuantityRule = {
     fallback?: number;
 };
 
+/** Matches your InputWrapper’s expectations */
+type InputKind = string;
+type InputVariant = "default" | (string & {});
+type AdapterCtx = {
+    field: Field;
+    props: ServiceProps;
+};
+type Adapter = {
+    valueProp?: string;
+    changeProp?: string;
+    errorProp?: string;
+    /** normalize what the host emitted into what we store in form-palette */
+    getValue?: (next: unknown, current: unknown, ctx: AdapterCtx) => unknown;
+    /** REQUIRED if field.options exists */
+    getSelectedOptions?: (next: unknown, current: unknown, ctx: AdapterCtx) => string[];
+    /** For option-less action buttons (button: true with no options) */
+    isActive?: (stored: unknown, ctx: AdapterCtx) => boolean;
+    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;
+    autoEnable?: boolean;
+};
+type InputDescriptor = {
+    Component: React__default.ComponentType<Record<string, unknown>>;
+    adapter?: Adapter;
+    defaultProps?: Record<string, unknown>;
+    ui?: Record<string, Ui>;
+    options?: InputOptionCapability;
+    multi?: InputMultiCapability;
+};
+type VariantMap = Map<InputVariant, InputDescriptor>;
+type RegistryStore = Map<InputKind, VariantMap>;
+type Registry = {
+    get(kind: InputKind, variant?: InputVariant): InputDescriptor | undefined;
+    register(kind: InputKind, descriptor: InputDescriptor, variant?: InputVariant): void;
+    unregister(kind: InputKind, variant?: InputVariant): void;
+    registerMany(entries: Array<{
+        kind: InputKind;
+        descriptor: InputDescriptor;
+        variant?: InputVariant;
+    }>): void;
+    /** low-level escape hatch */
+    _store: RegistryStore;
+};
+
 declare class Editor {
     private readonly builder;
     private readonly api;
@@ -1763,7 +1918,14 @@ declare class Editor {
         id?: string;
         label: string;
         type: Field["type"];
-    }): void;
+    }): string;
+    addFieldFromDescriptor(registry: Registry, partial: Omit<Field, "id" | "label" | "type"> & {
+        id?: string;
+        label: string;
+        type: Field["type"];
+    }, opts?: {
+        variant?: InputVariant;
+    }): string;
     updateField(id: string, patch: Partial<Field>): void;
     removeField(id: string): void;
     remove(id: string): void;
@@ -1782,6 +1944,7 @@ declare class Editor {
     setPricingRoleMany(ids: readonly string[], role: "base" | "utility"): void;
     clearFieldDefaultsMany(ids: readonly string[]): void;
     clearFieldValidationMany(ids: readonly string[]): void;
+    setFieldMulti(fieldId: string, enabled: boolean): void;
     autoCreateOptionsMany(ids: readonly string[], makeOption?: (fieldId: string) => {
         id?: string;
         label: string;
@@ -1796,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;