@fairmint/ui 0.3.26 → 0.3.28

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.
Files changed (52) hide show
  1. package/dist/_virtual/index3.cjs +3 -5
  2. package/dist/_virtual/index3.cjs.map +1 -1
  3. package/dist/_virtual/index3.js +2 -5
  4. package/dist/_virtual/index3.js.map +1 -1
  5. package/dist/_virtual/index4.cjs +5 -3
  6. package/dist/_virtual/index4.cjs.map +1 -1
  7. package/dist/_virtual/index4.js +5 -2
  8. package/dist/_virtual/index4.js.map +1 -1
  9. package/dist/components/FairmintLogo/FairmintLogoMarkRounded.cjs +82 -0
  10. package/dist/components/FairmintLogo/FairmintLogoMarkRounded.cjs.map +1 -0
  11. package/dist/components/FairmintLogo/FairmintLogoMarkRounded.d.ts +41 -0
  12. package/dist/components/FairmintLogo/FairmintLogoMarkRounded.d.ts.map +1 -0
  13. package/dist/components/FairmintLogo/FairmintLogoMarkRounded.js +82 -0
  14. package/dist/components/FairmintLogo/FairmintLogoMarkRounded.js.map +1 -0
  15. package/dist/components/layout/SideNav/SideNav.cjs +369 -19
  16. package/dist/components/layout/SideNav/SideNav.cjs.map +1 -1
  17. package/dist/components/layout/SideNav/SideNav.d.ts +45 -4
  18. package/dist/components/layout/SideNav/SideNav.d.ts.map +1 -1
  19. package/dist/components/layout/SideNav/SideNav.js +371 -21
  20. package/dist/components/layout/SideNav/SideNav.js.map +1 -1
  21. package/dist/fairmint-ui.cjs +8 -0
  22. package/dist/fairmint-ui.cjs.map +1 -1
  23. package/dist/fairmint-ui.js +9 -1
  24. package/dist/fairmint-ui.js.map +1 -1
  25. package/dist/index.d.ts +3 -1
  26. package/dist/index.d.ts.map +1 -1
  27. package/dist/node_modules/@mantine/core/esm/components/Slider/Slider/Slider.cjs +1 -1
  28. package/dist/node_modules/@mantine/core/esm/components/Slider/Slider/Slider.js +1 -1
  29. package/dist/node_modules/@mantine/form/esm/hooks/use-form-status/use-form-status.cjs +1 -1
  30. package/dist/node_modules/@mantine/form/esm/hooks/use-form-status/use-form-status.js +1 -1
  31. package/dist/node_modules/@tabler/icons-react/dist/esm/icons/IconLayoutSidebarLeftCollapse.cjs +8 -0
  32. package/dist/node_modules/@tabler/icons-react/dist/esm/icons/IconLayoutSidebarLeftCollapse.cjs.map +1 -0
  33. package/dist/node_modules/@tabler/icons-react/dist/esm/icons/IconLayoutSidebarLeftCollapse.js +8 -0
  34. package/dist/node_modules/@tabler/icons-react/dist/esm/icons/IconLayoutSidebarLeftCollapse.js.map +1 -0
  35. package/dist/node_modules/@tabler/icons-react/dist/esm/icons/IconLayoutSidebarLeftExpand.cjs +8 -0
  36. package/dist/node_modules/@tabler/icons-react/dist/esm/icons/IconLayoutSidebarLeftExpand.cjs.map +1 -0
  37. package/dist/node_modules/@tabler/icons-react/dist/esm/icons/IconLayoutSidebarLeftExpand.js +8 -0
  38. package/dist/node_modules/@tabler/icons-react/dist/esm/icons/IconLayoutSidebarLeftExpand.js.map +1 -0
  39. package/dist/node_modules/prop-types/index.cjs +1 -1
  40. package/dist/node_modules/prop-types/index.js +1 -1
  41. package/dist/theme/index.cjs +9 -4
  42. package/dist/theme/index.cjs.map +1 -1
  43. package/dist/theme/index.d.ts.map +1 -1
  44. package/dist/theme/index.js +9 -4
  45. package/dist/theme/index.js.map +1 -1
  46. package/dist/theme/logo.cjs +2 -0
  47. package/dist/theme/logo.cjs.map +1 -1
  48. package/dist/theme/logo.d.ts +2 -0
  49. package/dist/theme/logo.d.ts.map +1 -1
  50. package/dist/theme/logo.js +2 -0
  51. package/dist/theme/logo.js.map +1 -1
  52. package/package.json +1 -1
@@ -3,15 +3,146 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
3
  const jsxRuntime = require("react/jsx-runtime");
4
4
  const React = require("react");
5
5
  const index = require("../../../theme/index.cjs");
6
+ const useUncontrolled = require("../../../node_modules/@mantine/hooks/esm/use-uncontrolled/use-uncontrolled.cjs");
6
7
  const Stack = require("../../../node_modules/@mantine/core/esm/components/Stack/Stack.cjs");
7
- const Text = require("../../../node_modules/@mantine/core/esm/components/Text/Text.cjs");
8
+ const Box = require("../../../node_modules/@mantine/core/esm/core/Box/Box.cjs");
9
+ const Group = require("../../../node_modules/@mantine/core/esm/components/Group/Group.cjs");
10
+ const Divider = require("../../../node_modules/@mantine/core/esm/components/Divider/Divider.cjs");
11
+ const UnstyledButton = require("../../../node_modules/@mantine/core/esm/components/UnstyledButton/UnstyledButton.cjs");
12
+ const IconLayoutSidebarLeftExpand = require("../../../node_modules/@tabler/icons-react/dist/esm/icons/IconLayoutSidebarLeftExpand.cjs");
13
+ const IconLayoutSidebarLeftCollapse = require("../../../node_modules/@tabler/icons-react/dist/esm/icons/IconLayoutSidebarLeftCollapse.cjs");
14
+ const Tooltip = require("../../../node_modules/@mantine/core/esm/components/Tooltip/Tooltip.cjs");
15
+ const ActionIcon = require("../../../node_modules/@mantine/core/esm/components/ActionIcon/ActionIcon.cjs");
16
+ const Menu = require("../../../node_modules/@mantine/core/esm/components/Menu/Menu.cjs");
8
17
  const NavLink = require("../../../node_modules/@mantine/core/esm/components/NavLink/NavLink.cjs");
18
+ const SIDE_NAV_WIDTH = 260;
19
+ const SIDE_NAV_COLLAPSED_WIDTH = 80;
20
+ const SIDE_NAV_FLOATING_Z_INDEX = 1300;
9
21
  function hasActiveDescendant(item) {
10
22
  return item.children?.some((child) => child.active || hasActiveDescendant(child)) ?? false;
11
23
  }
12
- function SideNavNode({ color, item, onItemClick }) {
24
+ function getSideNavItemLabelText(item) {
25
+ if (item.ariaLabel) {
26
+ return item.ariaLabel;
27
+ }
28
+ if (typeof item.label === "string") {
29
+ return item.label;
30
+ }
31
+ if (typeof item.label === "number") {
32
+ return String(item.label);
33
+ }
34
+ return "Item";
35
+ }
36
+ function getSideNavLetterFallback(labelText) {
37
+ const match = labelText.match(/[\p{L}\p{N}]/u);
38
+ return match ? match[0].toUpperCase() : "?";
39
+ }
40
+ function LetterFallback({ letter, active = false }) {
41
+ return /* @__PURE__ */ jsxRuntime.jsx(
42
+ Box.Box,
43
+ {
44
+ component: "span",
45
+ "aria-hidden": true,
46
+ "data-active": active || void 0,
47
+ style: {
48
+ display: "inline-flex",
49
+ alignItems: "center",
50
+ justifyContent: "center",
51
+ width: 20,
52
+ height: 20,
53
+ flexShrink: 0,
54
+ fontSize: 12,
55
+ fontWeight: active ? 700 : 600,
56
+ lineHeight: 1,
57
+ // Selected chrome lives on the parent control — glyph matches icon sizing.
58
+ color: active ? index.fairmintVars.colorIconOnSurfaceSelected : "inherit"
59
+ },
60
+ children: letter
61
+ }
62
+ );
63
+ }
64
+ function CollapseToggle({
65
+ collapsed,
66
+ onToggle,
67
+ visible
68
+ }) {
69
+ const label = collapsed ? "Expand navigation" : "Collapse navigation";
70
+ const Icon = collapsed ? IconLayoutSidebarLeftExpand.default : IconLayoutSidebarLeftCollapse.default;
71
+ const button = /* @__PURE__ */ jsxRuntime.jsx(
72
+ UnstyledButton.UnstyledButton,
73
+ {
74
+ "data-sidenav-collapse": true,
75
+ "aria-label": label,
76
+ "aria-expanded": !collapsed,
77
+ onClick: onToggle,
78
+ style: {
79
+ display: "inline-flex",
80
+ alignItems: "center",
81
+ justifyContent: "center",
82
+ height: 32,
83
+ flexShrink: 0,
84
+ borderRadius: index.radii.md,
85
+ color: index.fairmintVars.colorIconTertiary,
86
+ opacity: visible ? 1 : 0,
87
+ pointerEvents: visible ? "auto" : "none",
88
+ transition: "opacity 120ms ease",
89
+ // Keep a layout slot when expanded so the wordmark does not shift on hover.
90
+ // Collapsed: always a fixed control below the logo.
91
+ width: 32,
92
+ overflow: "hidden",
93
+ padding: 0
94
+ },
95
+ children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { size: 20, stroke: 1.5, "aria-hidden": true })
96
+ }
97
+ );
98
+ if (!collapsed) {
99
+ return button;
100
+ }
101
+ return /* @__PURE__ */ jsxRuntime.jsx(
102
+ Tooltip.Tooltip,
103
+ {
104
+ label,
105
+ position: "right",
106
+ withArrow: true,
107
+ withinPortal: true,
108
+ zIndex: SIDE_NAV_FLOATING_Z_INDEX,
109
+ events: { hover: true, focus: true, touch: true },
110
+ disabled: !visible,
111
+ children: button
112
+ }
113
+ );
114
+ }
115
+ function resolveLeftSection(item, labelText, { requireIcon, active }) {
116
+ if (item.icon) {
117
+ return item.icon;
118
+ }
119
+ if (requireIcon) {
120
+ return /* @__PURE__ */ jsxRuntime.jsx(LetterFallback, { letter: getSideNavLetterFallback(labelText), active: Boolean(active) });
121
+ }
122
+ return void 0;
123
+ }
124
+ const COLLAPSED_ITEM_SIZE = 36;
125
+ const navLinkStyles = (active) => ({
126
+ root: {
127
+ color: active ? index.fairmintVars.colorTextPrimary : index.fairmintVars.colorTextSecondary,
128
+ fontWeight: active ? 500 : 400,
129
+ borderRadius: index.radii.md,
130
+ // Prefer Fairmint selected surface over Mantine defaults for active chrome.
131
+ ...active ? {
132
+ "--nl-bg": index.fairmintVars.colorSurfaceSelected,
133
+ "--nl-hover": index.fairmintVars.colorSurfaceSelected,
134
+ "--nl-color": index.fairmintVars.colorIconOnSurfaceSelected,
135
+ backgroundColor: index.fairmintVars.colorSurfaceSelected
136
+ } : {}
137
+ },
138
+ section: {
139
+ color: active ? index.fairmintVars.colorIconOnSurfaceSelected : index.fairmintVars.colorIconTertiary
140
+ }
141
+ });
142
+ function ExpandedSideNavNode({ color, item, onItemClick }) {
13
143
  const containsActiveItem = hasActiveDescendant(item);
14
144
  const [opened, setOpened] = React.useState(item.open ?? containsActiveItem);
145
+ const labelText = getSideNavItemLabelText(item);
15
146
  React.useEffect(() => {
16
147
  if (item.open !== void 0) {
17
148
  setOpened(item.open);
@@ -23,8 +154,13 @@ function SideNavNode({ color, item, onItemClick }) {
23
154
  return /* @__PURE__ */ jsxRuntime.jsx(
24
155
  NavLink.NavLink,
25
156
  {
157
+ component: "button",
158
+ type: "button",
26
159
  label: item.label,
27
- leftSection: item.icon,
160
+ leftSection: resolveLeftSection(item, labelText, {
161
+ requireIcon: false,
162
+ active: item.active
163
+ }),
28
164
  rightSection: item.rightSection,
29
165
  active: item.active,
30
166
  disabled: item.disabled,
@@ -32,20 +168,129 @@ function SideNavNode({ color, item, onItemClick }) {
32
168
  variant: "light",
33
169
  childrenOffset: 16,
34
170
  opened: hasChildren ? opened : void 0,
171
+ "aria-label": item.ariaLabel,
35
172
  onClick: hasChildren ? () => setOpened((currentOpened) => !currentOpened) : () => onItemClick(item.id),
36
- style: { borderRadius: index.radii.md },
37
- styles: {
38
- root: {
39
- color: item.active ? index.fairmintVars.colorTextPrimary : index.fairmintVars.colorTextSecondary,
40
- fontWeight: item.active ? 500 : 400
41
- },
42
- section: {
43
- color: item.active ? index.fairmintVars.colorBrandPrimary : index.fairmintVars.colorIconTertiary
173
+ styles: navLinkStyles(item.active),
174
+ children: item.children?.map((child) => /* @__PURE__ */ jsxRuntime.jsx(ExpandedSideNavNode, { item: child, color, onItemClick }, child.id))
175
+ }
176
+ );
177
+ }
178
+ function collectCollapsedMenuLeaves(items) {
179
+ return items.flatMap(
180
+ (item) => item.children?.length ? collectCollapsedMenuLeaves(item.children) : [item]
181
+ );
182
+ }
183
+ function CollapsedNestedMenuItems({
184
+ items,
185
+ onItemClick,
186
+ color
187
+ }) {
188
+ return collectCollapsedMenuLeaves(items).map((child) => {
189
+ const childLabel = getSideNavItemLabelText(child);
190
+ const isActive = Boolean(child.active);
191
+ return /* @__PURE__ */ jsxRuntime.jsx(
192
+ Menu.Menu.Item,
193
+ {
194
+ disabled: child.disabled,
195
+ leftSection: resolveLeftSection(child, childLabel, {
196
+ requireIcon: true,
197
+ active: isActive
198
+ }),
199
+ onClick: () => onItemClick(child.id),
200
+ "aria-current": isActive ? "page" : void 0,
201
+ "data-active": isActive || void 0,
202
+ color: isActive ? color : void 0,
203
+ style: isActive ? {
204
+ backgroundColor: index.fairmintVars.colorSurfaceSelected,
205
+ color: index.fairmintVars.colorIconOnSurfaceSelected,
206
+ fontWeight: 600
207
+ } : void 0,
208
+ children: child.label
209
+ },
210
+ child.id
211
+ );
212
+ });
213
+ }
214
+ function CollapsedSideNavNode({ color, item, onItemClick }) {
215
+ const labelText = getSideNavItemLabelText(item);
216
+ const hasChildren = Boolean(item.children?.length);
217
+ const isActive = Boolean(item.active || hasActiveDescendant(item));
218
+ const leftSection = resolveLeftSection(item, labelText, {
219
+ requireIcon: true,
220
+ active: isActive
221
+ });
222
+ const link = /* @__PURE__ */ jsxRuntime.jsx(
223
+ ActionIcon.ActionIcon,
224
+ {
225
+ type: "button",
226
+ variant: "subtle",
227
+ color,
228
+ size: COLLAPSED_ITEM_SIZE,
229
+ radius: "md",
230
+ disabled: item.disabled,
231
+ "aria-label": labelText,
232
+ "aria-current": isActive ? "page" : void 0,
233
+ "data-active": isActive || void 0,
234
+ onClick: hasChildren ? void 0 : () => onItemClick(item.id),
235
+ style: {
236
+ width: COLLAPSED_ITEM_SIZE,
237
+ height: COLLAPSED_ITEM_SIZE,
238
+ minWidth: COLLAPSED_ITEM_SIZE,
239
+ minHeight: COLLAPSED_ITEM_SIZE,
240
+ ...isActive ? {
241
+ "--ai-bg": index.fairmintVars.colorSurfaceSelected,
242
+ "--ai-hover": index.fairmintVars.colorSurfaceSelected,
243
+ "--ai-color": index.fairmintVars.colorIconOnSurfaceSelected,
244
+ "--ai-hover-color": index.fairmintVars.colorIconOnSurfaceSelected,
245
+ backgroundColor: index.fairmintVars.colorSurfaceSelected,
246
+ color: index.fairmintVars.colorIconOnSurfaceSelected
247
+ } : {
248
+ color: index.fairmintVars.colorIconTertiary
44
249
  }
45
250
  },
46
- children: item.children?.map((child) => /* @__PURE__ */ jsxRuntime.jsx(SideNavNode, { item: child, color, onItemClick }, child.id))
251
+ children: leftSection
252
+ }
253
+ );
254
+ const control = hasChildren ? /* @__PURE__ */ jsxRuntime.jsxs(Menu.Menu, { position: "right-start", offset: 8, withinPortal: true, zIndex: SIDE_NAV_FLOATING_Z_INDEX, children: [
255
+ /* @__PURE__ */ jsxRuntime.jsx(
256
+ Tooltip.Tooltip,
257
+ {
258
+ label: labelText,
259
+ position: "right",
260
+ withArrow: true,
261
+ withinPortal: true,
262
+ zIndex: SIDE_NAV_FLOATING_Z_INDEX,
263
+ events: { hover: true, focus: true, touch: true },
264
+ children: /* @__PURE__ */ jsxRuntime.jsx(Menu.Menu.Target, { children: link })
265
+ }
266
+ ),
267
+ /* @__PURE__ */ jsxRuntime.jsx(Menu.Menu.Dropdown, { children: /* @__PURE__ */ jsxRuntime.jsx(
268
+ CollapsedNestedMenuItems,
269
+ {
270
+ items: item.children ?? [],
271
+ onItemClick,
272
+ color
273
+ }
274
+ ) })
275
+ ] }) : /* @__PURE__ */ jsxRuntime.jsx(
276
+ Tooltip.Tooltip,
277
+ {
278
+ label: labelText,
279
+ position: "right",
280
+ withArrow: true,
281
+ withinPortal: true,
282
+ zIndex: SIDE_NAV_FLOATING_Z_INDEX,
283
+ events: { hover: true, focus: true, touch: true },
284
+ children: link
47
285
  }
48
286
  );
287
+ return /* @__PURE__ */ jsxRuntime.jsx(Box.Box, { style: { width: "100%", display: "flex", justifyContent: "center" }, children: control });
288
+ }
289
+ function SideNavNode(props) {
290
+ if (props.collapsed) {
291
+ return /* @__PURE__ */ jsxRuntime.jsx(CollapsedSideNavNode, { ...props });
292
+ }
293
+ return /* @__PURE__ */ jsxRuntime.jsx(ExpandedSideNavNode, { ...props });
49
294
  }
50
295
  function SideNav({
51
296
  items = [],
@@ -53,28 +298,133 @@ function SideNav({
53
298
  onItemClick,
54
299
  color = "indigo",
55
300
  ariaLabel = "Main navigation",
56
- withBorder = false
301
+ withBorder = false,
302
+ header,
303
+ cta,
304
+ profile,
305
+ footer,
306
+ collapsed,
307
+ defaultCollapsed = false,
308
+ onCollapsedChange,
309
+ collapsible = false
57
310
  }) {
58
311
  const resolvedSections = sections ?? [{ id: "main", items }];
59
- return /* @__PURE__ */ jsxRuntime.jsx(
312
+ const [collapsedState, setCollapsedState] = useUncontrolled.useUncontrolled({
313
+ value: collapsed,
314
+ defaultValue: defaultCollapsed,
315
+ finalValue: false,
316
+ onChange: onCollapsedChange
317
+ });
318
+ const hasBottomChrome = Boolean(footer || cta || profile);
319
+ const [headerHovered, setHeaderHovered] = React.useState(false);
320
+ const showExpandedCollapseControl = headerHovered;
321
+ const showHeaderChrome = Boolean(header) || collapsible;
322
+ const collapseToggle = collapsible ? /* @__PURE__ */ jsxRuntime.jsx(
323
+ CollapseToggle,
324
+ {
325
+ collapsed: collapsedState,
326
+ visible: collapsedState ? true : showExpandedCollapseControl,
327
+ onToggle: () => setCollapsedState(!collapsedState)
328
+ }
329
+ ) : null;
330
+ return /* @__PURE__ */ jsxRuntime.jsxs(
60
331
  Stack.Stack,
61
332
  {
62
333
  component: "nav",
63
334
  gap: "md",
64
335
  h: "100%",
65
- p: "md",
336
+ p: collapsedState ? "sm" : "md",
66
337
  "aria-label": ariaLabel,
338
+ "data-collapsed": collapsedState || void 0,
67
339
  style: {
68
340
  borderRight: withBorder ? "1px solid" : void 0,
69
341
  borderRightColor: withBorder ? index.fairmintVars.colorBorderDefault : void 0,
70
342
  boxShadow: "none"
71
343
  },
72
- children: resolvedSections.map((section) => /* @__PURE__ */ jsxRuntime.jsxs(Stack.Stack, { gap: 4, children: [
73
- section.label && /* @__PURE__ */ jsxRuntime.jsx(Text.Text, { size: "xs", fw: 700, tt: "uppercase", c: index.fairmintVars.colorTextTertiary, px: "sm", children: section.label }),
74
- section.items.map((item) => /* @__PURE__ */ jsxRuntime.jsx(SideNavNode, { item, color, onItemClick }, item.id))
75
- ] }, section.id))
344
+ children: [
345
+ showHeaderChrome ? collapsedState ? /* @__PURE__ */ jsxRuntime.jsxs(Stack.Stack, { gap: 6, align: "center", children: [
346
+ header ? /* @__PURE__ */ jsxRuntime.jsx(
347
+ Box.Box,
348
+ {
349
+ style: {
350
+ display: "flex",
351
+ alignItems: "center",
352
+ justifyContent: "center",
353
+ width: "100%"
354
+ },
355
+ children: header
356
+ }
357
+ ) : null,
358
+ collapseToggle
359
+ ] }) : /* @__PURE__ */ jsxRuntime.jsxs(
360
+ Group.Group,
361
+ {
362
+ justify: "space-between",
363
+ wrap: "nowrap",
364
+ gap: "xs",
365
+ align: "center",
366
+ style: { minHeight: 32 },
367
+ onMouseEnter: () => setHeaderHovered(true),
368
+ onMouseLeave: () => setHeaderHovered(false),
369
+ onFocusCapture: () => setHeaderHovered(true),
370
+ onBlurCapture: (event) => {
371
+ if (!event.currentTarget.contains(event.relatedTarget)) {
372
+ setHeaderHovered(false);
373
+ }
374
+ },
375
+ children: [
376
+ header ? /* @__PURE__ */ jsxRuntime.jsx(
377
+ Box.Box,
378
+ {
379
+ style: {
380
+ flex: 1,
381
+ minWidth: 0,
382
+ overflow: "hidden",
383
+ display: "flex",
384
+ alignItems: "center",
385
+ justifyContent: "flex-start"
386
+ },
387
+ children: header
388
+ }
389
+ ) : null,
390
+ collapseToggle
391
+ ]
392
+ }
393
+ ) : null,
394
+ /* @__PURE__ */ jsxRuntime.jsx(Stack.Stack, { gap: 4, style: { flex: 1, minHeight: 0, overflow: "auto" }, children: resolvedSections.flatMap(
395
+ (section) => section.items.map((item) => /* @__PURE__ */ jsxRuntime.jsx(
396
+ SideNavNode,
397
+ {
398
+ item,
399
+ color,
400
+ onItemClick,
401
+ collapsed: collapsedState
402
+ },
403
+ `${section.id}:${item.id}`
404
+ ))
405
+ ) }),
406
+ hasBottomChrome ? /* @__PURE__ */ jsxRuntime.jsx(Stack.Stack, { gap: "sm", style: { flexShrink: 0 }, children: footer ?? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
407
+ cta ? /* @__PURE__ */ jsxRuntime.jsx(
408
+ Box.Box,
409
+ {
410
+ style: {
411
+ width: "100%",
412
+ display: "flex",
413
+ justifyContent: collapsedState ? "center" : "stretch"
414
+ },
415
+ children: cta
416
+ }
417
+ ) : null,
418
+ cta && profile ? /* @__PURE__ */ jsxRuntime.jsx(Divider.Divider, { color: index.fairmintVars.colorBorderDefault }) : null,
419
+ profile ? /* @__PURE__ */ jsxRuntime.jsx(Box.Box, { style: { width: "100%" }, children: profile }) : null
420
+ ] }) }) : null
421
+ ]
76
422
  }
77
423
  );
78
424
  }
425
+ exports.SIDE_NAV_COLLAPSED_WIDTH = SIDE_NAV_COLLAPSED_WIDTH;
426
+ exports.SIDE_NAV_WIDTH = SIDE_NAV_WIDTH;
79
427
  exports.SideNav = SideNav;
428
+ exports.getSideNavItemLabelText = getSideNavItemLabelText;
429
+ exports.getSideNavLetterFallback = getSideNavLetterFallback;
80
430
  //# sourceMappingURL=SideNav.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"SideNav.cjs","sources":["../../../../src/components/layout/SideNav/SideNav.tsx"],"sourcesContent":["import { NavLink, Stack, Text } from \"@mantine/core\";\nimport { type ReactNode, useEffect, useState } from \"react\";\nimport { fairmintVars, radii } from \"../../../theme\";\n\nexport interface SideNavItem {\n /** Unique identifier for this nav item (e.g., route path or slug). */\n id: string;\n /** Display label. */\n label: ReactNode;\n /** Icon element. */\n icon?: ReactNode;\n /** Optional content rendered at the end of the item, such as a badge. */\n rightSection?: ReactNode;\n /** Whether this item is currently active. */\n active?: boolean;\n /** Whether the item is unavailable. */\n disabled?: boolean;\n /** Nested navigation items. */\n children?: SideNavItem[];\n /** Controlled expanded state for items with children. */\n open?: boolean;\n}\n\nexport interface SideNavSection {\n /** Unique identifier for the section. */\n id: string;\n /** Optional visible section heading. */\n label?: ReactNode;\n /** Navigation items in this section. */\n items: SideNavItem[];\n}\n\nexport interface SideNavProps {\n /** Navigation items to render when section headings are not needed. */\n items?: SideNavItem[];\n /** Grouped navigation items with optional section headings. */\n sections?: SideNavSection[];\n /** Callback when a nav item is clicked. Receives the item's `id`. */\n onItemClick: (id: string) => void;\n /** Active color. @default colors.primary */\n color?: string;\n /** Accessible label for the navigation landmark. @default \"Main navigation\" */\n ariaLabel?: string;\n /** Render a light right border when the parent shell does not already own the divider. @default false */\n withBorder?: boolean;\n}\n\nfunction hasActiveDescendant(item: SideNavItem): boolean {\n return item.children?.some((child) => child.active || hasActiveDescendant(child)) ?? false;\n}\n\ninterface SideNavNodeProps {\n color: string;\n item: SideNavItem;\n onItemClick: (id: string) => void;\n}\n\nfunction SideNavNode({ color, item, onItemClick }: SideNavNodeProps) {\n const containsActiveItem = hasActiveDescendant(item);\n const [opened, setOpened] = useState(item.open ?? containsActiveItem);\n\n useEffect(() => {\n if (item.open !== undefined) {\n setOpened(item.open);\n } else if (containsActiveItem) {\n setOpened(true);\n }\n }, [containsActiveItem, item.open]);\n\n const hasChildren = Boolean(item.children?.length);\n\n return (\n <NavLink\n label={item.label}\n leftSection={item.icon}\n rightSection={item.rightSection}\n active={item.active}\n disabled={item.disabled}\n color={color}\n variant=\"light\"\n childrenOffset={16}\n opened={hasChildren ? opened : undefined}\n onClick={\n hasChildren\n ? () => setOpened((currentOpened) => !currentOpened)\n : () => onItemClick(item.id)\n }\n style={{ borderRadius: radii.md }}\n styles={{\n root: {\n color: item.active ? fairmintVars.colorTextPrimary : fairmintVars.colorTextSecondary,\n fontWeight: item.active ? 500 : 400,\n },\n section: {\n color: item.active ? fairmintVars.colorBrandPrimary : fairmintVars.colorIconTertiary,\n },\n }}\n >\n {item.children?.map((child) => (\n <SideNavNode key={child.id} item={child} color={color} onItemClick={onItemClick} />\n ))}\n </NavLink>\n );\n}\n\nexport function SideNav({\n items = [],\n sections,\n onItemClick,\n color = \"indigo\",\n ariaLabel = \"Main navigation\",\n withBorder = false,\n}: SideNavProps) {\n const resolvedSections = sections ?? [{ id: \"main\", items }];\n\n return (\n <Stack\n component=\"nav\"\n gap=\"md\"\n h=\"100%\"\n p=\"md\"\n aria-label={ariaLabel}\n style={{\n borderRight: withBorder ? \"1px solid\" : undefined,\n borderRightColor: withBorder ? fairmintVars.colorBorderDefault : undefined,\n boxShadow: \"none\",\n }}\n >\n {resolvedSections.map((section) => (\n <Stack key={section.id} gap={4}>\n {section.label && (\n <Text size=\"xs\" fw={700} tt=\"uppercase\" c={fairmintVars.colorTextTertiary} px=\"sm\">\n {section.label}\n </Text>\n )}\n {section.items.map((item) => (\n <SideNavNode key={item.id} item={item} color={color} onItemClick={onItemClick} />\n ))}\n </Stack>\n ))}\n </Stack>\n );\n}\n"],"names":["useState","useEffect","jsx","NavLink","radii","fairmintVars","Stack","jsxs","Text"],"mappings":";;;;;;;;AA+CA,SAAS,oBAAoB,MAA4B;AACvD,SAAO,KAAK,UAAU,KAAK,CAAC,UAAU,MAAM,UAAU,oBAAoB,KAAK,CAAC,KAAK;AACvF;AAQA,SAAS,YAAY,EAAE,OAAO,MAAM,eAAiC;AACnE,QAAM,qBAAqB,oBAAoB,IAAI;AACnD,QAAM,CAAC,QAAQ,SAAS,IAAIA,MAAAA,SAAS,KAAK,QAAQ,kBAAkB;AAEpEC,QAAAA,UAAU,MAAM;AACd,QAAI,KAAK,SAAS,QAAW;AAC3B,gBAAU,KAAK,IAAI;AAAA,IACrB,WAAW,oBAAoB;AAC7B,gBAAU,IAAI;AAAA,IAChB;AAAA,EACF,GAAG,CAAC,oBAAoB,KAAK,IAAI,CAAC;AAElC,QAAM,cAAc,QAAQ,KAAK,UAAU,MAAM;AAEjD,SACEC,2BAAAA;AAAAA,IAACC,QAAAA;AAAAA,IAAA;AAAA,MACC,OAAO,KAAK;AAAA,MACZ,aAAa,KAAK;AAAA,MAClB,cAAc,KAAK;AAAA,MACnB,QAAQ,KAAK;AAAA,MACb,UAAU,KAAK;AAAA,MACf;AAAA,MACA,SAAQ;AAAA,MACR,gBAAgB;AAAA,MAChB,QAAQ,cAAc,SAAS;AAAA,MAC/B,SACE,cACI,MAAM,UAAU,CAAC,kBAAkB,CAAC,aAAa,IACjD,MAAM,YAAY,KAAK,EAAE;AAAA,MAE/B,OAAO,EAAE,cAAcC,MAAAA,MAAM,GAAA;AAAA,MAC7B,QAAQ;AAAA,QACN,MAAM;AAAA,UACJ,OAAO,KAAK,SAASC,MAAAA,aAAa,mBAAmBA,MAAAA,aAAa;AAAA,UAClE,YAAY,KAAK,SAAS,MAAM;AAAA,QAAA;AAAA,QAElC,SAAS;AAAA,UACP,OAAO,KAAK,SAASA,MAAAA,aAAa,oBAAoBA,MAAAA,aAAa;AAAA,QAAA;AAAA,MACrE;AAAA,MAGD,UAAA,KAAK,UAAU,IAAI,CAAC,UACnBH,2BAAAA,IAAC,aAAA,EAA2B,MAAM,OAAO,OAAc,YAAA,GAArC,MAAM,EAAyD,CAClF;AAAA,IAAA;AAAA,EAAA;AAGP;AAEO,SAAS,QAAQ;AAAA,EACtB,QAAQ,CAAA;AAAA,EACR;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,aAAa;AACf,GAAiB;AACf,QAAM,mBAAmB,YAAY,CAAC,EAAE,IAAI,QAAQ,OAAO;AAE3D,SACEA,2BAAAA;AAAAA,IAACI,MAAAA;AAAAA,IAAA;AAAA,MACC,WAAU;AAAA,MACV,KAAI;AAAA,MACJ,GAAE;AAAA,MACF,GAAE;AAAA,MACF,cAAY;AAAA,MACZ,OAAO;AAAA,QACL,aAAa,aAAa,cAAc;AAAA,QACxC,kBAAkB,aAAaD,mBAAa,qBAAqB;AAAA,QACjE,WAAW;AAAA,MAAA;AAAA,MAGZ,2BAAiB,IAAI,CAAC,YACrBE,gCAACD,MAAAA,OAAA,EAAuB,KAAK,GAC1B,UAAA;AAAA,QAAA,QAAQ,SACPJ,2BAAAA,IAACM,KAAAA,MAAA,EAAK,MAAK,MAAK,IAAI,KAAK,IAAG,aAAY,GAAGH,MAAAA,aAAa,mBAAmB,IAAG,MAC3E,kBAAQ,OACX;AAAA,QAED,QAAQ,MAAM,IAAI,CAAC,SAClBH,2BAAAA,IAAC,aAAA,EAA0B,MAAY,OAAc,eAAnC,KAAK,EAAwD,CAChF;AAAA,MAAA,EAAA,GARS,QAAQ,EASpB,CACD;AAAA,IAAA;AAAA,EAAA;AAGP;;"}
1
+ {"version":3,"file":"SideNav.cjs","sources":["../../../../src/components/layout/SideNav/SideNav.tsx"],"sourcesContent":["import {\n ActionIcon,\n Box,\n Divider,\n Group,\n Menu,\n NavLink,\n type NavLinkProps,\n Stack,\n Tooltip,\n UnstyledButton,\n} from \"@mantine/core\";\nimport { useUncontrolled } from \"@mantine/hooks\";\nimport { IconLayoutSidebarLeftCollapse, IconLayoutSidebarLeftExpand } from \"@tabler/icons-react\";\nimport { type ReactNode, useEffect, useState } from \"react\";\nimport { fairmintVars, radii } from \"../../../theme\";\n\n/** Expanded product side-nav width (Brand System shell metric). */\nexport const SIDE_NAV_WIDTH = 260;\n\n/**\n * Collapsed icon-rail width.\n * Proposed shell metric for Dylan / Brand System review — not yet in Brand System v3.4.\n */\nexport const SIDE_NAV_COLLAPSED_WIDTH = 80;\n\n/**\n * Floating chrome (tooltips, nested flyouts) must clear Studio/Investor fixed\n * shell layers — side nav ≈1200, header ≈1201, menus ≥1300.\n */\nconst SIDE_NAV_FLOATING_Z_INDEX = 1300;\n\nexport interface SideNavItem {\n /** Unique identifier for this nav item (e.g., route path or slug). */\n id: string;\n /** Display label. */\n label: ReactNode;\n /**\n * Accessible name when `label` is not a plain string.\n * Also used for collapsed tooltips and letter-fallback derivation.\n */\n ariaLabel?: string;\n /** Icon element. */\n icon?: ReactNode;\n /** Optional content rendered at the end of the item, such as a badge. */\n rightSection?: ReactNode;\n /** Whether this item is currently active. */\n active?: boolean;\n /** Whether the item is unavailable. */\n disabled?: boolean;\n /** Nested navigation items. */\n children?: SideNavItem[];\n /** Controlled expanded state for items with children. */\n open?: boolean;\n}\n\nexport interface SideNavSection {\n /** Unique identifier for the section. */\n id: string;\n /** Navigation items in this section. */\n items: SideNavItem[];\n}\n\nexport interface SideNavProps {\n /** Navigation items to render when section headings are not needed. */\n items?: SideNavItem[];\n /** Grouped navigation items. Sections are data-only — Fairmint product nav does not render section titles. */\n sections?: SideNavSection[];\n /** Callback when a nav item is clicked. Receives the item's `id`. */\n onItemClick: (id: string) => void;\n /** Active color. @default colors.primary */\n color?: string;\n /** Accessible label for the navigation landmark. @default \"Main navigation\" */\n ariaLabel?: string;\n /** Render a light right border when the parent shell does not already own the divider. @default false */\n withBorder?: boolean;\n /**\n * Logo or other chrome above the nav list.\n * Consumers own expanded wordmark vs collapsed mark switching.\n */\n header?: ReactNode;\n /**\n * Primary nav CTA pinned above the profile (Investor \"Add Investment\", Studio \"New\").\n * Prefer this over stuffing the CTA into `items`.\n */\n cta?: ReactNode;\n /**\n * Account / profile control pinned to the bottom of the rail.\n * Product shells keep profile here — not in the scrollable destination list or AppHeader.\n */\n profile?: ReactNode;\n /**\n * Custom bottom chrome. When set, replaces the standard `cta` + divider + `profile` composition.\n */\n footer?: ReactNode;\n /** Controlled collapsed (icon-rail) state. */\n collapsed?: boolean;\n /** Uncontrolled initial collapsed state. @default false */\n defaultCollapsed?: boolean;\n /** Called when the user toggles collapse. */\n onCollapsedChange?: (collapsed: boolean) => void;\n /** When true, render a collapse/expand control beside the logo (visible on header hover). @default false */\n collapsible?: boolean;\n}\n\nfunction hasActiveDescendant(item: SideNavItem): boolean {\n return item.children?.some((child) => child.active || hasActiveDescendant(child)) ?? false;\n}\n\n/** Resolve a plain-text name for tooltips, aria-label, and letter fallback. */\nexport function getSideNavItemLabelText(item: Pick<SideNavItem, \"label\" | \"ariaLabel\">): string {\n if (item.ariaLabel) {\n return item.ariaLabel;\n }\n if (typeof item.label === \"string\") {\n return item.label;\n }\n if (typeof item.label === \"number\") {\n return String(item.label);\n }\n return \"Item\";\n}\n\n/** First letter/number monogram for icon-less items in the collapsed rail. */\nexport function getSideNavLetterFallback(labelText: string): string {\n const match = labelText.match(/[\\p{L}\\p{N}]/u);\n return match ? match[0].toUpperCase() : \"?\";\n}\n\nfunction LetterFallback({ letter, active = false }: { letter: string; active?: boolean }) {\n return (\n <Box\n component=\"span\"\n aria-hidden\n data-active={active || undefined}\n style={{\n display: \"inline-flex\",\n alignItems: \"center\",\n justifyContent: \"center\",\n width: 20,\n height: 20,\n flexShrink: 0,\n fontSize: 12,\n fontWeight: active ? 700 : 600,\n lineHeight: 1,\n // Selected chrome lives on the parent control — glyph matches icon sizing.\n color: active ? fairmintVars.colorIconOnSurfaceSelected : \"inherit\",\n }}\n >\n {letter}\n </Box>\n );\n}\n\nfunction CollapseToggle({\n collapsed,\n onToggle,\n visible,\n}: {\n collapsed: boolean;\n onToggle: () => void;\n /** When false, hide visually but keep focusable for keyboard users via opacity/focus styles. */\n visible: boolean;\n}) {\n const label = collapsed ? \"Expand navigation\" : \"Collapse navigation\";\n const Icon = collapsed ? IconLayoutSidebarLeftExpand : IconLayoutSidebarLeftCollapse;\n\n const button = (\n <UnstyledButton\n data-sidenav-collapse\n aria-label={label}\n aria-expanded={!collapsed}\n onClick={onToggle}\n style={{\n display: \"inline-flex\",\n alignItems: \"center\",\n justifyContent: \"center\",\n height: 32,\n flexShrink: 0,\n borderRadius: radii.md,\n color: fairmintVars.colorIconTertiary,\n opacity: visible ? 1 : 0,\n pointerEvents: visible ? \"auto\" : \"none\",\n transition: \"opacity 120ms ease\",\n // Keep a layout slot when expanded so the wordmark does not shift on hover.\n // Collapsed: always a fixed control below the logo.\n width: 32,\n overflow: \"hidden\",\n padding: 0,\n }}\n >\n <Icon size={20} stroke={1.5} aria-hidden />\n </UnstyledButton>\n );\n\n if (!collapsed) {\n return button;\n }\n\n return (\n <Tooltip\n label={label}\n position=\"right\"\n withArrow\n withinPortal\n zIndex={SIDE_NAV_FLOATING_Z_INDEX}\n events={{ hover: true, focus: true, touch: true }}\n disabled={!visible}\n >\n {button}\n </Tooltip>\n );\n}\n\nfunction resolveLeftSection(\n item: SideNavItem,\n labelText: string,\n { requireIcon, active }: { requireIcon: boolean; active?: boolean },\n): ReactNode {\n if (item.icon) {\n return item.icon;\n }\n if (requireIcon) {\n return <LetterFallback letter={getSideNavLetterFallback(labelText)} active={Boolean(active)} />;\n }\n return undefined;\n}\n\n/** Collapsed rail control size — matches square CTA chrome. */\nconst COLLAPSED_ITEM_SIZE = 36;\n\nconst navLinkStyles = (active: boolean | undefined): NavLinkProps[\"styles\"] => ({\n root: {\n color: active ? fairmintVars.colorTextPrimary : fairmintVars.colorTextSecondary,\n fontWeight: active ? 500 : 400,\n borderRadius: radii.md,\n // Prefer Fairmint selected surface over Mantine defaults for active chrome.\n ...(active\n ? {\n \"--nl-bg\": fairmintVars.colorSurfaceSelected,\n \"--nl-hover\": fairmintVars.colorSurfaceSelected,\n \"--nl-color\": fairmintVars.colorIconOnSurfaceSelected,\n backgroundColor: fairmintVars.colorSurfaceSelected,\n }\n : {}),\n },\n section: {\n color: active ? fairmintVars.colorIconOnSurfaceSelected : fairmintVars.colorIconTertiary,\n },\n});\n\ninterface SideNavNodeProps {\n color: string;\n item: SideNavItem;\n onItemClick: (id: string) => void;\n collapsed: boolean;\n}\n\nfunction ExpandedSideNavNode({ color, item, onItemClick }: Omit<SideNavNodeProps, \"collapsed\">) {\n const containsActiveItem = hasActiveDescendant(item);\n const [opened, setOpened] = useState(item.open ?? containsActiveItem);\n const labelText = getSideNavItemLabelText(item);\n\n useEffect(() => {\n if (item.open !== undefined) {\n setOpened(item.open);\n } else if (containsActiveItem) {\n setOpened(true);\n }\n }, [containsActiveItem, item.open]);\n\n const hasChildren = Boolean(item.children?.length);\n\n return (\n <NavLink\n component=\"button\"\n type=\"button\"\n label={item.label}\n leftSection={resolveLeftSection(item, labelText, {\n requireIcon: false,\n active: item.active,\n })}\n rightSection={item.rightSection}\n active={item.active}\n disabled={item.disabled}\n color={color}\n variant=\"light\"\n childrenOffset={16}\n opened={hasChildren ? opened : undefined}\n aria-label={item.ariaLabel}\n onClick={\n hasChildren\n ? () => setOpened((currentOpened) => !currentOpened)\n : () => onItemClick(item.id)\n }\n styles={navLinkStyles(item.active)}\n >\n {item.children?.map((child) => (\n <ExpandedSideNavNode key={child.id} item={child} color={color} onItemClick={onItemClick} />\n ))}\n </NavLink>\n );\n}\n\n/** Flatten nested groups to leaves for the collapsed flyout (one actionable list). */\nfunction collectCollapsedMenuLeaves(items: SideNavItem[]): SideNavItem[] {\n return items.flatMap((item) =>\n item.children?.length ? collectCollapsedMenuLeaves(item.children) : [item],\n );\n}\n\nfunction CollapsedNestedMenuItems({\n items,\n onItemClick,\n color,\n}: {\n items: SideNavItem[];\n onItemClick: (id: string) => void;\n color: string;\n}) {\n return collectCollapsedMenuLeaves(items).map((child) => {\n const childLabel = getSideNavItemLabelText(child);\n const isActive = Boolean(child.active);\n return (\n <Menu.Item\n key={child.id}\n disabled={child.disabled}\n leftSection={resolveLeftSection(child, childLabel, {\n requireIcon: true,\n active: isActive,\n })}\n onClick={() => onItemClick(child.id)}\n aria-current={isActive ? \"page\" : undefined}\n data-active={isActive || undefined}\n color={isActive ? color : undefined}\n style={\n isActive\n ? {\n backgroundColor: fairmintVars.colorSurfaceSelected,\n color: fairmintVars.colorIconOnSurfaceSelected,\n fontWeight: 600,\n }\n : undefined\n }\n >\n {child.label}\n </Menu.Item>\n );\n });\n}\n\nfunction CollapsedSideNavNode({ color, item, onItemClick }: Omit<SideNavNodeProps, \"collapsed\">) {\n const labelText = getSideNavItemLabelText(item);\n const hasChildren = Boolean(item.children?.length);\n const isActive = Boolean(item.active || hasActiveDescendant(item));\n const leftSection = resolveLeftSection(item, labelText, {\n requireIcon: true,\n active: isActive,\n });\n\n // ActionIcon (not NavLink): NavLink.css forces `width: 100%` and asymmetric\n // horizontal padding, which makes selected/hover chrome a wide pill.\n // Selected fill uses Fairmint surface/selected — Mantine `light` is too dim in dark mode.\n const link = (\n <ActionIcon\n type=\"button\"\n variant=\"subtle\"\n color={color}\n size={COLLAPSED_ITEM_SIZE}\n radius=\"md\"\n disabled={item.disabled}\n aria-label={labelText}\n aria-current={isActive ? \"page\" : undefined}\n data-active={isActive || undefined}\n onClick={hasChildren ? undefined : () => onItemClick(item.id)}\n style={{\n width: COLLAPSED_ITEM_SIZE,\n height: COLLAPSED_ITEM_SIZE,\n minWidth: COLLAPSED_ITEM_SIZE,\n minHeight: COLLAPSED_ITEM_SIZE,\n ...(isActive\n ? {\n \"--ai-bg\": fairmintVars.colorSurfaceSelected,\n \"--ai-hover\": fairmintVars.colorSurfaceSelected,\n \"--ai-color\": fairmintVars.colorIconOnSurfaceSelected,\n \"--ai-hover-color\": fairmintVars.colorIconOnSurfaceSelected,\n backgroundColor: fairmintVars.colorSurfaceSelected,\n color: fairmintVars.colorIconOnSurfaceSelected,\n }\n : {\n color: fairmintVars.colorIconTertiary,\n }),\n }}\n >\n {leftSection}\n </ActionIcon>\n );\n\n const control = hasChildren ? (\n <Menu position=\"right-start\" offset={8} withinPortal zIndex={SIDE_NAV_FLOATING_Z_INDEX}>\n <Tooltip\n label={labelText}\n position=\"right\"\n withArrow\n withinPortal\n zIndex={SIDE_NAV_FLOATING_Z_INDEX}\n events={{ hover: true, focus: true, touch: true }}\n >\n <Menu.Target>{link}</Menu.Target>\n </Tooltip>\n <Menu.Dropdown>\n <CollapsedNestedMenuItems\n items={item.children ?? []}\n onItemClick={onItemClick}\n color={color}\n />\n </Menu.Dropdown>\n </Menu>\n ) : (\n <Tooltip\n label={labelText}\n position=\"right\"\n withArrow\n withinPortal\n zIndex={SIDE_NAV_FLOATING_Z_INDEX}\n events={{ hover: true, focus: true, touch: true }}\n >\n {link}\n </Tooltip>\n );\n\n // Uniform Stack child so Menu vs Tooltip wrappers cannot skew item gaps.\n return <Box style={{ width: \"100%\", display: \"flex\", justifyContent: \"center\" }}>{control}</Box>;\n}\n\nfunction SideNavNode(props: SideNavNodeProps) {\n if (props.collapsed) {\n return <CollapsedSideNavNode {...props} />;\n }\n return <ExpandedSideNavNode {...props} />;\n}\n\nexport function SideNav({\n items = [],\n sections,\n onItemClick,\n color = \"indigo\",\n ariaLabel = \"Main navigation\",\n withBorder = false,\n header,\n cta,\n profile,\n footer,\n collapsed,\n defaultCollapsed = false,\n onCollapsedChange,\n collapsible = false,\n}: SideNavProps) {\n const resolvedSections = sections ?? [{ id: \"main\", items }];\n const [collapsedState, setCollapsedState] = useUncontrolled({\n value: collapsed,\n defaultValue: defaultCollapsed,\n finalValue: false,\n onChange: onCollapsedChange,\n });\n\n const hasBottomChrome = Boolean(footer || cta || profile);\n const [headerHovered, setHeaderHovered] = useState(false);\n const showExpandedCollapseControl = headerHovered;\n const showHeaderChrome = Boolean(header) || collapsible;\n\n const collapseToggle = collapsible ? (\n <CollapseToggle\n collapsed={collapsedState}\n visible={collapsedState ? true : showExpandedCollapseControl}\n onToggle={() => setCollapsedState(!collapsedState)}\n />\n ) : null;\n\n return (\n <Stack\n component=\"nav\"\n gap=\"md\"\n h=\"100%\"\n p={collapsedState ? \"sm\" : \"md\"}\n aria-label={ariaLabel}\n data-collapsed={collapsedState || undefined}\n style={{\n borderRight: withBorder ? \"1px solid\" : undefined,\n borderRightColor: withBorder ? fairmintVars.colorBorderDefault : undefined,\n boxShadow: \"none\",\n }}\n >\n {showHeaderChrome ? (\n collapsedState ? (\n <Stack gap={6} align=\"center\">\n {header ? (\n <Box\n style={{\n display: \"flex\",\n alignItems: \"center\",\n justifyContent: \"center\",\n width: \"100%\",\n }}\n >\n {header}\n </Box>\n ) : null}\n {collapseToggle}\n </Stack>\n ) : (\n <Group\n justify=\"space-between\"\n wrap=\"nowrap\"\n gap=\"xs\"\n align=\"center\"\n style={{ minHeight: 32 }}\n onMouseEnter={() => setHeaderHovered(true)}\n onMouseLeave={() => setHeaderHovered(false)}\n onFocusCapture={() => setHeaderHovered(true)}\n onBlurCapture={(event) => {\n if (!event.currentTarget.contains(event.relatedTarget as Node | null)) {\n setHeaderHovered(false);\n }\n }}\n >\n {header ? (\n <Box\n style={{\n flex: 1,\n minWidth: 0,\n overflow: \"hidden\",\n display: \"flex\",\n alignItems: \"center\",\n justifyContent: \"flex-start\",\n }}\n >\n {header}\n </Box>\n ) : null}\n {collapseToggle}\n </Group>\n )\n ) : null}\n\n <Stack gap={4} style={{ flex: 1, minHeight: 0, overflow: \"auto\" }}>\n {resolvedSections.flatMap((section) =>\n section.items.map((item) => (\n <SideNavNode\n key={`${section.id}:${item.id}`}\n item={item}\n color={color}\n onItemClick={onItemClick}\n collapsed={collapsedState}\n />\n )),\n )}\n </Stack>\n\n {hasBottomChrome ? (\n <Stack gap=\"sm\" style={{ flexShrink: 0 }}>\n {footer ?? (\n <>\n {cta ? (\n <Box\n style={{\n width: \"100%\",\n display: \"flex\",\n justifyContent: collapsedState ? \"center\" : \"stretch\",\n }}\n >\n {cta}\n </Box>\n ) : null}\n {cta && profile ? <Divider color={fairmintVars.colorBorderDefault} /> : null}\n {profile ? <Box style={{ width: \"100%\" }}>{profile}</Box> : null}\n </>\n )}\n </Stack>\n ) : null}\n </Stack>\n );\n}\n"],"names":["jsx","Box","fairmintVars","IconLayoutSidebarLeftExpand","IconLayoutSidebarLeftCollapse","UnstyledButton","radii","Tooltip","useState","useEffect","NavLink","Menu","ActionIcon","jsxs","useUncontrolled","Stack","Group","Fragment","Divider"],"mappings":"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"}
@@ -1,9 +1,21 @@
1
1
  import { ReactNode } from 'react';
2
+ /** Expanded product side-nav width (Brand System shell metric). */
3
+ export declare const SIDE_NAV_WIDTH = 260;
4
+ /**
5
+ * Collapsed icon-rail width.
6
+ * Proposed shell metric for Dylan / Brand System review — not yet in Brand System v3.4.
7
+ */
8
+ export declare const SIDE_NAV_COLLAPSED_WIDTH = 80;
2
9
  export interface SideNavItem {
3
10
  /** Unique identifier for this nav item (e.g., route path or slug). */
4
11
  id: string;
5
12
  /** Display label. */
6
13
  label: ReactNode;
14
+ /**
15
+ * Accessible name when `label` is not a plain string.
16
+ * Also used for collapsed tooltips and letter-fallback derivation.
17
+ */
18
+ ariaLabel?: string;
7
19
  /** Icon element. */
8
20
  icon?: ReactNode;
9
21
  /** Optional content rendered at the end of the item, such as a badge. */
@@ -20,15 +32,13 @@ export interface SideNavItem {
20
32
  export interface SideNavSection {
21
33
  /** Unique identifier for the section. */
22
34
  id: string;
23
- /** Optional visible section heading. */
24
- label?: ReactNode;
25
35
  /** Navigation items in this section. */
26
36
  items: SideNavItem[];
27
37
  }
28
38
  export interface SideNavProps {
29
39
  /** Navigation items to render when section headings are not needed. */
30
40
  items?: SideNavItem[];
31
- /** Grouped navigation items with optional section headings. */
41
+ /** Grouped navigation items. Sections are data-only — Fairmint product nav does not render section titles. */
32
42
  sections?: SideNavSection[];
33
43
  /** Callback when a nav item is clicked. Receives the item's `id`. */
34
44
  onItemClick: (id: string) => void;
@@ -38,6 +48,37 @@ export interface SideNavProps {
38
48
  ariaLabel?: string;
39
49
  /** Render a light right border when the parent shell does not already own the divider. @default false */
40
50
  withBorder?: boolean;
51
+ /**
52
+ * Logo or other chrome above the nav list.
53
+ * Consumers own expanded wordmark vs collapsed mark switching.
54
+ */
55
+ header?: ReactNode;
56
+ /**
57
+ * Primary nav CTA pinned above the profile (Investor "Add Investment", Studio "New").
58
+ * Prefer this over stuffing the CTA into `items`.
59
+ */
60
+ cta?: ReactNode;
61
+ /**
62
+ * Account / profile control pinned to the bottom of the rail.
63
+ * Product shells keep profile here — not in the scrollable destination list or AppHeader.
64
+ */
65
+ profile?: ReactNode;
66
+ /**
67
+ * Custom bottom chrome. When set, replaces the standard `cta` + divider + `profile` composition.
68
+ */
69
+ footer?: ReactNode;
70
+ /** Controlled collapsed (icon-rail) state. */
71
+ collapsed?: boolean;
72
+ /** Uncontrolled initial collapsed state. @default false */
73
+ defaultCollapsed?: boolean;
74
+ /** Called when the user toggles collapse. */
75
+ onCollapsedChange?: (collapsed: boolean) => void;
76
+ /** When true, render a collapse/expand control beside the logo (visible on header hover). @default false */
77
+ collapsible?: boolean;
41
78
  }
42
- export declare function SideNav({ items, sections, onItemClick, color, ariaLabel, withBorder, }: SideNavProps): import("react/jsx-runtime").JSX.Element;
79
+ /** Resolve a plain-text name for tooltips, aria-label, and letter fallback. */
80
+ export declare function getSideNavItemLabelText(item: Pick<SideNavItem, "label" | "ariaLabel">): string;
81
+ /** First letter/number monogram for icon-less items in the collapsed rail. */
82
+ export declare function getSideNavLetterFallback(labelText: string): string;
83
+ export declare function SideNav({ items, sections, onItemClick, color, ariaLabel, withBorder, header, cta, profile, footer, collapsed, defaultCollapsed, onCollapsedChange, collapsible, }: SideNavProps): import("react/jsx-runtime").JSX.Element;
43
84
  //# sourceMappingURL=SideNav.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"SideNav.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/SideNav/SideNav.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAG5D,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,oBAAoB;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,yEAAyE;IACzE,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wCAAwC;IACxC,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,qEAAqE;IACrE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yGAAyG;IACzG,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA4DD,wBAAgB,OAAO,CAAC,EACtB,KAAU,EACV,QAAQ,EACR,WAAW,EACX,KAAgB,EAChB,SAA6B,EAC7B,UAAkB,GACnB,EAAE,YAAY,2CA8Bd"}
1
+ {"version":3,"file":"SideNav.d.ts","sourceRoot":"","sources":["../../../../src/components/layout/SideNav/SideNav.tsx"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAG5D,mEAAmE;AACnE,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAQ3C,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,yEAAyE;IACzE,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,8GAA8G;IAC9G,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,qEAAqE;IACrE,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yGAAyG;IACzG,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;OAGG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,4GAA4G;IAC5G,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG,MAAM,CAW9F;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGlE;AA2TD,wBAAgB,OAAO,CAAC,EACtB,KAAU,EACV,QAAQ,EACR,WAAW,EACX,KAAgB,EAChB,SAA6B,EAC7B,UAAkB,EAClB,MAAM,EACN,GAAG,EACH,OAAO,EACP,MAAM,EACN,SAAS,EACT,gBAAwB,EACxB,iBAAiB,EACjB,WAAmB,GACpB,EAAE,YAAY,2CA6Hd"}