@blac/core 2.0.4 → 2.0.6

package/dist/types.cjs

@@ -1,14 +1,3 @@
-
-//#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
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_branded = require("./branded-DndTHjv2.cjs");
+exports.instanceId = require_branded.instanceId;

package/dist/types.js

@@ -1,13 +1,2 @@
-//#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
+import { t as instanceId } from "./branded-mwGzzPF1.js";
 export { instanceId };
-//# sourceMappingURL=types.js.map

package/dist/utils/idGenerator.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Centralized ID Generation
+ *
+ * Provides consistent, collision-resistant ID generation for all BlaC subsystems.
+ * Uses timestamp + counter + random suffix for uniqueness.
+ */
+/**
+ * Creates an ID generator with isolated counter state
+ *
+ * @param prefix - Prefix for generated IDs
+ * @returns Object with next(), nextSimple(), and reset() methods
+ *
+ * @example
+ * ```ts
+ * const generator = createIdGenerator('sub');
+ * const id1 = generator.next(); // "sub:1698765432100_1_a3k9d7f2q"
+ * const id2 = generator.next(); // "sub:1698765432101_2_b4n8e9g3r"
+ * ```
+ */
+export declare function createIdGenerator(prefix: string): {
+    next: () => string;
+    nextSimple: () => string;
+    reset: () => void;
+};
+/**
+ * Generate ID with timestamp, counter, and random suffix (tree-shakeable)
+ *
+ * Format: `${prefix}:${timestamp}_${counter}_${random}`
+ *
+ * @param prefix - Prefix for the ID (e.g., 'sub', 'consumer', 'stage')
+ * @returns Branded ID string
+ *
+ * @example
+ * const id = generateId('sub');
+ * // Returns: "sub:1698765432100_1_a3k9d7f2q"
+ */
+export declare function generateId(prefix: string): string;
+/**
+ * Generate simple ID with timestamp and random (no counter tracking)
+ *
+ * Format: `${prefix}:${timestamp}_${random}`
+ *
+ * @param prefix - Prefix for the ID
+ * @returns Branded ID string
+ *
+ * @example
+ * ```ts
+ * const id = generateSimpleId('CounterBloc');
+ * // Returns: "CounterBloc:1698765432100_a3k9d7f2q"
+ * ```
+ */
+export declare function generateSimpleId(prefix: string, affix?: string): string;
+/**
+ * Reset all counters for testing purposes
+ * @internal
+ */
+export declare function __resetIdCounters(): void;
+/**
+ * Generate a unique isolated instance key
+ * Uses base36 encoding for compact, URL-safe identifiers
+ *
+ * Format: "isolated-{9-char-random-string}"
+ * Example: "isolated-k7x2m9p4q"
+ *
+ * @returns A unique isolated instance key
+ */
+export declare function generateIsolatedKey(): string;
+/**
+ * Check if a key is an isolated instance key
+ * @param key - The instance key to check
+ * @returns true if the key is an isolated instance key
+ */
+export declare function isIsolatedKey(key: string): boolean;

package/dist/utils/static-props.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Utility functions for accessing static properties on StateContainer classes
+ */
+import { StateContainerConstructor } from '../types/utilities';
+/**
+ * Get a static property from a class constructor
+ * Type-safe helper that avoids (Type as any) casts
+ *
+ * @param Type - The class constructor
+ * @param propName - The property name to access
+ * @param defaultValue - Optional default value if property is undefined
+ * @returns The property value or default
+ */
+export declare function getStaticProp<V, T extends StateContainerConstructor = StateContainerConstructor>(Type: T, propName: string, defaultValue?: V): V | undefined;
+/**
+ * Check if a class is marked as isolated.
+ * Isolated classes create separate instances per component.
+ * @param Type - The class constructor to check
+ * @returns true if the class has `static isolated = true`
+ */
+export declare function isIsolatedClass<T extends StateContainerConstructor>(Type: T): boolean;
+/**
+ * Check if a class is marked as keepAlive.
+ * KeepAlive classes are never auto-disposed when ref count reaches 0.
+ * @param Type - The class constructor to check
+ * @returns true if the class has `static keepAlive = true`
+ */
+export declare function isKeepAliveClass<T extends StateContainerConstructor>(Type: T): boolean;
+/**
+ * Check if a class should be excluded from DevTools.
+ * Used to prevent infinite loops when DevTools tracks itself.
+ * @param Type - The class constructor to check
+ * @returns true if the class has `static __excludeFromDevTools = true`
+ */
+export declare function isExcludedFromDevTools<T extends StateContainerConstructor>(Type: T): boolean;

package/dist/watch/index.d.ts

@@ -0,0 +1,2 @@
+export { watch, instance } from './watch';
+export type { WatchFn, BlocRef } from './watch';

package/dist/watch/watch.d.ts

@@ -0,0 +1,50 @@
+import type { StateContainerConstructor } from '../types/utilities';
+declare const STOP: unique symbol;
+declare const BLOC_REF_MARKER: unique symbol;
+/**
+ * Reference to a specific bloc instance by class and instance ID.
+ */
+export interface BlocRef<T extends StateContainerConstructor> {
+    [BLOC_REF_MARKER]: true;
+    blocClass: T;
+    instanceId: string;
+}
+/**
+ * Create a reference to a specific bloc instance.
+ *
+ * @example
+ * ```ts
+ * watch(instance(UserBloc, 'user-123'), (userBloc) => {
+ *   console.log(userBloc.state.name);
+ * });
+ * ```
+ */
+export declare function instance<T extends StateContainerConstructor>(BlocClass: T, instanceId: string): BlocRef<T>;
+type BlocInput = StateContainerConstructor | BlocRef<StateContainerConstructor>;
+type ExtractInstance<T> = T extends BlocRef<infer C> ? InstanceType<C> : T extends StateContainerConstructor ? InstanceType<T> : never;
+type ExtractInstances<T extends readonly BlocInput[]> = {
+    [K in keyof T]: ExtractInstance<T[K]>;
+};
+type StopSymbol = typeof STOP;
+/**
+ * Watch function signature for single bloc.
+ */
+export interface WatchSingleFn {
+    <T extends StateContainerConstructor>(bloc: T | BlocRef<T>, callback: (bloc: InstanceType<T>) => void | StopSymbol): () => void;
+    STOP: StopSymbol;
+}
+/**
+ * Watch function signature for multiple blocs.
+ */
+export interface WatchMultipleFn {
+    <T extends readonly BlocInput[]>(blocs: T, callback: (blocs: ExtractInstances<T>) => void | StopSymbol): () => void;
+    STOP: StopSymbol;
+}
+/**
+ * Combined watch function type.
+ */
+export interface WatchFn extends WatchSingleFn {
+    <T extends readonly BlocInput[]>(blocs: T, callback: (blocs: ExtractInstances<T>) => void | StopSymbol): () => void;
+}
+export declare const watch: WatchFn;
+export {};

package/dist/watch-entry.cjs

@@ -1,109 +1,7 @@
-const require_watch = require('./watch.cjs');
-const require_resolve_dependencies = require('./resolve-dependencies.cjs');
-
-//#region src/tracking/tracked.ts
-/**
-* 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
-* ```
-*/
-function tracked(callback, options) {
-	const tracker = require_resolve_dependencies.createState();
-	require_resolve_dependencies.startTracking(tracker);
-	let result;
-	try {
-		result = callback();
-	} finally {
-		require_resolve_dependencies.stopTracking(tracker, { state: null });
-	}
-	const dependencies = new Set(tracker.dependencies);
-	if (options?.exclude) dependencies.delete(options.exclude);
-	return {
-		result,
-		dependencies
-	};
-}
-/**
-* Context for running tracked callbacks with bloc proxies.
-* Provides methods to create proxies and check for changes.
-*/
-var TrackedContext = class {
-	constructor() {
-		this.proxiedBlocs = /* @__PURE__ */ new WeakMap();
-		this.primaryBlocs = /* @__PURE__ */ new Set();
-		this.tracker = require_resolve_dependencies.createState();
-	}
-	/**
-	* Get a tracking proxy for a bloc instance.
-	* The proxy will track state and getter accesses.
-	*/
-	proxy(bloc) {
-		const cached = this.proxiedBlocs.get(bloc);
-		if (cached) return cached;
-		const proxied = require_resolve_dependencies.createTrackingProxy(bloc, this.tracker);
-		this.proxiedBlocs.set(bloc, proxied);
-		this.primaryBlocs.add(bloc);
-		return proxied;
-	}
-	/**
-	* Start tracking for a new callback execution.
-	*/
-	start() {
-		require_resolve_dependencies.startTracking(this.tracker);
-	}
-	/**
-	* Stop tracking and get discovered dependencies.
-	* Excludes primary blocs (those explicitly proxied via proxy()).
-	*/
-	stop() {
-		const allDeps = /* @__PURE__ */ new Set();
-		for (const bloc of this.primaryBlocs) {
-			const deps = require_resolve_dependencies.stopTracking(this.tracker, bloc);
-			for (const dep of deps) if (!this.primaryBlocs.has(dep)) allDeps.add(dep);
-		}
-		return allDeps;
-	}
-	/**
-	* Check if any tracked state or getters have changed.
-	*/
-	changed() {
-		for (const bloc of this.primaryBlocs) if (require_resolve_dependencies.hasChanges(this.tracker, bloc)) return true;
-		return false;
-	}
-	/**
-	* Get all primary blocs (those explicitly proxied).
-	*/
-	getPrimaryBlocs() {
-		return new Set(this.primaryBlocs);
-	}
-	/**
-	* Reset the context for reuse.
-	*/
-	reset() {
-		this.tracker = require_resolve_dependencies.createState();
-		this.proxiedBlocs = /* @__PURE__ */ new WeakMap();
-		this.primaryBlocs.clear();
-	}
-};
-/**
-* Create a new tracked context for manual control over tracking.
-*/
-function createTrackedContext() {
-	return new TrackedContext();
-}
-
-//#endregion
-exports.TrackedContext = TrackedContext;
-exports.createTrackedContext = createTrackedContext;
-exports.instance = require_watch.instance;
-exports.tracked = tracked;
-exports.watch = require_watch.watch;
-//# sourceMappingURL=watch-entry.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_tracked = require("./tracked-B_MUXIpe.cjs");
+exports.TrackedContext = require_tracked.TrackedContext;
+exports.createTrackedContext = require_tracked.createTrackedContext;
+exports.instance = require_tracked.instance;
+exports.tracked = require_tracked.tracked;
+exports.watch = require_tracked.watch;

package/dist/watch-entry.d.cts

@@ -0,0 +1,26 @@
+/**
+ * Watch Subpath Export
+ *
+ * Reactive subscription utilities for watching bloc state changes.
+ * Import from '@blac/core/watch'
+ *
+ * @example
+ * ```typescript
+ * import { watch, instance } from '@blac/core/watch';
+ *
+ * // Watch a bloc with automatic dependency tracking
+ * const unwatch = watch(UserBloc, (userBloc) => {
+ *   console.log(userBloc.state.name);
+ *   console.log(userBloc.fullName); // getter also tracked
+ * });
+ *
+ * // Watch a specific instance
+ * const unwatch = watch(instance(UserBloc, 'user-123'), (userBloc) => {
+ *   console.log(userBloc.state.name);
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { watch, instance, type WatchFn, type BlocRef } from './watch';
+export { tracked, createTrackedContext, TrackedContext, type TrackedResult, type TrackedOptions, } from './tracking/tracked';

package/dist/watch-entry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Watch Subpath Export
+ *
+ * Reactive subscription utilities for watching bloc state changes.
+ * Import from '@blac/core/watch'
+ *
+ * @example
+ * ```typescript
+ * import { watch, instance } from '@blac/core/watch';
+ *
+ * // Watch a bloc with automatic dependency tracking
+ * const unwatch = watch(UserBloc, (userBloc) => {
+ *   console.log(userBloc.state.name);
+ *   console.log(userBloc.fullName); // getter also tracked
+ * });
+ *
+ * // Watch a specific instance
+ * const unwatch = watch(instance(UserBloc, 'user-123'), (userBloc) => {
+ *   console.log(userBloc.state.name);
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { watch, instance, type WatchFn, type BlocRef } from './watch';
+export { tracked, createTrackedContext, TrackedContext, type TrackedResult, type TrackedOptions, } from './tracking/tracked';

package/dist/watch-entry.js

@@ -1,105 +1,2 @@
-import { n as watch, t as instance } from "./watch.js";
-import { b as stopTracking, d as createTrackingProxy, f as hasChanges, u as createState, y as startTracking } from "./resolve-dependencies.js";
-
-//#region src/tracking/tracked.ts
-/**
-* 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
-* ```
-*/
-function tracked(callback, options) {
-	const tracker = createState();
-	startTracking(tracker);
-	let result;
-	try {
-		result = callback();
-	} finally {
-		stopTracking(tracker, { state: null });
-	}
-	const dependencies = new Set(tracker.dependencies);
-	if (options?.exclude) dependencies.delete(options.exclude);
-	return {
-		result,
-		dependencies
-	};
-}
-/**
-* Context for running tracked callbacks with bloc proxies.
-* Provides methods to create proxies and check for changes.
-*/
-var TrackedContext = class {
-	constructor() {
-		this.proxiedBlocs = /* @__PURE__ */ new WeakMap();
-		this.primaryBlocs = /* @__PURE__ */ new Set();
-		this.tracker = createState();
-	}
-	/**
-	* Get a tracking proxy for a bloc instance.
-	* The proxy will track state and getter accesses.
-	*/
-	proxy(bloc) {
-		const cached = this.proxiedBlocs.get(bloc);
-		if (cached) return cached;
-		const proxied = createTrackingProxy(bloc, this.tracker);
-		this.proxiedBlocs.set(bloc, proxied);
-		this.primaryBlocs.add(bloc);
-		return proxied;
-	}
-	/**
-	* Start tracking for a new callback execution.
-	*/
-	start() {
-		startTracking(this.tracker);
-	}
-	/**
-	* Stop tracking and get discovered dependencies.
-	* Excludes primary blocs (those explicitly proxied via proxy()).
-	*/
-	stop() {
-		const allDeps = /* @__PURE__ */ new Set();
-		for (const bloc of this.primaryBlocs) {
-			const deps = stopTracking(this.tracker, bloc);
-			for (const dep of deps) if (!this.primaryBlocs.has(dep)) allDeps.add(dep);
-		}
-		return allDeps;
-	}
-	/**
-	* Check if any tracked state or getters have changed.
-	*/
-	changed() {
-		for (const bloc of this.primaryBlocs) if (hasChanges(this.tracker, bloc)) return true;
-		return false;
-	}
-	/**
-	* Get all primary blocs (those explicitly proxied).
-	*/
-	getPrimaryBlocs() {
-		return new Set(this.primaryBlocs);
-	}
-	/**
-	* Reset the context for reuse.
-	*/
-	reset() {
-		this.tracker = createState();
-		this.proxiedBlocs = /* @__PURE__ */ new WeakMap();
-		this.primaryBlocs.clear();
-	}
-};
-/**
-* Create a new tracked context for manual control over tracking.
-*/
-function createTrackedContext() {
-	return new TrackedContext();
-}
-
-//#endregion
+import { a as watch, i as instance, n as createTrackedContext, r as tracked, t as TrackedContext } from "./tracked-I_q9buYg.js";
 export { TrackedContext, createTrackedContext, instance, tracked, watch };
-//# sourceMappingURL=watch-entry.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blac/core",
-  "version": "2.0.4",
+  "version": "2.0.6",
   "license": "MIT",
   "author": "Brendan Mullins <jsnanigans@gmail.com>",
   "repository": {
@@ -12,6 +12,7 @@
   "bugs": {
     "url": "https://github.com/jsnanigans/blac/issues"
   },
+  "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -26,16 +27,6 @@
         "default": "./dist/index.cjs"
       }
     },
-    "./types": {
-      "import": {
-        "types": "./dist/types.d.ts",
-        "default": "./dist/types.js"
-      },
-      "require": {
-        "types": "./dist/types.d.cts",
-        "default": "./dist/types.cjs"
-      }
-    },
     "./tracking": {
       "import": {
         "types": "./dist/tracking.d.ts",
@@ -46,14 +37,14 @@
         "default": "./dist/tracking.cjs"
       }
     },
-    "./watch": {
+    "./debug": {
       "import": {
-        "types": "./dist/watch-entry.d.ts",
-        "default": "./dist/watch-entry.js"
+        "types": "./dist/debug.d.ts",
+        "default": "./dist/debug.js"
       },
       "require": {
-        "types": "./dist/watch-entry.d.cts",
-        "default": "./dist/watch-entry.cjs"
+        "types": "./dist/debug.d.cts",
+        "default": "./dist/debug.cjs"
       }
     },
     "./plugins": {
@@ -66,47 +57,35 @@
         "default": "./dist/plugins.cjs"
       }
     },
-    "./debug": {
+    "./watch": {
       "import": {
-        "types": "./dist/debug.d.ts",
-        "default": "./dist/debug.js"
+        "types": "./dist/watch-entry.d.ts",
+        "default": "./dist/watch-entry.js"
       },
       "require": {
-        "types": "./dist/debug.d.cts",
-        "default": "./dist/debug.cjs"
+        "types": "./dist/watch-entry.d.cts",
+        "default": "./dist/watch-entry.cjs"
+      }
+    },
+    "./types": {
+      "import": {
+        "types": "./dist/types.d.ts",
+        "default": "./dist/types.js"
+      },
+      "require": {
+        "types": "./dist/types.d.cts",
+        "default": "./dist/types.cjs"
       }
     }
   },
   "files": [
-    "dist/index.js",
-    "dist/index.cjs",
-    "dist/index.d.ts",
-    "dist/index.d.cts",
-    "dist/types.js",
-    "dist/types.cjs",
-    "dist/types.d.ts",
-    "dist/types.d.cts",
-    "dist/tracking.js",
-    "dist/tracking.cjs",
-    "dist/tracking.d.ts",
-    "dist/tracking.d.cts",
-    "dist/tracking/**/*.d.ts",
-    "dist/watch-entry.js",
-    "dist/watch-entry.cjs",
-    "dist/watch-entry.d.ts",
-    "dist/watch-entry.d.cts",
-    "dist/plugins.js",
-    "dist/plugins.cjs",
-    "dist/plugins.d.ts",
-    "dist/plugins.d.cts",
-    "dist/debug.js",
-    "dist/debug.cjs",
-    "dist/debug.d.ts",
-    "dist/debug.d.cts",
-    "dist/*.map",
+    "dist",
     "README.md",
     "LICENSE"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "sideEffects": false,
   "keywords": [
     "typescript",
@@ -127,14 +106,12 @@
     "typescript": "^5.9.2",
     "valibot": "^1.1.0",
     "vitest": "3.2.4",
+    "publint": "^0.3.12",
     "zod": "^4.1.12"
   },
   "scripts": {
     "dev": "tsdown --watch",
-    "build": "pnpm build:js && pnpm build:types && pnpm build:dts",
-    "build:js": "tsdown",
-    "build:types": "tsc -p tsconfig.build.json",
-    "build:dts": "api-extractor run --local && cp dist/index.d.ts dist/index.d.cts && cp -r dist/.types/tracking dist/tracking && cp dist/.types/tracking.d.ts dist/tracking.d.ts && cp dist/.types/tracking.d.ts dist/tracking.d.cts && cp dist/.types/types.d.ts dist/types.d.ts && cp dist/.types/types.d.ts dist/types.d.cts && rm -rf dist/.types",
+    "build": "tsdown && tsc -p tsconfig.build.json && for f in dist/*.d.ts; do cp \"$f\" \"${f%.d.ts}.d.cts\"; done",
     "clean": "rm -rf dist",
     "format": "prettier --write \".\"",
     "lint": "eslint src --ext .ts,.tsx",
@@ -142,6 +119,7 @@
     "test": "vitest run",
     "test:watch": "vitest --watch",
     "coverage": "vitest run --coverage",
+    "verify": "node ../../scripts/run-workspace-bin.mjs publint",
     "typecheck": "tsc --noEmit",
     "deploy": "pnpm publish --access public"
   }