@adaptabletools/adaptable 24.0.0-canary.8 → 24.0.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 (235) hide show
  1. package/agGrid.d.ts +2 -3
  2. package/agGrid.js +2 -3
  3. package/aql.d.ts +29 -1
  4. package/aql.js +49 -1
  5. package/devtools.d.ts +55 -1
  6. package/index.css +0 -19
  7. package/index.d.ts +2 -3
  8. package/index.js +2 -3
  9. package/package.json +1 -1
  10. package/src/AdaptableOptions/ActionColumnOptions.d.ts +24 -0
  11. package/src/AdaptableOptions/AdaptableOptions.d.ts +97 -69
  12. package/src/AdaptableOptions/AdaptablePlugin.d.ts +113 -1
  13. package/src/AdaptableOptions/AlertOptions.d.ts +0 -2
  14. package/src/AdaptableOptions/ChartingOptions.d.ts +11 -5
  15. package/src/AdaptableOptions/ColumnMenuOptions.d.ts +30 -0
  16. package/src/AdaptableOptions/ColumnOptions.d.ts +0 -2
  17. package/src/AdaptableOptions/CommentOptions.d.ts +12 -4
  18. package/src/AdaptableOptions/ContextMenuOptions.d.ts +31 -1
  19. package/src/AdaptableOptions/DashboardOptions.d.ts +0 -3
  20. package/src/AdaptableOptions/DataChangeHistoryOptions.d.ts +3 -2
  21. package/src/AdaptableOptions/EditOptions.d.ts +18 -2
  22. package/src/AdaptableOptions/ExportOptions.d.ts +23 -0
  23. package/src/AdaptableOptions/ExpressionOptions.d.ts +0 -3
  24. package/src/AdaptableOptions/Fdc3Options.d.ts +77 -3
  25. package/src/AdaptableOptions/FilterOptions.d.ts +13 -8
  26. package/src/AdaptableOptions/LayoutOptions.d.ts +16 -3
  27. package/src/AdaptableOptions/NotificationsOptions.d.ts +0 -1
  28. package/src/AdaptableOptions/QuickSearchOptions.d.ts +0 -2
  29. package/src/AdaptableOptions/RowFormOptions.d.ts +9 -0
  30. package/src/AdaptableOptions/SettingsPanelOptions.d.ts +10 -1
  31. package/src/AdaptableOptions/ToolPanelOptions.d.ts +0 -1
  32. package/src/AdaptableOptions/UserInterfaceOptions.d.ts +6 -2
  33. package/src/AdaptableState/AdaptableState.d.ts +98 -4
  34. package/src/AdaptableState/AlertState.d.ts +20 -21
  35. package/src/AdaptableState/ApplicationState.d.ts +5 -3
  36. package/src/AdaptableState/BaseState.d.ts +9 -2
  37. package/src/AdaptableState/CalculatedColumnState.d.ts +10 -8
  38. package/src/AdaptableState/ChartingState.d.ts +10 -5
  39. package/src/AdaptableState/CommentState.d.ts +10 -4
  40. package/src/AdaptableState/Common/AdaptableAlert.d.ts +6 -2
  41. package/src/AdaptableState/Common/AdaptableButton.d.ts +3 -1
  42. package/src/AdaptableState/Common/AdaptableColumn.d.ts +38 -1
  43. package/src/AdaptableState/Common/AdaptableFilterState.d.ts +3 -1
  44. package/src/AdaptableState/Common/AdaptableFlashingCell.d.ts +3 -1
  45. package/src/AdaptableState/Common/AdaptableForm.d.ts +9 -0
  46. package/src/AdaptableState/Common/AdaptableFormat.d.ts +27 -1
  47. package/src/AdaptableState/Common/AdaptableIcon.d.ts +4 -2
  48. package/src/AdaptableState/Common/AdaptableObject.d.ts +9 -1
  49. package/src/AdaptableState/Common/AdaptableQuery.d.ts +9 -0
  50. package/src/AdaptableState/Common/AdaptableStyle.d.ts +6 -8
  51. package/src/AdaptableState/Common/AggregationColumns.d.ts +15 -6
  52. package/src/AdaptableState/Common/ButtonStyle.d.ts +3 -1
  53. package/src/AdaptableState/Common/CellDataChangedInfo.d.ts +6 -2
  54. package/src/AdaptableState/Common/CellHighlightInfo.d.ts +4 -2
  55. package/src/AdaptableState/Common/CellSummary.d.ts +33 -0
  56. package/src/AdaptableState/Common/ColumnFilter.d.ts +3 -1
  57. package/src/AdaptableState/Common/ColumnHighlightInfo.d.ts +4 -2
  58. package/src/AdaptableState/Common/ColumnScope.d.ts +32 -1
  59. package/src/AdaptableState/Common/ColumnSetupInfo.d.ts +17 -0
  60. package/src/AdaptableState/Common/ColumnSort.d.ts +3 -1
  61. package/src/AdaptableState/Common/CompactCalculatedColumnEditorInfo.d.ts +3 -0
  62. package/src/AdaptableState/Common/DataChangedScope.d.ts +3 -1
  63. package/src/AdaptableState/Common/DataUpdateConfig.d.ts +3 -1
  64. package/src/AdaptableState/Common/Entitlement.d.ts +4 -2
  65. package/src/AdaptableState/Common/Enums.d.ts +21 -0
  66. package/src/AdaptableState/Common/ExtendedLayout.d.ts +3 -1
  67. package/src/AdaptableState/Common/Fdc3Context.d.ts +9 -0
  68. package/src/AdaptableState/Common/Fdc3Intent.d.ts +6 -0
  69. package/src/AdaptableState/Common/GridFilter.d.ts +3 -1
  70. package/src/AdaptableState/Common/MenuItem.d.ts +9 -0
  71. package/src/AdaptableState/Common/RowHighlightInfo.d.ts +4 -2
  72. package/src/AdaptableState/Common/RowScope.d.ts +3 -1
  73. package/src/AdaptableState/Common/RowSummary.d.ts +14 -4
  74. package/src/AdaptableState/Common/RowsHighlightInfo.d.ts +5 -3
  75. package/src/AdaptableState/Common/Schedule.d.ts +10 -2
  76. package/src/AdaptableState/Common/SpecialColumnSettings.d.ts +3 -1
  77. package/src/AdaptableState/Common/SystemStatusMessageInfo.d.ts +4 -2
  78. package/src/AdaptableState/Common/TransposeConfig.d.ts +1 -1
  79. package/src/AdaptableState/Common/Types.d.ts +9 -0
  80. package/src/AdaptableState/CustomSortState.d.ts +8 -5
  81. package/src/AdaptableState/DashboardState.d.ts +14 -10
  82. package/src/AdaptableState/ExportState.d.ts +12 -4
  83. package/src/AdaptableState/FlashingCellState.d.ts +8 -5
  84. package/src/AdaptableState/FormatColumnState.d.ts +28 -8
  85. package/src/AdaptableState/FreeTextColumnState.d.ts +14 -8
  86. package/src/AdaptableState/IPushPullState.d.ts +39 -3
  87. package/src/AdaptableState/InitialState.d.ts +9 -9
  88. package/src/AdaptableState/InternalState.d.ts +183 -3
  89. package/src/AdaptableState/LayoutState.d.ts +64 -21
  90. package/src/AdaptableState/NamedQueryState.d.ts +16 -4
  91. package/src/AdaptableState/NoteState.d.ts +7 -3
  92. package/src/AdaptableState/OpenFinState.d.ts +12 -2
  93. package/src/AdaptableState/PlusMinusState.d.ts +8 -4
  94. package/src/AdaptableState/PopupState.d.ts +29 -1
  95. package/src/AdaptableState/QuickSearchState.d.ts +5 -3
  96. package/src/AdaptableState/Selection/GridCell.d.ts +5 -3
  97. package/src/AdaptableState/Selection/GridCellRange.d.ts +8 -7
  98. package/src/AdaptableState/Selection/SelectedCellInfo.d.ts +1 -1
  99. package/src/AdaptableState/ShortcutState.d.ts +7 -3
  100. package/src/AdaptableState/StatusBarState.d.ts +7 -6
  101. package/src/AdaptableState/StyledColumnState.d.ts +46 -14
  102. package/src/AdaptableState/TeamSharingState.d.ts +46 -2
  103. package/src/AdaptableState/ThemeState.d.ts +24 -2
  104. package/src/AdaptableState/ToolPanelState.d.ts +10 -5
  105. package/src/AdaptableState/UserInterfaceState.d.ts +2 -2
  106. package/src/AdaptableState/Uuid.d.ts +6 -0
  107. package/src/Api/ActionColumnApi.d.ts +3 -1
  108. package/src/Api/AdaptableApi.d.ts +54 -50
  109. package/src/Api/AlertApi.d.ts +20 -12
  110. package/src/Api/ApplicationApi.d.ts +6 -2
  111. package/src/Api/BulkUpdateApi.d.ts +2 -1
  112. package/src/Api/CalculatedColumnApi.d.ts +4 -1
  113. package/src/Api/CalendarApi.d.ts +10 -0
  114. package/src/Api/CellSummaryApi.d.ts +9 -3
  115. package/src/Api/ChartingApi.d.ts +22 -7
  116. package/src/Api/ColumnApi.d.ts +71 -4
  117. package/src/Api/ColumnFilterApi.d.ts +13 -3
  118. package/src/Api/ColumnMenuApi.d.ts +13 -2
  119. package/src/Api/ColumnScopeApi.d.ts +27 -1
  120. package/src/Api/CommentApi.d.ts +10 -7
  121. package/src/Api/ContextMenuApi.d.ts +11 -1
  122. package/src/Api/CustomSortApi.d.ts +6 -2
  123. package/src/Api/DashboardApi.d.ts +30 -9
  124. package/src/Api/DataChangeHistoryApi.d.ts +9 -3
  125. package/src/Api/DataImportApi.d.ts +1 -1
  126. package/src/Api/EntitlementApi.d.ts +6 -1
  127. package/src/Api/EventApi.d.ts +67 -19
  128. package/src/Api/Events/AdaptableReady.d.ts +6 -2
  129. package/src/Api/Events/AdaptableStateChanged.d.ts +9 -5
  130. package/src/Api/Events/AdaptableStateReloaded.d.ts +7 -3
  131. package/src/Api/Events/AlertFired.d.ts +8 -2
  132. package/src/Api/Events/BeforeAdaptableStateChange.d.ts +6 -2
  133. package/src/Api/Events/CalculatedColumnChanged.d.ts +7 -3
  134. package/src/Api/Events/CellChanged.d.ts +6 -2
  135. package/src/Api/Events/CellSelectionChanged.d.ts +6 -2
  136. package/src/Api/Events/ChartChanged.d.ts +16 -8
  137. package/src/Api/Events/CommentChanged.d.ts +8 -2
  138. package/src/Api/Events/CustomToolbarConfigured.d.ts +6 -2
  139. package/src/Api/Events/DashboardChanged.d.ts +27 -6
  140. package/src/Api/Events/DataImported.d.ts +8 -4
  141. package/src/Api/Events/DataSetSelected.d.ts +6 -2
  142. package/src/Api/Events/Fdc3MessageInfo.d.ts +14 -4
  143. package/src/Api/Events/FlashingCellDisplayed.d.ts +6 -2
  144. package/src/Api/Events/GridFilterApplied.d.ts +11 -3
  145. package/src/Api/Events/GridSorted.d.ts +6 -2
  146. package/src/Api/Events/LayoutChanged.d.ts +36 -5
  147. package/src/Api/Events/LiveDataChanged.d.ts +21 -5
  148. package/src/Api/Events/NoteChanged.d.ts +5 -1
  149. package/src/Api/Events/ReportScheduleRan.d.ts +7 -3
  150. package/src/Api/Events/RowChanged.d.ts +6 -2
  151. package/src/Api/Events/RowFormSubmitted.d.ts +28 -12
  152. package/src/Api/Events/RowSelectionChanged.d.ts +6 -2
  153. package/src/Api/Events/SystemStatusMessageDisplayed.d.ts +6 -2
  154. package/src/Api/Events/TeamSharingEntityChanged.d.ts +6 -2
  155. package/src/Api/Events/ThemeSelected.d.ts +6 -2
  156. package/src/Api/ExportApi.d.ts +59 -32
  157. package/src/Api/ExpressionApi.d.ts +24 -1
  158. package/src/Api/Fdc3Api.d.ts +16 -3
  159. package/src/Api/FlashingCellApi.d.ts +6 -1
  160. package/src/Api/FormatColumnApi.d.ts +18 -11
  161. package/src/Api/FreeTextColumnApi.d.ts +4 -2
  162. package/src/Api/GridApi.d.ts +92 -19
  163. package/src/Api/IPushPullApi.d.ts +19 -2
  164. package/src/Api/Internal/EventInternalApi.d.ts +2 -1
  165. package/src/Api/Internal/EventInternalApi.js +7 -0
  166. package/src/Api/InteropioPluginApi.d.ts +2 -1
  167. package/src/Api/LayoutApi.d.ts +29 -15
  168. package/src/Api/NamedQueryApi.d.ts +10 -6
  169. package/src/Api/NoteApi.d.ts +15 -11
  170. package/src/Api/OpenFinApi.d.ts +8 -2
  171. package/src/Api/OptionsApi.d.ts +43 -1
  172. package/src/Api/PluginsApi.d.ts +6 -1
  173. package/src/Api/PlusMinusApi.d.ts +2 -1
  174. package/src/Api/QuickSearchApi.d.ts +6 -1
  175. package/src/Api/RowFormApi.d.ts +8 -7
  176. package/src/Api/ShortcutApi.d.ts +3 -1
  177. package/src/Api/SmartEditApi.d.ts +4 -1
  178. package/src/Api/StateApi.d.ts +30 -2
  179. package/src/Api/StatusBarApi.d.ts +2 -0
  180. package/src/Api/StyledColumnApi.d.ts +23 -12
  181. package/src/Api/SystemStatusApi.d.ts +18 -6
  182. package/src/Api/TeamSharingApi.d.ts +8 -1
  183. package/src/Api/ThemeApi.d.ts +18 -9
  184. package/src/Api/ToolPanelApi.d.ts +12 -7
  185. package/src/Api/UserInterfaceApi.d.ts +10 -1
  186. package/src/Redux/Store/AdaptableStore.js +1 -1
  187. package/src/agGrid/Adaptable.d.ts +0 -12
  188. package/src/agGrid/Adaptable.js +0 -52
  189. package/src/agGrid/AdaptableFrameworkComponent.d.ts +12 -0
  190. package/src/agGrid/AdaptableLogger.d.ts +74 -1
  191. package/src/agGrid/editors/AdaptableDateEditor/index.d.ts +3 -0
  192. package/src/agGrid/editors/AdaptableNumberEditor/index.d.ts +3 -0
  193. package/src/agGrid/index.d.ts +1 -6
  194. package/src/agGrid/index.js +1 -3
  195. package/src/aql/ExpressionEvaluation.d.ts +27 -0
  196. package/src/aql/types.d.ts +22 -0
  197. package/src/env.js +2 -2
  198. package/src/migration/legacyAdaptableQuery.d.ts +29 -4
  199. package/src/setupDevTools.js +223 -0
  200. package/src/types.d.ts +0 -2
  201. package/tsconfig.esm.tsbuildinfo +1 -1
  202. package/src/AdaptableInterfaces/AdaptableNoCodeWizard.d.ts +0 -99
  203. package/src/AdaptableInterfaces/AdaptableNoCodeWizard.js +0 -1
  204. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/AdaptableConfig.d.ts +0 -15
  205. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/AdaptableConfig.js +0 -1
  206. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/ColumnsList.d.ts +0 -19
  207. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/ColumnsList.js +0 -337
  208. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/Components/FormBox.d.ts +0 -5
  209. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/Components/FormBox.js +0 -4
  210. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/ConfigurationWizard.d.ts +0 -30
  211. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/ConfigurationWizard.js +0 -162
  212. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/ConfigurationWizardColumnsStep.d.ts +0 -18
  213. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/ConfigurationWizardColumnsStep.js +0 -12
  214. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/EntitlementsForm.d.ts +0 -8
  215. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/EntitlementsForm.js +0 -131
  216. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/GridOptionsForm.d.ts +0 -8
  217. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/GridOptionsForm.js +0 -30
  218. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/UIOptions/UIOptionsSidebarForm.d.ts +0 -6
  219. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/UIOptions/UIOptionsSidebarForm.js +0 -80
  220. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/UIOptions/UIOptionsStatusbarForm.d.ts +0 -6
  221. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/UIOptions/UIOptionsStatusbarForm.js +0 -100
  222. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/UIOptions/UiOptionsForm.d.ts +0 -11
  223. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/UIOptions/UiOptionsForm.js +0 -8
  224. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/index.d.ts +0 -2
  225. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/index.js +0 -2
  226. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/useSelection.d.ts +0 -21
  227. package/src/View/AdaptableWizardView/AdaptableConfigurationDialog/useSelection.js +0 -63
  228. package/src/View/AdaptableWizardView/Utilities/Utils.d.ts +0 -1
  229. package/src/View/AdaptableWizardView/Utilities/Utils.js +0 -21
  230. package/src/View/AdaptableWizardView/Utilities/helper.d.ts +0 -19
  231. package/src/View/AdaptableWizardView/Utilities/helper.js +0 -81
  232. package/src/View/AdaptableWizardView/Wizard.d.ts +0 -57
  233. package/src/View/AdaptableWizardView/Wizard.js +0 -98
  234. package/src/View/AdaptableWizardView/index.d.ts +0 -4
  235. package/src/View/AdaptableWizardView/index.js +0 -4
@@ -40,10 +40,25 @@ export type CustomContextMenuItem = AgGridMenuItem<AgGridContextMenuItemType> |
40
40
  * Defines a Grouped Menu Item in the Context Menu
41
41
  */
42
42
  export type CustomGroupContextMenuItem = {
43
+ /**
44
+ * Always `Group`. The item is a submenu, not a clickable command.
45
+ */
43
46
  menuType: 'Group';
47
+ /**
48
+ * Text of the submenu.
49
+ */
44
50
  label: string;
51
+ /**
52
+ * Items shown when the submenu opens.
53
+ */
45
54
  subMenuItems: CustomContextMenuItem[];
55
+ /**
56
+ * When `true`, the submenu cannot be opened.
57
+ */
46
58
  disabled?: boolean;
59
+ /**
60
+ * Icon drawn next to the submenu label.
61
+ */
47
62
  icon?: AdaptableIcon;
48
63
  };
49
64
  /**
@@ -126,12 +141,27 @@ export type AgGridContextMenuItemType = 'autoSizeAll' | 'expandAll' | 'contractA
126
141
  */
127
142
  export type DefaultAdaptableMenuStructure = (AdaptableSystemContextMenuItem<AdaptableContextMenuItemName> | MenuSeparator)[];
128
143
  /**
129
- * AG Grid section of Context Menu provided by AadapTable by default
144
+ * AG Grid section of the Context Menu that AdapTable provides by default.
130
145
  */
131
146
  export type DefaultAgGridMenuStructure = (AgGridMenuItem<AgGridContextMenuItemType> | {
147
+ /**
148
+ * Always `Group`. The item is a submenu of AG Grid context-menu entries.
149
+ */
132
150
  menuType: 'Group';
151
+ /**
152
+ * Text of the submenu.
153
+ */
133
154
  label: string;
155
+ /**
156
+ * AG Grid context-menu entries shown when the submenu opens.
157
+ */
134
158
  subMenuItems: AgGridMenuItem<AgGridContextMenuItemType>[];
159
+ /**
160
+ * When `true`, the submenu cannot be opened.
161
+ */
135
162
  disabled?: boolean;
163
+ /**
164
+ * Icon drawn next to the submenu label.
165
+ */
136
166
  icon?: AdaptableIcon;
137
167
  })[];
@@ -11,14 +11,12 @@ export interface DashboardOptions {
11
11
  * Whether the Dashboard can be floated; if true (the default), double-clicking Dashboard puts it in float mode
12
12
  *
13
13
  * @defaultValue true
14
- * @noCodeItem
15
14
  */
16
15
  canFloat?: boolean;
17
16
  /**
18
17
  * Shows Quick Search input in Dashboard Header
19
18
  *
20
19
  * @defaultValue true
21
- * @noCodeItem
22
20
  */
23
21
  showQuickSearchInHeader?: boolean;
24
22
  /**
@@ -32,7 +30,6 @@ export interface DashboardOptions {
32
30
  /**
33
31
  * Where in Dashboard to display Module and Custom Buttons
34
32
  * @defaultValue 'right'
35
- * @noCodeItem
36
33
  */
37
34
  buttonsLocation?: DashboardButtonsLocation;
38
35
  }
@@ -8,7 +8,6 @@ export interface DataChangeHistoryOptions<TData = any> {
8
8
  * Make Data Change History active by default
9
9
  *
10
10
  * @defaultValue false
11
- * @noCodeItem
12
11
  */
13
12
  activeByDefault?: boolean;
14
13
  /**
@@ -32,7 +31,6 @@ export interface DataChangeHistoryOptions<TData = any> {
32
31
  * How many data changes are held in State at any one time; when limit is reached, oldest change(s) are deleted from memory
33
32
  *
34
33
  * @defaultValue undefined (all data changes are logged)
35
- * @noCodeItem
36
34
  */
37
35
  maxDataChangesInStore?: number;
38
36
  }
@@ -69,5 +67,8 @@ export interface DataChangeHistoryContext<TData = any> extends ActionColumnConte
69
67
  * A custom AdaptableButton which provides a build in `undo` action
70
68
  */
71
69
  export interface DataChangeHistoryButton<TData = any> extends AdaptableButton<DataChangeHistoryContext<TData>> {
70
+ /**
71
+ * Built-in action the button runs. `'undo'` restores the previous value. `'clear'` removes the change from the log.
72
+ */
72
73
  action?: AdaptableDataChangeHistoryAction;
73
74
  }
@@ -29,11 +29,15 @@ export interface EditOptions<TData = any> {
29
29
  */
30
30
  customEditColumnValues?: (context: CustomEditColumnValuesContext<TData>) => CustomEditColumnValueInfo[] | Promise<CustomEditColumnValueInfo[]>;
31
31
  /**
32
- * Options for Plus Minus module (keyboard increment / decrement)
32
+ * Keys that nudge a numeric cell up or down.
33
+ *
34
+ * A Plus Minus rule can set its own key. These are the keys used when it does not.
33
35
  */
34
36
  plusMinusOptions?: PlusMinusOptions;
35
37
  /**
36
- * Options for Smart Edit module
38
+ * Extra Smart Edit operations, beyond the ones AdapTable ships.
39
+ *
40
+ * A Smart Edit applies one operation to every selected cell.
37
41
  */
38
42
  smartEditOptions?: SmartEditOptions<TData>;
39
43
  }
@@ -58,14 +62,26 @@ export interface CustomEditColumnValuesContext<TData = any> extends AdaptableCol
58
62
  * Information about items in the Edit Controls
59
63
  */
60
64
  export interface EditColumnValueInfo {
65
+ /**
66
+ * Value written into the cell when this item is chosen.
67
+ */
61
68
  value: any;
69
+ /**
70
+ * Text shown for this item. The value is shown when this is omitted.
71
+ */
62
72
  label?: string;
63
73
  }
64
74
  /**
65
75
  * Information about items in the custom Edit Controls
66
76
  */
67
77
  export interface CustomEditColumnValueInfo {
78
+ /**
79
+ * Value written into the cell when this item is chosen.
80
+ */
68
81
  value: any;
82
+ /**
83
+ * Text shown for this item. The value is shown when this is omitted.
84
+ */
69
85
  label?: string;
70
86
  }
71
87
  /**
@@ -257,14 +257,37 @@ export interface ExportFormContext extends FormContext {
257
257
  /**
258
258
  * Type of Export result data: string (CSV), ReportData (JSON), or Blob (Excel)
259
259
  */
260
+ /**
261
+ * Data produced by an export, or returned from `processExport` to replace AdapTable's output.
262
+ *
263
+ * `type` selects the shape of `data`.
264
+ */
260
265
  export type ExportResultData = {
266
+ /**
267
+ * CSV export.
268
+ */
261
269
  type: 'csv';
270
+ /**
271
+ * CSV text.
272
+ */
262
273
  data: string;
263
274
  } | {
275
+ /**
276
+ * JSON export.
277
+ */
264
278
  type: 'json';
279
+ /**
280
+ * Columns and rows of the report.
281
+ */
265
282
  data: ReportData;
266
283
  } | {
284
+ /**
285
+ * Excel export.
286
+ */
267
287
  type: 'excel';
288
+ /**
289
+ * Excel file contents. A `Blob`, or a base64 string.
290
+ */
268
291
  data: Blob | string;
269
292
  };
270
293
  /**
@@ -166,14 +166,12 @@ export interface ExpressionOptions<TData = any> {
166
166
  * Reference a Column's Header (i.e. FriendlyName) in all Expression overviews (instead of ColumnId)
167
167
  *
168
168
  * @defaultValue true
169
- * @noCodeItem
170
169
  */
171
170
  displayColumnFriendlyNamesForExpressions?: boolean;
172
171
  /**
173
172
  * Perform case-sensitive text comparisons when evaluating Expressions
174
173
  *
175
174
  * @defaultValue false
176
- * @noCodeItem
177
175
  */
178
176
  caseSensitiveExpressions?: boolean;
179
177
  /**
@@ -186,7 +184,6 @@ export interface ExpressionOptions<TData = any> {
186
184
  * When an `IN` right-hand value is an ISO string containing `T`, the exact instant is used regardless.
187
185
  *
188
186
  * @defaultValue false
189
- * @noCodeItem
190
187
  */
191
188
  evaluateDatesUsingTime?: boolean | ((context: AdaptableColumnContext) => boolean);
192
189
  /**
@@ -181,77 +181,151 @@ export interface HandleFdc3IntentContext extends HandleFdc3Context {
181
181
  }
182
182
  export declare const ColumnRefTypePrefix = "_colId.";
183
183
  export declare const FieldRefTypePrefix = "_field.";
184
+ /**
185
+ * Points one FDC3 context field at a grid column or a row field.
186
+ *
187
+ * `` `_colId.${columnId}` `` reads the column. `` `_field.${fieldName}` `` reads a field that is not a column.
188
+ */
184
189
  export type GridDataRef = `_colId.${string}` | `_field.${string}`;
190
+ /**
191
+ * Maps each field of an FDC3 context (other than `type`) to a {@link GridDataRef}.
192
+ *
193
+ * AdapTable builds the context for a row by reading those columns and fields.
194
+ */
185
195
  export type Fdc3ContentMapping<T> = PropertiesToGridRefs<Omit<T, 'type'>>;
186
196
  /**
187
- * Mapping of FDC3 Context Types to Grid Data/Columns
197
+ * Which grid columns fill each standard FDC3 context, keyed by the context type.
198
+ *
199
+ * Set `custom` for a context type that is not one of the standard names.
188
200
  */
189
201
  export interface GridDataContextMapping {
202
+ /** Maps an `fdc3.action` context. Each field is a `_colId.` or `_field.` reference. */
190
203
  'fdc3.action'?: Fdc3ContentMapping<Action>;
204
+ /** Maps an `fdc3.chart` context. Each field is a `_colId.` or `_field.` reference. */
191
205
  'fdc3.chart'?: Fdc3ContentMapping<Chart>;
206
+ /** Maps an `fdc3.chat.initSettings` context. Each field is a `_colId.` or `_field.` reference. */
192
207
  'fdc3.chat.initSettings'?: Fdc3ContentMapping<ChatInitSettings>;
208
+ /** Maps an `fdc3.chat.message` context. Each field is a `_colId.` or `_field.` reference. */
193
209
  'fdc3.chat.message'?: Fdc3ContentMapping<ChatMessage>;
210
+ /** Maps an `fdc3.chat.room` context. Each field is a `_colId.` or `_field.` reference. */
194
211
  'fdc3.chat.room'?: Fdc3ContentMapping<ChatRoom>;
212
+ /** Maps an `fdc3.chat.searchCriteria` context. Each field is a `_colId.` or `_field.` reference. */
195
213
  'fdc3.chat.searchCriteria'?: Fdc3ContentMapping<ChatSearchCriteria>;
214
+ /** Maps an `fdc3.contact` context. Each field is a `_colId.` or `_field.` reference. */
196
215
  'fdc3.contact'?: Fdc3ContentMapping<Contact>;
216
+ /** Maps an `fdc3.contactList` context. Each field is a `_colId.` or `_field.` reference. */
197
217
  'fdc3.contactList'?: Fdc3ContentMapping<ContactList>;
218
+ /** Maps an `fdc3.country` context. Each field is a `_colId.` or `_field.` reference. */
198
219
  'fdc3.country'?: Fdc3ContentMapping<Country>;
220
+ /** Maps an `fdc3.currency` context. Each field is a `_colId.` or `_field.` reference. */
199
221
  'fdc3.currency'?: Fdc3ContentMapping<Currency>;
222
+ /** Maps an `fdc3.email` context. Each field is a `_colId.` or `_field.` reference. */
200
223
  'fdc3.email'?: Fdc3ContentMapping<Email>;
224
+ /** Maps an `fdc3.instrument` context. Each field is a `_colId.` or `_field.` reference. */
201
225
  'fdc3.instrument'?: Fdc3ContentMapping<Instrument>;
226
+ /** Maps an `fdc3.instrumentList` context. Each field is a `_colId.` or `_field.` reference. */
202
227
  'fdc3.instrumentList'?: Fdc3ContentMapping<InstrumentList>;
228
+ /** Maps an `fdc3.interaction` context. Each field is a `_colId.` or `_field.` reference. */
203
229
  'fdc3.interaction'?: Fdc3ContentMapping<Interaction>;
230
+ /** Maps an `fdc3.message` context. Each field is a `_colId.` or `_field.` reference. */
204
231
  'fdc3.message'?: Fdc3ContentMapping<Message>;
232
+ /** Maps an `fdc3.organization` context. Each field is a `_colId.` or `_field.` reference. */
205
233
  'fdc3.organization'?: Fdc3ContentMapping<Organization>;
234
+ /** Maps an `fdc3.portfolio` context. Each field is a `_colId.` or `_field.` reference. */
206
235
  'fdc3.portfolio'?: Fdc3ContentMapping<Portfolio>;
236
+ /** Maps an `fdc3.position` context. Each field is a `_colId.` or `_field.` reference. */
207
237
  'fdc3.position'?: Fdc3ContentMapping<Position>;
238
+ /** Maps an `fdc3.timerange` context. Each field is a `_colId.` or `_field.` reference. */
208
239
  'fdc3.timerange'?: Fdc3ContentMapping<TimeRange>;
240
+ /** Maps an `fdc3.transactionResult` context. Each field is a `_colId.` or `_field.` reference. */
209
241
  'fdc3.transactionResult'?: Fdc3ContentMapping<TransactionResult>;
242
+ /** Maps an `fdc3.valuation` context. Each field is a `_colId.` or `_field.` reference. */
210
243
  'fdc3.valuation'?: Fdc3ContentMapping<Valuation>;
244
+ /**
245
+ * Column mapping for a context type that is not one of the standard names. The key is the context type.
246
+ */
211
247
  custom?: {
212
248
  [key: string]: Fdc3ContentMapping<Context>;
213
249
  };
214
250
  }
215
251
  /**
216
- * Defines config options for Raising FDC3 Intents
252
+ * When each standard FDC3 intent is raised from the grid. The property name is the intent.
253
+ *
254
+ * Each value lists the grid actions that raise it (for example a cell click or a button). Use `custom` for an intent that is not a standard name.
217
255
  */
218
256
  export interface RaiseIntentConfiguration {
257
+ /** Grid actions that raise the standard `StartCall` intent. */
219
258
  StartCall?: RaiseIntentConfig[];
259
+ /** Grid actions that raise the standard `StartChat` intent. */
220
260
  StartChat?: RaiseIntentConfig[];
261
+ /** Grid actions that raise the standard `StartEmail` intent. */
221
262
  StartEmail?: RaiseIntentConfig[];
263
+ /** Grid actions that raise the standard `ViewAnalysis` intent. */
222
264
  ViewAnalysis?: RaiseIntentConfig[];
265
+ /** Grid actions that raise the standard `ViewChart` intent. */
223
266
  ViewChart?: RaiseIntentConfig[];
267
+ /** Grid actions that raise the standard `ViewContact` intent. */
224
268
  ViewContact?: RaiseIntentConfig[];
269
+ /** Grid actions that raise the standard `ViewHoldings` intent. */
225
270
  ViewHoldings?: RaiseIntentConfig[];
271
+ /** Grid actions that raise the standard `ViewInstrument` intent. */
226
272
  ViewInstrument?: RaiseIntentConfig[];
273
+ /** Grid actions that raise the standard `ViewInteractions` intent. */
227
274
  ViewInteractions?: RaiseIntentConfig[];
275
+ /** Grid actions that raise the standard `ViewNews` intent. */
228
276
  ViewNews?: RaiseIntentConfig[];
277
+ /** Grid actions that raise the standard `ViewOrders` intent. */
229
278
  ViewOrders?: RaiseIntentConfig[];
279
+ /** Grid actions that raise the standard `ViewProfile` intent. */
230
280
  ViewProfile?: RaiseIntentConfig[];
281
+ /** Grid actions that raise the standard `ViewQuote` intent. */
231
282
  ViewQuote?: RaiseIntentConfig[];
283
+ /** Grid actions that raise the standard `ViewResearch` intent. */
232
284
  ViewResearch?: RaiseIntentConfig[];
285
+ /**
286
+ * When to raise an intent that is not one of the standard names. The key is the intent name.
287
+ */
233
288
  custom?: {
234
289
  [customIntent: string]: RaiseIntentConfig[];
235
290
  };
236
291
  }
237
292
  /**
238
- * Defines config options for Broadcasting FDC3 Context
293
+ * When each standard FDC3 context is broadcast from the grid. The property name is the context type.
294
+ *
295
+ * Use `custom` for a context type that is not a standard name.
239
296
  */
240
297
  export interface BroadcastConfiguration {
298
+ /** When to broadcast an `fdc3.chart` context. */
241
299
  'fdc3.chart'?: BroadcastConfig;
300
+ /** When to broadcast an `fdc3.chat.initSettings` context. */
242
301
  'fdc3.chat.initSettings'?: BroadcastConfig;
302
+ /** When to broadcast an `fdc3.contact` context. */
243
303
  'fdc3.contact'?: BroadcastConfig;
304
+ /** When to broadcast an `fdc3.contactList` context. */
244
305
  'fdc3.contactList'?: BroadcastConfig;
306
+ /** When to broadcast an `fdc3.country` context. */
245
307
  'fdc3.country'?: BroadcastConfig;
308
+ /** When to broadcast an `fdc3.currency` context. */
246
309
  'fdc3.currency'?: BroadcastConfig;
310
+ /** When to broadcast an `fdc3.email` context. */
247
311
  'fdc3.email'?: BroadcastConfig;
312
+ /** When to broadcast an `fdc3.instrument` context. */
248
313
  'fdc3.instrument'?: BroadcastConfig;
314
+ /** When to broadcast an `fdc3.instrumentList` context. */
249
315
  'fdc3.instrumentList'?: BroadcastConfig;
316
+ /** When to broadcast an `fdc3.organization` context. */
250
317
  'fdc3.organization'?: BroadcastConfig;
318
+ /** When to broadcast an `fdc3.portfolio` context. */
251
319
  'fdc3.portfolio'?: BroadcastConfig;
320
+ /** When to broadcast an `fdc3.position` context. */
252
321
  'fdc3.position'?: BroadcastConfig;
322
+ /** When to broadcast an `fdc3.timerange` context. */
253
323
  'fdc3.timerange'?: BroadcastConfig;
324
+ /** When to broadcast an `fdc3.valuation` context. */
254
325
  'fdc3.valuation'?: BroadcastConfig;
326
+ /**
327
+ * When to broadcast a context type that is not one of the standard names. The key is the context type.
328
+ */
255
329
  custom?: {
256
330
  [customContext: string]: BroadcastConfig;
257
331
  };
@@ -3,18 +3,19 @@ import { AdaptableColumn } from '../AdaptableState/Common/AdaptableColumn';
3
3
  import { AdaptableColumnContext } from '../AdaptableState/Common/AdaptableColumnContext';
4
4
  import { IRowNode } from 'ag-grid-enterprise';
5
5
  /**
6
- * Options for managing Column & Grid Filters in AdapTable
6
+ * Column Filters (one column) and the Grid Filter (a query across columns).
7
+ *
8
+ * The filters a user creates are stored on the Layout. These options change how filtering works for the whole grid.
7
9
  */
8
10
  export interface FilterOptions<TData = any> {
9
11
  /**
10
- * Options for managing Column Filters
12
+ * The filter row under the column headers, and the operator offered first for each data type.
11
13
  */
12
14
  columnFilterOptions?: ColumnFilterOptions;
13
15
  /**
14
16
  * Clear Grid and Column Filters when AdapTable loads
15
17
  *
16
18
  * @defaultValue false
17
- * @noCodeItem
18
19
  */
19
20
  clearFiltersOnStartUp?: boolean;
20
21
  /**
@@ -38,7 +39,6 @@ export interface FilterOptions<TData = any> {
38
39
  isRowFilterable?: (context: IsRowFilterableContext) => boolean;
39
40
  /**
40
41
  * Show Date Picker (or Date Input) in Filter controls
41
- * @noCodeItem
42
42
  * @defaultValue true
43
43
  */
44
44
  showDatePicker?: boolean;
@@ -46,7 +46,6 @@ export interface FilterOptions<TData = any> {
46
46
  * Use Adaptable's Column & Grid Filters in preference to AG Grid's filtering
47
47
  *
48
48
  * @defaultValue true
49
- * @noCodeItem
50
49
  */
51
50
  useAdaptableFiltering?: boolean;
52
51
  }
@@ -58,14 +57,12 @@ export interface ColumnFilterOptions<TData = any> {
58
57
  * Make Column Header distinctive for filtered columns, helps users see currently filtered columns
59
58
  *
60
59
  * @defaultValue true
61
- * @noCodeItem
62
60
  */
63
61
  indicateFilteredColumns?: boolean;
64
62
  /**
65
63
  * Manually apply Column Filters; an Apply Filter button is displayed and Quick Filter is disabled
66
64
  *
67
65
  * @defaultValue false
68
- * @noCodeItem
69
66
  */
70
67
  manuallyApplyColumnFilter?: boolean | ((context: AdaptableColumnContext) => boolean);
71
68
  /**
@@ -110,7 +107,6 @@ export interface ColumnFilterOptions<TData = any> {
110
107
  /**
111
108
  * Display Quick Filter Bar between Column Header and Grid (provided its been setup)
112
109
  * @defaultValue true
113
- * @noCodeItem
114
110
  */
115
111
  showQuickFilter?: boolean;
116
112
  /**
@@ -201,7 +197,13 @@ export interface InFilterValue<ValueType = any> {
201
197
  * Tooltip for Item (if true, the label is used as tooltip)
202
198
  */
203
199
  tooltip?: boolean | string;
200
+ /**
201
+ * Depth of this item when the list is a tree. `0` is the root.
202
+ */
204
203
  level?: number;
204
+ /**
205
+ * Child items, used for a grouped or date tree. Selecting a parent selects its leaves.
206
+ */
205
207
  children?: InFilterValue<ValueType>[];
206
208
  }
207
209
  /**
@@ -286,6 +288,9 @@ export interface InFilterValueInfo extends InFilterValue {
286
288
  * Whether Item is currently visible in Grid (i.e. in filtered rows)
287
289
  */
288
290
  visible?: boolean;
291
+ /**
292
+ * Child items, with the same counts and selection state as this item.
293
+ */
289
294
  children?: InFilterValueInfo[];
290
295
  /**
291
296
  * For the grouping scenario, how many leafs are there under this item
@@ -18,7 +18,11 @@ export interface LayoutOptions<TData = any> {
18
18
  */
19
19
  enableLayoutExtensionsUI?: boolean;
20
20
  /**
21
- * @deprecated Layouts now extended through `Layout.LayoutExtensions` in Adaptable State
21
+ * Tag-based layout extensions. Do not set this.
22
+ *
23
+ * Extend an object into a Layout with `Layout.LayoutExtensions` in Adaptable State.
24
+ *
25
+ * @deprecated Layouts are extended through `Layout.LayoutExtensions` in Adaptable State
22
26
  */
23
27
  layoutTagOptions?: LayoutTagOptions;
24
28
  /**
@@ -138,9 +142,16 @@ export interface LayoutRowSelectionContext<TData = any> extends AdaptableColumnC
138
142
  /**
139
143
  * @deprecated since v24 Layouts are extended through `Layout.LayoutExtensions`; will be removed in v25
140
144
  */
145
+ /**
146
+ * Unused. Extend objects into a Layout with `Layout.LayoutExtensions`.
147
+ *
148
+ * @deprecated Layouts are extended through `Layout.LayoutExtensions` in Adaptable State
149
+ */
141
150
  export interface LayoutTagOptions {
142
151
  /**
143
- * @deprecated no longer generates Tags (v24)
152
+ * Not called. Extend objects with `Layout.LayoutExtensions`.
153
+ *
154
+ * @deprecated no longer generates Tags
144
155
  */
145
156
  autoGenerateTagsForLayouts?: boolean | ((context: any) => AdaptableObjectTag[]);
146
157
  /**
@@ -150,7 +161,9 @@ export interface LayoutTagOptions {
150
161
  */
151
162
  autoCheckTagsForLayouts?: boolean;
152
163
  /**
153
- * @deprecated no longer called (v24) - define extensions in `Layout.LayoutExtensions` instead
164
+ * Not called. Extend objects with `Layout.LayoutExtensions`.
165
+ *
166
+ * @deprecated no longer called. Define extensions in `Layout.LayoutExtensions` instead
154
167
  */
155
168
  isObjectExtendedInLayout?: (context: any) => boolean;
156
169
  }
@@ -6,7 +6,6 @@ export interface NotificationsOptions {
6
6
  * How many Notifications can be displayed at one time
7
7
  *
8
8
  * @defaultValue 3
9
- * @noCodeItem
10
9
  */
11
10
  maxNotifications?: number;
12
11
  /**
@@ -29,14 +29,12 @@ export interface QuickSearchOptions<TData = any> {
29
29
  * Filters Grid after quick search so only matching rows are displayed
30
30
  *
31
31
  * @defaultValue false
32
- * @noCodeItem
33
32
  */
34
33
  filterGridAfterQuickSearch?: boolean;
35
34
  /**
36
35
  * Run Quick Search using Case Sensitivity
37
36
  *
38
37
  * @defaultValue false
39
- * @noCodeItem
40
38
  */
41
39
  isQuickSearchCaseSensitive?: boolean;
42
40
  }
@@ -129,13 +129,22 @@ export interface EditRowFormContext<TData = any> extends FormContext {
129
129
  * Context used for overriding Title and Description of Row Form
130
130
  */
131
131
  export interface RowFormTitleContext<TData = any> extends BaseContext {
132
+ /**
133
+ * Which form is open. `'rowCreated'` is create or clone. `'rowEdited'` is edit. Delete does not use this context.
134
+ */
132
135
  type: Extract<RowFormType, 'rowEdited' | 'rowCreated'>;
136
+ /**
137
+ * Row being edited or cloned. Absent when the form creates a new row.
138
+ */
133
139
  rowNode?: IRowNode<TData>;
134
140
  }
135
141
  /**
136
142
  * Context used for overriding Field elements in Row Form
137
143
  */
138
144
  export interface RowFormFieldContext<TData = any> extends RowFormTitleContext {
145
+ /**
146
+ * Column the field is being built for. Return a partial field to override the default for this column only.
147
+ */
139
148
  column: AdaptableColumn<TData>;
140
149
  }
141
150
  /**
@@ -31,11 +31,15 @@ export interface SettingsPanelOptions {
31
31
  */
32
32
  displayOptions?: SettingsPanelDisplayOptions;
33
33
  /**
34
+ * Whether module icons show in the navigation. Set `displayOptions.showModuleIcons` instead.
35
+ *
34
36
  * @deprecated Use `displayOptions.showModuleIcons` instead.
35
37
  * @defaultValue true
36
38
  */
37
39
  showModuleIcons?: boolean;
38
40
  /**
41
+ * Whether module descriptions show under each name. Set `displayOptions.showModuleDescriptions` instead.
42
+ *
39
43
  * @deprecated Use `displayOptions.showModuleDescriptions` instead.
40
44
  * @defaultValue true
41
45
  */
@@ -43,7 +47,6 @@ export interface SettingsPanelOptions {
43
47
  /**
44
48
  * Whether a Settings Panel button should always be displayed in `ModuleButtons` area of ToolPanel
45
49
  * @defaultValue false
46
- * @noCodeItem
47
50
  */
48
51
  alwaysShowInToolPanel?: boolean;
49
52
  /**
@@ -125,6 +128,9 @@ export interface SettingsPanelNavigationGroup {
125
128
  * Grouped Settings Panel navigation structure.
126
129
  */
127
130
  export interface SettingsPanelNavigation {
131
+ /**
132
+ * Groups, in the order they appear. Each group has a heading and the modules inside it.
133
+ */
128
134
  groups: SettingsPanelNavigationGroup[];
129
135
  }
130
136
  /**
@@ -147,6 +153,9 @@ export type SettingsPanelNavigationConfigurer = (context: SettingsPanelNavigatio
147
153
  * removed in the next major release.
148
154
  */
149
155
  export interface LegacyFlatSettingsPanelNavigation {
156
+ /**
157
+ * Modules in one list. The string `'-'` starts a new group.
158
+ */
150
159
  items?: (AdaptableSettingsPanel | string | '-')[];
151
160
  }
152
161
  /**
@@ -10,7 +10,6 @@ export interface ToolPanelOptions {
10
10
  * Display the Tool Panels dropdown
11
11
  *
12
12
  * @defaultValue true
13
- * @noCodeItem
14
13
  */
15
14
  showToolPanelsDropdown?: boolean;
16
15
  /**
@@ -85,7 +85,6 @@ export interface UserInterfaceOptions<TData = any> {
85
85
  /**
86
86
  * Hides confirmation dialog which displays whenever an AdaptableObject is deleted
87
87
  * @defaultValue false
88
- * @noCodeItem
89
88
  */
90
89
  disableDeleteConfirmation?: boolean;
91
90
  /**
@@ -114,7 +113,6 @@ export interface LoadingScreenOptions<TData = any> {
114
113
  /**
115
114
  * Display Loading Screen when AdapTable initialises
116
115
  * @defaultValue true
117
- * @noCodeItem
118
116
  */
119
117
  showLoadingScreen?: boolean;
120
118
  /**
@@ -208,7 +206,13 @@ export interface ColourPickerFilterContext {
208
206
  * Colours to show - must be in list provided (otherwise ignored)
209
207
  */
210
208
  export interface ColourPickerFilterResult {
209
+ /**
210
+ * Theme colours to keep. A colour not in the supplied list is ignored.
211
+ */
211
212
  themeColours: ColourPickerColour[];
213
+ /**
214
+ * Palette colours to keep. A colour not in the supplied list is ignored.
215
+ */
212
216
  paletteColours: ColourPickerColour[];
213
217
  }
214
218
  /**