sage-nexus-ui 1.3.6 → 1.4.0

package/dist/assets/images/favicon.ico.mjs

@@ -0,0 +1 @@
+var a="assets/images/favicon.ico";export{a as default};

package/dist/assets/images/urls.mjs

@@ -0,0 +1 @@
+import o from"./nexus-logo-favicon.svg.mjs";import m from"./favicon.ico.mjs";import{SAGE_NEXUS_UI_VERSION as r}from"../../generated/version.mjs";const i=r,s=(r=!0)=>({svg:r?`${o}?v=${i}`:o,ico:r?`${m}?v=${i}`:m});export{s as getFaviconUrls};

package/dist/components/Alert.mjs

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{Alert as t}from"@mui/material";export{AlertTitle}from"@mui/material";const m=m=>r(t,{...m});export{m as Alert};

package/dist/components/Code.mjs

@@ -0,0 +1 @@
+import{jsx as o}from"react/jsx-runtime";import{Typography as r}from"@mui/material";import{forwardRef as e}from"react";const a=e(({sx:e,...a},t)=>o(r,{ref:t,variant:"body2",component:"code",sx:[{fontFamily:'"SFMono-Regular", "Consolas", "Liberation Mono", "Menlo", monospace',fontSize:"0.78rem",color:"text.secondary",backgroundColor:"action.hover",borderRadius:"4px",px:.75,py:.25},...Array.isArray(e)?e:e?[e]:[]],...a}));a.displayName="Code";export{a as Code};

package/dist/components/Container.mjs

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{Container as t}from"@mui/material";const m=m=>r(t,{...m});export{m as Container};

package/dist/components/FaviconLinks.mjs

@@ -0,0 +1 @@
+import{jsxs as r,Fragment as e,jsx as s}from"react/jsx-runtime";import o from"../assets/images/nexus-logo-favicon.svg.mjs";import i from"../assets/images/favicon.ico.mjs";import{SAGE_NEXUS_UI_VERSION as t}from"../generated/version.mjs";const m=t,n=({versioned:t=!0,svgAttrs:n,icoAttrs:c})=>{const a=t?`${i}?v=${m}`:i;return r(e,{children:[s("link",{rel:"icon",type:"image/svg+xml",href:t?`${o}?v=${m}`:o,...n}),s("link",{rel:"icon",href:a,...c})]})};export{n as FaviconLinks};

package/dist/components/Grid.mjs

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{Grid as m}from"@mui/material";const t=t=>r(m,{...t});export{t as Grid};

package/dist/components/Link.mjs

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{Link as o}from"@mui/material";import{useTokens as e}from"../theme/useTokens.mjs";const t=({openInNewTab:t=!1,children:n,sx:i,...a})=>{const m=e().text.blues;return r(o,{target:t?"_blank":void 0,rel:t?"noopener noreferrer":void 0,sx:[{color:m,textDecorationColor:m,"&:hover":{color:m,opacity:.8}},...Array.isArray(i)?i:i?[i]:[]],...a,children:n})};export{t as Link};

package/dist/components/Select.mjs

@@ -0,0 +1 @@
+import{jsxs as e,jsx as l}from"react/jsx-runtime";import{FormControl as i,InputLabel as r,Select as a,MenuItem as o}from"@mui/material";export{MenuItem}from"@mui/material";const t=({label:t,options:m,formControlSx:n,id:d,children:s,size:c="small",...u})=>{const p=d?`${d}-label`:void 0;return e(i,{size:c,sx:n,children:[t&&l(r,{id:p,children:t}),l(a,{id:d,labelId:p,label:t,size:c,...u,children:m?m.map(e=>l(o,{value:e.value,children:e.label},e.value)):s})]})};export{t as Select};

package/dist/components/StatusBadge.mjs

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{Chip as o}from"@mui/material";import{useTheme as e}from"@mui/material/styles";import{colours as a}from"../theme/tokens.mjs";const t=({variant:t="neutral",label:l})=>{const b=e(),n="dark"===b.palette.mode,i={success:{bg:n?"rgba(0, 166, 92, 0.18)":"rgba(0, 166, 92, 0.12)",color:n?a.brilliantGreen:a.jade},warning:{bg:n?"rgba(233, 135, 91, 0.18)":"rgba(233, 135, 91, 0.12)",color:a.amber},error:{bg:n?"rgba(204, 15, 75, 0.18)":"rgba(204, 15, 75, 0.10)",color:a.cherry},info:{bg:n?"rgba(0, 214, 222, 0.14)":"rgba(45, 96, 255, 0.10)",color:n?a.cyan:a.blue},neutral:{bg:b.palette.action.hover,color:b.palette.text.secondary}},{bg:m,color:g}=i[t];return r(o,{label:l,size:"small",sx:{backgroundColor:m,color:g,border:"none",boxShadow:"none",fontWeight:600,fontSize:"0.7rem",height:22,"& .MuiChip-label":{px:1.25}}})};export{t as StatusBadge};

package/dist/components/Switch.mjs

@@ -0,0 +1 @@
+import{jsx as r}from"react/jsx-runtime";import{Switch as t}from"@mui/material";const m=m=>r(t,{...m});export{m as Switch};

package/dist/generated/version.mjs

@@ -0,0 +1 @@
+const o="1.4.0";export{o as SAGE_NEXUS_UI_VERSION};

package/dist/index.d.ts

@@ -1,14 +1,15 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { AlertProps, TypographyProps, ContainerProps, GridProps, LinkProps as LinkProps$1, SelectProps as SelectProps$1, SxProps, SwitchProps, Theme as Theme$1, AccordionSummaryProps, ButtonProps, CardProps as CardProps$1, PaperProps, BoxProps, CollapseProps, ButtonBaseProps, ChipProps, DialogProps, DialogActionsProps, DialogContentProps, DialogContentTextProps, DialogTitleProps, DividerProps, IconButtonProps as IconButtonProps$1, SkeletonProps as SkeletonProps$1, StackProps, TabProps, TabsProps, TextFieldProps, TooltipProps as TooltipProps$1 } from '@mui/material';
+export { AlertProps, AlertTitle, BoxProps, ButtonBaseProps, ChipProps, CollapseProps, ContainerProps, DialogActionsProps, DialogContentProps, DialogContentTextProps, DialogProps, DialogTitleProps, DividerProps, GridProps, MenuItem, PaperProps, StackProps, SwitchProps, TabProps, TabsProps, TextFieldProps, Theme, alpha, useMediaQuery, useTheme } from '@mui/material';
 import * as react from 'react';
 import react__default, { ReactNode, ReactElement, CSSProperties, PropsWithChildren } from 'react';
-import { TypographyProps, SxProps, Theme, AccordionSummaryProps, ButtonProps, CardProps as CardProps$1, PaperProps, BoxProps, CollapseProps, ButtonBaseProps, ChipProps, DialogProps, DialogActionsProps, DialogContentProps, DialogContentTextProps, DialogTitleProps, DividerProps, IconButtonProps as IconButtonProps$1, SkeletonProps as SkeletonProps$1, StackProps, TabProps, TabsProps, TextFieldProps, TooltipProps as TooltipProps$1 } from '@mui/material';
-export { BoxProps, ButtonBaseProps, ChipProps, CollapseProps, DialogActionsProps, DialogContentProps, DialogContentTextProps, DialogProps, DialogTitleProps, DividerProps, PaperProps, StackProps, TabProps, TabsProps, TextFieldProps, Theme, alpha, useMediaQuery, useTheme } from '@mui/material';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Theme, SxProps as SxProps$2 } from '@mui/material/styles';
 import { DataGridProps } from '@mui/x-data-grid';
 export { DataGridProps, GridColDef, GridColumnVisibilityModel, GridPaginationModel, GridRenderCellParams, GridRowsProp, GridSortModel, GridValueGetter } from '@mui/x-data-grid';
 import { SxProps as SxProps$1 } from '@mui/system';
-import { Theme as Theme$1, SxProps as SxProps$2 } from '@mui/material/styles';
 export { default as nexusLogoNode } from './assets/images/nexus-logo-node.svg';
 export { default as nexusLogoFavicon } from './assets/images/nexus-logo-favicon.svg';
+export { default as nexusLogoIco } from './assets/images/favicon.ico';
 
 declare const getFiscalPeriod: (date: Date) => {
     fiscalYear: number;
@@ -17,6 +18,72 @@ declare const getFiscalPeriod: (date: Date) => {
 };
 declare const formatDate: (date: Date) => string;
 
+/**
+ * Themed inline alert for info / success / warning / error messages.
+ * Accepts all MUI AlertProps — use `severity` to set the variant.
+ */
+declare const Alert: (props: AlertProps) => react_jsx_runtime.JSX.Element;
+
+type Props$1 = Omit<TypographyProps, "variant" | "component">;
+/**
+ * Monospace inline code / path snippet.
+ * Renders as a `<code>` element using the system monospace font stack.
+ * Colour inherits from `text.secondary` by default.
+ */
+declare const Code: react.ForwardRefExoticComponent<Omit<Props$1, "ref"> & react.RefAttributes<HTMLElement>>;
+
+declare const Container: (props: ContainerProps) => react_jsx_runtime.JSX.Element;
+
+declare const Grid: (props: GridProps) => react_jsx_runtime.JSX.Element;
+
+interface LinkProps extends LinkProps$1 {
+    /** Open in a new tab. Defaults to false. */
+    openInNewTab?: boolean;
+}
+/**
+ * Styled anchor component for inline navigation.
+ * Uses the `text.blues` semantic token (from `useTokens()`).
+ *
+ * For button-shaped links use `PrimaryButtonLink` / `SecondaryButtonLink`.
+ */
+declare const Link: ({ openInNewTab, children, sx, ...rest }: LinkProps) => react_jsx_runtime.JSX.Element;
+
+interface SelectOption {
+    value: string;
+    label: string;
+}
+interface SelectProps extends Omit<SelectProps$1, "label"> {
+    /** Floating label rendered above the select. */
+    label?: string;
+    /** Convenience prop: renders `MenuItem`s from an array instead of requiring children. */
+    options?: SelectOption[];
+    /** `sx` passed to the wrapping `FormControl`. */
+    formControlSx?: SxProps<Theme>;
+}
+/**
+ * A single-value (or multi-value) select field that bundles
+ * `FormControl + InputLabel + Select` into one component.
+ *
+ * Use `options` for a simple array-driven list, or pass `<MenuItem>` children directly.
+ */
+declare const Select: ({ label, options, formControlSx, id, children, size, ...rest }: SelectProps) => react_jsx_runtime.JSX.Element;
+
+type StatusBadgeVariant = "success" | "warning" | "error" | "info" | "neutral";
+interface StatusBadgeProps {
+    variant?: StatusBadgeVariant;
+    label: string;
+}
+/**
+ * Inline semantic status pill.
+ * Use for conveying status at a glance: success / warning / error / info / neutral.
+ *
+ * For RAG-specific statuses (On Track / At Risk / Off Track) prefer `RagChip`.
+ * For domain-specific workflow statuses prefer `StatusChip`.
+ */
+declare const StatusBadge: ({ variant, label, }: StatusBadgeProps) => react_jsx_runtime.JSX.Element;
+
+declare const Switch: (props: SwitchProps) => react_jsx_runtime.JSX.Element;
+
 /**
  * Typed wrappers around MUI Typography that fix the `variant` prop and
  * inherit colour from the sageTheme TYPOGRAPHY_COLOURS map.
@@ -42,7 +109,7 @@ declare const ActionBar: ({ title, extraLeft, extraRight, homeHref, }: ActionBar
 
 interface AccordionGroupProps {
     children: ReactNode;
-    sx?: SxProps<Theme>;
+    sx?: SxProps<Theme$1>;
 }
 declare const AccordionGroup: ({ children, sx }: AccordionGroupProps) => react_jsx_runtime.JSX.Element;
 interface AccordionGroupItemProps {
@@ -52,8 +119,8 @@ interface AccordionGroupItemProps {
     disabled?: boolean;
     summaryProps?: Omit<AccordionSummaryProps, "children" | "expandIcon">;
     expandIcon?: ReactNode;
-    sx?: SxProps<Theme>;
-    detailsSx?: SxProps<Theme>;
+    sx?: SxProps<Theme$1>;
+    detailsSx?: SxProps<Theme$1>;
 }
 declare const AccordionGroupItem: ({ summary, children, defaultExpanded, disabled, summaryProps, expandIcon, sx, detailsSx, }: AccordionGroupItemProps) => react_jsx_runtime.JSX.Element;
 
@@ -66,8 +133,8 @@ interface AccordionSingleProps {
     disabled?: boolean;
     summaryProps?: Omit<AccordionSummaryProps, "children" | "expandIcon">;
     expandIcon?: ReactNode;
-    sx?: SxProps<Theme>;
-    detailsSx?: SxProps<Theme>;
+    sx?: SxProps<Theme$1>;
+    detailsSx?: SxProps<Theme$1>;
 }
 declare const AccordionSingle: ({ summary, children, defaultExpanded, expanded, onChange, disabled, summaryProps, expandIcon, sx, detailsSx, }: AccordionSingleProps) => react_jsx_runtime.JSX.Element;
 
@@ -130,9 +197,9 @@ interface CheckboxGroupProps {
     labels?: string[];
     selectedValues?: string[];
     onChange?: (values: string[]) => void;
-    rootSx?: SxProps$1<Theme$1>;
-    groupSx?: SxProps$1<Theme$1>;
-    titleSx?: SxProps$1<Theme$1>;
+    rootSx?: SxProps$1<Theme>;
+    groupSx?: SxProps$1<Theme>;
+    titleSx?: SxProps$1<Theme>;
 }
 declare const CheckboxGroup: React.FC<CheckboxGroupProps>;
 
@@ -175,9 +242,9 @@ interface LocationMultiSelectProps {
     emptyLabel?: string;
     selectedLocations?: string[];
     onLocationsChange?: (next: string[]) => void;
-    formControlSx?: SxProps<Theme$1>;
-    menuSx?: SxProps<Theme$1>;
-    selectSx?: SxProps<Theme$1>;
+    formControlSx?: SxProps<Theme>;
+    menuSx?: SxProps<Theme>;
+    selectSx?: SxProps<Theme>;
 }
 declare const LocationMultiSelect: react__default.FC<LocationMultiSelectProps>;
 
@@ -302,8 +369,8 @@ interface SearchInputProps {
     onSearchChange: (value: string) => void;
     placeholder?: string;
     searchValue?: string;
-    sx?: SxProps<Theme$1>;
-    styles?: SxProps<Theme$1>;
+    sx?: SxProps<Theme>;
+    styles?: SxProps<Theme>;
 }
 declare const SearchInput: react__default.FC<SearchInputProps>;
 
@@ -324,7 +391,7 @@ interface SideBladeProps {
     /** Width of the blade when collapsed (px). Default: 64 */
     collapsedWidth?: number;
     /** Additional sx overrides applied to the Drawer Paper */
-    sx?: SxProps<Theme>;
+    sx?: SxProps<Theme$1>;
 }
 /**
  * SideBlade — a mini-variant persistent Drawer that expands/collapses.
@@ -378,6 +445,21 @@ interface TooltipProps extends Omit<TooltipProps$1, "title"> {
 }
 declare const Tooltip: ({ title, children, ...rest }: TooltipProps) => react_jsx_runtime.JSX.Element;
 
+declare const getFaviconUrls: (versioned?: boolean) => {
+    svg: string;
+    ico: string;
+};
+
+type FaviconLinksProps = {
+    /** Append version query param for cache-busting (default true) */
+    versioned?: boolean;
+    /** Optional additional attributes to add to the svg link */
+    svgAttrs?: react__default.LinkHTMLAttributes<HTMLLinkElement>;
+    /** Optional additional attributes to add to the ico link */
+    icoAttrs?: react__default.LinkHTMLAttributes<HTMLLinkElement>;
+};
+declare const FaviconLinks: react__default.FC<FaviconLinksProps>;
+
 type ThemeMode = "light" | "dark";
 type ModeTokens = {
     background: {
@@ -438,7 +520,7 @@ declare module "@mui/material/Typography" {
     }
 }
 
-declare const createSageTheme: (mode?: ThemeMode) => Theme$1;
+declare const createSageTheme: (mode?: ThemeMode) => Theme;
 
 declare const useTokens: () => ModeTokens;
 
@@ -461,7 +543,7 @@ type GradientBorderOptions = {
     borderRadius?: number;
     padding?: number;
 };
-declare const getGradientBorderStyles: (theme: Theme$1, options?: GradientBorderOptions) => {
+declare const getGradientBorderStyles: (theme: Theme, options?: GradientBorderOptions) => {
     position: string;
     borderRadius: number;
     border: string;
@@ -480,8 +562,8 @@ declare const getGradientBorderStyles: (theme: Theme$1, options?: GradientBorder
         pointerEvents: string;
     };
 };
-declare const leftPipe: SxProps$2<Theme$1>;
-declare const expandableText: (isExpanded: boolean) => SxProps$2<Theme$1>;
+declare const leftPipe: SxProps$2<Theme>;
+declare const expandableText: (isExpanded: boolean) => SxProps$2<Theme>;
 
-export { AccordionGroup, AccordionGroupItem, AccordionSingle, ActionBar, ActionBarTitle, AiButton, AiCard, AiGlassCard, AiGlassPaper, AiPaper, Body1, Body2, Box, ButtonBase, Caption, Card, CheckboxGroup, Chip, Collapse, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, Divider, GlassCard, GlassPaper, GlassPaperAsync, GreenWaveBackground, H1, H2, H3, H4, IconButton, LoadingSpinnerNexus, LocationMultiSelect, LogoOptions, MuiAppThemeProvider, NexusDataGrid, NexusHome, NexusLogo, Paper, PrimaryButton, PrimaryButtonLink, RagChip, RagDot, SearchInput, SecondaryButton, SecondaryButtonLink, SideBlade, Skeleton, SkillChip, Stack, StatusChip, Tab, Tabs, TextField, ThemeModeProvider, ThemeToggle, Tooltip, colours, createSageTheme, expandableText, fontSageHeadline, fontSageText, fontSageUI, formatDate, getFiscalPeriod, getGradientBorderStyles, getModeTokens, gradients, leftPipe, useThemeMode, useTokens };
-export type { AccordionGroupItemProps, AccordionGroupProps, AccordionSingleProps, AiButtonProps, AiCardProps, AiGlassCardProps, AiGlassPaperProps, AiPaperProps, CardProps, CardTrend, GlassCardProps, GlassPaperAsyncProps, GlassPaperProps, GradientBorderOptions, GreenWaveBackgroundProps, IconButtonProps, LoadingSpinnerNexusProps, ModeTokens, PrimaryButtonLinkProps, PrimaryButtonProps, SecondaryButtonLinkProps, SecondaryButtonProps, SideBladeProps, SkeletonProps, ThemeMode, TooltipProps };
+export { AccordionGroup, AccordionGroupItem, AccordionSingle, ActionBar, ActionBarTitle, AiButton, AiCard, AiGlassCard, AiGlassPaper, AiPaper, Alert, Body1, Body2, Box, ButtonBase, Caption, Card, CheckboxGroup, Chip, Code, Collapse, Container, Dialog, DialogActions, DialogContent, DialogContentText, DialogTitle, Divider, FaviconLinks, GlassCard, GlassPaper, GlassPaperAsync, GreenWaveBackground, Grid, H1, H2, H3, H4, IconButton, Link, LoadingSpinnerNexus, LocationMultiSelect, LogoOptions, MuiAppThemeProvider, NexusDataGrid, NexusHome, NexusLogo, Paper, PrimaryButton, PrimaryButtonLink, RagChip, RagDot, SearchInput, SecondaryButton, SecondaryButtonLink, Select, SideBlade, Skeleton, SkillChip, Stack, StatusBadge, StatusChip, Switch, Tab, Tabs, TextField, ThemeModeProvider, ThemeToggle, Tooltip, colours, createSageTheme, expandableText, fontSageHeadline, fontSageText, fontSageUI, formatDate, getFaviconUrls, getFiscalPeriod, getGradientBorderStyles, getModeTokens, gradients, leftPipe, useThemeMode, useTokens };
+export type { AccordionGroupItemProps, AccordionGroupProps, AccordionSingleProps, AiButtonProps, AiCardProps, AiGlassCardProps, AiGlassPaperProps, AiPaperProps, CardProps, CardTrend, GlassCardProps, GlassPaperAsyncProps, GlassPaperProps, GradientBorderOptions, GreenWaveBackgroundProps, IconButtonProps, LinkProps, LoadingSpinnerNexusProps, ModeTokens, PrimaryButtonLinkProps, PrimaryButtonProps, SecondaryButtonLinkProps, SecondaryButtonProps, SelectOption, SelectProps, SideBladeProps, SkeletonProps, StatusBadgeProps, StatusBadgeVariant, ThemeMode, TooltipProps };

package/dist/index.mjs

@@ -1 +1 @@
-export{formatDate,getFiscalPeriod}from"./components/DateFormats.mjs";export{ActionBarTitle,Body1,Body2,Caption,H1,H2,H3,H4}from"./components/Typography.mjs";export{ActionBar}from"./components/ActionBar.mjs";export{AccordionGroup,AccordionGroupItem}from"./components/AccordionGroup.mjs";export{AccordionSingle}from"./components/AccordionSingle.mjs";export{AiButton}from"./components/AiButton.mjs";export{AiCard}from"./components/AiCard.mjs";export{AiGlassCard}from"./components/AiGlassCard.mjs";export{AiPaper}from"./components/AiPaper.mjs";export{AiGlassPaper}from"./components/AiGlassPaper.mjs";export{Box}from"./components/Box.mjs";export{Collapse}from"./components/Collapse.mjs";export{NexusDataGrid}from"./components/NexusDataGrid.mjs";export{ButtonBase}from"./components/ButtonBase.mjs";export{Card}from"./components/Card.mjs";export{CheckboxGroup}from"./components/CheckboxGroup.mjs";export{Chip}from"./components/Chip.mjs";export{Dialog,DialogActions,DialogContent,DialogContentText,DialogTitle}from"./components/Dialog.mjs";export{Divider}from"./components/Divider.mjs";export{GlassCard}from"./components/GlassCard.mjs";export{GlassPaper}from"./components/GlassPaper.mjs";export{GlassPaperAsync}from"./components/GlassPaperAsync.mjs";export{GreenWaveBackground}from"./components/GreenWaveBackground.mjs";export{IconButton}from"./components/IconButton.mjs";export{LoadingSpinnerNexus}from"./components/LoadingSpinnerNexus.mjs";export{LocationMultiSelect}from"./components/LocationMultiSelect.mjs";export{LogoOptions}from"./components/LogoOptions/index.mjs";export{NexusHome}from"./components/NexusHome.mjs";export{default as NexusLogo}from"./components/NexusLogo.mjs";export{Paper}from"./components/Paper.mjs";export{PrimaryButton}from"./components/PrimaryButton.mjs";export{PrimaryButtonLink}from"./components/PrimaryButtonLink.mjs";export{SecondaryButton}from"./components/SecondaryButton.mjs";export{RagDot}from"./components/RagDot.mjs";export{RagChip}from"./components/RagChip.mjs";export{SecondaryButtonLink}from"./components/SecondaryButtonLink.mjs";export{SearchInput}from"./components/SearchInput.mjs";export{SideBlade}from"./components/SideBlade.mjs";export{Skeleton}from"./components/Skeleton.mjs";export{SkillChip}from"./components/SkillChip.mjs";export{Stack}from"./components/Stack.mjs";export{StatusChip}from"./components/StatusChip.mjs";export{Tab}from"./components/Tab.mjs";export{Tabs}from"./components/Tabs.mjs";export{TextField}from"./components/TextField.mjs";export{ThemeToggle}from"./components/ThemeToggle.mjs";export{Tooltip}from"./components/Tooltip.mjs";export{default as nexusLogoNode}from"./assets/images/nexus-logo-node.svg.mjs";export{default as nexusLogoFavicon}from"./assets/images/nexus-logo-favicon.svg.mjs";export{createSageTheme}from"./theme/sageTheme.mjs";export{colours,fontSageHeadline,fontSageText,fontSageUI,getModeTokens,gradients}from"./theme/tokens.mjs";export{useTokens}from"./theme/useTokens.mjs";export{default as MuiAppThemeProvider}from"./theme/MuiAppThemeProvider.mjs";export{ThemeModeProvider,useThemeMode}from"./theme/ThemeContext.mjs";export{alpha,useMediaQuery,useTheme}from"@mui/material";export{expandableText,getGradientBorderStyles,leftPipe}from"./theme/sxHelpers.mjs";
+export{formatDate,getFiscalPeriod}from"./components/DateFormats.mjs";export{Alert}from"./components/Alert.mjs";export{Code}from"./components/Code.mjs";export{Container}from"./components/Container.mjs";export{Grid}from"./components/Grid.mjs";export{Link}from"./components/Link.mjs";export{Select}from"./components/Select.mjs";export{StatusBadge}from"./components/StatusBadge.mjs";export{Switch}from"./components/Switch.mjs";export{ActionBarTitle,Body1,Body2,Caption,H1,H2,H3,H4}from"./components/Typography.mjs";export{ActionBar}from"./components/ActionBar.mjs";export{AccordionGroup,AccordionGroupItem}from"./components/AccordionGroup.mjs";export{AccordionSingle}from"./components/AccordionSingle.mjs";export{AiButton}from"./components/AiButton.mjs";export{AiCard}from"./components/AiCard.mjs";export{AiGlassCard}from"./components/AiGlassCard.mjs";export{AiPaper}from"./components/AiPaper.mjs";export{AiGlassPaper}from"./components/AiGlassPaper.mjs";export{Box}from"./components/Box.mjs";export{Collapse}from"./components/Collapse.mjs";export{NexusDataGrid}from"./components/NexusDataGrid.mjs";export{ButtonBase}from"./components/ButtonBase.mjs";export{Card}from"./components/Card.mjs";export{CheckboxGroup}from"./components/CheckboxGroup.mjs";export{Chip}from"./components/Chip.mjs";export{Dialog,DialogActions,DialogContent,DialogContentText,DialogTitle}from"./components/Dialog.mjs";export{Divider}from"./components/Divider.mjs";export{GlassCard}from"./components/GlassCard.mjs";export{GlassPaper}from"./components/GlassPaper.mjs";export{GlassPaperAsync}from"./components/GlassPaperAsync.mjs";export{GreenWaveBackground}from"./components/GreenWaveBackground.mjs";export{IconButton}from"./components/IconButton.mjs";export{LoadingSpinnerNexus}from"./components/LoadingSpinnerNexus.mjs";export{LocationMultiSelect}from"./components/LocationMultiSelect.mjs";export{LogoOptions}from"./components/LogoOptions/index.mjs";export{NexusHome}from"./components/NexusHome.mjs";export{default as NexusLogo}from"./components/NexusLogo.mjs";export{Paper}from"./components/Paper.mjs";export{PrimaryButton}from"./components/PrimaryButton.mjs";export{PrimaryButtonLink}from"./components/PrimaryButtonLink.mjs";export{SecondaryButton}from"./components/SecondaryButton.mjs";export{RagDot}from"./components/RagDot.mjs";export{RagChip}from"./components/RagChip.mjs";export{SecondaryButtonLink}from"./components/SecondaryButtonLink.mjs";export{SearchInput}from"./components/SearchInput.mjs";export{SideBlade}from"./components/SideBlade.mjs";export{Skeleton}from"./components/Skeleton.mjs";export{SkillChip}from"./components/SkillChip.mjs";export{Stack}from"./components/Stack.mjs";export{StatusChip}from"./components/StatusChip.mjs";export{Tab}from"./components/Tab.mjs";export{Tabs}from"./components/Tabs.mjs";export{TextField}from"./components/TextField.mjs";export{ThemeToggle}from"./components/ThemeToggle.mjs";export{Tooltip}from"./components/Tooltip.mjs";export{default as nexusLogoNode}from"./assets/images/nexus-logo-node.svg.mjs";export{default as nexusLogoFavicon}from"./assets/images/nexus-logo-favicon.svg.mjs";export{default as nexusLogoIco}from"./assets/images/favicon.ico.mjs";export{getFaviconUrls}from"./assets/images/urls.mjs";export{FaviconLinks}from"./components/FaviconLinks.mjs";export{createSageTheme}from"./theme/sageTheme.mjs";export{colours,fontSageHeadline,fontSageText,fontSageUI,getModeTokens,gradients}from"./theme/tokens.mjs";export{useTokens}from"./theme/useTokens.mjs";export{default as MuiAppThemeProvider}from"./theme/MuiAppThemeProvider.mjs";export{ThemeModeProvider,useThemeMode}from"./theme/ThemeContext.mjs";export{AlertTitle,MenuItem,alpha,useMediaQuery,useTheme}from"@mui/material";export{expandableText,getGradientBorderStyles,leftPipe}from"./theme/sxHelpers.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sage-nexus-ui",
-  "version": "1.3.6",
+  "version": "1.4.0",
   "description": "Nexus core components",
   "license": "ISC",
   "author": "emsmart-sage",
@@ -23,6 +23,7 @@
   ],
   "sideEffects": false,
   "scripts": {
+    "prebuild": "node scripts/write-version.mjs",
     "build": "node -e \"require('fs').rmSync('dist', {recursive:true, force:true})\" && rollup -c",
     "build-storybook": "storybook build",
     "generate-favicon": "node scripts/generate-favicon.mjs",
@@ -54,6 +55,7 @@
     "@mui/material": "^9.0.1",
     "@mui/x-data-grid": "^9.0.0",
     "@rollup/plugin-alias": "^6.0.0",
+    "@rollup/plugin-json": "^5.0.0",
     "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-terser": "^1.0.0",

package/readme.md

@@ -1 +1,109 @@
 Small component library for personal use.
+
+## Favicon usage
+
+This package exports the favicon assets and a small helper to make adding
+favicon links in consuming apps trivial.
+
+Files available in package:
+
+- `nexus-logo-favicon.svg` — modern SVG favicon
+- `favicon.ico` — multi-size ICO (legacy support)
+
+Quick copy approach (recommended):
+
+1. Add and then run these asset copy scripts in the consuming project's package.json:
+
+```json
+"scripts": {
+	"copy-sage-assets": "cpx \"node_modules/sage-nexus-ui/dist/assets/images/*\" public/assets/sage-nexus-ui/",
+	"postinstall": "npm run copy-sage-assets"
+}
+```
+
+2. Add links in your HTML head:
+
+```html
+<link
+  rel="icon"
+  type="image/svg+xml"
+  href="/assets/sage-nexus-ui/nexus-logo-favicon.svg"
+/>
+<link rel="icon" href="/assets/sage-nexus-ui/favicon.ico" />
+```
+
+Or, use the React helper exported by this package:
+
+```tsx
+import { FaviconLinks } from "sage-nexus-ui";
+
+function AppHead() {
+  return <FaviconLinks />; // adds versioned SVG and ICO links
+}
+```
+
+### Next.js example
+
+If you use Next.js (Pages or App router), you can copy the built assets into your `public/` folder and render the helper component from the app head so the favicon is present on first render.
+
+1. Copy assets during install/build (example `package.json` scripts in the consuming app):
+
+```json
+"scripts": {
+  "copy-sage-assets": "cpx \"node_modules/sage-nexus-ui/dist/assets/images/*\" public/assets/sage-nexus-ui/",
+  "postinstall": "npm run copy-sage-assets"
+}
+```
+
+2. Pages router (`pages/_document.tsx`) example — server-side rendered so the links are available immediately:
+
+```tsx
+// pages/_document.tsx
+import Document, { Html, Head, Main, NextScript } from "next/document";
+import { FaviconLinks } from "sage-nexus-ui";
+
+class MyDocument extends Document {
+  render() {
+    return (
+      <Html>
+        <Head>
+          <FaviconLinks />
+        </Head>
+        <body>
+          <Main />
+          <NextScript />
+        </body>
+      </Html>
+    );
+  }
+}
+
+export default MyDocument;
+```
+
+3. App router (`app/layout.tsx`) example:
+
+```tsx
+// app/layout.tsx
+import { FaviconLinks } from "sage-nexus-ui";
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html>
+      <head>
+        <FaviconLinks />
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}
+```
+
+Notes:
+
+- Copying assets into `public/` ensures the files are served as static assets (no runtime JS required) and avoids a flash-of-default-favicon.
+- The `FaviconLinks` helper uses versioned URLs by default to help cache-busting when you publish a new library version.