@synerise/ds-alert 1.1.61 → 1.1.62

package/CHANGELOG.md

@@ -3,6 +3,10 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.1.62](https://github.com/Synerise/synerise-design/compare/@synerise/ds-alert@1.1.61...@synerise/ds-alert@1.1.62) (2026-07-23)
+
+**Note:** Version bump only for package @synerise/ds-alert
+
 ## [1.1.61](https://github.com/Synerise/synerise-design/compare/@synerise/ds-alert@1.1.60...@synerise/ds-alert@1.1.61) (2026-07-16)
 
 **Note:** Version bump only for package @synerise/ds-alert

package/CLAUDE.md

@@ -0,0 +1,101 @@
+# Alert (`@synerise/ds-alert`)
+
+> **DEPRECATED PACKAGE.** Do not add new usages. Four purpose-built replacement packages exist; see migration table below.
+
+## Migration
+
+| Export from `@synerise/ds-alert` | Replacement |
+|----------------------------------|-------------|
+| `Toast` | `@synerise/ds-toast` |
+| `BroadcastBar` | `@synerise/ds-broadcast-bar` |
+| `InlineAlert` / `IconAlert` | `@synerise/ds-inline-alert` |
+| `SectionMessage` | `@synerise/ds-section-message` |
+| `AlertInfo` | `@synerise/ds-result` (discouraged — no direct replacement yet) |
+| `Alert` (default) | `@synerise/ds-section-message` or `@synerise/ds-toast` depending on use case |
+| `AlertSemanticColor` | No direct replacement — use discouraged |
+
+## Package structure
+
+```
+src/
+  Alert.tsx                    — main Alert component (Ant Design wrapper, deprecated)
+  Alert.types.ts               — AlertType, Props (extends antd AlertProps)
+  Alert.styles.tsx             — AntdAlert, AlertContent, AlertMessage, AlertDescription
+  index.ts                     — all exports
+  InlineAlert/                 — thin wrapper → @synerise/ds-inline-alert
+  IconAlert/                   — re-export → @synerise/ds-inline-alert (deprecated)
+  SectionMessage/              — re-export → @synerise/ds-section-message (deprecated)
+  BroadcastBar/                — re-export → @synerise/ds-broadcast-bar (deprecated)
+  Toast/                       — standalone toast (deprecated, use @synerise/ds-toast)
+  AlertInfo/                   — full-page status illustration component (discouraged)
+  ColorSemantic/               — semantic color icon box (no replacement, discouraged)
+```
+
+## Public exports
+
+### `Alert` (default) — **deprecated**
+
+Wraps Ant Design `Alert`. Extends `antd/AlertProps` with:
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `type` | `'success' \| 'warning' \| 'error' \| 'info'` | — | **Required.** Semantic type |
+| `message` | `ReactNode` | `undefined` | Alert message content |
+| `color` | `'blue' \| 'grey' \| 'red' \| 'green' \| 'yellow' \| 'pink' \| 'mars' \| 'orange' \| 'fern' \| 'cyan' \| 'purple' \| 'violet'` | `undefined` | Colour override |
+| `mode` | `'background' \| 'background-outline' \| 'outline' \| 'clear'` | `undefined` | Visual style mode |
+| `showMoreLabel` | `ReactNode` | `undefined` | Label for "show more" link |
+| `onShowMore` | `() => void` | `undefined` | "Show more" click handler |
+
+Has `Alert.InlineAlert` sub-component (forwards to `InlineAlert`).
+
+### `Toast` — **deprecated**, use `@synerise/ds-toast`
+
+Standalone toast notification. Extends `antd/AlertProps` with extensive colour and expand props. See source `Toast.types.ts` for full prop list.
+
+### `InlineAlert` — **deprecated**, use `@synerise/ds-inline-alert`
+
+Thin wrapper around `@synerise/ds-inline-alert`. Props: `type: 'success' | 'alert' | 'warning' | 'info'`, `message: ReactNode`.
+
+### `SectionMessage` — **deprecated**, use `@synerise/ds-section-message`
+
+Direct re-export from `@synerise/ds-section-message`.
+
+### `BroadcastBar` — **deprecated**, use `@synerise/ds-broadcast-bar`
+
+Direct re-export from `@synerise/ds-broadcast-bar`.
+
+### `IconAlert` — **deprecated**, use `@synerise/ds-inline-alert`
+
+Alias for `InlineAlert`. Re-exports from `@synerise/ds-inline-alert`.
+
+### `AlertInfo` — **discouraged**, no direct replacement
+
+Full-page status illustration (icon + text + optional button). Props: `type`, `size` (`AlertSize.SMALL`=48px | `AlertSize.MEDIUM`=96px), `label`, `labelPosition`, `text`, `button`, `fontSize`, `mode`.
+
+### `AlertSemanticColor` — **discouraged**, no direct replacement
+
+100×100 px coloured icon box with 8 semantic types and 4 visual modes. Not exported from `index.ts` — only accessible via deep import.
+
+### `AlertStyles`
+
+```ts
+{ Alert: typeof MainAlertStyles, Toast: typeof ToastStyles }
+```
+
+Exported for consumers that need to extend styles. `AlertMessage` from `Alert.styles` is also exported directly (deprecated — use `AlertStyles.Alert` instead).
+
+### `AlertSize`
+
+```ts
+enum AlertSize { SMALL = 48, MEDIUM = 96 }
+```
+
+Used by `AlertInfo`.
+
+## Implementation notes
+
+- `SectionMessage`, `BroadcastBar`, and `IconAlert` are **one-line re-exports** — they add no logic, just re-export from their respective packages.
+- `InlineAlert` has its own thin styled wrapper (`InlineAlert.styles.ts`) on top of `@synerise/ds-inline-alert` — the styles may diverge from the source package.
+- `Toast` is a **full standalone implementation** (not a re-export). It uses `animate.css` keyframe animations and Ant Design `Alert` as its base. It is **not** a re-export of `@synerise/ds-toast`.
+- `Alert` default icons are `Check2M` (success), `Close2M` (error), `NotificationsM` (warning/info) from `@synerise/ds-icon`.
+- Ant Design 4.x (`antd ^4.24.16`) is a peer dependency — this package is tied to antd 4.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synerise/ds-alert",
-  "version": "1.1.61",
+  "version": "1.1.62",
   "description": "Alert UI Component for the Synerise Design System",
   "license": "ISC",
   "repository": "Synerise/synerise-design",
@@ -17,6 +17,7 @@
   "files": [
     "/dist",
     "CHANGELOG.md",
+    "CLAUDE.md",
     "README.md",
     "package.json",
     "LICENSE.md"
@@ -41,13 +42,13 @@
   ],
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@synerise/ds-broadcast-bar": "^1.1.28",
-    "@synerise/ds-button": "^1.5.34",
-    "@synerise/ds-icon": "^1.18.4",
-    "@synerise/ds-inline-alert": "^1.1.27",
-    "@synerise/ds-section-message": "^1.0.38",
-    "@synerise/ds-unordered-list": "^1.1.53",
-    "@synerise/ds-utils": "^1.10.1",
+    "@synerise/ds-broadcast-bar": "^1.1.29",
+    "@synerise/ds-button": "^1.5.35",
+    "@synerise/ds-icon": "^1.18.5",
+    "@synerise/ds-inline-alert": "^1.1.28",
+    "@synerise/ds-section-message": "^1.0.39",
+    "@synerise/ds-unordered-list": "^1.1.54",
+    "@synerise/ds-utils": "^1.10.2",
     "animate.css": "^4.1.1"
   },
   "peerDependencies": {
@@ -57,5 +58,5 @@
     "styled-components": "^5.3.3",
     "vitest": "4"
   },
-  "gitHead": "a81ab6519d49a3dea9c0cfebcdc9104cbb4f4226"
+  "gitHead": "d0a43cc43d8528a36f105aceea52ab470edb71d9"
 }