@rfdtech/components 0.3.0

package/dist/test/fixtures.d.ts

@@ -0,0 +1,4 @@
+import type { MeApp, MeAppsResponse } from "../types/app-switcher";
+export declare const sampleMeApp: MeApp;
+export declare const sampleMeAppsResponse: MeAppsResponse;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/test/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/test/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEnE,eAAO,MAAM,WAAW,EAAE,KAOzB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cASlC,CAAC"}

package/dist/test/setup.d.ts

@@ -0,0 +1,2 @@
+import "@testing-library/jest-dom/vitest";
+//# sourceMappingURL=setup.d.ts.map

package/dist/test/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/test/setup.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC"}

package/dist/types/app-switcher.d.ts

@@ -0,0 +1,102 @@
+import type { CSSProperties, ReactNode } from "react";
+export interface AppItem {
+    /** Unique identifier for the app */
+    id: string;
+    /** Display name shown below the icon */
+    name: string;
+    /** Icon as a React node, image URL, or emoji string */
+    icon: ReactNode | string;
+    /** URL to navigate to when the app is selected */
+    href?: string;
+    /** Custom click handler (called before navigation if href is set) */
+    onClick?: (app: AppItem) => void;
+    /** Whether the app is disabled */
+    disabled?: boolean;
+    /** Optional badge text (e.g. "New") */
+    badge?: string;
+    /** Original API payload when loaded from `/v1/me/apps` */
+    metadata?: MeApp;
+}
+export interface MeApp {
+    system_id: string;
+    system_name: string;
+    system_code: string;
+    frontend_url: string;
+    role: string;
+    permissions: string[];
+}
+export interface MeAppsResponse {
+    success: boolean;
+    message: string;
+    data: {
+        apps: MeApp[];
+    };
+    meta: {
+        count: number;
+    };
+}
+export interface AppSwitcherBaseProps {
+    /** Controlled open state */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Called when an app is selected */
+    onAppSelect?: (app: AppItem) => void;
+    /** Number of columns in the grid (default: 3) */
+    columns?: number;
+    /** Accessible label for the trigger button */
+    triggerLabel?: string;
+    /** Custom trigger element (replaces default 9-dot icon) */
+    trigger?: ReactNode;
+    /** Panel title shown at the top */
+    title?: string;
+    /** Footer content (e.g. "More from Google" link) */
+    footer?: ReactNode;
+    /** Additional CSS class for the root container */
+    className?: string;
+    /** Inline styles for the root container */
+    style?: CSSProperties;
+    /** Placement of the panel relative to trigger */
+    placement?: "bottom-end" | "bottom-start" | "bottom";
+    /** Whether to close the panel when an app is selected */
+    closeOnSelect?: boolean;
+}
+export interface AppSwitcherWithApps extends AppSwitcherBaseProps {
+    /** Static apps to display in the grid */
+    apps: AppItem[];
+    baseUrl?: never;
+    accessToken?: never;
+}
+export interface AppSwitcherWithFetch extends AppSwitcherBaseProps {
+    apps?: never;
+    /** API base URL, e.g. `https://api.example.com` */
+    baseUrl: string;
+    /** Bearer access token for authenticated requests */
+    accessToken: string;
+}
+export type AppSwitcherProps = AppSwitcherWithApps | AppSwitcherWithFetch;
+export interface UseMeAppsOptions {
+    baseUrl: string;
+    accessToken: string;
+    enabled?: boolean;
+}
+export interface UseMeAppsReturn {
+    apps: AppItem[];
+    loading: boolean;
+    error: string | null;
+    refetch: () => void;
+}
+export interface UseAppSwitcherOptions {
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    closeOnSelect?: boolean;
+}
+export interface UseAppSwitcherReturn {
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    toggle: () => void;
+    close: () => void;
+    triggerRef: React.RefObject<HTMLButtonElement | null>;
+    panelRef: React.RefObject<HTMLDivElement | null>;
+}
+//# sourceMappingURL=app-switcher.d.ts.map

package/dist/types/app-switcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-switcher.d.ts","sourceRoot":"","sources":["../../src/types/app-switcher.ts"],"names":[],"mappings":"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"}

package/dist/types/bulk-import-modal.d.ts

@@ -0,0 +1,92 @@
+export type BulkImportFieldType = "string" | "email" | "number" | "integer" | "date" | "boolean" | "url" | "phone";
+export interface BulkImportField {
+    key: string;
+    label: string;
+    required?: boolean;
+    type?: BulkImportFieldType;
+    pattern?: string | RegExp;
+    patternMessage?: string;
+    minLength?: number;
+    maxLength?: number;
+    min?: number;
+    max?: number;
+    options?: string[];
+    optionsIgnoreCase?: boolean;
+    optionsMessage?: string;
+    description?: string;
+    example?: string;
+    trim?: boolean;
+    validate?: (value: string) => string | null;
+}
+export interface BulkImportValidationError {
+    row: number;
+    fieldKey: string;
+    fieldLabel: string;
+    message: string;
+    severity: "error" | "warning";
+}
+export interface BulkImportResult {
+    rows: Record<string, string>[];
+    errors: BulkImportValidationError[];
+    warnings: BulkImportValidationError[];
+}
+export interface BulkImportModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    fields: BulkImportField[];
+    onComplete: (result: BulkImportResult) => void;
+    title?: string;
+    maxFileSizeBytes?: number;
+    allowImportWithWarnings?: boolean;
+    className?: string;
+}
+export interface SourceColumn {
+    index: number;
+    label: string;
+}
+export interface ParsedSpreadsheet {
+    rows: string[][];
+    fileName: string;
+}
+export type BulkImportStep = 1 | 2 | 3 | 4;
+/** Maps source column index to target field key */
+export type SourceColumnMapping = Record<number, string | null>;
+/** @deprecated Use SourceColumnMapping — kept for backwards compatibility */
+export type ColumnMapping = Record<string, number | null>;
+export interface UseBulkImportFlowOptions {
+    fields: BulkImportField[];
+    maxFileSizeBytes?: number;
+    open: boolean;
+}
+export interface UseBulkImportFlowReturn {
+    step: BulkImportStep;
+    parsed: ParsedSpreadsheet | null;
+    parseError: string | null;
+    headerRowIndex: number | null;
+    sourceColumnMapping: SourceColumnMapping;
+    excludedColumns: number[];
+    sourceColumns: SourceColumn[];
+    mappedRows: Record<string, string>[];
+    validationErrors: BulkImportValidationError[];
+    validationWarnings: BulkImportValidationError[];
+    selectedRowIds: number[];
+    showOnlyErrors: boolean;
+    discardedRows: number[];
+    canGoNext: boolean;
+    canImport: boolean;
+    isParsing: boolean;
+    setHeaderRowIndex: (index: number) => void;
+    setSourceColumnMapping: (mapping: SourceColumnMapping) => void;
+    updateSourceMapping: (sourceIndex: number, fieldKey: string | null) => void;
+    toggleExcludedColumn: (sourceIndex: number) => void;
+    setSelectedRowIds: (rowIds: number[]) => void;
+    toggleRowSelection: (rowId: number) => void;
+    setShowOnlyErrors: (value: boolean) => void;
+    discardSelectedRows: () => void;
+    handleFile: (file: File) => Promise<void>;
+    goNext: () => void;
+    goBack: () => void;
+    reset: () => void;
+    buildResult: () => BulkImportResult;
+}
+//# sourceMappingURL=bulk-import-modal.d.ts.map

package/dist/types/bulk-import-modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-import-modal.d.ts","sourceRoot":"","sources":["../../src/types/bulk-import-modal.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@rfdtech/components",
+  "version": "0.3.0",
+  "description": "Shared React component library for Ghana School of Law (GSL) projects",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "dev": "vite --config vite.demo.config.ts",
+    "demo": "vite --config vite.demo.config.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "@vitejs/plugin-react": "^4.6.0",
+    "jsdom": "^29.1.1",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "typescript": "^5.8.3",
+    "vite": "^6.3.5",
+    "vite-plugin-dts": "^4.5.4",
+    "vite-plugin-lib-inject-css": "^2.2.2",
+    "vitest": "^4.1.8"
+  },
+  "keywords": [
+    "react",
+    "components",
+    "gsl",
+    "ghana-school-of-law",
+    "app-switcher",
+    "app-launcher",
+    "google-apps",
+    "product-switcher"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "xlsx": "^0.18.5"
+  }
+}