@signaltree/enterprise 7.3.0 → 7.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/enterprise",
-  "version": "7.3.0",
+  "version": "7.3.1",
   "description": "Enterprise optimizations for SignalTree reactive JSON. Diff-based updates, bulk operations, and advanced change tracking for large-scale applications.",
   "license": "BSL-1.1",
   "type": "module",
@@ -98,6 +98,7 @@
   "files": [
     "dist/**/*.js",
     "dist/**/*.d.ts",
+    "src/**/*.d.ts",
     "README.md"
   ]
 }

package/src/diff-engine.d.ts

@@ -0,0 +1,2 @@
+// Placeholder declaration to satisfy packaging verification.
+export {};

package/src/enterprise-enhancer.d.ts

@@ -0,0 +1,2 @@
+// Placeholder declaration to satisfy packaging verification.
+export {};

package/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lib/diff-engine';
+export * from './lib/path-index';
+export * from './lib/update-engine';
+export * from './lib/enterprise-enhancer';
+export * from './lib/scheduler';
+export * from './lib/thread-pools';

package/src/lib/diff-engine.d.ts

@@ -0,0 +1,43 @@
+import type { Path } from './path-index';
+export declare enum ChangeType {
+    ADD = "add",
+    UPDATE = "update",
+    DELETE = "delete",
+    REPLACE = "replace"
+}
+export interface Change {
+    type: ChangeType;
+    path: Path;
+    value?: unknown;
+    oldValue?: unknown;
+}
+export interface Diff {
+    changes: Change[];
+    hasChanges: boolean;
+    instrumentation?: {
+        elementComparisons: number;
+        prefixFastPathHits: number;
+        wholeArrayReplaceHits: number;
+        traversals: number;
+        suffixFastPathHits: number;
+        segmentSkips: number;
+        samplesTaken: number;
+    };
+}
+export interface DiffOptions {
+    maxDepth?: number;
+    detectDeletions?: boolean;
+    ignoreArrayOrder?: boolean;
+    equalityFn?: (a: unknown, b: unknown) => boolean;
+    keyValidator?: (key: string) => boolean;
+    instrumentation?: boolean;
+}
+export declare class DiffEngine {
+    private defaultOptions;
+    diff(current: unknown, updates: unknown, options?: DiffOptions): Diff;
+    private traverse;
+    private diffArrays;
+    private diffArraysOrdered;
+    private diffArraysUnordered;
+    private stringify;
+}

package/src/lib/enterprise-enhancer.d.ts

@@ -0,0 +1,16 @@
+import { PathIndex } from './path-index';
+import { UpdateResult } from './update-engine';
+import type { Signal } from '@angular/core';
+import type { ISignalTree } from '@signaltree/core';
+export declare function enterprise<T = unknown>(): (tree: ISignalTree<T>) => ISignalTree<T> & EnterpriseEnhancedTree<T>;
+export interface EnterpriseEnhancedTree<T> {
+    updateOptimized(updates: Partial<T>, options?: {
+        maxDepth?: number;
+        ignoreArrayOrder?: boolean;
+        equalityFn?: (a: unknown, b: unknown) => boolean;
+        autoBatch?: boolean;
+        batchSize?: number;
+    }): UpdateResult;
+    getPathIndex(): PathIndex<Signal<unknown>> | null;
+}
+export declare const withEnterprise: typeof enterprise;

package/src/lib/enterprise.d.ts

@@ -0,0 +1 @@
+export declare function enterprise(): string;

package/src/lib/path-index.d.ts

@@ -0,0 +1,31 @@
+import type { WritableSignal } from '@angular/core';
+export type PathSegment = string | number;
+export type Path = PathSegment[];
+export declare class PathIndex<T extends object = WritableSignal<any>> {
+    private root;
+    private pathCache;
+    private stats;
+    private enableInstrumentation;
+    private instrumentation;
+    set(path: Path, signal: T): void;
+    get(path: Path): T | null;
+    has(path: Path): boolean;
+    getByPrefix(prefix: Path): Map<string, T>;
+    delete(path: Path): boolean;
+    clear(): void;
+    getStats(): {
+        hits: number;
+        misses: number;
+        sets: number;
+        cleanups: number;
+        hitRate: number;
+        cacheSize: number;
+    };
+    buildFromTree(tree: unknown, path?: Path): void;
+    private pathToString;
+    private collectDescendants;
+    deleteSubtree(path: Path): void;
+    incrementalUpdate(rootTree: unknown, changedPaths: string[]): void;
+    setInstrumentation(enabled: boolean): void;
+    getInstrumentation(reset?: boolean): typeof this.instrumentation;
+}

package/src/lib/scheduler.d.ts

@@ -0,0 +1,18 @@
+export type Task = () => void;
+interface SchedulerConfig {
+    yieldEveryTasks?: number;
+    yieldEveryMs?: number;
+    instrumentation?: boolean;
+}
+interface SchedulerMetrics {
+    drainCycles: number;
+    tasksExecuted: number;
+    maxQueueLength: number;
+    yields: number;
+    lastDrainDurationMs: number;
+    totalDrainDurationMs: number;
+}
+export declare function configureScheduler(newConfig: SchedulerConfig): void;
+export declare function getSchedulerMetrics(reset?: boolean): SchedulerMetrics;
+export declare function postTask(t: Task): void;
+export {};

package/src/lib/thread-pools.d.ts

@@ -0,0 +1,4 @@
+export interface WorkerPool {
+    run<T, A extends unknown[]>(fn: (...args: A) => T, ...args: A): Promise<T>;
+}
+export declare function createMockPool(): WorkerPool;

package/src/lib/update-engine.d.ts

@@ -0,0 +1,32 @@
+import { PathIndex } from './path-index';
+import type { DiffOptions } from './diff-engine';
+export interface UpdateOptions extends DiffOptions {
+    batch?: boolean;
+    batchSize?: number;
+}
+export interface UpdateResult {
+    changed: boolean;
+    duration: number;
+    changedPaths: string[];
+    stats?: {
+        totalPaths: number;
+        optimizedPaths: number;
+        batchedUpdates: number;
+    };
+}
+export declare class OptimizedUpdateEngine {
+    private pathIndex;
+    private diffEngine;
+    constructor(tree: unknown);
+    update(tree: unknown, updates: unknown, options?: UpdateOptions): UpdateResult;
+    rebuildIndex(tree: unknown): void;
+    getIndexStats(): ReturnType<PathIndex['getStats']>;
+    private createPatches;
+    private createPatch;
+    private calculatePriority;
+    private sortPatches;
+    private applyPatches;
+    private batchApplyPatches;
+    private applyPatch;
+    private isEqual;
+}

package/src/path-index.d.ts

@@ -0,0 +1,2 @@
+// Placeholder declaration to satisfy packaging verification.
+export {};

package/src/scheduler.d.ts

@@ -0,0 +1,2 @@
+// Placeholder declaration to satisfy packaging verification.
+export {};

package/src/signaltree-core.d.ts

@@ -0,0 +1,4 @@
+// Removed shim: previous local module augmentation caused stray declaration
+// files that break TypeScript resolution during packaging. If a module
+// augmentation is required again, prefer adding path mapping or proper
+// project references instead of committing a local `.d.ts` into `src/`.

package/src/test-setup.d.ts

@@ -0,0 +1,3 @@
+import '@angular/compiler';
+import 'zone.js';
+import 'zone.js/testing';

package/src/thread-pools.d.ts

@@ -0,0 +1,2 @@
+// Placeholder declaration to satisfy packaging verification.
+export {};

package/src/update-engine.d.ts

@@ -0,0 +1,2 @@
+// Placeholder declaration to satisfy packaging verification.
+export {};