@ssa-ui-kit/core 3.8.0 → 3.9.0

package/dist/types/emotion.d.ts

@@ -12,6 +12,7 @@ type Colors = MakeColors<[
     'white30',
     'dark',
     'greyLighter',
+    'greenLighterRGB',
     'greyLighter20',
     'greyLighter40',
     'greyLighter60',
@@ -52,6 +53,7 @@ type Colors = MakeColors<[
     'redLighter40',
     'red',
     'red6',
+    'red6RGB',
     'redDark',
     'red40',
     'greenLighter',
@@ -78,6 +80,7 @@ type Colors = MakeColors<[
     'yellow20',
     'yellowLighter',
     'yellowLighter20',
+    'yellowLighter20RGB',
     'yellowLighter40',
     'yellowWarm',
     'yellowWarm20',
@@ -97,6 +100,7 @@ type Colors = MakeColors<[
     'purpleDark40',
     'blue',
     'blue6',
+    'blue6RGB',
     'blue20',
     'blueCool',
     'blueDark',

package/dist/utils/colorUtils.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Color utilities shared by notification components (`Alert`, `Toast`, …).
+ *
+ * Used by any component that accepts a `color` prop and needs to auto-derive
+ * readable text/icon colors, darkened border/accent shades, or luminance checks.
+ *
+ * Theme colors are `rgba(r, g, b, a)` strings. Arbitrary CSS colors passed by
+ * consumers may be hex (`#rrggbb`) or any valid CSS color. Functions here handle
+ * both formats and fall back gracefully (returning the original string) for
+ * formats they cannot parse.
+ */
+/**
+ * Returns `true` when the color is perceptually dark enough to need light
+ * text/icons on top of it.
+ *
+ * Uses the WCAG luminance threshold (L < 0.179 ≈ midpoint between black and
+ * "mid-grey" at contrast ratio ~3:1 against white).
+ */
+export declare function isColorDark(color: string): boolean;
+/**
+ * Returns a darkened version of the color by **reducing HSL lightness** by
+ * `amount` (default 0.35 → 35 percentage points darker).
+ *
+ * Converting through HSL preserves the hue and saturation so light pastel
+ * colors (e.g. `greenLighter`) darken to a recognizable mid-shade of the same
+ * hue rather than washing out to grey (which a naïve per-channel multiply does).
+ *
+ * Falls back to the original string when the color format is not parsable
+ * (e.g. CSS named colors, `hsl()`, `color-mix()`).
+ */
+export declare function darkenColor(color: string, amount?: number): string;
+/**
+ * Returns either `'rgba(255, 255, 255, 1)'` (white) or `'rgba(43, 45, 49, 1)'`
+ * (greyDarker) depending on whether the background color is perceived as dark
+ * or light.
+ *
+ * Intended for computing readable text/icon colors on a custom background.
+ *
+ * @param bgColor - The background color to contrast against.
+ * @param darkText - The dark text color to use on light backgrounds.
+ *                   Defaults to `rgba(43, 45, 49, 1)` (theme `greyDarker`).
+ * @param lightText - The light text color to use on dark backgrounds.
+ *                    Defaults to `rgba(255, 255, 255, 1)` (white).
+ */
+export declare function getContrastColor(bgColor: string, darkText?: string, lightText?: string): string;

package/dist/utils/createObserver.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Creates a lightweight pub/sub observer.
+ *
+ * Subscribers are stored in a Map keyed by a caller-provided string identifier,
+ * so a single mount point can subscribe once and cleanly unsubscribe by key
+ * without affecting other subscribers.
+ *
+ * @example
+ * ```ts
+ * const myObserver = createObserver<{ message: string }>();
+ *
+ * myObserver.subscribe('my-component', (data) => console.log(data.message));
+ * myObserver.dispatch({ message: 'Hello' });
+ * myObserver.unsubscribe('my-component');
+ * ```
+ */
+export declare function createObserver<T>(): {
+    subscribe: (key: string, fn: (data: T) => void) => void;
+    unsubscribe: (key: string) => void;
+    dispatch: (data: T) => void;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssa-ui-kit/core",
-  "version": "3.8.0",
+  "version": "3.9.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -39,8 +39,8 @@
     "luxon": "3.5.0",
     "plotly.js": "3.0.0",
     "react-plotly.js": "2.6.0",
-    "@ssa-ui-kit/hooks": "^3.8.0",
-    "@ssa-ui-kit/utils": "^3.8.0"
+    "@ssa-ui-kit/hooks": "^3.9.0",
+    "@ssa-ui-kit/utils": "^3.9.0"
   },
   "devDependencies": {
     "@emotion/css": "11.13.5",