@blac/core 2.0.12 → 2.0.14

package/dist/config-CoNMTnMA.cjs

@@ -0,0 +1,32 @@
+//#region src/registry/config.ts
+let _registry = require('./StateContainerRegistry-C0I77Ndz.cjs').globalRegistry;
+function getRegistry() {
+  return _registry;
+}
+function setRegistry(registry) {
+  _registry = registry;
+}
+function getStats() {
+  return _registry.getStats();
+}
+//#endregion
+Object.defineProperty(exports, 'getRegistry', {
+  enumerable: true,
+  get: function () {
+    return getRegistry;
+  },
+});
+Object.defineProperty(exports, 'getStats', {
+  enumerable: true,
+  get: function () {
+    return getStats;
+  },
+});
+Object.defineProperty(exports, 'setRegistry', {
+  enumerable: true,
+  get: function () {
+    return setRegistry;
+  },
+});
+
+//# sourceMappingURL=config-CoNMTnMA.cjs.map

package/dist/config-CoNMTnMA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-CoNMTnMA.cjs","names":["globalRegistry"],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";AAKA,IAAI,6DAAYA;AAEhB,SAAgB,cAAsC;AACpD,QAAO;;AAGT,SAAgB,YAAY,UAAwC;AAClE,aAAY;;AAGd,SAAgB,WAId;AACA,QAAO,UAAU,UAAU"}

package/dist/config-Cwj8-C1J.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from './StateContainerRegistry-Ci0ajc5g.js';
+//#region src/registry/config.ts
+let _registry = globalRegistry;
+function getRegistry() {
+  return _registry;
+}
+function setRegistry(registry) {
+  _registry = registry;
+}
+function getStats() {
+  return _registry.getStats();
+}
+//#endregion
+export { getStats as n, setRegistry as r, getRegistry as t };
+
+//# sourceMappingURL=config-Cwj8-C1J.js.map

package/dist/config-Cwj8-C1J.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-Cwj8-C1J.js","names":[],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";;AAKA,IAAI,YAAY;AAEhB,SAAgB,cAAsC;AACpD,QAAO;;AAGT,SAAgB,YAAY,UAAwC;AAClE,aAAY;;AAGd,SAAgB,WAId;AACA,QAAO,UAAU,UAAU"}

package/dist/config-D3jisfdj.cjs

@@ -1,32 +1,32 @@
 //#region src/registry/config.ts
-let _registry = require("./StateContainerRegistry-vXMWtG7J.cjs").globalRegistry;
+let _registry = require('./StateContainerRegistry-vXMWtG7J.cjs').globalRegistry;
 function getRegistry() {
-	return _registry;
+  return _registry;
 }
 function setRegistry(registry) {
-	_registry = registry;
+  _registry = registry;
 }
 function getStats() {
-	return _registry.getStats();
+  return _registry.getStats();
 }
 //#endregion
-Object.defineProperty(exports, "getRegistry", {
-	enumerable: true,
-	get: function() {
-		return getRegistry;
-	}
+Object.defineProperty(exports, 'getRegistry', {
+  enumerable: true,
+  get: function () {
+    return getRegistry;
+  },
 });
-Object.defineProperty(exports, "getStats", {
-	enumerable: true,
-	get: function() {
-		return getStats;
-	}
+Object.defineProperty(exports, 'getStats', {
+  enumerable: true,
+  get: function () {
+    return getStats;
+  },
 });
-Object.defineProperty(exports, "setRegistry", {
-	enumerable: true,
-	get: function() {
-		return setRegistry;
-	}
+Object.defineProperty(exports, 'setRegistry', {
+  enumerable: true,
+  get: function () {
+    return setRegistry;
+  },
 });
 
-//# sourceMappingURL=config-D3jisfdj.cjs.map
+//# sourceMappingURL=config-D3jisfdj.cjs.map

package/dist/config-D4GifZQ4.js

@@ -1,16 +1,16 @@
-import { r as globalRegistry } from "./StateContainerRegistry-BhcnG0DF.js";
+import { r as globalRegistry } from './StateContainerRegistry-BhcnG0DF.js';
 //#region src/registry/config.ts
 let _registry = globalRegistry;
 function getRegistry() {
-	return _registry;
+  return _registry;
 }
 function setRegistry(registry) {
-	_registry = registry;
+  _registry = registry;
 }
 function getStats() {
-	return _registry.getStats();
+  return _registry.getStats();
 }
 //#endregion
 export { getStats as n, setRegistry as r, getRegistry as t };
 
-//# sourceMappingURL=config-D4GifZQ4.js.map
+//# sourceMappingURL=config-D4GifZQ4.js.map

package/dist/config-DDrSQGpQ.cjs

@@ -1,32 +1,32 @@
 //#region src/registry/config.ts
-let _registry = require("./StateContainerRegistry-v_prqMcI.cjs").globalRegistry;
+let _registry = require('./StateContainerRegistry-v_prqMcI.cjs').globalRegistry;
 function getRegistry() {
-	return _registry;
+  return _registry;
 }
 function setRegistry(registry) {
-	_registry = registry;
+  _registry = registry;
 }
 function getStats() {
-	return _registry.getStats();
+  return _registry.getStats();
 }
 //#endregion
-Object.defineProperty(exports, "getRegistry", {
-	enumerable: true,
-	get: function() {
-		return getRegistry;
-	}
+Object.defineProperty(exports, 'getRegistry', {
+  enumerable: true,
+  get: function () {
+    return getRegistry;
+  },
 });
-Object.defineProperty(exports, "getStats", {
-	enumerable: true,
-	get: function() {
-		return getStats;
-	}
+Object.defineProperty(exports, 'getStats', {
+  enumerable: true,
+  get: function () {
+    return getStats;
+  },
 });
-Object.defineProperty(exports, "setRegistry", {
-	enumerable: true,
-	get: function() {
-		return setRegistry;
-	}
+Object.defineProperty(exports, 'setRegistry', {
+  enumerable: true,
+  get: function () {
+    return setRegistry;
+  },
 });
 
-//# sourceMappingURL=config-DDrSQGpQ.cjs.map
+//# sourceMappingURL=config-DDrSQGpQ.cjs.map

package/dist/config-DEcslxan.cjs

@@ -0,0 +1,32 @@
+//#region src/registry/config.ts
+let _registry = require('./StateContainerRegistry-CDH9mnQS.cjs').globalRegistry;
+function getRegistry() {
+  return _registry;
+}
+function setRegistry(registry) {
+  _registry = registry;
+}
+function getStats() {
+  return _registry.getStats();
+}
+//#endregion
+Object.defineProperty(exports, 'getRegistry', {
+  enumerable: true,
+  get: function () {
+    return getRegistry;
+  },
+});
+Object.defineProperty(exports, 'getStats', {
+  enumerable: true,
+  get: function () {
+    return getStats;
+  },
+});
+Object.defineProperty(exports, 'setRegistry', {
+  enumerable: true,
+  get: function () {
+    return setRegistry;
+  },
+});
+
+//# sourceMappingURL=config-DEcslxan.cjs.map

package/dist/config-DEcslxan.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-DEcslxan.cjs","names":["globalRegistry"],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";AAKA,IAAI,6DAAYA;AAEhB,SAAgB,cAAsC;AACpD,QAAO;;AAGT,SAAgB,YAAY,UAAwC;AAClE,aAAY;;AAGd,SAAgB,WAId;AACA,QAAO,UAAU,UAAU"}

package/dist/config-DMNZ2YLV.cjs

@@ -1,32 +1,32 @@
 //#region src/registry/config.ts
-let _registry = require("./StateContainerRegistry-mseeTqSA.cjs").globalRegistry;
+let _registry = require('./StateContainerRegistry-mseeTqSA.cjs').globalRegistry;
 function getRegistry() {
-	return _registry;
+  return _registry;
 }
 function setRegistry(registry) {
-	_registry = registry;
+  _registry = registry;
 }
 function getStats() {
-	return _registry.getStats();
+  return _registry.getStats();
 }
 //#endregion
-Object.defineProperty(exports, "getRegistry", {
-	enumerable: true,
-	get: function() {
-		return getRegistry;
-	}
+Object.defineProperty(exports, 'getRegistry', {
+  enumerable: true,
+  get: function () {
+    return getRegistry;
+  },
 });
-Object.defineProperty(exports, "getStats", {
-	enumerable: true,
-	get: function() {
-		return getStats;
-	}
+Object.defineProperty(exports, 'getStats', {
+  enumerable: true,
+  get: function () {
+    return getStats;
+  },
 });
-Object.defineProperty(exports, "setRegistry", {
-	enumerable: true,
-	get: function() {
-		return setRegistry;
-	}
+Object.defineProperty(exports, 'setRegistry', {
+  enumerable: true,
+  get: function () {
+    return setRegistry;
+  },
 });
 
-//# sourceMappingURL=config-DMNZ2YLV.cjs.map
+//# sourceMappingURL=config-DMNZ2YLV.cjs.map

package/dist/config-De9oQ6Ki.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from './StateContainerRegistry-BpO5t-0i.js';
+//#region src/registry/config.ts
+let _registry = globalRegistry;
+function getRegistry() {
+  return _registry;
+}
+function setRegistry(registry) {
+  _registry = registry;
+}
+function getStats() {
+  return _registry.getStats();
+}
+//#endregion
+export { getStats as n, setRegistry as r, getRegistry as t };
+
+//# sourceMappingURL=config-De9oQ6Ki.js.map

package/dist/config-De9oQ6Ki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-De9oQ6Ki.js","names":[],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";;AAKA,IAAI,YAAY;AAEhB,SAAgB,cAAsC;AACpD,QAAO;;AAGT,SAAgB,YAAY,UAAwC;AAClE,aAAY;;AAGd,SAAgB,WAId;AACA,QAAO,UAAU,UAAU"}

package/dist/config-DoHx0Xsl.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from "./StateContainerRegistry-DmmzYa7S.js";
+//#region src/registry/config.ts
+let _registry = globalRegistry;
+function getRegistry() {
+	return _registry;
+}
+function setRegistry(registry) {
+	_registry = registry;
+}
+function getStats() {
+	return _registry.getStats();
+}
+//#endregion
+export { getStats as n, setRegistry as r, getRegistry as t };
+
+//# sourceMappingURL=config-DoHx0Xsl.js.map

package/dist/config-DoHx0Xsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-DoHx0Xsl.js","names":[],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";;AAKA,IAAI,YAAY;AAEhB,SAAgB,cAAsC;CACpD,OAAO;;AAGT,SAAgB,YAAY,UAAwC;CAClE,YAAY;;AAGd,SAAgB,WAId;CACA,OAAO,UAAU,UAAU"}

package/dist/config-DokTzpr8.cjs

@@ -1,32 +1,32 @@
 //#region src/registry/config.ts
-let _registry = require("./StateContainerRegistry-pRNxHNFD.cjs").globalRegistry;
+let _registry = require('./StateContainerRegistry-pRNxHNFD.cjs').globalRegistry;
 function getRegistry() {
-	return _registry;
+  return _registry;
 }
 function setRegistry(registry) {
-	_registry = registry;
+  _registry = registry;
 }
 function getStats() {
-	return _registry.getStats();
+  return _registry.getStats();
 }
 //#endregion
-Object.defineProperty(exports, "getRegistry", {
-	enumerable: true,
-	get: function() {
-		return getRegistry;
-	}
+Object.defineProperty(exports, 'getRegistry', {
+  enumerable: true,
+  get: function () {
+    return getRegistry;
+  },
 });
-Object.defineProperty(exports, "getStats", {
-	enumerable: true,
-	get: function() {
-		return getStats;
-	}
+Object.defineProperty(exports, 'getStats', {
+  enumerable: true,
+  get: function () {
+    return getStats;
+  },
 });
-Object.defineProperty(exports, "setRegistry", {
-	enumerable: true,
-	get: function() {
-		return setRegistry;
-	}
+Object.defineProperty(exports, 'setRegistry', {
+  enumerable: true,
+  get: function () {
+    return setRegistry;
+  },
 });
 
-//# sourceMappingURL=config-DokTzpr8.cjs.map
+//# sourceMappingURL=config-DokTzpr8.cjs.map

package/dist/config-DslYBm4Z.js

@@ -1,16 +1,16 @@
-import { r as globalRegistry } from "./StateContainerRegistry-Ck2-XmT_.js";
+import { r as globalRegistry } from './StateContainerRegistry-Ck2-XmT_.js';
 //#region src/registry/config.ts
 let _registry = globalRegistry;
 function getRegistry() {
-	return _registry;
+  return _registry;
 }
 function setRegistry(registry) {
-	_registry = registry;
+  _registry = registry;
 }
 function getStats() {
-	return _registry.getStats();
+  return _registry.getStats();
 }
 //#endregion
 export { getStats as n, setRegistry as r, getRegistry as t };
 
-//# sourceMappingURL=config-DslYBm4Z.js.map
+//# sourceMappingURL=config-DslYBm4Z.js.map

package/dist/config-H6FAqbW4.cjs

@@ -0,0 +1,32 @@
+//#region src/registry/config.ts
+let _registry = require('./StateContainerRegistry-CX2CBOmv.cjs').globalRegistry;
+function getRegistry() {
+  return _registry;
+}
+function setRegistry(registry) {
+  _registry = registry;
+}
+function getStats() {
+  return _registry.getStats();
+}
+//#endregion
+Object.defineProperty(exports, 'getRegistry', {
+  enumerable: true,
+  get: function () {
+    return getRegistry;
+  },
+});
+Object.defineProperty(exports, 'getStats', {
+  enumerable: true,
+  get: function () {
+    return getStats;
+  },
+});
+Object.defineProperty(exports, 'setRegistry', {
+  enumerable: true,
+  get: function () {
+    return setRegistry;
+  },
+});
+
+//# sourceMappingURL=config-H6FAqbW4.cjs.map

package/dist/config-H6FAqbW4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-H6FAqbW4.cjs","names":["globalRegistry"],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";AAKA,IAAI,6DAAYA;AAEhB,SAAgB,cAAsC;AACpD,QAAO;;AAGT,SAAgB,YAAY,UAAwC;AAClE,aAAY;;AAGd,SAAgB,WAId;AACA,QAAO,UAAU,UAAU"}

package/dist/config-Yp645dGK.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from './StateContainerRegistry-BAcxouCu.js';
+//#region src/registry/config.ts
+let _registry = globalRegistry;
+function getRegistry() {
+  return _registry;
+}
+function setRegistry(registry) {
+  _registry = registry;
+}
+function getStats() {
+  return _registry.getStats();
+}
+//#endregion
+export { getStats as n, setRegistry as r, getRegistry as t };
+
+//# sourceMappingURL=config-Yp645dGK.js.map

package/dist/config-Yp645dGK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-Yp645dGK.js","names":[],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";;AAKA,IAAI,YAAY;AAEhB,SAAgB,cAAsC;AACpD,QAAO;;AAGT,SAAgB,YAAY,UAAwC;AAClE,aAAY;;AAGd,SAAgB,WAId;AACA,QAAO,UAAU,UAAU"}

package/dist/config-ispAzOZV.js

@@ -0,0 +1,16 @@
+import { r as globalRegistry } from './StateContainerRegistry-BK57H92E.js';
+//#region src/registry/config.ts
+let _registry = globalRegistry;
+function getRegistry() {
+  return _registry;
+}
+function setRegistry(registry) {
+  _registry = registry;
+}
+function getStats() {
+  return _registry.getStats();
+}
+//#endregion
+export { getStats as n, setRegistry as r, getRegistry as t };
+
+//# sourceMappingURL=config-ispAzOZV.js.map

package/dist/config-ispAzOZV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-ispAzOZV.js","names":[],"sources":["../src/registry/config.ts"],"sourcesContent":["import {\n  globalRegistry,\n  StateContainerRegistry,\n} from '../core/StateContainerRegistry';\n\nlet _registry = globalRegistry;\n\nexport function getRegistry(): StateContainerRegistry {\n  return _registry;\n}\n\nexport function setRegistry(registry: StateContainerRegistry): void {\n  _registry = registry;\n}\n\nexport function getStats(): {\n  registeredTypes: number;\n  totalInstances: number;\n  typeBreakdown: Record<string, number>;\n} {\n  return _registry.getStats();\n}\n"],"mappings":";;AAKA,IAAI,YAAY;AAEhB,SAAgB,cAAsC;AACpD,QAAO;;AAGT,SAAgB,YAAY,UAAwC;AAClE,aAAY;;AAGd,SAAgB,WAId;AACA,QAAO,UAAU,UAAU"}

package/dist/config.d.cts

@@ -0,0 +1,72 @@
+/**
+ * Global configuration for @blac/core
+ */
+export type EqualityFn = <S>(prev: S, next: S) => boolean;
+export interface BlacConfig {
+    /**
+     * Equality check used by `StateContainer.applyState` to skip emits when
+     * `prev` and `next` are structurally equal. Default: `shallowEqualState`.
+     *
+     * Return `true` to skip the emit (states considered equal).
+     */
+    equality: EqualityFn;
+    /**
+     * Circuit breaker: maximum number of live instances allowed under a single
+     * bloc constructor before `acquire` throws. Guards against runaway instance
+     * creation — typically an unstable/args-derived key churning out instances
+     * that are never disposed (a memory leak that eventually freezes the app).
+     *
+     * Default: `1000`. Set to `Infinity` (or any non-positive value) to disable.
+     */
+    maxInstancesPerType: number;
+    /**
+     * Circuit breaker: maximum number of distinct live references (consumers)
+     * allowed on a single instance before `acquire` throws. Guards against the
+     * other leak shape — consumer cleanup (e.g. `useBloc` unmount `release`)
+     * never firing, so refs accumulate without bound on one instance.
+     *
+     * Default: `1000`. Set to `Infinity` (or any non-positive value) to disable.
+     */
+    maxRefsPerInstance: number;
+    /**
+     * Dev-only soft circuit breaker: if a single instance emits more than this
+     * many *real* state changes within a rolling one-second window, log a single
+     * `console.warn`. This is the "frozen app" smell — almost always a tight loop
+     * (RAF/animation, or an effect that emits on every commit) pushing
+     * high-frequency data through bloc state, which then saturates subscribers,
+     * plugins (logging/devtools), and the main thread.
+     *
+     * Heuristic by nature — warns, never throws, since high-frequency state can
+     * occasionally be legitimate. No-op in production. Default: `100`. Set to
+     * `Infinity` (or any non-positive value) to disable.
+     */
+    maxEmitsPerSecond: number;
+}
+/**
+ * Default equality: shallow per-key `Object.is` comparison.
+ * Falls through to `false` for primitives/null so reference-only state still
+ * behaves correctly.
+ */
+export declare const shallowEqualState: EqualityFn;
+/**
+ * Configure global defaults for @blac/core.
+ *
+ * @example
+ * ```ts
+ * import { configureBlac, shallowEqualState } from '@blac/core';
+ *
+ * // Swap in a deep-equality check for all blocs
+ * configureBlac({ equality: myDeepEqual });
+ * ```
+ */
+export declare function configureBlac(config: Partial<BlacConfig>): void;
+/**
+ * Get the current global configuration.
+ * @internal
+ */
+export declare function getBlacConfig(): BlacConfig;
+/**
+ * Reset configuration to defaults (useful for testing).
+ * @internal
+ */
+export declare function resetBlacConfig(): void;

package/dist/config.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Global configuration for @blac/core
+ */
+export type EqualityFn = <S>(prev: S, next: S) => boolean;
+export interface BlacConfig {
+    /**
+     * Equality check used by `StateContainer.applyState` to skip emits when
+     * `prev` and `next` are structurally equal. Default: `shallowEqualState`.
+     *
+     * Return `true` to skip the emit (states considered equal).
+     */
+    equality: EqualityFn;
+    /**
+     * Circuit breaker: maximum number of live instances allowed under a single
+     * bloc constructor before `acquire` throws. Guards against runaway instance
+     * creation — typically an unstable/args-derived key churning out instances
+     * that are never disposed (a memory leak that eventually freezes the app).
+     *
+     * Default: `1000`. Set to `Infinity` (or any non-positive value) to disable.
+     */
+    maxInstancesPerType: number;
+    /**
+     * Circuit breaker: maximum number of distinct live references (consumers)
+     * allowed on a single instance before `acquire` throws. Guards against the
+     * other leak shape — consumer cleanup (e.g. `useBloc` unmount `release`)
+     * never firing, so refs accumulate without bound on one instance.
+     *
+     * Default: `1000`. Set to `Infinity` (or any non-positive value) to disable.
+     */
+    maxRefsPerInstance: number;
+    /**
+     * Dev-only soft circuit breaker: if a single instance emits more than this
+     * many *real* state changes within a rolling one-second window, log a single
+     * `console.warn`. This is the "frozen app" smell — almost always a tight loop
+     * (RAF/animation, or an effect that emits on every commit) pushing
+     * high-frequency data through bloc state, which then saturates subscribers,
+     * plugins (logging/devtools), and the main thread.
+     *
+     * Heuristic by nature — warns, never throws, since high-frequency state can
+     * occasionally be legitimate. No-op in production. Default: `100`. Set to
+     * `Infinity` (or any non-positive value) to disable.
+     */
+    maxEmitsPerSecond: number;
+}
+/**
+ * Default equality: shallow per-key `Object.is` comparison.
+ * Falls through to `false` for primitives/null so reference-only state still
+ * behaves correctly.
+ */
+export declare const shallowEqualState: EqualityFn;
+/**
+ * Configure global defaults for @blac/core.
+ *
+ * @example
+ * ```ts
+ * import { configureBlac, shallowEqualState } from '@blac/core';
+ *
+ * // Swap in a deep-equality check for all blocs
+ * configureBlac({ equality: myDeepEqual });
+ * ```
+ */
+export declare function configureBlac(config: Partial<BlacConfig>): void;
+/**
+ * Get the current global configuration.
+ * @internal
+ */
+export declare function getBlacConfig(): BlacConfig;
+/**
+ * Reset configuration to defaults (useful for testing).
+ * @internal
+ */
+export declare function resetBlacConfig(): void;