@gridui/site-navigation 1.1.7 → 1.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -7,6 +7,13 @@ Load styles for any composed dependency used by this family. Applications own ro
7
7
 
8
8
  See [component ownership](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/docs/component-ownership.md) and [release history](https://github.com/sudo-ui/GridUI-React-Monorepo/tree/main/packages-landing/site-navigation/.changeset/history).
9
9
 
10
+ ## Mobile region spacing
11
+
12
+ The mobile navigation body has no outer padding: destination rows and separators
13
+ reach the drawer edges. Custom mobile navigation content owns row-internal
14
+ spacing. The settings group retains content padding for independent controls.
15
+ The generic DrawerBody default remains suitable for prose and forms.
16
+
10
17
  ## Rich navigation menus
11
18
 
12
19
  SiteNavigation combines `@gridui/responsive-navigation`, `@gridui/menu`,
@@ -16,7 +23,7 @@ preferences, desktop content, and optional mobile content/footer slots.
16
23
  ResponsiveNavigation owns desktop/mobile switching. Menu owns content-neutral
17
24
  navigation parts. Drawer owns modal focus management, scroll locking, start/end
18
25
  placement, dismissal, and its header/body/footer parts. The independent Popover
19
- family owns desktop hover intent. SiteHeader supplies a separate frame shell
26
+ family owns desktop hover intent. FrameHeader supplies a separate frame shell
20
27
  with caller-owned branding.
21
28
 
22
29
  Set `columns={1}` on a MenuGrid passed as mobile content; the composition does
@@ -28,10 +35,10 @@ preferences form one compact group at the far end, use an application utility
28
35
  class that disables the root's default flex growth:
29
36
 
30
37
  ```tsx
31
- <SiteHeader justify="between" gap={16} padding={{ base: 24, lg: 32 }}>
38
+ <FrameHeader justify="between" gap={16} padding={{ base: 24, lg: 32 }}>
32
39
  <BrandLink href="/">Product</BrandLink>
33
40
  <SiteNavigation className="flex-none" {...localizedNavigation} />
34
- </SiteHeader>
41
+ </FrameHeader>
35
42
  ```
36
43
 
37
44
  Without that class, the navigation keeps its existing flexible width, placing
@@ -67,3 +74,5 @@ normal trigger restoration. It does not cancel navigation or drawer dismissal.
67
74
  Caller-owned `mobileContent`, `mobilePreferences`, and `mobileFooter` slots retain
68
75
  their own activation policy. Compose their controls with public Drawer parts
69
76
  when they should dismiss the panel.
77
+
78
+ [Component reference](docs/reference/README.md) contains focused API pages for each public component.
package/dist/index.js CHANGED
@@ -115,59 +115,73 @@ var MobileSiteNavigation = (props) => {
115
115
  }
116
116
  )
117
117
  ] }),
118
- /* @__PURE__ */ jsxs2(DrawerBody, { children: [
119
- /* @__PURE__ */ jsxs2(
120
- "nav",
121
- {
122
- "aria-label": label,
123
- children: [
124
- links.map((link) => {
125
- const { label: linkLabel, current, onClick, ...anchorProps } = link;
126
- return /* @__PURE__ */ createElement2(
127
- MenuLink,
128
- {
129
- ...anchorProps,
130
- key: link.href,
131
- "aria-current": current ? "page" : void 0,
132
- onClick: (event) => {
133
- onClick?.(event);
134
- const activation = getNavigationActivation(event);
135
- if (!activation) {
136
- return;
137
- }
138
- anchorNavigation.current = activation === "anchor";
139
- closeDrawer();
118
+ /* @__PURE__ */ jsxs2(
119
+ DrawerBody,
120
+ {
121
+ className: "gridui-u-site-navigation--p-0",
122
+ children: [
123
+ /* @__PURE__ */ jsxs2(
124
+ "nav",
125
+ {
126
+ "aria-label": label,
127
+ children: [
128
+ links.map((link) => {
129
+ const { label: linkLabel, current, onClick, ...anchorProps } = link;
130
+ return /* @__PURE__ */ createElement2(
131
+ MenuLink,
132
+ {
133
+ ...anchorProps,
134
+ key: link.href,
135
+ "aria-current": current ? "page" : void 0,
136
+ onClick: (event) => {
137
+ onClick?.(event);
138
+ const activation = getNavigationActivation(event);
139
+ if (!activation) {
140
+ return;
141
+ }
142
+ anchorNavigation.current = activation === "anchor";
143
+ closeDrawer();
144
+ }
145
+ },
146
+ /* @__PURE__ */ jsx2(MenuItemContent, { children: /* @__PURE__ */ jsx2(MenuItemLabel, { children: linkLabel }) })
147
+ );
148
+ }),
149
+ mobileContent && /* @__PURE__ */ jsxs2(Fragment, { children: [
150
+ links.length > 0 && /* @__PURE__ */ jsx2(MenuSeparator, {}),
151
+ mobileContent
152
+ ] })
153
+ ]
154
+ }
155
+ ),
156
+ /* @__PURE__ */ jsx2(MenuSeparator, {}),
157
+ /* @__PURE__ */ jsxs2(
158
+ MenuGroup,
159
+ {
160
+ className: "gridui-u-site-navigation--gap-gridui-16 gridui-u-site-navigation--p-gridui-24",
161
+ "aria-labelledby": `${id}-settings`,
162
+ children: [
163
+ /* @__PURE__ */ jsx2(
164
+ MenuLabel,
165
+ {
166
+ className: "gridui-u-site-navigation--p-0",
167
+ id: `${id}-settings`,
168
+ children: settingsLabel
140
169
  }
141
- },
142
- /* @__PURE__ */ jsx2(MenuItemContent, { children: /* @__PURE__ */ jsx2(MenuItemLabel, { children: linkLabel }) })
143
- );
144
- }),
145
- mobileContent && /* @__PURE__ */ jsxs2(Fragment, { children: [
146
- /* @__PURE__ */ jsx2(MenuSeparator, {}),
147
- mobileContent
148
- ] })
149
- ]
150
- }
151
- ),
152
- /* @__PURE__ */ jsx2(MenuSeparator, {}),
153
- /* @__PURE__ */ jsxs2(
154
- MenuGroup,
155
- {
156
- "aria-labelledby": `${id}-settings`,
157
- children: [
158
- /* @__PURE__ */ jsx2(
159
- MenuLabel,
160
- {
161
- id: `${id}-settings`,
162
- children: settingsLabel
163
- }
164
- ),
165
- mobilePreferences
166
- ]
167
- }
168
- )
169
- ] }),
170
- mobileFooter && /* @__PURE__ */ jsx2(DrawerFooter, { children: mobileFooter })
170
+ ),
171
+ mobilePreferences
172
+ ]
173
+ }
174
+ )
175
+ ]
176
+ }
177
+ ),
178
+ mobileFooter && /* @__PURE__ */ jsx2(DrawerFooter, { children: /* @__PURE__ */ jsx2(
179
+ "div",
180
+ {
181
+ className: "gridui-u-site-navigation--p-gridui-24",
182
+ children: mobileFooter
183
+ }
184
+ ) })
171
185
  ]
172
186
  }
173
187
  )
package/dist/index.js.map CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../src/site-navigation/style.ts", "../src/site-navigation/desktop-site-navigation.tsx", "../src/site-navigation/mobile-site-navigation.tsx", "../src/site-navigation/site-navigation.tsx"],
4
- "sourcesContent": ["/**\n * @author WMXPY\n * @package Site Navigation\n * @namespace SiteNavigation\n * @description Style\n */\n\nimport { cn } from \"@gridui/style-utils\";\nimport { cva } from \"class-variance-authority\";\n\nexport const navigationActionsStyles = cva(cn(\n \"gridui-navigation-actions\",\n \"gridui-u-site-navigation--ms-auto\",\n));\n", "/**\n * @author WMXPY\n * @package Site Navigation\n * @namespace SiteNavigation\n * @description Desktop Site Navigation\n */\n\nimport type { DesktopNavigationOptions } from \"./site-navigation-types\";\nimport { navigationActionsStyles } from \"./style\";\nimport { NavigationLinks } from \"@gridui/menu\";\nimport { DesktopNavigation } from \"@gridui/responsive-navigation\";\nimport { cn } from \"@gridui/style-utils\";\nimport type { FC } from \"react\";\n\nexport type DesktopSiteNavigationProps = DesktopNavigationOptions;\n\nexport const DesktopSiteNavigation: FC<DesktopSiteNavigationProps> = (props: DesktopSiteNavigationProps) => {\n const { label, links, preferences, desktopContent } = props;\n return (<DesktopNavigation>\n <NavigationLinks\n aria-label={label}\n >\n {links.map((link) => {\n const { label: linkLabel, current, ...anchorProps } = link;\n return (<a\n {...anchorProps}\n key={link.href}\n aria-current={current ? \"page\" : undefined}\n >\n {linkLabel}\n </a>);\n })}\n {desktopContent}\n </NavigationLinks>\n <div\n className={cn(navigationActionsStyles())}\n >\n {preferences}\n </div>\n </DesktopNavigation>);\n};\n", "/**\n * @author WMXPY\n * @package Site Navigation\n * @namespace SiteNavigation\n * @description Mobile Site Navigation\n */\n\nimport type { MobileNavigationOptions } from \"./site-navigation-types\";\nimport { Button } from \"@gridui/button\";\nimport { DrawerBody, DrawerCloseButton, DrawerFooter, DrawerHeader, DrawerPanel, DrawerTitle, DrawerTrigger } from \"@gridui/drawer\";\nimport { getNavigationActivation } from \"@gridui/interaction\";\nimport { MenuGroup, MenuItemContent, MenuItemLabel, MenuLabel, MenuLink, MenuSeparator } from \"@gridui/menu\";\nimport { MobileNavigation, ResponsiveDrawer } from \"@gridui/responsive-navigation\";\nimport { Menu } from \"lucide-react\";\nimport { type FC, type RefObject, useId } from \"react\";\n\nexport type MobileSiteNavigationProps = MobileNavigationOptions & {\n readonly anchorNavigation: RefObject<boolean>;\n readonly closeDrawer: () => void;\n};\n\nexport const MobileSiteNavigation: FC<MobileSiteNavigationProps> = (props: MobileSiteNavigationProps) => {\n const { label, links, menuLabel, closeLabel, settingsLabel, mobilePreferences, mobileContent, mobileFooter,\n onMobileCloseAutoFocus, anchorNavigation, closeDrawer } = props;\n const id = useId();\n return (<MobileNavigation>\n <ResponsiveDrawer>\n <DrawerTrigger\n asChild\n >\n <Button\n variant=\"quiet\"\n size=\"standard\"\n layout=\"icon\"\n aria-label={menuLabel}\n title={menuLabel}\n >\n <Menu\n aria-hidden=\"true\"\n />\n </Button>\n </DrawerTrigger>\n <DrawerPanel\n onCloseAutoFocus={(event) => {\n const preserveAnchor = anchorNavigation.current;\n anchorNavigation.current = false;\n onMobileCloseAutoFocus?.(event);\n if (preserveAnchor) {\n event.preventDefault();\n }\n }}\n >\n <DrawerHeader>\n <DrawerTitle >\n {menuLabel}\n </DrawerTitle>\n <DrawerCloseButton\n aria-label={closeLabel}\n />\n </DrawerHeader>\n <DrawerBody>\n <nav\n aria-label={label}\n >\n {links.map((link) => {\n const { label: linkLabel, current, onClick, ...anchorProps } = link;\n return (<MenuLink\n {...anchorProps}\n key={link.href}\n aria-current={current ? \"page\" : undefined}\n onClick={(event) => {\n onClick?.(event);\n const activation = getNavigationActivation(event);\n if (!activation) {\n return;\n }\n anchorNavigation.current = activation === \"anchor\";\n closeDrawer();\n }}\n >\n <MenuItemContent>\n <MenuItemLabel>\n {linkLabel}\n </MenuItemLabel>\n </MenuItemContent>\n </MenuLink>);\n })}\n {mobileContent && (<>\n <MenuSeparator />\n {mobileContent}\n </>)}\n </nav>\n <MenuSeparator />\n <MenuGroup\n aria-labelledby={`${id}-settings`}\n >\n <MenuLabel\n id={`${id}-settings`}\n >\n {settingsLabel}\n </MenuLabel>\n {mobilePreferences}\n </MenuGroup>\n </DrawerBody>\n {mobileFooter && (<DrawerFooter>\n {mobileFooter}\n </DrawerFooter>)}\n </DrawerPanel>\n </ResponsiveDrawer>\n </MobileNavigation>);\n};\n", "/**\n * @author WMXPY\n * @package Site Navigation\n * @namespace SiteNavigation\n * @description Site Navigation\n */\n\nimport { DesktopSiteNavigation } from \"./desktop-site-navigation\";\nimport { MobileSiteNavigation } from \"./mobile-site-navigation\";\nimport type { DesktopNavigationOptions, MobileNavigationOptions } from \"./site-navigation-types\";\nimport { ResponsiveNavigation } from \"@gridui/responsive-navigation\";\nimport { type FC, useRef, useState } from \"react\";\n\nexport type SiteNavigationProps = DesktopNavigationOptions & MobileNavigationOptions & {\n readonly className?: string;\n};\n\nexport const SiteNavigation: FC<SiteNavigationProps> = (props: SiteNavigationProps) => {\n const {\n className,\n label,\n links,\n menuLabel,\n closeLabel,\n settingsLabel,\n preferences,\n mobilePreferences,\n desktopContent,\n mobileContent,\n mobileFooter,\n onMobileCloseAutoFocus,\n } = props;\n const anchorNavigation = useRef(false);\n const [\n mobileOpen,\n setMobileOpen,\n ] = useState(false);\n return (<ResponsiveNavigation\n className={className}\n drawerOpen={mobileOpen}\n onDrawerOpenChange={(open) => {\n if (open) {\n anchorNavigation.current = false;\n }\n setMobileOpen(open);\n }}\n >\n <DesktopSiteNavigation\n label={label}\n links={links}\n preferences={preferences}\n desktopContent={desktopContent}\n />\n <MobileSiteNavigation\n label={label}\n links={links}\n menuLabel={menuLabel}\n closeLabel={closeLabel}\n settingsLabel={settingsLabel}\n mobilePreferences={mobilePreferences}\n mobileContent={mobileContent}\n mobileFooter={mobileFooter}\n onMobileCloseAutoFocus={onMobileCloseAutoFocus}\n anchorNavigation={anchorNavigation}\n closeDrawer={() => {\n setMobileOpen(false);\n }}\n />\n </ResponsiveNavigation>);\n};\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["/**\n * @author WMXPY\n * @package Site Navigation\n * @namespace SiteNavigation\n * @description Style\n */\n\nimport { cn } from \"@gridui/style-utils\";\nimport { cva } from \"class-variance-authority\";\n\nexport const navigationActionsStyles = cva(cn(\n \"gridui-navigation-actions\",\n \"gridui-u-site-navigation--ms-auto\",\n));\n", "/**\n * @author WMXPY\n * @package Site Navigation\n * @namespace SiteNavigation\n * @description Desktop Site Navigation\n */\n\nimport type { DesktopNavigationOptions } from \"./site-navigation-types\";\nimport { navigationActionsStyles } from \"./style\";\nimport { NavigationLinks } from \"@gridui/menu\";\nimport { DesktopNavigation } from \"@gridui/responsive-navigation\";\nimport { cn } from \"@gridui/style-utils\";\nimport type { FC } from \"react\";\n\nexport type DesktopSiteNavigationProps = DesktopNavigationOptions;\n\nexport const DesktopSiteNavigation: FC<DesktopSiteNavigationProps> = (props: DesktopSiteNavigationProps) => {\n const { label, links, preferences, desktopContent } = props;\n return (<DesktopNavigation>\n <NavigationLinks\n aria-label={label}\n >\n {links.map((link) => {\n const { label: linkLabel, current, ...anchorProps } = link;\n return (<a\n {...anchorProps}\n key={link.href}\n aria-current={current ? \"page\" : undefined}\n >\n {linkLabel}\n </a>);\n })}\n {desktopContent}\n </NavigationLinks>\n <div\n className={cn(navigationActionsStyles())}\n >\n {preferences}\n </div>\n </DesktopNavigation>);\n};\n", "/**\n * @author WMXPY\n * @package Site Navigation\n * @namespace SiteNavigation\n * @description Mobile Site Navigation\n */\n\nimport type { MobileNavigationOptions } from \"./site-navigation-types\";\nimport { Button } from \"@gridui/button\";\nimport { DrawerBody, DrawerCloseButton, DrawerFooter, DrawerHeader, DrawerPanel, DrawerTitle, DrawerTrigger } from \"@gridui/drawer\";\nimport { getNavigationActivation } from \"@gridui/interaction\";\nimport { MenuGroup, MenuItemContent, MenuItemLabel, MenuLabel, MenuLink, MenuSeparator } from \"@gridui/menu\";\nimport { MobileNavigation, ResponsiveDrawer } from \"@gridui/responsive-navigation\";\nimport { Menu } from \"lucide-react\";\nimport { type FC, type RefObject, useId } from \"react\";\n\nexport type MobileSiteNavigationProps = MobileNavigationOptions & {\n readonly anchorNavigation: RefObject<boolean>;\n readonly closeDrawer: () => void;\n};\n\nexport const MobileSiteNavigation: FC<MobileSiteNavigationProps> = (props: MobileSiteNavigationProps) => {\n const { label, links, menuLabel, closeLabel, settingsLabel, mobilePreferences, mobileContent, mobileFooter,\n onMobileCloseAutoFocus, anchorNavigation, closeDrawer } = props;\n const id = useId();\n return (<MobileNavigation>\n <ResponsiveDrawer>\n <DrawerTrigger\n asChild\n >\n <Button\n variant=\"quiet\"\n size=\"standard\"\n layout=\"icon\"\n aria-label={menuLabel}\n title={menuLabel}\n >\n <Menu\n aria-hidden=\"true\"\n />\n </Button>\n </DrawerTrigger>\n <DrawerPanel\n onCloseAutoFocus={(event) => {\n const preserveAnchor = anchorNavigation.current;\n anchorNavigation.current = false;\n onMobileCloseAutoFocus?.(event);\n if (preserveAnchor) {\n event.preventDefault();\n }\n }}\n >\n <DrawerHeader>\n <DrawerTitle >\n {menuLabel}\n </DrawerTitle>\n <DrawerCloseButton\n aria-label={closeLabel}\n />\n </DrawerHeader>\n <DrawerBody\n className=\"gridui-u-site-navigation--p-0\"\n >\n <nav\n aria-label={label}\n >\n {links.map((link) => {\n const { label: linkLabel, current, onClick, ...anchorProps } = link;\n return (<MenuLink\n {...anchorProps}\n key={link.href}\n aria-current={current ? \"page\" : undefined}\n onClick={(event) => {\n onClick?.(event);\n const activation = getNavigationActivation(event);\n if (!activation) {\n return;\n }\n anchorNavigation.current = activation === \"anchor\";\n closeDrawer();\n }}\n >\n <MenuItemContent>\n <MenuItemLabel>\n {linkLabel}\n </MenuItemLabel>\n </MenuItemContent>\n </MenuLink>);\n })}\n {mobileContent && (<>\n {links.length > 0 && (<MenuSeparator />)}\n {mobileContent}\n </>)}\n </nav>\n <MenuSeparator />\n <MenuGroup\n className=\"gridui-u-site-navigation--gap-gridui-16 gridui-u-site-navigation--p-gridui-24\"\n aria-labelledby={`${id}-settings`}\n >\n <MenuLabel\n className=\"gridui-u-site-navigation--p-0\"\n id={`${id}-settings`}\n >\n {settingsLabel}\n </MenuLabel>\n {mobilePreferences}\n </MenuGroup>\n </DrawerBody>\n {mobileFooter && (<DrawerFooter>\n <div\n className=\"gridui-u-site-navigation--p-gridui-24\"\n >\n {mobileFooter}\n </div>\n </DrawerFooter>)}\n </DrawerPanel>\n </ResponsiveDrawer>\n </MobileNavigation>);\n};\n", "/**\n * @author WMXPY\n * @package Site Navigation\n * @namespace SiteNavigation\n * @description Site Navigation\n */\n\nimport { DesktopSiteNavigation } from \"./desktop-site-navigation\";\nimport { MobileSiteNavigation } from \"./mobile-site-navigation\";\nimport type { DesktopNavigationOptions, MobileNavigationOptions } from \"./site-navigation-types\";\nimport { ResponsiveNavigation } from \"@gridui/responsive-navigation\";\nimport { type FC, useRef, useState } from \"react\";\n\nexport type SiteNavigationProps = DesktopNavigationOptions & MobileNavigationOptions & {\n readonly className?: string;\n};\n\nexport const SiteNavigation: FC<SiteNavigationProps> = (props: SiteNavigationProps) => {\n const {\n className,\n label,\n links,\n menuLabel,\n closeLabel,\n settingsLabel,\n preferences,\n mobilePreferences,\n desktopContent,\n mobileContent,\n mobileFooter,\n onMobileCloseAutoFocus,\n } = props;\n const anchorNavigation = useRef(false);\n const [\n mobileOpen,\n setMobileOpen,\n ] = useState(false);\n return (<ResponsiveNavigation\n className={className}\n drawerOpen={mobileOpen}\n onDrawerOpenChange={(open) => {\n if (open) {\n anchorNavigation.current = false;\n }\n setMobileOpen(open);\n }}\n >\n <DesktopSiteNavigation\n label={label}\n links={links}\n preferences={preferences}\n desktopContent={desktopContent}\n />\n <MobileSiteNavigation\n label={label}\n links={links}\n menuLabel={menuLabel}\n closeLabel={closeLabel}\n settingsLabel={settingsLabel}\n mobilePreferences={mobilePreferences}\n mobileContent={mobileContent}\n mobileFooter={mobileFooter}\n onMobileCloseAutoFocus={onMobileCloseAutoFocus}\n anchorNavigation={anchorNavigation}\n closeDrawer={() => {\n setMobileOpen(false);\n }}\n />\n </ResponsiveNavigation>);\n};\n"],
5
+ "mappings": "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",
6
6
  "names": ["cn", "jsx", "jsxs", "createElement", "jsx", "jsxs"]
7
7
  }
package/dist/styles.css CHANGED
@@ -4,4 +4,13 @@
4
4
  .gridui-u-site-navigation--ms-auto {
5
5
  margin-inline-start: auto;
6
6
  }
7
+ .gridui-u-site-navigation--gap-gridui-16 {
8
+ gap: var(--gridui-space-16);
9
+ }
10
+ .gridui-u-site-navigation--p-0 {
11
+ padding: 0px;
12
+ }
13
+ .gridui-u-site-navigation--p-gridui-24 {
14
+ padding: var(--gridui-space-24);
15
+ }
7
16
  }
package/docs/catalog.json CHANGED
@@ -1,12 +1,14 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "name": "@gridui/site-navigation",
4
- "version": "1.1.7",
4
+ "version": "1.1.9",
5
5
  "category": "landing",
6
6
  "description": "GridUI React site navigation",
7
- "usage": "SiteNavigation combines `@gridui/responsive-navigation`, `@gridui/menu`, `@gridui/drawer`, and `@gridui/button`. Applications supply links, localized labels, preferences, desktop content, and optional mobile content/footer slots.",
7
+ "usage": "The mobile navigation body has no outer padding: destination rows and separators reach the drawer edges. Custom mobile navigation content owns row-internal spacing. The settings group retains content padding for independent controls. The generic DrawerBody default remains suitable for prose and forms.",
8
8
  "documentation": [
9
- "README.md"
9
+ "README.md",
10
+ "docs/reference/README.md",
11
+ "docs/reference/site-navigation.md"
10
12
  ],
11
13
  "exports": [
12
14
  {
@@ -36,6 +38,9 @@
36
38
  "@gridui/site-navigation/styles.css"
37
39
  ],
38
40
  "examples": [
41
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-landing/site-navigation/stories/getting-started.mdx",
42
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-landing/site-navigation/stories/mobile-navigation.mdx",
43
+ "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-landing/site-navigation/stories/site-navigation.mdx",
39
44
  "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-landing/site-navigation/stories/site-navigation.stories.tsx"
40
45
  ]
41
46
  }
@@ -0,0 +1,4 @@
1
+ <!-- Generated by pnpm docs:storybook. -->
2
+ # Component reference
3
+
4
+ - [SiteNavigation](site-navigation.md)
@@ -0,0 +1,71 @@
1
+ <!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
2
+ # SiteNavigation
3
+
4
+ Composes public-site branding and navigation across viewport sizes. Applications supply links, actions, and preference choices.
5
+
6
+ Import from ``@gridui/site-navigation`` and load Theme before this family's stylesheet.
7
+
8
+ ```tsx
9
+ import { SiteNavigation } from "@gridui/site-navigation";
10
+ import "@gridui/theme/styles.css";
11
+ import "@gridui/site-navigation/styles.css";
12
+ ```
13
+
14
+ Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-landing/site-navigation/README.md) for shared behavior and stylesheet dependencies.
15
+
16
+ The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-landing/site-navigation/stories/site-navigation.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
17
+
18
+ ## API
19
+
20
+ The public Props type is the source of these signatures. Defaults below are explicit implementation defaults; story presets are separate. Native attributes remain available through the exported Props type.
21
+
22
+ ### label
23
+
24
+ ``string`` · Required
25
+
26
+ ### links
27
+
28
+ ``readonly SiteNavigationLink[]`` · Required
29
+
30
+ ### preferences
31
+
32
+ ``ReactNode`` · Required
33
+
34
+ ### desktopContent
35
+
36
+ ``ReactNode`` · Optional
37
+
38
+ ### menuLabel
39
+
40
+ ``string`` · Required
41
+
42
+ ### closeLabel
43
+
44
+ ``string`` · Required
45
+
46
+ ### settingsLabel
47
+
48
+ ``string`` · Required
49
+
50
+ ### mobilePreferences
51
+
52
+ ``ReactNode`` · Required
53
+
54
+ ### mobileContent
55
+
56
+ ``ReactNode`` · Optional
57
+
58
+ ### mobileFooter
59
+
60
+ ``ReactNode`` · Optional
61
+
62
+ ### onMobileCloseAutoFocus
63
+
64
+ ``(event: Event): void`` · Optional
65
+
66
+ Called when the corresponding interaction occurs; inspect the arguments in Actions.
67
+
68
+ ### className
69
+
70
+ ``string | undefined`` · Optional
71
+
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gridui/site-navigation",
3
- "version": "1.1.7",
3
+ "version": "1.1.9",
4
4
  "description": "GridUI React site navigation",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",
@@ -27,21 +27,21 @@
27
27
  "react-dom": "^19.2.0"
28
28
  },
29
29
  "dependencies": {
30
- "@gridui/button": "^4.0.0",
31
- "@gridui/drawer": "^1.1.7",
30
+ "@gridui/button": "^5.0.0",
31
+ "@gridui/drawer": "^2.0.0",
32
32
  "@gridui/interaction": "^1.2.1",
33
- "@gridui/menu": "^3.0.0",
34
- "@gridui/responsive-navigation": "^1.1.6",
35
- "@gridui/style-utils": "^3.0.0",
36
- "@gridui/theme": "^2.5.3",
33
+ "@gridui/menu": "^4.0.1",
34
+ "@gridui/responsive-navigation": "^1.1.8",
35
+ "@gridui/style-utils": "^4.0.0",
36
+ "@gridui/theme": "^2.5.4",
37
37
  "class-variance-authority": "0.7.1",
38
38
  "lucide-react": "1.70.0"
39
39
  },
40
40
  "devDependencies": {
41
41
  "@gridui-internal/configuration": "0.0.0-internal",
42
- "@gridui/brand-link": "1.0.5",
43
- "@gridui/grid": "2.3.6",
44
- "@gridui/preferences": "1.0.8",
42
+ "@gridui/brand-link": "1.0.6",
43
+ "@gridui/grid": "3.0.0",
44
+ "@gridui/preferences": "1.0.10",
45
45
  "@jest/globals": "30.5.2",
46
46
  "@storybook/react-vite": "10.6.6",
47
47
  "@types/jest": "30.0.0",