@sprucelabs/spruce-heartwood-utils 38.17.7 → 38.17.8

package/README.md

@@ -59,7 +59,6 @@ import {
     AutoLogoutPlugin,
     loadActiveThemeForOrg,
     Sizer,
-    SimpleEmitter,
 } from '@sprucelabs/spruce-heartwood-utils/web'
 ```
 
@@ -675,7 +674,6 @@ import {
     // Utilities
     sizeUtil, Settings,
     // Emitter — pass to Sizer and DelayedPlacer to coordinate layout events
-    SimpleEmitter,
     // Types
     AnimationEmitter,
     SizerProps,
@@ -773,15 +771,15 @@ Pass the **same emitter instance** to `Sizer` and `DelayedPlacer` when they are
 
 ### AnimationEmitter
 
-The interface `Sizer` and `DelayedPlacer` use to communicate layout-change events. Pass an instance as the `emitter` prop to coordinate components. The package exports `SimpleEmitter` — a lightweight in-memory implementation you can use directly:
+The interface `Sizer` and `DelayedPlacer` use to communicate layout-change events. Pass an instance as the `emitter` prop to coordinate components. The package exports `SkillViewEmitter` for this:
 
 ```ts
-import { SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
+import { SkillViewEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
 
-const emitter = new SimpleEmitter()
+const emitter = SkillViewEmitter.getInstance()
 ```
 
-`SimpleEmitter` implements all three methods (`on`, `off`, `emit`) with a plain listener map. Use it for standalone components, isolated tests, or any context where a full Heartwood emitter is not available.
+`SkillViewEmitter` implements all three methods (`on`, `off`, `emit`) needed by `AnimationEmitter`.
 
 The `AnimationEmitter` interface, for reference:
 
@@ -804,9 +802,9 @@ interface AnimationEmitter {
 2. **Create an emitter** — one per component tree, stable across renders:
 
    ```ts
-   import { SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
+   import { SkillViewEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
 
-   const emitter = useMemo(() => new SimpleEmitter(), [])
+   const emitter = useMemo(() => SkillViewEmitter.getInstance(), [])
    ```
 
 3. **Wire to components and emit events** — pass the emitter to `Sizer` and/or `DelayedPlacer`, then signal layout changes:
@@ -1074,9 +1072,9 @@ Wraps children in a div whose `height` is set via inline style to match the meas
 2. **Wrap your content** — `shouldHideOverflow` clips children during the height transition:
 
    ```tsx
-   import { Sizer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
+   import { Sizer } from '@sprucelabs/spruce-heartwood-utils/web'
 
-   const emitter = useMemo(() => new SimpleEmitter(), [])
+   const emitter = useMemo(() => SkillViewEmitter.getInstance(), [])
 
    <Sizer emitter={emitter} shouldHideOverflow>
        <YourContent />
@@ -1142,7 +1140,7 @@ sizer.current?.hideOverflow(): void // re-apply overflow: hidden
 #### Usage
 
 ```tsx
-import { Sizer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
+import { Sizer } from '@sprucelabs/spruce-heartwood-utils/web'
 
 // Simplest — just clip overflow during height transition:
 <Sizer shouldHideOverflow>
@@ -1155,7 +1153,7 @@ import { Sizer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
 </Sizer>
 
 // Manually trigger resize when content changes outside React state:
-const emitter = useMemo(() => new SimpleEmitter(), [])
+const emitter = useMemo(() => SkillViewEmitter.getInstance(), [])
 const sizer = useRef<React.ElementRef<typeof Sizer>>(null)
 
 <Sizer shouldHideOverflow ref={sizer} emitter={emitter}>
@@ -1204,9 +1202,9 @@ When `isEnabled={false}`, children render inline with no wrapper.
 2. **Wrap your content** — `isEnabled`, `className`, and `isFocused` are all required:
 
    ```tsx
-   import { DelayedPlacer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
+   import { DelayedPlacer } from '@sprucelabs/spruce-heartwood-utils/web'
 
-   const emitter = useMemo(() => new SimpleEmitter(), [])
+   const emitter = useMemo(() => SkillViewEmitter.getInstance(), [])
 
    <DelayedPlacer
        className="placer__card"
@@ -1274,11 +1272,11 @@ delayedPlacer.current?.placeRightAway(): void  // re-measure and re-place immedi
 
 ```tsx
 import React, { useRef, useMemo } from 'react'
-import { DelayedPlacer, SimpleEmitter } from '@sprucelabs/spruce-heartwood-utils/web'
+import { DelayedPlacer } from '@sprucelabs/spruce-heartwood-utils/web'
 
 function YourPanel({ isFocused }: { isFocused: () => boolean }) {
     const placerRef = useRef<React.ElementRef<typeof DelayedPlacer>>(null)
-    const emitter = useMemo(() => new SimpleEmitter(), [])
+    const emitter = useMemo(() => SkillViewEmitter.getInstance(), [])
 
     return (
         <DelayedPlacer
@@ -1365,11 +1363,11 @@ A complete example showing all three systems working together in a card componen
 ```tsx
 import React, { useMemo } from 'react'
 import {
-    Sizer, DelayedPlacer, queueShow, Settings, SimpleEmitter,
+    Sizer, DelayedPlacer, queueShow, Settings,
 } from '@sprucelabs/spruce-heartwood-utils/web'
 
 function YourCard({ isPlaced, isFocused }: { isPlaced: boolean; isFocused: () => boolean }) {
-    const emitter = useMemo(() => new SimpleEmitter(), [])
+    const emitter = useMemo(() => SkillViewEmitter.getInstance(), [])
 
     return (
         <DelayedPlacer

package/build/components/animation/index.d.ts

@@ -6,4 +6,3 @@ export type { DelayedPlacerProps } from './DelayedPlacerExport';
 export { default as sizeUtil } from '../calendars/utils/size.utility';
 export { default as Settings } from '../Settings';
 export type { AnimationEmitter } from './types';
-export { default as SimpleEmitter } from './SimpleEmitter';

package/build/components/animation/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SimpleEmitter = exports.Settings = exports.sizeUtil = exports.DelayedPlacer = exports.Sizer = exports.stopQueue = exports.clearPendingShowAndQueueHide = exports.clearPendingHideAndQueueShow = exports.callbackImmediately = exports.queueCallback = exports.queueHide = exports.queueShow = exports.hideRightAway = exports.showRightAway = exports.useShowNow = exports.useQueueShow = void 0;
+exports.Settings = exports.sizeUtil = exports.DelayedPlacer = exports.Sizer = exports.stopQueue = exports.clearPendingShowAndQueueHide = exports.clearPendingHideAndQueueShow = exports.callbackImmediately = exports.queueCallback = exports.queueHide = exports.queueShow = exports.hideRightAway = exports.showRightAway = exports.useShowNow = exports.useQueueShow = void 0;
 // Queue system — all functions and hooks
 var queueShow_1 = require("../../hooks/queueShow");
 Object.defineProperty(exports, "useQueueShow", { enumerable: true, get: function () { return queueShow_1.useQueueShow; } });
@@ -27,6 +27,4 @@ var size_utility_1 = require("../calendars/utils/size.utility");
 Object.defineProperty(exports, "sizeUtil", { enumerable: true, get: function () { return __importDefault(size_utility_1).default; } });
 var Settings_1 = require("../Settings");
 Object.defineProperty(exports, "Settings", { enumerable: true, get: function () { return __importDefault(Settings_1).default; } });
-var SimpleEmitter_1 = require("./SimpleEmitter");
-Object.defineProperty(exports, "SimpleEmitter", { enumerable: true, get: function () { return __importDefault(SimpleEmitter_1).default; } });
 //# sourceMappingURL=index.js.map

package/build/esm/components/animation/index.d.ts

@@ -6,4 +6,3 @@ export type { DelayedPlacerProps } from './DelayedPlacerExport';
 export { default as sizeUtil } from '../calendars/utils/size.utility';
 export { default as Settings } from '../Settings';
 export type { AnimationEmitter } from './types';
-export { default as SimpleEmitter } from './SimpleEmitter';

package/build/esm/components/animation/index.js

@@ -6,4 +6,3 @@ export { default as DelayedPlacer } from './DelayedPlacerExport.js';
 // Utilities (useful for consumers who want to measure DOM nodes)
 export { default as sizeUtil } from '../calendars/utils/size.utility.js';
 export { default as Settings } from '../Settings.js';
-export { default as SimpleEmitter } from './SimpleEmitter.js';

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@sprucelabs/spruce-heartwood-utils",
 	"description": "Heartwood Utilities",
-	"version": "38.17.7",
+	"version": "38.17.8",
 	"skill": {
 		"namespace": "heartwood"
 	},