date-fns v3 updates

.github/workflows/publish.yml

@@ -16,6 +16,8 @@ jobs:
         with:
           node-version: '20.x'
           registry-url: 'https://registry.npmjs.org'
+      - name: Install latest npm
+        run: npm install -g npm@latest
       - name: Install Dependencies
         run: npm ci --ignore-scripts
       - name: Audit Signatures

README.md

@@ -17,10 +17,10 @@ and date manipulation functions provided by date-fns. Features:
 Temporal (vs the millisecond precision of standard Date built-in) is useful for webservices recording the time of events, where concurrent activity may occur and millisecond precision does not provide adequate uniqueness and ordering.
 
 The [`date-fns`](https://date-fns.org) library is included. The only locale currently supported is `en-US`, but otherwise contains all
-available functionality as of v2.29.1.
+available functionality as of v3.6.0.
 
 Additionally, the [`date-fns-tz`](https://github.com/marnusw/date-fns-tz) library is included. Contains all
-available functionality as of v1.3.7.
+available functionality as of v1.3.7 except fp.
 
 ### `formatUtc`
 
@@ -76,3 +76,14 @@ The reference documentation is here: https://tc39.es/proposal-temporal/docs/
 The documentation for `date-fns` is here: https://date-fns.org/
 
 The documentation for `date-fns-tz` is here: https://github.com/marnusw/date-fns-tz
+
+### Maintenance notes:
+
+When update the latest code from the original repositories, except making all the necessary changes to make them fully typescript compatible, please remember to carry over the patches to overcoming the following issues:
+
+- spring-forward support
+- nanosecond support
+
+please search for `[PATCH:]` in the existing codebase.
+
+The date-fns tests files are renamed from `test.ts` to `test.mts` so that they can be excluded from being processed by builder bundling. It's a workaround until better approach is available to have a unified control over both regular compilation and bundling.