@quazardous/qdadm 1.19.3 → 1.19.5

package/README.md

@@ -106,6 +106,27 @@ Options: `transformRequest`, `transformResponse`, `responseFormat`, `clientSideP
 - primevue ^4.0.0
 - pinia ^2.0.0
 
+## Consuming via `file:` link from a sibling monorepo
+
+If you install qdadm with a `file:../path/to/qdadm` link instead of from npm — typically during local development on qdadm itself, or before a release lands — pnpm/npm resolves the symlink into the qdadm-monorepo's hoisted `node_modules`. That can pull a *second* copy of `primevue` (and `vue`, `vue-router`, `@primeuix/themes`) into your host bundle even though qdadm itself only declares them as peers.
+
+Symptom: PrimeVue components render without their Aura preset tokens — component-level CSS variables (`--p-paginator-nav-button-width`, etc.) end up undefined, so paginator buttons collapse to 16×16, datatables lose padding, rounded corners disappear. Plugin singletons rely on a shared runtime registry; two instances split the registry in half.
+
+Fix in the host's bundler config — `dedupe` collapses duplicates back to a single resolved copy:
+
+```ts
+// vite.config.ts
+export default defineConfig({
+  resolve: {
+    dedupe: ['vue', 'vue-router', 'primevue', '@primeuix/themes'],
+  },
+})
+```
+
+This is the canonical Vite/Webpack pattern for Vue plugin singletons. The `file:` link can stay in place — useful for hot-reload during qdadm development — and the dedupe ensures only one instance of each peer ends up in the bundle.
+
+Installing qdadm from npm (`@quazardous/qdadm@^1.19.3`) doesn't have this issue: the published tarball ships no `node_modules/`, so peers always resolve from the host. The trap is specific to `file:` / `workspace:` links onto a package that lives inside another monorepo.
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quazardous/qdadm",
-  "version": "1.19.3",
+  "version": "1.19.5",
   "description": "Vue 3 framework for admin dashboards with PrimeVue",
   "author": "quazardous",
   "license": "MIT",
@@ -81,6 +81,7 @@
   ],
   "devDependencies": {
     "@eslint/js": "^9.39.2",
+    "@primeuix/themes": "^1.0.0",
     "@types/node": "^25.0.6",
     "@vitejs/plugin-vue": "^6.0.0",
     "@vue/test-utils": "^2.4.6",
@@ -92,6 +93,7 @@
     "globals": "^17.0.0",
     "jsdom": "^25.0.1",
     "prettier": "^3.7.4",
+    "primevue": "^4.0.0",
     "sass": "^1.97.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.52.0",

package/src/components/edit/FormPage.vue

@@ -160,6 +160,7 @@ function onGuardStay(): void {
           :label="action.label"
           :icon="action.icon"
           :severity="action.severity"
+          :size="action.size || 'small'"
           :loading="action.isLoading"
           :disabled="action.isDisabled"
           @click="action.onClick"

package/src/components/lists/ListPage.vue

@@ -25,7 +25,7 @@ import Button from 'primevue/button'
 import Select from 'primevue/select'
 import AutoComplete from 'primevue/autocomplete'
 import SplitButton from 'primevue/splitbutton'
-import type { FilterConfig, CardConfig, ResolvedAction, ResolvedHeaderAction as BaseResolvedHeaderAction } from '../../composables/useListPage'
+import type { FilterConfig, CardConfig, ResolvedAction, ResolvedHeaderAction } from '../../composables/useListPage'
 
 /**
  * Header action state for label function (matches useListPage)
@@ -41,13 +41,6 @@ interface HeaderActionState {
  */
 type LabelType = string | ((state: HeaderActionState) => string)
 
-/**
- * Extended header action with optional size property used in template
- */
-interface ResolvedHeaderAction extends BaseResolvedHeaderAction {
-  size?: string
-}
-
 /**
  * Autocomplete event interface
  */

package/src/composables/useEntityItemFormPage.types.ts

@@ -79,6 +79,7 @@ export interface ActionConfig {
   label: string
   icon?: string
   severity?: string
+  size?: string
   onClick: () => void | Promise<void>
   visible?: (ctx: { isEdit: boolean; dirty: boolean }) => boolean
   disabled?: (ctx: { dirty: boolean; saving: boolean }) => boolean

package/src/composables/useListPage.types.ts

@@ -146,6 +146,7 @@ export interface HeaderActionConfig {
   label: string | ((state: HeaderActionState) => string)
   icon?: string
   severity?: string
+  size?: string
   onClick: () => void | Promise<void>
   visible?: (state: HeaderActionState) => boolean
   loading?: (state: HeaderActionState) => boolean

package/src/gen/generateManagers.test.js

@@ -427,9 +427,12 @@ describe('generateManagers', () => {
       // Storage must be parameterized in class mode too — same TS2322
       // assignability problem as instance mode if we drop the generic.
       expect(content).toContain('new ApiStorage<UsersEntity>(')
-      // Constructor signature should accept a typed storage override, not `unknown`
-      expect(content).toContain("import type { EntityRecord, IStorage } from '@quazardous/qdadm'")
-      expect(content).toContain('storage: IStorage<UsersEntity>')
+      // Constructor signature delegates to the parent's options type so
+      // `fields: Record<string, FieldConfig>` doesn't widen on spread (TS2345).
+      expect(content).toContain("import type { EntityRecord, EntityManagerOptions } from '@quazardous/qdadm'")
+      expect(content).toContain('options: Partial<EntityManagerOptions<UsersEntity>>')
+      expect(content).not.toContain('Record<string, unknown>')
+      expect(content).not.toContain('[key: string]: unknown')
     })
   })
 

package/src/gen/generateManagers.ts

@@ -241,7 +241,7 @@ function generateManagerSource(
  */
 
 import { EntityManager } from '@quazardous/qdadm'
-import type { EntityRecord, IStorage } from '@quazardous/qdadm'
+import type { EntityRecord, EntityManagerOptions } from '@quazardous/qdadm'
 import { ${storageClass} } from '${storageImport}'
 
 ${entityInterface}
@@ -252,7 +252,7 @@ ${entityInterface}
  * @extends EntityManager
  */
 export class Generated${className}Manager extends EntityManager<${className}Entity> {
-  constructor(options: Partial<{ name: string; idField: string; fields: Record<string, unknown>; storage: IStorage<${className}Entity>; [key: string]: unknown }> = {}) {
+  constructor(options: Partial<EntityManagerOptions<${className}Entity>> = {}) {
     super({
       ...${serializeValue(managerOptions, 2)},
       storage: new ${storageClass}<${className}Entity>(${serializeValue(fullStorageOptions, 2)}),

package/src/generated/managers/testManager.js

@@ -1,45 +0,0 @@
-/**
- * TestManager - Auto-generated EntityManager
- *
- * Generated by qdadm/gen/generateManagers
- * DO NOT EDIT MANUALLY - Changes will be overwritten
- *
- * Entity: test
- * Endpoint: /test
- */
-
-import { EntityManager } from '@quazardous/qdadm'
-import { ApiStorage } from '@quazardous/qdadm'
-
-/**
- * Schema definition for test
- * @type {import('qdadm/gen').UnifiedEntitySchema}
- */
-export const testSchema = {
-  name: "test",
-  endpoint: "/test",
-  fields: {}
-}
-
-/**
- * Storage options for test
- */
-const storageOptions = {
-  endpoint: "/test"
-}
-
-/**
- * TestManager instance
- *
- * Provides CRUD operations for test entity.
- *
- * @type {EntityManager}
- */
-export const testManager = new EntityManager({
-  ...{
-  name: "test",
-  idField: "id",
-  fields: {}
-},
-  storage: new ApiStorage(storageOptions)
-})