com-angel-authorization 1.0.0

package/dist/vue/index.cjs

@@ -0,0 +1,241 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vue/index.ts
+var vue_exports = {};
+__export(vue_exports, {
+  Can: () => Can,
+  PERMISSION_STORE_KEY: () => PERMISSION_STORE_KEY,
+  PermissionStore: () => import_core2.PermissionStore,
+  createPermissionPlugin: () => createPermissionPlugin,
+  createPermissionStore: () => import_core2.createPermissionStore,
+  createVPermission: () => createVPermission,
+  useHasPermission: () => useHasPermission,
+  useHasRole: () => useHasRole,
+  usePermission: () => usePermission
+});
+module.exports = __toCommonJS(vue_exports);
+
+// src/vue/plugin.ts
+var import_vue = require("vue");
+var import_core = require("../core");
+
+// src/vue/directive.ts
+function parseBinding(binding) {
+  const value = binding.value;
+  const arg = binding.arg;
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return {
+      permission: value.permission,
+      role: value.role,
+      mode: value.mode ?? (arg === "all" ? "all" : "any"),
+      combine: value.combine ?? "and",
+      display: value.display
+    };
+  }
+  if (arg === "role") {
+    return {
+      role: value,
+      mode: binding.modifiers.all ? "all" : "any",
+      combine: "and"
+    };
+  }
+  return {
+    permission: value,
+    mode: arg === "all" || binding.modifiers.all ? "all" : "any",
+    combine: "and"
+  };
+}
+function isAllowed(store, binding) {
+  const { permission, role, mode, combine } = parseBinding(binding);
+  const options = { mode };
+  const hasPermCheck = permission !== void 0;
+  const hasRoleCheck = role !== void 0;
+  if (!hasPermCheck && !hasRoleCheck) return true;
+  const permOk = hasPermCheck ? store.hasPermission(permission, options) : true;
+  const roleOk = hasRoleCheck ? store.hasRole(role, options) : true;
+  if (hasPermCheck && hasRoleCheck) {
+    return combine === "or" ? permOk || roleOk : permOk && roleOk;
+  }
+  return hasPermCheck ? permOk : roleOk;
+}
+function applyVisibility(el, allowed, display) {
+  if (el.__angelPermissionDisplay === void 0) {
+    el.__angelPermissionDisplay = el.style.display;
+  }
+  if (allowed) {
+    el.style.display = display ?? el.__angelPermissionDisplay ?? "";
+    el.removeAttribute("aria-hidden");
+  } else {
+    el.style.display = "none";
+    el.setAttribute("aria-hidden", "true");
+  }
+}
+function createVPermission(store) {
+  return {
+    mounted(el, binding) {
+      const update = () => {
+        const { display } = parseBinding(binding);
+        applyVisibility(el, isAllowed(store, binding), display);
+      };
+      update();
+      el.__angelPermissionUnsubscribe = store.subscribe(update);
+    },
+    updated(el, binding) {
+      const { display } = parseBinding(binding);
+      applyVisibility(el, isAllowed(store, binding), display);
+    },
+    unmounted(el) {
+      el.__angelPermissionUnsubscribe?.();
+      delete el.__angelPermissionUnsubscribe;
+      delete el.__angelPermissionDisplay;
+    }
+  };
+}
+
+// src/vue/plugin.ts
+var PERMISSION_STORE_KEY = /* @__PURE__ */ Symbol(
+  "angel-authorization-store"
+);
+function createPermissionPlugin(options = {}) {
+  const store = options.store ?? (0, import_core.createPermissionStore)(options.initialState);
+  const directiveName = options.directiveName ?? "permission";
+  const plugin = {
+    store,
+    install(app) {
+      app.provide(PERMISSION_STORE_KEY, store);
+      app.directive(directiveName, createVPermission(store));
+      app.config.globalProperties.$permission = store;
+      app.config.globalProperties.$can = (codes, opts) => store.can(codes, opts);
+      app.config.globalProperties.$hasRole = (codes, opts) => store.hasRole(codes, opts);
+    }
+  };
+  return plugin;
+}
+function resolveStore(store) {
+  const injected = store ?? (0, import_vue.inject)(PERMISSION_STORE_KEY, null);
+  if (!injected) {
+    throw new Error(
+      "[com-angel-authorization/vue] Permission store not found. Did you call app.use(createPermissionPlugin())?"
+    );
+  }
+  return injected;
+}
+function usePermission(store) {
+  const permissionStore = resolveStore(store);
+  const state = (0, import_vue.shallowRef)(permissionStore.getState());
+  const unsubscribe = permissionStore.subscribe((next) => {
+    state.value = next;
+  });
+  (0, import_vue.onScopeDispose)(unsubscribe);
+  return {
+    permissions: (0, import_vue.computed)(() => state.value.permissions),
+    roles: (0, import_vue.computed)(() => state.value.roles),
+    isSuperAdmin: (0, import_vue.computed)(() => Boolean(state.value.isSuperAdmin)),
+    hasPermission: (codes, options) => permissionStore.hasPermission(codes, options),
+    hasRole: (codes, options) => permissionStore.hasRole(codes, options),
+    can: (codes, options) => permissionStore.can(codes, options),
+    setPermissions: permissionStore.setPermissions.bind(permissionStore),
+    setRoles: permissionStore.setRoles.bind(permissionStore),
+    setSuperAdmin: permissionStore.setSuperAdmin.bind(permissionStore),
+    hydrate: permissionStore.hydrate.bind(permissionStore),
+    clear: permissionStore.clear.bind(permissionStore),
+    store: permissionStore
+  };
+}
+function useHasPermission(codes, options, store) {
+  const { permissions, isSuperAdmin, hasPermission } = usePermission(store);
+  return (0, import_vue.computed)(() => {
+    void permissions.value;
+    void isSuperAdmin.value;
+    return hasPermission(codes, options);
+  });
+}
+function useHasRole(codes, options, store) {
+  const { roles, isSuperAdmin, hasRole } = usePermission(store);
+  return (0, import_vue.computed)(() => {
+    void roles.value;
+    void isSuperAdmin.value;
+    return hasRole(codes, options);
+  });
+}
+
+// src/vue/Can.ts
+var import_vue2 = require("vue");
+var Can = (0, import_vue2.defineComponent)({
+  name: "Can",
+  props: {
+    permission: {
+      type: [String, Array],
+      default: void 0
+    },
+    role: {
+      type: [String, Array],
+      default: void 0
+    },
+    mode: {
+      type: String,
+      default: "any"
+    },
+    combine: {
+      type: String,
+      default: "and"
+    }
+  },
+  setup(props, { slots }) {
+    const { hasPermission, hasRole, permissions, roles, isSuperAdmin } = usePermission();
+    const allowed = (0, import_vue2.computed)(() => {
+      void permissions.value;
+      void roles.value;
+      void isSuperAdmin.value;
+      const hasPermCheck = props.permission !== void 0;
+      const hasRoleCheck = props.role !== void 0;
+      if (!hasPermCheck && !hasRoleCheck) return true;
+      const options = { mode: props.mode };
+      const permOk = hasPermCheck ? hasPermission(props.permission, options) : true;
+      const roleOk = hasRoleCheck ? hasRole(props.role, options) : true;
+      if (hasPermCheck && hasRoleCheck) {
+        return props.combine === "or" ? permOk || roleOk : permOk && roleOk;
+      }
+      return hasPermCheck ? permOk : roleOk;
+    });
+    return () => {
+      if (allowed.value) {
+        return slots.default?.();
+      }
+      return slots.fallback?.() ?? null;
+    };
+  }
+});
+
+// src/vue/index.ts
+var import_core2 = require("../core");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Can,
+  PERMISSION_STORE_KEY,
+  PermissionStore,
+  createPermissionPlugin,
+  createPermissionStore,
+  createVPermission,
+  useHasPermission,
+  useHasRole,
+  usePermission
+});
+//# sourceMappingURL=index.cjs.map

package/dist/vue/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vue/index.ts","../../src/vue/plugin.ts","../../src/vue/directive.ts","../../src/vue/Can.ts"],"sourcesContent":["export {\n  createPermissionPlugin,\n  usePermission,\n  useHasPermission,\n  useHasRole,\n  PERMISSION_STORE_KEY,\n} from './plugin';\nexport type { PermissionPluginOptions, UsePermissionResult } from './plugin';\n\nexport { createVPermission } from './directive';\nexport type { PermissionDirectiveValue } from './directive';\n\nexport { Can } from './Can';\n\nexport type {\n  CheckOptions,\n  MatchMode,\n  PermissionChecker,\n  PermissionCode,\n  PermissionListener,\n  PermissionState,\n  RoleCode,\n} from '../core';\n\nexport { PermissionStore, createPermissionStore } from '../core';\n","import {\n  computed,\n  inject,\n  onScopeDispose,\n  shallowRef,\n  type App,\n  type ComputedRef,\n  type InjectionKey,\n  type Plugin,\n} from 'vue';\nimport {\n  createPermissionStore,\n  type CheckOptions,\n  type PermissionCode,\n  type PermissionState,\n  type PermissionStore,\n  type RoleCode,\n} from '../core';\nimport { createVPermission } from './directive';\n\nexport const PERMISSION_STORE_KEY: InjectionKey<PermissionStore> = Symbol(\n  'angel-authorization-store',\n);\n\nexport interface PermissionPluginOptions {\n  /** Pass an existing store to share across apps. */\n  store?: PermissionStore;\n  /** Initial state when the plugin creates its own store. */\n  initialState?: Partial<PermissionState>;\n  /** Custom directive name. Default: `permission` → `v-permission`. */\n  directiveName?: string;\n}\n\nexport function createPermissionPlugin(\n  options: PermissionPluginOptions = {},\n): Plugin & { store: PermissionStore } {\n  const store = options.store ?? createPermissionStore(options.initialState);\n  const directiveName = options.directiveName ?? 'permission';\n\n  const plugin: Plugin & { store: PermissionStore } = {\n    store,\n    install(app: App) {\n      app.provide(PERMISSION_STORE_KEY, store);\n      app.directive(directiveName, createVPermission(store));\n      app.config.globalProperties.$permission = store;\n      app.config.globalProperties.$can = (\n        codes: PermissionCode | PermissionCode[],\n        opts?: CheckOptions,\n      ) => store.can(codes, opts);\n      app.config.globalProperties.$hasRole = (\n        codes: RoleCode | RoleCode[],\n        opts?: CheckOptions,\n      ) => store.hasRole(codes, opts);\n    },\n  };\n\n  return plugin;\n}\n\nfunction resolveStore(store?: PermissionStore): PermissionStore {\n  const injected = store ?? inject(PERMISSION_STORE_KEY, null);\n  if (!injected) {\n    throw new Error(\n      '[com-angel-authorization/vue] Permission store not found. Did you call app.use(createPermissionPlugin())?',\n    );\n  }\n  return injected;\n}\n\nexport interface UsePermissionResult {\n  permissions: ComputedRef<PermissionCode[]>;\n  roles: ComputedRef<RoleCode[]>;\n  isSuperAdmin: ComputedRef<boolean>;\n  hasPermission: (codes: PermissionCode | PermissionCode[], options?: CheckOptions) => boolean;\n  hasRole: (codes: RoleCode | RoleCode[], options?: CheckOptions) => boolean;\n  can: (codes: PermissionCode | PermissionCode[], options?: CheckOptions) => boolean;\n  setPermissions: (permissions: PermissionCode[]) => void;\n  setRoles: (roles: RoleCode[]) => void;\n  setSuperAdmin: (isSuperAdmin: boolean) => void;\n  hydrate: (payload: Partial<PermissionState>) => void;\n  clear: () => void;\n  store: PermissionStore;\n}\n\n/**\n * Reactive permission API for Vue 3 Composition API.\n */\nexport function usePermission(store?: PermissionStore): UsePermissionResult {\n  const permissionStore = resolveStore(store);\n  const state = shallowRef<PermissionState>(permissionStore.getState());\n\n  const unsubscribe = permissionStore.subscribe((next) => {\n    state.value = next;\n  });\n  onScopeDispose(unsubscribe);\n\n  return {\n    permissions: computed(() => state.value.permissions),\n    roles: computed(() => state.value.roles),\n    isSuperAdmin: computed(() => Boolean(state.value.isSuperAdmin)),\n    hasPermission: (codes, options) => permissionStore.hasPermission(codes, options),\n    hasRole: (codes, options) => permissionStore.hasRole(codes, options),\n    can: (codes, options) => permissionStore.can(codes, options),\n    setPermissions: permissionStore.setPermissions.bind(permissionStore),\n    setRoles: permissionStore.setRoles.bind(permissionStore),\n    setSuperAdmin: permissionStore.setSuperAdmin.bind(permissionStore),\n    hydrate: permissionStore.hydrate.bind(permissionStore),\n    clear: permissionStore.clear.bind(permissionStore),\n    store: permissionStore,\n  };\n}\n\nexport function useHasPermission(\n  codes: PermissionCode | PermissionCode[],\n  options?: CheckOptions,\n  store?: PermissionStore,\n) {\n  const { permissions, isSuperAdmin, hasPermission } = usePermission(store);\n  return computed(() => {\n    void permissions.value;\n    void isSuperAdmin.value;\n    return hasPermission(codes, options);\n  });\n}\n\nexport function useHasRole(\n  codes: RoleCode | RoleCode[],\n  options?: CheckOptions,\n  store?: PermissionStore,\n) {\n  const { roles, isSuperAdmin, hasRole } = usePermission(store);\n  return computed(() => {\n    void roles.value;\n    void isSuperAdmin.value;\n    return hasRole(codes, options);\n  });\n}\n\ndeclare module 'vue' {\n  interface ComponentCustomProperties {\n    $permission: PermissionStore;\n    $can: (codes: PermissionCode | PermissionCode[], options?: CheckOptions) => boolean;\n    $hasRole: (codes: RoleCode | RoleCode[], options?: CheckOptions) => boolean;\n  }\n}\n","import type { Directive, DirectiveBinding } from 'vue';\nimport type { CheckOptions, MatchMode, PermissionCode, PermissionStore, RoleCode } from '../core';\n\nexport type PermissionDirectiveValue =\n  | PermissionCode\n  | PermissionCode[]\n  | {\n      permission?: PermissionCode | PermissionCode[];\n      role?: RoleCode | RoleCode[];\n      mode?: MatchMode;\n      /** When both permission and role are set. Default: `and`. */\n      combine?: 'and' | 'or';\n      /** CSS display value when allowed. Default: restores original display. */\n      display?: string;\n    };\n\nfunction parseBinding(binding: DirectiveBinding<PermissionDirectiveValue>): {\n  permission?: PermissionCode | PermissionCode[];\n  role?: RoleCode | RoleCode[];\n  mode?: MatchMode;\n  combine: 'and' | 'or';\n  display?: string;\n} {\n  const value = binding.value;\n  const arg = binding.arg;\n\n  if (value && typeof value === 'object' && !Array.isArray(value)) {\n    return {\n      permission: value.permission,\n      role: value.role,\n      mode: value.mode ?? (arg === 'all' ? 'all' : 'any'),\n      combine: value.combine ?? 'and',\n      display: value.display,\n    };\n  }\n\n  if (arg === 'role') {\n    return {\n      role: value as RoleCode | RoleCode[],\n      mode: binding.modifiers.all ? 'all' : 'any',\n      combine: 'and',\n    };\n  }\n\n  return {\n    permission: value as PermissionCode | PermissionCode[],\n    mode: arg === 'all' || binding.modifiers.all ? 'all' : 'any',\n    combine: 'and',\n  };\n}\n\nfunction isAllowed(\n  store: PermissionStore,\n  binding: DirectiveBinding<PermissionDirectiveValue>,\n): boolean {\n  const { permission, role, mode, combine } = parseBinding(binding);\n  const options: CheckOptions = { mode };\n\n  const hasPermCheck = permission !== undefined;\n  const hasRoleCheck = role !== undefined;\n\n  if (!hasPermCheck && !hasRoleCheck) return true;\n\n  const permOk = hasPermCheck ? store.hasPermission(permission!, options) : true;\n  const roleOk = hasRoleCheck ? store.hasRole(role!, options) : true;\n\n  if (hasPermCheck && hasRoleCheck) {\n    return combine === 'or' ? permOk || roleOk : permOk && roleOk;\n  }\n\n  return hasPermCheck ? permOk : roleOk;\n}\n\ntype ElWithPermission = HTMLElement & {\n  __angelPermissionDisplay?: string;\n  __angelPermissionUnsubscribe?: () => void;\n};\n\nfunction applyVisibility(\n  el: ElWithPermission,\n  allowed: boolean,\n  display?: string,\n): void {\n  if (el.__angelPermissionDisplay === undefined) {\n    el.__angelPermissionDisplay = el.style.display;\n  }\n\n  if (allowed) {\n    el.style.display = display ?? el.__angelPermissionDisplay ?? '';\n    el.removeAttribute('aria-hidden');\n  } else {\n    el.style.display = 'none';\n    el.setAttribute('aria-hidden', 'true');\n  }\n}\n\n/**\n * Create a `v-permission` directive bound to a specific store.\n * Prefer installing via `createPermissionPlugin()` which registers this automatically.\n */\nexport function createVPermission(\n  store: PermissionStore,\n): Directive<ElWithPermission, PermissionDirectiveValue> {\n  return {\n    mounted(el, binding) {\n      const update = () => {\n        const { display } = parseBinding(binding);\n        applyVisibility(el, isAllowed(store, binding), display);\n      };\n\n      update();\n      el.__angelPermissionUnsubscribe = store.subscribe(update);\n    },\n\n    updated(el, binding) {\n      const { display } = parseBinding(binding);\n      applyVisibility(el, isAllowed(store, binding), display);\n    },\n\n    unmounted(el) {\n      el.__angelPermissionUnsubscribe?.();\n      delete el.__angelPermissionUnsubscribe;\n      delete el.__angelPermissionDisplay;\n    },\n  };\n}\n","import { computed, defineComponent, type PropType } from 'vue';\nimport type { MatchMode, PermissionCode, RoleCode } from '../core';\nimport { usePermission } from './plugin';\n\n/**\n * Conditionally render slot content based on permission / role.\n *\n * @example\n * <Can permission=\"user:edit\">\n *   <button>Edit</button>\n * </Can>\n *\n * <Can :permission=\"['user:edit', 'user:delete']\" mode=\"all\">\n *   <AdminPanel />\n *   <template #fallback>No access</template>\n * </Can>\n */\nexport const Can = defineComponent({\n  name: 'Can',\n  props: {\n    permission: {\n      type: [String, Array] as PropType<PermissionCode | PermissionCode[]>,\n      default: undefined,\n    },\n    role: {\n      type: [String, Array] as PropType<RoleCode | RoleCode[]>,\n      default: undefined,\n    },\n    mode: {\n      type: String as PropType<MatchMode>,\n      default: 'any',\n    },\n    combine: {\n      type: String as PropType<'and' | 'or'>,\n      default: 'and',\n    },\n  },\n  setup(props, { slots }) {\n    const { hasPermission, hasRole, permissions, roles, isSuperAdmin } = usePermission();\n\n    const allowed = computed(() => {\n      void permissions.value;\n      void roles.value;\n      void isSuperAdmin.value;\n\n      const hasPermCheck = props.permission !== undefined;\n      const hasRoleCheck = props.role !== undefined;\n\n      if (!hasPermCheck && !hasRoleCheck) return true;\n\n      const options = { mode: props.mode };\n      const permOk = hasPermCheck ? hasPermission(props.permission!, options) : true;\n      const roleOk = hasRoleCheck ? hasRole(props.role!, options) : true;\n\n      if (hasPermCheck && hasRoleCheck) {\n        return props.combine === 'or' ? permOk || roleOk : permOk && roleOk;\n      }\n\n      return hasPermCheck ? permOk : roleOk;\n    });\n\n    return () => {\n      if (allowed.value) {\n        return slots.default?.();\n      }\n      return slots.fallback?.() ?? null;\n    };\n  },\n});\n"],"mappings":"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","names":["import_vue","import_core"]}

package/dist/vue/index.d.cts

@@ -0,0 +1,173 @@
+import * as vue from 'vue';
+import { InjectionKey, ComputedRef, Plugin, Directive, PropType } from 'vue';
+
+type PermissionCode = string;
+type RoleCode = string;
+interface PermissionState {
+    /** Permission codes owned by the current user */
+    permissions: PermissionCode[];
+    /** Roles owned by the current user */
+    roles: RoleCode[];
+    /** Super admin bypasses all checks when true */
+    isSuperAdmin?: boolean;
+}
+type MatchMode = 'all' | 'any';
+interface CheckOptions {
+    /**
+     * `any` — pass when at least one code matches (default)
+     * `all` — pass only when every code matches
+     */
+    mode?: MatchMode;
+}
+type PermissionListener = (state: PermissionState) => void;
+interface PermissionChecker {
+    hasPermission(codes: PermissionCode | PermissionCode[], options?: CheckOptions): boolean;
+    hasRole(codes: RoleCode | RoleCode[], options?: CheckOptions): boolean;
+    can(codes: PermissionCode | PermissionCode[], options?: CheckOptions): boolean;
+    getState(): PermissionState;
+}
+
+/**
+ * Mutable permission store shared by React / Vue adapters.
+ * Framework-agnostic — safe to use in Node, browser, or any UI lib.
+ */
+declare class PermissionStore implements PermissionChecker {
+    private state;
+    private permissionSet;
+    private roleSet;
+    private listeners;
+    constructor(initial?: Partial<PermissionState>);
+    getState(): PermissionState;
+    setState(next: Partial<PermissionState>): void;
+    setPermissions(permissions: PermissionCode[]): void;
+    setRoles(roles: RoleCode[]): void;
+    setSuperAdmin(isSuperAdmin: boolean): void;
+    /** Replace permissions, roles and super-admin flag in one shot (typical after login). */
+    hydrate(payload: Partial<PermissionState>): void;
+    /** Clear all authz data (typical after logout). */
+    clear(): void;
+    hasPermission(codes: PermissionCode | PermissionCode[], options?: CheckOptions): boolean;
+    hasRole(codes: RoleCode | RoleCode[], options?: CheckOptions): boolean;
+    /** Alias of `hasPermission` for template-friendly APIs. */
+    can(codes: PermissionCode | PermissionCode[], options?: CheckOptions): boolean;
+    subscribe(listener: PermissionListener): () => void;
+    private emit;
+}
+declare function createPermissionStore(initial?: Partial<PermissionState>): PermissionStore;
+
+declare const PERMISSION_STORE_KEY: InjectionKey<PermissionStore>;
+interface PermissionPluginOptions {
+    /** Pass an existing store to share across apps. */
+    store?: PermissionStore;
+    /** Initial state when the plugin creates its own store. */
+    initialState?: Partial<PermissionState>;
+    /** Custom directive name. Default: `permission` → `v-permission`. */
+    directiveName?: string;
+}
+declare function createPermissionPlugin(options?: PermissionPluginOptions): Plugin & {
+    store: PermissionStore;
+};
+interface UsePermissionResult {
+    permissions: ComputedRef<PermissionCode[]>;
+    roles: ComputedRef<RoleCode[]>;
+    isSuperAdmin: ComputedRef<boolean>;
+    hasPermission: (codes: PermissionCode | PermissionCode[], options?: CheckOptions) => boolean;
+    hasRole: (codes: RoleCode | RoleCode[], options?: CheckOptions) => boolean;
+    can: (codes: PermissionCode | PermissionCode[], options?: CheckOptions) => boolean;
+    setPermissions: (permissions: PermissionCode[]) => void;
+    setRoles: (roles: RoleCode[]) => void;
+    setSuperAdmin: (isSuperAdmin: boolean) => void;
+    hydrate: (payload: Partial<PermissionState>) => void;
+    clear: () => void;
+    store: PermissionStore;
+}
+/**
+ * Reactive permission API for Vue 3 Composition API.
+ */
+declare function usePermission(store?: PermissionStore): UsePermissionResult;
+declare function useHasPermission(codes: PermissionCode | PermissionCode[], options?: CheckOptions, store?: PermissionStore): ComputedRef<boolean>;
+declare function useHasRole(codes: RoleCode | RoleCode[], options?: CheckOptions, store?: PermissionStore): ComputedRef<boolean>;
+declare module 'vue' {
+    interface ComponentCustomProperties {
+        $permission: PermissionStore;
+        $can: (codes: PermissionCode | PermissionCode[], options?: CheckOptions) => boolean;
+        $hasRole: (codes: RoleCode | RoleCode[], options?: CheckOptions) => boolean;
+    }
+}
+
+type PermissionDirectiveValue = PermissionCode | PermissionCode[] | {
+    permission?: PermissionCode | PermissionCode[];
+    role?: RoleCode | RoleCode[];
+    mode?: MatchMode;
+    /** When both permission and role are set. Default: `and`. */
+    combine?: 'and' | 'or';
+    /** CSS display value when allowed. Default: restores original display. */
+    display?: string;
+};
+type ElWithPermission = HTMLElement & {
+    __angelPermissionDisplay?: string;
+    __angelPermissionUnsubscribe?: () => void;
+};
+/**
+ * Create a `v-permission` directive bound to a specific store.
+ * Prefer installing via `createPermissionPlugin()` which registers this automatically.
+ */
+declare function createVPermission(store: PermissionStore): Directive<ElWithPermission, PermissionDirectiveValue>;
+
+/**
+ * Conditionally render slot content based on permission / role.
+ *
+ * @example
+ * <Can permission="user:edit">
+ *   <button>Edit</button>
+ * </Can>
+ *
+ * <Can :permission="['user:edit', 'user:delete']" mode="all">
+ *   <AdminPanel />
+ *   <template #fallback>No access</template>
+ * </Can>
+ */
+declare const Can: vue.DefineComponent<vue.ExtractPropTypes<{
+    permission: {
+        type: PropType<PermissionCode | PermissionCode[]>;
+        default: undefined;
+    };
+    role: {
+        type: PropType<RoleCode | RoleCode[]>;
+        default: undefined;
+    };
+    mode: {
+        type: PropType<MatchMode>;
+        default: string;
+    };
+    combine: {
+        type: PropType<"and" | "or">;
+        default: string;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>[] | null | undefined, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    permission: {
+        type: PropType<PermissionCode | PermissionCode[]>;
+        default: undefined;
+    };
+    role: {
+        type: PropType<RoleCode | RoleCode[]>;
+        default: undefined;
+    };
+    mode: {
+        type: PropType<MatchMode>;
+        default: string;
+    };
+    combine: {
+        type: PropType<"and" | "or">;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    role: string | string[];
+    permission: string | string[];
+    mode: MatchMode;
+    combine: "and" | "or";
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+export { Can, type CheckOptions, type MatchMode, PERMISSION_STORE_KEY, type PermissionChecker, type PermissionCode, type PermissionDirectiveValue, type PermissionListener, type PermissionPluginOptions, type PermissionState, PermissionStore, type RoleCode, type UsePermissionResult, createPermissionPlugin, createPermissionStore, createVPermission, useHasPermission, useHasRole, usePermission };

package/dist/vue/index.d.ts

@@ -0,0 +1,173 @@
+import * as vue from 'vue';
+import { InjectionKey, ComputedRef, Plugin, Directive, PropType } from 'vue';
+
+type PermissionCode = string;
+type RoleCode = string;
+interface PermissionState {
+    /** Permission codes owned by the current user */
+    permissions: PermissionCode[];
+    /** Roles owned by the current user */
+    roles: RoleCode[];
+    /** Super admin bypasses all checks when true */
+    isSuperAdmin?: boolean;
+}
+type MatchMode = 'all' | 'any';
+interface CheckOptions {
+    /**
+     * `any` — pass when at least one code matches (default)
+     * `all` — pass only when every code matches
+     */
+    mode?: MatchMode;
+}
+type PermissionListener = (state: PermissionState) => void;
+interface PermissionChecker {
+    hasPermission(codes: PermissionCode | PermissionCode[], options?: CheckOptions): boolean;
+    hasRole(codes: RoleCode | RoleCode[], options?: CheckOptions): boolean;
+    can(codes: PermissionCode | PermissionCode[], options?: CheckOptions): boolean;
+    getState(): PermissionState;
+}
+
+/**
+ * Mutable permission store shared by React / Vue adapters.
+ * Framework-agnostic — safe to use in Node, browser, or any UI lib.
+ */
+declare class PermissionStore implements PermissionChecker {
+    private state;
+    private permissionSet;
+    private roleSet;
+    private listeners;
+    constructor(initial?: Partial<PermissionState>);
+    getState(): PermissionState;
+    setState(next: Partial<PermissionState>): void;
+    setPermissions(permissions: PermissionCode[]): void;
+    setRoles(roles: RoleCode[]): void;
+    setSuperAdmin(isSuperAdmin: boolean): void;
+    /** Replace permissions, roles and super-admin flag in one shot (typical after login). */
+    hydrate(payload: Partial<PermissionState>): void;
+    /** Clear all authz data (typical after logout). */
+    clear(): void;
+    hasPermission(codes: PermissionCode | PermissionCode[], options?: CheckOptions): boolean;
+    hasRole(codes: RoleCode | RoleCode[], options?: CheckOptions): boolean;
+    /** Alias of `hasPermission` for template-friendly APIs. */
+    can(codes: PermissionCode | PermissionCode[], options?: CheckOptions): boolean;
+    subscribe(listener: PermissionListener): () => void;
+    private emit;
+}
+declare function createPermissionStore(initial?: Partial<PermissionState>): PermissionStore;
+
+declare const PERMISSION_STORE_KEY: InjectionKey<PermissionStore>;
+interface PermissionPluginOptions {
+    /** Pass an existing store to share across apps. */
+    store?: PermissionStore;
+    /** Initial state when the plugin creates its own store. */
+    initialState?: Partial<PermissionState>;
+    /** Custom directive name. Default: `permission` → `v-permission`. */
+    directiveName?: string;
+}
+declare function createPermissionPlugin(options?: PermissionPluginOptions): Plugin & {
+    store: PermissionStore;
+};
+interface UsePermissionResult {
+    permissions: ComputedRef<PermissionCode[]>;
+    roles: ComputedRef<RoleCode[]>;
+    isSuperAdmin: ComputedRef<boolean>;
+    hasPermission: (codes: PermissionCode | PermissionCode[], options?: CheckOptions) => boolean;
+    hasRole: (codes: RoleCode | RoleCode[], options?: CheckOptions) => boolean;
+    can: (codes: PermissionCode | PermissionCode[], options?: CheckOptions) => boolean;
+    setPermissions: (permissions: PermissionCode[]) => void;
+    setRoles: (roles: RoleCode[]) => void;
+    setSuperAdmin: (isSuperAdmin: boolean) => void;
+    hydrate: (payload: Partial<PermissionState>) => void;
+    clear: () => void;
+    store: PermissionStore;
+}
+/**
+ * Reactive permission API for Vue 3 Composition API.
+ */
+declare function usePermission(store?: PermissionStore): UsePermissionResult;
+declare function useHasPermission(codes: PermissionCode | PermissionCode[], options?: CheckOptions, store?: PermissionStore): ComputedRef<boolean>;
+declare function useHasRole(codes: RoleCode | RoleCode[], options?: CheckOptions, store?: PermissionStore): ComputedRef<boolean>;
+declare module 'vue' {
+    interface ComponentCustomProperties {
+        $permission: PermissionStore;
+        $can: (codes: PermissionCode | PermissionCode[], options?: CheckOptions) => boolean;
+        $hasRole: (codes: RoleCode | RoleCode[], options?: CheckOptions) => boolean;
+    }
+}
+
+type PermissionDirectiveValue = PermissionCode | PermissionCode[] | {
+    permission?: PermissionCode | PermissionCode[];
+    role?: RoleCode | RoleCode[];
+    mode?: MatchMode;
+    /** When both permission and role are set. Default: `and`. */
+    combine?: 'and' | 'or';
+    /** CSS display value when allowed. Default: restores original display. */
+    display?: string;
+};
+type ElWithPermission = HTMLElement & {
+    __angelPermissionDisplay?: string;
+    __angelPermissionUnsubscribe?: () => void;
+};
+/**
+ * Create a `v-permission` directive bound to a specific store.
+ * Prefer installing via `createPermissionPlugin()` which registers this automatically.
+ */
+declare function createVPermission(store: PermissionStore): Directive<ElWithPermission, PermissionDirectiveValue>;
+
+/**
+ * Conditionally render slot content based on permission / role.
+ *
+ * @example
+ * <Can permission="user:edit">
+ *   <button>Edit</button>
+ * </Can>
+ *
+ * <Can :permission="['user:edit', 'user:delete']" mode="all">
+ *   <AdminPanel />
+ *   <template #fallback>No access</template>
+ * </Can>
+ */
+declare const Can: vue.DefineComponent<vue.ExtractPropTypes<{
+    permission: {
+        type: PropType<PermissionCode | PermissionCode[]>;
+        default: undefined;
+    };
+    role: {
+        type: PropType<RoleCode | RoleCode[]>;
+        default: undefined;
+    };
+    mode: {
+        type: PropType<MatchMode>;
+        default: string;
+    };
+    combine: {
+        type: PropType<"and" | "or">;
+        default: string;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>[] | null | undefined, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    permission: {
+        type: PropType<PermissionCode | PermissionCode[]>;
+        default: undefined;
+    };
+    role: {
+        type: PropType<RoleCode | RoleCode[]>;
+        default: undefined;
+    };
+    mode: {
+        type: PropType<MatchMode>;
+        default: string;
+    };
+    combine: {
+        type: PropType<"and" | "or">;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    role: string | string[];
+    permission: string | string[];
+    mode: MatchMode;
+    combine: "and" | "or";
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+export { Can, type CheckOptions, type MatchMode, PERMISSION_STORE_KEY, type PermissionChecker, type PermissionCode, type PermissionDirectiveValue, type PermissionListener, type PermissionPluginOptions, type PermissionState, PermissionStore, type RoleCode, type UsePermissionResult, createPermissionPlugin, createPermissionStore, createVPermission, useHasPermission, useHasRole, usePermission };