@promptbook/javascript 0.111.0-3 → 0.111.0-7

package/umd/src/utils/DEFAULT_THINKING_MESSAGES.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Default placeholder variants shown when an agent is still composing a response.
+ *
+ * @private BUT maybe export via some package
+ */
+export declare const DEFAULT_THINKING_MESSAGES: readonly ["Thinking...", "Searching for information...", "Sorting information..."];
+/** @internal */
+export type ThinkingMessageVariant = (typeof DEFAULT_THINKING_MESSAGES)[number];

package/umd/src/utils/agents/resolveAgentAvatarImageUrl.d.ts

@@ -0,0 +1,29 @@
+import type { AgentBasicInformation } from '../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_url, string_url_image } from '../../types/typeAliases';
+/**
+ * Options for resolving agent avatar URLs.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type ResolveAgentAvatarImageUrlOptions = {
+    /**
+     * Agent metadata used for avatar resolution.
+     */
+    readonly agent: Pick<AgentBasicInformation, 'agentName' | 'permanentId' | 'meta'>;
+    /**
+     * Optional base URL used to resolve relative meta images and placeholders.
+     */
+    readonly baseUrl?: string_url;
+};
+/**
+ * Resolve the fallback avatar URL for an agent.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function resolveAgentAvatarFallbackUrl(options: ResolveAgentAvatarImageUrlOptions): string_url_image | null;
+/**
+ * Resolve the best avatar URL for an agent, preferring META IMAGE and falling back to placeholders.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function resolveAgentAvatarImageUrl(options: ResolveAgentAvatarImageUrlOptions): string_url_image | null;

package/umd/src/utils/clientVersion.d.ts

@@ -0,0 +1,65 @@
+/**
+ * HTTP header used by Promptbook clients to advertise their release version.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare const CLIENT_VERSION_HEADER = "x-promptbook-client-version";
+/**
+ * The latest client (engine) version that the server expects.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare const CLIENT_LATEST_VERSION: string;
+/**
+ * Determines if the provided version string exactly matches the latest release.
+ *
+ * @param version - Version string obtained from a request header.
+ * @returns True when the version equals `CLIENT_LATEST_VERSION`.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function isClientVersionCompatible(version: unknown): version is string;
+/**
+ * Formats the message that should be shown when a client is out of date.
+ *
+ * @param clientVersion - The version reported by the client (optional).
+ * @returns User-facing text explaining how to fix the mismatch.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function formatClientVersionMismatchMessage(clientVersion?: string | null): string;
+/**
+ * Error thrown when the client version does not match the server requirements.
+ *
+ * @param requiredVersion - Version enforced by the server.
+ * @param reportedVersion - Version reported by the client (optional).
+ * @param message - Optional human-readable message describing the mismatch.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare class ClientVersionMismatchError extends Error {
+    readonly requiredVersion: string;
+    readonly reportedVersion: string | null;
+    constructor(requiredVersion: string, reportedVersion: string | null, message?: string);
+}
+/**
+ * Creates a headers object that includes the client version header.
+ *
+ * @param headers - Optional base headers to clone.
+ * @returns New headers object augmented with `CLIENT_VERSION_HEADER`.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function attachClientVersionHeader<T extends Record<string, string> = Record<string, string>>(headers?: T): T & Record<typeof CLIENT_VERSION_HEADER, string>;
+/**
+ * Normalizes the client version reported inside a `HeadersInit` object.
+ *
+ * @param headers - Headers collection to read from.
+ * @returns The trimmed client version or `null` when it is missing.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function getClientVersionFromHeaders(headers?: HeadersInit): string | null;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/umd/src/utils/color/$randomColor.d.ts

@@ -0,0 +1,12 @@
+import { Color } from './Color';
+/**
+ * Creates a random color
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function $randomColor(): Color;
+/**
+ * TODO: !! Use Internally Color.fromValues
+ * TODO: !! randomColorWithAlpha
+ * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+ */

package/umd/src/utils/color/Color.d.ts

@@ -0,0 +1,158 @@
+import type { string_color, string_url_image } from '../../types/typeAliases';
+import type { WithTake } from '../take/interfaces/ITakeChain';
+import { CSS_COLORS } from './css-colors';
+/**
+ * Color object represents an RGB color with alpha channel
+ *
+ * Note: There is no fromObject/toObject because the most logical way to serialize color is as a hex string (#009edd)
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare class Color {
+    readonly red: number;
+    readonly green: number;
+    readonly blue: number;
+    readonly alpha: number;
+    /**
+     * Creates a new Color instance from miscellaneous formats
+     * - It can receive Color instance and just return the same instance
+     * - It can receive color in string format for example `#009edd`, `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`, `hsl(197.1,100%,43.3%)`
+     *
+     * Note: This is not including fromImage because detecting color from an image is heavy task which requires async stuff and we cannot safely determine with overloading if return value will be a promise
+     *
+     * @param color
+     * @returns Color object
+     */
+    static from(color: string_color | Color, _isSingleValue?: boolean): WithTake<Color>;
+    /**
+     * Creates a new Color instance from miscellaneous formats
+     * It just does not throw error when it fails, it returns PROMPTBOOK_COLOR instead
+     *
+     * @param color
+     * @returns Color object
+     */
+    static fromSafe(color: string_color | Color): WithTake<Color>;
+    /**
+     * Creates a new Color instance from miscellaneous string formats
+     *
+     * @param color as a string for example `#009edd`, `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`, `hsl(197.1,100%,43.3%)`, `red`, `darkgrey`,...
+     * @returns Color object
+     */
+    static fromString(color: string_color): WithTake<Color>;
+    /**
+     * Gets common color
+     *
+     * @param key as a css string like `midnightblue`
+     * @returns Color object
+     */
+    static get(key: keyof typeof CSS_COLORS): WithTake<Color>;
+    /**
+     * Creates a new Color instance from average color of given image
+     *
+     * @param image as a source for example `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAAXNSR0IArs4c6QAAAA1JREFUGFdjYJh39z8ABJgCe/ZvAS4AAAAASUVORK5CYII=`
+     * @returns Color object
+     */
+    static fromImage(image: string_url_image): Promise<Color>;
+    /**
+     * Creates a new Color instance from color in hex format
+     *
+     * @param color in hex for example `#009edd`, `009edd`, `#555`,...
+     * @returns Color object
+     */
+    static fromHex(hex: string_color): WithTake<Color>;
+    /**
+     * Creates a new Color instance from color in hsl format
+     *
+     * @param color as a hsl for example `hsl(197.1,100%,43.3%)`
+     * @returns Color object
+     */
+    static fromHsl(hsl: string_color): WithTake<Color>;
+    /**
+     * Creates a new Color instance from color in rgb format
+     *
+     * @param color as a rgb for example `rgb(0,158,221)`, `rgb(0%,62%,86.7%)`
+     * @returns Color object
+     */
+    static fromRgbString(rgb: string_color): WithTake<Color>;
+    /**
+     * Creates a new Color instance from color in rbga format
+     *
+     * @param color as a rgba for example `rgba(0,158,221,0.5)`, `rgb(0%,62%,86.7%,50%)`
+     * @returns Color object
+     */
+    static fromRgbaString(rgba: string_color): WithTake<Color>;
+    /**
+     * Creates a new Color for color channels values
+     *
+     * @param red number from 0 to 255
+     * @param green number from 0 to 255
+     * @param blue number from 0 to 255
+     * @param alpha number from 0 (transparent) to 255 (opaque = default)
+     * @returns Color object
+     */
+    static fromValues(red: number, green: number, blue: number, alpha?: number): WithTake<Color>;
+    /**
+     * Checks if the given value is a valid Color object.
+     *
+     * @param {unknown} value - The value to check.
+     * @return {value is WithTake<Color>} Returns true if the value is a valid Color object, false otherwise.
+     */
+    static isColor(value: unknown): value is WithTake<Color>;
+    /**
+     * Checks if the given value is a valid hex color string
+     *
+     * @param value - value to check
+     * @returns true if the value is a valid hex color string (e.g., `#009edd`, `#fff`, etc.)
+     */
+    static isHexColorString(value: unknown): value is string_color;
+    /**
+     * Creates new Color object
+     *
+     * Note: Consider using one of static methods like `from` or `fromString`
+     *
+     * @param red number from 0 to 255
+     * @param green number from 0 to 255
+     * @param blue number from 0 to 255
+     * @param alpha number from 0 (transparent) to 255 (opaque)
+     */
+    private constructor();
+    /**
+     * Shortcut for `red` property
+     * Number from 0 to 255
+     * @alias red
+     */
+    get r(): number;
+    /**
+     * Shortcut for `green` property
+     * Number from 0 to 255
+     * @alias green
+     */
+    get g(): number;
+    /**
+     * Shortcut for `blue` property
+     * Number from 0 to 255
+     * @alias blue
+     */
+    get b(): number;
+    /**
+     * Shortcut for `alpha` property
+     * Number from 0 (transparent) to 255 (opaque)
+     * @alias alpha
+     */
+    get a(): number;
+    /**
+     * Shortcut for `alpha` property
+     * Number from 0 (transparent) to 255 (opaque)
+     * @alias alpha
+     */
+    get opacity(): number;
+    /**
+     * Shortcut for 1-`alpha` property
+     */
+    get transparency(): number;
+    clone(): WithTake<Color>;
+    toString(): string_color;
+    toHex(): string_color;
+    toRgb(): string_color;
+    toHsl(): string_color;
+}

package/umd/src/utils/color/Color.test.d.ts

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

package/umd/src/utils/color/css-colors.d.ts

@@ -0,0 +1,160 @@
+/**
+ * 🎨 List of all 140 color names which are supported by CSS
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare const CSS_COLORS: {
+    readonly promptbook: "#79EAFD";
+    readonly transparent: "rgba(0,0,0,0)";
+    readonly aliceblue: "#f0f8ff";
+    readonly antiquewhite: "#faebd7";
+    readonly aqua: "#00ffff";
+    readonly aquamarine: "#7fffd4";
+    readonly azure: "#f0ffff";
+    readonly beige: "#f5f5dc";
+    readonly bisque: "#ffe4c4";
+    readonly black: "#000000";
+    readonly blanchedalmond: "#ffebcd";
+    readonly blue: "#0000ff";
+    readonly blueviolet: "#8a2be2";
+    readonly brown: "#a52a2a";
+    readonly burlywood: "#deb887";
+    readonly cadetblue: "#5f9ea0";
+    readonly chartreuse: "#7fff00";
+    readonly chocolate: "#d2691e";
+    readonly coral: "#ff7f50";
+    readonly cornflowerblue: "#6495ed";
+    readonly cornsilk: "#fff8dc";
+    readonly crimson: "#dc143c";
+    readonly cyan: "#00ffff";
+    readonly darkblue: "#00008b";
+    readonly darkcyan: "#008b8b";
+    readonly darkgoldenrod: "#b8860b";
+    readonly darkgray: "#a9a9a9";
+    readonly darkgrey: "#a9a9a9";
+    readonly darkgreen: "#006400";
+    readonly darkkhaki: "#bdb76b";
+    readonly darkmagenta: "#8b008b";
+    readonly darkolivegreen: "#556b2f";
+    readonly darkorange: "#ff8c00";
+    readonly darkorchid: "#9932cc";
+    readonly darkred: "#8b0000";
+    readonly darksalmon: "#e9967a";
+    readonly darkseagreen: "#8fbc8f";
+    readonly darkslateblue: "#483d8b";
+    readonly darkslategray: "#2f4f4f";
+    readonly darkslategrey: "#2f4f4f";
+    readonly darkturquoise: "#00ced1";
+    readonly darkviolet: "#9400d3";
+    readonly deeppink: "#ff1493";
+    readonly deepskyblue: "#00bfff";
+    readonly dimgray: "#696969";
+    readonly dimgrey: "#696969";
+    readonly dodgerblue: "#1e90ff";
+    readonly firebrick: "#b22222";
+    readonly floralwhite: "#fffaf0";
+    readonly forestgreen: "#228b22";
+    readonly fuchsia: "#ff00ff";
+    readonly gainsboro: "#dcdcdc";
+    readonly ghostwhite: "#f8f8ff";
+    readonly gold: "#ffd700";
+    readonly goldenrod: "#daa520";
+    readonly gray: "#808080";
+    readonly grey: "#808080";
+    readonly green: "#008000";
+    readonly greenyellow: "#adff2f";
+    readonly honeydew: "#f0fff0";
+    readonly hotpink: "#ff69b4";
+    readonly indianred: "#cd5c5c";
+    readonly indigo: "#4b0082";
+    readonly ivory: "#fffff0";
+    readonly khaki: "#f0e68c";
+    readonly lavender: "#e6e6fa";
+    readonly lavenderblush: "#fff0f5";
+    readonly lawngreen: "#7cfc00";
+    readonly lemonchiffon: "#fffacd";
+    readonly lightblue: "#add8e6";
+    readonly lightcoral: "#f08080";
+    readonly lightcyan: "#e0ffff";
+    readonly lightgoldenrodyellow: "#fafad2";
+    readonly lightgray: "#d3d3d3";
+    readonly lightgrey: "#d3d3d3";
+    readonly lightgreen: "#90ee90";
+    readonly lightpink: "#ffb6c1";
+    readonly lightsalmon: "#ffa07a";
+    readonly lightseagreen: "#20b2aa";
+    readonly lightskyblue: "#87cefa";
+    readonly lightslategray: "#778899";
+    readonly lightslategrey: "#778899";
+    readonly lightsteelblue: "#b0c4de";
+    readonly lightyellow: "#ffffe0";
+    readonly lime: "#00ff00";
+    readonly limegreen: "#32cd32";
+    readonly linen: "#faf0e6";
+    readonly magenta: "#ff00ff";
+    readonly maroon: "#800000";
+    readonly mediumaquamarine: "#66cdaa";
+    readonly mediumblue: "#0000cd";
+    readonly mediumorchid: "#ba55d3";
+    readonly mediumpurple: "#9370db";
+    readonly mediumseagreen: "#3cb371";
+    readonly mediumslateblue: "#7b68ee";
+    readonly mediumspringgreen: "#00fa9a";
+    readonly mediumturquoise: "#48d1cc";
+    readonly mediumvioletred: "#c71585";
+    readonly midnightblue: "#191970";
+    readonly mintcream: "#f5fffa";
+    readonly mistyrose: "#ffe4e1";
+    readonly moccasin: "#ffe4b5";
+    readonly navajowhite: "#ffdead";
+    readonly navy: "#000080";
+    readonly oldlace: "#fdf5e6";
+    readonly olive: "#808000";
+    readonly olivedrab: "#6b8e23";
+    readonly orange: "#ffa500";
+    readonly orangered: "#ff4500";
+    readonly orchid: "#da70d6";
+    readonly palegoldenrod: "#eee8aa";
+    readonly palegreen: "#98fb98";
+    readonly paleturquoise: "#afeeee";
+    readonly palevioletred: "#db7093";
+    readonly papayawhip: "#ffefd5";
+    readonly peachpuff: "#ffdab9";
+    readonly peru: "#cd853f";
+    readonly pink: "#ffc0cb";
+    readonly plum: "#dda0dd";
+    readonly powderblue: "#b0e0e6";
+    readonly purple: "#800080";
+    readonly rebeccapurple: "#663399";
+    readonly red: "#ff0000";
+    readonly rosybrown: "#bc8f8f";
+    readonly royalblue: "#4169e1";
+    readonly saddlebrown: "#8b4513";
+    readonly salmon: "#fa8072";
+    readonly sandybrown: "#f4a460";
+    readonly seagreen: "#2e8b57";
+    readonly seashell: "#fff5ee";
+    readonly sienna: "#a0522d";
+    readonly silver: "#c0c0c0";
+    readonly skyblue: "#87ceeb";
+    readonly slateblue: "#6a5acd";
+    readonly slategray: "#708090";
+    readonly slategrey: "#708090";
+    readonly snow: "#fffafa";
+    readonly springgreen: "#00ff7f";
+    readonly steelblue: "#4682b4";
+    readonly tan: "#d2b48c";
+    readonly teal: "#008080";
+    readonly thistle: "#d8bfd8";
+    readonly tomato: "#ff6347";
+    readonly turquoise: "#40e0d0";
+    readonly violet: "#ee82ee";
+    readonly wheat: "#f5deb3";
+    readonly white: "#ffffff";
+    readonly whitesmoke: "#f5f5f5";
+    readonly yellow: "#ffff00";
+    readonly yellowgreen: "#9acd32";
+};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/umd/src/utils/color/internal-utils/checkChannelValue.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Validates that a channel value is a valid number within the range of 0 to 255.
+ * Throws an error if the value is not valid.
+ *
+ * @param channelName - The name of the channel being validated.
+ * @param value - The value of the channel to validate.
+ * @throws Will throw an error if the value is not a valid channel number.
+ *
+ * @private util of `@promptbook/color`
+ */
+export declare function checkChannelValue(channelName: string, value: number): asserts value is number;

package/umd/src/utils/color/internal-utils/hslToRgb.d.ts

@@ -0,0 +1,17 @@
+import type { number_integer } from '../../../types/typeAliases';
+import type { number_percent } from '../../../types/typeAliases';
+import type { number_positive } from '../../../types/typeAliases';
+/**
+ * Converts HSL values to RGB values
+ *
+ * @param hue [0-1]
+ * @param saturation [0-1]
+ * @param lightness [0-1]
+ * @returns [red, green, blue] [0-255]
+ *
+ * @private util of `@promptbook/color`
+ */
+export declare function hslToRgb(hue: number_percent, saturation: number_percent, lightness: number_percent): readonly [number_positive & number_integer, number_positive & number_integer, number_positive & number_integer];
+/**
+ * TODO: Properly name all used internal variables
+ */

package/umd/src/utils/color/internal-utils/rgbToHsl.d.ts

@@ -0,0 +1,17 @@
+import type { number_integer } from '../../../types/typeAliases';
+import type { number_percent } from '../../../types/typeAliases';
+import type { number_positive } from '../../../types/typeAliases';
+/**
+ * Converts RGB values to HSL values
+ *
+ * @param red [0-255]
+ * @param green [0-255]
+ * @param blue [0-255]
+ * @returns [hue, saturation, lightness] [0-1]
+ *
+ * @private util of `@promptbook/color`
+ */
+export declare function rgbToHsl(red: number_positive & number_integer, green: number_positive & number_integer, blue: number_positive & number_integer): readonly [number_percent, number_percent, number_percent];
+/**
+ * TODO: Properly name all used internal variables
+ */

package/umd/src/utils/color/operators/ColorTransformer.d.ts

@@ -0,0 +1,5 @@
+import { Color } from '../Color';
+/**
+ * @public exported from `@promptbook/color`
+ */
+export type ColorTransformer = (color: Color) => Color;

package/umd/src/utils/color/operators/darken.d.ts

@@ -0,0 +1,10 @@
+import type { number_percent } from '../../../types/typeAliases';
+import type { ColorTransformer } from './ColorTransformer';
+/**
+ * Makes color transformer which darker the given color
+ *
+ * @param amount from 0 to 1
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function darken(amount: number_percent): ColorTransformer;

package/umd/src/utils/color/operators/furthest.d.ts

@@ -0,0 +1,16 @@
+import { Color } from '../Color';
+import type { ColorTransformer } from './ColorTransformer';
+/**
+ * Makes color transformer which finds the furthest color from the given list
+ *
+ * @param colors array of colors to choose from
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function furthest(...colors: Color[]): ColorTransformer;
+/**
+ * Makes color transformer which finds the best text color (black or white) for the given background color
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare const textColor: ColorTransformer;

package/umd/src/utils/color/operators/grayscale.d.ts

@@ -0,0 +1,10 @@
+import type { number_percent } from '../../../types/typeAliases';
+import type { ColorTransformer } from './ColorTransformer';
+/**
+ * Makes color transformer which returns a grayscale version of the color
+ *
+ * @param amount from 0 to 1
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function grayscale(amount: number_percent): ColorTransformer;

package/umd/src/utils/color/operators/lighten.d.ts

@@ -0,0 +1,13 @@
+import type { number_percent } from '../../../types/typeAliases';
+import type { ColorTransformer } from './ColorTransformer';
+/**
+ * Makes color transformer which lighten the given color
+ *
+ * @param amount from 0 to 1
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function lighten(amount: number_percent): ColorTransformer;
+/**
+ * TODO: Maybe implement by mix+hsl
+ */

package/umd/src/utils/color/operators/mixWithColor.d.ts

@@ -0,0 +1,12 @@
+import type { number_percent } from '../../../types/typeAliases';
+import { Color } from '../Color';
+import type { ColorTransformer } from './ColorTransformer';
+/**
+ * Makes color transformer which returns a mix of two colors based on a ratio
+ *
+ * @param ratio the ratio of the first color to the second color, from 0 to 1
+ * @param additionalColor the second color to mix with the first color
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function mixWithColor(ratio: number_percent, additionalColor: Color): ColorTransformer;

package/umd/src/utils/color/operators/nearest.d.ts

@@ -0,0 +1,10 @@
+import { Color } from '../Color';
+import type { ColorTransformer } from './ColorTransformer';
+/**
+ * Makes color transformer which finds the nearest color from the given list
+ *
+ * @param colors array of colors to choose from
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function nearest(...colors: Color[]): ColorTransformer;

package/umd/src/utils/color/operators/negative.d.ts

@@ -0,0 +1,7 @@
+import { Color } from '../Color';
+/**
+ * Color transformer which returns the negative color
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function negative(color: Color): Color;

package/umd/src/utils/color/operators/negativeLightness.d.ts

@@ -0,0 +1,7 @@
+import { Color } from '../Color';
+/**
+ * Color transformer which returns the negative color but preserves hue and saturation
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function negativeLightness(color: Color): Color;

package/umd/src/utils/color/operators/saturate.d.ts

@@ -0,0 +1,13 @@
+import type { number_percent } from '../../../types/typeAliases';
+import type { ColorTransformer } from './ColorTransformer';
+/**
+ * Makes color transformer which saturate the given color
+ *
+ * @param amount from -1 to 1
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function saturate(amount: number_percent): ColorTransformer;
+/**
+ * TODO: Maybe implement by mix+hsl
+ */

package/umd/src/utils/color/operators/withAlpha.d.ts

@@ -0,0 +1,9 @@
+import type { ColorTransformer } from './ColorTransformer';
+/**
+ * Makes color transformer which sets alpha channel to given color
+ *
+ * @param alpha number from 0 (transparent) to 1 (opaque)
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function withAlpha(alpha: number): ColorTransformer;

package/umd/src/utils/color/parsers/ColorChannelSet.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Describes RGBA channel values that represent a color.
+ *
+ * @private type of Color
+ */
+export type ColorChannelSet = {
+    red: number;
+    green: number;
+    blue: number;
+    alpha: number;
+};

package/umd/src/utils/color/parsers/parseHexColor.d.ts

@@ -0,0 +1,11 @@
+import type { string_color } from '../../../types/typeAliases';
+import type { ColorChannelSet } from './ColorChannelSet';
+/**
+ * Parses a hex string into RGBA channel values.
+ *
+ * @param hex - Hex value such as `#09d`, `009edd`, `#009eddff`.
+ * @returns RGBA channel values.
+ *
+ * @private function of Color
+ */
+export declare function parseHexColor(hex: string_color): ColorChannelSet;

package/umd/src/utils/color/parsers/parseHslColor.d.ts

@@ -0,0 +1,11 @@
+import type { string_color } from '../../../types/typeAliases';
+import type { ColorChannelSet } from './ColorChannelSet';
+/**
+ * Parses an HSL string into RGBA channel values.
+ *
+ * @param hsl - HSL string such as `hsl(197.1, 100%, 43.3%)`.
+ * @returns RGBA channel values.
+ *
+ * @private function of Color
+ */
+export declare function parseHslColor(hsl: string_color): ColorChannelSet;