@kosmeo-ui/react 0.1.0 → 0.2.0

package/dist/components/navigation/pagination/styles.css

@@ -0,0 +1,113 @@
+.k-pagination {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem 1.5rem;
+  color: var(--text-color);
+}
+
+.k-pagination-summary {
+  margin: 0;
+  color: var(--text-color-secondary);
+  font-variant-numeric: tabular-nums;
+}
+
+.k-pagination-pages {
+  display: flex;
+  align-items: center;
+  gap: 0.25rem;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.k-pagination-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border: 0.0625rem solid var(--border-color);
+  border-radius: 0.375rem;
+  background-color: var(--background-color-light);
+  color: var(--text-color);
+  font-variant-numeric: tabular-nums;
+  cursor: pointer;
+  transition:
+    background-color 0.15s ease-in-out,
+    border-color 0.15s ease-in-out;
+}
+
+.k-pagination-button:not(:disabled):hover {
+  background-color: var(--background-color-hover);
+}
+
+.k-pagination-button:focus-visible {
+  outline: 0.125rem solid var(--border-color-active);
+  outline-offset: 0.125rem;
+}
+
+.k-pagination-button-current,
+.k-pagination-button-current:not(:disabled):hover {
+  border-color: var(--primary-color);
+  background-color: var(--primary-color);
+  color: var(--text-color-light);
+  font-weight: 600;
+}
+
+.k-pagination-button:disabled {
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+
+.k-pagination-gap {
+  color: var(--text-color-secondary);
+  text-align: center;
+}
+
+.k-pagination-page-size {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  color: var(--text-color-secondary);
+  white-space: nowrap;
+}
+
+/* Sizes: every button stays at least 32px, above the 24px target minimum. */
+.k-pagination-sm {
+  font-size: var(--text-size-sm);
+}
+
+.k-pagination-sm .k-pagination-button,
+.k-pagination-sm .k-pagination-gap {
+  min-width: 2rem;
+  height: 2rem;
+  padding: 0 0.5rem;
+}
+
+.k-pagination-md {
+  font-size: var(--text-size-sm);
+}
+
+.k-pagination-md .k-pagination-button,
+.k-pagination-md .k-pagination-gap {
+  min-width: 2.25rem;
+  height: 2.25rem;
+  padding: 0 0.625rem;
+}
+
+.k-pagination-lg {
+  font-size: var(--text-size-md);
+}
+
+.k-pagination-lg .k-pagination-button,
+.k-pagination-lg .k-pagination-gap {
+  min-width: 2.75rem;
+  height: 2.75rem;
+  padding: 0 0.75rem;
+}
+
+.k-pagination-gap {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}

package/dist/components/navigation/pagination/utils.d.ts

@@ -0,0 +1,9 @@
+export type PageRangeItem = number | "start-gap" | "end-gap";
+/**
+ * The page buttons to show: always the first and last page, the current page
+ * with `siblings` neighbours either side, and a gap marker wherever pages are
+ * skipped. The list is the same length on every page, so the control doesn't
+ * jump around as you move through it.
+ */
+export declare const pageRange: (page: number, pageCount: number, siblings?: number) => PageRangeItem[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/components/navigation/pagination/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/components/navigation/pagination/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACpB,MAAM,MAAM,EACZ,WAAW,MAAM,EACjB,iBAAY,KACX,aAAa,EAmBf,CAAC"}

package/dist/components/navigation/pagination/utils.js

@@ -0,0 +1,25 @@
+/**
+ * The page buttons to show: always the first and last page, the current page
+ * with `siblings` neighbours either side, and a gap marker wherever pages are
+ * skipped. The list is the same length on every page, so the control doesn't
+ * jump around as you move through it.
+ */
+export const pageRange = (page, pageCount, siblings = 1) => {
+    const range = (from, to) => Array.from({ length: to - from + 1 }, (_, i) => from + i);
+    // first + last + current + siblings + two gaps
+    const slots = siblings * 2 + 5;
+    if (pageCount <= slots)
+        return range(1, pageCount);
+    const left = Math.max(page - siblings, 1);
+    const right = Math.min(page + siblings, pageCount);
+    const gapBefore = left > 2;
+    const gapAfter = right < pageCount - 1;
+    // Pages shown at the start or end when only one gap is needed.
+    const edge = siblings * 2 + 3;
+    if (!gapBefore)
+        return [...range(1, edge), "end-gap", pageCount];
+    if (!gapAfter)
+        return [1, "start-gap", ...range(pageCount - edge + 1, pageCount)];
+    return [1, "start-gap", ...range(left, right), "end-gap", pageCount];
+};
+//# sourceMappingURL=utils.js.map

package/dist/components/navigation/pagination/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/components/navigation/pagination/utils.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAY,EACZ,SAAiB,EACjB,QAAQ,GAAG,CAAC,EACK,EAAE;IACnB,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CACzC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAE5D,+CAA+C;IAC/C,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,SAAS,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAEnD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC;IAC3B,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,CAAC,CAAC;IACvC,+DAA+D;IAC/D,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IAE9B,IAAI,CAAC,SAAS;QAAE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACjE,IAAI,CAAC,QAAQ;QACX,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACvE,CAAC,CAAC"}

package/dist/components/navigation/sidebar/styles.css

@@ -14,7 +14,9 @@
   font-weight: 700;
   text-transform: uppercase;
   letter-spacing: 0.05em;
-  color: var(--overlay-light-medium);
+  /* 50% white: the weakest overlay that keeps small text above 4.5:1 on the
+     sidebar's dark background. */
+  color: var(--overlay-light-strong);
   white-space: nowrap;
   overflow: hidden;
 }
@@ -38,6 +40,12 @@
   background-color: var(--overlay-light-weak);
 }
 
+/* Browser default focus rings can vanish on the dark background. */
+.k-sidebar-nav-link:focus-visible {
+  outline: 2px solid var(--text-color-light);
+  outline-offset: -2px;
+}
+
 .k-sidebar-nav-link.active {
   background-color: var(--overlay-light-medium);
   color: var(--text-color-light);

package/dist/components/navigation/tabButton/styles.css

@@ -35,12 +35,12 @@
 }
 
 .k-tab-button-primary:hover:not(.k-tab-button-disabled) {
-  color: var(--primary-color);
+  color: var(--primary-color-text);
   background-color: var(--background-color);
 }
 
 .k-tab-button-primary.k-tab-button-active {
-  color: var(--primary-color);
+  color: var(--primary-color-text);
   background-color: var(--background-color);
   border-bottom-color: var(--primary-color);
   border-color: var(--primary-color) var(--primary-color) transparent
@@ -89,12 +89,12 @@
 }
 
 .k-tab-button-danger:hover:not(.k-tab-button-disabled) {
-  color: var(--danger-color);
+  color: var(--danger-color-text);
   background-color: var(--background-color);
 }
 
 .k-tab-button-danger.k-tab-button-active {
-  color: var(--danger-color);
+  color: var(--danger-color-text);
   background-color: var(--background-color);
   border-bottom-color: var(--danger-color);
   border-color: var(--danger-color) var(--danger-color) transparent
@@ -107,12 +107,12 @@
 }
 
 .k-tab-button-warning:hover:not(.k-tab-button-disabled) {
-  color: var(--warning-color);
+  color: var(--warning-color-text);
   background-color: var(--background-color);
 }
 
 .k-tab-button-warning.k-tab-button-active {
-  color: var(--warning-color);
+  color: var(--warning-color-text);
   background-color: var(--background-color);
   border-bottom-color: var(--warning-color);
   border-color: var(--warning-color) var(--warning-color) transparent

package/dist/components/navigation/tabs/styles.css

@@ -28,11 +28,11 @@
 }
 
 .k-tabs-button:hover:not(:disabled) {
-  color: var(--primary-color);
+  color: var(--primary-color-text);
 }
 
 .k-tabs-button-active {
-  color: var(--primary-color);
+  color: var(--primary-color-text);
   border-bottom-color: var(--primary-color);
 }
 

package/dist/components/overlays/confirmationModal/index.d.ts

@@ -1,3 +1,4 @@
+import "./styles.css";
 export interface ConfirmationModalProps {
     show: boolean;
     handleHide: () => void;
@@ -7,6 +8,10 @@ export interface ConfirmationModalProps {
     confirmButtonText: string;
     cancelButtonText?: string;
     isLoading?: boolean;
+    /** **_Optional_** text the user must type, exactly, before the confirm button enables (e.g. the name of what's being deleted) */
+    confirmationText?: string;
+    /** **_Optional_** whether Escape and a click outside close the modal. Defaults to `true` */
+    dismissible?: boolean;
 }
 declare const ConfirmationModal: (props: ConfirmationModalProps) => import("react").JSX.Element;
 export default ConfirmationModal;

package/dist/components/overlays/confirmationModal/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/overlays/confirmationModal/index.tsx"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,QAAA,MAAM,iBAAiB,GAAI,OAAO,sBAAsB,gCA6BvD,CAAC;AAEF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/overlays/confirmationModal/index.tsx"],"names":[],"mappings":"AAMA,OAAO,cAAc,CAAC;AAEtB,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iIAAiI;IACjI,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,QAAA,MAAM,iBAAiB,GAAI,OAAO,sBAAsB,gCA0DvD,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/components/overlays/confirmationModal/index.js

@@ -1,12 +1,31 @@
 "use client";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Button from "../../buttons/button/index.js";
+import Input from "../../inputs/input/index.js";
 import Modal from "../modal/index.js";
+import { useState } from "react";
+import "./styles.css";
 const ConfirmationModal = (props) => {
-    return (_jsx(Modal, { show: props.show, title: props.title, onClose: props.handleHide, footerButtons: [
+    const [typed, setTyped] = useState("");
+    const [wasShown, setWasShown] = useState(props.show);
+    // Clear the typed text each time the modal opens, so a match from a
+    // previous confirmation never carries over.
+    if (props.show !== wasShown) {
+        setWasShown(props.show);
+        if (props.show)
+            setTyped("");
+    }
+    const confirmed = props.confirmationText === undefined || typed === props.confirmationText;
+    const canConfirm = confirmed && !props.isLoading;
+    return (_jsxs(Modal, { show: props.show, title: props.title, onClose: props.handleHide, 
+        // Cancel is disabled while loading; Escape and the backdrop follow suit.
+        dismissible: props.dismissible !== false && !props.isLoading, footerButtons: [
             _jsx(Button, { variant: "secondary", onClick: props.handleHide, disabled: props.isLoading, children: props.cancelButtonText || "Cancel" }, "cancel"),
-            _jsx(Button, { variant: "danger", onClick: props.handleConfirm, isLoading: props.isLoading, disabled: props.isLoading, children: props.confirmButtonText }, "confirm"),
-        ], children: props.body }));
+            _jsx(Button, { variant: "danger", onClick: props.handleConfirm, isLoading: props.isLoading, disabled: !canConfirm, children: props.confirmButtonText }, "confirm"),
+        ], children: [props.body, props.confirmationText !== undefined && (_jsx("div", { className: "k-confirmation-modal-check", children: _jsx(Input, { label: `Type "${props.confirmationText}" to confirm`, value: typed, onChange: (e) => setTyped(e.target.value), onKeyDown: (e) => {
+                        if (e.key === "Enter" && canConfirm)
+                            props.handleConfirm();
+                    }, autoComplete: "off" }) }))] }));
 };
 export default ConfirmationModal;
 //# sourceMappingURL=index.js.map

package/dist/components/overlays/confirmationModal/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/overlays/confirmationModal/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,MAAM,MAAM,+BAA+B,CAAC;AACnD,OAAO,KAAK,MAAM,mBAAmB,CAAC;AAatC,MAAM,iBAAiB,GAAG,CAAC,KAA6B,EAAE,EAAE;IAC1D,OAAO,CACL,KAAC,KAAK,IACJ,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,OAAO,EAAE,KAAK,CAAC,UAAU,EACzB,aAAa,EAAE;YACb,KAAC,MAAM,IAEL,OAAO,EAAC,WAAW,EACnB,OAAO,EAAE,KAAK,CAAC,UAAU,EACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,YAExB,KAAK,CAAC,gBAAgB,IAAI,QAAQ,IAL/B,QAAQ,CAML;YACT,KAAC,MAAM,IAEL,OAAO,EAAC,QAAQ,EAChB,OAAO,EAAE,KAAK,CAAC,aAAa,EAC5B,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,YAExB,KAAK,CAAC,iBAAiB,IANpB,SAAS,CAON;SACV,YAEA,KAAK,CAAC,IAAI,GACL,CACT,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/overlays/confirmationModal/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,MAAM,MAAM,+BAA+B,CAAC;AACnD,OAAO,KAAK,MAAM,6BAA6B,CAAC;AAChD,OAAO,KAAK,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,cAAc,CAAC;AAiBtB,MAAM,iBAAiB,GAAG,CAAC,KAA6B,EAAE,EAAE;IAC1D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAErD,oEAAoE;IACpE,4CAA4C;IAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK,CAAC,IAAI;YAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,SAAS,GACb,KAAK,CAAC,gBAAgB,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,CAAC,gBAAgB,CAAC;IAC3E,MAAM,UAAU,GAAG,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;IAEjD,OAAO,CACL,MAAC,KAAK,IACJ,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,OAAO,EAAE,KAAK,CAAC,UAAU;QACzB,yEAAyE;QACzE,WAAW,EAAE,KAAK,CAAC,WAAW,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS,EAC5D,aAAa,EAAE;YACb,KAAC,MAAM,IAEL,OAAO,EAAC,WAAW,EACnB,OAAO,EAAE,KAAK,CAAC,UAAU,EACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,YAExB,KAAK,CAAC,gBAAgB,IAAI,QAAQ,IAL/B,QAAQ,CAML;YACT,KAAC,MAAM,IAEL,OAAO,EAAC,QAAQ,EAChB,OAAO,EAAE,KAAK,CAAC,aAAa,EAC5B,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,QAAQ,EAAE,CAAC,UAAU,YAEpB,KAAK,CAAC,iBAAiB,IANpB,SAAS,CAON;SACV,aAEA,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,gBAAgB,KAAK,SAAS,IAAI,CACvC,cAAK,SAAS,EAAC,4BAA4B,YACzC,KAAC,KAAK,IACJ,KAAK,EAAE,SAAS,KAAK,CAAC,gBAAgB,cAAc,EACpD,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACzC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;wBACf,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,IAAI,UAAU;4BAAE,KAAK,CAAC,aAAa,EAAE,CAAC;oBAC7D,CAAC,EACD,YAAY,EAAC,KAAK,GAClB,GACE,CACP,IACK,CACT,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/components/overlays/confirmationModal/styles.css

@@ -0,0 +1,3 @@
+.k-confirmation-modal-check {
+  margin-top: 1rem;
+}

package/dist/components/overlays/modal/index.d.ts

@@ -16,6 +16,8 @@ interface ModalProps extends PropsWithChildren {
      * editors) that would feel cramped at `lg`.
      */
     size?: ModalSize;
+    /** **_Optional_** whether Escape and a click on the backdrop close the modal. When `false`, only the modal's own buttons can close it. Defaults to `true` */
+    dismissible?: boolean;
 }
 declare const Modal: (props: ModalProps) => React.JSX.Element | null;
 export default Modal;

package/dist/components/overlays/modal/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/overlays/modal/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAA+B,MAAM,OAAO,CAAC;AAI9E,OAAO,cAAc,CAAC;AAEtB,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAEpD,UAAU,UAAW,SAAQ,iBAAiB;IAC5C,yDAAyD;IACzD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IAClC;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,QAAA,MAAM,KAAK,GAAI,OAAO,UAAU,6BA2D/B,CAAC;AAEF,eAAe,KAAK,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/overlays/modal/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAA+B,MAAM,OAAO,CAAC;AAI9E,OAAO,cAAc,CAAC;AAEtB,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAEpD,UAAU,UAAW,SAAQ,iBAAiB;IAC5C,yDAAyD;IACzD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IAClC;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,6JAA6J;IAC7J,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,QAAA,MAAM,KAAK,GAAI,OAAO,UAAU,6BA4E/B,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/components/overlays/modal/index.js

@@ -6,10 +6,11 @@ import Button from "../../buttons/button/index.js";
 import Portal from "../portal/index.js";
 import "./styles.css";
 const Modal = (props) => {
-    const { size = "md" } = props;
+    const { size = "md", dismissible = true } = props;
     const [shouldRender, setShouldRender] = useState(props.show);
     const [isAnimating, setIsAnimating] = useState(false);
     const contentRef = useRef(null);
+    const pressStartedOnOverlay = useRef(false);
     useEffect(() => {
         if (props.show) {
             setIsAnimating(false);
@@ -25,7 +26,7 @@ const Modal = (props) => {
         }
     }, [props.show]);
     useEffect(() => {
-        if (!props.show)
+        if (!props.show || !dismissible)
             return;
         const handler = (e) => {
             if (e.key === "Escape")
@@ -33,11 +34,19 @@ const Modal = (props) => {
         };
         document.addEventListener("keydown", handler);
         return () => document.removeEventListener("keydown", handler);
-    }, [props.show, props.onClose]);
+    }, [props.show, props.onClose, dismissible]);
     useFocusTrap(contentRef, !!props.show && !!shouldRender);
     if (!shouldRender)
         return null;
-    return (_jsx(Portal, { children: _jsx("div", { className: `k-modal-overlay ${isAnimating ? "closing" : ""}`, children: _jsxs("div", { ref: contentRef, className: `k-modal-content ${isAnimating ? "closing" : ""} ${size}`, role: "dialog", "aria-modal": "true", children: [props.title && _jsx("div", { className: "k-modal-header", children: props.title }), _jsx("div", { className: "k-modal-body", children: props.children }), _jsx("div", { className: "k-modal-footer", children: props.footerButtons ? (props.footerButtons.map((button, index) => (_jsx(React.Fragment, { children: button }, index)))) : (_jsx(Button, { onClick: props.onClose, variant: "secondary", children: "Close" })) })] }) }) }));
+    return (_jsx(Portal, { children: _jsx("div", { className: `k-modal-overlay ${isAnimating ? "closing" : ""}`, onMouseDown: (e) => {
+                pressStartedOnOverlay.current = e.target === e.currentTarget;
+            }, onClick: (e) => {
+                if (dismissible &&
+                    pressStartedOnOverlay.current &&
+                    e.target === e.currentTarget) {
+                    props.onClose();
+                }
+            }, children: _jsxs("div", { ref: contentRef, className: `k-modal-content ${isAnimating ? "closing" : ""} ${size}`, role: "dialog", "aria-modal": "true", children: [props.title && _jsx("div", { className: "k-modal-header", children: props.title }), _jsx("div", { className: "k-modal-body", children: props.children }), _jsx("div", { className: "k-modal-footer", children: props.footerButtons ? (props.footerButtons.map((button, index) => (_jsx(React.Fragment, { children: button }, index)))) : (_jsx(Button, { onClick: props.onClose, variant: "secondary", children: "Close" })) })] }) }) }));
 };
 export default Modal;
 //# sourceMappingURL=index.js.map

package/dist/components/overlays/modal/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/overlays/modal/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/overlays/modal/index.tsx"],"names":[],"mappings":"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"}

package/dist/hooks/index.d.ts

@@ -1,6 +1,7 @@
 export { default as useInfiniteArchivableCursor } from "./useInfiniteArchivableCursor.js";
 export { default as useInfinite, type UseInfiniteReturn, } from "./useInfinite.js";
 export { default as useInfiniteCursor } from "./useInfiniteCursor.js";
+export { default as usePaginated, type UsePaginatedReturn, } from "./usePaginated.js";
 export { default as useScrollIntoView } from "./useScrollIntoView.js";
 export { default as useDebouncedValue } from "./useDebouncedValue.js";
 export { default as useOutsideClick } from "./useOutsideClick.js";

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EACL,OAAO,IAAI,WAAW,EACtB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,OAAO,IAAI,mBAAmB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EACL,OAAO,IAAI,WAAW,EACtB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EACL,OAAO,IAAI,YAAY,EACvB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,OAAO,IAAI,mBAAmB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC"}

package/dist/hooks/index.js

@@ -1,6 +1,7 @@
 export { default as useInfiniteArchivableCursor } from "./useInfiniteArchivableCursor.js";
 export { default as useInfinite, } from "./useInfinite.js";
 export { default as useInfiniteCursor } from "./useInfiniteCursor.js";
+export { default as usePaginated, } from "./usePaginated.js";
 export { default as useScrollIntoView } from "./useScrollIntoView.js";
 export { default as useDebouncedValue } from "./useDebouncedValue.js";
 export { default as useOutsideClick } from "./useOutsideClick.js";

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EACL,OAAO,IAAI,WAAW,GAEvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,OAAO,IAAI,mBAAmB,GAG/B,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EACL,OAAO,IAAI,WAAW,GAEvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EACL,OAAO,IAAI,YAAY,GAExB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EACL,OAAO,IAAI,mBAAmB,GAG/B,MAAM,0BAA0B,CAAC"}

package/dist/hooks/usePaginated.d.ts

@@ -0,0 +1,43 @@
+import { AxiosInstance } from "axios";
+type QueryParams = Record<string, string | number | boolean | undefined>;
+interface UsePaginatedOptions {
+    axiosInstance: AxiosInstance;
+    /** API endpoint to fetch from (e.g., "/v1/projects"). It takes `limit` and `offset` and returns `{ data, total }`. */
+    endpoint: string;
+    /** Query key for React Query caching. */
+    queryKey: string;
+    /** Organization ID to scope cache keys (prevents stale cross-org data). */
+    orgId?: string | null;
+    /** Initial page size (default: 10). */
+    initialPageSize?: number;
+    /** Extra query params such as filters and sort. Changing them returns to page 1. */
+    params?: QueryParams;
+    enabled?: boolean;
+}
+export interface UsePaginatedReturn<T> {
+    /** The current page's rows. */
+    data: T[];
+    /** Total matching rows across all pages. */
+    total: number;
+    /** Current page, starting at 1. */
+    page: number;
+    pageSize: number;
+    pageCount: number;
+    setPage: (page: number) => void;
+    /** Changes the page size and returns to page 1. */
+    setPageSize: (pageSize: number) => void;
+    /** True until the first page arrives. */
+    isLoading: boolean;
+    /** True whenever a page is loading, including after the first. */
+    isFetching: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+/**
+ * One page at a time from an offset endpoint (`limit` + `offset` in,
+ * `{ data, total }` out), for `Pagination`. The previous page stays on screen
+ * while the next one loads. Use `useInfiniteCursor` for `InfiniteScroll`.
+ */
+declare const usePaginated: <T>(options: UsePaginatedOptions) => UsePaginatedReturn<T>;
+export default usePaginated;
+//# sourceMappingURL=usePaginated.d.ts.map

package/dist/hooks/usePaginated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaginated.d.ts","sourceRoot":"","sources":["../../src/hooks/usePaginated.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAOtC,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;AAEzE,UAAU,mBAAmB;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,sHAAsH;IACtH,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,+BAA+B;IAC/B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,mDAAmD;IACnD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,yCAAyC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;GAIG;AACH,QAAA,MAAM,YAAY,GAAI,CAAC,EACrB,SAAS,mBAAmB,KAC3B,kBAAkB,CAAC,CAAC,CAiEtB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/hooks/usePaginated.js

@@ -0,0 +1,60 @@
+"use client";
+import { keepPreviousData, useQuery } from "@tanstack/react-query";
+import { useCallback, useEffect, useState } from "react";
+/**
+ * One page at a time from an offset endpoint (`limit` + `offset` in,
+ * `{ data, total }` out), for `Pagination`. The previous page stays on screen
+ * while the next one loads. Use `useInfiniteCursor` for `InfiniteScroll`.
+ */
+const usePaginated = (options) => {
+    const { axiosInstance, endpoint, queryKey, orgId, initialPageSize = 10, params, enabled = true, } = options;
+    const [page, setPage] = useState(1);
+    const [pageSize, setPageSizeState] = useState(initialPageSize);
+    // New filters or sort make the old page number meaningless.
+    const paramsKey = JSON.stringify(params ?? {});
+    const [prevParamsKey, setPrevParamsKey] = useState(paramsKey);
+    if (paramsKey !== prevParamsKey) {
+        setPrevParamsKey(paramsKey);
+        setPage(1);
+    }
+    const query = useQuery({
+        queryKey: [`${queryKey}-paged`, orgId ?? null, paramsKey, page, pageSize],
+        enabled,
+        placeholderData: keepPreviousData,
+        queryFn: async () => {
+            const res = await axiosInstance.get(endpoint, {
+                params: { ...params, limit: pageSize, offset: (page - 1) * pageSize },
+            });
+            return res.data;
+        },
+    });
+    const total = query.data?.total ?? 0;
+    const pageCount = Math.max(1, Math.ceil(total / pageSize));
+    // Rows deleted from the last page can leave it empty; step back.
+    useEffect(() => {
+        if (query.data && !query.isPlaceholderData && page > pageCount) {
+            setPage(pageCount);
+        }
+    }, [query.data, query.isPlaceholderData, page, pageCount]);
+    const setPageSize = useCallback((size) => {
+        setPageSizeState(size);
+        setPage(1);
+    }, []);
+    const { refetch } = query;
+    const refetchPage = useCallback(() => void refetch(), [refetch]);
+    return {
+        data: query.data?.data ?? [],
+        total,
+        page,
+        pageSize,
+        pageCount,
+        setPage,
+        setPageSize,
+        isLoading: query.isLoading,
+        isFetching: query.isFetching,
+        error: query.error,
+        refetch: refetchPage,
+    };
+};
+export default usePaginated;
+//# sourceMappingURL=usePaginated.js.map

package/dist/hooks/usePaginated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaginated.js","sourceRoot":"","sources":["../../src/hooks/usePaginated.ts"],"names":[],"mappings":"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"}