@blac/react 2.0.0-rc.6 → 2.0.0-rc.8

package/dist/index.d.cts

@@ -1,154 +1,12 @@
-import { AnyObject, BlocConstructor, ExtractState, StateContainer } from "@blac/core";
-import { RefObject } from "react";
-
-//#region src/types.d.ts
-
 /**
- * Configuration options for the useBloc hook
+ * React Integration
  *
- * @template TBloc - The StateContainer type
- *
- * @example
- * ```tsx
- * const [state, bloc] = useBloc(CounterBloc, {
- *   staticProps: { initialCount: 0 },
- *   dependencies: (state) => [state.count],
- *   onMount: (bloc) => console.log('Mounted'),
- * });
- * ```
- */
-interface UseBlocOptions<TBloc extends StateContainer<AnyObject>> {
-  /**
-   * Static props to pass to the Bloc constructor
-   * Type should match the constructor's first parameter
-   */
-  staticProps?: AnyObject;
-  /**
-   * Custom instance ID for shared blocs
-   * - For isolated blocs, each useBloc call gets its own instance
-   * - For shared blocs, the same instanceId will share the same bloc instance
-   */
-  instanceId?: string;
-  /**
-   * Manual dependency tracking function
-   * - When provided, automatic proxy tracking is disabled
-   * - Component only re-renders when the returned values change (shallow equality)
-   *
-   * @param state - Current state of the bloc
-   * @param bloc - The bloc instance
-   * @returns Array of values to track
-   */
-  dependencies?: (state: ExtractState<TBloc>, bloc: TBloc) => unknown[];
-  /**
-   * Control automatic dependency tracking (default: true)
-   * - true: Automatically track accessed properties via Proxy
-   * - false: Disable tracking, all state changes trigger re-render
-   * - Ignored when `dependencies` option is provided
-   *
-   * @default true
-   */
-  autoTrack?: boolean;
-  /**
-   * Callback invoked when the component mounts
-   *
-   * @param bloc - The bloc instance
-   */
-  onMount?: (bloc: TBloc) => void;
-  /**
-   * Callback invoked when the component unmounts
-   *
-   * @param bloc - The bloc instance
-   */
-  onUnmount?: (bloc: TBloc) => void;
-}
-/**
- * Return type of the useBloc hook
- *
- * @template TBloc - The StateContainer type
- *
- * @returns A tuple containing:
- * - [0]: The current state (may be a Proxy for tracking)
- * - [1]: The bloc instance with methods
- * - [2]: Component ref (internal use only)
- */
-type UseBlocReturn<TBloc extends StateContainer<AnyObject>> = [ExtractState<TBloc>, TBloc, RefObject<ComponentRef>];
-/**
- * @internal
- * Component reference object for internal tracking
- * Used to persist instance IDs across React Strict Mode remounts
- */
-type ComponentRef = {
-  __blocInstanceId?: string;
-  __bridge?: any;
-};
-//#endregion
-//#region src/useBloc.d.ts
-/**
- * Lifecycle: INITIAL MOUNT
- * 1. useMemo runs once - creates bloc, subscribeFn, getSnapshotFn
- * 2. useSyncExternalStore calls getSnapshotFn (1st time) - lazy creates tracker, starts tracking, returns proxy
- * 3. Component renders - proxy tracks property accesses
- * 4. useSyncExternalStore calls getSnapshotFn (2nd time) - captures tracked paths, starts new tracking, returns proxy
- * 5. useSyncExternalStore calls subscribeFn - sets up state change listener
- *
- * Lifecycle: STATE CHANGE
- * 1. Bloc state changes
- * 2. subscribeFn callback checks hasChanges() - only re-renders if tracked paths changed
- * 3. If re-render: getSnapshotFn captures previous paths, starts tracking, returns proxy
- *
- * Lifecycle: RE-RENDER (parent re-render)
- * 1. useMemo returns cached values (same bloc, subscribeFn, getSnapshotFn)
- * 2. useSyncExternalStore calls getSnapshotFn - captures paths, starts tracking, returns proxy
- */
-declare function useBloc<TBloc extends StateContainer<AnyObject>>(BlocClass: BlocConstructor<TBloc>, options?: UseBlocOptions<TBloc>): UseBlocReturn<TBloc>;
-//#endregion
-//#region src/useBlocActions.d.ts
-/**
- * Configuration options for the useBlocActions hook
- *
- * @template TBloc - The StateContainer type
- */
-interface UseBlocActionsOptions<TBloc extends StateContainer<AnyObject>> {
-  /**
-   * Static props to pass to the Bloc constructor
-   * Type should match the constructor's first parameter
-   */
-  staticProps?: AnyObject;
-  /**
-   * Custom instance ID for shared blocs
-   * - For isolated blocs, each useBlocActions call gets its own instance
-   * - For shared blocs, the same instanceId will share the same bloc instance
-   */
-  instanceId?: string;
-  /**
-   * Callback invoked when the component mounts
-   *
-   * @param bloc - The bloc instance
-   */
-  onMount?: (bloc: TBloc) => void;
-  /**
-   * Callback invoked when the component unmounts
-   *
-   * @param bloc - The bloc instance
-   */
-  onUnmount?: (bloc: TBloc) => void;
-}
-/**
- * React hook for accessing bloc instance without state subscription.
- * Use this when you only need to call bloc methods/actions without reading state.
- *
- * Benefits over useBloc:
- * - No state subscription overhead
- * - No proxy tracking
- * - Component never re-renders due to bloc state changes
- * - Lighter weight for action-only components
- *
- * @template TBloc - The StateContainer type
- * @param BlocClass - The bloc class constructor
- * @param options - Optional configuration
- * @returns The bloc instance
+ * Clean integration between React and StateContainer architecture.
+ * Constructor-based API with automatic type inference.
+ * Supports concurrent (useSyncExternalStore) mode for optimal performance.
  */
-declare function useBlocActions<TBloc extends StateContainer<AnyObject>>(BlocClass: BlocConstructor<TBloc>, options?: UseBlocActionsOptions<TBloc>): TBloc;
-//#endregion
-export { type UseBlocActionsOptions, type UseBlocOptions, type UseBlocReturn, useBloc, useBlocActions };
-//# sourceMappingURL=index.d.cts.map
+export { useBloc } from './useBloc';
+export { useBlocActions } from './useBlocActions';
+export type { UseBlocOptions, UseBlocReturn } from './types';
+export type { UseBlocActionsOptions } from './useBlocActions';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -1,154 +1,12 @@
-import { RefObject } from "react";
-import { AnyObject, BlocConstructor, ExtractState, StateContainer } from "@blac/core";
-
-//#region src/types.d.ts
-
 /**
- * Configuration options for the useBloc hook
+ * React Integration
  *
- * @template TBloc - The StateContainer type
- *
- * @example
- * ```tsx
- * const [state, bloc] = useBloc(CounterBloc, {
- *   staticProps: { initialCount: 0 },
- *   dependencies: (state) => [state.count],
- *   onMount: (bloc) => console.log('Mounted'),
- * });
- * ```
- */
-interface UseBlocOptions<TBloc extends StateContainer<AnyObject>> {
-  /**
-   * Static props to pass to the Bloc constructor
-   * Type should match the constructor's first parameter
-   */
-  staticProps?: AnyObject;
-  /**
-   * Custom instance ID for shared blocs
-   * - For isolated blocs, each useBloc call gets its own instance
-   * - For shared blocs, the same instanceId will share the same bloc instance
-   */
-  instanceId?: string;
-  /**
-   * Manual dependency tracking function
-   * - When provided, automatic proxy tracking is disabled
-   * - Component only re-renders when the returned values change (shallow equality)
-   *
-   * @param state - Current state of the bloc
-   * @param bloc - The bloc instance
-   * @returns Array of values to track
-   */
-  dependencies?: (state: ExtractState<TBloc>, bloc: TBloc) => unknown[];
-  /**
-   * Control automatic dependency tracking (default: true)
-   * - true: Automatically track accessed properties via Proxy
-   * - false: Disable tracking, all state changes trigger re-render
-   * - Ignored when `dependencies` option is provided
-   *
-   * @default true
-   */
-  autoTrack?: boolean;
-  /**
-   * Callback invoked when the component mounts
-   *
-   * @param bloc - The bloc instance
-   */
-  onMount?: (bloc: TBloc) => void;
-  /**
-   * Callback invoked when the component unmounts
-   *
-   * @param bloc - The bloc instance
-   */
-  onUnmount?: (bloc: TBloc) => void;
-}
-/**
- * Return type of the useBloc hook
- *
- * @template TBloc - The StateContainer type
- *
- * @returns A tuple containing:
- * - [0]: The current state (may be a Proxy for tracking)
- * - [1]: The bloc instance with methods
- * - [2]: Component ref (internal use only)
- */
-type UseBlocReturn<TBloc extends StateContainer<AnyObject>> = [ExtractState<TBloc>, TBloc, RefObject<ComponentRef>];
-/**
- * @internal
- * Component reference object for internal tracking
- * Used to persist instance IDs across React Strict Mode remounts
- */
-type ComponentRef = {
-  __blocInstanceId?: string;
-  __bridge?: any;
-};
-//#endregion
-//#region src/useBloc.d.ts
-/**
- * Lifecycle: INITIAL MOUNT
- * 1. useMemo runs once - creates bloc, subscribeFn, getSnapshotFn
- * 2. useSyncExternalStore calls getSnapshotFn (1st time) - lazy creates tracker, starts tracking, returns proxy
- * 3. Component renders - proxy tracks property accesses
- * 4. useSyncExternalStore calls getSnapshotFn (2nd time) - captures tracked paths, starts new tracking, returns proxy
- * 5. useSyncExternalStore calls subscribeFn - sets up state change listener
- *
- * Lifecycle: STATE CHANGE
- * 1. Bloc state changes
- * 2. subscribeFn callback checks hasChanges() - only re-renders if tracked paths changed
- * 3. If re-render: getSnapshotFn captures previous paths, starts tracking, returns proxy
- *
- * Lifecycle: RE-RENDER (parent re-render)
- * 1. useMemo returns cached values (same bloc, subscribeFn, getSnapshotFn)
- * 2. useSyncExternalStore calls getSnapshotFn - captures paths, starts tracking, returns proxy
- */
-declare function useBloc<TBloc extends StateContainer<AnyObject>>(BlocClass: BlocConstructor<TBloc>, options?: UseBlocOptions<TBloc>): UseBlocReturn<TBloc>;
-//#endregion
-//#region src/useBlocActions.d.ts
-/**
- * Configuration options for the useBlocActions hook
- *
- * @template TBloc - The StateContainer type
- */
-interface UseBlocActionsOptions<TBloc extends StateContainer<AnyObject>> {
-  /**
-   * Static props to pass to the Bloc constructor
-   * Type should match the constructor's first parameter
-   */
-  staticProps?: AnyObject;
-  /**
-   * Custom instance ID for shared blocs
-   * - For isolated blocs, each useBlocActions call gets its own instance
-   * - For shared blocs, the same instanceId will share the same bloc instance
-   */
-  instanceId?: string;
-  /**
-   * Callback invoked when the component mounts
-   *
-   * @param bloc - The bloc instance
-   */
-  onMount?: (bloc: TBloc) => void;
-  /**
-   * Callback invoked when the component unmounts
-   *
-   * @param bloc - The bloc instance
-   */
-  onUnmount?: (bloc: TBloc) => void;
-}
-/**
- * React hook for accessing bloc instance without state subscription.
- * Use this when you only need to call bloc methods/actions without reading state.
- *
- * Benefits over useBloc:
- * - No state subscription overhead
- * - No proxy tracking
- * - Component never re-renders due to bloc state changes
- * - Lighter weight for action-only components
- *
- * @template TBloc - The StateContainer type
- * @param BlocClass - The bloc class constructor
- * @param options - Optional configuration
- * @returns The bloc instance
+ * Clean integration between React and StateContainer architecture.
+ * Constructor-based API with automatic type inference.
+ * Supports concurrent (useSyncExternalStore) mode for optimal performance.
  */
-declare function useBlocActions<TBloc extends StateContainer<AnyObject>>(BlocClass: BlocConstructor<TBloc>, options?: UseBlocActionsOptions<TBloc>): TBloc;
-//#endregion
-export { type UseBlocActionsOptions, type UseBlocOptions, type UseBlocReturn, useBloc, useBlocActions };
+export { useBloc } from './useBloc';
+export { useBlocActions } from './useBlocActions';
+export type { UseBlocOptions, UseBlocReturn } from './types';
+export type { UseBlocActionsOptions } from './useBlocActions';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}