class RulesActionContainer

abstract class RulesActionContainer extends RulesContainerPlugin implements RulesActionInterface {
    public function __construct($variables = array(), $providesVars = array()) {
        parent::__construct($variables);
        // The provided vars of a component are the names of variables, which should
        // be provided to the caller. See rule().
        if ($providesVars) {
            $this->info['provides'] = $providesVars;
        }
    }
    
    /**
     * Adds an action to the container.
     *
     * Pass in either an instance of the RulesActionInterface or the arguments
     * as needed by rules_action().
     *
     * @return $this
     */
    public function action($name, $settings = array()) {
        $action = is_object($name) && $name instanceof RulesActionInterface ? $name : rules_action($name, $settings);
        $action->setParent($this);
        return $this;
    }
    
    /**
     * Evaluate, whereas by default new vars are visible in the parent's scope.
     */
    public function evaluate(RulesState $state) {
        foreach ($this->children as $action) {
            $action->evaluate($state);
        }
    }
    public function pluginProvidesVariables() {
        return array();
    }
    public function providesVariables() {
        $provides = parent::providesVariables();
        if (isset($this->info['provides']) && ($vars = $this->componentVariables())) {
            // Determine the full variable info for the provided variables. Note that
            // we only support providing variables list in the component vars.
            $provides += array_intersect_key($vars, array_flip($this->info['provides']));
        }
        return $provides;
    }
    
    /**
     * Returns an array of provided variable names.
     *
     * Returns an array of variable names, which are provided by passing through
     * the provided variables of the children.
     */
    public function &componentProvidesVariables() {
        $this->info += array(
            'provides' => array(),
        );
        return $this->info['provides'];
    }
    protected function exportToArray() {
        $export = parent::exportToArray();
        if (!empty($this->info['provides'])) {
            $export['PROVIDES VARIABLES'] = $this->info['provides'];
        }
        return $export;
    }
    public function import(array $export) {
        parent::import($export);
        if (!empty($export['PROVIDES VARIABLES'])) {
            $this->info['provides'] = $export['PROVIDES VARIABLES'];
        }
    }

}