@quazardous/qdadm 2.4.4 → 2.5.0

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) {

package/src/orchestrator/useOrchestrator.ts

@@ -16,13 +16,24 @@ import { inject } from 'vue'
 import type { Orchestrator } from './Orchestrator'
 import type { EntityManager } from '../entity/EntityManager'
 import type { EntityRecord } from '../types'
+// Type-only circular import: QdadmManagerRegistry must live in the package
+// entry (module augmentation does not merge through re-export aliases).
+import type { QdadmManagerRegistry } from '../index'
 
 /**
  * Return type for useOrchestrator
+ *
+ * `getManager` resolves through the consumer-augmentable
+ * QdadmManagerRegistry first (#1253): a declared entity name returns its
+ * concrete manager subclass; anything else falls back to the historical
+ * `EntityManager<T>` signature.
  */
 export interface UseOrchestratorReturn {
   orchestrator: Orchestrator
-  getManager: <T extends EntityRecord = EntityRecord>(name: string) => EntityManager<T>
+  getManager: {
+    <K extends keyof QdadmManagerRegistry>(name: K): QdadmManagerRegistry[K]
+    <T extends EntityRecord = EntityRecord>(name: string): EntityManager<T>
+  }
   hasManager: (name: string) => boolean
 }
 
@@ -46,8 +57,10 @@ export function useOrchestrator(): UseOrchestratorReturn {
    * Get an EntityManager by name
    * @param name - Entity name
    */
-  function getManager<T extends EntityRecord = EntityRecord>(name: string): EntityManager<T> {
-    return orchestrator.get(name) as EntityManager<T>
+  function getManager<K extends keyof QdadmManagerRegistry>(name: K): QdadmManagerRegistry[K]
+  function getManager<T extends EntityRecord = EntityRecord>(name: string): EntityManager<T>
+  function getManager(name: string): unknown {
+    return orchestrator.get(name)
   }
 
   /**
@@ -74,7 +87,9 @@ export function useOrchestrator(): UseOrchestratorReturn {
  * const { items } = await users.list()
  * ```
  */
-export function useEntity<T extends EntityRecord = EntityRecord>(name: string): EntityManager<T> {
+export function useEntity<K extends keyof QdadmManagerRegistry>(name: K): QdadmManagerRegistry[K]
+export function useEntity<T extends EntityRecord = EntityRecord>(name: string): EntityManager<T>
+export function useEntity(name: string): unknown {
   const { getManager } = useOrchestrator()
-  return getManager<T>(name)
+  return getManager(name)
 }

package/src/utils/humanize.ts

@@ -0,0 +1,26 @@
+/**
+ * Field-name humanization (#1255)
+ *
+ * Turns machine field names into presentable labels:
+ *   'botUuid'      → 'Bot Uuid'
+ *   'created_at'   → 'Created At'
+ *   'filter.botId' → 'Filter Bot Id'
+ *
+ * Shared by the list column binding helper (useListPage.column()) and the
+ * OpenAPI connector's opt-in label inference — dependency-free so the gen
+ * side (node) can import it too.
+ */
+
+/**
+ * Humanize a field name: split camelCase, snake_case, kebab-case and dotted
+ * segments into words, then capitalize each word.
+ */
+export function humanizeFieldName(field: string): string {
+  return field
+    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+    .replace(/[_\-.]+/g, ' ')
+    .trim()
+    .split(/\s+/)
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+    .join(' ')
+}

package/src/utils/index.ts

@@ -21,6 +21,9 @@ export {
 // Error formatting
 export { formatFetchError, type FetchErrorLike } from './errors'
 
+// Field-name humanization
+export { humanizeFieldName } from './humanize'
+
 // Transformers
 export {
   toKeyValueArray,