@cortex-js/compute-engine 0.51.1 → 0.52.1

package/dist/types/compute-engine/symbolic/antiderivative.d.ts

@@ -1,3 +1,3 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /** Calculate the antiderivative of fn, as an expression (not a function) */
 export declare function antiderivative(fn: Expression, index: string): Expression;

package/dist/types/compute-engine/symbolic/derivative.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /**
  *
  * @param fn The function to differentiate, a function literal.

package/dist/types/compute-engine/symbolic/distribute.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /**
  *
  */

package/dist/types/compute-engine/symbolic/fu-cost.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
  * Cost functions for the Fu trigonometric simplification algorithm.
  *
  * The primary objective is to minimize the number of trigonometric functions,

package/dist/types/compute-engine/symbolic/fu-transforms.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
  * Fu Algorithm Transformation Rules
  *
  * Programmatic implementations of TR1-TR22 from the Fu trigonometric

package/dist/types/compute-engine/symbolic/fu.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
  * Fu Algorithm for Trigonometric Simplification
  *
  * Implementation of the algorithm by Fu, Zhong, and Zeng:

package/dist/types/compute-engine/symbolic/logic-utils.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 export declare function evaluateAnd(args: ReadonlyArray<Expression>, { engine: ce }: {
     engine: ComputeEngine;
 }): Expression | undefined;

package/dist/types/compute-engine/symbolic/simplify-abs.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 export declare function simplifyAbs(x: Expression): RuleStep | undefined;
 /**
  * Simplify expressions where Abs appears as the base of a power.

package/dist/types/compute-engine/symbolic/simplify-divide.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /**
  * Division simplification rules consolidated from simplify-rules.ts.
  *

package/dist/types/compute-engine/symbolic/simplify-factorial.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /**
  * Extracts base + integer offset from an expression.
  * - Symbol `n` → { base: n, offset: 0 }

package/dist/types/compute-engine/symbolic/simplify-hyperbolic.d.ts

@@ -1,2 +1,2 @@
-/* 0.51.1 */
+/* 0.52.1 */
 export declare function simplifyHyperbolic(x: Expression): RuleStep | undefined;

package/dist/types/compute-engine/symbolic/simplify-infinity.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /**
  * Infinity simplification rules consolidated from simplify-rules.ts.
  * Handles ~20 patterns for simplifying expressions involving infinity.

package/dist/types/compute-engine/symbolic/simplify-log.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /**
  * Logarithm simplification rules consolidated from simplify-rules.ts.
  * Handles ~30 patterns for simplifying Ln and Log expressions.

package/dist/types/compute-engine/symbolic/simplify-logic.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 export declare function simplifyLogicFunction(x: Expression): {
     value: Expression;
     because: string;

package/dist/types/compute-engine/symbolic/simplify-power.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /**
  * Power simplification rules consolidated from simplify-rules.ts.
  * Handles ~25 patterns for simplifying Power expressions.

package/dist/types/compute-engine/symbolic/simplify-product.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /**
  * Product simplification rules extracted from simplify-rules.ts.
  * Handles 13 patterns for simplifying Product expressions.

package/dist/types/compute-engine/symbolic/simplify-rules.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /**
  * # Performance Optimization Notes for Simplification Rules
  *

package/dist/types/compute-engine/symbolic/simplify-sum.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /**
  * Sum simplification rules extracted from simplify-rules.ts.
  * Handles 16 patterns for simplifying Sum expressions.

package/dist/types/compute-engine/symbolic/simplify-trig.d.ts

@@ -1,2 +1,2 @@
-/* 0.51.1 */
+/* 0.52.1 */
 export declare function simplifyTrig(x: Expression): RuleStep | undefined;

package/dist/types/compute-engine/tensor/tensor-fields.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 import { Expression, IComputeEngine as ComputeEngine, DataTypeMap, TensorDataType, TensorField } from '../global-types';
 /** @category Tensors */
 export declare function makeTensorField<DT extends keyof DataTypeMap>(ce: ComputeEngine, dtype: DT): TensorField<DataTypeMap[DT]>;

package/dist/types/compute-engine/tensor/tensors.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 /** @category Tensors */
 export declare abstract class AbstractTensor<DT extends keyof DataTypeMap> implements Tensor<DT> {
     private ce;

package/dist/types/compute-engine/types-definitions.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 import type { Type, TypeString } from '../common/type/types';
 import type { BoxedType } from '../common/type/boxed-type';
 import type { LatexString, LatexDictionaryEntry } from './latex-syntax/types';

package/dist/types/compute-engine/types-engine.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 import type { OneOf } from '../common/one-of';
 import type { MathJsonSymbol, MathJsonNumberObject } from '../math-json';
 import type { Type, TypeString, TypeResolver } from '../common/type/types';

package/dist/types/compute-engine/types-evaluation.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 import type { IComputeEngine as ComputeEngine } from './types-engine';
 import type { Expression, ExpressionInput } from './types-expression';
 import type { Assumption as KernelAssumption, AssumeResult, AssignValue as KernelAssignValue, BoxedRule as KernelBoxedRule, BoxedRuleSet as KernelBoxedRuleSet, EvaluateOptions as KernelEvaluateOptions, EvalContext as KernelEvalContext, ExpressionMapInterface as KernelExpressionMapInterface, Rule as KernelRule, RuleConditionFunction as KernelRuleConditionFunction, RuleFunction as KernelRuleFunction, RuleReplaceFunction as KernelRuleReplaceFunction, RuleStep as KernelRuleStep, RuleSteps as KernelRuleSteps, Scope as KernelScope } from './types-kernel-evaluation';

package/dist/types/compute-engine/types-expression.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 import type { OneOf } from '../common/one-of';
 import type { MathJsonExpression, MathJsonNumberObject, MathJsonStringObject, MathJsonSymbolObject, MathJsonFunctionObject, MathJsonSymbol, MathJsonDictionaryObject } from '../math-json';
 import type { Type, TypeString } from '../common/type/types';
@@ -687,8 +687,11 @@ export interface Expression {
      */
     readonly subexpressions: ReadonlyArray<Expression>;
     /**
+     * All the symbols in the expression, recursively, including
+     * bound variables (e.g., summation/product index variables).
      *
-     * All the symbols in the expression, recursively
+     * Use {@link unknowns} or {@link freeVariables} to get only the
+     * symbols that are free (not bound by a scoping construct).
      *
      * ```js
      * const expr = ce.parse('a + b * c + d');
@@ -707,6 +710,14 @@ export interface Expression {
      * associated with them, i.e. they are declared but not defined.
      */
     readonly unknowns: ReadonlyArray<string>;
+    /**
+     * The free variables of the expression: symbols that are not constants,
+     * not operators, not bound to a value, and not locally scoped (e.g.,
+     * summation/product index variables are excluded).
+     *
+     * This is an alias for {@link unknowns}.
+     */
+    readonly freeVariables: ReadonlyArray<string>;
     /**
      * Attempt to factor a numeric coefficient `c` and a `rest` out of a
      * canonical expression such that `rest.mul(c)` is equal to `this`.
@@ -965,11 +976,20 @@ export interface Expression {
      * :::
      */
     has(v: string | string[]): boolean;
-    /** Structural/symbolic equality (weak equality).
+    /** Fast exact structural/symbolic equality check.
+     *
+     * Returns `true` if the expression is structurally identical to `rhs`.
+     * For symbols with value bindings, follows the binding (e.g., if `one = 1`,
+     * then `ce.symbol('one').isSame(1)` is `true`).
+     *
+     * Accepts JavaScript primitives: `number`, `bigint`, `boolean`, `string`.
+     *
+     * Does **not** evaluate expressions — purely structural.
      *
      * `ce.parse('1+x', {form: 'raw'}).isSame(ce.parse('x+1', {form: 'raw'}))` is `false`.
      *
-     * See `expr.isEqual()` for mathematical equality.
+     * See `expr.is()` for a smart check with numeric evaluation fallback,
+     * and `expr.isEqual()` for full mathematical equality.
      *
      * :::info[Note]
      * Applicable to canonical and non-canonical expressions.
@@ -977,16 +997,32 @@ export interface Expression {
      *
      * @category Relational Operator
      */
-    isSame(rhs: Expression): boolean;
+    isSame(rhs: Expression | number | bigint | boolean | string): boolean;
     /**
-     * Equivalent to `Expression.isSame()` but the argument can be
-     * a JavaScript primitive. For example, `expr.is(2)` is equivalent to
-     * `expr.isSame(ce.number(2))`.
+     * Smart equality check: structural first, then numeric evaluation fallback.
      *
-     * @category Primitive Methods
+     * First tries an exact structural check (same as `isSame()`). If that fails
+     * and the expression is constant (no free variables), evaluates numerically
+     * and compares within `engine.tolerance`.
+     *
+     * For literal numbers (`BoxedNumber`), behaves identically to `isSame()` —
+     * no tolerance is applied. Tolerance only applies to expressions that
+     * require evaluation (e.g., `\\sin(\\pi)`).
+     *
+     * ```typescript
+     * ce.parse('\\cos(\\frac{\\pi}{2})').is(0)  // true — evaluates, within tolerance
+     * ce.number(1e-17).is(0)                     // false — literal, no tolerance
+     * ce.parse('x + 1').is(1)                    // false — has free variables
+     * ce.parse('\\pi').is(3.14, 0.01)            // true — within custom tolerance
+     * ```
+     *
+     * @param tolerance - If provided, overrides `engine.tolerance` for the
+     * numeric comparison. Has no effect when the comparison is structural
+     * (i.e., when `isSame()` succeeds or the expression has free variables).
      *
+     * @category Primitive Methods
      */
-    is(other: Expression | number | bigint | boolean | string): boolean;
+    is(other: Expression | number | bigint | boolean | string, tolerance?: number): boolean;
     /**
      * If this expression matches `pattern`, return a substitution that makes
      * `pattern` equal to `this`. Otherwise return `null`.
@@ -1395,22 +1431,22 @@ export interface Expression {
      *
      * Evaluating the expressions may be expensive. Other options to consider
      * to compare two expressions include:
-     * - `expr.isSame(other)` for a structural comparison which does not involve
-     *   evaluating the expressions.
-     * - `expr.is(other)` for a comparison of a number literal
+     * - `expr.isSame(other)` for a fast exact structural comparison (no evaluation)
+     * - `expr.is(other)` for a smart check that tries structural first, then
+     *   numeric evaluation fallback for constant expressions
      *
      * **Examples**
      *
      * ```js
      * let expr = ce.parse('2 + 2');
      * console.log(expr.isEqual(4)); // true
-     * console.log(expr.isSame(ce.parse(4))); // false
-     * console.log(expr.is(4)); // false
+     * console.log(expr.isSame(4)); // false (structural only)
+     * console.log(expr.is(4)); // true (evaluates, within tolerance)
      *
      * expr = ce.parse('4');
      * console.log(expr.isEqual(4)); // true
-     * console.log(expr.isSame(ce.parse(4))); // true
-     * console.log(expr.is(4)); // true (fastest)
+     * console.log(expr.isSame(4)); // true
+     * console.log(expr.is(4)); // true
      *
      * ```
      *
@@ -1537,6 +1573,7 @@ export interface Expression {
  */
 export interface NumberLiteralInterface {
     readonly numericValue: number | NumericValue;
+    readonly isExact: boolean;
     readonly isNumberLiteral: true;
 }
 /**

package/dist/types/compute-engine/types-kernel-evaluation.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 import type { TypeReference } from '../common/type/types';
 import type { BoxedType } from '../common/type/boxed-type';
 import type { LatexString } from './latex-syntax/types';

package/dist/types/compute-engine/types-kernel-serialization.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 export type Hold = 'none' | 'all' | 'first' | 'rest' | 'last' | 'most';
 /**
  * Options to control serialization to MathJSON when using

package/dist/types/compute-engine/types-serialization.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 import type { BoxedSubstitution as KernelBoxedSubstitution, CanonicalForm, CanonicalOptions, FormOption, Hold, JsonSerializationOptions, Metadata, PatternMatchOptions as KernelPatternMatchOptions, ReplaceOptions, Substitution as KernelSubstitution } from './types-kernel-serialization';
 export type { Hold, JsonSerializationOptions, ReplaceOptions, CanonicalForm, CanonicalOptions, FormOption, Metadata, };
 /**

package/dist/types/compute-engine/types.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 export type { MathJsonExpression, MathJsonAttributes, MathJsonNumberObject, MathJsonSymbolObject, MathJsonStringObject, MathJsonFunctionObject, DictionaryValue, MathJsonDictionaryObject, ExpressionObject, MathJsonSymbol, } from '../math-json/types';
 export * from '../common/type/boxed-type';
 export * from '../common/type/types';

package/dist/types/compute-engine.d.ts

@@ -1,7 +1,7 @@
-/* 0.51.1 */
+/* 0.52.1 */
 export { ComputeEngine } from './compute-engine/index';
 export type * from './compute-engine/types';
-export type { CompileTarget, CompiledOperators, CompiledFunctions, CompilationOptions, CompilationResult, LanguageTarget, TargetSource, CompiledFunction, } from './compute-engine/compilation/types';
+export type { CompileTarget, CompiledOperators, CompiledFunctions, CompilationOptions, CompilationResult, ExecutableTarget, ComplexResult, CompiledRunner, ExpressionRunner, LambdaRunner, LanguageTarget, TargetSource, CompiledFunction, } from './compute-engine/compilation/types';
 export { JavaScriptTarget } from './compute-engine/compilation/javascript-target';
 export { GPUShaderTarget } from './compute-engine/compilation/gpu-target';
 export { GLSLTarget } from './compute-engine/compilation/glsl-target';
@@ -11,8 +11,9 @@ export { IntervalJavaScriptTarget } from './compute-engine/compilation/interval-
 export { IntervalGLSLTarget } from './compute-engine/compilation/interval-glsl-target';
 export { IntervalWGSLTarget } from './compute-engine/compilation/interval-wgsl-target';
 export { BaseCompiler } from './compute-engine/compilation/base-compiler';
+export type { Interval, IntervalResult, BoolInterval, } from './compute-engine/interval/types';
 export { parse, simplify, evaluate, N, declare, assign, expand, expandAll, factor, solve, compile, getDefaultEngine, } from './compute-engine/free-functions';
-export { isExpression, isNumber, isSymbol, isFunction, isString, isTensor, isDictionary, isCollection, isIndexedCollection, isBoxedExpression, isBoxedNumber, isBoxedSymbol, isBoxedFunction, isBoxedString, isBoxedTensor, } from './compute-engine/boxed-expression/type-guards';
+export { isExpression, isNumber, isSymbol, isFunction, isString, isTensor, isDictionary, isCollection, isIndexedCollection, numericValue, isBoxedExpression, isBoxedNumber, isBoxedSymbol, isBoxedFunction, isBoxedString, isBoxedTensor, } from './compute-engine/boxed-expression/type-guards';
 export type { BoxedNumber } from './compute-engine/boxed-expression/boxed-number';
 export type { BoxedSymbol } from './compute-engine/boxed-expression/boxed-symbol';
 export type { BoxedFunction } from './compute-engine/boxed-expression/boxed-function';

package/dist/types/math-json/symbols.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
  * Return true if the string is a valid symbol.
  *
  * Check for symbols matching a profile of [Unicode UAX31](https://unicode.org/reports/tr31/)

package/dist/types/math-json/types.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
  * The following properties can be added to any MathJSON expression
  * to provide additional information about the expression.
  *

package/dist/types/math-json/utils.d.ts

@@ -1,4 +1,4 @@
-/* 0.51.1 */
+/* 0.52.1 */
 export declare const MISSING: MathJsonExpression;
 export declare function isNumberExpression(expr: MathJsonExpression | null): expr is number | string | MathJsonNumberObject;
 export declare function isNumberObject(expr: MathJsonExpression | null): expr is MathJsonNumberObject;

package/dist/types/math-json.d.ts

@@ -1,3 +1,3 @@
-/* 0.51.1 */
+/* 0.52.1 */
 export { isSymbolObject, isStringObject, isFunctionObject, stringValue, operator, operand, symbol, mapArgs, dictionaryFromExpression, } from './math-json/utils';
-export declare const version = "0.51.1";
+export declare const version = "0.52.1";

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.51.1",
+  "version": "0.52.1",
   "scripts": {
     "doc": "bash ./scripts/doc.sh",
     "build": "bash ./scripts/build.sh",
@@ -99,6 +99,7 @@
   },
   "prettier": "@cortex-js/prettier-config",
   "dependencies": {
+    "@arnog/colors": "^0.2.1",
     "complex-esm": "^2.1.1-esm1",
     "decimal.js": "^10.6.0"
   }

package/dist/types/color/categorical.d.ts

@@ -1,16 +0,0 @@
-/* 0.51.1 */
-    readonly tycho11: string[];
-    readonly 'tycho-dark11': string[];
-    readonly 'tycho-robust11': string[];
-    readonly 'tycho-soft11': string[];
-    readonly 'tycho-soft-dark11': string[];
-    readonly 'tycho-bold11': string[];
-    readonly 'tycho-bold-dark11': string[];
-    readonly tableau10: string[];
-    readonly kelly22: string[];
-    readonly mathematica10: string[];
-    readonly cupertino10: string[];
-    readonly 'cupertino-dark10': string[];
-    readonly spectrum12: string[];
-};
-export type CategoricalPaletteName = keyof typeof CATEGORICAL_PALETTES;

package/dist/types/color/contrast.d.ts

@@ -1,16 +0,0 @@
-/* 0.51.1 */
-/**
- * APCA contrast calculation using Color objects.
- *
- * Return the contrast value (positive for dark text on light background, negative for light text on dark background)
- */
-export declare function apca(bgColor: Color, fgColor: Color): number;
-/**
- * Choose the foreground color with better contrast against the background
- * Returns the color (as rgba number) that provides better APCA contrast
- */
-export declare function contrastingColor(arg: {
-    bg: Color;
-    fg1: Color;
-    fg2: Color;
-} | Color | number): number;

package/dist/types/color/conversion.d.ts

@@ -1,13 +0,0 @@
-/* 0.51.1 */
-export declare function asOklch(color: string | RgbColor | OklchColor | OklabColor): OklchColor;
-export declare function asRgb(color: number | Color): RgbColor;
-export declare function asColorNumber(color: number | Color): number;
-export declare function clampByte(v: number): number;
-export declare function oklchToOklab(_: OklchColor): OklabColor;
-export declare function oklabToOklch(_: OklabColor): OklchColor;
-export declare function oklabToUnclippedRgb(_: OklabColor): number[];
-/** Convert an oklab color to sRGB, clipping the chroma if necessary */
-export declare function oklabToRgb(color: OklabColor): RgbColor;
-export declare function oklchToRgb(_: OklchColor): RgbColor;
-export declare function rgbToOklab(_: RgbColor): OklabColor;
-export declare function rgbToOklch(_: RgbColor): OklchColor;

package/dist/types/color/diverging-palettes.d.ts

@@ -1,15 +0,0 @@
-/* 0.51.1 */
-    readonly roma: string[];
-    readonly 'roma-reversed': string[];
-    readonly vik: string[];
-    readonly 'vik-reversed': string[];
-    readonly broc: string[];
-    readonly 'broc-reversed': string[];
-    readonly rdbu: string[];
-    readonly 'rdbu-reversed': string[];
-    readonly coolwarm: string[];
-    readonly 'coolwarm-reversed': string[];
-    readonly 'ocean-balance': string[];
-    readonly 'ocean-balance-reversed': string[];
-};
-export type DivergingPaletteName = keyof typeof DIVERGING_PALETTES;

package/dist/types/color/index.d.ts

@@ -1,4 +0,0 @@
-/* 0.51.1 */
-export { asOklch, asRgb, clampByte, oklchToOklab, oklabToOklch, oklabToRgb, oklchToRgb, rgbToOklab, rgbToOklch, } from './conversion';
-export { apca, contrastingColor } from './contrast';
-export { oklch, oklchFromRGB, parseColor, cMaxFor, getOptimalHueRange, gray, lighten, darken, shade, gammaCorrect, inverseGammaCorrect, hslToRgb, rgbToHsl, } from './manipulation';

package/dist/types/color/manipulation.d.ts

@@ -1,95 +0,0 @@
-/* 0.51.1 */
-export declare function gammaCorrect(channel: number): number;
-export declare function inverseGammaCorrect(channel: number): number;
-export declare function hslToRgb(h: number, s: number, l: number): {
-    r: number;
-    g: number;
-    b: number;
-};
-/** Convert an RGB color (0-255 per channel) to HSL.
- * Returns h: 0-360, s: 0-1, l: 0-1. */
-export declare function rgbToHsl(r: number, g: number, b: number): {
-    h: number;
-    s: number;
-    l: number;
-};
-export declare function cMaxFor(L: number, Hdeg: number): number;
-/**
- * Convert OKLCH to RGB color
- * @param l lightness: 0..100
- * @param c chroma: 0..about 0.4
- * @param h hue: 0..360
- * @returns 0xrrggbbaa color
- */
-export declare function oklch(l: number, c: number, h: number): number;
-export declare function oklchFromRGB(rgba: number): {
-    l: number;
-    c: number;
-    h: number;
-};
-/**
- * Calculate the usable lightness range for a given hue where chroma is above the visibility floor
- *
- * @param Hdeg hue in degrees 0-360
- * @param Cmin minimum distinguishable chroma (0.03-0.06 for UI)
- * @param step lightness sampling step
- * @returns object with darkestL and lightestL values
- */
-export declare function lightnessRangeForHue(Hdeg: number, Cmin?: number, step?: number): {
-    darkestL: number | null;
-    lightestL: number | null;
-};
-/**
- * Generate optimal darkest and lightest colors for a given hue using practical UI guidelines
- *
- * @param hue hue in degrees 0-360
- * @param chromaBackoff percentage to back off from maximum chroma to avoid edge clipping (0.05 = 5%)
- * @param minChroma minimum distinguishable chroma for UI visibility
- * @returns object with darkest and lightest colors in 0xrrggbbaa format
- */
-export declare function getOptimalHueRange(hue: number, chromaBackoff?: number, _minChroma?: number): {
-    darkest: number;
-    lightest: number;
-};
-export declare function gray(percent: number): number;
-export declare function lighten(color: number, amount: number): number;
-export declare function darken(color: number, amount: number): number;
-/**
- * Return a shade of the color.
- *
- * The index is a value between 0 and 1000. 0 represent the darkest shade (black) and 1000 represent the lightest shade (white).
- *
- * If color is a single number, the darkest shade and lightest shade are determined based on the hue and chroma of the color, with a 10% lightness for the darkest shade and a 95% lightness for the lightest shade.
- *
- * If `mid` is not provided, it is linearly interpolated between the darkest
- * and lightest shades.
- *
- * The result is determined by interpolating along a s-curve between the darkest and lightest shades, with the `mid` value at index 500.
- *
- * If any of the colors are a string, they are parsed with `parseColor`.
- *
- * @todo: provide a LaTeX equation of the s-curve interpolation function used
- *
- */
-export declare function shade(color: string | number | {
-    lightest: number | string;
-    darkest: number | string;
-    mid?: number | string;
-}, index: number): number;
-/**
- * Return true if `s` is a named color from the NAMED_COLORS palette
- * (e.g. "red", "blue", "dark-grey") or "transparent".
- */
-export declare function isNamedColor(s: string): boolean;
-/**
- * Given a string `s` in the following formats, return a 0xrrggbbaa color.
- * - hex: #rrggbbaa, #rgb, #rrggbb
- * - rgba: rgba(r, g, b, a)
- * - rgb: rgb(r, g, b) or rgb(r, g, b / a) or rgb(r g b / a) or rgb(r g b)
- * - oklch: oklch(l c h / a) or oklch(l c h) or oklch(l, c, h / a) or oklch(l, c, h), when l is a percentage, c is a number between 0 and 0.4, and h is a number between 0 and 360, for example "oklch(50% 0.3 240 / 0.8)" or "oklch(50% 0.3 240 / 80%)"
- * - oklab: oklab(L a b / alpha) or oklab(L a b), where L is 0-1 (or percentage), a is ~-0.4 to 0.4, b is ~-0.4 to 0.4
- * - hsl: hsl(h, s, l) or hsl(h, s, l / a) or hsl(h s l / a) or hsl(h s l), where h is a number between 0 and 360, s is a percentage, l is a percentage and a is a percentage
- * - named: color names from the NAMED_COLORS palette (e.g. "red", "blue", "cyan", "dark-grey") or "transparent"
- */
-export declare function parseColor(s: string): number;
-export declare function parseColorToRgb(s: string): RgbColor;

package/dist/types/color/palette.d.ts

@@ -1,68 +0,0 @@
-/* 0.51.1 */
-export type DesignColorName = keyof typeof BACKGROUND_COLORS;
-export declare const BACKGROUND_COLORS: {
-    readonly red: "#fbbbb6";
-    readonly orange: "#ffe0c2";
-    readonly yellow: "#fff1c2";
-    readonly lime: "#d0e8b9";
-    readonly green: "#bceac4";
-    readonly teal: "#b9f1f1";
-    readonly cyan: "#b8e5c9";
-    readonly blue: "#b6d9fb";
-    readonly indigo: "#d1c2f0";
-    readonly purple: "#e3baf8";
-    readonly magenta: "#f9c8e0";
-    readonly black: "#353535";
-    readonly 'dark-grey': "#8C8C8C";
-    readonly grey: "#D0D0D0";
-    readonly 'light-grey': "#F0F0F0";
-    readonly white: "#ffffff";
-};
-export declare const FOREGROUND_COLORS: {
-    red: string;
-    orange: string;
-    yellow: string;
-    lime: string;
-    green: string;
-    teal: string;
-    cyan: string;
-    blue: string;
-    indigo: string;
-    purple: string;
-    magenta: string;
-    black: string;
-    'dark-grey': string;
-    grey: string;
-    'light-grey': string;
-    white: string;
-};
-export declare const NAMED_COLORS: {
-    readonly red: "#d7170b";
-    readonly orange: "#fe8a2b";
-    readonly yellow: "#ffc02b";
-    readonly lime: "#63b215";
-    readonly green: "#21ba3a";
-    readonly teal: "#17cfcf";
-    readonly cyan: "#13a7ec";
-    readonly blue: "#0d80f2";
-    readonly indigo: "#63c";
-    readonly purple: "#a219e6";
-    readonly magenta: "#eb4799";
-    readonly brown: "#8c564b";
-    readonly olive: "#8a8f2a";
-    readonly midnight: "#2c4670";
-    readonly sky: "#d2dce9";
-    readonly black: "#000";
-    readonly white: "#ffffff";
-    readonly carbon: "#111111";
-    readonly charcoal: "#333333";
-    readonly slate: "#555555";
-    readonly 'dark-grey': "#666";
-    readonly graphite: "#777777";
-    readonly stone: "#999999";
-    readonly grey: "#A6A6A6";
-    readonly 'light-grey': "#d4d5d2";
-    readonly ash: "#E6E6E6";
-    readonly mist: "#F3F3F3";
-    readonly snow: "#FFFFFF";
-};