react-auth-gate 0.0.1

package/dist/devtools/DevStore.d.ts

@@ -0,0 +1,80 @@
+/**
+ * DevStore
+ *
+ * Centralized state management for dev tools.
+ * Tracks all permission evaluations and provides override capabilities.
+ */
+import type { PermissionEvaluation, DevToolsState } from '../core/types';
+/**
+ * Dev tools store
+ * Simple observable pattern for managing dev panel state
+ */
+export declare class DevStore {
+    private state;
+    private listeners;
+    /**
+     * Get current state
+     */
+    getState(): DevToolsState;
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(listener: (state: DevToolsState) => void): () => void;
+    /**
+     * Notify all listeners of state change
+     */
+    private notify;
+    /**
+     * Add a permission evaluation
+     */
+    addEvaluation(evaluation: PermissionEvaluation): void;
+    /**
+     * Clear all evaluations
+     */
+    clearEvaluations(): void;
+    /**
+     * Toggle panel open/closed
+     */
+    togglePanel(): void;
+    /**
+     * Set panel open state
+     */
+    setOpen(isOpen: boolean): void;
+    /**
+     * Set override user for testing
+     */
+    setOverrideUser(user: any): void;
+    /**
+     * Set override roles for testing
+     */
+    setOverrideRoles(roles: string[] | undefined): void;
+    /**
+     * Set override permissions for testing
+     */
+    setOverridePermissions(permissions: string[] | undefined): void;
+    /**
+     * Set override flags for testing
+     */
+    setOverrideFlags(flags: Record<string, boolean> | undefined): void;
+    /**
+     * Toggle a specific role
+     */
+    toggleRole(role: string, currentRoles: string[]): void;
+    /**
+     * Toggle a specific permission
+     */
+    togglePermission(permission: string, currentPermissions: string[]): void;
+    /**
+     * Toggle a feature flag
+     */
+    toggleFlag(flag: string, currentFlags: Record<string, boolean>): void;
+    /**
+     * Reset all overrides
+     */
+    resetOverrides(): void;
+}
+/**
+ * Global dev store instance
+ */
+export declare const devStore: DevStore;
+//# sourceMappingURL=DevStore.d.ts.map

package/dist/devtools/DevStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevStore.d.ts","sourceRoot":"","sources":["../../src/devtools/DevStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEzE;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAOX;IAEF,OAAO,CAAC,SAAS,CAAkD;IAEnE;;OAEG;IACH,QAAQ,IAAI,aAAa;IAIzB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAS/D;;OAEG;IACH,OAAO,CAAC,MAAM;IAKd;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,oBAAoB;IAK9C;;OAEG;IACH,gBAAgB;IAKhB;;OAEG;IACH,WAAW;IAKX;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO;IAKvB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,GAAG;IAKzB;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS;IAK5C;;OAEG;IACH,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS;IAKxD;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAK3D;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE;IAa/C;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE;IAajE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAO9D;;OAEG;IACH,cAAc;CAOf;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,UAAiB,CAAC"}

package/dist/devtools/DevStore.js

@@ -0,0 +1,152 @@
+/**
+ * DevStore
+ *
+ * Centralized state management for dev tools.
+ * Tracks all permission evaluations and provides override capabilities.
+ */
+/**
+ * Dev tools store
+ * Simple observable pattern for managing dev panel state
+ */
+export class DevStore {
+    constructor() {
+        this.state = {
+            evaluations: [],
+            isOpen: false,
+            overrideUser: undefined,
+            overrideRoles: undefined,
+            overridePermissions: undefined,
+            overrideFlags: undefined,
+        };
+        this.listeners = new Set();
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        // Return unsubscribe function
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /**
+     * Notify all listeners of state change
+     */
+    notify() {
+        const currentState = this.getState();
+        this.listeners.forEach((listener) => listener(currentState));
+    }
+    /**
+     * Add a permission evaluation
+     */
+    addEvaluation(evaluation) {
+        this.state.evaluations = [evaluation, ...this.state.evaluations].slice(0, 100); // Keep last 100
+        this.notify();
+    }
+    /**
+     * Clear all evaluations
+     */
+    clearEvaluations() {
+        this.state.evaluations = [];
+        this.notify();
+    }
+    /**
+     * Toggle panel open/closed
+     */
+    togglePanel() {
+        this.state.isOpen = !this.state.isOpen;
+        this.notify();
+    }
+    /**
+     * Set panel open state
+     */
+    setOpen(isOpen) {
+        this.state.isOpen = isOpen;
+        this.notify();
+    }
+    /**
+     * Set override user for testing
+     */
+    setOverrideUser(user) {
+        this.state.overrideUser = user;
+        this.notify();
+    }
+    /**
+     * Set override roles for testing
+     */
+    setOverrideRoles(roles) {
+        this.state.overrideRoles = roles;
+        this.notify();
+    }
+    /**
+     * Set override permissions for testing
+     */
+    setOverridePermissions(permissions) {
+        this.state.overridePermissions = permissions;
+        this.notify();
+    }
+    /**
+     * Set override flags for testing
+     */
+    setOverrideFlags(flags) {
+        this.state.overrideFlags = flags;
+        this.notify();
+    }
+    /**
+     * Toggle a specific role
+     */
+    toggleRole(role, currentRoles) {
+        const overrideRoles = this.state.overrideRoles || [...currentRoles];
+        const index = overrideRoles.indexOf(role);
+        if (index > -1) {
+            overrideRoles.splice(index, 1);
+        }
+        else {
+            overrideRoles.push(role);
+        }
+        this.setOverrideRoles(overrideRoles.length > 0 ? overrideRoles : undefined);
+    }
+    /**
+     * Toggle a specific permission
+     */
+    togglePermission(permission, currentPermissions) {
+        const overridePermissions = this.state.overridePermissions || [...currentPermissions];
+        const index = overridePermissions.indexOf(permission);
+        if (index > -1) {
+            overridePermissions.splice(index, 1);
+        }
+        else {
+            overridePermissions.push(permission);
+        }
+        this.setOverridePermissions(overridePermissions.length > 0 ? overridePermissions : undefined);
+    }
+    /**
+     * Toggle a feature flag
+     */
+    toggleFlag(flag, currentFlags) {
+        const overrideFlags = this.state.overrideFlags || { ...currentFlags };
+        overrideFlags[flag] = !overrideFlags[flag];
+        this.setOverrideFlags(overrideFlags);
+    }
+    /**
+     * Reset all overrides
+     */
+    resetOverrides() {
+        this.state.overrideUser = undefined;
+        this.state.overrideRoles = undefined;
+        this.state.overridePermissions = undefined;
+        this.state.overrideFlags = undefined;
+        this.notify();
+    }
+}
+/**
+ * Global dev store instance
+ */
+export const devStore = new DevStore();

package/dist/devtools/PermissionsRoot.d.ts

@@ -0,0 +1,33 @@
+/**
+ * PermissionsRoot
+ *
+ * Enhanced wrapper around PermissionsProvider that automatically
+ * integrates the Dev Panel in development mode.
+ */
+import React, { ReactNode } from 'react';
+import type { PermissionsConfig } from '../core/types';
+interface PermissionsRootProps<TUser = any> extends PermissionsConfig<TUser> {
+    children: ReactNode;
+}
+/**
+ * PermissionsRoot Component
+ *
+ * Use this instead of PermissionsProvider to get automatic Dev Panel integration.
+ * In production, this behaves exactly like PermissionsProvider.
+ *
+ * @example
+ * ```tsx
+ * import { PermissionsRoot } from 'react-permissions-gate';
+ *
+ * <PermissionsRoot
+ *   user={currentUser}
+ *   roles={['admin']}
+ *   rules={rules}
+ * >
+ *   <App />
+ * </PermissionsRoot>
+ * ```
+ */
+export declare function PermissionsRoot<TUser = any>(props: PermissionsRootProps<TUser>): React.JSX.Element;
+export {};
+//# sourceMappingURL=PermissionsRoot.d.ts.map

package/dist/devtools/PermissionsRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionsRoot.d.ts","sourceRoot":"","sources":["../../src/devtools/PermissionsRoot.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,UAAU,oBAAoB,CAAC,KAAK,GAAG,GAAG,CAAE,SAAQ,iBAAiB,CAAC,KAAK,CAAC;IAC1E,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAG,GAAG,EAAE,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,qBA6B9E"}

package/dist/devtools/PermissionsRoot.js

@@ -0,0 +1,46 @@
+/**
+ * PermissionsRoot
+ *
+ * Enhanced wrapper around PermissionsProvider that automatically
+ * integrates the Dev Panel in development mode.
+ */
+import React from 'react';
+import { PermissionsProvider } from '../react/PermissionsProvider';
+import { DevPanel } from './DevPanel';
+import { useDevRegister, useDevToolsState } from './useDevRegister';
+/**
+ * PermissionsRoot Component
+ *
+ * Use this instead of PermissionsProvider to get automatic Dev Panel integration.
+ * In production, this behaves exactly like PermissionsProvider.
+ *
+ * @example
+ * ```tsx
+ * import { PermissionsRoot } from 'react-permissions-gate';
+ *
+ * <PermissionsRoot
+ *   user={currentUser}
+ *   roles={['admin']}
+ *   rules={rules}
+ * >
+ *   <App />
+ * </PermissionsRoot>
+ * ```
+ */
+export function PermissionsRoot(props) {
+    const registerEvaluation = useDevRegister();
+    const devState = useDevToolsState();
+    // Apply dev tools overrides if they exist
+    const effectiveRoles = devState.overrideRoles ?? props.roles ?? [];
+    const effectivePermissions = devState.overridePermissions ?? props.permissions ?? [];
+    const effectiveFlags = devState.overrideFlags ?? props.flags ?? {};
+    // Create a key to force remount when overrides change
+    const overrideKey = JSON.stringify({
+        roles: devState.overrideRoles,
+        permissions: devState.overridePermissions,
+        flags: devState.overrideFlags,
+    });
+    return (React.createElement(PermissionsProvider, { key: overrideKey, ...props, roles: effectiveRoles, permissions: effectivePermissions, flags: effectiveFlags, onEvaluationRegister: registerEvaluation },
+        props.children,
+        React.createElement(DevPanel, null)));
+}

package/dist/devtools/useDevRegister.d.ts

@@ -0,0 +1,17 @@
+/**
+ * useDevRegister Hook
+ *
+ * Internal hook used by the PermissionsProvider to integrate
+ * with dev tools and track evaluations.
+ */
+import type { PermissionEvaluation, DevToolsState } from '../core/types';
+/**
+ * Hook to register permission evaluations with dev tools
+ * Returns a callback that should be passed to PermissionsProvider
+ */
+export declare function useDevRegister(): (evaluation: PermissionEvaluation) => void;
+/**
+ * Hook to subscribe to dev tools state
+ */
+export declare function useDevToolsState(): DevToolsState;
+//# sourceMappingURL=useDevRegister.d.ts.map

package/dist/devtools/useDevRegister.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDevRegister.d.ts","sourceRoot":"","sources":["../../src/devtools/useDevRegister.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,cAAc,iBACwB,oBAAoB,UAKzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAShD"}

package/dist/devtools/useDevRegister.js

@@ -0,0 +1,29 @@
+/**
+ * useDevRegister Hook
+ *
+ * Internal hook used by the PermissionsProvider to integrate
+ * with dev tools and track evaluations.
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { devStore } from './DevStore';
+/**
+ * Hook to register permission evaluations with dev tools
+ * Returns a callback that should be passed to PermissionsProvider
+ */
+export function useDevRegister() {
+    const registerEvaluation = useCallback((evaluation) => {
+        devStore.addEvaluation(evaluation);
+    }, []);
+    return registerEvaluation;
+}
+/**
+ * Hook to subscribe to dev tools state
+ */
+export function useDevToolsState() {
+    const [state, setState] = useState(devStore.getState());
+    useEffect(() => {
+        const unsubscribe = devStore.subscribe(setState);
+        return unsubscribe;
+    }, []);
+    return state;
+}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * react-permissions-gate
+ *
+ * A production-grade React authorization framework for RBAC, PBAC, ABAC,
+ * feature flags, and async permission checks.
+ *
+ * @packageDocumentation
+ */
+export type { PermissionContext, PermissionRule, PermissionRulesMap, PermissionCheck, PermissionMode, PermissionsConfig, PermissionsContextValue, PermissionEvaluation, RuleEvaluationResult, DevToolsState, } from './core/types';
+export { PermissionsProvider, usePermissionsContext } from './react/PermissionsProvider';
+export { PermissionsGate } from './react/PermissionsGate';
+export type { PermissionsGateProps } from './react/PermissionsGate';
+export { Permissioned } from './react/Permissioned';
+export type { PermissionedProps } from './react/Permissioned';
+export { ProtectedRoute } from './react/ProtectedRoute';
+export type { ProtectedRouteProps } from './react/ProtectedRoute';
+export { usePermission, usePermissionValue } from './react/usePermission';
+export { PermissionsRoot } from './devtools/PermissionsRoot';
+export { DevPanel } from './devtools/DevPanel';
+export { devStore } from './devtools/DevStore';
+export { evaluatePermission, evaluateRule, resolveStringRule, createPermissionContext, } from './core/ruleEngine';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG1E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * react-permissions-gate
+ *
+ * A production-grade React authorization framework for RBAC, PBAC, ABAC,
+ * feature flags, and async permission checks.
+ *
+ * @packageDocumentation
+ */
+// React components
+export { PermissionsProvider, usePermissionsContext } from './react/PermissionsProvider';
+export { PermissionsGate } from './react/PermissionsGate';
+export { Permissioned } from './react/Permissioned';
+export { ProtectedRoute } from './react/ProtectedRoute';
+// Hooks
+export { usePermission, usePermissionValue } from './react/usePermission';
+// Dev tools (auto-integrated root)
+export { PermissionsRoot } from './devtools/PermissionsRoot';
+export { DevPanel } from './devtools/DevPanel';
+export { devStore } from './devtools/DevStore';
+// Core utilities (advanced usage)
+export { evaluatePermission, evaluateRule, resolveStringRule, createPermissionContext, } from './core/ruleEngine';

package/dist/react/Permissioned.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Permissioned Component
+ *
+ * Render-prop version of PermissionsGate for more control.
+ * Passes the permission result to a render function.
+ */
+import React, { ReactNode } from 'react';
+import type { PermissionCheck } from '../core/types';
+export interface PermissionedProps<TUser = any, TResource = any> {
+    /**
+     * Permission check to evaluate
+     */
+    allow: PermissionCheck<TUser, TResource>;
+    /**
+     * Resource to check permission against
+     */
+    resource?: TResource;
+    /**
+     * Render function that receives permission result
+     */
+    children: (allowed: boolean, loading: boolean) => ReactNode;
+}
+/**
+ * Permissioned Component
+ *
+ * Render-prop pattern for permission checking.
+ * Gives you full control over how to render based on permission state.
+ *
+ * @example
+ * ```tsx
+ * <Permissioned allow="user.edit" resource={user}>
+ *   {(allowed, loading) => (
+ *     <button disabled={!allowed || loading}>
+ *       {loading ? 'Checking...' : allowed ? 'Edit' : 'View Only'}
+ *     </button>
+ *   )}
+ * </Permissioned>
+ * ```
+ */
+export declare function Permissioned<TUser = any, TResource = any>({ allow, resource, children, }: PermissionedProps<TUser, TResource>): React.JSX.Element;
+//# sourceMappingURL=Permissioned.d.ts.map

package/dist/react/Permissioned.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Permissioned.d.ts","sourceRoot":"","sources":["../../src/react/Permissioned.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,iBAAiB,CAAC,KAAK,GAAG,GAAG,EAAE,SAAS,GAAG,GAAG;IAC7D;;OAEG;IACH,KAAK,EAAE,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAG,GAAG,EAAE,SAAS,GAAG,GAAG,EAAE,EACzD,KAAK,EACL,QAAQ,EACR,QAAQ,GACT,EAAE,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,qBAIrC"}

package/dist/react/Permissioned.js

@@ -0,0 +1,29 @@
+/**
+ * Permissioned Component
+ *
+ * Render-prop version of PermissionsGate for more control.
+ * Passes the permission result to a render function.
+ */
+import React from 'react';
+import { usePermission } from './usePermission';
+/**
+ * Permissioned Component
+ *
+ * Render-prop pattern for permission checking.
+ * Gives you full control over how to render based on permission state.
+ *
+ * @example
+ * ```tsx
+ * <Permissioned allow="user.edit" resource={user}>
+ *   {(allowed, loading) => (
+ *     <button disabled={!allowed || loading}>
+ *       {loading ? 'Checking...' : allowed ? 'Edit' : 'View Only'}
+ *     </button>
+ *   )}
+ * </Permissioned>
+ * ```
+ */
+export function Permissioned({ allow, resource, children, }) {
+    const { allowed, loading } = usePermission(allow, resource);
+    return React.createElement(React.Fragment, null, children(allowed, loading));
+}

package/dist/react/PermissionsGate.d.ts

@@ -0,0 +1,79 @@
+/**
+ * PermissionsGate Component
+ *
+ * Declarative permission boundary for your components.
+ * Automatically hides or disables children based on permission checks.
+ */
+import React, { ReactNode } from 'react';
+import type { PermissionCheck, PermissionMode } from '../core/types';
+export interface PermissionsGateProps<TUser = any, TResource = any> {
+    /**
+     * Primary permission check
+     * Can be a string, array of strings, or inline rule function
+     */
+    allow?: PermissionCheck<TUser, TResource>;
+    /**
+     * Array of permissions where ANY must pass (OR logic)
+     * Alternative to `allow` - cannot be used together
+     */
+    any?: string[];
+    /**
+     * Array of permissions where ALL must pass (AND logic)
+     * Alternative to `allow` - cannot be used together
+     */
+    all?: string[];
+    /**
+     * Resource to check permission against
+     */
+    resource?: TResource;
+    /**
+     * Fallback content to render when permission is denied
+     * If not provided and mode is 'hide', nothing is rendered
+     */
+    fallback?: ReactNode;
+    /**
+     * How to handle denied permissions:
+     * - 'hide': Don't render children at all (default)
+     * - 'disable': Render children but add disabled prop
+     */
+    mode?: PermissionMode;
+    /**
+     * Children to protect with permission check
+     */
+    children: ReactNode;
+}
+/**
+ * PermissionsGate Component
+ *
+ * Wraps components with permission-based access control.
+ *
+ * @example
+ * ```tsx
+ * // Hide button if user can't edit
+ * <PermissionsGate allow="user.edit" resource={user}>
+ *   <EditButton />
+ * </PermissionsGate>
+ *
+ * // Disable button instead of hiding
+ * <PermissionsGate allow="post.delete" resource={post} mode="disable">
+ *   <DeleteButton />
+ * </PermissionsGate>
+ *
+ * // Check multiple permissions (any)
+ * <PermissionsGate any={["admin", "moderator"]}>
+ *   <AdminPanel />
+ * </PermissionsGate>
+ *
+ * // Check multiple permissions (all)
+ * <PermissionsGate all={["post.edit", "post.publish"]}>
+ *   <PublishButton />
+ * </PermissionsGate>
+ *
+ * // Show fallback when denied
+ * <PermissionsGate allow="premium.feature" fallback={<UpgradePrompt />}>
+ *   <PremiumFeature />
+ * </PermissionsGate>
+ * ```
+ */
+export declare function PermissionsGate<TUser = any, TResource = any>({ allow, any, all, resource, fallback, mode, children, }: PermissionsGateProps<TUser, TResource>): React.JSX.Element | null;
+//# sourceMappingURL=PermissionsGate.d.ts.map

package/dist/react/PermissionsGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionsGate.d.ts","sourceRoot":"","sources":["../../src/react/PermissionsGate.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAAE,SAAS,EAA8B,MAAM,OAAO,CAAC;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAErE,MAAM,WAAW,oBAAoB,CAAC,KAAK,GAAG,GAAG,EAAE,SAAS,GAAG,GAAG;IAChE;;;OAGG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAE1C;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IAEf;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IAErB;;;;OAIG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAG,GAAG,EAAE,SAAS,GAAG,GAAG,EAAE,EAC5D,KAAK,EACL,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,IAAa,EACb,QAAQ,GACT,EAAE,oBAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,4BA2CxC"}