@fabio.caffarello/react-design-system 1.7.0 → 1.8.0

package/src/ui/tokens/z-index.ts

@@ -0,0 +1,113 @@
+/**
+ * Z-Index Tokens
+ * 
+ * Centralized z-index system for consistent layering.
+ * Uses Factory Pattern for type-safe token creation.
+ */
+
+export type ZIndexLayer = 
+  | 'base' 
+  | 'dropdown' 
+  | 'sticky' 
+  | 'fixed' 
+  | 'modal-backdrop' 
+  | 'modal' 
+  | 'popover' 
+  | 'tooltip' 
+  | 'toast';
+
+export interface ZIndexToken {
+  value: number;
+  tailwind: string;
+  description: string;
+}
+
+/**
+ * Z-Index Token Factory
+ * Creates z-index tokens with consistent layering
+ */
+export class ZIndexTokenFactory {
+  /**
+   * Create a z-index token
+   */
+  static create(layer: ZIndexLayer): ZIndexToken {
+    const layerMap: Record<ZIndexLayer, { value: number; tailwind: string; description: string }> = {
+      base: {
+        value: 0,
+        tailwind: 'z-0',
+        description: 'Base layer for normal content',
+      },
+      dropdown: {
+        value: 1000,
+        tailwind: 'z-[1000]',
+        description: 'Dropdown menus and select options',
+      },
+      sticky: {
+        value: 1020,
+        tailwind: 'z-[1020]',
+        description: 'Sticky headers and navigation',
+      },
+      fixed: {
+        value: 1030,
+        tailwind: 'z-[1030]',
+        description: 'Fixed position elements',
+      },
+      'modal-backdrop': {
+        value: 1040,
+        tailwind: 'z-[1040]',
+        description: 'Modal backdrop/overlay',
+      },
+      modal: {
+        value: 1050,
+        tailwind: 'z-[1050]',
+        description: 'Modal dialogs and drawers',
+      },
+      popover: {
+        value: 1060,
+        tailwind: 'z-[1060]',
+        description: 'Popovers and tooltips',
+      },
+      tooltip: {
+        value: 1070,
+        tailwind: 'z-[1070]',
+        description: 'Tooltips (highest priority)',
+      },
+      toast: {
+        value: 1080,
+        tailwind: 'z-[1080]',
+        description: 'Toast notifications (highest priority)',
+      },
+    };
+
+    return layerMap[layer];
+  }
+}
+
+/**
+ * Pre-defined z-index tokens
+ */
+export const Z_INDEX_TOKENS = {
+  base: ZIndexTokenFactory.create('base'),
+  dropdown: ZIndexTokenFactory.create('dropdown'),
+  sticky: ZIndexTokenFactory.create('sticky'),
+  fixed: ZIndexTokenFactory.create('fixed'),
+  'modal-backdrop': ZIndexTokenFactory.create('modal-backdrop'),
+  modal: ZIndexTokenFactory.create('modal'),
+  popover: ZIndexTokenFactory.create('popover'),
+  tooltip: ZIndexTokenFactory.create('tooltip'),
+  toast: ZIndexTokenFactory.create('toast'),
+} as const;
+
+/**
+ * Helper function to get z-index token
+ */
+export function getZIndex(layer: ZIndexLayer): ZIndexToken {
+  return ZIndexTokenFactory.create(layer);
+}
+
+/**
+ * Helper function to get z-index as Tailwind class
+ */
+export function getZIndexClass(layer: ZIndexLayer): string {
+  return ZIndexTokenFactory.create(layer).tailwind;
+}

package/src/ui/utils/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Utils Module
+ * 
+ * Shared utilities and helper functions for the design system.
+ */
+
+// Placeholder for future utilities
+// Export utilities here as they are created
+
+export {};

package/src/App.css

@@ -1,42 +0,0 @@
-#root {
-  max-width: 1280px;
-  margin: 0 auto;
-  padding: 2rem;
-  text-align: center;
-}
-
-.logo {
-  height: 6em;
-  padding: 1.5em;
-  will-change: filter;
-  transition: filter 300ms;
-}
-.logo:hover {
-  filter: drop-shadow(0 0 2em #646cffaa);
-}
-.logo.react:hover {
-  filter: drop-shadow(0 0 2em #61dafbaa);
-}
-
-@keyframes logo-spin {
-  from {
-    transform: rotate(0deg);
-  }
-  to {
-    transform: rotate(360deg);
-  }
-}
-
-@media (prefers-reduced-motion: no-preference) {
-  a:nth-of-type(2) .logo {
-    animation: logo-spin infinite 20s linear;
-  }
-}
-
-.card {
-  padding: 2em;
-}
-
-.read-the-docs {
-  color: #888;
-}

package/src/App.tsx

@@ -1,35 +0,0 @@
-import { useState } from "react";
-import reactLogo from "./assets/react.svg";
-import viteLogo from "/vite.svg";
-import "./App.css";
-
-function App() {
-  const [count, setCount] = useState(0);
-
-  return (
-    <>
-      <div>
-        <a href="https://vite.dev" target="_blank">
-          <img src={viteLogo} className="logo" alt="Vite logo" />
-        </a>
-        <a href="https://react.dev" target="_blank">
-          <img src={reactLogo} className="logo react" alt="React logo" />
-        </a>
-      </div>
-      <h1>Vite + React</h1>
-      <div className="card">
-        <button onClick={() => setCount((count) => count + 1)}>
-          count is {count}
-        </button>
-        <p>
-          Edit <code>src/App.tsx</code> and save to test HMR
-        </p>
-      </div>
-      <p className="read-the-docs">
-        Click on the Vite and React logos to learn more
-      </p>
-    </>
-  );
-}
-
-export default App;

package/src/index.css

@@ -1,68 +0,0 @@
-:root {
-  font-family: system-ui, Avenir, Helvetica, Arial, sans-serif;
-  line-height: 1.5;
-  font-weight: 400;
-
-  color-scheme: light dark;
-  color: rgba(255, 255, 255, 0.87);
-  background-color: #242424;
-
-  font-synthesis: none;
-  text-rendering: optimizeLegibility;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
-}
-
-a {
-  font-weight: 500;
-  color: #646cff;
-  text-decoration: inherit;
-}
-a:hover {
-  color: #535bf2;
-}
-
-body {
-  margin: 0;
-  display: flex;
-  place-items: center;
-  min-width: 320px;
-  min-height: 100vh;
-}
-
-h1 {
-  font-size: 3.2em;
-  line-height: 1.1;
-}
-
-button {
-  border-radius: 8px;
-  border: 1px solid transparent;
-  padding: 0.6em 1.2em;
-  font-size: 1em;
-  font-weight: 500;
-  font-family: inherit;
-  background-color: #1a1a1a;
-  cursor: pointer;
-  transition: border-color 0.25s;
-}
-button:hover {
-  border-color: #646cff;
-}
-button:focus,
-button:focus-visible {
-  outline: 4px auto -webkit-focus-ring-color;
-}
-
-@media (prefers-color-scheme: light) {
-  :root {
-    color: #213547;
-    background-color: #ffffff;
-  }
-  a:hover {
-    color: #747bff;
-  }
-  button {
-    background-color: #f9f9f9;
-  }
-}

package/src/main.tsx

@@ -1,15 +0,0 @@
-import { StrictMode } from "react";
-import { createRoot } from "react-dom/client";
-import "./style.css";
-import App from "./App.tsx";
-import { Info } from "@ui";
-
-createRoot(document.getElementById("root")!).render(
-  <StrictMode>
-    <Info variant={"error"}> This is an error message</Info>
-    <Info variant={"warning"}> This is a warning message</Info>
-    <Info variant={"info"}> This is an info message</Info>
-    <Info> This is a default info component</Info>
-    <App />
-  </StrictMode>,
-);