Merge next into develop

.github/workflows/deployment-storybook.yml

@@ -24,6 +24,13 @@ jobs:
       - uses: actions/checkout@main
         with:
           fetch-depth: 0
+      - name: Workflow git state
+        run: |
+          echo github.ref: ${{ github.ref }}
+          echo github.event_name: ${{ github.event_name }}
+          echo github.actor: ${{ github.actor }}
+          git status
+          git log --oneline -1
       - uses: actions/setup-node@main
         with:
           node-version: "18"
@@ -32,7 +39,7 @@ jobs:
       - name: Create jest results
         run: yarn test:generate-output
       - name: Publish to Chromatic
-        uses: chromaui/action@v11
+        uses: chromaui/action@main
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
           projectToken: ${{ secrets.CHROMATIC_PROJECT_TOKEN }}

.storybook/main.js

@@ -64,7 +64,12 @@ module.exports = {
     },
     webpackFinal: async (config, { configType }) => {
         // `configType` has a value of 'DEVELOPMENT' or 'PRODUCTION'
-
+        if (configType === "PRODUCTION") {
+            // remove source maps from production storybook
+            // this may lead to errors when it is created via github workers
+            // reason is currently not known
+            config.devtool = false;
+        }
         config.module.rules = [
             {
                 test: /\.(png|jpg|gif|svg)(\\?.*)?$/,

CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 
 ## [Unreleased]
 
+## [25.0.0] - 2025-12-01
+
+This is a major release, and it might be not compatible with your current usage of our library. Please read about the necessary changes in the section about how to migrate.
+
+### Migration from v24 to v25
+
+-   remove deprecated components, properties and imports from your project, if the info cannot be found here then it was already mentioned in **Deprecated** sections of the past changelogs
+-   in case you set your own colors before importing GUI elements you need to update your configuration to the new color palette structure, see `README.md`
+-   change `intent="primary"` to `intent="accent"` for `<Button />`, `<IconButton />` and `<Spinner />`, if supported you may check if it is better to use `affirmative={true}` or `elevated={true}` instead of `intent`
+
 ### Added
 
 -   `<ChatContent />`
@@ -20,6 +30,115 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
     -   reduces HTML to simple text and can display it as one ellipsed line
 -   `<Tooltip />`
     -   prove useage of `usePlaceholder` by jest test coverage
+-   `<EdgeStraight />`
+    -   it's basically `<EdgeDefault />` without any special configs
+-   `<EdgeBezier />`
+    -   only supported for v12, in v9 as straight edge is used
+    -   use `curvature` property in the edge `data` object to define the bezier layout (0..1, default: 0.25)
+-   `<EdgeDefaultV12 />`
+    -   the `data` object provides `markerAppearance` to set and remove the edge arrows
+-   `<EdgeDefault />`
+    -   introduced the new `arrowDirection` property, including support for bidirectional edges - supported only for `<EdgeDefaultV12 />`
+-   `<EdgeNew />`
+    -   component for React Flow v12, displaying new connection lines
+-   `<VisualTour />`
+    -   component to display a visual tour multi-step tour of the current view
+-   `<Button />`
+    -   `accent` value for `intent` was added to align property with other components
+-   `<Spinner />`
+    -   `accent` value for `intent` was added to align property with other components
+    -   `elevated` property can be used to highlight the spinner, currently the `intent="accent"` display is used
+-   `<Modal />`:
+    -   Add `ModalContext` to track open/close state of all used application modals.
+    -   Add `modalId` property to give a modal a unique ID for tracking purposes.
+    -   `preventReactFlowEvents`: adds 'nopan', 'nowheel' and 'nodrag' classes to overlay classes in order to prevent react-flow to react to drag and pan actions in modals.
+    -   new `utils` methods
+    -   `colorCalculateDistance()`: calculates the difference between 2 colors using the simple CIE76 formula
+    -   `textToColorHash()`: calculates a color from a text string
+    -   `reduceToText`: shrinks HTML content and React elements to plain text, used for `<TextReducer />`
+    -   `decodeHtmlEntities`: decode a string of HTML text, map HTML entities back to UTF-8 chars
+-   SCSS color functions
+    -   `eccgui-color-var`: returns a var of a custom property used for palette color
+    -   `eccgui-color-mix`: mix 2 colors in `srgb`, works with all types of color values and CSS custom properties
+    -   `eccgui-color-rgba`: like `rgba()` but it works also for CSS custom properties
+-   Color palette: includes 4 sections with 20+ color tints in 5 weights each
+    -   indentity, semantic, layout, extra
+    -   managed via CSS custom properties
+    -   see `README.md` for more information about usage
+-   New icons
+    -   `artefact-task-sqlupdatequeryoperator`
+    -   `artefact-task-customsqlexecution`
+    -   `item-legend`
+    -   `operation-tour`
+    -   `toggler-carettop`
+    -   `toggler-caretleft`
+    -   `toggler-micon`
+    -   `toggler-micoff`
+    -   `toggler-radio`
+    -   `toggler-radio-checked`
+    -   `state-flagged`
+    -   `state-progress`
+    -   `state-progress-error`
+    -   `state-progress-warning`
+    -   more icons for build tasks
+
+### Removed
+
+-   support for React Flow v10 was completely removed
+-   removed direct replacements for legacy components (imported via `@eccenca/gui-elements/src/legacy-replacements` or `LegacyReplacements`)
+    -   `<AffirmativeButton />`, `<Button />`, `<DismissiveButton />`, `<DisruptiveButton />`, `<Checkbox />`, `<RadioButton />`, `<Tabs />`, `<TextField />`
+-   `<Button />`, `<FieldItem />`, `<FieldSet />`, `<MultiSuggestField />`
+    -   removed support for old state properties `hasStatePrimary`, `hasStateSuccess`, `hasStateWarning` and `hasStateDanger`
+-   `<Notification />`
+    -   removed support for old state properties `neutral`, `success`, `warning` and `danger`
+-   `<Icon />`
+    -   removed `description` and `iconTitle` properties
+-   `<OverviewItemList />`
+    -   `densityHigh` property was removed
+-   `<CodeEditor />`
+    -   static fallback for test id `codemirror-wrapper` was removed, add `data-test-id` (or your test id data attribute) always directly to `CodeEditor`.
+-   `<EdgeDefault />`
+    -   removed `inversePath` property, can be replaced with `arrowDirection: "inversed"` property
+-   `<Spinner />`
+    -   `description` property was removed because it was defined but not implemented for a very long time, but we plan to add that type of caption later
+-   `nodeTypes` and `edgeTypes` exports were removed
+    -   use `<ReactFlow />` with `configuration`, or define it yourself
+-   SCSS variables `$eccgui-color-application-text` and `$eccgui-color-application-background` were removed
+    -   use `$eccgui-color-workspace-text` and `$eccgui-color-workspace-background`
+-   Removed `remark-typograf` plugin from `<Markdown />` rendering to maintain display expectation
+
+### Fixed
+
+-   `<CodeAutocompleteField />`:
+    -   In multiline mode, validation errors might be highlighted incorrectly (relative line offset added).
+
+### Changed
+
+-   `<EdgeDefault />` and `<EdgeStep />`
+    -   support now v9 and v12 of react flow
+-   `<ReactFlowExtended />`
+    -   use `<EdgeNew />` by default for new connection lines, you can overwrite it by setting `connectionLineComponent` to `undefined`
+-   `<Spinner />`
+    -   `color` property does not accept `intent` values anymore
+-   `<OverflowText />`
+    -   beside explicitly specified properties it allows only basic HTML element properties and testing IDs
+-   overrite the native SCSS `rgba()` function, so it now works for SCSS color values and CSS custom properties
+-   `<SuggestField />`
+    -   Always add class 'nodrag' to popover content element to always prevent dragging of react-flow and dnd-kit elements when interacting with the component.
+-   `utils.getColorConfiguration()` works with CSS custom properties
+-   property names returned by `getColorConfiguration` were changed to kebab case because they are originally defined via CSS custom properties
+    -   e.g. `graphNode` is now `eccgui-graph-node` and `graphNodeBright` is `eccgui-graph-node-bright`
+-   `<Button />` and `<IconButton />`
+    -   `intent` display was aligned with other components, `intent="primary"` is now `intent="accent"`, in most cases it may be better to use `affirmative={true}` or `elevated={true}` instead of primary/accent intent
+-   `<Spinner />`
+    -   `intent` display was aligned with other components, `intent="primary"` is now `intent="accent"`, in most cases it may be better to use `elevated={true}` instead of using intent
+-   icons: arrow directions for `list-sortasc` and `list-sortdesc` were switched, up arrow is now used for ascending sort
+
+### Deprecated
+
+-   support for React Flow v9 will be removed in v26
+-   `<EdgeDefs />`
+    -   use `<ReactFlowMarkers />` or build it on single `<ReactFlowMarker />`
 
 ## [24.4.1] - 2025-08-25
 
@@ -129,6 +248,11 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 
 ### Changed
 
+-   `eslint` libraries were upgraded to v9, so `node` v18.18 or higher is required
+-   react flow integration by renaming their resources from `legacy` and `next` to more precise `v9` and `v10`:
+    -   `HandleProps`: renamed to `HandleV9Props`
+    -   `HandleNextProps`: renamed to `HandleV10Props`
+    -   if provided then the `flowVersion` property do not accept `legacy` and `next` as values anymore, use `v9` and `v10`
 -   some more interfaces are exposed:
     -   `IntentBlueprint`: BlueprintJS intent types, also available by `DefinitionsBlueprint`
     -   `TableDataContainerProps`, `TableSimpleContainerProps`, `TableHeadProps`, `TableBodyProps`, `TableExpandedRowProps`, `TableHeaderProps` and `DataTableRenderProps` as interfaces for diverse table components
@@ -151,6 +275,18 @@ Old bundlers like webpack4 do not support the `exports` field from `package.json
 
 If you use Jest then you can use the same aliases for the `moduleNameMapper` config, if necessary.
 
+### Deprecated
+
+-   `HandleV9Props` and `HandleV10Props` export will be removed, use only `HandleDefaultProps`
+-   `<NodeContent />`
+    -   `businessDate`: will be removed because it is already not used
+-   `<ReactFlow />`: use `<ReactFlowExtended />`
+
+### Migration from v24 to v25
+
+-   remove deprecated components, properties and imports from your project, if the info cannot be found here then it was already mentioned in **Deprecated** sections of the v24.\* changelogs.
+    -   we changed the integration of the supported react flow versions, formerly names `legacy` and `next` resources were renamed to more precise `v9` and `v10`, please see all info in the section about changes
+
 ## [24.1.0] - 2025-04-16
 
 ### Added
@@ -223,6 +359,8 @@ If you use Jest then you can use the same aliases for the `moduleNameMapper` con
     -   use always `<Label/>` component for `label` value
 -   `<StickyNoteNode />`
     -   Refactored data structure position and dimension (breaking change)
+-   `<MiniMap />`
+    -   component supports now React Flow v9 and v12
 
 ### Deprecated
 
@@ -422,8 +560,6 @@ This is a major release, and it might be not compatible with your current usage
 -   `<MultiSuggestField />`
     -   Updated the interface with the ability to use either `selectedItems` or `prePopulateWithItems` properties, which is more logical.
     -   Fixed deferred `selectedItems` setting.
--   `<StickyNoteModal/>`
-    -   static test id `data-test-id="sticky-note-modal"` will be removed with next major version
 -   `<BreadcrumbsList />`
     -   `onItemClick` handler is only executed if breadcrumb has `href` set because this is one callback parameter and the handler would not have any information otherwise
 -   `<Depiction />`
@@ -450,6 +586,8 @@ This is a major release, and it might be not compatible with your current usage
 
 -   `<TextArea />`
     -   `hasStatePrimary`, `hasStateSuccess`, `hasStateWarning` and `hasStateDanger` properties: use the `intent` property instead.
+-   `<StickyNoteModal/>`
+    -   static test id `data-test-id="sticky-note-modal"` will be removed with next major version
 
 ## [23.6.0] - 2024-04-17
 

README.md

@@ -28,22 +28,69 @@ yarn add --dev @types/carbon-components-react
 
 ### Configuration
 
-All [configuration variables](https://github.com/eccenca/gui-elements/blob/develop/src/configuration/_variables.scss) can be set before importing the full library or the default configuration but for the main changes you should need to change only a few parameters:
-
--   Basic colors
-    -   `$eccgui-color-primary`: color for very important buttons and switches
-    -   `$eccgui-color-primary-contrast`: readable text color used on primary color areas
-    -   `$eccgui-color-accent`: color for most conformation buttons, links, etc
-    -   `$eccgui-color-accent-contrast`: readable text color used on accent color areas
-    -   `$eccgui-color-applicationheader-text`
-    -   `$eccgui-color-applicationheader-background`
-    -   `$eccgui-color-workspace-text`
-    -   `$eccgui-color-workspace-background`
--   Basic sizes
-    -   `$eccgui-size-typo-base`: size including absolute unit, currently only `px` is supported
-    -   `$eccgui-size-typo-base-lineheight`: only ratio to font size, no unit!
-    -   `$eccgui-size-type-levelratio`: ratio without unit! used to calculate different text sizes based on `$eccgui-size-typo-base`
-    -   `$eccgui-size-block-whitespace`: white space between block level elements, currently only `px` is supported
+All [configuration variables](https://github.com/eccenca/gui-elements/blob/develop/src/configuration/_variables.scss) can be set before importing the full library or the default configuration but for the main properties you should need to change only a few parameters
+
+#### Colors
+
+Since v25 we use a color palette as basic foundation for color configurations. The palette is defined in 4 sections containing various color tints, each tint includes 5 different weights from 100 (light color) to 900 (dark color).
+
+The default palette can be overwritten if it is defined before the configuration or full library is imported to your Sass styles. The palette need to be defined entirely, we currently don't support overwriting it partly.
+
+```
+$eccgui-color-palette-light: (
+    "identity": (
+        "brand": #fae1cc #f8cd99 #f6b966 #f4a533 #f29100,
+        "accent": #e5f4fb #aecfe3 #77abca #4186b2 #0a6199,
+        "text": #f8f8f8 #bcbcbc #818181 #434343 #090909,
+        "background": #fff #e8e8e8 #d6d6d6 #d4d4d4 #d3d3d3,
+    ),
+    "semantic": (
+        "info": #e5f4fb #aecfe3 #77aaca #4086b2 #096199,
+        "success": #e8f5e9 #b2c6b4 #7c967e #466749 #103713,
+        "warning": #fff3e0 #fad2b3 #f5b287 #f0915a #eb702d,
+        "danger": #fff5f6 #edbfc0 #db8989 #c95253 #b71c1c,
+    ),
+    "layout": (
+        "yellow": #fff6d5 #f1ecb5 #e3db79 #d4c93c #c1a500,
+        "purple": #f4ddf3 #c8a2d1 #9d6eb8 #71378f #480e75,
+        "magenta": #ffd8e8 #f5a6c3 #e276a4 #be4c80 #59122d,
+        "pink": #fde4f1 #e6b4ce #d08aae #bb5f8e #711c4d,
+        "violet": #f4e3f4 #d8b0d8 #b377b3 #904490 #570057,
+        "indigo": #efe4fb #b89ee0 #8f72c5 #6547aa #3b1e8f,
+        "cyan": #dff9fc #86d6e5 #5abfd4 #2da9c4 #0092b3,
+        "teal": #d4f2ec #a3ddd3 #6dc0b2 #479d8d #104c42,
+        "lime": #cde0d6 #bce3c2 #9dcd99 #7ba66c #87b347,
+        "amber": #ffe7b8 #ffe9c4 #f9cd8d #eeb757 #ef8f00,
+        "vermilion": #ffd8cc #e4c4ba #b27a6b #8c4b3a #651c09,
+        "grey": #f5f6f7 #b7b7b7 #808080 #484848 #1c2329,
+    ),
+    "extra": (
+        "gold": #fff7d5 #ebd893 #dfc670 #d3b44e #c7a22b,
+        "silver": #f0f0f0 #dedede #ccc #bababa #a8a8a8,
+        "bronze": #fbe9db #f2d6bc #eac29d #e1af7e #d89b5f,
+    ),
+);
+```
+
+All palette colors will be transformed into CSS custom properties automatically and can be referenced by name scheme `--eccgui-color-palette-{groupname}-{colortint}-{colorweight}`, e.g. `--eccgui-color-palette-identity-brand-100`.
+
+All other colors are based on the palette but it is still possible to set them before the default values are used by importing the configuration or the full library.
+
+-   `$eccgui-color-primary`: color for very important buttons and switches
+-   `$eccgui-color-primary-contrast`: readable text color used on primary color areas
+-   `$eccgui-color-accent`: color for most conformation buttons, links, etc
+-   `$eccgui-color-accent-contrast`: readable text color used on accent color areas
+-   `$eccgui-color-applicationheader-text`
+-   `$eccgui-color-applicationheader-background`
+-   `$eccgui-color-workspace-text`
+-   `$eccgui-color-workspace-background`
+
+#### Sizes
+
+-   `$eccgui-size-typo-base`: size including absolute unit, currently only `px` is supported
+-   `$eccgui-size-typo-base-lineheight`: only ratio to font size, no unit!
+-   `$eccgui-size-type-levelratio`: ratio without unit! used to calculate different text sizes based on `$eccgui-size-typo-base`
+-   `$eccgui-size-block-whitespace`: white space between block level elements, currently only `px` is supported
 
 ## Development
 

package.json

@@ -1,7 +1,7 @@
 {
     "name": "@eccenca/gui-elements",
     "description": "GUI elements based on other libraries, usable in React application, written in Typescript.",
-    "version": "24.4.1",
+    "version": "25.0.0",
     "license": "Apache-2.0",
     "homepage": "https://github.com/eccenca/gui-elements",
     "bugs": "https://github.com/eccenca/gui-elements/issues",
@@ -73,6 +73,7 @@
         "@blueprintjs/select": "^5.3.19",
         "@carbon/icons": "^11.58.0",
         "@carbon/react": "^1.80.1",
+        "@codemirror/lang-html": "^6.4.9",
         "@codemirror/lang-javascript": "^6.2.3",
         "@codemirror/lang-json": "^6.0.1",
         "@codemirror/lang-markdown": "^6.3.2",
@@ -86,18 +87,17 @@
         "codemirror": "^6.0.1",
         "color": "^4.2.3",
         "compute-scroll-into-view": "^3.1.1",
+        "he": "^1.2.0",
         "jshint": "^2.13.6",
         "lodash": "^4.17.21",
         "n3": "^1.25.1",
         "re-resizable": "^6.10.3",
         "react": "^16.13.1",
         "react-dom": "^16.14.0",
         "react-flow-renderer": "9.7.4",
-        "react-flow-renderer-lts": "npm:react-flow-renderer@^10.3.17",
         "react-inlinesvg": "^3.0.3",
         "react-is": "^16.13.1",
         "react-markdown": "^10.1.0",
-        "react-markdown-deprecated": "npm:react-markdown@^8.0.7",
         "react-syntax-highlighter": "^15.6.1",
         "rehype-external-links": "^3.0.0",
         "rehype-raw": "^7.0.0",
@@ -135,6 +135,7 @@
         "@testing-library/react": "^12.1.5",
         "@types/codemirror": "^5.60.15",
         "@types/color": "^3.0.6",
+        "@types/he": "^1.2.3",
         "@types/jest": "^29.5.14",
         "@types/jshint": "^2.12.4",
         "@types/lodash": "^4.17.16",
@@ -151,8 +152,8 @@
         "eslint-plugin-simple-import-sort": "^12.1.1",
         "husky": "4",
         "identity-obj-proxy": "^3.0.0",
-        "jest": "^30.0.5",
-        "jest-environment-jsdom": "^30.0.5",
+        "jest": "^30.2.0",
+        "jest-environment-jsdom": "^30.2.0",
         "jest-pnp-resolver": "^1.2.3",
         "lint-staged": "^15.5.1",
         "node-sass-package-importer": "^5.3.3",

src/_shame.scss

@@ -51,6 +51,6 @@ textarea:focus-visible {
 }
 
 :focus-visible {
-    outline: rgba($eccgui-color-accent, $eccgui-opacity-muted) solid 2px;
+    outline: eccgui-color-rgba($eccgui-color-accent, $eccgui-opacity-muted) solid 2px;
     outline-offset: 1px;
 }

src/cmem/ContentBlobToggler/StringPreviewContentBlobToggler.tsx

@@ -83,4 +83,4 @@ function firstNonEmptyLine(preview: string) {
 
 export const stringPreviewContentBlobTogglerUtils = {
     firstNonEmptyLine,
-};
+};

src/cmem/markdown/Markdown.stories.tsx

@@ -1,5 +1,4 @@
 import React from "react";
-import { Blockquote } from "@blueprintjs/core";
 import { Meta, StoryFn } from "@storybook/react";
 
 import { Markdown } from "./../../../index";