@kubit-ui-web/react-charts 1.9.0 → 1.10.0

package/dist/types/types/focusConfig.type.d.ts

@@ -1,11 +1,15 @@
 /**
  * Configuration for the focus effect.
  *
+ * **Important**: All numeric values (stroke widths and gap) are relative to the SVG viewBox coordinate system,
+ * not pixel values. This means the same values may appear different in size depending on the chart's viewBox dimensions.
+ * For example, a value of 2 in a chart with viewBox 200x200 will appear larger than the same value in a chart with viewBox 100x80.
+ *
  * - `outlineColor` - Color of the outer outline when focused. Defaults to #0078D7.
- * - `outlineStrokeWidth` - Stroke width of the outer outline. Defaults to 2.
+ * - `outlineStrokeWidth` - Stroke width of the outer outline (viewBox-relative). Defaults to 2.
  * - `innerColor` - Color of the inner outline when focused. Defaults to #FFFFFF.
- * - `innerStrokeWidth` - Stroke width of the inner outline. Defaults to 2.
- * - `gap` - Gap between the element and the focus rings. Defaults to 0.
+ * - `innerStrokeWidth` - Stroke width of the inner outline (viewBox-relative). Defaults to 2.
+ * - `gap` - Gap between the element and the focus rings (viewBox-relative). Defaults to 0.
  *   Note: Only applies when variant is 'bounding-box'. Ignored in 'adaptive' mode.
  * - `variant` - Focus ring rendering mode. Defaults to 'adaptive'.
  *   - 'adaptive': Ring follows the exact shape of the element (circle → circular ring, path → path ring)
@@ -13,10 +17,12 @@
  */
 export interface FocusConfig {
     outlineColor?: string;
+    /** Stroke width in viewBox coordinate units (not pixels) */
     outlineStrokeWidth?: number;
     innerColor?: string;
+    /** Stroke width in viewBox coordinate units (not pixels) */
     innerStrokeWidth?: number;
-    /** Only applicable when variant is 'bounding-box' */
+    /** Gap in viewBox coordinate units (not pixels). Only applicable when variant is 'bounding-box' */
     gap?: number;
     variant?: 'adaptive' | 'bounding-box';
 }
@@ -25,11 +31,11 @@ export declare const FOCUS_DEFAULT: {
     readonly FOCUS_COLOR: "#0078D4";
     /** Focus ring inner border */
     readonly FOCUS_INNER: "#ffffff";
-    /** Focus ring inner stroke width */
+    /** Focus ring inner stroke width (viewBox-relative units) */
     readonly INNER_FOCUS_STROKE_WIDTH: 2;
-    /** Focus ring outer stroke width */
+    /** Focus ring outer stroke width (viewBox-relative units) */
     readonly OUTER_FOCUS_STROKE_WIDTH: 2;
-    /** Gap between element and outlines (only applies in bounding-box variant) */
+    /** Gap between element and outlines in viewBox-relative units (only applies in bounding-box variant) */
     readonly OUTLINES_GAP: 0;
     /** Focus ring rendering variant */
     readonly VARIANT: "adaptive";

package/dist/types/types/focusConfig.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focusConfig.type.d.ts","sourceRoot":"","sources":["../../../src/types/focusConfig.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;CACvC;AAED,eAAO,MAAM,aAAa;IACxB,uBAAuB;;IAEvB,8BAA8B;;IAE9B,oCAAoC;;IAEpC,oCAAoC;;IAEpC,8EAA8E;;IAE9E,mCAAmC;;CAE3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,WAAW,KAAG,QAAQ,CAAC,WAAW,CAO7E,CAAC"}
+{"version":3,"file":"focusConfig.type.d.ts","sourceRoot":"","sources":["../../../src/types/focusConfig.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mGAAmG;IACnG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;CACvC;AAED,eAAO,MAAM,aAAa;IACxB,uBAAuB;;IAEvB,8BAA8B;;IAE9B,6DAA6D;;IAE7D,6DAA6D;;IAE7D,wGAAwG;;IAExG,mCAAmC;;CAE3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,WAAW,KAAG,QAAQ,CAAC,WAAW,CAO7E,CAAC"}

package/dist/types/utils/adaptLegacyFocusConfig/adaptLegacyFocusConfig.d.ts

@@ -0,0 +1,20 @@
+import { StyleProps } from '../../components/path/path.types';
+import { FocusConfig } from '../../types/focusConfig.type';
+/**
+ * Adapts legacy StyleProps focusConfig to the new FocusConfig format.
+ *
+ * Only maps properties that have semantic equivalence:
+ * - `stroke` → `outlineColor` (color of the focus ring outline)
+ * - `strokeWidth` → `outlineStrokeWidth` and `innerStrokeWidth` (width of both focus rings)
+ *
+ * Other StyleProps properties (fill, fillOpacity, strokeDasharray, etc.) are ignored
+ * as they don't have meaningful equivalents in the new FocusRing component.
+ *
+ * @deprecated This adapter exists for backward compatibility only.
+ * It will be removed in the next major version along with the legacy focusConfig prop.
+ *
+ * @param legacy - Legacy focusConfig using StyleProps interface
+ * @returns FocusConfig compatible object, or undefined if no legacy config provided
+ */
+export declare const adaptLegacyFocusConfig: (legacy?: StyleProps) => FocusConfig | undefined;
+//# sourceMappingURL=adaptLegacyFocusConfig.d.ts.map

package/dist/types/utils/adaptLegacyFocusConfig/adaptLegacyFocusConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptLegacyFocusConfig.d.ts","sourceRoot":"","sources":["../../../../src/utils/adaptLegacyFocusConfig/adaptLegacyFocusConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,UAAU,KAAG,WAAW,GAAG,SAU1E,CAAC"}

package/dist/types/utils/adaptLegacyFocusConfig/index.d.ts

@@ -0,0 +1,2 @@
+export { adaptLegacyFocusConfig } from './adaptLegacyFocusConfig';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/adaptLegacyFocusConfig/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/adaptLegacyFocusConfig/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubit-ui-web/react-charts",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "private": false,
   "main": "dist/kubit-ui-web-react-charts.cjs.js",
   "module": "dist/kubit-ui-web-react-charts.es.js",