@blac/react 2.0.15 → 2.0.17

package/dist/testing.d.cts

@@ -1,11 +1,12 @@
 import type { ReactElement } from 'react';
 import type { RenderResult } from '@testing-library/react';
-import type { StateContainerConstructor } from '@blac/core';
+import type { ExtractArgs, StateContainerConstructor } from '@blac/core';
 import { StateContainerRegistry } from '@blac/core';
 import { type CubitStubOptions } from '@blac/core/testing';
 interface RenderWithBlocOptions<T extends StateContainerConstructor> extends CubitStubOptions<T> {
     bloc: T;
-    instanceKey?: string;
+    /** Args used to resolve which instance the stub is registered under. */
+    args?: ExtractArgs<T>;
 }
 export declare function renderWithBloc<T extends StateContainerConstructor>(ui: ReactElement, options: RenderWithBlocOptions<T>): RenderResult & {
     bloc: InstanceType<T>;

package/dist/testing.d.ts

@@ -1,11 +1,12 @@
 import type { ReactElement } from 'react';
 import type { RenderResult } from '@testing-library/react';
-import type { StateContainerConstructor } from '@blac/core';
+import type { ExtractArgs, StateContainerConstructor } from '@blac/core';
 import { StateContainerRegistry } from '@blac/core';
 import { type CubitStubOptions } from '@blac/core/testing';
 interface RenderWithBlocOptions<T extends StateContainerConstructor> extends CubitStubOptions<T> {
     bloc: T;
-    instanceKey?: string;
+    /** Args used to resolve which instance the stub is registered under. */
+    args?: ExtractArgs<T>;
 }
 export declare function renderWithBloc<T extends StateContainerConstructor>(ui: ReactElement, options: RenderWithBlocOptions<T>): RenderResult & {
     bloc: InstanceType<T>;

package/dist/testing.js

@@ -3,11 +3,14 @@ import { createCubitStub, registerOverride } from "@blac/core/testing";
 import { render } from "@testing-library/react";
 //#region src/testing.ts
 function renderWithBloc(ui, options) {
-	const { bloc: BlocClass, instanceKey, ...stubOptions } = options;
+	const { bloc: BlocClass, args, ...stubOptions } = options;
 	const previous = getRegistry();
 	setRegistry(new StateContainerRegistry());
-	const instance = createCubitStub(BlocClass, stubOptions);
-	registerOverride(BlocClass, instance, instanceKey);
+	const instance = createCubitStub(BlocClass, {
+		...stubOptions,
+		args
+	});
+	registerOverride(BlocClass, instance, args);
 	let renderResult;
 	try {
 		renderResult = render(ui);

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import type { ReactElement } from 'react';\nimport type { RenderResult } from '@testing-library/react';\nimport type { StateContainerConstructor } from '@blac/core';\nimport { StateContainerRegistry, getRegistry, setRegistry } from '@blac/core';\nimport {\n  registerOverride,\n  createCubitStub,\n  type CubitStubOptions,\n} from '@blac/core/testing';\nimport { render } from '@testing-library/react';\n\ninterface RenderWithBlocOptions<\n  T extends StateContainerConstructor,\n> extends CubitStubOptions<T> {\n  bloc: T;\n  instanceKey?: string;\n}\n\nexport function renderWithBloc<T extends StateContainerConstructor>(\n  ui: ReactElement,\n  options: RenderWithBlocOptions<T>,\n): RenderResult & { bloc: InstanceType<T> } {\n  const { bloc: BlocClass, instanceKey, ...stubOptions } = options;\n\n  const previous = getRegistry();\n  const testRegistry = new StateContainerRegistry();\n  setRegistry(testRegistry);\n\n  const instance = createCubitStub(BlocClass, stubOptions);\n  registerOverride(BlocClass, instance, instanceKey);\n\n  let renderResult: RenderResult;\n  try {\n    renderResult = render(ui);\n  } catch (e) {\n    setRegistry(previous);\n    throw e;\n  }\n\n  const originalUnmount = renderResult.unmount;\n  renderResult.unmount = () => {\n    originalUnmount();\n    setRegistry(previous);\n  };\n\n  return {\n    ...renderResult,\n    bloc: instance,\n  };\n}\n\nexport function renderWithRegistry(\n  ui: ReactElement,\n  setup: (registry: StateContainerRegistry) => void,\n): RenderResult {\n  const previous = getRegistry();\n  const testRegistry = new StateContainerRegistry();\n  setRegistry(testRegistry);\n\n  try {\n    setup(testRegistry);\n  } catch (e) {\n    setRegistry(previous);\n    throw e;\n  }\n\n  let renderResult: RenderResult;\n  try {\n    renderResult = render(ui);\n  } catch (e) {\n    setRegistry(previous);\n    throw e;\n  }\n\n  const originalUnmount = renderResult.unmount;\n  renderResult.unmount = () => {\n    originalUnmount();\n    setRegistry(previous);\n  };\n\n  return renderResult;\n}\n"],"mappings":";;;;AAkBA,SAAgB,eACd,IACA,SAC0C;CAC1C,MAAM,EAAE,MAAM,WAAW,aAAa,GAAG,gBAAgB;CAEzD,MAAM,WAAW,aAAa;CAE9B,YAAY,IADa,wBACD,CAAC;CAEzB,MAAM,WAAW,gBAAgB,WAAW,YAAY;CACxD,iBAAiB,WAAW,UAAU,YAAY;CAElD,IAAI;CACJ,IAAI;EACF,eAAe,OAAO,GAAG;UAClB,GAAG;EACV,YAAY,SAAS;EACrB,MAAM;;CAGR,MAAM,kBAAkB,aAAa;CACrC,aAAa,gBAAgB;EAC3B,iBAAiB;EACjB,YAAY,SAAS;;CAGvB,OAAO;EACL,GAAG;EACH,MAAM;EACP;;AAGH,SAAgB,mBACd,IACA,OACc;CACd,MAAM,WAAW,aAAa;CAC9B,MAAM,eAAe,IAAI,wBAAwB;CACjD,YAAY,aAAa;CAEzB,IAAI;EACF,MAAM,aAAa;UACZ,GAAG;EACV,YAAY,SAAS;EACrB,MAAM;;CAGR,IAAI;CACJ,IAAI;EACF,eAAe,OAAO,GAAG;UAClB,GAAG;EACV,YAAY,SAAS;EACrB,MAAM;;CAGR,MAAM,kBAAkB,aAAa;CACrC,aAAa,gBAAgB;EAC3B,iBAAiB;EACjB,YAAY,SAAS;;CAGvB,OAAO"}
+{"version":3,"file":"testing.js","names":[],"sources":["../src/testing.ts"],"sourcesContent":["import type { ReactElement } from 'react';\nimport type { RenderResult } from '@testing-library/react';\nimport type { ExtractArgs, StateContainerConstructor } from '@blac/core';\nimport { StateContainerRegistry, getRegistry, setRegistry } from '@blac/core';\nimport {\n  registerOverride,\n  createCubitStub,\n  type CubitStubOptions,\n} from '@blac/core/testing';\nimport { render } from '@testing-library/react';\n\ninterface RenderWithBlocOptions<\n  T extends StateContainerConstructor,\n> extends CubitStubOptions<T> {\n  bloc: T;\n  /** Args used to resolve which instance the stub is registered under. */\n  args?: ExtractArgs<T>;\n}\n\nexport function renderWithBloc<T extends StateContainerConstructor>(\n  ui: ReactElement,\n  options: RenderWithBlocOptions<T>,\n): RenderResult & { bloc: InstanceType<T> } {\n  const { bloc: BlocClass, args, ...stubOptions } = options;\n\n  const previous = getRegistry();\n  const testRegistry = new StateContainerRegistry();\n  setRegistry(testRegistry);\n\n  // Pass args explicitly so createCubitStub calls initConfig → init().\n  const instance = createCubitStub(BlocClass, { ...stubOptions, args } as any);\n  registerOverride(BlocClass, instance, args);\n\n  let renderResult: RenderResult;\n  try {\n    renderResult = render(ui);\n  } catch (e) {\n    setRegistry(previous);\n    throw e;\n  }\n\n  const originalUnmount = renderResult.unmount;\n  renderResult.unmount = () => {\n    originalUnmount();\n    setRegistry(previous);\n  };\n\n  return {\n    ...renderResult,\n    bloc: instance,\n  };\n}\n\nexport function renderWithRegistry(\n  ui: ReactElement,\n  setup: (registry: StateContainerRegistry) => void,\n): RenderResult {\n  const previous = getRegistry();\n  const testRegistry = new StateContainerRegistry();\n  setRegistry(testRegistry);\n\n  try {\n    setup(testRegistry);\n  } catch (e) {\n    setRegistry(previous);\n    throw e;\n  }\n\n  let renderResult: RenderResult;\n  try {\n    renderResult = render(ui);\n  } catch (e) {\n    setRegistry(previous);\n    throw e;\n  }\n\n  const originalUnmount = renderResult.unmount;\n  renderResult.unmount = () => {\n    originalUnmount();\n    setRegistry(previous);\n  };\n\n  return renderResult;\n}\n"],"mappings":";;;;AAmBA,SAAgB,eACd,IACA,SAC0C;CAC1C,MAAM,EAAE,MAAM,WAAW,MAAM,GAAG,gBAAgB;CAElD,MAAM,WAAW,YAAY;CAE7B,YAAY,IADa,uBACF,CAAC;CAGxB,MAAM,WAAW,gBAAgB,WAAW;EAAE,GAAG;EAAa;CAAK,CAAQ;CAC3E,iBAAiB,WAAW,UAAU,IAAI;CAE1C,IAAI;CACJ,IAAI;EACF,eAAe,OAAO,EAAE;CAC1B,SAAS,GAAG;EACV,YAAY,QAAQ;EACpB,MAAM;CACR;CAEA,MAAM,kBAAkB,aAAa;CACrC,aAAa,gBAAgB;EAC3B,gBAAgB;EAChB,YAAY,QAAQ;CACtB;CAEA,OAAO;EACL,GAAG;EACH,MAAM;CACR;AACF;AAEA,SAAgB,mBACd,IACA,OACc;CACd,MAAM,WAAW,YAAY;CAC7B,MAAM,eAAe,IAAI,uBAAuB;CAChD,YAAY,YAAY;CAExB,IAAI;EACF,MAAM,YAAY;CACpB,SAAS,GAAG;EACV,YAAY,QAAQ;EACpB,MAAM;CACR;CAEA,IAAI;CACJ,IAAI;EACF,eAAe,OAAO,EAAE;CAC1B,SAAS,GAAG;EACV,YAAY,QAAQ;EACpB,MAAM;CACR;CAEA,MAAM,kBAAkB,aAAa;CACrC,aAAa,gBAAgB;EAC3B,gBAAgB;EAChB,YAAY,QAAQ;CACtB;CAEA,OAAO;AACT"}

package/dist/types.d.ts

@@ -1,13 +1,16 @@
 import type { ExtractArgs, ExtractState, InstanceReadonlyState, StateContainerConstructor } from '@blac/core';
 import type { RefObject } from 'react';
 /**
- * Conditional `args` field: required when the bloc declares Args, forbidden
- * (type `never`) when the bloc uses the default `void` Args.
+ * Conditional `args` field:
+ * - When the bloc uses the default `void` Args: args is forbidden (type `never`).
+ * - When the bloc declares Args: args is optional (may be inherited from a
+ *   `BlocProvider` ancestor at runtime; omitting it resolves to the provider
+ *   args or the default key).
  */
 type ArgsOption<T extends StateContainerConstructor> = ExtractArgs<T> extends void ? {
     args?: never;
 } : {
-    args: ExtractArgs<T>;
+    args?: ExtractArgs<T>;
 };
 /**
  * Configuration options for {@link useBloc}.
@@ -15,16 +18,15 @@ type ArgsOption<T extends StateContainerConstructor> = ExtractArgs<T> extends vo
  * @template TBloc - The state container constructor type
  *
  * @remarks
+ * Instance identity is derived entirely from `args`. For a per-mount private
+ * instance (like the old `instanceId: useId()` pattern) pass a stable unique
+ * object: `{ args: { _id: useId() } }`.
+ *
  * The `dependencies` option from BlaC v1 has been removed — use `select`
  * instead. Codemod: rename `dependencies` → `select`; the return value is
  * still a tuple/array compared per-index via `Object.is`.
  */
 export type UseBlocOptions<TBloc extends StateContainerConstructor> = ArgsOption<TBloc> & {
-    /**
-     * Per-consumer instance identifier. Overrides any `instanceId` provided
-     * by an ancestor {@link BlocProvider}.
-     */
-    instanceId?: string | number;
     /**
      * Per-consumer re-render selector. When provided, the hook re-renders
      * only when the returned array's elements change (Object.is per index).

package/dist/useBloc.d.ts

@@ -15,12 +15,19 @@ import type { UseBlocOptions, UseBlocReturn } from './types';
  *
  * Lifecycle:
  * - The bloc is acquired from the registry on mount and released on
- *   unmount. The instance key is the explicit `options.instanceId`, then
- *   the surrounding {@link BlocProvider} context, then the default key.
+ *   unmount. The instance key is derived from `options.args` (own args),
+ *   then the surrounding {@link BlocProvider} context args for this bloc,
+ *   then the default key (no args).
  * - `options.onMount` fires after the bloc is acquired; `options.onUnmount`
  *   fires *before* the registry releases its ref, so the bloc is still
  *   alive when the callback runs.
  *
+ * Per-mount private instance:
+ * ```ts
+ * const id = useId();
+ * const [state, bloc] = useBloc(MyBloc, { args: { _id: id } });
+ * ```
+ *
  * @template T - The state container constructor type (inferred from BlocClass)
  * @param BlocClass - The state container class to connect to
  * @param options - Configuration options
@@ -38,9 +45,9 @@ import type { UseBlocOptions, UseBlocReturn } from './types';
  * });
  * ```
  *
- * @example Named instance
+ * @example Args-based shared instance
  * ```ts
- * const [state, bloc] = useBloc(MyBloc, { instanceId: 'cart-42' });
+ * const [state, bloc] = useBloc(UserBloc, { args: { userId: 'alice' } });
  * ```
  */
 export declare function useBloc<T extends StateContainerConstructor = StateContainerConstructor>(BlocClass: T, options?: UseBlocOptions<T>): UseBlocReturn<T, ExtractState<T>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blac/react",
-  "version": "2.0.15",
+  "version": "2.0.17",
   "license": "MIT",
   "author": "Brendan Mullins <jsnanigans@gmail.com>",
   "description": "React bindings for BlaC — useBloc hook with automatic re-render optimization",
@@ -64,14 +64,27 @@
     "bloc",
     "bloc-pattern"
   ],
+  "size-limit": [
+    {
+      "name": "@blac/react (ESM, brotli, excl. peers)",
+      "path": "dist/index.js",
+      "limit": "3.5 kB",
+      "ignore": [
+        "react",
+        "react-dom",
+        "@blac/core",
+        "@types/react"
+      ]
+    }
+  ],
   "dependencies": {
-    "@dirtytalk/structural": "^0.0.3"
+    "@dirtytalk/structural": "^0.0.5"
   },
   "peerDependencies": {
     "@testing-library/react": "^14.0.0 || ^15.0.0 || ^16.0.0",
     "@types/react": "^18.0.0 || ^19.0.0",
     "react": "^18.0.0 || ^19.0.0",
-    "@blac/core": "^2.0.15"
+    "@blac/core": "^2.0.17"
   },
   "peerDependenciesMeta": {
     "@types/react": {
@@ -85,24 +98,29 @@
     }
   },
   "devDependencies": {
+    "@size-limit/preset-small-lib": "^11.1.6",
+    "size-limit": "^11.1.6",
+    "@babel/core": "^7.28.0",
+    "@rolldown/plugin-babel": "^0.2.3",
     "@testing-library/dom": "^10.4.1",
-    "@testing-library/jest-dom": "^6.6.4",
-    "@testing-library/react": "^16.3.0",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
-    "@types/react": "^19.1.9",
-    "@types/react-dom": "^19.1.7",
-    "@vitejs/plugin-react": "^4.7.0",
+    "@types/babel__core": "^7.20.5",
+    "@types/react": "^19.2.15",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.2",
     "babel-plugin-react-compiler": "^1.0.0",
-    "happy-dom": "^18.0.1",
-    "jsdom": "^26.1.0",
-    "publint": "^0.3.12",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
-    "typescript": "^5.9.2",
+    "happy-dom": "^20.9.0",
+    "jsdom": "^29.1.1",
+    "publint": "^0.3.21",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "typescript": "^6.0.3",
     "vite": "npm:@voidzero-dev/vite-plus-core@latest",
+    "vite-plus": "^0.1.23",
     "vitest": "npm:@voidzero-dev/vite-plus-test@latest",
-    "vite-plus": "latest",
-    "@blac/core": "2.0.15"
+    "@blac/core": "2.0.17"
   },
   "scripts": {
     "dev": "vp pack --watch",
@@ -121,6 +139,7 @@
     "test:both": "pnpm test && echo '\n\n=== Running tests WITH React Compiler ===\n' && pnpm test:compiler",
     "verify": "node ../../scripts/run-workspace-bin.mjs publint",
     "typecheck": "tsc --noEmit",
+    "size": "size-limit",
     "deploy": "pnpm publish --access public"
   }
 }