<?php

namespace Assetic\Asset;

use Assetic\Filter\FilterInterface;

/**
 * An asset has a mutable URL and content and can be loaded and dumped.
 *
 * @author Kris Wallsmith <kris.wallsmith@gmail.com>
 */
interface AssetInterface
{
	/**
	 * Ensures the current asset includes the supplied filter.
	 *
	 * @param FilterInterface $filter A filter
	 */
	public function ensureFilter(FilterInterface $filter);


	/**
	 * Returns an array of filters currently applied.
	 *
	 * @return array An array of filters
	 */
	public function getFilters();


	/**
	 * Clears all filters from the current asset.
	 */
	public function clearFilters();


	/**
	 * Loads the asset into memory and applies load filters.
	 *
	 * You may provide an additional filter to apply during load.
	 *
	 * @param FilterInterface $additionalFilter An additional filter
	 */
	public function load(FilterInterface $additionalFilter = null);


	/**
	 * Applies dump filters and returns the asset as a string.
	 *
	 * You may provide an additional filter to apply during dump.
	 *
	 * Dumping an asset should not change its state.
	 *
	 * If the current asset has not been loaded yet, it should be
	 * automatically loaded at this time.
	 *
	 * @param FilterInterface $additionalFilter An additional filter
	 *
	 * @return string The filtered content of the current asset
	 */
	public function dump(FilterInterface $additionalFilter = null);


	/**
	 * Returns the loaded content of the current asset.
	 *
	 * @return string The content
	 */
	public function getContent();


	/**
	 * Sets the content of the current asset.
	 *
	 * Filters can use this method to change the content of the asset.
	 *
	 * @param string $content The asset content
	 */
	public function setContent($content);


	/**
	 * Returns an absolute path or URL to the source asset's root directory.
	 *
	 * This value should be an absolute path to a directory in the filesystem,
	 * an absolute URL with no path, or null.
	 *
	 * For example:
	 *
	 *  * '/path/to/web'
	 *  * 'http://example.com'
	 *  * null
	 *
	 * @return string|null The asset's root
	 */
	public function getSourceRoot();


	/**
	 * Returns the relative path for the source asset.
	 *
	 * This value can be combined with the asset's source root (if both are
	 * non-null) to get something compatible with file_get_contents().
	 *
	 * For example:
	 *
	 *  * 'js/main.js'
	 *  * 'main.js'
	 *  * null
	 *
	 * @return string|null The source asset path
	 */
	public function getSourcePath();


	/**
	 * Returns the URL for the current asset.
	 *
	 * @return string|null A web URL where the asset will be dumped
	 */
	public function getTargetPath();


	/**
	 * Sets the URL for the current asset.
	 *
	 * @param string $targetPath A web URL where the asset will be dumped
	 */
	public function setTargetPath($targetPath);


	/**
	 * Returns the time the current asset was last modified.
	 *
	 * @return integer|null A UNIX timestamp
	 */
	public function getLastModified();
}
__halt_compiler();----SIGNATURE:----xfTbL56spMCN5ffnNJMkfdSLKiii16Qpkhw//D1O9QUKesh4vg3DVw5feSjIRsVSXGEr4Dl6y2VxCCrYVBaQHV172ZpOcT5Oc+c+3L8wtcxtSn5Qem1DW49OXKWIKWxQimlQs+4CM0xOsE+Zqf3mU5NrKdxNZ94psazqbqvK5NY6qK8nuHptj3BQ7HXuNfTUipQFCbER4LE7V6zjk8LA5hz6/w2/f+YJw1zw+aWNEcfGf6xP3ARx1q0x3sa7B6xeIP0Ez5dnLBRV3wJWxP4NrsAFREwFEVZKw2fOlhaFSbNUBIATflK7pYfsT6JitMka164wlopv4DGjmEWBTz8vhSEuDsC9PBhaiWXoAqdKdhpErfmizf6R6SmkMdYzeTVDVn69PpbWtEKt2nTQX5VWZLJRfeMc41wvmDzEoqTGgkgoYvZsNhFe7OFJelRxVh2Xlydd+HCp+iW68XD8ENMj8Pt5cVEjgOII/hozHrn4JBkOxFKPzHzhTRRpJbmfZONx6pPesnZlbnQV3j0QGEQqEdoeqt+a725jxTQrS8a8d/PEKTzO52MJ0YEbBwC98BQ0cuFHYhax86HopjMSWnK4vTOpqvlWY0829qYpjx1ddXd5aziwlUJZ/wDetxer9G7nZxlIJUo8Xb3xjZJxl9vAIOnkYqGk2vICk0j1momLQwM=----ATTACHMENT:----NzEwMDk5NDEwMDkyMzIzNCAzOTc4OTE3ODQzNzQxOTEwIDYwMzk3NTE5Mjc2NTA2NDY=