dialkit 1.1.0 → 1.2.1

package/dist/shortcut-utils.d.ts

@@ -0,0 +1,39 @@
+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;
+};
+
+declare function decimalsForStep(step: number): number;
+declare function roundValue(val: number, step: number): number;
+declare function getEffectiveStep(control: ControlMeta, shortcut: ShortcutConfig): number;
+declare function applySliderDelta(panelId: string, path: string, control: ControlMeta, effectiveStep: number, direction: number): void;
+declare function snapToDecile(rawValue: number, min: number, max: number): number;
+declare function isInputFocused(): boolean;
+declare function getActiveModifier(e: KeyboardEvent | WheelEvent | MouseEvent): 'alt' | 'shift' | 'meta' | undefined;
+declare function findControl(controls: ControlMeta[], path: string): ControlMeta | null;
+declare const DRAG_SENSITIVITY = 4;
+declare function formatInteractionLabel(interaction: string): string;
+declare function formatSliderShortcut(sc: ShortcutConfig): string;
+declare function formatToggleShortcut(sc: ShortcutConfig): string;
+
+export { DRAG_SENSITIVITY, applySliderDelta, decimalsForStep, findControl, formatInteractionLabel, formatSliderShortcut, formatToggleShortcut, getActiveModifier, getEffectiveStep, isInputFocused, roundValue, snapToDecile };

package/dist/shortcut-utils.js

@@ -0,0 +1,100 @@
+// src/shortcut-utils.ts
+import { DialStore } from "dialkit/store";
+function decimalsForStep(step) {
+  const s = step.toString();
+  const dot = s.indexOf(".");
+  return dot === -1 ? 0 : s.length - dot - 1;
+}
+function roundValue(val, step) {
+  const raw = Math.round(val / step) * step;
+  return parseFloat(raw.toFixed(decimalsForStep(step)));
+}
+function getEffectiveStep(control, shortcut) {
+  const min = control.min ?? 0;
+  const max = control.max ?? 1;
+  const range = max - min;
+  const mode = shortcut.mode ?? "normal";
+  return mode === "fine" ? range * 0.01 : mode === "coarse" ? range * 0.1 : control.step ?? 1;
+}
+function applySliderDelta(panelId, path, control, effectiveStep, direction) {
+  const currentValue = DialStore.getValue(panelId, path);
+  const min = control.min ?? 0;
+  const max = control.max ?? 1;
+  const newValue = Math.max(min, Math.min(max, currentValue + direction * effectiveStep));
+  DialStore.updateValue(panelId, path, roundValue(newValue, effectiveStep));
+}
+function snapToDecile(rawValue, min, max) {
+  const normalized = (rawValue - min) / (max - min);
+  const nearest = Math.round(normalized * 10) / 10;
+  if (Math.abs(normalized - nearest) <= 0.03125) {
+    return min + nearest * (max - min);
+  }
+  return rawValue;
+}
+function isInputFocused() {
+  const el = document.activeElement;
+  if (!el) return false;
+  const tag = el.tagName;
+  if (tag === "INPUT" || tag === "TEXTAREA") return true;
+  if (el.contentEditable === "true") return true;
+  return false;
+}
+function getActiveModifier(e) {
+  if (e.altKey) return "alt";
+  if (e.shiftKey) return "shift";
+  if (e.metaKey) return "meta";
+  return void 0;
+}
+function findControl(controls, path) {
+  for (const control of controls) {
+    if (control.path === path) return control;
+    if (control.type === "folder" && control.children) {
+      const found = findControl(control.children, path);
+      if (found) return found;
+    }
+  }
+  return null;
+}
+var DRAG_SENSITIVITY = 4;
+function formatInteractionLabel(interaction) {
+  switch (interaction) {
+    case "drag":
+      return "Drag";
+    case "move":
+      return "Move";
+    case "scroll-only":
+      return "Scroll";
+    default:
+      return "Scroll";
+  }
+}
+function formatSliderShortcut(sc) {
+  const interaction = sc.interaction ?? "scroll";
+  const actionLabel = formatInteractionLabel(interaction);
+  if (!sc.key) return actionLabel;
+  const mod = formatModifier(sc.modifier);
+  return `${mod}${sc.key.toUpperCase()}+${actionLabel}`;
+}
+function formatToggleShortcut(sc) {
+  if (!sc.key) return "Press";
+  const mod = formatModifier(sc.modifier);
+  return `${mod}${sc.key.toUpperCase()}`;
+}
+function formatModifier(modifier) {
+  return modifier === "alt" ? "\u2325" : modifier === "shift" ? "\u21E7" : modifier === "meta" ? "\u2318" : "";
+}
+export {
+  DRAG_SENSITIVITY,
+  applySliderDelta,
+  decimalsForStep,
+  findControl,
+  formatInteractionLabel,
+  formatSliderShortcut,
+  formatToggleShortcut,
+  getActiveModifier,
+  getEffectiveStep,
+  isInputFocused,
+  roundValue,
+  snapToDecile
+};
+//# sourceMappingURL=shortcut-utils.js.map

package/dist/shortcut-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shortcut-utils.ts"],"sourcesContent":["// Shared shortcut utilities — single source of truth across all framework adapters.\n\nimport { DialStore } from './store/DialStore';\nimport type { ControlMeta, ShortcutConfig } from './store/DialStore';\n\n// ── Math helpers ──\n\nexport function decimalsForStep(step: number): number {\n  const s = step.toString();\n  const dot = s.indexOf('.');\n  return dot === -1 ? 0 : s.length - dot - 1;\n}\n\nexport function roundValue(val: number, step: number): number {\n  const raw = Math.round(val / step) * step;\n  return parseFloat(raw.toFixed(decimalsForStep(step)));\n}\n\nexport function getEffectiveStep(control: ControlMeta, shortcut: ShortcutConfig): number {\n  const min = control.min ?? 0;\n  const max = control.max ?? 1;\n  const range = max - min;\n  const mode = shortcut.mode ?? 'normal';\n  return mode === 'fine' ? range * 0.01\n    : mode === 'coarse' ? range * 0.1\n    : control.step ?? 1;\n}\n\nexport function applySliderDelta(\n  panelId: string,\n  path: string,\n  control: ControlMeta,\n  effectiveStep: number,\n  direction: number\n): void {\n  const currentValue = DialStore.getValue(panelId, path) as number;\n  const min = control.min ?? 0;\n  const max = control.max ?? 1;\n  const newValue = Math.max(min, Math.min(max, currentValue + direction * effectiveStep));\n  DialStore.updateValue(panelId, path, roundValue(newValue, effectiveStep));\n}\n\nexport function snapToDecile(rawValue: number, min: number, max: number): number {\n  const normalized = (rawValue - min) / (max - min);\n  const nearest = Math.round(normalized * 10) / 10;\n  if (Math.abs(normalized - nearest) <= 0.03125) {\n    return min + nearest * (max - min);\n  }\n  return rawValue;\n}\n\n// ── DOM helpers ──\n\nexport function isInputFocused(): boolean {\n  const el = document.activeElement;\n  if (!el) return false;\n  const tag = el.tagName;\n  if (tag === 'INPUT' || tag === 'TEXTAREA') return true;\n  if ((el as HTMLElement).contentEditable === 'true') return true;\n  return false;\n}\n\nexport function getActiveModifier(e: KeyboardEvent | WheelEvent | MouseEvent): 'alt' | 'shift' | 'meta' | undefined {\n  if (e.altKey) return 'alt';\n  if (e.shiftKey) return 'shift';\n  if (e.metaKey) return 'meta';\n  return undefined;\n}\n\nexport function findControl(controls: ControlMeta[], path: string): ControlMeta | null {\n  for (const control of controls) {\n    if (control.path === path) return control;\n    if (control.type === 'folder' && control.children) {\n      const found = findControl(control.children, path);\n      if (found) return found;\n    }\n  }\n  return null;\n}\n\nexport const DRAG_SENSITIVITY = 4;\n\n// ── Formatting helpers ──\n\nexport function formatInteractionLabel(interaction: string): string {\n  switch (interaction) {\n    case 'drag': return 'Drag';\n    case 'move': return 'Move';\n    case 'scroll-only': return 'Scroll';\n    default: return 'Scroll';\n  }\n}\n\nexport function formatSliderShortcut(sc: ShortcutConfig): string {\n  const interaction = sc.interaction ?? 'scroll';\n  const actionLabel = formatInteractionLabel(interaction);\n  if (!sc.key) return actionLabel;\n  const mod = formatModifier(sc.modifier);\n  return `${mod}${sc.key.toUpperCase()}+${actionLabel}`;\n}\n\nexport function formatToggleShortcut(sc: ShortcutConfig): string {\n  if (!sc.key) return 'Press';\n  const mod = formatModifier(sc.modifier);\n  return `${mod}${sc.key.toUpperCase()}`;\n}\n\nfunction formatModifier(modifier?: string): string {\n  return modifier === 'alt' ? '\\u2325'\n    : modifier === 'shift' ? '\\u21E7'\n    : modifier === 'meta' ? '\\u2318'\n    : '';\n}\n"],"mappings":";AAEA,SAAS,iBAAiB;AAKnB,SAAS,gBAAgB,MAAsB;AACpD,QAAM,IAAI,KAAK,SAAS;AACxB,QAAM,MAAM,EAAE,QAAQ,GAAG;AACzB,SAAO,QAAQ,KAAK,IAAI,EAAE,SAAS,MAAM;AAC3C;AAEO,SAAS,WAAW,KAAa,MAAsB;AAC5D,QAAM,MAAM,KAAK,MAAM,MAAM,IAAI,IAAI;AACrC,SAAO,WAAW,IAAI,QAAQ,gBAAgB,IAAI,CAAC,CAAC;AACtD;AAEO,SAAS,iBAAiB,SAAsB,UAAkC;AACvF,QAAM,MAAM,QAAQ,OAAO;AAC3B,QAAM,MAAM,QAAQ,OAAO;AAC3B,QAAM,QAAQ,MAAM;AACpB,QAAM,OAAO,SAAS,QAAQ;AAC9B,SAAO,SAAS,SAAS,QAAQ,OAC7B,SAAS,WAAW,QAAQ,MAC5B,QAAQ,QAAQ;AACtB;AAEO,SAAS,iBACd,SACA,MACA,SACA,eACA,WACM;AACN,QAAM,eAAe,UAAU,SAAS,SAAS,IAAI;AACrD,QAAM,MAAM,QAAQ,OAAO;AAC3B,QAAM,MAAM,QAAQ,OAAO;AAC3B,QAAM,WAAW,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,eAAe,YAAY,aAAa,CAAC;AACtF,YAAU,YAAY,SAAS,MAAM,WAAW,UAAU,aAAa,CAAC;AAC1E;AAEO,SAAS,aAAa,UAAkB,KAAa,KAAqB;AAC/E,QAAM,cAAc,WAAW,QAAQ,MAAM;AAC7C,QAAM,UAAU,KAAK,MAAM,aAAa,EAAE,IAAI;AAC9C,MAAI,KAAK,IAAI,aAAa,OAAO,KAAK,SAAS;AAC7C,WAAO,MAAM,WAAW,MAAM;AAAA,EAChC;AACA,SAAO;AACT;AAIO,SAAS,iBAA0B;AACxC,QAAM,KAAK,SAAS;AACpB,MAAI,CAAC,GAAI,QAAO;AAChB,QAAM,MAAM,GAAG;AACf,MAAI,QAAQ,WAAW,QAAQ,WAAY,QAAO;AAClD,MAAK,GAAmB,oBAAoB,OAAQ,QAAO;AAC3D,SAAO;AACT;AAEO,SAAS,kBAAkB,GAAkF;AAClH,MAAI,EAAE,OAAQ,QAAO;AACrB,MAAI,EAAE,SAAU,QAAO;AACvB,MAAI,EAAE,QAAS,QAAO;AACtB,SAAO;AACT;AAEO,SAAS,YAAY,UAAyB,MAAkC;AACrF,aAAW,WAAW,UAAU;AAC9B,QAAI,QAAQ,SAAS,KAAM,QAAO;AAClC,QAAI,QAAQ,SAAS,YAAY,QAAQ,UAAU;AACjD,YAAM,QAAQ,YAAY,QAAQ,UAAU,IAAI;AAChD,UAAI,MAAO,QAAO;AAAA,IACpB;AAAA,EACF;AACA,SAAO;AACT;AAEO,IAAM,mBAAmB;AAIzB,SAAS,uBAAuB,aAA6B;AAClE,UAAQ,aAAa;AAAA,IACnB,KAAK;AAAQ,aAAO;AAAA,IACpB,KAAK;AAAQ,aAAO;AAAA,IACpB,KAAK;AAAe,aAAO;AAAA,IAC3B;AAAS,aAAO;AAAA,EAClB;AACF;AAEO,SAAS,qBAAqB,IAA4B;AAC/D,QAAM,cAAc,GAAG,eAAe;AACtC,QAAM,cAAc,uBAAuB,WAAW;AACtD,MAAI,CAAC,GAAG,IAAK,QAAO;AACpB,QAAM,MAAM,eAAe,GAAG,QAAQ;AACtC,SAAO,GAAG,GAAG,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,WAAW;AACrD;AAEO,SAAS,qBAAqB,IAA4B;AAC/D,MAAI,CAAC,GAAG,IAAK,QAAO;AACpB,QAAM,MAAM,eAAe,GAAG,QAAQ;AACtC,SAAO,GAAG,GAAG,GAAG,GAAG,IAAI,YAAY,CAAC;AACtC;AAEA,SAAS,eAAe,UAA2B;AACjD,SAAO,aAAa,QAAQ,WACxB,aAAa,UAAU,WACvB,aAAa,SAAS,WACtB;AACN;","names":[]}