dialkit 0.2.1 → 1.0.0

package/dist/index.d.cts

@@ -10,6 +10,12 @@ type SpringConfig = {
     visualDuration?: number;
     bounce?: number;
 };
+type EasingConfig = {
+    type: 'easing';
+    duration: number;
+    ease: [number, number, number, number];
+};
+type TransitionConfig = SpringConfig | EasingConfig;
 type ActionConfig = {
     type: 'action';
     label?: string;
@@ -31,21 +37,22 @@ type TextConfig = {
     default?: string;
     placeholder?: string;
 };
-type DialValue = number | boolean | string | SpringConfig | ActionConfig | SelectConfig | ColorConfig | TextConfig;
+type DialValue = number | boolean | string | SpringConfig | EasingConfig | ActionConfig | SelectConfig | ColorConfig | TextConfig;
 type DialConfig = {
-    [key: string]: DialValue | [number, number, number] | DialConfig;
+    [key: string]: DialValue | [number, number, number, number?] | DialConfig;
 };
 type ResolvedValues<T extends DialConfig> = {
-    [K in keyof T]: T[K] extends [number, number, number] ? number : T[K] extends SpringConfig ? SpringConfig : T[K] extends SelectConfig ? string : T[K] extends ColorConfig ? string : T[K] extends TextConfig ? string : T[K] extends DialConfig ? ResolvedValues<T[K]> : T[K];
+    [K in keyof T]: T[K] extends [number, number, number, number?] ? number : T[K] extends SpringConfig ? TransitionConfig : T[K] extends EasingConfig ? TransitionConfig : T[K] extends SelectConfig ? string : T[K] extends ColorConfig ? string : T[K] extends TextConfig ? string : T[K] extends DialConfig ? ResolvedValues<T[K]> : T[K];
 };
 type ControlMeta = {
-    type: 'slider' | 'toggle' | 'spring' | 'folder' | 'action' | 'select' | 'color' | 'text';
+    type: 'slider' | 'toggle' | 'spring' | 'transition' | 'folder' | 'action' | 'select' | 'color' | 'text';
     path: string;
     label: string;
     min?: number;
     max?: number;
     step?: number;
     children?: ControlMeta[];
+    defaultOpen?: boolean;
     options?: (string | {
         value: string;
         label: string;
@@ -75,10 +82,13 @@ declare class DialStoreClass {
     private activePreset;
     private baseValues;
     registerPanel(id: string, name: string, config: DialConfig): void;
+    updatePanel(id: string, name: string, config: DialConfig): void;
     unregisterPanel(id: string): void;
     updateValue(panelId: string, path: string, value: DialValue): void;
     updateSpringMode(panelId: string, path: string, mode: 'simple' | 'advanced'): void;
     getSpringMode(panelId: string, path: string): 'simple' | 'advanced';
+    updateTransitionMode(panelId: string, path: string, mode: 'easing' | 'simple' | 'advanced'): void;
+    getTransitionMode(panelId: string, path: string): 'easing' | 'simple' | 'advanced';
     getValue(panelId: string, path: string): DialValue | undefined;
     getValues(panelId: string): Record<string, DialValue>;
     getPanels(): PanelConfig[];
@@ -95,9 +105,11 @@ declare class DialStoreClass {
     clearActivePreset(panelId: string): void;
     private notify;
     private notifyGlobal;
+    private initTransitionModes;
     private parseConfig;
     private flattenValues;
     private isSpringConfig;
+    private isEasingConfig;
     private isActionConfig;
     private isSelectConfig;
     private isColorConfig;
@@ -106,6 +118,10 @@ declare class DialStoreClass {
     private formatLabel;
     private inferRange;
     private inferStep;
+    private normalizePreservedValue;
+    private roundToStep;
+    private stepPrecision;
+    private mapControlsByPath;
 }
 declare const DialStore: DialStoreClass;
 
@@ -117,8 +133,9 @@ declare function useDialKit<T extends DialConfig>(name: string, config: T, optio
 type DialPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
 interface DialRootProps {
     position?: DialPosition;
+    defaultOpen?: boolean;
 }
-declare function DialRoot({ position }: DialRootProps): react.ReactPortal | null;
+declare function DialRoot({ position, defaultOpen }: DialRootProps): react.ReactPortal | null;
 
 interface SliderProps {
     label: string;
@@ -171,6 +188,20 @@ interface SpringVisualizationProps {
 }
 declare function SpringVisualization({ spring, isSimpleMode }: SpringVisualizationProps): react_jsx_runtime.JSX.Element;
 
+interface TransitionControlProps {
+    panelId: string;
+    path: string;
+    label: string;
+    value: TransitionConfig;
+    onChange: (value: TransitionConfig) => void;
+}
+declare function TransitionControl({ panelId, path, label, value, onChange }: TransitionControlProps): react_jsx_runtime.JSX.Element;
+
+interface EasingVisualizationProps {
+    easing: EasingConfig;
+}
+declare function EasingVisualization({ easing }: EasingVisualizationProps): react_jsx_runtime.JSX.Element;
+
 interface TextControlProps {
     label: string;
     value: string;
@@ -206,4 +237,4 @@ interface PresetManagerProps {
 }
 declare function PresetManager({ panelId, presets, activePresetId, onAdd }: PresetManagerProps): react_jsx_runtime.JSX.Element;
 
-export { type ActionConfig, ButtonGroup, type ColorConfig, ColorControl, type ControlMeta, type DialConfig, type DialPosition, DialRoot, DialStore, type DialValue, Folder, type PanelConfig, type Preset, PresetManager, type ResolvedValues, type SelectConfig, SelectControl, Slider, type SpringConfig, SpringControl, SpringVisualization, type TextConfig, TextControl, Toggle, type UseDialOptions, useDialKit };
+export { type ActionConfig, ButtonGroup, type ColorConfig, ColorControl, type ControlMeta, type DialConfig, type DialPosition, DialRoot, DialStore, type DialValue, type EasingConfig, EasingVisualization, Folder, type PanelConfig, type Preset, PresetManager, type ResolvedValues, type SelectConfig, SelectControl, Slider, type SpringConfig, SpringControl, SpringVisualization, type TextConfig, TextControl, Toggle, type TransitionConfig, TransitionControl, type UseDialOptions, useDialKit };

package/dist/index.d.ts

@@ -10,6 +10,12 @@ type SpringConfig = {
     visualDuration?: number;
     bounce?: number;
 };
+type EasingConfig = {
+    type: 'easing';
+    duration: number;
+    ease: [number, number, number, number];
+};
+type TransitionConfig = SpringConfig | EasingConfig;
 type ActionConfig = {
     type: 'action';
     label?: string;
@@ -31,21 +37,22 @@ type TextConfig = {
     default?: string;
     placeholder?: string;
 };
-type DialValue = number | boolean | string | SpringConfig | ActionConfig | SelectConfig | ColorConfig | TextConfig;
+type DialValue = number | boolean | string | SpringConfig | EasingConfig | ActionConfig | SelectConfig | ColorConfig | TextConfig;
 type DialConfig = {
-    [key: string]: DialValue | [number, number, number] | DialConfig;
+    [key: string]: DialValue | [number, number, number, number?] | DialConfig;
 };
 type ResolvedValues<T extends DialConfig> = {
-    [K in keyof T]: T[K] extends [number, number, number] ? number : T[K] extends SpringConfig ? SpringConfig : T[K] extends SelectConfig ? string : T[K] extends ColorConfig ? string : T[K] extends TextConfig ? string : T[K] extends DialConfig ? ResolvedValues<T[K]> : T[K];
+    [K in keyof T]: T[K] extends [number, number, number, number?] ? number : T[K] extends SpringConfig ? TransitionConfig : T[K] extends EasingConfig ? TransitionConfig : T[K] extends SelectConfig ? string : T[K] extends ColorConfig ? string : T[K] extends TextConfig ? string : T[K] extends DialConfig ? ResolvedValues<T[K]> : T[K];
 };
 type ControlMeta = {
-    type: 'slider' | 'toggle' | 'spring' | 'folder' | 'action' | 'select' | 'color' | 'text';
+    type: 'slider' | 'toggle' | 'spring' | 'transition' | 'folder' | 'action' | 'select' | 'color' | 'text';
     path: string;
     label: string;
     min?: number;
     max?: number;
     step?: number;
     children?: ControlMeta[];
+    defaultOpen?: boolean;
     options?: (string | {
         value: string;
         label: string;
@@ -75,10 +82,13 @@ declare class DialStoreClass {
     private activePreset;
     private baseValues;
     registerPanel(id: string, name: string, config: DialConfig): void;
+    updatePanel(id: string, name: string, config: DialConfig): void;
     unregisterPanel(id: string): void;
     updateValue(panelId: string, path: string, value: DialValue): void;
     updateSpringMode(panelId: string, path: string, mode: 'simple' | 'advanced'): void;
     getSpringMode(panelId: string, path: string): 'simple' | 'advanced';
+    updateTransitionMode(panelId: string, path: string, mode: 'easing' | 'simple' | 'advanced'): void;
+    getTransitionMode(panelId: string, path: string): 'easing' | 'simple' | 'advanced';
     getValue(panelId: string, path: string): DialValue | undefined;
     getValues(panelId: string): Record<string, DialValue>;
     getPanels(): PanelConfig[];
@@ -95,9 +105,11 @@ declare class DialStoreClass {
     clearActivePreset(panelId: string): void;
     private notify;
     private notifyGlobal;
+    private initTransitionModes;
     private parseConfig;
     private flattenValues;
     private isSpringConfig;
+    private isEasingConfig;
     private isActionConfig;
     private isSelectConfig;
     private isColorConfig;
@@ -106,6 +118,10 @@ declare class DialStoreClass {
     private formatLabel;
     private inferRange;
     private inferStep;
+    private normalizePreservedValue;
+    private roundToStep;
+    private stepPrecision;
+    private mapControlsByPath;
 }
 declare const DialStore: DialStoreClass;
 
@@ -117,8 +133,9 @@ declare function useDialKit<T extends DialConfig>(name: string, config: T, optio
 type DialPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
 interface DialRootProps {
     position?: DialPosition;
+    defaultOpen?: boolean;
 }
-declare function DialRoot({ position }: DialRootProps): react.ReactPortal | null;
+declare function DialRoot({ position, defaultOpen }: DialRootProps): react.ReactPortal | null;
 
 interface SliderProps {
     label: string;
@@ -171,6 +188,20 @@ interface SpringVisualizationProps {
 }
 declare function SpringVisualization({ spring, isSimpleMode }: SpringVisualizationProps): react_jsx_runtime.JSX.Element;
 
+interface TransitionControlProps {
+    panelId: string;
+    path: string;
+    label: string;
+    value: TransitionConfig;
+    onChange: (value: TransitionConfig) => void;
+}
+declare function TransitionControl({ panelId, path, label, value, onChange }: TransitionControlProps): react_jsx_runtime.JSX.Element;
+
+interface EasingVisualizationProps {
+    easing: EasingConfig;
+}
+declare function EasingVisualization({ easing }: EasingVisualizationProps): react_jsx_runtime.JSX.Element;
+
 interface TextControlProps {
     label: string;
     value: string;
@@ -206,4 +237,4 @@ interface PresetManagerProps {
 }
 declare function PresetManager({ panelId, presets, activePresetId, onAdd }: PresetManagerProps): react_jsx_runtime.JSX.Element;
 
-export { type ActionConfig, ButtonGroup, type ColorConfig, ColorControl, type ControlMeta, type DialConfig, type DialPosition, DialRoot, DialStore, type DialValue, Folder, type PanelConfig, type Preset, PresetManager, type ResolvedValues, type SelectConfig, SelectControl, Slider, type SpringConfig, SpringControl, SpringVisualization, type TextConfig, TextControl, Toggle, type UseDialOptions, useDialKit };
+export { type ActionConfig, ButtonGroup, type ColorConfig, ColorControl, type ControlMeta, type DialConfig, type DialPosition, DialRoot, DialStore, type DialValue, type EasingConfig, EasingVisualization, Folder, type PanelConfig, type Preset, PresetManager, type ResolvedValues, type SelectConfig, SelectControl, Slider, type SpringConfig, SpringControl, SpringVisualization, type TextConfig, TextControl, Toggle, type TransitionConfig, TransitionControl, type UseDialOptions, useDialKit };