@latte-macchiat-io/latte-payload 1.0.6 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +83 -4
  2. package/package.json +13 -13
package/README.md CHANGED
@@ -22,19 +22,94 @@ pnpm add @latte-macchiat-io/latte-payload
22
22
  ## Peer Dependencies
23
23
 
24
24
  ```bash
25
- pnpm add payload @payloadcms/db-postgres @payloadcms/next @payloadcms/richtext-lexical react react-dom next sharp
25
+ pnpm add payload@3.64.0 \
26
+ @payloadcms/db-postgres@3.64.0 \
27
+ @payloadcms/next@3.64.0 \
28
+ @payloadcms/richtext-lexical@3.64.0 \
29
+ @payloadcms/ui@3.64.0 \
30
+ react@19.0.0 \
31
+ react-dom@19.0.0 \
32
+ next@15.0.0 \
33
+ sharp@0.34.0
26
34
  ```
27
35
 
28
36
  ### Optional Dependencies
29
37
 
30
38
  ```bash
31
39
  # For email functionality
32
- pnpm add @payloadcms/email-resend # or @payloadcms/email-nodemailer
40
+ pnpm add @payloadcms/email-resend@3.64.0 # or @payloadcms/email-nodemailer@3.64.0
33
41
 
34
42
  # For S3 storage
35
- pnpm add @payloadcms/storage-s3
43
+ pnpm add @payloadcms/storage-s3@3.64.0
36
44
  ```
37
45
 
46
+ ## ⚠️ Important: Payload Version Alignment
47
+
48
+ **All `@payloadcms/*` packages and `payload` must be at the exact same version (minimum 3.64.0).**
49
+
50
+ Payload CMS enforces strict version matching across all its packages. If any package has a different version, you'll encounter this error:
51
+
52
+ ```
53
+ Error: Mismatching "payload" dependency versions found
54
+ ```
55
+
56
+ ### Ensuring Version Alignment
57
+
58
+ Add the following to your project's `package.json` to enforce version alignment:
59
+
60
+ ```json
61
+ {
62
+ "pnpm": {
63
+ "overrides": {
64
+ "@payloadcms/db-postgres": "3.64.0",
65
+ "@payloadcms/email-nodemailer": "3.64.0",
66
+ "@payloadcms/email-resend": "3.64.0",
67
+ "@payloadcms/next": "3.64.0",
68
+ "@payloadcms/richtext-lexical": "3.64.0",
69
+ "@payloadcms/storage-s3": "3.64.0",
70
+ "@payloadcms/ui": "3.64.0",
71
+ "payload": "3.64.0"
72
+ }
73
+ }
74
+ }
75
+ ```
76
+
77
+ **For npm users:**
78
+ ```json
79
+ {
80
+ "overrides": {
81
+ "@payloadcms/db-postgres": "3.64.0",
82
+ "@payloadcms/email-nodemailer": "3.64.0",
83
+ "@payloadcms/email-resend": "3.64.0",
84
+ "@payloadcms/next": "3.64.0",
85
+ "@payloadcms/richtext-lexical": "3.64.0",
86
+ "@payloadcms/storage-s3": "3.64.0",
87
+ "@payloadcms/ui": "3.64.0",
88
+ "payload": "3.64.0"
89
+ }
90
+ }
91
+ ```
92
+
93
+ **For yarn users:**
94
+ ```json
95
+ {
96
+ "resolutions": {
97
+ "@payloadcms/db-postgres": "3.64.0",
98
+ "@payloadcms/email-nodemailer": "3.64.0",
99
+ "@payloadcms/email-resend": "3.64.0",
100
+ "@payloadcms/next": "3.64.0",
101
+ "@payloadcms/richtext-lexical": "3.64.0",
102
+ "@payloadcms/storage-s3": "3.64.0",
103
+ "@payloadcms/ui": "3.64.0",
104
+ "payload": "3.64.0"
105
+ }
106
+ }
107
+ ```
108
+
109
+ ### Why This Matters
110
+
111
+ Payload CMS validates that all its packages share the same version to prevent compatibility issues. Even if transitive dependencies (packages installed by other packages) try to pull in different versions, the overrides above will ensure version consistency.
112
+
38
113
  ## Quick Start
39
114
 
40
115
  ### Basic Usage
@@ -389,10 +464,14 @@ import type {
389
464
 
390
465
  ## Version Compatibility
391
466
 
392
- - **Payload CMS**: ^3.64.0
467
+ - **Payload CMS**: >=3.64.0 <4.0.0 (all @payloadcms/* packages must match)
393
468
  - **React**: ^19.0.0
394
469
  - **Next.js**: ^15.0.0
470
+ - **Sharp**: ^0.34.0
395
471
  - **Node.js**: >=22.x
472
+ - **pnpm**: ^10.0.0
473
+
474
+ **Important:** All `@payloadcms/*` packages must be at the same version. Use package manager overrides (see above) to enforce this.
396
475
 
397
476
  ## Contributing
398
477
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@latte-macchiat-io/latte-payload",
3
- "version": "1.0.6",
3
+ "version": "1.0.7",
4
4
  "description": "Reusable Payload CMS collections, utilities, and components for Latte projects",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -59,15 +59,15 @@
59
59
  "zod": "^3.25.76"
60
60
  },
61
61
  "peerDependencies": {
62
- "@payloadcms/db-postgres": "^3.64.0",
63
- "@payloadcms/email-nodemailer": "^3.64.0",
64
- "@payloadcms/email-resend": "^3.64.0",
65
- "@payloadcms/next": "^3.64.0",
66
- "@payloadcms/richtext-lexical": "^3.64.0",
67
- "@payloadcms/storage-s3": "^3.64.0",
68
- "@payloadcms/ui": "^3.64.0",
62
+ "@payloadcms/db-postgres": ">=3.64.0 <4.0.0",
63
+ "@payloadcms/email-nodemailer": ">=3.64.0 <4.0.0",
64
+ "@payloadcms/email-resend": ">=3.64.0 <4.0.0",
65
+ "@payloadcms/next": ">=3.64.0 <4.0.0",
66
+ "@payloadcms/richtext-lexical": ">=3.64.0 <4.0.0",
67
+ "@payloadcms/storage-s3": ">=3.64.0 <4.0.0",
68
+ "@payloadcms/ui": ">=3.64.0 <4.0.0",
69
69
  "next": "^15.0.0",
70
- "payload": "^3.64.0",
70
+ "payload": ">=3.64.0 <4.0.0",
71
71
  "react": "^19.0.0",
72
72
  "react-dom": "^19.0.0",
73
73
  "sharp": "^0.34.0"
@@ -84,7 +84,7 @@
84
84
  }
85
85
  },
86
86
  "devDependencies": {
87
- "@payloadcms/db-sqlite": "^3.64.0",
87
+ "@payloadcms/db-sqlite": ">=3.64.0 <4.0.0",
88
88
  "@testing-library/jest-dom": "^6.6.3",
89
89
  "@testing-library/react": "^16.1.0",
90
90
  "@types/node": "^20.6.0",
@@ -101,11 +101,11 @@
101
101
  "eslint-plugin-storybook": "^10.1.6",
102
102
  "happy-dom": "^20.0.11",
103
103
  "prettier": "^3.7.4",
104
- "typedoc": "^0.27.5",
105
- "typedoc-plugin-markdown": "^4.3.3",
104
+ "typedoc": "^0.28.16",
105
+ "typedoc-plugin-markdown": "^4.9.0",
106
106
  "typescript": "^5.9.2",
107
107
  "typescript-eslint": "^8.21.0",
108
- "vitest": "^2.1.8"
108
+ "vitest": "^4.0.17"
109
109
  },
110
110
  "engines": {
111
111
  "node": ">=22.x",