docs

Author: Lukas742

docs/knowledge-base/FAQ.mdx

@@ -117,4 +117,45 @@ import { Button } from '@ui5/webcomponents-react/Button';
 // ...
 ```
 
+## Why Use Direct Imports via Package Export Maps
+
+Since [v2.14.0](https://github.com/UI5/webcomponents-react/releases/tag/v2.14.0), `ui5-webcomponents-react` supports **export maps** through the `exports` field in `package.json` ([documentation](https://nodejs.org/api/packages.html#exports)).
+
+Export maps allow you to import components directly from their package entry points instead of relying on deep file paths or the package root (barrel) files.
+While most bundlers perform tree-shaking in production builds, so only the code you actually use is included, tree-shaking is often limited or disabled in development. If you import from the package root (a “barrel file”), all components and utilities exported from that root are included in the bundle, even those you don’t use.
+
+```ts
+// Root import (less optimal without tree-shaking)
+import { Button, AnalyticalTable } from "@ui5/webcomponents-react";
+
+// Direct import (recommended)
+import { Button } from "@ui5/webcomponents-react/Button";
+import { AnalyticalTable } from "@ui5/webcomponents-react/AnalyticalTable";
+```
+
+### Codemod
+
+To migrate from root imports to direct imports, you can use the `exports-map` codemod from the [cli](https://github.com/UI5/webcomponents-react/blob/main/packages/cli/README.md) package.
+
+<MessageStrip
+    hideCloseButton
+    design="Critical"
+    children={
+        <>
+            The codemod is a best-effort attempt to help you migrate to direct imports. Please review the generated code thoroughly!
+            <br />
+            <strong>
+                Applying the codemod might break your code formatting, so please don't forget to run prettier and/or eslint
+                after you've applied the codemod!
+            </strong>
+        </>
+    }
+/>
+
+```shell
+npx @ui5/webcomponents-react-cli codemod --transform export-maps \
+    --src ./path/to/src \
+    --typescript # only if you use TypeScript in your project, omit if you use JavaScript
+```
+
 <Footer />

packages/cli/README.md

@@ -1,6 +1,6 @@
 # @ui5/webcomponents-react-cli
 
-Wrapper generation and code-mod for ui5-webcomponents-react.
+Wrapper generation and code-mod for ui5/webcomponents-react.
 
 ## Usage
 
@@ -12,19 +12,30 @@ npm install @ui5/webcomponents-react-cli
 
 ### Documentation
 
-You can find an interactive documentation in our [Storybook](https://sap.github.io/ui5-webcomponents-react/).
+You can find an interactive documentation in our [Storybook](https://ui5.github.io/webcomponents-react/).
 
 - [Wrapper generation](https://sap.github.io/ui5-webcomponents-react/v2/?path=/docs/knowledge-base-bring-your-own-web-components--docs)
-- [Code-mod](https://sap.github.io/ui5-webcomponents-react/v2/?path=/docs/migration-guide--docs#codemod)
-- ~~[Patch compatibility table](https://sap.github.io/ui5-webcomponents-react/v2/?path=/docs/legacy-components-docs--docs#experimental-patch-script)~~ (deprecated in favor of [compatibility package scoping](https://sap.github.io/ui5-webcomponents-react/v2/?path=/docs/legacy-components-docs--docs#using-the-compat-v1-table-together-with-the-v2-table-in-one-application))
+- Code-mods:
+  - [v2](https://ui5.github.io/webcomponents-react/v2/?path=/docs/migration-guide--docs#codemod): Migrate your codebase from v1 to v2
+    ```shell
+    npx @ui5/webcomponents-react-cli codemod --transform v2 \
+        --src ./path/to/src \
+        --typescript # only if you use TypeScript in your project, omit if you use JavaScript
+    ```
+  - [export-maps](https://ui5.github.io/webcomponents-react/v2/?path=/docs/knowledge-base-faq--docs#why-use-direct-imports-via-package-export-maps): Migrate your codebase from root imports to direct imports using exports maps
+    ```shell
+    npx @ui5/webcomponents-react-cli codemod --transform export-maps \
+        --src ./path/to/src \
+        --typescript # only if you use TypeScript in your project, omit if you use JavaScript
+    ```
 
 ## Contribute
 
-Please check our [Contribution Guidelines](https://github.com/SAP/ui5-webcomponents-react/blob/main/CONTRIBUTING.md).
+Please check our [Contribution Guidelines](https://github.com/UI5/webcomponents-react/blob/main/CONTRIBUTING.md).
 
 ## License
 
-Please see our [LICENSE](https://github.com/SAP/ui5-webcomponents-react/blob/main/LICENSE) for copyright and license information.
+Please see our [LICENSE](https://github.com/UI5/webcomponents-react/blob/main/LICENSE) for copyright and license information.
 Detailed information including third-party components and their licensing/copyright information is available via the [REUSE tool](https://api.reuse.software/info/github.com/UI5/webcomponents-react).
 
 <!-- Use the force -->