@visactor/vrender-core 1.0.47-alpha.0 → 1.1.0-alpha.1

package/es/graphic/state/state-engine.js

@@ -0,0 +1,212 @@
+import { getStageStatePerfMonitor } from "./state-perf-monitor";
+
+function isPlainObject(value) {
+    return null != value && "object" == typeof value && !Array.isArray(value);
+}
+
+function cloneValue(value) {
+    if (!isPlainObject(value)) return value;
+    const clone = {};
+    return Object.keys(value).forEach((key => {
+        clone[key] = cloneValue(value[key]);
+    })), clone;
+}
+
+function deepMerge(base, value) {
+    var _a;
+    const result = null !== (_a = cloneValue(base)) && void 0 !== _a ? _a : {};
+    return Object.keys(value).forEach((key => {
+        const nextValue = value[key], previousValue = result[key];
+        isPlainObject(previousValue) && isPlainObject(nextValue) ? result[key] = deepMerge(previousValue, nextValue) : result[key] = cloneValue(nextValue);
+    })), result;
+}
+
+const FULL_DEFINITION_KEYS = new Set([ "name", "patch", "priority", "exclude", "suppress", "resolver", "declaredAffectedKeys" ]);
+
+export class StateEngine {
+    constructor(options) {
+        var _a;
+        this._activeStates = [], this._effectiveStates = [], this._suppressed = [], this._resolvedPatch = {}, 
+        this.resolverPatchCache = new Map, this.resolverCacheKey = "", this.resolverCacheValid = !1, 
+        this.baseAttributes = {}, this.compiledDefinitions = options.compiledDefinitions, 
+        this.stateSort = options.stateSort, this.stateProxy = options.stateProxy, this.stateProxyEligibility = options.stateProxyEligibility, 
+        this.states = options.states, this.mergeMode = null !== (_a = options.mergeMode) && void 0 !== _a ? _a : "shallow";
+    }
+    get activeStates() {
+        return this._activeStates;
+    }
+    get effectiveStates() {
+        return this._effectiveStates;
+    }
+    get resolvedPatch() {
+        return this._resolvedPatch;
+    }
+    get suppressed() {
+        return this._suppressed;
+    }
+    setResolveContext(graphic, baseAttributes) {
+        this.graphic = graphic, this.baseAttributes = baseAttributes;
+    }
+    applyStates(stateNames) {
+        const uniqueStates = Array.from(new Set(stateNames)), sortedStates = this.sortStates(uniqueStates), adjudicated = this.adjudicate(sortedStates), activeStates = adjudicated.active, effectiveStates = activeStates.filter((stateName => !adjudicated.suppressedSet.has(stateName))), suppressed = activeStates.filter((stateName => adjudicated.suppressedSet.has(stateName))), changed = !this.sameArray(this._activeStates, activeStates) || !this.sameArray(this._effectiveStates, effectiveStates) || !this.sameArray(this._suppressed, suppressed);
+        return this._activeStates = activeStates, this._effectiveStates = effectiveStates, 
+        this._suppressed = suppressed, !changed && this.resolverCacheValid || this.recomputePatch(effectiveStates), 
+        {
+            changed: changed,
+            activeStates: [ ...this._activeStates ],
+            effectiveStates: [ ...this._effectiveStates ],
+            suppressed: [ ...this._suppressed ]
+        };
+    }
+    addState(stateName, keepCurrentStates) {
+        if (this._activeStates.includes(stateName) && (keepCurrentStates || 1 === this._activeStates.length)) return {
+            changed: !1,
+            activeStates: [ ...this._activeStates ],
+            effectiveStates: [ ...this._effectiveStates ],
+            suppressed: [ ...this._suppressed ]
+        };
+        const nextStates = keepCurrentStates && this._activeStates.length ? this._activeStates.concat([ stateName ]) : [ stateName ];
+        return this.applyStates(nextStates);
+    }
+    removeState(stateNames) {
+        if (!this._activeStates.length) return {
+            changed: !1,
+            activeStates: [],
+            effectiveStates: [],
+            suppressed: []
+        };
+        const filteredNames = Array.isArray(stateNames) ? this._activeStates.filter((stateName => !stateNames.includes(stateName))) : this._activeStates.filter((stateName => stateName !== stateNames));
+        return filteredNames.length === this._activeStates.length ? {
+            changed: !1,
+            activeStates: [ ...this._activeStates ],
+            effectiveStates: [ ...this._effectiveStates ],
+            suppressed: [ ...this._suppressed ]
+        } : this.applyStates(filteredNames);
+    }
+    toggleState(stateName) {
+        return this.hasState(stateName) ? this.removeState(stateName) : this.applyStates(this._activeStates.concat([ stateName ]));
+    }
+    clearStates() {
+        const changed = this._activeStates.length > 0 || this._effectiveStates.length > 0 || this._suppressed.length > 0;
+        return this._activeStates = [], this._effectiveStates = [], this._suppressed = [], 
+        this._resolvedPatch = {}, this.resolverPatchCache.clear(), this.resolverCacheKey = "", 
+        this.resolverCacheValid = !1, {
+            changed: changed,
+            activeStates: [],
+            effectiveStates: [],
+            suppressed: []
+        };
+    }
+    invalidateResolverCache() {
+        var _a, _b;
+        this.resolverPatchCache.clear(), this.resolverCacheKey = "", this.resolverCacheValid = !1, 
+        null === (_b = getStageStatePerfMonitor(null === (_a = this.graphic) || void 0 === _a ? void 0 : _a.stage)) || void 0 === _b || _b.recordResolver("invalidations");
+    }
+    hasState(stateName) {
+        return !!this._activeStates.length && (null == stateName || this._activeStates.includes(stateName));
+    }
+    getCompatPatch(stateName) {
+        var _a, _b, _c;
+        const targetStates = this._activeStates.length ? this._activeStates : this._effectiveStates, canUseStateProxy = this.canUseStateProxy(stateName), proxyPatch = canUseStateProxy ? null === (_a = this.stateProxy) || void 0 === _a ? void 0 : _a.call(this, stateName, targetStates) : void 0;
+        if (this.stateProxy && canUseStateProxy) return null != proxyPatch ? proxyPatch : void 0;
+        const value = null === (_b = this.states) || void 0 === _b ? void 0 : _b[stateName];
+        if (null == value) return;
+        if (!isPlainObject(value)) return value;
+        return Object.keys(value).some((key => FULL_DEFINITION_KEYS.has(key))) ? cloneValue(null !== (_c = value.patch) && void 0 !== _c ? _c : void 0) : value;
+    }
+    sortStates(states) {
+        const withDefinition = [], withoutDefinition = [];
+        return states.forEach((stateName => {
+            this.compiledDefinitions.has(stateName) ? withDefinition.push(stateName) : withoutDefinition.push(stateName);
+        })), withDefinition.sort(((left, right) => {
+            const leftDefinition = this.compiledDefinitions.get(left), rightDefinition = this.compiledDefinitions.get(right);
+            return leftDefinition && rightDefinition ? leftDefinition.priority !== rightDefinition.priority ? leftDefinition.priority - rightDefinition.priority : leftDefinition.rank - rightDefinition.rank : 0;
+        })), this.stateSort && withoutDefinition.length > 1 && withoutDefinition.sort(this.stateSort), 
+        withDefinition.concat(withoutDefinition);
+    }
+    adjudicate(sortedStates) {
+        const candidate = sortedStates.slice(), suppressedSet = new Set;
+        for (let index = candidate.length - 1; index >= 0; index--) {
+            const stateName = candidate[index], definition = this.compiledDefinitions.get(stateName);
+            definition && (definition.exclude.forEach((excludedState => {
+                const excludedIndex = candidate.indexOf(excludedState);
+                -1 !== excludedIndex && (candidate.splice(excludedIndex, 1), excludedIndex < index && (index -= 1));
+            })), definition.suppress.forEach((suppressedState => {
+                suppressedSet.add(suppressedState);
+            })));
+        }
+        return {
+            active: candidate,
+            suppressedSet: suppressedSet
+        };
+    }
+    recomputePatch(effectiveStates) {
+        var _a;
+        const perfMonitor = getStageStatePerfMonitor(null === (_a = this.graphic) || void 0 === _a ? void 0 : _a.stage), patchStart = perfMonitor ? performance.now() : 0;
+        let resolverCost = 0;
+        const cacheKey = effectiveStates.join(","), nextPatch = {};
+        if (null == perfMonitor || perfMonitor.recordAllocation("patchObjectsCreated"), 
+        this.resolverCacheValid && this.resolverCacheKey === cacheKey ? effectiveStates.forEach((stateName => {
+            var _a;
+            const canUseStateProxy = this.canUseStateProxy(stateName), proxyPatch = canUseStateProxy ? null === (_a = this.stateProxy) || void 0 === _a ? void 0 : _a.call(this, stateName, effectiveStates) : void 0;
+            if (this.stateProxy && canUseStateProxy) return void (null != proxyPatch && this.mergeInto(nextPatch, proxyPatch));
+            const definition = this.compiledDefinitions.get(stateName);
+            if (definition) {
+                if (definition.patch && this.mergeInto(nextPatch, definition.patch), definition.hasResolver) {
+                    const cachedPatch = this.resolverPatchCache.get(stateName);
+                    cachedPatch && (null == perfMonitor || perfMonitor.recordResolver("cacheHits"), 
+                    this.mergeInto(nextPatch, cachedPatch));
+                }
+            } else {
+                const compatPatch = this.getCompatPatch(stateName);
+                compatPatch && this.mergeInto(nextPatch, compatPatch);
+            }
+        })) : (this.resolverPatchCache.clear(), this.resolverCacheKey = cacheKey, effectiveStates.forEach((stateName => {
+            var _a;
+            const canUseStateProxy = this.canUseStateProxy(stateName), proxyPatch = canUseStateProxy ? null === (_a = this.stateProxy) || void 0 === _a ? void 0 : _a.call(this, stateName, effectiveStates) : void 0;
+            if (this.stateProxy && canUseStateProxy) return void (null != proxyPatch && this.mergeInto(nextPatch, proxyPatch));
+            const definition = this.compiledDefinitions.get(stateName);
+            if (definition) {
+                if (definition.patch && this.mergeInto(nextPatch, definition.patch), definition.hasResolver && definition.resolver) {
+                    null == perfMonitor || perfMonitor.recordResolver("cacheMisses");
+                    const resolverStart = perfMonitor ? performance.now() : 0, resolverPatch = definition.resolver({
+                        graphic: this.graphic,
+                        activeStates: this._activeStates,
+                        effectiveStates: this._effectiveStates,
+                        baseAttributes: this.baseAttributes,
+                        resolvedPatch: nextPatch
+                    });
+                    if (perfMonitor) {
+                        const duration = performance.now() - resolverStart;
+                        resolverCost += duration, perfMonitor.recordCost("resolver", duration);
+                    }
+                    resolverPatch && (this.resolverPatchCache.set(stateName, resolverPatch), this.mergeInto(nextPatch, resolverPatch));
+                }
+            } else {
+                const compatPatch = this.getCompatPatch(stateName);
+                compatPatch && this.mergeInto(nextPatch, compatPatch);
+            }
+        })), this.resolverCacheValid = !0), this._resolvedPatch = nextPatch, perfMonitor) {
+            const totalCost = performance.now() - patchStart;
+            perfMonitor.recordCost("patch", Math.max(0, totalCost - resolverCost));
+        }
+    }
+    mergeInto(target, patch) {
+        "deep" !== this.mergeMode ? Object.keys(patch).forEach((key => {
+            target[key] = cloneValue(patch[key]);
+        })) : Object.keys(patch).forEach((key => {
+            var _a;
+            const nextValue = patch[key], previousValue = target[key], baseValue = null === (_a = this.baseAttributes) || void 0 === _a ? void 0 : _a[key];
+            isPlainObject(previousValue) && isPlainObject(nextValue) ? target[key] = deepMerge(previousValue, nextValue) : !isPlainObject(previousValue) && isPlainObject(baseValue) && isPlainObject(nextValue) ? target[key] = deepMerge(baseValue, nextValue) : target[key] = cloneValue(nextValue);
+        }));
+    }
+    sameArray(left, right) {
+        if (left.length !== right.length) return !1;
+        for (let index = 0; index < left.length; index++) if (left[index] !== right[index]) return !1;
+        return !0;
+    }
+    canUseStateProxy(stateName) {
+        return !!this.stateProxy && (!this.stateProxyEligibility || this.stateProxyEligibility(stateName));
+    }
+}
+//# sourceMappingURL=state-engine.js.map

package/es/graphic/state/state-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graphic/state/state-engine.ts"],"names":[],"mappings":"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","file":"state-engine.js","sourcesContent":["import type {\n  CompiledStateDefinition,\n  IStateEngineOptions,\n  StateDefinitionsInput,\n  StateTransitionResult\n} from './state-definition';\nimport { getStageStatePerfMonitor } from './state-perf-monitor';\n\nfunction isPlainObject(value: unknown): value is Record<string, any> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction cloneValue<T>(value: T): T {\n  if (!isPlainObject(value)) {\n    return value;\n  }\n\n  const clone: Record<string, any> = {};\n  Object.keys(value).forEach(key => {\n    clone[key] = cloneValue((value as Record<string, any>)[key]);\n  });\n  return clone as T;\n}\n\nfunction deepMerge(base: Record<string, any>, value: Record<string, any>): Record<string, any> {\n  const result: Record<string, any> = cloneValue(base) ?? {};\n\n  Object.keys(value).forEach(key => {\n    const nextValue = value[key];\n    const previousValue = result[key];\n\n    if (isPlainObject(previousValue) && isPlainObject(nextValue)) {\n      result[key] = deepMerge(previousValue, nextValue);\n      return;\n    }\n\n    result[key] = cloneValue(nextValue);\n  });\n\n  return result;\n}\n\nconst FULL_DEFINITION_KEYS = new Set([\n  'name',\n  'patch',\n  'priority',\n  'exclude',\n  'suppress',\n  'resolver',\n  'declaredAffectedKeys'\n]);\n\nexport class StateEngine<T extends Record<string, any> = Record<string, any>> {\n  private readonly compiledDefinitions: Map<string, CompiledStateDefinition<T>>;\n  private readonly stateSort?: (a: string, b: string) => number;\n  private readonly stateProxy?: (stateName: string, targetStates?: string[]) => Partial<T> | undefined;\n  private readonly stateProxyEligibility?: (stateName: string) => boolean;\n  private readonly states?: StateDefinitionsInput<T>;\n  private readonly mergeMode: 'shallow' | 'deep';\n\n  private _activeStates: string[] = [];\n  private _effectiveStates: string[] = [];\n  private _suppressed: string[] = [];\n  private _resolvedPatch: Partial<T> = {};\n  private resolverPatchCache = new Map<string, Partial<T>>();\n  private resolverCacheKey = '';\n  private resolverCacheValid = false;\n  private graphic: any;\n  private baseAttributes: Partial<T> = {};\n\n  constructor(options: IStateEngineOptions<T>) {\n    this.compiledDefinitions = options.compiledDefinitions;\n    this.stateSort = options.stateSort;\n    this.stateProxy = options.stateProxy;\n    this.stateProxyEligibility = options.stateProxyEligibility;\n    this.states = options.states;\n    this.mergeMode = options.mergeMode ?? 'shallow';\n  }\n\n  get activeStates(): ReadonlyArray<string> {\n    return this._activeStates;\n  }\n\n  get effectiveStates(): ReadonlyArray<string> {\n    return this._effectiveStates;\n  }\n\n  get resolvedPatch(): Partial<T> {\n    return this._resolvedPatch;\n  }\n\n  get suppressed(): ReadonlyArray<string> {\n    return this._suppressed;\n  }\n\n  setResolveContext(graphic: any, baseAttributes: Partial<T>): void {\n    this.graphic = graphic;\n    this.baseAttributes = baseAttributes;\n  }\n\n  applyStates(stateNames: string[]): StateTransitionResult {\n    const uniqueStates = Array.from(new Set(stateNames));\n    const sortedStates = this.sortStates(uniqueStates);\n    const adjudicated = this.adjudicate(sortedStates);\n    const activeStates = adjudicated.active;\n    const effectiveStates = activeStates.filter(stateName => !adjudicated.suppressedSet.has(stateName));\n    const suppressed = activeStates.filter(stateName => adjudicated.suppressedSet.has(stateName));\n\n    const changed =\n      !this.sameArray(this._activeStates, activeStates) ||\n      !this.sameArray(this._effectiveStates, effectiveStates) ||\n      !this.sameArray(this._suppressed, suppressed);\n\n    this._activeStates = activeStates;\n    this._effectiveStates = effectiveStates;\n    this._suppressed = suppressed;\n\n    if (changed || !this.resolverCacheValid) {\n      this.recomputePatch(effectiveStates);\n    }\n\n    return {\n      changed,\n      activeStates: [...this._activeStates],\n      effectiveStates: [...this._effectiveStates],\n      suppressed: [...this._suppressed]\n    };\n  }\n\n  addState(stateName: string, keepCurrentStates?: boolean): StateTransitionResult {\n    if (this._activeStates.includes(stateName) && (keepCurrentStates || this._activeStates.length === 1)) {\n      return {\n        changed: false,\n        activeStates: [...this._activeStates],\n        effectiveStates: [...this._effectiveStates],\n        suppressed: [...this._suppressed]\n      };\n    }\n\n    const nextStates =\n      keepCurrentStates && this._activeStates.length ? this._activeStates.concat([stateName]) : [stateName];\n\n    return this.applyStates(nextStates);\n  }\n\n  removeState(stateNames: string | string[]): StateTransitionResult {\n    if (!this._activeStates.length) {\n      return {\n        changed: false,\n        activeStates: [],\n        effectiveStates: [],\n        suppressed: []\n      };\n    }\n\n    const filteredNames = Array.isArray(stateNames)\n      ? this._activeStates.filter(stateName => !stateNames.includes(stateName))\n      : this._activeStates.filter(stateName => stateName !== stateNames);\n\n    if (filteredNames.length === this._activeStates.length) {\n      return {\n        changed: false,\n        activeStates: [...this._activeStates],\n        effectiveStates: [...this._effectiveStates],\n        suppressed: [...this._suppressed]\n      };\n    }\n\n    return this.applyStates(filteredNames);\n  }\n\n  toggleState(stateName: string): StateTransitionResult {\n    if (this.hasState(stateName)) {\n      return this.removeState(stateName);\n    }\n\n    return this.applyStates(this._activeStates.concat([stateName]));\n  }\n\n  clearStates(): StateTransitionResult {\n    const changed = this._activeStates.length > 0 || this._effectiveStates.length > 0 || this._suppressed.length > 0;\n    this._activeStates = [];\n    this._effectiveStates = [];\n    this._suppressed = [];\n    this._resolvedPatch = {};\n    this.resolverPatchCache.clear();\n    this.resolverCacheKey = '';\n    this.resolverCacheValid = false;\n\n    return {\n      changed,\n      activeStates: [],\n      effectiveStates: [],\n      suppressed: []\n    };\n  }\n\n  invalidateResolverCache(): void {\n    this.resolverPatchCache.clear();\n    this.resolverCacheKey = '';\n    this.resolverCacheValid = false;\n    getStageStatePerfMonitor(this.graphic?.stage)?.recordResolver('invalidations');\n  }\n\n  hasState(stateName?: string): boolean {\n    if (!this._activeStates.length) {\n      return false;\n    }\n\n    if (stateName == null) {\n      return true;\n    }\n\n    return this._activeStates.includes(stateName);\n  }\n\n  getCompatPatch(stateName: string): Partial<T> | undefined {\n    const targetStates = this._activeStates.length ? this._activeStates : this._effectiveStates;\n    const canUseStateProxy = this.canUseStateProxy(stateName);\n    const proxyPatch = canUseStateProxy ? this.stateProxy?.(stateName, targetStates) : undefined;\n    if (this.stateProxy && canUseStateProxy) {\n      return proxyPatch ?? undefined;\n    }\n\n    const value = this.states?.[stateName];\n    if (value == null) {\n      return undefined;\n    }\n\n    if (!isPlainObject(value)) {\n      return value as Partial<T>;\n    }\n\n    const keys = Object.keys(value);\n    const hasFullKey = keys.some(key => FULL_DEFINITION_KEYS.has(key));\n    if (!hasFullKey) {\n      return value as Partial<T>;\n    }\n\n    return cloneValue(((value as Record<string, any>).patch ?? undefined) as Partial<T> | undefined);\n  }\n\n  private sortStates(states: string[]): string[] {\n    const withDefinition: string[] = [];\n    const withoutDefinition: string[] = [];\n\n    states.forEach(stateName => {\n      if (this.compiledDefinitions.has(stateName)) {\n        withDefinition.push(stateName);\n      } else {\n        withoutDefinition.push(stateName);\n      }\n    });\n\n    withDefinition.sort((left, right) => {\n      const leftDefinition = this.compiledDefinitions.get(left);\n      const rightDefinition = this.compiledDefinitions.get(right);\n      if (!leftDefinition || !rightDefinition) {\n        return 0;\n      }\n      if (leftDefinition.priority !== rightDefinition.priority) {\n        return leftDefinition.priority - rightDefinition.priority;\n      }\n      return leftDefinition.rank - rightDefinition.rank;\n    });\n\n    if (this.stateSort && withoutDefinition.length > 1) {\n      withoutDefinition.sort(this.stateSort);\n    }\n\n    return withDefinition.concat(withoutDefinition);\n  }\n\n  private adjudicate(sortedStates: string[]): { active: string[]; suppressedSet: Set<string> } {\n    const candidate = sortedStates.slice();\n    const suppressedSet = new Set<string>();\n\n    for (let index = candidate.length - 1; index >= 0; index--) {\n      const stateName = candidate[index];\n      const definition = this.compiledDefinitions.get(stateName);\n      if (!definition) {\n        continue;\n      }\n\n      definition.exclude.forEach(excludedState => {\n        const excludedIndex = candidate.indexOf(excludedState);\n        if (excludedIndex === -1) {\n          return;\n        }\n\n        candidate.splice(excludedIndex, 1);\n        if (excludedIndex < index) {\n          index -= 1;\n        }\n      });\n\n      definition.suppress.forEach(suppressedState => {\n        suppressedSet.add(suppressedState);\n      });\n    }\n\n    return {\n      active: candidate,\n      suppressedSet\n    };\n  }\n\n  private recomputePatch(effectiveStates: string[]): void {\n    const perfMonitor = getStageStatePerfMonitor(this.graphic?.stage);\n    const patchStart = perfMonitor ? performance.now() : 0;\n    let resolverCost = 0;\n    const cacheKey = effectiveStates.join(',');\n    const nextPatch: Partial<T> = {};\n    perfMonitor?.recordAllocation('patchObjectsCreated');\n\n    if (this.resolverCacheValid && this.resolverCacheKey === cacheKey) {\n      effectiveStates.forEach(stateName => {\n        const canUseStateProxy = this.canUseStateProxy(stateName);\n        const proxyPatch = canUseStateProxy ? this.stateProxy?.(stateName, effectiveStates) : undefined;\n        if (this.stateProxy && canUseStateProxy) {\n          if (proxyPatch != null) {\n            this.mergeInto(nextPatch, proxyPatch);\n          }\n          return;\n        }\n\n        const definition = this.compiledDefinitions.get(stateName);\n        if (!definition) {\n          const compatPatch = this.getCompatPatch(stateName);\n          if (compatPatch) {\n            this.mergeInto(nextPatch, compatPatch);\n          }\n          return;\n        }\n\n        if (definition.patch) {\n          this.mergeInto(nextPatch, definition.patch);\n        }\n\n        if (definition.hasResolver) {\n          const cachedPatch = this.resolverPatchCache.get(stateName);\n          if (cachedPatch) {\n            perfMonitor?.recordResolver('cacheHits');\n            this.mergeInto(nextPatch, cachedPatch);\n          }\n        }\n      });\n    } else {\n      this.resolverPatchCache.clear();\n      this.resolverCacheKey = cacheKey;\n\n      effectiveStates.forEach(stateName => {\n        const canUseStateProxy = this.canUseStateProxy(stateName);\n        const proxyPatch = canUseStateProxy ? this.stateProxy?.(stateName, effectiveStates) : undefined;\n        if (this.stateProxy && canUseStateProxy) {\n          if (proxyPatch != null) {\n            this.mergeInto(nextPatch, proxyPatch);\n          }\n          return;\n        }\n\n        const definition = this.compiledDefinitions.get(stateName);\n        if (!definition) {\n          const compatPatch = this.getCompatPatch(stateName);\n          if (compatPatch) {\n            this.mergeInto(nextPatch, compatPatch);\n          }\n          return;\n        }\n\n        if (definition.patch) {\n          this.mergeInto(nextPatch, definition.patch);\n        }\n\n        if (definition.hasResolver && definition.resolver) {\n          perfMonitor?.recordResolver('cacheMisses');\n          const resolverStart = perfMonitor ? performance.now() : 0;\n          const resolverPatch = definition.resolver({\n            graphic: this.graphic,\n            activeStates: this._activeStates,\n            effectiveStates: this._effectiveStates,\n            baseAttributes: this.baseAttributes,\n            resolvedPatch: nextPatch\n          });\n          if (perfMonitor) {\n            const duration = performance.now() - resolverStart;\n            resolverCost += duration;\n            perfMonitor.recordCost('resolver', duration);\n          }\n          if (resolverPatch) {\n            this.resolverPatchCache.set(stateName, resolverPatch);\n            this.mergeInto(nextPatch, resolverPatch);\n          }\n        }\n      });\n\n      this.resolverCacheValid = true;\n    }\n\n    this._resolvedPatch = nextPatch;\n    if (perfMonitor) {\n      const totalCost = performance.now() - patchStart;\n      perfMonitor.recordCost('patch', Math.max(0, totalCost - resolverCost));\n    }\n  }\n\n  private mergeInto(target: Partial<T>, patch: Partial<T>): void {\n    if (this.mergeMode === 'deep') {\n      Object.keys(patch).forEach(key => {\n        const nextValue = (patch as Record<string, any>)[key];\n        const previousValue = (target as Record<string, any>)[key];\n        const baseValue = (this.baseAttributes as Record<string, any>)?.[key];\n\n        if (isPlainObject(previousValue) && isPlainObject(nextValue)) {\n          (target as Record<string, any>)[key] = deepMerge(previousValue, nextValue);\n          return;\n        }\n\n        if (!isPlainObject(previousValue) && isPlainObject(baseValue) && isPlainObject(nextValue)) {\n          (target as Record<string, any>)[key] = deepMerge(baseValue, nextValue);\n          return;\n        }\n\n        (target as Record<string, any>)[key] = cloneValue(nextValue);\n      });\n      return;\n    }\n\n    Object.keys(patch).forEach(key => {\n      (target as Record<string, any>)[key] = cloneValue((patch as Record<string, any>)[key]);\n    });\n  }\n\n  private sameArray(left: readonly string[], right: readonly string[]): boolean {\n    if (left.length !== right.length) {\n      return false;\n    }\n\n    for (let index = 0; index < left.length; index++) {\n      if (left[index] !== right[index]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  private canUseStateProxy(stateName: string): boolean {\n    if (!this.stateProxy) {\n      return false;\n    }\n\n    return this.stateProxyEligibility ? this.stateProxyEligibility(stateName) : true;\n  }\n}\n"]}

package/es/graphic/state/state-model.d.ts

@@ -0,0 +1,43 @@
+import type { StateDefinition, StateDefinitionsInput } from './state-definition';
+import type { StateEngine } from './state-engine';
+export type StateSort = (stateA: string, stateB: string) => number;
+export type StateProxy<T> = (stateName: string, targetStates?: string[]) => Partial<T> | undefined;
+export interface IStateModelOptions<T> {
+    states?: StateDefinitionsInput<T>;
+    currentStates?: string[];
+    stateSort?: StateSort;
+    stateProxy?: StateProxy<T>;
+    exclusiveGroups?: Record<string, string[]>;
+    stateEngine?: StateEngine<T>;
+}
+export interface IStateModelTransition {
+    changed: boolean;
+    states: string[];
+    effectiveStates?: string[];
+}
+export declare class StateModel<T extends Record<string, any> = Record<string, any>> {
+    states?: StateDefinitionsInput<T>;
+    currentStates?: string[];
+    stateSort?: StateSort;
+    stateProxy?: StateProxy<T>;
+    readonly stateEngine?: StateEngine<T>;
+    private readonly exclusiveGroupMap;
+    private readonly exclusiveGroups;
+    constructor(options?: IStateModelOptions<T>);
+    getCurrentStates(): string[];
+    hasState(stateName?: string): boolean;
+    getState(stateName: string): Partial<T> | StateDefinition<T> | undefined;
+    useStates(states: string[]): IStateModelTransition;
+    clearStates(): IStateModelTransition;
+    addState(stateName: string, keepCurrentStates?: boolean): IStateModelTransition;
+    removeState(stateName: string | string[]): IStateModelTransition;
+    toggleState(stateName: string): IStateModelTransition;
+    sortStates(states: string[]): string[];
+    registerExclusiveGroup(groupName: string, states: string[]): void;
+    getExclusiveGroup(stateName: string): string | undefined;
+    getMutuallyExclusiveStates(stateName: string): string[];
+    isMutuallyExclusive(stateA: string, stateB: string): boolean;
+    get effectiveStates(): ReadonlyArray<string>;
+    get resolvedPatch(): Partial<T> | undefined;
+    private sameStates;
+}

package/es/graphic/state/state-model.js

@@ -0,0 +1,135 @@
+export class StateModel {
+    constructor(options = {}) {
+        var _a;
+        this.exclusiveGroupMap = new Map, this.exclusiveGroups = new Map, this.states = options.states, 
+        this.currentStates = options.currentStates ? [ ...options.currentStates ] : void 0, 
+        this.stateSort = options.stateSort, this.stateProxy = options.stateProxy, this.stateEngine = options.stateEngine, 
+        this.stateEngine && options.currentStates && !this.sameStates(this.stateEngine.activeStates, options.currentStates) && this.stateEngine.applyStates(options.currentStates);
+        const exclusiveGroups = null !== (_a = options.exclusiveGroups) && void 0 !== _a ? _a : {};
+        for (const groupName in exclusiveGroups) Object.prototype.hasOwnProperty.call(exclusiveGroups, groupName) && this.registerExclusiveGroup(groupName, exclusiveGroups[groupName]);
+    }
+    getCurrentStates() {
+        return this.currentStates ? [ ...this.currentStates ] : [];
+    }
+    hasState(stateName) {
+        return this.stateEngine ? this.stateEngine.hasState(stateName) : !(!this.currentStates || !this.currentStates.length) && (null == stateName || this.currentStates.includes(stateName));
+    }
+    getState(stateName) {
+        var _a;
+        return null === (_a = this.states) || void 0 === _a ? void 0 : _a[stateName];
+    }
+    useStates(states) {
+        var _a;
+        if (this.stateEngine) {
+            const result = this.stateEngine.applyStates(states);
+            return this.currentStates = [ ...result.activeStates ], {
+                changed: result.changed,
+                states: [ ...result.activeStates ],
+                effectiveStates: [ ...result.effectiveStates ]
+            };
+        }
+        if (!states.length) return this.clearStates();
+        const previousStates = null !== (_a = this.currentStates) && void 0 !== _a ? _a : [], changed = previousStates.length !== states.length || states.some(((stateName, index) => previousStates[index] !== stateName)), nextStates = this.sortStates(states);
+        return changed && (this.currentStates = nextStates), {
+            changed: changed,
+            states: changed ? [ ...nextStates ] : [ ...previousStates ]
+        };
+    }
+    clearStates() {
+        if (this.stateEngine) {
+            const result = this.stateEngine.clearStates();
+            return this.currentStates = [], {
+                changed: result.changed,
+                states: [],
+                effectiveStates: []
+            };
+        }
+        const changed = this.hasState();
+        return this.currentStates = [], {
+            changed: changed,
+            states: []
+        };
+    }
+    addState(stateName, keepCurrentStates) {
+        var _a;
+        if (this.stateEngine) {
+            const result = this.stateEngine.addState(stateName, keepCurrentStates);
+            return this.currentStates = [ ...result.activeStates ], {
+                changed: result.changed,
+                states: [ ...result.activeStates ],
+                effectiveStates: [ ...result.effectiveStates ]
+            };
+        }
+        if (this.currentStates && this.currentStates.includes(stateName) && (keepCurrentStates || 1 === this.currentStates.length)) return {
+            changed: !1,
+            states: this.getCurrentStates()
+        };
+        const nextStates = keepCurrentStates && (null === (_a = this.currentStates) || void 0 === _a ? void 0 : _a.length) ? this.currentStates.concat([ stateName ]) : [ stateName ];
+        return this.useStates(nextStates);
+    }
+    removeState(stateName) {
+        if (this.stateEngine) {
+            const result = this.stateEngine.removeState(stateName);
+            return this.currentStates = [ ...result.activeStates ], {
+                changed: result.changed,
+                states: [ ...result.activeStates ],
+                effectiveStates: [ ...result.effectiveStates ]
+            };
+        }
+        if (!this.currentStates) return {
+            changed: !1,
+            states: []
+        };
+        const filter = Array.isArray(stateName) ? s => !stateName.includes(s) : s => s !== stateName, nextStates = this.currentStates.filter(filter);
+        return nextStates.length === this.currentStates.length ? {
+            changed: !1,
+            states: this.getCurrentStates()
+        } : this.useStates(nextStates);
+    }
+    toggleState(stateName) {
+        if (this.stateEngine) {
+            const result = this.stateEngine.toggleState(stateName);
+            return this.currentStates = [ ...result.activeStates ], {
+                changed: result.changed,
+                states: [ ...result.activeStates ],
+                effectiveStates: [ ...result.effectiveStates ]
+            };
+        }
+        if (this.hasState(stateName)) return this.removeState(stateName);
+        const nextStates = this.currentStates ? this.currentStates.slice() : [];
+        return nextStates.includes(stateName) || nextStates.push(stateName), this.useStates(nextStates);
+    }
+    sortStates(states) {
+        return this.stateEngine ? [ ...this.stateEngine.activeStates ] : this.stateSort ? [ ...states ].sort(this.stateSort) : [ ...states ];
+    }
+    registerExclusiveGroup(groupName, states) {
+        const uniqueStates = Array.from(new Set(states));
+        this.exclusiveGroups.set(groupName, uniqueStates), uniqueStates.forEach((stateName => this.exclusiveGroupMap.set(stateName, groupName)));
+    }
+    getExclusiveGroup(stateName) {
+        return this.exclusiveGroupMap.get(stateName);
+    }
+    getMutuallyExclusiveStates(stateName) {
+        var _a;
+        const groupName = this.getExclusiveGroup(stateName);
+        return groupName ? (null !== (_a = this.exclusiveGroups.get(groupName)) && void 0 !== _a ? _a : []).filter((name => name !== stateName)) : [];
+    }
+    isMutuallyExclusive(stateA, stateB) {
+        const groupName = this.getExclusiveGroup(stateA);
+        return !!groupName && groupName === this.getExclusiveGroup(stateB) && stateA !== stateB;
+    }
+    get effectiveStates() {
+        var _a, _b, _c;
+        return null !== (_c = null !== (_b = null === (_a = this.stateEngine) || void 0 === _a ? void 0 : _a.effectiveStates) && void 0 !== _b ? _b : this.currentStates) && void 0 !== _c ? _c : [];
+    }
+    get resolvedPatch() {
+        var _a;
+        return null === (_a = this.stateEngine) || void 0 === _a ? void 0 : _a.resolvedPatch;
+    }
+    sameStates(left, right) {
+        if (left.length !== right.length) return !1;
+        for (let index = 0; index < left.length; index++) if (left[index] !== right[index]) return !1;
+        return !0;
+    }
+}
+//# sourceMappingURL=state-model.js.map

package/es/graphic/state/state-model.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graphic/state/state-model.ts"],"names":[],"mappings":"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","file":"state-model.js","sourcesContent":["import type { StateDefinition, StateDefinitionsInput } from './state-definition';\nimport type { StateEngine } from './state-engine';\n\nexport type StateSort = (stateA: string, stateB: string) => number;\n\nexport type StateProxy<T> = (stateName: string, targetStates?: string[]) => Partial<T> | undefined;\n\nexport interface IStateModelOptions<T> {\n  states?: StateDefinitionsInput<T>;\n  currentStates?: string[];\n  stateSort?: StateSort;\n  stateProxy?: StateProxy<T>;\n  exclusiveGroups?: Record<string, string[]>;\n  stateEngine?: StateEngine<T>;\n}\n\nexport interface IStateModelTransition {\n  changed: boolean;\n  states: string[];\n  effectiveStates?: string[];\n}\n\nexport class StateModel<T extends Record<string, any> = Record<string, any>> {\n  states?: StateDefinitionsInput<T>;\n  currentStates?: string[];\n  stateSort?: StateSort;\n  stateProxy?: StateProxy<T>;\n  readonly stateEngine?: StateEngine<T>;\n\n  private readonly exclusiveGroupMap = new Map<string, string>();\n  private readonly exclusiveGroups = new Map<string, string[]>();\n\n  constructor(options: IStateModelOptions<T> = {}) {\n    this.states = options.states;\n    this.currentStates = options.currentStates ? [...options.currentStates] : undefined;\n    this.stateSort = options.stateSort;\n    this.stateProxy = options.stateProxy;\n    this.stateEngine = options.stateEngine;\n\n    if (\n      this.stateEngine &&\n      options.currentStates &&\n      !this.sameStates(this.stateEngine.activeStates, options.currentStates)\n    ) {\n      this.stateEngine.applyStates(options.currentStates);\n    }\n\n    const exclusiveGroups = options.exclusiveGroups ?? {};\n    for (const groupName in exclusiveGroups) {\n      if (!Object.prototype.hasOwnProperty.call(exclusiveGroups, groupName)) {\n        continue;\n      }\n      this.registerExclusiveGroup(groupName, exclusiveGroups[groupName]);\n    }\n  }\n\n  getCurrentStates(): string[] {\n    return this.currentStates ? [...this.currentStates] : [];\n  }\n\n  hasState(stateName?: string): boolean {\n    if (this.stateEngine) {\n      return this.stateEngine.hasState(stateName);\n    }\n\n    if (!this.currentStates || !this.currentStates.length) {\n      return false;\n    }\n\n    if (stateName == null) {\n      return true;\n    }\n\n    return this.currentStates.includes(stateName);\n  }\n\n  getState(stateName: string): Partial<T> | StateDefinition<T> | undefined {\n    return this.states?.[stateName];\n  }\n\n  useStates(states: string[]): IStateModelTransition {\n    if (this.stateEngine) {\n      const result = this.stateEngine.applyStates(states);\n      this.currentStates = [...result.activeStates];\n      return {\n        changed: result.changed,\n        states: [...result.activeStates],\n        effectiveStates: [...result.effectiveStates]\n      };\n    }\n\n    if (!states.length) {\n      return this.clearStates();\n    }\n\n    const previousStates = this.currentStates ?? [];\n    const changed =\n      previousStates.length !== states.length || states.some((stateName, index) => previousStates[index] !== stateName);\n\n    const nextStates = this.sortStates(states);\n\n    if (changed) {\n      this.currentStates = nextStates;\n    }\n\n    return {\n      changed,\n      states: changed ? [...nextStates] : [...previousStates]\n    };\n  }\n\n  clearStates(): IStateModelTransition {\n    if (this.stateEngine) {\n      const result = this.stateEngine.clearStates();\n      this.currentStates = [];\n      return {\n        changed: result.changed,\n        states: [],\n        effectiveStates: []\n      };\n    }\n\n    const changed = this.hasState();\n    this.currentStates = [];\n\n    return {\n      changed,\n      states: []\n    };\n  }\n\n  addState(stateName: string, keepCurrentStates?: boolean): IStateModelTransition {\n    if (this.stateEngine) {\n      const result = this.stateEngine.addState(stateName, keepCurrentStates);\n      this.currentStates = [...result.activeStates];\n      return {\n        changed: result.changed,\n        states: [...result.activeStates],\n        effectiveStates: [...result.effectiveStates]\n      };\n    }\n\n    if (\n      this.currentStates &&\n      this.currentStates.includes(stateName) &&\n      (keepCurrentStates || this.currentStates.length === 1)\n    ) {\n      return {\n        changed: false,\n        states: this.getCurrentStates()\n      };\n    }\n\n    const nextStates =\n      keepCurrentStates && this.currentStates?.length ? this.currentStates.concat([stateName]) : [stateName];\n\n    return this.useStates(nextStates);\n  }\n\n  removeState(stateName: string | string[]): IStateModelTransition {\n    if (this.stateEngine) {\n      const result = this.stateEngine.removeState(stateName);\n      this.currentStates = [...result.activeStates];\n      return {\n        changed: result.changed,\n        states: [...result.activeStates],\n        effectiveStates: [...result.effectiveStates]\n      };\n    }\n\n    if (!this.currentStates) {\n      return {\n        changed: false,\n        states: []\n      };\n    }\n\n    const filter = Array.isArray(stateName) ? (s: string) => !stateName.includes(s) : (s: string) => s !== stateName;\n    const nextStates = this.currentStates.filter(filter);\n\n    if (nextStates.length === this.currentStates.length) {\n      return {\n        changed: false,\n        states: this.getCurrentStates()\n      };\n    }\n\n    return this.useStates(nextStates);\n  }\n\n  toggleState(stateName: string): IStateModelTransition {\n    if (this.stateEngine) {\n      const result = this.stateEngine.toggleState(stateName);\n      this.currentStates = [...result.activeStates];\n      return {\n        changed: result.changed,\n        states: [...result.activeStates],\n        effectiveStates: [...result.effectiveStates]\n      };\n    }\n\n    if (this.hasState(stateName)) {\n      return this.removeState(stateName);\n    }\n\n    const nextStates = this.currentStates ? this.currentStates.slice() : [];\n    if (!nextStates.includes(stateName)) {\n      nextStates.push(stateName);\n    }\n\n    return this.useStates(nextStates);\n  }\n\n  sortStates(states: string[]): string[] {\n    if (this.stateEngine) {\n      return [...this.stateEngine.activeStates];\n    }\n\n    if (!this.stateSort) {\n      return [...states];\n    }\n\n    return [...states].sort(this.stateSort);\n  }\n\n  registerExclusiveGroup(groupName: string, states: string[]): void {\n    const uniqueStates = Array.from(new Set(states));\n    this.exclusiveGroups.set(groupName, uniqueStates);\n    uniqueStates.forEach(stateName => this.exclusiveGroupMap.set(stateName, groupName));\n  }\n\n  getExclusiveGroup(stateName: string): string | undefined {\n    return this.exclusiveGroupMap.get(stateName);\n  }\n\n  getMutuallyExclusiveStates(stateName: string): string[] {\n    const groupName = this.getExclusiveGroup(stateName);\n    if (!groupName) {\n      return [];\n    }\n\n    return (this.exclusiveGroups.get(groupName) ?? []).filter(name => name !== stateName);\n  }\n\n  isMutuallyExclusive(stateA: string, stateB: string): boolean {\n    const groupName = this.getExclusiveGroup(stateA);\n    return !!groupName && groupName === this.getExclusiveGroup(stateB) && stateA !== stateB;\n  }\n\n  get effectiveStates(): ReadonlyArray<string> {\n    return this.stateEngine?.effectiveStates ?? this.currentStates ?? [];\n  }\n\n  get resolvedPatch(): Partial<T> | undefined {\n    return this.stateEngine?.resolvedPatch;\n  }\n\n  private sameStates(left: readonly string[], right: readonly string[]): boolean {\n    if (left.length !== right.length) {\n      return false;\n    }\n\n    for (let index = 0; index < left.length; index++) {\n      if (left[index] !== right[index]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n"]}

package/es/graphic/state/state-perf-monitor.d.ts

@@ -0,0 +1,119 @@
+import type { IGroup, ILayer, IStage } from '../../interface';
+import { UpdateCategory } from './attribute-update-classifier';
+export type DeferredIneligibleReason = 'config_disabled' | 'context_disabled' | 'non_batch_operation' | 'mixed_update_category' | 'resolver_unstable_keys' | 'graphic_unavailable';
+export interface IStatePerfConfig {
+    enabled?: boolean;
+    recordEvents?: boolean;
+    maxEventRecords?: number;
+}
+export interface IDeferredStateConfig {
+    enabled?: boolean;
+    frameBudget?: number;
+    maxGraphicsPerFrame?: number;
+}
+export interface IDeferredStateContextConfig {
+    deferred?: IDeferredStateConfig;
+    priority?: number;
+    localEnabled?: boolean;
+}
+export type IDeferredStateOwnerConfig = IDeferredStateConfig | IDeferredStateContextConfig;
+export type IStatePerfEventType = 'state-commit' | 'shared-refresh-flush' | 'deferred-job-start' | 'deferred-job-yield' | 'deferred-job-cancel' | 'deferred-job-complete' | 'deferred-ineligible';
+export interface IStatePerfEventRecord {
+    type: IStatePerfEventType;
+    at: number;
+    detail?: Record<string, unknown>;
+}
+export interface IStatePerfSnapshot {
+    counters: {
+        stateCommits: number;
+        sharedRefreshCommits: number;
+        deferredJobsCreated: number;
+        deferredJobsCompleted: number;
+        deferredJobsCancelled: number;
+        deferredJobsCoalesced: number;
+        deferredGraphicsCommitted: number;
+        deferredBudgetYields: number;
+        deferredIneligibleGraphics: number;
+    };
+    deferredIneligibleByReason: Record<DeferredIneligibleReason, number>;
+    categoryBreakdown: {
+        paint: number;
+        transform: number;
+        shape: number;
+        bounds: number;
+        layout: number;
+        pick: number;
+    };
+    refresh: {
+        queuedGraphics: number;
+        flushedGraphics: number;
+        ensureFreshCalls: number;
+        renderScheduled: number;
+    };
+    resolver: {
+        cacheHits: number;
+        cacheMisses: number;
+        invalidations: number;
+    };
+    cost: {
+        resolverTotalMs: number;
+        resolverMaxMs: number;
+        patchTotalMs: number;
+        patchMaxMs: number;
+        sharedRefreshTotalMs: number;
+        sharedRefreshMaxMs: number;
+        batchSliceTotalMs: number;
+        batchSliceMaxMs: number;
+    };
+    allocationHints: {
+        patchObjectsCreated: number;
+        batchEntriesCreated: number;
+        refreshQueuePushes: number;
+    };
+    batch: {
+        pendingJobs: number;
+        maxPendingJobs: number;
+        maxGraphicsInJob: number;
+        maxFrameSliceCost: number;
+    };
+    events?: IStatePerfEventRecord[];
+}
+type SnapshotCounterKey = keyof IStatePerfSnapshot['counters'];
+type SnapshotRefreshKey = keyof IStatePerfSnapshot['refresh'];
+type SnapshotResolverKey = keyof IStatePerfSnapshot['resolver'];
+type SnapshotAllocationKey = keyof IStatePerfSnapshot['allocationHints'];
+type SnapshotCostKind = 'resolver' | 'patch' | 'sharedRefresh' | 'batchSlice';
+export interface IResolvedDeferredContext {
+    contextOwner: IStage | ILayer | IGroup;
+    contextOwnerId: number;
+    config: Required<IDeferredStateConfig>;
+    configFingerprint: string;
+}
+export declare function createEmptyStatePerfSnapshot(): IStatePerfSnapshot;
+export declare function normalizeDeferredStateOwnerConfig(value?: IDeferredStateOwnerConfig): IDeferredStateContextConfig | undefined;
+export declare function normalizeDeferredStateConfig(config?: IDeferredStateConfig): Required<IDeferredStateConfig>;
+export declare function fingerprintDeferredStateConfig(config: Required<IDeferredStateConfig>): string;
+export declare class StatePerfMonitor {
+    private configSource?;
+    private readonly snapshot;
+    constructor(configSource?: IStatePerfConfig | (() => IStatePerfConfig | undefined));
+    setConfig(config?: IStatePerfConfig): void;
+    getSnapshot(): IStatePerfSnapshot;
+    reset(): void;
+    incrementCounter(key: SnapshotCounterKey, delta?: number): void;
+    recordDeferredIneligible(reason: DeferredIneligibleReason, delta?: number): void;
+    recordCategory(category: UpdateCategory): void;
+    recordRefresh(key: SnapshotRefreshKey, delta?: number): void;
+    recordResolver(key: SnapshotResolverKey, delta?: number): void;
+    recordCost(kind: SnapshotCostKind, durationMs: number): void;
+    recordAllocation(key: SnapshotAllocationKey, delta?: number): void;
+    updateBatchPending(pendingJobs: number): void;
+    updateMaxGraphicsInJob(count: number): void;
+    recordEvent(type: IStatePerfEventType, detail?: Record<string, unknown>): void;
+    private isEnabled;
+    private shouldRecordEvents;
+    private getConfig;
+}
+export declare function ensureStageStatePerfMonitor(stage: IStage): StatePerfMonitor;
+export declare function getStageStatePerfMonitor(stage?: IStage): StatePerfMonitor | undefined;
+export {};