@campxdev/react-blueprint 3.0.0-alpha.4 → 3.0.0-alpha.6

package/dist/styles.css

@@ -1,7 +1,7 @@
 /*! tailwindcss v4.1.17 | MIT License | https://tailwindcss.com */
-@import url('https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&display=swap');
 @layer properties;
 @layer theme, base, components, utilities;
+@import url('https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&display=swap');
 @layer theme {
   :root, :host {
     --font-sans: ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji",
@@ -46,6 +46,7 @@
     --color-pink-400: oklch(71.8% 0.202 349.761);
     --color-pink-700: oklch(52.5% 0.223 3.958);
     --color-pink-950: oklch(28.4% 0.109 3.907);
+    --color-gray-50: oklch(98.5% 0.002 247.839);
     --color-gray-200: oklch(92.8% 0.006 264.531);
     --color-gray-300: oklch(87.2% 0.01 258.338);
     --color-gray-500: oklch(55.1% 0.027 264.364);
@@ -94,6 +95,7 @@
     --ease-in: cubic-bezier(0.4, 0, 1, 1);
     --ease-out: cubic-bezier(0, 0, 0.2, 1);
     --ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
+    --animate-spin: spin 1s linear infinite;
     --animate-pulse: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
     --aspect-video: 16 / 9;
     --default-transition-duration: 150ms;
@@ -333,6 +335,9 @@
   .relative {
     position: relative;
   }
+  .static {
+    position: static;
+  }
   .inset-0 {
     inset: calc(var(--spacing) * 0);
   }
@@ -411,9 +416,6 @@
   .left-\[50\%\] {
     left: 50%;
   }
-  .z-1 {
-    z-index: 1;
-  }
   .z-50 {
     z-index: 50;
   }
@@ -423,18 +425,9 @@
   .z-\[1000\] {
     z-index: 1000;
   }
-  .z-\[1299\] {
-    z-index: 1299;
-  }
-  .z-\[1300\] {
-    z-index: 1300;
-  }
   .z-\[1500\] {
     z-index: 1500;
   }
-  .z-\[2000\] {
-    z-index: 2000;
-  }
   .z-\[9999\] {
     z-index: 9999;
   }
@@ -806,6 +799,9 @@
   .min-h-\[60px\] {
     min-height: 60px;
   }
+  .min-h-screen {
+    min-height: 100vh;
+  }
   .w-\(--cell-size\) {
     width: var(--cell-size);
   }
@@ -1061,6 +1057,9 @@
   .animate-pulse {
     animation: var(--animate-pulse);
   }
+  .animate-spin {
+    animation: var(--animate-spin);
+  }
   .cursor-default {
     cursor: default;
   }
@@ -1379,6 +1378,9 @@
   .border-\(--color-border\) {
     border-color: var(--color-border);
   }
+  .border-blue-500 {
+    border-color: var(--color-blue-500);
+  }
   .border-blue-700 {
     border-color: var(--color-blue-700);
   }
@@ -1466,12 +1468,18 @@
   .bg-foreground {
     background-color: var(--foreground);
   }
+  .bg-gray-50 {
+    background-color: var(--color-gray-50);
+  }
   .bg-gray-200 {
     background-color: var(--color-gray-200);
   }
   .bg-green-50 {
     background-color: var(--color-green-50);
   }
+  .bg-green-500 {
+    background-color: var(--color-green-500);
+  }
   .bg-green-background {
     background-color: var(--green-background);
   }
@@ -1541,6 +1549,9 @@
   .bg-transparent {
     background-color: transparent;
   }
+  .bg-white {
+    background-color: var(--color-white);
+  }
   .bg-yellow-50 {
     background-color: var(--color-yellow-50);
   }
@@ -1649,6 +1660,12 @@
   .py-6 {
     padding-block: calc(var(--spacing) * 6);
   }
+  .py-8 {
+    padding-block: calc(var(--spacing) * 8);
+  }
+  .py-12 {
+    padding-block: calc(var(--spacing) * 12);
+  }
   .py-\[0\.2rem\] {
     padding-block: 0.2rem;
   }
@@ -1823,6 +1840,9 @@
   .break-all {
     word-break: break-all;
   }
+  .text-ellipsis {
+    text-overflow: ellipsis;
+  }
   .whitespace-nowrap {
     white-space: nowrap;
   }
@@ -1889,6 +1909,9 @@
   .text-highlight-yellow {
     color: var(--highlight-yellow);
   }
+  .text-muted {
+    color: var(--muted);
+  }
   .text-muted-foreground {
     color: var(--muted-foreground);
   }
@@ -3666,6 +3689,11 @@
       translate: var(--tw-translate-x) var(--tw-translate-y);
     }
   }
+  .\[\&\>button\]\:hidden {
+    &>button {
+      display: none;
+    }
+  }
   .\[\&\>div\]\:\!aspect-auto {
     &>div {
       aspect-ratio: auto !important;
@@ -3880,6 +3908,7 @@
   --yellow-background: oklch(0.82 0.166 94.2 / 0.2);
   --default-background: oklch(0.978 0.004 233.756);
   --input-background: oklch(0.953 0.002 264);
+  --font-sans: 'Geist', ui-sans-serif, system-ui, sans-serif;
 }
 .dark {
   --background: oklch(0.145 0 0);
@@ -3928,6 +3957,7 @@
   --yellow-background: oklch(0.82 0.166 94.2 / 0.2);
   --default-background: oklch(0.154 0.013 233.756);
   --input-background: oklch(0.215 0.008 264);
+  --font-sans: 'Geist', ui-sans-serif, system-ui, sans-serif;
 }
 @layer base {
   * {
@@ -3944,6 +3974,7 @@
   body {
     height: 100%;
     overflow: auto;
+    -webkit-font-smoothing: antialiased;
     background-color: var(--background);
     font-family: var(--font-sans);
     color: var(--foreground);
@@ -4045,6 +4076,359 @@
     transform: scale(0.95);
   }
 }
+.react-joyride__tooltip {
+  background-color: #ffffff !important;
+  border-radius: 12px !important;
+  box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04) !important;
+  border: 1px solid #f3f4f6 !important;
+  font-family: 'Roboto', -apple-system, BlinkMacSystemFont, sans-serif !important;
+  padding-top: 16px !important;
+}
+.react-joyride__tooltip div {
+  text-align: left !important;
+}
+.react-joyride__tooltip > div:nth-child(1) div:nth-child(2) {
+  padding: 0 !important;
+  font-size: 14px !important;
+  line-height: 1.5 !important;
+  color: #4b5563 !important;
+}
+.react-joyride__tooltip button[data-action="skip"] {
+  top: 16px !important;
+  right: 16px !important;
+}
+.react-joyride__beacon {
+  background-color: #3b82f6 !important;
+  border: 3px solid #3b82f6 !important;
+  border-radius: 50% !important;
+  box-shadow: 0 0 0 6px rgba(59, 130, 246, 0.2) !important;
+}
+.react-joyride__beacon::before {
+  background-color: #3b82f6 !important;
+  animation: joyride-beacon-pulse 1.5s ease-in-out infinite !important;
+}
+.react-joyride__tooltip button[data-action="next"]:hover {
+  background-color: #000000 !important;
+  transform: translateY(-1px) !important;
+}
+.react-joyride__tooltip button[data-action="back"]:hover {
+  background-color: #f9fafb !important;
+  border-color: #d1d5db !important;
+}
+.react-joyride__tooltip button[data-action="skip"]:hover {
+  background-color: #f3f4f6 !important;
+  color: #374151 !important;
+}
+.react-joyride__tooltip .react-joyride__tooltip-footer {
+  margin-top: 16px !important;
+  padding-top: 16px !important;
+  border-top: 1px solid #f3f4f6 !important;
+}
+.react-joyride__tooltip-arrow {
+  filter: drop-shadow(0 1px 3px rgba(0, 0, 0, 0.1)) !important;
+}
+@keyframes joyride-beacon-pulse {
+  0% {
+    transform: scale(1);
+    opacity: 1;
+  }
+  50% {
+    transform: scale(1.2);
+    opacity: 0.7;
+  }
+  100% {
+    transform: scale(1);
+    opacity: 1;
+  }
+}
+.buttonLoader {
+  max-height: 40px;
+  padding: 10px 20px;
+  font-size: '14px';
+  aspect-ratio: 2.5;
+  --_g: no-repeat radial-gradient(circle, currentColor 48%, #0000);
+  background: var(--_g), var(--_g), var(--_g), var(--_g);
+  background-size: 15% 40%;
+  animation: l44 1s infinite linear alternate;
+  scale: 0.5;
+}
+@keyframes l44 {
+  0%,
+  5% {
+    background-position: calc(0 * 100% / 3) 50%, calc(1 * 100% / 3) 50%,
+      calc(2 * 100% / 3) 50%, calc(3 * 100% / 3) 50%;
+  }
+  12.5% {
+    background-position: calc(0 * 100% / 3) 0, calc(1 * 100% / 3) 50%,
+      calc(2 * 100% / 3) 50%, calc(3 * 100% / 3) 50%;
+  }
+  25% {
+    background-position: calc(0 * 100% / 3) 0, calc(1 * 100% / 3) 0,
+      calc(2 * 100% / 3) 50%, calc(3 * 100% / 3) 50%;
+  }
+  37.5% {
+    background-position: calc(0 * 100% / 3) 100%, calc(1 * 100% / 3) 0,
+      calc(2 * 100% / 3) 0, calc(3 * 100% / 3) 50%;
+  }
+  50% {
+    background-position: calc(0 * 100% / 3) 100%, calc(1 * 100% / 3) 100%,
+      calc(2 * 100% / 3) 0, calc(3 * 100% / 3) 0;
+  }
+  62.5% {
+    background-position: calc(0 * 100% / 3) 50%, calc(1 * 100% / 3) 100%,
+      calc(2 * 100% / 3) 100%, calc(3 * 100% / 3) 0;
+  }
+  75% {
+    background-position: calc(0 * 100% / 3) 50%, calc(1 * 100% / 3) 50%,
+      calc(2 * 100% / 3) 100%, calc(3 * 100% / 3) 100%;
+  }
+  87.5% {
+    background-position: calc(0 * 100% / 3) 50%, calc(1 * 100% / 3) 50%,
+      calc(2 * 100% / 3) 50%, calc(3 * 100% / 3) 100%;
+  }
+  95%,
+  100% {
+    background-position: calc(0 * 100% / 3) 50%, calc(1 * 100% / 3) 50%,
+      calc(2 * 100% / 3) 50%, calc(3 * 100% / 3) 50%;
+  }
+}
+.calendar-wrapper .fc {
+  height: 100%;
+  font-family: inherit;
+  font-size: 0.875rem;
+}
+.calendar-wrapper .fc-header-toolbar {
+  background-color: var(--background);
+  padding: 1rem;
+  margin: 0 !important;
+  border-bottom: 1px solid var(--border);
+}
+.calendar-wrapper .fc-toolbar-chunk {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+.calendar-wrapper .fc-button-group {
+  display: inline-flex;
+}
+.calendar-wrapper .fc-button {
+  border: 1px solid var(--border);
+  background-color: transparent;
+  color: var(--foreground);
+  font-size: 0.875rem;
+  font-weight: 500;
+  height: auto;
+  padding: 0.25rem 1rem;
+  border-radius: 0.375rem;
+  cursor: pointer;
+  text-transform: capitalize;
+}
+.calendar-wrapper .fc-button:hover {
+  background-color: var(--muted);
+  color: var(--primary);
+  border: 1px solid var(--border);
+}
+.calendar-wrapper .fc-button:focus {
+  box-shadow: none !important;
+}
+.calendar-wrapper .fc-button:disabled {
+  opacity: 0.5;
+  pointer-events: none;
+}
+.calendar-wrapper .fc-toolbar-title {
+  color: var(--foreground);
+  font-size: 1.25rem;
+  font-weight: 600;
+  margin: 0;
+}
+.calendar-wrapper .fc-col-header {
+  background-color: var(--muted);
+  border-bottom: 1px solid var(--border);
+}
+.calendar-wrapper .fc-col-header-cell {
+  padding: 0.5rem;
+}
+.calendar-wrapper .fc-col-header-cell-cushion {
+  color: var(--muted-foreground);
+  font-weight: 600;
+  text-decoration: none;
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.025em;
+}
+.calendar-wrapper .fc-daygrid-day {
+  background-color: var(--background);
+  border-color: var(--border);
+}
+.calendar-wrapper .fc-day-today {
+  background-color: var(--primary) !important;
+  @supports (color: color-mix(in lab, red, red)) {
+    background-color: color-mix(
+    in oklch,
+    var(--primary) 5%,
+    transparent
+  ) !important;
+  }
+}
+.calendar-wrapper .fc-daygrid-day-number {
+  color: var(--foreground);
+  text-decoration: none;
+  padding: 0.25rem 0.5rem;
+  font-size: 0.875rem;
+  transition: all 0.2s;
+}
+.calendar-wrapper .fc-daygrid-day-number:hover {
+  background-color: var(--muted);
+  border-radius: 0.25rem;
+}
+.calendar-wrapper .fc-daygrid-day-top {
+  display: flex;
+  justify-content: flex-end;
+  padding: 0.25rem;
+}
+.calendar-wrapper .fc-event {
+  background-color: var(--primary);
+  border-color: var(--primary);
+  color: var(--primary-foreground);
+  border-radius: 0.25rem;
+  border: none;
+  transition: all 0.2s;
+  cursor: pointer;
+}
+.calendar-wrapper .fc-event:hover {
+  background-color: var(--primary);
+  @supports (color: color-mix(in lab, red, red)) {
+    background-color: color-mix(in oklch, var(--primary) 90%, transparent);
+  }
+}
+.calendar-wrapper .fc-event-title,
+.calendar-wrapper .fc-event-time {
+  padding: 0.125rem 0.25rem;
+}
+.calendar-wrapper .fc-timegrid-slot {
+  border-color: var(--border);
+}
+.calendar-wrapper .fc-timegrid-col.fc-day-today {
+  background-color: var(--primary);
+  @supports (color: color-mix(in lab, red, red)) {
+    background-color: color-mix(in oklch, var(--primary) 3%, transparent);
+  }
+}
+.calendar-wrapper .fc-timegrid-axis {
+  color: var(--muted-foreground);
+}
+.calendar-wrapper .fc-timegrid-slot-label {
+  color: var(--muted-foreground);
+  font-size: 0.75rem;
+}
+.calendar-wrapper .fc-list {
+  border-color: var(--border);
+}
+.calendar-wrapper .fc-list-day {
+  background-color: var(--muted);
+}
+.calendar-wrapper .fc-list-day-cushion {
+  color: var(--foreground);
+  font-weight: 600;
+}
+.calendar-wrapper .fc-list-event {
+  border-color: var(--border);
+  transition: all 0.2s;
+}
+.calendar-wrapper .fc-list-event:hover {
+  background-color: var(--muted);
+  @supports (color: color-mix(in lab, red, red)) {
+    background-color: color-mix(in oklch, var(--muted) 50%, transparent);
+  }
+}
+.calendar-wrapper .fc-list-event-title {
+  color: var(--foreground);
+}
+.calendar-wrapper .fc-list-event-time {
+  color: var(--muted-foreground);
+}
+.calendar-wrapper .fc-more-link {
+  color: var(--primary);
+  font-weight: 500;
+}
+.calendar-wrapper .fc-more-link:hover {
+  color: var(--primary);
+  @supports (color: color-mix(in lab, red, red)) {
+    color: color-mix(in oklch, var(--primary) 90%, transparent);
+  }
+}
+.calendar-wrapper .fc-popover {
+  background-color: var(--background);
+  border: 1px solid var(--border);
+  border-radius: 0.5rem;
+  box-shadow: 0 10px 15px -3px rgb(0 0 0 / 0.1), 0 4px 6px -4px rgb(0 0 0 / 0.1);
+}
+.calendar-wrapper .fc-popover-header {
+  background-color: var(--muted);
+  border-bottom: 1px solid var(--border);
+  padding: 0.5rem 0.75rem;
+}
+.calendar-wrapper .fc-popover-title {
+  color: var(--foreground);
+  font-weight: 600;
+}
+.calendar-wrapper .fc-popover-close {
+  color: var(--muted-foreground);
+  cursor: pointer;
+}
+.calendar-wrapper .fc-popover-close:hover {
+  color: var(--foreground);
+}
+.calendar-wrapper .fc-scroller::-webkit-scrollbar {
+  width: 6px;
+  height: 6px;
+}
+.calendar-wrapper .fc-scroller::-webkit-scrollbar-track {
+  background-color: var(--muted);
+  border-radius: 3px;
+}
+.calendar-wrapper .fc-scroller::-webkit-scrollbar-thumb {
+  background-color: var(--border);
+  border-radius: 3px;
+}
+.calendar-wrapper .fc-scroller::-webkit-scrollbar-thumb:hover {
+  background-color: var(--muted-foreground);
+}
+.calendar-wrapper .fc-theme-standard td,
+.calendar-wrapper .fc-theme-standard th {
+  border-color: var(--border);
+}
+.calendar-wrapper .fc-theme-standard .fc-scrollgrid {
+  border-color: var(--border);
+}
+.calendar-wrapper .fc-timegrid-now-indicator-line {
+  border-color: var(--destructive);
+}
+.calendar-wrapper .fc-timegrid-now-indicator-arrow {
+  border-color: var(--destructive);
+}
+@media (max-width: 768px) {
+  .calendar-wrapper .fc-header-toolbar {
+    flex-direction: column;
+    gap: 0.5rem;
+  }
+  .calendar-wrapper .fc-toolbar-chunk {
+    width: 100%;
+    justify-content: center;
+  }
+  .calendar-wrapper .fc-button {
+    padding: 0.25rem 0.5rem;
+    font-size: 0.75rem;
+  }
+}
+@media (max-width: 640px) {
+  .calendar-wrapper .fc-event {
+    font-size: 0.7rem;
+  }
+  .calendar-wrapper .fc-daygrid-day-number {
+    font-size: 0.75rem;
+  }
+}
 @property --tw-translate-x {
   syntax: "*";
   inherits: false;
@@ -4305,6 +4689,11 @@
   initial-value: "";
   inherits: false;
 }
+@keyframes spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
 @keyframes pulse {
   50% {
     opacity: 0.5;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@campxdev/react-blueprint",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.6",
   "description": "React UI component library for CampX applications",
   "author": "CampX",
   "license": "MIT",

package/src/components/Assets/ErrorPages/ComingSoon.tsx

@@ -8,6 +8,30 @@ interface NoItemFoundProps {
   description: ReactNode;
 }
 
+/**
+ * ComingSoon component displays a "Coming Soon" placeholder page.
+ *
+ * This component renders a centered container with an SVG illustration,
+ * a title, and a description message to inform users that a feature or page
+ * is not yet available.
+ *
+ * @component
+ * @param {Object} props - The component props
+ * @param {string} [props.title='Coming Soon'] - The title text to display. Defaults to "Coming Soon"
+ * @param {ReactNode} props.description - The description or message to display below the title
+ * @returns {React.ReactElement} A centered layout with SVG, title, and description
+ *
+ * @example
+ * // Basic usage
+ * <ComingSoon description="This feature will be available soon!" />
+ *
+ * @example
+ * // With custom title
+ * <ComingSoon
+ *   title="New Dashboard"
+ *   description="We're working hard to bring you an improved dashboard experience."
+ * />
+ */
 export const ComingSoon = ({
   title = 'Coming Soon',
   description,

package/src/components/Assets/ErrorPages/InternalServerError.tsx

@@ -2,6 +2,26 @@ import { Svgs } from '../../../assets/images/svg';
 import { Typography } from '../../DataDisplay/Typography/Typography';
 import { Button } from '../../Input/Button/Button';
 
+/**
+ * InternalServerError component displays a 500 server error page.
+ *
+ * This component renders a centered error page with an SVG illustration,
+ * error message, and a "Try Again" button that triggers the error boundary reset.
+ * Typically used within an error boundary to handle unexpected server errors.
+ *
+ * @component
+ * @param {Object} props - The component props
+ * @param {Function} props.resetBoundary - Callback function to reset the error boundary and retry the operation
+ * @returns {React.ReactElement} A centered error page with icon, message, and retry button
+ *
+ * @example
+ * // Usage within an error boundary
+ * <InternalServerError resetBoundary={() => window.location.reload()} />
+ *
+ * @example
+ * // Usage with custom reset logic
+ * <InternalServerError resetBoundary={handleRetry} />
+ */
 export const InternalServerError = ({ resetBoundary }: any) => {
   return (
     <div className="flex w-full flex-col items-center justify-center">

package/src/components/Assets/ErrorPages/NoInternetConnection.tsx

@@ -2,6 +2,26 @@ import { Svgs } from '../../../assets/images/svg';
 import { Typography } from '../../DataDisplay/Typography/Typography';
 import { Button } from '../../Input/Button/Button';
 
+/**
+ * NoInterneConnection component displays a "No Internet Connection" error page.
+ *
+ * This component renders a centered error page with an SVG illustration,
+ * a message informing the user of a lost internet connection, and a "Try Again" button.
+ * Useful for displaying when the application detects no network connectivity.
+ *
+ * @component
+ * @param {Object} props - The component props
+ * @param {Function} props.resetBoundary - Callback function to retry the connection or operation
+ * @returns {React.ReactElement} A centered offline error page with icon, message, and retry button
+ *
+ * @example
+ * // Display when network connection is lost
+ * <NoInterneConnection resetBoundary={handleRetry} />
+ *
+ * @example
+ * // With navigation reset
+ * <NoInterneConnection resetBoundary={() => window.location.reload()} />
+ */
 export const NoInterneConnection = ({ resetBoundary }: any) => {
   return (
     <div className="flex w-full flex-col items-center justify-center">

package/src/components/Assets/ErrorPages/NoItemFound.tsx

@@ -10,6 +10,34 @@ interface NoItemFoundProps {
   width?: string | number;
 }
 
+/**
+ * NoItemFound component displays a "No Items Found" placeholder page.
+ *
+ * This component renders a centered container with an empty state SVG illustration,
+ * a title, and a description. The SVG size can be customized with height and width props.
+ * Commonly used to indicate when a list, search results, or data collection is empty.
+ *
+ * @component
+ * @param {Object} props - The component props
+ * @param {string} [props.title='No Items Found'] - The title text to display. Defaults to "No Items Found"
+ * @param {ReactNode} props.description - The description or message to display below the title
+ * @param {string | number} [props.height] - The height of the SVG illustration
+ * @param {string | number} [props.width] - The width of the SVG illustration
+ * @returns {React.ReactElement} A centered layout with SVG, title, and description
+ *
+ * @example
+ * // Basic usage
+ * <NoItemFound description="Try adjusting your search criteria." />
+ *
+ * @example
+ * // With custom title and SVG dimensions
+ * <NoItemFound
+ *   title="No Results"
+ *   description="Your search didn't return any results."
+ *   width={200}
+ *   height={200}
+ * />
+ */
 export const NoItemFound = ({
   title = 'No Items Found',
   description,

package/src/components/Assets/ErrorPages/PageNotFound.tsx

@@ -1,6 +1,27 @@
 import { Svgs } from '../../../assets/images/svg';
 import { Typography } from '../../DataDisplay/Typography/Typography';
 
+/**
+ * PageNotFound component displays a 404 "Page Not Found" error page.
+ *
+ * This component renders a centered error page with an SVG illustration
+ * and informative messages to indicate that the requested page does not exist.
+ * Typically used as a fallback for invalid or missing routes.
+ *
+ * @component
+ * @returns {React.ReactElement} A centered 404 error page with icon and messages
+ *
+ * @example
+ * // Basic usage in routing
+ * <Route path="*" element={<PageNotFound />} />
+ *
+ * @example
+ * // As a fallback route
+ * <Routes>
+ *   <Route path="/" element={<Home />} />
+ *   <Route path="*" element={<PageNotFound />} />
+ * </Routes>
+ */
 export const PageNotFound = () => {
   return (
     <div className="flex w-full flex-col items-center justify-center">