@blac/core 2.0.8 → 2.0.10
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/dist/Cubit-CZaf_fp4.cjs +313 -0
- package/dist/Cubit-CZaf_fp4.cjs.map +1 -0
- package/dist/Cubit-PMTXxI_u.js +290 -0
- package/dist/Cubit-PMTXxI_u.js.map +1 -0
- package/dist/{StateContainerRegistry-COxgpYAw.cjs → StateContainerRegistry-BsMIpllP.cjs} +7 -1
- package/dist/{StateContainerRegistry-COxgpYAw.cjs.map → StateContainerRegistry-BsMIpllP.cjs.map} +1 -1
- package/dist/{StateContainerRegistry-DS_wyKck.js → StateContainerRegistry-DOkDGng-.js} +2 -2
- package/dist/{StateContainerRegistry-DS_wyKck.js.map → StateContainerRegistry-DOkDGng-.js.map} +1 -1
- package/dist/{branded-DndTHjv2.cjs → branded-DCqi3De1.cjs} +1 -1
- package/dist/{branded-DndTHjv2.cjs.map → branded-DCqi3De1.cjs.map} +1 -1
- package/dist/{branded-mwGzzPF1.js → branded-Max3xOTA.js} +1 -1
- package/dist/{branded-mwGzzPF1.js.map → branded-Max3xOTA.js.map} +1 -1
- package/dist/config-DLzmy2rZ.cjs +32 -0
- package/dist/config-DLzmy2rZ.cjs.map +1 -0
- package/dist/config-XQua95Xz.js +16 -0
- package/dist/config-XQua95Xz.js.map +1 -0
- package/dist/debug.cjs +8 -7
- package/dist/debug.js +3 -2
- package/dist/ensure-C5I1xp2C.js +9 -0
- package/dist/ensure-C5I1xp2C.js.map +1 -0
- package/dist/ensure-CSHYjIeH.cjs +14 -0
- package/dist/ensure-CSHYjIeH.cjs.map +1 -0
- package/dist/index.cjs +24 -305
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +12 -294
- package/dist/index.js.map +1 -1
- package/dist/management-C-wBdpho.js +29 -0
- package/dist/management-C-wBdpho.js.map +1 -0
- package/dist/management-xoZ7w3bI.cjs +70 -0
- package/dist/management-xoZ7w3bI.cjs.map +1 -0
- package/dist/plugins.cjs +1 -1
- package/dist/plugins.js +1 -1
- package/dist/{resolve-dependencies-8xtWXd53.js → resolve-dependencies-BA3u06uC.js} +4 -3
- package/dist/resolve-dependencies-BA3u06uC.js.map +1 -0
- package/dist/{resolve-dependencies-DJ2UBTq1.cjs → resolve-dependencies-BT6TU2HF.cjs} +4 -3
- package/dist/resolve-dependencies-BT6TU2HF.cjs.map +1 -0
- package/dist/testing.cjs +105 -0
- package/dist/testing.cjs.map +1 -0
- package/dist/testing.d.cts +19 -0
- package/dist/testing.d.ts +19 -0
- package/dist/testing.js +96 -0
- package/dist/testing.js.map +1 -0
- package/dist/{tracked-DLnq137F.cjs → tracked-DCfBaYjL.cjs} +6 -16
- package/dist/tracked-DCfBaYjL.cjs.map +1 -0
- package/dist/{tracked-12W-U7tq.js → tracked-DKduNLgI.js} +5 -9
- package/dist/tracked-DKduNLgI.js.map +1 -0
- package/dist/tracking/path-utils.d.ts +1 -1
- package/dist/tracking/tracking-proxy.d.ts +3 -3
- package/dist/tracking.cjs +1 -1
- package/dist/tracking.js +1 -1
- package/dist/types.cjs +1 -1
- package/dist/types.js +1 -1
- package/dist/watch-entry.cjs +1 -1
- package/dist/watch-entry.js +1 -1
- package/package.json +45 -14
- package/dist/config-BD9MkJ0k.js +0 -42
- package/dist/config-BD9MkJ0k.js.map +0 -1
- package/dist/config-DTuCbHcJ.cjs +0 -101
- package/dist/config-DTuCbHcJ.cjs.map +0 -1
- package/dist/resolve-dependencies-8xtWXd53.js.map +0 -1
- package/dist/resolve-dependencies-DJ2UBTq1.cjs.map +0 -1
- package/dist/tracked-12W-U7tq.js.map +0 -1
- package/dist/tracked-DLnq137F.cjs.map +0 -1
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
const require_StateContainerRegistry = require("./StateContainerRegistry-
|
|
1
|
+
const require_StateContainerRegistry = require("./StateContainerRegistry-BsMIpllP.cjs");
|
|
2
|
+
const require_config = require("./config-DLzmy2rZ.cjs");
|
|
2
3
|
//#region src/tracking/path-utils.ts
|
|
3
4
|
/**
|
|
4
5
|
* Path utilities for dependency tracking
|
|
@@ -634,7 +635,7 @@ function resolveDependencies(bloc) {
|
|
|
634
635
|
const visitKey = `${Type.name}::${key}`;
|
|
635
636
|
if (visited.has(visitKey)) continue;
|
|
636
637
|
visited.add(visitKey);
|
|
637
|
-
const dep =
|
|
638
|
+
const dep = require_config.getRegistry().ensure(Type, key);
|
|
638
639
|
result.add(dep);
|
|
639
640
|
if (dep.dependencies.size > 0) queue.push(dep);
|
|
640
641
|
}
|
|
@@ -770,4 +771,4 @@ Object.defineProperty(exports, "stopTracking", {
|
|
|
770
771
|
}
|
|
771
772
|
});
|
|
772
773
|
|
|
773
|
-
//# sourceMappingURL=resolve-dependencies-
|
|
774
|
+
//# sourceMappingURL=resolve-dependencies-BT6TU2HF.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolve-dependencies-BT6TU2HF.cjs","names":["BLAC_ERROR_PREFIX","BLAC_DEFAULTS","getRegistry"],"sources":["../src/tracking/path-utils.ts","../src/tracking/tracking-proxy.ts","../src/tracking/dependency-manager.ts","../src/tracking/resolve-dependencies.ts"],"sourcesContent":["/**\n * Path utilities for dependency tracking\n *\n * Provides utilities for parsing property paths and extracting values\n * from nested objects using path strings.\n *\n * @internal\n */\n\n/**\n * Parse a property path string into an array of segments\n *\n * @internal\n *\n * Handles both dot notation (a.b.c) and bracket notation (a[0].b)\n *\n * @example\n * ```ts\n * parsePath('user.name') // ['user', 'name']\n * parsePath('items[0].name') // ['items', '0', 'name']\n * parsePath('data.users[2].address.city') // ['data', 'users', '2', 'address', 'city']\n * ```\n */\nexport function parsePath(path: string): string[] {\n const segments: string[] = [];\n let current = '';\n let i = 0;\n\n while (i < path.length) {\n const char = path[i];\n if (char === '.') {\n if (current) segments.push(current);\n current = '';\n } else if (char === '[') {\n if (current) segments.push(current);\n current = '';\n // Skip bracket\n i++;\n // Read until ]\n while (i < path.length && path[i] !== ']') {\n current += path[i++];\n }\n if (current) segments.push(current);\n current = '';\n } else {\n current += char;\n }\n i++;\n }\n\n if (current) segments.push(current);\n return segments;\n}\n\n/**\n * Get a value from an object using a path of segments\n *\n * @example\n * ```ts\n * const obj = { user: { name: 'Alice', age: 30 } }\n * getValueAtPath(obj, ['user', 'name']) // 'Alice'\n * getValueAtPath(obj, ['user', 'age']) // 30\n * getValueAtPath(obj, ['user', 'missing']) // undefined\n * ```\n *\n * @internal\n */\nexport function getValueAtPath(obj: unknown, segments: string[]): unknown {\n if (obj == null) return undefined;\n\n let current: unknown = obj;\n for (let i = 0; i < segments.length; i++) {\n current = (current as Record<string, unknown>)[segments[i]];\n if (current == null) return undefined;\n }\n return current;\n}\n\n/**\n * Shallow equality comparison for arrays\n *\n * Compares two arrays element-by-element using Object.is\n *\n * @example\n * ```ts\n * shallowEqual([1, 2, 3], [1, 2, 3]) // true\n * shallowEqual([1, 2, 3], [1, 2, 4]) // false\n * shallowEqual([1, 2], [1, 2, 3]) // false\n * ```\n *\n * @internal\n */\nexport function shallowEqual(arr1: unknown[], arr2: unknown[]): boolean {\n if (arr1.length !== arr2.length) return false;\n for (let i = 0; i < arr1.length; i++) {\n if (!Object.is(arr1[i], arr2[i])) return false;\n }\n return true;\n}\n","/**\n * Consolidated Tracking System\n *\n * This module provides all dependency and getter tracking functionality:\n * - Proxy creation for automatic property access tracking\n * - Dependency path tracking and change detection\n * - Getter execution tracking for computed properties\n * - Combined tracking proxy for watch/waitUntil use cases\n */\nimport { BLAC_DEFAULTS, BLAC_ERROR_PREFIX } from '../constants';\nimport type { StateContainerInstance } from '../types/utilities';\nimport { parsePath, getValueAtPath } from './path-utils';\n\n// =============================================================================\n// PROXY TRACKER (Low-level proxy creation)\n// =============================================================================\n\n/**\n * Check if a value can be proxied\n * Returns true for plain objects and arrays only.\n * @internal\n */\nexport function isProxyable(value: unknown): value is object {\n if (typeof value !== 'object' || value === null) return false;\n const proto = Object.getPrototypeOf(value);\n return proto === Object.prototype || proto === Array.prototype;\n}\n\n/**\n * State container for proxy tracking\n * @internal\n */\nexport interface ProxyState<T> {\n trackedPaths: Set<string>;\n isTracking: boolean;\n proxyCache: WeakMap<object, unknown>;\n // oxlint-disable-next-line @typescript-eslint/no-unsafe-function-type\n boundFunctionsCache: WeakMap<Function, Function> | null;\n lastProxiedState: T | null;\n lastProxy: T | null;\n maxDepth: number;\n}\n\n/**\n * Create a new proxy tracker state\n * @internal\n */\nexport function createProxyState<T>(): ProxyState<T> {\n return {\n trackedPaths: new Set<string>(),\n isTracking: false,\n proxyCache: new WeakMap<object, unknown>(),\n boundFunctionsCache: null,\n lastProxiedState: null,\n lastProxy: null,\n maxDepth: 10,\n };\n}\n\n/**\n * Start tracking property accesses\n * @internal\n */\nexport function startProxy<T>(state: ProxyState<T>): void {\n state.isTracking = true;\n state.trackedPaths.clear();\n}\n\n/**\n * Stop tracking and return the tracked paths\n * @internal\n */\nexport function stopProxy<T>(state: ProxyState<T>): Set<string> {\n state.isTracking = false;\n return new Set(state.trackedPaths);\n}\n\n/**\n * Create a proxy for an array with property access tracking\n * @internal\n */\nexport function createArrayProxy<T, U>(\n state: ProxyState<T>,\n target: U[],\n path: string,\n depth: number = 0,\n): U[] {\n const proxy = new Proxy(target, {\n get: (arr, prop: string | symbol) => {\n if (typeof prop === 'symbol') {\n return Reflect.get(arr, prop);\n }\n\n const value = Reflect.get(arr, prop);\n\n if (typeof value === 'function') {\n if (!state.boundFunctionsCache) {\n // oxlint-disable-next-line @typescript-eslint/no-unsafe-function-type\n state.boundFunctionsCache = new WeakMap<Function, Function>();\n }\n const cached = state.boundFunctionsCache.get(value);\n if (cached) {\n return cached;\n }\n const bound = value.bind(arr);\n state.boundFunctionsCache.set(value, bound);\n return bound;\n }\n\n if (prop === 'length') {\n if (state.isTracking) {\n const fullPath = path ? `${path}.length` : 'length';\n state.trackedPaths.add(fullPath);\n }\n return value;\n }\n\n let fullPath: string;\n if (typeof prop === 'string') {\n const index = Number(prop);\n if (!isNaN(index) && index >= 0) {\n fullPath = path ? `${path}[${index}]` : `[${index}]`;\n } else {\n fullPath = path ? `${path}.${prop}` : prop;\n }\n } else {\n return value;\n }\n\n if (isProxyable(value)) {\n return createInternal(state, value as T, fullPath, depth + 1);\n }\n\n if (state.isTracking) {\n state.trackedPaths.add(fullPath);\n }\n\n return value;\n },\n });\n\n state.proxyCache.set(target, proxy);\n return proxy;\n}\n\n/**\n * Create a proxy for an object with property access tracking\n * @internal\n */\nexport function createInternal<T>(\n state: ProxyState<T>,\n target: T,\n path: string = '',\n depth: number = 0,\n): T {\n if (!state.isTracking || !isProxyable(target)) {\n return target;\n }\n\n if (depth >= state.maxDepth) {\n console.warn(\n `${BLAC_ERROR_PREFIX} Proxy depth limit (${state.maxDepth}) reached at path \"${path}\". ` +\n `Deeper property accesses won't be tracked for re-renders.`,\n );\n return target;\n }\n\n if (state.proxyCache.has(target)) {\n return state.proxyCache.get(target) as T;\n }\n\n if (Array.isArray(target)) {\n return createArrayProxy(\n state,\n target as unknown[],\n path,\n depth,\n ) as unknown as T;\n }\n\n const proxy = new Proxy(target, {\n get: (obj, prop: string | symbol) => {\n if (typeof prop === 'symbol') {\n return Reflect.get(obj, prop);\n }\n\n const value = Reflect.get(obj, prop);\n\n if (typeof value === 'function') {\n if (!state.boundFunctionsCache) {\n // oxlint-disable-next-line @typescript-eslint/no-unsafe-function-type\n state.boundFunctionsCache = new WeakMap<Function, Function>();\n }\n const cached = state.boundFunctionsCache.get(value);\n if (cached) {\n return cached;\n }\n const bound = value.bind(obj);\n state.boundFunctionsCache.set(value, bound);\n return bound;\n }\n\n const fullPath = path ? `${path}.${String(prop)}` : String(prop);\n\n if (typeof prop === 'string' && state.isTracking) {\n if (!prop.startsWith('_') && !prop.startsWith('$$')) {\n state.trackedPaths.add(fullPath);\n }\n }\n\n if (isProxyable(value)) {\n const proxiedValue = createInternal(\n state,\n value as T,\n fullPath,\n depth + 1,\n );\n return proxiedValue;\n }\n\n return value;\n },\n\n has: (obj, prop: string | symbol) => {\n if (typeof prop === 'string' && state.isTracking) {\n const fullPath = path ? `${path}.${prop}` : prop;\n state.trackedPaths.add(fullPath);\n }\n return Reflect.has(obj, prop);\n },\n\n ownKeys: (obj) => {\n if (state.isTracking && path) {\n state.trackedPaths.add(path);\n }\n return Reflect.ownKeys(obj);\n },\n });\n\n state.proxyCache.set(target, proxy);\n return proxy as T;\n}\n\n/**\n * Create a proxy for a target with caching\n * @internal\n */\nexport function createForTarget<T>(state: ProxyState<T>, target: T): T {\n if (state.lastProxiedState === target && state.lastProxy) {\n return state.lastProxy;\n }\n\n state.proxyCache = new WeakMap<object, any>();\n state.boundFunctionsCache = null;\n\n const proxy = createInternal(state, target, '', 0);\n state.lastProxiedState = target;\n state.lastProxy = proxy;\n return proxy;\n}\n\n// =============================================================================\n// DEPENDENCY TRACKER (Path tracking and change detection)\n// =============================================================================\n\n/**\n * @internal\n */\nexport interface PathInfo {\n segments: string[];\n value: unknown;\n}\n\n/**\n * @internal\n */\nexport interface DependencyState<T> {\n proxyState: ProxyState<T>;\n previousRenderPaths: Set<string>;\n currentRenderPaths: Set<string>;\n pathCache: Map<string, PathInfo>;\n lastCheckedState: T | null;\n lastCheckedValues: Map<string, unknown>;\n}\n\nfunction isChildPath(child: string, parent: string): boolean {\n if (child === parent) return false;\n return child.startsWith(parent + '.') || child.startsWith(parent + '[');\n}\n\nfunction getArrayParentPath(path: string): string | null {\n if (path.endsWith('.length')) {\n return path.slice(0, -7);\n }\n const arrayIndexMatch = path.match(/^(.+?)\\[\\d+\\]/);\n if (arrayIndexMatch) {\n return arrayIndexMatch[1];\n }\n return null;\n}\n\n/**\n * @internal\n */\nexport function optimizeTrackedPaths(paths: Set<string>): Set<string> {\n if (paths.size === 0) {\n return new Set();\n }\n\n if (paths.size === 1) {\n return new Set(paths);\n }\n\n const sortedPaths = Array.from(paths).sort((a, b) => b.length - a.length);\n const optimized = new Set<string>();\n\n for (const path of sortedPaths) {\n let hasMoreSpecificChild = false;\n\n for (const optimizedPath of optimized) {\n if (isChildPath(optimizedPath, path)) {\n hasMoreSpecificChild = true;\n break;\n }\n }\n\n if (!hasMoreSpecificChild) {\n optimized.add(path);\n }\n }\n\n const arrayParents = new Set<string>();\n for (const path of optimized) {\n const arrayParent = getArrayParentPath(path);\n if (arrayParent) {\n arrayParents.add(arrayParent);\n }\n }\n\n for (const arrayParent of arrayParents) {\n optimized.add(arrayParent);\n }\n\n return optimized;\n}\n\n/**\n * @internal\n */\nexport function createDependencyState<T>(): DependencyState<T> {\n return {\n proxyState: createProxyState<T>(),\n previousRenderPaths: new Set<string>(),\n currentRenderPaths: new Set<string>(),\n pathCache: new Map<string, PathInfo>(),\n lastCheckedState: null,\n lastCheckedValues: new Map<string, any>(),\n };\n}\n\n/**\n * @internal\n */\nexport function startDependency<T>(tracker: DependencyState<T>): void {\n startProxy(tracker.proxyState);\n}\n\n/**\n * @internal\n */\nexport function createDependencyProxy<T>(\n tracker: DependencyState<T>,\n state: T,\n): T {\n return createForTarget(tracker.proxyState, state);\n}\n\n/**\n * @internal\n */\nexport function capturePaths<T>(tracker: DependencyState<T>, state: T): void {\n tracker.previousRenderPaths = tracker.currentRenderPaths;\n\n const rawPaths = stopProxy(tracker.proxyState);\n tracker.currentRenderPaths = optimizeTrackedPaths(rawPaths);\n\n if (\n tracker.previousRenderPaths.size === 0 &&\n tracker.currentRenderPaths.size === 0\n ) {\n return;\n }\n\n const trackedPathsUnion = new Set(tracker.previousRenderPaths);\n for (const path of tracker.currentRenderPaths) {\n trackedPathsUnion.add(path);\n }\n\n const canReuseCache = tracker.lastCheckedState === state;\n\n for (const path of trackedPathsUnion) {\n if (!tracker.pathCache.has(path)) {\n const segments = parsePath(path);\n const value =\n canReuseCache && tracker.lastCheckedValues.has(path)\n ? tracker.lastCheckedValues.get(path)\n : getValueAtPath(state, segments);\n\n tracker.pathCache.set(path, { segments, value });\n } else {\n const info = tracker.pathCache.get(path);\n if (!info) continue;\n info.value =\n canReuseCache && tracker.lastCheckedValues.has(path)\n ? tracker.lastCheckedValues.get(path)\n : getValueAtPath(state, info.segments);\n }\n }\n\n tracker.lastCheckedValues.clear();\n}\n\n/**\n * @internal\n */\nexport function hasDependencyChanges<T>(\n tracker: DependencyState<T>,\n state: T,\n): boolean {\n if (tracker.pathCache.size === 0) {\n return true;\n }\n\n tracker.lastCheckedValues.clear();\n\n for (const [path, info] of tracker.pathCache.entries()) {\n const currentValue = getValueAtPath(state, info.segments);\n tracker.lastCheckedValues.set(path, currentValue);\n\n if (!Object.is(currentValue, info.value)) {\n tracker.lastCheckedState = state;\n return true;\n }\n }\n\n tracker.lastCheckedState = state;\n return false;\n}\n\n/**\n * @internal\n */\nexport function hasTrackedData<T>(tracker: DependencyState<T>): boolean {\n return (\n tracker.proxyState.trackedPaths.size > 0 ||\n tracker.pathCache.size > 0 ||\n tracker.previousRenderPaths.size > 0\n );\n}\n\n// =============================================================================\n// GETTER TRACKER (Getter execution tracking)\n// =============================================================================\n\n/**\n * @internal\n */\nexport interface GetterState {\n trackedValues: Map<string | symbol, unknown>;\n currentlyAccessing: Set<string | symbol>;\n trackedGetters: Set<string | symbol>;\n isTracking: boolean;\n renderCache: Map<string | symbol, unknown>;\n cacheValid: boolean;\n depth: number;\n visitedBlocs: Set<StateContainerInstance>;\n}\n\nconst descriptorCache = new WeakMap<\n // oxlint-disable-next-line @typescript-eslint/no-unsafe-function-type\n Function,\n Map<string | symbol, PropertyDescriptor | undefined>\n>();\n\nconst blocProxyCache = new WeakMap<\n StateContainerInstance,\n StateContainerInstance\n>();\n\nconst activeTrackerMap = new WeakMap<StateContainerInstance, GetterState>();\n\nconst MAX_GETTER_DEPTH = BLAC_DEFAULTS.MAX_GETTER_DEPTH;\n\n/**\n * @internal\n */\nexport function getDescriptor(\n obj: any,\n prop: string | symbol,\n): PropertyDescriptor | undefined {\n const constructor = obj.constructor;\n\n let constructorCache = descriptorCache.get(constructor);\n if (constructorCache?.has(prop)) {\n return constructorCache.get(prop);\n }\n\n let current = obj;\n let descriptor: PropertyDescriptor | undefined;\n\n while (current && current !== Object.prototype) {\n descriptor = Object.getOwnPropertyDescriptor(current, prop);\n if (descriptor) {\n break;\n }\n current = Object.getPrototypeOf(current);\n }\n\n if (!constructorCache) {\n constructorCache = new Map();\n descriptorCache.set(constructor, constructorCache);\n }\n constructorCache.set(prop, descriptor);\n\n return descriptor;\n}\n\n/**\n * @internal\n */\nexport function isGetter(obj: any, prop: string | symbol): boolean {\n const descriptor = getDescriptor(obj, prop);\n return descriptor?.get !== undefined;\n}\n\n/**\n * @internal\n */\nexport function createGetterState(): GetterState {\n return {\n trackedValues: new Map(),\n currentlyAccessing: new Set(),\n trackedGetters: new Set(),\n isTracking: false,\n renderCache: new Map(),\n cacheValid: false,\n depth: 0,\n visitedBlocs: new Set(),\n };\n}\n\n/**\n * @internal\n */\nexport function setActiveTracker<TBloc extends StateContainerInstance>(\n bloc: TBloc,\n tracker: GetterState,\n): void {\n activeTrackerMap.set(bloc, tracker);\n}\n\n/**\n * @internal\n */\nexport function clearActiveTracker<TBloc extends StateContainerInstance>(\n bloc: TBloc,\n): void {\n activeTrackerMap.delete(bloc);\n}\n\n/**\n * @internal\n */\nexport function getActiveTracker<TBloc extends StateContainerInstance>(\n bloc: TBloc,\n): GetterState | undefined {\n return activeTrackerMap.get(bloc);\n}\n\n/**\n * @internal\n */\nexport function commitTrackedGetters(tracker: GetterState): void {\n if (tracker.currentlyAccessing.size > 0) {\n tracker.trackedGetters = new Set(tracker.currentlyAccessing);\n }\n tracker.currentlyAccessing.clear();\n}\n\n/**\n * Execute a tracked getter with depth/circular dependency checks and context management.\n * @internal\n */\nfunction executeTrackedGetter<T extends StateContainerInstance>(\n target: T,\n prop: string | symbol,\n tracker: GetterState,\n): unknown {\n tracker.currentlyAccessing.add(prop);\n\n if (tracker.cacheValid && tracker.renderCache.has(prop)) {\n const cachedValue = tracker.renderCache.get(prop);\n tracker.trackedValues.set(prop, cachedValue);\n return cachedValue;\n }\n\n if (tracker.depth >= MAX_GETTER_DEPTH) {\n throw new Error(\n `${BLAC_ERROR_PREFIX} Maximum getter depth (${MAX_GETTER_DEPTH}) exceeded. ` +\n `Possible circular dependency in getter \"${String(prop)}\" on ${target.constructor.name}.`,\n );\n }\n\n if (tracker.visitedBlocs.has(target)) {\n throw new Error(\n `${BLAC_ERROR_PREFIX} Circular dependency detected: getter \"${String(prop)}\" on ${target.constructor.name}.`,\n );\n }\n\n const prevDepth = tracker.depth;\n const prevVisited = new Set(tracker.visitedBlocs);\n\n tracker.depth++;\n tracker.visitedBlocs.add(target);\n\n try {\n const descriptor = getDescriptor(target, prop);\n if (!descriptor?.get) {\n return (target as Record<PropertyKey, unknown>)[prop];\n }\n const value = descriptor.get.call(target);\n tracker.trackedValues.set(prop, value);\n return value;\n } catch (error) {\n tracker.currentlyAccessing.delete(prop);\n throw error;\n } finally {\n tracker.depth = prevDepth;\n tracker.visitedBlocs = prevVisited;\n }\n}\n\n/**\n * @internal\n */\nexport function createBlocProxy<TBloc extends StateContainerInstance>(\n bloc: TBloc,\n): TBloc {\n const cached = blocProxyCache.get(bloc);\n if (cached) {\n return cached as TBloc;\n }\n\n const proxy = new Proxy(bloc, {\n get(target, prop, receiver) {\n const tracker = activeTrackerMap.get(target);\n\n if (tracker?.isTracking && isGetter(target, prop)) {\n return executeTrackedGetter(target, prop, tracker);\n }\n\n return Reflect.get(target, prop, receiver);\n },\n });\n\n blocProxyCache.set(bloc, proxy);\n return proxy as TBloc;\n}\n\n/**\n * @internal\n */\nexport function hasGetterChanges<TBloc extends StateContainerInstance>(\n bloc: TBloc,\n tracker: GetterState | null,\n): boolean {\n if (!tracker || tracker.trackedGetters.size === 0) {\n return false;\n }\n\n tracker.renderCache.clear();\n\n let hasAnyChange = false;\n\n for (const prop of tracker.trackedGetters) {\n try {\n const descriptor = getDescriptor(bloc, prop);\n if (!descriptor?.get) {\n continue;\n }\n\n const newValue = descriptor.get.call(bloc);\n const oldValue = tracker.trackedValues.get(prop);\n\n tracker.renderCache.set(prop, newValue);\n tracker.trackedValues.set(prop, newValue);\n\n if (!Object.is(newValue, oldValue)) {\n hasAnyChange = true;\n }\n } catch (error) {\n console.warn(\n `${BLAC_ERROR_PREFIX} Getter \"${String(prop)}\" threw error during change detection. Stopping tracking for this getter.`,\n error,\n );\n\n tracker.trackedGetters.delete(prop);\n tracker.trackedValues.delete(prop);\n tracker.cacheValid = false;\n return true;\n }\n }\n\n tracker.cacheValid = true;\n\n return hasAnyChange;\n}\n\n/**\n * @internal\n */\nexport function invalidateRenderCache(tracker: GetterState): void {\n tracker.cacheValid = false;\n}\n\n/**\n * @internal\n */\nexport function resetGetterState(tracker: GetterState): void {\n tracker.trackedValues.clear();\n tracker.currentlyAccessing.clear();\n tracker.trackedGetters.clear();\n tracker.renderCache.clear();\n tracker.cacheValid = false;\n tracker.isTracking = false;\n tracker.depth = 0;\n tracker.visitedBlocs.clear();\n}\n\n// =============================================================================\n// TRACKING PROXY (Combined tracking for watch/waitUntil)\n// =============================================================================\n\n/**\n * State for tracking both state property access and getter access.\n */\nexport interface TrackingProxyState {\n dependencyState: DependencyState<any>;\n getterState: GetterState;\n dependencies: Set<StateContainerInstance>;\n isTracking: boolean;\n}\n\n/**\n * Create a new tracking proxy state.\n */\nexport function createState(): TrackingProxyState {\n return {\n dependencyState: createDependencyState(),\n getterState: createGetterState(),\n dependencies: new Set(),\n isTracking: false,\n };\n}\n\n/**\n * Start tracking on a tracking proxy.\n */\nexport function startTracking(tracker: TrackingProxyState): void {\n tracker.isTracking = true;\n tracker.dependencies.clear();\n tracker.getterState.isTracking = true;\n startDependency(tracker.dependencyState);\n}\n\n/**\n * Stop tracking and collect all dependencies.\n */\nexport function stopTracking(\n tracker: TrackingProxyState,\n bloc: StateContainerInstance,\n): Set<StateContainerInstance> {\n tracker.isTracking = false;\n tracker.getterState.isTracking = false;\n\n capturePaths(tracker.dependencyState, bloc.state);\n commitTrackedGetters(tracker.getterState);\n\n return new Set(tracker.dependencies);\n}\n\n/**\n * Check if tracked state or getters have changed.\n */\nexport function hasChanges(\n tracker: TrackingProxyState,\n bloc: StateContainerInstance,\n): boolean {\n invalidateRenderCache(tracker.getterState);\n\n const stateChanged = hasDependencyChanges(\n tracker.dependencyState,\n bloc.state,\n );\n const getterChanged = hasGetterChanges(bloc, tracker.getterState);\n\n return stateChanged || getterChanged;\n}\n\n/**\n * Create a tracking proxy for a bloc instance.\n * Tracks both state property access and getter access.\n */\nexport function createTrackingProxy<T extends StateContainerInstance>(\n bloc: T,\n tracker: TrackingProxyState,\n): T {\n tracker.dependencies.add(bloc);\n\n const stateProxyCache = new WeakMap<object, any>();\n\n const proxy = new Proxy(bloc, {\n get(target, prop, receiver) {\n if (prop === 'state') {\n if (!tracker.isTracking) {\n return target.state;\n }\n\n const rawState = target.state;\n if (rawState === null || typeof rawState !== 'object') {\n return rawState;\n }\n\n if (stateProxyCache.has(rawState)) {\n return stateProxyCache.get(rawState);\n }\n\n const stateProxy = createDependencyProxy(\n tracker.dependencyState,\n rawState,\n );\n stateProxyCache.set(rawState, stateProxy);\n return stateProxy;\n }\n\n if (typeof prop === 'symbol') {\n return Reflect.get(target, prop, receiver);\n }\n\n const value = Reflect.get(target, prop, receiver);\n\n if (typeof value === 'function') {\n return value.bind(target);\n }\n\n if (tracker.isTracking && isGetter(target, prop)) {\n return executeTrackedGetter(target, prop, tracker.getterState);\n }\n\n return value;\n },\n });\n\n return proxy as T;\n}\n","import type { StateContainerInstance } from '../types/utilities';\n\n/**\n * Manages subscriptions to state container dependencies.\n * Provides efficient sync mechanism to add/remove subscriptions\n * as dependencies change between callback invocations.\n */\nexport class DependencyManager {\n private subscriptions = new Map<StateContainerInstance, () => void>();\n private currentDeps = new Set<StateContainerInstance>();\n\n /**\n * Sync subscriptions with a new set of dependencies.\n * Adds subscriptions for new deps, removes subscriptions for stale deps.\n *\n * @param newDeps - The new set of dependencies to subscribe to\n * @param onChange - Callback to invoke when any dependency changes\n * @param exclude - Optional instance to exclude from subscriptions (e.g., primary bloc)\n * @returns true if the dependency set changed, false if unchanged\n */\n sync(\n newDeps: Set<StateContainerInstance>,\n onChange: () => void,\n exclude?: StateContainerInstance,\n ): boolean {\n const filteredNewDeps = new Set<StateContainerInstance>();\n for (const dep of newDeps) {\n if (dep !== exclude && !dep.isDisposed) {\n filteredNewDeps.add(dep);\n }\n }\n\n if (this.areSetsEqual(this.currentDeps, filteredNewDeps)) {\n return false;\n }\n\n for (const dep of this.currentDeps) {\n if (!filteredNewDeps.has(dep)) {\n const unsub = this.subscriptions.get(dep);\n if (unsub) {\n unsub();\n this.subscriptions.delete(dep);\n }\n }\n }\n\n for (const dep of filteredNewDeps) {\n if (!this.currentDeps.has(dep) && !this.subscriptions.has(dep)) {\n const unsub = dep.subscribe(onChange);\n this.subscriptions.set(dep, unsub);\n }\n }\n\n this.currentDeps = filteredNewDeps;\n return true;\n }\n\n /**\n * Add a single dependency subscription.\n */\n add(dep: StateContainerInstance, onChange: () => void): void {\n if (this.subscriptions.has(dep) || dep.isDisposed) {\n return;\n }\n const unsub = dep.subscribe(onChange);\n this.subscriptions.set(dep, unsub);\n this.currentDeps.add(dep);\n }\n\n /**\n * Check if a dependency is currently subscribed.\n */\n has(dep: StateContainerInstance): boolean {\n return this.currentDeps.has(dep);\n }\n\n /**\n * Get the current set of dependencies.\n */\n getDependencies(): Set<StateContainerInstance> {\n return new Set(this.currentDeps);\n }\n\n /**\n * Clean up all active subscriptions.\n */\n cleanup(): void {\n for (const unsub of this.subscriptions.values()) {\n unsub();\n }\n this.subscriptions.clear();\n this.currentDeps.clear();\n }\n\n private areSetsEqual(\n a: Set<StateContainerInstance>,\n b: Set<StateContainerInstance>,\n ): boolean {\n if (a.size !== b.size) return false;\n for (const item of a) {\n if (!b.has(item)) return false;\n }\n return true;\n }\n}\n","import { getRegistry } from '../registry/config';\nimport type { StateContainerInstance } from '../types/utilities';\n\n/**\n * Resolve all transitive dependencies of a bloc via BFS over `dependencies` maps.\n * Uses cycle detection to avoid infinite loops.\n * @internal\n */\nexport function resolveDependencies(\n bloc: StateContainerInstance,\n): Set<StateContainerInstance> {\n const result = new Set<StateContainerInstance>();\n const visited = new Set<string>();\n const queue: StateContainerInstance[] = [bloc];\n\n while (queue.length > 0) {\n const current = queue.shift();\n if (!current) {\n break;\n }\n for (const [Type, key] of current.dependencies) {\n const visitKey = `${Type.name}::${key}`;\n if (visited.has(visitKey)) continue;\n visited.add(visitKey);\n const dep = getRegistry().ensure(Type, key);\n result.add(dep);\n if (dep.dependencies.size > 0) {\n queue.push(dep);\n }\n }\n }\n\n result.delete(bloc);\n return result;\n}\n"],"mappings":"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"}
|
package/dist/testing.cjs
ADDED
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
+
const require_Cubit = require("./Cubit-CZaf_fp4.cjs");
|
|
3
|
+
const require_StateContainerRegistry = require("./StateContainerRegistry-BsMIpllP.cjs");
|
|
4
|
+
const require_config = require("./config-DLzmy2rZ.cjs");
|
|
5
|
+
const require_ensure = require("./ensure-CSHYjIeH.cjs");
|
|
6
|
+
//#region src/testing.ts
|
|
7
|
+
function createTestRegistry() {
|
|
8
|
+
return new require_StateContainerRegistry.StateContainerRegistry();
|
|
9
|
+
}
|
|
10
|
+
function withTestRegistry(fn) {
|
|
11
|
+
const previous = require_config.getRegistry();
|
|
12
|
+
const testRegistry = createTestRegistry();
|
|
13
|
+
require_config.setRegistry(testRegistry);
|
|
14
|
+
try {
|
|
15
|
+
const result = fn(testRegistry);
|
|
16
|
+
if (result instanceof Promise) return result.then((value) => {
|
|
17
|
+
require_config.setRegistry(previous);
|
|
18
|
+
return value;
|
|
19
|
+
}, (error) => {
|
|
20
|
+
require_config.setRegistry(previous);
|
|
21
|
+
throw error;
|
|
22
|
+
});
|
|
23
|
+
require_config.setRegistry(previous);
|
|
24
|
+
return result;
|
|
25
|
+
} catch (error) {
|
|
26
|
+
require_config.setRegistry(previous);
|
|
27
|
+
throw error;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
function blacTestSetup() {
|
|
31
|
+
let savedRegistry;
|
|
32
|
+
beforeEach(() => {
|
|
33
|
+
savedRegistry = require_config.getRegistry();
|
|
34
|
+
require_config.setRegistry(new require_StateContainerRegistry.StateContainerRegistry());
|
|
35
|
+
});
|
|
36
|
+
afterEach(() => {
|
|
37
|
+
require_config.setRegistry(savedRegistry);
|
|
38
|
+
});
|
|
39
|
+
}
|
|
40
|
+
const DEFAULT_KEY = "default";
|
|
41
|
+
function registerOverride(BlocClass, instance, instanceKey = DEFAULT_KEY) {
|
|
42
|
+
const registry = require_config.getRegistry();
|
|
43
|
+
const existing = registry.acquire(BlocClass, instanceKey, {
|
|
44
|
+
canCreate: true,
|
|
45
|
+
countRef: false
|
|
46
|
+
});
|
|
47
|
+
if (existing !== instance && !existing.isDisposed) existing.dispose();
|
|
48
|
+
const instancesMap = registry.getInstancesMap(BlocClass);
|
|
49
|
+
const entry = {
|
|
50
|
+
instance,
|
|
51
|
+
refCount: 1
|
|
52
|
+
};
|
|
53
|
+
instancesMap.set(instanceKey, entry);
|
|
54
|
+
}
|
|
55
|
+
function overrideEnsure(BlocClass, instance, fn, instanceKey = DEFAULT_KEY) {
|
|
56
|
+
return withTestRegistry(() => {
|
|
57
|
+
registerOverride(BlocClass, instance, instanceKey);
|
|
58
|
+
return fn();
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
function createCubitStub(BlocClass, options) {
|
|
62
|
+
const instance = new BlocClass();
|
|
63
|
+
if (options?.state != null) {
|
|
64
|
+
if (instance instanceof require_Cubit.Cubit) {
|
|
65
|
+
const currentState = instance.state;
|
|
66
|
+
if (typeof currentState === "object" && currentState !== null && typeof options.state === "object" && options.state !== null) instance.patch(options.state);
|
|
67
|
+
else instance.emit(options.state);
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
if (options?.methods) {
|
|
71
|
+
for (const [key, impl] of Object.entries(options.methods)) if (typeof impl === "function") instance[key] = impl;
|
|
72
|
+
}
|
|
73
|
+
return instance;
|
|
74
|
+
}
|
|
75
|
+
function withBlocState(BlocClass, state, instanceKey) {
|
|
76
|
+
const instance = require_ensure.ensure(BlocClass, instanceKey);
|
|
77
|
+
if (instance instanceof require_Cubit.Cubit) {
|
|
78
|
+
const currentState = instance.state;
|
|
79
|
+
if (typeof currentState === "object" && currentState !== null && typeof state === "object" && state !== null) instance.patch(state);
|
|
80
|
+
else instance.emit(state);
|
|
81
|
+
}
|
|
82
|
+
return instance;
|
|
83
|
+
}
|
|
84
|
+
function withBlocMethod(BlocClass, methodName, impl, instanceKey) {
|
|
85
|
+
const instance = require_ensure.ensure(BlocClass, instanceKey);
|
|
86
|
+
instance[methodName] = impl;
|
|
87
|
+
return instance;
|
|
88
|
+
}
|
|
89
|
+
async function flushBlocUpdates() {
|
|
90
|
+
await new Promise((resolve) => {
|
|
91
|
+
setTimeout(resolve, 0);
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
//#endregion
|
|
95
|
+
exports.blacTestSetup = blacTestSetup;
|
|
96
|
+
exports.createCubitStub = createCubitStub;
|
|
97
|
+
exports.createTestRegistry = createTestRegistry;
|
|
98
|
+
exports.flushBlocUpdates = flushBlocUpdates;
|
|
99
|
+
exports.overrideEnsure = overrideEnsure;
|
|
100
|
+
exports.registerOverride = registerOverride;
|
|
101
|
+
exports.withBlocMethod = withBlocMethod;
|
|
102
|
+
exports.withBlocState = withBlocState;
|
|
103
|
+
exports.withTestRegistry = withTestRegistry;
|
|
104
|
+
|
|
105
|
+
//# sourceMappingURL=testing.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"testing.cjs","names":["StateContainerRegistry","getRegistry","Cubit","ensure"],"sources":["../src/testing.ts"],"sourcesContent":["import { Cubit } from './core/Cubit';\nimport {\n type InstanceEntry,\n StateContainerRegistry,\n} from './core/StateContainerRegistry';\nimport { ensure, getRegistry, setRegistry } from './registry';\nimport type {\n ExtractState,\n StateContainerConstructor,\n} from './types/utilities';\n\ndeclare const beforeEach: (fn: () => void) => void;\ndeclare const afterEach: (fn: () => void) => void;\n\n// --- createTestRegistry + withTestRegistry ---\n\nexport function createTestRegistry(): StateContainerRegistry {\n return new StateContainerRegistry();\n}\n\nexport function withTestRegistry<T>(\n fn: (registry: StateContainerRegistry) => T,\n): T {\n const previous = getRegistry();\n const testRegistry = createTestRegistry();\n setRegistry(testRegistry);\n try {\n const result = fn(testRegistry);\n if (result instanceof Promise) {\n return result.then(\n (value) => {\n setRegistry(previous);\n return value;\n },\n (error) => {\n setRegistry(previous);\n throw error;\n },\n ) as T;\n }\n setRegistry(previous);\n return result;\n } catch (error) {\n setRegistry(previous);\n throw error;\n }\n}\n\n// --- blacTestSetup ---\n\nexport function blacTestSetup(): void {\n let savedRegistry: StateContainerRegistry;\n beforeEach(() => {\n savedRegistry = getRegistry();\n setRegistry(new StateContainerRegistry());\n });\n afterEach(() => {\n setRegistry(savedRegistry);\n });\n}\n\n// --- registerOverride + overrideEnsure ---\n\nconst DEFAULT_KEY = 'default';\n\nexport function registerOverride<T extends StateContainerConstructor>(\n BlocClass: T,\n instance: InstanceType<T>,\n instanceKey: string = DEFAULT_KEY,\n): void {\n const registry = getRegistry();\n const existing = registry.acquire(BlocClass, instanceKey, {\n canCreate: true,\n countRef: false,\n });\n if (existing !== instance && !existing.isDisposed) {\n existing.dispose();\n }\n const instancesMap = registry.getInstancesMap(BlocClass);\n const entry: InstanceEntry<InstanceType<T>> = { instance, refCount: 1 };\n instancesMap.set(instanceKey, entry);\n}\n\nexport function overrideEnsure<T extends StateContainerConstructor, R>(\n BlocClass: T,\n instance: InstanceType<T>,\n fn: () => R,\n instanceKey: string = DEFAULT_KEY,\n): R {\n return withTestRegistry(() => {\n registerOverride(BlocClass, instance, instanceKey);\n return fn();\n });\n}\n\n// --- createCubitStub ---\n\ntype MethodKeys<T> = {\n [K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;\n}[keyof T];\n\nexport interface CubitStubOptions<T extends StateContainerConstructor> {\n state?: ExtractState<T> extends Record<string, any>\n ? Partial<ExtractState<T>>\n : ExtractState<T>;\n methods?: Partial<\n Record<MethodKeys<InstanceType<T>>, (...args: any[]) => any>\n >;\n}\n\nexport function createCubitStub<T extends StateContainerConstructor>(\n BlocClass: T,\n options?: CubitStubOptions<T>,\n): InstanceType<T> {\n const instance = new BlocClass() as InstanceType<T>;\n if (options?.state != null) {\n if (instance instanceof Cubit) {\n const currentState = instance.state;\n if (\n typeof currentState === 'object' &&\n currentState !== null &&\n typeof options.state === 'object' &&\n options.state !== null\n ) {\n instance.patch(options.state as any);\n } else {\n instance.emit(options.state as any);\n }\n }\n }\n if (options?.methods) {\n for (const [key, impl] of Object.entries(options.methods)) {\n if (typeof impl === 'function') {\n (instance as any)[key] = impl;\n }\n }\n }\n return instance;\n}\n\n// --- withBlocState ---\n\nexport function withBlocState<T extends StateContainerConstructor>(\n BlocClass: T,\n state: ExtractState<T> extends Record<string, any>\n ? Partial<ExtractState<T>>\n : ExtractState<T>,\n instanceKey?: string,\n): InstanceType<T> {\n const instance = ensure(BlocClass, instanceKey);\n if (instance instanceof Cubit) {\n const currentState = instance.state;\n if (\n typeof currentState === 'object' &&\n currentState !== null &&\n typeof state === 'object' &&\n state !== null\n ) {\n instance.patch(state as any);\n } else {\n instance.emit(state as any);\n }\n }\n return instance;\n}\n\n// --- withBlocMethod ---\n\nexport function withBlocMethod<T extends StateContainerConstructor>(\n BlocClass: T,\n methodName: keyof InstanceType<T>,\n impl: (...args: any[]) => any,\n instanceKey?: string,\n): InstanceType<T> {\n const instance = ensure(BlocClass, instanceKey);\n (instance as any)[methodName] = impl;\n return instance;\n}\n\n// --- flushBlocUpdates ---\n\nexport async function flushBlocUpdates(): Promise<void> {\n await new Promise<void>((resolve) => {\n setTimeout(resolve, 0);\n });\n}\n"],"mappings":";;;;;;AAgBA,SAAgB,qBAA6C;AAC3D,QAAO,IAAIA,+BAAAA,wBAAwB;;AAGrC,SAAgB,iBACd,IACG;CACH,MAAM,WAAWC,eAAAA,aAAa;CAC9B,MAAM,eAAe,oBAAoB;AACzC,gBAAA,YAAY,aAAa;AACzB,KAAI;EACF,MAAM,SAAS,GAAG,aAAa;AAC/B,MAAI,kBAAkB,QACpB,QAAO,OAAO,MACX,UAAU;AACT,kBAAA,YAAY,SAAS;AACrB,UAAO;MAER,UAAU;AACT,kBAAA,YAAY,SAAS;AACrB,SAAM;IAET;AAEH,iBAAA,YAAY,SAAS;AACrB,SAAO;UACA,OAAO;AACd,iBAAA,YAAY,SAAS;AACrB,QAAM;;;AAMV,SAAgB,gBAAsB;CACpC,IAAI;AACJ,kBAAiB;AACf,kBAAgBA,eAAAA,aAAa;AAC7B,iBAAA,YAAY,IAAID,+BAAAA,wBAAwB,CAAC;GACzC;AACF,iBAAgB;AACd,iBAAA,YAAY,cAAc;GAC1B;;AAKJ,MAAM,cAAc;AAEpB,SAAgB,iBACd,WACA,UACA,cAAsB,aAChB;CACN,MAAM,WAAWC,eAAAA,aAAa;CAC9B,MAAM,WAAW,SAAS,QAAQ,WAAW,aAAa;EACxD,WAAW;EACX,UAAU;EACX,CAAC;AACF,KAAI,aAAa,YAAY,CAAC,SAAS,WACrC,UAAS,SAAS;CAEpB,MAAM,eAAe,SAAS,gBAAgB,UAAU;CACxD,MAAM,QAAwC;EAAE;EAAU,UAAU;EAAG;AACvE,cAAa,IAAI,aAAa,MAAM;;AAGtC,SAAgB,eACd,WACA,UACA,IACA,cAAsB,aACnB;AACH,QAAO,uBAAuB;AAC5B,mBAAiB,WAAW,UAAU,YAAY;AAClD,SAAO,IAAI;GACX;;AAkBJ,SAAgB,gBACd,WACA,SACiB;CACjB,MAAM,WAAW,IAAI,WAAW;AAChC,KAAI,SAAS,SAAS;MAChB,oBAAoBC,cAAAA,OAAO;GAC7B,MAAM,eAAe,SAAS;AAC9B,OACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,QAAQ,UAAU,YACzB,QAAQ,UAAU,KAElB,UAAS,MAAM,QAAQ,MAAa;OAEpC,UAAS,KAAK,QAAQ,MAAa;;;AAIzC,KAAI,SAAS;OACN,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,QAAQ,QAAQ,CACvD,KAAI,OAAO,SAAS,WACjB,UAAiB,OAAO;;AAI/B,QAAO;;AAKT,SAAgB,cACd,WACA,OAGA,aACiB;CACjB,MAAM,WAAWC,eAAAA,OAAO,WAAW,YAAY;AAC/C,KAAI,oBAAoBD,cAAAA,OAAO;EAC7B,MAAM,eAAe,SAAS;AAC9B,MACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,UAAU,YACjB,UAAU,KAEV,UAAS,MAAM,MAAa;MAE5B,UAAS,KAAK,MAAa;;AAG/B,QAAO;;AAKT,SAAgB,eACd,WACA,YACA,MACA,aACiB;CACjB,MAAM,WAAWC,eAAAA,OAAO,WAAW,YAAY;AAC9C,UAAiB,cAAc;AAChC,QAAO;;AAKT,eAAsB,mBAAkC;AACtD,OAAM,IAAI,SAAe,YAAY;AACnC,aAAW,SAAS,EAAE;GACtB"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { StateContainerRegistry } from './core/StateContainerRegistry';
|
|
2
|
+
import type { ExtractState, StateContainerConstructor } from './types/utilities';
|
|
3
|
+
export declare function createTestRegistry(): StateContainerRegistry;
|
|
4
|
+
export declare function withTestRegistry<T>(fn: (registry: StateContainerRegistry) => T): T;
|
|
5
|
+
export declare function blacTestSetup(): void;
|
|
6
|
+
export declare function registerOverride<T extends StateContainerConstructor>(BlocClass: T, instance: InstanceType<T>, instanceKey?: string): void;
|
|
7
|
+
export declare function overrideEnsure<T extends StateContainerConstructor, R>(BlocClass: T, instance: InstanceType<T>, fn: () => R, instanceKey?: string): R;
|
|
8
|
+
type MethodKeys<T> = {
|
|
9
|
+
[K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;
|
|
10
|
+
}[keyof T];
|
|
11
|
+
export interface CubitStubOptions<T extends StateContainerConstructor> {
|
|
12
|
+
state?: ExtractState<T> extends Record<string, any> ? Partial<ExtractState<T>> : ExtractState<T>;
|
|
13
|
+
methods?: Partial<Record<MethodKeys<InstanceType<T>>, (...args: any[]) => any>>;
|
|
14
|
+
}
|
|
15
|
+
export declare function createCubitStub<T extends StateContainerConstructor>(BlocClass: T, options?: CubitStubOptions<T>): InstanceType<T>;
|
|
16
|
+
export declare function withBlocState<T extends StateContainerConstructor>(BlocClass: T, state: ExtractState<T> extends Record<string, any> ? Partial<ExtractState<T>> : ExtractState<T>, instanceKey?: string): InstanceType<T>;
|
|
17
|
+
export declare function withBlocMethod<T extends StateContainerConstructor>(BlocClass: T, methodName: keyof InstanceType<T>, impl: (...args: any[]) => any, instanceKey?: string): InstanceType<T>;
|
|
18
|
+
export declare function flushBlocUpdates(): Promise<void>;
|
|
19
|
+
export {};
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { StateContainerRegistry } from './core/StateContainerRegistry';
|
|
2
|
+
import type { ExtractState, StateContainerConstructor } from './types/utilities';
|
|
3
|
+
export declare function createTestRegistry(): StateContainerRegistry;
|
|
4
|
+
export declare function withTestRegistry<T>(fn: (registry: StateContainerRegistry) => T): T;
|
|
5
|
+
export declare function blacTestSetup(): void;
|
|
6
|
+
export declare function registerOverride<T extends StateContainerConstructor>(BlocClass: T, instance: InstanceType<T>, instanceKey?: string): void;
|
|
7
|
+
export declare function overrideEnsure<T extends StateContainerConstructor, R>(BlocClass: T, instance: InstanceType<T>, fn: () => R, instanceKey?: string): R;
|
|
8
|
+
type MethodKeys<T> = {
|
|
9
|
+
[K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;
|
|
10
|
+
}[keyof T];
|
|
11
|
+
export interface CubitStubOptions<T extends StateContainerConstructor> {
|
|
12
|
+
state?: ExtractState<T> extends Record<string, any> ? Partial<ExtractState<T>> : ExtractState<T>;
|
|
13
|
+
methods?: Partial<Record<MethodKeys<InstanceType<T>>, (...args: any[]) => any>>;
|
|
14
|
+
}
|
|
15
|
+
export declare function createCubitStub<T extends StateContainerConstructor>(BlocClass: T, options?: CubitStubOptions<T>): InstanceType<T>;
|
|
16
|
+
export declare function withBlocState<T extends StateContainerConstructor>(BlocClass: T, state: ExtractState<T> extends Record<string, any> ? Partial<ExtractState<T>> : ExtractState<T>, instanceKey?: string): InstanceType<T>;
|
|
17
|
+
export declare function withBlocMethod<T extends StateContainerConstructor>(BlocClass: T, methodName: keyof InstanceType<T>, impl: (...args: any[]) => any, instanceKey?: string): InstanceType<T>;
|
|
18
|
+
export declare function flushBlocUpdates(): Promise<void>;
|
|
19
|
+
export {};
|
package/dist/testing.js
ADDED
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import { t as Cubit } from "./Cubit-PMTXxI_u.js";
|
|
2
|
+
import { t as StateContainerRegistry } from "./StateContainerRegistry-DOkDGng-.js";
|
|
3
|
+
import { r as setRegistry, t as getRegistry } from "./config-XQua95Xz.js";
|
|
4
|
+
import { t as ensure } from "./ensure-C5I1xp2C.js";
|
|
5
|
+
//#region src/testing.ts
|
|
6
|
+
function createTestRegistry() {
|
|
7
|
+
return new StateContainerRegistry();
|
|
8
|
+
}
|
|
9
|
+
function withTestRegistry(fn) {
|
|
10
|
+
const previous = getRegistry();
|
|
11
|
+
const testRegistry = createTestRegistry();
|
|
12
|
+
setRegistry(testRegistry);
|
|
13
|
+
try {
|
|
14
|
+
const result = fn(testRegistry);
|
|
15
|
+
if (result instanceof Promise) return result.then((value) => {
|
|
16
|
+
setRegistry(previous);
|
|
17
|
+
return value;
|
|
18
|
+
}, (error) => {
|
|
19
|
+
setRegistry(previous);
|
|
20
|
+
throw error;
|
|
21
|
+
});
|
|
22
|
+
setRegistry(previous);
|
|
23
|
+
return result;
|
|
24
|
+
} catch (error) {
|
|
25
|
+
setRegistry(previous);
|
|
26
|
+
throw error;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
function blacTestSetup() {
|
|
30
|
+
let savedRegistry;
|
|
31
|
+
beforeEach(() => {
|
|
32
|
+
savedRegistry = getRegistry();
|
|
33
|
+
setRegistry(new StateContainerRegistry());
|
|
34
|
+
});
|
|
35
|
+
afterEach(() => {
|
|
36
|
+
setRegistry(savedRegistry);
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
const DEFAULT_KEY = "default";
|
|
40
|
+
function registerOverride(BlocClass, instance, instanceKey = DEFAULT_KEY) {
|
|
41
|
+
const registry = getRegistry();
|
|
42
|
+
const existing = registry.acquire(BlocClass, instanceKey, {
|
|
43
|
+
canCreate: true,
|
|
44
|
+
countRef: false
|
|
45
|
+
});
|
|
46
|
+
if (existing !== instance && !existing.isDisposed) existing.dispose();
|
|
47
|
+
const instancesMap = registry.getInstancesMap(BlocClass);
|
|
48
|
+
const entry = {
|
|
49
|
+
instance,
|
|
50
|
+
refCount: 1
|
|
51
|
+
};
|
|
52
|
+
instancesMap.set(instanceKey, entry);
|
|
53
|
+
}
|
|
54
|
+
function overrideEnsure(BlocClass, instance, fn, instanceKey = DEFAULT_KEY) {
|
|
55
|
+
return withTestRegistry(() => {
|
|
56
|
+
registerOverride(BlocClass, instance, instanceKey);
|
|
57
|
+
return fn();
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
function createCubitStub(BlocClass, options) {
|
|
61
|
+
const instance = new BlocClass();
|
|
62
|
+
if (options?.state != null) {
|
|
63
|
+
if (instance instanceof Cubit) {
|
|
64
|
+
const currentState = instance.state;
|
|
65
|
+
if (typeof currentState === "object" && currentState !== null && typeof options.state === "object" && options.state !== null) instance.patch(options.state);
|
|
66
|
+
else instance.emit(options.state);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
if (options?.methods) {
|
|
70
|
+
for (const [key, impl] of Object.entries(options.methods)) if (typeof impl === "function") instance[key] = impl;
|
|
71
|
+
}
|
|
72
|
+
return instance;
|
|
73
|
+
}
|
|
74
|
+
function withBlocState(BlocClass, state, instanceKey) {
|
|
75
|
+
const instance = ensure(BlocClass, instanceKey);
|
|
76
|
+
if (instance instanceof Cubit) {
|
|
77
|
+
const currentState = instance.state;
|
|
78
|
+
if (typeof currentState === "object" && currentState !== null && typeof state === "object" && state !== null) instance.patch(state);
|
|
79
|
+
else instance.emit(state);
|
|
80
|
+
}
|
|
81
|
+
return instance;
|
|
82
|
+
}
|
|
83
|
+
function withBlocMethod(BlocClass, methodName, impl, instanceKey) {
|
|
84
|
+
const instance = ensure(BlocClass, instanceKey);
|
|
85
|
+
instance[methodName] = impl;
|
|
86
|
+
return instance;
|
|
87
|
+
}
|
|
88
|
+
async function flushBlocUpdates() {
|
|
89
|
+
await new Promise((resolve) => {
|
|
90
|
+
setTimeout(resolve, 0);
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
//#endregion
|
|
94
|
+
export { blacTestSetup, createCubitStub, createTestRegistry, flushBlocUpdates, overrideEnsure, registerOverride, withBlocMethod, withBlocState, withTestRegistry };
|
|
95
|
+
|
|
96
|
+
//# sourceMappingURL=testing.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import { Cubit } from './core/Cubit';\nimport {\n type InstanceEntry,\n StateContainerRegistry,\n} from './core/StateContainerRegistry';\nimport { ensure, getRegistry, setRegistry } from './registry';\nimport type {\n ExtractState,\n StateContainerConstructor,\n} from './types/utilities';\n\ndeclare const beforeEach: (fn: () => void) => void;\ndeclare const afterEach: (fn: () => void) => void;\n\n// --- createTestRegistry + withTestRegistry ---\n\nexport function createTestRegistry(): StateContainerRegistry {\n return new StateContainerRegistry();\n}\n\nexport function withTestRegistry<T>(\n fn: (registry: StateContainerRegistry) => T,\n): T {\n const previous = getRegistry();\n const testRegistry = createTestRegistry();\n setRegistry(testRegistry);\n try {\n const result = fn(testRegistry);\n if (result instanceof Promise) {\n return result.then(\n (value) => {\n setRegistry(previous);\n return value;\n },\n (error) => {\n setRegistry(previous);\n throw error;\n },\n ) as T;\n }\n setRegistry(previous);\n return result;\n } catch (error) {\n setRegistry(previous);\n throw error;\n }\n}\n\n// --- blacTestSetup ---\n\nexport function blacTestSetup(): void {\n let savedRegistry: StateContainerRegistry;\n beforeEach(() => {\n savedRegistry = getRegistry();\n setRegistry(new StateContainerRegistry());\n });\n afterEach(() => {\n setRegistry(savedRegistry);\n });\n}\n\n// --- registerOverride + overrideEnsure ---\n\nconst DEFAULT_KEY = 'default';\n\nexport function registerOverride<T extends StateContainerConstructor>(\n BlocClass: T,\n instance: InstanceType<T>,\n instanceKey: string = DEFAULT_KEY,\n): void {\n const registry = getRegistry();\n const existing = registry.acquire(BlocClass, instanceKey, {\n canCreate: true,\n countRef: false,\n });\n if (existing !== instance && !existing.isDisposed) {\n existing.dispose();\n }\n const instancesMap = registry.getInstancesMap(BlocClass);\n const entry: InstanceEntry<InstanceType<T>> = { instance, refCount: 1 };\n instancesMap.set(instanceKey, entry);\n}\n\nexport function overrideEnsure<T extends StateContainerConstructor, R>(\n BlocClass: T,\n instance: InstanceType<T>,\n fn: () => R,\n instanceKey: string = DEFAULT_KEY,\n): R {\n return withTestRegistry(() => {\n registerOverride(BlocClass, instance, instanceKey);\n return fn();\n });\n}\n\n// --- createCubitStub ---\n\ntype MethodKeys<T> = {\n [K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;\n}[keyof T];\n\nexport interface CubitStubOptions<T extends StateContainerConstructor> {\n state?: ExtractState<T> extends Record<string, any>\n ? Partial<ExtractState<T>>\n : ExtractState<T>;\n methods?: Partial<\n Record<MethodKeys<InstanceType<T>>, (...args: any[]) => any>\n >;\n}\n\nexport function createCubitStub<T extends StateContainerConstructor>(\n BlocClass: T,\n options?: CubitStubOptions<T>,\n): InstanceType<T> {\n const instance = new BlocClass() as InstanceType<T>;\n if (options?.state != null) {\n if (instance instanceof Cubit) {\n const currentState = instance.state;\n if (\n typeof currentState === 'object' &&\n currentState !== null &&\n typeof options.state === 'object' &&\n options.state !== null\n ) {\n instance.patch(options.state as any);\n } else {\n instance.emit(options.state as any);\n }\n }\n }\n if (options?.methods) {\n for (const [key, impl] of Object.entries(options.methods)) {\n if (typeof impl === 'function') {\n (instance as any)[key] = impl;\n }\n }\n }\n return instance;\n}\n\n// --- withBlocState ---\n\nexport function withBlocState<T extends StateContainerConstructor>(\n BlocClass: T,\n state: ExtractState<T> extends Record<string, any>\n ? Partial<ExtractState<T>>\n : ExtractState<T>,\n instanceKey?: string,\n): InstanceType<T> {\n const instance = ensure(BlocClass, instanceKey);\n if (instance instanceof Cubit) {\n const currentState = instance.state;\n if (\n typeof currentState === 'object' &&\n currentState !== null &&\n typeof state === 'object' &&\n state !== null\n ) {\n instance.patch(state as any);\n } else {\n instance.emit(state as any);\n }\n }\n return instance;\n}\n\n// --- withBlocMethod ---\n\nexport function withBlocMethod<T extends StateContainerConstructor>(\n BlocClass: T,\n methodName: keyof InstanceType<T>,\n impl: (...args: any[]) => any,\n instanceKey?: string,\n): InstanceType<T> {\n const instance = ensure(BlocClass, instanceKey);\n (instance as any)[methodName] = impl;\n return instance;\n}\n\n// --- flushBlocUpdates ---\n\nexport async function flushBlocUpdates(): Promise<void> {\n await new Promise<void>((resolve) => {\n setTimeout(resolve, 0);\n });\n}\n"],"mappings":";;;;;AAgBA,SAAgB,qBAA6C;AAC3D,QAAO,IAAI,wBAAwB;;AAGrC,SAAgB,iBACd,IACG;CACH,MAAM,WAAW,aAAa;CAC9B,MAAM,eAAe,oBAAoB;AACzC,aAAY,aAAa;AACzB,KAAI;EACF,MAAM,SAAS,GAAG,aAAa;AAC/B,MAAI,kBAAkB,QACpB,QAAO,OAAO,MACX,UAAU;AACT,eAAY,SAAS;AACrB,UAAO;MAER,UAAU;AACT,eAAY,SAAS;AACrB,SAAM;IAET;AAEH,cAAY,SAAS;AACrB,SAAO;UACA,OAAO;AACd,cAAY,SAAS;AACrB,QAAM;;;AAMV,SAAgB,gBAAsB;CACpC,IAAI;AACJ,kBAAiB;AACf,kBAAgB,aAAa;AAC7B,cAAY,IAAI,wBAAwB,CAAC;GACzC;AACF,iBAAgB;AACd,cAAY,cAAc;GAC1B;;AAKJ,MAAM,cAAc;AAEpB,SAAgB,iBACd,WACA,UACA,cAAsB,aAChB;CACN,MAAM,WAAW,aAAa;CAC9B,MAAM,WAAW,SAAS,QAAQ,WAAW,aAAa;EACxD,WAAW;EACX,UAAU;EACX,CAAC;AACF,KAAI,aAAa,YAAY,CAAC,SAAS,WACrC,UAAS,SAAS;CAEpB,MAAM,eAAe,SAAS,gBAAgB,UAAU;CACxD,MAAM,QAAwC;EAAE;EAAU,UAAU;EAAG;AACvE,cAAa,IAAI,aAAa,MAAM;;AAGtC,SAAgB,eACd,WACA,UACA,IACA,cAAsB,aACnB;AACH,QAAO,uBAAuB;AAC5B,mBAAiB,WAAW,UAAU,YAAY;AAClD,SAAO,IAAI;GACX;;AAkBJ,SAAgB,gBACd,WACA,SACiB;CACjB,MAAM,WAAW,IAAI,WAAW;AAChC,KAAI,SAAS,SAAS;MAChB,oBAAoB,OAAO;GAC7B,MAAM,eAAe,SAAS;AAC9B,OACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,QAAQ,UAAU,YACzB,QAAQ,UAAU,KAElB,UAAS,MAAM,QAAQ,MAAa;OAEpC,UAAS,KAAK,QAAQ,MAAa;;;AAIzC,KAAI,SAAS;OACN,MAAM,CAAC,KAAK,SAAS,OAAO,QAAQ,QAAQ,QAAQ,CACvD,KAAI,OAAO,SAAS,WACjB,UAAiB,OAAO;;AAI/B,QAAO;;AAKT,SAAgB,cACd,WACA,OAGA,aACiB;CACjB,MAAM,WAAW,OAAO,WAAW,YAAY;AAC/C,KAAI,oBAAoB,OAAO;EAC7B,MAAM,eAAe,SAAS;AAC9B,MACE,OAAO,iBAAiB,YACxB,iBAAiB,QACjB,OAAO,UAAU,YACjB,UAAU,KAEV,UAAS,MAAM,MAAa;MAE5B,UAAS,KAAK,MAAa;;AAG/B,QAAO;;AAKT,SAAgB,eACd,WACA,YACA,MACA,aACiB;CACjB,MAAM,WAAW,OAAO,WAAW,YAAY;AAC9C,UAAiB,cAAc;AAChC,QAAO;;AAKT,eAAsB,mBAAkC;AACtD,OAAM,IAAI,SAAe,YAAY;AACnC,aAAW,SAAS,EAAE;GACtB"}
|
|
@@ -1,10 +1,6 @@
|
|
|
1
|
-
const require_StateContainerRegistry = require("./StateContainerRegistry-
|
|
2
|
-
const
|
|
3
|
-
|
|
4
|
-
function ensure(BlocClass, instanceKey) {
|
|
5
|
-
return require_StateContainerRegistry.globalRegistry.ensure(BlocClass, instanceKey);
|
|
6
|
-
}
|
|
7
|
-
//#endregion
|
|
1
|
+
const require_StateContainerRegistry = require("./StateContainerRegistry-BsMIpllP.cjs");
|
|
2
|
+
const require_ensure = require("./ensure-CSHYjIeH.cjs");
|
|
3
|
+
const require_resolve_dependencies = require("./resolve-dependencies-BT6TU2HF.cjs");
|
|
8
4
|
//#region src/watch/watch.ts
|
|
9
5
|
const STOP = Symbol("watch.STOP");
|
|
10
6
|
const BLOC_REF_MARKER = Symbol("BlocRef");
|
|
@@ -29,8 +25,8 @@ function isBlocRef(input) {
|
|
|
29
25
|
return typeof input === "object" && input !== null && BLOC_REF_MARKER in input;
|
|
30
26
|
}
|
|
31
27
|
function resolveBloc(input) {
|
|
32
|
-
if (isBlocRef(input)) return ensure(input.blocClass, input.instanceId);
|
|
33
|
-
return ensure(input, require_StateContainerRegistry.BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY);
|
|
28
|
+
if (isBlocRef(input)) return require_ensure.ensure(input.blocClass, input.instanceId);
|
|
29
|
+
return require_ensure.ensure(input, require_StateContainerRegistry.BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY);
|
|
34
30
|
}
|
|
35
31
|
function isArray(input) {
|
|
36
32
|
return Array.isArray(input);
|
|
@@ -188,12 +184,6 @@ Object.defineProperty(exports, "createTrackedContext", {
|
|
|
188
184
|
return createTrackedContext;
|
|
189
185
|
}
|
|
190
186
|
});
|
|
191
|
-
Object.defineProperty(exports, "ensure", {
|
|
192
|
-
enumerable: true,
|
|
193
|
-
get: function() {
|
|
194
|
-
return ensure;
|
|
195
|
-
}
|
|
196
|
-
});
|
|
197
187
|
Object.defineProperty(exports, "instance", {
|
|
198
188
|
enumerable: true,
|
|
199
189
|
get: function() {
|
|
@@ -213,4 +203,4 @@ Object.defineProperty(exports, "watch", {
|
|
|
213
203
|
}
|
|
214
204
|
});
|
|
215
205
|
|
|
216
|
-
//# sourceMappingURL=tracked-
|
|
206
|
+
//# sourceMappingURL=tracked-DCfBaYjL.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tracked-DCfBaYjL.cjs","names":["ensure","BLAC_DEFAULTS","createState","createTrackingProxy","DependencyManager","stopTracking","resolveDependencies","createState","createTrackingProxy","stopTracking","hasChanges"],"sources":["../src/watch/watch.ts","../src/tracking/tracked.ts"],"sourcesContent":["import { ensure } from '../registry';\nimport type {\n StateContainerConstructor,\n StateContainerInstance,\n} from '../types/utilities';\nimport { BLAC_DEFAULTS } from '../constants';\nimport {\n createState,\n startTracking,\n stopTracking,\n createTrackingProxy,\n type TrackingProxyState,\n} from '../tracking/tracking-proxy';\nimport { DependencyManager } from '../tracking/dependency-manager';\nimport { resolveDependencies } from '../tracking/resolve-dependencies';\n\nconst STOP: unique symbol = Symbol('watch.STOP');\n\nconst BLOC_REF_MARKER = Symbol('BlocRef');\n\n/**\n * Reference to a specific bloc instance by class and instance ID.\n */\nexport interface BlocRef<T extends StateContainerConstructor> {\n [BLOC_REF_MARKER]: true;\n blocClass: T;\n instanceId: string;\n}\n\n/**\n * Create a reference to a specific bloc instance.\n *\n * @example\n * ```ts\n * watch(instance(UserBloc, 'user-123'), (userBloc) => {\n * console.log(userBloc.state.name);\n * });\n * ```\n */\nexport function instance<T extends StateContainerConstructor>(\n BlocClass: T,\n instanceId: string,\n): BlocRef<T> {\n return {\n [BLOC_REF_MARKER]: true,\n blocClass: BlocClass,\n instanceId,\n };\n}\n\nfunction isBlocRef(\n input: unknown,\n): input is BlocRef<StateContainerConstructor> {\n return (\n typeof input === 'object' && input !== null && BLOC_REF_MARKER in input\n );\n}\n\ntype BlocInput = StateContainerConstructor | BlocRef<StateContainerConstructor>;\n\ntype ExtractInstance<T> =\n T extends BlocRef<infer C>\n ? InstanceType<C>\n : T extends StateContainerConstructor\n ? InstanceType<T>\n : never;\n\ntype ExtractInstances<T extends readonly BlocInput[]> = {\n [K in keyof T]: ExtractInstance<T[K]>;\n};\n\ntype StopSymbol = typeof STOP;\n\n/**\n * Watch function signature for single bloc.\n */\nexport interface WatchSingleFn {\n <T extends StateContainerConstructor>(\n bloc: T | BlocRef<T>,\n callback: (bloc: InstanceType<T>) => void | StopSymbol,\n ): () => void;\n\n STOP: StopSymbol;\n}\n\n/**\n * Watch function signature for multiple blocs.\n */\nexport interface WatchMultipleFn {\n <T extends readonly BlocInput[]>(\n blocs: T,\n callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n ): () => void;\n\n STOP: StopSymbol;\n}\n\n/**\n * Combined watch function type.\n */\nexport interface WatchFn extends WatchSingleFn {\n <T extends readonly BlocInput[]>(\n blocs: T,\n callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n ): () => void;\n}\n\nfunction resolveBloc(input: BlocInput): StateContainerInstance {\n if (isBlocRef(input)) {\n return ensure(input.blocClass, input.instanceId);\n }\n return ensure(input, BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY);\n}\n\nfunction isArray(input: unknown): input is readonly BlocInput[] {\n return Array.isArray(input);\n}\n\n/**\n * Watch one or more blocs for state changes.\n * Automatically tracks state property and getter accesses.\n *\n * @example Single bloc\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n * console.log(userBloc.state.name);\n * console.log(userBloc.fullName); // getter also tracked\n * });\n * ```\n *\n * @example Multiple blocs\n * ```ts\n * const unwatch = watch(\n * [UserBloc, SettingsBloc] as const,\n * ([userBloc, settingsBloc]) => {\n * console.log(userBloc.state.name, settingsBloc.state.theme);\n * }\n * );\n * ```\n *\n * @example With specific instance\n * ```ts\n * const unwatch = watch(\n * instance(UserBloc, 'user-123'),\n * (userBloc) => {\n * console.log(userBloc.state.name);\n * }\n * );\n * ```\n *\n * @example Stop watching from callback\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n * if (userBloc.state.done) {\n * return watch.STOP;\n * }\n * });\n * ```\n */\nfunction watchImpl<T extends StateContainerConstructor>(\n bloc: T | BlocRef<T>,\n callback: (bloc: InstanceType<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl<T extends readonly BlocInput[]>(\n blocs: T,\n callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl(\n blocsOrBloc: BlocInput | readonly BlocInput[],\n callback: (blocsOrBloc: any) => void | StopSymbol,\n): () => void {\n const isSingle = !isArray(blocsOrBloc);\n const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;\n\n const instances = inputs.map(resolveBloc);\n\n const tracker: TrackingProxyState = createState();\n const proxiedInstances = instances.map((inst) =>\n createTrackingProxy(inst, tracker),\n );\n\n const externalDepsManager = new DependencyManager();\n\n let disposed = false;\n const primarySubscriptions: (() => void)[] = [];\n\n const cleanup = () => {\n if (disposed) return;\n disposed = true;\n primarySubscriptions.forEach((unsub) => unsub());\n externalDepsManager.cleanup();\n };\n\n const runCallback = () => {\n if (disposed) return;\n\n startTracking(tracker);\n\n let result: void | StopSymbol;\n try {\n const arg = isSingle ? proxiedInstances[0] : proxiedInstances;\n result = callback(arg);\n } finally {\n const externalDeps = new Set<StateContainerInstance>();\n for (const inst of instances) {\n const deps = stopTracking(tracker, inst);\n for (const dep of deps) {\n externalDeps.add(dep);\n }\n for (const dep of resolveDependencies(inst)) {\n externalDeps.add(dep);\n }\n }\n\n for (const inst of instances) {\n externalDeps.delete(inst);\n }\n\n externalDepsManager.sync(externalDeps, runCallback);\n }\n\n if (result === STOP) {\n cleanup();\n }\n };\n\n const onChange = () => {\n if (disposed) return;\n runCallback();\n };\n\n for (const inst of instances) {\n primarySubscriptions.push(inst.subscribe(onChange));\n }\n\n runCallback();\n\n return cleanup;\n}\n\nexport const watch: WatchFn = Object.assign(watchImpl, { STOP }) as WatchFn;\n","import type { StateContainerInstance } from '../types/utilities';\nimport {\n createState,\n startTracking,\n stopTracking,\n createTrackingProxy,\n hasChanges,\n type TrackingProxyState,\n} from './tracking-proxy';\nimport { DependencyManager } from './dependency-manager';\n\n/**\n * Result of running a tracked callback.\n */\nexport interface TrackedResult<T> {\n result: T;\n dependencies: Set<StateContainerInstance>;\n}\n\n/**\n * Options for the tracked() function.\n */\nexport interface TrackedOptions {\n exclude?: StateContainerInstance;\n}\n\n/**\n * Run a callback while tracking all bloc dependencies accessed.\n * Returns both the result and the set of discovered dependencies.\n *\n * @example\n * ```ts\n * const { result, dependencies } = tracked(() => {\n * const user = ensure(UserBloc);\n * return user.fullName; // getter that may access other blocs\n * });\n * // dependencies contains UserBloc + any blocs accessed in fullName getter\n * ```\n */\nexport function tracked<T>(\n callback: () => T,\n options?: TrackedOptions,\n): TrackedResult<T> {\n const tracker = createState();\n startTracking(tracker);\n\n let result: T;\n try {\n result = callback();\n } finally {\n stopTracking(tracker, { state: null } as any);\n }\n\n const dependencies = new Set(tracker.dependencies);\n\n if (options?.exclude) {\n dependencies.delete(options.exclude);\n }\n\n return { result, dependencies };\n}\n\n/**\n * Context for running tracked callbacks with bloc proxies.\n * Provides methods to create proxies and check for changes.\n */\nexport class TrackedContext {\n private tracker: TrackingProxyState;\n private proxiedBlocs = new WeakMap<\n StateContainerInstance,\n StateContainerInstance\n >();\n private primaryBlocs = new Set<StateContainerInstance>();\n\n constructor() {\n this.tracker = createState();\n }\n\n /**\n * Get a tracking proxy for a bloc instance.\n * The proxy will track state and getter accesses.\n */\n proxy<T extends StateContainerInstance>(bloc: T): T {\n const cached = this.proxiedBlocs.get(bloc);\n if (cached) {\n return cached as T;\n }\n\n const proxied = createTrackingProxy(bloc, this.tracker);\n this.proxiedBlocs.set(bloc, proxied);\n this.primaryBlocs.add(bloc);\n return proxied;\n }\n\n /**\n * Start tracking for a new callback execution.\n */\n start(): void {\n startTracking(this.tracker);\n }\n\n /**\n * Stop tracking and get discovered dependencies.\n * Excludes primary blocs (those explicitly proxied via proxy()).\n */\n stop(): Set<StateContainerInstance> {\n const allDeps = new Set<StateContainerInstance>();\n\n for (const bloc of this.primaryBlocs) {\n const deps = stopTracking(this.tracker, bloc);\n for (const dep of deps) {\n if (!this.primaryBlocs.has(dep)) {\n allDeps.add(dep);\n }\n }\n }\n\n return allDeps;\n }\n\n /**\n * Check if any tracked state or getters have changed.\n */\n changed(): boolean {\n for (const bloc of this.primaryBlocs) {\n if (hasChanges(this.tracker, bloc)) {\n return true;\n }\n }\n return false;\n }\n\n /**\n * Get all primary blocs (those explicitly proxied).\n */\n getPrimaryBlocs(): Set<StateContainerInstance> {\n return new Set(this.primaryBlocs);\n }\n\n /**\n * Reset the context for reuse.\n */\n reset(): void {\n this.tracker = createState();\n this.proxiedBlocs = new WeakMap();\n this.primaryBlocs.clear();\n }\n}\n\n/**\n * Create a new tracked context for manual control over tracking.\n */\nexport function createTrackedContext(): TrackedContext {\n return new TrackedContext();\n}\n\nexport { DependencyManager };\n"],"mappings":"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"}
|
|
@@ -1,10 +1,6 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
|
|
4
|
-
function ensure(BlocClass, instanceKey) {
|
|
5
|
-
return globalRegistry.ensure(BlocClass, instanceKey);
|
|
6
|
-
}
|
|
7
|
-
//#endregion
|
|
1
|
+
import { a as BLAC_DEFAULTS } from "./StateContainerRegistry-DOkDGng-.js";
|
|
2
|
+
import { t as ensure } from "./ensure-C5I1xp2C.js";
|
|
3
|
+
import { b as stopTracking, d as createTrackingProxy, f as hasChanges, n as DependencyManager, t as resolveDependencies, u as createState, y as startTracking } from "./resolve-dependencies-BA3u06uC.js";
|
|
8
4
|
//#region src/watch/watch.ts
|
|
9
5
|
const STOP = Symbol("watch.STOP");
|
|
10
6
|
const BLOC_REF_MARKER = Symbol("BlocRef");
|
|
@@ -176,6 +172,6 @@ function createTrackedContext() {
|
|
|
176
172
|
return new TrackedContext();
|
|
177
173
|
}
|
|
178
174
|
//#endregion
|
|
179
|
-
export { watch as a, instance as i, createTrackedContext as n,
|
|
175
|
+
export { watch as a, instance as i, createTrackedContext as n, tracked as r, TrackedContext as t };
|
|
180
176
|
|
|
181
|
-
//# sourceMappingURL=tracked-
|
|
177
|
+
//# sourceMappingURL=tracked-DKduNLgI.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tracked-DKduNLgI.js","names":[],"sources":["../src/watch/watch.ts","../src/tracking/tracked.ts"],"sourcesContent":["import { ensure } from '../registry';\nimport type {\n StateContainerConstructor,\n StateContainerInstance,\n} from '../types/utilities';\nimport { BLAC_DEFAULTS } from '../constants';\nimport {\n createState,\n startTracking,\n stopTracking,\n createTrackingProxy,\n type TrackingProxyState,\n} from '../tracking/tracking-proxy';\nimport { DependencyManager } from '../tracking/dependency-manager';\nimport { resolveDependencies } from '../tracking/resolve-dependencies';\n\nconst STOP: unique symbol = Symbol('watch.STOP');\n\nconst BLOC_REF_MARKER = Symbol('BlocRef');\n\n/**\n * Reference to a specific bloc instance by class and instance ID.\n */\nexport interface BlocRef<T extends StateContainerConstructor> {\n [BLOC_REF_MARKER]: true;\n blocClass: T;\n instanceId: string;\n}\n\n/**\n * Create a reference to a specific bloc instance.\n *\n * @example\n * ```ts\n * watch(instance(UserBloc, 'user-123'), (userBloc) => {\n * console.log(userBloc.state.name);\n * });\n * ```\n */\nexport function instance<T extends StateContainerConstructor>(\n BlocClass: T,\n instanceId: string,\n): BlocRef<T> {\n return {\n [BLOC_REF_MARKER]: true,\n blocClass: BlocClass,\n instanceId,\n };\n}\n\nfunction isBlocRef(\n input: unknown,\n): input is BlocRef<StateContainerConstructor> {\n return (\n typeof input === 'object' && input !== null && BLOC_REF_MARKER in input\n );\n}\n\ntype BlocInput = StateContainerConstructor | BlocRef<StateContainerConstructor>;\n\ntype ExtractInstance<T> =\n T extends BlocRef<infer C>\n ? InstanceType<C>\n : T extends StateContainerConstructor\n ? InstanceType<T>\n : never;\n\ntype ExtractInstances<T extends readonly BlocInput[]> = {\n [K in keyof T]: ExtractInstance<T[K]>;\n};\n\ntype StopSymbol = typeof STOP;\n\n/**\n * Watch function signature for single bloc.\n */\nexport interface WatchSingleFn {\n <T extends StateContainerConstructor>(\n bloc: T | BlocRef<T>,\n callback: (bloc: InstanceType<T>) => void | StopSymbol,\n ): () => void;\n\n STOP: StopSymbol;\n}\n\n/**\n * Watch function signature for multiple blocs.\n */\nexport interface WatchMultipleFn {\n <T extends readonly BlocInput[]>(\n blocs: T,\n callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n ): () => void;\n\n STOP: StopSymbol;\n}\n\n/**\n * Combined watch function type.\n */\nexport interface WatchFn extends WatchSingleFn {\n <T extends readonly BlocInput[]>(\n blocs: T,\n callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n ): () => void;\n}\n\nfunction resolveBloc(input: BlocInput): StateContainerInstance {\n if (isBlocRef(input)) {\n return ensure(input.blocClass, input.instanceId);\n }\n return ensure(input, BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY);\n}\n\nfunction isArray(input: unknown): input is readonly BlocInput[] {\n return Array.isArray(input);\n}\n\n/**\n * Watch one or more blocs for state changes.\n * Automatically tracks state property and getter accesses.\n *\n * @example Single bloc\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n * console.log(userBloc.state.name);\n * console.log(userBloc.fullName); // getter also tracked\n * });\n * ```\n *\n * @example Multiple blocs\n * ```ts\n * const unwatch = watch(\n * [UserBloc, SettingsBloc] as const,\n * ([userBloc, settingsBloc]) => {\n * console.log(userBloc.state.name, settingsBloc.state.theme);\n * }\n * );\n * ```\n *\n * @example With specific instance\n * ```ts\n * const unwatch = watch(\n * instance(UserBloc, 'user-123'),\n * (userBloc) => {\n * console.log(userBloc.state.name);\n * }\n * );\n * ```\n *\n * @example Stop watching from callback\n * ```ts\n * const unwatch = watch(UserBloc, (userBloc) => {\n * if (userBloc.state.done) {\n * return watch.STOP;\n * }\n * });\n * ```\n */\nfunction watchImpl<T extends StateContainerConstructor>(\n bloc: T | BlocRef<T>,\n callback: (bloc: InstanceType<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl<T extends readonly BlocInput[]>(\n blocs: T,\n callback: (blocs: ExtractInstances<T>) => void | StopSymbol,\n): () => void;\n\nfunction watchImpl(\n blocsOrBloc: BlocInput | readonly BlocInput[],\n callback: (blocsOrBloc: any) => void | StopSymbol,\n): () => void {\n const isSingle = !isArray(blocsOrBloc);\n const inputs = isSingle ? [blocsOrBloc] : blocsOrBloc;\n\n const instances = inputs.map(resolveBloc);\n\n const tracker: TrackingProxyState = createState();\n const proxiedInstances = instances.map((inst) =>\n createTrackingProxy(inst, tracker),\n );\n\n const externalDepsManager = new DependencyManager();\n\n let disposed = false;\n const primarySubscriptions: (() => void)[] = [];\n\n const cleanup = () => {\n if (disposed) return;\n disposed = true;\n primarySubscriptions.forEach((unsub) => unsub());\n externalDepsManager.cleanup();\n };\n\n const runCallback = () => {\n if (disposed) return;\n\n startTracking(tracker);\n\n let result: void | StopSymbol;\n try {\n const arg = isSingle ? proxiedInstances[0] : proxiedInstances;\n result = callback(arg);\n } finally {\n const externalDeps = new Set<StateContainerInstance>();\n for (const inst of instances) {\n const deps = stopTracking(tracker, inst);\n for (const dep of deps) {\n externalDeps.add(dep);\n }\n for (const dep of resolveDependencies(inst)) {\n externalDeps.add(dep);\n }\n }\n\n for (const inst of instances) {\n externalDeps.delete(inst);\n }\n\n externalDepsManager.sync(externalDeps, runCallback);\n }\n\n if (result === STOP) {\n cleanup();\n }\n };\n\n const onChange = () => {\n if (disposed) return;\n runCallback();\n };\n\n for (const inst of instances) {\n primarySubscriptions.push(inst.subscribe(onChange));\n }\n\n runCallback();\n\n return cleanup;\n}\n\nexport const watch: WatchFn = Object.assign(watchImpl, { STOP }) as WatchFn;\n","import type { StateContainerInstance } from '../types/utilities';\nimport {\n createState,\n startTracking,\n stopTracking,\n createTrackingProxy,\n hasChanges,\n type TrackingProxyState,\n} from './tracking-proxy';\nimport { DependencyManager } from './dependency-manager';\n\n/**\n * Result of running a tracked callback.\n */\nexport interface TrackedResult<T> {\n result: T;\n dependencies: Set<StateContainerInstance>;\n}\n\n/**\n * Options for the tracked() function.\n */\nexport interface TrackedOptions {\n exclude?: StateContainerInstance;\n}\n\n/**\n * Run a callback while tracking all bloc dependencies accessed.\n * Returns both the result and the set of discovered dependencies.\n *\n * @example\n * ```ts\n * const { result, dependencies } = tracked(() => {\n * const user = ensure(UserBloc);\n * return user.fullName; // getter that may access other blocs\n * });\n * // dependencies contains UserBloc + any blocs accessed in fullName getter\n * ```\n */\nexport function tracked<T>(\n callback: () => T,\n options?: TrackedOptions,\n): TrackedResult<T> {\n const tracker = createState();\n startTracking(tracker);\n\n let result: T;\n try {\n result = callback();\n } finally {\n stopTracking(tracker, { state: null } as any);\n }\n\n const dependencies = new Set(tracker.dependencies);\n\n if (options?.exclude) {\n dependencies.delete(options.exclude);\n }\n\n return { result, dependencies };\n}\n\n/**\n * Context for running tracked callbacks with bloc proxies.\n * Provides methods to create proxies and check for changes.\n */\nexport class TrackedContext {\n private tracker: TrackingProxyState;\n private proxiedBlocs = new WeakMap<\n StateContainerInstance,\n StateContainerInstance\n >();\n private primaryBlocs = new Set<StateContainerInstance>();\n\n constructor() {\n this.tracker = createState();\n }\n\n /**\n * Get a tracking proxy for a bloc instance.\n * The proxy will track state and getter accesses.\n */\n proxy<T extends StateContainerInstance>(bloc: T): T {\n const cached = this.proxiedBlocs.get(bloc);\n if (cached) {\n return cached as T;\n }\n\n const proxied = createTrackingProxy(bloc, this.tracker);\n this.proxiedBlocs.set(bloc, proxied);\n this.primaryBlocs.add(bloc);\n return proxied;\n }\n\n /**\n * Start tracking for a new callback execution.\n */\n start(): void {\n startTracking(this.tracker);\n }\n\n /**\n * Stop tracking and get discovered dependencies.\n * Excludes primary blocs (those explicitly proxied via proxy()).\n */\n stop(): Set<StateContainerInstance> {\n const allDeps = new Set<StateContainerInstance>();\n\n for (const bloc of this.primaryBlocs) {\n const deps = stopTracking(this.tracker, bloc);\n for (const dep of deps) {\n if (!this.primaryBlocs.has(dep)) {\n allDeps.add(dep);\n }\n }\n }\n\n return allDeps;\n }\n\n /**\n * Check if any tracked state or getters have changed.\n */\n changed(): boolean {\n for (const bloc of this.primaryBlocs) {\n if (hasChanges(this.tracker, bloc)) {\n return true;\n }\n }\n return false;\n }\n\n /**\n * Get all primary blocs (those explicitly proxied).\n */\n getPrimaryBlocs(): Set<StateContainerInstance> {\n return new Set(this.primaryBlocs);\n }\n\n /**\n * Reset the context for reuse.\n */\n reset(): void {\n this.tracker = createState();\n this.proxiedBlocs = new WeakMap();\n this.primaryBlocs.clear();\n }\n}\n\n/**\n * Create a new tracked context for manual control over tracking.\n */\nexport function createTrackedContext(): TrackedContext {\n return new TrackedContext();\n}\n\nexport { DependencyManager };\n"],"mappings":"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"}
|
|
@@ -34,7 +34,7 @@ export declare function parsePath(path: string): string[];
|
|
|
34
34
|
*
|
|
35
35
|
* @internal
|
|
36
36
|
*/
|
|
37
|
-
export declare function getValueAtPath(obj:
|
|
37
|
+
export declare function getValueAtPath(obj: unknown, segments: string[]): unknown;
|
|
38
38
|
/**
|
|
39
39
|
* Shallow equality comparison for arrays
|
|
40
40
|
*
|
|
@@ -12,7 +12,7 @@ export declare function isProxyable(value: unknown): value is object;
|
|
|
12
12
|
export interface ProxyState<T> {
|
|
13
13
|
trackedPaths: Set<string>;
|
|
14
14
|
isTracking: boolean;
|
|
15
|
-
proxyCache: WeakMap<object,
|
|
15
|
+
proxyCache: WeakMap<object, unknown>;
|
|
16
16
|
boundFunctionsCache: WeakMap<Function, Function> | null;
|
|
17
17
|
lastProxiedState: T | null;
|
|
18
18
|
lastProxy: T | null;
|
|
@@ -53,7 +53,7 @@ export declare function createForTarget<T>(state: ProxyState<T>, target: T): T;
|
|
|
53
53
|
*/
|
|
54
54
|
export interface PathInfo {
|
|
55
55
|
segments: string[];
|
|
56
|
-
value:
|
|
56
|
+
value: unknown;
|
|
57
57
|
}
|
|
58
58
|
/**
|
|
59
59
|
* @internal
|
|
@@ -64,7 +64,7 @@ export interface DependencyState<T> {
|
|
|
64
64
|
currentRenderPaths: Set<string>;
|
|
65
65
|
pathCache: Map<string, PathInfo>;
|
|
66
66
|
lastCheckedState: T | null;
|
|
67
|
-
lastCheckedValues: Map<string,
|
|
67
|
+
lastCheckedValues: Map<string, unknown>;
|
|
68
68
|
}
|
|
69
69
|
/**
|
|
70
70
|
* @internal
|
package/dist/tracking.cjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
-
const require_resolve_dependencies = require("./resolve-dependencies-
|
|
2
|
+
const require_resolve_dependencies = require("./resolve-dependencies-BT6TU2HF.cjs");
|
|
3
3
|
exports.DependencyManager = require_resolve_dependencies.DependencyManager;
|
|
4
4
|
exports.capturePaths = require_resolve_dependencies.capturePaths;
|
|
5
5
|
exports.clearActiveTracker = require_resolve_dependencies.clearActiveTracker;
|
package/dist/tracking.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { _ as setActiveTracker, a as commitTrackedGetters, c as createDependencyState, g as invalidateRenderCache, h as hasTrackedData, i as clearActiveTracker, l as createGetterState, m as hasGetterChanges, n as DependencyManager, o as createBlocProxy, p as hasDependencyChanges, r as capturePaths, s as createDependencyProxy, t as resolveDependencies, v as startDependency, x as shallowEqual } from "./resolve-dependencies-
|
|
1
|
+
import { _ as setActiveTracker, a as commitTrackedGetters, c as createDependencyState, g as invalidateRenderCache, h as hasTrackedData, i as clearActiveTracker, l as createGetterState, m as hasGetterChanges, n as DependencyManager, o as createBlocProxy, p as hasDependencyChanges, r as capturePaths, s as createDependencyProxy, t as resolveDependencies, v as startDependency, x as shallowEqual } from "./resolve-dependencies-BA3u06uC.js";
|
|
2
2
|
export { DependencyManager, capturePaths, clearActiveTracker, commitTrackedGetters, createBlocProxy, createDependencyProxy, createDependencyState, createGetterState, hasDependencyChanges, hasGetterChanges, hasTrackedData, invalidateRenderCache, resolveDependencies, setActiveTracker, shallowEqual, startDependency };
|
package/dist/types.cjs
CHANGED
package/dist/types.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { t as instanceId } from "./branded-
|
|
1
|
+
import { t as instanceId } from "./branded-Max3xOTA.js";
|
|
2
2
|
export { instanceId };
|
package/dist/watch-entry.cjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
-
const require_tracked = require("./tracked-
|
|
2
|
+
const require_tracked = require("./tracked-DCfBaYjL.cjs");
|
|
3
3
|
exports.TrackedContext = require_tracked.TrackedContext;
|
|
4
4
|
exports.createTrackedContext = require_tracked.createTrackedContext;
|
|
5
5
|
exports.instance = require_tracked.instance;
|
package/dist/watch-entry.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { a as watch, i as instance, n as createTrackedContext, r as tracked, t as TrackedContext } from "./tracked-
|
|
1
|
+
import { a as watch, i as instance, n as createTrackedContext, r as tracked, t as TrackedContext } from "./tracked-DKduNLgI.js";
|
|
2
2
|
export { TrackedContext, createTrackedContext, instance, tracked, watch };
|