[DO NOT MERGE ] feat: next

.changeset/config.json

@@ -7,9 +7,17 @@
     }
   ],
   "ignore": [
+    "@contentful/f36-typography",
+    "@contentful/f36-codemod",
+    "@contentful/f36-icon",
+    "@contentful/f36-icons",
+    "@contentful/f36-avatar",
+    "@contentful/f36-image",
+    "@contentful/f36-header",
     "@contentful/f36-layout",
     "@contentful/f36-progress-stepper",
     "@contentful/f36-navlist",
+    "@contentful/f36-navbar",
     "@contentful/f36-website"
   ],
   "commit": false,
@@ -59,4 +67,4 @@
   "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
     "onlyUpdatePeerDependentsWhenOutOfRange": true
   }
-}
+}

.eslintignore

@@ -10,3 +10,6 @@ tsup.config.ts
 # next.js
 **/.next/
 **/out/
+
+# codemod tests
+**/__testfixtures__

BUILD.md

@@ -0,0 +1,34 @@
+# Building
+
+We are using [tsup](https://tsup.egoist.dev/) and [esbuild](https://esbuild.github.io/) together with [Microbundle](https://www.npmjs.com/package/microbundle) to build our component library.
+
+Each component builds to its own `dist` directory with:
+
+- `index.d.ts` – TypeScript type declaration file
+- `index.js` – CJS (CommonJS)
+- `index.modern.mjs` – [Modern](https://github.com/developit/microbundle#-modern-mode-) output (work in all modern browsers)
+- `index.module.js` – legacy ESM (ES Modules) output (for bundlers)
+- `index.umd.js` – legacy UMD (Universal Module Definition) output (for Node & CDN use)
+
+## Create a build of the library
+
+```bash
+npm run-script build
+```
+
+## v5 alpha/beta pre-releases
+
+> [!WARNING]
+>
+> Revisit the build setup before the v5 release
+
+We aim to emit ESM only in our next major release.
+
+Until then, we emit CJS and ESM using a dual-package approach with `tsc` and [tsconfig-to-dual-package](https://github.com/azu/tsconfig-to-dual-package/tree/main).
+
+This ensures Node/TypeScript point to the right package type (commonjs, module) depending on the consumer's configuration, without the hassle of us to "hack" the main `package.json` and `tsconfig` to satisfy all use cases.
+
+The build has the following structure in its own `dist` directory:
+
+- `./cjs` – CJS (CommonJS) with declaration + inline source map.
+- `./esm` – ESM (ES Modules) with declaration + inline source map.

jest.config.js

@@ -71,11 +71,12 @@ module.exports = {
   moduleNameMapper: {
     '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$':
       '<rootDir>/scripts/test/__mocks__/fileMock.js',
+    '(.+)\\.js': '$1',
     '@/scripts/(.*)': '<rootDir>/scripts/$1',
   },
 
   // An array of regexp pattern strings, matched against all module paths before considered 'visible' to the module loader
-  // modulePathIgnorePatterns: [],
+  modulePathIgnorePatterns: ['/dist/'],
 
   // Activates notifications for test results
   // notify: false,