@blac/core 2.0.0-rc-2 → 2.0.0-rc-4

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.
package/README.md CHANGED
@@ -47,34 +47,37 @@ class CounterCubit extends Cubit<number> {
47
47
  }
48
48
  ```
49
49
 
50
- **Bloc**: More powerful state container with a reducer pattern for action-based state transitions.
50
+ **Bloc**: More powerful state container that uses an event-handler pattern for type-safe, event-driven state transitions. Events (instances of classes) are dispatched via `this.add()`, and handlers are registered using `this.on(EventClass, handler)`.
51
51
 
52
52
  ```typescript
53
- // Define actions
54
- type CounterAction =
55
- | { type: 'increment', amount: number }
56
- | { type: 'decrement', amount: number };
53
+ // Define event classes
54
+ class IncrementEvent { constructor(public readonly amount: number = 1) {} }
55
+ class DecrementEvent { constructor(public readonly amount: number = 1) {} }
57
56
 
58
- class CounterBloc extends Bloc<number, CounterAction> {
57
+ // Optional: Union type for all events
58
+ type CounterEvent = IncrementEvent | DecrementEvent;
59
+
60
+ class CounterBloc extends Bloc<number, CounterEvent> {
59
61
  constructor() {
60
62
  super(0); // Initial state
61
- }
62
63
 
63
- reducer = (action: CounterAction, state: number): number => {
64
- switch (action.type) {
65
- case 'increment':
66
- return state + action.amount;
67
- case 'decrement':
68
- return state - action.amount;
69
- }
64
+ // Register event handlers
65
+ this.on(IncrementEvent, (event, emit) => {
66
+ emit(this.state + event.amount);
67
+ });
68
+
69
+ this.on(DecrementEvent, (event, emit) => {
70
+ emit(this.state - event.amount);
71
+ });
70
72
  }
71
73
 
74
+ // Helper methods to dispatch event instances (optional)
72
75
  increment = (amount = 1) => {
73
- this.add({ type: 'increment', amount });
76
+ this.add(new IncrementEvent(amount));
74
77
  }
75
78
 
76
79
  decrement = (amount = 1) => {
77
- this.add({ type: 'decrement', amount });
80
+ this.add(new DecrementEvent(amount));
78
81
  }
79
82
  }
80
83
  ```
@@ -180,47 +183,52 @@ interface UserProfileState {
180
183
  error: string | null;
181
184
  }
182
185
 
183
- // Define actions (if any, for this example we'll focus on constructor and an async method)
184
- type UserProfileAction = { type: 'dataLoaded', data: any } | { type: 'error', error: string };
186
+ // Define Event Classes for UserProfileBloc
187
+ class UserProfileFetchEvent {}
188
+ class UserProfileDataLoadedEvent { constructor(public readonly data: any) {} }
189
+ class UserProfileErrorEvent { constructor(public readonly error: string) {} }
185
190
 
186
- class UserProfileBloc extends Bloc<UserProfileState, UserProfileAction> {
191
+ type UserProfileEvents = UserProfileFetchEvent | UserProfileDataLoadedEvent | UserProfileErrorEvent;
192
+
193
+ class UserProfileBloc extends Bloc<UserProfileState, UserProfileEvents, UserProfileProps> {
187
194
  private userId: string;
188
195
 
189
- // The Blac library or its React bindings (like @blac/react)
190
- // might provide a way to pass these props during instantiation.
191
- // For example, `useBloc(UserProfileBloc, { props: { userId: '123' } })`
192
196
  constructor(props: UserProfileProps) {
193
197
  super({ loading: true, userData: null, error: null }); // Initial state
194
198
  this.userId = props.userId;
195
- // Optional: Set a dynamic name for easier debugging with multiple instances
196
- this._name = `UserProfileBloc_${this.userId}`;
197
- this.fetchUserProfile();
198
- }
199
-
200
- // Example reducer
201
- reducer = (action: UserProfileAction, state: UserProfileState): UserProfileState => {
202
- switch (action.type) {
203
- case 'dataLoaded':
204
- return { ...state, loading: false, userData: action.data, error: null };
205
- case 'error':
206
- return { ...state, loading: false, error: action.error };
207
- default:
208
- return state;
209
- }
199
+ this._name = `UserProfileBloc_${this.userId}`;
200
+
201
+ // Register event handlers
202
+ this.on(UserProfileFetchEvent, this.handleFetchUserProfile);
203
+ this.on(UserProfileDataLoadedEvent, (event, emit) => {
204
+ emit({ ...this.state, loading: false, userData: event.data, error: null });
205
+ });
206
+ this.on(UserProfileErrorEvent, (event, emit) => {
207
+ emit({ ...this.state, loading: false, error: event.error });
208
+ });
209
+
210
+ // Initial fetch
211
+ this.add(new UserProfileFetchEvent());
210
212
  }
211
213
 
212
- fetchUserProfile = async ()_ => {
213
- this.emit({ ...this.state, loading: true }); // Set loading true before fetch
214
+ private handleFetchUserProfile = async (_event: UserProfileFetchEvent, emit: (state: UserProfileState) => void) => {
215
+ // Emit loading state directly if not already covered by initial state or another event
216
+ // For this example, constructor sets loading: true, so an immediate emit here might be redundant
217
+ // unless an event handler could set loading to false before this runs.
218
+ // emit({ ...this.state, loading: true }); // Ensure loading is true
214
219
  try {
215
- // Simulate an API call
216
- await new Promise(resolve => setTimeout(resolve, 1000));
220
+ await new Promise(resolve => setTimeout(resolve, 1000)); // Simulate API call
217
221
  const mockUserData = { id: this.userId, name: `User ${this.userId}`, bio: 'Loves Blac states!' };
218
- // Dispatch an action or directly emit a new state
219
- this.add({ type: 'dataLoaded', data: mockUserData });
222
+ this.add(new UserProfileDataLoadedEvent(mockUserData));
220
223
  } catch (e:any) {
221
- this.add({ type: 'error', error: e.message || 'Failed to fetch user profile' });
224
+ this.add(new UserProfileErrorEvent(e.message || 'Failed to fetch user profile'));
222
225
  }
223
226
  }
227
+
228
+ // Public method to re-trigger fetch if needed
229
+ refetchUserProfile = () => {
230
+ this.add(new UserProfileFetchEvent());
231
+ }
224
232
  }
225
233
  ```
226
234
 
@@ -230,7 +238,7 @@ class UserProfileBloc extends Bloc<UserProfileState, UserProfileAction> {
230
238
 
231
239
  - `BlocBase<S, P>`: Base class for state containers
232
240
  - `Cubit<S, P>`: Simple state container with `emit()` and `patch()`
233
- - `Bloc<S, A, P>`: Action-based state container with a reducer pattern
241
+ - `Bloc<S, E, P>`: Event-driven state container with `on(EventClass, handler)` and `add(eventInstance)` methods.
234
242
  - `Blac`: Singleton manager for all Bloc instances
235
243
 
236
244
  ### React Hooks
package/dist/index.cjs.js CHANGED
@@ -1,2 +1,2 @@
1
- "use strict";var m=Object.defineProperty;var D=(c,t,e)=>t in c?m(c,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):c[t]=e;var n=(c,t,e)=>D(c,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var g=(c=>(c.BLOC_DISPOSED="BLOC_DISPOSED",c.BLOC_CREATED="BLOC_CREATED",c.LISTENER_REMOVED="LISTENER_REMOVED",c.LISTENER_ADDED="LISTENER_ADDED",c.STATE_CHANGED="STATE_CHANGED",c.BLOC_CONSUMER_REMOVED="BLOC_CONSUMER_REMOVED",c.BLOC_CONSUMER_ADDED="BLOC_CONSUMER_ADDED",c))(g||{});const r=class r{constructor(t={}){n(this,"createdAt",Date.now());n(this,"blocInstanceMap",new Map);n(this,"isolatedBlocMap",new Map);n(this,"pluginList",[]);n(this,"postChangesToDocument",!1);n(this,"log",(...t)=>{r.enableLog&&console.warn(`☢️ [Blac ${this.createdAt.toString()}]`,...t)});n(this,"warn",(t,...e)=>{r.enableLog&&console.warn(`🚨 [Blac ${String(r.instance.createdAt)}]`,t,...e)});n(this,"error",(t,...e)=>{r.enableLog&&console.error(`🚨 [Blac ${String(r.instance.createdAt)}]`,t,...e)});n(this,"resetInstance",()=>{this.log("Reset Blac instance");const t=new Map(this.blocInstanceMap),e=new Map(this.isolatedBlocMap);t.forEach(s=>{s._dispose()}),e.forEach(s=>{s.forEach(i=>{i._dispose()})}),this.blocInstanceMap.clear(),this.isolatedBlocMap.clear(),r.instance=new r({__unsafe_ignore_singleton:!0})});n(this,"addPlugin",t=>{this.pluginList.findIndex(s=>s.name===t.name)===-1&&(this.log("Add plugin",t.name),this.pluginList.push(t))});n(this,"dispatchEventToPlugins",(t,e,s)=>{this.pluginList.forEach(i=>{i.onEvent(t,e,s)})});n(this,"dispatchEvent",(t,e,s)=>{switch(this.log(t,e,s),t){case"BLOC_DISPOSED":this.disposeBloc(e);break;case"BLOC_CONSUMER_REMOVED":case"LISTENER_REMOVED":this.log(`[${e._name}:${String(e._id)}] Listener/Consumer removed. Listeners: ${String(e._observer.size)}, Consumers: ${String(e._consumers.size)}, KeepAlive: ${String(e._keepAlive)}`),e._observer.size===0&&e._consumers.size===0&&!e._keepAlive&&(this.log(`[${e._name}:${String(e._id)}] No listeners or consumers left and not keepAlive. Disposing.`),e._dispose());break}this.dispatchEventToPlugins(t,e,s)});n(this,"disposeBloc",t=>{const e=t.constructor,s=this.createBlocInstanceMapKey(t._name,t._id);this.log(`[${t._name}:${String(t._id)}] disposeBloc called. Isolated: ${String(e.isolated)}`),e.isolated?(this.unregisterIsolatedBlocInstance(t),this.blocInstanceMap.delete(s)):this.unregisterBlocInstance(t),this.dispatchEventToPlugins("BLOC_DISPOSED",t)});n(this,"getBloc",(t,e={})=>{const{id:s}=e,i=t,a=s??t.name;if(this.log(`[${t.name}:${String(a)}] getBloc called. Options:`,e),i.isolated){const o=this.findIsolatedBlocInstance(t,a);if(o)return this.log(`[${t.name}:${String(a)}] Found existing isolated instance.`),o}if(!i.isolated){const o=this.findRegisteredBlocInstance(t,a);if(o)return this.log(`[${t.name}:${String(a)}] Found existing registered instance.`),o}return this.log(`[${t.name}:${String(a)}] No existing instance found. Creating new one.`),this.createNewBlocInstance(t,a,e)});n(this,"getBlocOrThrow",(t,e={})=>{const s=t.isolated,i=e.id||t.name,a=s?this.findIsolatedBlocInstance(t,i):this.findRegisteredBlocInstance(t,i);if(a)return a;throw new Error(`Bloc ${t.name} not found`)});n(this,"getAllBlocs",(t,e={})=>{const s=[];if(this.blocInstanceMap.forEach(i=>{i.constructor===t&&s.push(i)}),e.searchIsolated!==!1){const i=this.isolatedBlocMap.get(t);i&&s.push(...i.map(a=>a))}return s});const{__unsafe_ignore_singleton:e=!1}=t;if(!e)return r.instance;r.instance=this}static getInstance(){return r.instance}createBlocInstanceMapKey(t,e){return`${t}:${String(e)}`}unregisterBlocInstance(t){const e=this.createBlocInstanceMapKey(t._name,t._id);this.blocInstanceMap.delete(e)}registerBlocInstance(t){const e=this.createBlocInstanceMapKey(t._name,t._id);this.blocInstanceMap.set(e,t)}findRegisteredBlocInstance(t,e){if(t.isolated)return;const i=this.createBlocInstanceMapKey(t.name,e),a=this.blocInstanceMap.get(i);return a&&this.log(`[${t.name}:${String(e)}] Found registered instance. Returning.`),a}registerIsolatedBlocInstance(t){const e=t.constructor,s=this.isolatedBlocMap.get(e);s?s.push(t):this.isolatedBlocMap.set(e,[t])}unregisterIsolatedBlocInstance(t){const e=t.constructor,s=this.isolatedBlocMap.get(e);if(s){const i=s.findIndex(a=>a._id===t._id);i!==-1&&s.splice(i,1),s.length===0&&this.isolatedBlocMap.delete(e)}}findIsolatedBlocInstance(t,e){if(!t.isolated)return;const i=this.isolatedBlocMap.get(t);if(!i)return;const a=i.find(o=>o._id===e);return a&&this.log(`[${t.name}:${String(e)}] Found isolated instance. Returning.`),a}createNewBlocInstance(t,e,s={}){const{props:i,instanceRef:a}=s,o=new t(i);return o._instanceRef=a,o.props=i||null,o._updateId(e),o.isIsolated?(this.registerIsolatedBlocInstance(o),o):(this.registerBlocInstance(o),o)}};n(r,"instance",new r),n(r,"getAllBlocs",r.instance.getAllBlocs),n(r,"addPlugin",r.instance.addPlugin),n(r,"enableLog",!1),n(r,"log",r.instance.log),n(r,"warn",r.instance.warn),n(r,"error",r.instance.error),n(r,"resetInstance",r.instance.resetInstance),n(r,"getBloc",r.instance.getBloc),n(r,"getBlocOrThrow",r.instance.getBlocOrThrow);let h=r;class B{constructor(t){n(this,"bloc");n(this,"_observers",new Set);this.bloc=t}get size(){return this._observers.size}get observers(){return this._observers}subscribe(t){return this._observers.add(t),h.instance.dispatchEvent(g.LISTENER_ADDED,this.bloc,{listenerId:t.id}),t.lastState||(t.lastState=t.dependencyArray?t.dependencyArray(this.bloc.state):[]),()=>{this.unsubscribe(t)}}unsubscribe(t){var e;(e=t.dispose)==null||e.call(t),this._observers.delete(t),h.instance.dispatchEvent(g.LISTENER_REMOVED,this.bloc,{listenerId:t.id})}notify(t,e,s){this._observers.forEach(i=>{let a=!1;if(i.dependencyArray){const o=i.lastState||[],p=i.dependencyArray(t);for(let _=0;_<p.length;_++){const S=p[_],d=o[_]||[];for(let l=0;l<S.length;l++)if(!Object.is(S[l],d[l])){a=!0;break}}i.lastState=p}else a=!0;a&&i.fn(t,e,s)})}dispose(){this._observers.forEach(t=>{this.unsubscribe(t)}),this._observers.clear()}}class E{constructor(t){n(this,"defaultDependencySelector");n(this,"_addons");n(this,"_isolated",!1);n(this,"_observer");n(this,"_blac",h.getInstance());n(this,"_id");n(this,"_instanceRef");n(this,"_keepAlive",!1);n(this,"_createdAt",Date.now());n(this,"_state");n(this,"_oldState");n(this,"props",null);n(this,"_updateId",t=>{const e=this._id;!t||t===e||(this._id=t)});n(this,"onDispose");n(this,"_consumers",new Set);n(this,"_addConsumer",t=>{this._consumers.add(t),this._blac.dispatchEvent(g.BLOC_CONSUMER_ADDED,this,{consumerId:t})});n(this,"_removeConsumer",t=>{this._blac.log(`[${this._name}:${String(this._id??"default_id")}] Removing consumer: ${t}`),this._consumers.delete(t),this._blac.dispatchEvent(g.BLOC_CONSUMER_REMOVED,this,{consumerId:t})});n(this,"_connectAddons",()=>{const{_addons:t}=this;t&&t.forEach(e=>{var s;(s=e.onInit)==null||s.call(e,this)})});n(this,"lastUpdate",Date.now());n(this,"_pushState",(t,e,s)=>{this._state=t,this._observer.notify(t,e,s),this.lastUpdate=Date.now()});this._state=t,this._observer=new B(this),this._blac.dispatchEvent(g.BLOC_CREATED,this),this._id=this.constructor.name;const e=this.constructor;this._keepAlive=e.keepAlive,this._isolated=e.isolated,this._addons=e.addons,this._connectAddons()}get isIsolated(){return this._isolated}get isKeepAlive(){return this._keepAlive}get state(){return this._state}get _name(){return this.constructor.name}_dispose(){var t;this._observer.dispose(),this._blac.dispatchEvent(g.BLOC_DISPOSED,this),(t=this.onDispose)==null||t.call(this)}}n(E,"isolated",!1),n(E,"keepAlive",!1);class O extends E{emit(t){if(Object.is(t,this.state))return;const e=this.state,s=t;this._pushState(s,e)}patch(t,e=!1){if(typeof this.state!="object"||this.state===null){h.warn("Cubit.patch: was called on a cubit where the state is not an object. This is a no-op.");return}let s=!1;if(e)s=!0;else for(const i in t)if(Object.prototype.hasOwnProperty.call(t,i)){const o=this.state[i];if(!Object.is(t[i],o)){s=!0;break}}s&&this.emit({...this.state,...t})}}class M extends E{constructor(){super(...arguments);n(this,"eventHandlers",new Map);n(this,"add",async e=>{const s=e.constructor,i=this.eventHandlers.get(s);if(i){const a=o=>{const p=this.state;this._pushState(o,p,e)};try{await i(e,a)}catch(o){h.error(`[Bloc ${this._name}:${String(this._id)}] Error in event handler for '${s.name}':`,o,"Action:",e)}}else{const a=e.constructor.name||"UnnamedConstructor";h.warn(`[Bloc ${this._name}:${String(this._id)}] No handler registered for action type: '${a}'. Action was:`,e)}})}on(e,s){this.eventHandlers.has(e)&&h.warn(`[Bloc ${this._name}:${String(this._id)}] Handler for event '${e.name}' already registered. It will be overwritten.`),this.eventHandlers.set(e,s)}}function I(c){switch(c){case"localStorage":return localStorage;case"sessionStorage":return sessionStorage;default:return localStorage}}function w(c={}){const{keyPrefix:t="blac",keyName:e,defaultValue:s,storageType:i="localStorage"}=c,a=d=>`${t}:${String(d)}`,o=d=>{var l;try{const u=I(i).getItem(a(d));if(typeof u!="string")return s;const f=JSON.parse(u);return typeof f.v<"u"?f.v:s}catch(u){return(l=c.onError)==null||l.call(c,u),s}},p=d=>{const l=e??d._id,u=o(l);d._pushState(u,null)};let _="";return{name:"Persist",onInit:p,onEmit:({newState:d,cubit:l})=>{const u=e??l._id,f=JSON.stringify({v:d});f!==_&&(I(i).setItem(a(u),f),_=f)}}}exports.Blac=h;exports.BlacLifecycleEvent=g;exports.BlacObservable=B;exports.Bloc=M;exports.BlocBase=E;exports.Cubit=O;exports.Persist=w;
1
+ "use strict";var w=Object.defineProperty;var y=(d,e,t)=>e in d?w(d,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):d[e]=t;var n=(d,e,t)=>y(d,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=class h{getInstance(){return h._instance||(h._instance=new l({__unsafe_ignore_singleton:!0})),h._instance}setInstance(e){h._instance=e}resetInstance(){const e=h._instance;h._instance=new l({__unsafe_ignore_singleton:!0});for(const t of e.keepAliveBlocs)h._instance.keepAliveBlocs.add(t),h._instance.uidRegistry.set(t.uid,t)}};n(h,"_instance");let B=h,u=new B;function m(d){u=d}const r=class r{constructor(e={}){n(this,"createdAt",Date.now());n(this,"blocInstanceMap",new Map);n(this,"isolatedBlocMap",new Map);n(this,"isolatedBlocIndex",new Map);n(this,"uidRegistry",new Map);n(this,"keepAliveBlocs",new Set);n(this,"postChangesToDocument",!1);n(this,"log",(...e)=>{r.enableLog&&console.warn(`☢️ [Blac ${this.createdAt.toString()}]`,...e)});n(this,"warn",(e,...t)=>{r.enableLog&&console.warn(`🚨 [Blac ${String(r.instance.createdAt)}]`,e,...t)});n(this,"error",(e,...t)=>{r.enableLog&&console.error(`🚨 [Blac ${String(r.instance.createdAt)}]`,e,...t)});n(this,"resetInstance",()=>{this.log("Reset Blac instance");const e=new Map(this.blocInstanceMap),t=new Map(this.isolatedBlocMap);e.forEach(s=>{s._keepAlive||s._dispose()}),t.forEach(s=>{s.forEach(i=>{i._keepAlive||i._dispose()})}),this.blocInstanceMap.clear(),this.isolatedBlocMap.clear(),this.isolatedBlocIndex.clear(),u.resetInstance()});n(this,"disposeBloc",e=>{const t=e.constructor,s=this.createBlocInstanceMapKey(e._name,e._id);this.log(`[${e._name}:${String(e._id)}] disposeBloc called. Isolated: ${String(t.isolated)}`),t.isolated?(this.unregisterIsolatedBlocInstance(e),this.blocInstanceMap.delete(s)):this.unregisterBlocInstance(e),this.log("dispatched bloc",e)});n(this,"activateBloc",e=>{const t=e.constructor;(e.isIsolated?this.findIsolatedBlocInstance(t,e._id):this.findRegisteredBlocInstance(t,e._id))||(this.log(`[${e._name}:${String(e._id)}] activateBloc called. Isolated: ${String(e.isIsolated)}`),e.isIsolated?this.registerIsolatedBlocInstance(e):this.registerBlocInstance(e))});n(this,"getBloc",(e,t={})=>{const{id:s}=t,i=e,a=s??e.name;if(i.isolated){const c=this.findIsolatedBlocInstance(e,a);if(c)return this.log(`[${e.name}:${String(a)}] (getBloc) Found existing isolated instance.`,t),c;if(t.throwIfNotFound)throw new Error(`Isolated bloc ${e.name} not found`)}else{const c=this.findRegisteredBlocInstance(e,a);if(c)return this.log(`[${e.name}:${String(a)}] (getBloc) Found existing registered instance.`,t),c;if(t.throwIfNotFound)throw new Error(`Registered bloc ${e.name} not found`)}const o=this.createNewBlocInstance(e,a,t);return this.log(`[${e.name}:${String(a)}] (getBloc) No existing instance found. Creating new one.`,t,o),o});n(this,"getBlocOrThrow",(e,t={})=>{const s=e.isolated,i=t.id||e.name,a=s?this.findIsolatedBlocInstance(e,i):this.findRegisteredBlocInstance(e,i);if(a)return a;throw new Error(`Bloc ${e.name} not found`)});n(this,"getAllBlocs",(e,t={})=>{const s=[];if(this.blocInstanceMap.forEach(i=>{i.constructor===e&&s.push(i)}),t.searchIsolated!==!1){const i=this.isolatedBlocMap.get(e);i&&s.push(...i.map(a=>a))}return s});n(this,"disposeKeepAliveBlocs",e=>{const t=[];for(const s of this.keepAliveBlocs)(!e||s.constructor===e)&&t.push(s);t.forEach(s=>s._dispose())});n(this,"disposeBlocs",e=>{const t=[];for(const s of this.blocInstanceMap.values())e(s)&&t.push(s);for(const s of this.isolatedBlocMap.values())for(const i of s)e(i)&&t.push(i);t.forEach(s=>s._dispose())});n(this,"getMemoryStats",()=>({totalBlocs:this.uidRegistry.size,registeredBlocs:this.blocInstanceMap.size,isolatedBlocs:Array.from(this.isolatedBlocMap.values()).reduce((e,t)=>e+t.length,0),keepAliveBlocs:this.keepAliveBlocs.size,isolatedBlocTypes:this.isolatedBlocMap.size}));n(this,"validateConsumers",()=>{for(const e of this.uidRegistry.values())e._consumers.size===0&&!e._keepAlive&&setTimeout(()=>{e._consumers.size===0&&!e._keepAlive&&e._dispose()},1e3)});const{__unsafe_ignore_singleton:t=!1}=e;if(!t)return r.instance;u.setInstance(this)}static get instance(){return u.getInstance()}static get getAllBlocs(){return r.instance.getAllBlocs}static get log(){return r.instance.log}static getInstance(){return u.getInstance()}static get warn(){return r.instance.warn}static get error(){return r.instance.error}createBlocInstanceMapKey(e,t){return`${e}:${String(t)}`}unregisterBlocInstance(e){const t=this.createBlocInstanceMapKey(e._name,e._id);this.blocInstanceMap.delete(t),this.uidRegistry.delete(e.uid),this.keepAliveBlocs.delete(e)}registerBlocInstance(e){const t=this.createBlocInstanceMapKey(e._name,e._id);this.blocInstanceMap.set(t,e),this.uidRegistry.set(e.uid,e),e._keepAlive&&this.keepAliveBlocs.add(e)}findRegisteredBlocInstance(e,t){if(e.isolated)return;const i=this.createBlocInstanceMapKey(e.name,t);return this.blocInstanceMap.get(i)}registerIsolatedBlocInstance(e){const t=e.constructor,s=this.isolatedBlocMap.get(t);s?s.push(e):this.isolatedBlocMap.set(t,[e]),this.isolatedBlocIndex.set(e.uid,e),this.uidRegistry.set(e.uid,e),e._keepAlive&&this.keepAliveBlocs.add(e)}unregisterIsolatedBlocInstance(e){const t=e.constructor,s=this.isolatedBlocMap.get(t);if(s){const i=s.findIndex(a=>a.uid===e.uid);i!==-1&&s.splice(i,1),s.length===0&&this.isolatedBlocMap.delete(t)}this.isolatedBlocIndex.delete(e.uid),this.uidRegistry.delete(e.uid),this.keepAliveBlocs.delete(e)}findIsolatedBlocInstance(e,t){if(!e.isolated)return;const i=this.isolatedBlocMap.get(e);return i?i.find(o=>o._id===t):void 0}findIsolatedBlocInstanceByUid(e){return this.isolatedBlocIndex.get(e)}createNewBlocInstance(e,t,s={}){const{props:i,instanceRef:a}=s,o=new e(i);return o._instanceRef=a,o.props=i||null,o._updateId(t),o._setDisposalHandler(c=>this.disposeBloc(c)),o.isIsolated?(this.registerIsolatedBlocInstance(o),o):(this.registerBlocInstance(o),o)}static get activateBloc(){return r.instance.activateBloc}static get getBloc(){return r.instance.getBloc}static get getBlocOrThrow(){return r.instance.getBlocOrThrow}static get disposeKeepAliveBlocs(){return r.instance.disposeKeepAliveBlocs}static get disposeBlocs(){return r.instance.disposeBlocs}static get getMemoryStats(){return r.instance.getMemoryStats}static get validateConsumers(){return r.instance.validateConsumers}};n(r,"enableLog",!1),n(r,"resetInstance",()=>{u.resetInstance()});let l=r;class I{constructor(e){n(this,"bloc");n(this,"_observers",new Set);this.bloc=e}get size(){return this._observers.size}get observers(){return this._observers}subscribe(e){return l.log("BlacObservable.subscribe: Subscribing observer.",this.bloc,e),this._observers.add(e),e.lastState||(e.lastState=e.dependencyArray?e.dependencyArray(this.bloc.state):[]),()=>{l.log("BlacObservable.subscribe: Unsubscribing observer.",this.bloc,e),this.unsubscribe(e)}}unsubscribe(e){this._observers.delete(e),this.size===0&&(l.log("BlacObservable.unsubscribe: No observers left. Disposing bloc.",this.bloc),this.bloc._dispose())}notify(e,t,s){this._observers.forEach(i=>{let a=!1;if(i.dependencyArray){const o=i.lastState||[],c=i.dependencyArray(e);for(let f=0;f<c.length;f++){const _=c[f],v=o[f]||[];for(let g=0;g<_.length;g++)if(!Object.is(_[g],v[g])){a=!0;break}}i.lastState=c}else a=!0;a&&i.fn(e,t,s)})}clear(){this._observers.forEach(e=>{this.unsubscribe(e)}),this._observers.clear()}}class p{constructor(e){n(this,"uid",crypto.randomUUID());n(this,"defaultDependencySelector");n(this,"_isolated",!1);n(this,"_observer");n(this,"_id");n(this,"_instanceRef");n(this,"_keepAlive",!1);n(this,"_createdAt",Date.now());n(this,"_state");n(this,"_oldState");n(this,"props",null);n(this,"_updateId",e=>{const t=this._id;!e||e===t||(this._id=e)});n(this,"onDispose");n(this,"_consumers",new Set);n(this,"_consumerRefs",new WeakSet);n(this,"_addConsumer",(e,t)=>{this._consumers.has(e)||(this._consumers.add(e),t&&this._consumerRefs.add(t))});n(this,"_removeConsumer",e=>{this._consumers.has(e)&&(this._consumers.delete(e),this._consumers.size===0&&!this._keepAlive&&this._scheduleDisposal())});n(this,"_disposalHandler");n(this,"lastUpdate",Date.now());n(this,"_batchingEnabled",!1);n(this,"_pendingUpdates",[]);n(this,"_pushState",(e,t,s)=>{if(e===void 0){console.warn("BlocBase._pushState: newState is undefined",this);return}if(s!=null){const i=typeof s;["string","object","number"].includes(i)||console.warn("BlocBase._pushState: Invalid action type",this,s)}if(this._batchingEnabled){this._pendingUpdates.push({newState:e,oldState:t,action:s});return}this._oldState=t,this._state=e,this._observer.notify(e,t,s),this.lastUpdate=Date.now()});n(this,"batch",e=>{const t=this._batchingEnabled;this._batchingEnabled=!0;try{const s=e();if(this._pendingUpdates.length>0){const i=this._pendingUpdates[this._pendingUpdates.length-1];this._oldState=this._pendingUpdates[0].oldState,this._state=i.newState,this._observer.notify(i.newState,this._oldState,i.action),this.lastUpdate=Date.now(),this._pendingUpdates=[]}return s}finally{this._batchingEnabled=t}});this._state=e,this._observer=new I(this),this._id=this.constructor.name;const t=this.constructor;this._keepAlive=typeof t.keepAlive=="boolean"?t.keepAlive:!1,this._isolated=typeof t.isolated=="boolean"?t.isolated:!1}get isIsolated(){return this._isolated}get isKeepAlive(){return this._keepAlive}get state(){return this._state}get _name(){return this.constructor.name}_dispose(){var e;this._consumers.clear(),this._observer.clear(),(e=this.onDispose)==null||e.call(this)}_setDisposalHandler(e){this._disposalHandler=e}_scheduleDisposal(){setTimeout(()=>{this._consumers.size===0&&!this._keepAlive&&(this._disposalHandler?this._disposalHandler(this):this._dispose())},0)}}n(p,"isolated",!1),n(p,"keepAlive",!1);class b extends p{constructor(){super(...arguments);n(this,"eventHandlers",new Map);n(this,"add",async t=>{const s=t.constructor,i=this.eventHandlers.get(s);if(i){const a=o=>{const c=this.state;this._pushState(o,c,t)};try{await i(t,a)}catch(o){l.error(`[Bloc ${this._name}:${String(this._id)}] Error in event handler for '${s.name}':`,o,"Action:",t)}}else{const a=t.constructor.name||"UnnamedConstructor";l.warn(`[Bloc ${this._name}:${String(this._id)}] No handler registered for action type: '${a}'. Action was:`,t)}})}on(t,s){this.eventHandlers.has(t)&&l.warn(`[Bloc ${this._name}:${String(this._id)}] Handler for event '${t.name}' already registered. It will be overwritten.`),this.eventHandlers.set(t,s)}}class A extends p{emit(e){if(Object.is(e,this.state))return;const t=this.state,s=e;this._pushState(s,t)}patch(e,t=!1){if(typeof this.state!="object"||this.state===null){l.warn("Cubit.patch: was called on a cubit where the state is not an object. This is a no-op.");return}let s=!1;if(t)s=!0;else for(const i in e)if(Object.prototype.hasOwnProperty.call(e,i)){const o=this.state[i];if(!Object.is(e[i],o)){s=!0;break}}s&&this.emit({...this.state,...e})}}exports.Blac=l;exports.BlacObservable=I;exports.Bloc=b;exports.BlocBase=p;exports.Cubit=A;exports.setBlacInstanceManager=m;
2
2
  //# sourceMappingURL=index.cjs.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs.js","sources":["../src/Blac.ts","../src/BlacObserver.ts","../src/BlocBase.ts","../src/Cubit.ts","../src/Bloc.ts","../src/addons/Persist.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { BlacPlugin } from \"./BlacPlugin\";\nimport { BlocBase, BlocInstanceId } from \"./BlocBase\";\nimport {\n BlocBaseAbstract,\n BlocConstructor,\n BlocHookDependencyArrayFn,\n BlocState,\n InferPropsFromGeneric\n} from \"./types\";\n\n/**\n * Configuration options for the Blac instance\n */\nexport interface BlacConfig {\n /** Whether to expose the Blac instance globally */\n exposeBlacInstance?: boolean;\n}\n\nexport interface GetBlocOptions<B extends BlocBase<any>> {\n id?: string;\n selector?: BlocHookDependencyArrayFn<BlocState<B>>;\n props?: InferPropsFromGeneric<B>;\n onMount?: (bloc: B) => void;\n instanceRef?: string;\n}\n\n/**\n * Enum representing different lifecycle events that can occur in the Blac system.\n * These events are used to track the lifecycle of blocs and their consumers.\n */\nexport enum BlacLifecycleEvent {\n BLOC_DISPOSED = \"BLOC_DISPOSED\",\n BLOC_CREATED = \"BLOC_CREATED\",\n LISTENER_REMOVED = \"LISTENER_REMOVED\",\n LISTENER_ADDED = \"LISTENER_ADDED\",\n STATE_CHANGED = \"STATE_CHANGED\",\n BLOC_CONSUMER_REMOVED = \"BLOC_CONSUMER_REMOVED\",\n BLOC_CONSUMER_ADDED = \"BLOC_CONSUMER_ADDED\",\n}\n\n/**\n * Main Blac class that manages the state management system.\n * Implements a singleton pattern to ensure only one instance exists.\n * Handles bloc lifecycle, plugin management, and instance tracking.\n * \n * Key responsibilities:\n * - Managing bloc instances (creation, disposal, lookup)\n * - Handling isolated and non-isolated blocs\n * - Managing plugins and lifecycle events\n * - Providing logging and debugging capabilities\n */\nexport class Blac {\n /** The singleton instance of Blac */\n static instance: Blac = new Blac();\n /** Timestamp when the instance was created */\n createdAt = Date.now();\n static getAllBlocs = Blac.instance.getAllBlocs;\n static addPlugin = Blac.instance.addPlugin;\n /** Map storing all registered bloc instances by their class name and ID */\n blocInstanceMap: Map<string, BlocBase<any>> = new Map();\n /** Map storing isolated bloc instances grouped by their constructor */\n isolatedBlocMap: Map<BlocConstructor<any>, BlocBase<any>[]> = new Map();\n pluginList: BlacPlugin[] = [];\n /** Flag to control whether changes should be posted to document */\n postChangesToDocument = false;\n\n /**\n * Creates a new Blac instance.\n * @param options - Configuration options including singleton control\n */\n constructor(options: { __unsafe_ignore_singleton?: boolean } = {}) {\n const { __unsafe_ignore_singleton = false } = options;\n if (!__unsafe_ignore_singleton) {\n return Blac.instance;\n }\n Blac.instance = this;\n }\n\n /** Flag to enable/disable logging */\n static enableLog = false;\n\n /**\n * Logs messages to console when logging is enabled\n * @param args - Arguments to log\n */\n log = (...args: unknown[]) => {\n if (Blac.enableLog) console.warn(`☢️ [Blac ${this.createdAt.toString()}]`, ...args);\n };\n static log = Blac.instance.log;\n\n /**\n * Gets the singleton instance of Blac\n * @returns The Blac instance\n */\n static getInstance(): Blac {\n return Blac.instance;\n }\n\n\n /**\n * Logs a warning message\n * @param message - Warning message\n * @param args - Additional arguments\n */\n warn = (message: string, ...args: unknown[]) => {\n if (Blac.enableLog) {\n console.warn(`🚨 [Blac ${String(Blac.instance.createdAt)}]`, message, ...args);\n }\n };\n static warn = Blac.instance.warn;\n /**\n * Logs an error message\n * @param message - Error message\n * @param args - Additional arguments\n */\n error = (message: string, ...args: unknown[]) => {\n if (Blac.enableLog) {\n console.error(`🚨 [Blac ${String(Blac.instance.createdAt)}]`, message, ...args);\n }\n };\n static error = Blac.instance.error;\n\n /**\n * Resets the Blac instance to a new one, disposing non-keepAlive blocs\n * from the old instance.\n */\n resetInstance = (): void => {\n this.log(\"Reset Blac instance\");\n\n // Dispose non-keepAlive blocs from the current instance\n const oldBlocInstanceMap = new Map(this.blocInstanceMap);\n const oldIsolatedBlocMap = new Map(this.isolatedBlocMap);\n\n oldBlocInstanceMap.forEach((bloc) => {\n bloc._dispose();\n });\n\n oldIsolatedBlocMap.forEach((blocArray) => {\n blocArray.forEach((bloc) => {\n bloc._dispose();\n });\n });\n\n this.blocInstanceMap.clear();\n this.isolatedBlocMap.clear();\n\n // Create and assign the new instance\n Blac.instance = new Blac({\n __unsafe_ignore_singleton: true,\n });\n }\n static resetInstance = Blac.instance.resetInstance;\n\n /**\n * Adds a plugin to the Blac instance\n * @param plugin - The plugin to add\n */\n addPlugin = (plugin: BlacPlugin): void => {\n // check if already added\n const index = this.pluginList.findIndex((p) => p.name === plugin.name);\n if (index !== -1) return;\n this.log(\"Add plugin\", plugin.name);\n this.pluginList.push(plugin);\n };\n\n /**\n * Dispatches a lifecycle event to all registered plugins\n * @param event - The lifecycle event to dispatch\n * @param bloc - The bloc instance involved in the event\n * @param params - Additional parameters for the event\n */\n dispatchEventToPlugins = (\n event: BlacLifecycleEvent,\n bloc: BlocBase<any>,\n params?: unknown,\n ) => {\n this.pluginList.forEach((plugin) => {\n plugin.onEvent(event, bloc, params);\n });\n };\n\n /**\n * Dispatches a lifecycle event and handles related cleanup actions.\n * This method is responsible for:\n * - Logging the event\n * - Handling bloc disposal when needed\n * - Managing bloc consumer cleanup\n * - Forwarding the event to plugins\n * \n * @param event - The lifecycle event to dispatch\n * @param bloc - The bloc instance involved in the event\n * @param params - Additional parameters for the event\n */\n dispatchEvent = (\n event: BlacLifecycleEvent,\n bloc: BlocBase<any>,\n params?: unknown,\n ) => {\n this.log(event, bloc, params);\n\n switch (event) {\n case BlacLifecycleEvent.BLOC_DISPOSED:\n this.disposeBloc(bloc);\n break;\n case BlacLifecycleEvent.BLOC_CONSUMER_REMOVED:\n case BlacLifecycleEvent.LISTENER_REMOVED:\n this.log(`[${bloc._name}:${String(bloc._id)}] Listener/Consumer removed. Listeners: ${String(bloc._observer.size)}, Consumers: ${String(bloc._consumers.size)}, KeepAlive: ${String(bloc._keepAlive)}`);\n if (\n bloc._observer.size === 0 &&\n bloc._consumers.size === 0 &&\n !bloc._keepAlive\n ) {\n this.log(`[${bloc._name}:${String(bloc._id)}] No listeners or consumers left and not keepAlive. Disposing.`);\n bloc._dispose();\n }\n break;\n }\n\n this.dispatchEventToPlugins(event, bloc, params);\n };\n\n /**\n * Disposes of a bloc instance by removing it from the appropriate registry\n * @param bloc - The bloc instance to dispose\n */\n disposeBloc = (bloc: BlocBase<any>): void => {\n const base = bloc.constructor as unknown as BlocBaseAbstract;\n const key = this.createBlocInstanceMapKey(bloc._name, bloc._id);\n this.log(`[${bloc._name}:${String(bloc._id)}] disposeBloc called. Isolated: ${String(base.isolated)}`);\n\n if (base.isolated) {\n this.unregisterIsolatedBlocInstance(bloc);\n this.blocInstanceMap.delete(key);\n } else {\n this.unregisterBlocInstance(bloc);\n }\n this.dispatchEventToPlugins(BlacLifecycleEvent.BLOC_DISPOSED, bloc);\n };\n\n /**\n * Creates a unique key for a bloc instance in the map based on the bloc class name and instance ID\n * @param blocClassName - The name of the bloc class\n * @param id - The instance ID\n * @returns A unique key string in the format \"className:id\"\n */\n createBlocInstanceMapKey(blocClassName: string, id: BlocInstanceId): string {\n return `${blocClassName}:${String(id)}`;\n }\n\n /**\n * Unregister a bloc instance from the main registry\n * @param bloc - The bloc instance to unregister\n */\n unregisterBlocInstance(bloc: BlocBase<any>): void {\n const key = this.createBlocInstanceMapKey(bloc._name, bloc._id);\n this.blocInstanceMap.delete(key);\n }\n\n /**\n * Registers a bloc instance in the main registry\n * @param bloc - The bloc instance to register\n */\n registerBlocInstance(bloc: BlocBase<any>): void {\n const key = this.createBlocInstanceMapKey(bloc._name, bloc._id);\n this.blocInstanceMap.set(key, bloc);\n }\n\n /**\n * Finds a registered bloc instance by its class and ID\n * @param blocClass - The bloc class to search for\n * @param id - The instance ID\n * @returns The found bloc instance or undefined if not found\n */\n findRegisteredBlocInstance<B extends BlocConstructor<unknown>>(\n blocClass: B,\n id: BlocInstanceId,\n ): InstanceType<B> | undefined {\n const base = blocClass as unknown as BlocBaseAbstract;\n if (base.isolated) return undefined;\n\n const key = this.createBlocInstanceMapKey(blocClass.name, id);\n const found = this.blocInstanceMap.get(key) as InstanceType<B> | undefined;\n if (found) {\n this.log(`[${blocClass.name}:${String(id)}] Found registered instance. Returning.`);\n }\n return found \n }\n\n /**\n * Registers an isolated bloc instance in the isolated registry\n * @param bloc - The isolated bloc instance to register\n */\n registerIsolatedBlocInstance(bloc: BlocBase<any>): void {\n const blocClass = bloc.constructor as BlocConstructor<unknown>;\n const blocs = this.isolatedBlocMap.get(blocClass);\n if (blocs) {\n blocs.push(bloc);\n } else {\n this.isolatedBlocMap.set(blocClass, [bloc]);\n }\n }\n\n /**\n * Unregister an isolated bloc instance from the isolated registry\n * @param bloc - The isolated bloc instance to unregister\n */\n unregisterIsolatedBlocInstance(bloc: BlocBase<any>): void {\n const blocClass = bloc.constructor;\n const blocs = this.isolatedBlocMap.get(blocClass as BlocConstructor<unknown>);\n if (blocs) {\n const index = blocs.findIndex((b) => b._id === bloc._id);\n if (index !== -1) {\n blocs.splice(index, 1);\n }\n\n if (blocs.length === 0) {\n this.isolatedBlocMap.delete(blocClass as BlocConstructor<unknown>);\n }\n }\n }\n\n /**\n * Finds an isolated bloc instance by its class and ID\n */\n findIsolatedBlocInstance<B extends BlocConstructor<unknown>>(\n blocClass: B,\n id: BlocInstanceId,\n ): InstanceType<B> | undefined {\n const base = blocClass as unknown as BlocBaseAbstract;\n if (!base.isolated) return undefined;\n\n const blocs = this.isolatedBlocMap.get(blocClass);\n if (!blocs) return undefined;\n\n // Fix: Find the specific bloc by ID within the isolated array\n const found = blocs.find((b) => b._id === id) as InstanceType<B> | undefined;\n\n if (found) {\n this.log(`[${blocClass.name}:${String(id)}] Found isolated instance. Returning.`);\n }\n\n return found;\n }\n\n /**\n * Creates a new bloc instance and registers it in the appropriate registry\n * @param blocClass - The bloc class to instantiate\n * @param id - The instance ID\n * @param props - Properties to pass to the bloc constructor\n * @param instanceRef - Optional reference string for the instance\n * @returns The newly created bloc instance\n */\n createNewBlocInstance<B extends BlocConstructor<BlocBase<any>>>(\n blocClass: B,\n id: BlocInstanceId,\n options: GetBlocOptions<InstanceType<B>> = {},\n ): InstanceType<B> {\n const { props, instanceRef } = options;\n const newBloc = new blocClass(props as never) as InstanceType<BlocConstructor<BlocBase<unknown>>>;\n newBloc._instanceRef = instanceRef;\n newBloc.props = props || null;\n newBloc._updateId(id);\n\n if (newBloc.isIsolated) {\n this.registerIsolatedBlocInstance(newBloc);\n return newBloc as InstanceType<B>;\n }\n\n this.registerBlocInstance(newBloc);\n return newBloc as InstanceType<B>;\n }\n\n /**\n * Gets or creates a bloc instance based on the provided class and options.\n * If a bloc with the given ID exists, it will be returned. Otherwise, a new instance will be created.\n * \n * @param blocClass - The bloc class to get or create\n * @param options - Options including:\n * - id: The instance ID (defaults to class name if not provided)\n * - props: Properties to pass to the bloc constructor\n * - instanceRef: Optional reference string for the instance\n * @returns The bloc instance\n */\n getBloc = <B extends BlocConstructor<BlocBase<any>>>(\n blocClass: B,\n options: GetBlocOptions<InstanceType<B>> = {},\n ): InstanceType<B> => {\n const { id } = options;\n const base = blocClass as unknown as BlocBaseAbstract;\n const blocId = id ?? blocClass.name;\n\n this.log(`[${blocClass.name}:${String(blocId)}] getBloc called. Options:`, options);\n\n if (base.isolated) {\n const isolatedBloc = this.findIsolatedBlocInstance<B>(blocClass, blocId)\n if (isolatedBloc) {\n this.log(`[${blocClass.name}:${String(blocId)}] Found existing isolated instance.`);\n return isolatedBloc;\n }\n }\n\n if (!base.isolated) {\n const registeredBloc = this.findRegisteredBlocInstance(blocClass, blocId)\n if (registeredBloc) {\n this.log(`[${blocClass.name}:${String(blocId)}] Found existing registered instance.`);\n return registeredBloc\n }\n }\n\n this.log(`[${blocClass.name}:${String(blocId)}] No existing instance found. Creating new one.`);\n return this.createNewBlocInstance(\n blocClass,\n blocId,\n options,\n );\n };\n static getBloc = Blac.instance.getBloc;\n\n /**\n * Gets a bloc instance or throws an error if it doesn't exist\n * @param blocClass - The bloc class to get\n * @param options - Options including:\n * - id: The instance ID (defaults to class name if not provided)\n * - props: Properties to pass to the bloc constructor\n * - instanceRef: Optional reference string for the instance\n */\n getBlocOrThrow = <B extends BlocConstructor<unknown>>(\n blocClass: B,\n options: {\n id?: BlocInstanceId;\n props?: InferPropsFromGeneric<B>;\n instanceRef?: string;\n } = {},\n ): InstanceType<B> => {\n const isIsolated = (blocClass as unknown as BlocBaseAbstract).isolated;\n const id = options.id || blocClass.name;\n\n const registered = isIsolated\n ? this.findIsolatedBlocInstance(blocClass, id)\n : this.findRegisteredBlocInstance(blocClass, id);\n\n if (registered) {\n return registered;\n }\n throw new Error(`Bloc ${blocClass.name} not found`);\n };\n static getBlocOrThrow = Blac.instance.getBlocOrThrow;\n\n /**\n * Gets all instances of a specific bloc class\n * @param blocClass - The bloc class to search for\n * @param options - Options including:\n * - searchIsolated: Whether to search in isolated blocs (defaults to bloc's isolated property)\n * @returns Array of matching bloc instances\n */\n getAllBlocs = <B extends BlocConstructor<unknown>>(\n blocClass: B,\n options: {\n searchIsolated?: boolean;\n } = {},\n ): InstanceType<B>[] => {\n const results: InstanceType<B>[] = [];\n // const blocClassName = (blocClass as any).name; // Temporarily removed for debugging\n\n // Search non-isolated blocs\n this.blocInstanceMap.forEach((blocInstance) => {\n if (blocInstance.constructor === blocClass) { // Strict constructor check\n results.push(blocInstance as InstanceType<B>);\n }\n });\n\n // Optionally search isolated blocs\n if (options.searchIsolated !== false) {\n const isolatedBlocs = this.isolatedBlocMap.get(blocClass);\n if (isolatedBlocs) {\n results.push(...isolatedBlocs.map(bloc => bloc as InstanceType<B>));\n }\n }\n\n return results;\n };\n}\n","import { Blac, BlacLifecycleEvent } from './Blac';\nimport { BlocBase } from './BlocBase';\nimport { BlocHookDependencyArrayFn } from './types';\n\n/**\n * Represents an observer that can subscribe to state changes in a Bloc\n * @template S - The type of state being observed\n */\nexport type BlacObserver<S> = {\n /** Function to be called when state changes */\n fn: (newState: S, oldState: S, action?: unknown) => void | Promise<void>;\n /** Optional function to determine if the observer should be notified of state changes */\n dependencyArray?: BlocHookDependencyArrayFn<S>;\n /** Dispose function for the observer */\n dispose?: () => void;\n /** Cached state values used for dependency comparison */\n lastState?: unknown[][];\n /** Unique identifier for the observer */\n id: string;\n};\n\n/**\n * A class that manages observers for a Bloc's state changes\n * @template S - The type of state being observed\n */\nexport class BlacObservable<S = unknown> {\n /** The Bloc instance this observable is associated with */\n bloc: BlocBase<S>;\n\n /**\n * Creates a new BlacObservable instance\n * @param bloc - The Bloc instance to observe\n */\n constructor(bloc: BlocBase<S>) {\n this.bloc = bloc;\n }\n\n private _observers = new Set<BlacObserver<S>>();\n\n /**\n * Gets the number of active observers\n * @returns The number of observers currently subscribed\n */\n get size(): number {\n return this._observers.size;\n }\n\n /**\n * Gets the set of all observers\n * @returns The Set of all BlacObserver instances\n */\n get observers() {\n return this._observers;\n }\n\n /**\n * Subscribes an observer to state changes\n * @param observer - The observer to subscribe\n * @returns A function that can be called to unsubscribe the observer\n */\n subscribe(observer: BlacObserver<S>): () => void {\n this._observers.add(observer);\n Blac.instance.dispatchEvent(BlacLifecycleEvent.LISTENER_ADDED, this.bloc, { listenerId: observer.id });\n if (!observer.lastState) {\n observer.lastState = observer.dependencyArray\n ? observer.dependencyArray(this.bloc.state)\n : [];\n }\n return () => {\n this.unsubscribe(observer);\n }\n }\n\n /**\n * Unsubscribes an observer from state changes\n * @param observer - The observer to unsubscribe\n */\n unsubscribe(observer: BlacObserver<S>) {\n observer.dispose?.();\n this._observers.delete(observer);\n Blac.instance.dispatchEvent(BlacLifecycleEvent.LISTENER_REMOVED, this.bloc, { listenerId: observer.id });\n }\n\n /**\n * Notifies all observers of a state change\n * @param newState - The new state value\n * @param oldState - The previous state value\n * @param action - Optional action that triggered the state change\n */\n notify(newState: S, oldState: S, action?: unknown) {\n this._observers.forEach((observer) => {\n let shouldUpdate = false;\n\n if (observer.dependencyArray) {\n const lastDependencyCheck = observer.lastState || [];\n const newDependencyCheck = observer.dependencyArray(newState);\n\n for (let o = 0; o < newDependencyCheck.length; o++) {\n const partNew = newDependencyCheck[o];\n const partOld = lastDependencyCheck[o] || [];\n for (let i = 0; i < partNew.length; i++) {\n if (!Object.is(partNew[i], partOld[i])) {\n shouldUpdate = true;\n break;\n }\n }\n }\n\n observer.lastState = newDependencyCheck;\n } else {\n shouldUpdate = true;\n }\n\n if (shouldUpdate) {\n void observer.fn(newState, oldState, action);\n }\n });\n }\n\n /**\n * Disposes of all observers and clears the observer set\n */\n dispose() {\n this._observers.forEach((observer) => {\n this.unsubscribe(observer);\n });\n this._observers.clear();\n }\n}\n","import { Blac, BlacLifecycleEvent } from './Blac';\nimport { BlacObservable } from './BlacObserver';\nimport BlacAddon from './addons/BlacAddon';\nimport { BlocConstructor } from './types';\n\nexport type BlocInstanceId = string | number | undefined;\ntype DependencySelector<S> = (newState: S) => unknown[][];\n\n// Define an interface for the static properties expected on a Bloc/Cubit constructor\ninterface BlocStaticProperties {\n isolated: boolean;\n keepAlive: boolean;\n addons?: BlacAddon[];\n}\n\n/**\n * Base class for both Blocs and Cubits that provides core state management functionality.\n * Handles state transitions, observer notifications, lifecycle management, and addon integration.\n * \n * @abstract This class should be extended, not instantiated directly\n * @template S The type of state managed by this Bloc\n * @template P The type of props that can be passed during instance creation (optional)\n */\nexport abstract class BlocBase<\n S,\n P = unknown\n> {\n /**\n * When true, every consumer will receive its own unique instance of this Bloc.\n * Use this when state should not be shared between components.\n * @default false\n */\n static isolated = false;\n get isIsolated() {\n return this._isolated;\n }\n \n /**\n * When true, the Bloc instance persists even when there are no active consumers.\n * Useful for maintaining state between component unmount/remount cycles.\n * @default false\n */\n static keepAlive = false;\n get isKeepAlive() {\n return this._keepAlive;\n }\n \n /**\n * Defines how dependencies are selected from the state for efficient updates.\n * When provided, observers will only be notified when selected dependencies change.\n */\n defaultDependencySelector: DependencySelector<S> | undefined;\n\n /**\n * @internal\n * Optional array of addons to extend the functionality of this Bloc.\n */\n public _addons?: BlacAddon[];\n \n /**\n * @internal\n * Indicates if this specific Bloc instance is isolated from others of the same type.\n */\n public _isolated = false;\n \n /**\n * @internal\n * Observable responsible for managing state listeners and notifying consumers.\n */\n public _observer: BlacObservable<S>;\n \n /**\n * @internal\n * Reference to the global Blac manager instance.\n */\n public _blac = Blac.getInstance();\n \n /**\n * The unique identifier for this Bloc instance.\n * Defaults to the class name, but can be customized.\n */\n public _id: BlocInstanceId;\n \n /**\n * @internal\n * Reference string used internally for tracking and debugging.\n */\n public _instanceRef?: string;\n \n /**\n * @internal\n * Indicates if this specific Bloc instance should be kept alive when no consumers are present.\n */\n public _keepAlive = false;\n \n /**\n * @readonly\n * Timestamp when this Bloc instance was created, useful for debugging and performance tracking.\n */\n public readonly _createdAt = Date.now();\n\n /**\n * @internal\n * The current state of the Bloc.\n */\n public _state: S;\n \n /**\n * @internal\n * The previous state of the Bloc, maintained for comparison and history.\n */\n public _oldState: S | undefined;\n \n /**\n * Props passed during Bloc instance creation.\n * Can be used to configure or parameterize the Bloc's behavior.\n */\n public props: P | null = null;\n\n /**\n * Creates a new BlocBase instance with the given initial state.\n * Sets up the observer, registers with the Blac manager, and initializes addons.\n * \n * @param initialState The initial state value for this Bloc\n */\n constructor(initialState: S) {\n this._state = initialState;\n this._observer = new BlacObservable(this);\n this._blac.dispatchEvent(BlacLifecycleEvent.BLOC_CREATED, this);\n this._id = this.constructor.name;\n\n // Use a type assertion for the constructor to access static properties safely\n const constructorWithStaticProps = this.constructor as BlocConstructor<this> & BlocStaticProperties;\n\n this._keepAlive = constructorWithStaticProps.keepAlive;\n this._isolated = constructorWithStaticProps.isolated;\n this._addons = constructorWithStaticProps.addons;\n\n this._connectAddons();\n }\n\n /**\n * Returns the current state of the Bloc.\n * Use this getter to access the state in a read-only manner.\n */\n get state(): S {\n return this._state;\n }\n\n /**\n * @internal\n * Returns the name of the Bloc class for identification and debugging.\n */\n get _name() {\n return this.constructor.name;\n }\n\n /**\n * @internal\n * Updates the Bloc instance's ID to a new value.\n * Only updates if the new ID is defined and different from the current one.\n * \n * @param id The new ID to assign to this Bloc instance\n */\n _updateId = (id?: BlocInstanceId) => {\n const originalId = this._id;\n if (!id || id === originalId) return;\n this._id = id;\n };\n\n /**\n * @internal\n * Cleans up resources and removes this Bloc from the system.\n * Notifies the Blac manager and clears all observers.\n */\n _dispose() {\n this._observer.dispose();\n this._blac.dispatchEvent(BlacLifecycleEvent.BLOC_DISPOSED, this);\n this.onDispose?.();\n }\n\n /**\n * @internal\n * Optional function to be called when the Bloc is disposed.\n */\n onDispose?: () => void;\n\n /**\n * @internal\n * Set of consumer IDs currently listening to this Bloc's state changes.\n */\n _consumers = new Set<string>();\n\n /**\n * @internal\n * Registers a new consumer to this Bloc instance.\n * Notifies the Blac manager that a consumer has been added.\n * \n * @param consumerId The unique ID of the consumer being added\n */\n _addConsumer = (consumerId: string) => {\n this._consumers.add(consumerId);\n this._blac.dispatchEvent(BlacLifecycleEvent.BLOC_CONSUMER_ADDED, this, { consumerId });\n };\n\n /**\n * @internal\n * Unregisters a consumer from this Bloc instance.\n * Notifies the Blac manager that a consumer has been removed.\n * \n * @param consumerId The unique ID of the consumer being removed\n */\n _removeConsumer = (consumerId: string) => {\n this._blac.log(`[${this._name}:${String(this._id ?? 'default_id')}] Removing consumer: ${consumerId}`);\n this._consumers.delete(consumerId);\n this._blac.dispatchEvent(BlacLifecycleEvent.BLOC_CONSUMER_REMOVED, this, { consumerId });\n };\n\n /**\n * @internal\n * Initializes all registered addons for this Bloc instance.\n * Calls the onInit lifecycle method on each addon if defined.\n */\n _connectAddons = () => {\n const { _addons: addons } = this;\n if (addons) {\n addons.forEach(addon => {\n addon.onInit?.(this);\n });\n }\n };\n\n lastUpdate = Date.now();\n\n /**\n * @internal\n * Updates the state and notifies all observers of the change.\n * \n * @param newState The new state to be set\n * @param oldState The previous state for comparison\n * @param action Optional metadata about what caused the state change\n */\n _pushState = (newState: S, oldState: S, action?: unknown): void => {\n this._state = newState;\n this._observer.notify(newState, oldState, action);\n this.lastUpdate = Date.now();\n };\n}\n","import { Blac } from './Blac';\nimport { BlocBase } from './BlocBase';\n\n/**\n * A Cubit is a simpler version of a Bloc that doesn't handle events.\n * It manages state and provides methods to update it.\n * @template S - The type of state this Cubit manages\n * @template P - The type of parameters (optional, defaults to null)\n */\nexport abstract class Cubit<S, P = null> extends BlocBase<S, P> {\n /**\n * Updates the current state and notifies all observers of the change.\n * If the new state is identical to the current state (using Object.is),\n * no update will occur.\n * @param state - The new state to set\n */\n emit(state: S): void {\n if (Object.is(state, this.state)) {\n return;\n }\n\n const oldState = this.state;\n const newState = state;\n this._pushState(newState, oldState);\n }\n\n /**\n * Partially updates the current state by merging it with the provided state patch.\n * This method is only applicable when the state is an object type.\n * \n * @param statePatch - A partial state object containing only the properties to update\n * @param ignoreChangeCheck - If true, skips checking if the state has actually changed\n * @throws {TypeError} If the state is not an object type\n */\n patch(\n statePatch: S extends object ? Partial<S> : S,\n ignoreChangeCheck = false,\n ): void {\n if (typeof this.state !== 'object' || this.state === null) {\n Blac.warn(\n 'Cubit.patch: was called on a cubit where the state is not an object. This is a no-op.',\n );\n return;\n }\n\n let changes = false;\n if (!ignoreChangeCheck) {\n for (const key in statePatch) {\n if (Object.prototype.hasOwnProperty.call(statePatch, key)) {\n const s = this.state;\n const current = s[key as keyof S];\n if (!Object.is(statePatch[key as keyof S], current)) {\n changes = true;\n break;\n }\n }\n }\n } else {\n changes = true;\n }\n\n if (changes) {\n this.emit({\n ...this.state,\n ...(statePatch as Partial<S>),\n } as S);\n }\n }\n}\n","import { Blac } from './Blac';\nimport { BlocBase } from './BlocBase';\n\n// A should be the base type for all events this Bloc handles and must be an object type\n// to access action.constructor. Events are typically class instances.\n// P is for props, changed from any to unknown.\nexport abstract class Bloc<\n S, // State type\n A extends object, // Base Action/Event type, constrained to object\n P = unknown // Props type\n> extends BlocBase<S, P> {\n // Stores handlers: Map<EventConstructor (subtype of A), HandlerFunction>\n // The handler's event parameter will be correctly typed to the specific EventConstructor\n // by the 'on' method's signature.\n readonly eventHandlers: Map<\n // Key: Constructor of a specific event E (where E extends A)\n // Using 'any[]' for constructor arguments for broader compatibility.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n new (...args: any[]) => A,\n // Value: Handler function. 'event: A' is used here for the stored function type.\n // The 'on' method ensures the specific handler (event: E) is correctly typed.\n (event: A, emit: (newState: S) => void) => void | Promise<void>\n > = new Map();\n\n /**\n * Registers an event handler for a specific event type.\n * This method is typically called in the constructor of a derived Bloc class.\n * @param eventConstructor The constructor of the event to handle (e.g., LoadDataEvent).\n * @param handler A function that processes the event and can emit new states.\n * The 'event' parameter in the handler will be typed to the specific eventConstructor.\n */\n protected on<E extends A>(\n // Using 'any[]' for constructor arguments for broader compatibility.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n eventConstructor: new (...args: any[]) => E, \n handler: (event: E, emit: (newState: S) => void) => void | Promise<void>\n ): void {\n if (this.eventHandlers.has(eventConstructor)) {\n // Using Blac.warn or a similar logging mechanism from BlocBase if available,\n // otherwise console.warn. Assuming this._name and this._id are available from BlocBase.\n Blac.warn(\n `[Bloc ${this._name}:${String(this._id)}] Handler for event '${eventConstructor.name}' already registered. It will be overwritten.`\n );\n }\n // Cast the specific handler (event: E) to a more general (event: A) for storage.\n // This is safe because E extends A. When the handler is called with an 'action' of type A,\n // if it was originally registered for type E, 'action' must be an instance of E.\n this.eventHandlers.set(\n eventConstructor,\n handler as (event: A, emit: (newState: S) => void) => void | Promise<void>\n );\n }\n\n /**\n * Dispatches an action/event to the Bloc.\n * If a handler is registered for this specific event type (via 'on'), it will be invoked.\n * Asynchronous handlers are awaited.\n * @param action The action/event instance to be processed.\n */\n public add = async (action: A): Promise<void> => {\n // Using 'any[]' for constructor arguments for broader compatibility.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const eventConstructor = action.constructor as new (...args: any[]) => A;\n const handler = this.eventHandlers.get(eventConstructor);\n\n if (handler) {\n // Define the 'emit' function that handlers will use to update state.\n // It captures the current state ('this.state') right before each emission\n // to provide the correct 'previousState' to _pushState.\n const emit = (newState: S): void => {\n const previousState = this.state; // State just before this specific emission\n // The 'action' passed to _pushState is the original action that triggered the handler,\n // providing context for the state change (e.g., for logging or plugins).\n this._pushState(newState, previousState, action);\n };\n\n try {\n // Await the handler in case it's an async function (e.g., performs API calls).\n // The 'action' is passed to the handler, and due to the way 'on' is typed,\n // the 'event' parameter within the handler function will be correctly\n // typed to its specific class (e.g., LoadMyFeatureData).\n await handler(action, emit);\n } catch (error) {\n // It's good practice to handle errors occurring within event handlers.\n Blac.error(\n `[Bloc ${this._name}:${String(this._id)}] Error in event handler for '${eventConstructor.name}':`,\n error,\n \"Action:\", action\n );\n // Depending on the desired error handling strategy, you might:\n // 1. Emit a specific error state: this.emit(new MyErrorState(error));\n // 2. Re-throw the error: throw error;\n // 3. Log and ignore (as done here by default).\n // This should be decided based on application requirements.\n }\n } else {\n // action.constructor.name should be safe due to 'A extends object' and common JS practice for constructors.\n // If linting still complains, it might be overly strict for this common pattern.\n const constructorName = (action.constructor as { name?: string }).name || 'UnnamedConstructor';\n Blac.warn(\n `[Bloc ${this._name}:${String(this._id)}] No handler registered for action type: '${constructorName}'. Action was:`,\n action\n );\n // If no handler is found, the action is effectively ignored.\n // Consider if this is the desired behavior or if an error should be thrown\n // or a default handler should be invoked.\n }\n };\n}\n","import { BlocBase, BlocInstanceId } from '../BlocBase';\nimport BlacAddon, { BlacAddonEmit, BlacAddonInit } from './BlacAddon';\n\ntype StorageType = 'localStorage' | 'sessionStorage';\n\nfunction getStorage(type: StorageType): Storage {\n switch (type) {\n case 'localStorage':\n return localStorage;\n case 'sessionStorage':\n return sessionStorage;\n default:\n return localStorage;\n }\n}\n\n/**\n * Persist addon\n *\n * @param options\n * @returns BlacAddon\n */\nexport function Persist(\n options: {\n /**\n * @default 'blac'\n */\n keyPrefix?: string;\n /**\n * @default the bloc's id\n */\n keyName?: string;\n /**\n * Used when the value is not found in storage\n */\n defaultValue?: unknown;\n\n /**\n * @default 'localStorage'\n * @see StorageType\n */\n storageType?: StorageType;\n\n /**\n * @default false\n */\n onError?: (e: unknown) => void;\n } = {},\n): BlacAddon {\n const {\n keyPrefix = 'blac',\n keyName,\n defaultValue,\n storageType = 'localStorage',\n } = options;\n\n const fullKey = (id: string | BlocInstanceId) => `${keyPrefix}:${String(id)}`;\n\n const getFromLocalStorage = (id: string | BlocInstanceId): unknown => {\n try {\n // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n const value = getStorage(storageType).getItem(fullKey(id));\n if (typeof value !== 'string') {\n return defaultValue;\n }\n\n const p = JSON.parse(value) as { v: unknown };\n if (typeof p.v !== 'undefined') {\n return p.v;\n } else {\n return defaultValue;\n }\n } catch (e) {\n options.onError?.(e);\n return defaultValue;\n }\n };\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const onInit: BlacAddonInit = (e: BlocBase<any>) => {\n const id = keyName ?? e._id;\n\n const value = getFromLocalStorage(id);\n e._pushState(value, null);\n };\n\n let currentCachedValue = '';\n const onEmit: BlacAddonEmit = ({ newState, cubit }) => {\n const id = keyName ?? cubit._id;\n\n const newValue = JSON.stringify({ v: newState });\n\n if (newValue !== currentCachedValue) {\n // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access\n getStorage(storageType).setItem(fullKey(id), newValue);\n currentCachedValue = newValue;\n }\n };\n\n return {\n name: 'Persist',\n onInit,\n onEmit,\n };\n}\n"],"names":["BlacLifecycleEvent","_Blac","options","__publicField","args","message","oldBlocInstanceMap","oldIsolatedBlocMap","bloc","blocArray","plugin","p","event","params","base","key","blocClass","id","blocId","isolatedBloc","registeredBloc","isIsolated","registered","results","blocInstance","isolatedBlocs","__unsafe_ignore_singleton","blocClassName","found","blocs","index","b","props","instanceRef","newBloc","Blac","BlacObservable","observer","_a","newState","oldState","action","shouldUpdate","lastDependencyCheck","newDependencyCheck","o","partNew","partOld","i","BlocBase","initialState","originalId","consumerId","addons","addon","constructorWithStaticProps","Cubit","state","statePatch","ignoreChangeCheck","changes","current","Bloc","eventConstructor","handler","emit","previousState","error","constructorName","getStorage","type","Persist","keyPrefix","keyName","defaultValue","storageType","fullKey","getFromLocalStorage","value","e","onInit","currentCachedValue","cubit","newValue"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs.js","sources":["../src/Blac.ts","../src/BlacObserver.ts","../src/BlocBase.ts","../src/Bloc.ts","../src/Cubit.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n// TODO: Remove this eslint disable once any types are properly replaced\nimport { BlocBase, BlocInstanceId } from \"./BlocBase\";\nimport {\n BlocBaseAbstract,\n BlocConstructor,\n BlocHookDependencyArrayFn,\n BlocState,\n InferPropsFromGeneric\n} from \"./types\";\n\n/**\n * Configuration options for the Blac instance\n */\nexport interface BlacConfig {\n /** Whether to expose the Blac instance globally */\n exposeBlacInstance?: boolean;\n}\n\nexport interface GetBlocOptions<B extends BlocBase<unknown>> {\n id?: string;\n selector?: BlocHookDependencyArrayFn<BlocState<B>>;\n props?: InferPropsFromGeneric<B>;\n onMount?: (bloc: B) => void;\n instanceRef?: string;\n throwIfNotFound?: boolean;\n}\n\n/**\n * Interface for Blac instance management\n */\nexport interface BlacInstanceManager {\n getInstance(): Blac;\n setInstance(instance: Blac): void;\n resetInstance(): void;\n}\n\n/**\n * Default singleton implementation of BlacInstanceManager\n */\nclass SingletonBlacManager implements BlacInstanceManager {\n private static _instance: Blac;\n\n getInstance(): Blac {\n if (!SingletonBlacManager._instance) {\n SingletonBlacManager._instance = new Blac({ __unsafe_ignore_singleton: true });\n }\n return SingletonBlacManager._instance;\n }\n\n setInstance(instance: Blac): void {\n SingletonBlacManager._instance = instance;\n }\n\n resetInstance(): void {\n const oldInstance = SingletonBlacManager._instance;\n SingletonBlacManager._instance = new Blac({ __unsafe_ignore_singleton: true });\n \n // Transfer any keep-alive blocs to the new instance\n for (const bloc of oldInstance.keepAliveBlocs) {\n SingletonBlacManager._instance.keepAliveBlocs.add(bloc);\n SingletonBlacManager._instance.uidRegistry.set(bloc.uid, bloc);\n }\n }\n}\n\n/**\n * Global instance manager (can be replaced for testing or different patterns)\n */\nlet instanceManager: BlacInstanceManager = new SingletonBlacManager();\n\n/**\n * Sets a custom instance manager (useful for testing or advanced patterns)\n */\nexport function setBlacInstanceManager(manager: BlacInstanceManager): void {\n instanceManager = manager;\n}\n\n/**\n * Main Blac class that manages the state management system.\n * Can work with singleton pattern or dependency injection.\n * Handles bloc lifecycle, and instance tracking.\n * \n * Key responsibilities:\n * - Managing bloc instances (creation, disposal, lookup)\n * - Handling isolated and non-isolated blocs\n * - Providing logging and debugging capabilities\n */\nexport class Blac {\n /** @deprecated Use getInstance() instead */\n static get instance(): Blac {\n return instanceManager.getInstance();\n }\n /** Timestamp when the instance was created */\n createdAt = Date.now();\n static get getAllBlocs() {\n return Blac.instance.getAllBlocs;\n }\n /** Map storing all registered bloc instances by their class name and ID */\n blocInstanceMap: Map<string, BlocBase<unknown>> = new Map();\n /** Map storing isolated bloc instances grouped by their constructor */\n isolatedBlocMap: Map<BlocConstructor<unknown>, BlocBase<unknown>[]> = new Map();\n /** Map for O(1) lookup of isolated blocs by UID */\n private isolatedBlocIndex: Map<string, BlocBase<unknown>> = new Map();\n /** Map tracking UIDs to prevent memory leaks */\n uidRegistry: Map<string, BlocBase<unknown>> = new Map();\n /** Set of keep-alive blocs for controlled cleanup */\n keepAliveBlocs: Set<BlocBase<unknown>> = new Set();\n /** Flag to control whether changes should be posted to document */\n postChangesToDocument = false;\n\n /**\n * Creates a new Blac instance.\n * @param options - Configuration options including singleton control\n */\n constructor(options: { __unsafe_ignore_singleton?: boolean } = {}) {\n const { __unsafe_ignore_singleton = false } = options;\n if (!__unsafe_ignore_singleton) {\n return Blac.instance;\n }\n instanceManager.setInstance(this);\n }\n\n /** Flag to enable/disable logging */\n static enableLog = false;\n\n /**\n * Logs messages to console when logging is enabled\n * @param args - Arguments to log\n */\n log = (...args: unknown[]) => {\n if (Blac.enableLog) console.warn(`☢️ [Blac ${this.createdAt.toString()}]`, ...args);\n };\n static get log() { return Blac.instance.log; }\n\n /**\n * Gets the current Blac instance\n * @returns The Blac instance\n */\n static getInstance(): Blac {\n return instanceManager.getInstance();\n }\n\n\n /**\n * Logs a warning message\n * @param message - Warning message\n * @param args - Additional arguments\n */\n warn = (message: string, ...args: unknown[]) => {\n if (Blac.enableLog) {\n console.warn(`🚨 [Blac ${String(Blac.instance.createdAt)}]`, message, ...args);\n }\n };\n static get warn() { return Blac.instance.warn; }\n /**\n * Logs an error message\n * @param message - Error message\n * @param args - Additional arguments\n */\n error = (message: string, ...args: unknown[]) => {\n if (Blac.enableLog) {\n console.error(`🚨 [Blac ${String(Blac.instance.createdAt)}]`, message, ...args);\n }\n };\n static get error() { return Blac.instance.error; }\n\n /**\n * Resets the Blac instance to a new one, disposing non-keepAlive blocs\n * from the old instance.\n */\n resetInstance = (): void => {\n this.log(\"Reset Blac instance\");\n\n // Dispose non-keepAlive blocs from the current instance\n const oldBlocInstanceMap = new Map(this.blocInstanceMap);\n const oldIsolatedBlocMap = new Map(this.isolatedBlocMap);\n\n oldBlocInstanceMap.forEach((bloc) => {\n if (!bloc._keepAlive) {\n bloc._dispose();\n }\n });\n\n oldIsolatedBlocMap.forEach((blocArray) => {\n blocArray.forEach((bloc) => {\n if (!bloc._keepAlive) {\n bloc._dispose();\n }\n });\n });\n\n this.blocInstanceMap.clear();\n this.isolatedBlocMap.clear();\n this.isolatedBlocIndex.clear();\n\n // Use instance manager to reset\n instanceManager.resetInstance();\n }\n static resetInstance = (): void => {\n instanceManager.resetInstance();\n };\n\n /**\n * Disposes of a bloc instance by removing it from the appropriate registry\n * @param bloc - The bloc instance to dispose\n */\n disposeBloc = (bloc: BlocBase<unknown>): void => {\n const base = bloc.constructor as unknown as BlocBaseAbstract;\n const key = this.createBlocInstanceMapKey(bloc._name, bloc._id);\n this.log(`[${bloc._name}:${String(bloc._id)}] disposeBloc called. Isolated: ${String(base.isolated)}`);\n\n if (base.isolated) {\n this.unregisterIsolatedBlocInstance(bloc);\n this.blocInstanceMap.delete(key);\n } else {\n this.unregisterBlocInstance(bloc);\n }\n this.log('dispatched bloc', bloc)\n };\n\n /**\n * Creates a unique key for a bloc instance in the map based on the bloc class name and instance ID\n * @param blocClassName - The name of the bloc class\n * @param id - The instance ID\n * @returns A unique key string in the format \"className:id\"\n */\n createBlocInstanceMapKey(blocClassName: string, id: BlocInstanceId): string {\n return `${blocClassName}:${String(id)}`;\n }\n\n /**\n * Unregister a bloc instance from the main registry\n * @param bloc - The bloc instance to unregister\n */\n unregisterBlocInstance(bloc: BlocBase<unknown>): void {\n const key = this.createBlocInstanceMapKey(bloc._name, bloc._id);\n this.blocInstanceMap.delete(key);\n \n // Clean up UID tracking\n this.uidRegistry.delete(bloc.uid);\n \n // Remove from keep-alive set\n this.keepAliveBlocs.delete(bloc);\n }\n\n /**\n * Registers a bloc instance in the main registry\n * @param bloc - The bloc instance to register\n */\n registerBlocInstance(bloc: BlocBase<unknown>): void {\n const key = this.createBlocInstanceMapKey(bloc._name, bloc._id);\n this.blocInstanceMap.set(key, bloc);\n \n // Track UID for cleanup\n this.uidRegistry.set(bloc.uid, bloc);\n \n // Track keep-alive blocs\n if (bloc._keepAlive) {\n this.keepAliveBlocs.add(bloc);\n }\n }\n\n /**\n * Finds a registered bloc instance by its class and ID\n * @param blocClass - The bloc class to search for\n * @param id - The instance ID\n * @returns The found bloc instance or undefined if not found\n */\n findRegisteredBlocInstance<B extends BlocConstructor<unknown>>(\n blocClass: B,\n id: BlocInstanceId,\n ): InstanceType<B> | undefined {\n const base = blocClass as unknown as BlocBaseAbstract;\n if (base.isolated) return undefined;\n\n const key = this.createBlocInstanceMapKey(blocClass.name, id);\n const found = this.blocInstanceMap.get(key) as InstanceType<B> | undefined;\n return found\n }\n\n /**\n * Registers an isolated bloc instance in the isolated registry\n * @param bloc - The isolated bloc instance to register\n */\n registerIsolatedBlocInstance(bloc: BlocBase<unknown>): void {\n const blocClass = bloc.constructor as BlocConstructor<unknown>;\n const blocs = this.isolatedBlocMap.get(blocClass);\n if (blocs) {\n blocs.push(bloc);\n } else {\n this.isolatedBlocMap.set(blocClass, [bloc]);\n }\n \n // Add to isolated index for O(1) lookups\n this.isolatedBlocIndex.set(bloc.uid, bloc);\n \n // Track UID for cleanup\n this.uidRegistry.set(bloc.uid, bloc);\n \n // Track keep-alive blocs\n if (bloc._keepAlive) {\n this.keepAliveBlocs.add(bloc);\n }\n }\n\n /**\n * Unregister an isolated bloc instance from the isolated registry\n * @param bloc - The isolated bloc instance to unregister\n */\n unregisterIsolatedBlocInstance(bloc: BlocBase<unknown>): void {\n const blocClass = bloc.constructor;\n const blocs = this.isolatedBlocMap.get(blocClass as BlocConstructor<unknown>);\n if (blocs) {\n const index = blocs.findIndex((b) => b.uid === bloc.uid);\n if (index !== -1) {\n blocs.splice(index, 1);\n }\n\n if (blocs.length === 0) {\n this.isolatedBlocMap.delete(blocClass as BlocConstructor<unknown>);\n }\n }\n \n // Remove from isolated index\n this.isolatedBlocIndex.delete(bloc.uid);\n \n // Clean up UID tracking\n this.uidRegistry.delete(bloc.uid);\n \n // Remove from keep-alive set\n this.keepAliveBlocs.delete(bloc);\n }\n\n /**\n * Finds an isolated bloc instance by its class and ID (O(n) lookup)\n */\n findIsolatedBlocInstance<B extends BlocConstructor<unknown>>(\n blocClass: B,\n id: BlocInstanceId,\n ): InstanceType<B> | undefined {\n const base = blocClass as unknown as BlocBaseAbstract;\n if (!base.isolated) return undefined;\n\n const blocs = this.isolatedBlocMap.get(blocClass);\n if (!blocs) {\n return undefined;\n }\n // Find the specific bloc by ID within the isolated array\n const found = blocs.find((b) => b._id === id) as InstanceType<B> | undefined;\n return found;\n }\n\n /**\n * Finds an isolated bloc instance by UID (O(1) lookup)\n */\n findIsolatedBlocInstanceByUid<B extends BlocBase<unknown>>(\n uid: string\n ): B | undefined {\n return this.isolatedBlocIndex.get(uid) as B | undefined;\n }\n\n /**\n * Creates a new bloc instance and registers it in the appropriate registry\n * @param blocClass - The bloc class to instantiate\n * @param id - The instance ID\n * @param props - Properties to pass to the bloc constructor\n * @param instanceRef - Optional reference string for the instance\n * @returns The newly created bloc instance\n */\n createNewBlocInstance<B extends BlocConstructor<BlocBase<unknown>>>(\n blocClass: B,\n id: BlocInstanceId,\n options: GetBlocOptions<InstanceType<B>> = {},\n ): InstanceType<B> {\n const { props, instanceRef } = options;\n const newBloc = new blocClass(props as never) as InstanceType<BlocConstructor<BlocBase<unknown>>>;\n newBloc._instanceRef = instanceRef;\n newBloc.props = props || null;\n newBloc._updateId(id);\n\n // Set up disposal handler to break circular dependency\n newBloc._setDisposalHandler((bloc) => this.disposeBloc(bloc));\n\n if (newBloc.isIsolated) {\n this.registerIsolatedBlocInstance(newBloc);\n return newBloc as InstanceType<B>;\n }\n\n this.registerBlocInstance(newBloc);\n return newBloc as InstanceType<B>;\n }\n\n\n activateBloc = (bloc: BlocBase<unknown>): void => {\n const base = bloc.constructor as unknown as BlocConstructor<BlocBase<unknown>>;\n const isIsolated = bloc.isIsolated;\n\n let found = isIsolated ? this.findIsolatedBlocInstance(base, bloc._id) : this.findRegisteredBlocInstance(base, bloc._id);\n if (found) {\n return;\n }\n\n this.log(`[${bloc._name}:${String(bloc._id)}] activateBloc called. Isolated: ${String(bloc.isIsolated)}`);\n if (bloc.isIsolated) {\n this.registerIsolatedBlocInstance(bloc);\n } else {\n this.registerBlocInstance(bloc);\n }\n };\n static get activateBloc() { return Blac.instance.activateBloc; }\n\n /**\n * Gets or creates a bloc instance based on the provided class and options.\n * If a bloc with the given ID exists, it will be returned. Otherwise, a new instance will be created.\n * \n * @param blocClass - The bloc class to get or create\n * @param options - Options including:\n * - id: The instance ID (defaults to class name if not provided)\n * - props: Properties to pass to the bloc constructor\n * - instanceRef: Optional reference string for the instance\n * @returns The bloc instance\n */\n getBloc = <B extends BlocConstructor<BlocBase<unknown>>>(\n blocClass: B,\n options: GetBlocOptions<InstanceType<B>> = {},\n ): InstanceType<B> => {\n const { id } = options;\n const base = blocClass as unknown as BlocBaseAbstract;\n const blocId = id ?? blocClass.name;\n\n\n if (base.isolated) {\n const isolatedBloc = this.findIsolatedBlocInstance<B>(blocClass, blocId)\n if (isolatedBloc) {\n this.log(`[${blocClass.name}:${String(blocId)}] (getBloc) Found existing isolated instance.`, options);\n return isolatedBloc;\n } else {\n if (options.throwIfNotFound) {\n throw new Error(`Isolated bloc ${blocClass.name} not found`);\n }\n }\n } else {\n const registeredBloc = this.findRegisteredBlocInstance(blocClass, blocId)\n if (registeredBloc) {\n this.log(`[${blocClass.name}:${String(blocId)}] (getBloc) Found existing registered instance.`, options);\n return registeredBloc\n } else {\n if (options.throwIfNotFound) {\n throw new Error(`Registered bloc ${blocClass.name} not found`);\n }\n }\n }\n\n const bloc = this.createNewBlocInstance(\n blocClass,\n blocId,\n options,\n );\n this.log(`[${blocClass.name}:${String(blocId)}] (getBloc) No existing instance found. Creating new one.`, options, bloc);\n return bloc;\n };\n static get getBloc() { return Blac.instance.getBloc; }\n\n /**\n * Gets a bloc instance or throws an error if it doesn't exist\n * @param blocClass - The bloc class to get\n * @param options - Options including:\n * - id: The instance ID (defaults to class name if not provided)\n * - props: Properties to pass to the bloc constructor\n * - instanceRef: Optional reference string for the instance\n */\n getBlocOrThrow = <B extends BlocConstructor<unknown>>(\n blocClass: B,\n options: {\n id?: BlocInstanceId;\n props?: InferPropsFromGeneric<B>;\n instanceRef?: string;\n } = {},\n ): InstanceType<B> => {\n const isIsolated = (blocClass as unknown as BlocBaseAbstract).isolated;\n const id = options.id || blocClass.name;\n\n const registered = isIsolated\n ? this.findIsolatedBlocInstance(blocClass, id)\n : this.findRegisteredBlocInstance(blocClass, id);\n\n if (registered) {\n return registered;\n }\n throw new Error(`Bloc ${blocClass.name} not found`);\n };\n static get getBlocOrThrow() { return Blac.instance.getBlocOrThrow; }\n\n /**\n * Gets all instances of a specific bloc class\n * @param blocClass - The bloc class to search for\n * @param options - Options including:\n * - searchIsolated: Whether to search in isolated blocs (defaults to bloc's isolated property)\n * @returns Array of matching bloc instances\n */\n getAllBlocs = <B extends BlocConstructor<unknown>>(\n blocClass: B,\n options: {\n searchIsolated?: boolean;\n } = {},\n ): InstanceType<B>[] => {\n const results: InstanceType<B>[] = [];\n // const blocClassName = (blocClass as any).name; // Temporarily removed for debugging\n\n // Search non-isolated blocs\n this.blocInstanceMap.forEach((blocInstance) => {\n if (blocInstance.constructor === blocClass) { // Strict constructor check\n results.push(blocInstance as InstanceType<B>);\n }\n });\n\n // Optionally search isolated blocs\n if (options.searchIsolated !== false) {\n const isolatedBlocs = this.isolatedBlocMap.get(blocClass);\n if (isolatedBlocs) {\n results.push(...isolatedBlocs.map(bloc => bloc as InstanceType<B>));\n }\n }\n\n return results;\n };\n\n /**\n * Disposes all keep-alive blocs of a specific type\n * @param blocClass - The bloc class to dispose\n */\n disposeKeepAliveBlocs = <B extends BlocConstructor<unknown>>(\n blocClass?: B\n ): void => {\n const toDispose: BlocBase<unknown>[] = [];\n \n for (const bloc of this.keepAliveBlocs) {\n if (!blocClass || bloc.constructor === blocClass) {\n toDispose.push(bloc);\n }\n }\n \n toDispose.forEach(bloc => bloc._dispose());\n };\n static get disposeKeepAliveBlocs() { return Blac.instance.disposeKeepAliveBlocs; }\n\n /**\n * Disposes all blocs matching a pattern\n * @param predicate - Function to test each bloc for disposal\n */\n disposeBlocs = (predicate: (bloc: BlocBase<unknown>) => boolean): void => {\n const toDispose: BlocBase<unknown>[] = [];\n \n // Check registered blocs\n for (const bloc of this.blocInstanceMap.values()) {\n if (predicate(bloc)) {\n toDispose.push(bloc);\n }\n }\n \n // Check isolated blocs\n for (const blocs of this.isolatedBlocMap.values()) {\n for (const bloc of blocs) {\n if (predicate(bloc)) {\n toDispose.push(bloc);\n }\n }\n }\n \n toDispose.forEach(bloc => bloc._dispose());\n };\n static get disposeBlocs() { return Blac.instance.disposeBlocs; }\n\n /**\n * Gets memory usage statistics for debugging\n */\n getMemoryStats = () => {\n return {\n totalBlocs: this.uidRegistry.size,\n registeredBlocs: this.blocInstanceMap.size,\n isolatedBlocs: Array.from(this.isolatedBlocMap.values()).reduce((sum, arr) => sum + arr.length, 0),\n keepAliveBlocs: this.keepAliveBlocs.size,\n isolatedBlocTypes: this.isolatedBlocMap.size,\n };\n };\n static get getMemoryStats() { return Blac.instance.getMemoryStats; }\n\n /**\n * Validates consumer references and cleans up orphaned consumers\n */\n validateConsumers = (): void => {\n for (const bloc of this.uidRegistry.values()) {\n // This would need to be called periodically to clean up orphaned consumers\n // Implementation depends on how we want to handle consumer validation\n if (bloc._consumers.size === 0 && !bloc._keepAlive) {\n // Schedule disposal for blocs with no consumers\n setTimeout(() => {\n if (bloc._consumers.size === 0 && !bloc._keepAlive) {\n bloc._dispose();\n }\n }, 1000); // Give a grace period\n }\n }\n };\n static get validateConsumers() { return Blac.instance.validateConsumers; }\n}\n","import { Blac } from './Blac';\nimport { BlocBase } from './BlocBase';\nimport { BlocHookDependencyArrayFn } from './types';\n\n/**\n * Represents an observer that can subscribe to state changes in a Bloc\n * @template S - The type of state being observed\n */\nexport type BlacObserver<S> = {\n /** Function to be called when state changes */\n fn: (newState: S, oldState: S, action?: unknown) => void | Promise<void>;\n /** Optional function to determine if the observer should be notified of state changes */\n dependencyArray?: BlocHookDependencyArrayFn<S>;\n /** Dispose function for the observer */\n dispose?: () => void;\n /** Cached state values used for dependency comparison */\n lastState?: unknown[][];\n /** Unique identifier for the observer */\n id: string;\n};\n\n/**\n * A class that manages observers for a Bloc's state changes\n * @template S - The type of state being observed\n */\nexport class BlacObservable<S = unknown> {\n /** The Bloc instance this observable is associated with */\n bloc: BlocBase<S>;\n\n /**\n * Creates a new BlacObservable instance\n * @param bloc - The Bloc instance to observe\n */\n constructor(bloc: BlocBase<S>) {\n this.bloc = bloc;\n }\n\n private _observers = new Set<BlacObserver<S>>();\n\n /**\n * Gets the number of active observers\n * @returns The number of observers currently subscribed\n */\n get size(): number {\n return this._observers.size;\n }\n\n /**\n * Gets the set of all observers\n * @returns The Set of all BlacObserver instances\n */\n get observers() {\n return this._observers;\n }\n\n /**\n * Subscribes an observer to state changes\n * @param observer - The observer to subscribe\n * @returns A function that can be called to unsubscribe the observer\n */\n subscribe(observer: BlacObserver<S>): () => void {\n Blac.log('BlacObservable.subscribe: Subscribing observer.', this.bloc, observer);\n this._observers.add(observer);\n // Blac.instance.dispatchEvent(BlacLifecycleEvent.LISTENER_ADDED, this.bloc, { listenerId: observer.id });\n if (!observer.lastState) {\n observer.lastState = observer.dependencyArray\n ? observer.dependencyArray(this.bloc.state)\n : [];\n }\n return () => {\n Blac.log('BlacObservable.subscribe: Unsubscribing observer.', this.bloc, observer);\n this.unsubscribe(observer);\n }\n }\n\n /**\n * Unsubscribes an observer from state changes\n * @param observer - The observer to unsubscribe\n */\n unsubscribe(observer: BlacObserver<S>) {\n this._observers.delete(observer);\n // Blac.instance.dispatchEvent(BlacLifecycleEvent.LISTENER_REMOVED, this.bloc, { listenerId: observer.id });\n\n if (this.size === 0) {\n Blac.log('BlacObservable.unsubscribe: No observers left. Disposing bloc.', this.bloc);\n this.bloc._dispose();\n }\n }\n\n /**\n * Notifies all observers of a state change\n * @param newState - The new state value\n * @param oldState - The previous state value\n * @param action - Optional action that triggered the state change\n */\n notify(newState: S, oldState: S, action?: unknown) {\n this._observers.forEach((observer) => {\n let shouldUpdate = false;\n\n if (observer.dependencyArray) {\n const lastDependencyCheck = observer.lastState || [];\n const newDependencyCheck = observer.dependencyArray(newState);\n\n for (let o = 0; o < newDependencyCheck.length; o++) {\n const partNew = newDependencyCheck[o];\n const partOld = lastDependencyCheck[o] || [];\n for (let i = 0; i < partNew.length; i++) {\n if (!Object.is(partNew[i], partOld[i])) {\n shouldUpdate = true;\n break;\n }\n }\n }\n\n observer.lastState = newDependencyCheck;\n } else {\n shouldUpdate = true;\n }\n\n if (shouldUpdate) {\n void observer.fn(newState, oldState, action);\n }\n });\n }\n\n /**\n * Clears the observer set\n */\n clear() {\n this._observers.forEach((observer) => {\n this.unsubscribe(observer);\n });\n this._observers.clear();\n }\n}\n","import { BlacObservable } from './BlacObserver';\nimport { BlocConstructor } from './types';\n\nexport type BlocInstanceId = string | number | undefined;\ntype DependencySelector<S> = (newState: S) => unknown[][];\n\n// Define an interface for the static properties expected on a Bloc/Cubit constructor\ninterface BlocStaticProperties {\n isolated: boolean;\n keepAlive: boolean;\n}\n\n/**\n * Base class for both Blocs and Cubits that provides core state management functionality.\n * Handles state transitions, observer notifications, lifecycle management, and addon integration.\n * \n * @abstract This class should be extended, not instantiated directly\n * @template S The type of state managed by this Bloc\n * @template P The type of props that can be passed during instance creation (optional)\n */\nexport abstract class BlocBase<\n S,\n P = unknown\n> {\n public uid = crypto.randomUUID();\n /**\n * When true, every consumer will receive its own unique instance of this Bloc.\n * Use this when state should not be shared between components.\n * @default false\n */\n static isolated = false;\n get isIsolated() {\n return this._isolated;\n }\n \n /**\n * When true, the Bloc instance persists even when there are no active consumers.\n * Useful for maintaining state between component unmount/remount cycles.\n * @default false\n */\n static keepAlive = false;\n get isKeepAlive() {\n return this._keepAlive;\n }\n \n /**\n * Defines how dependencies are selected from the state for efficient updates.\n * When provided, observers will only be notified when selected dependencies change.\n */\n defaultDependencySelector: DependencySelector<S> | undefined;\n \n /**\n * @internal\n * Indicates if this specific Bloc instance is isolated from others of the same type.\n */\n public _isolated = false;\n \n /**\n * @internal\n * Observable responsible for managing state listeners and notifying consumers.\n */\n public _observer: BlacObservable<S>;\n \n /**\n * The unique identifier for this Bloc instance.\n * Defaults to the class name, but can be customized.\n */\n public _id: BlocInstanceId;\n \n /**\n * @internal\n * Reference string used internally for tracking and debugging.\n */\n public _instanceRef?: string;\n \n /**\n * @internal\n * Indicates if this specific Bloc instance should be kept alive when no consumers are present.\n */\n public _keepAlive = false;\n \n /**\n * @readonly\n * Timestamp when this Bloc instance was created, useful for debugging and performance tracking.\n */\n public readonly _createdAt = Date.now();\n\n /**\n * @internal\n * The current state of the Bloc.\n */\n public _state: S;\n \n /**\n * @internal\n * The previous state of the Bloc, maintained for comparison and history.\n */\n public _oldState: S | undefined;\n \n /**\n * Props passed during Bloc instance creation.\n * Can be used to configure or parameterize the Bloc's behavior.\n */\n public props: P | null = null;\n\n /**\n * Creates a new BlocBase instance with the given initial state.\n * Sets up the observer, registers with the Blac manager, and initializes addons.\n * \n * @param initialState The initial state value for this Bloc\n */\n constructor(initialState: S) {\n this._state = initialState;\n this._observer = new BlacObservable(this);\n this._id = this.constructor.name;\n\n // Access static properties safely with proper type checking\n const Constructor = this.constructor as typeof BlocBase & BlocStaticProperties;\n \n // Validate that the static properties exist and are boolean\n this._keepAlive = typeof Constructor.keepAlive === 'boolean' ? Constructor.keepAlive : false;\n this._isolated = typeof Constructor.isolated === 'boolean' ? Constructor.isolated : false;\n }\n\n /**\n * Returns the current state of the Bloc.\n * Use this getter to access the state in a read-only manner.\n */\n get state(): S {\n return this._state;\n }\n\n /**\n * @internal\n * Returns the name of the Bloc class for identification and debugging.\n */\n get _name() {\n return this.constructor.name;\n }\n\n /**\n * @internal\n * Updates the Bloc instance's ID to a new value.\n * Only updates if the new ID is defined and different from the current one.\n * \n * @param id The new ID to assign to this Bloc instance\n */\n _updateId = (id?: BlocInstanceId) => {\n const originalId = this._id;\n if (!id || id === originalId) return;\n this._id = id;\n };\n\n /**\n * @internal\n * Cleans up resources and removes this Bloc from the system.\n * Notifies the Blac manager and clears all observers.\n */\n _dispose() {\n // Clear all consumers\n this._consumers.clear();\n \n // Clear observer subscriptions\n this._observer.clear();\n \n // Call user-defined disposal hook\n this.onDispose?.();\n \n // The Blac manager will handle removal from registry\n // This method is called by Blac.disposeBloc, so we don't need to call it again\n }\n\n /**\n * @internal\n * Optional function to be called when the Bloc is disposed.\n */\n onDispose?: () => void;\n\n /**\n * @internal\n * Set of consumer IDs currently listening to this Bloc's state changes.\n */\n _consumers = new Set<string>();\n\n /**\n * @internal\n * WeakSet to track consumer references for cleanup validation\n */\n private _consumerRefs = new WeakSet<object>();\n\n /**\n * @internal\n * Registers a new consumer to this Bloc instance.\n * Notifies the Blac manager that a consumer has been added.\n * \n * @param consumerId The unique ID of the consumer being added\n * @param consumerRef Optional reference to the consumer object for cleanup validation\n */\n _addConsumer = (consumerId: string, consumerRef?: object) => {\n if (this._consumers.has(consumerId)) return;\n this._consumers.add(consumerId);\n \n if (consumerRef) {\n this._consumerRefs.add(consumerRef);\n }\n \n // this._blac.dispatchEvent(BlacLifecycleEvent.BLOC_CONSUMER_ADDED, this, { consumerId });\n };\n\n /**\n * @internal\n * Unregisters a consumer from this Bloc instance.\n * Notifies the Blac manager that a consumer has been removed.\n * \n * @param consumerId The unique ID of the consumer being removed\n */\n _removeConsumer = (consumerId: string) => {\n if (!this._consumers.has(consumerId)) return;\n this._consumers.delete(consumerId);\n // this._blac.dispatchEvent(BlacLifecycleEvent.BLOC_CONSUMER_REMOVED, this, { consumerId });\n \n // If no consumers remain and not keep-alive, schedule disposal\n if (this._consumers.size === 0 && !this._keepAlive) {\n this._scheduleDisposal();\n }\n };\n\n /**\n * @internal\n * Handler function for disposal (can be set by Blac manager)\n */\n private _disposalHandler?: (bloc: BlocBase<unknown>) => void;\n\n /**\n * @internal\n * Sets the disposal handler for this bloc\n */\n _setDisposalHandler(handler: (bloc: BlocBase<unknown>) => void) {\n this._disposalHandler = handler;\n }\n\n /**\n * @internal\n * Schedules disposal of this bloc instance if it has no consumers\n */\n private _scheduleDisposal() {\n // Use setTimeout to avoid disposal during render cycles\n setTimeout(() => {\n if (this._consumers.size === 0 && !this._keepAlive) {\n if (this._disposalHandler) {\n this._disposalHandler(this as any);\n } else {\n this._dispose();\n }\n }\n }, 0);\n }\n\n lastUpdate = Date.now();\n\n /**\n * @internal\n * Flag to indicate if batching is enabled for this bloc\n */\n private _batchingEnabled = false;\n\n /**\n * @internal\n * Pending state updates when batching is enabled\n */\n private _pendingUpdates: Array<{newState: S, oldState: S, action?: unknown}> = [];\n\n /**\n * @internal\n * Updates the state and notifies all observers of the change.\n * \n * @param newState The new state to be set\n * @param oldState The previous state for comparison\n * @param action Optional metadata about what caused the state change\n */\n _pushState = (newState: S, oldState: S, action?: unknown): void => {\n // Runtime validation for state changes\n if (newState === undefined) {\n console.warn('BlocBase._pushState: newState is undefined', this);\n return;\n }\n \n // Validate action type if provided\n if (action !== undefined && action !== null) {\n const actionType = typeof action;\n if (!(['string', 'object', 'number'].includes(actionType))) {\n console.warn('BlocBase._pushState: Invalid action type', this, action);\n }\n }\n\n // If batching is enabled, queue the update\n if (this._batchingEnabled) {\n this._pendingUpdates.push({ newState, oldState, action });\n return;\n }\n \n this._oldState = oldState;\n this._state = newState;\n this._observer.notify(newState, oldState, action);\n this.lastUpdate = Date.now();\n };\n\n /**\n * Enables batching for multiple state updates\n * @param batchFn Function to execute with batching enabled\n */\n batch = <T>(batchFn: () => T): T => {\n const wasBatching = this._batchingEnabled;\n this._batchingEnabled = true;\n \n try {\n const result = batchFn();\n \n // Process all pending updates\n if (this._pendingUpdates.length > 0) {\n const lastUpdate = this._pendingUpdates[this._pendingUpdates.length - 1];\n this._oldState = this._pendingUpdates[0].oldState;\n this._state = lastUpdate.newState;\n \n // Notify with the final state\n this._observer.notify(lastUpdate.newState, this._oldState, lastUpdate.action);\n this.lastUpdate = Date.now();\n \n this._pendingUpdates = [];\n }\n \n return result;\n } finally {\n this._batchingEnabled = wasBatching;\n }\n };\n}\n","import { Blac } from './Blac';\nimport { BlocBase } from './BlocBase';\n\n// A should be the base type for all events this Bloc handles and must be an object type\n// to access action.constructor. Events are typically class instances.\n// P is for props, changed from any to unknown.\nexport abstract class Bloc<\n S, // State type\n A extends object, // Base Action/Event type, constrained to object\n P = unknown // Props type\n> extends BlocBase<S, P> {\n // Stores handlers: Map<EventConstructor (subtype of A), HandlerFunction>\n // The handler's event parameter will be correctly typed to the specific EventConstructor\n // by the 'on' method's signature.\n readonly eventHandlers: Map<\n // Key: Constructor of a specific event E (where E extends A)\n // Using 'any[]' for constructor arguments for broader compatibility.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n new (...args: any[]) => A,\n // Value: Handler function. 'event: A' is used here for the stored function type.\n // The 'on' method ensures the specific handler (event: E) is correctly typed.\n (event: A, emit: (newState: S) => void) => void | Promise<void>\n > = new Map();\n\n /**\n * Registers an event handler for a specific event type.\n * This method is typically called in the constructor of a derived Bloc class.\n * @param eventConstructor The constructor of the event to handle (e.g., LoadDataEvent).\n * @param handler A function that processes the event and can emit new states.\n * The 'event' parameter in the handler will be typed to the specific eventConstructor.\n */\n protected on<E extends A>(\n // Using 'any[]' for constructor arguments for broader compatibility.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n eventConstructor: new (...args: any[]) => E, \n handler: (event: E, emit: (newState: S) => void) => void | Promise<void>\n ): void {\n if (this.eventHandlers.has(eventConstructor)) {\n // Using Blac.warn or a similar logging mechanism from BlocBase if available,\n // otherwise console.warn. Assuming this._name and this._id are available from BlocBase.\n Blac.warn(\n `[Bloc ${this._name}:${String(this._id)}] Handler for event '${eventConstructor.name}' already registered. It will be overwritten.`\n );\n }\n // Cast the specific handler (event: E) to a more general (event: A) for storage.\n // This is safe because E extends A. When the handler is called with an 'action' of type A,\n // if it was originally registered for type E, 'action' must be an instance of E.\n this.eventHandlers.set(\n eventConstructor,\n handler as (event: A, emit: (newState: S) => void) => void | Promise<void>\n );\n }\n\n /**\n * Dispatches an action/event to the Bloc.\n * If a handler is registered for this specific event type (via 'on'), it will be invoked.\n * Asynchronous handlers are awaited.\n * @param action The action/event instance to be processed.\n */\n public add = async (action: A): Promise<void> => {\n // Using 'any[]' for constructor arguments for broader compatibility.\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const eventConstructor = action.constructor as new (...args: any[]) => A;\n const handler = this.eventHandlers.get(eventConstructor);\n\n if (handler) {\n // Define the 'emit' function that handlers will use to update state.\n // It captures the current state ('this.state') right before each emission\n // to provide the correct 'previousState' to _pushState.\n const emit = (newState: S): void => {\n const previousState = this.state; // State just before this specific emission\n // The 'action' passed to _pushState is the original action that triggered the handler,\n // providing context for the state change (e.g., for logging or plugins).\n this._pushState(newState, previousState, action);\n };\n\n try {\n // Await the handler in case it's an async function (e.g., performs API calls).\n // The 'action' is passed to the handler, and due to the way 'on' is typed,\n // the 'event' parameter within the handler function will be correctly\n // typed to its specific class (e.g., LoadMyFeatureData).\n await handler(action, emit);\n } catch (error) {\n // It's good practice to handle errors occurring within event handlers.\n Blac.error(\n `[Bloc ${this._name}:${String(this._id)}] Error in event handler for '${eventConstructor.name}':`,\n error,\n \"Action:\", action\n );\n // Depending on the desired error handling strategy, you might:\n // 1. Emit a specific error state: this.emit(new MyErrorState(error));\n // 2. Re-throw the error: throw error;\n // 3. Log and ignore (as done here by default).\n // This should be decided based on application requirements.\n }\n } else {\n // action.constructor.name should be safe due to 'A extends object' and common JS practice for constructors.\n // If linting still complains, it might be overly strict for this common pattern.\n const constructorName = (action.constructor as { name?: string }).name || 'UnnamedConstructor';\n Blac.warn(\n `[Bloc ${this._name}:${String(this._id)}] No handler registered for action type: '${constructorName}'. Action was:`,\n action\n );\n // If no handler is found, the action is effectively ignored.\n // Consider if this is the desired behavior or if an error should be thrown\n // or a default handler should be invoked.\n }\n };\n}\n","import { Blac } from './Blac';\nimport { BlocBase } from './BlocBase';\n\n/**\n * A Cubit is a simpler version of a Bloc that doesn't handle events.\n * It manages state and provides methods to update it.\n * @template S - The type of state this Cubit manages\n * @template P - The type of parameters (optional, defaults to null)\n */\nexport abstract class Cubit<S, P = null> extends BlocBase<S, P> {\n /**\n * Updates the current state and notifies all observers of the change.\n * If the new state is identical to the current state (using Object.is),\n * no update will occur.\n * @param state - The new state to set\n */\n emit(state: S): void {\n if (Object.is(state, this.state)) {\n return;\n }\n\n const oldState = this.state;\n const newState = state;\n this._pushState(newState, oldState);\n }\n\n /**\n * Partially updates the current state by merging it with the provided state patch.\n * This method is only applicable when the state is an object type.\n * \n * @param statePatch - A partial state object containing only the properties to update\n * @param ignoreChangeCheck - If true, skips checking if the state has actually changed\n * @throws {TypeError} If the state is not an object type\n */\n patch(\n statePatch: S extends object ? Partial<S> : S,\n ignoreChangeCheck = false,\n ): void {\n if (typeof this.state !== 'object' || this.state === null) {\n Blac.warn(\n 'Cubit.patch: was called on a cubit where the state is not an object. This is a no-op.',\n );\n return;\n }\n\n let changes = false;\n if (!ignoreChangeCheck) {\n for (const key in statePatch) {\n if (Object.prototype.hasOwnProperty.call(statePatch, key)) {\n const s = this.state;\n const current = s[key as keyof S];\n if (!Object.is(statePatch[key as keyof S], current)) {\n changes = true;\n break;\n }\n }\n }\n } else {\n changes = true;\n }\n\n if (changes) {\n this.emit({\n ...this.state,\n ...(statePatch as Partial<S>),\n } as S);\n }\n }\n}\n"],"names":["_SingletonBlacManager","Blac","instance","oldInstance","bloc","__publicField","SingletonBlacManager","instanceManager","setBlacInstanceManager","manager","_Blac","options","args","message","oldBlocInstanceMap","oldIsolatedBlocMap","blocArray","base","key","blocClass","id","blocId","isolatedBloc","registeredBloc","isIsolated","registered","results","blocInstance","isolatedBlocs","toDispose","predicate","blocs","sum","arr","__unsafe_ignore_singleton","blocClassName","index","b","uid","props","instanceRef","newBloc","BlacObservable","observer","newState","oldState","action","shouldUpdate","lastDependencyCheck","newDependencyCheck","o","partNew","partOld","i","BlocBase","initialState","originalId","consumerId","consumerRef","actionType","batchFn","wasBatching","result","lastUpdate","Constructor","_a","handler","Bloc","eventConstructor","emit","previousState","error","constructorName","Cubit","state","statePatch","ignoreChangeCheck","changes","current"],"mappings":"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"}