@koine/react 1.0.5 → 1.0.8

package/Forms/Label/Label.js

@@ -0,0 +1,24 @@
+import styled from "styled-components";
+export const label = `
+  display: flex;
+  font-size: 13px;
+  cursor: pointer;
+`;
+export const labelMaterial = `
+  z-index: 2;
+  position: relative;
+  display: inline-block;
+  padding: 0 5px;
+  font-weight: 100;
+  font-size: 10px;
+  background: var(--bodyBg);
+  transform: translateY(-0.3em) translateX(1em);
+  cursor: pointer;
+
+  + * {
+    margin-top: -1em;
+  }
+`;
+export const Label = styled.label `
+  ${labelMaterial}
+`;

package/Forms/Label/index.js

@@ -0,0 +1 @@
+export * from "./Label";

package/Forms/Password/Password.js

@@ -0,0 +1,32 @@
+import { __rest } from "tslib";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { forwardRef, useState } from "react";
+import styled from "styled-components";
+import { ImEye as IconVisible, ImEyeBlocked as IconInvisible, } from "react-icons/im";
+import { Label } from "../Label/Label";
+import { InputNative } from "../Input/Input";
+const ICON_WIDTH = "2em";
+const PasswordInputWrap = styled.div `
+  position: relative;
+`;
+export const PasswordInputNative = styled(InputNative) `
+  position: relative;
+  padding-right: ${ICON_WIDTH};
+`;
+const PasswordIcon = styled.span `
+  position: absolute;
+  top: 0;
+  right: 0;
+  bottom: 0;
+  width: ${ICON_WIDTH};
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  opacity: 0.5;
+`;
+export const Password = forwardRef(function Password(_a, ref) {
+    var { register, name, label } = _a, props = __rest(_a, ["register", "name", "label"]);
+    const [visible, setVisible] = useState(false);
+    return (_jsxs(_Fragment, { children: [label && _jsx(Label, { children: label }), _jsxs(PasswordInputWrap, { children: [_jsx(PasswordInputNative, Object.assign({ type: visible ? "text" : "password", autoComplete: "new-password" }, (register ? register(name) : { name, ref }), props)), _jsx(PasswordIcon, Object.assign({ onClick: () => setVisible((prev) => !prev) }, { children: visible ? _jsx(IconInvisible, {}) : _jsx(IconVisible, {}) }))] })] }));
+});

package/Forms/Password/index.js

@@ -0,0 +1 @@
+export * from "./Password";

package/Forms/Radio/Radio.js

@@ -0,0 +1,31 @@
+import { __rest } from "tslib";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import styled from "styled-components";
+import { label } from "../Label/Label";
+import { Toggle, ToggleLabel, ToggleIndicatorSquared } from "../Toggle";
+import { InputInvisible } from "../styles";
+const RadioRoot = styled.div ``;
+const RadioLabel = styled.div `
+  ${label}
+`;
+const RadioOptionRoot = styled.label `
+  display: flex;
+  align-items: center;
+  padding: 0.05em;
+  cursor: pointer;
+`;
+const RadioToggle = styled(Toggle) ``;
+const RadioIndicator = styled(ToggleIndicatorSquared) ``;
+const RadioOptionLabel = styled(ToggleLabel) ``;
+const RadioOption = forwardRef(function RadioOption(_a, ref) {
+    var { register, name, label, $ref } = _a, props = __rest(_a, ["register", "name", "label", "$ref"]);
+    const inputProps = register ? register(name) : { name, ref: $ref || ref };
+    return (_jsxs(RadioOptionRoot, { children: [_jsxs(RadioToggle, { children: [_jsx(InputInvisible, Object.assign({ type: "radio" }, inputProps, props)), _jsx(RadioIndicator, {})] }), _jsx(RadioOptionLabel, { children: label })] }));
+});
+export const Radio = forwardRef(function Radio(_a, ref) {
+    var { label, options } = _a, props = __rest(_a, ["label", "options"]);
+    if (!options)
+        return null;
+    return (_jsxs(RadioRoot, { children: [label && _jsx(RadioLabel, { children: label }), options.map((option, idx) => (_jsx(RadioOption, Object.assign({}, option, props, { "$ref": ref }), idx)))] }));
+});

package/Forms/Radio/index.js

@@ -0,0 +1 @@
+export * from "./Radio";

package/Forms/Switch/Switch.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import styled from "styled-components";
+import { CheckboxRoot, CheckboxLabel } from "../Checkbox";
+import { toggleBase } from "../Toggle";
+import { useToggle } from "../Toggle/useToggle";
+import { stateFocus } from "../../styles/styled";
+const SWITCH_GUTTER = 0.25;
+const SWITCH_HANDLE_SIZE = 1;
+export const SwitchTrack = styled.span `
+  position: relative;
+  width: ${SWITCH_HANDLE_SIZE * 3}em;
+  height: ${SWITCH_HANDLE_SIZE * 1.5}em;
+  padding: ${SWITCH_GUTTER}em;
+  border-radius: ${SWITCH_HANDLE_SIZE}em;
+  ${toggleBase}
+
+  input:focus ~ & {
+    ${stateFocus}
+  }
+
+  input:disabled ~ & {
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+`;
+export const SwitchHandle = styled.span `
+  position: absolute;
+  width: ${SWITCH_HANDLE_SIZE}em;
+  height: ${SWITCH_HANDLE_SIZE}em;
+  left: ${SWITCH_GUTTER}em;
+  margin-top: -1px;
+  /* border: 1px solid currentColor; */
+  background: currentColor;
+  opacity: 0.5;
+  border-radius: 100%;
+  transition: all 0.18s ease-in-out;
+
+  input:checked + ${SwitchTrack} & {
+    opacity: 1;
+    left: calc(100% - ${SWITCH_HANDLE_SIZE}em - ${SWITCH_GUTTER}em);
+  }
+`;
+/**
+ * All logic and invisible Inputs come from the `useToggle` hook
+ */
+export const Switch = forwardRef(function Switch(props, ref) {
+    const { rootProps, Inputs, label } = useToggle(props, ref);
+    return (_jsxs(CheckboxRoot, Object.assign({}, rootProps, { children: [Inputs, _jsx(SwitchTrack, { children: _jsx(SwitchHandle, {}) }), label && _jsx(CheckboxLabel, { children: label })] })));
+});

package/Forms/Switch/index.js

@@ -0,0 +1 @@
+export * from "./Switch";

package/Forms/Textarea/Textarea.js

@@ -0,0 +1,15 @@
+import { __rest } from "tslib";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import styled from "styled-components";
+import { Label } from "../Label/Label";
+import { inputBase, inputFocus } from "../styles";
+export const TextareaNative = styled.textarea `
+  ${inputBase}
+  ${inputFocus}
+  resize: vertical;
+`;
+export const Textarea = forwardRef(function Textarea(_a, ref) {
+    var { register, name, label } = _a, props = __rest(_a, ["register", "name", "label"]);
+    return (_jsxs(_Fragment, { children: [label && _jsx(Label, { children: label }), _jsx(TextareaNative, Object.assign({}, (register ? register(name) : { name, ref }), props))] }));
+});

package/Forms/Textarea/TextareaRich.js

@@ -0,0 +1,44 @@
+import { __rest } from "tslib";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import styled from "styled-components";
+// import TextareaAutosize from "@mui/base/TextareaAutosize";
+import { Label } from "../Label/Label";
+import { Editor } from "../../Editor";
+import { triggerOnChange } from "../helpers";
+const Root = styled.div `
+  .ProseMirror {
+    max-height: 160px;
+    overflow: auto;
+  }
+  .EditorContent {
+    position: relative;
+    &:after {
+      position: absolute;
+      content: "";
+      bottom: 0;
+      left: 0;
+      right: 16px; /* scrollbar width? */
+      height: 3em;
+      background: linear-gradient(0deg, white, white 33%, transparent);
+      pointer-events: none;
+    }
+  }
+`;
+export const TextareaRich = forwardRef(function TextareaRich(_a, ref) {
+    var { register, setValue, name, label, defaultValue = "", onChange } = _a, props = __rest(_a, ["register", "setValue", "name", "label", "defaultValue", "onChange"]);
+    if (register)
+        register(name);
+    return (_jsxs(Root, { children: [label && _jsx(Label, { children: label }), _jsx(Editor, Object.assign({ options: {
+                    // element: <TextareaAutosize />,
+                    content: defaultValue,
+                    onUpdate: (onChange || setValue) && name
+                        ? ({ editor }) => {
+                            const value = editor.getHTML();
+                            if (setValue)
+                                setValue(name, value);
+                            triggerOnChange(onChange, name, value);
+                        }
+                        : undefined,
+                } }, props))] }));
+});

package/Forms/Textarea/index.js

@@ -0,0 +1,2 @@
+export * from "./Textarea";
+export * from "./TextareaRich";

package/Forms/Toggle/Toggle.js

@@ -0,0 +1,79 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @file
+ *
+ * About accessibility:
+ * - minimum target size of 44px https://www.w3.org/TR/WCAG21/#target-size
+ */
+import styled from "styled-components";
+import { uid } from "@koine/utils";
+import { stateFocus } from "../../styles/styled";
+export const toggleBase = `
+  border: 1px solid var(--forms-border-color);
+`;
+export const toggleIndicatorBg = `
+  display: inline-block;
+  flex-shrink: 0;
+  width: 100%;
+  height: 100%;
+`;
+export const toggleIndicatorBgShape = `
+  ${toggleIndicatorBg}
+  fill: none;
+  stroke-width: 2px;
+  stroke: var(--forms-border-color);
+`;
+export const toggleIndicatorFg = `
+  position: absolute;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  fill: currentcolor;
+`;
+export const Toggle = styled.span `
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2em;
+  height: 2em;
+  margin: 0 -0.3em; /* rtl */
+  padding: 0.3em;
+`;
+export const ToggleLabel = styled.span `
+  margin-left: 0.6em; /* rtl */
+`;
+export const ToggleLabelSub = styled.small `
+  opacity: 0.7;
+  font-size: 0.7em; ;
+`;
+export const ToggleIndicatorHolder = styled.span `
+  position: relative;
+  display: flex;
+
+  input:focus ~ & {
+    ${stateFocus}
+  }
+`;
+export const ToggleIndicatorBgSquare = styled.svg `
+  ${toggleIndicatorBgShape}
+`;
+export const ToggleIndicatorBgCircle = styled.svg `
+  ${toggleIndicatorBgShape}
+`;
+export const ToggleIndicatorFg = styled.svg `
+  ${toggleIndicatorFg}
+  transform: scale(0);
+  transition: transform 0.18s ease;
+
+  input:checked + ${ToggleIndicatorHolder} & {
+    transform: scale(1);
+  }
+`;
+export const ToggleIndicatorSquared = (props) => {
+    return (_jsxs(ToggleIndicatorHolder, { children: [_jsx(ToggleIndicatorBgSquare, Object.assign({ viewBox: "0 0 24 24" }, { children: _jsx("rect", { width: "24", height: "24" }) })), _jsx(ToggleIndicatorFg, Object.assign({ viewBox: "0 0 24 24" }, { children: _jsx("path", { d: "M9 16.17L4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z" }) }))] }));
+};
+export const ToggleIndicatorRounded = ({ r = 6, }) => {
+    const id = uid("Toggle");
+    return (_jsxs(ToggleIndicatorHolder, { children: [_jsxs(ToggleIndicatorBgCircle, Object.assign({ viewBox: "0 0 24 24" }, { children: [_jsx("circle", { cy: "12", cx: "12", r: "12", id: `r_${id}`, clipPath: `url(#c_${id})` }), _jsx("clipPath", Object.assign({ id: `c_${id}` }, { children: _jsx("use", { xlinkHref: `#r_${id}` }) }))] })), _jsx(ToggleIndicatorFg, Object.assign({ viewBox: "0 0 24 24" }, { children: _jsx("circle", { r: r, cx: "12", cy: "12" }) }))] }));
+};

package/Forms/Toggle/index.js

@@ -0,0 +1 @@
+export * from "./Toggle";

package/Forms/Toggle/useToggle.js

@@ -0,0 +1,143 @@
+import { __rest } from "tslib";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo } from "react";
+import { useWatch } from "react-hook-form";
+import { InputInvisible } from "../styles";
+/**
+ * This hook is meant to powere Checkboxes, Switches and checkbox-like Radios
+ * components, it works in fact in two modes:
+ *
+ * 1: behaviour as standard checkbox
+ * yup validation would simply look like:
+ *
+ * ```ts
+ * privacy:  boolean().required(),
+ * // add `.nullable()` if you do not provide a boolean `defaultValue`
+ * ```
+ *
+ * 2: beahviour as two radio for checkbox with custom true/false values as
+ * strings yup validation would look like:
+ *
+ * ```ts
+ * newsletter: string().oneOf(["yes", "no"]).required(),
+ * // add `.nullable()` if you do not provide a string `defaultValue`
+ *
+ * // to do not make it required and avoid triggering an error when the input is
+ * // untouched you need to set the default value of the input in the form
+ * // initialization's `defaultValues` as such:
+ *
+ * useForm({ defaultValues: { newsletter: "no" }})
+ * ```
+ *
+ * To enable this mode either pass the props `valueTrue` and `valueFalse` or
+ * an array of options with the shape of `Option`
+ */
+export function useToggle(props, ref) {
+    const { name, control, register, label, options, value: propValue } = props, restProps = __rest(props, ["name", "control", "register", "label", "options", "value"]);
+    let { id, valueTrue, valueFalse } = restProps, 
+    // defaultChecked,
+    // defaultValue,
+    // eslint-disable-next-line prefer-const
+    remainingInputProps = __rest(restProps, ["id", "valueTrue", "valueFalse"]);
+    // use options data convention to pass on the true/false values
+    if (options) {
+        valueTrue = options
+            .filter((opt) => opt.value === "true")[0]
+            .label.toString();
+        valueFalse = options
+            .filter((opt) => opt.value === "false")[0]
+            .label.toString();
+    }
+    id = `switch-${name}`;
+    const idTrue = `${id}-true`;
+    const idFalse = `${id}-false`;
+    const isRadio = !!(valueTrue && valueFalse);
+    // // manage default values for both toggle modes
+    // defaultChecked = isUndefined(defaultChecked) ? false : defaultChecked;
+    // // TODO: maybe throw an error if the defaultValue that arrives here is not
+    // // a valid value
+    // defaultValue =
+    //   defaultValue === valueTrue || defaultValue === valueFalse
+    //     ? defaultValue
+    //     : valueFalse;
+    // get the value either from the uncontrolled watched input or from the given
+    // prop to control the component
+    let value = useWatch({
+        name,
+        control,
+        // defaultValue: isRadio ? defaultValue : defaultChecked,
+    });
+    if (propValue) {
+        value = propValue;
+    }
+    // get the input props needed by react-hook-form, first check if we have
+    // a `register` function, then check if we have a `control` object or just
+    // rely on the `name` prop and `ref`, they probably would be passed alongside
+    // an `onChange` prop that is spreaded on the inputs
+    const inputProps = useMemo(() => {
+        return register
+            ? register(name)
+            : control
+                ? control.register(name)
+                : {
+                    name,
+                    ref,
+                };
+    }, [register, control, name, ref]);
+    /**
+     * Accessibility.
+     *
+     * Fake the spacebar keyboard behaviour on the radio mode of the checkbox.
+     * Without this *only* the arrow keys would change the checkbox state
+     */
+    const handleKeyDown = useCallback((event) => {
+        if (event.key === " ") {
+            event.preventDefault();
+            event.stopPropagation();
+            const firstInput = event.target;
+            const next = firstInput.nextElementSibling;
+            const prev = firstInput.previousElementSibling;
+            const secondInput = (next === null || next === void 0 ? void 0 : next.tagName) === "INPUT" ? next : prev;
+            let target = firstInput;
+            if (firstInput.checked) {
+                target = secondInput;
+            }
+            else {
+                if (!secondInput.checked) {
+                    target =
+                        firstInput.value === valueTrue ? firstInput : secondInput;
+                }
+            }
+            if (target)
+                target.click();
+        }
+    }, [valueTrue]);
+    // collect all the return values that are dependent on the current value
+    // of the input
+    const valueDependentProps = useMemo(() => ({
+        rootProps: {
+            htmlFor: isRadio
+                ? !value || value === valueFalse
+                    ? idTrue
+                    : idFalse
+                : id,
+        },
+        label: label ? label : value,
+        value,
+    }), [value, valueFalse, isRadio, id, idTrue, idFalse, label]);
+    const Inputs = useMemo(() => isRadio ? (_jsxs(_Fragment, { children: [_jsx(InputInvisible, Object.assign({ id: idFalse }, inputProps, remainingInputProps, { onKeyDown: handleKeyDown, type: "radio", value: valueFalse })), _jsx(InputInvisible, Object.assign({ id: idTrue }, inputProps, remainingInputProps, { onKeyDown: handleKeyDown, type: "radio", value: valueTrue }))] })) : (_jsx(InputInvisible, Object.assign({ id: id, type: "checkbox" }, inputProps, remainingInputProps))), [
+        inputProps,
+        remainingInputProps,
+        handleKeyDown,
+        isRadio,
+        idFalse,
+        idTrue,
+        valueFalse,
+        valueTrue,
+        id,
+        // defaultChecked,
+        // defaultValue,
+    ]);
+    // console.log("useToggle: render", value);
+    return Object.assign(Object.assign({}, valueDependentProps), { Inputs });
+}

package/Forms/antispam.js

@@ -0,0 +1,56 @@
+import { object } from "yup";
+import { encode, decode, isUndefined } from "@koine/utils";
+/**
+ * Encode form
+ *
+ * Takes a record of yup validations and outputs a `yup` schema with encoded
+ * names (antispam technique) and a record of the encoded/decoded input `name`s.
+ *
+ * We skip the names prefixed wth an underscore which are considered programmatic
+ * form data not created by user input.
+ */
+export function encodeForm(validationRules) {
+    const encoded = {};
+    const encodedNames = {};
+    for (const name in validationRules) {
+        if (!name.startsWith("_")) {
+            const encodedName = encode(name);
+            encoded[encodedName] = validationRules[name];
+            encodedNames[name] = encodedName;
+        }
+    }
+    // we need `.required()` to correctly infer the type @see
+    // https://github.com/jquense/yup/issues/946
+    const encodedSchema = object(encoded).required();
+    return { encodedSchema, encodedNames };
+}
+/**
+ * Decode form data
+ *
+ * This function is meant to be used inside an api endpoint to gather an encoded
+ * form submit data and transform it to the decoded desired json data.
+ *
+ * Here too we skip encoding/decoding process for names prefixed wth an underscore
+ * which are considered programmatic form data not created by user input.
+ */
+export function decodeForm(formData) {
+    const json = {};
+    for (const encodedName in formData) {
+        const decodedName = decode(encodedName);
+        // always add underscore prefixed names as they are treated as internal
+        // private inputs outside of the honeypot system, normalise them here removing
+        // the underscore prefix
+        if (encodedName.startsWith("_")) {
+            // @ts-expect-error nevermind
+            json[encodedName.substring(1)] = formData[encodedName];
+        }
+        // if the decoded `name` is empty and the encoded `name` is defined honeypot passed
+        else if (!isUndefined(formData[encodedName]) &&
+            formData[decodedName] === "") {
+            // @ts-expect-error nevermind
+            json[decodedName] = formData[encodedName];
+        }
+    }
+    // console.log(formData, decoded, json);
+    return json;
+}

package/Forms/helpers.js

@@ -0,0 +1,44 @@
+import { isString, matchSorter } from "@koine/utils";
+export const normaliseOptions = (options = []) => {
+    return options.map((option) => {
+        return isString(option)
+            ? {
+                label: option,
+                value: option,
+            }
+            : option;
+    });
+};
+export function defaultOptionsFilterFn(options, inputValue) {
+    if (!inputValue) {
+        return options;
+    }
+    return matchSorter(options, inputValue, { keys: ["value", "label"] });
+}
+/**
+ * We are faking the native input `onChange` event
+ */
+export function triggerOnChange(onChange, name, value) {
+    // @ts-expect-error nevermind
+    if (onChange)
+        onChange({ target: { name, value } });
+}
+/**
+ * @see https://hustle.bizongo.in/simulate-react-on-change-on-controlled-components-baa336920e04
+ * @deprecated
+ */
+export function triggerChange(input, value) {
+    const obj = window.Object;
+    if (!obj) {
+        // if (__DEV__) {
+        //   console.warn("triggerChange: window.Object does not exists, bailing.");
+        // }
+        return;
+    }
+    // @ts-expect-error nevermind
+    const nativeInputValueSetter = obj.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, "value").set;
+    // @ts-expect-error nevermind
+    nativeInputValueSetter.call(input, value);
+    const inputEvent = new Event("input", { bubbles: true });
+    input.dispatchEvent(inputEvent);
+}

package/Forms/index.js

@@ -0,0 +1,17 @@
+export * from "./antispam";
+export * from "./Checkbox";
+export * from "./Input";
+export * from "./InputGroup";
+export * from "./Feedback";
+export * from "./Field";
+export * from "./InputGroup";
+export * from "./Form";
+export * from "./Label";
+export * from "./Password";
+export * from "./Radio";
+// export * from "./Select";
+export * from "./Switch";
+export * from "./Textarea";
+export * from "./Toggle";
+export * from "./helpers";
+export * from "./styles";

package/Forms/styles.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import styled from "styled-components";
+import { stateFocus } from "../styles/styled";
+import { ProgressLinear } from "../Progress/ProgressLinear";
+import { invisible } from "../styles/styled";
+export const InputInvisible = styled.input `
+  ${invisible}
+`;
+export const InputHoneypot = styled(InputInvisible).attrs({
+    type: "text",
+    autoComplete: "new-password",
+    tabIndex: -1,
+}) ``;
+export const InputProgress = styled((p) => (_jsx(ProgressLinear, Object.assign({ fg: "var(--accent300)", bg: "var(--accent400)" }, p)))) `
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  width: 100%;
+`;
+/**
+ * Remove the default light blue background on autofilled inputs. To be used as
+ * a function that outputs a CSS string.
+ *
+ * @see https://stackoverflow.com/a/62624824/1938970
+ */
+export const inputResetAutofill = `
+  &:-webkit-autofill,
+  &:-webkit-autofill:hover,
+  &:-webkit-autofill:focus,
+  &:-webkit-autofill:active {
+    -webkit-background-clip: text;
+  }
+`;
+/* FIXME: find a nice way to override this styling from implementation */
+// border-bottom: 1px solid var(--forms-border-color);
+// border: 0;
+export const inputBorder = `
+  border: 1px solid var(--forms-border-color);
+`;
+export const inputPadding = `
+  padding: var(--forms-gutter-y) var(--forms-gutter-x);
+`;
+export const inputReset = `
+  width: 100%;
+  min-height: 44px;
+  ${inputBorder}
+  ${inputPadding}
+`;
+export const inputBase = `
+  ${inputReset}
+  ${inputResetAutofill}
+  background: transparent;
+`;
+export const inputFocus = `
+  &:focus {
+    outline: 0px;
+    appearance: none;
+    ${stateFocus}
+  }
+`;