@vef-framework-react/form-editor 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/_internal/_rolldown/runtime.cjs +1 -0
- package/dist/cjs/components/button/index.cjs +1 -0
- package/dist/cjs/components/checkbox-group-field/index.cjs +1 -0
- package/dist/cjs/components/code-editor/code-editor-input.cjs +1 -0
- package/dist/cjs/components/code-editor/index.cjs +1 -0
- package/dist/cjs/components/containers/index.cjs +1 -0
- package/dist/cjs/components/date-field/index.cjs +1 -0
- package/dist/cjs/components/display/index.cjs +1 -0
- package/dist/cjs/components/field-entries.cjs +1 -0
- package/dist/cjs/components/mobile/alert-block.cjs +1 -0
- package/dist/cjs/components/mobile/button.cjs +1 -0
- package/dist/cjs/components/mobile/checkbox-group.cjs +1 -0
- package/dist/cjs/components/mobile/date-adapters.cjs +1 -0
- package/dist/cjs/components/mobile/date.cjs +1 -0
- package/dist/cjs/components/mobile/daterange.cjs +1 -0
- package/dist/cjs/components/mobile/datetime.cjs +1 -0
- package/dist/cjs/components/mobile/definitions.cjs +1 -0
- package/dist/cjs/components/mobile/divider.cjs +1 -0
- package/dist/cjs/components/mobile/input-cell.cjs +1 -0
- package/dist/cjs/components/mobile/number.cjs +1 -0
- package/dist/cjs/components/mobile/option-group.cjs +1 -0
- package/dist/cjs/components/mobile/paragraph.cjs +1 -0
- package/dist/cjs/components/mobile/picker-trigger.cjs +1 -0
- package/dist/cjs/components/mobile/radio.cjs +1 -0
- package/dist/cjs/components/mobile/scope.cjs +1 -0
- package/dist/cjs/components/mobile/select.cjs +1 -0
- package/dist/cjs/components/mobile/switch.cjs +1 -0
- package/dist/cjs/components/mobile/textarea.cjs +1 -0
- package/dist/cjs/components/mobile/textfield.cjs +1 -0
- package/dist/cjs/components/mobile/theme.cjs +1 -0
- package/dist/cjs/components/number-field/index.cjs +1 -0
- package/dist/cjs/components/radio-field/index.cjs +1 -0
- package/dist/cjs/components/select-field/index.cjs +1 -0
- package/dist/cjs/components/switch-field/index.cjs +1 -0
- package/dist/cjs/components/textarea-field/index.cjs +1 -0
- package/dist/cjs/components/textfield/index.cjs +1 -0
- package/dist/cjs/editor/canvas/canvas-field.cjs +1 -0
- package/dist/cjs/editor/canvas/canvas.cjs +1 -0
- package/dist/cjs/editor/canvas/drop-indicator.cjs +1 -0
- package/dist/cjs/editor/canvas/drop-zones.cjs +1 -0
- package/dist/cjs/editor/canvas/json-split-view.cjs +1 -0
- package/dist/cjs/editor/canvas/mobile-seed-state.cjs +2 -0
- package/dist/cjs/editor/canvas/phone-frame.cjs +1 -0
- package/dist/cjs/editor/dnd.cjs +1 -0
- package/dist/cjs/editor/editor-layout-context.cjs +1 -0
- package/dist/cjs/editor/footer/footer.cjs +1 -0
- package/dist/cjs/editor/form-config/form-basics-tab.cjs +1 -0
- package/dist/cjs/editor/form-config/form-config-drawer.cjs +1 -0
- package/dist/cjs/editor/form-config/outline-tab.cjs +1 -0
- package/dist/cjs/editor/form-editor.cjs +1 -0
- package/dist/cjs/editor/palette/field-groups.cjs +1 -0
- package/dist/cjs/editor/palette/palette-group.cjs +1 -0
- package/dist/cjs/editor/palette/palette-item.cjs +1 -0
- package/dist/cjs/editor/palette/palette-panel.cjs +1 -0
- package/dist/cjs/editor/preview-effects.cjs +1 -0
- package/dist/cjs/editor/preview-runtime-context.cjs +1 -0
- package/dist/cjs/editor/properties/block-layout-section.cjs +1 -0
- package/dist/cjs/editor/properties/container-properties.cjs +1 -0
- package/dist/cjs/editor/properties/entries/built-ins.cjs +1 -0
- package/dist/cjs/editor/properties/entries/checkbox-entry.cjs +1 -0
- package/dist/cjs/editor/properties/entries/coerce.cjs +1 -0
- package/dist/cjs/editor/properties/entries/entry-field.cjs +1 -0
- package/dist/cjs/editor/properties/entries/icon-entry.cjs +1 -0
- package/dist/cjs/editor/properties/entries/index.cjs +1 -0
- package/dist/cjs/editor/properties/entries/key-entry.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/action-editor.cjs +2 -0
- package/dist/cjs/editor/properties/entries/linkage/actions-editor.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/condition-editor.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/container-linkage-section.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/expression-assist.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/index.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/linkage-rules-entry.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/mutators.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/options.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/rule-diagnostics.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/rule-list-editor.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/styles.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/trigger-editor.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/use-linkage-editor-model.cjs +1 -0
- package/dist/cjs/editor/properties/entries/linkage/use-stable-options.cjs +1 -0
- package/dist/cjs/editor/properties/entries/number-entry.cjs +1 -0
- package/dist/cjs/editor/properties/entries/options-source/index.cjs +1 -0
- package/dist/cjs/editor/properties/entries/options-source/source-mutators.cjs +1 -0
- package/dist/cjs/editor/properties/entries/select-entry.cjs +1 -0
- package/dist/cjs/editor/properties/entries/text-entry.cjs +1 -0
- package/dist/cjs/editor/properties/form-data-sources-panel.cjs +1 -0
- package/dist/cjs/editor/properties/form-linkage-panel.cjs +1 -0
- package/dist/cjs/editor/properties/form-variables-panel.cjs +1 -0
- package/dist/cjs/editor/properties/option-editors.cjs +1 -0
- package/dist/cjs/editor/properties/panel-header.cjs +1 -0
- package/dist/cjs/editor/properties/properties-empty.cjs +1 -0
- package/dist/cjs/editor/properties/properties-header.cjs +1 -0
- package/dist/cjs/editor/properties/properties-panel.cjs +1 -0
- package/dist/cjs/editor/properties/properties-provider.cjs +1 -0
- package/dist/cjs/editor/properties/properties-tabs.cjs +1 -0
- package/dist/cjs/editor/properties/use-confirmable-kind-switch.cjs +1 -0
- package/dist/cjs/editor/remove-node-confirm.cjs +1 -0
- package/dist/cjs/editor/schema-apply.cjs +2 -0
- package/dist/cjs/editor/styles.cjs +1 -0
- package/dist/cjs/editor/toolbar/notify.cjs +1 -0
- package/dist/cjs/editor/toolbar/schema-io.cjs +1 -0
- package/dist/cjs/editor/toolbar/toolbar.cjs +1 -0
- package/dist/cjs/editor/use-editor-shortcuts.cjs +1 -0
- package/dist/cjs/editor/validation-summary.cjs +1 -0
- package/dist/cjs/engine/assert-never.cjs +1 -0
- package/dist/cjs/engine/conversion/index.cjs +1 -0
- package/dist/cjs/engine/ids.cjs +1 -0
- package/dist/cjs/engine/keys.cjs +1 -0
- package/dist/cjs/engine/linkage/cycle.cjs +1 -0
- package/dist/cjs/engine/linkage/default-evaluator.cjs +1 -0
- package/dist/cjs/engine/linkage/effects.cjs +1 -0
- package/dist/cjs/engine/linkage/evaluator.cjs +1 -0
- package/dist/cjs/engine/linkage/index.cjs +1 -0
- package/dist/cjs/engine/linkage/operators.cjs +1 -0
- package/dist/cjs/engine/linkage/source-tracking.cjs +1 -0
- package/dist/cjs/engine/linkage/taxonomy.cjs +1 -0
- package/dist/cjs/engine/linkage/validator.cjs +1 -0
- package/dist/cjs/engine/registry/defaults-mobile.cjs +1 -0
- package/dist/cjs/engine/registry/defaults.cjs +1 -0
- package/dist/cjs/engine/registry/form-field-registry.cjs +1 -0
- package/dist/cjs/engine/schema/edit-ops.cjs +1 -0
- package/dist/cjs/engine/schema/mutate.cjs +1 -0
- package/dist/cjs/engine/schema/nodes.cjs +1 -0
- package/dist/cjs/engine/schema/permission-bridge.cjs +1 -0
- package/dist/cjs/engine/schema/presentation.cjs +1 -0
- package/dist/cjs/engine/schema/reconcile.cjs +1 -0
- package/dist/cjs/engine/schema/removal-impact.cjs +1 -0
- package/dist/cjs/engine/schema/rewrite.cjs +1 -0
- package/dist/cjs/engine/schema/validate.cjs +1 -0
- package/dist/cjs/engine/schema/walk.cjs +1 -0
- package/dist/cjs/engine/validation.cjs +1 -0
- package/dist/cjs/icons.cjs +1 -0
- package/dist/cjs/index.cjs +1 -0
- package/dist/cjs/render/chrome/mobile-chrome.cjs +1 -0
- package/dist/cjs/render/chrome/pc-chrome.cjs +1 -0
- package/dist/cjs/render/chrome/subform-shell.cjs +1 -0
- package/dist/cjs/render/data-source-context.cjs +0 -0
- package/dist/cjs/render/flex-style.cjs +1 -0
- package/dist/cjs/render/form-field.cjs +1 -0
- package/dist/cjs/render/form-renderer.cjs +1 -0
- package/dist/cjs/render/grid-style.cjs +1 -0
- package/dist/cjs/render/parts/field-shell.cjs +1 -0
- package/dist/cjs/render/parts/label.cjs +1 -0
- package/dist/cjs/render/parts/options-status.cjs +1 -0
- package/dist/cjs/render/stack-style.cjs +1 -0
- package/dist/cjs/render/subform-columns.cjs +1 -0
- package/dist/cjs/render/submit.cjs +1 -0
- package/dist/cjs/runtime/effects.cjs +1 -0
- package/dist/cjs/runtime/resolve-scope-values.cjs +1 -0
- package/dist/cjs/runtime/runtime-context.cjs +1 -0
- package/dist/cjs/runtime/runtime-state-controller.cjs +1 -0
- package/dist/cjs/runtime/stabilize-state-map.cjs +1 -0
- package/dist/cjs/store/engine-provider.cjs +1 -0
- package/dist/cjs/store/form-store.cjs +1 -0
- package/dist/cjs/types/chrome.cjs +0 -0
- package/dist/cjs/types/component.cjs +1 -0
- package/dist/cjs/types/data-source.cjs +1 -0
- package/dist/cjs/types/index.cjs +1 -0
- package/dist/cjs/types/linkage.cjs +0 -0
- package/dist/cjs/types/properties.cjs +1 -0
- package/dist/cjs/types/schema.cjs +1 -0
- package/dist/es/components/button/index.js +183 -0
- package/dist/es/components/checkbox-group-field/index.js +103 -0
- package/dist/es/components/code-editor/code-editor-input.js +3 -0
- package/dist/es/components/code-editor/index.js +212 -0
- package/dist/es/components/containers/index.js +72 -0
- package/dist/es/components/date-field/index.js +197 -0
- package/dist/es/components/display/index.js +276 -0
- package/dist/es/components/field-entries.js +184 -0
- package/dist/es/components/mobile/alert-block.js +40 -0
- package/dist/es/components/mobile/button.js +41 -0
- package/dist/es/components/mobile/checkbox-group.js +35 -0
- package/dist/es/components/mobile/date-adapters.js +16 -0
- package/dist/es/components/mobile/date.js +42 -0
- package/dist/es/components/mobile/daterange.js +48 -0
- package/dist/es/components/mobile/datetime.js +42 -0
- package/dist/es/components/mobile/definitions.js +58 -0
- package/dist/es/components/mobile/divider.js +10 -0
- package/dist/es/components/mobile/input-cell.js +56 -0
- package/dist/es/components/mobile/number.js +73 -0
- package/dist/es/components/mobile/option-group.js +34 -0
- package/dist/es/components/mobile/paragraph.js +30 -0
- package/dist/es/components/mobile/picker-trigger.js +94 -0
- package/dist/es/components/mobile/radio.js +35 -0
- package/dist/es/components/mobile/scope.js +61 -0
- package/dist/es/components/mobile/select.js +45 -0
- package/dist/es/components/mobile/switch.js +22 -0
- package/dist/es/components/mobile/textarea.js +32 -0
- package/dist/es/components/mobile/textfield.js +30 -0
- package/dist/es/components/mobile/theme.js +8 -0
- package/dist/es/components/number-field/index.js +186 -0
- package/dist/es/components/radio-field/index.js +139 -0
- package/dist/es/components/select-field/index.js +128 -0
- package/dist/es/components/switch-field/index.js +133 -0
- package/dist/es/components/textarea-field/index.js +137 -0
- package/dist/es/components/textfield/index.js +138 -0
- package/dist/es/editor/canvas/canvas-field.js +202 -0
- package/dist/es/editor/canvas/canvas.js +415 -0
- package/dist/es/editor/canvas/drop-indicator.js +42 -0
- package/dist/es/editor/canvas/drop-zones.js +42 -0
- package/dist/es/editor/canvas/json-split-view.js +148 -0
- package/dist/es/editor/canvas/mobile-seed-state.js +103 -0
- package/dist/es/editor/canvas/phone-frame.js +109 -0
- package/dist/es/editor/dnd.js +75 -0
- package/dist/es/editor/editor-layout-context.js +34 -0
- package/dist/es/editor/footer/footer.js +154 -0
- package/dist/es/editor/form-config/form-basics-tab.js +184 -0
- package/dist/es/editor/form-config/form-config-drawer.js +224 -0
- package/dist/es/editor/form-config/outline-tab.js +132 -0
- package/dist/es/editor/form-editor.js +179 -0
- package/dist/es/editor/palette/field-groups.js +19 -0
- package/dist/es/editor/palette/palette-group.js +147 -0
- package/dist/es/editor/palette/palette-item.js +153 -0
- package/dist/es/editor/palette/palette-panel.js +109 -0
- package/dist/es/editor/preview-effects.js +22 -0
- package/dist/es/editor/preview-runtime-context.js +24 -0
- package/dist/es/editor/properties/block-layout-section.js +161 -0
- package/dist/es/editor/properties/container-properties.js +575 -0
- package/dist/es/editor/properties/entries/built-ins.js +21 -0
- package/dist/es/editor/properties/entries/checkbox-entry.js +31 -0
- package/dist/es/editor/properties/entries/coerce.js +8 -0
- package/dist/es/editor/properties/entries/entry-field.js +43 -0
- package/dist/es/editor/properties/entries/icon-entry.js +21 -0
- package/dist/es/editor/properties/entries/index.js +9 -0
- package/dist/es/editor/properties/entries/key-entry.js +29 -0
- package/dist/es/editor/properties/entries/linkage/action-editor.js +260 -0
- package/dist/es/editor/properties/entries/linkage/actions-editor.js +64 -0
- package/dist/es/editor/properties/entries/linkage/condition-editor.js +265 -0
- package/dist/es/editor/properties/entries/linkage/container-linkage-section.js +71 -0
- package/dist/es/editor/properties/entries/linkage/expression-assist.js +87 -0
- package/dist/es/editor/properties/entries/linkage/index.js +3 -0
- package/dist/es/editor/properties/entries/linkage/linkage-rules-entry.js +110 -0
- package/dist/es/editor/properties/entries/linkage/mutators.js +209 -0
- package/dist/es/editor/properties/entries/linkage/options.js +155 -0
- package/dist/es/editor/properties/entries/linkage/rule-diagnostics.js +58 -0
- package/dist/es/editor/properties/entries/linkage/rule-list-editor.js +126 -0
- package/dist/es/editor/properties/entries/linkage/styles.js +276 -0
- package/dist/es/editor/properties/entries/linkage/trigger-editor.js +64 -0
- package/dist/es/editor/properties/entries/linkage/use-linkage-editor-model.js +20 -0
- package/dist/es/editor/properties/entries/linkage/use-stable-options.js +12 -0
- package/dist/es/editor/properties/entries/number-entry.js +25 -0
- package/dist/es/editor/properties/entries/options-source/index.js +122 -0
- package/dist/es/editor/properties/entries/options-source/source-mutators.js +31 -0
- package/dist/es/editor/properties/entries/select-entry.js +23 -0
- package/dist/es/editor/properties/entries/text-entry.js +23 -0
- package/dist/es/editor/properties/form-data-sources-panel.js +170 -0
- package/dist/es/editor/properties/form-linkage-panel.js +36 -0
- package/dist/es/editor/properties/form-variables-panel.js +184 -0
- package/dist/es/editor/properties/option-editors.js +170 -0
- package/dist/es/editor/properties/panel-header.js +93 -0
- package/dist/es/editor/properties/properties-empty.js +62 -0
- package/dist/es/editor/properties/properties-header.js +31 -0
- package/dist/es/editor/properties/properties-panel.js +195 -0
- package/dist/es/editor/properties/properties-provider.js +95 -0
- package/dist/es/editor/properties/properties-tabs.js +91 -0
- package/dist/es/editor/properties/use-confirmable-kind-switch.js +26 -0
- package/dist/es/editor/remove-node-confirm.js +60 -0
- package/dist/es/editor/schema-apply.js +36 -0
- package/dist/es/editor/styles.js +74 -0
- package/dist/es/editor/toolbar/notify.js +59 -0
- package/dist/es/editor/toolbar/schema-io.js +107 -0
- package/dist/es/editor/toolbar/toolbar.js +394 -0
- package/dist/es/editor/use-editor-shortcuts.js +43 -0
- package/dist/es/editor/validation-summary.js +66 -0
- package/dist/es/engine/assert-never.js +8 -0
- package/dist/es/engine/conversion/index.js +127 -0
- package/dist/es/engine/ids.js +18 -0
- package/dist/es/engine/keys.js +48 -0
- package/dist/es/engine/linkage/cycle.js +25 -0
- package/dist/es/engine/linkage/default-evaluator.js +79 -0
- package/dist/es/engine/linkage/effects.js +41 -0
- package/dist/es/engine/linkage/evaluator.js +119 -0
- package/dist/es/engine/linkage/index.js +9 -0
- package/dist/es/engine/linkage/operators.js +44 -0
- package/dist/es/engine/linkage/source-tracking.js +17 -0
- package/dist/es/engine/linkage/taxonomy.js +51 -0
- package/dist/es/engine/linkage/validator.js +360 -0
- package/dist/es/engine/registry/defaults-mobile.js +12 -0
- package/dist/es/engine/registry/defaults.js +25 -0
- package/dist/es/engine/registry/form-field-registry.js +52 -0
- package/dist/es/engine/schema/edit-ops.js +264 -0
- package/dist/es/engine/schema/mutate.js +39 -0
- package/dist/es/engine/schema/nodes.js +61 -0
- package/dist/es/engine/schema/permission-bridge.js +46 -0
- package/dist/es/engine/schema/presentation.js +37 -0
- package/dist/es/engine/schema/reconcile.js +258 -0
- package/dist/es/engine/schema/removal-impact.js +59 -0
- package/dist/es/engine/schema/rewrite.js +11 -0
- package/dist/es/engine/schema/validate.js +320 -0
- package/dist/es/engine/schema/walk.js +103 -0
- package/dist/es/engine/validation.js +122 -0
- package/dist/es/icons.js +74 -0
- package/dist/es/index.js +54 -0
- package/dist/es/render/chrome/mobile-chrome.js +119 -0
- package/dist/es/render/chrome/pc-chrome.js +76 -0
- package/dist/es/render/chrome/subform-shell.js +38 -0
- package/dist/es/render/data-source-context.js +0 -0
- package/dist/es/render/flex-style.js +24 -0
- package/dist/es/render/form-field.js +37 -0
- package/dist/es/render/form-renderer.js +516 -0
- package/dist/es/render/grid-style.js +23 -0
- package/dist/es/render/parts/field-shell.js +119 -0
- package/dist/es/render/parts/label.js +44 -0
- package/dist/es/render/parts/options-status.js +19 -0
- package/dist/es/render/stack-style.js +13 -0
- package/dist/es/render/subform-columns.js +118 -0
- package/dist/es/render/submit.js +112 -0
- package/dist/es/runtime/effects.js +109 -0
- package/dist/es/runtime/resolve-scope-values.js +14 -0
- package/dist/es/runtime/runtime-context.js +10 -0
- package/dist/es/runtime/runtime-state-controller.js +99 -0
- package/dist/es/runtime/stabilize-state-map.js +14 -0
- package/dist/es/store/engine-provider.js +37 -0
- package/dist/es/store/form-store.js +306 -0
- package/dist/es/types/chrome.js +1 -0
- package/dist/es/types/component.js +13 -0
- package/dist/es/types/data-source.js +5 -0
- package/dist/es/types/index.js +5 -0
- package/dist/es/types/linkage.js +1 -0
- package/dist/es/types/properties.js +7 -0
- package/dist/es/types/schema.js +15 -0
- package/dist/types/src/components/button/index.d.ts +8 -0
- package/dist/types/src/components/checkbox-group-field/index.d.ts +2 -0
- package/dist/types/src/components/code-editor/code-editor-input.d.ts +1 -0
- package/dist/types/src/components/code-editor/index.d.ts +4 -0
- package/dist/types/src/components/containers/index.d.ts +12 -0
- package/dist/types/src/components/date-field/index.d.ts +4 -0
- package/dist/types/src/components/display/index.d.ts +4 -0
- package/dist/types/src/components/field-entries.d.ts +103 -0
- package/dist/types/src/components/mobile/alert-block.d.ts +12 -0
- package/dist/types/src/components/mobile/button.d.ts +9 -0
- package/dist/types/src/components/mobile/checkbox-group.d.ts +11 -0
- package/dist/types/src/components/mobile/date-adapters.d.ts +28 -0
- package/dist/types/src/components/mobile/date.d.ts +10 -0
- package/dist/types/src/components/mobile/daterange.d.ts +11 -0
- package/dist/types/src/components/mobile/datetime.d.ts +10 -0
- package/dist/types/src/components/mobile/definitions.d.ts +9 -0
- package/dist/types/src/components/mobile/divider.d.ts +10 -0
- package/dist/types/src/components/mobile/input-cell.d.ts +30 -0
- package/dist/types/src/components/mobile/number.d.ts +25 -0
- package/dist/types/src/components/mobile/option-group.d.ts +17 -0
- package/dist/types/src/components/mobile/paragraph.d.ts +10 -0
- package/dist/types/src/components/mobile/picker-trigger.d.ts +31 -0
- package/dist/types/src/components/mobile/radio.d.ts +12 -0
- package/dist/types/src/components/mobile/scope.d.ts +42 -0
- package/dist/types/src/components/mobile/select.d.ts +12 -0
- package/dist/types/src/components/mobile/switch.d.ts +14 -0
- package/dist/types/src/components/mobile/textarea.d.ts +3 -0
- package/dist/types/src/components/mobile/textfield.d.ts +11 -0
- package/dist/types/src/components/mobile/theme.d.ts +16 -0
- package/dist/types/src/components/number-field/index.d.ts +2 -0
- package/dist/types/src/components/radio-field/index.d.ts +2 -0
- package/dist/types/src/components/select-field/index.d.ts +2 -0
- package/dist/types/src/components/switch-field/index.d.ts +2 -0
- package/dist/types/src/components/textarea-field/index.d.ts +2 -0
- package/dist/types/src/components/textfield/index.d.ts +11 -0
- package/dist/types/src/editor/canvas/canvas-field.d.ts +24 -0
- package/dist/types/src/editor/canvas/canvas.d.ts +11 -0
- package/dist/types/src/editor/canvas/drop-indicator.d.ts +14 -0
- package/dist/types/src/editor/canvas/drop-zones.d.ts +48 -0
- package/dist/types/src/editor/canvas/json-split-view.d.ts +15 -0
- package/dist/types/src/editor/canvas/mobile-seed-state.d.ts +9 -0
- package/dist/types/src/editor/canvas/phone-frame.d.ts +15 -0
- package/dist/types/src/editor/dnd.d.ts +88 -0
- package/dist/types/src/editor/editor-layout-context.d.ts +53 -0
- package/dist/types/src/editor/footer/footer.d.ts +7 -0
- package/dist/types/src/editor/form-config/form-basics-tab.d.ts +34 -0
- package/dist/types/src/editor/form-config/form-config-drawer.d.ts +8 -0
- package/dist/types/src/editor/form-config/outline-tab.d.ts +2 -0
- package/dist/types/src/editor/form-editor.d.ts +142 -0
- package/dist/types/src/editor/palette/field-groups.d.ts +12 -0
- package/dist/types/src/editor/palette/palette-group.d.ts +31 -0
- package/dist/types/src/editor/palette/palette-item.d.ts +34 -0
- package/dist/types/src/editor/palette/palette-panel.d.ts +17 -0
- package/dist/types/src/editor/preview-effects.d.ts +14 -0
- package/dist/types/src/editor/preview-runtime-context.d.ts +23 -0
- package/dist/types/src/editor/properties/block-layout-section.d.ts +19 -0
- package/dist/types/src/editor/properties/container-properties.d.ts +19 -0
- package/dist/types/src/editor/properties/entries/built-ins.d.ts +19 -0
- package/dist/types/src/editor/properties/entries/checkbox-entry.d.ts +3 -0
- package/dist/types/src/editor/properties/entries/coerce.d.ts +6 -0
- package/dist/types/src/editor/properties/entries/entry-field.d.ts +29 -0
- package/dist/types/src/editor/properties/entries/icon-entry.d.ts +8 -0
- package/dist/types/src/editor/properties/entries/index.d.ts +8 -0
- package/dist/types/src/editor/properties/entries/key-entry.d.ts +14 -0
- package/dist/types/src/editor/properties/entries/linkage/action-editor.d.ts +42 -0
- package/dist/types/src/editor/properties/entries/linkage/actions-editor.d.ts +43 -0
- package/dist/types/src/editor/properties/entries/linkage/condition-editor.d.ts +28 -0
- package/dist/types/src/editor/properties/entries/linkage/container-linkage-section.d.ts +14 -0
- package/dist/types/src/editor/properties/entries/linkage/expression-assist.d.ts +33 -0
- package/dist/types/src/editor/properties/entries/linkage/index.d.ts +1 -0
- package/dist/types/src/editor/properties/entries/linkage/linkage-rules-entry.d.ts +17 -0
- package/dist/types/src/editor/properties/entries/linkage/mutators.d.ts +73 -0
- package/dist/types/src/editor/properties/entries/linkage/options.d.ts +72 -0
- package/dist/types/src/editor/properties/entries/linkage/rule-diagnostics.d.ts +20 -0
- package/dist/types/src/editor/properties/entries/linkage/rule-list-editor.d.ts +75 -0
- package/dist/types/src/editor/properties/entries/linkage/styles.d.ts +46 -0
- package/dist/types/src/editor/properties/entries/linkage/trigger-editor.d.ts +35 -0
- package/dist/types/src/editor/properties/entries/linkage/use-linkage-editor-model.d.ts +46 -0
- package/dist/types/src/editor/properties/entries/linkage/use-stable-options.d.ts +17 -0
- package/dist/types/src/editor/properties/entries/number-entry.d.ts +3 -0
- package/dist/types/src/editor/properties/entries/options-source/index.d.ts +9 -0
- package/dist/types/src/editor/properties/entries/options-source/source-mutators.d.ts +14 -0
- package/dist/types/src/editor/properties/entries/select-entry.d.ts +3 -0
- package/dist/types/src/editor/properties/entries/text-entry.d.ts +3 -0
- package/dist/types/src/editor/properties/form-data-sources-panel.d.ts +16 -0
- package/dist/types/src/editor/properties/form-linkage-panel.d.ts +13 -0
- package/dist/types/src/editor/properties/form-variables-panel.d.ts +17 -0
- package/dist/types/src/editor/properties/option-editors.d.ts +33 -0
- package/dist/types/src/editor/properties/panel-header.d.ts +21 -0
- package/dist/types/src/editor/properties/properties-empty.d.ts +13 -0
- package/dist/types/src/editor/properties/properties-header.d.ts +13 -0
- package/dist/types/src/editor/properties/properties-panel.d.ts +18 -0
- package/dist/types/src/editor/properties/properties-provider.d.ts +42 -0
- package/dist/types/src/editor/properties/properties-tabs.d.ts +24 -0
- package/dist/types/src/editor/properties/use-confirmable-kind-switch.d.ts +38 -0
- package/dist/types/src/editor/remove-node-confirm.d.ts +8 -0
- package/dist/types/src/editor/schema-apply.d.ts +25 -0
- package/dist/types/src/editor/styles.d.ts +37 -0
- package/dist/types/src/editor/toolbar/notify.d.ts +13 -0
- package/dist/types/src/editor/toolbar/schema-io.d.ts +12 -0
- package/dist/types/src/editor/toolbar/toolbar.d.ts +42 -0
- package/dist/types/src/editor/use-editor-shortcuts.d.ts +23 -0
- package/dist/types/src/editor/validation-summary.d.ts +19 -0
- package/dist/types/src/engine/assert-never.d.ts +18 -0
- package/dist/types/src/engine/conversion/index.d.ts +87 -0
- package/dist/types/src/engine/ids.d.ts +14 -0
- package/dist/types/src/engine/keys.d.ts +70 -0
- package/dist/types/src/engine/linkage/cycle.d.ts +28 -0
- package/dist/types/src/engine/linkage/default-evaluator.d.ts +10 -0
- package/dist/types/src/engine/linkage/effects.d.ts +76 -0
- package/dist/types/src/engine/linkage/evaluator.d.ts +72 -0
- package/dist/types/src/engine/linkage/index.d.ts +8 -0
- package/dist/types/src/engine/linkage/operators.d.ts +23 -0
- package/dist/types/src/engine/linkage/source-tracking.d.ts +25 -0
- package/dist/types/src/engine/linkage/taxonomy.d.ts +49 -0
- package/dist/types/src/engine/linkage/validator.d.ts +23 -0
- package/dist/types/src/engine/registry/defaults-mobile.d.ts +17 -0
- package/dist/types/src/engine/registry/defaults.d.ts +22 -0
- package/dist/types/src/engine/registry/form-field-registry.d.ts +79 -0
- package/dist/types/src/engine/schema/edit-ops.d.ts +101 -0
- package/dist/types/src/engine/schema/mutate.d.ts +41 -0
- package/dist/types/src/engine/schema/nodes.d.ts +34 -0
- package/dist/types/src/engine/schema/permission-bridge.d.ts +37 -0
- package/dist/types/src/engine/schema/presentation.d.ts +30 -0
- package/dist/types/src/engine/schema/reconcile.d.ts +80 -0
- package/dist/types/src/engine/schema/removal-impact.d.ts +39 -0
- package/dist/types/src/engine/schema/rewrite.d.ts +15 -0
- package/dist/types/src/engine/schema/validate.d.ts +36 -0
- package/dist/types/src/engine/schema/walk.d.ts +90 -0
- package/dist/types/src/engine/validation.d.ts +139 -0
- package/dist/types/src/icons.d.ts +8 -0
- package/dist/types/src/index.d.ts +39 -0
- package/dist/types/src/render/chrome/mobile-chrome.d.ts +9 -0
- package/dist/types/src/render/chrome/pc-chrome.d.ts +7 -0
- package/dist/types/src/render/chrome/subform-shell.d.ts +17 -0
- package/dist/types/src/render/data-source-context.d.ts +42 -0
- package/dist/types/src/render/flex-style.d.ts +26 -0
- package/dist/types/src/render/form-field.d.ts +32 -0
- package/dist/types/src/render/form-renderer.d.ts +65 -0
- package/dist/types/src/render/grid-style.d.ts +24 -0
- package/dist/types/src/render/parts/field-shell.d.ts +33 -0
- package/dist/types/src/render/parts/label.d.ts +20 -0
- package/dist/types/src/render/parts/options-status.d.ts +14 -0
- package/dist/types/src/render/stack-style.d.ts +19 -0
- package/dist/types/src/render/subform-columns.d.ts +16 -0
- package/dist/types/src/render/submit.d.ts +91 -0
- package/dist/types/src/runtime/effects.d.ts +77 -0
- package/dist/types/src/runtime/resolve-scope-values.d.ts +8 -0
- package/dist/types/src/runtime/runtime-context.d.ts +21 -0
- package/dist/types/src/runtime/runtime-state-controller.d.ts +33 -0
- package/dist/types/src/runtime/stabilize-state-map.d.ts +12 -0
- package/dist/types/src/runtime/types.d.ts +13 -0
- package/dist/types/src/store/engine-provider.d.ts +50 -0
- package/dist/types/src/store/form-store.d.ts +234 -0
- package/dist/types/src/types/chrome.d.ts +51 -0
- package/dist/types/src/types/component.d.ts +116 -0
- package/dist/types/src/types/data-source.d.ts +70 -0
- package/dist/types/src/types/index.d.ts +6 -0
- package/dist/types/src/types/linkage.d.ts +350 -0
- package/dist/types/src/types/properties.d.ts +122 -0
- package/dist/types/src/types/schema.d.ts +839 -0
- package/package.json +77 -0
|
@@ -0,0 +1,350 @@
|
|
|
1
|
+
import { RemoteDataSourceRequest } from './data-source';
|
|
2
|
+
/**
|
|
3
|
+
* Linkage data model.
|
|
4
|
+
*
|
|
5
|
+
* A node declares how it reacts to the form via a list of **rules**. Every rule
|
|
6
|
+
* is a single {@link LinkageTrigger} paired with an ordered list of
|
|
7
|
+
* {@link FieldLinkageAction}s — one uniform shape that subsumes both classic
|
|
8
|
+
* "linkage" (a value condition drives a state change) and "events" (a field /
|
|
9
|
+
* form moment drives a side effect). An event is simply a rule whose trigger is
|
|
10
|
+
* an edge instead of a value condition.
|
|
11
|
+
*
|
|
12
|
+
* The model is intentionally recursive and orthogonal:
|
|
13
|
+
*
|
|
14
|
+
* - **Condition** is a discriminated union of three kinds — `leaf`, `group`,
|
|
15
|
+
* `expression` — that compose freely. A leaf evaluates a single operator
|
|
16
|
+
* against one source field; a group joins children with `all` / `any`
|
|
17
|
+
* logic; an expression delegates to a host-supplied JS evaluator.
|
|
18
|
+
* - **Trigger** wraps a condition (a *level* signal) or names an *edge* — a
|
|
19
|
+
* field event (`change` / `focus` / `blur` / `click`) or a form lifecycle
|
|
20
|
+
* moment (`load` / `beforeSubmit` / `afterSubmit`).
|
|
21
|
+
* - **Action** is one of two families: **state** actions (`show` / `hide` /
|
|
22
|
+
* ... / `assign` / `script`) that derive a field's runtime state, and
|
|
23
|
+
* **effect** actions (`alert` / `set_field` / ...) that fire side effects.
|
|
24
|
+
*
|
|
25
|
+
* The framework only ships the JSON shape and the recursion. Expression /
|
|
26
|
+
* script evaluation and side-effect dispatch are pluggable via
|
|
27
|
+
* {@link LinkageEvaluators} so hosts choose their own JS engine, sandbox, or
|
|
28
|
+
* effect runtime.
|
|
29
|
+
*/
|
|
30
|
+
/**
|
|
31
|
+
* Comparison operators available on a leaf condition. `empty` / `notEmpty`
|
|
32
|
+
* do not take a `value`; the others compare the source field's value to the
|
|
33
|
+
* supplied `value` using loose-string equality (see `engine/linkage/operators`).
|
|
34
|
+
*/
|
|
35
|
+
export type LinkageOperator = "eq" | "ne" | "gt" | "lt" | "gte" | "lte" | "contains" | "empty" | "notEmpty";
|
|
36
|
+
/**
|
|
37
|
+
* Atomic condition that compares one source field's value with an operator.
|
|
38
|
+
*
|
|
39
|
+
* `id` is an optional client-stable identity: the visual editor mints one per
|
|
40
|
+
* condition so list re-renders key off identity (not array index), keeping a
|
|
41
|
+
* controlled editor pinned to its logical row across edits and middle removals.
|
|
42
|
+
* The runtime and validator ignore it.
|
|
43
|
+
*/
|
|
44
|
+
export interface LinkageConditionLeaf {
|
|
45
|
+
kind: "leaf";
|
|
46
|
+
id?: string;
|
|
47
|
+
sourceKey: string;
|
|
48
|
+
operator: LinkageOperator;
|
|
49
|
+
value?: unknown;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Combines child conditions with a logical connector.
|
|
53
|
+
*
|
|
54
|
+
* - `all` short-circuits on the first false child.
|
|
55
|
+
* - `any` short-circuits on the first true child.
|
|
56
|
+
*
|
|
57
|
+
* Empty `children` evaluates to `true` for `all` and `false` for `any`,
|
|
58
|
+
* matching standard quantifier semantics. The editor UI keeps groups
|
|
59
|
+
* non-empty.
|
|
60
|
+
*/
|
|
61
|
+
export interface LinkageConditionGroup {
|
|
62
|
+
kind: "group";
|
|
63
|
+
/**
|
|
64
|
+
* Optional client-stable identity for editor list keys (see {@link LinkageConditionLeaf}).
|
|
65
|
+
*/
|
|
66
|
+
id?: string;
|
|
67
|
+
logic: "all" | "any";
|
|
68
|
+
children: LinkageCondition[];
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Catch-all for cases the visual editor cannot express. The host project
|
|
72
|
+
* supplies an evaluator that runs `source` against the form values and
|
|
73
|
+
* returns a boolean.
|
|
74
|
+
*/
|
|
75
|
+
export interface LinkageConditionExpression {
|
|
76
|
+
kind: "expression";
|
|
77
|
+
/**
|
|
78
|
+
* Optional client-stable identity for editor list keys (see {@link LinkageConditionLeaf}).
|
|
79
|
+
*/
|
|
80
|
+
id?: string;
|
|
81
|
+
source: string;
|
|
82
|
+
}
|
|
83
|
+
export type LinkageCondition = LinkageConditionLeaf | LinkageConditionGroup | LinkageConditionExpression;
|
|
84
|
+
/**
|
|
85
|
+
* What makes a rule fire.
|
|
86
|
+
*
|
|
87
|
+
* - `condition` is a **level** signal: it is continuously true or false as
|
|
88
|
+
* values change. It is the only trigger that feeds the pure state lane
|
|
89
|
+
* ({@link "../engine/linkage/evaluator"!evaluateLinkage}); its false→true rising
|
|
90
|
+
* edge also drives effect actions, each of which tunes its own re-firing via
|
|
91
|
+
* {@link ConditionRetrigger}.
|
|
92
|
+
* - The remaining kinds are **edges** that pulse once when they happen — field
|
|
93
|
+
* events (`change` / `focus` / `blur` / `click`) and form lifecycle moments
|
|
94
|
+
* (`load` / `beforeSubmit` / `afterSubmit`). They never derive durable state;
|
|
95
|
+
* they drive the side-effect lane only.
|
|
96
|
+
*
|
|
97
|
+
* This single dimension is what unifies "linkage" and "events": an event is a
|
|
98
|
+
* rule with an edge trigger and no value to compare against.
|
|
99
|
+
*/
|
|
100
|
+
export type LinkageTrigger = {
|
|
101
|
+
kind: "condition";
|
|
102
|
+
condition: LinkageCondition;
|
|
103
|
+
} | {
|
|
104
|
+
kind: "change";
|
|
105
|
+
} | {
|
|
106
|
+
kind: "focus";
|
|
107
|
+
} | {
|
|
108
|
+
kind: "blur";
|
|
109
|
+
} | {
|
|
110
|
+
kind: "click";
|
|
111
|
+
} | {
|
|
112
|
+
kind: "load";
|
|
113
|
+
} | {
|
|
114
|
+
kind: "beforeSubmit";
|
|
115
|
+
} | {
|
|
116
|
+
kind: "afterSubmit";
|
|
117
|
+
};
|
|
118
|
+
/**
|
|
119
|
+
* How a single **effect** action re-fires under a `condition` trigger as values
|
|
120
|
+
* change. Configured per effect action (not on the trigger) so one rule can mix
|
|
121
|
+
* a re-firing `alert` with a once-only `api_call`. Ignored under an edge trigger
|
|
122
|
+
* (`change` / `click` / ...), which already pulses on every event, and on state
|
|
123
|
+
* actions, which are level-derived every render regardless.
|
|
124
|
+
*
|
|
125
|
+
* - `"edge"` (default) — fire once on the condition's false→true rising edge.
|
|
126
|
+
* Entering the condition triggers the effect; it then stays quiet while the
|
|
127
|
+
* condition keeps holding. This is the standard side-effect semantic and
|
|
128
|
+
* prevents `api_call` / `navigate` / `submit` spam on every keystroke.
|
|
129
|
+
* - `"always"` — fire every time the condition is true *and* a field the
|
|
130
|
+
* condition depends on changes (e.g. "re-warn on each edit while the value is
|
|
131
|
+
* out of range"). An unrelated field changing does not re-fire it. Expression
|
|
132
|
+
* conditions have opaque dependencies, so they fall back to firing on any
|
|
133
|
+
* value change while the condition holds.
|
|
134
|
+
*/
|
|
135
|
+
export type ConditionRetrigger = "edge" | "always";
|
|
136
|
+
/**
|
|
137
|
+
* Discriminator extracted from {@link LinkageTrigger}.
|
|
138
|
+
*/
|
|
139
|
+
export type LinkageTriggerKind = LinkageTrigger["kind"];
|
|
140
|
+
/**
|
|
141
|
+
* Default-state overrides applied before any rule fires. Useful for
|
|
142
|
+
* "hidden by default, shown when condition matches" progressive forms.
|
|
143
|
+
*/
|
|
144
|
+
export interface FieldLinkageDefaults {
|
|
145
|
+
hidden?: boolean;
|
|
146
|
+
disabled?: boolean;
|
|
147
|
+
required?: boolean;
|
|
148
|
+
}
|
|
149
|
+
/**
|
|
150
|
+
* Value used by an action that writes data (`assign`, `set_field`, `alert`,
|
|
151
|
+
* `navigate`). A literal carries the value verbatim; an expression is computed
|
|
152
|
+
* at runtime via the injected evaluator.
|
|
153
|
+
*/
|
|
154
|
+
export type LinkageActionValue = {
|
|
155
|
+
kind: "literal";
|
|
156
|
+
value: unknown;
|
|
157
|
+
} | {
|
|
158
|
+
kind: "expression";
|
|
159
|
+
source: string;
|
|
160
|
+
};
|
|
161
|
+
/**
|
|
162
|
+
* Severity passed to an `alert` effect, mirroring antd's alert/message levels.
|
|
163
|
+
*/
|
|
164
|
+
export type LinkageAlertLevel = "info" | "success" | "warning" | "error";
|
|
165
|
+
/**
|
|
166
|
+
* **State actions** derive a field's runtime state and are *level / continuous*:
|
|
167
|
+
* while a condition holds the state is applied, and when it stops holding the
|
|
168
|
+
* state reverts. They are meaningful only under a `condition` trigger, and the
|
|
169
|
+
* pure state lane folds them into `RuntimeFieldState`.
|
|
170
|
+
*
|
|
171
|
+
* - `show` / `hide` / `enable` / `disable` apply to leaves and containers.
|
|
172
|
+
* - `require` / `optional` / `assign` are keyed-leaf only (they touch a value).
|
|
173
|
+
* - `script` is the escape hatch — host returns a partial state patch.
|
|
174
|
+
*/
|
|
175
|
+
export type StateAction = {
|
|
176
|
+
type: "show" | "hide" | "enable" | "disable" | "require" | "optional";
|
|
177
|
+
} | {
|
|
178
|
+
type: "assign";
|
|
179
|
+
value: LinkageActionValue;
|
|
180
|
+
} | {
|
|
181
|
+
type: "script";
|
|
182
|
+
source: string;
|
|
183
|
+
};
|
|
184
|
+
/**
|
|
185
|
+
* **Effect actions** are *edge-fired side effects*: they run once when a trigger
|
|
186
|
+
* fires (a condition's false→true rising edge, a field event, or a form
|
|
187
|
+
* lifecycle moment). They never derive durable state — state must stay
|
|
188
|
+
* reconstructible from values — so writing another field is `set_field` (an
|
|
189
|
+
* imperative one-shot write), distinct from the continuous self-`assign`.
|
|
190
|
+
*
|
|
191
|
+
* `set_field` / `set_variable` / `refresh_data_source` / `submit` / `reset` are
|
|
192
|
+
* handled natively by the runtime (it owns the form api, the `$vars` store, and
|
|
193
|
+
* the data-source refresh versions); `alert` / `api_call` / `navigate` are
|
|
194
|
+
* delegated to the host's {@link LinkageEvaluators.dispatchEffect} (a no-op by
|
|
195
|
+
* default), mirroring the `DataSourceResolver` injection seam.
|
|
196
|
+
*
|
|
197
|
+
* Every effect carries an optional {@link ConditionRetrigger} (`retrigger`)
|
|
198
|
+
* controlling how it re-fires under a `condition` trigger; it defaults to
|
|
199
|
+
* `"edge"` and is ignored under edge triggers. Intersecting it onto the union
|
|
200
|
+
* (rather than repeating it per member) keeps the `type` discriminant — and thus
|
|
201
|
+
* narrowing — intact.
|
|
202
|
+
*/
|
|
203
|
+
export type EffectAction = ({
|
|
204
|
+
type: "alert";
|
|
205
|
+
level?: LinkageAlertLevel;
|
|
206
|
+
message: LinkageActionValue;
|
|
207
|
+
} | {
|
|
208
|
+
type: "set_field";
|
|
209
|
+
targetKey: string;
|
|
210
|
+
value: LinkageActionValue;
|
|
211
|
+
} | {
|
|
212
|
+
type: "set_variable";
|
|
213
|
+
variable: string;
|
|
214
|
+
value: LinkageActionValue;
|
|
215
|
+
} | {
|
|
216
|
+
type: "refresh_data_source";
|
|
217
|
+
dataSourceId: string;
|
|
218
|
+
} | {
|
|
219
|
+
type: "api_call";
|
|
220
|
+
request: RemoteDataSourceRequest;
|
|
221
|
+
} | {
|
|
222
|
+
type: "navigate";
|
|
223
|
+
to: LinkageActionValue;
|
|
224
|
+
} | {
|
|
225
|
+
type: "submit";
|
|
226
|
+
} | {
|
|
227
|
+
type: "reset";
|
|
228
|
+
}) & {
|
|
229
|
+
retrigger?: ConditionRetrigger;
|
|
230
|
+
};
|
|
231
|
+
/**
|
|
232
|
+
* The unified action vocabulary shared by conditions and events. A rule carries
|
|
233
|
+
* an ordered list of these; the runtime routes each by family — state actions
|
|
234
|
+
* into the derived-state fold, effect actions into the side-effect lane.
|
|
235
|
+
*
|
|
236
|
+
* The `id` is an optional client-stable identity (minted by the editor) so the
|
|
237
|
+
* actions list keys off identity rather than array index; the runtime ignores
|
|
238
|
+
* it. Intersecting keeps the `type` discriminant — and thus narrowing — intact.
|
|
239
|
+
*/
|
|
240
|
+
export type FieldLinkageAction = (StateAction | EffectAction) & {
|
|
241
|
+
id?: string;
|
|
242
|
+
};
|
|
243
|
+
/**
|
|
244
|
+
* Discriminators, narrowed per family. {@link LinkageActionType} is the full
|
|
245
|
+
* union; the engine's `isStateAction` / `isEffectAction` guards split them.
|
|
246
|
+
*/
|
|
247
|
+
export type StateActionType = StateAction["type"];
|
|
248
|
+
export type EffectActionType = EffectAction["type"];
|
|
249
|
+
export type LinkageActionType = FieldLinkageAction["type"];
|
|
250
|
+
/**
|
|
251
|
+
* Partial state patch returned by a `script` action's body. Any omitted
|
|
252
|
+
* key leaves the corresponding runtime-state slot untouched.
|
|
253
|
+
*
|
|
254
|
+
* `value` is the script equivalent of `assign` — setting it marks the
|
|
255
|
+
* field assigned and applies the supplied value at the form-runtime level.
|
|
256
|
+
*/
|
|
257
|
+
export interface LinkageScriptResult {
|
|
258
|
+
hidden?: boolean;
|
|
259
|
+
disabled?: boolean;
|
|
260
|
+
required?: boolean;
|
|
261
|
+
value?: unknown;
|
|
262
|
+
}
|
|
263
|
+
/**
|
|
264
|
+
* One linkage rule: a single {@link LinkageTrigger} paired with an ordered list
|
|
265
|
+
* of {@link FieldLinkageAction}s. When the trigger fires, the actions run in
|
|
266
|
+
* declaration order — state actions fold into the field's runtime state, effect
|
|
267
|
+
* actions fire as side effects.
|
|
268
|
+
*/
|
|
269
|
+
export interface FieldLinkageRule {
|
|
270
|
+
id: string;
|
|
271
|
+
trigger: LinkageTrigger;
|
|
272
|
+
actions: FieldLinkageAction[];
|
|
273
|
+
}
|
|
274
|
+
export interface FieldLinkage {
|
|
275
|
+
defaults?: FieldLinkageDefaults;
|
|
276
|
+
rules?: FieldLinkageRule[];
|
|
277
|
+
}
|
|
278
|
+
/**
|
|
279
|
+
* Context handed to the host's {@link LinkageEvaluators.dispatchEffect} so it
|
|
280
|
+
* can render an alert, fire an API call, or navigate using the values present
|
|
281
|
+
* when the effect fired.
|
|
282
|
+
*/
|
|
283
|
+
export interface EffectDispatchContext {
|
|
284
|
+
/**
|
|
285
|
+
* The form values in the firing rule's value scope at the moment the effect
|
|
286
|
+
* ran (a subform row's effect sees that row's record, not the root form).
|
|
287
|
+
*/
|
|
288
|
+
values: Record<string, unknown>;
|
|
289
|
+
/**
|
|
290
|
+
* Resolve a literal / expression action value against {@link values}.
|
|
291
|
+
*/
|
|
292
|
+
resolveValue: (value: LinkageActionValue) => unknown;
|
|
293
|
+
}
|
|
294
|
+
/**
|
|
295
|
+
* Extra scope surfaced to expressions and scripts alongside the form values.
|
|
296
|
+
* The default evaluator exposes these as `$vars` / `$user` / `$node` (plus
|
|
297
|
+
* `$form` for the values and `$now` for the current time); all are optional, so
|
|
298
|
+
* an expression that only reads `field.x` / `$form.x` keeps working when no
|
|
299
|
+
* context is supplied.
|
|
300
|
+
*/
|
|
301
|
+
export interface ExpressionContext {
|
|
302
|
+
/**
|
|
303
|
+
* Form-global variables (`$vars`), seeded from `FormSchema.variables`.
|
|
304
|
+
*/
|
|
305
|
+
variables?: Record<string, unknown>;
|
|
306
|
+
/**
|
|
307
|
+
* Host-supplied current-user info (`$user`) — e.g. role-driven linkage.
|
|
308
|
+
*/
|
|
309
|
+
user?: Record<string, unknown>;
|
|
310
|
+
/**
|
|
311
|
+
* Host-supplied workflow-node context (`$node`).
|
|
312
|
+
*/
|
|
313
|
+
node?: Record<string, unknown>;
|
|
314
|
+
}
|
|
315
|
+
/**
|
|
316
|
+
* Pluggable evaluators for the dynamic parts of the model. The expression /
|
|
317
|
+
* script slots default to a `new Function`-based implementation provided by the
|
|
318
|
+
* engine package; `dispatchEffect` defaults to a no-op. Hosts override any slot
|
|
319
|
+
* to swap in their own JS engine, sandbox, or effect runtime.
|
|
320
|
+
*
|
|
321
|
+
* The optional `context` argument carries the {@link ExpressionContext}
|
|
322
|
+
* (`$vars` / `$user` / `$node`); a host evaluator may ignore it.
|
|
323
|
+
*/
|
|
324
|
+
export interface LinkageEvaluators {
|
|
325
|
+
/**
|
|
326
|
+
* Evaluates an expression-condition's `source` against the current
|
|
327
|
+
* form values and returns a boolean. Should return `false` (not throw)
|
|
328
|
+
* when the source is malformed.
|
|
329
|
+
*/
|
|
330
|
+
evaluateExpression?: (source: string, values: Record<string, unknown>, context?: ExpressionContext) => boolean;
|
|
331
|
+
/**
|
|
332
|
+
* Evaluates a script-action's `source` against the current form values
|
|
333
|
+
* and returns a state patch. Returning `void` is treated as no-op.
|
|
334
|
+
*/
|
|
335
|
+
evaluateScriptAction?: (source: string, values: Record<string, unknown>, context?: ExpressionContext) => LinkageScriptResult | void;
|
|
336
|
+
/**
|
|
337
|
+
* Evaluates an assignment / value expression's `source` and returns the
|
|
338
|
+
* computed value. Used by every action value with `{ kind: "expression" }`.
|
|
339
|
+
*/
|
|
340
|
+
evaluateAssignExpression?: (source: string, values: Record<string, unknown>, context?: ExpressionContext) => unknown;
|
|
341
|
+
/**
|
|
342
|
+
* Handles the host-delegated effect actions (`alert` / `api_call` /
|
|
343
|
+
* `navigate`). The runtime handles `set_field` / `set_variable` /
|
|
344
|
+
* `refresh_data_source` / `submit` / `reset` itself and never routes them
|
|
345
|
+
* here. Defaults to a no-op so a form with effect actions
|
|
346
|
+
* degrades gracefully when the host wires none — exactly as a `remote` data
|
|
347
|
+
* source resolves to an empty list without a resolver.
|
|
348
|
+
*/
|
|
349
|
+
dispatchEffect?: (action: EffectAction, context: EffectDispatchContext) => void | Promise<void>;
|
|
350
|
+
}
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
import { FormField, FormSchema } from './schema';
|
|
2
|
+
/**
|
|
3
|
+
* Open registry of property entry types — the source of the {@link EntryType}
|
|
4
|
+
* discriminator. Built-in types live here; consumers augment the interface
|
|
5
|
+
* (`declare module`) to add new types and register a renderer for them via
|
|
6
|
+
* `FormFieldRegistry.registerPropertyEntry`. Each entry's per-renderer knobs are
|
|
7
|
+
* the shared `options` / `placeholder` / `description` slots on
|
|
8
|
+
* {@link PropertyEntry}; the values here are placeholders, only the keys matter.
|
|
9
|
+
*/
|
|
10
|
+
export interface PropertyEntryTypeMap {
|
|
11
|
+
text: undefined;
|
|
12
|
+
key: undefined;
|
|
13
|
+
number: undefined;
|
|
14
|
+
checkbox: undefined;
|
|
15
|
+
select: undefined;
|
|
16
|
+
icon: undefined;
|
|
17
|
+
"options-editor": undefined;
|
|
18
|
+
"linkage-rules": undefined;
|
|
19
|
+
}
|
|
20
|
+
export type EntryType = keyof PropertyEntryTypeMap;
|
|
21
|
+
export interface PropertyEntryOption {
|
|
22
|
+
value: string;
|
|
23
|
+
label: string;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Props passed to every property entry renderer. The lens on `entry`
|
|
27
|
+
* (`read` / `write`) is opaque at this seam — runtime safety comes from
|
|
28
|
+
* the entry's `definePropertyEntry` declaration, not from re-narrowing
|
|
29
|
+
* here. Renderers handle their own value coercion through `entry.read`
|
|
30
|
+
* and forward the user's input via `onChange`; the panel applies it via
|
|
31
|
+
* `entry.write`.
|
|
32
|
+
*/
|
|
33
|
+
export interface EntryComponentProps {
|
|
34
|
+
entry: PropertyEntry;
|
|
35
|
+
field: FormField;
|
|
36
|
+
schema: FormSchema;
|
|
37
|
+
onChange: (value: unknown) => void;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* A property entry describes one editable property on a field.
|
|
41
|
+
*
|
|
42
|
+
* `read` / `write` are the lens that mediate between the panel and the
|
|
43
|
+
* field. Both are typed against the concrete field interface and the
|
|
44
|
+
* value the entry renderer consumes, so a typo in a property name or a
|
|
45
|
+
* wrong-type write fails to compile. Authors must declare entries through
|
|
46
|
+
* {@link definePropertyEntry} so this pairing is checked at the call
|
|
47
|
+
* site — bare object literals would lose the per-entry generic to the
|
|
48
|
+
* group's heterogeneous storage.
|
|
49
|
+
*/
|
|
50
|
+
export interface PropertyEntry<TField extends FormField = FormField, TValue = unknown> {
|
|
51
|
+
id: string;
|
|
52
|
+
label: string;
|
|
53
|
+
/**
|
|
54
|
+
* Discriminator matched against a renderer registered via
|
|
55
|
+
* `FormFieldRegistry.registerPropertyEntry`.
|
|
56
|
+
*/
|
|
57
|
+
type: EntryType;
|
|
58
|
+
options?: PropertyEntryOption[];
|
|
59
|
+
visible?: (field: TField) => boolean;
|
|
60
|
+
/**
|
|
61
|
+
* When true, the entry is rendered in a read-only state.
|
|
62
|
+
*/
|
|
63
|
+
readOnly?: boolean;
|
|
64
|
+
/**
|
|
65
|
+
* Optional helper line shown under the input.
|
|
66
|
+
*/
|
|
67
|
+
description?: string;
|
|
68
|
+
/**
|
|
69
|
+
* Placeholder text for input-style entries.
|
|
70
|
+
*/
|
|
71
|
+
placeholder?: string;
|
|
72
|
+
/**
|
|
73
|
+
* Reads the current value off the field. Pure.
|
|
74
|
+
*/
|
|
75
|
+
read: (field: TField) => TValue;
|
|
76
|
+
/**
|
|
77
|
+
* Returns a new field with the property updated. Pure — must not mutate
|
|
78
|
+
* the input.
|
|
79
|
+
*/
|
|
80
|
+
write: (field: TField, value: TValue) => TField;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Identity helper that pins both `TField` and `TValue` at the declaration
|
|
84
|
+
* site while widening the result to the group's storage type.
|
|
85
|
+
*
|
|
86
|
+
* Use this in every `*.properties.ts` file instead of bare object
|
|
87
|
+
* literals. The widening is a single, well-contained cast (this function
|
|
88
|
+
* is the only place the type system loses information); the call-site
|
|
89
|
+
* generics keep authors honest about what their lens actually reads and
|
|
90
|
+
* writes.
|
|
91
|
+
*/
|
|
92
|
+
export declare function definePropertyEntry<TField extends FormField, TValue>(entry: PropertyEntry<TField, TValue>): PropertyEntry;
|
|
93
|
+
/**
|
|
94
|
+
* Tab the property panel renders this group inside. Determines which tab in
|
|
95
|
+
* the panel header the group's entries appear under.
|
|
96
|
+
*
|
|
97
|
+
* - `props`: general attributes (label, key, placeholder, ...)
|
|
98
|
+
* - `validation`: validation rules (required, min/max length, regex, ...)
|
|
99
|
+
* - `linkage`: field linkage (show/hide rules driven by other fields)
|
|
100
|
+
* - `layout`: sizing within a flex / grid container (grow / basis / span);
|
|
101
|
+
* contextual — the panel only surfaces this tab for a container's children
|
|
102
|
+
*/
|
|
103
|
+
export type PropertyTabId = "props" | "validation" | "linkage" | "layout";
|
|
104
|
+
export interface PropertyGroup {
|
|
105
|
+
/**
|
|
106
|
+
* 'general' | 'appearance' | 'validation' | custom.
|
|
107
|
+
*/
|
|
108
|
+
id: string;
|
|
109
|
+
label: string;
|
|
110
|
+
/**
|
|
111
|
+
* Which top-level tab to display this group under. Defaults to `"props"`
|
|
112
|
+
* when omitted so existing descriptors keep their current behavior.
|
|
113
|
+
*/
|
|
114
|
+
tab?: PropertyTabId;
|
|
115
|
+
/**
|
|
116
|
+
* Heterogeneous entries (text, number, checkbox, …). Each declared via
|
|
117
|
+
* {@link definePropertyEntry} so the per-entry `TField`/`TValue` are
|
|
118
|
+
* pinned at the call site; group storage widens to the defaults.
|
|
119
|
+
*/
|
|
120
|
+
entries: PropertyEntry[];
|
|
121
|
+
}
|
|
122
|
+
export type PropertiesDescriptor = PropertyGroup[];
|