@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.
Files changed (483) hide show
  1. package/dist/cjs/_internal/_rolldown/runtime.cjs +1 -0
  2. package/dist/cjs/components/button/index.cjs +1 -0
  3. package/dist/cjs/components/checkbox-group-field/index.cjs +1 -0
  4. package/dist/cjs/components/code-editor/code-editor-input.cjs +1 -0
  5. package/dist/cjs/components/code-editor/index.cjs +1 -0
  6. package/dist/cjs/components/containers/index.cjs +1 -0
  7. package/dist/cjs/components/date-field/index.cjs +1 -0
  8. package/dist/cjs/components/display/index.cjs +1 -0
  9. package/dist/cjs/components/field-entries.cjs +1 -0
  10. package/dist/cjs/components/mobile/alert-block.cjs +1 -0
  11. package/dist/cjs/components/mobile/button.cjs +1 -0
  12. package/dist/cjs/components/mobile/checkbox-group.cjs +1 -0
  13. package/dist/cjs/components/mobile/date-adapters.cjs +1 -0
  14. package/dist/cjs/components/mobile/date.cjs +1 -0
  15. package/dist/cjs/components/mobile/daterange.cjs +1 -0
  16. package/dist/cjs/components/mobile/datetime.cjs +1 -0
  17. package/dist/cjs/components/mobile/definitions.cjs +1 -0
  18. package/dist/cjs/components/mobile/divider.cjs +1 -0
  19. package/dist/cjs/components/mobile/input-cell.cjs +1 -0
  20. package/dist/cjs/components/mobile/number.cjs +1 -0
  21. package/dist/cjs/components/mobile/option-group.cjs +1 -0
  22. package/dist/cjs/components/mobile/paragraph.cjs +1 -0
  23. package/dist/cjs/components/mobile/picker-trigger.cjs +1 -0
  24. package/dist/cjs/components/mobile/radio.cjs +1 -0
  25. package/dist/cjs/components/mobile/scope.cjs +1 -0
  26. package/dist/cjs/components/mobile/select.cjs +1 -0
  27. package/dist/cjs/components/mobile/switch.cjs +1 -0
  28. package/dist/cjs/components/mobile/textarea.cjs +1 -0
  29. package/dist/cjs/components/mobile/textfield.cjs +1 -0
  30. package/dist/cjs/components/mobile/theme.cjs +1 -0
  31. package/dist/cjs/components/number-field/index.cjs +1 -0
  32. package/dist/cjs/components/radio-field/index.cjs +1 -0
  33. package/dist/cjs/components/select-field/index.cjs +1 -0
  34. package/dist/cjs/components/switch-field/index.cjs +1 -0
  35. package/dist/cjs/components/textarea-field/index.cjs +1 -0
  36. package/dist/cjs/components/textfield/index.cjs +1 -0
  37. package/dist/cjs/editor/canvas/canvas-field.cjs +1 -0
  38. package/dist/cjs/editor/canvas/canvas.cjs +1 -0
  39. package/dist/cjs/editor/canvas/drop-indicator.cjs +1 -0
  40. package/dist/cjs/editor/canvas/drop-zones.cjs +1 -0
  41. package/dist/cjs/editor/canvas/json-split-view.cjs +1 -0
  42. package/dist/cjs/editor/canvas/mobile-seed-state.cjs +2 -0
  43. package/dist/cjs/editor/canvas/phone-frame.cjs +1 -0
  44. package/dist/cjs/editor/dnd.cjs +1 -0
  45. package/dist/cjs/editor/editor-layout-context.cjs +1 -0
  46. package/dist/cjs/editor/footer/footer.cjs +1 -0
  47. package/dist/cjs/editor/form-config/form-basics-tab.cjs +1 -0
  48. package/dist/cjs/editor/form-config/form-config-drawer.cjs +1 -0
  49. package/dist/cjs/editor/form-config/outline-tab.cjs +1 -0
  50. package/dist/cjs/editor/form-editor.cjs +1 -0
  51. package/dist/cjs/editor/palette/field-groups.cjs +1 -0
  52. package/dist/cjs/editor/palette/palette-group.cjs +1 -0
  53. package/dist/cjs/editor/palette/palette-item.cjs +1 -0
  54. package/dist/cjs/editor/palette/palette-panel.cjs +1 -0
  55. package/dist/cjs/editor/preview-effects.cjs +1 -0
  56. package/dist/cjs/editor/preview-runtime-context.cjs +1 -0
  57. package/dist/cjs/editor/properties/block-layout-section.cjs +1 -0
  58. package/dist/cjs/editor/properties/container-properties.cjs +1 -0
  59. package/dist/cjs/editor/properties/entries/built-ins.cjs +1 -0
  60. package/dist/cjs/editor/properties/entries/checkbox-entry.cjs +1 -0
  61. package/dist/cjs/editor/properties/entries/coerce.cjs +1 -0
  62. package/dist/cjs/editor/properties/entries/entry-field.cjs +1 -0
  63. package/dist/cjs/editor/properties/entries/icon-entry.cjs +1 -0
  64. package/dist/cjs/editor/properties/entries/index.cjs +1 -0
  65. package/dist/cjs/editor/properties/entries/key-entry.cjs +1 -0
  66. package/dist/cjs/editor/properties/entries/linkage/action-editor.cjs +2 -0
  67. package/dist/cjs/editor/properties/entries/linkage/actions-editor.cjs +1 -0
  68. package/dist/cjs/editor/properties/entries/linkage/condition-editor.cjs +1 -0
  69. package/dist/cjs/editor/properties/entries/linkage/container-linkage-section.cjs +1 -0
  70. package/dist/cjs/editor/properties/entries/linkage/expression-assist.cjs +1 -0
  71. package/dist/cjs/editor/properties/entries/linkage/index.cjs +1 -0
  72. package/dist/cjs/editor/properties/entries/linkage/linkage-rules-entry.cjs +1 -0
  73. package/dist/cjs/editor/properties/entries/linkage/mutators.cjs +1 -0
  74. package/dist/cjs/editor/properties/entries/linkage/options.cjs +1 -0
  75. package/dist/cjs/editor/properties/entries/linkage/rule-diagnostics.cjs +1 -0
  76. package/dist/cjs/editor/properties/entries/linkage/rule-list-editor.cjs +1 -0
  77. package/dist/cjs/editor/properties/entries/linkage/styles.cjs +1 -0
  78. package/dist/cjs/editor/properties/entries/linkage/trigger-editor.cjs +1 -0
  79. package/dist/cjs/editor/properties/entries/linkage/use-linkage-editor-model.cjs +1 -0
  80. package/dist/cjs/editor/properties/entries/linkage/use-stable-options.cjs +1 -0
  81. package/dist/cjs/editor/properties/entries/number-entry.cjs +1 -0
  82. package/dist/cjs/editor/properties/entries/options-source/index.cjs +1 -0
  83. package/dist/cjs/editor/properties/entries/options-source/source-mutators.cjs +1 -0
  84. package/dist/cjs/editor/properties/entries/select-entry.cjs +1 -0
  85. package/dist/cjs/editor/properties/entries/text-entry.cjs +1 -0
  86. package/dist/cjs/editor/properties/form-data-sources-panel.cjs +1 -0
  87. package/dist/cjs/editor/properties/form-linkage-panel.cjs +1 -0
  88. package/dist/cjs/editor/properties/form-variables-panel.cjs +1 -0
  89. package/dist/cjs/editor/properties/option-editors.cjs +1 -0
  90. package/dist/cjs/editor/properties/panel-header.cjs +1 -0
  91. package/dist/cjs/editor/properties/properties-empty.cjs +1 -0
  92. package/dist/cjs/editor/properties/properties-header.cjs +1 -0
  93. package/dist/cjs/editor/properties/properties-panel.cjs +1 -0
  94. package/dist/cjs/editor/properties/properties-provider.cjs +1 -0
  95. package/dist/cjs/editor/properties/properties-tabs.cjs +1 -0
  96. package/dist/cjs/editor/properties/use-confirmable-kind-switch.cjs +1 -0
  97. package/dist/cjs/editor/remove-node-confirm.cjs +1 -0
  98. package/dist/cjs/editor/schema-apply.cjs +2 -0
  99. package/dist/cjs/editor/styles.cjs +1 -0
  100. package/dist/cjs/editor/toolbar/notify.cjs +1 -0
  101. package/dist/cjs/editor/toolbar/schema-io.cjs +1 -0
  102. package/dist/cjs/editor/toolbar/toolbar.cjs +1 -0
  103. package/dist/cjs/editor/use-editor-shortcuts.cjs +1 -0
  104. package/dist/cjs/editor/validation-summary.cjs +1 -0
  105. package/dist/cjs/engine/assert-never.cjs +1 -0
  106. package/dist/cjs/engine/conversion/index.cjs +1 -0
  107. package/dist/cjs/engine/ids.cjs +1 -0
  108. package/dist/cjs/engine/keys.cjs +1 -0
  109. package/dist/cjs/engine/linkage/cycle.cjs +1 -0
  110. package/dist/cjs/engine/linkage/default-evaluator.cjs +1 -0
  111. package/dist/cjs/engine/linkage/effects.cjs +1 -0
  112. package/dist/cjs/engine/linkage/evaluator.cjs +1 -0
  113. package/dist/cjs/engine/linkage/index.cjs +1 -0
  114. package/dist/cjs/engine/linkage/operators.cjs +1 -0
  115. package/dist/cjs/engine/linkage/source-tracking.cjs +1 -0
  116. package/dist/cjs/engine/linkage/taxonomy.cjs +1 -0
  117. package/dist/cjs/engine/linkage/validator.cjs +1 -0
  118. package/dist/cjs/engine/registry/defaults-mobile.cjs +1 -0
  119. package/dist/cjs/engine/registry/defaults.cjs +1 -0
  120. package/dist/cjs/engine/registry/form-field-registry.cjs +1 -0
  121. package/dist/cjs/engine/schema/edit-ops.cjs +1 -0
  122. package/dist/cjs/engine/schema/mutate.cjs +1 -0
  123. package/dist/cjs/engine/schema/nodes.cjs +1 -0
  124. package/dist/cjs/engine/schema/permission-bridge.cjs +1 -0
  125. package/dist/cjs/engine/schema/presentation.cjs +1 -0
  126. package/dist/cjs/engine/schema/reconcile.cjs +1 -0
  127. package/dist/cjs/engine/schema/removal-impact.cjs +1 -0
  128. package/dist/cjs/engine/schema/rewrite.cjs +1 -0
  129. package/dist/cjs/engine/schema/validate.cjs +1 -0
  130. package/dist/cjs/engine/schema/walk.cjs +1 -0
  131. package/dist/cjs/engine/validation.cjs +1 -0
  132. package/dist/cjs/icons.cjs +1 -0
  133. package/dist/cjs/index.cjs +1 -0
  134. package/dist/cjs/render/chrome/mobile-chrome.cjs +1 -0
  135. package/dist/cjs/render/chrome/pc-chrome.cjs +1 -0
  136. package/dist/cjs/render/chrome/subform-shell.cjs +1 -0
  137. package/dist/cjs/render/data-source-context.cjs +0 -0
  138. package/dist/cjs/render/flex-style.cjs +1 -0
  139. package/dist/cjs/render/form-field.cjs +1 -0
  140. package/dist/cjs/render/form-renderer.cjs +1 -0
  141. package/dist/cjs/render/grid-style.cjs +1 -0
  142. package/dist/cjs/render/parts/field-shell.cjs +1 -0
  143. package/dist/cjs/render/parts/label.cjs +1 -0
  144. package/dist/cjs/render/parts/options-status.cjs +1 -0
  145. package/dist/cjs/render/stack-style.cjs +1 -0
  146. package/dist/cjs/render/subform-columns.cjs +1 -0
  147. package/dist/cjs/render/submit.cjs +1 -0
  148. package/dist/cjs/runtime/effects.cjs +1 -0
  149. package/dist/cjs/runtime/resolve-scope-values.cjs +1 -0
  150. package/dist/cjs/runtime/runtime-context.cjs +1 -0
  151. package/dist/cjs/runtime/runtime-state-controller.cjs +1 -0
  152. package/dist/cjs/runtime/stabilize-state-map.cjs +1 -0
  153. package/dist/cjs/store/engine-provider.cjs +1 -0
  154. package/dist/cjs/store/form-store.cjs +1 -0
  155. package/dist/cjs/types/chrome.cjs +0 -0
  156. package/dist/cjs/types/component.cjs +1 -0
  157. package/dist/cjs/types/data-source.cjs +1 -0
  158. package/dist/cjs/types/index.cjs +1 -0
  159. package/dist/cjs/types/linkage.cjs +0 -0
  160. package/dist/cjs/types/properties.cjs +1 -0
  161. package/dist/cjs/types/schema.cjs +1 -0
  162. package/dist/es/components/button/index.js +183 -0
  163. package/dist/es/components/checkbox-group-field/index.js +103 -0
  164. package/dist/es/components/code-editor/code-editor-input.js +3 -0
  165. package/dist/es/components/code-editor/index.js +212 -0
  166. package/dist/es/components/containers/index.js +72 -0
  167. package/dist/es/components/date-field/index.js +197 -0
  168. package/dist/es/components/display/index.js +276 -0
  169. package/dist/es/components/field-entries.js +184 -0
  170. package/dist/es/components/mobile/alert-block.js +40 -0
  171. package/dist/es/components/mobile/button.js +41 -0
  172. package/dist/es/components/mobile/checkbox-group.js +35 -0
  173. package/dist/es/components/mobile/date-adapters.js +16 -0
  174. package/dist/es/components/mobile/date.js +42 -0
  175. package/dist/es/components/mobile/daterange.js +48 -0
  176. package/dist/es/components/mobile/datetime.js +42 -0
  177. package/dist/es/components/mobile/definitions.js +58 -0
  178. package/dist/es/components/mobile/divider.js +10 -0
  179. package/dist/es/components/mobile/input-cell.js +56 -0
  180. package/dist/es/components/mobile/number.js +73 -0
  181. package/dist/es/components/mobile/option-group.js +34 -0
  182. package/dist/es/components/mobile/paragraph.js +30 -0
  183. package/dist/es/components/mobile/picker-trigger.js +94 -0
  184. package/dist/es/components/mobile/radio.js +35 -0
  185. package/dist/es/components/mobile/scope.js +61 -0
  186. package/dist/es/components/mobile/select.js +45 -0
  187. package/dist/es/components/mobile/switch.js +22 -0
  188. package/dist/es/components/mobile/textarea.js +32 -0
  189. package/dist/es/components/mobile/textfield.js +30 -0
  190. package/dist/es/components/mobile/theme.js +8 -0
  191. package/dist/es/components/number-field/index.js +186 -0
  192. package/dist/es/components/radio-field/index.js +139 -0
  193. package/dist/es/components/select-field/index.js +128 -0
  194. package/dist/es/components/switch-field/index.js +133 -0
  195. package/dist/es/components/textarea-field/index.js +137 -0
  196. package/dist/es/components/textfield/index.js +138 -0
  197. package/dist/es/editor/canvas/canvas-field.js +202 -0
  198. package/dist/es/editor/canvas/canvas.js +415 -0
  199. package/dist/es/editor/canvas/drop-indicator.js +42 -0
  200. package/dist/es/editor/canvas/drop-zones.js +42 -0
  201. package/dist/es/editor/canvas/json-split-view.js +148 -0
  202. package/dist/es/editor/canvas/mobile-seed-state.js +103 -0
  203. package/dist/es/editor/canvas/phone-frame.js +109 -0
  204. package/dist/es/editor/dnd.js +75 -0
  205. package/dist/es/editor/editor-layout-context.js +34 -0
  206. package/dist/es/editor/footer/footer.js +154 -0
  207. package/dist/es/editor/form-config/form-basics-tab.js +184 -0
  208. package/dist/es/editor/form-config/form-config-drawer.js +224 -0
  209. package/dist/es/editor/form-config/outline-tab.js +132 -0
  210. package/dist/es/editor/form-editor.js +179 -0
  211. package/dist/es/editor/palette/field-groups.js +19 -0
  212. package/dist/es/editor/palette/palette-group.js +147 -0
  213. package/dist/es/editor/palette/palette-item.js +153 -0
  214. package/dist/es/editor/palette/palette-panel.js +109 -0
  215. package/dist/es/editor/preview-effects.js +22 -0
  216. package/dist/es/editor/preview-runtime-context.js +24 -0
  217. package/dist/es/editor/properties/block-layout-section.js +161 -0
  218. package/dist/es/editor/properties/container-properties.js +575 -0
  219. package/dist/es/editor/properties/entries/built-ins.js +21 -0
  220. package/dist/es/editor/properties/entries/checkbox-entry.js +31 -0
  221. package/dist/es/editor/properties/entries/coerce.js +8 -0
  222. package/dist/es/editor/properties/entries/entry-field.js +43 -0
  223. package/dist/es/editor/properties/entries/icon-entry.js +21 -0
  224. package/dist/es/editor/properties/entries/index.js +9 -0
  225. package/dist/es/editor/properties/entries/key-entry.js +29 -0
  226. package/dist/es/editor/properties/entries/linkage/action-editor.js +260 -0
  227. package/dist/es/editor/properties/entries/linkage/actions-editor.js +64 -0
  228. package/dist/es/editor/properties/entries/linkage/condition-editor.js +265 -0
  229. package/dist/es/editor/properties/entries/linkage/container-linkage-section.js +71 -0
  230. package/dist/es/editor/properties/entries/linkage/expression-assist.js +87 -0
  231. package/dist/es/editor/properties/entries/linkage/index.js +3 -0
  232. package/dist/es/editor/properties/entries/linkage/linkage-rules-entry.js +110 -0
  233. package/dist/es/editor/properties/entries/linkage/mutators.js +209 -0
  234. package/dist/es/editor/properties/entries/linkage/options.js +155 -0
  235. package/dist/es/editor/properties/entries/linkage/rule-diagnostics.js +58 -0
  236. package/dist/es/editor/properties/entries/linkage/rule-list-editor.js +126 -0
  237. package/dist/es/editor/properties/entries/linkage/styles.js +276 -0
  238. package/dist/es/editor/properties/entries/linkage/trigger-editor.js +64 -0
  239. package/dist/es/editor/properties/entries/linkage/use-linkage-editor-model.js +20 -0
  240. package/dist/es/editor/properties/entries/linkage/use-stable-options.js +12 -0
  241. package/dist/es/editor/properties/entries/number-entry.js +25 -0
  242. package/dist/es/editor/properties/entries/options-source/index.js +122 -0
  243. package/dist/es/editor/properties/entries/options-source/source-mutators.js +31 -0
  244. package/dist/es/editor/properties/entries/select-entry.js +23 -0
  245. package/dist/es/editor/properties/entries/text-entry.js +23 -0
  246. package/dist/es/editor/properties/form-data-sources-panel.js +170 -0
  247. package/dist/es/editor/properties/form-linkage-panel.js +36 -0
  248. package/dist/es/editor/properties/form-variables-panel.js +184 -0
  249. package/dist/es/editor/properties/option-editors.js +170 -0
  250. package/dist/es/editor/properties/panel-header.js +93 -0
  251. package/dist/es/editor/properties/properties-empty.js +62 -0
  252. package/dist/es/editor/properties/properties-header.js +31 -0
  253. package/dist/es/editor/properties/properties-panel.js +195 -0
  254. package/dist/es/editor/properties/properties-provider.js +95 -0
  255. package/dist/es/editor/properties/properties-tabs.js +91 -0
  256. package/dist/es/editor/properties/use-confirmable-kind-switch.js +26 -0
  257. package/dist/es/editor/remove-node-confirm.js +60 -0
  258. package/dist/es/editor/schema-apply.js +36 -0
  259. package/dist/es/editor/styles.js +74 -0
  260. package/dist/es/editor/toolbar/notify.js +59 -0
  261. package/dist/es/editor/toolbar/schema-io.js +107 -0
  262. package/dist/es/editor/toolbar/toolbar.js +394 -0
  263. package/dist/es/editor/use-editor-shortcuts.js +43 -0
  264. package/dist/es/editor/validation-summary.js +66 -0
  265. package/dist/es/engine/assert-never.js +8 -0
  266. package/dist/es/engine/conversion/index.js +127 -0
  267. package/dist/es/engine/ids.js +18 -0
  268. package/dist/es/engine/keys.js +48 -0
  269. package/dist/es/engine/linkage/cycle.js +25 -0
  270. package/dist/es/engine/linkage/default-evaluator.js +79 -0
  271. package/dist/es/engine/linkage/effects.js +41 -0
  272. package/dist/es/engine/linkage/evaluator.js +119 -0
  273. package/dist/es/engine/linkage/index.js +9 -0
  274. package/dist/es/engine/linkage/operators.js +44 -0
  275. package/dist/es/engine/linkage/source-tracking.js +17 -0
  276. package/dist/es/engine/linkage/taxonomy.js +51 -0
  277. package/dist/es/engine/linkage/validator.js +360 -0
  278. package/dist/es/engine/registry/defaults-mobile.js +12 -0
  279. package/dist/es/engine/registry/defaults.js +25 -0
  280. package/dist/es/engine/registry/form-field-registry.js +52 -0
  281. package/dist/es/engine/schema/edit-ops.js +264 -0
  282. package/dist/es/engine/schema/mutate.js +39 -0
  283. package/dist/es/engine/schema/nodes.js +61 -0
  284. package/dist/es/engine/schema/permission-bridge.js +46 -0
  285. package/dist/es/engine/schema/presentation.js +37 -0
  286. package/dist/es/engine/schema/reconcile.js +258 -0
  287. package/dist/es/engine/schema/removal-impact.js +59 -0
  288. package/dist/es/engine/schema/rewrite.js +11 -0
  289. package/dist/es/engine/schema/validate.js +320 -0
  290. package/dist/es/engine/schema/walk.js +103 -0
  291. package/dist/es/engine/validation.js +122 -0
  292. package/dist/es/icons.js +74 -0
  293. package/dist/es/index.js +54 -0
  294. package/dist/es/render/chrome/mobile-chrome.js +119 -0
  295. package/dist/es/render/chrome/pc-chrome.js +76 -0
  296. package/dist/es/render/chrome/subform-shell.js +38 -0
  297. package/dist/es/render/data-source-context.js +0 -0
  298. package/dist/es/render/flex-style.js +24 -0
  299. package/dist/es/render/form-field.js +37 -0
  300. package/dist/es/render/form-renderer.js +516 -0
  301. package/dist/es/render/grid-style.js +23 -0
  302. package/dist/es/render/parts/field-shell.js +119 -0
  303. package/dist/es/render/parts/label.js +44 -0
  304. package/dist/es/render/parts/options-status.js +19 -0
  305. package/dist/es/render/stack-style.js +13 -0
  306. package/dist/es/render/subform-columns.js +118 -0
  307. package/dist/es/render/submit.js +112 -0
  308. package/dist/es/runtime/effects.js +109 -0
  309. package/dist/es/runtime/resolve-scope-values.js +14 -0
  310. package/dist/es/runtime/runtime-context.js +10 -0
  311. package/dist/es/runtime/runtime-state-controller.js +99 -0
  312. package/dist/es/runtime/stabilize-state-map.js +14 -0
  313. package/dist/es/store/engine-provider.js +37 -0
  314. package/dist/es/store/form-store.js +306 -0
  315. package/dist/es/types/chrome.js +1 -0
  316. package/dist/es/types/component.js +13 -0
  317. package/dist/es/types/data-source.js +5 -0
  318. package/dist/es/types/index.js +5 -0
  319. package/dist/es/types/linkage.js +1 -0
  320. package/dist/es/types/properties.js +7 -0
  321. package/dist/es/types/schema.js +15 -0
  322. package/dist/types/src/components/button/index.d.ts +8 -0
  323. package/dist/types/src/components/checkbox-group-field/index.d.ts +2 -0
  324. package/dist/types/src/components/code-editor/code-editor-input.d.ts +1 -0
  325. package/dist/types/src/components/code-editor/index.d.ts +4 -0
  326. package/dist/types/src/components/containers/index.d.ts +12 -0
  327. package/dist/types/src/components/date-field/index.d.ts +4 -0
  328. package/dist/types/src/components/display/index.d.ts +4 -0
  329. package/dist/types/src/components/field-entries.d.ts +103 -0
  330. package/dist/types/src/components/mobile/alert-block.d.ts +12 -0
  331. package/dist/types/src/components/mobile/button.d.ts +9 -0
  332. package/dist/types/src/components/mobile/checkbox-group.d.ts +11 -0
  333. package/dist/types/src/components/mobile/date-adapters.d.ts +28 -0
  334. package/dist/types/src/components/mobile/date.d.ts +10 -0
  335. package/dist/types/src/components/mobile/daterange.d.ts +11 -0
  336. package/dist/types/src/components/mobile/datetime.d.ts +10 -0
  337. package/dist/types/src/components/mobile/definitions.d.ts +9 -0
  338. package/dist/types/src/components/mobile/divider.d.ts +10 -0
  339. package/dist/types/src/components/mobile/input-cell.d.ts +30 -0
  340. package/dist/types/src/components/mobile/number.d.ts +25 -0
  341. package/dist/types/src/components/mobile/option-group.d.ts +17 -0
  342. package/dist/types/src/components/mobile/paragraph.d.ts +10 -0
  343. package/dist/types/src/components/mobile/picker-trigger.d.ts +31 -0
  344. package/dist/types/src/components/mobile/radio.d.ts +12 -0
  345. package/dist/types/src/components/mobile/scope.d.ts +42 -0
  346. package/dist/types/src/components/mobile/select.d.ts +12 -0
  347. package/dist/types/src/components/mobile/switch.d.ts +14 -0
  348. package/dist/types/src/components/mobile/textarea.d.ts +3 -0
  349. package/dist/types/src/components/mobile/textfield.d.ts +11 -0
  350. package/dist/types/src/components/mobile/theme.d.ts +16 -0
  351. package/dist/types/src/components/number-field/index.d.ts +2 -0
  352. package/dist/types/src/components/radio-field/index.d.ts +2 -0
  353. package/dist/types/src/components/select-field/index.d.ts +2 -0
  354. package/dist/types/src/components/switch-field/index.d.ts +2 -0
  355. package/dist/types/src/components/textarea-field/index.d.ts +2 -0
  356. package/dist/types/src/components/textfield/index.d.ts +11 -0
  357. package/dist/types/src/editor/canvas/canvas-field.d.ts +24 -0
  358. package/dist/types/src/editor/canvas/canvas.d.ts +11 -0
  359. package/dist/types/src/editor/canvas/drop-indicator.d.ts +14 -0
  360. package/dist/types/src/editor/canvas/drop-zones.d.ts +48 -0
  361. package/dist/types/src/editor/canvas/json-split-view.d.ts +15 -0
  362. package/dist/types/src/editor/canvas/mobile-seed-state.d.ts +9 -0
  363. package/dist/types/src/editor/canvas/phone-frame.d.ts +15 -0
  364. package/dist/types/src/editor/dnd.d.ts +88 -0
  365. package/dist/types/src/editor/editor-layout-context.d.ts +53 -0
  366. package/dist/types/src/editor/footer/footer.d.ts +7 -0
  367. package/dist/types/src/editor/form-config/form-basics-tab.d.ts +34 -0
  368. package/dist/types/src/editor/form-config/form-config-drawer.d.ts +8 -0
  369. package/dist/types/src/editor/form-config/outline-tab.d.ts +2 -0
  370. package/dist/types/src/editor/form-editor.d.ts +142 -0
  371. package/dist/types/src/editor/palette/field-groups.d.ts +12 -0
  372. package/dist/types/src/editor/palette/palette-group.d.ts +31 -0
  373. package/dist/types/src/editor/palette/palette-item.d.ts +34 -0
  374. package/dist/types/src/editor/palette/palette-panel.d.ts +17 -0
  375. package/dist/types/src/editor/preview-effects.d.ts +14 -0
  376. package/dist/types/src/editor/preview-runtime-context.d.ts +23 -0
  377. package/dist/types/src/editor/properties/block-layout-section.d.ts +19 -0
  378. package/dist/types/src/editor/properties/container-properties.d.ts +19 -0
  379. package/dist/types/src/editor/properties/entries/built-ins.d.ts +19 -0
  380. package/dist/types/src/editor/properties/entries/checkbox-entry.d.ts +3 -0
  381. package/dist/types/src/editor/properties/entries/coerce.d.ts +6 -0
  382. package/dist/types/src/editor/properties/entries/entry-field.d.ts +29 -0
  383. package/dist/types/src/editor/properties/entries/icon-entry.d.ts +8 -0
  384. package/dist/types/src/editor/properties/entries/index.d.ts +8 -0
  385. package/dist/types/src/editor/properties/entries/key-entry.d.ts +14 -0
  386. package/dist/types/src/editor/properties/entries/linkage/action-editor.d.ts +42 -0
  387. package/dist/types/src/editor/properties/entries/linkage/actions-editor.d.ts +43 -0
  388. package/dist/types/src/editor/properties/entries/linkage/condition-editor.d.ts +28 -0
  389. package/dist/types/src/editor/properties/entries/linkage/container-linkage-section.d.ts +14 -0
  390. package/dist/types/src/editor/properties/entries/linkage/expression-assist.d.ts +33 -0
  391. package/dist/types/src/editor/properties/entries/linkage/index.d.ts +1 -0
  392. package/dist/types/src/editor/properties/entries/linkage/linkage-rules-entry.d.ts +17 -0
  393. package/dist/types/src/editor/properties/entries/linkage/mutators.d.ts +73 -0
  394. package/dist/types/src/editor/properties/entries/linkage/options.d.ts +72 -0
  395. package/dist/types/src/editor/properties/entries/linkage/rule-diagnostics.d.ts +20 -0
  396. package/dist/types/src/editor/properties/entries/linkage/rule-list-editor.d.ts +75 -0
  397. package/dist/types/src/editor/properties/entries/linkage/styles.d.ts +46 -0
  398. package/dist/types/src/editor/properties/entries/linkage/trigger-editor.d.ts +35 -0
  399. package/dist/types/src/editor/properties/entries/linkage/use-linkage-editor-model.d.ts +46 -0
  400. package/dist/types/src/editor/properties/entries/linkage/use-stable-options.d.ts +17 -0
  401. package/dist/types/src/editor/properties/entries/number-entry.d.ts +3 -0
  402. package/dist/types/src/editor/properties/entries/options-source/index.d.ts +9 -0
  403. package/dist/types/src/editor/properties/entries/options-source/source-mutators.d.ts +14 -0
  404. package/dist/types/src/editor/properties/entries/select-entry.d.ts +3 -0
  405. package/dist/types/src/editor/properties/entries/text-entry.d.ts +3 -0
  406. package/dist/types/src/editor/properties/form-data-sources-panel.d.ts +16 -0
  407. package/dist/types/src/editor/properties/form-linkage-panel.d.ts +13 -0
  408. package/dist/types/src/editor/properties/form-variables-panel.d.ts +17 -0
  409. package/dist/types/src/editor/properties/option-editors.d.ts +33 -0
  410. package/dist/types/src/editor/properties/panel-header.d.ts +21 -0
  411. package/dist/types/src/editor/properties/properties-empty.d.ts +13 -0
  412. package/dist/types/src/editor/properties/properties-header.d.ts +13 -0
  413. package/dist/types/src/editor/properties/properties-panel.d.ts +18 -0
  414. package/dist/types/src/editor/properties/properties-provider.d.ts +42 -0
  415. package/dist/types/src/editor/properties/properties-tabs.d.ts +24 -0
  416. package/dist/types/src/editor/properties/use-confirmable-kind-switch.d.ts +38 -0
  417. package/dist/types/src/editor/remove-node-confirm.d.ts +8 -0
  418. package/dist/types/src/editor/schema-apply.d.ts +25 -0
  419. package/dist/types/src/editor/styles.d.ts +37 -0
  420. package/dist/types/src/editor/toolbar/notify.d.ts +13 -0
  421. package/dist/types/src/editor/toolbar/schema-io.d.ts +12 -0
  422. package/dist/types/src/editor/toolbar/toolbar.d.ts +42 -0
  423. package/dist/types/src/editor/use-editor-shortcuts.d.ts +23 -0
  424. package/dist/types/src/editor/validation-summary.d.ts +19 -0
  425. package/dist/types/src/engine/assert-never.d.ts +18 -0
  426. package/dist/types/src/engine/conversion/index.d.ts +87 -0
  427. package/dist/types/src/engine/ids.d.ts +14 -0
  428. package/dist/types/src/engine/keys.d.ts +70 -0
  429. package/dist/types/src/engine/linkage/cycle.d.ts +28 -0
  430. package/dist/types/src/engine/linkage/default-evaluator.d.ts +10 -0
  431. package/dist/types/src/engine/linkage/effects.d.ts +76 -0
  432. package/dist/types/src/engine/linkage/evaluator.d.ts +72 -0
  433. package/dist/types/src/engine/linkage/index.d.ts +8 -0
  434. package/dist/types/src/engine/linkage/operators.d.ts +23 -0
  435. package/dist/types/src/engine/linkage/source-tracking.d.ts +25 -0
  436. package/dist/types/src/engine/linkage/taxonomy.d.ts +49 -0
  437. package/dist/types/src/engine/linkage/validator.d.ts +23 -0
  438. package/dist/types/src/engine/registry/defaults-mobile.d.ts +17 -0
  439. package/dist/types/src/engine/registry/defaults.d.ts +22 -0
  440. package/dist/types/src/engine/registry/form-field-registry.d.ts +79 -0
  441. package/dist/types/src/engine/schema/edit-ops.d.ts +101 -0
  442. package/dist/types/src/engine/schema/mutate.d.ts +41 -0
  443. package/dist/types/src/engine/schema/nodes.d.ts +34 -0
  444. package/dist/types/src/engine/schema/permission-bridge.d.ts +37 -0
  445. package/dist/types/src/engine/schema/presentation.d.ts +30 -0
  446. package/dist/types/src/engine/schema/reconcile.d.ts +80 -0
  447. package/dist/types/src/engine/schema/removal-impact.d.ts +39 -0
  448. package/dist/types/src/engine/schema/rewrite.d.ts +15 -0
  449. package/dist/types/src/engine/schema/validate.d.ts +36 -0
  450. package/dist/types/src/engine/schema/walk.d.ts +90 -0
  451. package/dist/types/src/engine/validation.d.ts +139 -0
  452. package/dist/types/src/icons.d.ts +8 -0
  453. package/dist/types/src/index.d.ts +39 -0
  454. package/dist/types/src/render/chrome/mobile-chrome.d.ts +9 -0
  455. package/dist/types/src/render/chrome/pc-chrome.d.ts +7 -0
  456. package/dist/types/src/render/chrome/subform-shell.d.ts +17 -0
  457. package/dist/types/src/render/data-source-context.d.ts +42 -0
  458. package/dist/types/src/render/flex-style.d.ts +26 -0
  459. package/dist/types/src/render/form-field.d.ts +32 -0
  460. package/dist/types/src/render/form-renderer.d.ts +65 -0
  461. package/dist/types/src/render/grid-style.d.ts +24 -0
  462. package/dist/types/src/render/parts/field-shell.d.ts +33 -0
  463. package/dist/types/src/render/parts/label.d.ts +20 -0
  464. package/dist/types/src/render/parts/options-status.d.ts +14 -0
  465. package/dist/types/src/render/stack-style.d.ts +19 -0
  466. package/dist/types/src/render/subform-columns.d.ts +16 -0
  467. package/dist/types/src/render/submit.d.ts +91 -0
  468. package/dist/types/src/runtime/effects.d.ts +77 -0
  469. package/dist/types/src/runtime/resolve-scope-values.d.ts +8 -0
  470. package/dist/types/src/runtime/runtime-context.d.ts +21 -0
  471. package/dist/types/src/runtime/runtime-state-controller.d.ts +33 -0
  472. package/dist/types/src/runtime/stabilize-state-map.d.ts +12 -0
  473. package/dist/types/src/runtime/types.d.ts +13 -0
  474. package/dist/types/src/store/engine-provider.d.ts +50 -0
  475. package/dist/types/src/store/form-store.d.ts +234 -0
  476. package/dist/types/src/types/chrome.d.ts +51 -0
  477. package/dist/types/src/types/component.d.ts +116 -0
  478. package/dist/types/src/types/data-source.d.ts +70 -0
  479. package/dist/types/src/types/index.d.ts +6 -0
  480. package/dist/types/src/types/linkage.d.ts +350 -0
  481. package/dist/types/src/types/properties.d.ts +122 -0
  482. package/dist/types/src/types/schema.d.ts +839 -0
  483. 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[];