pixelize-design-library 3.0.1-beta.1 → 3.1.1

package/dist/Components/ProductDetails/productDetailsModel.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clampQuantity = exports.quantityCeiling = exports.soldOutEverywhere = exports.firstUnpickedAxis = exports.packUnitPrice = exports.activeMediaIds = exports.resolveVariants = exports.DEFAULT_MAX_QUANTITY = void 0;
+const commerceVariants_1 = require("../Commerce/commerceVariants");
+const price_1 = require("../../Utils/price");
+exports.DEFAULT_MAX_QUANTITY = 10;
+/** A product without variants sells as one variant at its own price. */
+const resolveVariants = (product) => product.variants.length > 0
+    ? product.variants
+    : [{ id: "default", options: {}, price: product.price, mrp: product.mrp }];
+exports.resolveVariants = resolveVariants;
+/** A variant's own frames win; otherwise the frames of each picked option, in axis order. */
+const activeMediaIds = (product, selection, variant) => {
+    if ((variant === null || variant === void 0 ? void 0 : variant.mediaIds) && variant.mediaIds.length > 0)
+        return variant.mediaIds;
+    const byOption = product.mediaIdsByOption;
+    if (!byOption)
+        return undefined;
+    const ids = product.axes.flatMap((axis) => { var _a; return (_a = byOption[`${axis.id}:${selection[axis.id]}`]) !== null && _a !== void 0 ? _a : []; });
+    return ids.length > 0 ? [...new Set(ids)] : undefined;
+};
+exports.activeMediaIds = activeMediaIds;
+const packUnitPrice = (product, selection, price) => {
+    if (!product.unit)
+        return null;
+    const axis = product.axes.find((candidate) => candidate.type === "pack");
+    const picked = axis === null || axis === void 0 ? void 0 : axis.values.find((value) => value.id === selection[axis.id]);
+    if (!(picked === null || picked === void 0 ? void 0 : picked.quantity))
+        return null;
+    return (0, price_1.unitPrice)(price, picked.quantity, product.unit.unit, product.unit.per);
+};
+exports.packUnitPrice = packUnitPrice;
+const firstUnpickedAxis = (axes, selection) => axes.find((axis) => selection[axis.id] === undefined);
+exports.firstUnpickedAxis = firstUnpickedAxis;
+const soldOutEverywhere = (variants) => variants.length > 0 && variants.every((variant) => (0, commerceVariants_1.stockState)(variant) === "out-of-stock");
+exports.soldOutEverywhere = soldOutEverywhere;
+/** Real remaining stock caps the order; backorder and untracked stock fall back to the per-order ceiling. */
+const quantityCeiling = (variant, maxQuantity) => {
+    if ((variant === null || variant === void 0 ? void 0 : variant.stock) === undefined || variant.backorder)
+        return maxQuantity;
+    return Math.max(0, Math.min(variant.stock, maxQuantity));
+};
+exports.quantityCeiling = quantityCeiling;
+const clampQuantity = (value, ceiling) => Math.max(1, Math.min(value, Math.max(1, ceiling)));
+exports.clampQuantity = clampQuantity;

package/dist/Components/ProductDetails/useInViewport.d.ts

@@ -0,0 +1,3 @@
+import type { RefObject } from "react";
+/** Whether the element is on screen; true until an observer reports otherwise, and always true where IntersectionObserver is missing. */
+export declare const useInViewport: (ref: RefObject<Element>, enabled?: boolean) => boolean;

package/dist/Components/ProductDetails/useInViewport.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useInViewport = void 0;
+const react_1 = require("react");
+/** Whether the element is on screen; true until an observer reports otherwise, and always true where IntersectionObserver is missing. */
+const useInViewport = (ref, enabled = true) => {
+    const [inView, setInView] = (0, react_1.useState)(true);
+    (0, react_1.useEffect)(() => {
+        const node = ref.current;
+        if (!enabled || !node || typeof IntersectionObserver === "undefined")
+            return undefined;
+        const observer = new IntersectionObserver(([entry]) => setInView(entry.isIntersecting));
+        observer.observe(node);
+        return () => observer.disconnect();
+    }, [ref, enabled]);
+    return inView;
+};
+exports.useInViewport = useInViewport;

package/dist/Components/ProfileCard/ProfileCard.d.ts

@@ -1,12 +1,7 @@
 import React from "react";
-import { ProfileCardProps } from "./ProfileCardProps";
-export declare const ProfileCardHeader: React.FC<{
-    children: React.ReactNode;
-}>;
-export declare const ProfileCardBody: React.FC<{
-    children: React.ReactNode;
-}>;
-export declare const ProfileCardFooter: React.FC<{
-    children: React.ReactNode;
-}>;
-export default function ProfileCard({ maxW, align, variant, direction, justify, children, size, color, overflow, dividercolor, dividersize, dividervariant, CardStyle, CardHeaderStyle, CardBodyStyle, borderTopColor, borderLeftColor, }: ProfileCardProps): React.JSX.Element;
+import { ProfileCardProps, ProfileCardHeaderSlotProps, ProfileCardBodySlotProps, ProfileCardFooterSlotProps } from "./ProfileCardProps";
+export declare const ProfileCardHeader: React.FC<ProfileCardHeaderSlotProps>;
+export declare const ProfileCardBody: React.FC<ProfileCardBodySlotProps>;
+export declare const ProfileCardFooter: React.FC<ProfileCardFooterSlotProps>;
+/** Card built from ProfileCardHeader, Body and Footer slots; other children are dropped. */
+export default function ProfileCard({ maxW, align, variant, direction, justify, children, size, color, overflow, dividercolor, dividersize, dividervariant, CardStyle, CardHeaderStyle, CardBodyStyle, borderTopColor, borderLeftColor, }: ProfileCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/Components/ProfileCard/ProfileCard.js

@@ -1,61 +1,45 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProfileCardFooter = exports.ProfileCardBody = exports.ProfileCardHeader = void 0;
 exports.default = ProfileCard;
-var react_1 = __importDefault(require("react"));
-var react_2 = require("@chakra-ui/react");
-var ProfileCardHeader = function (_a) {
-    var children = _a.children;
-    return react_1.default.createElement(react_1.default.Fragment, null, children);
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("@chakra-ui/react");
+const useCustomTheme_1 = require("../../Theme/useCustomTheme");
+const warnDroppedSlotChildren_1 = require("../Modal/warnDroppedSlotChildren");
+const findSlot_1 = require("../Common/findSlot");
+const ProfileCardHeader = ({ children, }) => {
+    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children });
 };
 exports.ProfileCardHeader = ProfileCardHeader;
-var ProfileCardBody = function (_a) {
-    var children = _a.children;
-    return react_1.default.createElement(react_1.default.Fragment, null, children);
+const ProfileCardBody = ({ children, }) => {
+    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children });
 };
 exports.ProfileCardBody = ProfileCardBody;
-var ProfileCardFooter = function (_a) {
-    var children = _a.children;
-    return react_1.default.createElement(react_1.default.Fragment, null, children);
+const ProfileCardFooter = ({ children, }) => {
+    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: children });
 };
 exports.ProfileCardFooter = ProfileCardFooter;
-function ProfileCard(_a) {
-    var _b, _c, _d, _e;
-    var maxW = _a.maxW, align = _a.align, variant = _a.variant, direction = _a.direction, justify = _a.justify, children = _a.children, size = _a.size, color = _a.color, overflow = _a.overflow, dividercolor = _a.dividercolor, _f = _a.dividersize, dividersize = _f === void 0 ? "0.5px" : _f, _g = _a.dividervariant, dividervariant = _g === void 0 ? "solid" : _g, CardStyle = _a.CardStyle, CardHeaderStyle = _a.CardHeaderStyle, CardBodyStyle = _a.CardBodyStyle, borderTopColor = _a.borderTopColor, borderLeftColor = _a.borderLeftColor;
-    var theme = (0, react_2.useTheme)();
-    var resolvedDividerColor = (_c = dividercolor !== null && dividercolor !== void 0 ? dividercolor : (_b = theme.colors.border) === null || _b === void 0 ? void 0 : _b[400]) !== null && _c !== void 0 ? _c : (_d = theme.colors.gray) === null || _d === void 0 ? void 0 : _d[300];
-    var accentBorder = "2px solid ".concat((_e = theme.colors.primary) === null || _e === void 0 ? void 0 : _e[500]);
-    var isReactElement = function (child) {
-        return child !== null && typeof child === "object" && "type" in child;
-    };
-    var header = react_1.default.Children.toArray(children).find(function (child) { return isReactElement(child) && child.type === exports.ProfileCardHeader; });
-    var body = react_1.default.Children.toArray(children).find(function (child) { return isReactElement(child) && child.type === exports.ProfileCardBody; });
-    var footer = react_1.default.Children.toArray(children).find(function (child) { return isReactElement(child) && child.type === exports.ProfileCardFooter; });
-    var StylesWithBorder = borderLeftColor
-        ? __assign(__assign({}, CardStyle), { borderLeft: accentBorder }) : borderTopColor
-        ? __assign(__assign({}, CardStyle), { borderTop: accentBorder }) : __assign({}, CardStyle);
-    return (react_1.default.createElement(react_2.Card, { maxW: maxW, align: align, variant: variant, direction: direction, justify: justify, size: size, overflow: overflow, colorScheme: color, style: StylesWithBorder },
-        header && (react_1.default.createElement(react_1.default.Fragment, null,
-            react_1.default.createElement(react_2.CardHeader, { sx: __assign(__assign({}, CardHeaderStyle), { fontWeight: "bold" }), py: 15 }, header),
-            react_1.default.createElement(react_2.Divider, { style: {
-                    borderColor: resolvedDividerColor,
-                    borderWidth: dividersize,
-                    borderStyle: dividervariant,
-                } }))),
-        react_1.default.createElement(react_2.CardBody, { sx: CardBodyStyle }, body),
-        footer && react_1.default.createElement(react_2.CardFooter, null, footer)));
+const SLOTS = [exports.ProfileCardHeader, exports.ProfileCardBody, exports.ProfileCardFooter];
+const DROPPED_ADVICE = "Render it outside the card.";
+/** Card built from ProfileCardHeader, Body and Footer slots; other children are dropped. */
+function ProfileCard({ maxW, align, variant, direction, justify, children, size, color, overflow, dividercolor, dividersize = "1px", dividervariant = "solid", CardStyle, CardHeaderStyle, CardBodyStyle, borderTopColor, borderLeftColor, }) {
+    var _a;
+    const { colors } = (0, useCustomTheme_1.useCustomTheme)();
+    const resolvedDividerColor = dividercolor !== null && dividercolor !== void 0 ? dividercolor : colors.boxborder[200];
+    const accentBorder = `2px solid ${colors.primary[500]}`;
+    const header = (0, findSlot_1.findSlot)(children, exports.ProfileCardHeader);
+    const body = (0, findSlot_1.findSlot)(children, exports.ProfileCardBody);
+    const footer = (0, findSlot_1.findSlot)(children, exports.ProfileCardFooter);
+    (0, warnDroppedSlotChildren_1.warnDroppedSlotChildren)("ProfileCard", children, SLOTS, DROPPED_ADVICE);
+    const StylesWithBorder = borderLeftColor
+        ? { ...CardStyle, borderLeft: accentBorder }
+        : borderTopColor
+            ? { ...CardStyle, borderTop: accentBorder }
+            : { ...CardStyle };
+    return ((0, jsx_runtime_1.jsxs)(react_1.Card, { maxW: maxW, align: align, variant: variant === "outlein" ? "outline" : variant, direction: direction, justify: justify, size: size, overflow: overflow, colorScheme: color, style: StylesWithBorder, children: [header && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(react_1.CardHeader, { sx: CardHeaderStyle, ...header.props, children: header }), (0, jsx_runtime_1.jsx)(react_1.Divider, { opacity: 1, style: {
+                            borderColor: resolvedDividerColor,
+                            borderWidth: 0,
+                            borderBottomWidth: dividersize,
+                            borderStyle: dividervariant,
+                        } })] })), (0, jsx_runtime_1.jsx)(react_1.CardBody, { sx: CardBodyStyle, ...((_a = body === null || body === void 0 ? void 0 : body.props) !== null && _a !== void 0 ? _a : {}), children: body }), footer && (0, jsx_runtime_1.jsx)(react_1.CardFooter, { ...footer.props, children: footer })] }));
 }

package/dist/Components/ProfileCard/ProfileCardProps.d.ts

@@ -1,15 +1,38 @@
-import { CardProps } from "@chakra-ui/react";
+import { CardProps, CardHeaderProps, CardBodyProps, CardFooterProps } from "@chakra-ui/react";
+/** Mirrors Chakra Card's own variant strings — forwarded to the underlying Card unchanged. */
+export type ProfileCardVariant = "elevated" | "outline" | "filled" | "unstyled";
+/** @deprecated Misspelling kept for existing callers — use "outline". */
+export type ProfileCardVariantLegacy = "outlein";
+/** borderTopColor/borderLeftColor are booleans toggling a fixed accent border color, not custom-color props; borderLeftColor wins if both are true. */
 export type ProfileCardProps = Pick<CardProps, "direction" | "maxW" | "align" | "justify" | "overflow"> & {
+    /** Only ProfileCardHeader/Body/Footer children render, matched by type through nested Fragments; any other sibling is dropped. */
     children: React.ReactNode;
-    variant?: "elevated" | "outlein" | "filled" | "unstyled";
+    /** Chakra Card variant; "outlein" is mapped to "outline". */
+    variant?: ProfileCardVariant | ProfileCardVariantLegacy;
+    /** Padding scale of header, body and footer. */
     size?: "sm" | "md" | "lg";
+    /** @deprecated No visual effect: forwarded as colorScheme, which the Card styles never read. */
     color?: "whiteAlpha" | "blackAlpha" | "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink";
+    /** CSS colour of the rule under the header, drawn only with a header slot. */
     dividercolor?: string;
+    /** Thickness of the header rule; defaults to "1px". */
     dividersize?: string;
+    /** Border style of the header rule; defaults to "solid". */
     dividervariant?: "solid" | "dashed" | "dotted" | "double" | "groove" | "ridge" | "inset" | "outset";
+    /** Inline style on the card root; an accent border replaces its own borderTop/borderLeft. */
     CardStyle?: React.CSSProperties;
+    /** Applied as the header's sx; an `sx` on ProfileCardHeader replaces it entirely. */
     CardHeaderStyle?: React.CSSProperties;
+    /** Applied as the body's sx; an `sx` on ProfileCardBody replaces it entirely. */
     CardBodyStyle?: React.CSSProperties;
+    /** True draws a 2px brand-primary border along the top. */
     borderTopColor?: boolean;
+    /** True draws a 2px brand-primary border down the left; wins over borderTopColor. */
     borderLeftColor?: boolean;
 };
+/** Chakra style props (padding, borderBottom, gap, sx, ...) spread onto the rendered CardHeader; omit to keep theme/CardHeaderStyle defaults. */
+export type ProfileCardHeaderSlotProps = CardHeaderProps;
+/** Chakra style props (padding, gap, sx, ...) spread onto the rendered CardBody; omit to keep theme/CardBodyStyle defaults. */
+export type ProfileCardBodySlotProps = CardBodyProps;
+/** Chakra style props (padding, gap, sx, ...) spread onto the rendered CardFooter; omit to keep theme defaults. */
+export type ProfileCardFooterSlotProps = CardFooterProps;

package/dist/Components/ProfilePhotoViewer/ProfilePhotoViewer.d.ts

@@ -1,3 +1,3 @@
-import React from "react";
 import { ProfilePhotoViewerProps } from "./ProfilePhotoViewerProps";
-export default function ProfilePhotoViewer({ photoUrl, onPhotoChange, imageWidth, imageAlt, imageObjectFit, imageBorderRadius, editIconSize, editIconPositionRight, editIconPositionBottom, isRound, boxStyle, isEditable, isView, style, handleIsView, fallbackText, }: ProfilePhotoViewerProps): React.JSX.Element;
+/** Avatar display with optional edit/view actions — does not crop, resize, or upload; PDF detection breaks on a freshly-picked file. */
+export default function ProfilePhotoViewer({ photoUrl, onPhotoChange, imageWidth, imageAlt, imageObjectFit, imageBorderRadius, editIconSize, editIconPositionRight, editIconPositionBottom, isRound, boxStyle, isEditable, isView, style, handleIsView, fallbackText, revealOnHover, }: ProfilePhotoViewerProps): import("react/jsx-runtime").JSX.Element;

package/dist/Components/ProfilePhotoViewer/ProfilePhotoViewer.js

@@ -1,106 +1,95 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = ProfilePhotoViewer;
-var react_1 = __importStar(require("react"));
-var react_2 = require("@chakra-ui/react");
-var lucide_react_1 = require("lucide-react");
-var useCustomTheme_1 = require("../../Theme/useCustomTheme");
-function ProfilePhotoViewer(_a) {
-    var photoUrl = _a.photoUrl, onPhotoChange = _a.onPhotoChange, _b = _a.imageWidth, imageWidth = _b === void 0 ? "100px" : _b, _c = _a.imageAlt, imageAlt = _c === void 0 ? "Profile Photo" : _c, _d = _a.imageObjectFit, imageObjectFit = _d === void 0 ? "cover" : _d, _e = _a.imageBorderRadius, imageBorderRadius = _e === void 0 ? "full" : _e, _f = _a.editIconSize, editIconSize = _f === void 0 ? "sm" : _f, _g = _a.editIconPositionRight, editIconPositionRight = _g === void 0 ? "0px" : _g, _h = _a.editIconPositionBottom, editIconPositionBottom = _h === void 0 ? "0px" : _h, _j = _a.isRound, isRound = _j === void 0 ? true : _j, boxStyle = _a.boxStyle, _k = _a.isEditable, isEditable = _k === void 0 ? false : _k, _l = _a.isView, isView = _l === void 0 ? false : _l, style = _a.style, handleIsView = _a.handleIsView, fallbackText = _a.fallbackText;
-    var _m = (0, react_1.useState)(photoUrl), photo = _m[0], setPhoto = _m[1];
-    var fileInputRef = (0, react_1.useRef)(null);
-    var theme = (0, useCustomTheme_1.useCustomTheme)();
-    var handlePhotoChange = function (event) {
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_2 = require("@chakra-ui/react");
+const lucide_react_1 = require("lucide-react");
+const useCustomTheme_1 = require("../../Theme/useCustomTheme");
+const borderWidths_1 = require("../../Theme/tokens/primitives/borderWidths");
+const motion_1 = require("../../Theme/tokens/primitives/motion");
+const accentText_1 = require("../../Theme/tokens/builders/accentText");
+const planeStep_1 = require("../../Theme/tokens/builders/planeStep");
+const filledSurface_1 = require("../../Theme/tokens/builders/filledSurface");
+const color_1 = require("../../Theme/tokens/builders/color");
+const RING_TRANSITION = (0, motion_1.transitionFor)(["box-shadow"], "base");
+const FADE_TRANSITION = (0, motion_1.transitionFor)(["opacity"], "base");
+const ACTION_TRANSITION = (0, motion_1.transitionFor)(["transform", "background", "box-shadow"], "base");
+/** Avatar display with optional edit/view actions — does not crop, resize, or upload; PDF detection breaks on a freshly-picked file. */
+function ProfilePhotoViewer({ photoUrl, onPhotoChange, imageWidth = "100px", imageAlt = "Profile Photo", imageObjectFit = "cover", imageBorderRadius = "full", editIconSize = "sm", editIconPositionRight = "0px", editIconPositionBottom = "0px", isRound = true, boxStyle, isEditable = false, isView = false, style, handleIsView, fallbackText, revealOnHover = true, }) {
+    var _a, _b, _c, _d, _e;
+    const [photo, setPhoto] = (0, react_1.useState)(photoUrl);
+    const [syncedUrl, setSyncedUrl] = (0, react_1.useState)(photoUrl);
+    if (photoUrl !== syncedUrl) {
+        setSyncedUrl(photoUrl);
+        setPhoto(photoUrl);
+    }
+    const fileInputRef = (0, react_1.useRef)(null);
+    const theme = (0, useCustomTheme_1.useCustomTheme)();
+    const c = theme.colors;
+    const editFill = (0, filledSurface_1.resolveFilledSurface)(c.primary, c);
+    const handlePhotoChange = (event) => {
         var _a;
         if (!isEditable)
             return;
-        var file = (_a = event.target.files) === null || _a === void 0 ? void 0 : _a[0];
+        const file = (_a = event.target.files) === null || _a === void 0 ? void 0 : _a[0];
         if (file) {
-            var reader_1 = new FileReader();
-            reader_1.onload = function () {
-                var photoUrl = reader_1.result;
+            const reader = new FileReader();
+            reader.onload = () => {
+                const photoUrl = reader.result;
                 setPhoto(photoUrl);
                 onPhotoChange(file);
             };
-            reader_1.readAsDataURL(file);
+            reader.readAsDataURL(file);
         }
     };
-    var handleClick = function () {
+    const handleClick = () => {
         var _a;
         if (!isEditable)
             return;
         (_a = fileInputRef.current) === null || _a === void 0 ? void 0 : _a.click();
     };
-    var isPdf = photo === null || photo === void 0 ? void 0 : photo.endsWith(".pdf");
-    return (react_1.default.createElement(react_2.Box, { position: "relative", display: "inline-block", style: boxStyle, sx: {
-            "&:hover .icon-button": {
-                opacity: 1,
+    const isPdf = photo === null || photo === void 0 ? void 0 : photo.endsWith(".pdf");
+    const viewHoverBg = (0, planeStep_1.bandOn)(c.gray[50], c.background[50]);
+    // NOTE: [800] not [300] — the edit IconButton's border is a control boundary, WCAG 1.4.11 needs >=3:1.
+    const border = c.boxborder[500];
+    const hoverScrim = (opacity) => {
+        const { r, g, b } = (0, color_1.hexToRgb)(c.black);
+        return `rgba(${r}, ${g}, ${b}, ${opacity})`;
+    };
+    // Shared modern frame for whichever media we render (photo / pdf / fallback).
+    const mediaFrame = {
+        boxSize: imageWidth,
+        borderRadius: imageBorderRadius,
+        border: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${border}`,
+        boxShadow: (_a = theme.shadows) === null || _a === void 0 ? void 0 : _a.sm,
+    };
+    const renderMedia = () => {
+        if (photo) {
+            return isPdf ? ((0, jsx_runtime_1.jsx)(react_2.Box, { ...mediaFrame, bg: c.gray[100], color: (0, accentText_1.accentTextOnCanvas)(c.gray, c.gray[100]), display: "flex", alignItems: "center", justifyContent: "center", overflow: "hidden", children: (0, jsx_runtime_1.jsx)(lucide_react_1.FileText, { size: "45%" }) })) : ((0, jsx_runtime_1.jsx)(react_2.Image, { src: photo, alt: imageAlt, objectFit: imageObjectFit, ...mediaFrame }));
+        }
+        // Fallback: branded tinted avatar (initials or user glyph).
+        return ((0, jsx_runtime_1.jsx)(react_2.Box, { ...mediaFrame, display: "flex", alignItems: "center", justifyContent: "center", bg: c.primary.opacity[16], color: (0, accentText_1.accentTextOnCanvas)(c.primary, c.backgroundColor.main), children: fallbackText ? ((0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "1.75rem", fontWeight: 700, lineHeight: "1", children: fallbackText })) : ((0, jsx_runtime_1.jsx)(lucide_react_1.User, { size: "48%" })) }));
+    };
+    const hasActions = isEditable || isView;
+    return ((0, jsx_runtime_1.jsxs)(react_2.Box, { position: "relative", display: "inline-block", style: boxStyle, borderRadius: imageBorderRadius, transition: RING_TRANSITION, sx: {
+            "&:hover .ppv-overlay": { opacity: 1 },
+            "&:hover .ppv-actions": { opacity: 1 },
+            "&:hover .ppv-media": {
+                boxShadow: `0 0 0 0.1875rem ${c.primary.opacity[24]}`,
             },
-        } },
-        photo ? (isPdf ? (react_1.default.createElement(react_2.Box, { width: imageWidth, height: imageWidth, borderRadius: imageBorderRadius, bg: "gray.200", display: "flex", alignItems: "center", justifyContent: "center", overflow: "hidden" },
-            react_1.default.createElement(lucide_react_1.FileText, { size: "50%" }))) : (react_1.default.createElement(react_2.Image, { src: photo, alt: imageAlt, boxSize: imageWidth, objectFit: imageObjectFit, borderRadius: imageBorderRadius }))) : fallbackText ? (react_1.default.createElement(react_2.Box, { boxSize: imageWidth, display: "flex", alignItems: "center", justifyContent: "center", borderRadius: imageBorderRadius, bg: "gray.200" },
-            react_1.default.createElement(react_2.Text, { fontSize: "2xl", fontWeight: "bold" }, fallbackText))) : (react_1.default.createElement(react_2.Box, { boxSize: imageWidth, display: "flex", alignItems: "center", justifyContent: "center", borderRadius: imageBorderRadius, bg: "gray.200" },
-            react_1.default.createElement(lucide_react_1.User, { size: "50%" }))),
-        (isEditable || isView) && (react_1.default.createElement(react_1.default.Fragment, null,
-            react_1.default.createElement(react_2.Box, { className: "icon-button", position: "absolute", right: editIconPositionRight, bottom: editIconPositionBottom, transform: "translate(-25%, -25%)", sx: {
-                    opacity: 0,
-                    transition: "opacity 0.3s",
-                } },
-                isEditable && (react_1.default.createElement(react_2.Tooltip, { label: "Edit", "aria-label": "Edit" },
-                    react_1.default.createElement(react_2.IconButton, { icon: react_1.default.createElement(lucide_react_1.SquarePen, { size: 14 }), isRound: isRound, size: editIconSize, onClick: handleClick, "aria-label": "Edit photo", color: theme.colors.gray[200], style: __assign(__assign({}, style), { transition: "transform 0.3s, box-shadow 0.3s", boxShadow: theme.shadows.md, marginRight: "3px" }), _hover: {
-                            transform: "scale(1.1)",
-                            color: theme.colors.white,
-                            boxShadow: theme.shadows.lg,
-                        } }))),
-                isView && (react_1.default.createElement(react_2.Tooltip, { label: "View", "aria-label": "View" },
-                    react_1.default.createElement(react_2.IconButton, { icon: react_1.default.createElement(lucide_react_1.Eye, { size: 14 }), isRound: isRound, size: editIconSize, onClick: handleIsView, "aria-label": "View photo", color: theme.colors.gray[200], style: __assign(__assign({}, style), { transition: "transform 0.3s, box-shadow 0.3s", boxShadow: theme.shadows.md }), _hover: {
-                            transform: "scale(1.1)",
-                            color: theme.colors.white,
-                            boxShadow: theme.shadows.lg,
-                        } })))),
-            isEditable && (react_1.default.createElement(react_2.Input, { type: "file", accept: "image/*", onChange: handlePhotoChange, hidden: true, ref: fileInputRef }))))));
+        }, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { className: "ppv-media", borderRadius: imageBorderRadius, transition: RING_TRANSITION, children: renderMedia() }), hasActions && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(react_2.Box, { className: "ppv-overlay", position: "absolute", inset: 0, borderRadius: imageBorderRadius, bg: hoverScrim(0.3), opacity: 0, transition: FADE_TRANSITION, pointerEvents: "none" }), (0, jsx_runtime_1.jsxs)(react_2.HStack, { className: "ppv-actions", position: "absolute", right: editIconPositionRight, bottom: editIconPositionBottom, transform: "translate(-15%, -15%)", spacing: 1.5, opacity: revealOnHover ? 0 : 1, transition: FADE_TRANSITION, children: [isEditable && ((0, jsx_runtime_1.jsx)(react_2.Tooltip, { label: "Edit", "aria-label": "Edit", hasArrow: true, children: (0, jsx_runtime_1.jsx)(react_2.IconButton, { icon: (0, jsx_runtime_1.jsx)(lucide_react_1.SquarePen, { size: 14 }), isRound: isRound, size: editIconSize, onClick: handleClick, "aria-label": "Edit photo", bg: editFill.fill, color: editFill.color, border: `0.125rem solid ${c.background[50]}`, boxShadow: (_b = theme.shadows) === null || _b === void 0 ? void 0 : _b.md, style: style, transition: ACTION_TRANSITION, _hover: {
+                                        bg: editFill.hoverFill,
+                                        color: editFill.hoverColor,
+                                        transform: "scale(1.1)",
+                                        boxShadow: (_c = theme.shadows) === null || _c === void 0 ? void 0 : _c.lg,
+                                    }, _active: {
+                                        bg: editFill.activeFill,
+                                        color: editFill.activeColor,
+                                    } }) })), isView && ((0, jsx_runtime_1.jsx)(react_2.Tooltip, { label: "View", "aria-label": "View", hasArrow: true, children: (0, jsx_runtime_1.jsx)(react_2.IconButton, { icon: (0, jsx_runtime_1.jsx)(lucide_react_1.Eye, { size: 14 }), isRound: isRound, size: editIconSize, onClick: handleIsView, "aria-label": "View photo", bg: c.background[50], color: c.text[700], border: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${border}`, boxShadow: (_d = theme.shadows) === null || _d === void 0 ? void 0 : _d.md, style: style, transition: ACTION_TRANSITION, _hover: {
+                                        bg: viewHoverBg,
+                                        color: (0, accentText_1.accentTextOnCanvas)(c.primary, viewHoverBg),
+                                        transform: "scale(1.1)",
+                                        boxShadow: (_e = theme.shadows) === null || _e === void 0 ? void 0 : _e.lg,
+                                    }, _active: { bg: c.gray[100] } }) }))] }), isEditable && ((0, jsx_runtime_1.jsx)(react_2.Input, { type: "file", accept: "image/*", onChange: handlePhotoChange, hidden: true, ref: fileInputRef }))] }))] }));
 }

package/dist/Components/ProfilePhotoViewer/ProfilePhotoViewerProps.d.ts

@@ -1,6 +1,10 @@
+/** isEditable and isView are independent — both true shows edit and view actions side by side. */
 export type ProfilePhotoViewerProps = {
+    /** Source of the displayed image; a changed value replaces it, discarding a locally picked preview. */
     photoUrl: string;
+    /** Receives the raw File (not a URL, despite the param name) — fires only when isEditable and a file is picked. */
     onPhotoChange: (photoUrl: File) => void;
+    /** Also sets the height (maps to Chakra's boxSize) — there's no separate height prop; the frame is square. */
     imageWidth?: string;
     imageAlt?: string;
     imageObjectFit?: "cover" | "contain" | "fill" | "none" | "scale-down";
@@ -9,10 +13,16 @@ export type ProfilePhotoViewerProps = {
     editIconSize?: "xs" | "sm" | "md" | "lg" | "xl";
     editIconPositionRight?: string;
     editIconPositionBottom?: string;
+    /** Rounds only the edit/view IconButtons — the photo/avatar shape comes from imageBorderRadius, not this. */
     isRound?: boolean;
+    /** Inline style for the outer wrapper only — the edit/view buttons use the separate `style` prop below. */
     boxStyle?: React.CSSProperties;
     isView?: boolean;
+    /** Applied to BOTH edit and view IconButtons identically — no way to style them individually. */
     style?: React.CSSProperties;
+    /** Fires from the View IconButton — that button (and this handler) only renders when isView is true. */
     handleIsView?: () => void;
     fallbackText?: string;
+    /** When true (the actual default), edit/view icons stay hidden until hover; false keeps them always visible. */
+    revealOnHover?: boolean;
 };

package/dist/Components/ProgressBar/ProgressBar.d.ts

@@ -1,3 +1,3 @@
-import React from "react";
 import { ProgressBarProps } from "./ProgressBarProps";
-export default function ProgressBar({ size, isIndeterminate, color, hasStripe, height, value, isAnimated, max, min, variant, }: ProgressBarProps): React.JSX.Element;
+/** Percentage/quantity fill bar (isAnimated needs hasStripe=true or it's a no-op) — for a named pipeline tracker use StageProgress instead. */
+export default function ProgressBar({ colorScheme, color, variant, isIndeterminate, ...rest }: ProgressBarProps): import("react/jsx-runtime").JSX.Element;

package/dist/Components/ProgressBar/ProgressBar.js

@@ -1,13 +1,35 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = ProgressBar;
-var react_1 = __importDefault(require("react"));
-var react_2 = require("@chakra-ui/react");
-function ProgressBar(_a) {
-    var size = _a.size, isIndeterminate = _a.isIndeterminate, _b = _a.color, color = _b === void 0 ? "primary" : _b, hasStripe = _a.hasStripe, height = _a.height, value = _a.value, isAnimated = _a.isAnimated, max = _a.max, min = _a.min, variant = _a.variant;
-    //  const theme = useCustomTheme();
-    return (react_1.default.createElement(react_2.Progress, { size: size, isIndeterminate: isIndeterminate, colorScheme: color, hasStripe: hasStripe, height: height, value: value, isAnimated: isAnimated, max: max, min: min, variant: variant }));
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("@chakra-ui/react");
+const useCustomTheme_1 = require("../../Theme/useCustomTheme");
+const outlineRung_1 = require("../../Theme/tokens/builders/outlineRung");
+const paletteScale_1 = require("../../Theme/tokens/builders/paletteScale");
+// whiteAlpha/blackAlpha keep Chakra's own fill; contrast math can't resolve alpha scales.
+const NAMED_SCALES = new Set([
+    "gray", "red", "orange", "yellow", "green", "teal", "blue", "cyan", "purple", "pink",
+    "primary", "secondary",
+]);
+const scaleFor = (colors, scheme) => NAMED_SCALES.has(scheme)
+    ? (0, paletteScale_1.scaleNamed)(colors, scheme)
+    : undefined;
+/** Percentage/quantity fill bar (isAnimated needs hasStripe=true or it's a no-op) — for a named pipeline tracker use StageProgress instead. */
+function ProgressBar({ colorScheme, color, variant, isIndeterminate, ...rest }) {
+    var _a;
+    const { colors } = (0, useCustomTheme_1.useCustomTheme)();
+    const scheme = (_a = colorScheme !== null && colorScheme !== void 0 ? colorScheme : color) !== null && _a !== void 0 ? _a : "primary";
+    const scale = scaleFor(colors, scheme);
+    // Chakra pins the fill to rung [500]; light hues (green/orange/blue/cyan) measure as low as
+    // 1.67:1 against the `gray[100]` track — under 1.4.11's 3:1. Lift the fill, not the track.
+    const fill = scale ? (0, outlineRung_1.liftToContrast)(scale[500], colors.gray[100]) : undefined;
+    return ((0, jsx_runtime_1.jsx)(react_1.Progress, { ...rest, variant: variant, isIndeterminate: isIndeterminate, colorScheme: scheme, sx: fill
+            ? {
+                "& > div:first-of-type": isIndeterminate
+                    ? {
+                        backgroundImage: `linear-gradient(to right, transparent 0%, ${fill} 50%, transparent 100%) !important`,
+                    }
+                    : { backgroundColor: `${fill} !important` },
+            }
+            : undefined }));
 }

package/dist/Components/ProgressBar/ProgressBarProps.d.ts

@@ -1,6 +1,14 @@
 import { ProgressProps } from "@chakra-ui/react";
-export type ProgressBarProps = Pick<ProgressProps, "size" | "isIndeterminate" | "value" | "height" | "hasStripe" | "isAnimated" | "max" | "min"> & {
-    color?: "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink" | "whiteAlpha" | "blackAlpha" | "primary" | "secondary";
+/** Fill colour scheme; primary/secondary are brand scales, the rest global scales. */
+export type ProgressBarColorScheme = "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink" | "whiteAlpha" | "blackAlpha" | "primary" | "secondary";
+/** Thin themed wrapper over Chakra's Progress; `aria-valuetext` is the only way to describe indeterminate progress. */
+export type ProgressBarProps = Pick<ProgressProps, "size" | "isIndeterminate" | "value" | "height" | "hasStripe" | "isAnimated" | "max" | "min" | "aria-label" | "aria-labelledby" | "aria-valuetext" | "id" | "borderRadius" | "m" | "mt" | "mb" | "ml" | "mr" | "mx" | "my"> & {
+    /** Fill colour scheme; defaults to "primary". */
+    colorScheme?: ProgressBarColorScheme;
+    /** @deprecated Use `colorScheme` — the library-wide name; still honoured when colorScheme is unset. */
+    color?: ProgressBarColorScheme;
+    /** @deprecated Forwarded to Chakra, but neither this theme nor Chakra Progress defines variants. */
     variant?: "solid" | "outline" | "ghost" | "link" | "unstyled";
+    /** Bar thickness. */
     size?: "lg" | "md" | "sm" | "xs";
 };

package/dist/Components/QuantityStepper/QuantityStepper.d.ts

@@ -0,0 +1,4 @@
+import type { QuantityStepperProps } from "./QuantityStepperProps";
+/** Pill stepper for quantities: soft or outline, trash at the floor on cart lines, limits announced via aria-disabled. */
+declare const QuantityStepper: ({ value, defaultValue, onValueChange, min, max, step, size, variant, removable, onRemove, disabled, itemLabel, "data-testid": testId, }: QuantityStepperProps) => import("react/jsx-runtime").JSX.Element;
+export default QuantityStepper;

package/dist/Components/QuantityStepper/QuantityStepper.js

@@ -0,0 +1,63 @@
+"use strict";
+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 lucide_react_1 = require("lucide-react");
+const useCustomTheme_1 = require("../../Theme/useCustomTheme");
+const typography_1 = require("../../Theme/tokens/primitives/typography");
+const controlSizes_1 = require("../../Theme/tokens/primitives/controlSizes");
+const motion_1 = require("../../Theme/tokens/primitives/motion");
+const borderWidths_1 = require("../../Theme/tokens/primitives/borderWidths");
+const motion_2 = require("../../Theme/chakra/motion");
+const focusRing_styles_1 = require("../../Theme/chakra/focusRing.styles");
+const tonalHover_1 = require("../CheckoutKit/tonalHover");
+const MIN_HIT = "2.75rem";
+const LIMIT_OPACITY = 0.4;
+const clamp = (n, min, max) => Math.max(min, max === undefined ? n : Math.min(max, n));
+/** Pill stepper for quantities: soft or outline, trash at the floor on cart lines, limits announced via aria-disabled. */
+const QuantityStepper = ({ value, defaultValue, onValueChange, min = 1, max, step = 1, size = "md", variant = "soft", removable = false, onRemove, disabled = false, itemLabel, "data-testid": testId, }) => {
+    const { colors } = (0, useCustomTheme_1.useCustomTheme)();
+    const spec = controlSizes_1.BUTTON_SIZES[size];
+    const [inner, setInner] = (0, react_1.useState)(defaultValue !== null && defaultValue !== void 0 ? defaultValue : min);
+    const current = value !== null && value !== void 0 ? value : inner;
+    const atMin = current <= min;
+    const atMax = max !== undefined && current >= max;
+    const trash = removable && atMin;
+    const subject = itemLabel ? ` of ${itemLabel}` : "";
+    const change = (direction) => {
+        const next = clamp(current + direction * step, min, max);
+        if (next === current)
+            return;
+        if (value === undefined)
+            setInner(next);
+        onValueChange === null || onValueChange === void 0 ? void 0 : onValueChange(next);
+    };
+    const surface = variant === "outline"
+        ? { bg: "transparent", boxShadow: `inset 0 0 0 ${borderWidths_1.BORDER_WIDTHS.hairline} ${colors.boxborder[500]}` }
+        : { bg: colors.background[100], boxShadow: "none" };
+    const hoverFill = (0, tonalHover_1.tonalHover)(colors, variant === "outline" ? colors.background[50] : colors.background[100]);
+    const button = (kind) => {
+        const limited = kind === "dec" ? atMin && !trash : atMax;
+        const Icon = kind === "inc" ? lucide_react_1.Plus : trash ? lucide_react_1.Trash2 : lucide_react_1.Minus;
+        const label = kind === "inc" ? `Increase quantity${subject}` : trash ? `Remove${itemLabel ? ` ${itemLabel}` : ""}` : `Decrease quantity${subject}`;
+        return ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", "aria-label": label, "aria-disabled": limited || undefined, disabled: disabled, "data-testid": testId ? `${testId}-${kind}` : undefined, onClick: () => {
+                if (limited)
+                    return;
+                if (kind === "dec" && trash)
+                    onRemove === null || onRemove === void 0 ? void 0 : onRemove();
+                else
+                    change(kind === "inc" ? 1 : -1);
+            }, position: "relative", display: "inline-flex", alignItems: "center", justifyContent: "center", flexShrink: 0, boxSize: spec.height, borderRadius: "full", color: colors.header[900], opacity: limited || disabled ? LIMIT_OPACITY : 1, cursor: limited || disabled ? "not-allowed" : "pointer", transition: (0, motion_1.transitionFor)(["background-color", "transform", "opacity"]), _hover: limited || disabled ? undefined : { bg: hoverFill }, _active: limited || disabled ? undefined : { transform: "scale(0.96)" }, sx: {
+                ...(0, focusRing_styles_1.focusVisibleStyles)(colors),
+                ...(0, motion_2.reducedMotionSx)({ "&:active": { transform: "none" } }),
+                "&::before": {
+                    content: '""',
+                    position: "absolute",
+                    inset: `max(0px, calc((${MIN_HIT} - ${spec.height}) / -2))`,
+                },
+            }, children: (0, jsx_runtime_1.jsx)(Icon, { size: spec.iconSize, "aria-hidden": true }) }));
+    };
+    return ((0, jsx_runtime_1.jsxs)(react_2.Flex, { role: "group", "aria-label": `Quantity${subject}`, display: "inline-flex", align: "center", h: spec.height, borderRadius: "full", ...surface, "data-testid": testId, children: [button("dec"), (0, jsx_runtime_1.jsx)(react_2.Text, { as: "span", "aria-live": "polite", "aria-atomic": "true", minW: "1.75rem", textAlign: "center", fontSize: spec.fontSize, fontWeight: 600, color: colors.header[900], sx: typography_1.NUMERIC_TEXT, children: current }), button("inc")] }));
+};
+exports.default = QuantityStepper;