@quazardous/qdadm 2.7.0 → 2.7.2

package/README.md

@@ -98,6 +98,7 @@ Options: `transformRequest`, `transformResponse`, `responseFormat`, `clientSideP
 | [QDADM_CREDO](QDADM_CREDO.md) | Philosophy, patterns, concepts |
 | [Page compositions](../../docs/page-compositions.md) | **Start here** — which composition for which need |
 | [CRUD Pages](../../docs/crud.md) | List / form / show / child pages reference |
+| [Navigation](../../docs/navigation.md) | Breadcrumb, sibling navlinks, View↔Edit toggle |
 | [Architecture](../../docs/architecture.md) | PAC pattern, layers |
 | [Extension](../../docs/extension.md) | Decorators, bundles, multi-storage |
 | [Hooks](../../docs/hooks.md) | Alter / invoke registry |

package/package.json

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

package/src/components/layout/AppLayout.vue

@@ -31,6 +31,8 @@ import { version as qdadmVersion } from '../../../package.json'
 interface FeaturesConfig {
   poweredBy?: boolean
   breadcrumb?: boolean
+  /** Opt-in (#1332/#1341): View↔Edit toggle next to the terminal crumb */
+  breadcrumbModeToggle?: boolean
   [key: string]: unknown
 }
 
@@ -239,7 +241,7 @@ watch(() => route.fullPath, () => {
 
 // Navigation context (breadcrumb + navlinks from route config)
 // Entity data comes from activeStack (populated by useEntityItemPage/useEntityItemFormPage)
-const { breadcrumb: defaultBreadcrumb, navlinks: defaultNavlinks } = useNavContext()
+const { breadcrumb: defaultBreadcrumb, navlinks: defaultNavlinks, modeToggle } = useNavContext()
 
 // Allow child pages to override breadcrumb/navlinks via provide/inject
 const breadcrumbOverride = ref<BreadcrumbItem[] | null>(null)
@@ -258,6 +260,12 @@ const showBreadcrumb = computed<boolean>(() => {
   if (route.name === 'dashboard') return false
   return true
 })
+
+// View↔Edit toggle on the terminal crumb (#1332/#1341) — same opt-in contract
+// as DefaultBreadcrumb; this inline breadcrumb must honor the flag too
+const shownModeToggle = computed(() =>
+  features.breadcrumbModeToggle === true ? modeToggle.value : null
+)
 </script>
 
 <template>
@@ -382,8 +390,10 @@ const showBreadcrumb = computed<boolean>(() => {
           </template>
         </Breadcrumb>
 
-        <!-- Navlinks (provided by PageNav for child routes) -->
-        <div v-if="navlinks.length > 0" class="layout-navlinks">
+        <!-- Navlinks (provided by PageNav for child routes) + View↔Edit mode
+             toggle (#1332/#1341) — plain navigation; the form page's own
+             route-leave guard covers unsaved changes on edit→show -->
+        <div v-if="navlinks.length > 0 || shownModeToggle" class="layout-navlinks">
           <template v-for="(link, index) in navlinks" :key="link.to?.name || index">
             <span v-if="index > 0" class="layout-navlinks-separator">|</span>
             <RouterLink
@@ -394,6 +404,15 @@ const showBreadcrumb = computed<boolean>(() => {
               {{ link.label }}
             </RouterLink>
           </template>
+          <template v-if="shownModeToggle">
+            <span v-if="navlinks.length > 0" class="layout-navlinks-separator">|</span>
+            <RouterLink
+              :to="shownModeToggle.to"
+              class="layout-navlink breadcrumb-mode-toggle"
+            >
+              {{ shownModeToggle.label }}
+            </RouterLink>
+          </template>
         </div>
       </div>
 

package/src/components/layout/defaults/DefaultBreadcrumb.vue

@@ -64,19 +64,10 @@ const shownModeToggle = computed(() =>
       </template>
     </Breadcrumb>
 
-    <!-- View↔Edit mode toggle (#1332) — plain navigation; the form page's
-         own route-leave guard covers unsaved changes on edit→show -->
-    <RouterLink
-      v-if="shownModeToggle"
-      :to="shownModeToggle.to"
-      class="breadcrumb-mode-toggle"
-    >
-      <i :class="shownModeToggle.target === 'edit' ? 'pi pi-pencil' : 'pi pi-eye'"></i>
-      <span>{{ shownModeToggle.label }}</span>
-    </RouterLink>
-
-    <!-- Navlinks (provided by PageNav for child routes) -->
-    <div v-if="navlinks.length > 0" class="breadcrumb-navlinks">
+    <!-- Navlinks (provided by PageNav for child routes) + View↔Edit mode
+         toggle (#1332/#1341) — plain navigation; the form page's own
+         route-leave guard covers unsaved changes on edit→show -->
+    <div v-if="navlinks.length > 0 || shownModeToggle" class="breadcrumb-navlinks">
       <template v-for="(link, index) in navlinks" :key="link.to?.name || index">
         <span v-if="index > 0" class="navlinks-separator">|</span>
         <RouterLink
@@ -87,6 +78,15 @@ const shownModeToggle = computed(() =>
           {{ link.label }}
         </RouterLink>
       </template>
+      <template v-if="shownModeToggle">
+        <span v-if="navlinks.length > 0" class="navlinks-separator">|</span>
+        <RouterLink
+          :to="shownModeToggle.to"
+          class="navlink breadcrumb-mode-toggle"
+        >
+          {{ shownModeToggle.label }}
+        </RouterLink>
+      </template>
     </div>
   </div>
 </template>
@@ -111,24 +111,6 @@ const shownModeToggle = computed(() =>
   font-size: 0.875rem;
 }
 
-/* Mode toggle sits right after the crumbs; auto margin keeps navlinks pinned right */
-.breadcrumb-mode-toggle {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.35rem;
-  margin-left: 0.75rem;
-  margin-right: auto;
-  font-size: 0.875rem;
-  color: var(--p-primary-500, #3b82f6);
-  text-decoration: none;
-  transition: color 0.15s;
-}
-
-.breadcrumb-mode-toggle:hover {
-  color: var(--p-primary-700, #1d4ed8);
-  text-decoration: underline;
-}
-
 .navlinks-separator {
   color: var(--p-surface-400, #94a3b8);
 }

package/src/composables/createShowFieldResolver.ts

@@ -39,7 +39,8 @@ export interface ShowFieldDefinition {
   type?: string
   schemaType?: string
   label?: string
-  reference?: string
+  /** Canonical FieldConfig object form, or the entity name as a bare string */
+  reference?: string | { entity: string; labelField?: string; valueField?: string }
   referenceRoute?: string | ((value: unknown) => { name: string; params: Record<string, unknown> })
   referenceLabel?: string | ((value: unknown, option?: unknown) => string)
   options?: unknown[]
@@ -73,6 +74,8 @@ export interface ShowResolvedFieldConfig extends ShowFieldDefinition {
  */
 export interface ShowResolverOrchestrator {
   get: (entityName: string) => ShowResolverManager | undefined
+  /** Real Orchestrator.get THROWS on unknown entities — probe first when available */
+  has?: (entityName: string) => boolean
 }
 
 /**
@@ -133,13 +136,20 @@ export function createShowFieldResolver(
     let resolvedDisplayType = SHOW_TYPE_MAPPINGS[type] || SHOW_TYPE_MAPPINGS[schemaType] || 'text'
     const resolvedLabel = label || snakeCaseToTitle(name)
 
-    // Auto-set reference route if reference entity is specified
+    // Auto-set reference route if reference entity is specified.
+    // FieldConfig.reference is canonically { entity, ... }; the bare-string
+    // form stays accepted. Passing the object to orchestrator.get produced
+    // '[object Object]' lookups that THREW during generateFields (#1341).
     let referenceRoute = rest.referenceRoute
     if (reference && !referenceRoute) {
-      const refManager = orchestrator.get(reference)
+      const refEntity = typeof reference === 'string' ? reference : reference.entity
+      const refManager =
+        refEntity && (!orchestrator.has || orchestrator.has(refEntity))
+          ? orchestrator.get(refEntity)
+          : undefined
       if (refManager) {
         referenceRoute = (value: unknown) => ({
-          name: `${refManager.routePrefix || reference}-show`,
+          name: `${refManager.routePrefix || refEntity}-show`,
           params: { [refManager.idField]: value },
         })
       }