@cimpress-ui/react 1.30.1 → 1.31.0

package/dist/commonjs/components/app-shell/app-shell-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell-context.js","sourceRoot":"","sources":["../../../../src/components/app-shell/app-shell-context.tsx"],"names":[],"mappings":";;;AAAA,iCAAsC;AAEtC,gBAAgB;AACH,QAAA,eAAe,GAAG,IAAA,qBAAa,EAQlC,IAAI,CAAC,CAAC","sourcesContent":["import { createContext } from 'react';\n\n/** @internal */\nexport const AppShellContext = createContext<{\n  mobileNavIsOpen: boolean;\n  toggleMobileNav: (isOpen?: boolean) => void;\n  sideNavIsCollapsed: boolean | undefined;\n  toggleSideNavCollapse: (isCollapsed?: boolean) => void;\n  sideNavIsCollapsible: boolean;\n  setSideNavIsCollapsible: (isCollapsible: boolean) => void;\n  toggleSideNav: () => void;\n} | null>(null);\n"]}
+{"version":3,"file":"app-shell-context.js","sourceRoot":"","sources":["../../../../src/components/app-shell/app-shell-context.tsx"],"names":[],"mappings":";;;AAAA,iCAAsC;AAEtC,gBAAgB;AACH,QAAA,eAAe,GAAG,IAAA,qBAAa,EAUlC,IAAI,CAAC,CAAC","sourcesContent":["import { createContext } from 'react';\n\n/** @internal */\nexport const AppShellContext = createContext<{\n  mobileNavIsOpen: boolean;\n  toggleMobileNav: (isOpen?: boolean) => void;\n  sideNavIsCollapsed: boolean | undefined;\n  toggleSideNavCollapse: (isCollapsed?: boolean) => void;\n  sideNavIsCollapsible: boolean;\n  setSideNavIsCollapsible: (isCollapsible: boolean) => void;\n  toggleSideNav: () => void;\n  /** ID of the main content area targeted by the skip link. */\n  mainContentId: string;\n} | null>(null);\n"]}

package/dist/commonjs/components/app-shell/app-shell.d.ts

@@ -1,11 +1,33 @@
 import { type ReactNode } from 'react';
 import type { CommonProps } from '../types.js';
-export interface UNSTABLE_AppShellProps extends CommonProps {
+export interface AppShellProps extends CommonProps {
+    /**
+     * The children of the app shell should be composed using specific components to fill the available layout slots:
+     * - `<AppHeader />` for the global header
+     * - `<SideNav />` for the side navigation
+     * - `<TopNav />` for the top navigation bar
+     * - `<AppShellBody />` for the main content area
+     *
+     * These components should be passed as direct children to correctly populate the app shell layout.
+     */
     children: ReactNode;
 }
-export declare function UNSTABLE_AppShell({ children, UNSAFE_className, UNSAFE_style, ...props }: UNSTABLE_AppShellProps): import("react/jsx-runtime").JSX.Element;
-export interface UNSTABLE_AppShellBodyProps extends CommonProps {
+/**
+ * Provides the foundational layout structure for applications, including header, navigation, and main content slots.
+ *
+ * See [app shell usage guidelines](https://ui.cimpress.io/components/app-shell/).
+ */
+export declare function AppShell({ children, UNSAFE_className, UNSAFE_style, ...props }: AppShellProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace AppShell {
+    var displayName: string;
+}
+export interface AppShellBodyProps extends Omit<CommonProps, 'id'> {
+    /** Main content area of the app shell. */
     children: ReactNode;
 }
-export declare function UNSTABLE_AppShellBody({ children, UNSAFE_className, UNSAFE_style, ...props }: UNSTABLE_AppShellBodyProps): import("react/jsx-runtime").JSX.Element;
+/** Renders the main content area within `AppShell`. */
+export declare function AppShellBody({ children, UNSAFE_className, UNSAFE_style, ...props }: AppShellBodyProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace AppShellBody {
+    var displayName: string;
+}
 //# sourceMappingURL=app-shell.d.ts.map

package/dist/commonjs/components/app-shell/app-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../src/components/app-shell/app-shell.tsx"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,sBAAuB,SAAQ,WAAW;IACzD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,EAAE,sBAAsB,2CAmC/G;AAED,MAAM,WAAW,0BAA2B,SAAQ,WAAW;IAC7D,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,GAAG,KAAK,EACT,EAAE,0BAA0B,2CAM5B"}
+{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../src/components/app-shell/app-shell.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAK1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD;;;;;;;;OAQG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,2CA2C7F;yBA3Ce,QAAQ;;;AA8CxB,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC;IAChE,0CAA0C;IAC1C,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,2CASrG;yBATe,YAAY"}

package/dist/commonjs/components/app-shell/app-shell.js

@@ -1,16 +1,28 @@
+'use client';
 "use strict";
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNSTABLE_AppShell = UNSTABLE_AppShell;
-exports.UNSTABLE_AppShellBody = UNSTABLE_AppShellBody;
+exports.AppShell = AppShell;
+exports.AppShellBody = AppShellBody;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const clsx_1 = __importDefault(require("clsx"));
 const react_1 = require("react");
+const react_aria_1 = require("react-aria");
+const index_js_1 = require("../../i18n/index.js");
 const breakpoints_js_1 = require("../../utils/breakpoints.js");
+const link_button_js_1 = require("../button/link-button.js");
+const visually_hidden_js_1 = require("../visually-hidden/visually-hidden.js");
 const app_shell_context_js_1 = require("./app-shell-context.js");
-function UNSTABLE_AppShell({ children, UNSAFE_className, UNSAFE_style, ...props }) {
+/**
+ * Provides the foundational layout structure for applications, including header, navigation, and main content slots.
+ *
+ * See [app shell usage guidelines](https://ui.cimpress.io/components/app-shell/).
+ */
+function AppShell({ children, UNSAFE_className, UNSAFE_style, ...props }) {
+    const messages = (0, index_js_1.useLocalizedMessages)('appShell');
+    const mainContentId = 'app-shell-body-' + (0, react_aria_1.useId)();
     const [sideNavIsCollapsible, setSideNavIsCollapsible] = (0, react_1.useState)(false);
     const [mobileNavIsOpen, setMobileNavIsOpen] = (0, react_1.useState)(false);
     const toggleMobileNav = (0, react_1.useCallback)((isOpen) => {
@@ -36,9 +48,15 @@ function UNSTABLE_AppShell({ children, UNSAFE_className, UNSAFE_style, ...props
             sideNavIsCollapsed,
             toggleSideNavCollapse,
             toggleSideNav,
-        }, children: (0, jsx_runtime_1.jsx)("div", { className: (0, clsx_1.default)('cim-app-shell', UNSAFE_className), style: UNSAFE_style, ...props, children: children }) }));
+            mainContentId,
+        }, children: (0, jsx_runtime_1.jsxs)("div", { ...props, className: (0, clsx_1.default)('cim-app-shell', UNSAFE_className), style: UNSAFE_style, children: [(0, jsx_runtime_1.jsx)(visually_hidden_js_1.UNSTABLE_VisuallyHidden, { showWhenFocused: true, UNSAFE_className: "cim-app-shell-skip-link", children: (0, jsx_runtime_1.jsx)(link_button_js_1.LinkButton, { href: `#${encodeURIComponent(mainContentId)}`, target: "_self", variant: "secondary", size: "small", children: messages.format('skipToContent') }) }), children] }) }));
 }
-function UNSTABLE_AppShellBody({ children, UNSAFE_className, UNSAFE_style, ...props }) {
-    return ((0, jsx_runtime_1.jsx)("div", { className: (0, clsx_1.default)('cim-app-shell-body', UNSAFE_className), style: UNSAFE_style, ...props, children: children }));
+AppShell.displayName = 'AppShell';
+/** Renders the main content area within `AppShell`. */
+function AppShellBody({ children, UNSAFE_className, UNSAFE_style, ...props }) {
+    const appShellContext = (0, react_1.useContext)(app_shell_context_js_1.AppShellContext);
+    const mainContentId = appShellContext?.mainContentId;
+    return ((0, jsx_runtime_1.jsx)("div", { ...props, id: mainContentId, className: (0, clsx_1.default)('cim-app-shell-body', UNSAFE_className), style: UNSAFE_style, children: children }));
 }
+AppShellBody.displayName = 'AppShellBody';
 //# sourceMappingURL=app-shell.js.map

package/dist/commonjs/components/app-shell/app-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.js","sourceRoot":"","sources":["../../../../src/components/app-shell/app-shell.tsx"],"names":[],"mappings":";;;;;AAUA,8CAmCC;AAMD,sDAWC;;AA9DD,gDAAwB;AACxB,iCAA8D;AAC9D,+DAA+D;AAE/D,iEAAyD;AAMzD,SAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,KAAK,EAA0B;IAC9G,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IACxE,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG,IAAA,mBAAW,EAAC,CAAC,MAAgB,EAAE,EAAE;QACvD,kBAAkB,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,IAAA,gBAAQ,EAAsB,SAAS,CAAC,CAAC;IAC7F,MAAM,qBAAqB,GAAG,IAAA,mBAAW,EAAC,CAAC,WAAqB,EAAE,EAAE;QAClE,qBAAqB,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC,WAAW,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9E,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,MAAM,aAAa,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QACrC,IAAI,oBAAoB,IAAI,IAAA,kCAAiB,EAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAC7D,qBAAqB,EAAE,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,eAAe,EAAE,CAAC;QACpB,CAAC;IACH,CAAC,EAAE,CAAC,oBAAoB,EAAE,eAAe,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAEnE,OAAO,CACL,uBAAC,sCAAe,CAAC,QAAQ,IACvB,KAAK,EAAE;YACL,oBAAoB;YACpB,uBAAuB;YACvB,eAAe;YACf,eAAe;YACf,kBAAkB;YAClB,qBAAqB;YACrB,aAAa;SACd,YAED,gCAAK,SAAS,EAAE,IAAA,cAAI,EAAC,eAAe,EAAE,gBAAgB,CAAC,EAAE,KAAK,EAAE,YAAY,KAAM,KAAK,YACpF,QAAQ,GACL,GACmB,CAC5B,CAAC;AACJ,CAAC;AAMD,SAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,GAAG,KAAK,EACmB;IAC3B,OAAO,CACL,gCAAK,SAAS,EAAE,IAAA,cAAI,EAAC,oBAAoB,EAAE,gBAAgB,CAAC,EAAE,KAAK,EAAE,YAAY,KAAM,KAAK,YACzF,QAAQ,GACL,CACP,CAAC;AACJ,CAAC","sourcesContent":["import clsx from 'clsx';\nimport { useCallback, useState, type ReactNode } from 'react';\nimport { matchesBreakpoint } from '../../utils/breakpoints.js';\nimport type { CommonProps } from '../types.js';\nimport { AppShellContext } from './app-shell-context.js';\n\nexport interface UNSTABLE_AppShellProps extends CommonProps {\n  children: ReactNode;\n}\n\nexport function UNSTABLE_AppShell({ children, UNSAFE_className, UNSAFE_style, ...props }: UNSTABLE_AppShellProps) {\n  const [sideNavIsCollapsible, setSideNavIsCollapsible] = useState(false);\n  const [mobileNavIsOpen, setMobileNavIsOpen] = useState(false);\n  const toggleMobileNav = useCallback((isOpen?: boolean) => {\n    setMobileNavIsOpen((prevIsOpen) => isOpen ?? !prevIsOpen);\n  }, []);\n  const [sideNavIsCollapsed, setSideNavIsCollapsed] = useState<boolean | undefined>(undefined);\n  const toggleSideNavCollapse = useCallback((isCollapsed?: boolean) => {\n    setSideNavIsCollapsed((prevIsCollapsed) => isCollapsed ?? !prevIsCollapsed);\n  }, []);\n  const toggleSideNav = useCallback(() => {\n    if (sideNavIsCollapsible && matchesBreakpoint({ min: 'md' })) {\n      toggleSideNavCollapse();\n    } else {\n      toggleMobileNav();\n    }\n  }, [sideNavIsCollapsible, toggleMobileNav, toggleSideNavCollapse]);\n\n  return (\n    <AppShellContext.Provider\n      value={{\n        sideNavIsCollapsible,\n        setSideNavIsCollapsible,\n        mobileNavIsOpen,\n        toggleMobileNav,\n        sideNavIsCollapsed,\n        toggleSideNavCollapse,\n        toggleSideNav,\n      }}\n    >\n      <div className={clsx('cim-app-shell', UNSAFE_className)} style={UNSAFE_style} {...props}>\n        {children}\n      </div>\n    </AppShellContext.Provider>\n  );\n}\n\nexport interface UNSTABLE_AppShellBodyProps extends CommonProps {\n  children: ReactNode;\n}\n\nexport function UNSTABLE_AppShellBody({\n  children,\n  UNSAFE_className,\n  UNSAFE_style,\n  ...props\n}: UNSTABLE_AppShellBodyProps) {\n  return (\n    <div className={clsx('cim-app-shell-body', UNSAFE_className)} style={UNSAFE_style} {...props}>\n      {children}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"app-shell.js","sourceRoot":"","sources":["../../../../src/components/app-shell/app-shell.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport clsx from 'clsx';\nimport { useCallback, useContext, useState, type ReactNode } from 'react';\nimport { useId } from 'react-aria';\nimport { useLocalizedMessages } from '../../i18n/index.js';\nimport { matchesBreakpoint } from '../../utils/breakpoints.js';\nimport { LinkButton } from '../button/link-button.js';\nimport type { CommonProps } from '../types.js';\nimport { UNSTABLE_VisuallyHidden as VisuallyHidden } from '../visually-hidden/visually-hidden.js';\nimport { AppShellContext } from './app-shell-context.js';\n\nexport interface AppShellProps extends CommonProps {\n  /**\n   * The children of the app shell should be composed using specific components to fill the available layout slots:\n   * - `<AppHeader />` for the global header\n   * - `<SideNav />` for the side navigation\n   * - `<TopNav />` for the top navigation bar\n   * - `<AppShellBody />` for the main content area\n   *\n   * These components should be passed as direct children to correctly populate the app shell layout.\n   */\n  children: ReactNode;\n}\n\n/**\n * Provides the foundational layout structure for applications, including header, navigation, and main content slots.\n *\n * See [app shell usage guidelines](https://ui.cimpress.io/components/app-shell/).\n */\nexport function AppShell({ children, UNSAFE_className, UNSAFE_style, ...props }: AppShellProps) {\n  const messages = useLocalizedMessages('appShell');\n  const mainContentId = 'app-shell-body-' + useId();\n  const [sideNavIsCollapsible, setSideNavIsCollapsible] = useState(false);\n  const [mobileNavIsOpen, setMobileNavIsOpen] = useState(false);\n  const toggleMobileNav = useCallback((isOpen?: boolean) => {\n    setMobileNavIsOpen((prevIsOpen) => isOpen ?? !prevIsOpen);\n  }, []);\n  const [sideNavIsCollapsed, setSideNavIsCollapsed] = useState<boolean | undefined>(undefined);\n  const toggleSideNavCollapse = useCallback((isCollapsed?: boolean) => {\n    setSideNavIsCollapsed((prevIsCollapsed) => isCollapsed ?? !prevIsCollapsed);\n  }, []);\n  const toggleSideNav = useCallback(() => {\n    if (sideNavIsCollapsible && matchesBreakpoint({ min: 'md' })) {\n      toggleSideNavCollapse();\n    } else {\n      toggleMobileNav();\n    }\n  }, [sideNavIsCollapsible, toggleMobileNav, toggleSideNavCollapse]);\n\n  return (\n    <AppShellContext.Provider\n      value={{\n        sideNavIsCollapsible,\n        setSideNavIsCollapsible,\n        mobileNavIsOpen,\n        toggleMobileNav,\n        sideNavIsCollapsed,\n        toggleSideNavCollapse,\n        toggleSideNav,\n        mainContentId,\n      }}\n    >\n      <div {...props} className={clsx('cim-app-shell', UNSAFE_className)} style={UNSAFE_style}>\n        <VisuallyHidden showWhenFocused UNSAFE_className=\"cim-app-shell-skip-link\">\n          <LinkButton href={`#${encodeURIComponent(mainContentId)}`} target=\"_self\" variant=\"secondary\" size=\"small\">\n            {messages.format('skipToContent')}\n          </LinkButton>\n        </VisuallyHidden>\n        {children}\n      </div>\n    </AppShellContext.Provider>\n  );\n}\nAppShell.displayName = 'AppShell';\n\nexport interface AppShellBodyProps extends Omit<CommonProps, 'id'> {\n  /** Main content area of the app shell. */\n  children: ReactNode;\n}\n\n/** Renders the main content area within `AppShell`. */\nexport function AppShellBody({ children, UNSAFE_className, UNSAFE_style, ...props }: AppShellBodyProps) {\n  const appShellContext = useContext(AppShellContext);\n  const mainContentId = appShellContext?.mainContentId;\n\n  return (\n    <div {...props} id={mainContentId} className={clsx('cim-app-shell-body', UNSAFE_className)} style={UNSAFE_style}>\n      {children}\n    </div>\n  );\n}\nAppShellBody.displayName = 'AppShellBody';\n"]}

package/dist/commonjs/components/side-nav/side-nav.d.ts

@@ -1,6 +1,7 @@
 import { type ReactNode } from 'react';
 import type { Href, StringLikeChildren } from '../types.js';
-export interface UNSTABLE_SideNavProps {
+export interface SideNavProps {
+    /** The contents of the side navigation. Typically a `<SideNavList>`. */
     children: ReactNode;
     /**
      * Determines if the side navigation can be collapsed down to an icon-only rail, allowing for more screen space when needed.
@@ -16,21 +17,48 @@ export interface UNSTABLE_SideNavProps {
         onCollapseChange?: (isCollapsed: boolean) => void;
     };
 }
-export declare function UNSTABLE_SideNav({ children, UNSTABLE_isCollapsible: isCollapsible }: UNSTABLE_SideNavProps): import("react/jsx-runtime").JSX.Element;
-export interface UNSTABLE_SideNavListProps {
+/**
+ * Displays persistent side navigation for applications with multiple sections or pages.
+ *
+ * See [side nav usage guidelines](https://ui.cimpress.io/components/side-nav/).
+ */
+export declare function SideNav({ children, UNSTABLE_isCollapsible: isCollapsible }: SideNavProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace SideNav {
+    var displayName: string;
+}
+export interface SideNavListProps {
+    /** Navigation items and sections belonging to the list. */
     children: ReactNode;
 }
-export declare function UNSTABLE_SideNavList({ children }: UNSTABLE_SideNavListProps): import("react/jsx-runtime").JSX.Element;
-export interface UNSTABLE_SideNavListItemProps {
+/** Renders a list of navigation items within `SideNav`. */
+export declare function SideNavList({ children }: SideNavListProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace SideNavList {
+    var displayName: string;
+}
+export interface SideNavListItemProps {
+    /** The text to display as the navigation item label. */
     children: StringLikeChildren;
+    /** A URL to link to. */
     href: Href;
+    /** Whether the navigation item represents the current page. */
     isActive?: boolean;
+    /** An icon displayed before the navigation item label. Required when the side nav is collapsible. */
     icon?: ReactNode;
 }
-export declare function UNSTABLE_SideNavListItem({ children, href, isActive, icon }: UNSTABLE_SideNavListItemProps): import("react/jsx-runtime").JSX.Element;
-export interface UNSTABLE_SideNavListSectionProps {
+/** Renders a single navigation item within `SideNavList`. */
+export declare function SideNavListItem({ children, href, isActive, icon }: SideNavListItemProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace SideNavListItem {
+    var displayName: string;
+}
+export interface SideNavListSectionProps {
+    /** Navigation items belonging to the section. */
     children: ReactNode;
+    /** The content to display as the section title. */
     label?: string;
 }
-export declare function UNSTABLE_SideNavListSection({ children, label }: UNSTABLE_SideNavListSectionProps): import("react/jsx-runtime").JSX.Element;
+/** Renders a section of navigation items within `SideNavList`. */
+export declare function SideNavListSection({ children, label }: SideNavListSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace SideNavListSection {
+    var displayName: string;
+}
 //# sourceMappingURL=side-nav.d.ts.map

package/dist/commonjs/components/side-nav/side-nav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"side-nav.d.ts","sourceRoot":"","sources":["../../../../src/components/side-nav/side-nav.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAQ1E,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAQ5D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,sBAAsB,CAAC,EACnB,OAAO,GACP;QACE,yFAAyF;QACzF,gBAAgB,CAAC,EAAE,IAAI,CAAC;QACxB,qHAAqH;QACrH,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,mFAAmF;QACnF,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;KACnD,CAAC;CACP;AAED,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,sBAAsB,EAAE,aAAa,EAAE,EAAE,qBAAqB,2CAwB1G;AAkED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,EAAE,yBAAyB,2CAE3E;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,6BAA6B,2CAazG;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,2BAA2B,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,gCAAgC,2CAahG"}
+{"version":3,"file":"side-nav.d.ts","sourceRoot":"","sources":["../../../../src/components/side-nav/side-nav.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAS1E,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAQ5D,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,sBAAsB,CAAC,EACnB,OAAO,GACP;QACE,yFAAyF;QACzF,gBAAgB,CAAC,EAAE,IAAI,CAAC;QACxB,qHAAqH;QACrH,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,mFAAmF;QACnF,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;KACnD,CAAC;CACP;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,sBAAsB,EAAE,aAAa,EAAE,EAAE,YAAY,2CAwBxF;yBAxBe,OAAO;;;AA4FvB,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE,gBAAgB,2CAEzD;yBAFe,WAAW;;;AAK3B,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,wBAAwB;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qGAAqG;IACrG,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,oBAAoB,2CAavF;yBAbe,eAAe;;;AAgB/B,MAAM,WAAW,uBAAuB;IACtC,iDAAiD;IACjD,QAAQ,EAAE,SAAS,CAAC;IACpB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,uBAAuB,2CAa9E;yBAbe,kBAAkB"}

package/dist/commonjs/components/side-nav/side-nav.js

@@ -1,15 +1,16 @@
 'use client';
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNSTABLE_SideNav = UNSTABLE_SideNav;
-exports.UNSTABLE_SideNavList = UNSTABLE_SideNavList;
-exports.UNSTABLE_SideNavListItem = UNSTABLE_SideNavListItem;
-exports.UNSTABLE_SideNavListSection = UNSTABLE_SideNavListSection;
+exports.SideNav = SideNav;
+exports.SideNavList = SideNavList;
+exports.SideNavListItem = SideNavListItem;
+exports.SideNavListSection = SideNavListSection;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const utils_1 = require("@react-aria/utils");
 const react_1 = require("react");
 const react_aria_1 = require("react-aria");
 const react_aria_components_1 = require("react-aria-components");
+const index_js_1 = require("../../i18n/index.js");
 const breakpoints_js_1 = require("../../utils/breakpoints.js");
 const string_like_children_to_string_js_1 = require("../../utils/string-like-children-to-string.js");
 const app_shell_context_js_1 = require("../app-shell/app-shell-context.js");
@@ -17,7 +18,12 @@ const mobile_nav_js_1 = require("../mobile-nav/mobile-nav.js");
 const tooltip_js_1 = require("../tooltip/tooltip.js");
 const text_js_1 = require("../typography/text.js");
 const SideNavContext = (0, react_1.createContext)({ isCollapsed: false });
-function UNSTABLE_SideNav({ children, UNSTABLE_isCollapsible: isCollapsible }) {
+/**
+ * Displays persistent side navigation for applications with multiple sections or pages.
+ *
+ * See [side nav usage guidelines](https://ui.cimpress.io/components/side-nav/).
+ */
+function SideNav({ children, UNSTABLE_isCollapsible: isCollapsible }) {
     const appShellContext = (0, react_1.useContext)(app_shell_context_js_1.AppShellContext);
     (0, utils_1.useLayoutEffect)(() => {
         appShellContext?.setSideNavIsCollapsible(typeof isCollapsible === 'object' || isCollapsible || false);
@@ -27,7 +33,9 @@ function UNSTABLE_SideNav({ children, UNSTABLE_isCollapsible: isCollapsible }) {
                         onItemSelect: () => appShellContext.toggleMobileNav(false),
                     }, children: children }) }))] }));
 }
+SideNav.displayName = 'SideNav';
 function SideNavInner({ children, UNSTABLE_isCollapsible: isCollapsible }) {
+    const messages = (0, index_js_1.useLocalizedMessages)('sideNav');
     const appShellContext = (0, react_1.useContext)(app_shell_context_js_1.AppShellContext);
     const sideNavRef = (0, react_1.useRef)(null);
     const isOverlaySideNav = (0, breakpoints_js_1.useBreakpoint)({ max: 'md' }) && isCollapsible !== false;
@@ -63,16 +71,22 @@ function SideNavInner({ children, UNSTABLE_isCollapsible: isCollapsible }) {
     return ((0, jsx_runtime_1.jsx)(SideNavContext.Provider, { value: {
             isCollapsed: isCollapsed ?? false,
             onItemSelect: isOverlaySideNav ? handleClose : undefined,
-        }, children: (0, jsx_runtime_1.jsx)("div", { ...(isOverlaySideNav ? overlayProps : {}), className: "cim-side-nav", "data-collapsible": typeof isCollapsible === 'object' ? true : isCollapsible || false, "data-collapsed": isCollapsed, "aria-label": "Side navigation", ref: sideNavRef, children: (0, jsx_runtime_1.jsx)("div", { className: "cim-side-nav-panel", children: children }) }) }));
+        }, children: (0, jsx_runtime_1.jsx)("div", { ...(isOverlaySideNav ? overlayProps : {}), className: "cim-side-nav", "data-collapsible": typeof isCollapsible === 'object' ? true : isCollapsible || false, "data-collapsed": isCollapsed, "aria-label": messages.format('srLabel'), ref: sideNavRef, children: (0, jsx_runtime_1.jsx)("div", { className: "cim-side-nav-panel", children: children }) }) }));
 }
-function UNSTABLE_SideNavList({ children }) {
+/** Renders a list of navigation items within `SideNav`. */
+function SideNavList({ children }) {
     return (0, jsx_runtime_1.jsx)("nav", { className: "cim-side-nav-list", children: children });
 }
-function UNSTABLE_SideNavListItem({ children, href, isActive, icon }) {
+SideNavList.displayName = 'SideNavList';
+/** Renders a single navigation item within `SideNavList`. */
+function SideNavListItem({ children, href, isActive, icon }) {
     const { isCollapsed, onItemSelect } = (0, react_1.useContext)(SideNavContext);
     return ((0, jsx_runtime_1.jsx)(tooltip_js_1.Tooltip, { label: (0, string_like_children_to_string_js_1.stringLikeChildrenToString)(children), placement: "right", isDisabled: !isCollapsed, children: (0, jsx_runtime_1.jsxs)(react_aria_components_1.Link, { href: href, className: "cim-side-nav-list-item", "data-active": isActive, onPress: onItemSelect, children: [icon, (0, jsx_runtime_1.jsx)(text_js_1.Text, { as: "span", variant: "medium", UNSAFE_className: "cim-side-nav-list-item-label", children: children })] }) }));
 }
-function UNSTABLE_SideNavListSection({ children, label }) {
+SideNavListItem.displayName = 'SideNavListItem';
+/** Renders a section of navigation items within `SideNavList`. */
+function SideNavListSection({ children, label }) {
     return ((0, jsx_runtime_1.jsxs)("div", { className: "cim-side-nav-list-section", children: [label && ((0, jsx_runtime_1.jsx)("div", { className: "cim-side-nav-list-section-header", children: (0, jsx_runtime_1.jsx)(text_js_1.Text, { as: "p", variant: "small-semibold", tone: "subtle", UNSAFE_className: "cim-side-nav-list-section-header-label", children: label }) })), children] }));
 }
+SideNavListSection.displayName = 'SideNavListSection';
 //# sourceMappingURL=side-nav.js.map

package/dist/commonjs/components/side-nav/side-nav.js.map

@@ -1 +1 @@
-{"version":3,"file":"side-nav.js","sourceRoot":"","sources":["../../../../src/components/side-nav/side-nav.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AAsCb,4CAwBC;AAsED,oDAEC;AASD,4DAaC;AAOD,kEAaC;;AA9KD,6CAAoE;AACpE,iCAA0E;AAC1E,2CAAwC;AACxC,iEAAwD;AACxD,+DAA8E;AAC9E,qGAA2F;AAC3F,4EAAoE;AACpE,+DAA8E;AAC9E,sDAAgD;AAEhD,mDAA6C;AAE7C,MAAM,cAAc,GAAG,IAAA,qBAAa,EAGjC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;AAqB3B,SAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,sBAAsB,EAAE,aAAa,EAAyB;IACzG,MAAM,eAAe,GAAG,IAAA,kBAAU,EAAC,sCAAe,CAAC,CAAC;IAEpD,IAAA,uBAAe,EAAC,GAAG,EAAE;QACnB,eAAe,EAAE,uBAAuB,CAAC,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,IAAI,KAAK,CAAC,CAAC;IACxG,CAAC,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC;IAErC,OAAO,CACL,6DACE,uBAAC,YAAY,IAAC,sBAAsB,EAAE,aAAa,YAAG,QAAQ,GAAgB,EAC7E,eAAe,IAAI,CAClB,uBAAC,kCAAS,IAAC,MAAM,EAAE,eAAe,CAAC,eAAe,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC,KAAK,CAAC,YAC5G,uBAAC,cAAc,CAAC,QAAQ,IACtB,KAAK,EAAE;wBACL,WAAW,EAAE,KAAK;wBAClB,YAAY,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC,KAAK,CAAC;qBAC3D,YAEA,QAAQ,GACe,GAChB,CACb,IACA,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,EAAE,QAAQ,EAAE,sBAAsB,EAAE,aAAa,EAAyB;IAC9F,MAAM,eAAe,GAAG,IAAA,kBAAU,EAAC,sCAAe,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,IAAA,cAAM,EAAiB,IAAI,CAAC,CAAC;IAChD,MAAM,gBAAgB,GAAG,IAAA,8BAAa,EAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,IAAI,aAAa,KAAK,KAAK,CAAC;IACjF,MAAM,WAAW,GACf,OAAO,aAAa,KAAK,QAAQ;QAC/B,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,IAAI,eAAe,EAAE,kBAAkB,IAAI,aAAa,CAAC,gBAAgB,CAAC;QACtG,CAAC,CAAC,aAAa;YACb,CAAC,CAAC,eAAe,EAAE,kBAAkB;YACrC,CAAC,CAAC,SAAS,CAAC;IAElB,SAAS,WAAW;QAClB,eAAe,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;YACtC,aAAa,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,GAAG,IAAA,uBAAU,EACjC;QACE,aAAa,EAAE,gBAAgB;QAC/B,MAAM,EAAE,gBAAgB,IAAI,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QAChF,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;KAC7B,EACD,UAAU,CACX,CAAC;IAEF,MAAM,UAAU,GAAG,IAAA,sBAAc,EAAC,GAAG,EAAE;QACrC,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,EAAE,CAAC;YACvD,MAAM,kBAAkB,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC;YACtG,eAAe,EAAE,qBAAqB,CAAC,kBAAkB,IAAI,IAAA,kCAAiB,EAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC/F,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;gBACtC,aAAa,CAAC,gBAAgB,EAAE,CAAC,kBAAkB,IAAI,IAAA,kCAAiB,EAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,IAAA,uBAAe,EAAC,GAAG,EAAE;QACnB,UAAU,EAAE,CAAC;IACf,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAEvB,OAAO,CACL,uBAAC,cAAc,CAAC,QAAQ,IACtB,KAAK,EAAE;YACL,WAAW,EAAE,WAAW,IAAI,KAAK;YACjC,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;SACzD,YAED,mCACM,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,EAC1C,SAAS,EAAC,cAAc,sBACN,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,IAAI,KAAK,oBACnE,WAAW,gBAChB,iBAAiB,EAC5B,GAAG,EAAE,UAAU,YAEf,gCAAK,SAAS,EAAC,oBAAoB,YAAE,QAAQ,GAAO,GAChD,GACkB,CAC3B,CAAC;AACJ,CAAC;AAMD,SAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAA6B;IAC1E,OAAO,gCAAK,SAAS,EAAC,mBAAmB,YAAE,QAAQ,GAAO,CAAC;AAC7D,CAAC;AASD,SAAgB,wBAAwB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAiC;IACxG,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,IAAA,kBAAU,EAAC,cAAc,CAAC,CAAC;IAEjE,OAAO,CACL,uBAAC,oBAAO,IAAC,KAAK,EAAE,IAAA,8DAA0B,EAAC,QAAQ,CAAC,EAAE,SAAS,EAAC,OAAO,EAAC,UAAU,EAAE,CAAC,WAAW,YAC9F,wBAAC,4BAAO,IAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAC,wBAAwB,iBAAc,QAAQ,EAAE,OAAO,EAAE,YAAY,aACjG,IAAI,EACL,uBAAC,cAAI,IAAC,EAAE,EAAC,MAAM,EAAC,OAAO,EAAC,QAAQ,EAAC,gBAAgB,EAAC,8BAA8B,YAC7E,QAAQ,GACJ,IACC,GACF,CACX,CAAC;AACJ,CAAC;AAOD,SAAgB,2BAA2B,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAoC;IAC/F,OAAO,CACL,iCAAK,SAAS,EAAC,2BAA2B,aACvC,KAAK,IAAI,CACR,gCAAK,SAAS,EAAC,kCAAkC,YAC/C,uBAAC,cAAI,IAAC,EAAE,EAAC,GAAG,EAAC,OAAO,EAAC,gBAAgB,EAAC,IAAI,EAAC,QAAQ,EAAC,gBAAgB,EAAC,wCAAwC,YAC1G,KAAK,GACD,GACH,CACP,EACA,QAAQ,IACL,CACP,CAAC;AACJ,CAAC","sourcesContent":["'use client';\n\nimport { useEffectEvent, useLayoutEffect } from '@react-aria/utils';\nimport { createContext, useContext, useRef, type ReactNode } from 'react';\nimport { useOverlay } from 'react-aria';\nimport { Link as RACLink } from 'react-aria-components';\nimport { matchesBreakpoint, useBreakpoint } from '../../utils/breakpoints.js';\nimport { stringLikeChildrenToString } from '../../utils/string-like-children-to-string.js';\nimport { AppShellContext } from '../app-shell/app-shell-context.js';\nimport { UNSTABLE_MobileNav as MobileNav } from '../mobile-nav/mobile-nav.js';\nimport { Tooltip } from '../tooltip/tooltip.js';\nimport type { Href, StringLikeChildren } from '../types.js';\nimport { Text } from '../typography/text.js';\n\nconst SideNavContext = createContext<{\n  isCollapsed: boolean;\n  onItemSelect?: () => void;\n}>({ isCollapsed: false });\n\nexport interface UNSTABLE_SideNavProps {\n  children: ReactNode;\n  /**\n   * Determines if the side navigation can be collapsed down to an icon-only rail, allowing for more screen space when needed.\n   *\n   * Setting to `true` will enable collapsibility. Passing an object allows for more advanced configuration, including fully controlled usage outside app shell context.\n   */\n  UNSTABLE_isCollapsible?:\n    | boolean\n    | {\n        /** Whether the side nav should be collapsed by default. Only affects large viewports. */\n        defaultCollapsed?: true;\n        /** Whether the side nav is currently collapsed. Only needed when the side nav is not controlled by the app shell. */\n        isCollapsed?: boolean;\n        /** Callback function that is called when the side nav is collapsed or expanded. */\n        onCollapseChange?: (isCollapsed: boolean) => void;\n      };\n}\n\nexport function UNSTABLE_SideNav({ children, UNSTABLE_isCollapsible: isCollapsible }: UNSTABLE_SideNavProps) {\n  const appShellContext = useContext(AppShellContext);\n\n  useLayoutEffect(() => {\n    appShellContext?.setSideNavIsCollapsible(typeof isCollapsible === 'object' || isCollapsible || false);\n  }, [isCollapsible, appShellContext]);\n\n  return (\n    <>\n      <SideNavInner UNSTABLE_isCollapsible={isCollapsible}>{children}</SideNavInner>\n      {appShellContext && (\n        <MobileNav isOpen={appShellContext.mobileNavIsOpen} onOpenChange={() => appShellContext.toggleMobileNav(false)}>\n          <SideNavContext.Provider\n            value={{\n              isCollapsed: false,\n              onItemSelect: () => appShellContext.toggleMobileNav(false),\n            }}\n          >\n            {children}\n          </SideNavContext.Provider>\n        </MobileNav>\n      )}\n    </>\n  );\n}\n\nfunction SideNavInner({ children, UNSTABLE_isCollapsible: isCollapsible }: UNSTABLE_SideNavProps) {\n  const appShellContext = useContext(AppShellContext);\n  const sideNavRef = useRef<HTMLDivElement>(null);\n  const isOverlaySideNav = useBreakpoint({ max: 'md' }) && isCollapsible !== false;\n  const isCollapsed =\n    typeof isCollapsible === 'object'\n      ? (isCollapsible.isCollapsed ?? appShellContext?.sideNavIsCollapsed ?? isCollapsible.defaultCollapsed)\n      : isCollapsible\n        ? appShellContext?.sideNavIsCollapsed\n        : undefined;\n\n  function handleClose() {\n    appShellContext?.toggleSideNavCollapse(true);\n\n    if (typeof isCollapsible === 'object') {\n      isCollapsible.onCollapseChange?.(true);\n    }\n  }\n\n  const { overlayProps } = useOverlay(\n    {\n      isDismissable: isOverlaySideNav,\n      isOpen: isOverlaySideNav && isCollapsed !== undefined ? !isCollapsed : undefined,\n      onClose: () => handleClose(),\n    },\n    sideNavRef,\n  );\n\n  const resetState = useEffectEvent(() => {\n    if (typeof isCollapsible === 'object' || isCollapsible) {\n      const defaultIsCollapsed = typeof isCollapsible === 'object' ? isCollapsible.defaultCollapsed : false;\n      appShellContext?.toggleSideNavCollapse(defaultIsCollapsed || matchesBreakpoint({ max: 'md' }));\n      if (typeof isCollapsible === 'object') {\n        isCollapsible.onCollapseChange?.(defaultIsCollapsed || matchesBreakpoint({ max: 'md' }));\n      }\n    }\n  });\n\n  // Hydrate state and reset when screen size changes to or from overlay mode\n  useLayoutEffect(() => {\n    resetState();\n  }, [isOverlaySideNav]);\n\n  return (\n    <SideNavContext.Provider\n      value={{\n        isCollapsed: isCollapsed ?? false,\n        onItemSelect: isOverlaySideNav ? handleClose : undefined,\n      }}\n    >\n      <div\n        {...(isOverlaySideNav ? overlayProps : {})}\n        className=\"cim-side-nav\"\n        data-collapsible={typeof isCollapsible === 'object' ? true : isCollapsible || false}\n        data-collapsed={isCollapsed}\n        aria-label=\"Side navigation\"\n        ref={sideNavRef}\n      >\n        <div className=\"cim-side-nav-panel\">{children}</div>\n      </div>\n    </SideNavContext.Provider>\n  );\n}\n\nexport interface UNSTABLE_SideNavListProps {\n  children: ReactNode;\n}\n\nexport function UNSTABLE_SideNavList({ children }: UNSTABLE_SideNavListProps) {\n  return <nav className=\"cim-side-nav-list\">{children}</nav>;\n}\n\nexport interface UNSTABLE_SideNavListItemProps {\n  children: StringLikeChildren;\n  href: Href;\n  isActive?: boolean;\n  icon?: ReactNode;\n}\n\nexport function UNSTABLE_SideNavListItem({ children, href, isActive, icon }: UNSTABLE_SideNavListItemProps) {\n  const { isCollapsed, onItemSelect } = useContext(SideNavContext);\n\n  return (\n    <Tooltip label={stringLikeChildrenToString(children)} placement=\"right\" isDisabled={!isCollapsed}>\n      <RACLink href={href} className=\"cim-side-nav-list-item\" data-active={isActive} onPress={onItemSelect}>\n        {icon}\n        <Text as=\"span\" variant=\"medium\" UNSAFE_className=\"cim-side-nav-list-item-label\">\n          {children}\n        </Text>\n      </RACLink>\n    </Tooltip>\n  );\n}\n\nexport interface UNSTABLE_SideNavListSectionProps {\n  children: ReactNode;\n  label?: string;\n}\n\nexport function UNSTABLE_SideNavListSection({ children, label }: UNSTABLE_SideNavListSectionProps) {\n  return (\n    <div className=\"cim-side-nav-list-section\">\n      {label && (\n        <div className=\"cim-side-nav-list-section-header\">\n          <Text as=\"p\" variant=\"small-semibold\" tone=\"subtle\" UNSAFE_className=\"cim-side-nav-list-section-header-label\">\n            {label}\n          </Text>\n        </div>\n      )}\n      {children}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"side-nav.js","sourceRoot":"","sources":["../../../../src/components/side-nav/side-nav.tsx"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport { useEffectEvent, useLayoutEffect } from '@react-aria/utils';\nimport { createContext, useContext, useRef, type ReactNode } from 'react';\nimport { useOverlay } from 'react-aria';\nimport { Link as RACLink } from 'react-aria-components';\nimport { useLocalizedMessages } from '../../i18n/index.js';\nimport { matchesBreakpoint, useBreakpoint } from '../../utils/breakpoints.js';\nimport { stringLikeChildrenToString } from '../../utils/string-like-children-to-string.js';\nimport { AppShellContext } from '../app-shell/app-shell-context.js';\nimport { UNSTABLE_MobileNav as MobileNav } from '../mobile-nav/mobile-nav.js';\nimport { Tooltip } from '../tooltip/tooltip.js';\nimport type { Href, StringLikeChildren } from '../types.js';\nimport { Text } from '../typography/text.js';\n\nconst SideNavContext = createContext<{\n  isCollapsed: boolean;\n  onItemSelect?: () => void;\n}>({ isCollapsed: false });\n\nexport interface SideNavProps {\n  /** The contents of the side navigation. Typically a `<SideNavList>`. */\n  children: ReactNode;\n  /**\n   * Determines if the side navigation can be collapsed down to an icon-only rail, allowing for more screen space when needed.\n   *\n   * Setting to `true` will enable collapsibility. Passing an object allows for more advanced configuration, including fully controlled usage outside app shell context.\n   */\n  UNSTABLE_isCollapsible?:\n    | boolean\n    | {\n        /** Whether the side nav should be collapsed by default. Only affects large viewports. */\n        defaultCollapsed?: true;\n        /** Whether the side nav is currently collapsed. Only needed when the side nav is not controlled by the app shell. */\n        isCollapsed?: boolean;\n        /** Callback function that is called when the side nav is collapsed or expanded. */\n        onCollapseChange?: (isCollapsed: boolean) => void;\n      };\n}\n\n/**\n * Displays persistent side navigation for applications with multiple sections or pages.\n *\n * See [side nav usage guidelines](https://ui.cimpress.io/components/side-nav/).\n */\nexport function SideNav({ children, UNSTABLE_isCollapsible: isCollapsible }: SideNavProps) {\n  const appShellContext = useContext(AppShellContext);\n\n  useLayoutEffect(() => {\n    appShellContext?.setSideNavIsCollapsible(typeof isCollapsible === 'object' || isCollapsible || false);\n  }, [isCollapsible, appShellContext]);\n\n  return (\n    <>\n      <SideNavInner UNSTABLE_isCollapsible={isCollapsible}>{children}</SideNavInner>\n      {appShellContext && (\n        <MobileNav isOpen={appShellContext.mobileNavIsOpen} onOpenChange={() => appShellContext.toggleMobileNav(false)}>\n          <SideNavContext.Provider\n            value={{\n              isCollapsed: false,\n              onItemSelect: () => appShellContext.toggleMobileNav(false),\n            }}\n          >\n            {children}\n          </SideNavContext.Provider>\n        </MobileNav>\n      )}\n    </>\n  );\n}\nSideNav.displayName = 'SideNav';\n\nfunction SideNavInner({ children, UNSTABLE_isCollapsible: isCollapsible }: SideNavProps) {\n  const messages = useLocalizedMessages('sideNav');\n  const appShellContext = useContext(AppShellContext);\n  const sideNavRef = useRef<HTMLDivElement>(null);\n  const isOverlaySideNav = useBreakpoint({ max: 'md' }) && isCollapsible !== false;\n  const isCollapsed =\n    typeof isCollapsible === 'object'\n      ? (isCollapsible.isCollapsed ?? appShellContext?.sideNavIsCollapsed ?? isCollapsible.defaultCollapsed)\n      : isCollapsible\n        ? appShellContext?.sideNavIsCollapsed\n        : undefined;\n\n  function handleClose() {\n    appShellContext?.toggleSideNavCollapse(true);\n\n    if (typeof isCollapsible === 'object') {\n      isCollapsible.onCollapseChange?.(true);\n    }\n  }\n\n  const { overlayProps } = useOverlay(\n    {\n      isDismissable: isOverlaySideNav,\n      isOpen: isOverlaySideNav && isCollapsed !== undefined ? !isCollapsed : undefined,\n      onClose: () => handleClose(),\n    },\n    sideNavRef,\n  );\n\n  const resetState = useEffectEvent(() => {\n    if (typeof isCollapsible === 'object' || isCollapsible) {\n      const defaultIsCollapsed = typeof isCollapsible === 'object' ? isCollapsible.defaultCollapsed : false;\n      appShellContext?.toggleSideNavCollapse(defaultIsCollapsed || matchesBreakpoint({ max: 'md' }));\n      if (typeof isCollapsible === 'object') {\n        isCollapsible.onCollapseChange?.(defaultIsCollapsed || matchesBreakpoint({ max: 'md' }));\n      }\n    }\n  });\n\n  // Hydrate state and reset when screen size changes to or from overlay mode\n  useLayoutEffect(() => {\n    resetState();\n  }, [isOverlaySideNav]);\n\n  return (\n    <SideNavContext.Provider\n      value={{\n        isCollapsed: isCollapsed ?? false,\n        onItemSelect: isOverlaySideNav ? handleClose : undefined,\n      }}\n    >\n      <div\n        {...(isOverlaySideNav ? overlayProps : {})}\n        className=\"cim-side-nav\"\n        data-collapsible={typeof isCollapsible === 'object' ? true : isCollapsible || false}\n        data-collapsed={isCollapsed}\n        aria-label={messages.format('srLabel')}\n        ref={sideNavRef}\n      >\n        <div className=\"cim-side-nav-panel\">{children}</div>\n      </div>\n    </SideNavContext.Provider>\n  );\n}\n\nexport interface SideNavListProps {\n  /** Navigation items and sections belonging to the list. */\n  children: ReactNode;\n}\n\n/** Renders a list of navigation items within `SideNav`. */\nexport function SideNavList({ children }: SideNavListProps) {\n  return <nav className=\"cim-side-nav-list\">{children}</nav>;\n}\nSideNavList.displayName = 'SideNavList';\n\nexport interface SideNavListItemProps {\n  /** The text to display as the navigation item label. */\n  children: StringLikeChildren;\n  /** A URL to link to. */\n  href: Href;\n  /** Whether the navigation item represents the current page. */\n  isActive?: boolean;\n  /** An icon displayed before the navigation item label. Required when the side nav is collapsible. */\n  icon?: ReactNode;\n}\n\n/** Renders a single navigation item within `SideNavList`. */\nexport function SideNavListItem({ children, href, isActive, icon }: SideNavListItemProps) {\n  const { isCollapsed, onItemSelect } = useContext(SideNavContext);\n\n  return (\n    <Tooltip label={stringLikeChildrenToString(children)} placement=\"right\" isDisabled={!isCollapsed}>\n      <RACLink href={href} className=\"cim-side-nav-list-item\" data-active={isActive} onPress={onItemSelect}>\n        {icon}\n        <Text as=\"span\" variant=\"medium\" UNSAFE_className=\"cim-side-nav-list-item-label\">\n          {children}\n        </Text>\n      </RACLink>\n    </Tooltip>\n  );\n}\nSideNavListItem.displayName = 'SideNavListItem';\n\nexport interface SideNavListSectionProps {\n  /** Navigation items belonging to the section. */\n  children: ReactNode;\n  /** The content to display as the section title. */\n  label?: string;\n}\n\n/** Renders a section of navigation items within `SideNavList`. */\nexport function SideNavListSection({ children, label }: SideNavListSectionProps) {\n  return (\n    <div className=\"cim-side-nav-list-section\">\n      {label && (\n        <div className=\"cim-side-nav-list-section-header\">\n          <Text as=\"p\" variant=\"small-semibold\" tone=\"subtle\" UNSAFE_className=\"cim-side-nav-list-section-header-label\">\n            {label}\n          </Text>\n        </div>\n      )}\n      {children}\n    </div>\n  );\n}\nSideNavListSection.displayName = 'SideNavListSection';\n"]}

package/dist/commonjs/components/top-nav/top-nav.d.ts

@@ -1,12 +1,27 @@
 import type { ReactNode } from 'react';
 import type { NavigationProps, StringLikeChildren, WithRequired } from '../types.js';
-export interface UNSTABLE_TopNavProps {
+export interface TopNavProps {
+    /** The contents of the top navigation. Must be one or more of `<TopNavItem>`. */
     children: ReactNode;
 }
-export declare function UNSTABLE_TopNav({ children }: UNSTABLE_TopNavProps): import("react/jsx-runtime").JSX.Element;
-export interface UNSTABLE_TopNavItemProps extends WithRequired<NavigationProps, 'href'> {
+/**
+ * Displays horizontal navigation, typically below the app header.
+ *
+ * See [top nav usage guidelines](https://ui.cimpress.io/components/top-nav/).
+ */
+export declare function TopNav({ children, ...props }: TopNavProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace TopNav {
+    var displayName: string;
+}
+export interface TopNavItemProps extends WithRequired<NavigationProps, 'href'> {
+    /** The text to display as the navigation item label. */
     children: StringLikeChildren;
+    /** Whether the navigation item represents the current page. */
     isActive?: boolean;
 }
-export declare function UNSTABLE_TopNavItem({ children, href, isActive, ...props }: UNSTABLE_TopNavItemProps): import("react/jsx-runtime").JSX.Element;
+/** Renders a single navigation item within `TopNav`. */
+export declare function TopNavItem({ children, href, isActive, ...props }: TopNavItemProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace TopNavItem {
+    var displayName: string;
+}
 //# sourceMappingURL=top-nav.d.ts.map

package/dist/commonjs/components/top-nav/top-nav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"top-nav.d.ts","sourceRoot":"","sources":["../../../../src/components/top-nav/top-nav.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGrF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,oBAAoB,2CAMjE;AAED,MAAM,WAAW,wBAAyB,SAAQ,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC;IACrF,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,wBAAwB,2CAgBnG"}
+{"version":3,"file":"top-nav.d.ts","sourceRoot":"","sources":["../../../../src/components/top-nav/top-nav.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGrF,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,WAAW,2CAQzD;yBARe,MAAM;;;AAWtB,MAAM,WAAW,eAAgB,SAAQ,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC;IAC5E,wDAAwD;IACxD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,eAAe,2CAgBjF;yBAhBe,UAAU"}

package/dist/commonjs/components/top-nav/top-nav.js

@@ -1,18 +1,29 @@
+'use client';
 "use strict";
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNSTABLE_TopNav = UNSTABLE_TopNav;
-exports.UNSTABLE_TopNavItem = UNSTABLE_TopNavItem;
+exports.TopNav = TopNav;
+exports.TopNavItem = TopNavItem;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const clsx_1 = __importDefault(require("clsx"));
 const react_aria_components_1 = require("react-aria-components");
+const index_js_1 = require("../../i18n/index.js");
 const text_js_1 = require("../typography/text.js");
-function UNSTABLE_TopNav({ children }) {
-    return ((0, jsx_runtime_1.jsx)("nav", { className: (0, clsx_1.default)('cim-top-nav', 'cim-link-tabs'), children: (0, jsx_runtime_1.jsx)("ul", { className: "cim-tab-list", children: children }) }));
+/**
+ * Displays horizontal navigation, typically below the app header.
+ *
+ * See [top nav usage guidelines](https://ui.cimpress.io/components/top-nav/).
+ */
+function TopNav({ children, ...props }) {
+    const messages = (0, index_js_1.useLocalizedMessages)('topNav');
+    return ((0, jsx_runtime_1.jsx)("nav", { ...props, className: (0, clsx_1.default)('cim-top-nav', 'cim-link-tabs'), "aria-label": messages.format('srLabel'), children: (0, jsx_runtime_1.jsx)("ul", { className: "cim-tab-list", children: children }) }));
 }
-function UNSTABLE_TopNavItem({ children, href, isActive, ...props }) {
+TopNav.displayName = 'TopNav';
+/** Renders a single navigation item within `TopNav`. */
+function TopNavItem({ children, href, isActive, ...props }) {
     return ((0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsx)(react_aria_components_1.Link, { ...props, className: (0, clsx_1.default)('cim-tab-item', 'cim-link-tab-item'), href: href, "aria-current": isActive ? 'page' : undefined, "data-selected": isActive || undefined, children: (0, jsx_runtime_1.jsx)(text_js_1.Text, { as: "span", variant: "medium-semibold", alignment: "center", children: children }) }) }));
 }
+TopNavItem.displayName = 'TopNavItem';
 //# sourceMappingURL=top-nav.js.map

package/dist/commonjs/components/top-nav/top-nav.js.map

@@ -1 +1 @@
-{"version":3,"file":"top-nav.js","sourceRoot":"","sources":["../../../../src/components/top-nav/top-nav.tsx"],"names":[],"mappings":";;;;;AAUA,0CAMC;AAOD,kDAgBC;;AAvCD,gDAAwB;AAExB,iEAAwD;AAExD,mDAA6C;AAM7C,SAAgB,eAAe,CAAC,EAAE,QAAQ,EAAwB;IAChE,OAAO,CACL,gCAAK,SAAS,EAAE,IAAA,cAAI,EAAC,aAAa,EAAE,eAAe,CAAC,YAClD,+BAAI,SAAS,EAAC,cAAc,YAAE,QAAQ,GAAM,GACxC,CACP,CAAC;AACJ,CAAC;AAOD,SAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,EAA4B;IAClG,OAAO,CACL,yCACE,uBAAC,4BAAO,OACF,KAAK,EACT,SAAS,EAAE,IAAA,cAAI,EAAC,cAAc,EAAE,mBAAmB,CAAC,EACpD,IAAI,EAAE,IAAI,kBACI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,mBAC5B,QAAQ,IAAI,SAAS,YAEpC,uBAAC,cAAI,IAAC,EAAE,EAAC,MAAM,EAAC,OAAO,EAAC,iBAAiB,EAAC,SAAS,EAAC,QAAQ,YACzD,QAAQ,GACJ,GACC,GACP,CACN,CAAC;AACJ,CAAC","sourcesContent":["import clsx from 'clsx';\nimport type { ReactNode } from 'react';\nimport { Link as RACLink } from 'react-aria-components';\nimport type { NavigationProps, StringLikeChildren, WithRequired } from '../types.js';\nimport { Text } from '../typography/text.js';\n\nexport interface UNSTABLE_TopNavProps {\n  children: ReactNode;\n}\n\nexport function UNSTABLE_TopNav({ children }: UNSTABLE_TopNavProps) {\n  return (\n    <nav className={clsx('cim-top-nav', 'cim-link-tabs')}>\n      <ul className=\"cim-tab-list\">{children}</ul>\n    </nav>\n  );\n}\n\nexport interface UNSTABLE_TopNavItemProps extends WithRequired<NavigationProps, 'href'> {\n  children: StringLikeChildren;\n  isActive?: boolean;\n}\n\nexport function UNSTABLE_TopNavItem({ children, href, isActive, ...props }: UNSTABLE_TopNavItemProps) {\n  return (\n    <li>\n      <RACLink\n        {...props}\n        className={clsx('cim-tab-item', 'cim-link-tab-item')}\n        href={href}\n        aria-current={isActive ? 'page' : undefined}\n        data-selected={isActive || undefined}\n      >\n        <Text as=\"span\" variant=\"medium-semibold\" alignment=\"center\">\n          {children}\n        </Text>\n      </RACLink>\n    </li>\n  );\n}\n"]}
+{"version":3,"file":"top-nav.js","sourceRoot":"","sources":["../../../../src/components/top-nav/top-nav.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;AAmBb,wBAQC;AAWD,gCAgBC;;AApDD,gDAAwB;AAExB,iEAAwD;AACxD,kDAA2D;AAE3D,mDAA6C;AAO7C;;;;GAIG;AACH,SAAgB,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAe;IACxD,MAAM,QAAQ,GAAG,IAAA,+BAAoB,EAAC,QAAQ,CAAC,CAAC;IAEhD,OAAO,CACL,mCAAS,KAAK,EAAE,SAAS,EAAE,IAAA,cAAI,EAAC,aAAa,EAAE,eAAe,CAAC,gBAAc,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,YACrG,+BAAI,SAAS,EAAC,cAAc,YAAE,QAAQ,GAAM,GACxC,CACP,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC;AAS9B,wDAAwD;AACxD,SAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAmB;IAChF,OAAO,CACL,yCACE,uBAAC,4BAAO,OACF,KAAK,EACT,SAAS,EAAE,IAAA,cAAI,EAAC,cAAc,EAAE,mBAAmB,CAAC,EACpD,IAAI,EAAE,IAAI,kBACI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,mBAC5B,QAAQ,IAAI,SAAS,YAEpC,uBAAC,cAAI,IAAC,EAAE,EAAC,MAAM,EAAC,OAAO,EAAC,iBAAiB,EAAC,SAAS,EAAC,QAAQ,YACzD,QAAQ,GACJ,GACC,GACP,CACN,CAAC;AACJ,CAAC;AACD,UAAU,CAAC,WAAW,GAAG,YAAY,CAAC","sourcesContent":["'use client';\n\nimport clsx from 'clsx';\nimport type { ReactNode } from 'react';\nimport { Link as RACLink } from 'react-aria-components';\nimport { useLocalizedMessages } from '../../i18n/index.js';\nimport type { NavigationProps, StringLikeChildren, WithRequired } from '../types.js';\nimport { Text } from '../typography/text.js';\n\nexport interface TopNavProps {\n  /** The contents of the top navigation. Must be one or more of `<TopNavItem>`. */\n  children: ReactNode;\n}\n\n/**\n * Displays horizontal navigation, typically below the app header.\n *\n * See [top nav usage guidelines](https://ui.cimpress.io/components/top-nav/).\n */\nexport function TopNav({ children, ...props }: TopNavProps) {\n  const messages = useLocalizedMessages('topNav');\n\n  return (\n    <nav {...props} className={clsx('cim-top-nav', 'cim-link-tabs')} aria-label={messages.format('srLabel')}>\n      <ul className=\"cim-tab-list\">{children}</ul>\n    </nav>\n  );\n}\nTopNav.displayName = 'TopNav';\n\nexport interface TopNavItemProps extends WithRequired<NavigationProps, 'href'> {\n  /** The text to display as the navigation item label. */\n  children: StringLikeChildren;\n  /** Whether the navigation item represents the current page. */\n  isActive?: boolean;\n}\n\n/** Renders a single navigation item within `TopNav`. */\nexport function TopNavItem({ children, href, isActive, ...props }: TopNavItemProps) {\n  return (\n    <li>\n      <RACLink\n        {...props}\n        className={clsx('cim-tab-item', 'cim-link-tab-item')}\n        href={href}\n        aria-current={isActive ? 'page' : undefined}\n        data-selected={isActive || undefined}\n      >\n        <Text as=\"span\" variant=\"medium-semibold\" alignment=\"center\">\n          {children}\n        </Text>\n      </RACLink>\n    </li>\n  );\n}\nTopNavItem.displayName = 'TopNavItem';\n"]}

package/dist/commonjs/i18n/messages/en-US.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en-US.d.ts","sourceRoot":"","sources":["../../../../src/i18n/messages/en-US.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,+EAA+E;AAC/E,eAAO,MAAM,IAAI,EAAE,iBAsDlB,CAAC"}
+{"version":3,"file":"en-US.d.ts","sourceRoot":"","sources":["../../../../src/i18n/messages/en-US.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,+EAA+E;AAC/E,eAAO,MAAM,IAAI,EAAE,iBAyDlB,CAAC"}

package/dist/commonjs/i18n/messages/en-US.js

@@ -5,6 +5,9 @@ exports.enUS = void 0;
 /** Strings used by Cimpress UI components, localized in the `en-US` locale. */
 exports.enUS = {
     common: { clearValue: `Clear`, dismiss: `Dismiss`, clearValueDescription: `Press Escape to clear text.` },
+    appShell: { skipToContent: `Skip to content` },
+    topNav: { srLabel: `Top` },
+    sideNav: { srLabel: `Side` },
     copyToClipboard: { success: `Copied to clipboard.`, failure: `Failed to copy to clipboard.` },
     label: { required: `(required)` },
     datePicker: {

package/dist/commonjs/i18n/messages/en-US.js.map

@@ -1 +1 @@
-{"version":3,"file":"en-US.js","sourceRoot":"","sources":["../../../../src/i18n/messages/en-US.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n\nimport type { LocalizedMessages } from './types.js';\n\n/** Strings used by Cimpress UI components, localized in the `en-US` locale. */\nexport const enUS: LocalizedMessages = {\n  common: { clearValue: `Clear`, dismiss: `Dismiss`, clearValueDescription: `Press Escape to clear text.` },\n  copyToClipboard: { success: `Copied to clipboard.`, failure: `Failed to copy to clipboard.` },\n  label: { required: `(required)` },\n  datePicker: {\n    clearValue: `Clear`,\n    openCalendar: `Open calendar`,\n    previousMonth: `Previous month`,\n    nextMonth: `Next month`,\n    switchToYearView: `Year view`,\n    previousYear: `Previous year`,\n    nextYear: `Next year`,\n    switchToMultiYearView: `Multi-year view`,\n    previousMultiYearSection: (args, formatter) => `Previous ${formatter.number(args.yearCount)} years`,\n    nextMultiYearSection: (args, formatter) => `Next ${formatter.number(args.yearCount)} years`,\n  },\n  numberField: { decrement: `Decrement`, increment: `Increment` },\n  pagination: {\n    goToPage: (args, formatter) => `Page ${formatter.number(args.pageNumber)}`,\n    previousPage: `Previous page`,\n    nextPage: `Next page`,\n    selectedPageAnnouncement: (args, formatter) => `Selected page: ${formatter.number(args.pageNumber)}`,\n  },\n  slider: { rangeStart: `Range start`, rangeEnd: `Range end` },\n  tagField: {\n    itemsSelected: (args, formatter) =>\n      `${formatter.plural(args.selectedItemCount, { one: () => `${formatter.number(args.selectedItemCount)} item selected`, other: () => `${formatter.number(args.selectedItemCount)} items selected` })}`,\n  },\n  filePicker: {\n    chooseFile: `Choose file`,\n    noFilesSelected: (args, formatter) =>\n      `${formatter.select({ true: `No files selected`, other: `No file selected` }, args.allowsMultiple)}`,\n    multipleFilesSelected: (args, formatter) => `${formatter.number(args.fileCount)} files`,\n  },\n  table: { loadingData: `Loading data`, toggleColumnSortOrder: `Toggle sort order of column:` },\n  simpleAuthTool: {\n    logIn: `Log in`,\n    logOut: `Log out`,\n    profileDetails: (args) => `Profile details for ${args.userFullName}`,\n    unknownUser: `Unknown User`,\n  },\n  select: {\n    searchLabel: `Search`,\n    searchPlaceholder: `Search`,\n    noResultsFound: `No results found.`,\n    clearSelection: `Clear selection`,\n    selectedItems: `selected items`,\n  },\n  UNSTABLE_collection: {\n    loading: `Loading items`,\n    loadingMore: `Loading more items`,\n    itemsSelected: (args, formatter) =>\n      `${formatter.plural(args.selectedItemCount, { one: () => `${formatter.number(args.selectedItemCount)} item selected`, other: () => `${formatter.number(args.selectedItemCount)} items selected` })}`,\n  },\n};\n"]}
+{"version":3,"file":"en-US.js","sourceRoot":"","sources":["../../../../src/i18n/messages/en-US.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n\nimport type { LocalizedMessages } from './types.js';\n\n/** Strings used by Cimpress UI components, localized in the `en-US` locale. */\nexport const enUS: LocalizedMessages = {\n  common: { clearValue: `Clear`, dismiss: `Dismiss`, clearValueDescription: `Press Escape to clear text.` },\n  appShell: { skipToContent: `Skip to content` },\n  topNav: { srLabel: `Top` },\n  sideNav: { srLabel: `Side` },\n  copyToClipboard: { success: `Copied to clipboard.`, failure: `Failed to copy to clipboard.` },\n  label: { required: `(required)` },\n  datePicker: {\n    clearValue: `Clear`,\n    openCalendar: `Open calendar`,\n    previousMonth: `Previous month`,\n    nextMonth: `Next month`,\n    switchToYearView: `Year view`,\n    previousYear: `Previous year`,\n    nextYear: `Next year`,\n    switchToMultiYearView: `Multi-year view`,\n    previousMultiYearSection: (args, formatter) => `Previous ${formatter.number(args.yearCount)} years`,\n    nextMultiYearSection: (args, formatter) => `Next ${formatter.number(args.yearCount)} years`,\n  },\n  numberField: { decrement: `Decrement`, increment: `Increment` },\n  pagination: {\n    goToPage: (args, formatter) => `Page ${formatter.number(args.pageNumber)}`,\n    previousPage: `Previous page`,\n    nextPage: `Next page`,\n    selectedPageAnnouncement: (args, formatter) => `Selected page: ${formatter.number(args.pageNumber)}`,\n  },\n  slider: { rangeStart: `Range start`, rangeEnd: `Range end` },\n  tagField: {\n    itemsSelected: (args, formatter) =>\n      `${formatter.plural(args.selectedItemCount, { one: () => `${formatter.number(args.selectedItemCount)} item selected`, other: () => `${formatter.number(args.selectedItemCount)} items selected` })}`,\n  },\n  filePicker: {\n    chooseFile: `Choose file`,\n    noFilesSelected: (args, formatter) =>\n      `${formatter.select({ true: `No files selected`, other: `No file selected` }, args.allowsMultiple)}`,\n    multipleFilesSelected: (args, formatter) => `${formatter.number(args.fileCount)} files`,\n  },\n  table: { loadingData: `Loading data`, toggleColumnSortOrder: `Toggle sort order of column:` },\n  simpleAuthTool: {\n    logIn: `Log in`,\n    logOut: `Log out`,\n    profileDetails: (args) => `Profile details for ${args.userFullName}`,\n    unknownUser: `Unknown User`,\n  },\n  select: {\n    searchLabel: `Search`,\n    searchPlaceholder: `Search`,\n    noResultsFound: `No results found.`,\n    clearSelection: `Clear selection`,\n    selectedItems: `selected items`,\n  },\n  UNSTABLE_collection: {\n    loading: `Loading items`,\n    loadingMore: `Loading more items`,\n    itemsSelected: (args, formatter) =>\n      `${formatter.plural(args.selectedItemCount, { one: () => `${formatter.number(args.selectedItemCount)} item selected`, other: () => `${formatter.number(args.selectedItemCount)} items selected` })}`,\n  },\n};\n"]}

package/dist/commonjs/i18n/messages/types.d.ts

@@ -14,6 +14,18 @@ export type LocalizedMessages = {
         /** A visually hidden label that indicates a text field can be cleared by pressing the Escape key. This text is only announced by screen readers. */
         clearValueDescription: LocalizedString;
     };
+    appShell: {
+        /** Label for a skip link rendered by the app shell that moves keyboard focus to the main content area. */
+        skipToContent: LocalizedString;
+    };
+    topNav: {
+        /** An ARIA label for the top navigation landmark. */
+        srLabel: LocalizedString;
+    };
+    sideNav: {
+        /** An ARIA label for the side navigation landmark. */
+        srLabel: LocalizedString;
+    };
     copyToClipboard: {
         /** The message displayed in a tooltip when a value is successfully copied to clipboard. */
         success: LocalizedString;

package/dist/commonjs/i18n/messages/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/i18n/messages/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/i18n/messages/types.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/i18n/messages/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/i18n/messages/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { LocalizedStringFormatter } from 'react-aria';\n\n/**\n * Represents a localized piece of text used within a component.\n * It can either be a plain string, or a function that returns a plain string based on provided context.\n */\nexport type LocalizedString =\n  | string\n  | ((\n      args?: Record<string, string | number | boolean>,\n      formatter?: LocalizedStringFormatter<string, LocalizedString>,\n    ) => string);\n\n/** A collection of localized strings used by Cimpress UI components. */\nexport type LocalizedMessages = {\n  common: {\n    /** An ARIA label for a button that clears the value of a field. */\n    clearValue: LocalizedString;\n    /** An ARIA label for a button that closes or dismisses an alert, a callout, a dialog, or other overlay component. Used for accessibility purposes to clearly indicate the button's function to screen reader users. */\n    dismiss: LocalizedString;\n    /** A visually hidden label that indicates a text field can be cleared by pressing the Escape key. This text is only announced by screen readers. */\n    clearValueDescription: LocalizedString;\n  };\n  copyToClipboard: {\n    /** The message displayed in a tooltip when a value is successfully copied to clipboard. */\n    success: LocalizedString;\n    /** The message displayed in a tooltip when a value fails to be copied to clipboard. */\n    failure: LocalizedString;\n  };\n  label: {\n    /** A visually hidden label that indicates a form field is required. This text is appended to the field's visible label and is only announced by screen readers. */\n    required: LocalizedString;\n  };\n  datePicker: {\n    /** An ARIA label for a button that clears the value of a date picker field. */\n    clearValue: LocalizedString;\n    /** An ARIA label for a button that opens a calendar popup. Part of a date picker. */\n    openCalendar: LocalizedString;\n    /** An ARIA label for a button that displays the previous month in a calendar popup. Part of a date picker. */\n    previousMonth: LocalizedString;\n    /** An ARIA label for a button that displays the next month in a calendar popup. Part of a date picker. */\n    nextMonth: LocalizedString;\n    /** An ARIA label for a button that changes the calendar popup to a single-year view. Part of a date picker. */\n    switchToYearView: LocalizedString;\n    /** An ARIA label for a button that displays the previous year in a calendar popup. Part of a date picker. */\n    previousYear: LocalizedString;\n    /** An ARIA label for a button that displays the next year in a calendar popup. Part of a date picker. */\n    nextYear: LocalizedString;\n    /** An ARIA label for a button that changes the calendar popup to a multi-year view. Part of a date picker. */\n    switchToMultiYearView: LocalizedString;\n    /** An ARIA label for a button that displays the previous section of a multi-year view in a calendar popup. Year count will always be larger than 1. Part of a date picker. */\n    previousMultiYearSection: LocalizedString;\n    /** An ARIA label for a button that displays the next section of a multi-year view in a calendar popup. Year count will always be larger than 1. Part of a date picker. */\n    nextMultiYearSection: LocalizedString;\n  };\n  numberField: {\n    /** An ARIA label for a button that decrements the value of a number field. */\n    decrement: LocalizedString;\n    /** An ARIA label for a button that increments the value of a number field. */\n    increment: LocalizedString;\n  };\n  pagination: {\n    /** An ARIA label for a button that navigates to a specific page. Part of a pagination navigation structure. */\n    goToPage: LocalizedString;\n    /** An ARIA label for a button that navigates to the previous page. Part of a pagination navigation structure. */\n    previousPage: LocalizedString;\n    /** An ARIA label for a button that navigates to the next page. Part of a pagination navigation structure. */\n    nextPage: LocalizedString;\n    /** A screen reader announcement for when the selected page changes. Part of a pagination navigation structure. */\n    selectedPageAnnouncement: LocalizedString;\n  };\n  slider: {\n    /** An ARIA label for a slider thumb that is used to select the start (minimum) value of a range. */\n    rangeStart: LocalizedString;\n    /** An ARIA label for a slider thumb that is used to select the end (maximum) value of a range. */\n    rangeEnd: LocalizedString;\n  };\n  tagField: {\n    /** A label displayed within a tag field to inform the user about the number of selected items. */\n    itemsSelected: LocalizedString;\n  };\n  filePicker: {\n    /** A label for the button that opens the native file picker dialog. */\n    chooseFile: LocalizedString;\n    /** A label for when no files are selected. */\n    noFilesSelected: LocalizedString;\n    /** A label for when multiple files are selected. */\n    multipleFilesSelected: LocalizedString;\n  };\n  table: {\n    /** An ARIA label for a spinner displayed when data is being loaded into a table. */\n    loadingData: LocalizedString;\n    /** An ARIA label for a button that toggles the sort order of a specific column in a data table. This label will be followed by the name of the column. */\n    toggleColumnSortOrder: LocalizedString;\n  };\n  simpleAuthTool: {\n    /** A label used for a button that redirects to a login flow. */\n    logIn: LocalizedString;\n    /** A label used for a button that logs the current user out. */\n    logOut: LocalizedString;\n    /** An ARIA label for a popover that contains information about the logged in user. */\n    profileDetails: LocalizedString;\n    /** A name that's displayed when the current user's name is unknown. */\n    unknownUser: LocalizedString;\n  };\n  select: {\n    /** An ARIA label for the search field displayed inside a filterable select dropdown. */\n    searchLabel: LocalizedString;\n    /** Placeholder text for the search field displayed inside a filterable select dropdown. */\n    searchPlaceholder: LocalizedString;\n    /** Message displayed when filtering a select list yields no matching options. */\n    noResultsFound: LocalizedString;\n    /** An ARIA label for a button that clears the current selection in a select. */\n    clearSelection: LocalizedString;\n    /** An ARIA label for the group of tags representing selected items in a multi-select. */\n    selectedItems: LocalizedString;\n  };\n  UNSTABLE_collection: {\n    /** An ARIA label for a spinner displayed when the list of items is first being loaded in a collection. */\n    loading: LocalizedString;\n    /** An ARIA label for a spinner displayed when more items are being loaded into a collection. */\n    loadingMore: LocalizedString;\n    /** A label displayed within a select to inform the user about the number of selected items. */\n    itemsSelected: LocalizedString;\n  };\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/i18n/messages/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { LocalizedStringFormatter } from 'react-aria';\n\n/**\n * Represents a localized piece of text used within a component.\n * It can either be a plain string, or a function that returns a plain string based on provided context.\n */\nexport type LocalizedString =\n  | string\n  | ((\n      args?: Record<string, string | number | boolean>,\n      formatter?: LocalizedStringFormatter<string, LocalizedString>,\n    ) => string);\n\n/** A collection of localized strings used by Cimpress UI components. */\nexport type LocalizedMessages = {\n  common: {\n    /** An ARIA label for a button that clears the value of a field. */\n    clearValue: LocalizedString;\n    /** An ARIA label for a button that closes or dismisses an alert, a callout, a dialog, or other overlay component. Used for accessibility purposes to clearly indicate the button's function to screen reader users. */\n    dismiss: LocalizedString;\n    /** A visually hidden label that indicates a text field can be cleared by pressing the Escape key. This text is only announced by screen readers. */\n    clearValueDescription: LocalizedString;\n  };\n  appShell: {\n    /** Label for a skip link rendered by the app shell that moves keyboard focus to the main content area. */\n    skipToContent: LocalizedString;\n  };\n  topNav: {\n    /** An ARIA label for the top navigation landmark. */\n    srLabel: LocalizedString;\n  };\n  sideNav: {\n    /** An ARIA label for the side navigation landmark. */\n    srLabel: LocalizedString;\n  };\n  copyToClipboard: {\n    /** The message displayed in a tooltip when a value is successfully copied to clipboard. */\n    success: LocalizedString;\n    /** The message displayed in a tooltip when a value fails to be copied to clipboard. */\n    failure: LocalizedString;\n  };\n  label: {\n    /** A visually hidden label that indicates a form field is required. This text is appended to the field's visible label and is only announced by screen readers. */\n    required: LocalizedString;\n  };\n  datePicker: {\n    /** An ARIA label for a button that clears the value of a date picker field. */\n    clearValue: LocalizedString;\n    /** An ARIA label for a button that opens a calendar popup. Part of a date picker. */\n    openCalendar: LocalizedString;\n    /** An ARIA label for a button that displays the previous month in a calendar popup. Part of a date picker. */\n    previousMonth: LocalizedString;\n    /** An ARIA label for a button that displays the next month in a calendar popup. Part of a date picker. */\n    nextMonth: LocalizedString;\n    /** An ARIA label for a button that changes the calendar popup to a single-year view. Part of a date picker. */\n    switchToYearView: LocalizedString;\n    /** An ARIA label for a button that displays the previous year in a calendar popup. Part of a date picker. */\n    previousYear: LocalizedString;\n    /** An ARIA label for a button that displays the next year in a calendar popup. Part of a date picker. */\n    nextYear: LocalizedString;\n    /** An ARIA label for a button that changes the calendar popup to a multi-year view. Part of a date picker. */\n    switchToMultiYearView: LocalizedString;\n    /** An ARIA label for a button that displays the previous section of a multi-year view in a calendar popup. Year count will always be larger than 1. Part of a date picker. */\n    previousMultiYearSection: LocalizedString;\n    /** An ARIA label for a button that displays the next section of a multi-year view in a calendar popup. Year count will always be larger than 1. Part of a date picker. */\n    nextMultiYearSection: LocalizedString;\n  };\n  numberField: {\n    /** An ARIA label for a button that decrements the value of a number field. */\n    decrement: LocalizedString;\n    /** An ARIA label for a button that increments the value of a number field. */\n    increment: LocalizedString;\n  };\n  pagination: {\n    /** An ARIA label for a button that navigates to a specific page. Part of a pagination navigation structure. */\n    goToPage: LocalizedString;\n    /** An ARIA label for a button that navigates to the previous page. Part of a pagination navigation structure. */\n    previousPage: LocalizedString;\n    /** An ARIA label for a button that navigates to the next page. Part of a pagination navigation structure. */\n    nextPage: LocalizedString;\n    /** A screen reader announcement for when the selected page changes. Part of a pagination navigation structure. */\n    selectedPageAnnouncement: LocalizedString;\n  };\n  slider: {\n    /** An ARIA label for a slider thumb that is used to select the start (minimum) value of a range. */\n    rangeStart: LocalizedString;\n    /** An ARIA label for a slider thumb that is used to select the end (maximum) value of a range. */\n    rangeEnd: LocalizedString;\n  };\n  tagField: {\n    /** A label displayed within a tag field to inform the user about the number of selected items. */\n    itemsSelected: LocalizedString;\n  };\n  filePicker: {\n    /** A label for the button that opens the native file picker dialog. */\n    chooseFile: LocalizedString;\n    /** A label for when no files are selected. */\n    noFilesSelected: LocalizedString;\n    /** A label for when multiple files are selected. */\n    multipleFilesSelected: LocalizedString;\n  };\n  table: {\n    /** An ARIA label for a spinner displayed when data is being loaded into a table. */\n    loadingData: LocalizedString;\n    /** An ARIA label for a button that toggles the sort order of a specific column in a data table. This label will be followed by the name of the column. */\n    toggleColumnSortOrder: LocalizedString;\n  };\n  simpleAuthTool: {\n    /** A label used for a button that redirects to a login flow. */\n    logIn: LocalizedString;\n    /** A label used for a button that logs the current user out. */\n    logOut: LocalizedString;\n    /** An ARIA label for a popover that contains information about the logged in user. */\n    profileDetails: LocalizedString;\n    /** A name that's displayed when the current user's name is unknown. */\n    unknownUser: LocalizedString;\n  };\n  select: {\n    /** An ARIA label for the search field displayed inside a filterable select dropdown. */\n    searchLabel: LocalizedString;\n    /** Placeholder text for the search field displayed inside a filterable select dropdown. */\n    searchPlaceholder: LocalizedString;\n    /** Message displayed when filtering a select list yields no matching options. */\n    noResultsFound: LocalizedString;\n    /** An ARIA label for a button that clears the current selection in a select. */\n    clearSelection: LocalizedString;\n    /** An ARIA label for the group of tags representing selected items in a multi-select. */\n    selectedItems: LocalizedString;\n  };\n  UNSTABLE_collection: {\n    /** An ARIA label for a spinner displayed when the list of items is first being loaded in a collection. */\n    loading: LocalizedString;\n    /** An ARIA label for a spinner displayed when more items are being loaded into a collection. */\n    loadingMore: LocalizedString;\n    /** A label displayed within a select to inform the user about the number of selected items. */\n    itemsSelected: LocalizedString;\n  };\n};\n"]}

package/dist/commonjs/index.d.ts

@@ -2,6 +2,9 @@ export * from './components/alert/alert.js';
 export * from './components/alert-dialog/alert-dialog.js';
 export * from './components/app-header/app-header.js';
 export * from './components/app-header/simple-auth-tool.js';
+export * from './components/app-shell/app-shell.js';
+export * from './components/side-nav/side-nav.js';
+export * from './components/top-nav/top-nav.js';
 export * from './components/badge/badge.js';
 export * from './components/button/button.js';
 export * from './components/button/link-button.js';
@@ -85,10 +88,7 @@ export * from './components/container/container.js';
 export * from './components/stepper/stepper.js';
 export * from './components/stepper/stepper-item.js';
 export type { StepperStatus } from './components/stepper/types.js';
-export * from './components/app-shell/app-shell.js';
-export * from './components/side-nav/side-nav.js';
 export * from './components/hidden/hidden.js';
-export * from './components/top-nav/top-nav.js';
 export * from './components/page-layout/page-layout.js';
 export * from './components/nav-list/nav-list.js';
 export * from './components/app-header/nav-button.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}