Method apply

packages/effect/src/core/EffectContainer.ts:129–178

* @zh 应用效果 * @en Apply effect * * @param definition - @zh 效果定义 @en Effect definition * @param sourceId - @zh 来源 ID @en Source ID * @param initialData - @zh 初始数据 @en Initial data * @returns @zh 效果实例或 null @en Effect instance or null

(
        definition: IEffectDefinition,
        sourceId?: string,
        initialData?: Record<string, unknown>
    )

     * @returns @zh 效果实例或 null @en Effect instance or null
     */
    apply(
        definition: IEffectDefinition,
        sourceId?: string,
        initialData?: Record<string, unknown>
    ): IEffectInstance | null {
        // Handle exclusive tags - remove conflicting effects
        if (definition.exclusiveTags) {
            for (const tag of definition.exclusiveTags) {
                this.removeByTag(tag);
            }
        }

        // Check for existing effect of same type
        const existingIds = this._effectsByType.get(definition.typeId);
        if (existingIds && existingIds.size > 0) {
            const existingId = existingIds.values().next().value as string;
            const existing = this._effects.get(existingId);

            if (existing) {
                return this._handleStacking(existing, definition);
            }
        }

        // Create new effect instance
        const instance = this._createInstance(definition, sourceId, initialData);

        // Add to collections
        this._effects.set(instance.instanceId, instance);

        if (!this._effectsByType.has(definition.typeId)) {
            this._effectsByType.set(definition.typeId, new Set());
        }
        this._effectsByType.get(definition.typeId)!.add(instance.instanceId);

        for (const tag of definition.tags) {
            if (!this._effectsByTag.has(tag)) {
                this._effectsByTag.set(tag, new Set());
            }
            this._effectsByTag.get(tag)!.add(instance.instanceId);
        }

        // Call handler
        const handler = this._handlers.get(definition.typeId);
        handler?.onApply?.(instance, this._target);

        // Emit event
        this._emitEvent('applied', instance);

        return instance;
    }

    private _createInstance(
        definition: IEffectDefinition,