@blac/core 2.0.0-rc-16 → 2.0.0-rc.1

package/dist/utils/BatchingManager.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Manages batching of state updates to optimize performance
+ */
+export declare class BatchingManager<S> {
+    private pendingUpdates;
+    private isBatching;
+    /**
+     * Execute a callback with batched updates
+     */
+    batchUpdates(callback: () => void, onFlush: (finalUpdate: {
+        newState: S;
+        oldState: S;
+        action?: unknown;
+    }) => void): void;
+    /**
+     * Add an update to the batch
+     */
+    addUpdate(update: {
+        newState: S;
+        oldState: S;
+        action?: unknown;
+    }): void;
+    /**
+     * Check if currently batching
+     */
+    get isCurrentlyBatching(): boolean;
+}
+//# sourceMappingURL=BatchingManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BatchingManager.d.ts","sourceRoot":"","sources":["../../src/utils/BatchingManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC;IAC5B,OAAO,CAAC,cAAc,CAId;IACR,OAAO,CAAC,UAAU,CAAS;IAE3B;;OAEG;IACH,YAAY,CACV,QAAQ,EAAE,MAAM,IAAI,EACpB,OAAO,EAAE,CAAC,WAAW,EAAE;QACrB,QAAQ,EAAE,CAAC,CAAC;QACZ,QAAQ,EAAE,CAAC,CAAC;QACZ,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,KAAK,IAAI,GACT,IAAI;IAsBP;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,CAAC,CAAC;QAAC,QAAQ,EAAE,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAMvE;;OAEG;IACH,IAAI,mBAAmB,IAAI,OAAO,CAEjC;CACF"}

package/dist/utils/BatchingManager.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchingManager = void 0;
+/**
+ * Manages batching of state updates to optimize performance
+ */
+class BatchingManager {
+    pendingUpdates = [];
+    isBatching = false;
+    /**
+     * Execute a callback with batched updates
+     */
+    batchUpdates(callback, onFlush) {
+        if (this.isBatching) {
+            callback();
+            return;
+        }
+        this.isBatching = true;
+        this.pendingUpdates = [];
+        try {
+            callback();
+            if (this.pendingUpdates.length > 0) {
+                const finalUpdate = this.pendingUpdates[this.pendingUpdates.length - 1];
+                onFlush(finalUpdate);
+            }
+        }
+        finally {
+            this.isBatching = false;
+            this.pendingUpdates = [];
+        }
+    }
+    /**
+     * Add an update to the batch
+     */
+    addUpdate(update) {
+        if (this.isBatching) {
+            this.pendingUpdates.push(update);
+        }
+    }
+    /**
+     * Check if currently batching
+     */
+    get isCurrentlyBatching() {
+        return this.isBatching;
+    }
+}
+exports.BatchingManager = BatchingManager;
+//# sourceMappingURL=BatchingManager.js.map

package/dist/utils/BatchingManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchingManager.js","sourceRoot":"","sources":["../../src/utils/BatchingManager.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,eAAe;IAClB,cAAc,GAIjB,EAAE,CAAC;IACA,UAAU,GAAG,KAAK,CAAC;IAE3B;;OAEG;IACH,YAAY,CACV,QAAoB,EACpB,OAIU;QAEV,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,QAAQ,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,QAAQ,EAAE,CAAC;YAEX,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACxE,OAAO,CAAC,WAAW,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAsD;QAC9D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF;AAvDD,0CAuDC"}

package/dist/utils/RerenderLogger.d.ts

@@ -0,0 +1,60 @@
+export interface RerenderInfo {
+    componentName: string;
+    blocName: string;
+    blocId: string;
+    renderCount: number;
+    reason: RerenderReason;
+    timestamp: number;
+    duration?: number;
+    stackTrace?: string;
+}
+export interface RerenderReason {
+    type: 'state-change' | 'dependency-change' | 'mount' | 'props-change' | 'unknown';
+    changedPaths?: string[];
+    oldValues?: Record<string, any>;
+    newValues?: Record<string, any>;
+    dependencies?: string[];
+    description?: string;
+}
+/**
+ * Utility class for logging component rerenders with detailed debugging information
+ */
+export declare class RerenderLogger {
+    private static componentRenderCounts;
+    private static lastRenderTimestamps;
+    private static groupedLogs;
+    private static groupTimeouts;
+    /**
+     * Log a component rerender with detailed information
+     */
+    static logRerender(info: RerenderInfo): void;
+    /**
+     * Parse the logging configuration
+     */
+    private static parseConfig;
+    /**
+     * Log immediately without grouping
+     */
+    private static logImmediate;
+    /**
+     * Log with grouping (batch multiple rerenders)
+     */
+    private static logGrouped;
+    /**
+     * Format the log message based on level
+     */
+    private static formatMessage;
+    /**
+     * Get emoji for reason type
+     */
+    private static getReasonEmoji;
+    /**
+     * Clear all tracking data
+     */
+    static clear(): void;
+    /**
+     * Get render count for a component
+     */
+    static getRenderCount(componentName: string, blocId: string): number;
+}
+//# sourceMappingURL=RerenderLogger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RerenderLogger.d.ts","sourceRoot":"","sources":["../../src/utils/RerenderLogger.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,cAAc,GACd,mBAAmB,GACnB,OAAO,GACP,cAAc,GACd,SAAS,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAA6B;IACjE,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAA6B;IAChE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAqC;IAC/D,OAAO,CAAC,MAAM,CAAC,aAAa,CAAqC;IAEjE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IA+C5C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAoB1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAiB3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAwCzB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAqD5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAe7B;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAQpB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;CAGrE"}

package/dist/utils/RerenderLogger.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RerenderLogger = void 0;
+const Blac_1 = require("../Blac");
+/**
+ * Utility class for logging component rerenders with detailed debugging information
+ */
+class RerenderLogger {
+    static componentRenderCounts = new Map();
+    static lastRenderTimestamps = new Map();
+    static groupedLogs = new Map();
+    static groupTimeouts = new Map();
+    /**
+     * Log a component rerender with detailed information
+     */
+    static logRerender(info) {
+        // RerenderLogger is now controlled by the RenderLoggingPlugin
+        // This method is called by the plugin which already handles configuration
+        const config = Blac_1.Blac._config?.rerenderLogging;
+        if (!config)
+            return;
+        // Parse config
+        const loggingConfig = this.parseConfig(config);
+        if (!loggingConfig.enabled)
+            return;
+        // Apply filter if provided
+        if (loggingConfig.filter &&
+            !loggingConfig.filter({
+                componentName: info.componentName,
+                blocName: info.blocName,
+            })) {
+            return;
+        }
+        // Track render count
+        const key = `${info.componentName}-${info.blocId}`;
+        const currentCount = this.componentRenderCounts.get(key) || 0;
+        this.componentRenderCounts.set(key, currentCount + 1);
+        info.renderCount = currentCount + 1;
+        // Calculate duration if possible
+        const lastTimestamp = this.lastRenderTimestamps.get(key);
+        if (lastTimestamp) {
+            info.duration = info.timestamp - lastTimestamp;
+        }
+        this.lastRenderTimestamps.set(key, info.timestamp);
+        // Add stack trace if requested
+        if (loggingConfig.includeStackTrace && loggingConfig.level === 'detailed') {
+            info.stackTrace = new Error().stack;
+        }
+        // Handle grouping
+        if (loggingConfig.groupRerenders) {
+            this.logGrouped(info, loggingConfig);
+        }
+        else {
+            this.logImmediate(info, loggingConfig);
+        }
+    }
+    /**
+     * Parse the logging configuration
+     */
+    static parseConfig(config) {
+        if (config === true) {
+            return { enabled: true, level: 'normal' };
+        }
+        if (typeof config === 'string') {
+            return {
+                enabled: true,
+                level: config === 'minimal' ? 'minimal' : 'detailed',
+            };
+        }
+        return {
+            enabled: config.enabled,
+            level: config.level || 'normal',
+            filter: config.filter,
+            includeStackTrace: config.includeStackTrace,
+            groupRerenders: config.groupRerenders,
+        };
+    }
+    /**
+     * Log immediately without grouping
+     */
+    static logImmediate(info, config) {
+        const message = this.formatMessage(info, config.level);
+        if (config.level === 'detailed') {
+            console.group(message.header);
+            if (message.details)
+                console.log(message.details);
+            if (message.values)
+                console.table(message.values);
+            if (info.stackTrace)
+                console.log('Stack trace:', info.stackTrace);
+            console.groupEnd();
+        }
+        else {
+            console.log(message.header, message.details || '');
+        }
+    }
+    /**
+     * Log with grouping (batch multiple rerenders)
+     */
+    static logGrouped(info, config) {
+        const groupKey = `${info.componentName}-${info.blocId}`;
+        // Clear existing timeout
+        const existingTimeout = this.groupTimeouts.get(groupKey);
+        if (existingTimeout) {
+            clearTimeout(existingTimeout);
+        }
+        // Add to group
+        const group = this.groupedLogs.get(groupKey) || [];
+        group.push(info);
+        this.groupedLogs.set(groupKey, group);
+        // Set new timeout
+        const timeout = setTimeout(() => {
+            const logs = this.groupedLogs.get(groupKey) || [];
+            this.groupedLogs.delete(groupKey);
+            this.groupTimeouts.delete(groupKey);
+            if (logs.length === 1) {
+                this.logImmediate(logs[0], config);
+            }
+            else {
+                console.group(`🔄 ${info.componentName} rendered ${logs.length} times (${info.blocName})`);
+                logs.forEach((log, index) => {
+                    const message = this.formatMessage(log, config.level);
+                    console.log(`  ${index + 1}. ${message.details || message.header}`);
+                });
+                console.groupEnd();
+            }
+        }, 50); // 50ms debounce
+        this.groupTimeouts.set(groupKey, timeout);
+    }
+    /**
+     * Format the log message based on level
+     */
+    static formatMessage(info, level) {
+        const emoji = this.getReasonEmoji(info.reason.type);
+        if (level === 'minimal') {
+            return {
+                header: `${emoji} ${info.componentName} #${info.renderCount}`,
+                details: null,
+                values: null,
+            };
+        }
+        const header = `${emoji} ${info.componentName} rerender #${info.renderCount} (${info.blocName})`;
+        let details = `Reason: ${info.reason.description || info.reason.type}`;
+        if (info.duration !== undefined) {
+            details += ` | Time since last: ${info.duration}ms`;
+        }
+        if (level === 'normal' &&
+            info.reason.changedPaths &&
+            info.reason.changedPaths.length > 0) {
+            details += ` | Changed: ${info.reason.changedPaths.join(', ')}`;
+        }
+        let values = null;
+        if (level === 'detailed' &&
+            info.reason.changedPaths &&
+            info.reason.changedPaths.length > 0) {
+            values = {};
+            info.reason.changedPaths.forEach((path) => {
+                values[path] = {
+                    old: info.reason.oldValues?.[path],
+                    new: info.reason.newValues?.[path],
+                };
+            });
+            // If we have values to show in detailed mode, ensure they're not empty
+            if (Object.keys(values).length === 0) {
+                values = null;
+            }
+        }
+        return { header, details, values };
+    }
+    /**
+     * Get emoji for reason type
+     */
+    static getReasonEmoji(type) {
+        switch (type) {
+            case 'state-change':
+                return '📊';
+            case 'dependency-change':
+                return '🔗';
+            case 'mount':
+                return '🚀';
+            case 'props-change':
+                return '📦';
+            default:
+                return '🔄';
+        }
+    }
+    /**
+     * Clear all tracking data
+     */
+    static clear() {
+        this.componentRenderCounts.clear();
+        this.lastRenderTimestamps.clear();
+        this.groupedLogs.clear();
+        this.groupTimeouts.forEach((timeout) => clearTimeout(timeout));
+        this.groupTimeouts.clear();
+    }
+    /**
+     * Get render count for a component
+     */
+    static getRenderCount(componentName, blocId) {
+        return this.componentRenderCounts.get(`${componentName}-${blocId}`) || 0;
+    }
+}
+exports.RerenderLogger = RerenderLogger;
+//# sourceMappingURL=RerenderLogger.js.map

package/dist/utils/RerenderLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RerenderLogger.js","sourceRoot":"","sources":["../../src/utils/RerenderLogger.ts"],"names":[],"mappings":"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"}

package/dist/utils/generateInstanceId.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generates a deterministic instance ID from static props by extracting primitive values
+ *
+ * Rules:
+ * 1. Only considers primitive types: string, number, boolean, null, undefined
+ * 2. Ignores complex types: objects, arrays, functions, symbols
+ * 3. Sorts keys alphabetically for deterministic output
+ * 4. Returns undefined if no primitives found (caller should use default ID)
+ */
+export declare function generateInstanceIdFromProps(props: unknown): string | undefined;
+//# sourceMappingURL=generateInstanceId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateInstanceId.d.ts","sourceRoot":"","sources":["../../src/utils/generateInstanceId.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,SAAS,CA0CpB"}

package/dist/utils/generateInstanceId.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateInstanceIdFromProps = generateInstanceIdFromProps;
+/**
+ * Generates a deterministic instance ID from static props by extracting primitive values
+ *
+ * Rules:
+ * 1. Only considers primitive types: string, number, boolean, null, undefined
+ * 2. Ignores complex types: objects, arrays, functions, symbols
+ * 3. Sorts keys alphabetically for deterministic output
+ * 4. Returns undefined if no primitives found (caller should use default ID)
+ */
+function generateInstanceIdFromProps(props) {
+    if (!props || typeof props !== 'object') {
+        return undefined;
+    }
+    const primitives = [];
+    // Extract primitive values
+    for (const [key, value] of Object.entries(props)) {
+        const type = typeof value;
+        if (type === 'string' ||
+            type === 'number' ||
+            type === 'boolean' ||
+            value === null ||
+            value === undefined) {
+            primitives.push([key, value]);
+        }
+    }
+    // No primitives found
+    if (primitives.length === 0) {
+        return undefined;
+    }
+    // Sort by key for deterministic output
+    primitives.sort(([a], [b]) => a.localeCompare(b));
+    // Create instance ID
+    const parts = [];
+    for (const [key, value] of primitives) {
+        if (value === null) {
+            parts.push(`${key}:null`);
+        }
+        else if (value === undefined) {
+            parts.push(`${key}:undefined`);
+        }
+        else {
+            parts.push(`${key}:${String(value)}`);
+        }
+    }
+    return parts.join('|');
+}
+//# sourceMappingURL=generateInstanceId.js.map

package/dist/utils/generateInstanceId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateInstanceId.js","sourceRoot":"","sources":["../../src/utils/generateInstanceId.ts"],"names":[],"mappings":";;AASA,kEA4CC;AArDD;;;;;;;;GAQG;AACH,SAAgB,2BAA2B,CACzC,KAAc;IAEd,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAA6B,EAAE,CAAC;IAEhD,2BAA2B;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC;QAC1B,IACE,IAAI,KAAK,QAAQ;YACjB,IAAI,KAAK,QAAQ;YACjB,IAAI,KAAK,SAAS;YAClB,KAAK,KAAK,IAAI;YACd,KAAK,KAAK,SAAS,EACnB,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,uCAAuC;IACvC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAElD,qBAAqB;IACrB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QACtC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/utils/shallowEqual.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Performs a shallow equality comparison between two values.
+ * For objects, it checks if all top-level properties are equal using Object.is.
+ * @param a First value to compare
+ * @param b Second value to compare
+ * @returns true if values are shallowly equal, false otherwise
+ */
+export declare function shallowEqual(a: any, b: any): boolean;
+//# sourceMappingURL=shallowEqual.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shallowEqual.d.ts","sourceRoot":"","sources":["../../src/utils/shallowEqual.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,OAAO,CAgCpD"}

package/dist/utils/shallowEqual.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shallowEqual = shallowEqual;
+/**
+ * Performs a shallow equality comparison between two values.
+ * For objects, it checks if all top-level properties are equal using Object.is.
+ * @param a First value to compare
+ * @param b Second value to compare
+ * @returns true if values are shallowly equal, false otherwise
+ */
+function shallowEqual(a, b) {
+    if (Object.is(a, b)) {
+        return true;
+    }
+    if (typeof a !== 'object' ||
+        a === null ||
+        typeof b !== 'object' ||
+        b === null) {
+        return false;
+    }
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length) {
+        return false;
+    }
+    for (let i = 0; i < keysA.length; i++) {
+        const key = keysA[i];
+        if (!Object.prototype.hasOwnProperty.call(b, key) ||
+            !Object.is(a[key], b[key])) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=shallowEqual.js.map

package/dist/utils/shallowEqual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shallowEqual.js","sourceRoot":"","sources":["../../src/utils/shallowEqual.ts"],"names":[],"mappings":";;AAOA,oCAgCC;AAvCD;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,CAAM,EAAE,CAAM;IACzC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IACE,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACV,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI,EACV,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE7B,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;YAC7C,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAC1B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/uuid.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cross-platform UUID v4 generator that works in all environments including React Native/Hermes
+ * Falls back to crypto.randomUUID() when available, otherwise uses Math.random()
+ */
+/**
+ * Generates a UUID v4 string compatible with all JavaScript environments
+ * @returns A UUID v4 string in the format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ */
+export declare function generateUUID(): string;
+//# sourceMappingURL=uuid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/utils/uuid.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAYrC"}

package/dist/utils/uuid.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Cross-platform UUID v4 generator that works in all environments including React Native/Hermes
+ * Falls back to crypto.randomUUID() when available, otherwise uses Math.random()
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateUUID = generateUUID;
+/**
+ * Generates a UUID v4 string compatible with all JavaScript environments
+ * @returns A UUID v4 string in the format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ */
+function generateUUID() {
+    // Try to use crypto.randomUUID() if available (Node.js 16+, modern browsers)
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback implementation for React Native/Hermes and older environments
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=uuid.js.map

package/dist/utils/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/utils/uuid.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAMH,oCAYC;AAhBD;;;GAGG;AACH,SAAgB,YAAY;IAC1B,6EAA6E;IAC7E,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,yEAAyE;IACzE,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC;QACxE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,14 +1,20 @@
 {
   "name": "@blac/core",
-  "version": "2.0.0-rc-16",
+  "version": "2.0.0-rc.1",
   "license": "MIT",
   "author": "Brendan Mullins <jsnanigans@gmail.com>",
-  "main": "src/index.ts",
-  "module": "src/index.ts",
-  "typings": "src/index.ts",
-  "types": "src/index.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
   "files": [
-    "src",
+    "dist",
     "README.md",
     "LICENSE"
   ],
@@ -32,7 +38,14 @@
     "vitest": "^3.2.4"
   },
   "scripts": {
+    "dev": "tsc --watch --project tsconfig.build.json",
+    "build": "pnpm run clean && pnpm run build:esm && pnpm run build:cjs",
+    "build:esm": "tsc --project tsconfig.build.json",
+    "build:cjs": "tsc --project tsconfig.build.json --module commonjs --outDir dist --declaration false --declarationMap false && cp dist/index.js dist/index.cjs",
+    "clean": "rm -rf dist",
     "format": "prettier --write \".\"",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
     "test": "vitest run",
     "test:watch": "vitest --watch",
     "coverage": "vitest run --coverage",