@muraldevkit/ui-toolkit 4.73.0-dev-NYDL.1 → 4.73.0-dev-t0WE.1

package/dist/types/components/link/MrlLink/MrlLink.d.ts

@@ -39,6 +39,11 @@ export interface MrlLinkProptypes extends React.ComponentProps<'a'> {
      * Custom on click listener
      */
     onClick?: (e: React.MouseEvent<HTMLElement>) => void | undefined;
+    /**
+     * Enables interaction tracking for this link. Provide a stable, non-PII id
+     * (e.g. 'help-center-link'). When omitted, the link emits no analytics.
+     */
+    eventId?: string;
 }
 /**
  * Renders a link component
@@ -46,4 +51,4 @@ export interface MrlLinkProptypes extends React.ComponentProps<'a'> {
  * @param {MrlLinkProptypes} props the props for your MrlLink
  * @returns {React.ReactElement} an a element containing the text you pass
  */
-export declare const MrlLink: ({ target, className, color, kind, size, href, attrs, onClick, text, ...remainingProps }: MrlLinkProptypes) => React.ReactElement;
+export declare const MrlLink: ({ target, className, color, kind, size, href, attrs, onClick, text, eventId, ...remainingProps }: MrlLinkProptypes) => React.ReactElement;

package/dist/types/components/link/MrlLinkButton/MrlLinkButton.d.ts

@@ -46,6 +46,11 @@ export interface MrlLinkButtonProps extends Omit<MrlComponentProps, 'style'>, Re
      * Tooltip configuration for the button
      */
     tooltip?: TooltipConfig;
+    /**
+     * Enables interaction tracking for this link button. Provide a stable, non-PII id
+     * (e.g. 'upgrade-plan-cta'). When omitted, the link button emits no analytics.
+     */
+    eventId?: string;
 }
 /**
  * Warning: use this component with care. Our links generally do not look like buttons.

package/dist/types/components/menu/MrlMenu/MrlMenu.d.ts

@@ -105,6 +105,11 @@ export interface MrlMenuProps {
      * @param type - type of close event
      */
     onClose?: (type?: string) => void;
+    /**
+     * Enables interaction tracking for this menu. Provide a stable, non-PII id
+     * (e.g. 'mural-context-menu'). When omitted, the menu emits no analytics.
+     */
+    eventId?: string;
 }
 /**
  * MrlMenu component
@@ -113,7 +118,7 @@ export interface MrlMenuProps {
  * @param {MrlMenuProps} props - The props for the MrlMenu component
  * @returns {Element} - rendered MrlMenu component
  */
-export declare function MrlMenu({ actionState, alignment, children, closeOnScroll, closeParent, customPosition, clickOutsideEvent, disableArrowOpen, disableFlipping, id, isInternal, isSubMenu, spacing, menuOffset, portalProps, position, triggerStopPropagation, onClose, triggerRef, ...remainingProps }: MrlMenuProps): JSX.Element;
+export declare function MrlMenu({ actionState, alignment, children, closeOnScroll, closeParent, customPosition, clickOutsideEvent, disableArrowOpen, disableFlipping, id, isInternal, isSubMenu, spacing, menuOffset, portalProps, position, triggerStopPropagation, onClose, eventId, triggerRef, ...remainingProps }: MrlMenuProps): JSX.Element;
 export declare namespace MrlMenu {
     var componentType: string;
 }

package/dist/types/components/menu/MrlMenuItem/MrlMenuItem.d.ts

@@ -39,6 +39,11 @@ export interface MrlMenuItemProps {
     role?: MenuItemRole;
     /** If the menu item is selected */
     selected?: boolean;
+    /**
+     * Enables interaction tracking for this menu item. Provide a stable, non-PII id
+     * (e.g. 'mural-menu-duplicate'). When omitted, the menu item emits no analytics.
+     */
+    eventId?: string;
 }
 /**
  * MrlMenuItem component
@@ -47,4 +52,4 @@ export interface MrlMenuItemProps {
  * @param {MrlMenuItemProps} props - The props for the MrlMenuItem component
  * @returns {Element} - rendered MrlMenuItem component
  */
-export declare function MrlMenuItem({ ariaDescribedBy, ariaHasPopup, children, className, dataQa, disabled, icon, id, onClick, onMouseOut, onMouseOver, role, selected, ...rest }: MrlMenuItemProps): JSX.Element;
+export declare function MrlMenuItem({ ariaDescribedBy, ariaHasPopup, children, className, dataQa, disabled, icon, id, onClick, onMouseOut, onMouseOver, role, selected, eventId, ...rest }: MrlMenuItemProps): JSX.Element;

package/dist/types/components/menu/MrlMenuItemLink/MrlMenuItemLink.d.ts

@@ -27,6 +27,11 @@ export interface MrlMenuItemLinkProps {
     selected?: boolean;
     /** Rel attr for the menu item */
     rel?: string;
+    /**
+     * Enables interaction tracking for this menu item. Provide a stable, non-PII id
+     * (e.g. 'help-menu-docs'). When omitted, the menu item emits no analytics.
+     */
+    eventId?: string;
 }
 /**
  * MrlMenuItem component
@@ -35,4 +40,4 @@ export interface MrlMenuItemLinkProps {
  * @param {MrlMenuItemLinkProps} props - The props for the MrlMenuItem component
  * @returns {Element} - rendered MrlMenuItem component
  */
-export declare function MrlMenuItemLink({ ariaDescribedBy, children, className, dataQa, disabled, href, icon, id, onClick, selected, target, ...rest }: MrlMenuItemLinkProps): JSX.Element;
+export declare function MrlMenuItemLink({ ariaDescribedBy, children, className, dataQa, disabled, href, icon, id, onClick, selected, target, eventId, ...rest }: MrlMenuItemLinkProps): JSX.Element;

package/dist/types/components/modal/MrlModal/MrlModal.d.ts

@@ -39,6 +39,11 @@ interface ModalProps extends MrlComponentProps {
     state?: ModalState;
     /** Additional function to be run when the modal closes */
     hookClose?: (() => void) | undefined;
+    /**
+     * Enables interaction tracking for this modal. Provide a stable, non-PII id
+     * (e.g. 'share-mural-modal'). When omitted, the modal emits no analytics.
+     */
+    eventId?: string;
 }
 /**
  * Modal Component.

package/dist/types/components/notification/MrlBlockNotification/MrlBlockNotification.d.ts

@@ -88,6 +88,13 @@ export interface MrlBlockNotificationProps {
      * Callback to be called when component closes (see useAutoClose)
      */
     onAutoClose?: Parameters<useAutoClose>[2];
+    /**
+     * Enables interaction tracking for this notification. Provide a stable, non-PII id
+     * (e.g. 'trial-expiry-notification'). When omitted, the notification emits no analytics.
+     *
+     * Note: heading and message text are never emitted.
+     */
+    eventId?: string;
 }
 /**
  * Block Notification Component

package/dist/types/components/notification/MrlToast/MrlToast.d.ts

@@ -57,10 +57,17 @@ export interface MrlToastProps {
     /** Determines whether the close icon button should be shown. */
     showCloseButton?: boolean;
     showIcon?: boolean;
+    /**
+     * Enables interaction tracking for this toast. Provide a stable, non-PII id
+     * (e.g. 'export-complete-toast'). When omitted, the toast emits no analytics.
+     *
+     * Note: message text is never emitted.
+     */
+    eventId?: string;
 }
 /**
  * MrlToast component.
  * @param {MrlToastProps} props - The props for the MrlToast component.
  * @returns {React.ReactElement} The MrlToast component.
  */
-export declare const MrlToast: ({ ["data-qa"]: qa, autoClose, avatar, backgroundColor, className, closeAfterMs, kind, link, onClose, primaryCTA, primaryMessage, secondaryCTA, secondaryMessage, showCloseButton, showIcon, ...rest }: MrlToastProps) => React.ReactElement;
+export declare const MrlToast: ({ ["data-qa"]: qa, autoClose, avatar, backgroundColor, className, closeAfterMs, kind, link, onClose, primaryCTA, primaryMessage, secondaryCTA, secondaryMessage, showCloseButton, showIcon, eventId, ...rest }: MrlToastProps) => React.ReactElement;

package/dist/types/components/pagination/MrlPaginationButton/MrlPaginationButton.d.ts

@@ -15,6 +15,11 @@ interface MrlPaginationButtonProps {
     handleClick?: (e: React.SyntheticEvent<HTMLButtonElement>) => void;
     /** Pagination heading */
     text?: string;
+    /**
+     * Enables interaction tracking for this button. Provide a stable, non-PII id
+     * (e.g. 'templates-pagination'). When omitted, the button emits no analytics.
+     */
+    eventId?: string;
     /** The anchor of the tooltips on the buttons */
     tooltipAnchor?: MrlTooltipAnchor;
     /** The placement of the tooltips on the buttons */
@@ -25,5 +30,5 @@ interface MrlPaginationButtonProps {
  * @param {MrlPaginationButtonProps} props - the component props
  * @returns a pagintaion button
  */
-export declare function MrlPaginationButton({ buttonClass, className, disabled, kind, handleClick, text, tooltipAnchor, tooltipPosition, ...rest }: MrlPaginationButtonProps): JSX.Element;
+export declare function MrlPaginationButton({ buttonClass, className, disabled, kind, handleClick, text, tooltipAnchor, tooltipPosition, eventId, ...rest }: MrlPaginationButtonProps): JSX.Element;
 export {};

package/dist/types/components/panel/MrlPanel/MrlPanel.d.ts

@@ -42,6 +42,14 @@ interface MrlPanelProps extends React.ComponentPropsWithRef<'div'> {
      * hasDataScrollAnchor is required to enable infinite scroll
      */
     hasDataScrollAnchor?: boolean;
+    /**
+     * Enables interaction tracking for this panel. Provide a stable, non-PII id
+     * (e.g. 'comments-panel'). When omitted, the panel emits no analytics.
+     *
+     * `open` is emitted when the panel mounts, since consumers control the panel's
+     * presence by rendering it.
+     */
+    eventId?: string;
 }
 /**
  * MrlPanel component.

package/dist/types/components/popover/MrlPopover/MrlPopover.d.ts

@@ -117,6 +117,11 @@ export interface MrlPopoverProps {
      * data-qa attribute for the popover
      */
     ['data-qa']?: string;
+    /**
+     * Enables interaction tracking for this popover. Provide a stable, non-PII id
+     * (e.g. 'sticky-note-color-picker'). When omitted, the popover emits no analytics.
+     */
+    eventId?: string;
 }
 /**
  * MrlPopover
@@ -125,7 +130,7 @@ export interface MrlPopoverProps {
  * @param {MrlPopoverProps} props - The props for the MrlPopover component
  * @returns {Element} - rendered MrlPopover component
  */
-export declare function MrlPopover({ alignment, ariaLabel, ariaLabelledBy, children, className, customPosition, disableClickToOpen, disableClickOutside, disableFlipping, disableFocusTrap, hasCloseButton, spacing, id, isSubMenu, actionState, position, point, portalProps, kind, offset, onClose, onOpen, triggerRef, ...rest }: MrlPopoverProps): JSX.Element;
+export declare function MrlPopover({ alignment, ariaLabel, ariaLabelledBy, children, className, customPosition, disableClickToOpen, disableClickOutside, disableFlipping, disableFocusTrap, hasCloseButton, spacing, id, isSubMenu, actionState, position, point, portalProps, kind, offset, onClose, onOpen, eventId, triggerRef, ...rest }: MrlPopoverProps): JSX.Element;
 export declare namespace MrlPopover {
     var componentType: string;
 }

package/dist/types/components/table/MrlSmartTable/MrlSmartTable.d.ts

@@ -214,6 +214,13 @@ export interface MrlSmartTableProps extends Partial<Pick<MrlTableProps, 'aria-la
      * @default false
      */
     enableVirtualization?: boolean;
+    /**
+     * Enables interaction tracking for this table. Provide a stable, non-PII id
+     * (e.g. 'workspace-members-table'). When omitted, the table emits no analytics.
+     *
+     * Note: row content is never emitted — selection events carry counts only.
+     */
+    eventId?: string;
 }
 /**
  * MrlSmartTable Component

package/dist/types/components/table/MrlTableRow/MrlTableRow.d.ts

@@ -16,6 +16,13 @@ export interface MrlTableRowProps extends React.ComponentPropsWithoutRef<'tr'> {
      * Custom click handler to be used for mouse and keyboard selection of table row
      */
     onClick?: (e: React.MouseEvent<HTMLElement> | React.KeyboardEvent) => void;
+    /**
+     * Enables interaction tracking for this row. Provide a stable, non-PII id
+     * (e.g. 'members-table-row'). When omitted, the row emits no analytics.
+     *
+     * Note: row content is never emitted.
+     */
+    eventId?: string;
 }
 /**
  * MrlTableRow Component

package/dist/types/components/tabs/MrlTab/MrlTab.d.ts

@@ -11,10 +11,15 @@ export interface MrlTabProps extends React.ComponentProps<'button'> {
     /** An addition function to call when clicking on a tab */
     hookClick?: () => void;
     text: string;
+    /**
+     * Enables interaction tracking for this tab. Provide a stable, non-PII id
+     * (e.g. 'settings-tabs'). When omitted, the tab emits no analytics.
+     */
+    eventId?: string;
 }
 /**
  * Renders a tab component
  * @param {MrlTabProps} props the props for your MrlTab
  * @returns {React.ReactElement} an a element containing the text you pass
  */
-export declare const MrlTab: ({ className, icon, id, hookClick, text, ...rest }: MrlTabProps) => React.ReactElement;
+export declare const MrlTab: ({ className, icon, id, hookClick, text, eventId, ...rest }: MrlTabProps) => React.ReactElement;

package/dist/types/components/tabs/MrlTabLink/MrlTabLink.d.ts

@@ -18,6 +18,11 @@ export interface MrlTabLinkProps extends NavLinkProps {
      * use children to provide content
      */
     text?: string;
+    /**
+     * Enables interaction tracking for this tab. Provide a stable, non-PII id
+     * (e.g. 'workspace-nav-tabs'). When omitted, the tab emits no analytics.
+     */
+    eventId?: string;
 }
 /**
  * Renders a tab component
@@ -25,4 +30,4 @@ export interface MrlTabLinkProps extends NavLinkProps {
  * @param {MrlTabLinkProps} props the props for your MrlTabLink
  * @returns {React.ReactElement} an a element containing the text you pass
  */
-export declare const MrlTabLink: ({ className, children, icon, id, hookClick, text, to, ...remainingProps }: MrlTabLinkProps) => React.ReactElement;
+export declare const MrlTabLink: ({ className, children, icon, id, hookClick, text, to, eventId, ...remainingProps }: MrlTabLinkProps) => React.ReactElement;

package/dist/types/components/toolbar/MrlToolbarButton/MrlToolbarButton.d.ts

@@ -29,6 +29,11 @@ export interface MrlToolbarButtonProps {
      */
     renderInMenu?: boolean;
     text: string;
+    /**
+     * Enables interaction tracking for this button. Provide a stable, non-PII id
+     * (e.g. 'canvas-toolbar-shapes'). When omitted, the button emits no analytics.
+     */
+    eventId?: string;
     /**
      * Props used to control the display of the button in the toolbar.
      */

package/dist/types/components/tooltip/MrlTooltip/MrlTooltip.d.ts

@@ -39,6 +39,14 @@ interface MrlTooltipProps {
     tooltipContentClass?: string;
     /** A custom render function to render the tooltip content */
     customRender?: (text?: string) => React.ReactNode;
+    /**
+     * Enables interaction tracking for this tooltip. Provide a stable, non-PII id
+     * (e.g. 'facilitation-timer-tooltip'). When omitted, the tooltip emits no analytics.
+     *
+     * Note: tooltips open on hover, so an instrumented tooltip is a high-volume source.
+     * Only add an id where the reveal itself is the signal you need.
+     */
+    eventId?: string;
 }
 /**
  * MrlTooltip Component

package/dist/types/contexts/MrlAnalyticsContext/types.d.ts

@@ -12,7 +12,7 @@ export interface MrlAnalyticsEvent {
      * Consumer-supplied attribution id. REQUIRED for an event to fire (opt-in).
      * Must be a stable, non-PII identifier (e.g. 'board-share', not the user's name).
      */
-    trackingId: string;
+    eventId: string;
     /** Non-PII component variant, e.g. button kind/size. Set by the component. */
     variant?: string;
     /** Curated, non-PII extra context. Never button labels, input values, etc. */

package/dist/types/hooks/useMrlAnalytics/useMrlAnalytics.d.ts

@@ -9,13 +9,13 @@ export declare const useMrlAnalytics: () => {
 };
 type EmitArgs = Pick<MrlAnalyticsEvent, 'action' | 'variant' | 'metadata'>;
 /**
- * Component-facing helper. Binds component identity + trackingId once, then
- * `emit({ action })` per interaction. No-ops entirely when trackingId is absent,
+ * Component-facing helper. Binds component identity + eventId once, then
+ * `emit({ action })` per interaction. No-ops entirely when eventId is absent,
  * so instrumentation is opt-in and attributable.
  *
  * @param component - the emitting component's name, e.g. 'MrlButton'
- * @param trackingId - consumer-supplied, non-PII id; undefined disables emission
+ * @param eventId - consumer-supplied, non-PII id; undefined disables emission
  * @returns an `emit` callback that fires a single interaction per call
  */
-export declare const useMrlTrackInteraction: (component: string, trackingId?: string) => ({ action, variant, metadata }: EmitArgs) => void;
+export declare const useMrlTrackInteraction: (component: string, eventId?: string) => ({ action, variant, metadata }: EmitArgs) => void;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@muraldevkit/ui-toolkit",
-	"version": "4.73.0-dev-NYDL.1",
+	"version": "4.73.0-dev-t0WE.1",
 	"description": "Mural's UI Toolkit",
 	"main": "./dist/cjs/index.js",
 	"module": "./dist/esm/index.js",
@@ -50,13 +50,7 @@
 	"license": "https://www.mural.co/terms/developer-addendum",
 	"peerDependencies": {
 		"@tactivos/mural-shared": "2.8.0",
-		"lottie-web": "^5.9.6",
-		"react-router-dom": "^6"
-	},
-	"peerDependenciesMeta": {
-		"react-router-dom": {
-			"optional": true
-		}
+		"lottie-web": "^5.9.6"
 	},
 	"devDependencies": {
 		"@babel/core": "7.21.4",
@@ -91,6 +85,7 @@
 		"@types/path-browserify": "1.0.2",
 		"@types/react": "18.2.22",
 		"@types/react-dom": "18.2.7",
+		"@types/react-router-dom": "5.3.3",
 		"@typescript-eslint/eslint-plugin": "8.64.0",
 		"@typescript-eslint/parser": "8.64.0",
 		"babel-loader": "9.1.2",
@@ -115,7 +110,6 @@
 		"null-loader": "4.0.1",
 		"prettier": "3.6.2",
 		"react-markdown": "8.0.7",
-		"react-router-dom": "6.30.4",
 		"rimraf": "6.1.0",
 		"rollup": "4.62.2",
 		"rollup-plugin-postcss": "4.0.2",
@@ -147,6 +141,7 @@
 		"path-browserify": "1.0.1",
 		"react": "18.2.0",
 		"react-dom": "18.2.0",
+		"react-router-dom": "5.3.4",
 		"react-select": "5.8.2"
 	},
 	"lint-staged": {