@carto/ps-react-ui 4.4.1 → 4.4.2

package/dist/widgets/wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"wrapper.js","sources":["../../src/widgets/wrapper/styles.ts","../../src/widgets/wrapper/components/actions.tsx","../../src/widgets/wrapper/components/options.tsx","../../src/widgets/wrapper/components/title.tsx","../../src/widgets/wrapper/wrapper-ui.tsx","../../src/widgets/wrapper/wrapper.tsx"],"sourcesContent":["import type { SxProps, Theme } from '@mui/material'\n\nexport const styles = {\n  root: {\n    '.Mui-disabled .MuiAccordionSummary-expandIconWrapper': {\n      display: 'none',\n    },\n    '.widget-wrapper-actions > *': {\n      opacity: 1,\n      transition: ({ transitions }) =>\n        transitions.create('opacity', {\n          duration: transitions.duration.standard,\n          easing: transitions.easing.easeInOut,\n        }),\n\n      '@media (hover: hover)': {\n        opacity: 0,\n      },\n\n      '&:has(.active)': {\n        opacity: 1,\n      },\n    },\n    '&:hover': {\n      '& .widget-wrapper-actions > *': {\n        opacity: 1,\n      },\n    },\n\n    '&.collapsed .widget-wrapper-actions > *': {\n      opacity: 0,\n      pointerEvents: 'none',\n\n      '&:has(.active)': {\n        opacity: 1,\n      },\n    },\n  },\n  summary: {\n    minHeight: ({ spacing }) => spacing(7),\n    '& .MuiAccordionSummary-content': {\n      gap: ({ spacing }) => spacing(0.5),\n      paddingInlineEnd: ({ spacing }) => spacing(0.75),\n    },\n  },\n  loading: {\n    height: ({ spacing }) => spacing(0.35),\n    left: 0,\n    position: 'absolute',\n    top: 0,\n    width: '100%',\n    zIndex: 1,\n  },\n  title: {\n    wrapper: {\n      flexGrow: 1,\n      flexShrink: 1,\n      minWidth: 0,\n      display: 'flex',\n      justifyContent: 'center',\n      flexDirection: 'column',\n    },\n    container: {\n      display: 'flex',\n      alignItems: 'center',\n      flexGrow: 1,\n      minHeight: ({ spacing }) => spacing(3),\n    },\n    text: {\n      wordBreak: 'break-word',\n      overflow: 'hidden',\n      display: '-webkit-box',\n      WebkitLineClamp: 2,\n      WebkitBoxOrient: 'vertical',\n    },\n  },\n  actions: {\n    display: 'flex',\n    gap: ({ spacing }) => spacing(0.5),\n    alignItems: 'center',\n    flexShrink: 0,\n    justifyContent: 'flex-end',\n    '& > div': {\n      pointerEvents: 'auto',\n    },\n  },\n  options: {\n    trigger: {\n      pointerEvents: 'auto',\n    },\n  },\n  detail: {\n    display: 'flex',\n    flexDirection: 'column',\n    gap: ({ spacing }) => spacing(1),\n    paddingTop: ({ spacing }) => spacing(0.5),\n  },\n} satisfies Record<string, SxProps<Theme>>\n","import { Box } from '@mui/material'\nimport type { WrapperActionsProps } from '../types'\nimport { styles } from '../styles'\n\nconst EMPTY_ACTIONS: NonNullable<WrapperActionsProps['actions']> = []\n\nexport function Actions({ actions = EMPTY_ACTIONS }: WrapperActionsProps) {\n  return (\n    <Box sx={styles.actions} className='widget-wrapper-actions'>\n      {actions.map((action, index) => {\n        // Prefer action.key if present (React elements), else fallback to index\n        const key =\n          action &&\n          typeof action === 'object' &&\n          'key' in action &&\n          action.key != null\n            ? action.key\n            : index\n        return (\n          <Box\n            key={key}\n            onClick={(e) => {\n              e.stopPropagation()\n            }}\n          >\n            {action}\n          </Box>\n        )\n      })}\n    </Box>\n  )\n}\n","import { MoreVert } from '@mui/icons-material'\nimport {\n  IconButton,\n  Menu,\n  MenuItem,\n  ListItemIcon,\n  ListItemText,\n} from '@mui/material'\nimport type { WrapperOptionsProps } from '../types'\nimport { useState } from 'react'\nimport { styles } from '../styles'\n\nconst EMPTY_OPTIONS: NonNullable<WrapperOptionsProps['options']> = []\n\nexport function Options({\n  labels,\n  options = EMPTY_OPTIONS,\n}: WrapperOptionsProps) {\n  const [anchorEl, setAnchorEl] = useState<null | HTMLElement>(null)\n\n  const handleOptionAction = (\n    e: React.MouseEvent<HTMLElement>,\n    option: NonNullable<WrapperOptionsProps['options']>[number],\n  ) => {\n    e.stopPropagation()\n    option.onClick()\n    setAnchorEl(null)\n  }\n\n  return (\n    <>\n      <IconButton\n        sx={styles.options.trigger}\n        size='small'\n        aria-label={labels?.title ?? 'Options'}\n        aria-controls='options-menu'\n        aria-haspopup='true'\n        onClick={(e) => {\n          e.stopPropagation()\n          setAnchorEl(e.currentTarget)\n        }}\n      >\n        <MoreVert />\n      </IconButton>\n      <Menu\n        variant='menu'\n        elevation={8}\n        anchorOrigin={{\n          vertical: 'top',\n          horizontal: 'right',\n        }}\n        transformOrigin={{\n          vertical: 'top',\n          horizontal: 'right',\n        }}\n        anchorEl={anchorEl}\n        open={Boolean(anchorEl)}\n        onClose={() => setAnchorEl(null)}\n        MenuListProps={{\n          sx: {\n            paddingBottom: 0,\n          },\n        }}\n      >\n        {options.map((option) => (\n          <MenuItem\n            key={option.label}\n            disabled={option.disabled}\n            onClick={(e) => handleOptionAction(e, option)}\n          >\n            {option.icon && <ListItemIcon>{option.icon}</ListItemIcon>}\n            <ListItemText>{option.label}</ListItemText>\n          </MenuItem>\n        ))}\n      </Menu>\n    </>\n  )\n}\n","import { Box, Typography } from '@mui/material'\nimport { styles } from '../styles'\nimport { SmartTooltip } from '../../../components'\nimport type { ReactNode } from 'react'\nimport type { WrapperOptionsProps } from '../types'\n\nexport function Title({\n  label,\n  children,\n}: {\n  children: ReactNode\n  label?: NonNullable<WrapperOptionsProps['labels']>['title']\n}) {\n  return (\n    <SmartTooltip\n      title={label ?? (typeof children === 'string' ? children : '')}\n    >\n      {({ ref }) => (\n        <Box sx={styles.title.container}>\n          <Typography\n            sx={styles.title.text}\n            ref={ref}\n            variant='subtitle1'\n            textTransform='none'\n          >\n            {children}\n          </Typography>\n        </Box>\n      )}\n    </SmartTooltip>\n  )\n}\n","import {\n  Accordion,\n  AccordionDetails,\n  AccordionSummary,\n  LinearProgress,\n} from '@mui/material'\nimport { styles } from './styles'\nimport { Title } from './components/title'\nimport type { WrapperState, WrapperUIProps } from './types'\nimport { Options } from './components/options'\nimport { Actions } from './components/actions'\nimport { useWidgetStore } from '../stores/widget-store'\nimport { useShallow } from 'zustand/shallow'\n\nconst EMPTY_ACTIONS: NonNullable<WrapperUIProps['actions']> = []\nconst EMPTY_OPTIONS: NonNullable<WrapperUIProps['options']> = []\n\nexport function WrapperUI({\n  children,\n  id,\n  actions = EMPTY_ACTIONS,\n  sx,\n  labels,\n  options = EMPTY_OPTIONS,\n  onChangeCollapsed,\n}: WrapperUIProps) {\n  const title = useWidgetStore(\n    useShallow((state) => state.getWidget<WrapperState>(id)?.title),\n  )\n  const collapsed = useWidgetStore(\n    useShallow((state) => state.getWidget<WrapperState>(id)?.collapsed),\n  )\n  const disabled = useWidgetStore(\n    useShallow((state) => state.getWidget<WrapperState>(id)?.disabled),\n  )\n  const isFetching = useWidgetStore(\n    useShallow((state) => state.getWidget<WrapperState>(id)?.isFetching),\n  )\n\n  return (\n    <Accordion\n      className={collapsed ? 'collapsed' : ''}\n      sx={{ ...styles.root, ...sx }}\n      expanded={!collapsed}\n      onChange={onChangeCollapsed}\n      disabled={disabled}\n    >\n      <AccordionSummary sx={styles.summary}>\n        {isFetching && <LinearProgress sx={styles.loading} color='primary' />}\n        <Title>{title}</Title>\n        {!!actions.length && <Actions actions={actions} />}\n        {!!options.length && (\n          <Options labels={labels?.options} options={options} />\n        )}\n      </AccordionSummary>\n      <AccordionDetails sx={styles.detail}>{children}</AccordionDetails>\n    </Accordion>\n  )\n}\n","import type { WrapperProps, WrapperState } from './types'\nimport { WrapperUI } from './wrapper-ui'\nimport { useWidgetStore } from '../stores/widget-store'\nimport { useLayoutEffect } from 'react'\n\nexport function WidgetWrapper({\n  id,\n  title,\n  defaultCollapsed,\n  disabled,\n  sx,\n  actions,\n  options,\n  labels,\n  children,\n  onChangeCollapsed,\n}: WrapperProps) {\n  const setWidget = useWidgetStore((state) => state.setWidget)\n\n  useLayoutEffect(() => {\n    setWidget<WrapperState>(id, {\n      collapsed: defaultCollapsed,\n      disabled,\n      title,\n    })\n  }, [defaultCollapsed, disabled, title, id, setWidget])\n\n  const handleChangeCollapsed = (\n    event: React.SyntheticEvent<Element, Event>,\n    expanded: boolean,\n  ) => {\n    onChangeCollapsed?.(event, expanded)\n    setWidget<WrapperState>(id, { collapsed: !expanded })\n  }\n\n  return (\n    <WrapperUI\n      id={id}\n      labels={labels}\n      actions={actions}\n      options={options}\n      sx={sx}\n      onChangeCollapsed={handleChangeCollapsed}\n    >\n      {children}\n    </WrapperUI>\n  )\n}\n"],"names":["styles","root","display","opacity","transition","transitions","create","duration","standard","easing","easeInOut","pointerEvents","summary","minHeight","spacing","gap","paddingInlineEnd","loading","height","left","position","top","width","zIndex","title","container","alignItems","flexGrow","text","wordBreak","overflow","WebkitLineClamp","WebkitBoxOrient","actions","flexShrink","justifyContent","options","trigger","detail","flexDirection","paddingTop","EMPTY_ACTIONS","Actions","t0","$","_c","t1","undefined","t2","map","_temp2","t3","Box","action","index","key","jsx","_temp","e","stopPropagation","EMPTY_OPTIONS","Options","labels","anchorEl","setAnchorEl","useState","Symbol","for","option","onClick","handleOptionAction","t4","t5","e_0","currentTarget","MoreVert","t6","IconButton","t7","t8","vertical","horizontal","t9","Boolean","t10","t11","sx","paddingBottom","t12","t13","option_0","jsxs","MenuItem","disabled","e_1","icon","ListItemIcon","ListItemText","label","Menu","t14","Title","children","ref","Typography","SmartTooltip","WrapperUI","id","onChangeCollapsed","state","getWidget","useWidgetStore","useShallow","state_0","collapsed","state_1","state_2","isFetching","LinearProgress","length","AccordionSummary","t15","AccordionDetails","t16","Accordion","WidgetWrapper","defaultCollapsed","setWidget","useLayoutEffect","event","expanded","handleChangeCollapsed"],"mappings":";;;;;;;;;;AAEO,MAAMA,IAAS;AAAA,EACpBC,MAAM;AAAA,IACJ,wDAAwD;AAAA,MACtDC,SAAS;AAAA,IAAA;AAAA,IAEX,+BAA+B;AAAA,MAC7BC,SAAS;AAAA,MACTC,YAAYA,CAAC;AAAA,QAAEC,aAAAA;AAAAA,MAAAA,MACbA,EAAYC,OAAO,WAAW;AAAA,QAC5BC,UAAUF,EAAYE,SAASC;AAAAA,QAC/BC,QAAQJ,EAAYI,OAAOC;AAAAA,MAAAA,CAC5B;AAAA,MAEH,yBAAyB;AAAA,QACvBP,SAAS;AAAA,MAAA;AAAA,MAGX,kBAAkB;AAAA,QAChBA,SAAS;AAAA,MAAA;AAAA,IACX;AAAA,IAEF,WAAW;AAAA,MACT,iCAAiC;AAAA,QAC/BA,SAAS;AAAA,MAAA;AAAA,IACX;AAAA,IAGF,2CAA2C;AAAA,MACzCA,SAAS;AAAA,MACTQ,eAAe;AAAA,MAEf,kBAAkB;AAAA,QAChBR,SAAS;AAAA,MAAA;AAAA,IACX;AAAA,EACF;AAAA,EAEFS,SAAS;AAAA,IACPC,WAAWA,CAAC;AAAA,MAAEC,SAAAA;AAAAA,IAAAA,MAAcA,EAAQ,CAAC;AAAA,IACrC,kCAAkC;AAAA,MAChCC,KAAKA,CAAC;AAAA,QAAED,SAAAA;AAAAA,MAAAA,MAAcA,EAAQ,GAAG;AAAA,MACjCE,kBAAkBA,CAAC;AAAA,QAAEF,SAAAA;AAAAA,MAAAA,MAAcA,EAAQ,IAAI;AAAA,IAAA;AAAA,EACjD;AAAA,EAEFG,SAAS;AAAA,IACPC,QAAQA,CAAC;AAAA,MAAEJ,SAAAA;AAAAA,IAAAA,MAAcA,EAAQ,IAAI;AAAA,IACrCK,MAAM;AAAA,IACNC,UAAU;AAAA,IACVC,KAAK;AAAA,IACLC,OAAO;AAAA,IACPC,QAAQ;AAAA,EAAA;AAAA,EAEVC,OAAO;AAAA,IASLC,WAAW;AAAA,MACTvB,SAAS;AAAA,MACTwB,YAAY;AAAA,MACZC,UAAU;AAAA,MACVd,WAAWA,CAAC;AAAA,QAAEC,SAAAA;AAAAA,MAAAA,MAAcA,EAAQ,CAAC;AAAA,IAAA;AAAA,IAEvCc,MAAM;AAAA,MACJC,WAAW;AAAA,MACXC,UAAU;AAAA,MACV5B,SAAS;AAAA,MACT6B,iBAAiB;AAAA,MACjBC,iBAAiB;AAAA,IAAA;AAAA,EACnB;AAAA,EAEFC,SAAS;AAAA,IACP/B,SAAS;AAAA,IACTa,KAAKA,CAAC;AAAA,MAAED,SAAAA;AAAAA,IAAAA,MAAcA,EAAQ,GAAG;AAAA,IACjCY,YAAY;AAAA,IACZQ,YAAY;AAAA,IACZC,gBAAgB;AAAA,IAChB,WAAW;AAAA,MACTxB,eAAe;AAAA,IAAA;AAAA,EACjB;AAAA,EAEFyB,SAAS;AAAA,IACPC,SAAS;AAAA,MACP1B,eAAe;AAAA,IAAA;AAAA,EACjB;AAAA,EAEF2B,QAAQ;AAAA,IACNpC,SAAS;AAAA,IACTqC,eAAe;AAAA,IACfxB,KAAKA,CAAC;AAAA,MAAED,SAAAA;AAAAA,IAAAA,MAAcA,EAAQ,CAAC;AAAA,IAC/B0B,YAAYA,CAAC;AAAA,MAAE1B,SAAAA;AAAAA,IAAAA,MAAcA,EAAQ,GAAG;AAAA,EAAA;AAE5C,GC7FM2B,IAA6D,CAAA;AAE5D,SAAAC,EAAAC,GAAA;AAAA,QAAAC,IAAAC,EAAA,CAAA,GAAiB;AAAA,IAAAZ,SAAAa;AAAAA,EAAAA,IAAAH,GAAEV,IAAAa,MAAAC,SAAAN,IAAAK;AAAuB,MAAAE;AAAA,EAAAJ,SAAAX,KAG1Ce,IAAAf,EAAOgB,IAAKC,EAmBZ,GAACN,OAAAX,GAAAW,OAAAI,KAAAA,IAAAJ,EAAA,CAAA;AAAA,MAAAO;AAAA,SAAAP,SAAAI,KApBJG,sBAACC,GAAA,EAAQ,IAAApD,EAAMiC,SAAoB,WAAA,0BAChCe,UAAAA,EAAAA,CAoBH,GAAMJ,OAAAI,GAAAJ,OAAAO,KAAAA,IAAAP,EAAA,CAAA,GArBNO;AAqBM;AAvBH,SAAAD,GAAAG,GAAAC,GAAA;AAKC,QAAAC,IACEF,KACA,OAAOA,KAAW,YAClB,SAASA,KACTA,EAAME,OAAQ,OACVF,EAAME,MAJVD;AAKS,SAET,gBAAAE,EAACJ,GAAA,EAEU,SAAAK,mBADJF,CAMP;AAAM;AApBT,SAAAE,GAAAC,GAAA;AAgBOA,EAAAA,EAACC,gBAAAA;AAAkB;ACVjC,MAAMC,KAA6D,CAAA;AAE5D,SAAAC,GAAAlB,GAAA;AAAA,QAAAC,IAAAC,EAAA,EAAA,GAAiB;AAAA,IAAAiB,QAAAA;AAAAA,IAAA1B,SAAAU;AAAAA,EAAAA,IAAAH,GAEtBP,IAAAU,MAAAC,SAAAa,KAAAd,GAEA,CAAAiB,GAAAC,CAAA,IAAgCC,EAA6B,IAAI;AAAC,MAAAjB;AAAA,EAAAJ,EAAA,CAAA,MAAAsB,uBAAAC,IAAA,2BAAA,KAEvCnB,IAAAA,CAAAU,GAAAU,MAAA;AAIzBV,IAAAA,EAACC,gBAAAA,GACDS,EAAMC,QAAAA,GACNL,EAAY,IAAI;AAAA,EAAC,GAClBpB,OAAAI,KAAAA,IAAAJ,EAAA,CAAA;AAPD,QAAA0B,IAA2BtB,GAcTG,IAAAW,GAAMtC,SAAN;AAA0B,MAAA+C,GAAAC;AAAA,EAAA5B,EAAA,CAAA,MAAAsB,uBAAAC,IAAA,2BAAA,KAG7BI,IAAAE,CAAAA,MAAA;AACPf,IAAAA,EAACC,gBAAAA,GACDK,EAAYN,EAACgB,aAAc;AAAA,EAAC,GAG9BF,sBAACG,GAAA,EAAQ,GAAG/B,OAAA2B,GAAA3B,OAAA4B,MAAAD,IAAA3B,EAAA,CAAA,GAAA4B,IAAA5B,EAAA,CAAA;AAAA,MAAAgC;AAAA,EAAAhC,SAAAO,KAXdyB,sBAACC,GAAA,EACK,IAAA7E,EAAMoC,QAAQC,SACb,MAAA,SACO,cAAAc,GACE,iBAAA,gBACA,iBAAA,QACL,SAAAoB,GAKTC,UAAAA,GACF,GAAa5B,OAAAO,GAAAP,OAAAgC,KAAAA,IAAAhC,EAAA,CAAA;AAAA,MAAAkC,GAAAC;AAAA,EAAAnC,EAAA,CAAA,MAAAsB,uBAAAC,IAAA,2BAAA,KAIGW,IAAA;AAAA,IAAAE,UACF;AAAA,IAAKC,YACH;AAAA,EAAA,GAEGF,IAAA;AAAA,IAAAC,UACL;AAAA,IAAKC,YACH;AAAA,EAAA,GACbrC,OAAAkC,GAAAlC,OAAAmC,MAAAD,IAAAlC,EAAA,CAAA,GAAAmC,IAAAnC,EAAA,CAAA;AAEK,QAAAsC,IAAAC,EAAQpB;AAAS,MAAAqB,GAAAC;AAAA,EAAAzC,EAAA,CAAA,MAAAsB,uBAAAC,IAAA,2BAAA,KACdiB,IAAAA,MAAMpB,EAAY,IAAI,GAChBqB,IAAA;AAAA,IAAAC,IACT;AAAA,MAAAC,eACa;AAAA,IAAA;AAAA,EACjB,GACD3C,OAAAwC,GAAAxC,OAAAyC,MAAAD,IAAAxC,EAAA,CAAA,GAAAyC,IAAAzC,EAAA,CAAA;AAAA,MAAA4C;AAAA,MAAA5C,SAAAR,GAAA;AAAA,QAAAqD;AAAA,IAAA7C,EAAA,EAAA,MAAAsB,uBAAAC,IAAA,2BAAA,KAEYsB,IAAAC,CAAAA,MACX,gBAAAC,EAACC,GAAA,EAEW,UAAAxB,EAAMyB,UACP,SAAAC,CAAAA,MAAOxB,EAAmBZ,GAAGU,CAAM,GAE3CA,UAAAA;AAAAA,MAAAA,EAAM2B,QAAS,gBAAAvC,EAACwC,GAAA,EAAc5B,UAAAA,EAAM2B,MAAM;AAAA,MAC3C,gBAAAvC,EAACyC,GAAA,EAAc7B,UAAAA,EAAM8B,MAAAA,CAAO;AAAA,IAAA,EAAA,GALvB9B,EAAM8B,KAMb,GACDtD,QAAA6C,KAAAA,IAAA7C,EAAA,EAAA,GATA4C,IAAApD,EAAOa,IAAKwC,CASZ,GAAC7C,OAAAR,GAAAQ,QAAA4C;AAAAA,EAAA;AAAAA,IAAAA,IAAA5C,EAAA,EAAA;AAAA,MAAA6C;AAAA,EAAA7C,EAAA,EAAA,MAAAmB,KAAAnB,UAAA4C,KAAA5C,EAAA,EAAA,MAAAsC,KA7BJO,sBAACU,GAAA,EACS,SAAA,QACG,WAAA,GACG,cAAArB,GAIG,iBAAAC,GAIPhB,UAAAA,GACJ,MAAAmB,GACG,SAAAE,GACM,eAAAC,GAMdG,UAAAA,GAUH,GAAO5C,QAAAmB,GAAAnB,QAAA4C,GAAA5C,QAAAsC,GAAAtC,QAAA6C,KAAAA,IAAA7C,EAAA,EAAA;AAAA,MAAAwD;AAAA,SAAAxD,EAAA,EAAA,MAAA6C,KAAA7C,UAAAgC,KA5CTwB,2BACExB,UAAAA;AAAAA,IAAAA;AAAAA,IAaAa;AAAAA,EAAAA,GA8BO,GACN7C,QAAA6C,GAAA7C,QAAAgC,GAAAhC,QAAAwD,KAAAA,IAAAxD,EAAA,EAAA,GA7CHwD;AA6CG;ACrEA,SAAAC,GAAA1D,GAAA;AAAA,QAAAC,IAAAC,EAAA,CAAA,GAAe;AAAA,IAAAqD,OAAAA;AAAAA,IAAAI,UAAAA;AAAAA,EAAAA,IAAA3D,GASTG,IAAAoD,MAAU,OAAOI,KAAa,WAApBA,IAAA;AAA6C,MAAAtD;AAAA,EAAAJ,SAAA0D,KAE7DtD,IAAAG,CAAAA,MAAA;AAAC,UAAA;AAAA,MAAAoD,KAAAA;AAAAA,IAAAA,IAAApD;AAAO,6BACNC,GAAA,EAAQ,IAAApD,EAAMwB,MAAMC,WACnB,4BAAC+E,GAAA,EACK,IAAAxG,EAAMwB,MAAMI,MACX2E,KAAAA,GACG,SAAA,aACM,eAAA,QAEbD,UAAAA,GACH,GACF;AAAA,EAAM,GACP1D,OAAA0D,GAAA1D,OAAAI,KAAAA,IAAAJ,EAAA,CAAA;AAAA,MAAAO;AAAA,SAAAP,EAAA,CAAA,MAAAE,KAAAF,SAAAI,KAdHG,IAAA,gBAAAK,EAACiD,GAAA,EACQ,OAAA3D,GAENE,UAAAA,GAYH,GAAeJ,OAAAE,GAAAF,OAAAI,GAAAJ,OAAAO,KAAAA,IAAAP,EAAA,CAAA,GAffO;AAee;ACfnB,MAAMV,KAAwD,CAAA,GACxDmB,KAAwD,CAAA;AAEvD,SAAA8C,GAAA/D,GAAA;AAAA,QAAAC,IAAAC,EAAA,EAAA,GAAmB;AAAA,IAAAyD,UAAAA;AAAAA,IAAAK,IAAAA;AAAAA,IAAA1E,SAAAa;AAAAA,IAAAwC,IAAAA;AAAAA,IAAAxB,QAAAA;AAAAA,IAAA1B,SAAAY;AAAAA,IAAA4D,mBAAAA;AAAAA,EAAAA,IAAAjE,GAGxBV,IAAAa,MAAAC,SAAAN,KAAAK,GAGAV,IAAAY,MAAAD,SAAAa,KAAAZ;AAAuB,MAAAG;AAAA,EAAAP,SAAA+D,KAIVxD,IAAA0D,CAAAA,MAAWA,EAAKC,UAAyBH,CAAS,GAACnF,OAAAoB,OAAA+D,GAAA/D,OAAAO,KAAAA,IAAAP,EAAA,CAAA;AADhE,QAAApB,IAAcuF,EACZC,EAAW7D,CAAmD,CAChE;AAAC,MAAAoB;AAAA,EAAA3B,SAAA+D,KAEYpC,IAAA0C,CAAAA,MAAWJ,EAAKC,UAAyBH,CAAa,GAACO,WAAAtE,OAAA+D,GAAA/D,OAAA2B,KAAAA,IAAA3B,EAAA,CAAA;AADpE,QAAAsE,IAAkBH,EAChBC,EAAWzC,CAAuD,CACpE;AAAC,MAAAC;AAAA,EAAA5B,SAAA+D,KAEYnC,IAAA2C,CAAAA,MAAWN,EAAKC,UAAyBH,CAAY,GAACd,UAAAjD,OAAA+D,GAAA/D,OAAA4B,KAAAA,IAAA5B,EAAA,CAAA;AADnE,QAAAiD,IAAiBkB,EACfC,EAAWxC,CAAsD,CACnE;AAAC,MAAAI;AAAA,EAAAhC,SAAA+D,KAEY/B,IAAAwC,CAAAA,MAAWP,EAAKC,UAAyBH,CAAc,GAACU,YAAAzE,OAAA+D,GAAA/D,OAAAgC,KAAAA,IAAAhC,EAAA,CAAA;AADrE,QAAAyE,IAAmBN,EACjBC,EAAWpC,CAAwD,CACrE,GAIeE,IAAAoC,IAAA,cAAA;AAA4B,MAAAnC;AAAA,EAAAnC,SAAA0C,KACnCP,IAAA;AAAA,IAAA,GAAK/E,EAAMC;AAAAA,IAAK,GAAKqF;AAAAA,EAAAA,GAAI1C,OAAA0C,GAAA1C,OAAAmC,KAAAA,IAAAnC,EAAA,CAAA;AACnB,QAAAsC,KAACgC;AAAS,MAAA9B;AAAA,EAAAxC,UAAAyE,KAKjBjC,IAAAiC,KAAc,gBAAA7D,EAAC8D,GAAA,EAAmB,IAAAtH,EAAMiB,SAAgB,OAAA,WAAS,GAAG2B,QAAAyE,GAAAzE,QAAAwC,KAAAA,IAAAxC,EAAA,EAAA;AAAA,MAAAyC;AAAA,EAAAzC,UAAApB,KACrE6D,sBAACgB,mBAAa,GAAQzD,QAAApB,GAAAoB,QAAAyC,KAAAA,IAAAzC,EAAA,EAAA;AAAA,MAAA4C;AAAA,EAAA5C,UAAAX,KACrBuD,IAAA,CAAC,CAACvD,EAAOsF,UAAW,gBAAA/D,EAACd,KAAiBT,SAAAA,GAAO,GAAIW,QAAAX,GAAAW,QAAA4C,KAAAA,IAAA5C,EAAA,EAAA;AAAA,MAAA6C;AAAA,EAAA7C,UAAAkB,GAAA1B,WAAAQ,UAAAR,KACjDqD,IAAA,CAAC,CAACrD,EAAOmF,4BACP1D,IAAA,EAAgB,QAAAC,GAAM1B,SAAoBA,SAAAA,EAAAA,CAAO,GACnDQ,EAAA,EAAA,IAAAkB,GAAA1B,SAAAQ,QAAAR,GAAAQ,QAAA6C,KAAAA,IAAA7C,EAAA,EAAA;AAAA,MAAAwD;AAAA,EAAAxD,EAAA,EAAA,MAAAwC,KAAAxC,EAAA,EAAA,MAAAyC,KAAAzC,EAAA,EAAA,MAAA4C,KAAA5C,UAAA6C,KANHW,IAAA,gBAAAT,EAAC6B,GAAA,EAAqB,IAAAxH,EAAMY,SACzBwE,UAAAA;AAAAA,IAAAA;AAAAA,IACDC;AAAAA,IACCG;AAAAA,IACAC;AAAAA,EAAAA,GAGH,GAAmB7C,QAAAwC,GAAAxC,QAAAyC,GAAAzC,QAAA4C,GAAA5C,QAAA6C,GAAA7C,QAAAwD,KAAAA,IAAAxD,EAAA,EAAA;AAAA,MAAA6E;AAAA,EAAA7E,UAAA0D,KACnBmB,IAAA,gBAAAjE,EAACkE,GAAA,EAAqB,IAAA1H,EAAMsC,QAAUgE,UAAAA,GAAS,GAAmB1D,QAAA0D,GAAA1D,QAAA6E,KAAAA,IAAA7E,EAAA,EAAA;AAAA,MAAA+E;AAAA,SAAA/E,EAAA,EAAA,MAAAiD,KAAAjD,EAAA,EAAA,MAAAgE,KAAAhE,EAAA,EAAA,MAAAwD,KAAAxD,UAAA6E,KAAA7E,EAAA,EAAA,MAAAkC,KAAAlC,EAAA,EAAA,MAAAmC,KAAAnC,EAAA,EAAA,MAAAsC,KAfpEyC,sBAACC,GAAA,EACY,WAAA9C,GACP,IAAAC,GACM,UAAAG,GACA0B,UAAAA,GACAf,UAAAA,GAEVO,UAAAA;AAAAA,IAAAA;AAAAA,IAQAqB;AAAAA,EAAAA,GACF,GAAY7E,QAAAiD,GAAAjD,QAAAgE,GAAAhE,QAAAwD,GAAAxD,QAAA6E,GAAA7E,QAAAkC,GAAAlC,QAAAmC,GAAAnC,QAAAsC,GAAAtC,QAAA+E,KAAAA,IAAA/E,EAAA,EAAA,GAhBZ+E;AAgBY;ACnDT,SAAAE,GAAAlF,GAAA;AAAA,QAAAC,IAAAC,EAAA,EAAA,GAAuB;AAAA,IAAA8D,IAAAA;AAAAA,IAAAnF,OAAAA;AAAAA,IAAAsG,kBAAAA;AAAAA,IAAAjC,UAAAA;AAAAA,IAAAP,IAAAA;AAAAA,IAAArD,SAAAA;AAAAA,IAAAG,SAAAA;AAAAA,IAAA0B,QAAAA;AAAAA,IAAAwC,UAAAA;AAAAA,IAAAM,mBAAAA;AAAAA,EAAAA,IAAAjE,GAY5BoF,IAAkBhB,EAAetD,EAA0B;AAAC,MAAAX,GAAAE;AAAA,EAAAJ,EAAA,CAAA,MAAAkF,KAAAlF,EAAA,CAAA,MAAAiD,KAAAjD,EAAA,CAAA,MAAA+D,KAAA/D,EAAA,CAAA,MAAAmF,KAAAnF,SAAApB,KAE5CsB,IAAAA,MAAA;AACdiF,IAAAA,EAAwBpB,GAAI;AAAA,MAAAO,WACfY;AAAAA,MAAgBjC,UAAAA;AAAAA,MAAArE,OAAAA;AAAAA,IAAAA,CAG5B;AAAA,EAAC,GACDwB,IAAA,CAAC8E,GAAkBjC,GAAUrE,GAAOmF,GAAIoB,CAAS,GAACnF,OAAAkF,GAAAlF,OAAAiD,GAAAjD,OAAA+D,GAAA/D,OAAAmF,GAAAnF,OAAApB,GAAAoB,OAAAE,GAAAF,OAAAI,MAAAF,IAAAF,EAAA,CAAA,GAAAI,IAAAJ,EAAA,CAAA,IANrDoF,EAAgBlF,GAMbE,CAAkD;AAAC,MAAAG;AAAA,EAAAP,EAAA,CAAA,MAAA+D,KAAA/D,SAAAgE,KAAAhE,EAAA,CAAA,MAAAmF,KAExB5E,IAAAA,CAAA8E,GAAAC,MAAA;AAI5BtB,IAAAA,IAAoBqB,GAAOC,CAAQ,GACnCH,EAAwBpB,GAAI;AAAA,MAAAO,WAAa,CAACgB;AAAAA,IAAAA,CAAU;AAAA,EAAC,GACtDtF,OAAA+D,GAAA/D,OAAAgE,GAAAhE,OAAAmF,GAAAnF,QAAAO,KAAAA,IAAAP,EAAA,EAAA;AAND,QAAAuF,IAA8BhF;AAM7B,MAAAoB;AAAA,SAAA3B,EAAA,EAAA,MAAAX,KAAAW,EAAA,EAAA,MAAA0D,KAAA1D,EAAA,EAAA,MAAAuF,KAAAvF,UAAA+D,KAAA/D,EAAA,EAAA,MAAAkB,KAAAlB,EAAA,EAAA,MAAAR,KAAAQ,EAAA,EAAA,MAAA0C,KAGCf,sBAACmC,MACKC,IAAAA,GACI7C,QAAAA,GACC7B,SAAAA,GACAG,SAAAA,GACLkD,IAAAA,GACe6C,mCAGrB,GAAYvF,QAAAX,GAAAW,QAAA0D,GAAA1D,QAAAuF,GAAAvF,QAAA+D,GAAA/D,QAAAkB,GAAAlB,QAAAR,GAAAQ,QAAA0C,GAAA1C,QAAA2B,KAAAA,IAAA3B,EAAA,EAAA,GATZ2B;AASY;AAxCT,SAAAd,GAAAoD,GAAA;AAAA,SAYuCA,EAAKkB;AAAU;"}
+{"version":3,"file":"wrapper.js","sources":["../../src/widgets/wrapper/styles.ts","../../src/widgets/wrapper/components/actions.tsx","../../src/widgets/wrapper/components/options.tsx","../../src/widgets/wrapper/components/title.tsx","../../src/widgets/wrapper/wrapper-ui.tsx","../../src/widgets/wrapper/wrapper.tsx"],"sourcesContent":["import type { SxProps, Theme } from '@mui/material'\n\nexport const styles = {\n  root: {\n    '.Mui-disabled .MuiAccordionSummary-expandIconWrapper': {\n      display: 'none',\n    },\n    '.widget-wrapper-actions > *': {\n      opacity: 1,\n      transition: ({ transitions }) =>\n        transitions.create('opacity', {\n          duration: transitions.duration.standard,\n          easing: transitions.easing.easeInOut,\n        }),\n\n      '@media (hover: hover)': {\n        opacity: 0,\n      },\n\n      '&:has(.active)': {\n        opacity: 1,\n      },\n    },\n    '&:hover': {\n      '& .widget-wrapper-actions > *': {\n        opacity: 1,\n      },\n    },\n\n    '&.collapsed .widget-wrapper-actions > *': {\n      opacity: 0,\n      pointerEvents: 'none',\n\n      '&:has(.active)': {\n        opacity: 1,\n      },\n    },\n  },\n  summary: {\n    minHeight: ({ spacing }) => spacing(7),\n    '& .MuiAccordionSummary-content': {\n      gap: ({ spacing }) => spacing(0.5),\n      paddingInlineEnd: ({ spacing }) => spacing(0.75),\n    },\n  },\n  loading: {\n    height: ({ spacing }) => spacing(0.35),\n    left: 0,\n    position: 'absolute',\n    top: 0,\n    width: '100%',\n    zIndex: 1,\n  },\n  title: {\n    wrapper: {\n      flexGrow: 1,\n      flexShrink: 1,\n      minWidth: 0,\n      display: 'flex',\n      justifyContent: 'center',\n      flexDirection: 'column',\n    },\n    container: {\n      display: 'flex',\n      alignItems: 'center',\n      flexGrow: 1,\n      minHeight: ({ spacing }) => spacing(3),\n    },\n    text: {\n      wordBreak: 'break-word',\n      overflow: 'hidden',\n      display: '-webkit-box',\n      WebkitLineClamp: 2,\n      WebkitBoxOrient: 'vertical',\n    },\n  },\n  actions: {\n    display: 'flex',\n    gap: ({ spacing }) => spacing(0.5),\n    alignItems: 'center',\n    flexShrink: 0,\n    justifyContent: 'flex-end',\n    '& > div': {\n      pointerEvents: 'auto',\n    },\n  },\n  options: {\n    trigger: {\n      pointerEvents: 'auto',\n    },\n  },\n  detail: {\n    display: 'flex',\n    flexDirection: 'column',\n    gap: ({ spacing }) => spacing(1),\n    paddingTop: ({ spacing }) => spacing(0.5),\n  },\n} satisfies Record<string, SxProps<Theme>>\n","import { Box } from '@mui/material'\nimport type { WrapperActionsProps } from '../types'\nimport { styles } from '../styles'\n\nconst EMPTY_ACTIONS: NonNullable<WrapperActionsProps['actions']> = []\n\n/**\n * Renders action buttons in the widget wrapper header. Each action click event is stopped from propagating to the accordion.\n */\nexport function Actions({ actions = EMPTY_ACTIONS }: WrapperActionsProps) {\n  return (\n    <Box sx={styles.actions} className='widget-wrapper-actions'>\n      {actions.map((action, index) => {\n        // Prefer action.key if present (React elements), else fallback to index\n        const key =\n          action &&\n          typeof action === 'object' &&\n          'key' in action &&\n          action.key != null\n            ? action.key\n            : index\n        return (\n          <Box\n            key={key}\n            onClick={(e) => {\n              e.stopPropagation()\n            }}\n          >\n            {action}\n          </Box>\n        )\n      })}\n    </Box>\n  )\n}\n","import { MoreVert } from '@mui/icons-material'\nimport {\n  IconButton,\n  Menu,\n  MenuItem,\n  ListItemIcon,\n  ListItemText,\n} from '@mui/material'\nimport type { WrapperOptionsProps } from '../types'\nimport { useState } from 'react'\nimport { styles } from '../styles'\n\nconst EMPTY_OPTIONS: NonNullable<WrapperOptionsProps['options']> = []\n\n/**\n * Renders a dropdown options menu in the widget wrapper header, triggered by a vertical ellipsis icon button.\n */\nexport function Options({\n  labels,\n  options = EMPTY_OPTIONS,\n}: WrapperOptionsProps) {\n  const [anchorEl, setAnchorEl] = useState<null | HTMLElement>(null)\n\n  const handleOptionAction = (\n    e: React.MouseEvent<HTMLElement>,\n    option: NonNullable<WrapperOptionsProps['options']>[number],\n  ) => {\n    e.stopPropagation()\n    option.onClick()\n    setAnchorEl(null)\n  }\n\n  return (\n    <>\n      <IconButton\n        sx={styles.options.trigger}\n        size='small'\n        aria-label={labels?.title ?? 'Options'}\n        aria-controls='options-menu'\n        aria-haspopup='true'\n        onClick={(e) => {\n          e.stopPropagation()\n          setAnchorEl(e.currentTarget)\n        }}\n      >\n        <MoreVert />\n      </IconButton>\n      <Menu\n        variant='menu'\n        elevation={8}\n        anchorOrigin={{\n          vertical: 'top',\n          horizontal: 'right',\n        }}\n        transformOrigin={{\n          vertical: 'top',\n          horizontal: 'right',\n        }}\n        anchorEl={anchorEl}\n        open={Boolean(anchorEl)}\n        onClose={() => setAnchorEl(null)}\n        MenuListProps={{\n          sx: {\n            paddingBottom: 0,\n          },\n        }}\n      >\n        {options.map((option) => (\n          <MenuItem\n            key={option.label}\n            disabled={option.disabled}\n            onClick={(e) => handleOptionAction(e, option)}\n          >\n            {option.icon && <ListItemIcon>{option.icon}</ListItemIcon>}\n            <ListItemText>{option.label}</ListItemText>\n          </MenuItem>\n        ))}\n      </Menu>\n    </>\n  )\n}\n","import { Box, Typography } from '@mui/material'\nimport { styles } from '../styles'\nimport { SmartTooltip } from '../../../components'\nimport type { ReactNode } from 'react'\nimport type { WrapperOptionsProps } from '../types'\n\n/**\n * Renders the widget title text inside the wrapper header with smart tooltip support for truncated titles.\n */\nexport function Title({\n  label,\n  children,\n}: {\n  children: ReactNode\n  label?: NonNullable<WrapperOptionsProps['labels']>['title']\n}) {\n  return (\n    <SmartTooltip\n      title={label ?? (typeof children === 'string' ? children : '')}\n    >\n      {({ ref }) => (\n        <Box sx={styles.title.container}>\n          <Typography\n            sx={styles.title.text}\n            ref={ref}\n            variant='subtitle1'\n            textTransform='none'\n          >\n            {children}\n          </Typography>\n        </Box>\n      )}\n    </SmartTooltip>\n  )\n}\n","import {\n  Accordion,\n  AccordionDetails,\n  AccordionSummary,\n  LinearProgress,\n} from '@mui/material'\nimport { styles } from './styles'\nimport { Title } from './components/title'\nimport type { WrapperState, WrapperUIProps } from './types'\nimport { Options } from './components/options'\nimport { Actions } from './components/actions'\nimport { useWidgetStore } from '../stores/widget-store'\nimport { useShallow } from 'zustand/shallow'\n\nconst EMPTY_ACTIONS: NonNullable<WrapperUIProps['actions']> = []\nconst EMPTY_OPTIONS: NonNullable<WrapperUIProps['options']> = []\n\n/**\n * Presentational wrapper component that renders the widget accordion UI with title, actions, options menu, and loading indicator. For uncontrolled usage without automatic widget store synchronization, use this instead of WidgetWrapper.\n *\n * @example\n * ```tsx\n * <WrapperUI\n *   id=\"my-widget\"\n *   actions={[<Download key=\"download\" id=\"my-widget\" />]}\n *   onChangeCollapsed={(e, collapsed) => console.log(collapsed)}\n * >\n *   <div>Content</div>\n * </WrapperUI>\n * ```\n */\nexport function WrapperUI({\n  children,\n  id,\n  actions = EMPTY_ACTIONS,\n  sx,\n  labels,\n  options = EMPTY_OPTIONS,\n  onChangeCollapsed,\n}: WrapperUIProps) {\n  const title = useWidgetStore(\n    useShallow((state) => state.getWidget<WrapperState>(id)?.title),\n  )\n  const collapsed = useWidgetStore(\n    useShallow((state) => state.getWidget<WrapperState>(id)?.collapsed),\n  )\n  const disabled = useWidgetStore(\n    useShallow((state) => state.getWidget<WrapperState>(id)?.disabled),\n  )\n  const isFetching = useWidgetStore(\n    useShallow((state) => state.getWidget<WrapperState>(id)?.isFetching),\n  )\n\n  return (\n    <Accordion\n      className={collapsed ? 'collapsed' : ''}\n      sx={{ ...styles.root, ...sx }}\n      expanded={!collapsed}\n      onChange={onChangeCollapsed}\n      disabled={disabled}\n    >\n      <AccordionSummary sx={styles.summary}>\n        {isFetching && <LinearProgress sx={styles.loading} color='primary' />}\n        <Title>{title}</Title>\n        {!!actions.length && <Actions actions={actions} />}\n        {!!options.length && (\n          <Options labels={labels?.options} options={options} />\n        )}\n      </AccordionSummary>\n      <AccordionDetails sx={styles.detail}>{children}</AccordionDetails>\n    </Accordion>\n  )\n}\n","import type { WrapperProps, WrapperState } from './types'\nimport { WrapperUI } from './wrapper-ui'\nimport { useWidgetStore } from '../stores/widget-store'\nimport { useLayoutEffect } from 'react'\n\n/**\n * Container component providing a collapsible header with title, action buttons, and options menu for widgets. Syncs collapse, disabled, and title state with the widget store.\n *\n * @example\n * ```tsx\n * <WidgetWrapper\n *   id=\"my-widget\"\n *   title=\"Sales Overview\"\n *   actions={[<Download key=\"download\" id=\"my-widget\" items={downloads} />]}\n * >\n *   {children}\n * </WidgetWrapper>\n * ```\n */\nexport function WidgetWrapper({\n  id,\n  title,\n  defaultCollapsed,\n  disabled,\n  sx,\n  actions,\n  options,\n  labels,\n  children,\n  onChangeCollapsed,\n}: WrapperProps) {\n  const setWidget = useWidgetStore((state) => state.setWidget)\n\n  useLayoutEffect(() => {\n    setWidget<WrapperState>(id, {\n      collapsed: defaultCollapsed,\n      disabled,\n      title,\n    })\n  }, [defaultCollapsed, disabled, title, id, setWidget])\n\n  const handleChangeCollapsed = (\n    event: React.SyntheticEvent<Element, Event>,\n    expanded: boolean,\n  ) => {\n    onChangeCollapsed?.(event, expanded)\n    setWidget<WrapperState>(id, { collapsed: !expanded })\n  }\n\n  return (\n    <WrapperUI\n      id={id}\n      labels={labels}\n      actions={actions}\n      options={options}\n      sx={sx}\n      onChangeCollapsed={handleChangeCollapsed}\n    >\n      {children}\n    </WrapperUI>\n  )\n}\n"],"names":["styles","root","display","opacity","transition","transitions","create","duration","standard","easing","easeInOut","pointerEvents","summary","minHeight","spacing","gap","paddingInlineEnd","loading","height","left","position","top","width","zIndex","title","container","alignItems","flexGrow","text","wordBreak","overflow","WebkitLineClamp","WebkitBoxOrient","actions","flexShrink","justifyContent","options","trigger","detail","flexDirection","paddingTop","EMPTY_ACTIONS","Actions","t0","$","_c","t1","undefined","t2","map","_temp2","t3","Box","action","index","key","jsx","_temp","e","stopPropagation","EMPTY_OPTIONS","Options","labels","anchorEl","setAnchorEl","useState","Symbol","for","option","onClick","handleOptionAction","t4","t5","e_0","currentTarget","MoreVert","t6","IconButton","t7","t8","vertical","horizontal","t9","Boolean","t10","t11","sx","paddingBottom","t12","t13","option_0","jsxs","MenuItem","disabled","e_1","icon","ListItemIcon","ListItemText","label","Menu","t14","Title","children","ref","Typography","SmartTooltip","WrapperUI","id","onChangeCollapsed","state","getWidget","useWidgetStore","useShallow","state_0","collapsed","state_1","state_2","isFetching","LinearProgress","length","AccordionSummary","t15","AccordionDetails","t16","Accordion","WidgetWrapper","defaultCollapsed","setWidget","useLayoutEffect","event","expanded","handleChangeCollapsed"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carto/ps-react-ui",
-  "version": "4.4.1",
+  "version": "4.4.2",
   "description": "CARTO's Professional Service React Material library",
   "type": "module",
   "devDependencies": {
@@ -129,6 +129,10 @@
       "import": "./dist/widgets/toolbar-actions.js",
       "types": "./dist/types/widgets/toolbar-actions/index.d.ts"
     },
+    "./widgets/utils": {
+      "import": "./dist/widgets/utils.js",
+      "types": "./dist/types/widgets/utils/index.d.ts"
+    },
     "./widgets/wrapper": {
       "import": "./dist/widgets/wrapper.js",
       "types": "./dist/types/widgets/wrapper/index.d.ts"

package/src/components/basemaps/basemaps.tsx

@@ -12,6 +12,26 @@ import { Tooltip } from '../tooltip/tooltip'
 
 const EMPTY_OPTIONS: BasemapsUIProps['options'] = []
 
+/**
+ * Provides an interactive basemap selector with responsive drawer, grouping support, and customizable positioning.
+ *
+ * @remarks
+ * This is an uncontrolled component focused on UI presentation. Typically used with the `BasemapsControls` HOC from `@carto/ps-react-maps` for automatic state management.
+ *
+ * @example
+ * ```tsx
+ * <BasemapsControls mapId={mapId}>
+ *   {({ basemap, setBasemap }) => (
+ *     <BasemapsUI
+ *       options={basemapOptions}
+ *       selected={basemap}
+ *       onChange={setBasemap}
+ *       position="bottom-right"
+ *     />
+ *   )}
+ * </BasemapsControls>
+ * ```
+ */
 export function BasemapsUI({
   options = EMPTY_OPTIONS,
   labels: _labels,

package/src/components/geolocation-controls/geolocation-controls.tsx

@@ -8,6 +8,17 @@ import { useCallback, useEffect, useReducer, useRef, type JSX } from 'react'
 import { ariaLabel, tooltipLabelsDefault } from './const'
 import { Tooltip } from '../tooltip/tooltip'
 
+/**
+ * Provides a seamless interface for accessing device location through the browser's Geolocation API, with permission handling, continuous tracking, and error management.
+ *
+ * @example
+ * ```tsx
+ * <GeolocationControls
+ *   onChange={(coords) => console.log(coords.latitude, coords.longitude)}
+ *   onError={(error) => console.error(error.message)}
+ * />
+ * ```
+ */
 export function GeolocationControls({
   disabled,
   labels,

package/src/components/lasso-tool/lasso-tool-inline.tsx

@@ -24,6 +24,23 @@ const EMPTY_VALUES: LassoToolsInlineComponentProps['values'] = []
 const EMPTY_BOX_PROPS: NonNullable<LassoToolsInlineComponentProps['BoxProps']> =
   {}
 
+/**
+ * Provides an inline layout variant of the lasso tools interface with toggle button groups for mode selection and inline chip management for spatial filters.
+ *
+ * @example
+ * ```tsx
+ * <LassoToolsInlineUI
+ *   enabled={enabled}
+ *   values={spatialFilters}
+ *   modes={modes}
+ *   modesMapping={modesMapping}
+ *   modeSelected={modeSelected}
+ *   onChangeMode={setModeSelected}
+ *   onChipToggle={handleChipToggle}
+ *   onDelete={handleDelete}
+ * />
+ * ```
+ */
 export function LassoToolsInlineUI({
   enabled,
   values = EMPTY_VALUES,

package/src/components/lasso-tool/lasso-tool.tsx

@@ -36,6 +36,27 @@ const EMPTY_VALUES: LassoToolsComponentProps['values'] = []
 const EMPTY_PAPER_PROPS: NonNullable<LassoToolsComponentProps['PaperProps']> =
   {}
 
+/**
+ * Provides a comprehensive floating interface for spatial selection and drawing operations on maps, supporting polygon, rectangle, circle, freehand lasso, and edit modes.
+ *
+ * @remarks
+ * Supports customizable slots for action, options, chips, and secondary actions via compound component pattern (e.g., `LassoToolsUI.Action`, `LassoToolsUI.Chips`).
+ *
+ * @example
+ * ```tsx
+ * <LassoToolsUI
+ *   enabled={enabled}
+ *   values={spatialFilters}
+ *   modes={modes}
+ *   modesMapping={modesMapping}
+ *   modeSelected={modeSelected}
+ *   onActionToggle={setEnabled}
+ *   onChangeMode={setModeSelected}
+ *   onChipToggle={handleChipToggle}
+ *   onDelete={handleDelete}
+ * />
+ * ```
+ */
 export function LassoToolsUI({
   enabled,
   values = EMPTY_VALUES,

package/src/components/list-data/list-data.tsx

@@ -14,6 +14,22 @@ const DEFAULT_LABELS = {
 
 const EMPTY_DATA: ListDataProps['data'] = []
 
+/**
+ * Displays structured data in an accessible list format with expandable views, interactive selection, tooltips, and loading states.
+ *
+ * @example
+ * ```tsx
+ * <ListDataUI
+ *   data={[
+ *     { id: '1', label: 'Population', value: '8.4M' },
+ *     { id: '2', label: 'Median Age', value: '32 years' },
+ *   ]}
+ *   maxItems={3}
+ *   onItemClick={(item) => setSelectedId(item.id)}
+ *   selectedItemId={selectedId}
+ * />
+ * ```
+ */
 export function ListDataUI({
   data = EMPTY_DATA,
   isLoading = false,

package/src/components/measurement-tools/measurement-tools.tsx

@@ -53,6 +53,26 @@ const EMPTY_PAPER_PROPS: NonNullable<
   MeasurementToolsComponentProps['PaperProps']
 > = {}
 
+/**
+ * Provides a measurement interface for calculating distances, areas, and buffers on maps with support for metric and imperial unit systems and real-time unit conversion.
+ *
+ * @example
+ * ```tsx
+ * <MeasurementToolsUI
+ *   enabled={enabled}
+ *   value={measurementValue}
+ *   modes={DEFAULT_MEASUREMENT_TOOLS_MODES}
+ *   units={DEFAULT_MEASUREMENT_TOOLS_UNITS}
+ *   modesMapping={DEFAULT_MEASUREMENT_TOOLS_MODES_MAPPING}
+ *   unitsMapping={DEFAULT_MEASUREMENT_TOOLS_UNITS_MAPPING}
+ *   modeSelected={mode}
+ *   unitSelected={unit}
+ *   onActionToggle={setEnabled}
+ *   onChangeMode={setMode}
+ *   onChangeUnit={setUnit}
+ * />
+ * ```
+ */
 export function MeasurementToolsUI({
   enabled,
   actionProps,

package/src/components/smart-tooltip/smart-tooltip.tsx

@@ -4,6 +4,23 @@ import { Tooltip } from '../tooltip/tooltip'
 
 const EMPTY_DEPENDENCIES: unknown[] = []
 
+/**
+ * An intelligent tooltip wrapper that automatically detects text overflow and displays a tooltip only when content is truncated.
+ *
+ * @remarks
+ * Uses a render prop pattern. The child function receives a `ref` that must be attached to the element being monitored for overflow. Use the `dependencies` array to trigger re-evaluation when content or container size changes.
+ *
+ * @example
+ * ```tsx
+ * <SmartTooltip title="This is a long text that might get truncated">
+ *   {({ ref }) => (
+ *     <Typography ref={ref} noWrap sx={{ overflow: 'hidden', textOverflow: 'ellipsis' }}>
+ *       This is a long text that might get truncated
+ *     </Typography>
+ *   )}
+ * </SmartTooltip>
+ * ```
+ */
 export function SmartTooltip<T extends HTMLElement>({
   title,
   dependencies = EMPTY_DEPENDENCIES,

package/src/components/tooltip/tooltip.tsx

@@ -25,6 +25,19 @@ export function Tooltip({
   )
 }
 
+/**
+ * Sets the global default `enterNextDelay` for all Tooltip components in the application.
+ *
+ * @param delay - Delay in milliseconds before showing tooltips on subsequent hovers.
+ *
+ * @example
+ * ```tsx
+ * import { setTooltipEnterDelay } from '@carto/ps-react-ui/components';
+ *
+ * // Set global delay to 300ms at app initialization
+ * setTooltipEnterDelay(300);
+ * ```
+ */
 export function setTooltipEnterDelay(delay: number) {
   tooltipEnterDelay = delay
 }

package/src/components/zoom-controls/zoom-controls.tsx

@@ -15,6 +15,22 @@ import { styles } from './styles'
 import type { ZoomControlProps } from './types'
 import { useCallback, type JSX } from 'react'
 
+/**
+ * Provides intuitive zoom controls for maps and zoomable interfaces with flexible layouts, loading states, and optional reset functionality.
+ *
+ * @remarks
+ * This is an uncontrolled component. Typically used with the `ZoomControls` HOC from `@carto/ps-react-maps` for automatic state management.
+ *
+ * @example
+ * ```tsx
+ * <ZoomControlsUI
+ *   zoom={zoom}
+ *   onChange={setZoom}
+ *   minZoom={2}
+ *   maxZoom={20}
+ * />
+ * ```
+ */
 export function ZoomControlsUI({
   zoom,
   disabled,

package/src/hooks/use-widget-ref.ts

@@ -2,11 +2,11 @@ import { useEffect, useRef } from 'react'
 import { useWidgetStore } from '../widgets/stores/widget-store'
 
 /**
- * Custom hook for registering a DOM element ref with the widget store.
- * This allows other parts of the application to access the widget's DOM element.
+ * Registers a DOM element ref and an ECharts instance ref with the widget store.
+ * This allows other parts of the application (e.g., screenshot export) to access the widget's DOM element.
  *
- * @param widgetId - The widget ID to register the ref under
- * @returns A ref object to attach to the DOM element
+ * @param widgetId - The widget ID to register the refs under.
+ * @returns An object with `ref` (DOM element) and `instance` (ECharts instance) refs.
  *
  * @example
  * ```tsx

package/src/widgets/README.md

@@ -21,7 +21,7 @@ This directory contains the CARTO PS widget system with an optimized architectur
 
 ```
 widgets/
-├── _shared/              # Shared utilities (internal, not exported)
+├── utils/              # Shared utilities (exported as @carto/ps-react-ui/widgets/utils)
 │   ├── chart-config/     # Chart widget configuration utilities
 │   │   ├── config-factory.ts     # Factory for creating chart widget configs
 │   │   ├── csv-modifiers.ts      # CSV export utilities
@@ -48,13 +48,13 @@ widgets/
 └── widget/               # Main widget orchestrator
 ```
 
-## Shared Utilities (`_shared/`)
+## Shared Utilities (`utils/`)
 
-The `_shared` directory contains internal utilities used by multiple widgets. These are **not exported** from the package and are only for internal use.
+The `utils` directory contains shared utilities used by multiple widgets. These are exported as `@carto/ps-react-ui/widgets/utils`.
 
 ### Chart Config Factory
 
-**File:** `_shared/chart-config/config-factory.ts`
+**File:** `utils/chart-config/config-factory.ts`
 
 Creates standardized chart widget configurations, eliminating code duplication.
 
@@ -64,7 +64,7 @@ Creates standardized chart widget configurations, eliminating code duplication.
 import {
   createChartWidgetConfig,
   flattenObjectArrayToCSV,
-} from '../_shared/chart-config'
+} from '../utils/chart-config'
 
 export const myWidgetConfig = createChartWidgetConfig({
   type: 'my-widget',
@@ -79,14 +79,14 @@ export const myWidgetConfig = createChartWidgetConfig({
 
 ### CSV Modifiers
 
-**File:** `_shared/chart-config/csv-modifiers.ts`
+**File:** `utils/chart-config/csv-modifiers.ts`
 
 - `flattenObjectArrayToCSV()` - For widgets with object-based data (bar, pie, histogram, timeseries)
 - `scatterplotDataToCSV()` - For scatterplot with array-based data
 
 ### EChart Option Builders
 
-**File:** `_shared/chart-config/option-builders.ts`
+**File:** `utils/chart-config/option-builders.ts`
 
 - `buildLegendConfig(hasLegend)` - Standard legend configuration
 - `buildGridConfig(hasLegend, theme, additionalConfig?)` - Grid with legend-aware spacing
@@ -94,7 +94,7 @@ export const myWidgetConfig = createChartWidgetConfig({
 
 ### Skeleton Styles
 
-**File:** `_shared/skeleton/styles.ts`
+**File:** `utils/skeleton/styles.ts`
 
 - `baseSkeletonStyles.graph.container` - Base container styles for all chart skeletons
 
@@ -142,7 +142,7 @@ export const myWidgetConfig = createChartWidgetConfig({
      flattenObjectArrayToCSV,
      buildLegendConfig,
      buildGridConfig,
-   } from '../_shared/chart-config'
+   } from '../utils/chart-config'
 
    export const myWidgetConfig = createChartWidgetConfig<
      MyWidgetData,
@@ -171,7 +171,7 @@ export const myWidgetConfig = createChartWidgetConfig({
    ```typescript
    // style.ts
    import type { SxProps, Theme } from '@mui/material'
-   import { baseSkeletonStyles } from '../_shared/skeleton'
+   import { baseSkeletonStyles } from '../utils/skeleton'
 
    export const styles = {
      skeleton: {

package/src/widgets/actions/download/download.tsx

@@ -14,6 +14,17 @@ import { useShallow } from 'zustand/shallow'
 
 const EMPTY_LABELS: NonNullable<DownloadProps['labels']> = {}
 
+/**
+ * Dropdown menu action for exporting widget data in various formats (CSV, PNG, etc.).
+ *
+ * Reads widget data from the store and triggers downloads using the modifier
+ * function defined in each `DownloadItem`.
+ *
+ * @example
+ * ```tsx
+ * <Download id={widgetId} items={barDownloadConfig({ refUI })} />
+ * ```
+ */
 export function Download({
   id,
   items,

package/src/widgets/actions/download/exports.tsx

@@ -28,6 +28,12 @@ async function downloadFileToCSV<D>(data: D[][]) {
   return Promise.resolve(URL.createObjectURL(blob))
 }
 
+/**
+ * Pre-configured download item for exporting widget data as a CSV file.
+ *
+ * Converts a 2D array of data into CSV format with proper escaping and
+ * triggers a browser download. Revokes the object URL after download.
+ */
 export const downloadToCSV: DownloadItem<unknown[][]> = {
   id: 'csv',
   label: 'CSV',
@@ -91,6 +97,15 @@ async function downloadFileToPNG(ref: Ref<HTMLElement | null> | undefined) {
   return Promise.resolve(result)
 }
 
+/**
+ * Pre-configured download item for exporting a widget as a PNG image.
+ *
+ * Uses html2canvas to capture the widget DOM element referenced by a React ref.
+ * Strips toolbar and action elements before capturing.
+ *
+ * @remarks
+ * The modifier expects a React ref to the widget's root HTML element, not raw data.
+ */
 export const downloadToPNG: Omit<DownloadItem, 'modifier'> & {
   modifier: (
     ref: Ref<HTMLElement | null> | undefined,

package/src/widgets/actions/fullscreen/fullscreen.tsx

@@ -19,6 +19,19 @@ const EMPTY_DIALOG_CONTENT_PROPS: NonNullable<
   FullScreenProps['DialogContentProps']
 > = {}
 
+/**
+ * Displays widget content in a fullscreen modal dialog.
+ *
+ * Manages fullscreen state via the widget store and renders a MUI Dialog
+ * with the widget title and a close button.
+ *
+ * @example
+ * ```tsx
+ * <FullScreen id="my-widget" labels={{ ariaLabel: 'Expand chart' }}>
+ *   <ChartContent id="my-widget" />
+ * </FullScreen>
+ * ```
+ */
 export function FullScreen({
   id,
   labels,

package/src/widgets/actions/index.ts

@@ -11,6 +11,7 @@ export { downloadToCSV, downloadToPNG } from './download/exports'
 export {
   RelativeData,
   RELATIVE_DATA_TOOL_ID,
+  RELATIVE_DATA_CONFIG_TOOL_ID,
 } from './relative-data/relative-data'
 export type { RelativeDataProps } from './relative-data/types'
 

package/src/widgets/actions/relative-data/relative-data.test.tsx

@@ -1,6 +1,10 @@
 import { describe, test, expect, beforeEach } from 'vitest'
 import { render, screen, fireEvent, waitFor } from '@testing-library/react'
-import { RelativeData, RELATIVE_DATA_TOOL_ID } from './relative-data'
+import {
+  RelativeData,
+  RELATIVE_DATA_TOOL_ID,
+  RELATIVE_DATA_CONFIG_TOOL_ID,
+} from './relative-data'
 import { useWidgetStore } from '../../stores/widget-store'
 import type { EchartWidgetData } from '../../echart/types'
 
@@ -223,6 +227,63 @@ describe('RelativeData', () => {
     expect(button.hasAttribute('disabled')).toBeTruthy()
   })
 
+  test('registers config tool on mount', async () => {
+    render(<RelativeData id={widgetId} />)
+
+    await waitFor(() => {
+      const widget = useWidgetStore.getState().getWidget(widgetId)
+      const tool = widget?.registeredTools?.find(
+        (t) => t.id === RELATIVE_DATA_CONFIG_TOOL_ID,
+      )
+      expect(tool).toBeTruthy()
+      expect(tool?.type).toBe('config')
+      expect(tool?.enabled).toBe(true)
+    })
+  })
+
+  test('sets formatter via config pipeline when toggling to relative mode', async () => {
+    useWidgetStore.getState().setWidget(widgetId, { max: 500 })
+
+    render(<RelativeData id={widgetId} />)
+
+    const button = screen.getByRole('button')
+    fireEvent.click(button)
+
+    await waitFor(() => {
+      const widget = useWidgetStore.getState().getWidget(widgetId)
+      const tool = widget?.registeredTools?.find(
+        (t) => t.id === RELATIVE_DATA_CONFIG_TOOL_ID,
+      )
+      expect(tool?.config?.isRelative).toBe(true)
+      expect(tool?.config?.originalFormatter).toBeUndefined()
+      expect(tool?.config?.originalMax).toBe(500)
+    })
+  })
+
+  test('restores original formatter via config pipeline when toggling back', () => {
+    const customFormatter = (value: number) => `$${value}`
+    useWidgetStore
+      .getState()
+      .setWidget(widgetId, { formatter: customFormatter, max: 200 })
+
+    render(<RelativeData id={widgetId} />)
+
+    const button = screen.getByRole('button')
+
+    // Toggle to relative
+    fireEvent.click(button)
+    // Toggle back to absolute
+    fireEvent.click(button)
+
+    const widget = useWidgetStore.getState().getWidget(widgetId)
+    const tool = widget?.registeredTools?.find(
+      (t) => t.id === RELATIVE_DATA_CONFIG_TOOL_ID,
+    )
+    expect(tool?.config?.isRelative).toBe(false)
+    expect(tool?.config?.originalFormatter).toBe(customFormatter)
+    expect(tool?.config?.originalMax).toBe(200)
+  })
+
   test('recalculates relative values when store data changes externally while in relative mode', async () => {
     const initialData: EchartWidgetData = [
       [