From 7aa6a913ba2ea63e5d8c6cd722d6d7f94c56905d Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Mon, 23 Oct 2023 09:17:08 +0000
Subject: [PATCH] chore: release (prerelease)

---
 .changeset/pre.json |  5 ++++-
 CHANGELOG.md        | 24 ++++++++++++++++++++++++
 package.json        |  2 +-
 3 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/.changeset/pre.json b/.changeset/pre.json
index 055548ee1..29a4926e8 100644
--- a/.changeset/pre.json
+++ b/.changeset/pre.json
@@ -4,5 +4,8 @@
   "initialVersions": {
     "style-dictionary": "3.8.0"
   },
-  "changesets": []
+  "changesets": [
+    "big-worms-collect-2",
+    "big-worms-collect"
+  ]
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b2a23368f..549e98c93 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,29 @@
 # Changelog
 
+## 4.0.0-prerelease.0
+
+### Major Changes
+
+- dcbe2fb:
+
+  - The project has been fully converted to [ESM format](https://nodejs.org/api/esm.html), which is also the format that the browser uses.
+    For users, this means you'll have to either use Style-Dictionary in ESM JavaScript code, or dynamically import it into your CommonJS code.
+  - `Style-Dictionary.extend()` method is now asynchronous, which means it returns `Promise<StyleDictionary.Core>` instead of `StyleDictionary.Core`.
+  - `allProperties` / `properties` was deprecated in v3, and is now removed from `StyleDictionary.Core`, use `allTokens` and `tokens` instead.
+  - Templates and the method `registerTemplate` were deprecated in v3, now removed. Use Formats instead.
+  - The package now uses [package entrypoints](https://nodejs.org/api/packages.html), which means that what is importable from the package is locked down to just the specified entrypoints: `style-dictionary` & `style-dictionary/fs`. If more is needed, please raise an issue explaining which file you were importing and why you need it to be public API.
+
+### Minor Changes
+
+- dcbe2fb: FileSystem that is used by Style-Dictionary can now be customized:
+
+  ```js
+  import { setFs } from 'style-dictionary/fs';
+  setFs(myFileSystemShim);
+  ```
+
+  By default, it uses an in-memory filesystem shim `@bundled-es-modules/memfs` in browser context, `node:fs` built-in module in Node context.
+
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
 ## [3.8.0](https://github.com/amzn/style-dictionary/compare/v3.7.2...v3.8.0) (2023-04-25)
diff --git a/package.json b/package.json
index 418a56e2a..e5a72c570 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "style-dictionary",
-  "version": "3.8.0",
+  "version": "4.0.0-prerelease.0",
   "description": "Style once, use everywhere. A build system for creating cross-platform styles.",
   "keywords": [
     "style dictionary",