@noambz/ui 0.7.0

package/dist/utils/pagination.d.ts

@@ -0,0 +1,34 @@
+export interface IPaginationParams {
+    page: number;
+    pageSize: number;
+}
+/**
+ * Parse and clamp pagination query parameters. Returns safe defaults for
+ * missing or malformed values. `pageSize` is capped at `MAX_PAGE_SIZE` to
+ * protect the backend from runaway queries.
+ */
+export declare function parsePaginationParams(params: {
+    page?: string | number | null;
+    pageSize?: string | number | null;
+    defaultPageSize?: number;
+    maxPageSize?: number;
+}): IPaginationParams;
+export interface IPaginatedSlice<TItem> {
+    items: TItem[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+/**
+ * Build a paginated response envelope from a total-count + items pair.
+ * Does not perform the slicing itself — assumes the caller has already
+ * queried the correct page from the data source.
+ */
+export declare function buildPaginatedResponse<TItem>(params: {
+    items: TItem[];
+    total: number;
+    page: number;
+    pageSize: number;
+}): IPaginatedSlice<TItem>;
+//# sourceMappingURL=pagination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,iBAAiB,CAcpB;AAED,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE;IACpD,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,eAAe,CAAC,KAAK,CAAC,CASzB"}

package/dist/utils/pagination.js

@@ -0,0 +1,28 @@
+const DEFAULT_PAGE = 1;
+const DEFAULT_PAGE_SIZE = 20;
+const MAX_PAGE_SIZE = 100;
+const MIN_PAGE = 1;
+function parsePaginationParams(params) {
+  const max = params.maxPageSize ?? MAX_PAGE_SIZE;
+  const defaultSize = params.defaultPageSize ?? DEFAULT_PAGE_SIZE;
+  const rawPage = Number(params.page ?? DEFAULT_PAGE);
+  const page = Number.isFinite(rawPage) && rawPage >= MIN_PAGE ? Math.floor(rawPage) : DEFAULT_PAGE;
+  const rawSize = Number(params.pageSize ?? defaultSize);
+  const pageSize = Number.isFinite(rawSize) && rawSize >= MIN_PAGE ? Math.min(Math.floor(rawSize), max) : defaultSize;
+  return { page, pageSize };
+}
+function buildPaginatedResponse(params) {
+  const totalPages = params.pageSize > 0 ? Math.max(1, Math.ceil(params.total / params.pageSize)) : 1;
+  return {
+    items: params.items,
+    total: params.total,
+    page: params.page,
+    pageSize: params.pageSize,
+    totalPages
+  };
+}
+export {
+  buildPaginatedResponse,
+  parsePaginationParams
+};
+//# sourceMappingURL=pagination.js.map

package/dist/utils/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/pagination.ts"],"sourcesContent":["const DEFAULT_PAGE = 1;\nconst DEFAULT_PAGE_SIZE = 20;\nconst MAX_PAGE_SIZE = 100;\nconst MIN_PAGE = 1;\n\nexport interface IPaginationParams {\n  page: number;\n  pageSize: number;\n}\n\n/**\n * Parse and clamp pagination query parameters. Returns safe defaults for\n * missing or malformed values. `pageSize` is capped at `MAX_PAGE_SIZE` to\n * protect the backend from runaway queries.\n */\nexport function parsePaginationParams(params: {\n  page?: string | number | null;\n  pageSize?: string | number | null;\n  defaultPageSize?: number;\n  maxPageSize?: number;\n}): IPaginationParams {\n  const max = params.maxPageSize ?? MAX_PAGE_SIZE;\n  const defaultSize = params.defaultPageSize ?? DEFAULT_PAGE_SIZE;\n\n  const rawPage = Number(params.page ?? DEFAULT_PAGE);\n  const page = Number.isFinite(rawPage) && rawPage >= MIN_PAGE ? Math.floor(rawPage) : DEFAULT_PAGE;\n\n  const rawSize = Number(params.pageSize ?? defaultSize);\n  const pageSize =\n    Number.isFinite(rawSize) && rawSize >= MIN_PAGE\n      ? Math.min(Math.floor(rawSize), max)\n      : defaultSize;\n\n  return { page, pageSize };\n}\n\nexport interface IPaginatedSlice<TItem> {\n  items: TItem[];\n  total: number;\n  page: number;\n  pageSize: number;\n  totalPages: number;\n}\n\n/**\n * Build a paginated response envelope from a total-count + items pair.\n * Does not perform the slicing itself — assumes the caller has already\n * queried the correct page from the data source.\n */\nexport function buildPaginatedResponse<TItem>(params: {\n  items: TItem[];\n  total: number;\n  page: number;\n  pageSize: number;\n}): IPaginatedSlice<TItem> {\n  const totalPages = params.pageSize > 0 ? Math.max(1, Math.ceil(params.total / params.pageSize)) : 1;\n  return {\n    items: params.items,\n    total: params.total,\n    page: params.page,\n    pageSize: params.pageSize,\n    totalPages,\n  };\n}\n"],"mappings":"AAAA,MAAM,eAAe;AACrB,MAAM,oBAAoB;AAC1B,MAAM,gBAAgB;AACtB,MAAM,WAAW;AAYV,SAAS,sBAAsB,QAKhB;AACpB,QAAM,MAAM,OAAO,eAAe;AAClC,QAAM,cAAc,OAAO,mBAAmB;AAE9C,QAAM,UAAU,OAAO,OAAO,QAAQ,YAAY;AAClD,QAAM,OAAO,OAAO,SAAS,OAAO,KAAK,WAAW,WAAW,KAAK,MAAM,OAAO,IAAI;AAErF,QAAM,UAAU,OAAO,OAAO,YAAY,WAAW;AACrD,QAAM,WACJ,OAAO,SAAS,OAAO,KAAK,WAAW,WACnC,KAAK,IAAI,KAAK,MAAM,OAAO,GAAG,GAAG,IACjC;AAEN,SAAO,EAAE,MAAM,SAAS;AAC1B;AAeO,SAAS,uBAA8B,QAKnB;AACzB,QAAM,aAAa,OAAO,WAAW,IAAI,KAAK,IAAI,GAAG,KAAK,KAAK,OAAO,QAAQ,OAAO,QAAQ,CAAC,IAAI;AAClG,SAAO;AAAA,IACL,OAAO,OAAO;AAAA,IACd,OAAO,OAAO;AAAA,IACd,MAAM,OAAO;AAAA,IACb,UAAU,OAAO;AAAA,IACjB;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,148 @@
+{
+  "name": "@noambz/ui",
+  "version": "0.7.0",
+  "description": "Shared React UI library: atomic design system, Tailwind v4 tokens, Radix primitives, Storybook docs. Built for Next.js 16 + React 19.",
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist",
+    "src/styles/theme.css"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "import": "./dist/components/index.js",
+      "default": "./dist/components/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.js",
+      "default": "./dist/hooks/index.js"
+    },
+    "./i18n": {
+      "types": "./dist/i18n/index.d.ts",
+      "import": "./dist/i18n/index.js",
+      "default": "./dist/i18n/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "default": "./dist/utils/index.js"
+    },
+    "./styles/theme.css": "./src/styles/theme.css",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.json --emitDeclarationOnly",
+    "build:js": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build",
+    "verify": "npm run typecheck && npm run lint && npm run test && npm run build",
+    "prepublishOnly": "npm run verify"
+  },
+  "keywords": [
+    "ui",
+    "react",
+    "nextjs",
+    "tailwind",
+    "radix",
+    "storybook",
+    "design-system",
+    "components"
+  ],
+  "author": "noambz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/noam-benzeev/ui.git"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": ">=5",
+    "next": ">=15",
+    "next-themes": ">=0.4",
+    "react": ">=19",
+    "react-dom": ">=19",
+    "react-hook-form": "^7.73.1",
+    "sonner": ">=1",
+    "zod": "^4.3.6"
+  },
+  "dependencies": {
+    "@radix-ui/react-accordion": "^1.2.12",
+    "@radix-ui/react-avatar": "^1.1.11",
+    "@radix-ui/react-checkbox": "^1.3.3",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-popover": "^1.1.15",
+    "@radix-ui/react-progress": "^1.1.8",
+    "@radix-ui/react-radio-group": "^1.3.8",
+    "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-separator": "^1.1.8",
+    "@radix-ui/react-slider": "^1.3.6",
+    "@radix-ui/react-slot": "^1.2.4",
+    "@radix-ui/react-switch": "^1.2.6",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@radix-ui/react-visually-hidden": "^1.2.4",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "date-fns": "^4.1.0",
+    "react-day-picker": "^9.14.0",
+    "recharts": "^3.8.1",
+    "tailwind-merge": "^3.5.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@hookform/resolvers": "^5.2.2",
+    "@storybook/addon-a11y": "^10.3.5",
+    "@storybook/addon-themes": "^10.3.5",
+    "@storybook/react-vite": "^10.3.5",
+    "@tailwindcss/vite": "^4.2.4",
+    "@tanstack/react-query": "^5.99.2",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/node": "^24.12.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.59.0",
+    "@typescript-eslint/parser": "^8.59.0",
+    "@vitejs/plugin-react": "^6.0.1",
+    "@vitest/coverage-v8": "^4.1.5",
+    "eslint": "^9.39.4",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "jsdom": "^29.0.2",
+    "next": "^16.2.4",
+    "next-themes": "^0.4.6",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "react-hook-form": "^7.73.1",
+    "sonner": "^2.0.7",
+    "storybook": "^10.3.5",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.9",
+    "vitest": "^4.1.5",
+    "zod": "^4.3.6"
+  }
+}

package/src/styles/theme.css

@@ -0,0 +1,130 @@
+@custom-variant dark (&:where(.dark, .dark *));
+
+:root {
+  --ui-background: #ffffff;
+  --ui-foreground: #0a0a0a;
+
+  --ui-surface: #ffffff;
+  --ui-surface-muted: #f4f4f5;
+  --ui-surface-raised: #fafafa;
+
+  --ui-border: #e4e4e7;
+  --ui-border-strong: #d4d4d8;
+
+  --ui-muted: #71717a;
+  --ui-muted-foreground: #52525b;
+
+  --ui-primary: #2563eb;
+  --ui-primary-foreground: #ffffff;
+  --ui-primary-hover: #1d4ed8;
+
+  --ui-accent: #f4f4f5;
+  --ui-accent-foreground: #18181b;
+
+  --ui-success: #16a34a;
+  --ui-warning: #d97706;
+  --ui-danger: #dc2626;
+  --ui-info: #0284c7;
+
+  --ui-ring: #3b82f6;
+  --ui-focus-ring-offset: #ffffff;
+
+  --ui-radius-sm: 0.375rem;
+  --ui-radius-md: 0.5rem;
+  --ui-radius-lg: 0.75rem;
+  --ui-radius-xl: 1rem;
+  --ui-radius-full: 9999px;
+
+  --ui-motion-fast: 120ms;
+  --ui-motion-base: 200ms;
+  --ui-motion-slow: 320ms;
+  --ui-ease-out: cubic-bezier(0.16, 1, 0.3, 1);
+  --ui-ease-in-out: cubic-bezier(0.65, 0, 0.35, 1);
+
+  color-scheme: light;
+}
+
+.dark {
+  --ui-background: #0a0a0a;
+  --ui-foreground: #fafafa;
+
+  --ui-surface: #111113;
+  --ui-surface-muted: #18181b;
+  --ui-surface-raised: #1c1c1f;
+
+  --ui-border: #27272a;
+  --ui-border-strong: #3f3f46;
+
+  --ui-muted: #a1a1aa;
+  --ui-muted-foreground: #d4d4d8;
+
+  --ui-primary: #3b82f6;
+  --ui-primary-foreground: #f8fafc;
+  --ui-primary-hover: #60a5fa;
+
+  --ui-accent: #27272a;
+  --ui-accent-foreground: #f4f4f5;
+
+  --ui-success: #22c55e;
+  --ui-warning: #f59e0b;
+  --ui-danger: #ef4444;
+  --ui-info: #38bdf8;
+
+  --ui-ring: #60a5fa;
+  --ui-focus-ring-offset: #0a0a0a;
+
+  color-scheme: dark;
+}
+
+@theme inline {
+  --color-background: var(--ui-background);
+  --color-foreground: var(--ui-foreground);
+
+  --color-surface: var(--ui-surface);
+  --color-surface-muted: var(--ui-surface-muted);
+  --color-surface-raised: var(--ui-surface-raised);
+
+  --color-border-base: var(--ui-border);
+  --color-border-strong: var(--ui-border-strong);
+
+  --color-muted: var(--ui-muted);
+  --color-muted-foreground: var(--ui-muted-foreground);
+
+  --color-primary: var(--ui-primary);
+  --color-primary-foreground: var(--ui-primary-foreground);
+  --color-primary-hover: var(--ui-primary-hover);
+
+  --color-accent: var(--ui-accent);
+  --color-accent-foreground: var(--ui-accent-foreground);
+
+  --color-success: var(--ui-success);
+  --color-warning: var(--ui-warning);
+  --color-danger: var(--ui-danger);
+  --color-info: var(--ui-info);
+
+  --color-ring: var(--ui-ring);
+
+  --radius-sm: var(--ui-radius-sm);
+  --radius-md: var(--ui-radius-md);
+  --radius-lg: var(--ui-radius-lg);
+  --radius-xl: var(--ui-radius-xl);
+  --radius-full: var(--ui-radius-full);
+
+  --ease-out-brand: var(--ui-ease-out);
+  --ease-in-out-brand: var(--ui-ease-in-out);
+}
+
+[dir="rtl"] {
+  --ui-rtl: 1;
+}
+
+input[type="date"] {
+  min-width: 0;
+  -webkit-appearance: none;
+  appearance: none;
+}
+
+*:focus-visible {
+  outline: 2px solid var(--ui-ring);
+  outline-offset: 2px;
+}