dialkit 1.0.0 → 1.2.0

package/dist/store/index.d.cts

@@ -0,0 +1,146 @@
+type SpringConfig = {
+    type: 'spring';
+    stiffness?: number;
+    damping?: number;
+    mass?: number;
+    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;
+};
+type SelectConfig = {
+    type: 'select';
+    options: (string | {
+        value: string;
+        label: string;
+    })[];
+    default?: string;
+};
+type ColorConfig = {
+    type: 'color';
+    default?: string;
+};
+type TextConfig = {
+    type: 'text';
+    default?: string;
+    placeholder?: string;
+};
+type DialValue = number | boolean | string | SpringConfig | EasingConfig | ActionConfig | SelectConfig | ColorConfig | TextConfig;
+type 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?] ? 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 ShortcutMode = 'fine' | 'normal' | 'coarse';
+type ShortcutInteraction = 'scroll' | 'drag' | 'move' | 'scroll-only';
+type ShortcutConfig = {
+    key?: string;
+    modifier?: 'alt' | 'shift' | 'meta';
+    mode?: ShortcutMode;
+    interaction?: ShortcutInteraction;
+};
+type ControlMeta = {
+    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;
+    })[];
+    placeholder?: string;
+    shortcut?: ShortcutConfig;
+};
+type PanelConfig = {
+    id: string;
+    name: string;
+    controls: ControlMeta[];
+    values: Record<string, DialValue>;
+    shortcuts: Record<string, ShortcutConfig>;
+};
+type Listener = () => void;
+type ActionListener = (action: string) => void;
+type Preset = {
+    id: string;
+    name: string;
+    values: Record<string, DialValue>;
+};
+declare class DialStoreClass {
+    private panels;
+    private listeners;
+    private globalListeners;
+    private snapshots;
+    private actionListeners;
+    private presets;
+    private activePreset;
+    private baseValues;
+    registerPanel(id: string, name: string, config: DialConfig, shortcuts?: Record<string, ShortcutConfig>): void;
+    updatePanel(id: string, name: string, config: DialConfig, shortcuts?: Record<string, ShortcutConfig>): 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[];
+    getPanel(id: string): PanelConfig | undefined;
+    subscribe(panelId: string, listener: Listener): () => void;
+    subscribeGlobal(listener: Listener): () => void;
+    subscribeActions(panelId: string, listener: ActionListener): () => void;
+    triggerAction(panelId: string, path: string): void;
+    savePreset(panelId: string, name: string): string;
+    loadPreset(panelId: string, presetId: string): void;
+    deletePreset(panelId: string, presetId: string): void;
+    getPresets(panelId: string): Preset[];
+    getActivePresetId(panelId: string): string | null;
+    clearActivePreset(panelId: string): void;
+    resolveShortcutTarget(key: string, modifier?: 'alt' | 'shift' | 'meta'): {
+        panelId: string;
+        path: string;
+        control: ControlMeta;
+    } | null;
+    resolveScrollOnlyTargets(): Array<{
+        panelId: string;
+        path: string;
+        control: ControlMeta;
+        shortcut: ShortcutConfig;
+    }>;
+    private findControlByPath;
+    private notify;
+    private notifyGlobal;
+    private initTransitionModes;
+    private parseConfig;
+    private flattenValues;
+    private isSpringConfig;
+    private isEasingConfig;
+    private isActionConfig;
+    private isSelectConfig;
+    private isColorConfig;
+    private isTextConfig;
+    private isHexColor;
+    private formatLabel;
+    private inferRange;
+    private inferStep;
+    private normalizePreservedValue;
+    private roundToStep;
+    private stepPrecision;
+    private mapControlsByPath;
+}
+declare const DialStore: DialStoreClass;
+
+export { type ActionConfig, type ColorConfig, type ControlMeta, type DialConfig, DialStore, type DialValue, type EasingConfig, type PanelConfig, type Preset, type ResolvedValues, type SelectConfig, type ShortcutConfig, type ShortcutInteraction, type ShortcutMode, type SpringConfig, type TextConfig, type TransitionConfig };

package/dist/store/index.d.ts

@@ -0,0 +1,146 @@
+type SpringConfig = {
+    type: 'spring';
+    stiffness?: number;
+    damping?: number;
+    mass?: number;
+    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;
+};
+type SelectConfig = {
+    type: 'select';
+    options: (string | {
+        value: string;
+        label: string;
+    })[];
+    default?: string;
+};
+type ColorConfig = {
+    type: 'color';
+    default?: string;
+};
+type TextConfig = {
+    type: 'text';
+    default?: string;
+    placeholder?: string;
+};
+type DialValue = number | boolean | string | SpringConfig | EasingConfig | ActionConfig | SelectConfig | ColorConfig | TextConfig;
+type 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?] ? 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 ShortcutMode = 'fine' | 'normal' | 'coarse';
+type ShortcutInteraction = 'scroll' | 'drag' | 'move' | 'scroll-only';
+type ShortcutConfig = {
+    key?: string;
+    modifier?: 'alt' | 'shift' | 'meta';
+    mode?: ShortcutMode;
+    interaction?: ShortcutInteraction;
+};
+type ControlMeta = {
+    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;
+    })[];
+    placeholder?: string;
+    shortcut?: ShortcutConfig;
+};
+type PanelConfig = {
+    id: string;
+    name: string;
+    controls: ControlMeta[];
+    values: Record<string, DialValue>;
+    shortcuts: Record<string, ShortcutConfig>;
+};
+type Listener = () => void;
+type ActionListener = (action: string) => void;
+type Preset = {
+    id: string;
+    name: string;
+    values: Record<string, DialValue>;
+};
+declare class DialStoreClass {
+    private panels;
+    private listeners;
+    private globalListeners;
+    private snapshots;
+    private actionListeners;
+    private presets;
+    private activePreset;
+    private baseValues;
+    registerPanel(id: string, name: string, config: DialConfig, shortcuts?: Record<string, ShortcutConfig>): void;
+    updatePanel(id: string, name: string, config: DialConfig, shortcuts?: Record<string, ShortcutConfig>): 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[];
+    getPanel(id: string): PanelConfig | undefined;
+    subscribe(panelId: string, listener: Listener): () => void;
+    subscribeGlobal(listener: Listener): () => void;
+    subscribeActions(panelId: string, listener: ActionListener): () => void;
+    triggerAction(panelId: string, path: string): void;
+    savePreset(panelId: string, name: string): string;
+    loadPreset(panelId: string, presetId: string): void;
+    deletePreset(panelId: string, presetId: string): void;
+    getPresets(panelId: string): Preset[];
+    getActivePresetId(panelId: string): string | null;
+    clearActivePreset(panelId: string): void;
+    resolveShortcutTarget(key: string, modifier?: 'alt' | 'shift' | 'meta'): {
+        panelId: string;
+        path: string;
+        control: ControlMeta;
+    } | null;
+    resolveScrollOnlyTargets(): Array<{
+        panelId: string;
+        path: string;
+        control: ControlMeta;
+        shortcut: ShortcutConfig;
+    }>;
+    private findControlByPath;
+    private notify;
+    private notifyGlobal;
+    private initTransitionModes;
+    private parseConfig;
+    private flattenValues;
+    private isSpringConfig;
+    private isEasingConfig;
+    private isActionConfig;
+    private isSelectConfig;
+    private isColorConfig;
+    private isTextConfig;
+    private isHexColor;
+    private formatLabel;
+    private inferRange;
+    private inferStep;
+    private normalizePreservedValue;
+    private roundToStep;
+    private stepPrecision;
+    private mapControlsByPath;
+}
+declare const DialStore: DialStoreClass;
+
+export { type ActionConfig, type ColorConfig, type ControlMeta, type DialConfig, DialStore, type DialValue, type EasingConfig, type PanelConfig, type Preset, type ResolvedValues, type SelectConfig, type ShortcutConfig, type ShortcutInteraction, type ShortcutMode, type SpringConfig, type TextConfig, type TransitionConfig };