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

package/cjs/graphic/graphic.d.ts

@@ -1,6 +1,6 @@
 import type { ICustomPath2D } from './../interface/path';
 import { Matrix, Point, type Dict, type IAABBBounds, type IOBBBounds, type IPointLike } from '@visactor/vutils';
-import type { GraphicType, IAnimateConfig, IGraphicAttribute, IGraphic, IGraphicJson, ISetAttributeContext, ITransform, GraphicReleaseStatus } from '../interface/graphic';
+import type { GraphicType, IAnimateConfig, IGraphicAttribute, IGraphic, IGraphicJson, ISetAttributeContext, ISetStatesOptions, ITransform, GraphicReleaseStatus } from '../interface/graphic';
 import { Node } from './node-tree';
 import type { IAnimate, IAnimateTarget, IGlyphGraphicAttribute, ILayer, IPickerService, IShadowRoot, IStage, IStep, ISymbolClass } from '../interface';
 import { IContainPointMode } from '../common/enums';
@@ -8,6 +8,7 @@ import { CustomSymbolClass } from './builtin-symbol';
 import type { CompiledStateDefinition, StateDefinition, StateDefinitionsInput } from './state/state-definition';
 import { StateEngine } from './state/state-engine';
 import { StateModel } from './state/state-model';
+import { UpdateCategory } from './state/attribute-update-classifier';
 import { StateStyleResolver, type StateMergeMode } from './state/state-style-resolver';
 import { StateTransitionOrchestrator } from './state/state-transition-orchestrator';
 import { type SharedStateScope } from './state/shared-state-scope';
@@ -17,7 +18,16 @@ type AttributeDelta = Map<string, {
     prev: unknown;
     next: unknown;
 }>;
-export declare function shouldUseSimpleAttributeFastPath(value: unknown): value is Record<string, any>;
+type ResolvedGraphicStateTransition<T> = {
+    transition: {
+        changed: boolean;
+        states: string[];
+        effectiveStates?: string[];
+    };
+    effectiveStates: string[];
+    resolvedStateAttrs: Partial<T>;
+    isSimpleLocalTransition: boolean;
+};
 export declare const NOWORK_ANIMATE_ATTR: {
     strokeSeg: number;
     boundsPadding: number;
@@ -52,6 +62,8 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     static mixin(source: Dict<any>): void;
     _events?: any;
     context?: Record<string, any>;
+    private transientFromAttrsBeforePreventAnimate?;
+    private transientFromAttrsBeforePreventAnimateDiffAttrs?;
     static userSymbolMap: Record<string, ISymbolClass>;
     onBeforeAttributeUpdate?: (val: any, attributes: Partial<T>, key: null | string | string[], context?: ISetAttributeContext) => T | undefined;
     parent: any;
@@ -88,7 +100,9 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     protected _updateTag: number;
     stamp?: number;
     attribute: T;
-    baseAttributes: Partial<T>;
+    protected _baseAttributes?: Partial<T>;
+    get baseAttributes(): Partial<T>;
+    set baseAttributes(value: Partial<T>);
     shadowRoot?: IShadowRoot;
     releaseStatus?: GraphicReleaseStatus;
     states?: StateDefinitionsInput<T>;
@@ -124,18 +138,20 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     protected stateStyleResolver?: StateStyleResolver<T>;
     protected deepStateStyleResolver?: StateStyleResolver<T>;
     protected stateTransitionOrchestrator?: StateTransitionOrchestrator<T>;
-    protected _deprecatedNormalAttrsView?: Partial<T> | null;
     protected localStateDefinitionsSource?: StateDefinitionsInput<T>;
-    protected resolverEpoch: number;
+    protected resolverEpoch?: number;
+    protected attributeMayContainTransientAttrs?: boolean;
     constructor(params?: T);
     get normalAttrs(): Partial<T> | undefined;
-    set normalAttrs(value: Partial<T> | undefined);
+    set normalAttrs(_value: Partial<T> | undefined);
+    protected getBaseAttributesStorage(): Partial<T>;
     getGraphicService(): import("../interface").IGraphicService;
     getAttributes(): T;
     protected getStateStyleResolver(mergeMode?: StateMergeMode): StateStyleResolver<T>;
     protected getStateTransitionOrchestrator(): StateTransitionOrchestrator<T>;
     protected resolveBoundSharedStateScope(): SharedStateScope<T> | SharedStateScope<Record<string, any>> | undefined;
     protected syncSharedStateScopeBindingFromTree(markDirty?: boolean): boolean;
+    protected syncSharedStateScopeBindingOnTreeChange(markDirty?: boolean): boolean;
     protected syncSharedStateActiveRegistrations(): void;
     protected clearSharedStateActiveRegistrations(): void;
     protected markSharedStateDirty(): void;
@@ -149,14 +165,32 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     };
     protected recomputeCurrentStatePatch(): void;
     protected buildStaticAttributeSnapshot(): Partial<T>;
+    protected buildRemovedStateAnimationAttrs(targetStateAttrs: Partial<T>, previousResolvedStatePatch?: Partial<T>): Partial<T>;
     protected syncObjectToSnapshot(target: Record<string, any>, snapshot: Record<string, any>): AttributeDelta;
     protected _syncAttribute(): AttributeDelta;
     protected _syncFinalAttributeFromStaticTruth(): void;
+    protected mergeAttributeDeltaCategory(category: UpdateCategory, key: string, prev: unknown, next: unknown): number;
+    protected submitUpdateByCategory(category: UpdateCategory, forceUpdateTag?: boolean): void;
     protected submitUpdateByDelta(delta: AttributeDelta, forceUpdateTag?: boolean): void;
+    protected submitTouchedKeyUpdate(keys: string[], forceUpdateTag?: boolean): void;
+    protected submitTouchedUpdate(needsShapeAndBounds: boolean): void;
     protected commitBaseAttributeMutation(forceUpdateTag?: boolean, context?: ISetAttributeContext): void;
+    protected canCommitBaseAttributesByTouchedKeys(): boolean;
+    protected detachAttributeFromBaseAttributes(): void;
+    protected commitInternalBaseAttributes(params: Partial<T>, context?: ISetAttributeContext): void;
+    protected commitBaseAttributesByTouchedKeys(params: Partial<T>, forceUpdateTag?: boolean, context?: ISetAttributeContext): void;
+    protected commitBaseAttributeBySingleKey(key: string, value: any, forceUpdateTag?: boolean, context?: ISetAttributeContext): void;
     protected applyBaseAttributes(params: Partial<T>): void;
+    applyAnimationTransientAttributes(params: Partial<T>, forceUpdateTag?: boolean, context?: ISetAttributeContext): void;
     protected applyTransientAttributes(params: Partial<T>, forceUpdateTag?: boolean, context?: ISetAttributeContext): void;
     protected _restoreAttributeFromStaticTruth(context?: ISetAttributeContext): void;
+    protected collectStatePatchDeltaKeys(previousPatch?: Partial<T>, nextPatch?: Partial<T>): string[];
+    protected getStaticTruthValueForStateKey(key: string, nextPatch?: Partial<T>): {
+        hasValue: boolean;
+        value: any;
+    };
+    protected syncStatePatchDeltaToTarget(target: Record<string, any>, keys: string[], nextPatch?: Partial<T>, collectCategory?: boolean): UpdateCategory;
+    protected restoreAttributeFromStatePatchDelta(previousPatch?: Partial<T>, nextPatch?: Partial<T>, context?: ISetAttributeContext): void;
     setMode(mode: '2d' | '3d'): void;
     set3dMode(): void;
     set2dMode(): void;
@@ -164,6 +198,7 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     onAnimateBind(animate: IAnimate): void;
     protected visitTrackedAnimates(cb: (animate: IAnimate) => void): void;
     protected hasAnyTrackedAnimate(): any;
+    protected mayHaveTrackedAnimates(): boolean;
     protected tryUpdateAABBBounds(): IAABBBounds;
     protected tryUpdateOBBBounds(): IOBBBounds;
     protected combindShadowAABBBounds(bounds: IAABBBounds): void;
@@ -172,7 +207,7 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     protected abstract updateAABBBounds(attribute: T, symbolTheme: Required<T>, aabbBounds: IAABBBounds, full?: boolean): IAABBBounds;
     getClipPath(): ISymbolClass;
     parsePath(symbolType: string): ISymbolClass | CustomSymbolClass;
-    protected doUpdateAABBBounds(full?: boolean): IAABBBounds;
+    protected doUpdateAABBBounds(full?: boolean, graphicTheme?: Required<T>): IAABBBounds;
     updatePathProxyAABBBounds(aabbBounds: IAABBBounds): boolean;
     protected tryUpdateGlobalAABBBounds(): IAABBBounds;
     protected tryUpdateGlobalTransMatrix(clearTag?: boolean): Matrix;
@@ -188,6 +223,8 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     containsPoint(x: number, y: number, mode: IContainPointMode, picker?: IPickerService): boolean;
     protected setWidthHeightWithoutTransform(aabbBounds: IAABBBounds): void;
     setAttributesAndPreventAnimate(params: Partial<T>, forceUpdateTag?: boolean, context?: ISetAttributeContext, ignorePriority?: boolean): void;
+    protected captureTransientFromAttrsBeforePreventAnimate(params: Partial<T>, keys: string[], context?: ISetAttributeContext): void;
+    protected consumeTransientFromAttrsBeforePreventAnimate(diffAttrs: Record<string, any>): Record<string, any> | null;
     setAttributes(params: Partial<T>, forceUpdateTag?: boolean, context?: ISetAttributeContext): void;
     _setAttributes(params: Partial<T>, forceUpdateTag?: boolean, context?: ISetAttributeContext): void;
     setAttribute(key: string, value: any, forceUpdateTag?: boolean, context?: ISetAttributeContext): void;
@@ -208,16 +245,36 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     }): void;
     hasState(stateName?: string): boolean;
     getState(stateName: string): Partial<T> | StateDefinition<T> | undefined;
-    protected createStateModel(): StateModel<T>;
+    protected getStateResolveBaseAttrs(): Partial<T>;
+    protected syncStateResolveContext(stateResolveBaseAttrs?: Partial<T>): Partial<T>;
+    protected createStateModel(stateResolveBaseAttrs?: Partial<T>): StateModel<T>;
+    protected resolveSimpleLocalStateTransition(states: string[], previousStates: readonly string[]): {
+        changed: boolean;
+        states: string[];
+        effectiveStates: string[];
+        resolvedStateAttrs: Partial<T>;
+    } | null;
+    protected resolveGraphicStateTransition(states: string[], previousStates: readonly string[], forceResolverRefresh?: boolean): ResolvedGraphicStateTransition<T>;
+    protected normalizeSetStatesOptions(options?: boolean | ISetStatesOptions): {
+        hasAnimation?: boolean;
+        animateSameStatePatchChange: boolean;
+        shouldRefreshSameStatePatch: boolean;
+    };
+    protected sameStatePatches(left?: Partial<T>, right?: Partial<T>): boolean;
+    protected commitSameStatePatchRefresh(states: string[], hasAnimation?: boolean, animateSameStatePatchChange?: boolean): void;
     protected resolveStateAnimateConfig(animateConfig?: IAnimateConfig): any;
-    applyStateAttrs(attrs: Partial<T>, stateNames: string[], hasAnimation?: boolean, isClear?: boolean, animateConfig?: IAnimateConfig): void;
-    updateNormalAttrs(stateAttrs: Partial<T>): void;
+    applyStateAttrs(attrs: Partial<T>, stateNames: string[], hasAnimation?: boolean, isClear?: boolean, animateConfig?: IAnimateConfig, extraAnimateAttrs?: Partial<T>): void;
+    updateNormalAttrs(_stateAttrs: Partial<T>): void;
+    protected getStateTransitionDefaultAttribute(key: string, targetAttrs?: Partial<T>): any;
+    protected shouldSkipStateTransitionDefaultAttribute(_key: string, _targetAttrs?: Partial<T>): boolean;
     protected stopStateAnimates(type?: 'start' | 'end'): void;
     private getNormalAttribute;
     clearStates(hasAnimation?: boolean): void;
     removeState(stateName: string | string[], hasAnimation?: boolean): void;
     toggleState(stateName: string, hasAnimation?: boolean): void;
     addState(stateName: string, keepCurrentStates?: boolean, hasAnimation?: boolean): void;
+    setStates(states?: string[] | null, hasAnimation?: boolean): void;
+    setStates(states?: string[] | null, options?: ISetStatesOptions): void;
     useStates(states: string[], hasAnimation?: boolean): void;
     invalidateResolver(): void;
     private sameStateNames;
@@ -225,6 +282,7 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     addUpdatePaintTag(): void;
     addUpdateShapeTag(): void;
     addUpdateShapeAndBoundsTag(): void;
+    protected addBroadUpdateTag(): void;
     protected updateShapeAndBoundsTagSetted(): boolean;
     protected clearUpdateBoundTag(): void;
     protected clearUpdatePaintTag(): void;
@@ -241,6 +299,7 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     protected doUpdateLocalMatrix(): void;
     protected doUpdateGlobalMatrix(): void;
     setStage(stage?: IStage, layer?: ILayer): void;
+    detachStageForRelease(): void;
     setStageToShadowRoot(stage?: IStage, layer?: ILayer): void;
     onAddStep(step: IStep): void;
     onStop(props?: Partial<T>): void;
@@ -258,8 +317,10 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     private _stopAnimates;
     stopAnimates(stopChildren?: boolean): void;
     release(): void;
+    protected hasCustomEvent(type: string): boolean;
     protected _dispatchCustomEvent(type: string, context?: any): any;
-    protected beforeStateUpdate(attrs: Partial<T>, prevStates: string[], nextStates: string[], hasAnimation?: boolean, isClear?: boolean): any;
+    protected beforeStateUpdate(attrs: Partial<T>, prevStates: readonly string[], nextStates: readonly string[], hasAnimation?: boolean, isClear?: boolean): any;
+    protected emitStateUpdateEvent(): void;
     protected _emitCustomEvent(type: string, context?: any): void;
     abstract getNoWorkAnimateAttr(): Record<string, number>;
     abstract clone(): IGraphic<any>;