@koine/react 1.0.10 → 1.0.11

package/Forms/Toggle/useToggle.js

@@ -0,0 +1,145 @@
+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, ...restProps } = props;
+    let { id, valueTrue, valueFalse, 
+    // defaultChecked,
+    // defaultValue,
+    // eslint-disable-next-line prefer-const
+    ...remainingInputProps } = restProps;
+    // 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?.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, { id: idFalse, ...inputProps, ...remainingInputProps, onKeyDown: handleKeyDown, type: "radio", value: valueFalse }), _jsx(InputInvisible, { id: idTrue, ...inputProps, ...remainingInputProps, onKeyDown: handleKeyDown, type: "radio", value: valueTrue })] })) : (_jsx(InputInvisible, { id: id, type: "checkbox", ...inputProps, ...remainingInputProps })), [
+        inputProps,
+        remainingInputProps,
+        handleKeyDown,
+        isRadio,
+        idFalse,
+        idTrue,
+        valueFalse,
+        valueTrue,
+        id,
+        // defaultChecked,
+        // defaultValue,
+    ]);
+    // console.log("useToggle: render", value);
+    return {
+        ...valueDependentProps,
+        Inputs,
+    };
+}

package/Forms/antispam.d.ts

@@ -0,0 +1,24 @@
+import type { ObjectShape } from "yup/lib/object";
+/**
+ * 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 declare function encodeForm<T extends ObjectShape = {}>(validationRules: T): {
+    encodedSchema: import("yup/lib/object").RequiredObjectSchema<Record<string, T[keyof T]>, import("yup/lib/object").AnyObject, import("yup/lib/object").TypeOfShape<Record<string, T[keyof T]>>>;
+    encodedNames: Record<keyof T, string>;
+};
+/**
+ * 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 declare function decodeForm<ReturnAs extends Record<string, unknown> = {}, FormData extends Record<string, unknown> = {}>(formData: FormData): ReturnAs;

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.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="react" />
+import type { Control, UseFormRegister, UseFormSetValue } from "react-hook-form";
+import type { Option } from "../types";
+declare type FormControlNativeType = "input" | "select" | "textarea";
+declare type FormControlFieldValues = Record<string, any>;
+export declare type FormControlNative<T extends FormControlNativeType = "input"> = Omit<React.ComponentPropsWithRef<T>, "name">;
+export declare type FormControlProps<T extends FormControlFieldValues = any> = {
+    label?: React.ReactNode;
+    name: string;
+    control?: Control<T>;
+    register?: UseFormRegister<T>;
+    setValue?: UseFormSetValue<T>;
+};
+export declare type FormControl<TControlType extends FormControlNativeType = "input", TFieldValues extends FormControlFieldValues = any> = FormControlNative<TControlType> & FormControlProps<TFieldValues>;
+export declare const normaliseOptions: (options?: (string | Option)[]) => Option[];
+export declare function defaultOptionsFilterFn(options: Option[], inputValue?: string): Option[];
+/**
+ * We are faking the native input `onChange` event
+ */
+export declare function triggerOnChange<T extends HTMLElement = HTMLInputElement>(onChange?: React.ChangeEventHandler<T>, name?: string, value?: any): void;
+/**
+ * @see https://hustle.bizongo.in/simulate-react-on-change-on-controlled-components-baa336920e04
+ * @deprecated
+ */
+export declare function triggerChange(input: HTMLInputElement, value?: string): void;
+export {};

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 (process.env["NODE_ENV"] !== "production") {
+        //   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.d.ts

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

package/Forms/index.js

@@ -0,0 +1,16 @@
+export * from "./antispam";
+export * from "./Checkbox";
+export * from "./Input";
+export * from "./InputGroup";
+export * from "./Feedback";
+export * from "./Field";
+export * from "./InputGroup";
+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/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "./index.js",
+  "main": "../node/Forms/index.js",
+  "types": "./index.d.ts"
+}

package/Forms/styles.d.ts

@@ -0,0 +1,19 @@
+export declare const InputInvisible: import("styled-components").StyledComponent<"input", import("styled-components").DefaultTheme, {}, never>;
+export declare const InputHoneypot: import("styled-components").StyledComponent<"input", import("styled-components").DefaultTheme, {
+    type: "text";
+    autoComplete: "new-password";
+    tabIndex: -1;
+}, "tabIndex" | "type" | "autoComplete">;
+export declare const InputProgress: import("styled-components").StyledComponent<(p: any) => JSX.Element, import("styled-components").DefaultTheme, {}, never>;
+/**
+ * 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 declare const inputResetAutofill = "\n  &:-webkit-autofill,\n  &:-webkit-autofill:hover,\n  &:-webkit-autofill:focus,\n  &:-webkit-autofill:active {\n    -webkit-background-clip: text;\n  }\n";
+export declare const inputBorder = "\n  border: 1px solid var(--forms-border-color);\n";
+export declare const inputPadding = "\n  padding: var(--forms-gutter-y) var(--forms-gutter-x);\n";
+export declare const inputReset: string;
+export declare const inputBase: string;
+export declare const inputFocus: string;

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, { 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}
+  }
+`;

package/Gauge/Gauge.d.ts

@@ -0,0 +1,5 @@
+export declare type GaugeProps = {
+    /** In percentage */
+    value: number;
+};
+export declare const Gauge: (_props: GaugeProps) => null;

package/Gauge/Gauge.js

@@ -0,0 +1,102 @@
+// import styled, { keyframes } from "styled-components";
+// import { m } from "framer-motion";
+export const Gauge = (_props) => null;
+// export type GaugeProps = {
+//   /** In percentage */
+//   value: number;
+// };
+// export const Gauge = ({
+//   value,
+//   counter = true,
+//   stroke,
+//   // emptyStroke = "#e2e2e2",
+//   emptyStroke = stroke,
+//   emptyStrokeOpacity = 0.25,
+//   // emptyStrokeOpacity = 1,
+//   duration = 3,
+//   delay = 0.5,
+//   size = 100,
+//   strokeWidth = 6,
+// }) => {
+//   const radius = 45;
+//   const circumference = Math.ceil(2 * Math.PI * radius);
+//   const fillPercents = Math.abs(
+//     Math.ceil((circumference / 100) * (value - 100))
+//   );
+//   const transition = {
+//     duration: duration,
+//     delay: delay,
+//     ease: "easeIn",
+//   };
+//   const variants = {
+//     hidden: {
+//       strokeDashoffset: circumference,
+//       transition,
+//     },
+//     show: {
+//       strokeDashoffset: fillPercents,
+//       transition,
+//     },
+//   };
+//   return (
+//     <>
+//       <Flex justifyContent="center" alignItems="center">
+//         {counter && (
+//           <Box
+//             position="absolute"
+//             fontSize={size >= 100 ? 6 : 3}
+//             fontWeight={2}
+//             color="text500"
+//           >
+//             <Counter valueTo={value} totalDuration={duration + delay} />%
+//           </Box>
+//         )}
+//         <Box height={size}>
+//           <svg
+//             viewBox="0 0 100 100"
+//             version="1.1"
+//             xmlns="http://www.w3.org/2000/svg"
+//             width={size}
+//             height={size}
+//           >
+//             <circle
+//               cx="50"
+//               cy="50"
+//               r={radius}
+//               className="circle"
+//               strokeWidth={strokeWidth}
+//               stroke={emptyStroke}
+//               strokeOpacity={emptyStrokeOpacity}
+//               fill="transparent"
+//             />
+//           </svg>
+//           <svg
+//             viewBox="0 0 100 100"
+//             width={size}
+//             height={size}
+//             style={{
+//               position: "absolute",
+//               transform: "rotate(-90deg)",
+//               overflow: "visible",
+//               marginLeft: -size,
+//             }}
+//           >
+//             <m.circle
+//               cx="50"
+//               cy="50"
+//               r={radius}
+//               strokeWidth={strokeWidth}
+//               stroke={stroke}
+//               fill="transparent"
+//               strokeDashoffset={fillPercents}
+//               strokeDasharray={circumference}
+//               variants={variants}
+//               initial="hidden"
+//               animate={"show"}
+//             />
+//           </svg>
+//         </Box>
+//       </Flex>
+//     </>
+//   );
+// };

package/Grid/Grid.d.ts

@@ -0,0 +1,64 @@
+/// <reference types="react" />
+import type { Theme, Breakpoint } from "../styles/theme";
+export declare const GRID_COLUMNS = 12;
+export declare const GRID_GUTTER_DEFAULT: keyof Theme["gutter"];
+export declare type GridProps = {
+    /**
+     * @default "half"
+     */
+    $gutter?: keyof Theme["gutter"];
+};
+export declare type ContainerProps = React.PropsWithChildren<GridProps & {
+    size: Breakpoint;
+    clamp?: boolean;
+}>;
+export declare const Container: import("styled-components").StyledComponent<"div", import("styled-components").DefaultTheme, GridProps & {
+    size: Breakpoint;
+    clamp?: boolean | undefined;
+} & {
+    children?: import("react").ReactNode;
+}, never>;
+export declare type ContainerFluidProps = React.PropsWithChildren<GridProps & {
+    size: Breakpoint;
+}>;
+export declare const ContainerFluid: import("styled-components").StyledComponent<"div", import("styled-components").DefaultTheme, GridProps & {
+    size: Breakpoint;
+} & {
+    children?: import("react").ReactNode;
+}, never>;
+declare type Direction = "min" | "max";
+export declare type RowProps = GridProps & {
+    $valign?: React.CSSProperties["alignItems"];
+    $reverse?: `${Direction}:${Breakpoint}`;
+    /**
+     * It forces child columns to be on one line overflowing the content when it does not fit,
+     * it is suggested to use with children having a minimum width not in percentage,
+     * for things like sliders and carousels
+     */
+    $noWrap?: boolean;
+};
+export declare const Row: import("styled-components").StyledComponent<"div", import("styled-components").DefaultTheme, GridProps & {
+    $valign?: React.CSSProperties["alignItems"];
+    $reverse?: "max:xs" | "max:sm" | "max:md" | "max:lg" | "max:xl" | "max:xxl" | "min:xs" | "min:sm" | "min:md" | "min:lg" | "min:xl" | "min:xxl" | undefined;
+    /**
+     * It forces child columns to be on one line overflowing the content when it does not fit,
+     * it is suggested to use with children having a minimum width not in percentage,
+     * for things like sliders and carousels
+     */
+    $noWrap?: boolean | undefined;
+}, never>;
+export declare type ColProps = GridProps & Partial<Record<Breakpoint, number>> & {
+    $width?: number;
+    $flex?: boolean;
+    $valign?: React.CSSProperties["alignItems"];
+    $auto?: boolean;
+    $offset?: string;
+};
+export declare const Col: import("styled-components").StyledComponent<"div", import("styled-components").DefaultTheme, GridProps & Partial<Record<Breakpoint, number>> & {
+    $width?: number | undefined;
+    $flex?: boolean | undefined;
+    $valign?: React.CSSProperties["alignItems"];
+    $auto?: boolean | undefined;
+    $offset?: string | undefined;
+}, never>;
+export {};

package/Grid/Grid.js

@@ -0,0 +1,79 @@
+import styled from "styled-components";
+export const GRID_COLUMNS = 12;
+export const GRID_GUTTER_DEFAULT = "half";
+export const Container = styled.div `
+  max-width: ${(p) => p.theme.breakpoints[p.size]}px;
+  margin: 0 auto;
+  padding: 0 ${(p) => p.theme.gutter[p.$gutter || GRID_GUTTER_DEFAULT]}px;
+  ${(p) => (p.clamp ? "overflow: hidden;" : "")}
+`;
+export const ContainerFluid = styled.div `
+  padding: 0 ${(p) => p.theme.gutter[p.$gutter || GRID_GUTTER_DEFAULT]}px;
+`;
+export const Row = styled.div `
+  margin: 0 -${(p) => p.theme.gutter[p.$gutter || GRID_GUTTER_DEFAULT]}px;
+  display: flex;
+  ${(p) => (p.$noWrap ? "overflow: auto;" : "flex-wrap: wrap;")}
+  ${(p) => (p.$valign ? `align-items: ${p.$valign}` : "")};
+  ${(p) => p.$reverse &&
+    `@media (${p.$reverse.split(":")[0]}-width: ${p.$reverse.split(":")[1]}px) {
+      flex-direction: row-reverse;
+    }`}
+`;
+export const Col = styled.div `
+  padding: 0 ${(p) => p.theme.gutter[p.$gutter || GRID_GUTTER_DEFAULT]}px;
+  display: ${(p) => (p.$flex ? "flex" : "block")};
+  ${(p) => (p.$valign ? "align-items: " + p.$valign : "")};
+  ${(p) => getColCss(p)};
+`;
+function getColWidth(breakpoints, breakpoint, value) {
+    const breakpointValue = breakpoints[breakpoint] + "px";
+    const width = (value * 100) / GRID_COLUMNS;
+    const cssValue = `
+    min-width: ${width}%;
+    flex: 0 0 ${width}%;
+`;
+    if (breakpoint === Object.keys(breakpoints)[0]) {
+        return cssValue;
+    }
+    return `
+  @media (min-width: ${breakpointValue}){
+    ${cssValue}
+  }`;
+}
+function getColCss(props) {
+    const { $auto, $offset, $width } = props;
+    const { breakpoints } = props.theme;
+    let css = "";
+    if ($offset) {
+        const offsets = $offset.split(",");
+        for (let i = 0; i <= offsets.length; i++) {
+            if (offsets[i]) {
+                const [offsetBreakpoint, offsetSize] = offsets[i].split(":");
+                css += ` 
+          @media(min-width: ${breakpoints[offsetBreakpoint]}px){
+            margin-left: ${(100 * offsetSize) / GRID_COLUMNS}%;
+          }
+        `;
+            }
+        }
+    }
+    if ($width) {
+        // do nothing, width is set explicitly
+    }
+    else if ($auto) {
+        css += `flex: 0 0 auto; width: auto; max-width: none;`;
+    }
+    else {
+        for (const breakpoint in breakpoints) {
+            const value = props[breakpoint];
+            if (typeof value !== "undefined") {
+                css += getColWidth(breakpoints, breakpoint, value);
+            }
+            else if (breakpoint === "xs") {
+                css += getColWidth(breakpoints, breakpoint, 12);
+            }
+        }
+    }
+    return css;
+}

package/Grid/index.d.ts

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