tabler-react-2 0.1.96 → 0.1.98

package/dist/index.js

@@ -192,5 +192,17 @@ Object.keys(_index18).forEach(function (key) {
     }
   });
 });
+var _index19 = require("./offcanvas/index");
+Object.keys(_index19).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _index19[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _index19[key];
+    }
+  });
+});
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { "default": e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n["default"] = e, t && t.set(e, n), n; }

package/dist/input/input.js

@@ -9,7 +9,7 @@ var _react = _interopRequireWildcard(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _spinner = require("../spinner");
 var _classnames = _interopRequireDefault(require("classnames"));
-var _excluded = ["type", "label", "placeholder", "value", "onChange", "onRawChange", "onInput", "icon", "iconPos", "loader", "separated", "prependedText", "appendedText", "appendedLinkText", "appendedLinkHref", "appendedLinkOnClick", "datalistItems", "variant", "size", "noMargin", "inputProps"];
+var _excluded = ["type", "label", "placeholder", "value", "onChange", "onRawChange", "onInput", "icon", "iconPos", "loader", "separated", "prependedText", "appendedText", "appendedLinkText", "appendedLinkHref", "appendedLinkOnClick", "datalistItems", "variant", "size", "noMargin", "inputProps", "helpText", "helpTextPlacement", "helpPrompt", "required", "hint", "labelDescription"];
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { "default": e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n["default"] = e, t && t.set(e, n), n; }
@@ -49,6 +49,12 @@ var Input = exports.Input = function Input(_ref) {
     _ref$noMargin = _ref.noMargin,
     noMargin = _ref$noMargin === void 0 ? false : _ref$noMargin,
     inputProps = _ref.inputProps,
+    helpText = _ref.helpText,
+    helpTextPlacement = _ref.helpTextPlacement,
+    helpPrompt = _ref.helpPrompt,
+    required = _ref.required,
+    hint = _ref.hint,
+    labelDescription = _ref.labelDescription,
     props = _objectWithoutProperties(_ref, _excluded);
   // State for managing uncontrolled input value
   var _useState = (0, _react.useState)(controlledValue),
@@ -92,8 +98,16 @@ var Input = exports.Input = function Input(_ref) {
   return /*#__PURE__*/_react["default"].createElement("div", _extends({
     className: "".concat(noMargin ? "" : "mb-3")
   }, props), label && /*#__PURE__*/_react["default"].createElement("label", {
-    className: "form-label"
-  }, label), separated ? /*#__PURE__*/_react["default"].createElement("div", {
+    className: "form-label ".concat(required ? "required" : "")
+  }, label, helpText && /*#__PURE__*/_react["default"].createElement(_react["default"].Fragment, null, " ", /*#__PURE__*/_react["default"].createElement("span", {
+    "class": "form-help",
+    "data-bs-toggle": "popover",
+    "data-bs-placement": helpTextPlacement || "top",
+    "data-bs-html": "true",
+    "data-bs-content": helpText
+  }, helpPrompt || "?")), labelDescription && /*#__PURE__*/_react["default"].createElement("span", {
+    className: "form-label-description"
+  }, labelDescription)), separated ? /*#__PURE__*/_react["default"].createElement("div", {
     className: "row g-2"
   }, /*#__PURE__*/_react["default"].createElement("div", {
     className: "col"
@@ -145,7 +159,9 @@ var Input = exports.Input = function Input(_ref) {
       key: index,
       value: item
     });
-  }))));
+  }))), hint && /*#__PURE__*/_react["default"].createElement("div", {
+    className: "form-hint"
+  }, hint));
 };
 Input.propTypes = {
   type: _propTypes["default"].string,

package/dist/offcanvas/index.js

@@ -0,0 +1,171 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useOffcanvas = exports.Offcanvas = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _button = require("../button");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { "default": e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n["default"] = e, t && t.set(e, n), n; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+var Offcanvas = exports.Offcanvas = /*#__PURE__*/_react["default"].memo(function (_ref) {
+  var show = _ref.show,
+    onHide = _ref.onHide,
+    position = _ref.position,
+    children = _ref.children;
+  // backdrop style
+  var backdropStyle = (0, _react.useMemo)(function () {
+    return {
+      position: "fixed",
+      top: 0,
+      left: 0,
+      width: "100vw",
+      height: "100vh",
+      backgroundColor: "rgba(0,0,0,0.1)",
+      zIndex: 999
+    };
+  }, []);
+
+  // offcanvas container style
+  var containerStyle = (0, _react.useMemo)(function () {
+    var base = {
+      position: "fixed",
+      backgroundColor: "#fff",
+      boxShadow: "0 0.5rem 1rem rgba(0,0,0,0.15)",
+      transition: "transform 0.3s ease-out",
+      zIndex: 1000,
+      padding: 20,
+      overflow: "auto"
+    };
+    switch (position) {
+      case "end":
+        return _objectSpread(_objectSpread({}, base), {}, {
+          top: 0,
+          bottom: 0,
+          right: 0,
+          width: "300px",
+          transform: show ? "translateX(0)" : "translateX(100%)"
+        });
+      case "top":
+        return _objectSpread(_objectSpread({}, base), {}, {
+          left: 0,
+          right: 0,
+          top: 0,
+          height: "300px",
+          transform: show ? "translateY(0)" : "translateY(-100%)"
+        });
+      case "bottom":
+        return _objectSpread(_objectSpread({}, base), {}, {
+          left: 0,
+          right: 0,
+          bottom: 0,
+          height: "300px",
+          transform: show ? "translateY(0)" : "translateY(100%)"
+        });
+      case "start":
+      default:
+        return _objectSpread(_objectSpread({}, base), {}, {
+          top: 0,
+          bottom: 0,
+          left: 0,
+          width: "300px",
+          transform: show ? "translateX(0)" : "translateX(-100%)"
+        });
+    }
+  }, [position, show]);
+  return /*#__PURE__*/_react["default"].createElement(_react["default"].Fragment, null, show && /*#__PURE__*/_react["default"].createElement("div", {
+    style: backdropStyle,
+    onClick: onHide
+  }), /*#__PURE__*/_react["default"].createElement("div", {
+    style: containerStyle,
+    role: "dialog",
+    "aria-hidden": !show
+  }, children));
+});
+Offcanvas.displayName = "Offcanvas";
+Offcanvas.propTypes = {
+  /** Show or hide the offcanvas */
+  show: _propTypes["default"].bool.isRequired,
+  /** Callback when the backdrop is clicked */
+  onHide: _propTypes["default"].func.isRequired,
+  /** Position: 'start' (left), 'end' (right), 'top', or 'bottom' */
+  position: _propTypes["default"].oneOf(["start", "end", "top", "bottom"]),
+  /** Content inside the offcanvas */
+  children: _propTypes["default"].node
+};
+Offcanvas.defaultProps = {
+  position: "start",
+  children: null
+};
+var useOffcanvas = exports.useOffcanvas = function useOffcanvas() {
+  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var _useState = (0, _react.useState)({
+      show: false,
+      resolve: null,
+      content: options.content || null,
+      position: options.position || "start"
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    state = _useState2[0],
+    setState = _useState2[1];
+  var offcanvas = (0, _react.useCallback)(function () {
+    var newOptions = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    return new Promise(function (resolve) {
+      setState(function (prev) {
+        var _newOptions$content, _newOptions$position;
+        return _objectSpread(_objectSpread({}, prev), {}, {
+          show: true,
+          resolve: resolve,
+          content: (_newOptions$content = newOptions.content) !== null && _newOptions$content !== void 0 ? _newOptions$content : prev.content,
+          position: (_newOptions$position = newOptions.position) !== null && _newOptions$position !== void 0 ? _newOptions$position : prev.position
+        });
+      });
+    });
+  }, []);
+  var close = (0, _react.useCallback)(function () {
+    if (state.resolve) {
+      state.resolve();
+    }
+    setState(function (prev) {
+      return _objectSpread(_objectSpread({}, prev), {}, {
+        show: false,
+        resolve: null
+      });
+    });
+  }, [state.resolve]);
+  var OffcanvasElement = /*#__PURE__*/_react["default"].createElement(Offcanvas, _extends({
+    show: state.show,
+    onHide: close,
+    position: state.position
+  }, options.offcanvasProps || {}), /*#__PURE__*/_react["default"].createElement(_button.Button, {
+    type: "button",
+    className: "btn-close",
+    "aria-label": "Close",
+    onClick: close,
+    style: {
+      position: "absolute",
+      top: 10,
+      right: 10
+    }
+  }), state.content);
+  return {
+    offcanvas: offcanvas,
+    OffcanvasElement: OffcanvasElement,
+    close: close
+  };
+};

package/dist/provider/tabler.js

@@ -34,11 +34,11 @@ var TablerProvider = exports.TablerProvider = function TablerProvider(_ref3) {
     fallbackAnchor = _ref3$fallbackAnchor === void 0 ? true : _ref3$fallbackAnchor;
   (0, _react.useEffect)(function () {
     var script1 = document.createElement("script");
-    script1.src = "https://cdn.jsdelivr.net/npm/@tabler/core@1.0.0-beta17/dist/js/tabler.min.js";
+    script1.src = "https://cdn.jsdelivr.net/npm/@tabler/core@1.2.0/dist/js/tabler.min.js";
     script1.async = true;
     var link = document.createElement("link");
     link.rel = "stylesheet";
-    link.href = "https://cdn.jsdelivr.net/npm/@tabler/core@1.0.0-beta17/dist/css/tabler.min.css";
+    link.href = "https://cdn.jsdelivr.net/npm/@tabler/core@1.2.0/dist/css/tabler.min.css";
     var script2 = document.createElement("script");
     script2.textContent = "window.USE_FALLBACK_ANCHOR = ".concat(fallbackAnchor, ";");
     document.head.appendChild(link);

package/docs/package.json

@@ -22,7 +22,7 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "styled-components": "^6.1.15",
-    "tabler-react-2": "^0.1.95"
+    "tabler-react-2": "^0.1.97"
   },
   "devDependencies": {},
   "keywords": [

package/docs/src/config/sidebar.yml

@@ -6,6 +6,8 @@
   link: "/getting-started"
 - label: "Theme"
   link: "/theme"
+- label: "Changelog"
+  link: "/changelog"
 - label: "Components"
   items:
     - label: "Typography"

package/docs/src/docs/changelog.mdx

@@ -0,0 +1,8 @@
+---
+title: Changelog
+---
+
+## 0.1.97
+
+- Added `helpText`, `helpTextPlacement`, `helpPrompt`, `required`, `hint`, and `labelDescription` props to the `Input` component.
+- Updated the `TablerProvider` component to use the latest version of the Tabler core library. (migrated from `1.0.0-beta17` to `1.2.0`)

package/docs/src/docs/components/enclosed-select-group.mdx

@@ -11,22 +11,16 @@ Enclosed Select Groups are used to mask radio and checkbox inputs in boxes with
 ## Signature
 
 export const ControlledEnclosedSelectGroup = (props) => {
-  const [selectValue, setSelectValue] = useState();
+  const [value, setValue] = useState(props.value);
   return (
     <>
       <EnclosedSelectGroup
-        multiple
-        direction="column"
-        value={selectValue}
-        onChange={(v) => {
-          console.log(v);
-          setSelectValue(v);
+        {...props}
+        value={value}
+        onChange={(d) => {
+          setValue(d);
+          props.onChange && props.onChange(d);
         }}
-        items={[
-          { value: "one", content: <b>One</b> },
-          { value: "two", content: "Two" },
-          { value: "three", content: "Three" },
-        ]}
       />
     </>
   );
@@ -95,11 +89,7 @@ The `multiple` prop can be used to allow multiple items to be selected.
       { value: "two", label: "Two" },
       { value: "three", label: "Three" },
     ]}
-    value={[
-      {
-        value: "one",
-      },
-    ]}
+    value={[{ value: "one" }]}
     onChange={console.log}
     multiple
   />
@@ -112,7 +102,11 @@ The `multiple` prop can be used to allow multiple items to be selected.
     { value: "two", label: "Two" },
     { value: "three", label: "Three" },
   ]}
-  value={[]}
+  value={[
+    {
+      value: "one",
+    },
+  ]}
   onChange={console.log}
   multiple
 />
@@ -129,9 +123,10 @@ The `direction` prop can be used to change the direction of the items.
       { value: "two", label: "Two" },
       { value: "three", label: "Three" },
     ]}
-    value={null}
+    value={[]}
     onChange={console.log}
     direction="column"
+    multiple
   />
 </Excerpt>
 
@@ -142,8 +137,9 @@ The `direction` prop can be used to change the direction of the items.
     { value: "two", label: "Two" },
     { value: "three", label: "Three" },
   ]}
-  value={null}
+  value={[]}
   onChange={console.log}
   direction="column"
+  multiple
 />
 ```

package/docs/src/docs/components/input.mdx

@@ -40,6 +40,12 @@ import { Input } from "tabler-react-2";
 | `variant`             | No       | [color](/utilities/colors) |           | The color variant of the button.                                                                                        |
 | `size`                | No       | [`sm`, `md`, `lg`]         | `md`      | The size of the button.                                                                                                 |
 | `inputProps`          | No       | Object                     |           | The props to be passed to the input.                                                                                    |
+| `helpText`            | No       | String                     |           | The help text to be shown below the label.                                                                              |
+| `helpTextPlacement`   | No       | String                     | `top`     | The placement of the help text.                                                                                         |
+| `helpPrompt`          | No       | String                     | `?`       | The prompt to be shown in the field's label.                                                                            |
+| `required`            | No       | Boolean                    |           | Whether the input is required.                                                                                          |
+| `hint`                | No       | String                     |           | The hint to be shown below the input.                                                                                   |
+| `labelDescription`    | No       | String                     |           | The description to be shown to the right of the label.                                                                  |
 
 ## Basic Usage
 
@@ -428,3 +434,60 @@ You can supply a list of items to the `datalistItems` prop to show a datalist. T
 ```
 
 This is different than a DropdownInput because the datalist is not exclusive, meaning the user can use a value that is not in the list.
+
+## Help Text
+
+You can supply a `helpText` prop to the `Input` component to show a help text below the label.
+
+<Excerpt>
+  <Input
+    label="Input"
+    placeholder="Type here..."
+    helpText="This is some help text"
+    helpPrompt="?"
+  />
+</Excerpt>
+
+```jsx
+<Input
+  label="Input"
+  placeholder="Type here..."
+  helpText="This is some help text"
+/>
+```
+
+## Required
+
+You can supply a `required` prop to the `Input` component to show a red asterisk next to the label.
+
+<Excerpt>
+  <Input label="Input" placeholder="Type here..." required />
+</Excerpt>
+
+```jsx
+<Input label="Input" placeholder="Type here..." required />
+```
+
+## Hint
+
+You can supply a `hint` prop to the `Input` component to show a hint below the input.
+
+<Excerpt>
+  <Input label="Input" placeholder="Type here..." hint="This is a hint" />
+</Excerpt>
+
+```jsx
+<Input label="Input" placeholder="Type here..." hint="This is a hint" />
+```
+
+## Label Description
+
+You can supply a `labelDescription` prop to the `Input` component to show a description to the right of the label.
+
+<Excerpt>
+  <Input label="Input" placeholder="Type here..." labelDescription="37/100" />
+</Excerpt>
+
+```jsx
+<Input label="Input" placeholder="Type here..." labelDescription="37/100" />
+```

package/docs/src/docs/components/typography.mdx

@@ -5,8 +5,6 @@ title: Typography
 import { Typography, Card } from "../../components/LoadableTabler";
 import { Excerpt } from "../../components/Excerpt.jsx";
 
-# Typography
-
 ```jsx
 import { Typography } from "tabler-react-2";
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tabler-react-2",
-  "version": "0.1.96",
+  "version": "0.1.98",
   "description": "A react implementation of Tabler ui",
   "main": "dist/index.js",
   "scripts": {