pixelize-design-library 2.4.2 → 3.0.0

package/dist/Components/Table/settings/TableSettings.js

@@ -10,10 +10,17 @@ const framer_motion_1 = require("framer-motion");
 const ManageColumns_1 = __importDefault(require("./ManageColumns"));
 const Button_1 = __importDefault(require("../../Button/Button"));
 const useCustomTheme_1 = require("../../../Theme/useCustomTheme");
+const surfaceRaised_1 = require("../../../Theme/tokens/builders/surfaceRaised");
 const scrollbar_1 = require("../../../Theme/tokens/builders/scrollbar");
+const columnLabel_1 = require("../columnLabel");
 const lucide_react_1 = require("lucide-react");
 const ToolTip_1 = __importDefault(require("../../ToolTip/ToolTip"));
+const rowStates_1 = require("../../../Theme/tokens/builders/rowStates");
+const motion_1 = require("../../../Theme/tokens/primitives/motion");
+const motion_2 = require("../../../Theme/chakra/motion");
 const MotionModalContent = (0, framer_motion_1.motion)(react_1.ModalContent);
+const SHEET_ENTER = (0, motion_1.motionTransition)("enter", "out");
+const SHEET_EXIT = (0, motion_1.motionTransition)("exit", "in");
 const DENSITY_OPTIONS = [
     { value: "compact", label: "Compact", desc: "Tight rows — fit more data on screen" },
     { value: "normal", label: "Normal", desc: "Balanced default spacing" },
@@ -21,6 +28,8 @@ const DENSITY_OPTIONS = [
 ];
 const TableSettings = ({ columns, onSave, density = "normal", onDensityChange, groupBy, }) => {
     const theme = (0, useCustomTheme_1.useCustomTheme)();
+    const sheetOffset = (0, motion_2.usePrefersReducedMotion)() ? 0 : "-100%";
+    const rowBackgrounds = (0, react_2.useMemo)(() => (0, rowStates_1.listRowBackgrounds)(theme.colors), [theme.colors]);
     const childInputMethodsRef = (0, react_2.useRef)({});
     const [settingsOpen, setSettingsOpen] = (0, react_2.useState)(false);
     const [selectedIndex, setSelectedIndex] = (0, react_2.useState)(0);
@@ -37,7 +46,7 @@ const TableSettings = ({ columns, onSave, density = "normal", onDensityChange, g
         setSettingsOpen(true);
     }, [columns, groupBy]);
     const tabStyle = {
-        fontSize: "13px",
+        fontSize: "xs-plus",
         fontWeight: 500,
         px: 4,
         py: 2,
@@ -50,12 +59,12 @@ const TableSettings = ({ columns, onSave, density = "normal", onDensityChange, g
         },
         _hover: { color: theme.colors.text[600] },
     };
-    return ((0, jsx_runtime_1.jsxs)(react_1.Box, { children: [(0, jsx_runtime_1.jsx)(ToolTip_1.default, { label: "Table Settings", placement: "top", children: (0, jsx_runtime_1.jsx)(react_1.IconButton, { "aria-label": "Table settings", icon: (0, jsx_runtime_1.jsx)(lucide_react_1.Settings, { size: "1.25rem" }), onClick: handleOpen, variant: "unstyled", minW: "auto", h: "auto", display: "flex", justifyContent: "flex-end", cursor: "pointer", transition: "all 0.2s ease", color: theme.colors.text[500], _hover: {
+    return ((0, jsx_runtime_1.jsxs)(react_1.Box, { children: [(0, jsx_runtime_1.jsx)(ToolTip_1.default, { label: "Table Settings", placement: "top", children: (0, jsx_runtime_1.jsx)(react_1.IconButton, { "aria-label": "Table settings", icon: (0, jsx_runtime_1.jsx)(lucide_react_1.Settings, { size: "1.25rem" }), onClick: handleOpen, variant: "unstyled", minW: "auto", h: "auto", display: "flex", justifyContent: "flex-end", cursor: "pointer", transition: (0, motion_1.transitionFor)(["color", "transform"], "base"), color: theme.colors.text[500], _hover: {
                         transform: "scale(1.1)",
                         color: theme.colors.accentText
-                    } }) }), (0, jsx_runtime_1.jsxs)(react_1.Modal, { isOpen: settingsOpen, onClose: () => setSettingsOpen(false), size: "md", children: [(0, jsx_runtime_1.jsx)(react_1.ModalOverlay, {}), (0, jsx_runtime_1.jsxs)(MotionModalContent, { mt: "0", top: "0", position: "absolute", borderTopRadius: "none", initial: { y: "-100%", opacity: 0 }, animate: { y: 0, opacity: 1 }, exit: { y: "-100%", opacity: 0 }, transition: { duration: 0.4, ease: "easeOut" }, padding: "0", minW: "620px", minH: "520px", maxH: "90vh", display: "flex", flexDirection: "column", bg: theme.colors.background[50], overflow: "hidden", children: [(0, jsx_runtime_1.jsx)(react_1.ModalCloseButton, { top: 3, right: 3, zIndex: 2 }), (0, jsx_runtime_1.jsxs)(react_1.Tabs, { index: selectedIndex, onChange: setSelectedIndex, variant: "unstyled", display: "flex", flexDirection: "column", flex: "1", minH: 0, children: [(0, jsx_runtime_1.jsxs)(react_1.Box, { pt: 4, px: 4, children: [(0, jsx_runtime_1.jsx)(react_1.Text, { fontWeight: 600, fontSize: "md", mb: 3, children: "Table Settings" }), (0, jsx_runtime_1.jsxs)(react_1.TabList, { gap: 0, borderBottom: "1px solid", borderColor: theme.colors.boxborder[200], children: [(0, jsx_runtime_1.jsx)(react_1.Tab, { ...tabStyle, children: "Density" }), (0, jsx_runtime_1.jsx)(react_1.Tab, { ...tabStyle, children: "Manage Columns" }), (0, jsx_runtime_1.jsx)(react_1.Tab, { ...tabStyle, children: "Group" })] })] }), (0, jsx_runtime_1.jsx)(react_1.ModalBody, { px: 4, py: 3, flex: "1", overflowY: "auto", sx: (0, scrollbar_1.scrollbarStyles)(theme.colors), children: (0, jsx_runtime_1.jsxs)(react_1.TabPanels, { children: [(0, jsx_runtime_1.jsx)(react_1.TabPanel, { px: 0, py: 1, children: (0, jsx_runtime_1.jsx)(react_1.Flex, { direction: "column", gap: 2, children: DENSITY_OPTIONS.map((opt) => {
+                    } }) }), (0, jsx_runtime_1.jsxs)(react_1.Modal, { isOpen: settingsOpen, onClose: () => setSettingsOpen(false), size: { base: "full", md: "md" }, children: [(0, jsx_runtime_1.jsx)(react_1.ModalOverlay, {}), (0, jsx_runtime_1.jsxs)(MotionModalContent, { mt: "0", top: "0", left: { base: 0, md: "auto" }, right: { base: 0, md: "auto" }, position: "absolute", borderTopRadius: "none", initial: { y: sheetOffset, opacity: 0 }, animate: { y: 0, opacity: 1 }, exit: { y: sheetOffset, opacity: 0, transition: SHEET_EXIT }, transition: SHEET_ENTER, padding: "0", minW: { base: "auto", md: "620px" }, minH: { base: "auto", md: "520px" }, maxH: "90vh", display: "flex", flexDirection: "column", bg: theme.colors.surfaceRaised, overflow: "hidden", children: [(0, jsx_runtime_1.jsx)(react_1.ModalCloseButton, { top: 3, right: 3, zIndex: 2 }), (0, jsx_runtime_1.jsxs)(react_1.Tabs, { index: selectedIndex, onChange: setSelectedIndex, variant: "unstyled", display: "flex", flexDirection: "column", flex: "1", minH: 0, children: [(0, jsx_runtime_1.jsxs)(react_1.Box, { pt: 4, px: 4, children: [(0, jsx_runtime_1.jsx)(react_1.Text, { fontWeight: 600, fontSize: "md", mb: 3, children: "Table Settings" }), (0, jsx_runtime_1.jsxs)(react_1.TabList, { gap: 0, borderBottom: "1px solid", borderColor: (0, surfaceRaised_1.raisedRule)(theme.colors), children: [(0, jsx_runtime_1.jsx)(react_1.Tab, { ...tabStyle, children: "Density" }), (0, jsx_runtime_1.jsx)(react_1.Tab, { ...tabStyle, children: "Manage Columns" }), (0, jsx_runtime_1.jsx)(react_1.Tab, { ...tabStyle, children: "Group" })] })] }), (0, jsx_runtime_1.jsx)(react_1.ModalBody, { px: 4, py: 3, flex: "1", overflowY: "auto", sx: (0, scrollbar_1.scrollbarStyles)(theme.colors), children: (0, jsx_runtime_1.jsxs)(react_1.TabPanels, { children: [(0, jsx_runtime_1.jsx)(react_1.TabPanel, { px: 0, py: 1, children: (0, jsx_runtime_1.jsx)(react_1.Flex, { direction: "column", gap: 2, children: DENSITY_OPTIONS.map((opt) => {
                                                             const selected = density === opt.value;
-                                                            return ((0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "button", type: "button", align: "center", gap: 3, px: 3, py: 2.5, borderRadius: "lg", border: "1px solid", borderColor: selected ? theme.colors.accentText : theme.colors.boxborder[200], bg: selected ? theme.colors.primary.opacity[8] : theme.colors.transparent, transition: "all 0.15s", _hover: { borderColor: theme.colors.accentText }, onClick: () => onDensityChange === null || onDensityChange === void 0 ? void 0 : onDensityChange(opt.value), children: [(0, jsx_runtime_1.jsx)(react_1.Box, { boxSize: "1.1rem", borderRadius: "full", border: "2px solid", borderColor: selected ? theme.colors.accentText : theme.colors.boxborder[500], display: "flex", alignItems: "center", justifyContent: "center", flexShrink: 0, children: selected && (0, jsx_runtime_1.jsx)(lucide_react_1.Check, { size: 11, color: theme.colors.accentText, strokeWidth: 3 }) }), (0, jsx_runtime_1.jsxs)(react_1.Box, { textAlign: "left", children: [(0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: "13px", fontWeight: 600, color: theme.colors.text[700], children: opt.label }), (0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: "11px", color: theme.colors.textMuted, children: opt.desc })] })] }, opt.value));
+                                                            return ((0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "button", type: "button", align: "center", gap: 3, px: 3, py: 2.5, borderRadius: "lg", border: "1px solid", borderColor: selected ? theme.colors.accentText : (0, surfaceRaised_1.raisedRule)(theme.colors), bg: selected ? rowBackgrounds.selected : theme.colors.transparent, transition: (0, motion_1.transitionFor)(["background-color", "border-color"]), _hover: { borderColor: theme.colors.accentText }, onClick: () => onDensityChange === null || onDensityChange === void 0 ? void 0 : onDensityChange(opt.value), children: [(0, jsx_runtime_1.jsx)(react_1.Box, { boxSize: "1.1rem", borderRadius: "full", border: "2px solid", borderColor: selected ? theme.colors.accentText : theme.colors.boxborder[500], display: "flex", alignItems: "center", justifyContent: "center", flexShrink: 0, children: selected && (0, jsx_runtime_1.jsx)(lucide_react_1.Check, { size: 11, color: theme.colors.accentText, strokeWidth: 3 }) }), (0, jsx_runtime_1.jsxs)(react_1.Box, { textAlign: "left", children: [(0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: "xs-plus", fontWeight: 600, color: theme.colors.text[700], children: opt.label }), (0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: "xs-minus", color: theme.colors.textMuted, children: opt.desc })] })] }, opt.value));
                                                         }) }) }), (0, jsx_runtime_1.jsx)(react_1.TabPanel, { px: 0, py: 0, children: (0, jsx_runtime_1.jsx)(react_1.Box, { sx: {
                                                             "& [role='listitem'], & > div > div": {
                                                                 py: "4px !important",
@@ -65,15 +74,15 @@ const TableSettings = ({ columns, onSave, density = "normal", onDensityChange, g
                                                             "& .chakra-checkbox": { gap: "8px !important" },
                                                             "& .chakra-checkbox__label": { fontSize: "13px !important" },
                                                             "& [draggable]": { py: "5px !important" },
-                                                        }, children: (0, jsx_runtime_1.jsx)(ManageColumns_1.default, { columns: columns, items: items, setItems: setItems, childInputMethodsRef: childInputMethodsRef }) }) }), (0, jsx_runtime_1.jsxs)(react_1.TabPanel, { px: 0, py: 1, children: [(0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: "12px", color: theme.colors.textMuted, mb: 2, children: "Group rows by a column. Click Save to apply." }), (0, jsx_runtime_1.jsx)(react_1.Flex, { direction: "column", gap: 2, children: [{ id: undefined, label: "None (no grouping)" },
+                                                        }, children: (0, jsx_runtime_1.jsx)(ManageColumns_1.default, { columns: columns, items: items, setItems: setItems, childInputMethodsRef: childInputMethodsRef }) }) }), (0, jsx_runtime_1.jsxs)(react_1.TabPanel, { px: 0, py: 1, children: [(0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: "xs", color: theme.colors.textMuted, mb: 2, children: "Group rows by a column. Click Save to apply." }), (0, jsx_runtime_1.jsx)(react_1.Flex, { direction: "column", gap: 2, children: [{ id: undefined, label: "None (no grouping)" },
                                                                 // Only columns that declare a `columnType` are groupable.
                                                                 ...columns
                                                                     .filter((c) => !!c.columnType && !c.isHidden)
-                                                                    .map((c) => ({ id: c.id, label: String(c.label) }))]
+                                                                    .map((c) => ({ id: c.id, label: (0, columnLabel_1.columnLabelText)(c) }))]
                                                                 .map((opt) => {
                                                                 var _a;
                                                                 const selected = selectedGroup === opt.id;
-                                                                return ((0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "button", type: "button", align: "center", gap: 3, px: 3, py: 2.5, borderRadius: "lg", border: "1px solid", borderColor: selected ? theme.colors.accentText : theme.colors.boxborder[200], bg: selected ? theme.colors.primary.opacity[8] : theme.colors.transparent, transition: "all 0.15s", _hover: { borderColor: theme.colors.accentText }, onClick: () => setSelectedGroup(opt.id), children: [(0, jsx_runtime_1.jsx)(react_1.Box, { boxSize: "1.1rem", borderRadius: "full", border: "2px solid", borderColor: selected ? theme.colors.accentText : theme.colors.boxborder[500], display: "flex", alignItems: "center", justifyContent: "center", flexShrink: 0, children: selected && (0, jsx_runtime_1.jsx)(lucide_react_1.Check, { size: 11, color: theme.colors.accentText, strokeWidth: 3 }) }), (0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: "13px", fontWeight: 600, color: theme.colors.text[700], textAlign: "left", children: opt.label })] }, String((_a = opt.id) !== null && _a !== void 0 ? _a : "__none__")));
-                                                            }) })] })] }) })] }), (0, jsx_runtime_1.jsxs)(react_1.ModalFooter, { gap: "0.5rem", borderTop: "1px solid", borderColor: theme.colors.boxborder[200], pt: 3, pb: 3, px: 4, children: [(0, jsx_runtime_1.jsx)(Button_1.default, { label: "Close", size: "sm", onClick: () => setSettingsOpen(false), variant: "outline", colorScheme: "red" }), (0, jsx_runtime_1.jsx)(Button_1.default, { label: "Save", size: "sm", onClick: handleSave })] })] })] })] }));
+                                                                return ((0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "button", type: "button", align: "center", gap: 3, px: 3, py: 2.5, borderRadius: "lg", border: "1px solid", borderColor: selected ? theme.colors.accentText : (0, surfaceRaised_1.raisedRule)(theme.colors), bg: selected ? rowBackgrounds.selected : theme.colors.transparent, transition: (0, motion_1.transitionFor)(["background-color", "border-color"]), _hover: { borderColor: theme.colors.accentText }, onClick: () => setSelectedGroup(opt.id), children: [(0, jsx_runtime_1.jsx)(react_1.Box, { boxSize: "1.1rem", borderRadius: "full", border: "2px solid", borderColor: selected ? theme.colors.accentText : theme.colors.boxborder[500], display: "flex", alignItems: "center", justifyContent: "center", flexShrink: 0, children: selected && (0, jsx_runtime_1.jsx)(lucide_react_1.Check, { size: 11, color: theme.colors.accentText, strokeWidth: 3 }) }), (0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: "xs-plus", fontWeight: 600, color: theme.colors.text[700], textAlign: "left", children: opt.label })] }, String((_a = opt.id) !== null && _a !== void 0 ? _a : "__none__")));
+                                                            }) })] })] }) })] }), (0, jsx_runtime_1.jsxs)(react_1.ModalFooter, { gap: "0.5rem", borderTop: "1px solid", borderColor: (0, surfaceRaised_1.raisedRule)(theme.colors), pt: 3, pb: 3, px: 4, children: [(0, jsx_runtime_1.jsx)(Button_1.default, { label: "Close", size: "sm", onClick: () => setSettingsOpen(false), variant: "outline", colorScheme: "red" }), (0, jsx_runtime_1.jsx)(Button_1.default, { label: "Save", size: "sm", onClick: handleSave })] })] })] })] }));
 };
 exports.default = TableSettings;

package/dist/Components/Table/variants/TableVariantContext.d.ts

@@ -1,4 +1,4 @@
 import type { TableVariantTokens } from "./tokens";
 export declare const TableVariantProvider: import("react").Provider<TableVariantTokens | null>;
-/** No provider means the table as it always was — the default is a variant, not a gap. */
+/** No provider means the default variant — studio, the same preset `Table` falls back to. */
 export declare function useTableVariant(): TableVariantTokens;

package/dist/Components/Table/variants/TableVariantContext.js

@@ -5,13 +5,13 @@ exports.useTableVariant = useTableVariant;
 const react_1 = require("react");
 const useCustomTheme_1 = require("../../../Theme/useCustomTheme");
 const accentText_1 = require("../../../Theme/tokens/builders/accentText");
-const classic_1 = require("./classic");
+const studio_1 = require("./studio");
 const TableVariantContext = (0, react_1.createContext)(null);
 exports.TableVariantProvider = TableVariantContext.Provider;
-/** No provider means the table as it always was — the default is a variant, not a gap. */
+/** No provider means the default variant — studio, the same preset `Table` falls back to. */
 function useTableVariant() {
     const provided = (0, react_1.useContext)(TableVariantContext);
     const theme = (0, useCustomTheme_1.useCustomTheme)();
     const isDark = (0, accentText_1.isDarkCanvas)(theme.colors.backgroundColor.main);
-    return (0, react_1.useMemo)(() => provided !== null && provided !== void 0 ? provided : (0, classic_1.classicPreset)(theme.colors, isDark), [provided, theme.colors, isDark]);
+    return (0, react_1.useMemo)(() => provided !== null && provided !== void 0 ? provided : (0, studio_1.studioPreset)(theme.colors, isDark), [provided, theme.colors, isDark]);
 }

package/dist/Components/Table/variants/classic.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.classicPreset = void 0;
 const accentText_1 = require("../../../Theme/tokens/builders/accentText");
+const planeStep_1 = require("../../../Theme/tokens/builders/planeStep");
 const tableRowHoverStyle_1 = require("../components/tableRowHoverStyle");
+const stripe_1 = require("./stripe");
 /**
  * The table as it shipped. Pinned by snapshot: every value here is read off the
  * live component, so adding a variant cannot move it.
@@ -18,18 +20,19 @@ const classicPreset = (colors, isDark) => {
             textTransform: "capitalize",
             letterSpacing: "normal",
             height: "45px",
-            ruleColor: colors.boxborder[200],
+            ruleColor: (0, planeStep_1.cardRule)(colors),
             showColumnRule: true,
             actions: "always",
         },
         row: {
             hoverBg: (0, tableRowHoverStyle_1.getTableRowHoverStyle)(colors, isDark).backgroundColor,
             hoverScope: "cell",
-            ruleColor: colors.boxborder[200],
+            ruleColor: (0, planeStep_1.cardRule)(colors),
             frozenRuleColor: colors.boxborder[300],
             selectedBg: colors.primary.opacity[16],
             selectedBarColor: colors.primary[500],
             showSelectedBar: false,
+            stripeBg: (0, stripe_1.stripeFill)(colors),
         },
         slot: {
             width: "6",

package/dist/Components/Table/variants/stripe.d.ts

@@ -0,0 +1,3 @@
+import type { PaletteProps } from "../../../Theme/tokens/types";
+export declare const STRIPE_STEP = 1.04;
+export declare const stripeFill: (colors: PaletteProps) => string;

package/dist/Components/Table/variants/stripe.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripeFill = exports.STRIPE_STEP = void 0;
+const outlineRung_1 = require("../../../Theme/tokens/builders/outlineRung");
+exports.STRIPE_STEP = 1.04;
+const stripeFill = (colors) => (0, outlineRung_1.liftToContrast)(colors.table.hover[50], colors.background[50], exports.STRIPE_STEP);
+exports.stripeFill = stripeFill;

package/dist/Components/Table/variants/studio.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.studioPreset = void 0;
 const outlineRung_1 = require("../../../Theme/tokens/builders/outlineRung");
 const tableRowHoverStyle_1 = require("../components/tableRowHoverStyle");
+const stripe_1 = require("./stripe");
 /**
  * Quieter chrome, one rule instead of a grid, and a slot that rests on the row
  * number. Every colour is lifted against the surface it actually sits on.
@@ -33,6 +34,7 @@ const studioPreset = (colors, isDark) => {
             selectedBg: (0, outlineRung_1.liftToContrast)(colors.primary[50], surface, outlineRung_1.MIN_PERCEPTIBLE_STEP),
             selectedBarColor: colors.primary[500],
             showSelectedBar: true,
+            stripeBg: (0, stripe_1.stripeFill)(colors),
         },
         slot: {
             width: "3.5rem",

package/dist/Components/Table/variants/tokens.d.ts

@@ -12,6 +12,7 @@ export type TableHoverScope = "cell" | "row";
 export type TableChromeReveal = "always" | "hover";
 /** Every field required: a preset that forgets one is a compile error, not a runtime gap. */
 export type TableVariantTokens = {
+    /** Header row look: fill, ink, type scale, height, column rules and when the filter kebab shows. */
     header: {
         bg: string;
         ink: string;
@@ -25,6 +26,7 @@ export type TableVariantTokens = {
         /** When the per-column filter kebab appears. Active columns always show it. */
         actions: TableChromeReveal;
     };
+    /** Body row look: hover and selected fills, rules and the zebra stripe fill. */
     row: {
         hoverBg: string;
         hoverScope: TableHoverScope;
@@ -33,13 +35,17 @@ export type TableVariantTokens = {
         selectedBg: string;
         selectedBarColor: string;
         showSelectedBar: boolean;
+        /** Zebra fill for odd rows when `stripe` is on; a quiet step below `hoverBg`. */
+        stripeBg: string;
     };
+    /** Leading checkbox/index column: width, what rests in it and its ink. */
     slot: {
         width: string;
         rest: TableSlotRest;
         indexInk: string;
         centered: boolean;
     };
+    /** Body cell ink and how status values render (bleed fill or pill). */
     cells: {
         ink: string;
         statusFill: TableStatusFill;

package/dist/Components/Tabs/Tabs.d.ts

@@ -0,0 +1,4 @@
+import type { TabsProps } from "./TabsProps";
+/** Tabs from `items` or composed TabList and TabPanels; all-`href` items render a nav. */
+declare const Tabs: ({ items, children, value, defaultValue, onChange, variant, size, colorScheme, orientation, activationMode, isLazy, isFitted, id, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, linkAs, }: TabsProps) => import("react/jsx-runtime").JSX.Element;
+export default Tabs;

package/dist/Components/Tabs/Tabs.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_2 = require("@chakra-ui/react");
+const TabsContext_1 = require("./TabsContext");
+const TabList_1 = __importDefault(require("./components/TabList"));
+const Tab_1 = __importDefault(require("./components/Tab"));
+const TabPanels_1 = __importDefault(require("./components/TabPanels"));
+const TabPanel_1 = __importDefault(require("./components/TabPanel"));
+const TabLinkList_1 = __importDefault(require("./components/TabLinkList"));
+/** Tabs from `items` or composed TabList and TabPanels; all-`href` items render a nav. */
+const Tabs = ({ items, children, value, defaultValue, onChange, variant = "line", size = "sm", colorScheme = "primary", orientation = "horizontal", activationMode = "automatic", isLazy = false, isFitted = false, id, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, linkAs = "a", }) => {
+    var _a;
+    const generatedId = (0, react_1.useId)();
+    const baseId = id !== null && id !== void 0 ? id : generatedId;
+    const isControlled = value !== undefined;
+    const linkCount = (_a = items === null || items === void 0 ? void 0 : items.filter((item) => item.href !== undefined).length) !== null && _a !== void 0 ? _a : 0;
+    const isLinkMode = !children && !!(items === null || items === void 0 ? void 0 : items.length) && linkCount === items.length;
+    const isMixed = !children && linkCount > 0 && !isLinkMode;
+    (0, react_1.useEffect)(() => {
+        if (isMixed && process.env.NODE_ENV !== "production") {
+            console.warn("Tabs: some items have `href` and some do not. Link mode needs `href` on every item; rendering a tablist and ignoring `href`.");
+        }
+    }, [isMixed]);
+    const [internalValue, setInternalValue] = (0, react_1.useState)(() => { var _a; return defaultValue !== null && defaultValue !== void 0 ? defaultValue : (isLinkMode ? undefined : (_a = items === null || items === void 0 ? void 0 : items.find((item) => !item.isDisabled)) === null || _a === void 0 ? void 0 : _a.id); });
+    const selectedId = isControlled ? value : internalValue;
+    const [focusedId, setFocusedId] = (0, react_1.useState)(selectedId);
+    const [hasPanels, setHasPanels] = (0, react_1.useState)(() => !!(items === null || items === void 0 ? void 0 : items.some((item) => item.content !== undefined)));
+    (0, react_1.useEffect)(() => {
+        setFocusedId(selectedId);
+    }, [selectedId]);
+    const select = (0, react_1.useCallback)((next) => {
+        if (!isControlled)
+            setInternalValue(next);
+        setFocusedId(next);
+        onChange === null || onChange === void 0 ? void 0 : onChange(next);
+    }, [isControlled, onChange]);
+    const focusTab = (0, react_1.useCallback)((next) => setFocusedId(next), []);
+    const registerPanels = (0, react_1.useCallback)(() => setHasPanels(true), []);
+    const contextValue = (0, react_1.useMemo)(() => ({
+        baseId,
+        selectedId,
+        focusedId,
+        select,
+        focusTab,
+        hasPanels,
+        registerPanels,
+        orientation,
+        activationMode,
+        variant,
+        size,
+        colorScheme,
+        isLazy,
+        isFitted,
+    }), [
+        baseId,
+        selectedId,
+        focusedId,
+        select,
+        focusTab,
+        hasPanels,
+        registerPanels,
+        orientation,
+        activationMode,
+        variant,
+        size,
+        colorScheme,
+        isLazy,
+        isFitted,
+    ]);
+    if (children) {
+        return (0, jsx_runtime_1.jsx)(TabsContext_1.TabsContext.Provider, { value: contextValue, children: children });
+    }
+    if (isLinkMode) {
+        return ((0, jsx_runtime_1.jsx)(TabsContext_1.TabsContext.Provider, { value: contextValue, children: (0, jsx_runtime_1.jsx)(TabLinkList_1.default, { items: items, linkAs: linkAs, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy }) }));
+    }
+    const hasContent = !!(items === null || items === void 0 ? void 0 : items.some((item) => item.content !== undefined));
+    return ((0, jsx_runtime_1.jsx)(TabsContext_1.TabsContext.Provider, { value: contextValue, children: (0, jsx_runtime_1.jsxs)(react_2.Box, { display: "flex", flexDirection: orientation === "vertical" ? "row" : "column", alignItems: orientation === "vertical" ? "flex-start" : undefined, gap: orientation === "vertical" ? 4 : 2, children: [(0, jsx_runtime_1.jsx)(TabList_1.default, { "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, children: items === null || items === void 0 ? void 0 : items.map((item) => ((0, jsx_runtime_1.jsx)(Tab_1.default, { value: item.id, icon: item.icon, count: item.count, isDisabled: item.isDisabled, children: item.label }, item.id))) }), hasContent ? ((0, jsx_runtime_1.jsx)(TabPanels_1.default, { children: items === null || items === void 0 ? void 0 : items.filter((item) => item.content !== undefined).map((item) => ((0, jsx_runtime_1.jsx)(TabPanel_1.default, { value: item.id, children: item.content }, item.id))) })) : null] }) }));
+};
+exports.default = Tabs;

package/dist/Components/Tabs/TabsContext.d.ts

@@ -0,0 +1,36 @@
+import type { ControlSize } from "../../Theme/tokens/primitives/controlSizes";
+import type { TabActivationMode, TabsColorScheme, TabsOrientation, TabsVariant } from "./TabsProps";
+export interface TabsContextValue {
+    /** Id prefix from which tab and panel ids are derived. */
+    baseId: string;
+    /** Selected tab value; undefined when none is selected, e.g. in link mode. */
+    selectedId: string | undefined;
+    /** Tab that holds the roving tab stop. */
+    focusedId: string | undefined;
+    /** Selects a tab by value; updates internal state only when uncontrolled. */
+    select: (value: string) => void;
+    /** Moves the roving focus to a tab without selecting it. */
+    focusTab: (value: string) => void;
+    /** True once a panel container exists; tabs then point `aria-controls` at their panel. */
+    hasPanels: boolean;
+    /** Called by TabPanels to mark that this Tabs instance has panels. */
+    registerPanels: () => void;
+    /** Layout axis and arrow-key direction. */
+    orientation: TabsOrientation;
+    /** Whether focus alone selects a tab. */
+    activationMode: TabActivationMode;
+    /** Visual treatment shared by every tab. */
+    variant: TabsVariant;
+    /** Control size shared by every tab. */
+    size: ControlSize;
+    /** Colour of the selected tab and its count badge. */
+    colorScheme: TabsColorScheme;
+    /** Keeps unselected panels unmounted until first selected. */
+    isLazy: boolean;
+    /** Tabs share the tablist's width equally. */
+    isFitted: boolean;
+}
+export declare const TabsContext: import("react").Context<TabsContextValue | undefined>;
+export declare const useTabsContext: () => TabsContextValue;
+export declare const tabId: (baseId: string, value: string) => string;
+export declare const panelId: (baseId: string, value: string) => string;

package/dist/Components/Tabs/TabsContext.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.panelId = exports.tabId = exports.useTabsContext = exports.TabsContext = void 0;
+const react_1 = require("react");
+exports.TabsContext = (0, react_1.createContext)(undefined);
+const useTabsContext = () => {
+    const ctx = (0, react_1.useContext)(exports.TabsContext);
+    if (!ctx)
+        throw new Error("Tabs.List/Tab/Panels/Panel must be rendered inside <Tabs>");
+    return ctx;
+};
+exports.useTabsContext = useTabsContext;
+const tabId = (baseId, value) => `${baseId}-tab-${value}`;
+exports.tabId = tabId;
+const panelId = (baseId, value) => `${baseId}-panel-${value}`;
+exports.panelId = panelId;

package/dist/Components/Tabs/TabsProps.d.ts

@@ -0,0 +1,96 @@
+import type { ElementType, ReactNode } from "react";
+import type { ControlSize } from "../../Theme/tokens/primitives/controlSizes";
+/** Visual treatment; follows the repo's solid/subtle/outline/ghost/line vocabulary. Defaults to "line". */
+export type TabsVariant = "solid" | "subtle" | "outline" | "ghost" | "line";
+/** Arrow-key direction and tablist layout axis. */
+export type TabsOrientation = "horizontal" | "vertical";
+/** "automatic" (default) selects a tab as focus reaches it; "manual" only selects on Enter/Space/click. */
+export type TabActivationMode = "automatic" | "manual";
+/** Category colour for the selected tab's ink/fill and its count badge. */
+export type TabsColorScheme = "primary" | "secondary" | "tertiary" | "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink";
+/** One entry in the declarative `items` API; omit `content` when panels are rendered elsewhere (e.g. a route). With `href` on every item it is a navigation link, not a tab. */
+export interface TabItem {
+    /** Unique value of the tab; what `value` and `onChange` use. */
+    id: string;
+    /** Tab text or node. */
+    label: ReactNode;
+    /** Decorative — rendered aria-hidden, never a substitute for `label`. */
+    icon?: ReactNode;
+    /** Renders a soft count badge after the label; omit for no badge. */
+    count?: number | string;
+    /** Dims the tab and makes it unselectable; also skipped when picking the default selection. */
+    isDisabled?: boolean;
+    /** Panel body for this tab; if no item in `items` sets one, no panel container is rendered at all. */
+    content?: ReactNode;
+    /** Makes the item a link. When every item has one, `Tabs` renders a `<nav>` of links instead of a tablist. */
+    href?: string;
+}
+/** Themed, accessible tabs. Pass `items` for the declarative API, or `children` (TabList/Tab/TabPanels/TabPanel) to compose by hand. */
+export interface TabsProps {
+    /** Declarative API — builds TabList/Tab/TabPanels/TabPanel for you. Ignored when `children` is passed. */
+    items?: TabItem[];
+    /** Composed API — render TabList/Tab/TabPanels/TabPanel yourself; `items` is ignored. */
+    children?: ReactNode;
+    /** Controlled selected tab id; pass with `onChange`. */
+    value?: string;
+    /** Uncontrolled initial tab id; with `items` and neither this nor `value`, the first enabled tab is selected. */
+    defaultValue?: string;
+    /** Called with the new tab value on selection, controlled or not. */
+    onChange?: (value: string) => void;
+    /** Visual treatment; defaults to "line". */
+    variant?: TabsVariant;
+    /** Defaults to "sm", on the button control scale (sm 32 · md 40 · lg 48px), not form fields. */
+    size?: ControlSize;
+    /** Colour of the selected tab and count badges; defaults to "primary". */
+    colorScheme?: TabsColorScheme;
+    /** Layout axis and arrow-key direction; defaults to "horizontal". */
+    orientation?: TabsOrientation;
+    /** Whether focus alone selects a tab; defaults to "automatic". */
+    activationMode?: TabActivationMode;
+    /** Keeps an unselected panel unmounted until its tab is first selected; stays mounted after that. */
+    isLazy?: boolean;
+    /** Tabs share the tablist's width/height equally instead of sizing to their own content. */
+    isFitted?: boolean;
+    /** Stable id prefix for the generated tab/panel ids; auto-generated via useId() when omitted. */
+    id?: string;
+    /** Accessible name of the tablist, or of the nav in link mode. */
+    "aria-label"?: string;
+    /** Id of an element that names the tablist, or the nav in link mode. */
+    "aria-labelledby"?: string;
+    /** Anchor-like component for `href` items, e.g. a router link. Defaults to "a"; link mode only. */
+    linkAs?: ElementType;
+}
+/** Composed-API tablist wrapper; renders `Tab` children and owns keyboard navigation + overflow scroll. */
+export interface TabListProps {
+    /** `Tab` elements in order. */
+    children: ReactNode;
+    /** Accessible name of the tablist. */
+    "aria-label"?: string;
+    /** Id of an element that names the tablist. */
+    "aria-labelledby"?: string;
+}
+/** Composed-API single tab button; read from the nearest `<Tabs>` context for variant/size/colours. */
+export interface TabProps {
+    /** Must match a TabPanel's `value` to be controllable/reachable by aria-controls. */
+    value: string;
+    /** Tab label. */
+    children: ReactNode;
+    /** Decorative — rendered aria-hidden. */
+    icon?: ReactNode;
+    /** Soft count badge after the label; omit for none. */
+    count?: number | string;
+    /** Dims the tab and makes it unselectable. */
+    isDisabled?: boolean;
+}
+/** Composed-API panel wrapper; renders `TabPanel` children and registers that this Tabs instance has panels. */
+export interface TabPanelsProps {
+    /** `TabPanel` elements. */
+    children: ReactNode;
+}
+/** Composed-API panel body; hidden (and, with isLazy, unmounted) whenever its `value` isn't selected. */
+export interface TabPanelProps {
+    /** Must match the Tab's `value` this panel belongs to. */
+    value: string;
+    /** Panel content. */
+    children?: ReactNode;
+}

package/dist/Components/Tabs/TabsProps.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Components/Tabs/components/CountBadge.d.ts

@@ -0,0 +1,17 @@
+import type { ColorScale, PaletteProps } from "../../../Theme/tokens/types";
+import type { ControlSize } from "../../../Theme/tokens/primitives/controlSizes";
+/** Internal count pill on a tab; ink is lifted against `surface`. */
+export interface CountBadgeProps {
+    /** Number or text shown in the pill. */
+    count: number | string;
+    /** Active theme palette. */
+    colors: PaletteProps;
+    /** Colour scale the pill's tone is resolved from. */
+    scale: ColorScale;
+    /** Surface the badge actually sits on — the page canvas, or the tab's own solid fill when selected. */
+    surface: string;
+    /** Control size; picks the font size. */
+    size: ControlSize;
+}
+declare const CountBadge: ({ count, colors, scale, surface, size }: CountBadgeProps) => import("react/jsx-runtime").JSX.Element;
+export default CountBadge;

package/dist/Components/Tabs/components/CountBadge.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("@chakra-ui/react");
+const tone_1 = require("../../../Theme/tokens/builders/tone");
+const BADGE_FONT_SIZE = {
+    xs: "0.625rem",
+    sm: "xs-minus",
+    md: "xs",
+    lg: "xs-plus",
+};
+// Same resolveSoftTone(colors, scale, surface) pattern as SideBar/Header's own count badges.
+const CountBadge = ({ count, colors, scale, surface, size }) => {
+    const tone = (0, tone_1.resolveSoftTone)(colors, scale, surface);
+    return ((0, jsx_runtime_1.jsx)(react_1.Badge, { as: "span", bg: tone.bg, color: tone.fg, fontSize: BADGE_FONT_SIZE[size], fontWeight: 600, borderRadius: "full", px: "0.375rem", minW: "1.25rem", textAlign: "center", lineHeight: "1.4", flexShrink: 0, children: count }));
+};
+exports.default = CountBadge;

package/dist/Components/Tabs/components/Tab.d.ts

@@ -0,0 +1,4 @@
+import type { TabProps } from "../TabsProps";
+/** One role="tab" button inside a TabList; `ref` is that `<button>`. */
+declare const Tab: import("react").ForwardRefExoticComponent<TabProps & import("react").RefAttributes<HTMLButtonElement>>;
+export default Tab;

package/dist/Components/Tabs/components/Tab.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_2 = require("@chakra-ui/react");
+const TabsContext_1 = require("../TabsContext");
+const useTabAppearance_1 = require("../useTabAppearance");
+const CountBadge_1 = __importDefault(require("./CountBadge"));
+/** One role="tab" button inside a TabList; `ref` is that `<button>`. */
+const Tab = (0, react_1.forwardRef)(function Tab({ value, children, icon, count, isDisabled }, ref) {
+    var _a;
+    const ctx = (0, TabsContext_1.useTabsContext)();
+    const isSelected = ctx.selectedId === value;
+    const isFocusTarget = ((_a = ctx.focusedId) !== null && _a !== void 0 ? _a : ctx.selectedId) === value;
+    const { colors, canvas, scale, style, iconSize, iconSx, boxProps } = (0, useTabAppearance_1.useTabAppearance)(isSelected, isDisabled);
+    return ((0, jsx_runtime_1.jsxs)(react_2.Box, { as: "button", type: "button", ref: ref, role: "tab", id: (0, TabsContext_1.tabId)(ctx.baseId, value), "aria-selected": isSelected, "aria-disabled": isDisabled || undefined, "aria-controls": ctx.hasPanels ? (0, TabsContext_1.panelId)(ctx.baseId, value) : undefined, "data-value": value, tabIndex: isDisabled ? -1 : isFocusTarget ? 0 : -1, disabled: isDisabled, onClick: () => !isDisabled && ctx.select(value), onFocus: () => ctx.focusTab(value), ...boxProps, children: [icon ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", "aria-hidden": true, boxSize: `${iconSize}px`, sx: iconSx, children: icon })) : null, (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", children: children }), count !== undefined ? ((0, jsx_runtime_1.jsx)(CountBadge_1.default, { count: count, colors: colors, scale: scale, surface: ctx.variant === "solid" && isSelected ? style.bg : canvas, size: ctx.size })) : null] }));
+});
+Tab.displayName = "Tab";
+exports.default = Tab;

package/dist/Components/Tabs/components/TabLinkList.d.ts

@@ -0,0 +1,7 @@
+import type { ElementType } from "react";
+import type { TabsProps } from "../TabsProps";
+type TabLinkListProps = Pick<TabsProps, "items" | "aria-label" | "aria-labelledby"> & {
+    linkAs: ElementType;
+};
+declare const TabLinkList: ({ items, linkAs, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy }: TabLinkListProps) => import("react/jsx-runtime").JSX.Element;
+export default TabLinkList;

package/dist/Components/Tabs/components/TabLinkList.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("@chakra-ui/react");
+const useCustomTheme_1 = require("../../../Theme/useCustomTheme");
+const scrollbar_1 = require("../../../Theme/tokens/builders/scrollbar");
+const TabsContext_1 = require("../TabsContext");
+const useTabAppearance_1 = require("../useTabAppearance");
+const CountBadge_1 = __importDefault(require("./CountBadge"));
+const isPlainPrimaryClick = (event) => event.button === 0 && !event.metaKey && !event.ctrlKey && !event.shiftKey && !event.altKey;
+const TabLink = ({ item, linkAs }) => {
+    const ctx = (0, TabsContext_1.useTabsContext)();
+    const isSelected = ctx.selectedId === item.id;
+    const { colors, canvas, scale, style, iconSize, iconSx, boxProps } = (0, useTabAppearance_1.useTabAppearance)(isSelected, item.isDisabled);
+    const content = ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [item.icon ? ((0, jsx_runtime_1.jsx)(react_1.Box, { as: "span", "aria-hidden": true, boxSize: `${iconSize}px`, sx: iconSx, children: item.icon })) : null, (0, jsx_runtime_1.jsx)(react_1.Box, { as: "span", children: item.label }), item.count !== undefined ? ((0, jsx_runtime_1.jsx)(CountBadge_1.default, { count: item.count, colors: colors, scale: scale, surface: ctx.variant === "solid" && isSelected ? style.bg : canvas, size: ctx.size })) : null] }));
+    if (item.isDisabled) {
+        return ((0, jsx_runtime_1.jsx)(react_1.Box, { as: "span", "aria-disabled": "true", "data-value": item.id, ...boxProps, children: content }));
+    }
+    return ((0, jsx_runtime_1.jsx)(react_1.Box, { as: linkAs, href: item.href, "aria-current": isSelected ? "page" : undefined, "data-value": item.id, onClick: (event) => {
+            if (!event.defaultPrevented && isPlainPrimaryClick(event))
+                ctx.select(item.id);
+        }, ...boxProps, children: content }));
+};
+const TabLinkList = ({ items, linkAs, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy }) => {
+    const { colors } = (0, useCustomTheme_1.useCustomTheme)();
+    const ctx = (0, TabsContext_1.useTabsContext)();
+    const isVertical = ctx.orientation === "vertical";
+    const isLine = ctx.variant === "line";
+    return ((0, jsx_runtime_1.jsx)(react_1.Flex, { as: "nav", "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, direction: isVertical ? "column" : "row", flexShrink: 0, minW: isVertical ? "10rem" : undefined, overflowX: isVertical ? undefined : "auto", overflowY: isVertical ? "auto" : undefined, flexWrap: "nowrap", gap: isLine ? 1 : 1.5, borderBottom: isLine && !isVertical ? "1px solid" : undefined, borderBottomColor: isLine && !isVertical ? colors.boxborder[200] : undefined, borderRight: isLine && isVertical ? "1px solid" : undefined, borderRightColor: isLine && isVertical ? colors.boxborder[200] : undefined, sx: (0, scrollbar_1.scrollbarStyles)(colors, "hover"), children: items === null || items === void 0 ? void 0 : items.map((item) => ((0, jsx_runtime_1.jsx)(TabLink, { item: item, linkAs: linkAs }, item.id))) }));
+};
+exports.default = TabLinkList;

package/dist/Components/Tabs/components/TabList.d.ts

@@ -0,0 +1,4 @@
+import type { TabListProps } from "../TabsProps";
+/** Tablist that scrolls to keep the focused or selected tab in view. */
+declare const TabList: ({ children, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy }: TabListProps) => import("react/jsx-runtime").JSX.Element;
+export default TabList;