@react-vault/ui 0.1.0

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright (c) 2026 Rsense. All rights reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary property of Rsense and are licensed for internal use only by
+employees, contractors, and authorised partners of Rsense.
+
+No part of the Software may be redistributed, sublicensed, sold, or otherwise
+made available to third parties without prior written consent from Rsense.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.

package/README.md

@@ -0,0 +1,48 @@
+# @react-vault/ui
+
+React component library on top of Tailwind CSS + shadcn/ui, with BFSI-specific compositions.
+
+```tsx
+import { PIIMaskedDisplay, CurrencyDisplay, DateTimeDisplay, cn } from '@react-vault/ui';
+import { tokens } from '@react-vault/ui/theme';
+
+// PII masking with click-to-reveal + audit hook
+<PIIMaskedDisplay
+  type="pan"
+  value={user.pan}
+  auditTarget={{ type: 'user', id: user.id }}
+  onReveal={() => auditClient.record({ event_name: 'data.pan.revealed', ... })}
+/>
+
+// Locale-aware money + dates
+<CurrencyDisplay value={1234567.89} />            // ₹12,34,567.89
+<DateTimeDisplay value={tx.createdAt} preset="datetime" />  // IST
+```
+
+## What's inside (v0.1)
+
+- `PIIMaskedDisplay` — click-to-reveal PII display with auto re-mask + audit callback
+- `CurrencyDisplay` — Intl-based currency formatter, INR/en-IN default, accounting style option
+- `DateTimeDisplay` — Intl-based date/time formatter, IST default
+- `cn` — class-name composer (clsx + tailwind-merge)
+- `tokens` — BFSI design tokens (status colours, sensitivity tiers)
+
+## Coming in v0.2
+
+- `ConfirmModal` — confirmation modal with optional MFA challenge slot
+- `SecureFormField` — RHF integration with autocomplete=off + paste guards
+- `AuditedAction` — wraps a button to emit audit event on click
+- `AccessControlledTable` — data table with column-level RBAC + export controls
+- `StatusBadge` — KYC / transaction / audit status indicator
+- `DocumentUploader` — file upload with MIME validation + virus-scan hook
+- `SignatureCapture` — e-signature stub for IRDAI flows
+- `PCITokenizedCardInput` — PCI-DSS-compliant iframe for card capture
+
+The full shadcn/ui primitive set (Button, Input, Dialog, Toast, Combobox, etc.) gets installed by the CLI generator into each scaffolded app's `src/components/ui/` — apps own those copies.
+
+## Conventions
+
+- All components are typed; no `any`.
+- All interactive elements have proper a11y (`aria-*`, focus styles, keyboard).
+- All BFSI components emit `data-target-type` / `data-target-id` so screenshot diffing + audit replay can correlate.
+- All formatters fall back gracefully on null/undefined/NaN to `—`.

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@react-vault/ui",
+  "version": "0.1.0",
+  "description": "Tailwind + shadcn/ui + BFSI-specific React components: PIIMaskedDisplay, ConfirmModal, SecureFormField, AccessControlledTable, CurrencyDisplay, DateTimeDisplay, and more.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./primitives": {
+      "types": "./dist/primitives/index.d.ts",
+      "import": "./dist/primitives/index.js"
+    },
+    "./bfsi": {
+      "types": "./dist/bfsi/index.d.ts",
+      "import": "./dist/bfsi/index.js"
+    },
+    "./theme": {
+      "types": "./dist/theme/index.d.ts",
+      "import": "./dist/theme/index.js"
+    },
+    "./formatters": {
+      "types": "./dist/formatters/index.d.ts",
+      "import": "./dist/formatters/index.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "react": "18.3.1",
+    "react-dom": "18.3.1"
+  },
+  "dependencies": {
+    "class-variance-authority": "0.7.0",
+    "clsx": "2.1.1",
+    "tailwind-merge": "2.3.0",
+    "lucide-react": "0.378.0",
+    "date-fns": "3.6.0",
+    "@react-vault/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/react": "18.3.0",
+    "@types/react-dom": "18.3.0",
+    "@testing-library/react": "15.0.6",
+    "@testing-library/user-event": "14.5.2",
+    "@testing-library/jest-dom": "6.4.5",
+    "jsdom": "24.0.0",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "typescript": "5.4.5",
+    "vitest": "1.6.0"
+  },
+  "engines": {
+    "node": ">=20.11.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amar-josh/react-vault.git",
+    "directory": "packages/ui"
+  },
+  "homepage": "https://github.com/amar-josh/react-vault#readme",
+  "bugs": {
+    "url": "https://github.com/amar-josh/react-vault/issues"
+  },
+  "keywords": [
+    "bfsi",
+    "fintech",
+    "react",
+    "tailwind",
+    "shadcn",
+    "pii-masking",
+    "ui-components"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo"
+  }
+}