@adaptabletools/adaptable-mcp 0.1.0-canary.1 → 0.1.0-canary.2

package/data/changes/23-24.json

@@ -0,0 +1,1874 @@
+{
+  "from": 23,
+  "to": 24,
+  "builtFrom": {
+    "releaseNote": "support/version-240-release-note",
+    "sourceSha256": "c0f8671c160ff9cc38b048dcabb2ad25812efaf23064881ed8e52bbfaea4e3bc"
+  },
+  "records": [
+    {
+      "id": "deployment-team-sharing",
+      "area": "deployment",
+      "type": "BEHAVIOUR",
+      "title": "Team Sharing roll-out",
+      "rows": [
+        {
+          "item": "Team Sharing roll-out",
+          "before": "v.23 and v.24 clients read the same shared store",
+          "after": "every client that reads the store upgrades together; persistMigratedSharedEntities decides whether migrated entities are written back",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [],
+      "always": true,
+      "note": "Plan the release so every client of a shared store moves to v.24 at once.",
+      "docs": "support/version-240-release-note#chg-deployment-team-sharing"
+    },
+    {
+      "id": "deployment-duplicate-names",
+      "area": "deployment",
+      "type": "BEHAVIOUR",
+      "title": "Duplicate Names in persisted State",
+      "rows": [
+        {
+          "item": "Duplicate Names in persisted State",
+          "before": "objects of one Module may share a Name",
+          "after": "when Tags are converted, duplicates are renamed Name (2), Name (3), … on the first v.24 load",
+          "autoMigrated": "partial"
+        }
+      ],
+      "search": [],
+      "always": true,
+      "note": "Rename duplicates in the store beforehand where you can reach it; otherwise expect the renames in the console.",
+      "docs": "support/version-240-release-note#chg-deployment-duplicate-names"
+    },
+    {
+      "id": "packages-upgrade-24",
+      "area": "packages",
+      "type": "BREAKING",
+      "title": "AG Grid",
+      "rows": [
+        {
+          "item": "AG Grid",
+          "before": "35.3 (23.0) / 36.2 (23.1)",
+          "after": "36.2 (ag-grid-enterprise@>=36.2.0); ag-stack@>=36.2.0 only if reported as a missing peer",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "@adaptabletools/* versions",
+          "before": "23.x",
+          "after": "all on the same 24.x",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [],
+      "always": true,
+      "note": "Bump every @adaptabletools/* package to the same 24.x and AG Grid to 36.2 (use the ag-update skill for AG Grid); add ag-stack only if the package manager reports a missing peer.",
+      "docs": "support/version-240-release-note#chg-packages-upgrade-24"
+    },
+    {
+      "id": "packages-angular-20",
+      "area": "packages",
+      "type": "BREAKING",
+      "title": "Angular wrapper",
+      "rows": [
+        {
+          "item": "Angular wrapper",
+          "before": "Angular >=18.2.14 (23.0)",
+          "after": "Angular >=20 (@adaptabletools/adaptable-angular-aggrid)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "@adaptabletools/adaptable-angular-aggrid"
+      ],
+      "always": false,
+      "note": "Projects on 23.1 or later already run Angular 20; from 23.0 or older, upgrade the application to Angular 20 first.",
+      "docs": "support/version-240-release-note#chg-packages-angular-20"
+    },
+    {
+      "id": "packages-notes-module",
+      "area": "packages",
+      "type": "BREAKING",
+      "title": "Notes implementation",
+      "rows": [
+        {
+          "item": "Notes implementation",
+          "before": "AdapTable's own popup and indicator",
+          "after": "AG Grid Cell Notes — register NotesModule (or AllEnterpriseModule)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "noteOptions",
+        "noteApi",
+        "AdaptableNote",
+        "'Note'"
+      ],
+      "always": false,
+      "note": "Add NotesModule (or AllEnterpriseModule) to ModuleRegistry.registerModules.",
+      "docs": "support/version-240-release-note#chg-packages-notes-module"
+    },
+    {
+      "id": "css-notes-styling",
+      "area": "css",
+      "type": "BREAKING",
+      "title": "Note popup class",
+      "rows": [
+        {
+          "item": "Note popup class",
+          "before": ".ab-NotePopup",
+          "after": "removed — AG Grid renders the editor; style it with AG Grid's --ag-note-popup-* variables or Theming API parameters",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Note popup variables",
+          "before": "--ab-cmp-note-popup-*",
+          "after": "still defined, no longer read",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Note indicator colour",
+          "before": "--ab-CellNote-triangle-color, --ab-CellComment-CellNote-triangle-color",
+          "after": "AG Grid --ag-note-indicator-color, per Note Type on .ab-NoteType- (e.g. .ab--theme-dark .ab-NoteType-Info { … })",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "ab-NotePopup",
+        "--ab-CellNote-triangle-color",
+        "--ab-cmp-note-popup",
+        "--ab-CellComment-CellNote-triangle-color"
+      ],
+      "always": false,
+      "note": "Delete rules that target .ab-NotePopup; colour indicators per Note Type with --ag-note-indicator-color on the .ab-NoteType-* classes.",
+      "docs": "support/version-240-release-note#chg-css-notes-styling"
+    },
+    {
+      "id": "css-color-swatch-palette",
+      "area": "css",
+      "type": "BREAKING",
+      "title": "Swatch colour variables",
+      "rows": [
+        {
+          "item": "Swatch colour variables",
+          "before": "--ab-color-swatch-1 … --ab-color-swatch-20",
+          "after": "--ab-color-palette-13 … --ab-color-palette-32 (same colours); the swatch variables are not defined, so var(--ab-color-swatch-N) resolves to nothing — saved styles in State are migrated (see Colour Picker)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "--ab-color-swatch-"
+      ],
+      "always": false,
+      "note": "Replace every --ab-color-swatch-N with --ab-color-palette-{N+12} in theme CSS, initialState styles and code.",
+      "docs": "support/version-240-release-note#chg-css-color-swatch-palette"
+    },
+    {
+      "id": "css-component-variables",
+      "area": "css",
+      "type": "BREAKING",
+      "title": "Component variables",
+      "rows": [
+        {
+          "item": "Component variables",
+          "before": "--ab-cmp-listgroupitem*, --ab-cmp-column-tag*, --ab-cmp-entity-rules-editor__background-color",
+          "after": "removed — target the elements' .ab-* classes (AdapTable's CSS is in the adaptable cascade layer, so an unlayered rule wins without !important)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "--ab-cmp-listgroupitem",
+        "--ab-cmp-column-tag",
+        "--ab-cmp-entity-rules-editor"
+      ],
+      "always": false,
+      "note": "Delete the overrides and restyle those elements through their .ab-* classes.",
+      "docs": "support/version-240-release-note#chg-css-component-variables"
+    },
+    {
+      "id": "css-colour-input-classes",
+      "area": "css",
+      "type": "BREAKING",
+      "title": "Colour input classes",
+      "rows": [
+        {
+          "item": "Colour input classes",
+          "before": ".ab-ColorPicker-swatch, .ab-ColorPicker-range, .ab-OptionalColorPicker-empty",
+          "after": "removed — the Colour Picker popover replaces the browser colour input; configure it with userInterfaceOptions.colourPickerOptions",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "ab-ColorPicker-swatch",
+        "ab-ColorPicker-range",
+        "ab-OptionalColorPicker-empty"
+      ],
+      "always": false,
+      "note": "Delete rules that target those classes; configure the Colour Picker with userInterfaceOptions.colourPickerOptions.",
+      "docs": "support/version-240-release-note#chg-css-colour-input-classes"
+    },
+    {
+      "id": "packages-bundler-resolver-settings",
+      "area": "packages",
+      "type": "BREAKING",
+      "title": "Parcel 2",
+      "rows": [
+        {
+          "item": "Parcel 2",
+          "before": "no settings",
+          "after": "\"@parcel/resolver-default\": { \"packageExports\": true } in the project package.json",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "CodeSandbox",
+          "before": "no settings",
+          "after": "alias entries for #prehydration/tabs/indicator and #prehydration/slider/thumb — see Bundlers & CodeSandbox",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "\"parcel\"",
+        "@parcel/",
+        "codesandbox"
+      ],
+      "always": false,
+      "note": "Only Parcel 2 and CodeSandbox need settings; Vite, webpack 5, Next and Node resolve exports and imports already.",
+      "docs": "support/version-240-release-note#chg-packages-bundler-resolver-settings"
+    },
+    {
+      "id": "packages-nocode-removed",
+      "area": "packages",
+      "type": "BREAKING",
+      "title": "No Code",
+      "rows": [
+        {
+          "item": "No Code",
+          "before": "@adaptabletools/adaptable-plugin-nocode-aggrid, AdaptableNoCodeWizard, AdaptableWizardView, React AdaptableOptionsWizardView",
+          "after": "removed — build the Grid in the project",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "@adaptabletools/adaptable-plugin-nocode-aggrid",
+        "AdaptableNoCodeWizard",
+        "AdaptableWizardView",
+        "AdaptableOptionsWizardView",
+        "AdaptableNoCodeWizardOptions"
+      ],
+      "always": false,
+      "note": "Remove the dependency and every import of those symbols; build the Grid in the project.",
+      "docs": "support/version-240-release-note#chg-packages-nocode-removed"
+    },
+    {
+      "id": "aql-pre-24-syntax",
+      "area": "aql",
+      "type": "BREAKING",
+      "title": "Aggregation call",
+      "rows": [
+        {
+          "item": "Aggregation call",
+          "before": "SUM([PnL], GROUP_BY([Ccy]))",
+          "after": "SUM{[PnL], GROUP_BY([Ccy])}",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Cumulative",
+          "before": "CUMUL(SUM([PnL]), OVER([Date]))",
+          "after": "SUM{[PnL], CUMULATIVE([Date])}",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Window",
+          "before": "RANK(OVER([Date]), GROUP_BY([Ccy]))",
+          "after": "RANK{OVER([Date]), GROUP_BY([Ccy])}",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Quantile",
+          "before": "QUANT([Price], 4)",
+          "after": "QUANT{[Price], 4}",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Time window",
+          "before": "TIMEFRAME('5m')",
+          "after": "WITHIN(5m)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Duration literal",
+          "before": "TIMEFRAME('5m') (quoted)",
+          "after": "5m (unquoted duration)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Column reference function",
+          "before": "COL('Price')",
+          "after": "[Price]",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Scope stand-in",
+          "before": "$SCOPE()",
+          "after": "$SCOPE",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "All-rows clause",
+          "before": "GRID()",
+          "after": "ALL_ROWS()",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Observable count",
+          "before": "ROW_CHANGE(COUNT([qty], 3), TIMEFRAME('5m'))",
+          "after": "CHANGE_COUNT{[qty], WITHIN(5m)} >= 3",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Observable high (row)",
+          "before": "ROW_CHANGE(MAX([Price]), TIMEFRAME('20s'))",
+          "after": "[Price] >= HIGHEST{[Price], WITHIN(20s)}",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Observable high (grid)",
+          "before": "GRID_CHANGE(MAX([Cost]), TIMEFRAME('1h'))",
+          "after": "[Cost] >= HIGHEST{[Cost], WITHIN(1h), ALL_ROWS()}",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Rows added (count)",
+          "before": "ROW_ADDED(2, TIMEFRAME('20s'))",
+          "after": "ROWS_ADDED{WITHIN(20s)} >= 2",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Row added / removed (event)",
+          "before": "ROW_ADDED() / ROW_REMOVED()",
+          "after": "Row Change Alert (Type: 'RowChange', trigger Added / Removed)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Dual-name paren vs brace",
+          "before": "SUM([a], [b]) always one meaning",
+          "after": "SUM([a], [b]) is Standard (this row); SUM{[PnL]} is Aggregation",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Inclusive range",
+          "before": "[col] BETWEEN (lo, hi) / BETWEEN([col], lo, hi)",
+          "after": "([col] >= lo AND [col] <= hi)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Exclusive range",
+          "before": "NOT ([col] BETWEEN (lo, hi))",
+          "after": "([col] hi)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Null literal",
+          "before": "NULL()",
+          "after": "NULL",
+          "autoMigrated": "yes"
+        }
+      ],
+      "search": [
+        "TIMEFRAME(",
+        "ROW_CHANGE(",
+        "GRID_CHANGE(",
+        "ROW_ADDED(",
+        "ROW_REMOVED(",
+        "COL(",
+        "$SCOPE()",
+        "GRID()",
+        "CUMUL(",
+        " BETWEEN ",
+        "NULL()"
+      ],
+      "always": false,
+      "note": "Run `adaptable migrate expression` on each string kept outside State (API calls, config files, server rules); State literals are rewritten by `migrate state` and at load.",
+      "docs": "support/version-240-release-note#chg-aql-pre-24-syntax"
+    },
+    {
+      "id": "state-legacy-shapes",
+      "area": "state",
+      "type": "DEPRECATED",
+      "title": "Expression wrapper",
+      "rows": [
+        {
+          "item": "Expression wrapper",
+          "before": "Rule: { BooleanExpression: '[Price] > 100' } (also Query, ScalarExpression, AggregatedExpression, …)",
+          "after": "Rule: '[Price] > 100' (plain string)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Calculated Column text",
+          "before": "CalculatedColumn.Query (wrapper or string)",
+          "after": "CalculatedColumn.Expression (string)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Report row query",
+          "before": "Report.Query",
+          "after": "Report.Expression",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Named Query text",
+          "before": "wrapper object",
+          "after": "NamedQuery.Expression (string)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Named Query return",
+          "before": "always boolean",
+          "after": "NamedQuery.ReturnType ('boolean' when omitted)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Calculated Column kind",
+          "before": "inferred only",
+          "after": "CalculatedColumn.Type (Standard / Observable / Aggregated / Cumulative / Quantile / Window)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Alert kind",
+          "before": "inferred only",
+          "after": "AlertDefinition.Type (DataChange / RelativeChange / Validation / RowChange / Aggregation / Observable / Scheduled)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Flashing Cell kind",
+          "before": "inferred only",
+          "after": "FlashingCellDefinition.Type (Change / Observable)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Alert / Flashing Cell / Format Column / Plus Minus rule",
+          "before": "{ Predicates } or query wrapper",
+          "after": "Rule string",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Badge condition",
+          "before": "BadgeStyleDefinition.Predicate",
+          "after": "Rule string",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Column Filter",
+          "before": "ColumnFilter.Predicates + PredicatesOperator",
+          "after": "ColumnFilter.Expression (complete) or ColumnFilter.PreferredFilter (UI seed)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Column Filter seed names",
+          "before": "friendly names (GreaterThan, Contains, …)",
+          "after": "AQL operators (GT, CONTAINS, …)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Grid Filter",
+          "before": "Layout.GridFilter.Expression (string; leftover AQL)",
+          "after": "same property; AQL rewritten",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Wrapper key BooleanExpression",
+          "before": "{ BooleanExpression: '…' }",
+          "after": "{ Expression: '…' } then unwrapped to the string",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Wrapper key ScalarExpression",
+          "before": "{ ScalarExpression: '…' }",
+          "after": "{ Expression: '…' } then unwrapped to the string",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Wrapper key AggregatedBooleanExpression",
+          "before": "{ AggregatedBooleanExpression: '…' }",
+          "after": "{ AggregatedExpression: '…' } then unwrapped to the string",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Wrapper key AggregatedScalarExpression",
+          "before": "{ AggregatedScalarExpression: '…' }",
+          "after": "{ AggregatedExpression: '…' } then unwrapped to the string",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Badge intermediate",
+          "before": "BadgeStyleDefinition.Expression (query wrapper)",
+          "after": "BadgeStyleDefinition.Rule (string)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Note time",
+          "before": "AdaptableNote.Timestamp",
+          "after": "CreatedAt / UpdatedAt",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Alert object shape",
+          "before": "one object; kind inferred from Rule",
+          "after": "discriminated union: RuleBasedAlertDefinition (Rule: string) / RowChangeAlertDefinition (RowChangeTrigger, optional Rule) / ScheduledAlertDefinition (Schedule, no Rule)",
+          "autoMigrated": "yes"
+        }
+      ],
+      "search": [
+        "BooleanExpression:",
+        "ScalarExpression:",
+        "AggregatedBooleanExpression:",
+        "AggregatedScalarExpression:",
+        "ObservableExpression:",
+        "\"BooleanExpression\":",
+        "\"ScalarExpression\":",
+        " Predicates:",
+        " Predicate:",
+        "\"Predicates\":",
+        "\"Predicate\":",
+        "PredicatesOperator",
+        " Query:"
+      ],
+      "always": false,
+      "note": "State loads as is; rewrite the initialState literals with `adaptable migrate state` so the source matches v.24.",
+      "docs": "support/version-240-release-note#chg-state-legacy-shapes"
+    },
+    {
+      "id": "state-color-swatch",
+      "area": "state",
+      "type": "DEPRECATED",
+      "title": "Swatch colour in a style",
+      "rows": [
+        {
+          "item": "Swatch colour in a style",
+          "before": "var(--ab-color-swatch-N)",
+          "after": "var(--ab-color-palette-{N+12})",
+          "autoMigrated": "yes"
+        }
+      ],
+      "search": [
+        "--ab-color-swatch-"
+      ],
+      "always": false,
+      "note": "Saved styles are rewritten at load; rename the variable in initialState literals yourself.",
+      "docs": "support/version-240-release-note#chg-state-color-swatch"
+    },
+    {
+      "id": "state-layout-tag-conversion",
+      "area": "state",
+      "type": "BEHAVIOUR",
+      "title": "Layout membership",
+      "rows": [
+        {
+          "item": "Layout membership",
+          "before": "Object Tags (when autoCheckTagsForLayouts)",
+          "after": "Layout.LayoutExtensions (LayoutExtension per Layout)",
+          "autoMigrated": "yes"
+        },
+        {
+          "item": "Layout membership — duplicate names",
+          "before": "several objects of one Module with the same Name and different Tags",
+          "after": "renamed Name (2), Name (3), … so each can be referenced by Name; update name lookups",
+          "autoMigrated": "partial"
+        },
+        {
+          "item": "Layout membership — unmatched Tags",
+          "before": "objects whose Tags matched no Layout were hidden in every Layout",
+          "after": "apply in every Layout; suspend or delete them if they should stay hidden",
+          "autoMigrated": "no"
+        },
+        {
+          "item": "Layout membership — Reports / Free Text Columns",
+          "before": "Tags with a Layout name",
+          "after": "cannot be extended; apply in every Layout (move Layout-specific behaviour to application logic, e.g. on LayoutChanged)",
+          "autoMigrated": "no"
+        }
+      ],
+      "search": [
+        "autoCheckTagsForLayouts"
+      ],
+      "always": false,
+      "note": "Give every object extended into a Layout a unique Name before the first v.24 load, then check the console for renamed and unconverted objects.",
+      "docs": "support/version-240-release-note#chg-state-layout-tag-conversion"
+    },
+    {
+      "id": "state-custom-predicate-rules",
+      "area": "state",
+      "type": "BREAKING",
+      "title": "Custom Predicate rules",
+      "rows": [
+        {
+          "item": "Custom Predicate rules",
+          "before": "Predicates with a custom id",
+          "after": "no Expression equivalent",
+          "autoMigrated": "no"
+        }
+      ],
+      "search": [
+        "customPredicateDefs"
+      ],
+      "always": false,
+      "note": "Re-create the emptied rules as Expressions that call the customStandardFunctions replacing the Predicates.",
+      "docs": "support/version-240-release-note#chg-state-custom-predicate-rules"
+    },
+    {
+      "id": "state-percent-change",
+      "area": "state",
+      "type": "BREAKING",
+      "title": "PercentChange Predicate",
+      "rows": [
+        {
+          "item": "PercentChange Predicate",
+          "before": "PredicateId: 'PercentChange'",
+          "after": "no boolean equivalent (PERCENT_CHANGE is numeric)",
+          "autoMigrated": "no"
+        }
+      ],
+      "search": [
+        "'PercentChange'",
+        "\"PercentChange\""
+      ],
+      "always": false,
+      "note": "Re-author each rule as `PERCENT_CHANGE([col]) > n` or as a Relative Change Alert.",
+      "docs": "support/version-240-release-note#chg-state-percent-change"
+    },
+    {
+      "id": "state-unconverted-expressions",
+      "area": "state",
+      "type": "BREAKING",
+      "title": "Unparseable Expression",
+      "rows": [
+        {
+          "item": "Unparseable Expression",
+          "before": "leftover spelling",
+          "after": "left unchanged; logged; invalid in the UI",
+          "autoMigrated": "no"
+        },
+        {
+          "item": "Unconvertible Observable Alert",
+          "before": "leftover ROW_CHANGE / GRID_CHANGE",
+          "after": "IsSuspended: true, Name suffixed (needs migration)",
+          "autoMigrated": "partial"
+        }
+      ],
+      "search": [
+        "ROW_CHANGE(",
+        "GRID_CHANGE("
+      ],
+      "always": false,
+      "note": "Re-author the rule with the v.24 Observable functions, then un-suspend the Alert and remove the (needs migration) suffix.",
+      "docs": "support/version-240-release-note#chg-state-unconverted-expressions"
+    },
+    {
+      "id": "options-predicate-options",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Predicate Options object",
+      "rows": [
+        {
+          "item": "Predicate Options object",
+          "before": "predicateOptions",
+          "after": "removed — use expressionOptions",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Case sensitivity",
+          "before": "predicateOptions.caseSensitivePredicates",
+          "after": "expressionOptions.caseSensitiveExpressions",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Date IN granularity",
+          "before": "predicateOptions.evaluateInPredicateUsingTime",
+          "after": "expressionOptions.evaluateDatesUsingTime",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "predicateOptions",
+        "caseSensitivePredicates",
+        "evaluateInPredicateUsingTime"
+      ],
+      "always": false,
+      "note": "Move the settings to expressionOptions, then delete the predicateOptions object.",
+      "docs": "support/version-240-release-note#chg-options-predicate-options"
+    },
+    {
+      "id": "options-custom-predicate-defs",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Custom Predicates",
+      "rows": [
+        {
+          "item": "Custom Predicates",
+          "before": "predicateOptions.customPredicateDefs",
+          "after": "expressionOptions.customStandardFunctions (set returnType: 'boolean'; see Custom Predicates to Functions)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "customPredicateDefs",
+        "AdaptablePredicateDef",
+        "PredicateDefInput",
+        "PredicateDefHandlerContext",
+        "PredicateDefToStringParams",
+        "PredicateModuleScope"
+      ],
+      "always": false,
+      "note": "Re-author each Predicate as a customStandardFunctions entry with returnType 'boolean', using the field map in Custom Predicates to Functions.",
+      "docs": "support/version-240-release-note#chg-options-custom-predicate-defs"
+    },
+    {
+      "id": "options-custom-standard-functions",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Custom scalar / boolean functions",
+      "rows": [
+        {
+          "item": "Custom scalar / boolean functions",
+          "before": "customScalarFunctions and customBooleanFunctions",
+          "after": "customStandardFunctions — returnType required; handler is (args, context) with accessor-based context (getRowData(), getColumnValue(id), …); category values 'strings' / 'maths' / 'dates' / 'special' → 'text' / 'numeric' / 'date' / 'general'",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Custom aggregations",
+          "before": "customAggregatedFunctions (called with parentheses)",
+          "after": "customAggregatedFunctions (called with braces: MY_AGG{[col]})",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "customScalarFunctions",
+        "customBooleanFunctions",
+        "dataChangedEvent",
+        "evaluateCustomQueryVariable",
+        "whereClauseFunctions"
+      ],
+      "always": false,
+      "note": "Merge both maps into customStandardFunctions, add returnType to every entry and move handlers to the accessor-based context.",
+      "docs": "support/version-240-release-note#chg-options-custom-standard-functions"
+    },
+    {
+      "id": "options-query-variables",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Query variables",
+      "rows": [
+        {
+          "item": "Query variables",
+          "before": "customQueryVariables (object map)",
+          "after": "queryVariables (array of { name, value, description? })",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Variable resolver context",
+          "before": "CustomQueryVariableContext",
+          "after": "QueryVariableContext",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "customQueryVariables",
+        "CustomQueryVariableContext"
+      ],
+      "always": false,
+      "docs": "support/version-240-release-note#chg-options-query-variables"
+    },
+    {
+      "id": "options-function-allow-lists",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Function allow-lists",
+      "rows": [
+        {
+          "item": "Function allow-lists",
+          "before": "systemBooleanFunctions, systemScalarFunctions, systemObservableFunctions, systemAggregatedBooleanFunctions, systemAggregatedScalarFunctions, moduleExpressionFunctions",
+          "after": "isExpressionFunctionAvailable (shows / hides only; cannot re-order the operator list)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Filter Predicate allow-lists",
+          "before": "systemFilterPredicates (and similar)",
+          "after": "isExpressionFunctionAvailable (and per-function isAvailable)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "systemBooleanFunctions",
+        "systemScalarFunctions",
+        "systemObservableFunctions",
+        "systemAggregatedBooleanFunctions",
+        "systemAggregatedScalarFunctions",
+        "moduleExpressionFunctions",
+        "ModuleExpressionFunctions",
+        "systemFilterPredicates",
+        "systemAlertPredicates",
+        "systemFormatColumnPredicates",
+        "systemFlashingCellPredicates",
+        "systemBadgeStylePredicates",
+        "SystemPredicatesContext",
+        "BooleanFunctionName",
+        "ObservableFunctionName"
+      ],
+      "always": false,
+      "note": "Replace the lists with one isExpressionFunctionAvailable callback that returns context.defaultAvailability except for the functions to hide.",
+      "docs": "support/version-240-release-note#chg-options-function-allow-lists"
+    },
+    {
+      "id": "options-column-filter-keys",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Default Column Filter keys",
+      "rows": [
+        {
+          "item": "Default Column Filter keys",
+          "before": "GreaterThan, Equals, Contains, StartsWith, Blanks, After, On, …",
+          "after": "GT, EQ, CONTAINS, STARTS_WITH, IS_BLANK, GT, IS_SAME_DAY, … (see Column Filter Keys)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Default Column Filter context",
+          "before": "DefaultPredicateFilterContext",
+          "after": "DefaultFilterExpressionContext",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Quick Filter wildcards",
+          "before": "quickFilterWildcards keyed on any Predicate",
+          "after": "keys limited to EQ, NEQ, LT, LTE, GT, GTE, IN; other wildcards move to the function's shortcuts",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "defaultNumericColumnFilter",
+        "defaultTextColumnFilter",
+        "defaultDateColumnFilter",
+        "defaultArrayColumnFilter",
+        "quickFilterWildcards",
+        "DefaultPredicateFilterContext"
+      ],
+      "always": false,
+      "note": "Replace each Predicate key with its operator from Column Filter Keys; quickFilterWildcards keys are limited to the comparison operators.",
+      "docs": "support/version-240-release-note#chg-options-column-filter-keys"
+    },
+    {
+      "id": "options-custom-in-filter-values",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "IN Filter custom values",
+      "rows": [
+        {
+          "item": "IN Filter custom values",
+          "before": "customInFilterValues item with a Predicate id in value",
+          "after": "{ label, expressionFunction: 'IS_BLANK' } ('Blanks' → IS_BLANK, 'Positive' → IS_POSITIVE, …) — value is always a literal cell value",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "customInFilterValues"
+      ],
+      "always": false,
+      "note": "Replace items whose value is a Predicate id with { label, expressionFunction }; items with real cell values stay.",
+      "docs": "support/version-240-release-note#chg-options-custom-in-filter-values"
+    },
+    {
+      "id": "options-grid-filter-editors",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Grid Filter editors",
+      "rows": [
+        {
+          "item": "Grid Filter editors",
+          "before": "filterOptions.gridFilterOptions.availableFilterEditors",
+          "after": "expressionOptions.editorOptions.availableEditors / defaultEditor (gridFilterOptions removed)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "gridFilterOptions",
+        "availableFilterEditors",
+        "GridFilterEditors"
+      ],
+      "always": false,
+      "note": "Move the list to expressionOptions.editorOptions.availableEditors and delete gridFilterOptions.",
+      "docs": "support/version-240-release-note#chg-options-grid-filter-editors"
+    },
+    {
+      "id": "options-new-defaults",
+      "area": "options",
+      "type": "BEHAVIOUR",
+      "title": "New option defaults",
+      "rows": [
+        {
+          "item": "Expression editor default",
+          "before": "Expression Editor opened first",
+          "after": "expressionOptions.editorOptions.defaultEditor defaults to 'QueryBuilder'",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Batched Alerts default",
+          "before": "one Alert per changed cell",
+          "after": "alertOptions.consolidateBatchAlerts defaults to true (set false to restore)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Aggregated Calculated Column refresh",
+          "before": "synchronous on every row change",
+          "after": "calculatedColumnOptions.aggregatedColumnRowChangeThrottle defaults to 300 ms (set 0 to restore)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [],
+      "always": true,
+      "note": "Accept the new defaults or restore v.23 behaviour per row: defaultEditor 'ExpressionEditor', consolidateBatchAlerts false, aggregatedColumnRowChangeThrottle 0.",
+      "docs": "support/version-240-release-note#chg-options-new-defaults"
+    },
+    {
+      "id": "options-note-options",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Notes open trigger",
+      "rows": [
+        {
+          "item": "Notes open trigger",
+          "before": "noteOptions.showNoteAction",
+          "after": "AG Grid noteTrigger ('hover' / 'click')",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Notes close button",
+          "before": "noteOptions.showPopupCloseButton",
+          "after": "removed (AG Grid owns the Note editor)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Notes AG Grid module",
+          "before": "not required",
+          "after": "register AG Grid NotesModule",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "showNoteAction",
+        "showPopupCloseButton"
+      ],
+      "always": false,
+      "note": "Delete both properties; set AG Grid's noteTrigger ('hover' or 'click') to keep the open behaviour.",
+      "docs": "support/version-240-release-note#chg-options-note-options"
+    },
+    {
+      "id": "options-note-context-menu",
+      "area": "options",
+      "type": "BEHAVIOUR",
+      "title": "Notes context menu items",
+      "rows": [
+        {
+          "item": "Notes context menu items",
+          "before": "AdapTable items with category: 'Note'",
+          "after": "AG Grid's 'note' item — a customContextMenu that filters AdapTable items must add it from context.defaultAgGridMenuStructure",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "customContextMenu"
+      ],
+      "always": false,
+      "note": "A customContextMenu that keeps only AdapTable items must add AG Grid's 'note' item from context.defaultAgGridMenuStructure.",
+      "docs": "support/version-240-release-note#chg-options-note-context-menu"
+    },
+    {
+      "id": "options-always-show-in-dashboard",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Settings Panel dashboard button",
+      "rows": [
+        {
+          "item": "Settings Panel dashboard button",
+          "before": "settingsPanelOptions.alwaysShowInDashboard",
+          "after": "removed — Dashboard always provides an icon",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "alwaysShowInDashboard"
+      ],
+      "always": false,
+      "note": "Delete the property; no replacement is needed.",
+      "docs": "support/version-240-release-note#chg-options-always-show-in-dashboard"
+    },
+    {
+      "id": "options-settings-panel-display-options",
+      "area": "options",
+      "type": "DEPRECATED",
+      "title": "Settings Panel icons / descriptions",
+      "rows": [
+        {
+          "item": "Settings Panel icons / descriptions",
+          "before": "top-level showModuleIcons, showModuleDescriptions",
+          "after": "settingsPanelOptions.displayOptions.* (top-level keys still accepted, deprecated)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "showModuleIcons",
+        "showModuleDescriptions"
+      ],
+      "always": false,
+      "note": "Move both flags under settingsPanelOptions.displayOptions.",
+      "docs": "support/version-240-release-note#chg-options-settings-panel-display-options"
+    },
+    {
+      "id": "options-settings-panel-title-icon",
+      "area": "options",
+      "type": "BEHAVIOUR",
+      "title": "Settings Panel title default",
+      "rows": [
+        {
+          "item": "Settings Panel title default",
+          "before": "'Settings Panel'",
+          "after": "adaptableId when meaningful, otherwise 'Grid Settings'",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Settings Panel icon default",
+          "before": "ConfigurationIcon",
+          "after": "userInterfaceOptions.applicationIcon when set, else ConfigurationIcon",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "'Settings Panel'",
+        "ConfigurationIcon"
+      ],
+      "always": true,
+      "note": "Set settingsPanelOptions.title 'Settings Panel' and icon 'ConfigurationIcon' to keep the v.23 appearance.",
+      "docs": "support/version-240-release-note#chg-options-settings-panel-title-icon"
+    },
+    {
+      "id": "options-manage-state-hidden",
+      "area": "options",
+      "type": "BEHAVIOUR",
+      "title": "Manage State panel",
+      "rows": [
+        {
+          "item": "Manage State panel",
+          "before": "visible by default",
+          "after": "hidden until StateManagement is entitled Full",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [],
+      "always": true,
+      "note": "Entitle StateManagement as Full in entitlementOptions.moduleEntitlements to show the panel.",
+      "docs": "support/version-240-release-note#chg-options-manage-state-hidden"
+    },
+    {
+      "id": "options-grid-info-tabs",
+      "area": "options",
+      "type": "BEHAVIOUR",
+      "title": "Grid Info tabs default",
+      "rows": [
+        {
+          "item": "Grid Info tabs default",
+          "before": "settingsPanelOptions.gridInfoTabs defaults to ['Grid Options', 'Grid Summary', 'Grid State']",
+          "after": "defaults to ['Grid Summary', 'Layout', 'Grid State', 'Grid Options']; an explicit gridInfoTabs list shows only the tabs it names, so it hides the new Layout tab",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "gridInfoTabs"
+      ],
+      "always": false,
+      "note": "Add 'Layout' to an explicit gridInfoTabs array to show the new tab, or leave the option unset.",
+      "docs": "support/version-240-release-note#chg-options-grid-info-tabs"
+    },
+    {
+      "id": "options-column-header-every-column",
+      "area": "options",
+      "type": "BEHAVIOUR",
+      "title": "Column header callback",
+      "rows": [
+        {
+          "item": "Column header callback",
+          "before": "columnOptions.columnHeader skipped when the Layout had a caption",
+          "after": "called for every column; return context.layoutSpecificHeaderName when set to honour captions",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "columnHeader"
+      ],
+      "always": false,
+      "note": "Return context.layoutSpecificHeaderName when it is set to keep honouring Layout captions, or context.colDefHeaderName to fall back to the AG Grid header.",
+      "docs": "support/version-240-release-note#chg-options-column-header-every-column"
+    },
+    {
+      "id": "options-modal-container",
+      "area": "options",
+      "type": "BEHAVIOUR",
+      "title": "Modal container",
+      "rows": [
+        {
+          "item": "Modal container",
+          "before": "containerOptions.modalContainer named the popup element",
+          "after": "hosts the Settings Panel and Wizards; when set it overrides settingsPanelOptions.popupType / wizardOptions.popupType",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "modalContainer"
+      ],
+      "always": false,
+      "note": "Keep modalContainer only if the Settings Panel and Wizards should render in that element; otherwise remove it so popupType applies.",
+      "docs": "support/version-240-release-note#chg-options-modal-container"
+    },
+    {
+      "id": "options-action-column-controls",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Action Column content",
+      "rows": [
+        {
+          "item": "Action Column content",
+          "before": "actionColumnButton",
+          "after": "controls (array; each entry has type)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Action Column chrome",
+          "before": "actionColumnSettings",
+          "after": "settings",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Action Column command type",
+          "before": "ActionButtonCommand",
+          "after": "ActionCommand",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Action Column overflow",
+          "before": "displayMode, dropdownLabel",
+          "after": "menu control + settings.overflow",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Action Column style",
+          "before": "buttonStyle",
+          "after": "style",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Action Column handlers",
+          "before": "(button, context) => …",
+          "after": "(context) => …",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "actionColumnButton",
+        "ActionColumnButton",
+        "actionColumnSettings",
+        "ActionButtonCommand",
+        "ActionColumnDisplayMode",
+        "buttonStyle",
+        "dropdownLabel"
+      ],
+      "always": false,
+      "note": "Rewrite each Action Column as a controls array plus a settings object; see Action Columns.",
+      "docs": "support/version-240-release-note#chg-options-action-column-controls"
+    },
+    {
+      "id": "options-layout-tag-options",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Layout Tags",
+      "rows": [
+        {
+          "item": "Layout Tags",
+          "before": "layoutTagOptions.isObjectExtendedInLayout, autoGenerateTagsForLayouts",
+          "after": "deprecated / unused — use Layout.LayoutExtensions",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Layout Tag auto-check",
+          "before": "layoutTagOptions.autoCheckTagsForLayouts",
+          "after": "deprecated; still read only to auto-migrate Tags into LayoutExtensions",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "layoutTagOptions",
+        "isObjectExtendedInLayout",
+        "autoGenerateTagsForLayouts",
+        "autoCheckTagsForLayouts"
+      ],
+      "always": false,
+      "note": "Keep autoCheckTagsForLayouts true for the first v.24 loads so Tags become LayoutExtensions, then remove layoutTagOptions.",
+      "docs": "support/version-240-release-note#chg-options-layout-tag-options"
+    },
+    {
+      "id": "options-state-functions",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "State function state type",
+      "rows": [
+        {
+          "item": "State function state type",
+          "before": "stateOptions.saveState / persistState / applyState / loadState typed as AdaptableState or any",
+          "after": "AdaptablePersistentState (see State Options)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "saveState return",
+          "before": "any (returning nothing was accepted - and persisted undefined)",
+          "after": "AdaptablePersistentState - must return the state to persist",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "applyState state",
+          "before": "any",
+          "after": "Partial in and out",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "loadState result",
+          "before": "Promise",
+          "after": "Promise | null | void>",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "persistState / clearState result",
+          "before": "Promise",
+          "after": "Promise (resolved value is ignored)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Custom storage format",
+          "before": "add top-level keys in saveState, strip them in applyState",
+          "after": "wrap in persistState, unwrap in loadState; custom data goes in Application State",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "saveState",
+        "applyState",
+        "persistState",
+        "loadState",
+        "clearState",
+        "state.Internal",
+        "state.Popup",
+        "state.Comment",
+        "state.Plugins"
+      ],
+      "always": false,
+      "note": "Follow State Options: saveState returns the state, applyState takes a Partial persistent state, and custom storage data moves to persistState / loadState or Application State.",
+      "docs": "support/version-240-release-note#chg-options-state-functions"
+    },
+    {
+      "id": "options-color-palette",
+      "area": "options",
+      "type": "BREAKING",
+      "title": "Colour Picker palette",
+      "rows": [
+        {
+          "item": "Colour Picker palette",
+          "before": "userInterfaceOptions.colorPalette (deprecated)",
+          "after": "removed — override --ab-color-palette-* in theme CSS",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "colorPalette"
+      ],
+      "always": false,
+      "note": "Move the colours into theme CSS as --ab-color-palette-N overrides and remove colorPalette.",
+      "docs": "support/version-240-release-note#chg-options-color-palette"
+    },
+    {
+      "id": "api-predicate-api",
+      "area": "api",
+      "type": "BREAKING",
+      "title": "Predicate API",
+      "rows": [
+        {
+          "item": "Predicate API",
+          "before": "adaptableApi.predicateApi",
+          "after": "removed — use adaptableApi.expressionApi",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Predicate evaluate / label",
+          "before": "predicateApi.handle* / predicateToString",
+          "after": "evaluate / display the Expression string (expressionApi.evaluateStandardExpression, filterRowNodes, …)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "predicateApi",
+        "PredicateApi",
+        "predicateToString",
+        "getFlashingCellPredicateDefsForScope"
+      ],
+      "always": false,
+      "note": "Evaluate or display the Expression string with expressionApi; Rules are plain strings.",
+      "docs": "support/version-240-release-note#chg-api-predicate-api"
+    },
+    {
+      "id": "api-get-predicate-options",
+      "area": "api",
+      "type": "BREAKING",
+      "title": "Predicate Options getter",
+      "rows": [
+        {
+          "item": "Predicate Options getter",
+          "before": "optionsApi.getPredicateOptions",
+          "after": "removed — optionsApi.getExpressionOptions",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "getPredicateOptions"
+      ],
+      "always": false,
+      "docs": "support/version-240-release-note#chg-api-get-predicate-options"
+    },
+    {
+      "id": "api-column-filter-predicates",
+      "area": "api",
+      "type": "BREAKING",
+      "title": "Set Column Filter by Predicate",
+      "rows": [
+        {
+          "item": "Set Column Filter by Predicate",
+          "before": "columnFilterApi.setColumnFilterForColumn(col, predicate)",
+          "after": "columnFilterApi.setColumnFilters([{ ColumnId, Expression }])",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Column Filter def lists",
+          "before": "columnFilterApi.getColumnFilterDefs",
+          "after": "removed — read getColumnFilters() / Expression metadata",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Filter Predicate defs",
+          "before": "columnFilterApi.getFilterPredicateDefsForColumn / getFilterPredicateDefsForColumnId",
+          "after": "removed — operator metadata via Expression Function pools",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Blanks in IN filter values",
+          "before": "columnFilterApi.addBlanksToInFilterValues",
+          "after": "removed — use customInFilterValues with expressionFunction: 'IS_BLANK'",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "setColumnFilterForColumn",
+        "getColumnFilterDefs",
+        "getFilterPredicateDefsForColumn",
+        "addBlanksToInFilterValues"
+      ],
+      "always": false,
+      "note": "Set Column Filters as Expressions with setColumnFilters([{ ColumnId, Expression }]) and read them with getColumnFilters().",
+      "docs": "support/version-240-release-note#chg-api-column-filter-predicates"
+    },
+    {
+      "id": "api-filter-state-ast",
+      "area": "api",
+      "type": "BREAKING",
+      "title": "Filter state for servers",
+      "rows": [
+        {
+          "item": "Filter state for servers",
+          "before": "stateApi.getAdaptableFilterState().columnFilterDefs (Predicate ids)",
+          "after": "removed — columnFilters[].Expression plus gridFilterAST; parse a Column Filter with expressionApi.getASTForExpression(expression)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "External evaluation context",
+          "before": "EvaluateExpressionExternallyContext.predicates",
+          "after": "removed — read context.expression in evaluateAdaptableQLExternally",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "columnFilterDefs",
+        "getAdaptableFilterState",
+        "EvaluateExpressionExternallyContext",
+        "context.predicates"
+      ],
+      "always": false,
+      "note": "Send gridFilterAST and getASTForExpression output to the server instead of Predicate ids; see the Server Filtering note below the table.",
+      "docs": "support/version-240-release-note#chg-api-filter-state-ast"
+    },
+    {
+      "id": "api-expression-validity-checks",
+      "area": "api",
+      "type": "BREAKING",
+      "title": "Boolean Expression check",
+      "rows": [
+        {
+          "item": "Boolean Expression check",
+          "before": "expressionApi.isValidBooleanExpression",
+          "after": "expressionApi.isValidScalarExpression (boolean-predicate check)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Aggregated Expression check",
+          "before": "expressionApi.isValidAggregatedBooleanExpression / isValidAggregatedScalarExpression",
+          "after": "expressionApi.isValidAggregatedExpression",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Observable Expression check",
+          "before": "expressionApi.isValidObservableExpression",
+          "after": "removed — Observable calls are ordinary scalar Expressions; use isValidScalarExpression / isValidValueExpression",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "isValidBooleanExpression",
+        "isValidAggregatedBooleanExpression",
+        "isValidAggregatedScalarExpression",
+        "isValidObservableExpression"
+      ],
+      "always": false,
+      "docs": "support/version-240-release-note#chg-api-expression-validity-checks"
+    },
+    {
+      "id": "api-query-expression-accessors",
+      "area": "api",
+      "type": "BREAKING",
+      "title": "Query / Rule accessor",
+      "rows": [
+        {
+          "item": "Query / Rule accessor",
+          "before": "expressionApi.getAdaptableQueryExpression(query)",
+          "after": "removed — Rule / Expression are strings; use them directly",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Friendly-name Expression",
+          "before": "expressionApi.getAdaptableQueryExpressionWithColumnFriendlyNames(query)",
+          "after": "expressionApi.getExpressionWithColumnFriendlyNames(expression) (string only)",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "getAdaptableQueryExpression"
+      ],
+      "always": false,
+      "docs": "support/version-240-release-note#chg-api-query-expression-accessors"
+    },
+    {
+      "id": "api-expression-helpers",
+      "area": "api",
+      "type": "BREAKING",
+      "title": "Expression API helpers",
+      "rows": [
+        {
+          "item": "Expression kind",
+          "before": "inferred ad hoc",
+          "after": "expressionApi.getExpressionKind(expression)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Date-time comparisons",
+          "before": "Predicate Options / shouldEvaluateInUsingTime",
+          "after": "expressionApi.shouldEvaluateDatesUsingTime(column)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Case sensitivity",
+          "before": "Predicate Options",
+          "after": "expressionApi.useCaseSensitivity()",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Leftover Expression string",
+          "before": "n/a",
+          "after": "expressionApi.migratePreV24Expression(expression, { expressionKind? })",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "shouldEvaluateInUsingTime"
+      ],
+      "always": false,
+      "note": "Use expressionApi.shouldEvaluateDatesUsingTime, useCaseSensitivity, getExpressionKind and migratePreV24Expression.",
+      "docs": "support/version-240-release-note#chg-api-expression-helpers"
+    },
+    {
+      "id": "api-layout-extended-config",
+      "area": "api",
+      "type": "BREAKING",
+      "title": "Object getter config",
+      "rows": [
+        {
+          "item": "Object getter config",
+          "before": "getAlertDefinitions(config: LayoutExtendedConfig) + the other per-Module getters",
+          "after": "no argument — always every object; per-Layout objects via layoutApi.getLayoutExtensions(layoutName)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Format Column getters",
+          "before": "getFormatColumns(config: FormatColumnConfig)",
+          "after": "getFormatColumns() / getActiveFormatColumns() / getSuspendedFormatColumns() take no config (no includeSuspended, includeReadOnly, target); filter on IsReadOnly / Target yourself",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "LayoutExtendedConfig",
+        "includeLayoutNotExtendedObjects",
+        "extendedLayoutName",
+        "FormatColumnConfig"
+      ],
+      "always": false,
+      "note": "Drop the config argument; read State for every object and layoutApi.getLayoutExtensions(layoutName) for one Layout's objects.",
+      "docs": "support/version-240-release-note#chg-api-layout-extended-config"
+    },
+    {
+      "id": "api-extended-layout",
+      "area": "api",
+      "type": "BEHAVIOUR",
+      "title": "Layout contents",
+      "rows": [
+        {
+          "item": "Layout contents",
+          "before": "layoutApi.getExtendedLayoutByName included global objects",
+          "after": "returns only objects explicitly extended into that Layout",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Replace Layout extensions",
+          "before": "layoutApi.createOrUpdateExtendedLayout added to the existing set",
+          "after": "replaces the objects extended into the Layout",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Layout extension helpers",
+          "before": "via Tags / layoutTagOptions",
+          "after": "getLayoutExtensions, setLayoutExtensions, addObjectToLayout, removeObjectFromLayout, getLayoutsForObject, setLayoutsForObject, renameLayout",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "getExtendedLayoutByName",
+        "createOrUpdateExtendedLayout"
+      ],
+      "always": false,
+      "note": "Merge global objects yourself when reading, and pass the existing extensions back to createOrUpdateExtendedLayout.",
+      "docs": "support/version-240-release-note#chg-api-extended-layout"
+    },
+    {
+      "id": "api-load-user-state-async",
+      "area": "api",
+      "type": "BEHAVIOUR",
+      "title": "Load user State",
+      "rows": [
+        {
+          "item": "Load user State",
+          "before": "stateApi.loadUserState(state) returned void",
+          "after": "returns Promise — await it before reading State",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Persist State result",
+          "before": "stateApi.persistAdaptableState() resolved AdaptableState",
+          "after": "resolves AdaptablePersistentState",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Open Grid Filter editor",
+          "before": "gridFilterApi.openUIEditorForGridFilter(expression)",
+          "after": "argument ignored — call setGridFilterExpression(expression) first",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "loadUserState",
+        "persistAdaptableState",
+        "openUIEditorForGridFilter"
+      ],
+      "always": false,
+      "note": "Await loadUserState before reading State; call setGridFilterExpression before openUIEditorForGridFilter.",
+      "docs": "support/version-240-release-note#chg-api-load-user-state-async"
+    },
+    {
+      "id": "api-migrate-adaptable-state-generic",
+      "area": "api",
+      "type": "BEHAVIOUR",
+      "title": "Manual State migration",
+      "rows": [
+        {
+          "item": "Manual State migration",
+          "before": "AdaptableUpgradeHelper.migrateAdaptableState(state: AdaptableState, config): AdaptableState",
+          "after": "generic: migrateAdaptableState >(state: T, config): T - also accepts the applyState state",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "migrateAdaptableState"
+      ],
+      "always": false,
+      "note": "Pass the applyState state straight through; no cast is needed.",
+      "docs": "support/version-240-release-note#chg-api-migrate-adaptable-state-generic"
+    },
+    {
+      "id": "api-get-color-palette",
+      "area": "api",
+      "type": "BREAKING",
+      "title": "Colour Picker palette",
+      "rows": [
+        {
+          "item": "Colour Picker palette",
+          "before": "userInterfaceApi.getColorPalette()",
+          "after": "removed — the palette is the theme's --ab-color-palette-* CSS variables",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "getColorPalette"
+      ],
+      "always": false,
+      "note": "Read --ab-color-palette-N from CSS, or reference var(--ab-color-palette-N) directly.",
+      "docs": "support/version-240-release-note#chg-api-get-color-palette"
+    },
+    {
+      "id": "objects-predicate-types",
+      "area": "objects",
+      "type": "BREAKING",
+      "title": "Predicate types",
+      "rows": [
+        {
+          "item": "Predicate types",
+          "before": "AdaptablePredicate, AdaptablePredicateDef, SystemPredicateDefs",
+          "after": "removed — Expressions + Expression Functions",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Per-Module rule types",
+          "before": "AdaptableColumnPredicate, ColumnFilterPredicate, AlertDefinitionPredicate, AlertRule, FormatColumnPredicate, FormatColumnRule, BadgeStylePredicate, FlashingCellDefinitionPredicate, FlashingCellRule, PredicatesOperator",
+          "after": "removed — Rule / Expression are string",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "AdaptablePredicate",
+        "SystemPredicateDefs",
+        "PredicateId",
+        "AdaptableColumnPredicate",
+        "AlertDefinitionPredicate",
+        "FormatColumnPredicate",
+        "BadgeStylePredicate",
+        "FlashingCellDefinitionPredicate",
+        "AlertRule",
+        "FormatColumnRule",
+        "FlashingCellRule",
+        "PredicatesOperator",
+        ".Predicates",
+        ".Predicate?.",
+        ".Predicate."
+      ],
+      "always": false,
+      "note": "Build Expression strings instead of Predicate objects (see the Predicate map) and read .Expression / .Rule instead of .Predicates / .Predicate.",
+      "docs": "support/version-240-release-note#chg-objects-predicate-types"
+    },
+    {
+      "id": "objects-adaptable-query",
+      "area": "objects",
+      "type": "BREAKING",
+      "title": "Query Wrapper",
+      "rows": [
+        {
+          "item": "Query Wrapper",
+          "before": "AdaptableQuery ({ BooleanExpression | ScalarExpression | … })",
+          "after": "removed as a current type; leftover wrappers are LegacyAdaptableQuery; Rule / Expression are string",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "Query sub-types",
+          "before": "AdaptableBooleanQuery, AdaptableScalarQuery, AdaptableObservableQuery, AdaptableAggregatedBooleanQuery, AdaptableAggregatedScalarQuery, AdaptableAlertQuery, AdaptableCalculatedColumnQuery, isReactiveQuery",
+          "after": "removed",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "AdaptableQuery",
+        "BooleanQuery",
+        "ScalarQuery",
+        "ObservableQuery",
+        "AdaptableAlertQuery",
+        "AdaptableCalculatedColumnQuery",
+        "isReactiveQuery",
+        ".BooleanExpression",
+        ".ScalarExpression",
+        ".AggregatedBooleanExpression",
+        ".AggregatedScalarExpression",
+        ".ObservableExpression",
+        ".Query?.",
+        ".Query."
+      ],
+      "always": false,
+      "note": "Type the values as string and read report.Expression, calculatedColumn.Expression and namedQuery.Expression directly.",
+      "docs": "support/version-240-release-note#chg-objects-adaptable-query"
+    },
+    {
+      "id": "objects-alert-definition-union",
+      "area": "objects",
+      "type": "BREAKING",
+      "title": "Alert Definition",
+      "rows": [
+        {
+          "item": "Alert Definition",
+          "before": "one AlertDefinition with optional / inferred kind",
+          "after": "AlertDefinition = RuleBasedAlertDefinition | RowChangeAlertDefinition | ScheduledAlertDefinition",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "AlertDefinition"
+      ],
+      "always": false,
+      "note": "Set Type when creating Alerts and narrow on Type before reading Rule or Schedule.",
+      "docs": "support/version-240-release-note#chg-objects-alert-definition-union"
+    },
+    {
+      "id": "objects-column-filter-def",
+      "area": "objects",
+      "type": "BREAKING",
+      "title": "Column Filter def",
+      "rows": [
+        {
+          "item": "Column Filter def",
+          "before": "ColumnFilterDef",
+          "after": "removed — Column Filters carry Expression",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "ColumnFilterDef"
+      ],
+      "always": false,
+      "docs": "support/version-240-release-note#chg-objects-column-filter-def"
+    },
+    {
+      "id": "objects-grid-filter-options",
+      "area": "objects",
+      "type": "BREAKING",
+      "title": "Grid Filter options",
+      "rows": [
+        {
+          "item": "Grid Filter options",
+          "before": "GridFilterOptions",
+          "after": "removed — see expressionOptions.editorOptions",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "GridFilterOptions"
+      ],
+      "always": false,
+      "docs": "support/version-240-release-note#chg-objects-grid-filter-options"
+    },
+    {
+      "id": "objects-filter-contexts",
+      "area": "objects",
+      "type": "BREAKING",
+      "title": "Filter contexts",
+      "rows": [
+        {
+          "item": "Filter contexts",
+          "before": "DefaultPredicateFilterContext, CustomQueryVariableContext",
+          "after": "DefaultFilterExpressionContext, QueryVariableContext",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "DefaultPredicateFilterContext",
+        "CustomQueryVariableContext"
+      ],
+      "always": false,
+      "docs": "support/version-240-release-note#chg-objects-filter-contexts"
+    },
+    {
+      "id": "objects-layout-tag-contexts",
+      "area": "objects",
+      "type": "DEPRECATED",
+      "title": "Layout Tag contexts",
+      "rows": [
+        {
+          "item": "Layout Tag contexts",
+          "before": "LayoutExtendedContext, AutoGenerateTagsForLayoutsContext",
+          "after": "deprecated with layoutTagOptions",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "LayoutExtendedContext",
+        "AutoGenerateTagsForLayoutsContext"
+      ],
+      "always": false,
+      "docs": "support/version-240-release-note#chg-objects-layout-tag-contexts"
+    },
+    {
+      "id": "objects-extended-layout-object",
+      "area": "objects",
+      "type": "BREAKING",
+      "title": "Extended Layout items",
+      "rows": [
+        {
+          "item": "Extended Layout items",
+          "before": "ExtendedLayout.Extensions items typed LayoutExtension",
+          "after": "ExtendedLayoutObject ({ Module, Object }); LayoutExtension now means the State entry { LayoutName, Alert?, FormatColumn?, … }",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "ExtendedLayout",
+        "LayoutExtensionObject",
+        "LayoutExtensionModule"
+      ],
+      "always": false,
+      "note": "Re-type ExtendedLayout.Extensions items as ExtendedLayoutObject.",
+      "docs": "support/version-240-release-note#chg-objects-extended-layout-object"
+    },
+    {
+      "id": "objects-state-function-types",
+      "area": "objects",
+      "type": "BREAKING",
+      "title": "State function types",
+      "rows": [
+        {
+          "item": "State function types",
+          "before": "AdaptableSaveStateFunction, AdaptablePersistStateFunction, AdaptableLoadStateFunction, AdaptableApplyStateFunction on AdaptableState / any",
+          "after": "same names, typed on AdaptablePersistentState (see State Options)",
+          "autoMigrated": "n/a"
+        },
+        {
+          "item": "State function config",
+          "before": "AdaptableStateFunctionConfig.previousState: AdaptableState",
+          "after": "previousState: AdaptablePersistentState",
+          "autoMigrated": "n/a"
+        }
+      ],
+      "search": [
+        "AdaptableSaveStateFunction",
+        "AdaptablePersistStateFunction",
+        "AdaptableLoadStateFunction",
+        "AdaptableApplyStateFunction",
+        "AdaptableStateFunctionConfig"
+      ],
+      "always": false,
+      "note": "Re-annotate standalone state functions against AdaptablePersistentState; see State Options.",
+      "docs": "support/version-240-release-note#chg-objects-state-function-types"
+    }
+  ]
+}