@visactor/vrender-core 1.1.0-alpha.0 → 1.1.0-alpha.2

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 {};

package/es/graphic/state/state-perf-monitor.js

@@ -0,0 +1,207 @@
+import { UpdateCategory } from "./attribute-update-classifier";
+
+const DEFAULT_MAX_EVENT_RECORDS = 100, STAGE_PERF_MONITOR = Symbol("vrender.statePerfMonitor");
+
+function createReasonBreakdown() {
+    return {
+        config_disabled: 0,
+        context_disabled: 0,
+        non_batch_operation: 0,
+        mixed_update_category: 0,
+        resolver_unstable_keys: 0,
+        graphic_unavailable: 0
+    };
+}
+
+export function createEmptyStatePerfSnapshot() {
+    return {
+        counters: {
+            stateCommits: 0,
+            sharedRefreshCommits: 0,
+            deferredJobsCreated: 0,
+            deferredJobsCompleted: 0,
+            deferredJobsCancelled: 0,
+            deferredJobsCoalesced: 0,
+            deferredGraphicsCommitted: 0,
+            deferredBudgetYields: 0,
+            deferredIneligibleGraphics: 0
+        },
+        deferredIneligibleByReason: createReasonBreakdown(),
+        categoryBreakdown: {
+            paint: 0,
+            transform: 0,
+            shape: 0,
+            bounds: 0,
+            layout: 0,
+            pick: 0
+        },
+        refresh: {
+            queuedGraphics: 0,
+            flushedGraphics: 0,
+            ensureFreshCalls: 0,
+            renderScheduled: 0
+        },
+        resolver: {
+            cacheHits: 0,
+            cacheMisses: 0,
+            invalidations: 0
+        },
+        cost: {
+            resolverTotalMs: 0,
+            resolverMaxMs: 0,
+            patchTotalMs: 0,
+            patchMaxMs: 0,
+            sharedRefreshTotalMs: 0,
+            sharedRefreshMaxMs: 0,
+            batchSliceTotalMs: 0,
+            batchSliceMaxMs: 0
+        },
+        allocationHints: {
+            patchObjectsCreated: 0,
+            batchEntriesCreated: 0,
+            refreshQueuePushes: 0
+        },
+        batch: {
+            pendingJobs: 0,
+            maxPendingJobs: 0,
+            maxGraphicsInJob: 0,
+            maxFrameSliceCost: 0
+        },
+        events: []
+    };
+}
+
+function cloneSnapshot(snapshot) {
+    return {
+        counters: Object.assign({}, snapshot.counters),
+        deferredIneligibleByReason: Object.assign({}, snapshot.deferredIneligibleByReason),
+        categoryBreakdown: Object.assign({}, snapshot.categoryBreakdown),
+        refresh: Object.assign({}, snapshot.refresh),
+        resolver: Object.assign({}, snapshot.resolver),
+        cost: Object.assign({}, snapshot.cost),
+        allocationHints: Object.assign({}, snapshot.allocationHints),
+        batch: Object.assign({}, snapshot.batch),
+        events: snapshot.events ? snapshot.events.slice() : []
+    };
+}
+
+function isDeferredStateContextConfig(value) {
+    return !!value && (Object.prototype.hasOwnProperty.call(value, "deferred") || Object.prototype.hasOwnProperty.call(value, "localEnabled"));
+}
+
+export function normalizeDeferredStateOwnerConfig(value) {
+    if (value) return isDeferredStateContextConfig(value) ? value : {
+        deferred: value
+    };
+}
+
+export function normalizeDeferredStateConfig(config) {
+    var _a, _b, _c;
+    return {
+        enabled: null !== (_a = null == config ? void 0 : config.enabled) && void 0 !== _a && _a,
+        frameBudget: null !== (_b = null == config ? void 0 : config.frameBudget) && void 0 !== _b ? _b : 8,
+        maxGraphicsPerFrame: null !== (_c = null == config ? void 0 : config.maxGraphicsPerFrame) && void 0 !== _c ? _c : 100
+    };
+}
+
+export function fingerprintDeferredStateConfig(config) {
+    return `${config.enabled ? 1 : 0}:${config.frameBudget}:${config.maxGraphicsPerFrame}`;
+}
+
+export class StatePerfMonitor {
+    constructor(configSource) {
+        this.configSource = configSource, this.snapshot = createEmptyStatePerfSnapshot();
+    }
+    setConfig(config) {
+        this.configSource = config;
+    }
+    getSnapshot() {
+        return cloneSnapshot(this.snapshot);
+    }
+    reset() {
+        const next = createEmptyStatePerfSnapshot();
+        Object.assign(this.snapshot.counters, next.counters), Object.assign(this.snapshot.deferredIneligibleByReason, next.deferredIneligibleByReason), 
+        Object.assign(this.snapshot.categoryBreakdown, next.categoryBreakdown), Object.assign(this.snapshot.refresh, next.refresh), 
+        Object.assign(this.snapshot.resolver, next.resolver), Object.assign(this.snapshot.cost, next.cost), 
+        Object.assign(this.snapshot.allocationHints, next.allocationHints), Object.assign(this.snapshot.batch, next.batch), 
+        this.snapshot.events = [];
+    }
+    incrementCounter(key, delta = 1) {
+        this.isEnabled() && (this.snapshot.counters[key] += delta);
+    }
+    recordDeferredIneligible(reason, delta = 1) {
+        this.isEnabled() && (this.snapshot.deferredIneligibleByReason[reason] += delta, 
+        this.snapshot.counters.deferredIneligibleGraphics += delta, this.recordEvent("deferred-ineligible", {
+            reason: reason,
+            count: delta
+        }));
+    }
+    recordCategory(category) {
+        this.isEnabled() && (category & UpdateCategory.PAINT && (this.snapshot.categoryBreakdown.paint += 1), 
+        category & UpdateCategory.TRANSFORM && (this.snapshot.categoryBreakdown.transform += 1), 
+        category & UpdateCategory.SHAPE && (this.snapshot.categoryBreakdown.shape += 1), 
+        category & UpdateCategory.BOUNDS && (this.snapshot.categoryBreakdown.bounds += 1), 
+        category & UpdateCategory.LAYOUT && (this.snapshot.categoryBreakdown.layout += 1), 
+        category & UpdateCategory.PICK && (this.snapshot.categoryBreakdown.pick += 1));
+    }
+    recordRefresh(key, delta = 1) {
+        this.isEnabled() && (this.snapshot.refresh[key] += delta);
+    }
+    recordResolver(key, delta = 1) {
+        this.isEnabled() && (this.snapshot.resolver[key] += delta);
+    }
+    recordCost(kind, durationMs) {
+        if (this.isEnabled()) {
+            if ("resolver" === kind) return this.snapshot.cost.resolverTotalMs += durationMs, 
+            void (this.snapshot.cost.resolverMaxMs = Math.max(this.snapshot.cost.resolverMaxMs, durationMs));
+            if ("patch" === kind) return this.snapshot.cost.patchTotalMs += durationMs, void (this.snapshot.cost.patchMaxMs = Math.max(this.snapshot.cost.patchMaxMs, durationMs));
+            if ("sharedRefresh" === kind) return this.snapshot.cost.sharedRefreshTotalMs += durationMs, 
+            void (this.snapshot.cost.sharedRefreshMaxMs = Math.max(this.snapshot.cost.sharedRefreshMaxMs, durationMs));
+            this.snapshot.cost.batchSliceTotalMs += durationMs, this.snapshot.cost.batchSliceMaxMs = Math.max(this.snapshot.cost.batchSliceMaxMs, durationMs), 
+            this.snapshot.batch.maxFrameSliceCost = Math.max(this.snapshot.batch.maxFrameSliceCost, durationMs);
+        }
+    }
+    recordAllocation(key, delta = 1) {
+        this.isEnabled() && (this.snapshot.allocationHints[key] += delta);
+    }
+    updateBatchPending(pendingJobs) {
+        this.isEnabled() && (this.snapshot.batch.pendingJobs = pendingJobs, this.snapshot.batch.maxPendingJobs = Math.max(this.snapshot.batch.maxPendingJobs, pendingJobs));
+    }
+    updateMaxGraphicsInJob(count) {
+        this.isEnabled() && (this.snapshot.batch.maxGraphicsInJob = Math.max(this.snapshot.batch.maxGraphicsInJob, count));
+    }
+    recordEvent(type, detail) {
+        var _a, _b, _c;
+        if (!this.shouldRecordEvents()) return;
+        const events = null !== (_a = this.snapshot.events) && void 0 !== _a ? _a : this.snapshot.events = [];
+        events.push({
+            type: type,
+            at: Date.now(),
+            detail: detail
+        });
+        const max = null !== (_c = null === (_b = this.getConfig()) || void 0 === _b ? void 0 : _b.maxEventRecords) && void 0 !== _c ? _c : 100;
+        events.length > max && events.splice(0, events.length - max);
+    }
+    isEnabled() {
+        var _a;
+        return !0 === (null === (_a = this.getConfig()) || void 0 === _a ? void 0 : _a.enabled);
+    }
+    shouldRecordEvents() {
+        const config = this.getConfig();
+        return !!(null == config ? void 0 : config.enabled) && !!config.recordEvents;
+    }
+    getConfig() {
+        return "function" == typeof this.configSource ? this.configSource() : this.configSource;
+    }
+}
+
+export function ensureStageStatePerfMonitor(stage) {
+    const stageAny = stage;
+    return stageAny[STAGE_PERF_MONITOR] || (stageAny[STAGE_PERF_MONITOR] = new StatePerfMonitor((() => stage.statePerfConfig))), 
+    stageAny[STAGE_PERF_MONITOR];
+}
+
+export function getStageStatePerfMonitor(stage) {
+    if (stage) return stage[STAGE_PERF_MONITOR];
+}
+//# sourceMappingURL=state-perf-monitor.js.map

package/es/graphic/state/state-perf-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graphic/state/state-perf-monitor.ts"],"names":[],"mappings":"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","file":"state-perf-monitor.js","sourcesContent":["import type { IGroup, ILayer, IStage } from '../../interface';\nimport { UpdateCategory } from './attribute-update-classifier';\n\nexport type DeferredIneligibleReason =\n  | 'config_disabled'\n  | 'context_disabled'\n  | 'non_batch_operation'\n  | 'mixed_update_category'\n  | 'resolver_unstable_keys'\n  | 'graphic_unavailable';\n\nexport interface IStatePerfConfig {\n  enabled?: boolean;\n  recordEvents?: boolean;\n  maxEventRecords?: number;\n}\n\nexport interface IDeferredStateConfig {\n  enabled?: boolean;\n  frameBudget?: number;\n  maxGraphicsPerFrame?: number;\n}\n\nexport interface IDeferredStateContextConfig {\n  deferred?: IDeferredStateConfig;\n  priority?: number;\n  localEnabled?: boolean;\n}\n\nexport type IDeferredStateOwnerConfig = IDeferredStateConfig | IDeferredStateContextConfig;\n\nexport type IStatePerfEventType =\n  | 'state-commit'\n  | 'shared-refresh-flush'\n  | 'deferred-job-start'\n  | 'deferred-job-yield'\n  | 'deferred-job-cancel'\n  | 'deferred-job-complete'\n  | 'deferred-ineligible';\n\nexport interface IStatePerfEventRecord {\n  type: IStatePerfEventType;\n  at: number;\n  detail?: Record<string, unknown>;\n}\n\nexport interface IStatePerfSnapshot {\n  counters: {\n    stateCommits: number;\n    sharedRefreshCommits: number;\n    deferredJobsCreated: number;\n    deferredJobsCompleted: number;\n    deferredJobsCancelled: number;\n    deferredJobsCoalesced: number;\n    deferredGraphicsCommitted: number;\n    deferredBudgetYields: number;\n    deferredIneligibleGraphics: number;\n  };\n  deferredIneligibleByReason: Record<DeferredIneligibleReason, number>;\n  categoryBreakdown: {\n    paint: number;\n    transform: number;\n    shape: number;\n    bounds: number;\n    layout: number;\n    pick: number;\n  };\n  refresh: {\n    queuedGraphics: number;\n    flushedGraphics: number;\n    ensureFreshCalls: number;\n    renderScheduled: number;\n  };\n  resolver: {\n    cacheHits: number;\n    cacheMisses: number;\n    invalidations: number;\n  };\n  cost: {\n    resolverTotalMs: number;\n    resolverMaxMs: number;\n    patchTotalMs: number;\n    patchMaxMs: number;\n    sharedRefreshTotalMs: number;\n    sharedRefreshMaxMs: number;\n    batchSliceTotalMs: number;\n    batchSliceMaxMs: number;\n  };\n  allocationHints: {\n    patchObjectsCreated: number;\n    batchEntriesCreated: number;\n    refreshQueuePushes: number;\n  };\n  batch: {\n    pendingJobs: number;\n    maxPendingJobs: number;\n    maxGraphicsInJob: number;\n    maxFrameSliceCost: number;\n  };\n  events?: IStatePerfEventRecord[];\n}\n\ntype SnapshotCounterKey = keyof IStatePerfSnapshot['counters'];\ntype SnapshotRefreshKey = keyof IStatePerfSnapshot['refresh'];\ntype SnapshotResolverKey = keyof IStatePerfSnapshot['resolver'];\ntype SnapshotAllocationKey = keyof IStatePerfSnapshot['allocationHints'];\ntype SnapshotCostKind = 'resolver' | 'patch' | 'sharedRefresh' | 'batchSlice';\n\nexport interface IResolvedDeferredContext {\n  contextOwner: IStage | ILayer | IGroup;\n  contextOwnerId: number;\n  config: Required<IDeferredStateConfig>;\n  configFingerprint: string;\n}\n\nconst DEFAULT_MAX_EVENT_RECORDS = 100;\nconst STAGE_PERF_MONITOR = Symbol('vrender.statePerfMonitor');\n\nfunction createReasonBreakdown(): Record<DeferredIneligibleReason, number> {\n  return {\n    config_disabled: 0,\n    context_disabled: 0,\n    non_batch_operation: 0,\n    mixed_update_category: 0,\n    resolver_unstable_keys: 0,\n    graphic_unavailable: 0\n  };\n}\n\nexport function createEmptyStatePerfSnapshot(): IStatePerfSnapshot {\n  return {\n    counters: {\n      stateCommits: 0,\n      sharedRefreshCommits: 0,\n      deferredJobsCreated: 0,\n      deferredJobsCompleted: 0,\n      deferredJobsCancelled: 0,\n      deferredJobsCoalesced: 0,\n      deferredGraphicsCommitted: 0,\n      deferredBudgetYields: 0,\n      deferredIneligibleGraphics: 0\n    },\n    deferredIneligibleByReason: createReasonBreakdown(),\n    categoryBreakdown: {\n      paint: 0,\n      transform: 0,\n      shape: 0,\n      bounds: 0,\n      layout: 0,\n      pick: 0\n    },\n    refresh: {\n      queuedGraphics: 0,\n      flushedGraphics: 0,\n      ensureFreshCalls: 0,\n      renderScheduled: 0\n    },\n    resolver: {\n      cacheHits: 0,\n      cacheMisses: 0,\n      invalidations: 0\n    },\n    cost: {\n      resolverTotalMs: 0,\n      resolverMaxMs: 0,\n      patchTotalMs: 0,\n      patchMaxMs: 0,\n      sharedRefreshTotalMs: 0,\n      sharedRefreshMaxMs: 0,\n      batchSliceTotalMs: 0,\n      batchSliceMaxMs: 0\n    },\n    allocationHints: {\n      patchObjectsCreated: 0,\n      batchEntriesCreated: 0,\n      refreshQueuePushes: 0\n    },\n    batch: {\n      pendingJobs: 0,\n      maxPendingJobs: 0,\n      maxGraphicsInJob: 0,\n      maxFrameSliceCost: 0\n    },\n    events: []\n  };\n}\n\nfunction cloneSnapshot(snapshot: IStatePerfSnapshot): IStatePerfSnapshot {\n  return {\n    counters: { ...snapshot.counters },\n    deferredIneligibleByReason: { ...snapshot.deferredIneligibleByReason },\n    categoryBreakdown: { ...snapshot.categoryBreakdown },\n    refresh: { ...snapshot.refresh },\n    resolver: { ...snapshot.resolver },\n    cost: { ...snapshot.cost },\n    allocationHints: { ...snapshot.allocationHints },\n    batch: { ...snapshot.batch },\n    events: snapshot.events ? snapshot.events.slice() : []\n  };\n}\n\nfunction isDeferredStateContextConfig(\n  value: IDeferredStateOwnerConfig | undefined\n): value is IDeferredStateContextConfig {\n  return (\n    !!value &&\n    (Object.prototype.hasOwnProperty.call(value, 'deferred') ||\n      Object.prototype.hasOwnProperty.call(value, 'localEnabled'))\n  );\n}\n\nexport function normalizeDeferredStateOwnerConfig(\n  value?: IDeferredStateOwnerConfig\n): IDeferredStateContextConfig | undefined {\n  if (!value) {\n    return undefined;\n  }\n\n  if (isDeferredStateContextConfig(value)) {\n    return value;\n  }\n\n  return {\n    deferred: value\n  };\n}\n\nexport function normalizeDeferredStateConfig(config?: IDeferredStateConfig): Required<IDeferredStateConfig> {\n  return {\n    enabled: config?.enabled ?? false,\n    frameBudget: config?.frameBudget ?? 8,\n    maxGraphicsPerFrame: config?.maxGraphicsPerFrame ?? 100\n  };\n}\n\nexport function fingerprintDeferredStateConfig(config: Required<IDeferredStateConfig>): string {\n  return `${config.enabled ? 1 : 0}:${config.frameBudget}:${config.maxGraphicsPerFrame}`;\n}\n\nexport class StatePerfMonitor {\n  private readonly snapshot = createEmptyStatePerfSnapshot();\n\n  constructor(private configSource?: IStatePerfConfig | (() => IStatePerfConfig | undefined)) {}\n\n  setConfig(config?: IStatePerfConfig): void {\n    this.configSource = config;\n  }\n\n  getSnapshot(): IStatePerfSnapshot {\n    return cloneSnapshot(this.snapshot);\n  }\n\n  reset(): void {\n    const next = createEmptyStatePerfSnapshot();\n    Object.assign(this.snapshot.counters, next.counters);\n    Object.assign(this.snapshot.deferredIneligibleByReason, next.deferredIneligibleByReason);\n    Object.assign(this.snapshot.categoryBreakdown, next.categoryBreakdown);\n    Object.assign(this.snapshot.refresh, next.refresh);\n    Object.assign(this.snapshot.resolver, next.resolver);\n    Object.assign(this.snapshot.cost, next.cost);\n    Object.assign(this.snapshot.allocationHints, next.allocationHints);\n    Object.assign(this.snapshot.batch, next.batch);\n    this.snapshot.events = [];\n  }\n\n  incrementCounter(key: SnapshotCounterKey, delta: number = 1): void {\n    if (!this.isEnabled()) {\n      return;\n    }\n    this.snapshot.counters[key] += delta;\n  }\n\n  recordDeferredIneligible(reason: DeferredIneligibleReason, delta: number = 1): void {\n    if (!this.isEnabled()) {\n      return;\n    }\n    this.snapshot.deferredIneligibleByReason[reason] += delta;\n    this.snapshot.counters.deferredIneligibleGraphics += delta;\n    this.recordEvent('deferred-ineligible', { reason, count: delta });\n  }\n\n  recordCategory(category: UpdateCategory): void {\n    if (!this.isEnabled()) {\n      return;\n    }\n    if (category & UpdateCategory.PAINT) {\n      this.snapshot.categoryBreakdown.paint += 1;\n    }\n    if (category & UpdateCategory.TRANSFORM) {\n      this.snapshot.categoryBreakdown.transform += 1;\n    }\n    if (category & UpdateCategory.SHAPE) {\n      this.snapshot.categoryBreakdown.shape += 1;\n    }\n    if (category & UpdateCategory.BOUNDS) {\n      this.snapshot.categoryBreakdown.bounds += 1;\n    }\n    if (category & UpdateCategory.LAYOUT) {\n      this.snapshot.categoryBreakdown.layout += 1;\n    }\n    if (category & UpdateCategory.PICK) {\n      this.snapshot.categoryBreakdown.pick += 1;\n    }\n  }\n\n  recordRefresh(key: SnapshotRefreshKey, delta: number = 1): void {\n    if (!this.isEnabled()) {\n      return;\n    }\n    this.snapshot.refresh[key] += delta;\n  }\n\n  recordResolver(key: SnapshotResolverKey, delta: number = 1): void {\n    if (!this.isEnabled()) {\n      return;\n    }\n    this.snapshot.resolver[key] += delta;\n  }\n\n  recordCost(kind: SnapshotCostKind, durationMs: number): void {\n    if (!this.isEnabled()) {\n      return;\n    }\n    if (kind === 'resolver') {\n      this.snapshot.cost.resolverTotalMs += durationMs;\n      this.snapshot.cost.resolverMaxMs = Math.max(this.snapshot.cost.resolverMaxMs, durationMs);\n      return;\n    }\n    if (kind === 'patch') {\n      this.snapshot.cost.patchTotalMs += durationMs;\n      this.snapshot.cost.patchMaxMs = Math.max(this.snapshot.cost.patchMaxMs, durationMs);\n      return;\n    }\n    if (kind === 'sharedRefresh') {\n      this.snapshot.cost.sharedRefreshTotalMs += durationMs;\n      this.snapshot.cost.sharedRefreshMaxMs = Math.max(this.snapshot.cost.sharedRefreshMaxMs, durationMs);\n      return;\n    }\n\n    this.snapshot.cost.batchSliceTotalMs += durationMs;\n    this.snapshot.cost.batchSliceMaxMs = Math.max(this.snapshot.cost.batchSliceMaxMs, durationMs);\n    this.snapshot.batch.maxFrameSliceCost = Math.max(this.snapshot.batch.maxFrameSliceCost, durationMs);\n  }\n\n  recordAllocation(key: SnapshotAllocationKey, delta: number = 1): void {\n    if (!this.isEnabled()) {\n      return;\n    }\n    this.snapshot.allocationHints[key] += delta;\n  }\n\n  updateBatchPending(pendingJobs: number): void {\n    if (!this.isEnabled()) {\n      return;\n    }\n    this.snapshot.batch.pendingJobs = pendingJobs;\n    this.snapshot.batch.maxPendingJobs = Math.max(this.snapshot.batch.maxPendingJobs, pendingJobs);\n  }\n\n  updateMaxGraphicsInJob(count: number): void {\n    if (!this.isEnabled()) {\n      return;\n    }\n    this.snapshot.batch.maxGraphicsInJob = Math.max(this.snapshot.batch.maxGraphicsInJob, count);\n  }\n\n  recordEvent(type: IStatePerfEventType, detail?: Record<string, unknown>): void {\n    if (!this.shouldRecordEvents()) {\n      return;\n    }\n    const events = this.snapshot.events ?? (this.snapshot.events = []);\n    events.push({\n      type,\n      at: Date.now(),\n      detail\n    });\n    const max = this.getConfig()?.maxEventRecords ?? DEFAULT_MAX_EVENT_RECORDS;\n    if (events.length > max) {\n      events.splice(0, events.length - max);\n    }\n  }\n\n  private isEnabled(): boolean {\n    return this.getConfig()?.enabled === true;\n  }\n\n  private shouldRecordEvents(): boolean {\n    const config = this.getConfig();\n    return !!config?.enabled && !!config.recordEvents;\n  }\n\n  private getConfig(): IStatePerfConfig | undefined {\n    return typeof this.configSource === 'function' ? this.configSource() : this.configSource;\n  }\n}\n\nexport function ensureStageStatePerfMonitor(stage: IStage): StatePerfMonitor {\n  const stageAny = stage as any;\n  if (!stageAny[STAGE_PERF_MONITOR]) {\n    stageAny[STAGE_PERF_MONITOR] = new StatePerfMonitor(() => (stage as any).statePerfConfig);\n  }\n\n  return stageAny[STAGE_PERF_MONITOR] as StatePerfMonitor;\n}\n\nexport function getStageStatePerfMonitor(stage?: IStage): StatePerfMonitor | undefined {\n  if (!stage) {\n    return undefined;\n  }\n  return (stage as any)[STAGE_PERF_MONITOR] as StatePerfMonitor | undefined;\n}\n"]}

package/es/graphic/state/state-style-resolver.d.ts

@@ -0,0 +1,22 @@
+import type { CompiledStateDefinition } from './state-definition';
+import type { StateProxy, StateSort } from './state-model';
+export type StateMergeMode = 'shallow' | 'deep';
+export interface IStateStyleResolverOptions {
+    mergeMode?: StateMergeMode;
+}
+export interface IStateStyleBackupResult<T> {
+    attrs: Partial<T>;
+    normalAttrs: Partial<T>;
+}
+export interface IStateStyleResolver<T> {
+    resolve: (normalAttrs: Partial<T>, states: Record<string, Partial<T>> | undefined, stateProxy: StateProxy<T> | undefined, currentStates: string[], stateSort?: StateSort) => Partial<T>;
+    resolveWithCompiled: (normalAttrs: Partial<T>, compiledDefinitions: Map<string, CompiledStateDefinition<T>>, stateProxy: StateProxy<T> | undefined, effectiveStates: string[], resolvedPatch: Partial<T>) => Partial<T>;
+    computeNormalAttrsBackup: (normalAttrs: Partial<T> | null | undefined, targetAttrs: Partial<T>, finalAttribute: Record<string, any>) => IStateStyleBackupResult<T>;
+}
+export declare class StateStyleResolver<T extends Record<string, any> = Record<string, any>> implements IStateStyleResolver<T> {
+    private readonly options;
+    constructor(options?: IStateStyleResolverOptions);
+    resolve(normalAttrs: Partial<T>, states: Record<string, Partial<T>> | undefined, stateProxy: StateProxy<T> | undefined, currentStates: string[], stateSort?: StateSort): Partial<T>;
+    resolveWithCompiled(normalAttrs: Partial<T>, compiledDefinitions: Map<string, CompiledStateDefinition<T>>, stateProxy: StateProxy<T> | undefined, effectiveStates: string[], resolvedPatch: Partial<T>): Partial<T>;
+    computeNormalAttrsBackup(normalAttrs: Partial<T> | null | undefined, targetAttrs: Partial<T>, finalAttribute: Record<string, any>): IStateStyleBackupResult<T>;
+}

package/es/graphic/state/state-style-resolver.js

@@ -0,0 +1,65 @@
+function isPlainObject(value) {
+    return null != value && "object" == typeof value && !Array.isArray(value);
+}
+
+function cloneValue(value) {
+    if (!isPlainObject(value)) return value;
+    const clone = {};
+    for (const key in value) Object.prototype.hasOwnProperty.call(value, key) && (clone[key] = cloneValue(value[key]));
+    return clone;
+}
+
+function deepMerge(base, value) {
+    const result = cloneValue(base) || {};
+    for (const key in value) {
+        if (!Object.prototype.hasOwnProperty.call(value, key)) continue;
+        const nextValue = value[key], previousValue = result[key];
+        isPlainObject(previousValue) && isPlainObject(nextValue) ? result[key] = deepMerge(previousValue, nextValue) : result[key] = cloneValue(nextValue);
+    }
+    return result;
+}
+
+export class StateStyleResolver {
+    constructor(options = {}) {
+        this.options = options;
+    }
+    resolve(normalAttrs, states, stateProxy, currentStates, stateSort) {
+        var _a;
+        const mergeMode = null !== (_a = this.options.mergeMode) && void 0 !== _a ? _a : "shallow", sortedStates = stateSort ? currentStates.slice().sort(stateSort) : currentStates.slice(), resolvedAttrs = {};
+        return sortedStates.forEach((stateName => {
+            const attrs = stateProxy ? stateProxy(stateName, sortedStates) : null == states ? void 0 : states[stateName];
+            if (null != attrs) for (const key in attrs) {
+                if (!Object.prototype.hasOwnProperty.call(attrs, key)) continue;
+                const nextValue = attrs[key];
+                if ("deep" === mergeMode && isPlainObject(nextValue) && (isPlainObject(resolvedAttrs[key]) || isPlainObject(normalAttrs[key]))) {
+                    const baseValue = isPlainObject(resolvedAttrs[key]) ? resolvedAttrs[key] : isPlainObject(normalAttrs[key]) ? normalAttrs[key] : {};
+                    resolvedAttrs[key] = deepMerge(baseValue, nextValue);
+                } else resolvedAttrs[key] = cloneValue(nextValue);
+            }
+        })), resolvedAttrs;
+    }
+    resolveWithCompiled(normalAttrs, compiledDefinitions, stateProxy, effectiveStates, resolvedPatch) {
+        var _a, _b;
+        const mergeMode = null !== (_a = this.options.mergeMode) && void 0 !== _a ? _a : "shallow", resolvedAttrs = null !== (_b = cloneValue(resolvedPatch)) && void 0 !== _b ? _b : {};
+        return effectiveStates.forEach((stateName => {
+            const proxyPatch = null == stateProxy ? void 0 : stateProxy(stateName, effectiveStates);
+            null != proxyPatch && Object.keys(proxyPatch).forEach((key => {
+                const nextValue = proxyPatch[key], hasCompiledDefinition = compiledDefinitions.has(stateName);
+                if ("deep" === mergeMode && isPlainObject(nextValue) && (isPlainObject(resolvedAttrs[key]) || !hasCompiledDefinition && isPlainObject(normalAttrs[key]))) {
+                    const baseValue = isPlainObject(resolvedAttrs[key]) ? resolvedAttrs[key] : isPlainObject(normalAttrs[key]) ? normalAttrs[key] : {};
+                    resolvedAttrs[key] = deepMerge(baseValue, nextValue);
+                } else resolvedAttrs[key] = cloneValue(nextValue);
+            }));
+        })), resolvedAttrs;
+    }
+    computeNormalAttrsBackup(normalAttrs, targetAttrs, finalAttribute) {
+        const nextNormalAttrs = {}, nextTargetAttrs = Object.assign({}, targetAttrs);
+        for (const key in targetAttrs) Object.prototype.hasOwnProperty.call(targetAttrs, key) && (nextNormalAttrs[key] = cloneValue(normalAttrs && key in normalAttrs ? normalAttrs[key] : finalAttribute[key]));
+        if (normalAttrs) for (const key in normalAttrs) Object.prototype.hasOwnProperty.call(normalAttrs, key) && !(key in targetAttrs) && (nextTargetAttrs[key] = cloneValue(normalAttrs[key]));
+        return {
+            attrs: nextTargetAttrs,
+            normalAttrs: nextNormalAttrs
+        };
+    }
+}
+//# sourceMappingURL=state-style-resolver.js.map