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

package/cjs/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/cjs/graphic/state/state-perf-monitor.js

@@ -0,0 +1,217 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.getStageStatePerfMonitor = exports.ensureStageStatePerfMonitor = exports.StatePerfMonitor = exports.fingerprintDeferredStateConfig = exports.normalizeDeferredStateConfig = exports.normalizeDeferredStateOwnerConfig = exports.createEmptyStatePerfSnapshot = void 0;
+
+const attribute_update_classifier_1 = require("./attribute-update-classifier"), 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
+    };
+}
+
+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"));
+}
+
+function normalizeDeferredStateOwnerConfig(value) {
+    if (value) return isDeferredStateContextConfig(value) ? value : {
+        deferred: value
+    };
+}
+
+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
+    };
+}
+
+function fingerprintDeferredStateConfig(config) {
+    return `${config.enabled ? 1 : 0}:${config.frameBudget}:${config.maxGraphicsPerFrame}`;
+}
+
+exports.createEmptyStatePerfSnapshot = createEmptyStatePerfSnapshot, exports.normalizeDeferredStateOwnerConfig = normalizeDeferredStateOwnerConfig, 
+exports.normalizeDeferredStateConfig = normalizeDeferredStateConfig, exports.fingerprintDeferredStateConfig = fingerprintDeferredStateConfig;
+
+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 & attribute_update_classifier_1.UpdateCategory.PAINT && (this.snapshot.categoryBreakdown.paint += 1), 
+        category & attribute_update_classifier_1.UpdateCategory.TRANSFORM && (this.snapshot.categoryBreakdown.transform += 1), 
+        category & attribute_update_classifier_1.UpdateCategory.SHAPE && (this.snapshot.categoryBreakdown.shape += 1), 
+        category & attribute_update_classifier_1.UpdateCategory.BOUNDS && (this.snapshot.categoryBreakdown.bounds += 1), 
+        category & attribute_update_classifier_1.UpdateCategory.LAYOUT && (this.snapshot.categoryBreakdown.layout += 1), 
+        category & attribute_update_classifier_1.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;
+    }
+}
+
+function ensureStageStatePerfMonitor(stage) {
+    const stageAny = stage;
+    return stageAny[STAGE_PERF_MONITOR] || (stageAny[STAGE_PERF_MONITOR] = new StatePerfMonitor((() => stage.statePerfConfig))), 
+    stageAny[STAGE_PERF_MONITOR];
+}
+
+function getStageStatePerfMonitor(stage) {
+    if (stage) return stage[STAGE_PERF_MONITOR];
+}
+
+exports.StatePerfMonitor = StatePerfMonitor, exports.ensureStageStatePerfMonitor = ensureStageStatePerfMonitor, 
+exports.getStageStatePerfMonitor = getStageStatePerfMonitor;
+//# sourceMappingURL=state-perf-monitor.js.map

package/cjs/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/cjs/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/cjs/graphic/state/state-style-resolver.js

@@ -0,0 +1,73 @@
+"use strict";
+
+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;
+}
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.StateStyleResolver = void 0;
+
+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
+        };
+    }
+}
+
+exports.StateStyleResolver = StateStyleResolver;
+//# sourceMappingURL=state-style-resolver.js.map

package/cjs/graphic/state/state-style-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graphic/state/state-style-resolver.ts"],"names":[],"mappings":"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","file":"state-style-resolver.js","sourcesContent":["import type { CompiledStateDefinition } from './state-definition';\nimport type { StateProxy, StateSort } from './state-model';\n\nexport type StateMergeMode = 'shallow' | 'deep';\n\nexport interface IStateStyleResolverOptions {\n  mergeMode?: StateMergeMode;\n}\n\nexport interface IStateStyleBackupResult<T> {\n  attrs: Partial<T>;\n  normalAttrs: Partial<T>;\n}\n\nexport interface IStateStyleResolver<T> {\n  resolve: (\n    normalAttrs: Partial<T>,\n    states: Record<string, Partial<T>> | undefined,\n    stateProxy: StateProxy<T> | undefined,\n    currentStates: string[],\n    stateSort?: StateSort\n  ) => Partial<T>;\n  resolveWithCompiled: (\n    normalAttrs: Partial<T>,\n    compiledDefinitions: Map<string, CompiledStateDefinition<T>>,\n    stateProxy: StateProxy<T> | undefined,\n    effectiveStates: string[],\n    resolvedPatch: Partial<T>\n  ) => Partial<T>;\n  computeNormalAttrsBackup: (\n    normalAttrs: Partial<T> | null | undefined,\n    targetAttrs: Partial<T>,\n    finalAttribute: Record<string, any>\n  ) => IStateStyleBackupResult<T>;\n}\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  for (const key in value) {\n    if (!Object.prototype.hasOwnProperty.call(value, key)) {\n      continue;\n    }\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  for (const key in value) {\n    if (!Object.prototype.hasOwnProperty.call(value, key)) {\n      continue;\n    }\n\n    const nextValue = value[key];\n    const previousValue = result[key];\n\n    if (isPlainObject(previousValue) && isPlainObject(nextValue)) {\n      result[key] = deepMerge(previousValue, nextValue);\n    } else {\n      result[key] = cloneValue(nextValue);\n    }\n  }\n\n  return result;\n}\n\nexport class StateStyleResolver<T extends Record<string, any> = Record<string, any>> implements IStateStyleResolver<T> {\n  constructor(private readonly options: IStateStyleResolverOptions = {}) {}\n\n  resolve(\n    normalAttrs: Partial<T>,\n    states: Record<string, Partial<T>> | undefined,\n    stateProxy: StateProxy<T> | undefined,\n    currentStates: string[],\n    stateSort?: StateSort\n  ): Partial<T> {\n    const mergeMode = this.options.mergeMode ?? 'shallow';\n    const sortedStates = stateSort ? currentStates.slice().sort(stateSort) : currentStates.slice();\n    const resolvedAttrs: Partial<T> = {};\n\n    sortedStates.forEach(stateName => {\n      const attrs = stateProxy ? stateProxy(stateName, sortedStates) : states?.[stateName];\n\n      if (attrs == null) {\n        return;\n      }\n\n      for (const key in attrs) {\n        if (!Object.prototype.hasOwnProperty.call(attrs, key)) {\n          continue;\n        }\n\n        const nextValue = attrs[key];\n\n        if (\n          mergeMode === 'deep' &&\n          isPlainObject(nextValue) &&\n          (isPlainObject((resolvedAttrs as Record<string, any>)[key]) ||\n            isPlainObject((normalAttrs as Record<string, any>)[key]))\n        ) {\n          const baseValue = isPlainObject((resolvedAttrs as Record<string, any>)[key])\n            ? (resolvedAttrs as Record<string, any>)[key]\n            : isPlainObject((normalAttrs as Record<string, any>)[key])\n            ? (normalAttrs as Record<string, any>)[key]\n            : {};\n          (resolvedAttrs as Record<string, any>)[key] = deepMerge(baseValue, nextValue);\n        } else {\n          (resolvedAttrs as Record<string, any>)[key] = cloneValue(nextValue);\n        }\n      }\n    });\n\n    return resolvedAttrs;\n  }\n\n  resolveWithCompiled(\n    normalAttrs: Partial<T>,\n    compiledDefinitions: Map<string, CompiledStateDefinition<T>>,\n    stateProxy: StateProxy<T> | undefined,\n    effectiveStates: string[],\n    resolvedPatch: Partial<T>\n  ): Partial<T> {\n    const mergeMode = this.options.mergeMode ?? 'shallow';\n    const resolvedAttrs = cloneValue(resolvedPatch) ?? {};\n\n    effectiveStates.forEach(stateName => {\n      const proxyPatch = stateProxy?.(stateName, effectiveStates);\n      if (proxyPatch == null) {\n        return;\n      }\n\n      Object.keys(proxyPatch).forEach(key => {\n        const nextValue = (proxyPatch as Record<string, any>)[key];\n        const hasCompiledDefinition = compiledDefinitions.has(stateName);\n\n        if (\n          mergeMode === 'deep' &&\n          isPlainObject(nextValue) &&\n          (isPlainObject((resolvedAttrs as Record<string, any>)[key]) ||\n            (!hasCompiledDefinition && isPlainObject((normalAttrs as Record<string, any>)[key])))\n        ) {\n          const baseValue = isPlainObject((resolvedAttrs as Record<string, any>)[key])\n            ? (resolvedAttrs as Record<string, any>)[key]\n            : isPlainObject((normalAttrs as Record<string, any>)[key])\n            ? (normalAttrs as Record<string, any>)[key]\n            : {};\n          (resolvedAttrs as Record<string, any>)[key] = deepMerge(baseValue, nextValue);\n          return;\n        }\n\n        (resolvedAttrs as Record<string, any>)[key] = cloneValue(nextValue);\n      });\n    });\n\n    return resolvedAttrs;\n  }\n\n  computeNormalAttrsBackup(\n    normalAttrs: Partial<T> | null | undefined,\n    targetAttrs: Partial<T>,\n    finalAttribute: Record<string, any>\n  ): IStateStyleBackupResult<T> {\n    const nextNormalAttrs: Partial<T> = {};\n    const nextTargetAttrs = { ...targetAttrs };\n\n    for (const key in targetAttrs) {\n      if (!Object.prototype.hasOwnProperty.call(targetAttrs, key)) {\n        continue;\n      }\n\n      if (normalAttrs && key in normalAttrs) {\n        (nextNormalAttrs as Record<string, any>)[key] = cloneValue((normalAttrs as Record<string, any>)[key]);\n      } else {\n        (nextNormalAttrs as Record<string, any>)[key] = cloneValue(finalAttribute[key]);\n      }\n    }\n\n    if (normalAttrs) {\n      for (const key in normalAttrs) {\n        if (!Object.prototype.hasOwnProperty.call(normalAttrs, key) || key in targetAttrs) {\n          continue;\n        }\n        (nextTargetAttrs as Record<string, any>)[key] = cloneValue((normalAttrs as Record<string, any>)[key]);\n      }\n    }\n\n    return {\n      attrs: nextTargetAttrs,\n      normalAttrs: nextNormalAttrs\n    };\n  }\n}\n"]}

package/cjs/graphic/state/state-transition-orchestrator.d.ts

@@ -0,0 +1,41 @@
+import { AttributeUpdateType } from '../../common/enums';
+import type { IAnimateConfig } from '../../interface/graphic';
+export interface IStateTransitionPlan<T> {
+    stateNames?: string[];
+    targetAttrs: Partial<T>;
+    animateAttrs: Partial<T>;
+    jumpAttrs: Partial<T>;
+    noAnimateAttrs: Partial<T>;
+}
+export interface IStateTransitionAnalysisOptions {
+    noWorkAnimateAttr?: Record<string, number>;
+    isClear?: boolean;
+    getDefaultAttribute?: (key: string) => unknown;
+    animateConfig?: IAnimateConfig;
+}
+export interface IStateTransitionApplyOptions {
+    animateConfig?: IAnimateConfig;
+}
+export interface IStateTransitionGraphic<T> {
+    finalAttribute?: Record<string, any>;
+    applyAnimationState?: (state: string[], animations: Array<Record<string, any>>) => void;
+    setAttributesAndPreventAnimate: (attrs: Partial<T>, forceUpdateTag?: boolean, context?: {
+        type: AttributeUpdateType;
+    }) => void;
+    stopStateAnimates: () => void;
+    _emitCustomEvent: (type: string, context?: {
+        type: AttributeUpdateType;
+    }) => void;
+    getNoWorkAnimateAttr?: () => Record<string, number>;
+    getDefaultAttribute?: (key: string) => unknown;
+}
+export interface IStateTransitionOrchestrator<T> {
+    analyzeTransition: (currentAttrs: Partial<T>, targetAttrs: Partial<T>, stateNames?: string[], hasAnimation?: boolean, options?: IStateTransitionAnalysisOptions) => IStateTransitionPlan<T>;
+    applyTransition: (graphic: IStateTransitionGraphic<T>, plan: IStateTransitionPlan<T>, hasAnimation?: boolean, options?: IStateTransitionApplyOptions) => IStateTransitionPlan<T>;
+    applyClearTransition: (graphic: IStateTransitionGraphic<T>, targetAttrs: Partial<T>, hasAnimation?: boolean, stateNames?: string[], options?: IStateTransitionApplyOptions) => IStateTransitionPlan<T>;
+}
+export declare class StateTransitionOrchestrator<T extends Record<string, any> = Record<string, any>> implements IStateTransitionOrchestrator<T> {
+    analyzeTransition(_currentAttrs: Partial<T>, targetAttrs: Partial<T>, stateNames?: string[], hasAnimation?: boolean, options?: IStateTransitionAnalysisOptions): IStateTransitionPlan<T>;
+    applyTransition(graphic: IStateTransitionGraphic<T>, plan: IStateTransitionPlan<T>, hasAnimation?: boolean, options?: IStateTransitionApplyOptions): IStateTransitionPlan<T>;
+    applyClearTransition(graphic: IStateTransitionGraphic<T>, targetAttrs: Partial<T>, hasAnimation?: boolean, stateNames?: string[], options?: IStateTransitionApplyOptions): IStateTransitionPlan<T>;
+}

package/cjs/graphic/state/state-transition-orchestrator.js

@@ -0,0 +1,74 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+    value: !0
+}), exports.StateTransitionOrchestrator = void 0;
+
+const config_1 = require("../../animate/config"), enums_1 = require("../../common/enums");
+
+function hasOwnKeys(value) {
+    return Object.keys(value).length > 0;
+}
+
+function normalizeNoAnimateAttrConfig(config) {
+    return config ? Array.isArray(config) ? config.reduce(((acc, key) => (acc[key] = 1, 
+    acc)), {}) : Object.keys(config).reduce(((acc, key) => (config[key] && (acc[key] = 1), 
+    acc)), {}) : {};
+}
+
+class StateTransitionOrchestrator {
+    analyzeTransition(_currentAttrs, targetAttrs, stateNames, hasAnimation, options = {}) {
+        var _a, _b;
+        const plan = {
+            stateNames: stateNames,
+            targetAttrs: Object.assign({}, targetAttrs),
+            animateAttrs: {},
+            jumpAttrs: {},
+            noAnimateAttrs: {}
+        };
+        if (!hasAnimation) return plan;
+        const noWorkAnimateAttr = Object.assign(Object.assign({}, null !== (_a = options.noWorkAnimateAttr) && void 0 !== _a ? _a : {}), normalizeNoAnimateAttrConfig(null === (_b = options.animateConfig) || void 0 === _b ? void 0 : _b.noAnimateAttrs)), isClear = !0 === options.isClear, getDefaultAttribute = options.getDefaultAttribute;
+        for (const key in targetAttrs) {
+            if (!Object.prototype.hasOwnProperty.call(targetAttrs, key)) continue;
+            const value = targetAttrs[key];
+            noWorkAnimateAttr[key] ? (plan.jumpAttrs[key] = value, plan.noAnimateAttrs[key] = value) : plan.animateAttrs[key] = isClear && void 0 === value && getDefaultAttribute ? getDefaultAttribute(key) : value;
+        }
+        return plan;
+    }
+    applyTransition(graphic, plan, hasAnimation, options = {}) {
+        var _a, _b;
+        if (hasAnimation) {
+            const stateAnimateConfig = null !== (_a = options.animateConfig) && void 0 !== _a ? _a : config_1.DefaultStateAnimateConfig;
+            null === (_b = graphic.applyAnimationState) || void 0 === _b || _b.call(graphic, [ "state" ], [ {
+                name: "state",
+                animation: {
+                    type: "state",
+                    to: plan.animateAttrs,
+                    duration: stateAnimateConfig.duration,
+                    easing: stateAnimateConfig.easing
+                }
+            } ]), hasOwnKeys(plan.noAnimateAttrs) && graphic.setAttributesAndPreventAnimate(plan.noAnimateAttrs, !1, {
+                type: enums_1.AttributeUpdateType.STATE
+            });
+        } else graphic.stopStateAnimates(), graphic.setAttributesAndPreventAnimate(plan.targetAttrs, !1, {
+            type: enums_1.AttributeUpdateType.STATE
+        });
+        return graphic.finalAttribute && Object.assign(graphic.finalAttribute, plan.targetAttrs), 
+        graphic._emitCustomEvent("afterStateUpdate", {
+            type: enums_1.AttributeUpdateType.STATE
+        }), plan;
+    }
+    applyClearTransition(graphic, targetAttrs, hasAnimation, stateNames, options = {}) {
+        var _a, _b;
+        const plan = this.analyzeTransition({}, targetAttrs, stateNames, hasAnimation, {
+            noWorkAnimateAttr: null === (_a = graphic.getNoWorkAnimateAttr) || void 0 === _a ? void 0 : _a.call(graphic),
+            isClear: !0,
+            getDefaultAttribute: null === (_b = graphic.getDefaultAttribute) || void 0 === _b ? void 0 : _b.bind(graphic),
+            animateConfig: options.animateConfig
+        });
+        return this.applyTransition(graphic, plan, hasAnimation, options);
+    }
+}
+
+exports.StateTransitionOrchestrator = StateTransitionOrchestrator;
+//# sourceMappingURL=state-transition-orchestrator.js.map

package/cjs/graphic/state/state-transition-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graphic/state/state-transition-orchestrator.ts"],"names":[],"mappings":"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","file":"state-transition-orchestrator.js","sourcesContent":["import { DefaultStateAnimateConfig } from '../../animate/config';\nimport { AttributeUpdateType } from '../../common/enums';\nimport type { IAnimateConfig } from '../../interface/graphic';\n\nexport interface IStateTransitionPlan<T> {\n  stateNames?: string[];\n  targetAttrs: Partial<T>;\n  animateAttrs: Partial<T>;\n  jumpAttrs: Partial<T>;\n  noAnimateAttrs: Partial<T>;\n}\n\nexport interface IStateTransitionAnalysisOptions {\n  noWorkAnimateAttr?: Record<string, number>;\n  isClear?: boolean;\n  getDefaultAttribute?: (key: string) => unknown;\n  animateConfig?: IAnimateConfig;\n}\n\nexport interface IStateTransitionApplyOptions {\n  animateConfig?: IAnimateConfig;\n}\n\nexport interface IStateTransitionGraphic<T> {\n  finalAttribute?: Record<string, any>;\n  applyAnimationState?: (state: string[], animations: Array<Record<string, any>>) => void;\n  setAttributesAndPreventAnimate: (\n    attrs: Partial<T>,\n    forceUpdateTag?: boolean,\n    context?: { type: AttributeUpdateType }\n  ) => void;\n  stopStateAnimates: () => void;\n  _emitCustomEvent: (type: string, context?: { type: AttributeUpdateType }) => void;\n  getNoWorkAnimateAttr?: () => Record<string, number>;\n  getDefaultAttribute?: (key: string) => unknown;\n}\n\nexport interface IStateTransitionOrchestrator<T> {\n  analyzeTransition: (\n    currentAttrs: Partial<T>,\n    targetAttrs: Partial<T>,\n    stateNames?: string[],\n    hasAnimation?: boolean,\n    options?: IStateTransitionAnalysisOptions\n  ) => IStateTransitionPlan<T>;\n  applyTransition: (\n    graphic: IStateTransitionGraphic<T>,\n    plan: IStateTransitionPlan<T>,\n    hasAnimation?: boolean,\n    options?: IStateTransitionApplyOptions\n  ) => IStateTransitionPlan<T>;\n  applyClearTransition: (\n    graphic: IStateTransitionGraphic<T>,\n    targetAttrs: Partial<T>,\n    hasAnimation?: boolean,\n    stateNames?: string[],\n    options?: IStateTransitionApplyOptions\n  ) => IStateTransitionPlan<T>;\n}\n\nfunction hasOwnKeys(value: object): boolean {\n  return Object.keys(value).length > 0;\n}\n\nfunction normalizeNoAnimateAttrConfig(config?: IAnimateConfig['noAnimateAttrs']): Record<string, number> {\n  if (!config) {\n    return {};\n  }\n\n  if (Array.isArray(config)) {\n    return config.reduce<Record<string, number>>((acc, key) => {\n      acc[key] = 1;\n      return acc;\n    }, {});\n  }\n\n  return Object.keys(config).reduce<Record<string, number>>((acc, key) => {\n    if ((config as Record<string, boolean | number>)[key]) {\n      acc[key] = 1;\n    }\n    return acc;\n  }, {});\n}\n\nexport class StateTransitionOrchestrator<T extends Record<string, any> = Record<string, any>>\n  implements IStateTransitionOrchestrator<T>\n{\n  analyzeTransition(\n    _currentAttrs: Partial<T>,\n    targetAttrs: Partial<T>,\n    stateNames?: string[],\n    hasAnimation?: boolean,\n    options: IStateTransitionAnalysisOptions = {}\n  ): IStateTransitionPlan<T> {\n    const plan: IStateTransitionPlan<T> = {\n      stateNames,\n      targetAttrs: { ...targetAttrs },\n      animateAttrs: {},\n      jumpAttrs: {},\n      noAnimateAttrs: {}\n    };\n\n    if (!hasAnimation) {\n      return plan;\n    }\n\n    const noWorkAnimateAttr = {\n      ...(options.noWorkAnimateAttr ?? {}),\n      ...normalizeNoAnimateAttrConfig(options.animateConfig?.noAnimateAttrs)\n    };\n    const isClear = options.isClear === true;\n    const getDefaultAttribute = options.getDefaultAttribute;\n\n    for (const key in targetAttrs) {\n      if (!Object.prototype.hasOwnProperty.call(targetAttrs, key)) {\n        continue;\n      }\n\n      const value = (targetAttrs as Record<string, any>)[key];\n\n      if (noWorkAnimateAttr[key]) {\n        (plan.jumpAttrs as Record<string, any>)[key] = value;\n        (plan.noAnimateAttrs as Record<string, any>)[key] = value;\n        continue;\n      }\n\n      (plan.animateAttrs as Record<string, any>)[key] =\n        isClear && value === undefined && getDefaultAttribute ? getDefaultAttribute(key) : value;\n    }\n\n    return plan;\n  }\n\n  applyTransition(\n    graphic: IStateTransitionGraphic<T>,\n    plan: IStateTransitionPlan<T>,\n    hasAnimation?: boolean,\n    options: IStateTransitionApplyOptions = {}\n  ): IStateTransitionPlan<T> {\n    if (hasAnimation) {\n      const stateAnimateConfig = options.animateConfig ?? DefaultStateAnimateConfig;\n      graphic.applyAnimationState?.(\n        ['state'],\n        [\n          {\n            name: 'state',\n            animation: {\n              type: 'state',\n              to: plan.animateAttrs,\n              duration: stateAnimateConfig.duration,\n              easing: stateAnimateConfig.easing\n            }\n          }\n        ]\n      );\n\n      if (hasOwnKeys(plan.noAnimateAttrs)) {\n        graphic.setAttributesAndPreventAnimate(plan.noAnimateAttrs, false, { type: AttributeUpdateType.STATE });\n      }\n    } else {\n      graphic.stopStateAnimates();\n      graphic.setAttributesAndPreventAnimate(plan.targetAttrs, false, { type: AttributeUpdateType.STATE });\n    }\n\n    if (graphic.finalAttribute) {\n      Object.assign(graphic.finalAttribute, plan.targetAttrs);\n    }\n\n    graphic._emitCustomEvent('afterStateUpdate', { type: AttributeUpdateType.STATE });\n\n    return plan;\n  }\n\n  applyClearTransition(\n    graphic: IStateTransitionGraphic<T>,\n    targetAttrs: Partial<T>,\n    hasAnimation?: boolean,\n    stateNames?: string[],\n    options: IStateTransitionApplyOptions = {}\n  ): IStateTransitionPlan<T> {\n    const plan = this.analyzeTransition({}, targetAttrs, stateNames, hasAnimation, {\n      noWorkAnimateAttr: graphic.getNoWorkAnimateAttr?.(),\n      isClear: true,\n      getDefaultAttribute: graphic.getDefaultAttribute?.bind(graphic),\n      animateConfig: options.animateConfig\n    });\n\n    return this.applyTransition(graphic, plan, hasAnimation, options);\n  }\n}\n"]}