@blac/core 2.0.1 → 2.0.4

package/dist/resolve-dependencies.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-dependencies.cjs","names":["BLAC_DEFAULTS","BLAC_ERROR_PREFIX","globalRegistry"],"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: any, segments: string[]): any {\n  if (obj == null) return undefined;\n\n  let current = obj;\n  for (let i = 0; i < segments.length; i++) {\n    current = current[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, any>;\n  // eslint-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, any>(),\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          // eslint-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    return target;\n  }\n\n  if (state.proxyCache.has(target)) {\n    return state.proxyCache.get(target);\n  }\n\n  if (Array.isArray(target)) {\n    return createArrayProxy(\n      state,\n      target as unknown as any[],\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          // eslint-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: any;\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, any>;\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      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  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  Function,\n  Map<string | symbol, PropertyDescriptor | undefined>\n>();\n\nconst blocProxyCache = new WeakMap<StateContainerInstance>();\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    console.warn(\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    return undefined;\n  }\n\n  if (tracker.visitedBlocs.has(target)) {\n    console.warn(\n      `${BLAC_ERROR_PREFIX} Circular dependency detected: getter \"${String(prop)}\" on ${target.constructor.name}.`,\n    );\n    return undefined;\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    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;\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;\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 { globalRegistry } from '../core/StateContainerRegistry';\nimport type {\n  StateContainerConstructor,\n  StateContainerInstance,\n} 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<StateContainerConstructor>();\n  const queue: StateContainerInstance[] = [bloc];\n\n  while (queue.length > 0) {\n    const current = queue.shift()!;\n    for (const [Type, key] of current.dependencies) {\n      if (visited.has(Type)) continue;\n      visited.add(Type);\n      const dep = globalRegistry.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/resolve-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-dependencies.js","names":[],"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: any, segments: string[]): any {\n  if (obj == null) return undefined;\n\n  let current = obj;\n  for (let i = 0; i < segments.length; i++) {\n    current = current[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, any>;\n  // eslint-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, any>(),\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          // eslint-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    return target;\n  }\n\n  if (state.proxyCache.has(target)) {\n    return state.proxyCache.get(target);\n  }\n\n  if (Array.isArray(target)) {\n    return createArrayProxy(\n      state,\n      target as unknown as any[],\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          // eslint-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: any;\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, any>;\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      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  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  Function,\n  Map<string | symbol, PropertyDescriptor | undefined>\n>();\n\nconst blocProxyCache = new WeakMap<StateContainerInstance>();\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    console.warn(\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    return undefined;\n  }\n\n  if (tracker.visitedBlocs.has(target)) {\n    console.warn(\n      `${BLAC_ERROR_PREFIX} Circular dependency detected: getter \"${String(prop)}\" on ${target.constructor.name}.`,\n    );\n    return undefined;\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    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;\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;\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 { globalRegistry } from '../core/StateContainerRegistry';\nimport type {\n  StateContainerConstructor,\n  StateContainerInstance,\n} 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<StateContainerConstructor>();\n  const queue: StateContainerInstance[] = [bloc];\n\n  while (queue.length > 0) {\n    const current = queue.shift()!;\n    for (const [Type, key] of current.dependencies) {\n      if (visited.has(Type)) continue;\n      visited.add(Type);\n      const dep = globalRegistry.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/tracking/dependency-manager.d.ts

@@ -0,0 +1,37 @@
+import type { StateContainerInstance } from '../types/utilities';
+/**
+ * Manages subscriptions to state container dependencies.
+ * Provides efficient sync mechanism to add/remove subscriptions
+ * as dependencies change between callback invocations.
+ */
+export declare class DependencyManager {
+    private subscriptions;
+    private currentDeps;
+    /**
+     * Sync subscriptions with a new set of dependencies.
+     * Adds subscriptions for new deps, removes subscriptions for stale deps.
+     *
+     * @param newDeps - The new set of dependencies to subscribe to
+     * @param onChange - Callback to invoke when any dependency changes
+     * @param exclude - Optional instance to exclude from subscriptions (e.g., primary bloc)
+     * @returns true if the dependency set changed, false if unchanged
+     */
+    sync(newDeps: Set<StateContainerInstance>, onChange: () => void, exclude?: StateContainerInstance): boolean;
+    /**
+     * Add a single dependency subscription.
+     */
+    add(dep: StateContainerInstance, onChange: () => void): void;
+    /**
+     * Check if a dependency is currently subscribed.
+     */
+    has(dep: StateContainerInstance): boolean;
+    /**
+     * Get the current set of dependencies.
+     */
+    getDependencies(): Set<StateContainerInstance>;
+    /**
+     * Clean up all active subscriptions.
+     */
+    cleanup(): void;
+    private areSetsEqual;
+}

package/dist/tracking/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Dependency Tracking
+ *
+ * Framework-agnostic dependency tracking utilities for automatic reactivity.
+ * These utilities are used by framework adapters (React, Vue, Angular, etc.)
+ * to track property accesses and detect changes.
+ *
+ * @packageDocumentation
+ */
+export { type DependencyState, type PathInfo, createDependencyState, startDependency, createDependencyProxy, capturePaths, hasDependencyChanges, hasTrackedData, type GetterState, createGetterState, createBlocProxy, hasGetterChanges, setActiveTracker, clearActiveTracker, commitTrackedGetters, invalidateRenderCache, } from './tracking-proxy';
+export { shallowEqual } from './path-utils';
+export { DependencyManager } from './dependency-manager';
+export { resolveDependencies } from './resolve-dependencies';

package/dist/tracking/path-utils.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Path utilities for dependency tracking
+ *
+ * Provides utilities for parsing property paths and extracting values
+ * from nested objects using path strings.
+ *
+ * @internal
+ */
+/**
+ * Parse a property path string into an array of segments
+ *
+ * @internal
+ *
+ * Handles both dot notation (a.b.c) and bracket notation (a[0].b)
+ *
+ * @example
+ * ```ts
+ * parsePath('user.name') // ['user', 'name']
+ * parsePath('items[0].name') // ['items', '0', 'name']
+ * parsePath('data.users[2].address.city') // ['data', 'users', '2', 'address', 'city']
+ * ```
+ */
+export declare function parsePath(path: string): string[];
+/**
+ * Get a value from an object using a path of segments
+ *
+ * @example
+ * ```ts
+ * const obj = { user: { name: 'Alice', age: 30 } }
+ * getValueAtPath(obj, ['user', 'name']) // 'Alice'
+ * getValueAtPath(obj, ['user', 'age']) // 30
+ * getValueAtPath(obj, ['user', 'missing']) // undefined
+ * ```
+ *
+ * @internal
+ */
+export declare function getValueAtPath(obj: any, segments: string[]): any;
+/**
+ * Shallow equality comparison for arrays
+ *
+ * Compares two arrays element-by-element using Object.is
+ *
+ * @example
+ * ```ts
+ * shallowEqual([1, 2, 3], [1, 2, 3]) // true
+ * shallowEqual([1, 2, 3], [1, 2, 4]) // false
+ * shallowEqual([1, 2], [1, 2, 3]) // false
+ * ```
+ *
+ * @internal
+ */
+export declare function shallowEqual(arr1: unknown[], arr2: unknown[]): boolean;

package/dist/tracking/resolve-dependencies.d.ts

@@ -0,0 +1,7 @@
+import type { StateContainerInstance } from '../types/utilities';
+/**
+ * Resolve all transitive dependencies of a bloc via BFS over `dependencies` maps.
+ * Uses cycle detection to avoid infinite loops.
+ * @internal
+ */
+export declare function resolveDependencies(bloc: StateContainerInstance): Set<StateContainerInstance>;

package/dist/tracking/tracked.d.ts

@@ -0,0 +1,70 @@
+import type { StateContainerInstance } from '../types/utilities';
+import { DependencyManager } from './dependency-manager';
+/**
+ * Result of running a tracked callback.
+ */
+export interface TrackedResult<T> {
+    result: T;
+    dependencies: Set<StateContainerInstance>;
+}
+/**
+ * Options for the tracked() function.
+ */
+export interface TrackedOptions {
+    exclude?: StateContainerInstance;
+}
+/**
+ * Run a callback while tracking all bloc dependencies accessed.
+ * Returns both the result and the set of discovered dependencies.
+ *
+ * @example
+ * ```ts
+ * const { result, dependencies } = tracked(() => {
+ *   const user = ensure(UserBloc);
+ *   return user.fullName; // getter that may access other blocs
+ * });
+ * // dependencies contains UserBloc + any blocs accessed in fullName getter
+ * ```
+ */
+export declare function tracked<T>(callback: () => T, options?: TrackedOptions): TrackedResult<T>;
+/**
+ * Context for running tracked callbacks with bloc proxies.
+ * Provides methods to create proxies and check for changes.
+ */
+export declare class TrackedContext {
+    private tracker;
+    private proxiedBlocs;
+    private primaryBlocs;
+    constructor();
+    /**
+     * Get a tracking proxy for a bloc instance.
+     * The proxy will track state and getter accesses.
+     */
+    proxy<T extends StateContainerInstance>(bloc: T): T;
+    /**
+     * Start tracking for a new callback execution.
+     */
+    start(): void;
+    /**
+     * Stop tracking and get discovered dependencies.
+     * Excludes primary blocs (those explicitly proxied via proxy()).
+     */
+    stop(): Set<StateContainerInstance>;
+    /**
+     * Check if any tracked state or getters have changed.
+     */
+    changed(): boolean;
+    /**
+     * Get all primary blocs (those explicitly proxied).
+     */
+    getPrimaryBlocs(): Set<StateContainerInstance>;
+    /**
+     * Reset the context for reuse.
+     */
+    reset(): void;
+}
+/**
+ * Create a new tracked context for manual control over tracking.
+ */
+export declare function createTrackedContext(): TrackedContext;
+export { DependencyManager };

package/dist/tracking/tracking-proxy.d.ts

@@ -0,0 +1,183 @@
+import type { StateContainerInstance } from '../types/utilities';
+/**
+ * Check if a value can be proxied
+ * Returns true for plain objects and arrays only.
+ * @internal
+ */
+export declare function isProxyable(value: unknown): value is object;
+/**
+ * State container for proxy tracking
+ * @internal
+ */
+export interface ProxyState<T> {
+    trackedPaths: Set<string>;
+    isTracking: boolean;
+    proxyCache: WeakMap<object, any>;
+    boundFunctionsCache: WeakMap<Function, Function> | null;
+    lastProxiedState: T | null;
+    lastProxy: T | null;
+    maxDepth: number;
+}
+/**
+ * Create a new proxy tracker state
+ * @internal
+ */
+export declare function createProxyState<T>(): ProxyState<T>;
+/**
+ * Start tracking property accesses
+ * @internal
+ */
+export declare function startProxy<T>(state: ProxyState<T>): void;
+/**
+ * Stop tracking and return the tracked paths
+ * @internal
+ */
+export declare function stopProxy<T>(state: ProxyState<T>): Set<string>;
+/**
+ * Create a proxy for an array with property access tracking
+ * @internal
+ */
+export declare function createArrayProxy<T, U>(state: ProxyState<T>, target: U[], path: string, depth?: number): U[];
+/**
+ * Create a proxy for an object with property access tracking
+ * @internal
+ */
+export declare function createInternal<T>(state: ProxyState<T>, target: T, path?: string, depth?: number): T;
+/**
+ * Create a proxy for a target with caching
+ * @internal
+ */
+export declare function createForTarget<T>(state: ProxyState<T>, target: T): T;
+/**
+ * @internal
+ */
+export interface PathInfo {
+    segments: string[];
+    value: any;
+}
+/**
+ * @internal
+ */
+export interface DependencyState<T> {
+    proxyState: ProxyState<T>;
+    previousRenderPaths: Set<string>;
+    currentRenderPaths: Set<string>;
+    pathCache: Map<string, PathInfo>;
+    lastCheckedState: T | null;
+    lastCheckedValues: Map<string, any>;
+}
+/**
+ * @internal
+ */
+export declare function optimizeTrackedPaths(paths: Set<string>): Set<string>;
+/**
+ * @internal
+ */
+export declare function createDependencyState<T>(): DependencyState<T>;
+/**
+ * @internal
+ */
+export declare function startDependency<T>(tracker: DependencyState<T>): void;
+/**
+ * @internal
+ */
+export declare function createDependencyProxy<T>(tracker: DependencyState<T>, state: T): T;
+/**
+ * @internal
+ */
+export declare function capturePaths<T>(tracker: DependencyState<T>, state: T): void;
+/**
+ * @internal
+ */
+export declare function hasDependencyChanges<T>(tracker: DependencyState<T>, state: T): boolean;
+/**
+ * @internal
+ */
+export declare function hasTrackedData<T>(tracker: DependencyState<T>): boolean;
+/**
+ * @internal
+ */
+export interface GetterState {
+    trackedValues: Map<string | symbol, unknown>;
+    currentlyAccessing: Set<string | symbol>;
+    trackedGetters: Set<string | symbol>;
+    isTracking: boolean;
+    renderCache: Map<string | symbol, unknown>;
+    cacheValid: boolean;
+    depth: number;
+    visitedBlocs: Set<StateContainerInstance>;
+}
+/**
+ * @internal
+ */
+export declare function getDescriptor(obj: any, prop: string | symbol): PropertyDescriptor | undefined;
+/**
+ * @internal
+ */
+export declare function isGetter(obj: any, prop: string | symbol): boolean;
+/**
+ * @internal
+ */
+export declare function createGetterState(): GetterState;
+/**
+ * @internal
+ */
+export declare function setActiveTracker<TBloc extends StateContainerInstance>(bloc: TBloc, tracker: GetterState): void;
+/**
+ * @internal
+ */
+export declare function clearActiveTracker<TBloc extends StateContainerInstance>(bloc: TBloc): void;
+/**
+ * @internal
+ */
+export declare function getActiveTracker<TBloc extends StateContainerInstance>(bloc: TBloc): GetterState | undefined;
+/**
+ * @internal
+ */
+export declare function commitTrackedGetters(tracker: GetterState): void;
+/**
+ * @internal
+ */
+export declare function createBlocProxy<TBloc extends StateContainerInstance>(bloc: TBloc): TBloc;
+/**
+ * @internal
+ */
+export declare function hasGetterChanges<TBloc extends StateContainerInstance>(bloc: TBloc, tracker: GetterState | null): boolean;
+/**
+ * @internal
+ */
+export declare function invalidateRenderCache(tracker: GetterState): void;
+/**
+ * @internal
+ */
+export declare function resetGetterState(tracker: GetterState): void;
+/**
+ * State for tracking both state property access and getter access.
+ */
+export interface TrackingProxyState {
+    dependencyState: DependencyState<any>;
+    getterState: GetterState;
+    dependencies: Set<StateContainerInstance>;
+    isTracking: boolean;
+}
+/**
+ * Create a new tracking proxy state.
+ */
+export declare function createState(): TrackingProxyState;
+/**
+ * Start tracking on a tracking proxy.
+ */
+export declare function startTracking(tracker: TrackingProxyState): void;
+/**
+ * Stop tracking and collect all dependencies.
+ */
+export declare function stopTracking(tracker: TrackingProxyState, bloc: StateContainerInstance): Set<StateContainerInstance>;
+/**
+ * Check if tracked state or getters have changed.
+ */
+export declare function hasChanges(tracker: TrackingProxyState, bloc: StateContainerInstance): boolean;
+/**
+ * Create a tracking proxy for a bloc instance.
+ * Tracks both state property access and getter access.
+ */
+export declare function createTrackingProxy<T extends StateContainerInstance>(bloc: T, tracker: TrackingProxyState): T;

package/dist/tracking.cjs

@@ -0,0 +1,18 @@
+const require_resolve_dependencies = require('./resolve-dependencies.cjs');
+
+exports.DependencyManager = require_resolve_dependencies.DependencyManager;
+exports.capturePaths = require_resolve_dependencies.capturePaths;
+exports.clearActiveTracker = require_resolve_dependencies.clearActiveTracker;
+exports.commitTrackedGetters = require_resolve_dependencies.commitTrackedGetters;
+exports.createBlocProxy = require_resolve_dependencies.createBlocProxy;
+exports.createDependencyProxy = require_resolve_dependencies.createDependencyProxy;
+exports.createDependencyState = require_resolve_dependencies.createDependencyState;
+exports.createGetterState = require_resolve_dependencies.createGetterState;
+exports.hasDependencyChanges = require_resolve_dependencies.hasDependencyChanges;
+exports.hasGetterChanges = require_resolve_dependencies.hasGetterChanges;
+exports.hasTrackedData = require_resolve_dependencies.hasTrackedData;
+exports.invalidateRenderCache = require_resolve_dependencies.invalidateRenderCache;
+exports.resolveDependencies = require_resolve_dependencies.resolveDependencies;
+exports.setActiveTracker = require_resolve_dependencies.setActiveTracker;
+exports.shallowEqual = require_resolve_dependencies.shallowEqual;
+exports.startDependency = require_resolve_dependencies.startDependency;

package/dist/tracking.d.cts

@@ -0,0 +1,9 @@
+/**
+ * Tracking Subpath Export
+ *
+ * Dependency tracking utilities for framework adapters (React, Vue, etc.).
+ * Import from '@blac/core/tracking'
+ *
+ * @packageDocumentation
+ */
+export * from './tracking/index';

package/dist/tracking.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tracking Subpath Export
+ *
+ * Dependency tracking utilities for framework adapters (React, Vue, etc.).
+ * Import from '@blac/core/tracking'
+ *
+ * @packageDocumentation
+ */
+export * from './tracking/index';

package/dist/tracking.js

@@ -0,0 +1,3 @@
+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.js";
+
+export { DependencyManager, capturePaths, clearActiveTracker, commitTrackedGetters, createBlocProxy, createDependencyProxy, createDependencyState, createGetterState, hasDependencyChanges, hasGetterChanges, hasTrackedData, invalidateRenderCache, resolveDependencies, setActiveTracker, shallowEqual, startDependency };

package/dist/types.cjs

@@ -0,0 +1,14 @@
+
+//#region src/types/branded.ts
+/**
+* Create a branded InstanceId from a string
+* @param id - The string ID to brand
+* @returns Branded InstanceId
+*/
+function instanceId(id) {
+	return id;
+}
+
+//#endregion
+exports.instanceId = instanceId;
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","names":[],"sources":["../src/types/branded.ts"],"sourcesContent":["declare const brand: unique symbol;\n\n/**\n * Utility type for creating branded/nominal types.\n * Prevents accidental type confusion between similar primitive types.\n * @template T - The base type\n * @template B - The brand identifier\n */\nexport type Brand<T, B> = T & { [brand]: B };\n\n/**\n * Branded string type for type-safe IDs.\n * @template B - The brand identifier\n */\nexport type BrandedId<B> = Brand<string, B>;\n\n/**\n * Branded string type for state container instance IDs\n */\nexport type InstanceId = Brand<string, 'InstanceId'>;\n\n/**\n * Create a branded InstanceId from a string\n * @param id - The string ID to brand\n * @returns Branded InstanceId\n */\nexport function instanceId(id: string): InstanceId {\n  return id as InstanceId;\n}\n"],"mappings":";;;;;;;AA0BA,SAAgB,WAAW,IAAwB;AACjD,QAAO"}

package/dist/types.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Branded Types Subpath Export
+ *
+ * Advanced type utilities for creating nominal/branded types.
+ * Import from '@blac/core/types'
+ */
+export type { Brand, BrandedId, InstanceId } from './types/branded';
+export { instanceId } from './types/branded';

package/dist/types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Branded Types Subpath Export
+ *
+ * Advanced type utilities for creating nominal/branded types.
+ * Import from '@blac/core/types'
+ */
+export type { Brand, BrandedId, InstanceId } from './types/branded';
+export { instanceId } from './types/branded';