@quazardous/qdadm 2.7.0 → 2.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quazardous/qdadm",
-  "version": "2.7.0",
+  "version": "2.7.1",
   "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,6 +390,17 @@ const showBreadcrumb = computed<boolean>(() => {
           </template>
         </Breadcrumb>
 
+        <!-- View↔Edit mode toggle (#1332/#1341) — 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="layout-navlinks">
           <template v-for="(link, index) in navlinks" :key="link.to?.name || index">
@@ -702,6 +721,24 @@ const showBreadcrumb = computed<boolean>(() => {
   padding-bottom: 0;
 }
 
+/* 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 var(--fad-transition-fast);
+}
+
+.breadcrumb-mode-toggle:hover {
+  color: var(--p-primary-600, #2563eb);
+  text-decoration: underline;
+}
+
 .layout-navlinks {
   display: flex;
   align-items: center;

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 },
         })
       }