@muraldevkit/ui-toolkit 4.71.0-dev-nBIF.1 → 4.71.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/dist/cjs/components/button/MrlButton/MrlButton.js +1 -8
  2. package/dist/cjs/components/button/MrlButton/MrlButton.js.map +1 -1
  3. package/dist/cjs/index.js +0 -6
  4. package/dist/cjs/index.js.map +1 -1
  5. package/dist/components/button/MrlButton/MrlButton.d.ts +0 -5
  6. package/dist/components/svg/config.d.ts +1 -1
  7. package/dist/contexts/index.d.ts +0 -1
  8. package/dist/esm/components/button/MrlButton/MrlButton.js +1 -8
  9. package/dist/esm/components/button/MrlButton/MrlButton.js.map +1 -1
  10. package/dist/esm/index.js +0 -2
  11. package/dist/esm/index.js.map +1 -1
  12. package/dist/hooks/index.d.ts +0 -1
  13. package/dist/styles.css +754 -234
  14. package/dist/types/components/button/MrlButton/MrlButton.d.ts +0 -5
  15. package/dist/types/contexts/index.d.ts +0 -1
  16. package/dist/types/hooks/index.d.ts +0 -1
  17. package/package.json +1 -2
  18. package/dist/cjs/contexts/MrlAnalyticsContext/MrlAnalyticsContext.js +0 -54
  19. package/dist/cjs/contexts/MrlAnalyticsContext/MrlAnalyticsContext.js.map +0 -1
  20. package/dist/cjs/hooks/useMrlAnalytics/useMrlAnalytics.js +0 -69
  21. package/dist/cjs/hooks/useMrlAnalytics/useMrlAnalytics.js.map +0 -1
  22. package/dist/cjs/version.js +0 -6
  23. package/dist/cjs/version.js.map +0 -1
  24. package/dist/contexts/MrlAnalyticsContext/MrlAnalyticsContext.d.ts +0 -25
  25. package/dist/contexts/MrlAnalyticsContext/index.d.ts +0 -2
  26. package/dist/contexts/MrlAnalyticsContext/types.d.ts +0 -22
  27. package/dist/esm/contexts/MrlAnalyticsContext/MrlAnalyticsContext.js +0 -32
  28. package/dist/esm/contexts/MrlAnalyticsContext/MrlAnalyticsContext.js.map +0 -1
  29. package/dist/esm/hooks/useMrlAnalytics/useMrlAnalytics.js +0 -46
  30. package/dist/esm/hooks/useMrlAnalytics/useMrlAnalytics.js.map +0 -1
  31. package/dist/esm/version.js +0 -4
  32. package/dist/esm/version.js.map +0 -1
  33. package/dist/hooks/useMrlAnalytics/index.d.ts +0 -1
  34. package/dist/hooks/useMrlAnalytics/useMrlAnalytics.d.ts +0 -21
  35. package/dist/hooks/useMrlAnalytics/useMrlAnalyticsDemo.d.ts +0 -8
  36. package/dist/types/contexts/MrlAnalyticsContext/MrlAnalyticsContext.d.ts +0 -25
  37. package/dist/types/contexts/MrlAnalyticsContext/index.d.ts +0 -2
  38. package/dist/types/contexts/MrlAnalyticsContext/types.d.ts +0 -22
  39. package/dist/types/hooks/useMrlAnalytics/index.d.ts +0 -1
  40. package/dist/types/hooks/useMrlAnalytics/useMrlAnalytics.d.ts +0 -21
  41. package/dist/types/hooks/useMrlAnalytics/useMrlAnalyticsDemo.d.ts +0 -8
  42. package/dist/types/version.d.ts +0 -1
  43. package/dist/version.d.ts +0 -1
@@ -81,11 +81,6 @@ export interface MrlButtonProps extends Omit<MrlComponentProps, 'style'>, React.
81
81
  * Icon buttons require a text label to ensure accessibility.
82
82
  */
83
83
  text: string;
84
- /**
85
- * Enables interaction tracking for this button. Provide a stable, non-PII id
86
- * (e.g. 'board-share-cta'). When omitted, the button emits no analytics.
87
- */
88
- trackingId?: string;
89
84
  /**
90
85
  * Determines which aria setup to use for various toggle/selected styles.
91
86
  * pressed - use for an traditional “toggle button”
@@ -1,2 +1 @@
1
- export * from './MrlAnalyticsContext';
2
1
  export * from './MrlTabContext';
@@ -1,5 +1,4 @@
1
1
  export * from './useCoordinate';
2
- export * from './useMrlAnalytics';
3
2
  export * from './useBreakpoint';
4
3
  export * from './useElementDimensions';
5
4
  export * from './useHasFocusableDescendant';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@muraldevkit/ui-toolkit",
3
- "version": "4.71.0-dev-nBIF.1",
3
+ "version": "4.71.0",
4
4
  "description": "Mural's UI Toolkit",
5
5
  "main": "./dist/cjs/index.js",
6
6
  "module": "./dist/esm/index.js",
@@ -14,7 +14,6 @@
14
14
  ],
15
15
  "scripts": {
16
16
  "prebuild": "rimraf dist",
17
- "prepack": "npm run build",
18
17
  "analyze": "ANALYZE=true rollup --config rollup.config.mjs",
19
18
  "build": "npm run build:js && npm run build:css && npm run build:types && npm run build:verify",
20
19
  "build:css": "webpack --mode=production",
@@ -1,54 +0,0 @@
1
- 'use strict';
2
-
3
- var React = require('react');
4
- var index = require('../../utils/noop/index.js');
5
-
6
- function _interopNamespace(e) {
7
- if (e && e.__esModule) return e;
8
- var n = Object.create(null);
9
- if (e) {
10
- Object.keys(e).forEach(function (k) {
11
- if (k !== 'default') {
12
- var d = Object.getOwnPropertyDescriptor(e, k);
13
- Object.defineProperty(n, k, d.get ? d : {
14
- enumerable: true,
15
- get: function () { return e[k]; }
16
- });
17
- }
18
- });
19
- }
20
- n.default = e;
21
- return Object.freeze(n);
22
- }
23
-
24
- var React__namespace = /*#__PURE__*/_interopNamespace(React);
25
-
26
- /** Default is a no-op: components emit nothing until a consumer provides `track`. */
27
- var initialContext = {
28
- track: index.noop
29
- };
30
- var MrlAnalyticsContext = /*#__PURE__*/React.createContext(initialContext);
31
- /**
32
- * Injects the app's analytics transport into the toolkit. Wrap the app once;
33
- * every instrumented Mrl* component below emits through the provided `track`.
34
- *
35
- * @param props - the provider props
36
- * @param props.track - the transport that receives each MrlAnalyticsEvent (default no-op)
37
- * @param props.children - the subtree that can emit analytics
38
- * @returns the provider wrapping `children`
39
- */
40
- var MrlAnalyticsProvider = _ref => {
41
- var track = _ref.track,
42
- children = _ref.children;
43
- // Stable identity so consumers don't re-render every child on each parent render.
44
- var value = React__namespace.useMemo(() => ({
45
- track: track !== null && track !== void 0 ? track : index.noop
46
- }), [track]);
47
- return /*#__PURE__*/React__namespace.createElement(MrlAnalyticsContext.Provider, {
48
- value: value
49
- }, children);
50
- };
51
-
52
- exports.MrlAnalyticsContext = MrlAnalyticsContext;
53
- exports.MrlAnalyticsProvider = MrlAnalyticsProvider;
54
- //# sourceMappingURL=MrlAnalyticsContext.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"MrlAnalyticsContext.js","sources":["../../../../src/contexts/MrlAnalyticsContext/MrlAnalyticsContext.tsx"],"sourcesContent":["import * as React from 'react';\nimport { createContext } from 'react';\nimport { noop } from '../../utils';\nimport { MrlTrack } from './types';\n\nexport interface MrlAnalyticsContextProps {\n\ttrack: MrlTrack;\n}\n\n/** Default is a no-op: components emit nothing until a consumer provides `track`. */\nconst initialContext: MrlAnalyticsContextProps = {\n\ttrack: noop\n};\n\nexport const MrlAnalyticsContext = createContext<MrlAnalyticsContextProps>(initialContext);\n\nexport interface MrlAnalyticsProviderProps {\n\t/**\n\t * The transport the app injects. Receives a MrlAnalyticsEvent and forwards it\n\t * wherever the app tracks (in murally: a wrapper over trackWithSegment).\n\t * Omit it and the toolkit stays silent — safe for consumers with no analytics.\n\t */\n\ttrack?: MrlTrack;\n\tchildren: React.ReactNode;\n}\n\n/**\n * Injects the app's analytics transport into the toolkit. Wrap the app once;\n * every instrumented Mrl* component below emits through the provided `track`.\n *\n * @param props - the provider props\n * @param props.track - the transport that receives each MrlAnalyticsEvent (default no-op)\n * @param props.children - the subtree that can emit analytics\n * @returns the provider wrapping `children`\n */\nexport const MrlAnalyticsProvider = ({ track, children }: MrlAnalyticsProviderProps) => {\n\t// Stable identity so consumers don't re-render every child on each parent render.\n\tconst value = React.useMemo<MrlAnalyticsContextProps>(() => ({ track: track ?? noop }), [track]);\n\n\treturn <MrlAnalyticsContext.Provider value={value}>{children}</MrlAnalyticsContext.Provider>;\n};\n"],"names":["initialContext","track","noop","MrlAnalyticsContext","createContext","MrlAnalyticsProvider","_ref","children","value","React","useMemo","createElement","Provider"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AASA;AACA,IAAMA,cAAwC,GAAG;AAChDC,EAAAA,KAAK,EAAEC;AACR,CAAC;IAEYC,mBAAmB,gBAAGC,mBAAa,CAA2BJ,cAAc;AAYzF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,IAAMK,oBAAoB,GAAGC,IAAA,IAAoD;AAAA,EAAA,IAAjDL,KAAK,GAAAK,IAAA,CAALL,KAAK;IAAEM,QAAQ,GAAAD,IAAA,CAARC,QAAQ;AACrD;AACA,EAAA,IAAMC,KAAK,GAAGC,gBAAK,CAACC,OAAO,CAA2B,OAAO;AAAET,IAAAA,KAAK,EAAEA,KAAK,KAAA,IAAA,IAALA,KAAK,KAAA,MAAA,GAALA,KAAK,GAAIC;AAAK,GAAC,CAAC,EAAE,CAACD,KAAK,CAAC,CAAC;AAEhG,EAAA,oBAAOQ,gBAAA,CAAAE,aAAA,CAACR,mBAAmB,CAACS,QAAQ,EAAA;AAACJ,IAAAA,KAAK,EAAEA;AAAM,GAAA,EAAED,QAAuC,CAAC;AAC7F;;;;;"}
@@ -1,69 +0,0 @@
1
- 'use strict';
2
-
3
- var React = require('react');
4
- var version = require('../../version.js');
5
- var MrlAnalyticsContext = require('../../contexts/MrlAnalyticsContext/MrlAnalyticsContext.js');
6
-
7
- function _interopNamespace(e) {
8
- if (e && e.__esModule) return e;
9
- var n = Object.create(null);
10
- if (e) {
11
- Object.keys(e).forEach(function (k) {
12
- if (k !== 'default') {
13
- var d = Object.getOwnPropertyDescriptor(e, k);
14
- Object.defineProperty(n, k, d.get ? d : {
15
- enumerable: true,
16
- get: function () { return e[k]; }
17
- });
18
- }
19
- });
20
- }
21
- n.default = e;
22
- return Object.freeze(n);
23
- }
24
-
25
- var React__namespace = /*#__PURE__*/_interopNamespace(React);
26
-
27
- /**
28
- * Raw accessor for the analytics context.
29
- *
30
- * @returns the injected `track` transport (default no-op)
31
- */
32
- var useMrlAnalytics = () => React__namespace.useContext(MrlAnalyticsContext.MrlAnalyticsContext);
33
- /**
34
- * Component-facing helper. Binds component identity + trackingId once, then
35
- * `emit({ action })` per interaction. No-ops entirely when trackingId is absent,
36
- * so instrumentation is opt-in and attributable.
37
- *
38
- * @param component - the emitting component's name, e.g. 'MrlButton'
39
- * @param trackingId - consumer-supplied, non-PII id; undefined disables emission
40
- * @returns an `emit` callback that fires a single interaction per call
41
- */
42
- var useMrlTrackInteraction = (component, trackingId) => {
43
- var _useMrlAnalytics = useMrlAnalytics(),
44
- track = _useMrlAnalytics.track;
45
- return React__namespace.useCallback(_ref => {
46
- var action = _ref.action,
47
- variant = _ref.variant,
48
- metadata = _ref.metadata;
49
- // opt-in: no id → no event (volume + PII guard)
50
- if (!trackingId) return;
51
- try {
52
- track({
53
- action,
54
- component,
55
- metadata,
56
- toolkitVersion: version.TOOLKIT_VERSION,
57
- trackingId,
58
- variant
59
- });
60
- } catch (e) {
61
- // Ensure errors don't break the app
62
- return e;
63
- }
64
- }, [track, component, trackingId]);
65
- };
66
-
67
- exports.useMrlAnalytics = useMrlAnalytics;
68
- exports.useMrlTrackInteraction = useMrlTrackInteraction;
69
- //# sourceMappingURL=useMrlAnalytics.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"useMrlAnalytics.js","sources":["../../../../src/hooks/useMrlAnalytics/useMrlAnalytics.ts"],"sourcesContent":["import * as React from 'react';\nimport { MrlAnalyticsContext } from '../../contexts/MrlAnalyticsContext';\nimport { MrlAnalyticsEvent, MrlTrack } from '../../contexts/MrlAnalyticsContext/types';\nimport { TOOLKIT_VERSION } from '../../version';\n\n/**\n * Raw accessor for the analytics context.\n *\n * @returns the injected `track` transport (default no-op)\n */\nexport const useMrlAnalytics = (): { track: MrlTrack } => React.useContext(MrlAnalyticsContext);\n\ntype EmitArgs = Pick<MrlAnalyticsEvent, 'action' | 'variant' | 'metadata'>;\n\n/**\n * Component-facing helper. Binds component identity + trackingId once, then\n * `emit({ action })` per interaction. No-ops entirely when trackingId is absent,\n * so instrumentation is opt-in and attributable.\n *\n * @param component - the emitting component's name, e.g. 'MrlButton'\n * @param trackingId - consumer-supplied, non-PII id; undefined disables emission\n * @returns an `emit` callback that fires a single interaction per call\n */\nexport const useMrlTrackInteraction = (component: string, trackingId?: string) => {\n\tconst { track } = useMrlAnalytics();\n\n\treturn React.useCallback(\n\t\t({ action, variant, metadata }: EmitArgs) => {\n\t\t\t// opt-in: no id → no event (volume + PII guard)\n\t\t\tif (!trackingId) return;\n\t\t\ttry {\n\t\t\t\ttrack({\n\t\t\t\t\taction,\n\t\t\t\t\tcomponent,\n\t\t\t\t\tmetadata,\n\t\t\t\t\ttoolkitVersion: TOOLKIT_VERSION,\n\t\t\t\t\ttrackingId,\n\t\t\t\t\tvariant\n\t\t\t\t});\n\t\t\t} catch (e) {\n\t\t\t\t// Ensure errors don't break the app\n\t\t\t\treturn e;\n\t\t\t}\n\t\t},\n\t\t[track, component, trackingId]\n\t);\n};\n"],"names":["useMrlAnalytics","React","useContext","MrlAnalyticsContext","useMrlTrackInteraction","component","trackingId","_useMrlAnalytics","track","useCallback","_ref","action","variant","metadata","toolkitVersion","TOOLKIT_VERSION","e"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAKA;AACA;AACA;AACA;AACA;AACO,IAAMA,eAAe,GAAGA,MAA2BC,gBAAK,CAACC,UAAU,CAACC,uCAAmB;AAI9F;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACaC,sBAAsB,GAAGA,CAACC,SAAiB,EAAEC,UAAmB,KAAK;AACjF,EAAA,IAAAC,gBAAA,GAAkBP,eAAe,EAAE;IAA3BQ,KAAK,GAAAD,gBAAA,CAALC,KAAK;AAEb,EAAA,OAAOP,gBAAK,CAACQ,WAAW,CACvBC,IAAA,IAA6C;AAAA,IAAA,IAA1CC,MAAM,GAAAD,IAAA,CAANC,MAAM;MAAEC,OAAO,GAAAF,IAAA,CAAPE,OAAO;MAAEC,QAAQ,GAAAH,IAAA,CAARG,QAAQ;AAC3B;IACA,IAAI,CAACP,UAAU,EAAE;IACjB,IAAI;AACHE,MAAAA,KAAK,CAAC;QACLG,MAAM;QACNN,SAAS;QACTQ,QAAQ;AACRC,QAAAA,cAAc,EAAEC,uBAAe;QAC/BT,UAAU;AACVM,QAAAA;AACD,OAAC,CAAC;IACH,CAAC,CAAC,OAAOI,CAAC,EAAE;AACX;AACA,MAAA,OAAOA,CAAC;AACT,IAAA;EACD,CAAC,EACD,CAACR,KAAK,EAAEH,SAAS,EAAEC,UAAU,CAC9B,CAAC;AACF;;;;;"}
@@ -1,6 +0,0 @@
1
- 'use strict';
2
-
3
- var TOOLKIT_VERSION = "4.71.0-dev-nBIF.1";
4
-
5
- exports.TOOLKIT_VERSION = TOOLKIT_VERSION;
6
- //# sourceMappingURL=version.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"version.js","sources":["../../src/version.ts"],"sourcesContent":["export const TOOLKIT_VERSION = \"4.71.0-dev-nBIF.1\";"],"names":["TOOLKIT_VERSION"],"mappings":";;AAAO,IAAMA,eAAe,GAAG;;;;"}
@@ -1,25 +0,0 @@
1
- import * as React from 'react';
2
- import { MrlTrack } from './types';
3
- export interface MrlAnalyticsContextProps {
4
- track: MrlTrack;
5
- }
6
- export declare const MrlAnalyticsContext: React.Context<MrlAnalyticsContextProps>;
7
- export interface MrlAnalyticsProviderProps {
8
- /**
9
- * The transport the app injects. Receives a MrlAnalyticsEvent and forwards it
10
- * wherever the app tracks (in murally: a wrapper over trackWithSegment).
11
- * Omit it and the toolkit stays silent — safe for consumers with no analytics.
12
- */
13
- track?: MrlTrack;
14
- children: React.ReactNode;
15
- }
16
- /**
17
- * Injects the app's analytics transport into the toolkit. Wrap the app once;
18
- * every instrumented Mrl* component below emits through the provided `track`.
19
- *
20
- * @param props - the provider props
21
- * @param props.track - the transport that receives each MrlAnalyticsEvent (default no-op)
22
- * @param props.children - the subtree that can emit analytics
23
- * @returns the provider wrapping `children`
24
- */
25
- export declare const MrlAnalyticsProvider: ({ track, children }: MrlAnalyticsProviderProps) => React.JSX.Element;
@@ -1,2 +0,0 @@
1
- export * from './MrlAnalyticsContext';
2
- export * from './types';
@@ -1,22 +0,0 @@
1
- /** Values allowed in analytics payloads. No free-text/PII — see MrlAnalyticsProvider docs. */
2
- export type MrlAnalyticsValue = string | number | boolean;
3
- /** The canonical interaction a Mrl* component emits. Transport-agnostic. */
4
- export interface MrlAnalyticsEvent {
5
- /** Component identity, e.g. 'MrlButton', 'MrlMenu', 'MrlModal'. Set by the component. */
6
- component: string;
7
- /** Interaction type, e.g. 'click' | 'open' | 'close' | 'select' | 'change'. Set by the component. */
8
- action: string;
9
- /** ui-toolkit version for internal tracking */
10
- toolkitVersion: string;
11
- /**
12
- * Consumer-supplied attribution id. REQUIRED for an event to fire (opt-in).
13
- * Must be a stable, non-PII identifier (e.g. 'board-share', not the user's name).
14
- */
15
- trackingId: string;
16
- /** Non-PII component variant, e.g. button kind/size. Set by the component. */
17
- variant?: string;
18
- /** Curated, non-PII extra context. Never button labels, input values, etc. */
19
- metadata?: Record<string, MrlAnalyticsValue>;
20
- }
21
- /** The one function the toolkit calls. The app decides what it does. */
22
- export type MrlTrack = (event: MrlAnalyticsEvent) => void;
@@ -1,32 +0,0 @@
1
- import * as React from 'react';
2
- import { createContext } from 'react';
3
- import { noop } from '../../utils/noop/index.js';
4
-
5
- /** Default is a no-op: components emit nothing until a consumer provides `track`. */
6
- var initialContext = {
7
- track: noop
8
- };
9
- var MrlAnalyticsContext = /*#__PURE__*/createContext(initialContext);
10
- /**
11
- * Injects the app's analytics transport into the toolkit. Wrap the app once;
12
- * every instrumented Mrl* component below emits through the provided `track`.
13
- *
14
- * @param props - the provider props
15
- * @param props.track - the transport that receives each MrlAnalyticsEvent (default no-op)
16
- * @param props.children - the subtree that can emit analytics
17
- * @returns the provider wrapping `children`
18
- */
19
- var MrlAnalyticsProvider = _ref => {
20
- var track = _ref.track,
21
- children = _ref.children;
22
- // Stable identity so consumers don't re-render every child on each parent render.
23
- var value = React.useMemo(() => ({
24
- track: track !== null && track !== void 0 ? track : noop
25
- }), [track]);
26
- return /*#__PURE__*/React.createElement(MrlAnalyticsContext.Provider, {
27
- value: value
28
- }, children);
29
- };
30
-
31
- export { MrlAnalyticsContext, MrlAnalyticsProvider };
32
- //# sourceMappingURL=MrlAnalyticsContext.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"MrlAnalyticsContext.js","sources":["../../../../src/contexts/MrlAnalyticsContext/MrlAnalyticsContext.tsx"],"sourcesContent":["import * as React from 'react';\nimport { createContext } from 'react';\nimport { noop } from '../../utils';\nimport { MrlTrack } from './types';\n\nexport interface MrlAnalyticsContextProps {\n\ttrack: MrlTrack;\n}\n\n/** Default is a no-op: components emit nothing until a consumer provides `track`. */\nconst initialContext: MrlAnalyticsContextProps = {\n\ttrack: noop\n};\n\nexport const MrlAnalyticsContext = createContext<MrlAnalyticsContextProps>(initialContext);\n\nexport interface MrlAnalyticsProviderProps {\n\t/**\n\t * The transport the app injects. Receives a MrlAnalyticsEvent and forwards it\n\t * wherever the app tracks (in murally: a wrapper over trackWithSegment).\n\t * Omit it and the toolkit stays silent — safe for consumers with no analytics.\n\t */\n\ttrack?: MrlTrack;\n\tchildren: React.ReactNode;\n}\n\n/**\n * Injects the app's analytics transport into the toolkit. Wrap the app once;\n * every instrumented Mrl* component below emits through the provided `track`.\n *\n * @param props - the provider props\n * @param props.track - the transport that receives each MrlAnalyticsEvent (default no-op)\n * @param props.children - the subtree that can emit analytics\n * @returns the provider wrapping `children`\n */\nexport const MrlAnalyticsProvider = ({ track, children }: MrlAnalyticsProviderProps) => {\n\t// Stable identity so consumers don't re-render every child on each parent render.\n\tconst value = React.useMemo<MrlAnalyticsContextProps>(() => ({ track: track ?? noop }), [track]);\n\n\treturn <MrlAnalyticsContext.Provider value={value}>{children}</MrlAnalyticsContext.Provider>;\n};\n"],"names":["initialContext","track","noop","MrlAnalyticsContext","createContext","MrlAnalyticsProvider","_ref","children","value","React","useMemo","createElement","Provider"],"mappings":";;;;AASA;AACA,IAAMA,cAAwC,GAAG;AAChDC,EAAAA,KAAK,EAAEC;AACR,CAAC;IAEYC,mBAAmB,gBAAGC,aAAa,CAA2BJ,cAAc;AAYzF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,IAAMK,oBAAoB,GAAGC,IAAA,IAAoD;AAAA,EAAA,IAAjDL,KAAK,GAAAK,IAAA,CAALL,KAAK;IAAEM,QAAQ,GAAAD,IAAA,CAARC,QAAQ;AACrD;AACA,EAAA,IAAMC,KAAK,GAAGC,KAAK,CAACC,OAAO,CAA2B,OAAO;AAAET,IAAAA,KAAK,EAAEA,KAAK,KAAA,IAAA,IAALA,KAAK,KAAA,MAAA,GAALA,KAAK,GAAIC;AAAK,GAAC,CAAC,EAAE,CAACD,KAAK,CAAC,CAAC;AAEhG,EAAA,oBAAOQ,KAAA,CAAAE,aAAA,CAACR,mBAAmB,CAACS,QAAQ,EAAA;AAACJ,IAAAA,KAAK,EAAEA;AAAM,GAAA,EAAED,QAAuC,CAAC;AAC7F;;;;"}
@@ -1,46 +0,0 @@
1
- import * as React from 'react';
2
- import { TOOLKIT_VERSION } from '../../version.js';
3
- import { MrlAnalyticsContext } from '../../contexts/MrlAnalyticsContext/MrlAnalyticsContext.js';
4
-
5
- /**
6
- * Raw accessor for the analytics context.
7
- *
8
- * @returns the injected `track` transport (default no-op)
9
- */
10
- var useMrlAnalytics = () => React.useContext(MrlAnalyticsContext);
11
- /**
12
- * Component-facing helper. Binds component identity + trackingId once, then
13
- * `emit({ action })` per interaction. No-ops entirely when trackingId is absent,
14
- * so instrumentation is opt-in and attributable.
15
- *
16
- * @param component - the emitting component's name, e.g. 'MrlButton'
17
- * @param trackingId - consumer-supplied, non-PII id; undefined disables emission
18
- * @returns an `emit` callback that fires a single interaction per call
19
- */
20
- var useMrlTrackInteraction = (component, trackingId) => {
21
- var _useMrlAnalytics = useMrlAnalytics(),
22
- track = _useMrlAnalytics.track;
23
- return React.useCallback(_ref => {
24
- var action = _ref.action,
25
- variant = _ref.variant,
26
- metadata = _ref.metadata;
27
- // opt-in: no id → no event (volume + PII guard)
28
- if (!trackingId) return;
29
- try {
30
- track({
31
- action,
32
- component,
33
- metadata,
34
- toolkitVersion: TOOLKIT_VERSION,
35
- trackingId,
36
- variant
37
- });
38
- } catch (e) {
39
- // Ensure errors don't break the app
40
- return e;
41
- }
42
- }, [track, component, trackingId]);
43
- };
44
-
45
- export { useMrlAnalytics, useMrlTrackInteraction };
46
- //# sourceMappingURL=useMrlAnalytics.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"useMrlAnalytics.js","sources":["../../../../src/hooks/useMrlAnalytics/useMrlAnalytics.ts"],"sourcesContent":["import * as React from 'react';\nimport { MrlAnalyticsContext } from '../../contexts/MrlAnalyticsContext';\nimport { MrlAnalyticsEvent, MrlTrack } from '../../contexts/MrlAnalyticsContext/types';\nimport { TOOLKIT_VERSION } from '../../version';\n\n/**\n * Raw accessor for the analytics context.\n *\n * @returns the injected `track` transport (default no-op)\n */\nexport const useMrlAnalytics = (): { track: MrlTrack } => React.useContext(MrlAnalyticsContext);\n\ntype EmitArgs = Pick<MrlAnalyticsEvent, 'action' | 'variant' | 'metadata'>;\n\n/**\n * Component-facing helper. Binds component identity + trackingId once, then\n * `emit({ action })` per interaction. No-ops entirely when trackingId is absent,\n * so instrumentation is opt-in and attributable.\n *\n * @param component - the emitting component's name, e.g. 'MrlButton'\n * @param trackingId - consumer-supplied, non-PII id; undefined disables emission\n * @returns an `emit` callback that fires a single interaction per call\n */\nexport const useMrlTrackInteraction = (component: string, trackingId?: string) => {\n\tconst { track } = useMrlAnalytics();\n\n\treturn React.useCallback(\n\t\t({ action, variant, metadata }: EmitArgs) => {\n\t\t\t// opt-in: no id → no event (volume + PII guard)\n\t\t\tif (!trackingId) return;\n\t\t\ttry {\n\t\t\t\ttrack({\n\t\t\t\t\taction,\n\t\t\t\t\tcomponent,\n\t\t\t\t\tmetadata,\n\t\t\t\t\ttoolkitVersion: TOOLKIT_VERSION,\n\t\t\t\t\ttrackingId,\n\t\t\t\t\tvariant\n\t\t\t\t});\n\t\t\t} catch (e) {\n\t\t\t\t// Ensure errors don't break the app\n\t\t\t\treturn e;\n\t\t\t}\n\t\t},\n\t\t[track, component, trackingId]\n\t);\n};\n"],"names":["useMrlAnalytics","React","useContext","MrlAnalyticsContext","useMrlTrackInteraction","component","trackingId","_useMrlAnalytics","track","useCallback","_ref","action","variant","metadata","toolkitVersion","TOOLKIT_VERSION","e"],"mappings":";;;;AAKA;AACA;AACA;AACA;AACA;AACO,IAAMA,eAAe,GAAGA,MAA2BC,KAAK,CAACC,UAAU,CAACC,mBAAmB;AAI9F;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACaC,sBAAsB,GAAGA,CAACC,SAAiB,EAAEC,UAAmB,KAAK;AACjF,EAAA,IAAAC,gBAAA,GAAkBP,eAAe,EAAE;IAA3BQ,KAAK,GAAAD,gBAAA,CAALC,KAAK;AAEb,EAAA,OAAOP,KAAK,CAACQ,WAAW,CACvBC,IAAA,IAA6C;AAAA,IAAA,IAA1CC,MAAM,GAAAD,IAAA,CAANC,MAAM;MAAEC,OAAO,GAAAF,IAAA,CAAPE,OAAO;MAAEC,QAAQ,GAAAH,IAAA,CAARG,QAAQ;AAC3B;IACA,IAAI,CAACP,UAAU,EAAE;IACjB,IAAI;AACHE,MAAAA,KAAK,CAAC;QACLG,MAAM;QACNN,SAAS;QACTQ,QAAQ;AACRC,QAAAA,cAAc,EAAEC,eAAe;QAC/BT,UAAU;AACVM,QAAAA;AACD,OAAC,CAAC;IACH,CAAC,CAAC,OAAOI,CAAC,EAAE;AACX;AACA,MAAA,OAAOA,CAAC;AACT,IAAA;EACD,CAAC,EACD,CAACR,KAAK,EAAEH,SAAS,EAAEC,UAAU,CAC9B,CAAC;AACF;;;;"}
@@ -1,4 +0,0 @@
1
- var TOOLKIT_VERSION = "4.71.0-dev-nBIF.1";
2
-
3
- export { TOOLKIT_VERSION };
4
- //# sourceMappingURL=version.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"version.js","sources":["../../src/version.ts"],"sourcesContent":["export const TOOLKIT_VERSION = \"4.71.0-dev-nBIF.1\";"],"names":["TOOLKIT_VERSION"],"mappings":"AAAO,IAAMA,eAAe,GAAG;;;;"}
@@ -1 +0,0 @@
1
- export * from './useMrlAnalytics';
@@ -1,21 +0,0 @@
1
- import { MrlAnalyticsEvent, MrlTrack } from '../../contexts/MrlAnalyticsContext/types';
2
- /**
3
- * Raw accessor for the analytics context.
4
- *
5
- * @returns the injected `track` transport (default no-op)
6
- */
7
- export declare const useMrlAnalytics: () => {
8
- track: MrlTrack;
9
- };
10
- type EmitArgs = Pick<MrlAnalyticsEvent, 'action' | 'variant' | 'metadata'>;
11
- /**
12
- * Component-facing helper. Binds component identity + trackingId once, then
13
- * `emit({ action })` per interaction. No-ops entirely when trackingId is absent,
14
- * so instrumentation is opt-in and attributable.
15
- *
16
- * @param component - the emitting component's name, e.g. 'MrlButton'
17
- * @param trackingId - consumer-supplied, non-PII id; undefined disables emission
18
- * @returns an `emit` callback that fires a single interaction per call
19
- */
20
- export declare const useMrlTrackInteraction: (component: string, trackingId?: string) => ({ action, variant, metadata }: EmitArgs) => unknown;
21
- export {};
@@ -1,8 +0,0 @@
1
- /**
2
- * Demo for the useMrlAnalytics hooks. Injects a `track` transport that simply
3
- * records the last emitted event so you can see the transport-agnostic
4
- * `MrlAnalyticsEvent` the toolkit produces.
5
- *
6
- * @returns JSX.Element
7
- */
8
- export declare const UseMrlAnalyticsDemo: () => JSX.Element;
@@ -1,25 +0,0 @@
1
- import * as React from 'react';
2
- import { MrlTrack } from './types';
3
- export interface MrlAnalyticsContextProps {
4
- track: MrlTrack;
5
- }
6
- export declare const MrlAnalyticsContext: React.Context<MrlAnalyticsContextProps>;
7
- export interface MrlAnalyticsProviderProps {
8
- /**
9
- * The transport the app injects. Receives a MrlAnalyticsEvent and forwards it
10
- * wherever the app tracks (in murally: a wrapper over trackWithSegment).
11
- * Omit it and the toolkit stays silent — safe for consumers with no analytics.
12
- */
13
- track?: MrlTrack;
14
- children: React.ReactNode;
15
- }
16
- /**
17
- * Injects the app's analytics transport into the toolkit. Wrap the app once;
18
- * every instrumented Mrl* component below emits through the provided `track`.
19
- *
20
- * @param props - the provider props
21
- * @param props.track - the transport that receives each MrlAnalyticsEvent (default no-op)
22
- * @param props.children - the subtree that can emit analytics
23
- * @returns the provider wrapping `children`
24
- */
25
- export declare const MrlAnalyticsProvider: ({ track, children }: MrlAnalyticsProviderProps) => React.JSX.Element;
@@ -1,2 +0,0 @@
1
- export * from './MrlAnalyticsContext';
2
- export * from './types';
@@ -1,22 +0,0 @@
1
- /** Values allowed in analytics payloads. No free-text/PII — see MrlAnalyticsProvider docs. */
2
- export type MrlAnalyticsValue = string | number | boolean;
3
- /** The canonical interaction a Mrl* component emits. Transport-agnostic. */
4
- export interface MrlAnalyticsEvent {
5
- /** Component identity, e.g. 'MrlButton', 'MrlMenu', 'MrlModal'. Set by the component. */
6
- component: string;
7
- /** Interaction type, e.g. 'click' | 'open' | 'close' | 'select' | 'change'. Set by the component. */
8
- action: string;
9
- /** ui-toolkit version for internal tracking */
10
- toolkitVersion: string;
11
- /**
12
- * Consumer-supplied attribution id. REQUIRED for an event to fire (opt-in).
13
- * Must be a stable, non-PII identifier (e.g. 'board-share', not the user's name).
14
- */
15
- trackingId: string;
16
- /** Non-PII component variant, e.g. button kind/size. Set by the component. */
17
- variant?: string;
18
- /** Curated, non-PII extra context. Never button labels, input values, etc. */
19
- metadata?: Record<string, MrlAnalyticsValue>;
20
- }
21
- /** The one function the toolkit calls. The app decides what it does. */
22
- export type MrlTrack = (event: MrlAnalyticsEvent) => void;
@@ -1 +0,0 @@
1
- export * from './useMrlAnalytics';
@@ -1,21 +0,0 @@
1
- import { MrlAnalyticsEvent, MrlTrack } from '../../contexts/MrlAnalyticsContext/types';
2
- /**
3
- * Raw accessor for the analytics context.
4
- *
5
- * @returns the injected `track` transport (default no-op)
6
- */
7
- export declare const useMrlAnalytics: () => {
8
- track: MrlTrack;
9
- };
10
- type EmitArgs = Pick<MrlAnalyticsEvent, 'action' | 'variant' | 'metadata'>;
11
- /**
12
- * Component-facing helper. Binds component identity + trackingId once, then
13
- * `emit({ action })` per interaction. No-ops entirely when trackingId is absent,
14
- * so instrumentation is opt-in and attributable.
15
- *
16
- * @param component - the emitting component's name, e.g. 'MrlButton'
17
- * @param trackingId - consumer-supplied, non-PII id; undefined disables emission
18
- * @returns an `emit` callback that fires a single interaction per call
19
- */
20
- export declare const useMrlTrackInteraction: (component: string, trackingId?: string) => ({ action, variant, metadata }: EmitArgs) => unknown;
21
- export {};
@@ -1,8 +0,0 @@
1
- /**
2
- * Demo for the useMrlAnalytics hooks. Injects a `track` transport that simply
3
- * records the last emitted event so you can see the transport-agnostic
4
- * `MrlAnalyticsEvent` the toolkit produces.
5
- *
6
- * @returns JSX.Element
7
- */
8
- export declare const UseMrlAnalyticsDemo: () => JSX.Element;
@@ -1 +0,0 @@
1
- export declare const TOOLKIT_VERSION = "0.0.0-dev";
package/dist/version.d.ts DELETED
@@ -1 +0,0 @@
1
- export declare const TOOLKIT_VERSION = "0.0.0-dev";