@koine/react 1.0.10 → 1.0.13

package/scm/index.d.ts

@@ -0,0 +1,29 @@
+export * from "../shared";
+export * from "../Alert";
+export * from "../Animations";
+export * from "../Autocomplete";
+export * from "../Bg";
+export * from "../Breadcrumbs";
+export * from "../Buttons";
+export * from "../Carousel";
+export * from "../Collapsable";
+export * from "../Debug";
+export { KoineDialog, type KoineDialogProps } from "../Dialog/sc/framer";
+export * from "../Forms";
+export * from "../Grid";
+export * from "../Hamburger";
+export * from "../Header";
+export * from "../Hidden";
+export * from "../Img";
+export * from "../Link";
+export * from "../MenuItem";
+export * from "../Pagination";
+export * from "../Pill";
+export * from "../Progress";
+export * from "../Rating";
+export * from "../Sidebar";
+export * from "../Spacing";
+export * from "../Sticky";
+export * from "../styles";
+export * from "../Tabs";
+export * from "../Typography";

package/scm/index.js

@@ -0,0 +1,31 @@
+export * from "../shared";
+export * from "../Alert";
+export * from "../Animations";
+export * from "../Autocomplete";
+export * from "../Bg";
+export * from "../Breadcrumbs";
+export * from "../Buttons";
+export * from "../Carousel";
+export * from "../Collapsable";
+export * from "../Debug";
+export { KoineDialog } from "../Dialog/sc/framer";
+// export { KoineForm, type KoineFormProps} from "../Form/sc/framer";
+export * from "../Forms";
+export * from "../Grid";
+export * from "../Hamburger";
+export * from "../Header";
+export * from "../Hidden";
+export * from "../Img";
+export * from "../Link";
+export * from "../MenuItem";
+export * from "../Pagination";
+export * from "../Pill";
+export * from "../Progress";
+export * from "../Rating";
+// export * from "../Select";
+export * from "../Sidebar";
+export * from "../Spacing";
+export * from "../Sticky";
+export * from "../styles";
+export * from "../Tabs";
+export * from "../Typography";

package/scm/package.json

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

package/shared/index.d.ts

@@ -0,0 +1,8 @@
+export * from "../Calendar";
+export * from "../Dialog";
+export * from "../Favicon";
+export * from "../helpers";
+export * from "../hooks";
+export * from "../Meta";
+export * from "../NoJs";
+export * from "../types";

package/shared/index.js

@@ -0,0 +1,8 @@
+export * from "../Calendar";
+export * from "../Dialog";
+export * from "../Favicon";
+export * from "../helpers";
+export * from "../hooks";
+export * from "../Meta";
+export * from "../NoJs";
+export * from "../types";

package/shared/package.json

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

package/styles/Body.d.ts

@@ -0,0 +1,10 @@
+export declare const BodyRoot: import("styled-components").StyledComponent<"div", import("styled-components").DefaultTheme, {}, never>;
+/**
+ * If you have background graphics to overlap you might need to add:
+ *
+ * ```css
+ * z-index: 1;
+ * position: relative;
+ * ```
+ */
+export declare const BodyMain: import("styled-components").StyledComponent<"main", import("styled-components").DefaultTheme, {}, never>;

package/styles/Body.js

@@ -0,0 +1,13 @@
+import { __makeTemplateObject } from "tslib";
+import styled from "styled-components";
+export var BodyRoot = styled.div(templateObject_1 || (templateObject_1 = __makeTemplateObject(["\n  display: flex;\n  flex-direction: column;\n  min-height: 100vh;\n"], ["\n  display: flex;\n  flex-direction: column;\n  min-height: 100vh;\n"])));
+/**
+ * If you have background graphics to overlap you might need to add:
+ *
+ * ```css
+ * z-index: 1;
+ * position: relative;
+ * ```
+ */
+export var BodyMain = styled.main(templateObject_2 || (templateObject_2 = __makeTemplateObject(["\n  flex: 1;\n"], ["\n  flex: 1;\n"])));
+var templateObject_1, templateObject_2;

package/styles/Global.d.ts

@@ -0,0 +1,15 @@
+/**
+ * App global style
+ *
+ * For examples of what to do here take a look at [Bootstrap's reset](https://github.com/twbs/bootstrap/blob/main/scss/_reboot.scss)
+ * and similar.
+ *
+ * What we do here:
+ * - set the base font family on all possible elements including placeholders prevent Chrome showing a standard font when using the autofill feature
+ *  - @see https://stackoverflow.com/a/60987373/1938970
+ * - set the base font size on all possible elements to prevent weird zooming on input fields on iPhone iOS devices.
+ *  - @see https://www.warrenchandler.com/2019/04/02/stop-iphones-from-zooming-in-on-form-fields/
+ *  - @see https://css-tricks.com/16px-or-larger-text-prevents-ios-form-zoom/
+ */
+export declare const stylesGlobal = "\n  body {\n    margin: 0;\n    padding: 0;\n    overflow-x: hidden;\n    overflow-y: scroll;\n  }\n\n  body,\n  button,\n  input,\n  textarea,\n  select,\n  select:-webkit-autofill::first-line,\n  input:-webkit-autofill::first-line {\n    font-family: var(--font), -apple-system, BlinkMacSystemFont, \"Segoe UI\",\n      Roboto, Oxygen, Ubuntu, Cantarell, \"Open Sans\", \"Helvetica Neue\",\n      sans-serif;\n    font-size: var(--fontSize);\n  }\n\n  html {\n    box-sizing: border-box;\n    @media (prefers-reduced-motion: no-preference) {\n      scroll-behavior: smooth;\n    }\n  }\n\n  *,\n  *:before,\n  *:after {\n    box-sizing: inherit;\n    -webkit-tap-highlight-color: transparent;\n  }\n";
+export declare const StylesGlobal: import("styled-components").GlobalStyleComponent<{}, import("styled-components").DefaultTheme>;

package/styles/Global.js

@@ -0,0 +1,18 @@
+import { __makeTemplateObject } from "tslib";
+import { createGlobalStyle } from "styled-components";
+/**
+ * App global style
+ *
+ * For examples of what to do here take a look at [Bootstrap's reset](https://github.com/twbs/bootstrap/blob/main/scss/_reboot.scss)
+ * and similar.
+ *
+ * What we do here:
+ * - set the base font family on all possible elements including placeholders prevent Chrome showing a standard font when using the autofill feature
+ *  - @see https://stackoverflow.com/a/60987373/1938970
+ * - set the base font size on all possible elements to prevent weird zooming on input fields on iPhone iOS devices.
+ *  - @see https://www.warrenchandler.com/2019/04/02/stop-iphones-from-zooming-in-on-form-fields/
+ *  - @see https://css-tricks.com/16px-or-larger-text-prevents-ios-form-zoom/
+ */
+export var stylesGlobal = "\n  body {\n    margin: 0;\n    padding: 0;\n    overflow-x: hidden;\n    overflow-y: scroll;\n  }\n\n  body,\n  button,\n  input,\n  textarea,\n  select,\n  select:-webkit-autofill::first-line,\n  input:-webkit-autofill::first-line {\n    font-family: var(--font), -apple-system, BlinkMacSystemFont, \"Segoe UI\",\n      Roboto, Oxygen, Ubuntu, Cantarell, \"Open Sans\", \"Helvetica Neue\",\n      sans-serif;\n    font-size: var(--fontSize);\n  }\n\n  html {\n    box-sizing: border-box;\n    @media (prefers-reduced-motion: no-preference) {\n      scroll-behavior: smooth;\n    }\n  }\n\n  *,\n  *:before,\n  *:after {\n    box-sizing: inherit;\n    -webkit-tap-highlight-color: transparent;\n  }\n";
+export var StylesGlobal = createGlobalStyle(templateObject_1 || (templateObject_1 = __makeTemplateObject(["", ""], ["", ""])), stylesGlobal);
+var templateObject_1;

package/styles/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./Body";
+export * from "./Global";
+export * from "./media";
+export * from "./spacing";
+export * from "./styled";
+export * from "./theme";
+export * from "./theme--vanilla";

package/styles/index.js

@@ -0,0 +1,7 @@
+export * from "./Body";
+export * from "./Global";
+export * from "./media";
+export * from "./spacing";
+export * from "./styled";
+export * from "./theme";
+export * from "./theme--vanilla";

package/styles/media.d.ts

@@ -0,0 +1,67 @@
+import { Breakpoint, Breakpoints } from "./theme";
+export declare const min: MediaQueryFunction, max: MediaQueryFunction, up: MediaQueryFunction, down: (br: Breakpoint) => string, between: (br1: Breakpoint, br2: Breakpoint) => string, only: (br: Breakpoint) => string;
+export declare type MediaDirection = "min" | "max";
+export declare type MediaQuery = `${MediaDirection}:${Breakpoint}`;
+export declare type MediaQueryFunction = {
+    [Breakpoint in keyof Breakpoints]: string;
+} & {
+    (breakpoint: Breakpoint): string;
+};
+export declare function useMedia(media: MediaQuery): boolean;
+/**
+ * Generate media queries helpers
+ *
+ * Usage:
+ * ```jsx
+ * import { generateMediaQueries } from "@koine/react";
+ *
+ * export const breakpoints = {
+ *   xs: 0,
+ *   sm: 440,
+ *   md: 768,
+ *   lg: 1024,
+ *   xl: 1368,
+ *   xxl: 1690,
+ * } as const;
+ *
+ * export const { min, max, up, down, between, only } = generateMediaQueries(breakpoints);
+ * ```
+ *
+ * Consider the following syntaxes, using normal CSS is just slightly
+ * longer but it aovid js imports, reduce the js overhead and improve CSS
+ * highlighting in the editor.
+ *
+ * Even if we would reduce the function signature to the bare minimum the advantage
+ * in terms of typing would not be much, also loosing in readability.
+ *
+ * ```css
+ * // but unfortunately this does not work
+ * @media (min-width: var(--b-sm)) {}
+ * @media (min-width: 480px) {}
+ *
+ * ${media("min", "sm")} {}
+ * ${mediaMin("sm")} {}
+ * ${min.sm} {}
+ * ${p => p.theme.min.sm}``
+ * ```
+ *
+ * Related projects:
+ * @see https://github.com/mg901/styled-breakpoints
+ * @see https://github.com/morajabi/styled-media-query
+ *
+ * @see https://www.w3.org/TR/mediaqueries-5/#custom-mq The spec would allow for
+ * something like this syntax
+ *
+ * ```css
+ * @custom-media --narrow-window (max-width: 30em);
+ * @media (--narrow-window) {}
+ * ```
+ */
+export declare function generateMediaQueries(breakpoints: Breakpoints): {
+    min: MediaQueryFunction;
+    max: MediaQueryFunction;
+    up: MediaQueryFunction;
+    down: (br: Breakpoint) => string;
+    between: (br1: Breakpoint, br2: Breakpoint) => string;
+    only: (br: Breakpoint) => string;
+};

package/styles/media.js

@@ -0,0 +1,155 @@
+var _a;
+import { useState, useEffect } from "react";
+import { useTheme, breakpoints } from "./theme";
+export var min = (_a = generateMediaQueries(breakpoints), _a.min), max = _a.max, up = _a.up, down = _a.down, between = _a.between, only = _a.only;
+export function useMedia(media) {
+    var breakpoints = useTheme().breakpoints;
+    var _a = useState(false), matches = _a[0], setMatches = _a[1];
+    var _b = media.split(":"), _c = _b[0], direction = _c === void 0 ? "min" : _c, breakpoint = _b[1];
+    var px = breakpoints[breakpoint];
+    if (direction === "max") {
+        px = px - 0.02;
+    }
+    var query = "(".concat(direction, "-width: ").concat(px, "px)");
+    useEffect(function () {
+        var mq = window.matchMedia(query);
+        var handleChange = function (event) {
+            setMatches(event.matches);
+        };
+        setMatches(mq.matches);
+        // Safari < 14 can't use addEventListener on a MediaQueryList
+        // https://developer.mozilla.org/en-US/docs/Web/API/MediaQueryList#Browser_compatibility
+        if (!mq.addEventListener) {
+            // Update the state whenever the media query match state changes
+            mq.addListener(handleChange);
+            // Clean up on unmount and if the query changes
+            return function () {
+                mq.removeListener(handleChange);
+            };
+        }
+        mq.addEventListener("change", handleChange);
+        return function () {
+            mq.removeEventListener("change", handleChange);
+        };
+    }, [query]);
+    return matches;
+}
+/**
+ * Generate media queries helpers
+ *
+ * Usage:
+ * ```jsx
+ * import { generateMediaQueries } from "@koine/react";
+ *
+ * export const breakpoints = {
+ *   xs: 0,
+ *   sm: 440,
+ *   md: 768,
+ *   lg: 1024,
+ *   xl: 1368,
+ *   xxl: 1690,
+ * } as const;
+ *
+ * export const { min, max, up, down, between, only } = generateMediaQueries(breakpoints);
+ * ```
+ *
+ * Consider the following syntaxes, using normal CSS is just slightly
+ * longer but it aovid js imports, reduce the js overhead and improve CSS
+ * highlighting in the editor.
+ *
+ * Even if we would reduce the function signature to the bare minimum the advantage
+ * in terms of typing would not be much, also loosing in readability.
+ *
+ * ```css
+ * // but unfortunately this does not work
+ * @media (min-width: var(--b-sm)) {}
+ * @media (min-width: 480px) {}
+ *
+ * ${media("min", "sm")} {}
+ * ${mediaMin("sm")} {}
+ * ${min.sm} {}
+ * ${p => p.theme.min.sm}``
+ * ```
+ *
+ * Related projects:
+ * @see https://github.com/mg901/styled-breakpoints
+ * @see https://github.com/morajabi/styled-media-query
+ *
+ * @see https://www.w3.org/TR/mediaqueries-5/#custom-mq The spec would allow for
+ * something like this syntax
+ *
+ * ```css
+ * @custom-media --narrow-window (max-width: 30em);
+ * @media (--narrow-window) {}
+ * ```
+ */
+export function generateMediaQueries(breakpoints) {
+    var temp = Object.keys(breakpoints).map(function (key) {
+        var br = key;
+        return [br, breakpoints[br]];
+    });
+    var sortedKeys = temp.sort(function (a, b) { return a[1] - b[1]; }).map(function (item) { return item[0]; });
+    var getNext = function (breakpoint) {
+        var index = sortedKeys.indexOf(breakpoint);
+        return sortedKeys[index + 1];
+    };
+    /**
+     * It behaves the same as `@media (min-width: ${value}px)`
+     * where value is the given breakpoint value.
+     * For ease of use this can be used both as a function `min("md")` and as an
+     * object literal `min.md`.
+     */ // @ts-expect-error FIXME: at some point
+    var min = function (br) {
+        return "@media (min-width: ".concat(breakpoints[br], "px)");
+    };
+    /**
+     * It behaves the same as `@media (max-width: ${value}px)`
+     * where value is the given breakpoint value.
+     * For ease of use this can be used both as a function `max("md")` and as an
+     * object literal `max.md`.
+     */ // @ts-expect-error FIXME: at some point
+    var max = function (br) {
+        return "@media (max-width: ".concat(breakpoints[br] - 0.02, "px)");
+    };
+    for (var br in breakpoints) {
+        var _br = br;
+        min[_br] = "@media (min-width: ".concat(breakpoints[_br], "px)");
+        max[_br] = "@media (max-width: ".concat(breakpoints[_br] - 0.02, "px)");
+    }
+    /**
+     * It behaves the same as `min`
+     * @inheritdoc {max}
+     */
+    var up = min;
+    /**
+     * It behaves similarly to `max` but you will use the "next" breakpoint,
+     * specifying CSS that will apply from the given breakpoint and down.
+     */
+    var down = function (br) {
+        var brNext = getNext(br);
+        // TODO: if br does not exists otherwise throw Error
+        return brNext && "@media (max-width: ".concat(breakpoints[brNext] - 0.02, "px)");
+    };
+    /**
+     * Media query between the two given breakpoints
+     */
+    var between = function (br1, br2) {
+        return "@media (min-width: ".concat(breakpoints[br1], "px) and (max-width: ").concat(breakpoints[br2] - 0.02, "px)");
+    };
+    /**
+     * Media query to apply from the given breakpoint until the next, just for its
+     * full range
+     */
+    var only = function (br) {
+        var brNext = getNext(br);
+        return brNext ? between(br, brNext) : min(br);
+    };
+    return {
+        min: min,
+        max: max,
+        up: up,
+        down: down,
+        between: between,
+        only: only,
+    };
+}

package/styles/package.json

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

package/styles/spacing.d.ts

@@ -0,0 +1,13 @@
+import type { Theme } from "./theme";
+export declare type SpacingSize = "sm" | "md" | "lg";
+export declare type SpacingProperty = "padding" | "margin";
+/** @default 1 */
+export declare type SpacingFactor = number;
+export declare type SpacingDirection = "top" | "bottom";
+export declare type SpacingDirectionAxis = "vertical" | SpacingDirection;
+export declare type SpacingDevices = keyof Theme["devices"];
+export declare type SpacingArgs = Parameters<typeof spacing>;
+export declare function spacing(this: Theme, size?: SpacingSize, factor?: SpacingFactor, property?: SpacingProperty, direction?: SpacingDirectionAxis, devices?: SpacingDevices[]): string;
+export declare function spacingTop(this: Theme, size?: SpacingSize, factor?: SpacingFactor, property?: SpacingProperty, devices?: SpacingDevices[]): string;
+export declare function spacingBottom(this: Theme, size?: SpacingSize, factor?: SpacingFactor, property?: SpacingProperty, devices?: SpacingDevices[]): string;
+export declare function spacingVertical(this: Theme, size?: SpacingSize, factor?: SpacingFactor, property?: SpacingProperty, devices?: SpacingDevices[]): string;

package/styles/spacing.js

@@ -0,0 +1,45 @@
+function _spacing(theme, size, factor, property, direction, devices) {
+    if (size === void 0) { size = "md"; }
+    if (factor === void 0) { factor = 1; }
+    if (property === void 0) { property = "padding"; }
+    if (direction === void 0) { direction = "top"; }
+    if (devices === void 0) { devices = ["mobile", "tablet", "desktop"]; }
+    var breakpoints = theme.breakpoints, DEVICES = theme.devices, SPACES = theme.spaces;
+    var css = "";
+    var prop = "".concat(property, "-").concat(direction);
+    if (!devices.length || devices[0] === "mobile") {
+        css += "@media(max-width: ".concat(breakpoints[DEVICES.mobile], "px){\n        ").concat(prop, ": ").concat(SPACES["mobile"][size] * factor, "px;\n      }");
+    }
+    else {
+        for (var index = 0; index < devices.length; index++) {
+            var device = devices[index];
+            if (device === "mobile") {
+                css += "".concat(prop, ": ").concat(SPACES[device][size] * factor, "px;");
+            }
+            else if (device === "tablet") {
+                css += "@media(min-width: ".concat(breakpoints[DEVICES.tablet], "px){\n          ").concat(prop, ": ").concat(SPACES["tablet"][size] * factor, "px;\n        }");
+            }
+            else if (device === "desktop") {
+                css += "@media(min-width: ".concat(breakpoints[DEVICES.desktop], "px){\n          ").concat(prop, ": ").concat(SPACES["desktop"][size] * factor, "px;\n        }");
+            }
+        }
+    }
+    return css;
+}
+export function spacing(size, factor, property, direction, devices) {
+    if (direction === "vertical") {
+        return (_spacing(this, size, factor, property, "top", devices) +
+            _spacing(this, size, factor, property, "bottom", devices));
+    }
+    return _spacing(this, size, factor, property, direction, devices);
+}
+export function spacingTop(size, factor, property, devices) {
+    return _spacing(this, size, factor, property, "top", devices);
+}
+export function spacingBottom(size, factor, property, devices) {
+    return _spacing(this, size, factor, property, "bottom", devices);
+}
+export function spacingVertical(size, factor, property, devices) {
+    return (_spacing(this, size, factor, property, "top", devices) +
+        _spacing(this, size, factor, property, "bottom", devices));
+}

package/styles/styled.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+export declare function colStretch(direction: "left" | "right", bg: React.CSSProperties["background"]): string;
+/** @see https://caniuse.com/?search=inset */
+export declare const inset0 = "top:0;left:0;right:0;bottom:0;";
+export declare const overlay: string;
+export declare const centered = "display: flex;align-items: center;justify-content: center;";
+export declare const ellipsis = "overflow: hidden;text-overflow: ellipsis;white-space: nowrap;";
+/**
+ * @see import("@mui/utils").visuallyHidden https://github.com/mui-org/material-ui/blob/master/packages/mui-utils/src/visuallyHidden.ts
+ */
+export declare const invisible = "border: 0;clip: rect(0 0 0 0);height: 1px;margin: -1px;overflow: hidden;padding: 0;position: absolute;white-space: nowrap;width: 1px;";
+export declare const stateFocus = "outline: 0px;box-shadow: 0 0 0 0.2rem rgba(200, 200, 200, 0.25);";

package/styles/styled.js

@@ -0,0 +1,13 @@
+export function colStretch(direction, bg) {
+    return "\n    background: ".concat(bg, ";\n    position: relative;\n\n    &:before{\n      z-index: -1;\n      content: '';\n      position: absolute;\n      right: ").concat(direction === "left" ? "100%" : "-100vw", ";\n      left: ").concat(direction === "right" ? "100%" : "-100vw", ";\n      top: 0;\n      bottom: 0;\n      background: ").concat(bg, ";\n    }\n  ");
+}
+/** @see https://caniuse.com/?search=inset */
+export var inset0 = "top:0;left:0;right:0;bottom:0;";
+export var overlay = "position: absolute;".concat(inset0);
+export var centered = "display: flex;align-items: center;justify-content: center;";
+export var ellipsis = "overflow: hidden;text-overflow: ellipsis;white-space: nowrap;";
+/**
+ * @see import("@mui/utils").visuallyHidden https://github.com/mui-org/material-ui/blob/master/packages/mui-utils/src/visuallyHidden.ts
+ */
+export var invisible = "border: 0;clip: rect(0 0 0 0);height: 1px;margin: -1px;overflow: hidden;padding: 0;position: absolute;white-space: nowrap;width: 1px;";
+export var stateFocus = "outline: 0px;box-shadow: 0 0 0 0.2rem rgba(200, 200, 200, 0.25);";

package/styles/theme--vanilla.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="react" />
+export declare const THEME_KEY = "theme";
+export declare const THEME_DEFAULT: ThemeVanillaValue;
+export declare const getInitialThemeFromRequest: (cookie?: string | undefined) => ThemeVanillaValue;
+export declare const getInitialThemeFromClient: () => ThemeVanillaValue;
+export declare type ThemeCookie = {
+    [THEME_KEY]: ThemeVanillaValue;
+};
+export declare type ThemeVanillaValue = "light" | "dark";
+export declare type ThemeVanillaContextType = {
+    theme: ThemeVanillaValue;
+    setTheme?: React.Dispatch<React.SetStateAction<ThemeVanillaValue>>;
+};
+export declare const ThemeVanillaContext: import("react").Context<ThemeVanillaContextType>;
+export declare type ThemeVanillaProviderProps = React.PropsWithChildren<{
+    initialTheme: ThemeVanillaValue;
+}>;
+export declare const ThemeVanillaProvider: ({ initialTheme, children, }: ThemeVanillaProviderProps) => JSX.Element;

package/styles/theme--vanilla.js

@@ -0,0 +1,55 @@
+import { __assign } from "tslib";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useState } from "react";
+import { isBrowser, setCookie, parseCookie } from "@koine/utils";
+import { useMount, useUpdateEffect } from "../hooks";
+export var THEME_KEY = "theme";
+export var THEME_DEFAULT = "light";
+export var getInitialThemeFromRequest = function (cookie) {
+    if (cookie) {
+        var parsed = parseCookie(cookie);
+        return parsed === null || parsed === void 0 ? void 0 : parsed.theme;
+    }
+    return THEME_DEFAULT;
+};
+export var getInitialThemeFromClient = function () {
+    if (typeof window !== "undefined" && window.localStorage) {
+        var storedPrefs = window.localStorage.getItem(THEME_KEY);
+        if (typeof storedPrefs === "string") {
+            return storedPrefs;
+        }
+        var userMedia = window.matchMedia("(prefers-color-scheme: dark)");
+        if (userMedia.matches) {
+            return "dark";
+        }
+    }
+    return THEME_DEFAULT;
+};
+export var ThemeVanillaContext = createContext({
+    theme: "light",
+    setTheme: undefined,
+});
+export var ThemeVanillaProvider = function (_a) {
+    var initialTheme = _a.initialTheme, children = _a.children;
+    var _b = useState(initialTheme), theme = _b[0], setTheme = _b[1];
+    var rawSetTheme = function (rawTheme) {
+        if (!rawTheme || !isBrowser) {
+            return;
+        }
+        var root = window.document.documentElement;
+        var isDark = rawTheme === "dark";
+        root.classList.remove(isDark ? "light" : "dark");
+        root.classList.add(rawTheme);
+        localStorage.setItem(THEME_KEY, rawTheme);
+        setCookie(THEME_KEY, rawTheme);
+    };
+    useMount(function () {
+        var theme = getInitialThemeFromClient();
+        setTheme(theme);
+        rawSetTheme(theme);
+    });
+    useUpdateEffect(function () {
+        rawSetTheme(theme);
+    }, [theme]);
+    return (_jsx(ThemeVanillaContext.Provider, __assign({ value: { theme: theme, setTheme: setTheme } }, { children: children })));
+};

package/styles/theme.d.ts

@@ -0,0 +1,82 @@
+export declare type Breakpoint = "xs" | "sm" | "md" | "lg" | "xl" | "xxl";
+export declare type Breakpoints = Record<Breakpoint, number>;
+/**
+ * You can override the default breakpoints through the .env variable
+ *
+ * FIXME: find a better way to configure it, the problem is that we use the media
+ * queries within this pre-compiled library and thrught it was better to avoid
+ * using theming props for a more ergonomic usage.
+ *
+ * ```.env
+ * BREAKPOINTS=xs:0,sm:440,md:768,lg:1024,xl:1368,xxl:1690
+ * ```
+ */
+export declare const breakpoints: Breakpoints;
+export declare const createTheme: (options: ThemeOptions) => Theme;
+export declare const useTheme: () => Theme;
+export declare type Theme = {
+    maxWidth: number;
+    gutter: {
+        quarter: number;
+        third: number;
+        half: number;
+        /** @default 60 */
+        normal: number;
+        double: number;
+        triple: number;
+    };
+    breakpoints: Breakpoints;
+    devices: {
+        /** @default "sm" */
+        mobile: keyof Breakpoints;
+        /** @default "md" */
+        tablet: keyof Breakpoints;
+        /** @default "lg" */
+        desktop: keyof Breakpoints;
+    };
+    spaces: {
+        mobile: {
+            /** @default 10 */
+            sm: number;
+            /** @default 20 */
+            md: number;
+            /** @default 40 */
+            lg: number;
+        };
+        tablet: {
+            /** @default 15 */
+            sm: number;
+            /** @default 30 */
+            md: number;
+            /** @default 60 */
+            lg: number;
+        };
+        desktop: {
+            /** @default 20 */
+            sm: number;
+            /** @default 40 */
+            md: number;
+            /** @default 80 */
+            lg: number;
+        };
+    };
+    header: {
+        /** @default "lg" */
+        breakpoint: keyof Breakpoints;
+        /** @default [82, 134] */
+        height: [number, number];
+        /** @default [60, 90] */
+        heightSticky: [number, number];
+        /** @default [76, 76] */
+        logoWidth: [number, number];
+        /** @default [70, 70] */
+        logoWidthSticky: [number, number];
+    };
+};
+export declare type ThemeOptions = {
+    maxWidth?: number;
+    gutter: NonNullable<Theme["gutter"]>;
+    devices?: Theme["devices"];
+    spaces: NonNullable<Theme["spaces"]>;
+    header: NonNullable<Theme["header"]>;
+};