@promptbook/templates 0.100.0-47 → 0.100.0-49

package/esm/typings/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/esm/typings/src/utils/color/operators/darken.d.ts

@@ -0,0 +1,9 @@
+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): ColorTransformer;

package/esm/typings/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/esm/typings/src/utils/color/operators/grayscale.d.ts

@@ -0,0 +1,9 @@
+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): ColorTransformer;

package/esm/typings/src/utils/color/operators/lighten.d.ts

@@ -0,0 +1,12 @@
+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): ColorTransformer;
+/**
+ * TODO: Maybe implement by mix+hsl
+ */

package/esm/typings/src/utils/color/operators/mixWithColor.d.ts

@@ -0,0 +1,11 @@
+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, additionalColor: Color): ColorTransformer;

package/esm/typings/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/esm/typings/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/esm/typings/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/esm/typings/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/esm/typings/src/utils/color/utils/areColorsEqual.d.ts

@@ -0,0 +1,14 @@
+import { Color } from '../Color';
+/**
+ * Compares two colors to determine if they are equal based on their RGB values.
+ *
+ * @param color1 - The first color to compare.
+ * @param color2 - The second color to compare.
+ * @returns {boolean} True if the colors are equal, false otherwise.
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function areColorsEqual(color1: Color, color2: Color): boolean;
+/**
+ * TODO: [🥎] Implement for N colors
+ */

package/esm/typings/src/utils/color/utils/colorDistance.d.ts

@@ -0,0 +1,21 @@
+import { Color } from '../Color';
+/**
+ * Calculates distance between two colors
+ *
+ * @param color1 first color
+ * @param color2 second color
+ *
+ * Note: This function is inefficient. Use colorDistanceSquared instead if possible.
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function colorDistance(color1: Color, color2: Color): number;
+/**
+ * Calculates distance between two colors without square root
+ *
+ * @param color1 first color
+ * @param color2 second color
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function colorDistanceSquared(color1: Color, color2: Color): number;

package/esm/typings/src/utils/color/utils/colorHue.d.ts

@@ -0,0 +1,11 @@
+import { Color } from '../Color';
+/**
+ * Calculates hue of the color
+ *
+ * @returns hue in degrees <0-360)
+ *
+ * @see https://en.wikipedia.org/wiki/HSL_and_HSV#Hue_and_chroma
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function colorHue(color: Color): number;

package/esm/typings/src/utils/color/utils/colorHueDistance.d.ts

@@ -0,0 +1,11 @@
+import { Color } from '../Color';
+/**
+ * Calculates hue distance of two colors
+ *
+ * @returns hue distance in degrees <0-180)
+ *
+ * @see https://en.wikipedia.org/wiki/HSL_and_HSV#Hue_and_chroma
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function colorHueDistance(color1: Color, color2: Color): number;

package/esm/typings/src/utils/color/utils/colorHueDistance.test.d.ts

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

package/esm/typings/src/utils/color/utils/colorLuminance.d.ts

@@ -0,0 +1,9 @@
+import { Color } from '../Color';
+/**
+ * Calculates luminance of the color
+ *
+ * @see https://en.wikipedia.org/wiki/Relative_luminance
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function colorLuminance(color: Color): number;

package/esm/typings/src/utils/color/utils/colorSatulightion.d.ts

@@ -0,0 +1,7 @@
+import { Color } from '../Color';
+/**
+ * Calculates saturation*luminance of the color
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function colorSatulightion(color: Color): number;

package/esm/typings/src/utils/color/utils/colorSaturation.d.ts

@@ -0,0 +1,9 @@
+import { Color } from "../Color";
+/**
+ * Calculates saturation of the color
+ *
+ * @see https://en.wikipedia.org/wiki/HSL_and_HSV#Saturation
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function colorSaturation(color: Color): number;

package/esm/typings/src/utils/color/utils/colorToDataUrl.d.ts

@@ -0,0 +1,10 @@
+import { Color } from '../Color';
+/**
+ * Makes data url from color
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function colorToDataUrl(color: Color): string;
+/**
+ * TODO: Make as functions NOT const
+ */

package/esm/typings/src/utils/color/utils/mixColors.d.ts

@@ -0,0 +1,11 @@
+import type { WithTake } from '../../take/interfaces/ITakeChain';
+import { Color } from '../Color';
+/**
+ * Mixes an array of colors and returns the average color
+ *
+ * @param {...Color} colors - The array of colors to be mixed.
+ * @returns {WithTake<Color>} - The mixed color.
+ *
+ * @public exported from `@promptbook/color`
+ */
+export declare function mixColors(...colors: Array<Color>): WithTake<Color>;

package/esm/typings/src/utils/take/classes/TakeChain.d.ts

@@ -0,0 +1,11 @@
+import type { ITakeChain } from '../interfaces/ITakeChain';
+import type { Takeable } from '../interfaces/Takeable';
+/**
+ * @private util of `@promptbook/color`
+ * @de
+ */
+export declare class TakeChain<TValue extends Takeable> implements ITakeChain<TValue> {
+    value: TValue;
+    constructor(value: TValue);
+    then<TResultValue extends Takeable>(callback: (oldValue: TValue) => TResultValue): TResultValue & ITakeChain<TResultValue>;
+}

package/esm/typings/src/utils/take/interfaces/ITakeChain.d.ts

@@ -0,0 +1,12 @@
+import type { Takeable } from './Takeable';
+/**
+ * Represents any value with take chain functionality
+ *
+ * @private util of `@promptbook/color`
+ * @deprecated [🤡] Use some better functional library instead of `TakeChain`
+ */
+export type WithTake<TValue extends Takeable> = TValue & ITakeChain<TValue>;
+export interface ITakeChain<TValue extends Takeable> {
+    readonly value: TValue;
+    then<TResultValue extends Takeable>(callback: (value: TValue) => TResultValue): WithTake<TResultValue>;
+}

package/esm/typings/src/utils/take/interfaces/Takeable.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Represents a type that can be chained in take pipe
+ *
+ * @private util of `@promptbook/color`
+ * @deprecated [🤡] Use some better functional library instead of `TakeChain`
+ */
+export type Takeable = Exclude<object, null>;

package/esm/typings/src/utils/take/take.d.ts

@@ -0,0 +1,12 @@
+import type { WithTake } from './interfaces/ITakeChain';
+import type { Takeable } from './interfaces/Takeable';
+/**
+ * A function that takes an initial value and returns a proxy object with chainable methods.
+ *
+ * @param {*} initialValue - The initial value.
+ * @returns {Proxy<WithTake<TValue>>} - A proxy object with a `take` method.
+ *
+ * @private util of `@promptbook/color`
+ * @deprecated [🤡] Use some better functional library instead of `TakeChain`
+ */
+export declare function take<TValue extends Takeable>(initialValue: TValue): WithTake<TValue>;

package/esm/typings/src/utils/take/take.test.d.ts

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

package/esm/typings/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.100.0-46`).
+ * It follows semantic versioning (e.g., `0.100.0-48`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/templates",
-    "version": "0.100.0-47",
+    "version": "0.100.0-49",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -95,7 +95,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/templates.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.100.0-47"
+        "@promptbook/core": "0.100.0-49"
     },
     "dependencies": {
         "spacetrim": "0.11.59"