@visactor/vrender-core 1.1.0-alpha.9 → 1.1.1-alpha.0

package/cjs/graphic/graphic.d.ts

@@ -1,14 +1,13 @@
 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';
 import { CustomSymbolClass } from './builtin-symbol';
-import type { CompiledStateDefinition, StateDefinition, StateDefinitionsInput } from './state/state-definition';
+import type { CompiledStateDefinition, StateDefinition, StateDefinitionsInput, StateMergeMode, StateTransitionResult } from './state/state-definition';
 import { StateEngine } from './state/state-engine';
-import { StateModel } from './state/state-model';
-import { StateStyleResolver, type StateMergeMode } from './state/state-style-resolver';
+import { UpdateCategory } from './state/attribute-update-classifier';
 import { StateTransitionOrchestrator } from './state/state-transition-orchestrator';
 import { type SharedStateScope } from './state/shared-state-scope';
 export declare const PURE_STYLE_KEY: string[];
@@ -17,7 +16,17 @@ type AttributeDelta = Map<string, {
     prev: unknown;
     next: unknown;
 }>;
-export declare function shouldUseSimpleAttributeFastPath(value: unknown): value is Record<string, any>;
+type GraphicStateTransition = {
+    changed: boolean;
+    states: string[];
+    effectiveStates?: string[];
+};
+type ResolvedGraphicStateTransition<T> = {
+    transition: GraphicStateTransition;
+    effectiveStates: string[];
+    resolvedStateAttrs: Partial<T>;
+};
+type ExcludedAttributeKeys = Record<string, true>;
 export declare const NOWORK_ANIMATE_ATTR: {
     strokeSeg: number;
     boundsPadding: number;
@@ -52,6 +61,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 +99,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>;
@@ -99,10 +112,7 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     boundSharedStateRevision?: number;
     sharedStateDirty?: boolean;
     registeredActiveScopes?: Set<SharedStateScope<T>>;
-    localFallbackCompiledDefinitions?: Map<string, CompiledStateDefinition<T>>;
-    localFallbackVersion?: number;
     stateAnimateConfig?: IAnimateConfig;
-    stateProxy?: (stateName: string, targetStates?: string[]) => Partial<T>;
     stateMergeMode?: StateMergeMode;
     animates: Map<string | number, IAnimate>;
     animate?: () => IAnimate;
@@ -117,25 +127,23 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     protected compiledStateDefinitionsCacheKey?: string;
     protected stateEngine?: StateEngine<T>;
     protected stateEngineCompiledDefinitions?: Map<string, CompiledStateDefinition<T>>;
-    protected stateEngineStateProxy?: (stateName: string, targetStates?: string[]) => Partial<T>;
     protected stateEngineStateSort?: (stateA: string, stateB: string) => number;
     protected stateEngineMergeMode?: StateMergeMode;
-    protected stateEngineStateProxyModeKey?: string;
-    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 localStateDefinitionsVersion?: 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;
@@ -144,20 +152,36 @@ export declare abstract class Graphic<T extends Partial<IGraphicAttribute> = Par
     protected getLocalStatesVersion(): number;
     protected resolveEffectiveCompiledDefinitions(): {
         compiledDefinitions?: Map<string, CompiledStateDefinition<T>>;
-        stateProxyModeKey: string;
-        stateProxyEligibility?: (stateName: string) => boolean;
     };
     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 syncObjectToSnapshot(target: Record<string, any>, snapshot: Record<string, any>, excludedKeys?: ExcludedAttributeKeys): AttributeDelta;
+    protected _syncAttribute(excludedKeys?: ExcludedAttributeKeys): AttributeDelta;
+    protected _syncFinalAttributeFromStaticTruth(excludedKeys?: ExcludedAttributeKeys): 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;
+    protected _commitAnimationStaticAttributes(params: Partial<T>, context?: ISetAttributeContext): 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 _restoreAttributeFromStaticTruth(context?: ISetAttributeContext, excludedKeys?: ExcludedAttributeKeys): 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;
@@ -165,6 +189,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;
@@ -173,7 +198,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;
@@ -189,6 +214,9 @@ 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 syncFinalAttributesFromUpdateContext(context?: ISetAttributeContext): 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;
@@ -209,18 +237,38 @@ 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 ensureStateEngine(stateResolveBaseAttrs?: Partial<T>): StateEngine<T>;
+    protected toGraphicStateTransition(result: StateTransitionResult): GraphicStateTransition;
+    protected sortLocalStates(states: readonly string[]): string[];
+    protected resolveLocalUseStatesTransition(states: readonly string[]): GraphicStateTransition;
+    protected resolveLocalClearStatesTransition(): GraphicStateTransition;
+    protected resolveUseStatesTransition(states: string[], stateResolveBaseAttrs?: Partial<T>): GraphicStateTransition;
+    protected resolveClearStatesTransition(): GraphicStateTransition;
+    protected resolveAddStateTransition(stateName: string, keepCurrentStates?: boolean): GraphicStateTransition;
+    protected resolveRemoveStateTransition(stateName: string | string[]): GraphicStateTransition;
+    protected resolveToggleStateTransition(stateName: string): GraphicStateTransition;
+    protected resolveGraphicStateTransition(states: 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, extraAnimateAttrs?: Partial<T>): void;
-    updateNormalAttrs(stateAttrs: 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;
@@ -228,6 +276,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;
@@ -244,6 +293,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;
@@ -261,8 +311,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>;