@timmbr/cms 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,97 @@
-# Temporary Holding Version
+# @timmbr/cms
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Storefront chrome integration for Timmbr: category tree fetching, navigation mappers, `GlobalHeader`, `GlobalFooter`, and client components for multi-zone layouts.
+
+## Installation
+
+```bash
+pnpm add @timmbr/cms
+```
+
+Peer dependencies:
+- `@timmbr/ui`
+- `@timmbr/auth`
+- `@timmbr/hooks`
+- `react`, `react-dom`, `next`
+
+## Features
+
+- **Category Navigation Tree**: Cached fetching from timmbr-core (`GET /api/v1/categories/tree` via `getCategoryTree`) with graceful fallback.
+
+### Environment (server)
+
+Category tree reads run on the server inside `GlobalHeader` / `GlobalFooter`:
+
+- **`CORE_API_URL`** or **`NEXT_PUBLIC_API_URL`**: timmbr-core base URL (e.g. `http://localhost:8000`).
+- **`CORE_INTERNAL_KEY`** (optional): when set (32+ chars), sent as `x-internal-key` so core can treat the zone as a trusted storefront client.
+
+If neither base URL is set, chrome still renders with an empty category tree. In **development**, `@timmbr/cms` also tries `http://localhost:8000` so catalog/account/checkout zones work without a local `.env` (matching each zone's `env.ts` defaults). For production, set `CORE_API_URL` or `NEXT_PUBLIC_API_URL` on **every zone** that renders `GlobalHeader`.
+- **Nav Mappers**: Transforms category hierarchies into `@timmbr/ui` `NavHeader` and `NavFooter` structures (`toNavTree`, `toCategoryMenus`, `toFooterLinks`).
+- **Zone-Aware Navigation**: Automatic detection of cross-zone links (`catalog`, `shell`, `account`, `checkout`).
+- **Dynamic Footer Social Links**: Pass custom social platforms (`socialLinks` or `social`), auto-resolve branded `@timmbr/icons`, override icons, customize titles, or toggle visibility (`social={false}`). Falls back gracefully to `chromeCopy.footer.socialLinks`.
+- **Unified Chrome Components**:
+  - `GlobalHeader`: Async server component fetching category tree and rendering `StorefrontHeader`.
+  - `GlobalFooter`: Async server component resolving footer sections and rendering `StorefrontFooter`.
+  - `StorefrontHeader`: Client header handling storefront and checkout variants, search suggestions, cart badges, and auth trigger.
+  - `StorefrontFooter`: Client footer rendering branding, legal links, office details, and social icons.
+- **Storefront Search**: `useStorefrontSearch` hook wired to recent searches and product suggestions.
+
+## Usage
+
+### Server Component (Shell / Layout)
+
+```tsx
+import { GlobalHeader, GlobalFooter } from '@timmbr/cms';
+
+export default async function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        <GlobalHeader
+          variant="store"
+          assets={{
+            logo: '/images/logo.svg',
+            miniLogo: '/images/mini-logo.svg',
+          }}
+          zoneContext="shell"
+        />
+        <main>{children}</main>
+        <GlobalFooter
+          assets={{
+            logo: '/images/logo.svg',
+          }}
+          zoneContext="shell"
+          socialLinks={[
+            { name: 'instagram', href: 'https://instagram.com/timmbr' },
+            { name: 'facebook', href: 'https://facebook.com/timmbr' },
+            { name: 'linkedin', href: 'https://linkedin.com/company/timmbr' },
+            { name: 'x', href: 'https://x.com/timmbr' },
+          ]}
+        />
+      </body>
+    </html>
+  );
+}
+```
+
+### Checkout Layout
+
+```tsx
+import { GlobalHeader } from '@timmbr/cms';
+
+export default function CheckoutLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <>
+      <GlobalHeader
+        variant="checkout"
+        assets={{
+          logo: '/images/logo.svg',
+          miniLogo: '/images/mini-logo.svg',
+        }}
+        zoneContext="checkout"
+      />
+      {children}
+    </>
+  );
+}
+```

package/dist/api/categories.d.ts

@@ -0,0 +1,7 @@
+import type { CategoryTreeItem } from '../types';
+/**
+ * Active category tree from timmbr-core (public, cached). Returns an empty array when
+ * core is unreachable or misconfigured.
+ */
+export declare function getCategoryTree(depth?: number): Promise<CategoryTreeItem[]>;
+//# sourceMappingURL=categories.d.ts.map

package/dist/api/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/api/categories.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAKjD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,KAAK,GAAE,MAAsB,GAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsB7B"}

package/dist/api/categories.js

@@ -0,0 +1,28 @@
+import { safeApiCall } from '@timmbr/utils';
+import { FALLBACK_CATEGORY_TREE } from '../fallbacks/categories.js';
+import { getCoreServerClient } from './core-client.js';
+
+const DEFAULT_DEPTH = 3;
+async function getCategoryTree(depth = DEFAULT_DEPTH) {
+  const core = getCoreServerClient();
+  if (!core) {
+    console.warn(
+      "[CMS] CORE_API_URL (or NEXT_PUBLIC_API_URL) is not set; using empty category tree."
+    );
+    return FALLBACK_CATEGORY_TREE;
+  }
+  return safeApiCall(
+    () => core.get("/categories/tree", {
+      params: { depth },
+      skipAuth: true,
+      next: {
+        revalidate: process.env.NODE_ENV === "development" ? 0 : 600,
+        tags: ["categories", "storefront-category-tree"]
+      }
+    }),
+    FALLBACK_CATEGORY_TREE,
+    "[CMS:getCategoryTree]"
+  );
+}
+
+export { getCategoryTree };

package/dist/api/core-client.d.ts

@@ -0,0 +1,8 @@
+import { type ApiClient } from '@timmbr/utils';
+/** timmbr-core host reachable from the zone server (no trailing slash). */
+export declare function resolveCoreBaseUrl(): string | undefined;
+/** Server-side timmbr-core client (`/api/v1`, envelope unwrap). */
+export declare function getCoreServerClient(): ApiClient | null;
+/** Test helper: drop cached client between cases. */
+export declare function __resetCoreServerClientForTests(): void;
+//# sourceMappingURL=core-client.d.ts.map

package/dist/api/core-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-client.d.ts","sourceRoot":"","sources":["../../src/api/core-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAEhE,2EAA2E;AAC3E,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAQvD;AAaD,mEAAmE;AACnE,wBAAgB,mBAAmB,IAAI,SAAS,GAAG,IAAI,CActD;AAED,qDAAqD;AACrD,wBAAgB,+BAA+B,SAG9C"}

package/dist/api/core-client.js

@@ -0,0 +1,30 @@
+import { createApiClient } from '@timmbr/utils';
+
+function resolveCoreBaseUrl() {
+  const raw = process.env.CORE_API_URL || process.env.NEXT_PUBLIC_API_URL || (process.env.NODE_ENV === "development" ? "http://localhost:8000" : void 0);
+  return raw?.replace(/\/+$/, "");
+}
+function coreDefaultHeaders() {
+  const key = process.env.CORE_INTERNAL_KEY;
+  if (key && key.length >= 32) {
+    return { "x-internal-key": key };
+  }
+  return void 0;
+}
+let client = null;
+let clientBaseUrl;
+function getCoreServerClient() {
+  const baseUrl = resolveCoreBaseUrl();
+  if (!baseUrl) return null;
+  if (!client || clientBaseUrl !== baseUrl) {
+    clientBaseUrl = baseUrl;
+    client = createApiClient({
+      baseUrl,
+      apiPrefix: "/api/v1",
+      defaultHeaders: coreDefaultHeaders()
+    });
+  }
+  return client;
+}
+
+export { getCoreServerClient, resolveCoreBaseUrl };

package/dist/components/GlobalFooter.d.ts

@@ -0,0 +1,11 @@
+import type { StorefrontFooterAssets, StorefrontSocialLink, StorefrontSocialProp, StorefrontZoneContext } from '../types';
+export interface GlobalFooterProps {
+    assets: StorefrontFooterAssets;
+    zoneContext?: StorefrontZoneContext;
+    /** Custom social media configuration, link array, or false to hide. Falls back to chromeCopy defaults. */
+    social?: StorefrontSocialProp;
+    /** Shorthand array of social links. */
+    socialLinks?: StorefrontSocialLink[];
+}
+export declare function GlobalFooter({ assets, zoneContext, social, socialLinks, }: GlobalFooterProps): Promise<import("react").JSX.Element>;
+//# sourceMappingURL=GlobalFooter.d.ts.map

package/dist/components/GlobalFooter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalFooter.d.ts","sourceRoot":"","sources":["../../src/components/GlobalFooter.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,0GAA0G;IAC1G,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,uCAAuC;IACvC,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACtC;AAED,wBAAsB,YAAY,CAAC,EACjC,MAAM,EACN,WAAqB,EACrB,MAAM,EACN,WAAW,GACZ,EAAE,iBAAiB,wCAkCnB"}

package/dist/components/GlobalFooter.js

@@ -0,0 +1,44 @@
+import { jsx } from 'react/jsx-runtime';
+import { getCategoryTree } from '../api/categories.js';
+import { toNavTree, toFooterLinks, footerItemCrossZone } from '../mappers/nav.js';
+import { chromeCopy } from '../copy/chrome.js';
+import { StorefrontFooter } from './StorefrontFooter.js';
+
+async function GlobalFooter({
+  assets,
+  zoneContext = "shell",
+  social,
+  socialLinks
+}) {
+  const categories = toNavTree(await getCategoryTree());
+  const shopLinks = toFooterLinks(categories);
+  const footerZone = zoneContext === "catalog" ? "catalog" : "default";
+  const sections = [
+    ...shopLinks.length ? [{ id: "shop", title: chromeCopy.footer.shopTitle, items: shopLinks }] : [],
+    ...chromeCopy.footer.sections
+  ];
+  const navigation = {
+    sections: sections.map((section) => ({
+      id: section.id,
+      title: section.title,
+      items: section.items.map((item) => ({
+        id: item.id,
+        label: item.label,
+        href: item.href,
+        crossZone: footerItemCrossZone(item.href, footerZone)
+      }))
+    }))
+  };
+  return /* @__PURE__ */ jsx(
+    StorefrontFooter,
+    {
+      assets,
+      navigation,
+      zoneContext,
+      social,
+      socialLinks
+    }
+  );
+}
+
+export { GlobalFooter };

package/dist/components/GlobalHeader.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import type { StorefrontChromeAssets, StorefrontZoneContext } from '../types';
+export interface GlobalHeaderProps {
+    variant?: 'store' | 'checkout';
+    assets: StorefrontChromeAssets;
+    zoneContext?: StorefrontZoneContext;
+    /** Shell-only: sale banner or other chrome below the sticky bar. */
+    belowNav?: React.ReactNode;
+    navHeaderClassName?: string;
+    useStickyShell?: boolean;
+}
+export declare function GlobalHeader({ variant, assets, zoneContext, belowNav, navHeaderClassName, useStickyShell, }: GlobalHeaderProps): Promise<React.JSX.Element>;
+//# sourceMappingURL=GlobalHeader.d.ts.map

package/dist/components/GlobalHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalHeader.d.ts","sourceRoot":"","sources":["../../src/components/GlobalHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC/B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAsB,YAAY,CAAC,EACjC,OAAiB,EACjB,MAAM,EACN,WAAqB,EACrB,QAAQ,EACR,kBAAkB,EAClB,cAAsB,GACvB,EAAE,iBAAiB,8BAenB"}

package/dist/components/GlobalHeader.js

@@ -0,0 +1,29 @@
+import { jsx } from 'react/jsx-runtime';
+import { getCategoryTree } from '../api/categories.js';
+import { toNavTree } from '../mappers/nav.js';
+import { StorefrontHeader } from './StorefrontHeader.js';
+
+async function GlobalHeader({
+  variant = "store",
+  assets,
+  zoneContext = "shell",
+  belowNav,
+  navHeaderClassName,
+  useStickyShell = false
+}) {
+  const categories = variant === "checkout" ? [] : toNavTree(await getCategoryTree());
+  return /* @__PURE__ */ jsx(
+    StorefrontHeader,
+    {
+      variant,
+      assets,
+      categories,
+      zoneContext: variant === "checkout" ? "checkout" : zoneContext,
+      belowNav,
+      navHeaderClassName,
+      useStickyShell
+    }
+  );
+}
+
+export { GlobalHeader };

package/dist/components/StorefrontFooter.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { NavFooterNavigationConfig } from '@timmbr/ui';
+import type { StorefrontFooterAssets, StorefrontSocialLink, StorefrontSocialProp, StorefrontZoneContext } from '../types';
+export interface StorefrontFooterProps {
+    assets: StorefrontFooterAssets;
+    navigation: NavFooterNavigationConfig;
+    zoneContext: StorefrontZoneContext;
+    /** Custom social media configuration, link array, or false to hide. Falls back to chromeCopy defaults. */
+    social?: StorefrontSocialProp;
+    /** Shorthand array of social links. */
+    socialLinks?: StorefrontSocialLink[];
+}
+export declare function StorefrontFooter({ assets, navigation, zoneContext, social, socialLinks, }: StorefrontFooterProps): React.JSX.Element;
+//# sourceMappingURL=StorefrontFooter.d.ts.map

package/dist/components/StorefrontFooter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorefrontFooter.d.ts","sourceRoot":"","sources":["../../src/components/StorefrontFooter.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,yBAAyB,EAAuB,MAAM,YAAY,CAAC;AAWjF,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AA4BlB,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,UAAU,EAAE,yBAAyB,CAAC;IACtC,WAAW,EAAE,qBAAqB,CAAC;IACnC,0GAA0G;IAC1G,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,uCAAuC;IACvC,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACtC;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,UAAU,EACV,WAAW,EACX,MAAM,EACN,WAAW,GACZ,EAAE,qBAAqB,qBAwEvB"}

package/dist/components/StorefrontFooter.js

@@ -0,0 +1,107 @@
+"use client";
+import { jsx } from 'react/jsx-runtime';
+import * as React from 'react';
+import Image from 'next/image';
+import Link from 'next/link';
+import { NavFooter } from '@timmbr/ui';
+import { AppleIcon, GoogleIcon, GitHubIcon, TwitterXIcon, LinkedInIcon, FacebookIcon, InstagramIcon } from '@timmbr/icons';
+import { chromeCopy } from '../copy/chrome.js';
+
+const SOCIAL_ICON_PROPS = {
+  width: 24,
+  height: 24,
+  className: "shrink-0"
+};
+const SOCIAL_ICONS = {
+  instagram: /* @__PURE__ */ jsx(InstagramIcon, { ...SOCIAL_ICON_PROPS }),
+  facebook: /* @__PURE__ */ jsx(FacebookIcon, { ...SOCIAL_ICON_PROPS }),
+  linkedin: /* @__PURE__ */ jsx(LinkedInIcon, { ...SOCIAL_ICON_PROPS }),
+  twitter: /* @__PURE__ */ jsx(TwitterXIcon, { ...SOCIAL_ICON_PROPS }),
+  x: /* @__PURE__ */ jsx(TwitterXIcon, { ...SOCIAL_ICON_PROPS }),
+  github: /* @__PURE__ */ jsx(GitHubIcon, { ...SOCIAL_ICON_PROPS }),
+  google: /* @__PURE__ */ jsx(GoogleIcon, { ...SOCIAL_ICON_PROPS }),
+  apple: /* @__PURE__ */ jsx(AppleIcon, { ...SOCIAL_ICON_PROPS })
+};
+function resolveSocialLinks(links) {
+  return links.map((link) => ({
+    ...link,
+    icon: link.icon ?? SOCIAL_ICONS[link.name.toLowerCase()]
+  }));
+}
+function StorefrontFooter({
+  assets,
+  navigation,
+  zoneContext,
+  social,
+  socialLinks
+}) {
+  const useCatalogLinks = zoneContext === "catalog";
+  const resolvedSocial = React.useMemo(() => {
+    if (social === false) {
+      return { show: false, links: [] };
+    }
+    if (Array.isArray(social)) {
+      return {
+        title: chromeCopy.footer.socialTitle,
+        links: resolveSocialLinks(social)
+      };
+    }
+    if (social && typeof social === "object") {
+      return {
+        title: social.title ?? chromeCopy.footer.socialTitle,
+        show: social.show,
+        links: resolveSocialLinks(social.links ?? [])
+      };
+    }
+    if (socialLinks) {
+      return {
+        title: chromeCopy.footer.socialTitle,
+        links: resolveSocialLinks(socialLinks)
+      };
+    }
+    return {
+      title: chromeCopy.footer.socialTitle,
+      links: resolveSocialLinks(chromeCopy.footer.socialLinks)
+    };
+  }, [social, socialLinks]);
+  return /* @__PURE__ */ jsx(
+    NavFooter,
+    {
+      containerMaxWidth: "2xl",
+      linkComponent: useCatalogLinks ? Link : void 0,
+      branding: {
+        logo: /* @__PURE__ */ jsx(
+          Image,
+          {
+            src: assets.logo,
+            alt: chromeCopy.branding.logoAlt,
+            width: 140,
+            height: 34,
+            className: "h-8 w-auto object-contain"
+          }
+        ),
+        description: chromeCopy.footer.tagline,
+        href: "/",
+        alt: chromeCopy.branding.logoAlt,
+        ...useCatalogLinks ? { zone: "shell" } : {}
+      },
+      navigation,
+      social: resolvedSocial,
+      office: {
+        title: chromeCopy.footer.office.title,
+        address: chromeCopy.footer.office.address
+      },
+      legal: {
+        copyright: chromeCopy.footer.copyright,
+        links: chromeCopy.footer.legalLinks.map((link) => ({
+          id: link.id,
+          label: link.label,
+          href: link.href,
+          crossZone: useCatalogLinks
+        }))
+      }
+    }
+  );
+}
+
+export { StorefrontFooter };

package/dist/components/StorefrontHeader.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import type { CategoryNavNode, StorefrontChromeAssets, StorefrontZoneContext } from '../types';
+export interface StorefrontHeaderProps {
+    variant: 'store' | 'checkout';
+    assets: StorefrontChromeAssets;
+    categories: CategoryNavNode[];
+    zoneContext: StorefrontZoneContext;
+    /** Shell: outer sticky wrapper and optional banner below the bar. */
+    useStickyShell?: boolean;
+    navHeaderClassName?: string;
+    belowNav?: React.ReactNode;
+}
+export declare function StorefrontHeader({ variant, assets, categories, zoneContext, useStickyShell, navHeaderClassName, belowNav, }: StorefrontHeaderProps): React.JSX.Element;
+//# sourceMappingURL=StorefrontHeader.d.ts.map

package/dist/components/StorefrontHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorefrontHeader.d.ts","sourceRoot":"","sources":["../../src/components/StorefrontHeader.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAoBlB,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,GAAG,UAAU,CAAC;IAC9B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,EAAE,qBAAqB,CAAC;IACnC,qEAAqE;IACrE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,MAAM,EACN,UAAU,EACV,WAAW,EACX,cAAsB,EACtB,kBAAkB,EAClB,QAAQ,GACT,EAAE,qBAAqB,qBA6HvB"}

package/dist/components/StorefrontHeader.js

@@ -0,0 +1,136 @@
+"use client";
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import Image from 'next/image';
+import Link from 'next/link';
+import { toNavMenuItems, NavHeader, Inline, Icon, Text } from '@timmbr/ui';
+import { useProfileAction, useCartCount } from '@timmbr/auth';
+import { Lock, User, Package } from '@timmbr/icons';
+import { chromeCopy } from '../copy/chrome.js';
+import { useStorefrontSearch } from '../hooks/useStorefrontSearch.js';
+import { toCategoryMenus } from '../mappers/nav.js';
+
+const MENU_ICONS = {
+  orders: /* @__PURE__ */ jsx(Icon, { size: "sm", children: /* @__PURE__ */ jsx(Package, {}) }),
+  account: /* @__PURE__ */ jsx(Icon, { size: "sm", children: /* @__PURE__ */ jsx(User, {}) })
+};
+const PROFILE_MENU = chromeCopy.header.actions.account.menu.map((item) => ({
+  ...item,
+  icon: MENU_ICONS[item.id]
+}));
+function StorefrontHeader({
+  variant,
+  assets,
+  categories,
+  zoneContext,
+  useStickyShell = false,
+  navHeaderClassName,
+  belowNav
+}) {
+  const { profileAction, onAuthTrigger } = useProfileAction({
+    accountHref: chromeCopy.header.actions.account.href,
+    menuItems: PROFILE_MENU
+  });
+  const search = useStorefrontSearch();
+  const cartCount = useCartCount() ?? 0;
+  const navItems = variant === "store" ? toNavMenuItems(toCategoryMenus(categories, chromeCopy.header.categoryNav), {
+    ...zoneContext === "catalog" ? { linkComponent: Link } : { crossZone: true }
+  }) : [];
+  const branding = {
+    logo: /* @__PURE__ */ jsx(
+      Image,
+      {
+        src: assets.logo,
+        alt: chromeCopy.branding.logoAlt,
+        width: 130,
+        height: 32,
+        priority: true,
+        className: "h-8 w-auto object-contain"
+      }
+    ),
+    miniLogo: /* @__PURE__ */ jsx(
+      Image,
+      {
+        src: assets.miniLogo,
+        alt: chromeCopy.branding.miniLogoAlt,
+        width: 32,
+        height: 32,
+        priority: true,
+        className: variant === "checkout" ? "h-8 w-8 object-contain" : "h-8 w-auto object-contain"
+      }
+    ),
+    href: "/",
+    alt: chromeCopy.branding.logoAlt,
+    ...zoneContext === "catalog" ? { zone: "shell" } : {}
+  };
+  const header = variant === "checkout" ? /* @__PURE__ */ jsx(
+    NavHeader,
+    {
+      sticky: !useStickyShell,
+      authMode: "modal",
+      onAuthTrigger,
+      showOfferBanner: false,
+      containerMaxWidth: "2xl",
+      branding,
+      search: false,
+      navigation: { show: false },
+      mobile: { tabSlider: false },
+      actions: {
+        items: [
+          {
+            id: "secure",
+            label: chromeCopy.header.secure,
+            icon: /* @__PURE__ */ jsx(Lock, {}),
+            priority: "high",
+            render: () => /* @__PURE__ */ jsxs(Inline, { gap: 2, align: "center", className: "shrink-0 px-2", children: [
+              /* @__PURE__ */ jsx(Icon, { size: "sm", children: /* @__PURE__ */ jsx(Lock, {}) }),
+              /* @__PURE__ */ jsx(Text, { variant: "body-3", weight: "medium", foreground: "muted", children: chromeCopy.header.secure })
+            ] })
+          }
+        ],
+        profile: profileAction,
+        wishlist: false,
+        cart: false
+      },
+      className: navHeaderClassName
+    }
+  ) : /* @__PURE__ */ jsx(
+    NavHeader,
+    {
+      sticky: !useStickyShell,
+      authMode: "modal",
+      onAuthTrigger,
+      showOfferBanner: false,
+      containerMaxWidth: "2xl",
+      linkComponent: zoneContext === "catalog" ? Link : void 0,
+      branding,
+      navigation: { items: navItems },
+      search,
+      actions: {
+        profile: profileAction,
+        wishlist: {
+          label: chromeCopy.header.actions.wishlist.label,
+          href: chromeCopy.header.actions.wishlist.href,
+          ariaLabel: chromeCopy.header.actions.wishlist.ariaLabel,
+          crossZone: true
+        },
+        cart: {
+          label: chromeCopy.header.actions.cart.label,
+          href: chromeCopy.header.actions.cart.href,
+          ariaLabel: chromeCopy.header.actions.cart.ariaLabel,
+          count: cartCount,
+          ...zoneContext === "shell" ? {} : { crossZone: true }
+        }
+      },
+      className: navHeaderClassName
+    }
+  );
+  if (!useStickyShell) {
+    return header;
+  }
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("div", { className: "sticky top-0 z-40", children: header }),
+    belowNav
+  ] });
+}
+
+export { StorefrontHeader };

package/dist/copy/chrome.d.ts

@@ -0,0 +1,126 @@
+/** Shared storefront chrome copy (header, footer, branding). */
+export declare const chromeCopy: {
+    readonly branding: {
+        readonly logoAlt: "timmbr - Solid Wood Furniture";
+        readonly miniLogoAlt: "timmbr leaf icon";
+    };
+    readonly header: {
+        readonly search: {
+            readonly placeholder: "Search solid wood furniture, collections, artisanal pieces...";
+            readonly ariaLabel: "Search products";
+            readonly recentTitle: "Recent searches";
+            readonly clearRecent: "Clear";
+            readonly removeRecent: (query: string) => string;
+            readonly resultsTitle: "Products";
+            readonly noResults: "No products match";
+            readonly seeAll: (query: string) => string;
+        };
+        readonly categoryNav: {
+            readonly viewAll: (name: string) => string;
+            readonly viewMore: "View all";
+        };
+        readonly actions: {
+            readonly account: {
+                readonly href: "/account";
+                readonly menu: readonly [{
+                    readonly id: "orders";
+                    readonly label: "My orders";
+                    readonly href: "/account/orders";
+                }, {
+                    readonly id: "account";
+                    readonly label: "Your account";
+                    readonly href: "/account/security";
+                }];
+            };
+            readonly wishlist: {
+                readonly label: "WISH LIST";
+                readonly ariaLabel: "Wishlist";
+                readonly href: "/account/wishlist";
+            };
+            readonly cart: {
+                readonly label: "CART";
+                readonly ariaLabel: "Shopping Cart";
+                readonly href: "/checkout";
+            };
+        };
+        readonly secure: "Secure checkout";
+    };
+    readonly footer: {
+        readonly tagline: "Handcrafted solid wood furniture built with precision, finished slowly, and made to last generations.";
+        readonly office: {
+            readonly title: "Registered Office:";
+            readonly address: "Timmbr Furnitures, SABN Kallappa Layout, Ashwini Extension, Chintamani, Karnataka 563125";
+        };
+        readonly shopTitle: "Shop";
+        readonly sections: readonly [{
+            readonly id: "craft";
+            readonly title: "Craft";
+            readonly items: readonly [{
+                readonly id: "materials";
+                readonly label: "Our materials";
+                readonly href: "/craft/materials";
+            }, {
+                readonly id: "workshop";
+                readonly label: "The workshop";
+                readonly href: "/craft/workshop";
+            }, {
+                readonly id: "sustainability";
+                readonly label: "Sustainability";
+                readonly href: "/craft/sustainability";
+            }, {
+                readonly id: "care";
+                readonly label: "Care guide";
+                readonly href: "/craft/care-guide";
+            }];
+        }, {
+            readonly id: "help";
+            readonly title: "Help";
+            readonly items: readonly [{
+                readonly id: "contact";
+                readonly label: "Contact us";
+                readonly href: "/help/contact";
+            }, {
+                readonly id: "shipping";
+                readonly label: "Shipping & delivery";
+                readonly href: "/help/shipping";
+            }, {
+                readonly id: "warranty";
+                readonly label: "Warranty & returns";
+                readonly href: "/help/warranty";
+            }, {
+                readonly id: "trade";
+                readonly label: "Trade & commercial";
+                readonly href: "/help/trade";
+            }];
+        }];
+        readonly socialTitle: "Follow Us";
+        readonly socialLinks: readonly [{
+            readonly name: "instagram";
+            readonly href: "https://instagram.com";
+        }, {
+            readonly name: "facebook";
+            readonly href: "https://facebook.com";
+        }, {
+            readonly name: "linkedin";
+            readonly href: "https://linkedin.com";
+        }, {
+            readonly name: "twitter";
+            readonly href: "https://x.com";
+        }];
+        readonly copyright: "© 2026 Timmbr Furniture Co. All rights reserved.";
+        readonly legalLinks: readonly [{
+            readonly id: "privacy";
+            readonly label: "Privacy policy";
+            readonly href: "/legal/privacy";
+        }, {
+            readonly id: "terms";
+            readonly label: "Terms of service";
+            readonly href: "/legal/terms";
+        }, {
+            readonly id: "cookies";
+            readonly label: "Cookie preferences";
+            readonly href: "/legal/cookies";
+        }];
+    };
+};
+//# sourceMappingURL=chrome.d.ts.map

package/dist/copy/chrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../../src/copy/chrome.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,eAAO,MAAM,UAAU;;;;;;;;;;;2CAYK,MAAM;;;qCAGZ,MAAM;;;qCAGN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFlB,CAAC"}

package/dist/copy/chrome.js

@@ -0,0 +1,99 @@
+const chromeCopy = {
+  branding: {
+    logoAlt: "timmbr - Solid Wood Furniture",
+    miniLogoAlt: "timmbr leaf icon"
+  },
+  header: {
+    search: {
+      placeholder: "Search solid wood furniture, collections, artisanal pieces...",
+      ariaLabel: "Search products",
+      recentTitle: "Recent searches",
+      clearRecent: "Clear",
+      removeRecent: (query) => `Remove “${query}” from recent searches`,
+      resultsTitle: "Products",
+      noResults: "No products match",
+      seeAll: (query) => `See all results for “${query}”`
+    },
+    categoryNav: {
+      viewAll: (name) => `All ${name}`,
+      viewMore: "View all"
+    },
+    actions: {
+      account: {
+        href: "/account",
+        menu: [
+          { id: "orders", label: "My orders", href: "/account/orders" },
+          { id: "account", label: "Your account", href: "/account/security" }
+        ]
+      },
+      wishlist: {
+        label: "WISH LIST",
+        ariaLabel: "Wishlist",
+        href: "/account/wishlist"
+      },
+      cart: {
+        label: "CART",
+        ariaLabel: "Shopping Cart",
+        href: "/checkout"
+      }
+    },
+    secure: "Secure checkout"
+  },
+  footer: {
+    tagline: "Handcrafted solid wood furniture built with precision, finished slowly, and made to last generations.",
+    office: {
+      title: "Registered Office:",
+      address: "Timmbr Furnitures, SABN Kallappa Layout, Ashwini Extension, Chintamani, Karnataka 563125"
+    },
+    shopTitle: "Shop",
+    sections: [
+      {
+        id: "craft",
+        title: "Craft",
+        items: [
+          { id: "materials", label: "Our materials", href: "/craft/materials" },
+          { id: "workshop", label: "The workshop", href: "/craft/workshop" },
+          {
+            id: "sustainability",
+            label: "Sustainability",
+            href: "/craft/sustainability"
+          },
+          { id: "care", label: "Care guide", href: "/craft/care-guide" }
+        ]
+      },
+      {
+        id: "help",
+        title: "Help",
+        items: [
+          { id: "contact", label: "Contact us", href: "/help/contact" },
+          {
+            id: "shipping",
+            label: "Shipping & delivery",
+            href: "/help/shipping"
+          },
+          {
+            id: "warranty",
+            label: "Warranty & returns",
+            href: "/help/warranty"
+          },
+          { id: "trade", label: "Trade & commercial", href: "/help/trade" }
+        ]
+      }
+    ],
+    socialTitle: "Follow Us",
+    socialLinks: [
+      { name: "instagram", href: "https://instagram.com" },
+      { name: "facebook", href: "https://facebook.com" },
+      { name: "linkedin", href: "https://linkedin.com" },
+      { name: "twitter", href: "https://x.com" }
+    ],
+    copyright: "© 2026 Timmbr Furniture Co. All rights reserved.",
+    legalLinks: [
+      { id: "privacy", label: "Privacy policy", href: "/legal/privacy" },
+      { id: "terms", label: "Terms of service", href: "/legal/terms" },
+      { id: "cookies", label: "Cookie preferences", href: "/legal/cookies" }
+    ]
+  }
+};
+
+export { chromeCopy };

package/dist/fallbacks/categories.d.ts

@@ -0,0 +1,4 @@
+import type { CategoryTreeItem } from '../types';
+/** Empty tree: chrome still renders logo, search, and static footer sections. */
+export declare const FALLBACK_CATEGORY_TREE: CategoryTreeItem[];
+//# sourceMappingURL=categories.d.ts.map

package/dist/fallbacks/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/fallbacks/categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EAAO,CAAC"}

package/dist/fallbacks/categories.js

@@ -0,0 +1,3 @@
+const FALLBACK_CATEGORY_TREE = [];
+
+export { FALLBACK_CATEGORY_TREE };

package/dist/hooks/useStorefrontSearch.d.ts

@@ -0,0 +1,19 @@
+import type { NavSearchConfig, NavSearchResult } from '@timmbr/ui';
+export declare const RECENT_SEARCHES_KEY = "timmbr:recent-searches:v1";
+interface SuggestedProduct {
+    id: string;
+    slug: string;
+    title: string;
+    brandName: string | null;
+    price: number;
+    currency: string;
+    coverImage: {
+        url: string;
+        alt: string | null;
+    } | null;
+}
+export declare const searchHref: (query: string) => string;
+export declare function toSearchResult(product: SuggestedProduct): NavSearchResult;
+export declare function useStorefrontSearch(): NavSearchConfig;
+export {};
+//# sourceMappingURL=useStorefrontSearch.d.ts.map

package/dist/hooks/useStorefrontSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStorefrontSearch.d.ts","sourceRoot":"","sources":["../../src/hooks/useStorefrontSearch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAInE,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAG/D,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACxD;AAED,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,WACU,CAAC;AAenD,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAWzE;AAED,wBAAgB,mBAAmB,IAAI,eAAe,CA2CrD"}

package/dist/hooks/useStorefrontSearch.js

@@ -0,0 +1,73 @@
+"use client";
+import { useState, useCallback, useMemo } from 'react';
+import { useRecentSearches, useSearchSuggestions } from '@timmbr/hooks';
+import { formatCurrency } from '@timmbr/utils';
+import { chromeCopy } from '../copy/chrome.js';
+
+const RECENT_SEARCHES_KEY = "timmbr:recent-searches:v1";
+const SUGGEST_URL = "/products/api/search-suggest";
+const searchHref = (query) => `/products?${new URLSearchParams({ q: query })}`;
+async function fetchSuggestions(query, signal) {
+  const response = await fetch(
+    `${SUGGEST_URL}?${new URLSearchParams({ q: query })}`,
+    { signal }
+  );
+  if (!response.ok) return [];
+  const body = await response.json();
+  return body.products ?? [];
+}
+function toSearchResult(product) {
+  return {
+    id: product.id,
+    href: `/products/${product.slug}`,
+    crossZone: true,
+    title: product.title,
+    subtitle: product.brandName ?? void 0,
+    price: formatCurrency(product.price, product.currency),
+    imageUrl: product.coverImage?.url,
+    imageAlt: product.coverImage?.alt ?? ""
+  };
+}
+function useStorefrontSearch() {
+  const [value, setValue] = useState("");
+  const recent = useRecentSearches({ storageKey: RECENT_SEARCHES_KEY });
+  const suggestions = useSearchSuggestions(value, fetchSuggestions);
+  const { add } = recent;
+  const copy = chromeCopy.header.search;
+  const onSubmit = useCallback(
+    (query) => {
+      const q = query.trim();
+      if (!q) return;
+      add(q);
+      window.location.assign(searchHref(q));
+    },
+    [add]
+  );
+  const items = useMemo(
+    () => suggestions.items.map(toSearchResult),
+    [suggestions.items]
+  );
+  return {
+    show: true,
+    placeholder: copy.placeholder,
+    ariaLabel: copy.ariaLabel,
+    value,
+    onChange: setValue,
+    onSubmit,
+    recentSearches: recent.items,
+    recentSearchesTitle: copy.recentTitle,
+    onRecentSearchRemove: recent.remove,
+    onClearRecentSearches: recent.clear,
+    clearRecentSearchesLabel: copy.clearRecent,
+    removeRecentSearchLabel: copy.removeRecent,
+    results: {
+      items,
+      loading: suggestions.loading,
+      title: copy.resultsTitle,
+      emptyLabel: copy.noResults,
+      viewAllLabel: copy.seeAll
+    }
+  };
+}
+
+export { RECENT_SEARCHES_KEY, searchHref, toSearchResult, useStorefrontSearch };

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { getCategoryTree } from './api/categories';
+export { GlobalHeader } from './components/GlobalHeader';
+export type { GlobalHeaderProps } from './components/GlobalHeader';
+export { GlobalFooter } from './components/GlobalFooter';
+export type { GlobalFooterProps } from './components/GlobalFooter';
+export { StorefrontHeader } from './components/StorefrontHeader';
+export type { StorefrontHeaderProps } from './components/StorefrontHeader';
+export { StorefrontFooter } from './components/StorefrontFooter';
+export type { StorefrontFooterProps } from './components/StorefrontFooter';
+export { toNavTree, toCategoryMenus, toFooterLinks, isCatalogHref, footerItemCrossZone, NAV_ROOT_LIMIT, NAV_LINKS_PER_GROUP, categoryHref, toMenuGroups, toMenuTiles, } from './mappers/nav';
+export type { CategoryNavCopy } from './mappers/nav';
+export type { CategoryNavNode, CategoryTreeItem, StorefrontZoneContext, StorefrontChromeAssets, StorefrontFooterAssets, StorefrontSocialLink, StorefrontSocialConfig, StorefrontSocialProp, } from './types';
+export { chromeCopy } from './copy/chrome';
+export { RECENT_SEARCHES_KEY, useStorefrontSearch } from './hooks/useStorefrontSearch';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EACL,SAAS,EACT,eAAe,EACf,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { getCategoryTree } from './api/categories.js';
+export { GlobalHeader } from './components/GlobalHeader.js';
+export { GlobalFooter } from './components/GlobalFooter.js';
+export { StorefrontHeader } from './components/StorefrontHeader.js';
+export { StorefrontFooter } from './components/StorefrontFooter.js';
+export { NAV_LINKS_PER_GROUP, NAV_ROOT_LIMIT, categoryHref, footerItemCrossZone, isCatalogHref, toCategoryMenus, toFooterLinks, toMenuGroups, toMenuTiles, toNavTree } from './mappers/nav.js';
+export { chromeCopy } from './copy/chrome.js';
+export { RECENT_SEARCHES_KEY, useStorefrontSearch } from './hooks/useStorefrontSearch.js';

package/dist/mappers/nav.d.ts

@@ -0,0 +1,25 @@
+import type { NavMenuData, NavMenuGroup, NavMenuTile } from '@timmbr/ui';
+import type { CategoryNavNode, CategoryTreeItem } from '../types';
+/** Roots shown in the header and footer (no ranking yet: the first by name). */
+export declare const NAV_ROOT_LIMIT = 5;
+/** Subcategory links under one heading before a "View all" link takes over. */
+export declare const NAV_LINKS_PER_GROUP = 8;
+export interface CategoryNavCopy {
+    viewAll: (name: string) => string;
+    viewMore: string;
+}
+export declare const categoryHref: (slug: string) => string;
+export declare function toNavTree(tree: CategoryTreeItem[]): CategoryNavNode[];
+export declare function toMenuGroups(root: CategoryNavNode, copy: CategoryNavCopy): NavMenuGroup[];
+export declare function toMenuTiles(root: CategoryNavNode, copy: CategoryNavCopy): NavMenuTile[];
+export declare function toCategoryMenus(tree: CategoryNavNode[], copy: CategoryNavCopy): NavMenuData[];
+export declare function toFooterLinks(tree: CategoryNavNode[]): {
+    id: string;
+    label: string;
+    href: string;
+}[];
+/** True when href targets the catalog zone (cross-zone from shell/account). */
+export declare function isCatalogHref(href: string): boolean;
+/** Footer nav item: crossZone when leaving the rendering zone. */
+export declare function footerItemCrossZone(href: string, zone: 'catalog' | 'default'): boolean;
+//# sourceMappingURL=nav.d.ts.map

package/dist/mappers/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../src/mappers/nav.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAElE,gFAAgF;AAChF,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,WAAwB,CAAC;AAUlE,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,eAAe,EAAE,CAQrE;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,eAAe,GACpB,YAAY,EAAE,CAiChB;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,eAAe,GACpB,WAAW,EAAE,CASf;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,eAAe,EAAE,EACvB,IAAI,EAAE,eAAe,GACpB,WAAW,EAAE,CAOf;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE;;;;IAEpD;AAID,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,WAKzC;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,GAAG,SAAS,WAI5B"}

package/dist/mappers/nav.js

@@ -0,0 +1,80 @@
+import { mapTree } from '@timmbr/utils';
+
+const NAV_ROOT_LIMIT = 5;
+const NAV_LINKS_PER_GROUP = 8;
+const categoryHref = (slug) => `/category/${slug}`;
+const navRoots = (tree) => tree.slice(0, NAV_ROOT_LIMIT);
+const link = (node, label = node.name) => ({
+  id: node.id,
+  label,
+  href: categoryHref(node.slug)
+});
+function toNavTree(tree) {
+  return mapTree(navRoots(tree), (node, children) => ({
+    id: node.id,
+    name: node.name,
+    slug: node.slug,
+    logoUrl: node.logoUrl ?? null,
+    children
+  }));
+}
+function toMenuGroups(root, copy) {
+  const children = root.children ?? [];
+  const leaves = children.filter((child) => !child.children?.length);
+  const branches = children.filter((child) => child.children?.length);
+  const rootGroup = {
+    id: root.id,
+    title: root.name,
+    links: [
+      link(root, copy.viewAll(root.name)),
+      ...leaves.map((node) => link(node))
+    ]
+  };
+  const childGroups = branches.map((child) => {
+    const grandchildren = child.children ?? [];
+    return {
+      id: child.id,
+      title: child.name,
+      links: [
+        link(child, copy.viewAll(child.name)),
+        ...grandchildren.slice(0, NAV_LINKS_PER_GROUP).map((node) => link(node))
+      ],
+      more: grandchildren.length > NAV_LINKS_PER_GROUP ? { label: copy.viewMore, href: categoryHref(child.slug) } : void 0
+    };
+  });
+  return [rootGroup, ...childGroups];
+}
+function toMenuTiles(root, copy) {
+  const children = root.children ?? [];
+  return [
+    {
+      ...link(root, copy.viewAll(root.name)),
+      imageSrc: root.logoUrl ?? children.find((c) => c.logoUrl)?.logoUrl
+    },
+    ...children.map((child) => ({ ...link(child), imageSrc: child.logoUrl }))
+  ];
+}
+function toCategoryMenus(tree, copy) {
+  return navRoots(tree).map((root) => ({
+    id: root.id,
+    label: root.name,
+    groups: toMenuGroups(root, copy),
+    tiles: toMenuTiles(root, copy)
+  }));
+}
+function toFooterLinks(tree) {
+  return navRoots(tree).map((root) => link(root));
+}
+const CATALOG_PREFIXES = ["/products", "/category"];
+function isCatalogHref(href) {
+  const path = href.split(/[?#]/)[0];
+  return CATALOG_PREFIXES.some(
+    (prefix) => path === prefix || path.startsWith(`${prefix}/`)
+  );
+}
+function footerItemCrossZone(href, zone) {
+  const catalog = isCatalogHref(href);
+  return zone === "catalog" ? !catalog : catalog;
+}
+
+export { NAV_LINKS_PER_GROUP, NAV_ROOT_LIMIT, categoryHref, footerItemCrossZone, isCatalogHref, toCategoryMenus, toFooterLinks, toMenuGroups, toMenuTiles, toNavTree };

package/dist/types/index.d.ts

@@ -0,0 +1,28 @@
+import type { NavFooterSocialConfig, NavFooterSocialLink } from '@timmbr/ui';
+export type StorefrontSocialLink = NavFooterSocialLink;
+export type StorefrontSocialConfig = NavFooterSocialConfig;
+export type StorefrontSocialProp = StorefrontSocialConfig | StorefrontSocialLink[] | false;
+export interface CategoryTreeItem {
+    id: string;
+    name: string;
+    slug: string;
+    logoUrl?: string | null;
+    parentId?: string | null;
+    children?: CategoryTreeItem[];
+}
+export interface CategoryNavNode {
+    id: string;
+    name: string;
+    slug: string;
+    logoUrl?: string | null;
+    children?: CategoryNavNode[];
+}
+export type StorefrontZoneContext = 'shell' | 'catalog' | 'account' | 'checkout';
+export interface StorefrontChromeAssets {
+    logo: string;
+    miniLogo: string;
+}
+export interface StorefrontFooterAssets {
+    logo: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACvD,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAC3D,MAAM,MAAM,oBAAoB,GAC5B,sBAAsB,GACtB,oBAAoB,EAAE,GACtB,KAAK,CAAC;AAEV,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;CACd"}

package/package.json

@@ -1,6 +1,73 @@
 {
   "name": "@timmbr/cms",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "Storefront chrome integration: category tree fetch, nav mapping, GlobalHeader and GlobalFooter for multi-zone layouts",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@timmbr/icons": "^1.7.0",
+    "@timmbr/utils": "^1.6.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "next": ">=14.0.0",
+    "@timmbr/ui": "*",
+    "@timmbr/auth": "*",
+    "@timmbr/hooks": "*"
+  },
+  "peerDependenciesMeta": {
+    "@timmbr/ui": {
+      "optional": false
+    },
+    "@timmbr/auth": {
+      "optional": false
+    },
+    "@timmbr/hooks": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.2.0",
+    "@types/react": "^19.0.8",
+    "@types/react-dom": "^19.0.3",
+    "@vitejs/plugin-react": "^4.3.4",
+    "jsdom": "^26.0.0",
+    "next": "16.3.5",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "rimraf": "^6.0.1",
+    "rollup-plugin-preserve-directives": "^0.4.0",
+    "typescript": "^5.7.3",
+    "vite": "^6.2.0",
+    "vitest": "^3.0.5",
+    "@timmbr/ui": "1.17.6",
+    "@timmbr/auth": "1.4.7",
+    "@timmbr/hooks": "1.3.0",
+    "@timmbr/tsconfig": "1.0.0"
+  },
+  "scripts": {
+    "build": "vite build && tsc --project tsconfig.build.json",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rimraf dist"
+  }
 }