Initial commit for V8JS stubs @ 0.2.1

Author: virgofx

.buildpath

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<buildpath>
+	<buildpathentry kind="src" path=""/>
+	<buildpathentry kind="con" path="org.eclipse.php.core.LANGUAGE"/>
+</buildpath>

.gitignore

@@ -0,0 +1,2 @@
+vendor/
+/.project

CREDITS

@@ -0,0 +1,7 @@
+v8js
+Jani Taskinen
+Patrick Reilly
+Simon Best
+C. Scott Ananian
+Stefan Siegl
+Mark Johnson

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013 The PHP Group
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,20 @@
+[![Latest Version](https://img.shields.io/packagist/v/phpv8/v8js-stubs.svg?style=flat-square)](https://packagist.org/packages/phpv8/v8js-stubs)
+[![Total Downloads](https://img.shields.io/packagist/dt/phpv8/v8js-stubs.svg?style=flat-square)](https://packagist.org/packages/phpv8/v8js-stubs)
+[![Software License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://raw.githubusercontent.com/phpv8/v8js-stubs/master/LICENSE)
+
+
+V8Js Stubs
+==========
+
+V8Js PHP stubs for the [V8Js](https://github.com/phpv8/v8js) extension. Versions, tags, and branches
+maintain parity with the [phpv8/v8js library](https://github.com/phpv8/v8js).
+
+
+### Installation
+1. Include the `phpv8/v8js-stubs` repository into the **require-dev** section of your `composer.json` as follows:
+
+  ```json
+    "require-dev": {
+        "phpv8/v8js-stubs": "~0.4"
+    }
+  ```

composer.json

@@ -0,0 +1,7 @@
+{
+    "name": "phpv8/v8js-stubs",
+    "description": "IDE stubs vor V8Js PHP extension",
+    "require": {
+        "php": ">=5.3.3"
+    }
+}

src/V8Js.php

@@ -0,0 +1,148 @@
+<?php
+
+class V8Js
+{
+    /* Constants */
+    const V8_VERSION = '';
+
+    const FLAG_NONE = 1;
+
+    const FLAG_FORCE_ARRAY = 2;
+
+    const DEBUG_AUTO_BREAK_NEVER = 1;
+
+    const DEBUG_AUTO_BREAK_ONCE = 2;
+
+    const DEBUG_AUTO_BREAK_ALWAYS = 3;
+
+    /* Methods */
+
+    /**
+     * Initializes and starts V8 engine and Returns new V8Js object with it's own V8 context.
+     *
+     * @param string $object_name
+     * @param array  $variables
+     * @param array  $extensions
+     * @param bool   $report_uncaught_exceptions
+     */
+    public function __construct($object_name = 'PHP', array $variables = null, array $extensions = null, $report_uncaught_exceptions = true)
+    {}
+
+    /**
+     * Provide a function or method to be used to load required modules.
+     * This can be any valid PHP callable.
+     * The loader function will receive the normalised module path and should return Javascript code to be executed.
+     *
+     * @param callable $loader
+     */
+    public function setModuleLoader(callable $loader)
+    {}
+
+    /**
+     * Compiles and executes script in object's context with optional identifier string.
+     * A time limit (milliseconds) and/or memory limit (bytes) can be provided to restrict execution. These options will throw a V8JsTimeLimitException or V8JsMemoryLimitException.
+     *
+     * @param string $script
+     * @param string $identifier
+     * @param int    $flags
+     * @param int    $time_limit    in milliseconds
+     * @param int    $memory_limit  in bytes
+     *
+     * @return mixed
+     */
+    public function executeString($script, $identifier = '', $flags = self::FLAG_NONE, $time_limit = 0, $memory_limit = 0)
+    {}
+
+    /**
+     * Compiles a script in object's context with optional identifier string.
+     *
+     * @param
+     *            $script
+     * @param string $identifier
+     * @return resource
+     */
+    public function compileString($script, $identifier = '')
+    {}
+
+    /**
+     * Executes a precompiled script in object's context.
+     * A time limit (milliseconds) and/or memory limit (bytes) can be provided to restrict execution. These options will throw a V8JsTimeLimitException or V8JsMemoryLimitException.
+     *
+     * @param resource $script
+     * @param int      $flags
+     * @param int      $time_limit
+     * @param int      $memory_limit
+     */
+    public function executeScript($script, $flags = self::FLAG_NONE, $time_limit = 0, $memory_limit = 0)
+    {}
+
+    /**
+     * Set the time limit (in milliseconds) for this V8Js object
+     * works similar to the set_time_limit php
+     *
+     * @param int $limit
+     */
+    public function setTimeLimit($limit)
+    {}
+
+    /**
+     * Set the memory limit (in bytes) for this V8Js object
+     *
+     * @param int $limit
+     */
+    public function setMemoryLimit($limit)
+    {}
+
+    /**
+     * Returns uncaught pending exception or null if there is no pending exception.
+     *
+     * @return V8JsScriptException|null
+     */
+    public function getPendingException()
+    {}
+
+    /**
+     * Clears the uncaught pending exception
+     */
+    public function clearPendingException()
+    {}
+
+    /**
+     * Starts V8 debug agent for use with Google Chrome Developer Tools (Eclipse Plugin)
+     *
+     * @param string $agent_name
+     * @param int    $port
+     * @param int    $auto_break
+     *
+     * @return bool
+     */
+    public function startDebugAgent($agent_name = 'V8Js', $port = 9222, $auto_break = self::DEBUG_AUTO_BREAK_NEVER)
+    {}
+
+    /**
+     * Static methods *
+     */
+
+    /**
+     * Registers persistent context independent global Javascript extension.
+     * NOTE! These extensions exist until PHP is shutdown and they need to be registered before V8 is initialized.
+     * For best performance V8 is initialized only once per process thus this call has to be done before any V8Js objects are created!
+     *
+     * @param string $extension_name
+     * @param string $code
+     * @param array  $dependencies
+     * @param bool   $auto_enable
+     *
+     * @return bool
+     */
+    public static function registerExtension($extension_name, $code, array $dependencies, $auto_enable = false)
+    {}
+
+    /**
+     * Returns extensions successfully registered with V8Js::registerExtension().
+     *
+     * @return array|string[]
+     */
+    public static function getExtensions()
+    {}
+}

src/V8JsMemoryLimitException.php

@@ -0,0 +1,7 @@
+<?php
+
+use Exception;
+
+final class V8JsMemoryLimitException extends Exception
+{
+}

src/V8JsScriptException.php

@@ -0,0 +1,48 @@
+<?php
+
+use Exception;
+
+final class V8JsScriptException extends Exception
+{
+    /**
+     *
+     * @return string
+     */
+    final public function getJsFileName()
+    {}
+
+    /**
+     *
+     * @return int
+     */
+    final public function getJsLineNumber()
+    {}
+
+    /**
+     *
+     * @return int
+     */
+    final public function getJsStartColumn()
+    {}
+
+    /**
+     *
+     * @return int
+     */
+    final public function getJsEndColumn()
+    {}
+
+    /**
+     *
+     * @return string
+     */
+    final public function getJsSourceLine()
+    {}
+
+    /**
+     *
+     * @return string
+     */
+    final public function getJsTrace()
+    {}
+}

src/V8JsTimeLimitException.php

@@ -0,0 +1,7 @@
+<?php
+
+use Exception;
+
+final class V8JsTimeLimitException extends Exception
+{
+}