commercelayer · acasazza · Jul 21, 2026 · Jul 21, 2026
diff --git a/.github/workflows/pgk-pr-new.yaml b/.github/workflows/pgk-pr-new.yaml
@@ -37,8 +37,8 @@ jobs:
         run: pnpm install --frozen-lockfile
 
       - name: Build elements 🛠
-        run: pnpm --filter @commercelayer/core --filter @commercelayer/hooks --filter @commercelayer/react-components build
+        run: pnpm --filter @commercelayer/core-components --filter @commercelayer/react-hooks-components --filter @commercelayer/react-components build
 
       - name: Publish 🚀 pkg.pr.new
         run: |
-          npx pkg-pr-new publish './packages/react-components' './packages/core' './packages/hooks' --no-template
+          npx pkg-pr-new publish './packages/react-components' './packages/core-components' './packages/react-hooks-components' --no-template
diff --git a/package.json b/package.json
@@ -7,8 +7,8 @@
   },
   "scripts": {
     "preinstall": "npx only-allow pnpm",
-    "build": "pnpm --filter @commercelayer/core --filter @commercelayer/hooks --filter @commercelayer/react-components build",
-    "build:watch": "pnpm --filter @commercelayer/core --filter @commercelayer/hooks --filter @commercelayer/react-components --parallel build:watch",
+    "build": "pnpm --filter @commercelayer/core-components --filter @commercelayer/react-hooks-components --filter @commercelayer/react-components build",
+    "build:watch": "pnpm --filter @commercelayer/core-components --filter @commercelayer/react-hooks-components --filter @commercelayer/react-components --parallel build:watch",
     "prepare": "husky",
     "test": "pnpm -r --workspace-concurrency=1 --no-bail test",
     "docs:dev": "pnpm --filter docs storybook",

diff --git a/packages/core/extender.ts → packages/core-components/extender.ts b/packages/core/extender.ts → packages/core-components/extender.ts
diff --git a/packages/core/package.json → packages/core-components/package.json b/packages/core/package.json → packages/core-components/package.json
@@ -1,5 +1,5 @@
 {
-  "name": "@commercelayer/core",
+  "name": "@commercelayer/core-components",
   "version": "1.0.0",
   "description": "Commerce Layer Core",
   "type": "module",

diff --git a/packages/core/src/addresses/index.ts → ...es/core-components/src/addresses/index.ts b/packages/core/src/addresses/index.ts → ...es/core-components/src/addresses/index.ts
diff --git a/.../src/addresses/saveOrderAddresses.spec.ts → .../src/addresses/saveOrderAddresses.spec.ts b/.../src/addresses/saveOrderAddresses.spec.ts → .../src/addresses/saveOrderAddresses.spec.ts
diff --git a/.../core/src/addresses/saveOrderAddresses.ts → ...nents/src/addresses/saveOrderAddresses.ts b/.../core/src/addresses/saveOrderAddresses.ts → ...nents/src/addresses/saveOrderAddresses.ts
diff --git a/...e/src/addresses/updateAddressReference.ts → ...s/src/addresses/updateAddressReference.ts b/...e/src/addresses/updateAddressReference.ts → ...s/src/addresses/updateAddressReference.ts
diff --git a/...ages/core/src/auth/getAccessToken.spec.ts → ...omponents/src/auth/getAccessToken.spec.ts b/...ages/core/src/auth/getAccessToken.spec.ts → ...omponents/src/auth/getAccessToken.spec.ts
diff --git a/packages/core/src/auth/getAccessToken.ts → ...ore-components/src/auth/getAccessToken.ts b/packages/core/src/auth/getAccessToken.ts → ...ore-components/src/auth/getAccessToken.ts
diff --git a/packages/core/src/auth/index.ts → packages/core-components/src/auth/index.ts b/packages/core/src/auth/index.ts → packages/core-components/src/auth/index.ts
diff --git a/...y/getSkuAvailability.interceptors.spec.ts → ...y/getSkuAvailability.interceptors.spec.ts b/...y/getSkuAvailability.interceptors.spec.ts → ...y/getSkuAvailability.interceptors.spec.ts
diff --git a/...c/availability/getSkuAvailability.spec.ts → ...c/availability/getSkuAvailability.spec.ts b/...c/availability/getSkuAvailability.spec.ts → ...c/availability/getSkuAvailability.spec.ts
diff --git a/...re/src/availability/getSkuAvailability.ts → ...ts/src/availability/getSkuAvailability.ts b/...re/src/availability/getSkuAvailability.ts → ...ts/src/availability/getSkuAvailability.ts
diff --git a/packages/core/src/availability/index.ts → ...core-components/src/availability/index.ts b/packages/core/src/availability/index.ts → ...core-components/src/availability/index.ts
diff --git a/packages/core/src/createBatchStore.ts → ...s/core-components/src/createBatchStore.ts b/packages/core/src/createBatchStore.ts → ...s/core-components/src/createBatchStore.ts
diff --git a/...re/src/customers/createCustomerAddress.ts → ...ts/src/customers/createCustomerAddress.ts b/...re/src/customers/createCustomerAddress.ts → ...ts/src/customers/createCustomerAddress.ts
diff --git a/...re/src/customers/deleteCustomerAddress.ts → ...ts/src/customers/deleteCustomerAddress.ts b/...re/src/customers/deleteCustomerAddress.ts → ...ts/src/customers/deleteCustomerAddress.ts
diff --git a/...re/src/customers/deleteCustomerPayment.ts → ...ts/src/customers/deleteCustomerPayment.ts b/...re/src/customers/deleteCustomerPayment.ts → ...ts/src/customers/deleteCustomerPayment.ts
diff --git a/...ore/src/customers/getCustomerAddresses.ts → ...nts/src/customers/getCustomerAddresses.ts b/...ore/src/customers/getCustomerAddresses.ts → ...nts/src/customers/getCustomerAddresses.ts
diff --git a/...ges/core/src/customers/getCustomerInfo.ts → ...mponents/src/customers/getCustomerInfo.ts b/...ges/core/src/customers/getCustomerInfo.ts → ...mponents/src/customers/getCustomerInfo.ts
diff --git a/...s/core/src/customers/getCustomerOrders.ts → ...onents/src/customers/getCustomerOrders.ts b/...s/core/src/customers/getCustomerOrders.ts → ...onents/src/customers/getCustomerOrders.ts
diff --git a/...rc/customers/getCustomerPaymentSources.ts → ...rc/customers/getCustomerPaymentSources.ts b/...rc/customers/getCustomerPaymentSources.ts → ...rc/customers/getCustomerPaymentSources.ts
diff --git a/...core/src/customers/getCustomerPayments.ts → ...ents/src/customers/getCustomerPayments.ts b/...core/src/customers/getCustomerPayments.ts → ...ents/src/customers/getCustomerPayments.ts
diff --git a/...src/customers/getCustomerSubscriptions.ts → ...src/customers/getCustomerSubscriptions.ts b/...src/customers/getCustomerSubscriptions.ts → ...src/customers/getCustomerSubscriptions.ts
diff --git a/packages/core/src/customers/index.ts → ...es/core-components/src/customers/index.ts b/packages/core/src/customers/index.ts → ...es/core-components/src/customers/index.ts
diff --git a/...es/core/src/customers/saveCustomerUser.ts → ...ponents/src/customers/saveCustomerUser.ts b/...es/core/src/customers/saveCustomerUser.ts → ...ponents/src/customers/saveCustomerUser.ts
diff --git a/.../core/src/customers/setResourceTrigger.ts → ...nents/src/customers/setResourceTrigger.ts b/.../core/src/customers/setResourceTrigger.ts → ...nents/src/customers/setResourceTrigger.ts
diff --git a/packages/core/src/customers/types.ts → ...es/core-components/src/customers/types.ts b/packages/core/src/customers/types.ts → ...es/core-components/src/customers/types.ts
diff --git a/...cards/createGiftCard.interceptors.spec.ts → ...cards/createGiftCard.interceptors.spec.ts b/...cards/createGiftCard.interceptors.spec.ts → ...cards/createGiftCard.interceptors.spec.ts
diff --git a/...ore/src/gift_cards/createGiftCard.spec.ts → ...nts/src/gift_cards/createGiftCard.spec.ts b/...ore/src/gift_cards/createGiftCard.spec.ts → ...nts/src/gift_cards/createGiftCard.spec.ts
diff --git a/...ges/core/src/gift_cards/createGiftCard.ts → ...mponents/src/gift_cards/createGiftCard.ts b/...ges/core/src/gift_cards/createGiftCard.ts → ...mponents/src/gift_cards/createGiftCard.ts
diff --git a/...t_cards/getGiftCards.interceptors.spec.ts → ...t_cards/getGiftCards.interceptors.spec.ts b/...t_cards/getGiftCards.interceptors.spec.ts → ...t_cards/getGiftCards.interceptors.spec.ts
diff --git a/.../core/src/gift_cards/getGiftCards.spec.ts → ...nents/src/gift_cards/getGiftCards.spec.ts b/.../core/src/gift_cards/getGiftCards.spec.ts → ...nents/src/gift_cards/getGiftCards.spec.ts
diff --git a/packages/core/src/gift_cards/getGiftCards.ts → ...components/src/gift_cards/getGiftCards.ts b/packages/core/src/gift_cards/getGiftCards.ts → ...components/src/gift_cards/getGiftCards.ts
diff --git a/packages/core/src/gift_cards/index.ts → ...s/core-components/src/gift_cards/index.ts b/packages/core/src/gift_cards/index.ts → ...s/core-components/src/gift_cards/index.ts
diff --git a/...rds/retrieveGiftCard.interceptors.spec.ts → ...rds/retrieveGiftCard.interceptors.spec.ts b/...rds/retrieveGiftCard.interceptors.spec.ts → ...rds/retrieveGiftCard.interceptors.spec.ts
diff --git a/...e/src/gift_cards/retrieveGiftCard.spec.ts → ...s/src/gift_cards/retrieveGiftCard.spec.ts b/...e/src/gift_cards/retrieveGiftCard.spec.ts → ...s/src/gift_cards/retrieveGiftCard.spec.ts
diff --git a/...s/core/src/gift_cards/retrieveGiftCard.ts → ...onents/src/gift_cards/retrieveGiftCard.ts b/...s/core/src/gift_cards/retrieveGiftCard.ts → ...onents/src/gift_cards/retrieveGiftCard.ts
diff --git a/...cards/updateGiftCard.interceptors.spec.ts → ...cards/updateGiftCard.interceptors.spec.ts b/...cards/updateGiftCard.interceptors.spec.ts → ...cards/updateGiftCard.interceptors.spec.ts
diff --git a/...ore/src/gift_cards/updateGiftCard.spec.ts → ...nts/src/gift_cards/updateGiftCard.spec.ts b/...ore/src/gift_cards/updateGiftCard.spec.ts → ...nts/src/gift_cards/updateGiftCard.spec.ts
diff --git a/...ges/core/src/gift_cards/updateGiftCard.ts → ...mponents/src/gift_cards/updateGiftCard.ts b/...ges/core/src/gift_cards/updateGiftCard.ts → ...mponents/src/gift_cards/updateGiftCard.ts
diff --git a/.../core/src/in_stock_subscriptions/index.ts → ...nents/src/in_stock_subscriptions/index.ts b/.../core/src/in_stock_subscriptions/index.ts → ...nents/src/in_stock_subscriptions/index.ts
diff --git a/...scriptions/setInStockSubscription.spec.ts → ...scriptions/setInStockSubscription.spec.ts b/...scriptions/setInStockSubscription.spec.ts → ...scriptions/setInStockSubscription.spec.ts
diff --git a/...k_subscriptions/setInStockSubscription.ts → ...k_subscriptions/setInStockSubscription.ts b/...k_subscriptions/setInStockSubscription.ts → ...k_subscriptions/setInStockSubscription.ts
diff --git a/packages/core/src/index.ts → packages/core-components/src/index.ts b/packages/core/src/index.ts → packages/core-components/src/index.ts
diff --git a/...ore/src/line_items/deleteLineItem.spec.ts → ...nts/src/line_items/deleteLineItem.spec.ts b/...ore/src/line_items/deleteLineItem.spec.ts → ...nts/src/line_items/deleteLineItem.spec.ts
diff --git a/...ges/core/src/line_items/deleteLineItem.ts → ...mponents/src/line_items/deleteLineItem.ts b/...ges/core/src/line_items/deleteLineItem.ts → ...mponents/src/line_items/deleteLineItem.ts
diff --git a/.../core/src/line_items/getLineItems.spec.ts → ...nents/src/line_items/getLineItems.spec.ts b/.../core/src/line_items/getLineItems.spec.ts → ...nents/src/line_items/getLineItems.spec.ts
diff --git a/packages/core/src/line_items/getLineItems.ts → ...components/src/line_items/getLineItems.ts b/packages/core/src/line_items/getLineItems.ts → ...components/src/line_items/getLineItems.ts
diff --git a/packages/core/src/line_items/index.ts → ...s/core-components/src/line_items/index.ts b/packages/core/src/line_items/index.ts → ...s/core-components/src/line_items/index.ts
diff --git a/...ore/src/line_items/updateLineItem.spec.ts → ...nts/src/line_items/updateLineItem.spec.ts b/...ore/src/line_items/updateLineItem.spec.ts → ...nts/src/line_items/updateLineItem.spec.ts
diff --git a/...ges/core/src/line_items/updateLineItem.ts → ...mponents/src/line_items/updateLineItem.ts b/...ges/core/src/line_items/updateLineItem.ts → ...mponents/src/line_items/updateLineItem.ts
diff --git a/packages/core/src/orders/createOrder.ts → ...core-components/src/orders/createOrder.ts b/packages/core/src/orders/createOrder.ts → ...core-components/src/orders/createOrder.ts
diff --git a/packages/core/src/orders/index.ts → packages/core-components/src/orders/index.ts b/packages/core/src/orders/index.ts → packages/core-components/src/orders/index.ts
diff --git a/...ages/core/src/orders/orderStorage.spec.ts → ...omponents/src/orders/orderStorage.spec.ts b/...ages/core/src/orders/orderStorage.spec.ts → ...omponents/src/orders/orderStorage.spec.ts
diff --git a/packages/core/src/orders/orderStorage.ts → ...ore-components/src/orders/orderStorage.ts b/packages/core/src/orders/orderStorage.ts → ...ore-components/src/orders/orderStorage.ts
diff --git a/packages/core/src/orders/retrieveOrder.ts → ...re-components/src/orders/retrieveOrder.ts b/packages/core/src/orders/retrieveOrder.ts → ...re-components/src/orders/retrieveOrder.ts
diff --git a/packages/core/src/orders/updateOrder.ts → ...core-components/src/orders/updateOrder.ts b/packages/core/src/orders/updateOrder.ts → ...core-components/src/orders/updateOrder.ts
diff --git a/...src/prices/getPrices.interceptors.spec.ts → ...src/prices/getPrices.interceptors.spec.ts b/...src/prices/getPrices.interceptors.spec.ts → ...src/prices/getPrices.interceptors.spec.ts
diff --git a/packages/core/src/prices/getPrices.spec.ts → ...e-components/src/prices/getPrices.spec.ts b/packages/core/src/prices/getPrices.spec.ts → ...e-components/src/prices/getPrices.spec.ts
diff --git a/packages/core/src/prices/getPrices.ts → ...s/core-components/src/prices/getPrices.ts b/packages/core/src/prices/getPrices.ts → ...s/core-components/src/prices/getPrices.ts
diff --git a/packages/core/src/prices/index.ts → packages/core-components/src/prices/index.ts b/packages/core/src/prices/index.ts → packages/core-components/src/prices/index.ts
diff --git a/...prices/retrievePrice.interceptors.spec.ts → ...prices/retrievePrice.interceptors.spec.ts b/...prices/retrievePrice.interceptors.spec.ts → ...prices/retrievePrice.interceptors.spec.ts
diff --git a/...ges/core/src/prices/retrievePrice.spec.ts → ...mponents/src/prices/retrievePrice.spec.ts b/...ges/core/src/prices/retrievePrice.spec.ts → ...mponents/src/prices/retrievePrice.spec.ts
diff --git a/packages/core/src/prices/retrievePrice.ts → ...re-components/src/prices/retrievePrice.ts b/packages/core/src/prices/retrievePrice.ts → ...re-components/src/prices/retrievePrice.ts
diff --git a/...c/prices/updatePrice.interceptors.spec.ts → ...c/prices/updatePrice.interceptors.spec.ts b/...c/prices/updatePrice.interceptors.spec.ts → ...c/prices/updatePrice.interceptors.spec.ts
diff --git a/packages/core/src/prices/updatePrice.spec.ts → ...components/src/prices/updatePrice.spec.ts b/packages/core/src/prices/updatePrice.spec.ts → ...components/src/prices/updatePrice.spec.ts
diff --git a/packages/core/src/prices/updatePrice.ts → ...core-components/src/prices/updatePrice.ts b/packages/core/src/prices/updatePrice.ts → ...core-components/src/prices/updatePrice.ts
diff --git a/packages/core/src/sdk/getSdk.spec.ts → ...es/core-components/src/sdk/getSdk.spec.ts b/packages/core/src/sdk/getSdk.spec.ts → ...es/core-components/src/sdk/getSdk.spec.ts
diff --git a/packages/core/src/sdk/index.ts → packages/core-components/src/sdk/index.ts b/packages/core/src/sdk/index.ts → packages/core-components/src/sdk/index.ts
diff --git a/...s/core/src/shipments/getShipments.spec.ts → ...onents/src/shipments/getShipments.spec.ts b/...s/core/src/shipments/getShipments.spec.ts → ...onents/src/shipments/getShipments.spec.ts
diff --git a/packages/core/src/shipments/getShipments.ts → ...-components/src/shipments/getShipments.ts b/packages/core/src/shipments/getShipments.ts → ...-components/src/shipments/getShipments.ts
diff --git a/packages/core/src/shipments/index.ts → ...es/core-components/src/shipments/index.ts b/packages/core/src/shipments/index.ts → ...es/core-components/src/shipments/index.ts
diff --git a/...e/src/shipments/setShippingMethod.spec.ts → ...s/src/shipments/setShippingMethod.spec.ts b/...e/src/shipments/setShippingMethod.spec.ts → ...s/src/shipments/setShippingMethod.spec.ts
diff --git a/...s/core/src/shipments/setShippingMethod.ts → ...onents/src/shipments/setShippingMethod.ts b/...s/core/src/shipments/setShippingMethod.ts → ...onents/src/shipments/setShippingMethod.ts
diff --git a/...ku_lists/getSkuLists.interceptors.spec.ts → ...ku_lists/getSkuLists.interceptors.spec.ts b/...ku_lists/getSkuLists.interceptors.spec.ts → ...ku_lists/getSkuLists.interceptors.spec.ts
diff --git a/...es/core/src/sku_lists/getSkuLists.spec.ts → ...ponents/src/sku_lists/getSkuLists.spec.ts b/...es/core/src/sku_lists/getSkuLists.spec.ts → ...ponents/src/sku_lists/getSkuLists.spec.ts
diff --git a/packages/core/src/sku_lists/getSkuLists.ts → ...e-components/src/sku_lists/getSkuLists.ts b/packages/core/src/sku_lists/getSkuLists.ts → ...e-components/src/sku_lists/getSkuLists.ts
diff --git a/packages/core/src/sku_lists/index.ts → ...es/core-components/src/sku_lists/index.ts b/packages/core/src/sku_lists/index.ts → ...es/core-components/src/sku_lists/index.ts
diff --git a/...ists/retrieveSkuList.interceptors.spec.ts → ...ists/retrieveSkuList.interceptors.spec.ts b/...ists/retrieveSkuList.interceptors.spec.ts → ...ists/retrieveSkuList.interceptors.spec.ts
diff --git a/...ore/src/sku_lists/retrieveSkuList.spec.ts → ...nts/src/sku_lists/retrieveSkuList.spec.ts b/...ore/src/sku_lists/retrieveSkuList.spec.ts → ...nts/src/sku_lists/retrieveSkuList.spec.ts
diff --git a/...ges/core/src/sku_lists/retrieveSkuList.ts → ...mponents/src/sku_lists/retrieveSkuList.ts b/...ges/core/src/sku_lists/retrieveSkuList.ts → ...mponents/src/sku_lists/retrieveSkuList.ts
diff --git a/...ore/src/skus/getSkus.interceptors.spec.ts → ...nts/src/skus/getSkus.interceptors.spec.ts b/...ore/src/skus/getSkus.interceptors.spec.ts → ...nts/src/skus/getSkus.interceptors.spec.ts
diff --git a/packages/core/src/skus/getSkus.spec.ts → .../core-components/src/skus/getSkus.spec.ts b/packages/core/src/skus/getSkus.spec.ts → .../core-components/src/skus/getSkus.spec.ts
diff --git a/packages/core/src/skus/getSkus.ts → packages/core-components/src/skus/getSkus.ts b/packages/core/src/skus/getSkus.ts → packages/core-components/src/skus/getSkus.ts
diff --git a/packages/core/src/skus/index.ts → packages/core-components/src/skus/index.ts b/packages/core/src/skus/index.ts → packages/core-components/src/skus/index.ts
diff --git a/...src/skus/retrieveSku.interceptors.spec.ts → ...src/skus/retrieveSku.interceptors.spec.ts b/...src/skus/retrieveSku.interceptors.spec.ts → ...src/skus/retrieveSku.interceptors.spec.ts
diff --git a/packages/core/src/skus/retrieveSku.spec.ts → ...e-components/src/skus/retrieveSku.spec.ts b/packages/core/src/skus/retrieveSku.spec.ts → ...e-components/src/skus/retrieveSku.spec.ts
diff --git a/packages/core/src/skus/retrieveSku.ts → ...s/core-components/src/skus/retrieveSku.ts b/packages/core/src/skus/retrieveSku.ts → ...s/core-components/src/skus/retrieveSku.ts
diff --git a/...e/src/skus/updateSku.interceptors.spec.ts → ...s/src/skus/updateSku.interceptors.spec.ts b/...e/src/skus/updateSku.interceptors.spec.ts → ...s/src/skus/updateSku.interceptors.spec.ts
diff --git a/packages/core/src/skus/updateSku.spec.ts → ...ore-components/src/skus/updateSku.spec.ts b/packages/core/src/skus/updateSku.spec.ts → ...ore-components/src/skus/updateSku.spec.ts
diff --git a/packages/core/src/skus/updateSku.ts → ...ges/core-components/src/skus/updateSku.ts b/packages/core/src/skus/updateSku.ts → ...ges/core-components/src/skus/updateSku.ts
diff --git a/packages/core/src/types/base.ts → packages/core-components/src/types/base.ts b/packages/core/src/types/base.ts → packages/core-components/src/types/base.ts
diff --git a/packages/core/src/types/index.ts → packages/core-components/src/types/index.ts b/packages/core/src/types/index.ts → packages/core-components/src/types/index.ts
diff --git a/packages/core/tsconfig.json → packages/core-components/tsconfig.json b/packages/core/tsconfig.json → packages/core-components/tsconfig.json
diff --git a/packages/core/tsdown.config.ts → packages/core-components/tsdown.config.ts b/packages/core/tsdown.config.ts → packages/core-components/tsdown.config.ts
diff --git a/packages/core/vite-env.d.ts → packages/core-components/vite-env.d.ts b/packages/core/vite-env.d.ts → packages/core-components/vite-env.d.ts
diff --git a/packages/core/vitest.config.ts → packages/core-components/vitest.config.ts b/packages/core/vitest.config.ts → packages/core-components/vitest.config.ts
diff --git a/packages/document/src/stories/availability/availability.stories.tsx b/packages/document/src/stories/availability/availability.stories.tsx
@@ -11,7 +11,7 @@ function AvailabilityDocsPage(): JSX.Element {
         The Availability components let you display real-time stock quantity and delivery lead times
         for any SKU. They are powered by the Commerce Layer inventory model and work by fetching
         availability data through the <code>useAvailability</code> hook from{" "}
-        <code>@commercelayer/hooks</code>. All Availability components must be nested inside the{" "}
+        <code>@commercelayer/react-hooks-components</code>. All Availability components must be nested inside the{" "}
         <code>{"<CommerceLayer>"}</code> context.
       </p>
       <hr />

diff --git a/packages/document/src/stories/getting-started/006.core.mdx b/packages/document/src/stories/getting-started/006.core.mdx
@@ -4,9 +4,9 @@ import { Meta, Source } from '@storybook/addon-docs/blocks';
 
 # Core package
 
-The `@commercelayer/core` package is a collection of **low-level async functions** that wrap the [Commerce Layer SDK](https://github.com/commercelayer/commercelayer-sdk).
+The `@commercelayer/core-components` package is a collection of **low-level async functions** that wrap the [Commerce Layer SDK](https://github.com/commercelayer/commercelayer-sdk).
 
-It is the foundation layer used internally by the `@commercelayer/hooks` package and by the React components. You can use it directly if you need to fetch or mutate Commerce Layer resources outside of a React component.
+It is the foundation layer used internally by the `@commercelayer/react-hooks-components` package and by the React components. You can use it directly if you need to fetch or mutate Commerce Layer resources outside of a React component.
 
 <span type="info">
 This package has no React dependency — it can be used in any JavaScript/TypeScript environment (Node.js, edge functions, plain scripts, etc.).
@@ -20,9 +20,9 @@ The package is published to npm as part of this monorepo and listed as a workspa
   language="bash"
   dark
   code={`
-npm install @commercelayer/core
+npm install @commercelayer/core-components
 # or
-pnpm add @commercelayer/core
+pnpm add @commercelayer/core-components
 `}
 />
 
@@ -49,7 +49,7 @@ Every function follows the same pattern:
   language="typescript"
   dark
   code={`
-import { getSkus } from '@commercelayer/core'
+import { getSkus } from '@commercelayer/core-components'
 
 const skus = await getSkus({
   accessToken: 'your-access-token',
@@ -77,7 +77,7 @@ The first argument is always an object with:
   language="typescript"
   dark
   code={`
-import { getAccessToken } from '@commercelayer/core'
+import { getAccessToken } from '@commercelayer/core-components'
 
 const token = await getAccessToken({
   grantType: 'client_credentials',
@@ -98,7 +98,7 @@ console.log(token.accessToken)
   language="typescript"
   dark
   code={`
-import { getSkus } from '@commercelayer/core'
+import { getSkus } from '@commercelayer/core-components'
 
 const result = await getSkus({
   accessToken,
@@ -120,7 +120,7 @@ for (const sku of result) {
   language="typescript"
   dark
   code={`
-import { retrieveSkuList } from '@commercelayer/core'
+import { retrieveSkuList } from '@commercelayer/core-components'
 
 const skuList = await retrieveSkuList({
   accessToken,

diff --git a/packages/document/src/stories/getting-started/007.hooks.mdx b/packages/document/src/stories/getting-started/007.hooks.mdx
@@ -4,7 +4,7 @@ import { Meta, Source } from '@storybook/addon-docs/blocks';
 
 # Hooks package
 
-The `@commercelayer/hooks` package provides **SWR-based React hooks** built on top of the `@commercelayer/core` package.
+The `@commercelayer/react-hooks-components` package provides **SWR-based React hooks** built on top of the `@commercelayer/core-components` package.
 
 These hooks handle caching, deduplication, loading states, and error handling automatically. They are used internally by the React components in this library and are available for direct use if you want to build custom UI on top of Commerce Layer data.
 
@@ -18,9 +18,9 @@ This package requires React 18+ and depends on `swr` for data fetching and cachi
   language="bash"
   dark
   code={`
-npm install @commercelayer/hooks
+npm install @commercelayer/react-hooks-components
 # or
-pnpm add @commercelayer/hooks
+pnpm add @commercelayer/react-hooks-components
 `}
 />
 
@@ -65,7 +65,7 @@ All hooks use [SWR](https://swr.vercel.app/) with `revalidateOnFocus: false` and
   language="tsx"
   dark
   code={`
-import { useSkus } from '@commercelayer/hooks'
+import { useSkus } from '@commercelayer/react-hooks-components'
 
 function SkuList({ accessToken }: { accessToken: string }) {
   const { skus, isLoading, fetchSkus } = useSkus(accessToken)
@@ -96,7 +96,7 @@ function SkuList({ accessToken }: { accessToken: string }) {
   language="tsx"
   dark
   code={`
-import { useSkuLists } from '@commercelayer/hooks'
+import { useSkuLists } from '@commercelayer/react-hooks-components'
 
 function SkuListItems({ accessToken }: { accessToken: string }) {
   const { retrieveSkuList } = useSkuLists(accessToken)
@@ -126,7 +126,7 @@ function SkuListItems({ accessToken }: { accessToken: string }) {
   language="tsx"
   dark
   code={`
-import { usePrices } from '@commercelayer/hooks'
+import { usePrices } from '@commercelayer/react-hooks-components'
 
 function PriceList({ accessToken }: { accessToken: string }) {
   const { prices, isLoading, fetchPrices } = usePrices(accessToken)
@@ -154,7 +154,7 @@ function PriceList({ accessToken }: { accessToken: string }) {
   language="tsx"
   dark
   code={`
-import { useAvailability } from '@commercelayer/hooks'
+import { useAvailability } from '@commercelayer/react-hooks-components'
 
 function StockBadge({ accessToken, skuCode }: { accessToken: string; skuCode: string }) {
   const { quantity, isLoading, fetchAvailability } = useAvailability(accessToken)

diff --git a/packages/react-components/_vitest.config.mts b/packages/react-components/_vitest.config.mts
@@ -6,8 +6,8 @@ import { defineConfig } from "vitest/config"
 export default defineConfig({
   resolve: {
     alias: {
-      "@commercelayer/hooks": path.resolve("../hooks/src/index.ts"),
-      "@commercelayer/core": path.resolve("../core/src/index.ts"),
+      "@commercelayer/react-hooks-components": path.resolve("../react-hooks-components/src/index.ts"),
+      "@commercelayer/core-components": path.resolve("../core-components/src/index.ts"),
       "#components": path.resolve(__dirname, "src/components"),
       "#components/auth": path.resolve(__dirname, "src/components/auth"),
       "#components/auth/*": path.resolve(__dirname, "src/components/auth/*"),

diff --git a/packages/react-components/package.json b/packages/react-components/package.json
@@ -61,8 +61,8 @@
   "homepage": "https://github.com/commercelayer/commercelayer-react-components#readme",
   "dependencies": {
     "@adyen/adyen-web": "^6.41.0",
-    "@commercelayer/core": "workspace:*",
-    "@commercelayer/hooks": "workspace:*",
+    "@commercelayer/core-components": "workspace:*",
+    "@commercelayer/react-hooks-components": "workspace:*",
     "@commercelayer/organization-config": "^2.8.4",
     "@commercelayer/sdk": "7.12.1",
     "@stripe/react-stripe-js": "^6.8.0",

diff --git a/packages/react-components/specs/addresses/Address.spec.tsx b/packages/react-components/specs/addresses/Address.spec.tsx
@@ -7,7 +7,7 @@ import CustomerContext from "#context/CustomerContext"
 import OrderContext, { defaultOrderContext } from "#context/OrderContext"
 import ShippingAddressContext from "#context/ShippingAddressContext"
 
-vi.mock("@commercelayer/core", () => ({}))
+vi.mock("@commercelayer/core-components", () => ({}))
 
 const mockAddress: AddressType = {
   id: "addr-1",

diff --git a/packages/react-components/specs/addresses/AddressCountrySelector.spec.tsx b/packages/react-components/specs/addresses/AddressCountrySelector.spec.tsx
@@ -5,7 +5,7 @@ import BillingAddressFormContext from "#context/BillingAddressFormContext"
 import CustomerAddressFormContext from "#context/CustomerAddressFormContext"
 import ShippingAddressFormContext from "#context/ShippingAddressFormContext"
 
-vi.mock("@commercelayer/core", () => ({}))
+vi.mock("@commercelayer/core-components", () => ({}))
 
 const mockBillingCtx: Partial<DefaultContextAddress> = {
   setValue: vi.fn(),

diff --git a/packages/react-components/specs/addresses/AddressField.spec.tsx b/packages/react-components/specs/addresses/AddressField.spec.tsx
@@ -3,7 +3,7 @@ import AddressField from "#components/addresses/AddressField"
 import AddressChildrenContext from "#context/AddressChildrenContext"
 import CustomerContext from "#context/CustomerContext"
 
-vi.mock("@commercelayer/core", () => ({}))
+vi.mock("@commercelayer/core-components", () => ({}))
 
 const mockAddress = {
   id: "addr-1",

diff --git a/packages/react-components/specs/addresses/AddressInput.spec.tsx b/packages/react-components/specs/addresses/AddressInput.spec.tsx
@@ -5,7 +5,7 @@ import BillingAddressFormContext from "#context/BillingAddressFormContext"
 import CustomerAddressFormContext from "#context/CustomerAddressFormContext"
 import ShippingAddressFormContext from "#context/ShippingAddressFormContext"
 
-vi.mock("@commercelayer/core", () => ({}))
+vi.mock("@commercelayer/core-components", () => ({}))
 
 const makeBillingCtx = (overrides: Partial<DefaultContextAddress> = {}): DefaultContextAddress =>
   ({

diff --git a/packages/react-components/specs/addresses/AddressInputSelect.spec.tsx b/packages/react-components/specs/addresses/AddressInputSelect.spec.tsx
@@ -4,7 +4,7 @@ import type { DefaultContextAddress } from "#context/BillingAddressFormContext"
 import BillingAddressFormContext from "#context/BillingAddressFormContext"
 import ShippingAddressFormContext from "#context/ShippingAddressFormContext"
 
-vi.mock("@commercelayer/core", () => ({}))
+vi.mock("@commercelayer/core-components", () => ({}))
 
 const OPTIONS = [
   { label: "Option A", value: "a" },

diff --git a/packages/react-components/specs/addresses/AddressesContainer.spec.tsx b/packages/react-components/specs/addresses/AddressesContainer.spec.tsx
@@ -5,7 +5,7 @@ import AddressContext from "#context/AddressContext"
 import CommerceLayerContext from "#context/CommerceLayerContext"
 import OrderContext, { defaultOrderContext } from "#context/OrderContext"
 
-vi.mock("@commercelayer/core", () => ({}))
+vi.mock("@commercelayer/core-components", () => ({}))
 vi.mock("#utils/localStorage", () => ({
   setCustomerOrderParam: vi.fn(),
   getLocalOrder: vi.fn(),

diff --git a/packages/react-components/specs/addresses/AddressesEmpty.spec.tsx b/packages/react-components/specs/addresses/AddressesEmpty.spec.tsx
@@ -3,7 +3,7 @@ import { render, screen } from "@testing-library/react"
 import AddressesEmpty from "#components/addresses/AddressesEmpty"
 import CustomerContext from "#context/CustomerContext"
 
-vi.mock("@commercelayer/core", () => ({}))
+vi.mock("@commercelayer/core-components", () => ({}))
 
 function renderEmpty(
   addresses: Address[] | null | undefined,

diff --git a/packages/react-components/specs/addresses/BillingAddress.spec.tsx b/packages/react-components/specs/addresses/BillingAddress.spec.tsx
@@ -10,7 +10,7 @@ const core = vi.hoisted(() => ({
   updateAddressReference: vi.fn(),
 }))
 
-vi.mock("@commercelayer/core", () => ({
+vi.mock("@commercelayer/core-components", () => ({
   updateAddressReference: core.updateAddressReference,
 }))
 

diff --git a/packages/react-components/specs/addresses/BillingAddressContainer.spec.tsx b/packages/react-components/specs/addresses/BillingAddressContainer.spec.tsx
@@ -6,7 +6,7 @@ import BillingAddressContext from "#context/BillingAddressContext"
 import CommerceLayerContext from "#context/CommerceLayerContext"
 import OrderContext, { defaultOrderContext } from "#context/OrderContext"
 
-vi.mock("@commercelayer/core", () => ({ updateAddressReference: vi.fn() }))
+vi.mock("@commercelayer/core-components", () => ({ updateAddressReference: vi.fn() }))
 
 let latestSetBillingAddress: unknown
 

diff --git a/packages/react-components/specs/addresses/ShippingAddress.spec.tsx b/packages/react-components/specs/addresses/ShippingAddress.spec.tsx
@@ -10,7 +10,7 @@ const core = vi.hoisted(() => ({
   updateAddressReference: vi.fn(),
 }))
 
-vi.mock("@commercelayer/core", () => ({
+vi.mock("@commercelayer/core-components", () => ({
   updateAddressReference: core.updateAddressReference,
 }))
 

diff --git a/packages/react-components/specs/addresses/ShippingAddressContainer.spec.tsx b/packages/react-components/specs/addresses/ShippingAddressContainer.spec.tsx
@@ -6,7 +6,7 @@ import CommerceLayerContext from "#context/CommerceLayerContext"
 import OrderContext, { defaultOrderContext } from "#context/OrderContext"
 import ShippingAddressContext from "#context/ShippingAddressContext"
 
-vi.mock("@commercelayer/core", () => ({ updateAddressReference: vi.fn() }))
+vi.mock("@commercelayer/core-components", () => ({ updateAddressReference: vi.fn() }))
 
 let latestSetShippingAddress: unknown
 

diff --git a/packages/react-components/specs/customers/Customer.spec.tsx b/packages/react-components/specs/customers/Customer.spec.tsx
@@ -19,7 +19,7 @@ const core = vi.hoisted(() => ({
   setResourceTrigger: vi.fn(),
 }))
 
-vi.mock("@commercelayer/core", () => ({
+vi.mock("@commercelayer/core-components", () => ({
   getCustomerInfo: core.getCustomerInfo,
   getCustomerAddresses: core.getCustomerAddresses,
   getCustomerPayments: core.getCustomerPayments,

diff --git a/packages/react-components/specs/customers/CustomerContainer.spec.tsx b/packages/react-components/specs/customers/CustomerContainer.spec.tsx
@@ -17,7 +17,7 @@ const core = vi.hoisted(() => ({
   setResourceTrigger: vi.fn(),
 }))
 
-vi.mock("@commercelayer/core", () => ({
+vi.mock("@commercelayer/core-components", () => ({
   getCustomerInfo: core.getCustomerInfo,
   getCustomerAddresses: core.getCustomerAddresses,
   getCustomerPayments: core.getCustomerPayments,

diff --git a/packages/react-components/specs/gift_cards/GiftCard.spec.tsx b/packages/react-components/specs/gift_cards/GiftCard.spec.tsx
@@ -11,7 +11,7 @@ const core = vi.hoisted(() => ({
   getSdk: vi.fn(),
 }))
 
-vi.mock("@commercelayer/core", () => ({
+vi.mock("@commercelayer/core-components", () => ({
   createGiftCard: core.createGiftCard,
   getSdk: core.getSdk,
 }))

diff --git a/packages/react-components/specs/gift_cards/GiftCardContainer.spec.tsx b/packages/react-components/specs/gift_cards/GiftCardContainer.spec.tsx
@@ -11,7 +11,7 @@ const core = vi.hoisted(() => ({
   getSdk: vi.fn(),
 }))
 
-vi.mock("@commercelayer/core", () => ({
+vi.mock("@commercelayer/core-components", () => ({
   createGiftCard: core.createGiftCard,
   getSdk: core.getSdk,
 }))

diff --git a/packages/react-components/specs/in_stock_subscriptions/InStockSubscriptions.spec.tsx b/packages/react-components/specs/in_stock_subscriptions/InStockSubscriptions.spec.tsx
@@ -8,8 +8,8 @@ import InStockSubscriptionContext from "#context/InStockSubscriptionContext"
 const mockHookSetInStockSubscription = vi.fn().mockResolvedValue(undefined)
 const mockUseInStockSubscriptions = vi.fn()
 
-vi.mock("@commercelayer/hooks", async (importOriginal) => {
-  const actual = await importOriginal<typeof import("@commercelayer/hooks")>()
+vi.mock("@commercelayer/react-hooks-components", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@commercelayer/react-hooks-components")>()
   return {
     ...actual,
     useInStockSubscriptions: (...args: unknown[]) => mockUseInStockSubscriptions(...args),

diff --git a/...ages/react-components/specs/in_stock_subscriptions/InStockSubscriptionsContainer.spec.tsx b/...ages/react-components/specs/in_stock_subscriptions/InStockSubscriptionsContainer.spec.tsx
@@ -7,8 +7,8 @@ import InStockSubscriptionContext from "#context/InStockSubscriptionContext"
 
 const mockUseInStockSubscriptions = vi.fn()
 
-vi.mock("@commercelayer/hooks", async (importOriginal) => {
-  const actual = await importOriginal<typeof import("@commercelayer/hooks")>()
+vi.mock("@commercelayer/react-hooks-components", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@commercelayer/react-hooks-components")>()
   return {
     ...actual,
     useInStockSubscriptions: (...args: unknown[]) => mockUseInStockSubscriptions(...args),

diff --git a/packages/react-components/specs/line_items/LineItems.spec.tsx b/packages/react-components/specs/line_items/LineItems.spec.tsx
@@ -18,8 +18,8 @@ const mockMutate = vi.fn()
 
 const mockUseLineItems = vi.fn()
 
-vi.mock("@commercelayer/hooks", async (importOriginal) => {
-  const actual = await importOriginal<typeof import("@commercelayer/hooks")>()
+vi.mock("@commercelayer/react-hooks-components", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@commercelayer/react-hooks-components")>()
   return {
     ...actual,
     useLineItems: (...args: unknown[]) => mockUseLineItems(...args),

diff --git a/packages/react-components/specs/orders/place-order.spec.tsx b/packages/react-components/specs/orders/place-order.spec.tsx
@@ -11,8 +11,8 @@ import PaymentMethodContext, { defaultPaymentMethodContext } from "#context/Paym
 import PlaceOrderContext, { defaultPlaceOrderContext } from "#context/PlaceOrderContext"
 import { PLACE_ORDER_RECHECK_EVENT, usePlaceOrder } from "#hooks/usePlaceOrder"
 
-vi.mock("@commercelayer/core", async (importOriginal) => {
-  const actual = await importOriginal<typeof import("@commercelayer/core")>()
+vi.mock("@commercelayer/core-components", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@commercelayer/core-components")>()
   return {
     ...actual,
     getSdk: vi.fn().mockReturnValue({
@@ -859,7 +859,7 @@ describe("PlaceOrderButton handleClick", () => {
     vi.mocked(getCardDetailsModule.default).mockReturnValue({ brand: "visa" } as any)
     // Always restore getSdk to return a functional mock so sdk-null test
     // doesn't corrupt subsequent tests
-    const { getSdk } = await import("@commercelayer/core")
+    const { getSdk } = await import("@commercelayer/core-components")
     vi.mocked(getSdk).mockReturnValue({
       orders: {
         retrieve: vi
@@ -908,7 +908,7 @@ describe("PlaceOrderButton handleClick", () => {
 
   it("returns early if sdk is null", async () => {
     const setPlaceOrder = vi.fn()
-    const { getSdk } = await import("@commercelayer/core")
+    const { getSdk } = await import("@commercelayer/core-components")
     vi.mocked(getSdk).mockReturnValueOnce(null as any)
 
     render(
@@ -937,7 +937,7 @@ describe("PlaceOrderButton handleClick", () => {
 
   it("sets isValid=false when payment_status is partially_authorized (covers line 535)", async () => {
     // Must use non-stripe payment type so sdk.orders.retrieve is called
-    const { getSdk } = await import("@commercelayer/core")
+    const { getSdk } = await import("@commercelayer/core-components")
     const sdk = vi.mocked(getSdk)() as any
     vi.mocked(sdk.orders.retrieve).mockResolvedValueOnce({
       id: "order-1",
@@ -1277,7 +1277,7 @@ describe("usePlaceOrder hook direct", () => {
   beforeEach(async () => {
     localStorage.clear()
     vi.clearAllMocks()
-    const { getSdk } = await import("@commercelayer/core")
+    const { getSdk } = await import("@commercelayer/core-components")
     vi.mocked(getSdk).mockReturnValue({
       orders: {
         retrieve: vi