vinyl.d.ts

// Type definitions for vinyl 1.1.0
// Project: https://github.com/wearefractal/vinyl
// Definitions by: vvakame <https://github.com/vvakame/>, jedmao <https://github.com/jedmao>
// Definitions: https://github.com/borisyankov/DefinitelyTyped

/// <reference path="../node/node.d.ts" />

declare module "vinyl" {

	import fs = require("fs");

	/**
	 * A virtual file format.
	 */
	class File {
		constructor(options?: {

			/**
			* Default: process.cwd()
			*/
			cwd?: string;

			/**
			 * Used for relative pathing. Typically where a glob starts.
			 */
			base?: string;

			/**
			 * Full path to the file.
			 */
			path?: string;

			/**
			 * Path history. Has no effect if options.path is passed.
			 */
			history?: string[];

			/**
			 * The result of an fs.stat call. See fs.Stats for more information.
			 */
			stat?: fs.Stats;

			/**
			 * File contents.
			 * Type: Buffer, Stream, or null
			 */
			contents?: Buffer | NodeJS.ReadWriteStream;
		});

		/**
		 * Default: process.cwd()
		 */
		public cwd: string;

		/**
		 * Used for relative pathing. Typically where a glob starts.
		 */
		public dirname: string;
		public basename: string;
		public base: string;

		/**
		 * Full path to the file.
		 */
		public path: string;
		public stat: fs.Stats;

		/**
		 * Gets and sets stem (filename without suffix) for the file path.
		 */
		public stem: string;

		/**
		 * Gets and sets path.extname for the file path
		 */
		public extname: string;

		/**
		 * Array of path values the file object has had
		 */
		public history: string[];

		/**
		 * Type: Buffer|Stream|null (Default: null)
		 */
		public contents: Buffer | NodeJS.ReadableStream;

		/**
		 * Returns path.relative for the file base and file path.
		 * Example:
		 *  var file = new File({
		 *    cwd: "/",
		 *    base: "/test/",
		 *    path: "/test/file.js"
		 *  });
		 *  console.log(file.relative); // file.js
		 */
		public relative: string;

		/**
		 * Returns true if file.contents is a Buffer.
		 */
		public isBuffer(): boolean;

		/**
		 * Returns true if file.contents is a Stream.
		 */
		public isStream(): boolean;

		/**
		 * Returns true if file.contents is null.
		 */
		public isNull(): boolean;

		/**
		 * Returns a new File object with all attributes cloned. Custom attributes are deep-cloned.
		 */
		public clone(opts?: { contents?: boolean, deep?:boolean }): File;

		/**
		 * If file.contents is a Buffer, it will write it to the stream.
		 * If file.contents is a Stream, it will pipe it to the stream.
		 * If file.contents is null, it will do nothing.
		 */
		public pipe<T extends NodeJS.ReadWriteStream>(
			stream: T,
			opts?: {
				/**
				 * If false, the destination stream will not be ended (same as node core).
				 */
				end?: boolean;
			}): T;

		/**
		 * Returns a pretty String interpretation of the File. Useful for console.log.
		 */
		public inspect(): string;
	}

	export = File;

}