@teselagen/ui 0.7.34 → 0.7.36

package/src/utils/commandUtils.js

@@ -1,112 +0,0 @@
-import { startCase } from "lodash-es";
-
-// Generic factory function to create command objects.
-// TODO add documentation
-export function genericCommandFactory(config) {
-  const out = {};
-  // eslint-disable-next-line no-unused-vars
-  for (const cmdId in config.commandDefs) {
-    const def = config.commandDefs[cmdId];
-    const command = { id: cmdId };
-    command.execute = (...execArgs) => {
-      config.handleReturn(
-        cmdId,
-        def.handler &&
-          def.handler.apply(command, config.getArguments(cmdId, execArgs))
-      );
-    };
-
-    const properties = [
-      "icon",
-      "name",
-      "component",
-      "shortName",
-      "description",
-      "hotkey",
-      "hotkeyProps",
-      "isDisabled",
-      "submenu",
-      "isActive",
-      "isHidden",
-      "tooltip",
-      "inactiveIcon",
-      "inactiveName"
-    ];
-
-    properties.forEach(prop => {
-      if (def[prop] !== undefined) {
-        if (typeof def[prop] === "function") {
-          Object.defineProperty(command, prop, {
-            get: () => {
-              return def[prop].apply(command, config.getArguments(cmdId, []));
-            }
-          });
-        } else {
-          command[prop] = def[prop];
-        }
-      }
-    });
-
-    // If no name was specified in the definition, let's try to give some
-    // auto-generated names
-    if (!def.name) {
-      command.name = startCase(cmdId);
-      if (def.toggle && cmdId.startsWith("toggle")) {
-        command.name = startCase(cmdId.replace("toggle", def.toggle[0] || ""));
-        command.inactiveName = startCase(
-          cmdId.replace("toggle", def.toggle[1] || "")
-        );
-        command.shortName = startCase(cmdId.replace("toggle", ""));
-      }
-    }
-
-    out[cmdId] = command;
-  }
-
-  return out;
-}
-
-// Extract hotkey props from the given commands or command defs, returning
-// a mapping of command ids to hotkey prop objects
-export function getCommandHotkeys(commandsOrDefs) {
-  const hotkeyDefs = {};
-  Object.keys(commandsOrDefs).forEach(cmdId => {
-    if (commandsOrDefs[cmdId].hotkey) {
-      hotkeyDefs[cmdId] = {
-        combo: commandsOrDefs[cmdId].hotkey,
-        label: commandsOrDefs[cmdId].name || startCase(cmdId),
-        ...commandsOrDefs[cmdId].hotkeyProps
-      };
-    }
-  });
-
-  return hotkeyDefs;
-}
-
-// Extract handler functions from the given commands, returning a mapping of
-// command ids to handlers (directly - no checks added).
-export function getCommandHandlers(commands) {
-  const handlers = {};
-  Object.keys(commands).forEach(cmdId => {
-    handlers[cmdId] = commands[cmdId].execute;
-  });
-
-  return handlers;
-}
-
-// Get hotkey handler functions for the given commands, returning a mapping of
-// command ids to hotkey handlers.
-export function getCommandHotkeyHandlers(commands) {
-  const handlers = {};
-  Object.keys(commands).forEach(cmdId => {
-    if (commands[cmdId].hotkey) {
-      handlers[cmdId] = event => {
-        if (!commands[cmdId].isDisabled && !commands[cmdId].isHidden) {
-          commands[cmdId].execute({ event, viaHotkey: true });
-        }
-      };
-    }
-  });
-
-  return handlers;
-}

package/src/utils/determineBlackOrWhiteTextColor.js

@@ -1,4 +0,0 @@
-/* Copyright (C) 2018 TeselaGen Biotechnology, Inc. */
-import Color from "color";
-
-export default c => (Color(c).isLight() ? "#000000" : "#FFFFFF");

package/src/utils/getDayjsFormatter.js

@@ -1,35 +0,0 @@
-import dayjs from "dayjs";
-import LocalizedFormat from "dayjs/plugin/localizedFormat";
-import localeData from "dayjs/plugin/localeData";
-
-dayjs.extend(localeData);
-dayjs.extend(LocalizedFormat);
-const userLocale = Intl.DateTimeFormat().resolvedOptions().locale;
-
-if (userLocale) {
-  const requireLocale = (newLocale, skipCall) => {
-    if (dayjs.locale() !== newLocale) {
-      try {
-        require(`dayjs/locale/${newLocale}.js`);
-        dayjs.locale(newLocale);
-      } catch (error) {
-        // error
-        if (!skipCall && newLocale.includes("-")) {
-          requireLocale(newLocale.split("-")[0], true);
-        }
-      }
-    }
-  };
-  const localeToUse = userLocale.toLowerCase();
-  requireLocale(localeToUse);
-}
-
-export default function getDayjsFormatter(format) {
-  return {
-    formatDate: date => dayjs(date).format(format),
-    parseDate: str => dayjs(str, format).toDate(),
-    placeholder: format?.toLowerCase().includes("l")
-      ? dayjs.Ls[dayjs.locale()]?.formats[format.toUpperCase()]
-      : format
-  };
-}

package/src/utils/getTextFromEl.js

@@ -1,28 +0,0 @@
-import React from "react";
-
-export default function getTextFromEl(el, options = {}) {
-  const { lowerCase } = options;
-  if (React.isValidElement(el)) {
-    return el && el.props && el.props.children
-      ? (el.props.children.reduce
-          ? el.props.children
-          : [el.props.children]
-        ).reduce((acc, child) => {
-          if (child && child.props && child.props.children) {
-            acc += getTextFromEl(child);
-          } else if (typeof child === "string") {
-            if (lowerCase) {
-              acc += child.toLowerCase();
-            } else {
-              acc += child;
-            }
-          } else if (typeof child === "number") {
-            acc += child + "";
-          }
-          return acc;
-        }, "")
-      : "";
-  } else {
-    return el;
-  }
-}

package/src/utils/handlerHelpers.js

@@ -1,24 +0,0 @@
-export const onEnterHelper = callback => ({
-  onKeyDown: event => {
-    if (event.key === "Enter") {
-      callback(event);
-    }
-  }
-});
-
-export const onBlurHelper = callback => ({
-  onBlur: event => {
-    callback(event);
-  }
-});
-
-export const onEnterOrBlurHelper = callback => ({
-  onKeyDown: function (event) {
-    if (event.key === "Enter") {
-      callback(event);
-    }
-  },
-  onBlur: function (event) {
-    callback(event);
-  }
-});

package/src/utils/hooks/index.js

@@ -1 +0,0 @@
-export { useDeepEqualMemo } from "./useDeepEqualMemo";

package/src/utils/hooks/useDeepEqualMemo.js

@@ -1,15 +0,0 @@
-import { isEqual } from "lodash-es";
-import { useEffect, useRef } from "react";
-
-export const useDeepEqualMemo = value => {
-  const ref = useRef();
-  if (!isEqual(value, ref.current)) {
-    ref.current = value;
-  }
-  return ref.current;
-};
-
-export const useDeepEqualEffect = (effect, deps) => {
-  // eslint-disable-next-line react-hooks/exhaustive-deps
-  return useEffect(effect, useDeepEqualMemo(deps));
-};

package/src/utils/hooks/useStableReference.js

@@ -1,9 +0,0 @@
-import { useEffect, useRef } from "react";
-
-export const useStableReference = value => {
-  const ref = useRef();
-  useEffect(() => {
-    ref.current = value;
-  }, [value]);
-  return ref;
-};

package/src/utils/hotkeyUtils.js

@@ -1,131 +0,0 @@
-import React, { useMemo } from "react";
-import { useHotkeys } from "@blueprintjs/core";
-import { startCase } from "lodash-es";
-
-// This has been mostly superseded by blueprint's KeyCombo component, but may
-// still be useful for cases where we need plain text
-export function comboToLabel(def, useSymbols = true) {
-  const combo = typeof def === "string" ? def : def.combo;
-
-  if (useSymbols) {
-    let parts = combo.replace("++", "+plus").split("+");
-    parts = parts.map(p => symbols[p] || startCase(p) || p);
-    return parts.join("");
-  } else {
-    return combo
-      .split("+")
-      .map(p => startCase(p) || p)
-      .join(" + ")
-      .replace("Meta", isMac ? "Cmd" : "Ctrl")
-      .replace("Mod", isMac ? "Cmd" : "Ctrl")
-      .replace("Alt", isMac ? "Option" : "Alt");
-  }
-}
-
-// HOF to get hotkey combos by id
-export const hotkeysById =
-  (hotkeys, mode = "raw") =>
-  id => {
-    const def = getHotkeyProps(hotkeys[id]);
-    return (
-      def &&
-      (mode === "raw" ? def.combo : comboToLabel(def.combo, mode === "symbols"))
-    );
-  };
-
-// Translate shorthand array if needed
-export const getHotkeyProps = (def, id) => {
-  let out;
-  if (typeof def === "string") {
-    out = { combo: def };
-  } else if (def instanceof Array) {
-    out = { combo: def[0], label: def[1], ...(def[2] || {}) };
-  } else {
-    out = def;
-  }
-  out.label = out.label || startCase(id);
-  return out;
-};
-
-/*
- * HOC to add hotkey support to components. Use this instead of blueprint's one.
- *
- * Arguments:
- * - hotkeySpec: either a named hotkey section previously registered, or an
- *   object mapping command ids to hotkey definitions, where each hotkey can
- *   be either:
- *   - a string consisting in the key combo (e.g. 'ctrl+shift+x')
- *   - an array holding the combo, label, and an object with any other props
- *   - an object holding all props
- * - handlers: an object mapping command ids to handler functions
- * - options: an object that may specify the follownig options:
- *   - functional: boolean indicating if the wrapped component will be a
- *     functional stateless component instead of a class-based one
- *
- * Returns a function that can be invoked with a component class, or a
- * stateless component function (if specified in the options) and returns
- * the decorated class. It may also be invoked without arguments to generate a
- * dummy ad-hoc component with no output.
- *
- */
-export const withHotkeys = (hotkeys, handlers) => {
-  return ({ children } = {}) => {
-    const memoedHotkeys = useMemo(
-      () =>
-        Object.keys(hotkeys).map(id => {
-          const { ...props } = getHotkeyProps(hotkeys[id], id);
-          return {
-            key: id,
-            global: props.global !== false,
-            onKeyDown: function (e) {
-              return handlers[id](e);
-            },
-            ...props
-          };
-        }),
-      []
-    );
-
-    const { handleKeyDown, handleKeyUp } = useHotkeys(memoedHotkeys);
-    const newProps = {
-      tabIndex: 0,
-      onKeyDown: handleKeyDown,
-      onKeyUp: handleKeyUp
-    };
-    return children ? ( //tnr: if children are passed, we'll clone them with the new props
-      React.cloneElement(children, newProps)
-    ) : (
-      //if not, then we'll return a div that can be used
-      <div className="hotkeyHandler" {...newProps}></div>
-    );
-  };
-};
-
-const isMac = navigator.userAgent.includes("Mac OS X");
-
-// TODO maybe avoid using symbols by default when not on Mac?
-// Anyway, alternative 'Key + Key' description is provided as well
-const symbols = {
-  cmd: "⌘",
-  meta: "⌘",
-  ctrl: "⌃",
-  alt: "⌥",
-  shift: "⇧",
-  esc: "␛", //'⎋',
-  enter: "⏎",
-  backspace: "⌫",
-  plus: "+",
-  tab: "⇥",
-  space: "␣",
-  capslock: "⇪",
-  pageup: "⇞",
-  pagedown: "⇟",
-  home: "↖",
-  end: "↘",
-  left: "←",
-  right: "→",
-  up: "↑",
-  down: "↓"
-};
-
-symbols.mod = symbols[isMac ? "meta" : "ctrl"];

package/src/utils/isBeingCalledExcessively.js

@@ -1,24 +0,0 @@
-const keyCount = {};
-export const isBeingCalledExcessively = ({ uniqName }) => {
-  if (process.env.NODE_ENV !== "development") {
-    return;
-  }
-  if (!uniqName) {
-    throw new Error("uniqName is required");
-  }
-  // if this function is hit more than 10 times in a row in 2 seconds with the same uniqName then throw an error
-  if (keyCount[uniqName + "_timeout"]) {
-    clearTimeout(keyCount[uniqName + "_timeout"]);
-  }
-  keyCount[uniqName] = keyCount[uniqName] || 0;
-  keyCount[uniqName]++;
-
-  keyCount[uniqName + "_timeout"] = setTimeout(() => {
-    keyCount[uniqName] = 0;
-  }, 2000);
-
-  if (keyCount[uniqName] > 20) {
-    keyCount[uniqName] = 0;
-    throw new Error(`isBeingCalledExcessively: ${uniqName}`);
-  }
-};