@blac/core 2.0.0-rc.5 → 2.0.0-rc.8

package/dist/utils/idGenerator.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 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
+ * ```ts
+ * 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;
+//# sourceMappingURL=idGenerator.d.ts.map

package/dist/utils/idGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/idGenerator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM;;;;EAU/C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/utils/immutable.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Deep clone with circular reference handling
+ */
+export declare function cloneDeep<T>(obj: T, cloned?: WeakMap<WeakKey, any>): T;
+/**
+ * Deep freeze with circular reference handling
+ *
+ * Note: Currently disabled by default for proxy tracking compatibility.
+ * Proxies cannot intercept property access on frozen objects due to proxy invariants.
+ *
+ * @param obj - Object to freeze
+ * @param frozen - WeakSet for tracking circular references
+ * @param enabled - Whether to actually freeze (default: false for proxy compatibility)
+ */
+export declare function deepFreeze<T>(obj: T, frozen?: WeakSet<WeakKey>, enabled?: boolean): T;
+//# sourceMappingURL=immutable.d.ts.map

package/dist/utils/immutable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutable.d.ts","sourceRoot":"","sources":["../../src/utils/immutable.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,wBAAgB,GAAG,CAAC,CAyC9D;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,CAAC,EACN,MAAM,mBAAgB,EACtB,OAAO,UAAQ,GACd,CAAC,CAoBH"}

package/dist/utils/stack-trace.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Stack trace utilities for DevTools
+ */
+/**
+ * Capture and parse the current call stack
+ * Filters out internal BlaC framework calls to show only user code
+ */
+export declare function captureStackTrace(): string;
+/**
+ * Parse a stack trace string into structured data
+ */
+export interface StackFrame {
+    functionName: string;
+    fileName: string;
+    lineNumber: number | null;
+    columnNumber: number | null;
+}
+export declare function parseStackTrace(stack: string): StackFrame[];
+//# sourceMappingURL=stack-trace.d.ts.map

package/dist/utils/stack-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-trace.d.ts","sourceRoot":"","sources":["../../src/utils/stack-trace.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA+B1C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAiC3D"}

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

@@ -0,0 +1,29 @@
+/**
+ * Utility functions for accessing static properties on StateContainer classes
+ */
+/**
+ * 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<T>(Type: new (...args: any[]) => any, propName: string, defaultValue?: T): T | undefined;
+/**
+ * Check if a class is marked as isolated
+ * Isolated classes create separate instances per component
+ */
+export declare function isIsolatedClass(Type: new (...args: any[]) => any): boolean;
+/**
+ * Check if a class is marked as keepAlive
+ * KeepAlive classes are never auto-disposed when ref count reaches 0
+ */
+export declare function isKeepAliveClass(Type: new (...args: any[]) => any): boolean;
+/**
+ * Check if a class should be excluded from DevTools
+ * Used to prevent infinite loops when DevTools tracks itself
+ */
+export declare function isExcludedFromDevTools(Type: new (...args: any[]) => any): boolean;
+//# sourceMappingURL=static-props.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static-props.d.ts","sourceRoot":"","sources":["../../src/utils/static-props.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,CAAC,GACf,CAAC,GAAG,SAAS,CAEf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAE1E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,OAAO,CAE3E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAChC,OAAO,CAKT"}

package/package.json

@@ -1,9 +1,18 @@
 {
   "name": "@blac/core",
-  "version": "2.0.0-rc.5",
+  "version": "2.0.0-rc.8",
   "license": "MIT",
   "author": "Brendan Mullins <jsnanigans@gmail.com>",
-  "main": "./dist/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jsnanigans/blac.git",
+    "directory": "packages/blac"
+  },
+  "homepage": "https://github.com/jsnanigans/blac#readme",
+  "bugs": {
+    "url": "https://github.com/jsnanigans/blac/issues"
+  },
+  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -19,7 +28,11 @@
     }
   },
   "files": [
-    "dist",
+    "dist/**/*.js",
+    "dist/**/*.cjs",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.cts",
+    "dist/**/*.map",
     "README.md",
     "LICENSE"
   ],
@@ -47,7 +60,7 @@
   },
   "scripts": {
     "dev": "tsdown --watch",
-    "build": "tsdown",
+    "build": "tsdown && tsc -p tsconfig.build.json && cp dist/index.d.ts dist/index.d.cts",
     "clean": "rm -rf dist",
     "format": "prettier --write \".\"",
     "lint": "eslint src --ext .ts,.tsx",