@ikas/code-components-mcp 1.4.0-beta.163 → 1.4.0-beta.164

package/data/section-templates/account-info-section/children/AccountOrders/index.tsx

@@ -80,7 +80,7 @@ export function AccountOrders({
           <Button
             variant="primary"
             size="s"
-            onClick={() => Router.navigate("/")}
+            onClick={() => Router.navigateToPage("INDEX")}
           >
             {shopButtonText}
           </Button>

package/data/section-templates/blog-home-section/index.tsx

@@ -6,6 +6,7 @@ import {
   hasBlogListPrevPage,
   hasBlogListNextPage,
   getIkasBlogCategoryHref,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { observer } from "@ikas/component-utils";
 import { cx } from "../../utils/cx";
@@ -47,7 +48,7 @@ export function BlogHome({
         {categories.length > 0 && (
           <div className="kombos-blog-home__categories">
             <a
-              href="/blog"
+              href={withRoutePrefix("/blog")}
               className={cx(
                 "kombos-blog-home__cat-btn",
                 "text-sm-medium",

package/data/section-templates/blog-post-section/index.tsx

@@ -2,6 +2,7 @@ import {
   getIkasBlogFormattedDate,
   getIkasBlogCategoryHref,
   getDefaultSrc,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 
 import { Props } from "./types";
@@ -31,8 +32,8 @@ export function BlogPost({
   const writerName = getFullName(blogPost.writer?.firstName, blogPost.writer?.lastName);
 
   const breadcrumbItems: BreadcrumbItem[] = [
-    { label: homeText, href: "/" },
-    { label: blogText, href: "/blog" },
+    { label: homeText, href: withRoutePrefix("/") },
+    { label: blogText, href: withRoutePrefix("/blog") },
   ];
   if (categoryName && categoryHref) {
     breadcrumbItems.push({ label: categoryName, href: categoryHref });

package/data/section-templates/cart-section/components/EmptyState/index.tsx

@@ -12,7 +12,7 @@ export default function EmptyState({
   continueShoppingText,
 }: Props) {
   const handleContinueShopping = () => {
-    Router.navigate("/");
+    Router.navigateToPage("INDEX");
   };
 
   return (

package/data/section-templates/category-list-section/index.tsx

@@ -21,6 +21,7 @@ import {
   searchProductList,
   getProductOptionSet,
   IkasComponentRenderer,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { Props } from "./types";
 import ProductCard from "../../sub-components/ProductCard";
@@ -170,7 +171,7 @@ export function CategoryList(props: Props) {
     const path = getCategoryPath(category);
     if (path.length === 0) return [];
     return [
-      { label: homepageText, href: "/" } as BreadcrumbItem,
+      { label: homepageText, href: withRoutePrefix("/") } as BreadcrumbItem,
       ...path.map(
         (cat: any) =>
           ({

package/data/section-templates/component-renderer/additional/ProductDetail/index.tsx

@@ -6,6 +6,7 @@ import {
   IkasImage,
   isNotEmpty,
   IkasComponentRenderer,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { Props } from "./types";
 import Breadcrumb from "../../sub-components/Breadcrumb";
@@ -42,7 +43,10 @@ export function ProductDetail(props: Props) {
       <div className="kombos-container kombos-pd__container">
         <Breadcrumb
           items={[
-            { label: homepageText, href: "/" } as BreadcrumbItem,
+            {
+              label: homepageText,
+              href: withRoutePrefix("/"),
+            } as BreadcrumbItem,
             ...(isNotEmpty(categoryPath)
               ? categoryPath.map(
                   (pathItem: any) =>

package/data/section-templates/forgot-password-section/components/ForgotPasswordForm/index.tsx

@@ -49,7 +49,7 @@ const ForgotPasswordForm = observer(function ForgotPasswordForm({
           variant="primary"
           size="s"
           className="forgot-password__submit-btn"
-          onClick={() => Router.navigate("/")}
+          onClick={() => Router.navigateToPage("INDEX")}
         >
           {successButtonText}
         </Button>

package/data/section-templates/header-section/children/Navbar/components/CartSidebar/index.tsx

@@ -19,6 +19,7 @@ import {
   getCheckoutUrlFromCartStore,
   IkasOrderLineItem,
   Router,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import type { AspectRatio, ObjectFit } from "../../../../global-types";
 import CartItem from "../../../../sub-components/CartItem";
@@ -164,7 +165,7 @@ const CartSidebar = observer(function CartSidebar({
             </div>
             <div className="kombos-cart-sidebar__footer-buttons">
               <a
-                href="/cart"
+                href={withRoutePrefix("/cart")}
                 className="kombos-cart-sidebar__view-cart-link"
                 onClick={(e: Event) => {
                   e.preventDefault();

package/data/section-templates/header-section/children/Navbar/components/SearchModal/index.tsx

@@ -12,6 +12,7 @@ import {
   createMediaSrcset,
   getProductOptionSet,
   IkasComponentRenderer,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import type { IkasProduct } from "@ikas/bp-storefront";
 import { cx } from "../../../../utils/cx";
@@ -199,7 +200,7 @@ const SearchModal = observer(function SearchModal({
           <div className="kombos-search__logo-area">
             {logo && (
               <a
-                href="/"
+                href={withRoutePrefix("/")}
                 className="kombos-search__logo"
                 style={{
                   "--search-logo-h-desktop": logoSizeDesktop,

package/data/section-templates/header-section/children/Navbar/index.tsx

@@ -8,6 +8,7 @@ import {
   getFormattedHeightSize,
   Router,
   createMediaSrcset,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { Props } from "./types";
 import CartSidebar from "./components/CartSidebar";
@@ -104,10 +105,10 @@ export function Navbar(props: Props) {
         {logo && (
           <a
             className="kombos-navbar__logo"
-            href="/"
+            href={withRoutePrefix("/")}
             onClick={(e) => {
               e.preventDefault();
-              Router.navigate("/");
+              Router.navigateToPage("INDEX");
             }}
             style={{
               "--logo-h-desktop": logoSizeDesktop,
@@ -145,7 +146,7 @@ export function Navbar(props: Props) {
           {/* Search */}
           <a
             className="kombos-navbar__icon-btn"
-            href="/search"
+            href={withRoutePrefix("/search")}
             onClick={(e) => {
               e.preventDefault();
               e.stopPropagation();
@@ -159,7 +160,7 @@ export function Navbar(props: Props) {
           {/* Account */}
           <a
             className="kombos-navbar__icon-btn"
-            href={isLoggedIn ? "/account" : "/login"}
+            href={withRoutePrefix(isLoggedIn ? "/account" : "/account/login")}
             onClick={(e) => {
               e.preventDefault();
               e.stopPropagation();
@@ -173,7 +174,7 @@ export function Navbar(props: Props) {
           {/* Cart */}
           <a
             className="kombos-navbar__icon-btn kombos-navbar__cart-trigger"
-            href="/cart"
+            href={withRoutePrefix("/cart")}
             onClick={(e) => {
               e.preventDefault();
               e.stopPropagation();

package/data/section-templates/hero-slider-section/children/HeroSliderItem/index.tsx

@@ -4,6 +4,7 @@ import {
   createMediaSrcset,
   getFormattedFontSize,
   Router,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { Props } from "./types";
 import {
@@ -113,15 +114,19 @@ export function HeroSliderItem({
     mobileRoundedCorners && "kombos-hero-slider-item--mobile-rounded",
   );
 
-  const handleDesktopClick = () => {
-    if (!link) return;
-    Router.navigate(link.href || "/", false, link.openInNewTab ?? false);
+  // `target.href` already carries the routing prefix — it comes from a LINK prop the storefront
+  // resolves per request. Only the fallback is a literal, so only it needs prefixing.
+  const navigateToLink = (target: typeof link) => {
+    if (!target) return;
+    Router.navigate(
+      target.href || withRoutePrefix("/"),
+      false,
+      target.openInNewTab ?? false,
+    );
   };
 
-  const handleMobileClick = () => {
-    if (!mobLink) return;
-    Router.navigate(mobLink.href || "/", false, mobLink.openInNewTab ?? false);
-  };
+  const handleDesktopClick = () => navigateToLink(link);
+  const handleMobileClick = () => navigateToLink(mobLink);
 
   const formattedDesktopFontSize = getFormattedFontSize(buttonFontSize);
   const formattedMobileFontSize = getFormattedFontSize(mobBtnFontSize);

package/data/section-templates/image-handling/index.tsx

@@ -6,6 +6,7 @@ import {
   IkasImage,
   isNotEmpty,
   IkasComponentRenderer,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { Props } from "./types";
 import Breadcrumb from "../../sub-components/Breadcrumb";
@@ -42,7 +43,10 @@ export function ProductDetail(props: Props) {
       <div className="kombos-container kombos-pd__container">
         <Breadcrumb
           items={[
-            { label: homepageText, href: "/" } as BreadcrumbItem,
+            {
+              label: homepageText,
+              href: withRoutePrefix("/"),
+            } as BreadcrumbItem,
             ...(isNotEmpty(categoryPath)
               ? categoryPath.map(
                   (pathItem: any) =>

package/data/section-templates/navigation/components/CartSidebar/index.tsx

@@ -19,6 +19,7 @@ import {
   getCheckoutUrlFromCartStore,
   IkasOrderLineItem,
   Router,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import type { AspectRatio, ObjectFit } from "../../../../global-types";
 import CartItem from "../../../../sub-components/CartItem";
@@ -164,7 +165,7 @@ const CartSidebar = observer(function CartSidebar({
             </div>
             <div className="kombos-cart-sidebar__footer-buttons">
               <a
-                href="/cart"
+                href={withRoutePrefix("/cart")}
                 className="kombos-cart-sidebar__view-cart-link"
                 onClick={(e: Event) => {
                   e.preventDefault();

package/data/section-templates/navigation/components/SearchModal/index.tsx

@@ -12,6 +12,7 @@ import {
   createMediaSrcset,
   getProductOptionSet,
   IkasComponentRenderer,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import type { IkasProduct } from "@ikas/bp-storefront";
 import { cx } from "../../../../utils/cx";
@@ -199,7 +200,7 @@ const SearchModal = observer(function SearchModal({
           <div className="kombos-search__logo-area">
             {logo && (
               <a
-                href="/"
+                href={withRoutePrefix("/")}
                 className="kombos-search__logo"
                 style={{
                   "--search-logo-h-desktop": logoSizeDesktop,

package/data/section-templates/navigation/index.tsx

@@ -8,6 +8,7 @@ import {
   getFormattedHeightSize,
   Router,
   createMediaSrcset,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { Props } from "./types";
 import CartSidebar from "./components/CartSidebar";
@@ -104,10 +105,10 @@ export function Navbar(props: Props) {
         {logo && (
           <a
             className="kombos-navbar__logo"
-            href="/"
+            href={withRoutePrefix("/")}
             onClick={(e) => {
               e.preventDefault();
-              Router.navigate("/");
+              Router.navigateToPage("INDEX");
             }}
             style={{
               "--logo-h-desktop": logoSizeDesktop,
@@ -145,7 +146,7 @@ export function Navbar(props: Props) {
           {/* Search */}
           <a
             className="kombos-navbar__icon-btn"
-            href="/search"
+            href={withRoutePrefix("/search")}
             onClick={(e) => {
               e.preventDefault();
               e.stopPropagation();
@@ -159,7 +160,7 @@ export function Navbar(props: Props) {
           {/* Account */}
           <a
             className="kombos-navbar__icon-btn"
-            href={isLoggedIn ? "/account" : "/login"}
+            href={withRoutePrefix(isLoggedIn ? "/account" : "/account/login")}
             onClick={(e) => {
               e.preventDefault();
               e.stopPropagation();
@@ -173,7 +174,7 @@ export function Navbar(props: Props) {
           {/* Cart */}
           <a
             className="kombos-navbar__icon-btn kombos-navbar__cart-trigger"
-            href="/cart"
+            href={withRoutePrefix("/cart")}
             onClick={(e) => {
               e.preventDefault();
               e.stopPropagation();

package/data/section-templates/product-detail-section/index.tsx

@@ -6,6 +6,7 @@ import {
   IkasImage,
   isNotEmpty,
   IkasComponentRenderer,
+  withRoutePrefix,
 } from "@ikas/bp-storefront";
 import { Props } from "./types";
 import Breadcrumb from "../../sub-components/Breadcrumb";
@@ -42,7 +43,10 @@ export function ProductDetail(props: Props) {
       <div className="kombos-container kombos-pd__container">
         <Breadcrumb
           items={[
-            { label: homepageText, href: "/" } as BreadcrumbItem,
+            {
+              label: homepageText,
+              href: withRoutePrefix("/"),
+            } as BreadcrumbItem,
             ...(isNotEmpty(categoryPath)
               ? categoryPath.map(
                   (pathItem: any) =>

package/data/storefront-api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-08-17T09:16:23.125Z",
+  "generatedAt": "2026-08-18T14:25:38.304Z",
   "functions": [
     {
       "name": "apiListProductBrand",
@@ -15148,6 +15148,29 @@
       "isClass": true,
       "className": "Router"
     },
+    {
+      "name": "withRoutePrefix",
+      "signature": "function withRoutePrefix(path: string): string",
+      "description": "Put the visitor's storefront routing in front of a path you wrote yourself.\n\nEntity links (`getProductHref`, `getIkasOrderHref`, …) and LINK props already carry the prefix.\nA literal path in your own markup does not: `href=\"/cart\"` sends a visitor browsing `/en` to the\ndefault language. Wrap it, and a store with no extra routings gets the path back unchanged.\n\nIdempotent — a path that already starts with a supported routing segment is returned as-is.\nAnything that is not a path on this storefront — an absolute URL, `mailto:`, `tel:` — is returned\nuntouched, so a merchant-authored prop can be wrapped without checking it first.",
+      "params": [
+        {
+          "name": "path",
+          "description": "- A path on this storefront, starting with `/`"
+        }
+      ],
+      "returns": "The path under the current routing (e.g. `/cart` → `/en/cart`)",
+      "returnType": "string",
+      "example": "```tsx\nimport { Router, withRoutePrefix } from \"@ikas/bp-storefront\";\n\n// Correct href for crawlers, middle-click and open-in-new-tab...\n<a href={withRoutePrefix(\"/cart\")} onClick={e => {\n  e.preventDefault();\n  Router.navigateToPage(\"CART\"); // ...and this prefixes on its own.\n}}>Cart</a>\n```",
+      "categories": [
+        "Navigation"
+      ],
+      "related": [
+        "navigate",
+        "navigateToPage"
+      ],
+      "isAsync": false,
+      "isClass": false
+    },
     {
       "name": "registerThemeSettingValues",
       "signature": "function registerThemeSettingValues(values: Record<string, any> | null): void",

package/data/storefront-types.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-08-17T09:16:23.151Z",
+  "generatedAt": "2026-08-18T14:25:38.329Z",
   "types": [
     {
       "name": "TextElementTagTypes",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikas/code-components-mcp",
-  "version": "1.4.0-beta.163",
+  "version": "1.4.0-beta.164",
   "description": "MCP server for ikas code components documentation",
   "type": "module",
   "main": "dist/index.js",