@milaboratories/uikit 2.2.37 → 2.2.38

package/dist/src/colors/__tests__/colors.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/colors/color.d.ts

@@ -0,0 +1,44 @@
+import { type CategoricalColor } from './palette';
+/**
+ * Represents a color with red, green, blue, and alpha channels.
+ * Provides methods to convert to HEX and RGBA formats.
+ *
+ * @param {number} r - Red channel (0-255).
+ * @param {number} g - Green channel (0-255).
+ * @param {number} b - Blue channel (0-255).
+ * @param {number} [a=1] - Alpha channel (0-1).
+ */
+export declare function Color(r: number, g: number, b: number, a?: number): {
+    readonly r: number;
+    readonly g: number;
+    readonly b: number;
+    readonly a: number;
+    readonly hex: string;
+    readonly rgba: string;
+    toString(): string;
+    toJSON(): string;
+};
+export declare namespace Color {
+    var fromHex: (hex: string) => Color;
+    var fromString: (str: string) => {
+        readonly r: number;
+        readonly g: number;
+        readonly b: number;
+        readonly a: number;
+        readonly hex: string;
+        readonly rgba: string;
+        toString(): string;
+        toJSON(): string;
+    };
+    var categorical: (name: CategoricalColor) => {
+        readonly r: number;
+        readonly g: number;
+        readonly b: number;
+        readonly a: number;
+        readonly hex: string;
+        readonly rgba: string;
+        toString(): string;
+        toJSON(): string;
+    };
+}
+export type Color = ReturnType<typeof Color>;

package/dist/src/colors/gradient.d.ts

@@ -0,0 +1,69 @@
+import type { Palette } from './palette';
+import { Color } from './color';
+export type GradientSource = (string | Color)[] | Palette;
+/**
+ * Interpolates between two colors.
+ *
+ * @param {Color} color1 - Start color.
+ * @param {Color} color2 - End color.
+ * @param {number} t - Interpolation factor [0, 1].
+ * @returns {Color} Interpolated color.
+ */
+export declare function interpolateColor(color1: Color, color2: Color, t: number): Color;
+/**
+ * Normalizes a gradient definition into an array of Color objects.
+ *
+ * @param {GradientSource} raw - A gradient defined as an array of strings, Colors, or a Palette.
+ * @returns {Color[]} Array of normalized Color objects.
+ */
+export declare function normalizeGradient(raw: GradientSource): Color[];
+/**
+ * Creates a gradient with utilities to sample or split colors.
+ */
+export declare function Gradient(gradient: GradientSource): {
+    readonly colors: Color[];
+    /**
+     * Samples a color at a specific point in the gradient.
+     *
+     * @param {number} t - A value in [0, 1] representing the position in the gradient.
+     */
+    fromInterval(t: number): {
+        readonly r: number;
+        readonly g: number;
+        readonly b: number;
+        readonly a: number;
+        readonly hex: string;
+        readonly rgba: string;
+        toString(): string;
+        toJSON(): string;
+    };
+    /**
+     * Gets the nth color in a gradient divided into segments.
+     *
+     * @param {number} n - Index of the color (1-based).
+     * @param {number} segments - Total number of segments.
+     */
+    getNthOf(n: number, segments: number): {
+        readonly r: number;
+        readonly g: number;
+        readonly b: number;
+        readonly a: number;
+        readonly hex: string;
+        readonly rgba: string;
+        toString(): string;
+        toJSON(): string;
+    };
+    /**
+     * Splits the gradient into n evenly spaced colors.
+     */
+    split(n: number): {
+        readonly r: number;
+        readonly g: number;
+        readonly b: number;
+        readonly a: number;
+        readonly hex: string;
+        readonly rgba: string;
+        toString(): string;
+        toJSON(): string;
+    }[];
+};

package/dist/src/colors/index.d.ts

@@ -0,0 +1,3 @@
+export * from './palette';
+export * from './color';
+export * from './gradient';

package/dist/src/colors/palette.d.ts

@@ -0,0 +1,55 @@
+/**
+ * good for age range // from newborn → to old
+ */
+export declare const viridis: string[];
+/**
+ * from light → to hard (errors)
+ */
+export declare const magma: string[];
+export declare const palettes: {
+    viridis: string[];
+    magma: string[];
+    density: string[];
+    salinity: string[];
+    sunset: string[];
+    rainbow: string[];
+    spectrum: string[];
+    teal_red: string[];
+    blue_red: string[];
+    lime_rose: string[];
+    viridis_magma: string[];
+};
+export type Palette = keyof typeof palettes;
+/**
+ * Just named colors
+ */
+export declare const categoricalColors: {
+    green_light: string;
+    green_bright: string;
+    green_dark: string;
+    violet_light: string;
+    violet_bright: string;
+    violet_dark: string;
+    orange_light: string;
+    orange_bright: string;
+    orange_dark: string;
+    teal_light: string;
+    teal_bright: string;
+    teal_dark: string;
+    rose_light: string;
+    rose_bright: string;
+    rose_dark: string;
+    lime_light: string;
+    lime_bright: string;
+    lime_dark: string;
+    blue_light: string;
+    blue_bright: string;
+    blue_dark: string;
+    red_light: string;
+    red_bright: string;
+    red_dark: string;
+    grey_light: string;
+    grey_bright: string;
+    grey_dark: string;
+};
+export type CategoricalColor = keyof typeof categoricalColors;

package/dist/src/components/PlChartStackedBar/Legends.vue.d.ts

@@ -0,0 +1,10 @@
+import type { Color } from '../../colors';
+type __VLS_Props = {
+    maxInColumn?: number;
+    legends: {
+        color: string | Color;
+        text: string;
+    }[];
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/PlChartStackedBar/PlChartStackedBar.vue.d.ts

@@ -0,0 +1,6 @@
+import type { PlChartStackedBarSettings } from './types';
+type __VLS_Props = {
+    settings: PlChartStackedBarSettings;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/PlChartStackedBar/StackedRow.vue.d.ts

@@ -0,0 +1,8 @@
+import type { PlChartStackedBarSegment } from './types';
+type __VLS_Props = {
+    value: PlChartStackedBarSegment[];
+    height?: number;
+    showFractionInLabel?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/PlChartStackedBar/index.d.ts

@@ -0,0 +1,2 @@
+export { default as PlChartStackedBar } from './PlChartStackedBar.vue';
+export * from './types';

package/dist/src/components/PlChartStackedBar/types.d.ts

@@ -0,0 +1,29 @@
+import type { Color } from '../../colors';
+export type PlChartStackedBarSegment = {
+    value: number;
+    label: string;
+    description?: string;
+    color: string | Color;
+};
+export type PlChartStackedBarSettings = {
+    /**
+     * The title of the chart.
+     * This will be displayed at the top of the chart, if provided.
+     */
+    title?: string;
+    /**
+     * The data to be displayed in the chart.
+     * Each entry represents a segment of a stacked bar.
+     */
+    data: PlChartStackedBarSegment[];
+    /**
+     * The maximum number of legends displayed in a single column.
+     * Defaults to 5 if not specified.
+     */
+    maxLegendsInColumn?: number;
+    /**
+     * Whether to show legends for the chart.
+     * Defaults to `true` if not specified.
+     */
+    showLegends?: boolean;
+};

package/dist/src/index.d.ts

@@ -52,6 +52,8 @@ export * from './components/PlMaskIcon16';
 export * from './components/PlMaskIcon24';
 export * from './components/PlIcon16';
 export * from './components/PlIcon24';
+export * from './components/PlChartStackedBar';
+export * from './colors';
 import DropdownListItem from './components/DropdownListItem.vue';
 import ContextProvider from './components/ContextProvider.vue';
 import Slider from './components/Slider.vue';