dialkit 0.2.2 → 1.0.0

package/dist/solid/index.d.cts

@@ -0,0 +1,225 @@
+import * as solid_js from 'solid-js';
+import { Accessor, JSX } from 'solid-js';
+
+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 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;
+};
+type PanelConfig = {
+    id: string;
+    name: string;
+    controls: ControlMeta[];
+    values: Record<string, DialValue>;
+};
+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): 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[];
+    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;
+    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;
+
+interface CreateDialOptions {
+    onAction?: (action: string) => void;
+}
+declare function createDialKit<T extends DialConfig>(name: string, config: T, options?: CreateDialOptions): Accessor<ResolvedValues<T>>;
+
+type DialPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+interface DialRootProps {
+    position?: DialPosition;
+    defaultOpen?: boolean;
+}
+declare function DialRoot(props: DialRootProps): solid_js.JSX.Element;
+
+interface SliderProps {
+    label: string;
+    value: number;
+    onChange: (value: number) => void;
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+}
+declare function Slider(props: SliderProps): solid_js.JSX.Element;
+
+interface ToggleProps {
+    label: string;
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+}
+declare function Toggle(props: ToggleProps): solid_js.JSX.Element;
+
+interface FolderProps {
+    title: string;
+    children: JSX.Element;
+    defaultOpen?: boolean;
+    isRoot?: boolean;
+    onOpenChange?: (isOpen: boolean) => void;
+    toolbar?: JSX.Element;
+}
+declare function Folder(props: FolderProps): JSX.Element;
+
+interface ButtonGroupProps {
+    buttons: Array<{
+        label: string;
+        onClick: () => void;
+    }>;
+}
+declare function ButtonGroup(props: ButtonGroupProps): solid_js.JSX.Element;
+
+interface SpringControlProps {
+    panelId: string;
+    path: string;
+    label: string;
+    spring: SpringConfig;
+    onChange: (spring: SpringConfig) => void;
+}
+declare function SpringControl(props: SpringControlProps): solid_js.JSX.Element;
+
+interface SpringVisualizationProps {
+    spring: SpringConfig;
+    isSimpleMode: boolean;
+}
+declare function SpringVisualization(props: SpringVisualizationProps): solid_js.JSX.Element;
+
+interface TextControlProps {
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+}
+declare function TextControl(props: TextControlProps): solid_js.JSX.Element;
+
+type SelectOption = string | {
+    value: string;
+    label: string;
+};
+interface SelectControlProps {
+    label: string;
+    value: string;
+    options: SelectOption[];
+    onChange: (value: string) => void;
+}
+declare function SelectControl(props: SelectControlProps): solid_js.JSX.Element;
+
+interface ColorControlProps {
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+}
+declare function ColorControl(props: ColorControlProps): solid_js.JSX.Element;
+
+interface PresetManagerProps {
+    panelId: string;
+    presets: Preset[];
+    activePresetId: string | null;
+    onAdd: () => void;
+}
+declare function PresetManager(props: PresetManagerProps): solid_js.JSX.Element;
+
+export { type ActionConfig, ButtonGroup, type ColorConfig, ColorControl, type ControlMeta, type CreateDialOptions, 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, createDialKit };

package/dist/solid/index.d.ts

@@ -0,0 +1,225 @@
+import * as solid_js from 'solid-js';
+import { Accessor, JSX } from 'solid-js';
+
+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 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;
+};
+type PanelConfig = {
+    id: string;
+    name: string;
+    controls: ControlMeta[];
+    values: Record<string, DialValue>;
+};
+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): 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[];
+    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;
+    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;
+
+interface CreateDialOptions {
+    onAction?: (action: string) => void;
+}
+declare function createDialKit<T extends DialConfig>(name: string, config: T, options?: CreateDialOptions): Accessor<ResolvedValues<T>>;
+
+type DialPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+interface DialRootProps {
+    position?: DialPosition;
+    defaultOpen?: boolean;
+}
+declare function DialRoot(props: DialRootProps): solid_js.JSX.Element;
+
+interface SliderProps {
+    label: string;
+    value: number;
+    onChange: (value: number) => void;
+    min?: number;
+    max?: number;
+    step?: number;
+    unit?: string;
+}
+declare function Slider(props: SliderProps): solid_js.JSX.Element;
+
+interface ToggleProps {
+    label: string;
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+}
+declare function Toggle(props: ToggleProps): solid_js.JSX.Element;
+
+interface FolderProps {
+    title: string;
+    children: JSX.Element;
+    defaultOpen?: boolean;
+    isRoot?: boolean;
+    onOpenChange?: (isOpen: boolean) => void;
+    toolbar?: JSX.Element;
+}
+declare function Folder(props: FolderProps): JSX.Element;
+
+interface ButtonGroupProps {
+    buttons: Array<{
+        label: string;
+        onClick: () => void;
+    }>;
+}
+declare function ButtonGroup(props: ButtonGroupProps): solid_js.JSX.Element;
+
+interface SpringControlProps {
+    panelId: string;
+    path: string;
+    label: string;
+    spring: SpringConfig;
+    onChange: (spring: SpringConfig) => void;
+}
+declare function SpringControl(props: SpringControlProps): solid_js.JSX.Element;
+
+interface SpringVisualizationProps {
+    spring: SpringConfig;
+    isSimpleMode: boolean;
+}
+declare function SpringVisualization(props: SpringVisualizationProps): solid_js.JSX.Element;
+
+interface TextControlProps {
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+}
+declare function TextControl(props: TextControlProps): solid_js.JSX.Element;
+
+type SelectOption = string | {
+    value: string;
+    label: string;
+};
+interface SelectControlProps {
+    label: string;
+    value: string;
+    options: SelectOption[];
+    onChange: (value: string) => void;
+}
+declare function SelectControl(props: SelectControlProps): solid_js.JSX.Element;
+
+interface ColorControlProps {
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+}
+declare function ColorControl(props: ColorControlProps): solid_js.JSX.Element;
+
+interface PresetManagerProps {
+    panelId: string;
+    presets: Preset[];
+    activePresetId: string | null;
+    onAdd: () => void;
+}
+declare function PresetManager(props: PresetManagerProps): solid_js.JSX.Element;
+
+export { type ActionConfig, ButtonGroup, type ColorConfig, ColorControl, type ControlMeta, type CreateDialOptions, 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, createDialKit };