entangle-ui 0.1.0 → 0.3.0

package/dist/esm/utils/mathExpression.js

@@ -0,0 +1,275 @@
+// src/utils/mathExpression.ts
+/**
+ * Blocked identifiers that must be rejected before evaluation.
+ * Defense-in-depth layer to prevent prototype pollution or code execution
+ * via dangerous JavaScript identifiers that pass character validation.
+ */
+const BLOCKED_IDENTIFIERS = new Set([
+    'constructor',
+    'prototype',
+    '__proto__',
+    'this',
+    'self',
+    'window',
+    'document',
+    'globalThis',
+    'process',
+    'require',
+    'import',
+    'module',
+    'exports',
+    'eval',
+    'Function',
+    'Object',
+    'Array',
+    'Reflect',
+    'Proxy',
+    'Symbol',
+]);
+/**
+ * Mathematical constants available in expressions
+ */
+const MATH_CONSTANTS = {
+    pi: Math.PI,
+    e: Math.E,
+    tau: 2 * Math.PI,
+    phi: (1 + Math.sqrt(5)) / 2, // Golden ratio
+};
+/**
+ * Mathematical functions available in expressions
+ */
+const MATH_FUNCTIONS = {
+    // Trigonometric functions
+    sin: Math.sin,
+    cos: Math.cos,
+    tan: Math.tan,
+    asin: Math.asin,
+    acos: Math.acos,
+    atan: Math.atan,
+    // Logarithmic and exponential
+    log: Math.log,
+    log10: Math.log10,
+    log2: Math.log2,
+    exp: Math.exp,
+    // Power and root functions
+    sqrt: Math.sqrt,
+    cbrt: Math.cbrt,
+    // Rounding functions
+    floor: Math.floor,
+    ceil: Math.ceil,
+    round: Math.round,
+    // Other useful functions
+    abs: Math.abs,
+    sign: Math.sign,
+};
+/**
+ * Sanitizes mathematical expression by removing dangerous patterns
+ * and normalizing the input for safe evaluation.
+ */
+function sanitizeExpression(expression) {
+    // Remove whitespace
+    let sanitized = expression.replace(/\s+/g, '');
+    // Convert common alternative notations
+    sanitized = sanitized.replace(/×/g, '*'); // Multiplication symbol
+    sanitized = sanitized.replace(/÷/g, '/'); // Division symbol
+    sanitized = sanitized.replace(/\^/g, '**'); // Power operator
+    // Ensure proper decimal notation
+    sanitized = sanitized.replace(/,/g, '.'); // European decimal notation
+    return sanitized;
+}
+/**
+ * Validates that expression contains only allowed characters and patterns
+ */
+function isValidExpression(expression) {
+    // Allow numbers, operators, parentheses, dots, and known constants/functions
+    const allowedPattern = /^[0-9+\-*/().a-zA-Z_]+$/;
+    if (!allowedPattern.test(expression)) {
+        return false;
+    }
+    // Check for balanced parentheses
+    let depth = 0;
+    for (const char of expression) {
+        if (char === '(')
+            depth++;
+        if (char === ')')
+            depth--;
+        if (depth < 0)
+            return false;
+    }
+    return depth === 0;
+}
+/**
+ * Checks whether the expression contains any blocked identifiers or
+ * unknown alphabetic tokens. All word tokens must be either a known
+ * constant, a known function name, or part of "Math" (introduced by
+ * replaceConstantsAndFunctions). Any unrecognized identifier is rejected.
+ */
+function containsBlockedIdentifiers(expression) {
+    const wordTokens = expression.match(/[a-zA-Z_][a-zA-Z0-9_]*/g);
+    if (!wordTokens)
+        return false;
+    const allowedTokens = new Set([
+        ...Object.keys(MATH_CONSTANTS),
+        ...Object.keys(MATH_FUNCTIONS),
+    ]);
+    for (const token of wordTokens) {
+        if (BLOCKED_IDENTIFIERS.has(token))
+            return true;
+        if (!allowedTokens.has(token))
+            return true;
+    }
+    return false;
+}
+/**
+ * Replaces mathematical constants and functions in the expression
+ * with their JavaScript equivalents for safe evaluation.
+ */
+function replaceConstantsAndFunctions(expression) {
+    let result = expression;
+    // Replace constants
+    Object.entries(MATH_CONSTANTS).forEach(([name, value]) => {
+        const regex = new RegExp(`\\b${name}\\b`, 'g');
+        result = result.replace(regex, value.toString());
+    });
+    // Replace functions
+    Object.entries(MATH_FUNCTIONS).forEach(([name]) => {
+        const regex = new RegExp(`\\b${name}\\(`, 'g');
+        result = result.replace(regex, `Math.${name}(`);
+    });
+    return result;
+}
+/**
+ * Safely evaluates a mathematical expression using Function constructor
+ * instead of eval() for better security.
+ */
+function safeEvaluate(expression) {
+    // Create a function that returns the expression result
+    // This is safer than eval() as it doesn't have access to the scope
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval
+    const func = new Function('Math', `"use strict"; return (${expression});`);
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+    return func(Math);
+}
+/**
+ * Evaluates a mathematical expression and returns the result.
+ *
+ * Supports:
+ * - Basic arithmetic: +, -, *, /, **, ()
+ * - Mathematical constants: pi, e, tau, phi
+ * - Mathematical functions: sin, cos, tan, sqrt, log, etc.
+ * - Alternative notations: × (multiplication), ÷ (division), ^ (power)
+ * - European decimal notation: , instead of .
+ *
+ * @param expression The mathematical expression to evaluate
+ * @returns Evaluation result with success status and value or error
+ *
+ * @example
+ * ```typescript
+ * evaluateExpression("3 + 4 * 2") // { success: true, value: 11 }
+ * evaluateExpression("sqrt(16)") // { success: true, value: 4 }
+ * evaluateExpression("pi * 2") // { success: true, value: 6.283... }
+ * evaluateExpression("2 ^ 3") // { success: true, value: 8 }
+ * evaluateExpression("invalid") // { success: false, error: "..." }
+ * ```
+ */
+function evaluateExpression(expression) {
+    const originalExpression = expression;
+    try {
+        // Handle empty or whitespace-only expressions
+        if (!expression?.trim()) {
+            return {
+                success: false,
+                error: 'Expression cannot be empty',
+                expression: originalExpression,
+            };
+        }
+        // Sanitize the expression
+        const sanitized = sanitizeExpression(expression);
+        // Validate the expression
+        if (!isValidExpression(sanitized)) {
+            return {
+                success: false,
+                error: 'Expression contains invalid characters or syntax',
+                expression: originalExpression,
+            };
+        }
+        // Check for blocked or unknown identifiers (defense-in-depth)
+        if (containsBlockedIdentifiers(sanitized)) {
+            return {
+                success: false,
+                error: 'Expression contains invalid characters or syntax',
+                expression: originalExpression,
+            };
+        }
+        // Replace constants and functions
+        const processed = replaceConstantsAndFunctions(sanitized);
+        // Evaluate the expression
+        const result = safeEvaluate(processed);
+        // Check if result is a valid number
+        if (typeof result !== 'number' || !isFinite(result)) {
+            return {
+                success: false,
+                error: 'Expression does not evaluate to a valid number',
+                expression: originalExpression,
+            };
+        }
+        return {
+            success: true,
+            value: result,
+            expression: originalExpression,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown evaluation error',
+            expression: originalExpression,
+        };
+    }
+}
+/**
+ * Checks if a string looks like a mathematical expression
+ * (contains operators, functions, or constants)
+ */
+function isExpression(input) {
+    const trimmed = input.trim();
+    // Check for mathematical operators
+    if (/[+\-*/^×÷()]/.test(trimmed)) {
+        return true;
+    }
+    // Check for mathematical functions
+    const functionNames = Object.keys(MATH_FUNCTIONS);
+    const functionRegex = new RegExp(`\\b(${functionNames.join('|')})\\(`, 'i');
+    if (functionRegex.test(trimmed)) {
+        return true;
+    }
+    // Check for mathematical constants
+    const constantNames = Object.keys(MATH_CONSTANTS);
+    const constantRegex = new RegExp(`\\b(${constantNames.join('|')})\\b`, 'i');
+    if (constantRegex.test(trimmed)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Attempts to parse a string as either a direct number or mathematical expression
+ */
+function parseNumericInput(input) {
+    const trimmed = input.trim();
+    // Try direct number parsing first (more efficient)
+    const directNumber = parseFloat(trimmed);
+    if (!isNaN(directNumber) &&
+        isFinite(directNumber) &&
+        trimmed === directNumber.toString()) {
+        return {
+            success: true,
+            value: directNumber,
+            expression: input,
+        };
+    }
+    // Fall back to expression evaluation
+    return evaluateExpression(input);
+}
+
+export { evaluateExpression, isExpression, parseNumericInput };
+//# sourceMappingURL=mathExpression.js.map

package/dist/esm/utils/mathExpression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mathExpression.js","sources":["../../../../src/utils/mathExpression.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/utils/mathUtils.js

@@ -0,0 +1,18 @@
+/**
+ * Clamps a value between min and max bounds
+ */
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+/**
+ * Rounds a number to specified decimal places
+ */
+function roundToPrecision(value, precision) {
+    if (precision === undefined)
+        return value;
+    const factor = Math.pow(10, precision);
+    return Math.round(value * factor) / factor;
+}
+
+export { clamp, roundToPrecision };
+//# sourceMappingURL=mathUtils.js.map

package/dist/esm/utils/mathUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mathUtils.js","sources":["../../../../src/utils/mathUtils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;AAEG;SACa,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW,EAAA;AAC3D,IAAA,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC;AAC5C;AAEA;;AAEG;AACa,SAAA,gBAAgB,CAAC,KAAa,EAAE,SAAkB,EAAA;IAChE,IAAI,SAAS,KAAK,SAAS;AAAE,QAAA,OAAO,KAAK;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM;AAC5C;;;;"}

package/dist/esm/utils/objects.js

@@ -0,0 +1,22 @@
+const mergeDeep = (target, source) => {
+    const result = { ...target };
+    for (const key in source) {
+        const sourceValue = source[key];
+        const targetValue = result[key];
+        if (sourceValue &&
+            typeof sourceValue === 'object' &&
+            !Array.isArray(sourceValue) &&
+            targetValue &&
+            typeof targetValue === 'object' &&
+            !Array.isArray(targetValue)) {
+            result[key] = mergeDeep(targetValue, sourceValue);
+        }
+        else if (sourceValue !== undefined) {
+            result[key] = sourceValue;
+        }
+    }
+    return result;
+};
+
+export { mergeDeep };
+//# sourceMappingURL=objects.js.map

package/dist/esm/utils/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objects.js","sources":["../../../../src/utils/objects.ts"],"sourcesContent":[null],"names":[],"mappings":"MAEa,SAAS,GAAG,CACvB,MAAS,EACT,MAAsB,KACjB;AACL,IAAA,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE;AAC5B,IAAA,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;AACxB,QAAA,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC;AAC/B,QAAA,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC;AAE/B,QAAA,IACE,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;AAC/B,YAAA,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YAC3B,WAAW;YACX,OAAO,WAAW,KAAK,QAAQ;AAC/B,YAAA,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B;YACA,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,WAAsC,EACtC,WAAmD,CACrB;;AAC3B,aAAA,IAAI,WAAW,KAAK,SAAS,EAAE;AACpC,YAAA,MAAM,CAAC,GAAG,CAAC,GAAG,WAA0C;;;AAG5D,IAAA,OAAO,MAAM;AACf;;;;"}

package/dist/esm/utils/styledUtils.js

@@ -0,0 +1,81 @@
+/**
+ * Converts camelCase to kebab-case
+ */
+const camelToKebab = (str) => {
+    return str.replace(/([A-Z])/g, '-$1').toLowerCase();
+};
+/**
+ * Set of CSS properties (in kebab-case) that should NOT receive a `px` suffix
+ * when their value is a number. Based on the React DOM unitless properties list.
+ */
+const UNITLESS_PROPERTIES = new Set([
+    'animation-iteration-count',
+    'border-image-outset',
+    'border-image-slice',
+    'border-image-width',
+    'box-flex',
+    'box-flex-group',
+    'box-ordinal-group',
+    'column-count',
+    'columns',
+    'flex',
+    'flex-grow',
+    'flex-positive',
+    'flex-shrink',
+    'flex-negative',
+    'flex-order',
+    'grid-area',
+    'grid-column',
+    'grid-column-end',
+    'grid-column-span',
+    'grid-column-start',
+    'grid-row',
+    'grid-row-end',
+    'grid-row-span',
+    'grid-row-start',
+    'font-weight',
+    'line-clamp',
+    'line-height',
+    'opacity',
+    'order',
+    'orphans',
+    'tab-size',
+    'widows',
+    'z-index',
+    'zoom',
+    'fill-opacity',
+    'flood-opacity',
+    'stop-opacity',
+    'stroke-dasharray',
+    'stroke-dashoffset',
+    'stroke-miterlimit',
+    'stroke-opacity',
+    'stroke-width',
+]);
+/**
+ * Processes CSS properties from a CSS object or function
+ * Handles camelCase to kebab-case conversion and theme access.
+ * Numeric values are appended with 'px' unless the property is unitless.
+ */
+const processCss = (css, theme) => {
+    if (!css)
+        return '';
+    const cssObj = typeof css === 'function' ? css(theme) : css;
+    return Object.entries(cssObj)
+        .map(([key, value]) => {
+        const kebabKey = camelToKebab(key);
+        // Append 'px' to numeric values, except for 0 and unitless properties
+        const formattedValue = typeof value === 'number' &&
+            value !== 0 &&
+            !UNITLESS_PROPERTIES.has(kebabKey)
+            ? `${value}px`
+            : typeof value === 'number'
+                ? `${value}`
+                : value;
+        return `${kebabKey}: ${formattedValue};`;
+    })
+        .join('\n');
+};
+
+export { UNITLESS_PROPERTIES, camelToKebab, processCss };
+//# sourceMappingURL=styledUtils.js.map

package/dist/esm/utils/styledUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styledUtils.js","sources":["../../../../src/utils/styledUtils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGA;;AAEG;AACU,MAAA,YAAY,GAAG,CAAC,GAAW,KAAY;IAClD,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE;AACrD;AAEA;;;AAGG;AACU,MAAA,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IAC9D,2BAA2B;IAC3B,qBAAqB;IACrB,oBAAoB;IACpB,oBAAoB;IACpB,UAAU;IACV,gBAAgB;IAChB,mBAAmB;IACnB,cAAc;IACd,SAAS;IACT,MAAM;IACN,WAAW;IACX,eAAe;IACf,aAAa;IACb,eAAe;IACf,YAAY;IACZ,WAAW;IACX,aAAa;IACb,iBAAiB;IACjB,kBAAkB;IAClB,mBAAmB;IACnB,UAAU;IACV,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,aAAa;IACb,YAAY;IACZ,aAAa;IACb,SAAS;IACT,OAAO;IACP,SAAS;IACT,UAAU;IACV,QAAQ;IACR,SAAS;IACT,MAAM;IACN,cAAc;IACd,eAAe;IACf,cAAc;IACd,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,gBAAgB;IAChB,cAAc;AACf,CAAA;AAED;;;;AAIG;MACU,UAAU,GAAG,CACxB,GAGa,EACb,KAAY,KACF;AACV,IAAA,IAAI,CAAC,GAAG;AAAE,QAAA,OAAO,EAAE;AAEnB,IAAA,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG;AAE3D,IAAA,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM;SACzB,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAI;AACpB,QAAA,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC;;AAElC,QAAA,MAAM,cAAc,GAClB,OAAO,KAAK,KAAK,QAAQ;AACzB,YAAA,KAAK,KAAK,CAAC;AACX,YAAA,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ;cAC7B,CAAG,EAAA,KAAK,CAAI,EAAA;AACd,cAAE,OAAO,KAAK,KAAK;kBACf,CAAG,EAAA,KAAK,CAAE;kBACT,KAAgB;AACzB,QAAA,OAAO,CAAG,EAAA,QAAQ,CAAK,EAAA,EAAA,cAAc,GAAG;AAC1C,KAAC;SACA,IAAI,CAAC,IAAI,CAAC;AACf;;;;"}

package/dist/types/components/controls/ColorPicker/ColorPalette.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { PaletteColor } from './palettes/material.js';
+
+interface ColorPaletteProps {
+    palette: PaletteColor[];
+    currentColor: string;
+    onSelect: (color: string) => void;
+    /** Title displayed in the collapsible header @default "Palette" */
+    title?: string;
+    /** Whether the palette starts expanded @default false */
+    defaultExpanded?: boolean;
+}
+declare const ColorPalette: React.FC<ColorPaletteProps>;
+
+export { ColorPalette };
+export type { ColorPaletteProps };

package/dist/types/components/controls/ColorPicker/ColorPicker.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { ColorPickerProps } from './ColorPicker.types.js';
+
+declare const ColorPicker: React.FC<ColorPickerProps>;
+
+export { ColorPicker };

package/dist/types/components/controls/ColorPicker/ColorPicker.types.d.ts

@@ -0,0 +1,120 @@
+import { Prettify } from '../../../types/utilities.js';
+import { BaseComponent, Size } from '../../../types/common.js';
+import { ColorFormat as ColorFormat$1 } from './colorUtils.js';
+import { Palette, PaletteColor } from './palettes/material.js';
+export { PaletteShade } from './palettes/material.js';
+
+type ColorFormat = ColorFormat$1;
+type ColorPickerSize = Size;
+type ColorInputMode = 'hex' | 'rgb' | 'hsl';
+interface ColorPreset {
+    color: string;
+    label?: string;
+}
+
+interface ColorPickerBaseProps extends Omit<BaseComponent, 'onChange' | 'value' | 'defaultValue'> {
+    /**
+     * Current color value (controlled).
+     * Accepts any valid CSS color string.
+     */
+    value?: string;
+    /**
+     * Default color value (uncontrolled)
+     * @default "#007acc"
+     */
+    defaultValue?: string;
+    /**
+     * Output format for onChange
+     * @default "hex"
+     */
+    format?: ColorFormat;
+    /**
+     * Whether to show the alpha channel control
+     * @default false
+     */
+    showAlpha?: boolean;
+    /**
+     * Available input modes
+     * @default ['hex', 'rgb', 'hsl']
+     */
+    inputModes?: ColorInputMode[];
+    /**
+     * Default input mode
+     * @default "hex"
+     */
+    defaultInputMode?: ColorInputMode;
+    /**
+     * Preset color palette
+     */
+    presets?: ColorPreset[];
+    /**
+     * Swatch trigger size
+     * @default "md"
+     */
+    size?: ColorPickerSize;
+    /**
+     * Shape of the swatch trigger
+     * @default "square"
+     */
+    swatchShape?: 'square' | 'circle';
+    /**
+     * Label displayed next to the swatch
+     */
+    label?: string;
+    /**
+     * Whether the picker is disabled
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Whether the component is inline (no popover)
+     * @default false
+     */
+    inline?: boolean;
+    /**
+     * Width of the picker panel in pixels
+     * @default 240
+     */
+    pickerWidth?: number;
+    /**
+     * Callback when color changes (continuous)
+     */
+    onChange?: (color: string) => void;
+    /**
+     * Callback when color change is committed (drag end)
+     */
+    onChangeComplete?: (color: string) => void;
+    /**
+     * Whether to show the EyeDropper button (Chromium-only).
+     * Hidden automatically if browser doesn't support the EyeDropper API.
+     * @default false
+     */
+    showEyeDropper?: boolean;
+    /**
+     * Built-in color palette or custom palette data.
+     * - `'material'` — Material Design colors (19 hues × 10 shades)
+     * - `'tailwind'` — Tailwind CSS colors (22 hues × 11 shades)
+     * - `'pastel'` — Soft pastel colors
+     * - `'earth'` — Natural earth tones
+     * - `'neon'` — High-saturation neon colors
+     * - `'monochrome'` — Neutral, warm, and cool grays
+     * - `'skin-tones'` — Portrait/illustration skin palette
+     * - `'vintage'` — Desaturated retro film colors
+     * - `Palette` — custom palette with name
+     * - `PaletteColor[]` — custom palette data (legacy)
+     */
+    palette?: 'material' | 'tailwind' | 'pastel' | 'earth' | 'neon' | 'monochrome' | 'skin-tones' | 'vintage' | Palette | PaletteColor[];
+}
+type ColorPickerProps = Prettify<ColorPickerBaseProps>;
+interface ColorSwatchProps extends BaseComponent<HTMLButtonElement> {
+    color: string;
+    size?: ColorPickerSize;
+    shape?: 'square' | 'circle';
+    disabled?: boolean;
+    onClick?: () => void;
+    'aria-label'?: string;
+}
+type ColorSwatchPublicProps = Prettify<ColorSwatchProps>;
+
+export { Palette, PaletteColor };
+export type { ColorFormat, ColorInputMode, ColorPickerBaseProps, ColorPickerProps, ColorPickerSize, ColorPreset, ColorSwatchProps, ColorSwatchPublicProps };

package/dist/types/components/controls/ColorPicker/ColorSwatch.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { ColorSwatchProps } from './ColorPicker.types.js';
+
+declare const ColorSwatch: React.NamedExoticComponent<ColorSwatchProps>;
+
+export { ColorSwatch };

package/dist/types/components/controls/ColorPicker/EyeDropper.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import { Prettify } from '../../../types/utilities.js';
+import { BaseComponent, Size } from '../../../types/common.js';
+
+interface EyeDropperBaseProps extends Omit<BaseComponent<HTMLButtonElement>, 'onChange'> {
+    /** Callback when a color is picked */
+    onColorPick?: (color: string) => void;
+    /** Button size @default "md" */
+    size?: Size;
+    /** Whether disabled @default false */
+    disabled?: boolean;
+}
+type EyeDropperProps = Prettify<EyeDropperBaseProps>;
+/**
+ * EyeDropper button that opens the native browser EyeDropper API
+ * to sample a color from anywhere on the screen.
+ *
+ * Renders nothing if the EyeDropper API is not available in the browser.
+ *
+ * @example
+ * ```tsx
+ * <EyeDropper onColorPick={(hex) => setColor(hex)} />
+ * ```
+ */
+declare const EyeDropper: React.FC<EyeDropperProps>;
+
+export { EyeDropper };
+export type { EyeDropperProps };

package/dist/types/components/controls/ColorPicker/colorUtils.d.ts

@@ -0,0 +1,3 @@
+type ColorFormat = 'hex' | 'hex8' | 'rgb' | 'rgba' | 'hsl' | 'hsla';
+
+export type { ColorFormat };

package/dist/types/components/controls/ColorPicker/palettes/material.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Material Design color palette
+ *
+ * Contains 19 color families with 10 shades each (50-900).
+ * Based on the official Material Design color system.
+ */
+interface PaletteShade {
+    label: string;
+    color: string;
+}
+interface PaletteColor {
+    name: string;
+    shades: PaletteShade[];
+}
+interface Palette {
+    /** Display name for the palette (e.g. "Material Design") */
+    name: string;
+    /** Color families in this palette */
+    colors: PaletteColor[];
+}
+declare const MATERIAL_PALETTE: Palette;
+
+export { MATERIAL_PALETTE };
+export type { Palette, PaletteColor, PaletteShade };

package/dist/types/components/controls/ColorPicker/palettes/professional.d.ts

@@ -0,0 +1,19 @@
+import { Palette } from './material.js';
+
+/**
+ * Professional color palettes for creative workflows.
+ *
+ * Inspired by palettes found in Photoshop, Affinity Photo,
+ * and other professional creative tools.
+ */
+
+declare const PASTEL_PALETTE: Palette;
+declare const EARTH_PALETTE: Palette;
+declare const NEON_PALETTE: Palette;
+declare const MONOCHROME_PALETTE: Palette;
+declare const SKIN_TONES_PALETTE: Palette;
+declare const VINTAGE_PALETTE: Palette;
+/** All professional palettes as a convenience array */
+declare const PROFESSIONAL_PALETTES: Palette[];
+
+export { EARTH_PALETTE, MONOCHROME_PALETTE, NEON_PALETTE, PASTEL_PALETTE, PROFESSIONAL_PALETTES, SKIN_TONES_PALETTE, VINTAGE_PALETTE };

package/dist/types/components/controls/ColorPicker/palettes/tailwind.d.ts

@@ -0,0 +1,12 @@
+import { Palette } from './material.js';
+
+/**
+ * Tailwind CSS color palette
+ *
+ * Contains 22 color families with 11 shades each (50-950).
+ * Based on the official Tailwind CSS color system.
+ */
+
+declare const TAILWIND_PALETTE: Palette;
+
+export { TAILWIND_PALETTE };

package/dist/types/components/controls/CurveEditor/CurveEditor.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { CurveEditorProps } from './CurveEditor.types.js';
+
+declare const CurveEditor: React.FC<CurveEditorProps>;
+
+export { CurveEditor };