@quazardous/qdadm 2.4.4 → 2.4.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quazardous/qdadm",
-  "version": "2.4.4",
+  "version": "2.4.5",
   "description": "Vue 3 framework for admin dashboards with PrimeVue",
   "author": "quazardous",
   "license": "MIT",

package/src/entity/EntityManager.ts

@@ -501,10 +501,7 @@ export class EntityManager<T extends EntityRecord = EntityRecord> {
    * Check if SecurityChecker is configured via authAdapter
    */
   protected _hasSecurityChecker(): boolean {
-    return (
-      (this.authAdapter as unknown as { _securityChecker?: unknown })
-        ?._securityChecker != null
-    )
+    return this.authAdapter?.hasSecurityChecker?.() ?? false
   }
 
   /**

package/src/entity/auth/EntityAuthAdapter.ts

@@ -41,6 +41,16 @@ export class EntityAuthAdapter {
     this._securityChecker = checker
   }
 
+  /**
+   * Whether a SecurityChecker is configured (#1196).
+   *
+   * Public capability probe — EntityManager used to reach into the
+   * private _securityChecker field through a cast.
+   */
+  hasSecurityChecker(): boolean {
+    return this._securityChecker != null
+  }
+
   /**
    * Check if current user is granted an attribute (Symfony-like contract)
    *

package/src/entity/auth/SecurityChecker.ts

@@ -52,28 +52,24 @@ export interface SecurityCheckerConfig {
  */
 export class SecurityChecker {
   protected _rolesProvider: RoleProvider
-  protected _legacyRoleHierarchy: RoleHierarchy | null
   readonly getCurrentUser: () => AuthUser | null
 
   constructor({ rolesProvider, roleHierarchy, rolePermissions, getCurrentUser }: SecurityCheckerOptions) {
-    // Support both new rolesProvider and legacy rolePermissions
     if (rolesProvider) {
       this._rolesProvider = rolesProvider
-      this._legacyRoleHierarchy = null
     } else {
-      // Legacy: create static provider from rolePermissions
+      // Legacy options (roleHierarchy/rolePermissions) are normalized ONCE
+      // into a static provider (#1196) — the parallel _legacyRoleHierarchy
+      // branch is gone; only the provider path remains.
       const hierarchyConfig =
-        roleHierarchy instanceof RoleHierarchy ? {} : (roleHierarchy as RoleHierarchyConfig) || {}
+        roleHierarchy instanceof RoleHierarchy
+          ? roleHierarchy.map
+          : (roleHierarchy as RoleHierarchyConfig) || {}
 
       this._rolesProvider = new StaticRoleProvider({
         role_hierarchy: hierarchyConfig,
         role_permissions: rolePermissions || {},
       })
-
-      this._legacyRoleHierarchy =
-        roleHierarchy instanceof RoleHierarchy
-          ? roleHierarchy
-          : new RoleHierarchy(hierarchyConfig)
     }
 
     this.getCurrentUser = getCurrentUser
@@ -83,9 +79,6 @@ export class SecurityChecker {
    * Get role hierarchy (dynamically resolved from rolesProvider)
    */
   get roleHierarchy(): RoleHierarchy {
-    if (this._legacyRoleHierarchy) {
-      return this._legacyRoleHierarchy
-    }
     return new RoleHierarchy(this._rolesProvider.getHierarchy())
   }
 

package/src/kernel/Kernel.api.ts

@@ -1,14 +1,14 @@
 import type { AxiosLikeClient, AxiosError } from './Kernel.types'
+import type { Kernel } from './Kernel'
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+// #1196 Phase B — this-typing against the real Kernel shape (was Self = any)
+type Self = Kernel
 
 /**
  * Patch Kernel prototype with API client methods.
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyApiMethods(KernelClass: { prototype: any }): void {
-  const proto = KernelClass.prototype as Self
+export function applyApiMethods(KernelClass: { prototype: Kernel }): void {
+  const proto = KernelClass.prototype
 
   /**
    * Setup an axios client with automatic auth and error handling

package/src/kernel/Kernel.auth.ts

@@ -1,14 +1,14 @@
 import { authFactory, CompositeAuthAdapter } from '../entity/auth'
+import type { Kernel } from './Kernel'
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+// #1196 Phase B — this-typing against the real Kernel shape (was Self = any)
+type Self = Kernel
 
 /**
  * Patch Kernel prototype with auth-related methods.
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyAuthMethods(KernelClass: { prototype: any }): void {
-  const proto = KernelClass.prototype as Self
+export function applyAuthMethods(KernelClass: { prototype: Kernel }): void {
+  const proto = KernelClass.prototype
 
   /**
    * Resolve entityAuthAdapter through authFactory

package/src/kernel/Kernel.i18n.ts

@@ -9,13 +9,13 @@
 
 import { I18n } from '../i18n/I18n'
 import type { I18nOptions } from '../i18n/types'
+import type { Kernel } from './Kernel'
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+// #1196 Phase B — this-typing against the real Kernel shape (was Self = any)
+type Self = Kernel
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyI18nMethods(KernelClass: { prototype: any }): void {
-  const proto = KernelClass.prototype as Self
+export function applyI18nMethods(KernelClass: { prototype: Kernel }): void {
+  const proto = KernelClass.prototype
 
   proto._createI18n = function (this: Self): void {
     const opts = (this.options.i18n as I18nOptions | undefined) ?? {}

package/src/kernel/Kernel.modules.ts

@@ -1,15 +1,15 @@
 import { initModules, setSectionOrder } from '../module/moduleRegistry'
 import { createModuleLoader, type ModuleLike } from './ModuleLoader'
 import { createKernelContext, type KernelContext } from './KernelContext'
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+import type { Kernel } from './Kernel'
+// #1196 Phase B — this-typing against the real Kernel shape (was Self = any)
+type Self = Kernel
 
 /**
  * Patch Kernel prototype with module-related methods.
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyModuleMethods(KernelClass: { prototype: any }): void {
-  const proto = KernelClass.prototype as Self
+export function applyModuleMethods(KernelClass: { prototype: Kernel }): void {
+  const proto = KernelClass.prototype
 
   /**
    * Fire entity cache warmups

package/src/kernel/Kernel.registries.ts

@@ -13,15 +13,15 @@ import { ActiveStack } from '../chain/ActiveStack.js'
 import { StackHydrator } from '../chain/StackHydrator.js'
 import { Orchestrator } from '../orchestrator/Orchestrator'
 import type { EntityAuthAdapter } from '../entity/auth/EntityAuthAdapter'
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+import type { Kernel } from './Kernel'
+// #1196 Phase B — this-typing against the real Kernel shape (was Self = any)
+type Self = Kernel
 
 /**
  * Patch Kernel prototype with registry-related methods.
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyRegistryMethods(KernelClass: { prototype: any }): void {
-  const proto = KernelClass.prototype as Self
+export function applyRegistryMethods(KernelClass: { prototype: Kernel }): void {
+  const proto = KernelClass.prototype
 
   /**
    * Create signal bus for event-driven communication.

package/src/kernel/Kernel.routing.ts

@@ -8,15 +8,15 @@ import {
   type RouteRecordNormalized,
 } from 'vue-router'
 import { getRoutes } from '../module/moduleRegistry'
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+import type { Kernel } from './Kernel'
+// #1196 Phase B — this-typing against the real Kernel shape (was Self = any)
+type Self = Kernel
 
 /**
  * Patch Kernel prototype with routing-related methods.
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyRoutingMethods(KernelClass: { prototype: any }): void {
-  const proto = KernelClass.prototype as Self
+export function applyRoutingMethods(KernelClass: { prototype: Kernel }): void {
+  const proto = KernelClass.prototype
 
   /**
    * Create Vue Router.

package/src/kernel/Kernel.vue.ts

@@ -16,8 +16,9 @@ import ToastListener from '../toast/ToastListener.vue'
 import { createQdadm } from '../plugin.js'
 import { createNotificationStore, NOTIFICATION_KEY } from '../notifications/NotificationStore'
 import { I18N_INJECTION_KEY } from '../i18n/useI18n'
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+import type { Kernel } from './Kernel'
+// #1196 Phase B — this-typing against the real Kernel shape (was Self = any)
+type Self = Kernel
 
 /**
  * Reactive reference to the debug bar component, set by the Kernel
@@ -57,9 +58,8 @@ export function setQdadmDebugBar(component: Component | null): void {
 /**
  * Patch Kernel prototype with Vue app creation methods.
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyVueMethods(KernelClass: { prototype: any }): void {
-  const proto = KernelClass.prototype as Self
+export function applyVueMethods(KernelClass: { prototype: Kernel }): void {
+  const proto = KernelClass.prototype
 
   /**
    * Create layout components map for useLayoutResolver

package/src/kernel/KernelContext.entities.ts

@@ -8,13 +8,13 @@ import { managerFactory, type ManagerFactoryContext } from '../entity/factory.js
 import type { EntityManager } from '../entity/EntityManager'
 import { UsersManager } from '../security/UsersManager'
 import type { UserEntityOptions } from './KernelContext.types'
+import type { KernelContext } from './KernelContext'
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+// #1196 Phase B — this-typing against the real KernelContext shape (was Self = any)
+type Self = KernelContext
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyEntityMethods(KernelContextClass: { prototype: any }): void {
-  const proto = KernelContextClass.prototype as Self
+export function applyEntityMethods(KernelContextClass: { prototype: KernelContext }): void {
+  const proto = KernelContextClass.prototype
 
   /**
    * Register an entity manager.

package/src/kernel/KernelContext.events.ts

@@ -12,13 +12,13 @@ import type {
   HookHandler,
   SignalHandler,
 } from './KernelContext.types'
+import type { KernelContext } from './KernelContext'
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+// #1196 Phase B — this-typing against the real KernelContext shape (was Self = any)
+type Self = KernelContext
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyEventMethods(KernelContextClass: { prototype: any }): void {
-  const proto = KernelContextClass.prototype as Self
+export function applyEventMethods(KernelContextClass: { prototype: KernelContext }): void {
+  const proto = KernelContextClass.prototype
 
   proto.on = function (
     this: Self,

package/src/kernel/KernelContext.i18n.ts

@@ -6,13 +6,13 @@
  */
 
 import type { AliasPattern, MessagesBundle, TranslationProvider } from '../i18n/types'
+import type { KernelContext } from './KernelContext'
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+// #1196 Phase B — this-typing against the real KernelContext shape (was Self = any)
+type Self = KernelContext
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyI18nMethods(KernelContextClass: { prototype: any }): void {
-  const proto = KernelContextClass.prototype as Self
+export function applyI18nMethods(KernelContextClass: { prototype: KernelContext }): void {
+  const proto = KernelContextClass.prototype
 
   proto.messages = function (this: Self, locale: string, bundle: MessagesBundle): Self {
     if (this._kernel.i18nInstance) {

package/src/kernel/KernelContext.permissions.ts

@@ -5,13 +5,13 @@
  */
 
 import type { PermissionMeta, PermissionOptions } from './KernelContext.types'
+import type { KernelContext } from './KernelContext'
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+// #1196 Phase B — this-typing against the real KernelContext shape (was Self = any)
+type Self = KernelContext
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyPermissionMethods(KernelContextClass: { prototype: any }): void {
-  const proto = KernelContextClass.prototype as Self
+export function applyPermissionMethods(KernelContextClass: { prototype: KernelContext }): void {
+  const proto = KernelContextClass.prototype
 
   proto.permissions = function (
     this: Self,

package/src/kernel/KernelContext.routing.ts

@@ -21,9 +21,10 @@ import type {
   ParentConfig,
   RouteOptions,
 } from './KernelContext.types'
+import type { KernelContext } from './KernelContext'
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+// #1196 Phase B — this-typing against the real KernelContext shape (was Self = any)
+type Self = KernelContext
 
 /** Singularize a plural word (simple English rules) */
 function singularize(plural: string): string {
@@ -128,9 +129,8 @@ function resolveParentParam(opts: {
   return namespaced
 }
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyRoutingMethods(KernelContextClass: { prototype: any }): void {
-  const proto = KernelContextClass.prototype as Self
+export function applyRoutingMethods(KernelContextClass: { prototype: KernelContext }): void {
+  const proto = KernelContextClass.prototype
 
   proto.routes = function (
     this: Self,

package/src/kernel/KernelContext.types.ts

@@ -20,6 +20,7 @@ import type { DeferredRegistry } from '../deferred/DeferredRegistry.js'
 import type { SecurityChecker } from '../entity/auth/SecurityChecker'
 import type { PermissionRegistry } from '../security/PermissionRegistry'
 import type { I18n } from '../i18n/I18n'
+import type { RouteParamResolverContext } from './KernelContext.routing'
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Internal types — shared across patch modules, not exposed by index.ts
@@ -41,6 +42,10 @@ export interface AuthAdapter {
 export interface KernelOptions {
   debug?: boolean
   authAdapter?: AuthAdapter | null
+  /** Parent route param naming policy for child CRUD families (#1201). */
+  parentParamMode?: 'auto' | 'always' | 'bare'
+  /** Custom parent route param name resolver (#1201) — wins over parentParamMode. */
+  routeParamResolver?: (ctx: RouteParamResolverContext) => string | undefined
   storageResolver?: unknown
   managerResolver?: unknown
   managerRegistry?: Record<string, unknown>

package/src/kernel/KernelContext.zones.ts

@@ -12,13 +12,13 @@
 
 import type { Component } from 'vue'
 import type { BlockConfig, ZoneOptions } from './KernelContext.types'
+import type { KernelContext } from './KernelContext'
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type Self = any
+// #1196 Phase B — this-typing against the real KernelContext shape (was Self = any)
+type Self = KernelContext
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function applyZoneMethods(KernelContextClass: { prototype: any }): void {
-  const proto = KernelContextClass.prototype as Self
+export function applyZoneMethods(KernelContextClass: { prototype: KernelContext }): void {
+  const proto = KernelContextClass.prototype
 
   proto.zone = function (this: Self, name: string, options: ZoneOptions = {}): Self {
     if (this._kernel.zoneRegistry) {