+ * If `options.needle` was not found, this function returns `null`. + **/ + replace(input: string, replacement: string): string; + } + declare var Search: { + /** + * Creates a new `Search` object. The following search options are avaliable: + * - `needle`: The string or regular expression you're looking for + * - `backwards`: Whether to search backwards from where cursor currently is. Defaults to `false`. + * - `wrap`: Whether to wrap the search back to the beginning when it hits the end. Defaults to `false`. + * - `caseSensitive`: Whether the search ought to be case-sensitive. Defaults to `false`. + * - `wholeWord`: Whether the search matches only on whole words. Defaults to `false`. + * - `range`: The [[Range]] to search within. Set this to `null` for the whole document + * - `regExp`: Whether the search is a regular expression or not. Defaults to `false`. + * - `start`: The starting [[Range]] or cursor position to begin the search + * - `skipCurrent`: Whether or not to include the current line in the search. Default to `false`. + **/ + new(): Search; + } + + //////////////// + /// Search + //////////////// + + /** + * Contains the cursor position and the text selection of an edit session. + * The row/columns used in the selection are in document coordinates representing ths coordinates as thez appear in the document before applying soft wrap and folding. + **/ + export interface Selection { + + addEventListener(ev: string, callback: Function); + + moveCursorWordLeft(); + + moveCursorWordRight(); + + fromOrientedRange(range: Range); + + setSelectionRange(match); + + getAllRanges(): Range[]; + + on(event: string, fn: (e) => any); + + addRange(range: Range); + + /** + * Returns `true` if the selection is empty. + **/ + isEmpty(): bool; + + /** + * Returns `true` if the selection is a multi-line. + **/ + isMultiLine(): bool; + + /** + * Gets the current position of the cursor. + **/ + getCursor(): number; + + /** + * Sets the row and column position of the anchor. This function also emits the `'changeSelection'` event. + * @param row The new row + * @param column The new column + **/ + setSelectionAnchor(row: number, column: number); + + /** + * Returns an object containing the `row` and `column` of the calling selection anchor. + **/ + getSelectionAnchor(): any; + + /** + * Returns an object containing the `row` and `column` of the calling selection lead. + **/ + getSelectionLead(): any; + + /** + * Shifts the selection up (or down, if [[Selection.isBackwards `isBackwards()`]] is true) the given number of columns. + * @param columns The number of columns to shift by + **/ + shiftSelection(columns: number); + + /** + * Returns `true` if the selection is going backwards in the document. + **/ + isBackwards(): bool; + + /** + * [Returns the [[Range]] for the selected text.]{: #Selection.getRange} + **/ + getRange(): Range; + + /** + * [Empties the selection (by de-selecting it). This function also emits the `'changeSelection'` event.]{: #Selection.clearSelection} + **/ + clearSelection(); + + /** + * Selects all the text in the document. + **/ + selectAll(); + + /** + * Sets the selection to the provided range. + * @param range The range of text to select + * @param reverse Indicates if the range should go backwards (`true`) or not + **/ + setRange(range: Range, reverse: bool); + + /** + * Moves the selection cursor to the indicated row and column. + * @param row The row to select to + * @param column The column to select to + **/ + selectTo(row: number, column: number); + + /** + * Moves the selection cursor to the row and column indicated by `pos`. + * @param pos An object containing the row and column + **/ + selectToPosition(pos: any); + + /** + * Moves the selection up one row. + **/ + selectUp(); + + /** + * Moves the selection down one row. + **/ + selectDown(); + + /** + * Moves the selection right one column. + **/ + selectRight(); + + /** + * Moves the selection left one column. + **/ + selectLeft(); + + /** + * Moves the selection to the beginning of the current line. + **/ + selectLineStart(); + + /** + * Moves the selection to the end of the current line. + **/ + selectLineEnd(); + + /** + * Moves the selection to the end of the file. + **/ + selectFileEnd(); + + /** + * Moves the selection to the start of the file. + **/ + selectFileStart(); + + /** + * Moves the selection to the first word on the right. + **/ + selectWordRight(); + + /** + * Moves the selection to the first word on the left. + **/ + selectWordLeft(); + + /** + * Moves the selection to highlight the entire word. + **/ + getWordRange(); + + /** + * Selects an entire word boundary. + **/ + selectWord(); + + /** + * Selects a word, including its right whitespace. + **/ + selectAWord(); + + /** + * Selects the entire line. + **/ + selectLine(); + + /** + * Moves the cursor up one row. + **/ + moveCursorUp(); + + /** + * Moves the cursor down one row. + **/ + moveCursorDown(); + + /** + * Moves the cursor left one column. + **/ + moveCursorLeft(); + + /** + * Moves the cursor right one column. + **/ + moveCursorRight(); + + /** + * Moves the cursor to the start of the line. + **/ + moveCursorLineStart(); + + /** + * Moves the cursor to the end of the line. + **/ + moveCursorLineEnd(); + + /** + * Moves the cursor to the end of the file. + **/ + moveCursorFileEnd(); + + /** + * Moves the cursor to the start of the file. + **/ + moveCursorFileStart(); + + /** + * Moves the cursor to the word on the right. + **/ + moveCursorLongWordRight(); + + /** + * Moves the cursor to the word on the left. + **/ + moveCursorLongWordLeft(); + + /** + * Moves the cursor to position indicated by the parameters. Negative numbers move the cursor backwards in the document. + * @param rows The number of rows to move by + * @param chars The number of characters to move by + **/ + moveCursorBy(rows: number, chars: number); + + /** + * Moves the selection to the position indicated by its `row` and `column`. + * @param position The position to move to + **/ + moveCursorToPosition(position: any); + + /** + * Moves the cursor to the row and column provided. [If `preventUpdateDesiredColumn` is `true`, then the cursor stays in the same column position as its original point.]{: #preventUpdateBoolDesc} + * @param row The row to move to + * @param column The column to move to + * @param keepDesiredColumn [If `true`, the cursor move does not respect the previous column]{: #preventUpdateBool} + **/ + moveCursorTo(row: number, column: number, keepDesiredColumn?: bool); + + /** + * Moves the cursor to the screen position indicated by row and column. {:preventUpdateBoolDesc} + * @param row The row to move to + * @param column The column to move to + * @param keepDesiredColumn {:preventUpdateBool} + **/ + moveCursorToScreen(row: number, column: number, keepDesiredColumn: bool); + } + declare var Selection: { + /** + * Creates a new `Selection` object. + * @param session The session to use + **/ + new(session: IEditSession): Selection; + } + + //////////////// + /// Split + //////////////// + + export interface Split { + + /** + * Returns the number of splits. + **/ + getSplits(): number; + + /** + * Returns the editor identified by the index `idx`. + * @param idx The index of the editor you want + **/ + getEditor(idx: number); + + /** + * Returns the current editor. + **/ + getCurrentEditor(): Editor; + + /** + * Focuses the current editor. + **/ + focus(); + + /** + * Blurs the current editor. + **/ + blur(); + + /** + * Sets a theme for each of the available editors. + * @param theme The name of the theme to set + **/ + setTheme(theme: string); + + /** + * Sets the keyboard handler for the editor. + * @param keybinding + **/ + setKeyboardHandler(keybinding: string); + + /** + * Executes `callback` on all of the available editors. + * @param callback A callback function to execute + * @param scope The default scope for the callback + **/ + forEach(callback: Function, scope: string); + + /** + * Sets the font size, in pixels, for all the available editors. + * @param size The new font size + **/ + setFontSize(size: number); + + /** + * Sets a new [[EditSession `EditSession`]] for the indicated editor. + * @param session The new edit session + * @param idx The editor's index you're interested in + **/ + setSession(session: IEditSession, idx: number); + + /** + * Returns the orientation. + **/ + getOrientation(): number; + + /** + * Sets the orientation. + * @param orientation The new orientation value + **/ + setOrientation(orientation: number); + + /** + * Resizes the editor. + **/ + resize(); + } + declare var Split: { + new(): Split; + } + + ////////////////// + /// TokenIterator + ////////////////// + + /** + * This class provides an essay way to treat the document as a stream of tokens, and provides methods to iterate over these tokens. + **/ + export interface TokenIterator { + + /** + * Tokenizes all the items from the current point to the row prior in the document. + **/ + stepBackward(): string[]; + + /** + * Tokenizes all the items from the current point until the next row in the document. If the current point is at the end of the file, this function returns `null`. Otherwise, it returns the tokenized string. + **/ + stepForward(): string; + + /** + * Returns the current tokenized string. + **/ + getCurrentToken(): TokenInfo; + + /** + * Returns the current row. + **/ + getCurrentTokenRow(): number; + + /** + * Returns the current column. + **/ + getCurrentTokenColumn(): number; + } + declare var TokenIterator: { + /** + * Creates a new token iterator object. The inital token index is set to the provided row and column coordinates. + * @param session The session to associate with + * @param initialRow The row to start the tokenizing at + * @param initialColumn The column to start the tokenizing at + **/ + new(session: IEditSession, initialRow: number, initialColumn: number): TokenIterator; + } + + ////////////////// + /// Tokenizer + ////////////////// + + + /** + * This class takes a set of highlighting rules, and creates a tokenizer out of them. For more information, see [the wiki on extending highlighters](https://github.com/ajaxorg/ace/wiki/Creating-or-Extending-an-Edit-Mode#wiki-extendingTheHighlighter). + **/ + export interface Tokenizer { + + /** + * Returns an object containing two properties: `tokens`, which contains all the tokens; and `state`, the current state. + **/ + getLineTokens(): any; + } + declare var Tokenizer: { + /** + * Constructs a new tokenizer based on the given rules and flags. + * @param rules The highlighting rules + * @param flag Any additional regular expression flags to pass (like "i" for case insensitive) + **/ + new(rules: any, flag: string): Tokenizer; + } + + ////////////////// + /// UndoManager + ////////////////// + + /** + * This object maintains the undo stack for an [[EditSession `EditSession`]]. + **/ + export interface UndoManager { + + /** + * Provides a means for implementing your own undo manager. `options` has one property, `args`, an [[Array `Array`]], with two elements: + * - `args[0]` is an array of deltas + * - `args[1]` is the document to associate with + * @param options Contains additional properties + **/ + execute(options: any); + + /** + * [Perform an undo operation on the document, reverting the last change.]{: #UndoManager.undo} + * @param dontSelect {:dontSelect} + **/ + undo(dontSelect?: bool): Range; + + /** + * [Perform a redo operation on the document, reimplementing the last change.]{: #UndoManager.redo} + * @param dontSelect {:dontSelect} + **/ + redo(dontSelect: bool); + + /** + * Destroys the stack of undo and redo redo operations. + **/ + reset(); + + /** + * Returns `true` if there are undo operations left to perform. + **/ + hasUndo(): bool; + + /** + * Returns `true` if there are redo operations left to perform. + **/ + hasRedo(): bool; + + } + declare var UndoManager: { + /** + * Resets the current undo state and creates a new `UndoManager`. + **/ + new(): UndoManager; + } + + //////////////////// + /// VirtualRenderer + //////////////////// + + /** + * The class that is responsible for drawing everything you see on the screen! + **/ + export interface VirtualRenderer { + + scroller: any; + + characterWidth: number; + + lineHeight: number; + + screenToTextCoordinates(left: number, top: number); + + /** + * Associates the renderer with an [[EditSession `EditSession`]]. + **/ + setSession(session: IEditSession); + + /** + * Triggers a partial update of the text, from the range given by the two parameters. + * @param firstRow The first row to update + * @param lastRow The last row to update + **/ + updateLines(firstRow: number, lastRow: number); + + /** + * Triggers a full update of the text, for all the rows. + **/ + updateText(); + + /** + * Triggers a full update of all the layers, for all the rows. + * @param force If `true`, forces the changes through + **/ + updateFull(force: bool); + + /** + * Updates the font size. + **/ + updateFontSize(); + + /** + * [Triggers a resize of the editor.]{: #VirtualRenderer.onResize} + * @param force If `true`, recomputes the size, even if the height and width haven't changed + * @param gutterWidth The width of the gutter in pixels + * @param width The width of the editor in pixels + * @param height The hiehgt of the editor, in pixels + **/ + onResize(force: bool, gutterWidth: number, width: number, height: number); + + /** + * Adjusts the wrap limit, which is the number of characters that can fit within the width of the edit area on screen. + **/ + adjustWrapLimit(); + + /** + * Identifies whether you want to have an animated scroll or not. + * @param shouldAnimate Set to `true` to show animated scrolls + **/ + setAnimatedScroll(shouldAnimate: bool); + + /** + * Returns whether an animated scroll happens or not. + **/ + getAnimatedScroll(): bool; + + /** + * Identifies whether you want to show invisible characters or not. + * @param showInvisibles Set to `true` to show invisibles + **/ + setShowInvisibles(showInvisibles: bool); + + /** + * Returns whether invisible characters are being shown or not. + **/ + getShowInvisibles(): bool; + + /** + * Identifies whether you want to show the print margin or not. + * @param showPrintMargin Set to `true` to show the print margin + **/ + setShowPrintMargin(showPrintMargin: bool); + + /** + * Returns whether the print margin is being shown or not. + **/ + getShowPrintMargin(): bool; + + /** + * Identifies whether you want to show the print margin column or not. + * @param showPrintMargin Set to `true` to show the print margin column + **/ + setPrintMarginColumn(showPrintMargin: bool); + + /** + * Returns whether the print margin column is being shown or not. + **/ + getPrintMarginColumn(): bool; + + /** + * Returns `true` if the gutter is being shown. + **/ + getShowGutter(): bool; + + /** + * Identifies whether you want to show the gutter or not. + * @param show Set to `true` to show the gutter + **/ + setShowGutter(show: bool); + + /** + * Returns the root element containing this renderer. + **/ + getContainerElement(): HTMLElement; + + /** + * Returns the element that the mouse events are attached to + **/ + getMouseEventTarget(): HTMLElement; + + /** + * Returns the element to which the hidden text area is added. + **/ + getTextAreaContainer(): HTMLElement; + + /** + * [Returns the index of the first visible row.]{: #VirtualRenderer.getFirstVisibleRow} + **/ + getFirstVisibleRow(): number; + + /** + * Returns the index of the first fully visible row. "Fully" here means that the characters in the row are not truncated; that the top and the bottom of the row are on the screen. + **/ + getFirstFullyVisibleRow(): number; + + /** + * Returns the index of the last fully visible row. "Fully" here means that the characters in the row are not truncated; that the top and the bottom of the row are on the screen. + **/ + getLastFullyVisibleRow(): number; + + /** + * [Returns the index of the last visible row.]{: #VirtualRenderer.getLastVisibleRow} + **/ + getLastVisibleRow(): number; + + /** + * Sets the padding for all the layers. + * @param padding A new padding value (in pixels) + **/ + setPadding(padding: number); + + /** + * Returns whether the horizontal scrollbar is set to be always visible. + **/ + getHScrollBarAlwaysVisible(): bool; + + /** + * Identifies whether you want to show the horizontal scrollbar or not. + * @param alwaysVisible Set to `true` to make the horizontal scroll bar visible + **/ + setHScrollBarAlwaysVisible(alwaysVisible: bool); + + /** + * Schedules an update to all the front markers in the document. + **/ + updateFrontMarkers(); + + /** + * Schedules an update to all the back markers in the document. + **/ + updateBackMarkers(); + + /** + * Deprecated; (moved to [[EditSession]]) + **/ + addGutterDecoration(); + + /** + * Deprecated; (moved to [[EditSession]]) + **/ + removeGutterDecoration(); + + /** + * Redraw breakpoints. + **/ + updateBreakpoints(); + + /** + * Sets annotations for the gutter. + * @param annotations An array containing annotations + **/ + setAnnotations(annotations: Array); + + /** + * Updates the cursor icon. + **/ + updateCursor(); + + /** + * Hides the cursor icon. + **/ + hideCursor(); + + /** + * Shows the cursor icon. + **/ + showCursor(); + + /** + * Scrolls the cursor into the first visibile area of the editor + **/ + scrollCursorIntoView(); + + /** + * {:EditSession.getScrollTop} + **/ + getScrollTop(): number; + + /** + * {:EditSession.getScrollLeft} + **/ + getScrollLeft(): number; + + /** + * Returns the first visible row, regardless of whether it's fully visible or not. + **/ + getScrollTopRow(): number; + + /** + * Returns the last visible row, regardless of whether it's fully visible or not. + **/ + getScrollBottomRow(): number; + + /** + * Gracefully scrolls from the top of the editor to the row indicated. + * @param row A row id + **/ + scrollToRow(row: number); + + /** + * Gracefully scrolls the editor to the row indicated. + * @param line A line number + * @param center If `true`, centers the editor the to indicated line + * @param animate If `true` animates scrolling + * @param callback Function to be called after the animation has finished + **/ + scrollToLine(line: number, center: bool, animate: bool, callback: Function); + + /** + * Scrolls the editor to the y pixel indicated. + * @param scrollTop The position to scroll to + **/ + scrollToY(scrollTop: number): number; + + /** + * Scrolls the editor across the x-axis to the pixel indicated. + * @param scrollLeft The position to scroll to + **/ + scrollToX(scrollLeft: number): number; + + /** + * Scrolls the editor across both x- and y-axes. + * @param deltaX The x value to scroll by + * @param deltaY The y value to scroll by + **/ + scrollBy(deltaX: number, deltaY: number); + + /** + * Returns `true` if you can still scroll by either parameter; in other words, you haven't reached the end of the file or line. + * @param deltaX The x value to scroll by + * @param deltaY The y value to scroll by + **/ + isScrollableBy(deltaX: number, deltaY: number): bool; + + /** + * Returns an object containing the `pageX` and `pageY` coordinates of the document position. + * @param row The document row position + * @param column The document column position + **/ + textToScreenCoordinates(row: number, column: number): any; + + /** + * Focuses the current container. + **/ + visualizeFocus(); + + /** + * Blurs the current container. + **/ + visualizeBlur(); + + /** + * undefined + * @param position + **/ + showComposition(position: number); + + /** + * Sets the inner text of the current composition to `text`. + * @param text A string of text to use + **/ + setCompositionText(text: string); + + /** + * Hides the current composition. + **/ + hideComposition(); + + /** + * [Sets a new theme for the editor. `theme` should exist, and be a directory path, like `ace/theme/textmate`.]{: #VirtualRenderer.setTheme} + * @param theme The path to a theme + **/ + setTheme(theme: string); + + /** + * [Returns the path of the current theme.]{: #VirtualRenderer.getTheme} + **/ + getTheme(): string; + + /** + * [Adds a new class, `style`, to the editor.]{: #VirtualRenderer.setStyle} + * @param style A class name + **/ + setStyle(style: string); + + /** + * [Removes the class `style` from the editor.]{: #VirtualRenderer.unsetStyle} + * @param style A class name + **/ + unsetStyle(style: string); + + /** + * Destroys the text and cursor layers for this renderer. + **/ + destroy(); + + } + declare var VirtualRenderer: { + /** + * Constructs a new `VirtualRenderer` within the `container` specified, applying the given `theme`. + * @param container The root element of the editor + * @param theme The starting theme + **/ + new(container: HTMLElement, theme?: string): VirtualRenderer; + } +} + +declare var ace: AceAjax.Ace; \ No newline at end of file diff --git a/ace/all-tests.ts b/ace/all-tests.ts new file mode 100644 index 0000000000..80717ac5da --- /dev/null +++ b/ace/all-tests.ts @@ -0,0 +1,26 @@ +///
' + err + '
'; + if (msg) res.locals.message = '' + msg + '
'; + next(); +}); + +// dummy database + +var users =- ' + users.map(function (user) {
+ return '
- ' + user.name + ' '; + }).join('') + '
- '
+ + '
- Download amazing.txt. ' + + '
- Download missing.txt. ' + + '
- ' + ids.map(function (id) {
+ return '
- ' + id + ' '; + }).join('') + '
Users online: ' + ids.length + '
' + list(ids)); + }); +}); + +app.listen(3000); +console.log('listening on port 3000'); + +/////////////////// + +// Convert :to and :from to integers + +app.param(['to', 'from'], function (req, res, next, num, name) { + req.params[name] = num = parseInt(num, 10); + if (isNaN(num)) { + next(new Error('failed to parseInt ' + num)); + } else { + next(); + } +}); + +// Load user by id + +app.param('user', function (req, res, next, id) { + if (req.user = users[id]) { + next(); + } else { + next(new Error('failed to find user')); + } +}); + +/** + * GET index. + */ + +app.get('/', function (req, res) { + res.send('Visit /user/0 or /users/0-2'); +}); + +/** + * GET :user. + */ + +app.get('/user/:user', function (req, res, next) { + res.send('user ' + req.user.name); +}); + +/** + * GET users :from - :to. + */ + +app.get('/users/:from-:to', function (req, res, next) { + var from = req.params.from + , to = req.params.to + , names = users.map(function (user) { return user.name; }); + res.send('users ' + names.slice(from, to).join(', ')); +}); + +if (!module.parent) { + app.listen(3000); + console.log('Express started on port 3000'); +} + +////////////////// + +// Ad-hoc example resource method + +app.resource = function (path, obj) { + this.get(path, obj.index); + this.get(path + '/:a..:b.:format?', function (req, res) { + var a = parseInt(req.params.a, 10) + , b = parseInt(req.params.b, 10) + , format = req.params.format; + obj.range(req, res, a, b, format); + }); + this.get(path + '/:id', obj.show); + this.del(path + '/:id', obj.destroy); +}; + +// Fake controller. + +var FUser = { + index: function (req, res) { + res.send(users); + }, + show: function (req, res) { + res.send(users[req.params.id] || { error: 'Cannot find user' }); + }, + destroy: function (req, res) { + var id = req.params.id; + var destroyed = id in users; + delete users[id]; + res.send(destroyed ? 'destroyed' : 'Cannot find user'); + }, + range: function (req, res, a, b, format) { + var range = users.slice(a, b + 1); + switch (format) { + case 'json': + res.send(range); + break; + case 'html': + default: + var html = '- ' + range.map(function (user) {
+ return '
- ' + user.name + ' '; + }).join('\n') + '
Examples:
- '
+ , '
- GET /users ' + , '
- GET /users/1 ' + , '
- GET /users/3 ' + , '
- GET /users/1..3 ' + , '
- GET /users/1..3.json ' + , '
- DELETE /users/4 ' + , '
First time visiting? view this page in several browsers :)
'; + } + res.send(body + 'viewed ' + req.session.views + ' times.
'); +}); + +app.listen(3000); +console.log('Express app started on port 3000'); + +//////////////////////// + +// log requests +app.use(express.logger('dev')); + +// express on its own has no notion +// of a "file". The express.static() +// middleware checks for a file matching +// the `req.path` within the directory +// that you pass it. In this case "GET /js/app.js" +// will look for "./public/js/app.js". + +app.use(express.static(__dirname + '/public')); + +// if you wanted to "prefix" you may use +// the mounting feature of Connect, for example +// "GET /static/js/app.js" instead of "GET /js/app.js". +// The mount-path "/static" is simply removed before +// passing control to the express.static() middleware, +// thus it serves the file correctly by ignoring "/static" +app.use('/static', express.static(__dirname + '/public')); + +// if for some reason you want to serve files from +// several directories, you can use express.static() +// multiple times! Here we're passing "./public/css", +// this will allow "GET /style.css" instead of "GET /css/style.css": +app.use(express.static(__dirname + '/public/css')); + +// this examples does not have any routes, however +// you may `app.use(app.router)` before or after these +// static() middleware. If placed before them your routes +// will be matched BEFORE file serving takes place. If placed +// after as shown here then file serving is performed BEFORE +// any routes are hit: +app.use(app.router); + +app.listen(3000); +console.log('listening on port 3000'); +console.log('try:'); +console.log(' GET /hello.txt'); +console.log(' GET /js/app.js'); +console.log(' GET /css/style.css'); + +////////////////// + +/* +edit /etc/vhosts: + +127.0.0.1 foo.example.com +127.0.0.1 bar.example.com +127.0.0.1 example.com +*/ + +// Main app + +var main = express(); + +main.use(express.logger('dev')); + +main.get('/', function (req, res) { + res.send('Hello from main app!') +}); + +main.get('/:sub', function (req, res) { + res.send('requsted ' + req.params.sub); +}); + +// Redirect app + +var redirect = express(); + +redirect.all('*', function (req, res) { + console.log(req.subdomains); + res.redirect('http://example.com:3000/' + req.subdomains[0]); +}); + +app.use(express.vhost('*.example.com', redirect)) +app.use(express.vhost('example.com', main)); + +app.listen(3000); +console.log('Express app started on port 3000'); + +//////////////////// + +// create an error with .status. we +// can then use the property in our +// custom error handler (Connect repects this prop as well) + +function merror(status, msg) { + var err =some html
'); + * res.send(404, 'Sorry, cant find that'); + * res.send(404); + */ + send(status: number): ExpressServerResponse; + + send(bodyOrStatus: any): ExpressServerResponse; + + send(status: number, body: any): ExpressServerResponse; + + + /** + * Send JSON response. + * + * Examples: + * + * res.json(null); + * res.json({ user: 'tj' }); + * res.json(500, 'oh noes!'); + * res.json(404, 'I dont have that'); + */ + json(status: number): ExpressServerResponse; + + json(bodyOrStatus: any): ExpressServerResponse; + + json(status: number, body: any): ExpressServerResponse; + + /** + * Send JSON response with JSONP callback support. + * + * Examples: + * + * res.jsonp(null); + * res.jsonp({ user: 'tj' }); + * res.jsonp(500, 'oh noes!'); + * res.jsonp(404, 'I dont have that'); + */ + jsonp(status: number): ExpressServerResponse; + + jsonp(bodyOrStatus: any): ExpressServerResponse; + + jsonp(status: number, body: any): ExpressServerResponse; + + /** + * Transfer the file at the given `path`. + * + * Automatically sets the _Content-Type_ response header field. + * The callback `fn(err)` is invoked when the transfer is complete + * or when an error occurs. Be sure to check `res.sentHeader` + * if you wish to attempt responding, as the header and some data + * may have already been transferred. + * + * Options: + * + * - `maxAge` defaulting to 0 + * - `root` root directory for relative filenames + * + * Examples: + * + * The following example illustrates how `res.sendfile()` may + * be used as an alternative for the `static()` middleware for + * dynamic situations. The code backing `res.sendfile()` is actually + * the same code, so HTTP cache support etc is identical. + * + * app.get('/user/:uid/photos/:file', function(req, res){ + * var uid = req.params.uid + * , file = req.params.file; + * + * req.user.mayViewFilesFrom(uid, function(yes){ + * if (yes) { + * res.sendfile('/uploads/' + uid + '/' + file); + * } else { + * res.send(403, 'Sorry! you cant see that.'); + * } + * }); + * }); + */ + sendfile(path: string): void; + + sendfile(path: string, options: any): void; + + sendfile(path: string, fn: Errback): void; + + sendfile(path: string, options: any, fn: Errback): void; + + /** + * Transfer the file at the given `path` as an attachment. + * + * Optionally providing an alternate attachment `filename`, + * and optional callback `fn(err)`. The callback is invoked + * when the data transfer is complete, or when an error has + * ocurred. Be sure to check `res.headerSent` if you plan to respond. + * + * This method uses `res.sendfile()`. + */ + download(path: string): void; + + download(path: string, filename: string): void; + + download(path: string, fn: Errback): void; + + download(path: string, filename: string, fn: Errback): void; + + /** + * Set _Content-Type_ response header with `type` through `mime.lookup()` + * when it does not contain "/", or set the Content-Type to `type` otherwise. + * + * Examples: + * + * res.type('.html'); + * res.type('html'); + * res.type('json'); + * res.type('application/json'); + * res.type('png'); + * + * @param type + */ + contentType(type: string): ExpressServerResponse; + + /** + * Set _Content-Type_ response header with `type` through `mime.lookup()` + * when it does not contain "/", or set the Content-Type to `type` otherwise. + * + * Examples: + * + * res.type('.html'); + * res.type('html'); + * res.type('json'); + * res.type('application/json'); + * res.type('png'); + * + * @param type + */ + type(type: string): ExpressServerResponse; + + /** + * Respond to the Acceptable formats using an `obj` + * of mime-type callbacks. + * + * This method uses `req.accepted`, an array of + * acceptable types ordered by their quality values. + * When "Accept" is not present the _first_ callback + * is invoked, otherwise the first match is used. When + * no match is performed the server responds with + * 406 "Not Acceptable". + * + * Content-Type is set for you, however if you choose + * you may alter this within the callback using `res.type()` + * or `res.set('Content-Type', ...)`. + * + * res.format({ + * 'text/plain': function(){ + * res.send('hey'); + * }, + * + * 'text/html': function(){ + * res.send('hey
'); + * }, + * + * 'appliation/json': function(){ + * res.send({ message: 'hey' }); + * } + * }); + * + * In addition to canonicalized MIME types you may + * also use extnames mapped to these types: + * + * res.format({ + * text: function(){ + * res.send('hey'); + * }, + * + * html: function(){ + * res.send('hey
'); + * }, + * + * json: function(){ + * res.send({ message: 'hey' }); + * } + * }); + * + * By default Express passes an `Error` + * with a `.status` of 406 to `next(err)` + * if a match is not made. If you provide + * a `.default` callback it will be invoked + * instead. + * + * @param obj + */ + format(obj: any): ExpressServerResponse; + + /** + * Set _Content-Disposition_ header to _attachment_ with optional `filename`. + * + * @param filename + */ + attachment(filename?: string): ExpressServerResponse; + + /** + * Set header `field` to `val`, or pass + * an object of header fields. + * + * Examples: + * + * res.set('Foo', ['bar', 'baz']); + * res.set('Accept', 'application/json'); + * res.set({ Accept: 'text/plain', 'X-API-Key': 'tobi' }); + * + * Aliased as `res.header()`. + */ + set (field: any): void; + + set (field: string, value?: string): void; + + header(field: any): void; + + header(field: string, value?: string): void; + + /** + * Get value for header `field`. + * + * @param field + */ + get (field: string): string; + + /** + * Clear cookie `name`. + * + * @param name + * @param options + */ + clearCookie(name: string, options?: any): ExpressServerResponse; + + /** + * Set cookie `name` to `val`, with the given `options`. + * + * Options: + * + * - `maxAge` max-age in milliseconds, converted to `expires` + * - `signed` sign the cookie + * - `path` defaults to "/" + * + * Examples: + * + * // "Remember Me" for 15 minutes + * res.cookie('rememberme', '1', { expires: new Date(Date.now() + 900000), httpOnly: true }); + * + * // save as above + * res.cookie('rememberme', '1', { maxAge: 900000, httpOnly: true }) + */ + cookie(name: string, val: string, options: CookieOptions); + + cookie(name: string, val: any, options: CookieOptions); + + cookie(name: string, val: any); + + /** + * Set the location header to `url`. + * + * The given `url` can also be the name of a mapped url, for + * example by default express supports "back" which redirects + * to the _Referrer_ or _Referer_ headers or "/". + * + * Examples: + * + * res.location('/foo/bar').; + * res.location('http://example.com'); + * res.location('../login'); // /blog/post/1 -> /blog/login + * + * Mounting: + * + * When an application is mounted and `res.location()` + * is given a path that does _not_ lead with "/" it becomes + * relative to the mount-point. For example if the application + * is mounted at "/blog", the following would become "/blog/login". + * + * res.location('login'); + * + * While the leading slash would result in a location of "/login": + * + * res.location('/login'); + * + * @param url + */ + location(url: string); + + /** + * Redirect to the given `url` with optional response `status` + * defaulting to 302. + * + * The resulting `url` is determined by `res.location()`, so + * it will play nicely with mounted apps, relative paths, + * `"back"` etc. + * + * Examples: + * + * res.redirect('/foo/bar'); + * res.redirect('http://example.com'); + * res.redirect(301, 'http://example.com'); + * res.redirect('http://example.com', 301); + * res.redirect('../login'); // /blog/post/1 -> /blog/login + */ + redirect(url: string): void; + + redirect(status: number, url: string): void; + + redirect(url: string, status: number): void; + + /** + * Render `view` with the given `options` and optional callback `fn`. + * When a callback function is given a response will _not_ be made + * automatically, otherwise a response of _200_ and _text/html_ is given. + * + * Options: + * + * - `cache` boolean hinting to the engine it should cache + * - `filename` filename of the view being rendered + */ + render(view: string): void; + + render(view: string, options: any): void; + + render(view: string, callback: (err: Error, html: any) => void ): void; + + render(view: string, options: any, callback: (err: Error, html: any) => void ): void; + + locals: any; + + charset: string; +} + +interface ExpressApplication { + /** + * Initialize the server. + * + * - setup default configuration + * - setup default middleware + * - setup route reflection methods + */ + init(); + + /** + * Initialize application configuration. + */ + defaultConfiguration(); + + /** + * Proxy `connect#use()` to apply settings to + * mounted applications. + **/ + use(route: string, callback?: Function): ExpressApplication; + + use(route: string, server: ExpressApplication): ExpressApplication; + + use(callback: Function): ExpressApplication; + + use(server: ExpressApplication): ExpressApplication; + + /** + * Register the given template engine callback `fn` + * as `ext`. + * + * By default will `require()` the engine based on the + * file extension. For example if you try to render + * a "foo.jade" file Express will invoke the following internally: + * + * app.engine('jade', require('jade').__express); + * + * For engines that do not provide `.__express` out of the box, + * or if you wish to "map" a different extension to the template engine + * you may use this method. For example mapping the EJS template engine to + * ".html" files: + * + * app.engine('html', require('ejs').renderFile); + * + * In this case EJS provides a `.renderFile()` method with + * the same signature that Express expects: `(path, options, callback)`, + * though note that it aliases this method as `ejs.__express` internally + * so if you're using ".ejs" extensions you dont need to do anything. + * + * Some template engines do not follow this convention, the + * [Consolidate.js](https://github.com/visionmedia/consolidate.js) + * library was created to map all of node's popular template + * engines to follow this convention, thus allowing them to + * work seamlessly within Express. + */ + engine(ext: string, fn: Function): ExpressApplication; + + /** + * Map the given param placeholder `name`(s) to the given callback(s). + * + * Parameter mapping is used to provide pre-conditions to routes + * which use normalized placeholders. For example a _:user_id_ parameter + * could automatically load a user's information from the database without + * any additional code, + * + * The callback uses the samesignature as middleware, the only differencing + * being that the value of the placeholder is passed, in this case the _id_ + * of the user. Once the `next()` function is invoked, just like middleware + * it will continue on to execute the route, or subsequent parameter functions. + * + * app.param('user_id', function(req, res, next, id){ + * User.find(id, function(err, user){ + * if (err) { + * next(err); + * } else if (user) { + * req.user = user; + * next(); + * } else { + * next(new Error('failed to load user')); + * } + * }); + * }); + * + * @param name + * @param fn + */ + param(name: string, fn: Function): ExpressApplication; + + param(name: Array, fn: Function): ExpressApplication; + + /** + * Assign `setting` to `val`, or return `setting`'s value. + * + * app.set('foo', 'bar'); + * app.get('foo'); + * // => "bar" + * + * Mounted servers inherit their parent server's settings. + * + * @param setting + * @param val + */ + set (setting: string, val: string): ExpressApplication; + + /** + * Return the app's absolute pathname + * based on the parent(s) that have + * mounted it. + * + * For example if the application was + * mounted as "/admin", which itself + * was mounted as "/blog" then the + * return value would be "/blog/admin". + */ + path(): string; + + /** + * Check if `setting` is enabled (truthy). + * + * app.enabled('foo') + * // => false + * + * app.enable('foo') + * app.enabled('foo') + * // => true + */ + enabled(setting: string): bool; + + /** + * Check if `setting` is disabled. + * + * app.disabled('foo') + * // => true + * + * app.enable('foo') + * app.disabled('foo') + * // => false + * + * @param setting + */ + disabled(setting: string): bool; + + /** + * Enable `setting`. + * + * @param setting + */ + enable(setting: string): ExpressApplication; + + /** + * Disable `setting`. + * + * @param setting + */ + disable(setting: string): ExpressApplication; + + /** + * Configure callback for zero or more envs, + * when no `env` is specified that callback will + * be invoked for all environments. Any combination + * can be used multiple times, in any order desired. + * + * Examples: + * + * app.configure(function(){ + * // executed for all envs + * }); + * + * app.configure('stage', function(){ + * // executed staging env + * }); + * + * app.configure('stage', 'production', function(){ + * // executed for stage and production + * }); + * + * Note: + * + * These callbacks are invoked immediately, and + * are effectively sugar for the following: + * + * var env = process.env.NODE_ENV || 'development'; + * + * switch (env) { + * case 'development': + * ... + * break; + * case 'stage': + * ... + * break; + * case 'production': + * ... + * break; + * } + * + * @param env + * @param fn + */ + configure(env: string, fn: Function): ExpressApplication; + + configure(env0: string, env1: string, fn: Function): ExpressApplication; + + configure(env0: string, env1: string, env2: string, fn: Function): ExpressApplication; + + configure(env0: string, env1: string, env2: string, env3: string, fn: Function): ExpressApplication; + + configure(env0: string, env1: string, env2: string, env3: string, env4: string, fn: Function): ExpressApplication; + + configure(fn: Function): ExpressApplication; + + /** + * Special-cased "all" method, applying the given route `path`, + * middleware, and callback to _every_ HTTP method. + * + * @param path + * @param fn + */ + all(path: string, fn?: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): ExpressApplication; + + all(path: string, ...callbacks: Function[]): void; + + /** + * Render the given view `name` name with `options` + * and a callback accepting an error and the + * rendered template string. + * + * Example: + * + * app.render('email', { name: 'Tobi' }, function(err, html){ + * // ... + * }) + * + * @param name + * @param options or fn + * @param fn + */ + render(name: string, options: string, fn: Function); + + render(name: string, fn: Function); + + get (name: string): any; + + get (name: string, handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + get (name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + get (name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + get (name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + get (name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler5: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + get (name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler5: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + ...handlers: any[]): any; + + get (name: RegExp): any; + + get (name: RegExp, handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + get (name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + get (name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + get (name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + get (name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler5: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + ...handlers: any[]): any; + + post(name: string): any; + + post(name: string, handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + post(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + post(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + post(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + post(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler5: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + ...handlers: any[]): any; + + post(name: RegExp): any; + + post(name: RegExp, handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + post(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + post(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + post(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + post(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler5: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + ...handlers: any[]): any; + + put(name: string): any; + + put(name: string, handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + put(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + put(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + put(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + put(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler5: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + ...handlers: any[]): any; + + put(name: RegExp): any; + + put(name: RegExp, handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + put(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + put(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + put(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + put(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler5: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + ...handlers: any[]): any; + + del(name: string): any; + + del(name: string, handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + del(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + del(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + del(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + del(name: string, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler5: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + ...handlers: any[]): any; + + del(name: RegExp): any; + + del(name: RegExp, handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + del(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + del(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + del(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any): any; + + del(name: RegExp, + handler: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler2: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler3: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler4: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + handler5: (req: ExpressServerRequest, res: ExpressServerResponse, next: Function) => any, + ...handlers: any[]): any; + + /** + * Listen for connections. + * + * A node `http.Server` is returned, with this + * application (which is a `Function`) as its + * callback. If you wish to create both an HTTP + * and HTTPS server you may do so with the "http" + * and "https" modules as shown here: + * + * var http = require('http') + * , https = require('https') + * , express = require('express') + * , app = express(); + * + * http.createServer(app).listen(80); + * https.createServer({ ... }, app).listen(443); + */ + listen(port: number, hostname: string, backlog: number, callback: Function): void; + + listen(port: number, callback: Function): void; + + listen(path: string, callback?: Function): void; + + listen(handle: any, listeningListener?: Function): void; + + render(view: string, callback: (err: Error, html) => void ): void; + + render(view: string, optionss: any, callback: (err: Error, html) => void ): void; + + route: Route; + + router: string; + + settings: any; + + resource: any; + + map: any; + + locals: any; +} + +interface Express extends ExpressApplication { + /** + * Framework version. + */ + version: string; + + /** + * Expose mime. + */ + mime: string; + + (): ExpressApplication; + + /** + * Create an express application. + */ + createApplication(): ExpressApplication; + + createServer(): ExpressApplication; + + application: any; + + request: ExpressServerRequest; + + response: ExpressServerResponse; } declare module "express" { - export function (): _express.ServerApplication; - export function createServer(): ServerApplication; - export function static(path: string): any; - export var listen; + export function (): Express; - // Connect middleware + /** + * Body parser: + * + * Parse request bodies, supports _application/json_, + * _application/x-www-form-urlencoded_, and _multipart/form-data_. + * + * This is equivalent to: + * + * app.use(connect.json()); + * app.use(connect.urlencoded()); + * app.use(connect.multipart()); + * + * Examples: + * + * connect() + * .use(connect.bodyParser()) + * .use(function(req, res) { + * res.end('viewing user ' + req.body.user.name); + * }); + * + * $ curl -d 'user[name]=tj' http://local/ + * $ curl -d '{"user":{"name":"tj"}}' -H "Content-Type: application/json" http://local/ + * + * View [json](json.html), [urlencoded](urlencoded.html), and [multipart](multipart.html) for more info. + * + * @param options + */ export function bodyParser(options?: any): Handler; - export function errorHandler(opts?: any): Handler; - export function methodOverride(): Handler; - export interface ServerApplication extends _express.ServerApplication {} - export interface ServerRequest extends _express.ServerRequest {} - export interface ServerResponse extends _express.ServerResponse {} - export interface Handler extends _express.Handler {} -} + /** + * Error handler: + * + * Development error handler, providing stack traces + * and error message responses for requests accepting text, html, + * or json. + * + * Text: + * + * By default, and when _text/plain_ is accepted a simple stack trace + * or error message will be returned. + * + * JSON: + * + * When _application/json_ is accepted, connect will respond with + * an object in the form of `{ "error": error }`. + * + * HTML: + * + * When accepted connect will output a nice html stack trace. + */ + export function errorHandler(opts?: any): Handler; + + /** + * Method Override: + * + * Provides faux HTTP method support. + * + * Pass an optional `key` to use when checking for + * a method override, othewise defaults to _\_method_. + * The original method is available via `req.originalMethod`. + * + * @param key + */ + export function methodOverride(key?: string): Handler; + + /** + * Cookie parser: + * + * Parse _Cookie_ header and populate `req.cookies` + * with an object keyed by the cookie names. Optionally + * you may enabled signed cookie support by passing + * a `secret` string, which assigns `req.secret` so + * it may be used by other middleware. + * + * Examples: + * + * connect() + * .use(connect.cookieParser('optional secret string')) + * .use(function(req, res, next){ + * res.end(JSON.stringify(req.cookies)); + * }) + * + * @param secret + */ + export function cookieParser(secret?: string): Handler; + + /** + * Session: + * + * Setup session store with the given `options`. + * + * Session data is _not_ saved in the cookie itself, however + * cookies are used, so we must use the [cookieParser()](cookieParser.html) + * middleware _before_ `session()`. + * + * Examples: + * + * connect() + * .use(connect.cookieParser()) + * .use(connect.session({ secret: 'keyboard cat', key: 'sid', cookie: { secure: true }})) + * + * Options: + * + * - `key` cookie name defaulting to `connect.sid` + * - `store` session store instance + * - `secret` session cookie is signed with this secret to prevent tampering + * - `cookie` session cookie settings, defaulting to `{ path: '/', httpOnly: true, maxAge: null }` + * - `proxy` trust the reverse proxy when setting secure cookies (via "x-forwarded-proto") + * + * Cookie option: + * + * By default `cookie.maxAge` is `null`, meaning no "expires" parameter is set + * so the cookie becomes a browser-session cookie. When the user closes the + * browser the cookie (and session) will be removed. + * + * ## req.session + * + * To store or access session data, simply use the request property `req.session`, + * which is (generally) serialized as JSON by the store, so nested objects + * are typically fine. For example below is a user-specific view counter: + * + * connect() + * .use(connect.favicon()) + * .use(connect.cookieParser()) + * .use(connect.session({ secret: 'keyboard cat', cookie: { maxAge: 60000 }})) + * .use(function(req, res, next){ + * var sess = req.session; + * if (sess.views) { + * res.setHeader('Content-Type', 'text/html'); + * res.write('views: ' + sess.views + '
'); + * res.write('expires in: ' + (sess.cookie.maxAge / 1000) + 's
'); + * res.end(); + * sess.views++; + * } else { + * sess.views = 1; + * res.end('welcome to the session demo. refresh!'); + * } + * } + * )).listen(3000); + * + * ## Session#regenerate() + * + * To regenerate the session simply invoke the method, once complete + * a new SID and `Session` instance will be initialized at `req.session`. + * + * req.session.regenerate(function(err){ + * // will have a new session here + * }); + * + * ## Session#destroy() + * + * Destroys the session, removing `req.session`, will be re-generated next request. + * + * req.session.destroy(function(err){ + * // cannot access session here + * }); + * + * ## Session#reload() + * + * Reloads the session data. + * + * req.session.reload(function(err){ + * // session updated + * }); + * + * ## Session#save() + * + * Save the session. + * + * req.session.save(function(err){ + * // session saved + * }); + * + * ## Session#touch() + * + * Updates the `.maxAge` property. Typically this is + * not necessary to call, as the session middleware does this for you. + * + * ## Session#cookie + * + * Each session has a unique cookie object accompany it. This allows + * you to alter the session cookie per visitor. For example we can + * set `req.session.cookie.expires` to `false` to enable the cookie + * to remain for only the duration of the user-agent. + * + * ## Session#maxAge + * + * Alternatively `req.session.cookie.maxAge` will return the time + * remaining in milliseconds, which we may also re-assign a new value + * to adjust the `.expires` property appropriately. The following + * are essentially equivalent + * + * var hour = 3600000; + * req.session.cookie.expires = new Date(Date.now() + hour); + * req.session.cookie.maxAge = hour; + * + * For example when `maxAge` is set to `60000` (one minute), and 30 seconds + * has elapsed it will return `30000` until the current request has completed, + * at which time `req.session.touch()` is called to reset `req.session.maxAge` + * to its original value. + * + * req.session.cookie.maxAge; + * // => 30000 + * + * Session Store Implementation: + * + * Every session store _must_ implement the following methods + * + * - `.get(sid, callback)` + * - `.set(sid, session, callback)` + * - `.destroy(sid, callback)` + * + * Recommended methods include, but are not limited to: + * + * - `.length(callback)` + * - `.clear(callback)` + * + * For an example implementation view the [connect-redis](http://github.com/visionmedia/connect-redis) repo. + * + * @param options + */ + export function session(options?: any): Handler; + + /** + * Hash the given `sess` object omitting changes + * to `.cookie`. + * + * @param sess + */ + export function hash(sess: string): string; + + /** + * Static: + * + * Static file server with the given `root` path. + * + * Examples: + * + * var oneDay = 86400000; + * + * connect() + * .use(connect.static(__dirname + '/public')) + * + * connect() + * .use(connect.static(__dirname + '/public', { maxAge: oneDay })) + * + * Options: + * + * - `maxAge` Browser cache maxAge in milliseconds. defaults to 0 + * - `hidden` Allow transfer of hidden files. defaults to false + * - `redirect` Redirect to trailing "/" when the pathname is a dir. defaults to true + * + * @param root + * @param options + */ + export function static (root: string, options?: any): Handler; + + /** + * Basic Auth: + * + * Enfore basic authentication by providing a `callback(user, pass)`, + * which must return `true` in order to gain access. Alternatively an async + * method is provided as well, invoking `callback(user, pass, callback)`. Populates + * `req.user`. The final alternative is simply passing username / password + * strings. + * + * Simple username and password + * + * connect(connect.basicAuth('username', 'password')); + * + * Callback verification + * + * connect() + * .use(connect.basicAuth(function(user, pass){ + * return 'tj' == user & 'wahoo' == pass; + * })) + * + * Async callback verification, accepting `fn(err, user)`. + * + * connect() + * .use(connect.basicAuth(function(user, pass, fn){ + * User.authenticate({ user: user, pass: pass }, fn); + * })) + * + * @param callback or username + * @param realm + */ + export function basicAuth(callback: Function, realm: string); + + export function basicAuth(callback: string, realm: string); + + export function basicAuth(callback: Function); + + /** + * Compress: + * + * Compress response data with gzip/deflate. + * + * Filter: + * + * A `filter` callback function may be passed to + * replace the default logic of: + * + * exports.filter = function(req, res){ + * return /json|text|javascript/.test(res.getHeader('Content-Type')); + * }; + * + * Options: + * + * All remaining options are passed to the gzip/deflate + * creation functions. Consult node's docs for additional details. + * + * - `chunkSize` (default: 16*1024) + * - `windowBits` + * - `level`: 0-9 where 0 is no compression, and 9 is slow but best compression + * - `memLevel`: 1-9 low is slower but uses less memory, high is fast but uses more + * - `strategy`: compression strategy + * + * @param options + */ + export function compress(options?: any): Handler; + + /** + * Cookie Session: + * + * Cookie session middleware. + * + * var app = connect(); + * app.use(connect.cookieParser()); + * app.use(connect.cookieSession({ secret: 'tobo!', cookie: { maxAge: 60 * 60 * 1000 }})); + * + * Options: + * + * - `key` cookie name defaulting to `connect.sess` + * - `secret` prevents cookie tampering + * - `cookie` session cookie settings, defaulting to `{ path: '/', httpOnly: true, maxAge: null }` + * - `proxy` trust the reverse proxy when setting secure cookies (via "x-forwarded-proto") + * + * Clearing sessions: + * + * To clear the session simply set its value to `null`, + * `cookieSession()` will then respond with a 1970 Set-Cookie. + * + * req.session = null; + * + * @param options + */ + export function cookieSession(options?: any): Handler; + + /** + * Anti CSRF: + * + * CRSF protection middleware. + * + * By default this middleware generates a token named "_csrf" + * which should be added to requests which mutate + * state, within a hidden form field, query-string etc. This + * token is validated against the visitor's `req.session._csrf` + * property. + * + * The default `value` function checks `req.body` generated + * by the `bodyParser()` middleware, `req.query` generated + * by `query()`, and the "X-CSRF-Token" header field. + * + * This middleware requires session support, thus should be added + * somewhere _below_ `session()` and `cookieParser()`. + * + * Options: + * + * - `value` a function accepting the request, returning the token + * + * @param options + */ + export function csrf(options: any); + + /** + * Directory: + * + * Serve directory listings with the given `root` path. + * + * Options: + * + * - `hidden` display hidden (dot) files. Defaults to false. + * - `icons` display icons. Defaults to false. + * - `filter` Apply this filter function to files. Defaults to false. + * + * @param root + * @param options + */ + export function directory(root: string, options?: any): Handler; + + /** + * Favicon: + * + * By default serves the connect favicon, or the favicon + * located by the given `path`. + * + * Options: + * + * - `maxAge` cache-control max-age directive, defaulting to 1 day + * + * Examples: + * + * Serve default favicon: + * + * connect() + * .use(connect.favicon()) + * + * Serve favicon before logging for brevity: + * + * connect() + * .use(connect.favicon()) + * .use(connect.logger('dev')) + * + * Serve custom favicon: + * + * connect() + * .use(connect.favicon('public/favicon.ico)) + * + * @param path + * @param options + */ + export function favicon(path?: string, options?: any); + + /** + * JSON: + * + * Parse JSON request bodies, providing the + * parsed object as `req.body`. + * + * Options: + * + * - `strict` when `false` anything `JSON.parse()` accepts will be parsed + * - `reviver` used as the second "reviver" argument for JSON.parse + * - `limit` byte limit disabled by default + * + * @param options + */ + export function json(options?: any): Handler; + + /** + * Limit: + * + * Limit request bodies to the given size in `bytes`. + * + * A string representation of the bytesize may also be passed, + * for example "5mb", "200kb", "1gb", etc. + * + * connect() + * .use(connect.limit('5.5mb')) + * .use(handleImageUpload) + */ + export function limit(bytes: number): Handler; + + export function limit(bytes: string): Handler; + + /** + * Logger: + * + * Log requests with the given `options` or a `format` string. + * + * Options: + * + * - `format` Format string, see below for tokens + * - `stream` Output stream, defaults to _stdout_ + * - `buffer` Buffer duration, defaults to 1000ms when _true_ + * - `immediate` Write log line on request instead of response (for response times) + * + * Tokens: + * + * - `:req[header]` ex: `:req[Accept]` + * - `:res[header]` ex: `:res[Content-Length]` + * - `:http-version` + * - `:response-time` + * - `:remote-addr` + * - `:date` + * - `:method` + * - `:url` + * - `:referrer` + * - `:user-agent` + * - `:status` + * + * Formats: + * + * Pre-defined formats that ship with connect: + * + * - `default` ':remote-addr - - [:date] ":method :url HTTP/:http-version" :status :res[content-length] ":referrer" ":user-agent"' + * - `short` ':remote-addr - :method :url HTTP/:http-version :status :res[content-length] - :response-time ms' + * - `tiny` ':method :url :status :res[content-length] - :response-time ms' + * - `dev` concise output colored by response status for development use + * + * Examples: + * + * connect.logger() // default + * connect.logger('short') + * connect.logger('tiny') + * connect.logger({ immediate: true, format: 'dev' }) + * connect.logger(':method :url - :referrer') + * connect.logger(':req[content-type] -> :res[content-type]') + * connect.logger(function(tokens, req, res){ return 'some format string' }) + * + * Defining Tokens: + * + * To define a token, simply invoke `connect.logger.token()` with the + * name and a callback function. The value returned is then available + * as ":type" in this case. + * + * connect.logger.token('type', function(req, res){ return req.headers['content-type']; }) + * + * Defining Formats: + * + * All default formats are defined this way, however it's public API as well: + * + * connect.logger.format('name', 'string or function') + */ + export function logger(options: string): Handler; + + export function logger(options: Function): Handler; + + export function logger(options?: any): Handler; + + /** + * Compile `fmt` into a function. + * + * @param fmt + */ + export function compile(fmt: string): Handler; + + /** + * Define a token function with the given `name`, + * and callback `fn(req, res)`. + * + * @param name + * @param fn + */ + export function token(name: string, fn: Function): any; + + /** + * Define a `fmt` with the given `name`. + */ + export function format(name: string, str: string): any; + + export function format(name: string, str: Function): any; + + /** + * Query: + * + * Automatically parse the query-string when available, + * populating the `req.query` object. + * + * Examples: + * + * connect() + * .use(connect.query()) + * .use(function(req, res){ + * res.end(JSON.stringify(req.query)); + * }); + * + * The `options` passed are provided to qs.parse function. + */ + export function query(options: any): Handler; + + /** + * Reponse time: + * + * Adds the `X-Response-Time` header displaying the response + * duration in milliseconds. + */ + export function responseTime(): Handler; + + /** + * Static cache: + * + * Enables a memory cache layer on top of + * the `static()` middleware, serving popular + * static files. + * + * By default a maximum of 128 objects are + * held in cache, with a max of 256k each, + * totalling ~32mb. + * + * A Least-Recently-Used (LRU) cache algo + * is implemented through the `Cache` object, + * simply rotating cache objects as they are + * hit. This means that increasingly popular + * objects maintain their positions while + * others get shoved out of the stack and + * garbage collected. + * + * Benchmarks: + * + * static(): 2700 rps + * node-static: 5300 rps + * static() + staticCache(): 7500 rps + * + * Options: + * + * - `maxObjects` max cache objects [128] + * - `maxLength` max cache object length 256kb + */ + export function staticCache(options: any): Handler; + + /** + * Timeout: + * + * Times out the request in `ms`, defaulting to `5000`. The + * method `req.clearTimeout()` is added to revert this behaviour + * programmatically within your application's middleware, routes, etc. + * + * The timeout error is passed to `next()` so that you may customize + * the response behaviour. This error has the `.timeout` property as + * well as `.status == 408`. + */ + export function timeout(ms: number): Handler; + + /** + * Vhost: + * + * Setup vhost for the given `hostname` and `server`. + * + * connect() + * .use(connect.vhost('foo.com', fooApp)) + * .use(connect.vhost('bar.com', barApp)) + * .use(connect.vhost('*.com', mainApp)) + * + * The `server` may be a Connect server or + * a regular Node `http.Server`. + * + * @param hostname + * @param server + */ + export function vhost(hostname: string, server: any): Handler; + + export function urlencoded(): any; + + export function multipart(): any; +} \ No newline at end of file diff --git a/fabricjs/fabricjs.d.ts b/fabricjs/fabricjs.d.ts index ec4559e945..256e4cb41b 100644 --- a/fabricjs/fabricjs.d.ts +++ b/fabricjs/fabricjs.d.ts @@ -758,6 +758,7 @@ declare module fabric { fromURL(url: string): IImage; fromURL(url: string, callback: (image: IImage) => any): IImage; fromURL(url: string, callback: (image: IImage) => any, objObjects: IObjectOptions): IImage; + new (element: HTMLImageElement, objObjects: IObjectOptions): IImage; prototype: any; filters: diff --git a/filesystem/filesystem-tests.ts b/filesystem/filesystem-tests.ts new file mode 100644 index 0000000000..8f175db98d --- /dev/null +++ b/filesystem/filesystem-tests.ts @@ -0,0 +1,49 @@ +///-
+ *
+ * A move of a file on top of an existing file must attempt to delete and replace that file.
+ * A move of a directory on top of an existing empty directory must attempt to delete and replace that directory.
+ */
+ moveTo(parent:DirectoryEntry, newName?:string, successCallback?:EntryCallback, errorCallback?:ErrorCallback):string;
+
+ /**
+ * Copy an entry to a different location on the file system. It is an error to try to:
+ *
+ *
- copy a directory inside itself or to any child at any depth; + *
- copy an entry into its parent if a name different from its current one isn't provided; + *
- copy a file to a path occupied by a directory; + *
- copy a directory to a path occupied by a file; + *
- copy any element to a path occupied by a directory which is not empty. + *
- A copy of a file on top of an existing file must attempt to delete and replace that file. + *
- A copy of a directory on top of an existing empty directory must attempt to delete and replace that directory. + *
- If create and exclusive are both true, and the path already exists, getFile must fail. + *
- If create is true, the path doesn't exist, and no other error occurs, getFile must create it as a zero-length file and return a corresponding FileEntry. + *
- If create is not true and the path doesn't exist, getFile must fail. + *
- If create is not true and the path exists, but is a directory, getFile must fail. + *
- Otherwise, if no other error occurs, getFile must return a FileEntry corresponding to path. + *
- If create and exclusive are both true and the path already exists, getDirectory must fail. + *
- If create is true, the path doesn't exist, and no other error occurs, getDirectory must create and return a corresponding DirectoryEntry. + *
- If create is not true and the path doesn't exist, getDirectory must fail. + *
- If create is not true and the path exists, but is a file, getDirectory must fail. + *
- Otherwise, if no other error occurs, getDirectory must return a DirectoryEntry corresponding to path. + *
- A series of calls to readEntries must return each entry in the directory exactly once. + *
- Once all entries have been returned, the next call to readEntries must produce an empty array. + *
- If not all entries have been returned, the array produced by readEntries must not be empty. + *
- The entries produced by readEntries must not include the directory itself ["."] or its parent [".."]. + *
- move a directory inside itself or to any child at any depth; + *
- move an entry into its parent if a name different from its current one isn't provided; + *
- move a file to a path occupied by a directory; + *
- move a directory to a path occupied by a file; + *
- move any element to a path occupied by a directory which is not empty. + *
-
+ *
-
+ *
-
+ *
-
+ *
-
+ *
-
+ *
- copy a directory inside itself or to any child at any depth; + *
- copy an entry into its parent if a name different from its current one isn't provided; + *
- copy a file to a path occupied by a directory; + *
- copy a directory to a path occupied by a file; + *
- copy any element to a path occupied by a directory which is not empty. + * + * A copy of a file on top of an existing file must attempt to delete and replace that file. + * A copy of a directory on top of an existing empty directory must attempt to delete and replace that directory. + * Directory copies are always recursive--that is, they copy all contents of the directory. + */ + copyTo(parent:DirectoryEntrySync, newName?:string):EntrySync; + + /** + * Returns a URL that can be used to identify this entry. Unlike the URN defined in [FILE-API-ED], it has no specific expiration; as it describes a location on disk, it should be valid at least as long as that location exists. + */ + toURL():string; + + /** + * Deletes a file or directory. It is an error to attempt to delete a directory that is not empty. It is an error to attempt to delete the root directory of a filesystem. + */ + remove ():void; + + /** + * Look up the parent DirectoryEntrySync containing this Entry. If this EntrySync is the root of its filesystem, its parent is itself. + */ + getParent():DirectoryEntrySync; +} + +/** + * This interface represents a directory on a file system. + */ +interface DirectoryEntrySync extends EntrySync { + /** + * Creates a new DirectoryReaderSync to read EntrySyncs from this DirectorySync. + */ + createReader():DirectoryReaderSync; + + /** + * Creates or looks up a directory. + * @param path Either an absolute path or a relative path from this DirectoryEntrySync to the file to be looked up or created. It is an error to attempt to create a file whose immediate parent does not yet exist. + * @param options + *
- If create and exclusive are both true and the path already exists, getFile must fail. + *
- If create is true, the path doesn't exist, and no other error occurs, getFile must create it as a zero-length file and return a corresponding FileEntry. + *
- If create is not true and the path doesn't exist, getFile must fail. + *
- If create is not true and the path exists, but is a directory, getFile must fail. + *
- Otherwise, if no other error occurs, getFile must return a FileEntrySync corresponding to path. + *
- If create and exclusive are both true and the path already exists, getDirectory must fail. + *
- If create is true, the path doesn't exist, and no other error occurs, getDirectory must create and return a corresponding DirectoryEntry. + *
- If create is not true and the path doesn't exist, getDirectory must fail. + *
- If create is not true and the path exists, but is a file, getDirectory must fail. + *
- Otherwise, if no other error occurs, getDirectory must return a DirectoryEntrySync corresponding to path. + *
- A series of calls to readEntries must return each entry in the directory exactly once. + *
- Once all entries have been returned, the next call to readEntries must produce an empty array. + *
- If not all entries have been returned, the array produced by readEntries must not be empty. + *
- The entries produced by readEntries must not include the directory itself ["."] or its parent [".."]. + *
- If readyState == DONE or readyState == INIT, terminate this overall series of steps without doing anything else. + *
- Set readyState to DONE. + *
- If there are any tasks from the object's FileSaver task source in one of the task queues, then remove those tasks. + *
- Terminate the write algorithm being processed. + *
- Set the error attribute to a DOMError object of type "AbortError". + *
- Fire a progress event called abort + *
- Fire a progress event called writeend + *
- Terminate this algorithm. + *
- INIT + *
- WRITING + *
- DONE + *
- length must be equal to size. + *
- position must be the lesser of
+ *
-
+ *
- its pre-truncate value, + *
- size. + *
+ * - " + el.nodeName + " "; + }); + + // Insert the node names + $log.append( "
-
+ *
-
+ *
-
+ *
-
+ *
-
+ *
-
+ * @readonly
+ */
+ readyState:number;
+
+ /**
+ * The last error that occurred on the FileSaver.
+ * @readonly
+ */
+ error:DOMError;
+
+ /**
+ * Handler for writestart events
+ */
+ onwritestart:Function;
+
+ /**
+ * Handler for progress events.
+ */
+ onprogress:Function;
+
+ /**
+ * Handler for write events.
+ */
+ onwrite:Function;
+
+ /**
+ * Handler for abort events.
+ */
+ onabort:Function;
+
+ /**
+ * Handler for error events.
+ */
+ onerror:Function;
+
+ /**
+ * Handler for writeend events.
+ */
+ onwriteend:Function;
+}
+
+var FileSaver: {
+ /**
+ * When the FileSaver constructor is called, the user agent must return a new FileSaver object with readyState set to INIT.
+ * This constructor must be visible when the script's global object is either a Window object or an object implementing the WorkerUtils interface.
+ */
+ new(data:Blob): FileSaver;
+}
+
+/**
+ * This interface expands on the FileSaver interface to allow for multiple write actions, rather than just saving a single Blob.
+ */
+interface FileWriter extends FileSaver {
+ /**
+ * The byte offset at which the next write to the file will occur. This must be no greater than length.
+ * A newly-created FileWriter must have position set to 0.
+ */
+ position:number;
+
+ /**
+ * The length of the file. If the user does not have read access to the file, this must be the highest byte offset at which the user has written.
+ */
+ length:number;
+
+ /**
+ * Write the supplied data to the file at position.
+ * @param data The blob to write.
+ */
+ write(data:Blob):void;
+
+ /**
+ * Seek sets the file position at which the next write will occur.
+ * @param offset If nonnegative, an absolute byte offset into the file. If negative, an offset back from the end of the file.
+ */
+ seek(offset:number):void;
+
+ /**
+ * Changes the length of the file to that specified. If shortening the file, data beyond the new length must be discarded. If extending the file, the existing data must be zero-padded up to the new length.
+ * @param size The size to which the length of the file is to be adjusted, measured in bytes.
+ */
+ truncate(size:number):void;
+}
+
+/**
+ * This interface lets users write, truncate, and append to files using simple synchronous calls.
+ * This interface is specified to be used only within Web Workers (WorkerUtils [WEBWORKERS]).
+ */
+interface FileWriterSync {
+ /**
+ * The byte offset at which the next write to the file will occur. This must be no greater than length.
+ */
+ position:number;
+
+ /**
+ * The length of the file. If the user does not have read access to the file, this must be the highest byte offset at which the user has written.
+ */
+ length:number;
+
+ /**
+ * Write the supplied data to the file at position. Upon completion, position will increase by data.size.
+ * @param data The blob to write.
+ */
+ write(data:Blob):void;
+
+ /**
+ * Seek sets the file position at which the next write will occur.
+ * @param offset An absolute byte offset into the file. If offset is greater than length, length is used instead. If offset is less than zero, length is added to it, so that it is treated as an offset back from the end of the file. If it is still less than zero, zero is used.
+ */
+ seek(offset:number):void;
+
+ /**
+ * Changes the length of the file to that specified. If shortening the file, data beyond the new length must be discarded. If extending the file, the existing data must be zero-padded up to the new length.
+ * Upon successful completion:
+ *
-
+ *
')
+.cycle({
+ fx: 'turnDown',
+ speed: 'fast',
+ timeout: 0,
+ pager: '#nav'
+});
+
+$('#s5').cycle({
+ fx: 'scrollLeft',
+ timeout: 5000,
+ before: function () {
+ $('#output').html("Scrolling image:
" + this.src); + }, + after: function () { + $('#output').html("Scroll complete for:
" + this.src) + .append('
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+
+///
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
/// ![]()
');
@@ -1893,7 +1901,7 @@ function test_jQuery() {
}
function test_jquery() {
- var a = { what: "A regular JS object" },
+ var a = { what: "A regular JS object" },
b = $('body');
if (a.jquery) {
alert(' a is a jQuery object! ');
@@ -2218,6 +2226,13 @@ function test_prop() {
var title: string = $('option:selected', this).prop('title');
}
+
+function test_selector() {
+ var $main = $('#main');
+ var $mainDivs = $('div', $main);
+ return $mainDivs.selector == '#main div';
+}
+
function test_text() {
var str = $("p:first").text();
$("p:last").html(str);
@@ -2225,4 +2240,43 @@ function test_text() {
return 'item number ' + (index + 1);
});
$("p").text("Some new text.");
+}
+
+$('#item').click(function(e) {
+ if (e.ctrlKey) { console.log('control pressed'); }
+ if (e.altKey) { console.log('alt pressed'); }
+});
+
+function test_addBack() {
+ $('li.third-item').nextAll().addBack().css('background-color', 'red');
+
+ $("div.left, div.right").find("div, div > p").addClass("border");
+
+ // First Example
+ $("div.before-addback").find("p").addClass("background");
+
+ // Second Example
+ $("div.after-addback").find("p").addBack().addClass("background");
+}
+
+// http://api.jquery.com/jQuery.parseHTML/
+function test_parseHTML() {
+ var $log = $( "#log" ),
+ str = "hello, my name is jQuery.",
+ html = $.parseHTML( str ),
+ nodeNames = [];
+
+ // Append the parsed HTML
+ $log.append( html );
+
+ // Gather the parsed HTML's node names
+ $.each( html, function( i, el ) {
+ nodeNames[i] = "
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+
+interface Loop {
+ begin:number;
+ end:number;
+ step:number;
+}
+
+interface ConnectOption {
+ target:any;
+ args?:any[];
+ ok?:number;
+ ng?:number;
+}
+
+interface RetryOption {
+ wait:number;
+}
+
+interface DeferredizedFunction { (...arg:any[]):Deferred; }
+interface DeferredizedFunctionWithNumber { (n:number):Deferred; }
+interface FunctionWithNumber { (i:number); }
+interface ErrorCallback { (d:Deferred, ...args:any[]); }
+
+declare class Deferred {
+
+ static methods:string[];
+
+ static isDeferred(obj:any):bool;
+
+ static next(fun:Function):Deferred;
+
+ static chain(...args:any[]):Deferred;
+
+ static wait(n:number):Deferred;
+
+ static call(fun?:Function, ...args:any[]):Deferred;
+
+ static parallel(dl:any):Deferred;
+
+ static earlier(dl:any):Deferred;
+
+ static loop(n:number, fun:FunctionWithNumber):Deferred;
+
+ static loop(n:Loop, fun:FunctionWithNumber):Deferred;
+
+ static repeat(n:number, fun:FunctionWithNumber):Deferred;
+
+ static register(name:string, fun:DeferredizedFunction):void;
+
+ static connect(funo:any, options:string):DeferredizedFunction;
+
+ static connect(funo:Function, options?:ConnectOption):DeferredizedFunction;
+
+ static retry(retryCount:number, funcDeferred:DeferredizedFunctionWithNumber, options?:RetryOption):Deferred;
+
+ static define(obj?:any, list?:string[]):any;
+
+ constructor();
+
+ next(fun:Function):Deferred;
+
+ wait(n:number):Deferred;
+
+ error(fun:ErrorCallback):Deferred;
+
+ call(val?:any):Deferred;
+
+ fail(err:any):Deferred;
+
+ cancel():Deferred;
+
+ parallel(dl:any):Deferred;
+
+ loop(n:number, fun:FunctionWithNumber):Deferred;
+
+ loop(n:Loop, fun:FunctionWithNumber):Deferred;
+
+}
+
+
+declare function chain(...args:any[]):Deferred;
+
+declare function wait(n:number):Deferred;
+
+declare function call(fun?:Function, ...args:any[]):Deferred;
+
+declare function parallel(dl:any):Deferred;
+
+declare function earlier(dl:any):Deferred;
+
+declare function loop(n:number, fun:FunctionWithNumber):Deferred;
+declare function loop(n:Loop, fun:FunctionWithNumber):Deferred;
+
+declare function repeat(n:number, fun:FunctionWithNumber):Deferred;
\ No newline at end of file
diff --git a/jsoneditoronline/jsoneditoronline-tests.ts b/jsoneditoronline/jsoneditoronline-tests.ts
new file mode 100644
index 0000000000..d2196e1bcd
--- /dev/null
+++ b/jsoneditoronline/jsoneditoronline-tests.ts
@@ -0,0 +1,38 @@
+// Tests for JSONEditorOnline type definitions
+///
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
-interface KnockoutValidationGroupingOptions {
+///
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
-// build: knockout.viewmodel 1.1.3
-// http://coderenaissance.github.com/knockout.viewmodel/
+/// ko.bindingHandlers).countInits = { init: function() { initCalls++ } };
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "" }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: [1,2,3] }, testNode);
+ expect(initCalls).toEqual(3); // 3 because there were 3 items in myCollection
+ });
+
+ it('Data binding \'foreach\' should handle templates in which the very first node has a binding', function() {
+ // Represents https://github.com/SteveSanderson/knockout/pull/440
+ // Previously, the rewriting (which introduces a comment node before the bound node) was interfering
+ // with the array-to-DOM-node mapping state tracking
+ ko.setTemplateEngine(new dummyTemplateEngine({ mytemplate: "" }));
+ testNode.innerHTML = "";
+
+ // Bind against initial array containing one entry. UI just shows "original"
+ var myArray = ko.observableArray(["original"]);
+ ko.applyBindings({ items: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("ko.bindingHandlers).nonexistentHandler;
+ var initCalls = 0;
+ (ko.bindingHandlers).countInits = { init: function () { initCalls++ } };
+ testNode.innerHTML = ", so modern browsers will silently strip it. We need to verify this doesn't
+ // throw errors during unmemoization (when unmemoizing, it will try to apply the text to the following text node
+ // instead of the node you intended to bind to).
+ // Note that IE < 9 won't strip the ; instead it has much stranger behaviors regarding unexpected DOM structures.
+ // It just happens not to give an error in this particular case, though it would throw errors in many other cases
+ // of malformed template DOM.
+ ko.setTemplateEngine(new dummyTemplateEngine({
+ myTemplate: " " // The whitespace after the closing span is what triggers the strange HTML parsing
+ }));
+ testNode.innerHTML = "";
+ ko.applyBindings(null, testNode);
+ // Since the actual template markup was invalid, we don't really care what the
+ // resulting DOM looks like. We are only verifying there were no exceptions.
+ });
+})
\ No newline at end of file
diff --git a/knockout/knockout-tests.ts b/knockout/tests/knockout-tests.ts
similarity index 96%
rename from knockout/knockout-tests.ts
rename to knockout/tests/knockout-tests.ts
index d669af816e..97a4c8776f 100644
--- a/knockout/knockout-tests.ts
+++ b/knockout/tests/knockout-tests.ts
@@ -1,576 +1,574 @@
-/// null
- };
- viewModel.hasALotOfPets = ko.computed(function () {
- return this.pets().length > 2
- }, viewModel);
- var plainJs = ko.toJS(viewModel);
-
- ko.extenders.logChange = function (target, option) {
- target.subscribe(function (newValue) {
- console.log(option + ": " + newValue);
- });
- return target;
- };
-
- ko.extenders.numeric = function (target, precision) {
- var result = ko.computed({
- read: target,
- write: function (newValue) {
- var current = target(),
- roundingMultiplier = Math.pow(10, precision),
- newValueAsNum = isNaN(newValue) ? 0 : parseFloat(newValue),
- valueToWrite = Math.round(newValueAsNum * roundingMultiplier) / roundingMultiplier;
-
- if (valueToWrite !== current) {
- target(valueToWrite);
- } else {
- if (newValue !== current) {
- target.notifySubscribers(valueToWrite);
- }
- }
- }
- });
-
- result(target());
-
- return result;
- };
-
- function AppViewModel(one, two) {
- this.myNumberOne = ko.observable(one).extend({ numeric: 0 });
- this.myNumberTwo = ko.observable(two).extend({ numeric: 2 });
- }
-
- ko.applyBindings(new AppViewModel(221.2234, 123.4525));
-
- ko.extenders.required = function (target, overrideMessage) {
-
- target.hasError = ko.observable();
- target.validationMessage = ko.observable();
-
- function validate(newValue) {
- target.hasError(newValue ? false : true);
- target.validationMessage(newValue ? "" : overrideMessage || "This field is required");
- }
-
- validate(target());
-
- target.subscribe(validate);
-
- return target;
- };
-
- function AppViewModel(first, last) {
- this.firstName = ko.observable(first).extend({ required: "Please enter a first name" });
- this.lastName = ko.observable(last).extend({ required: "" });
- }
-
- ko.applyBindings(new AppViewModel("Bob", "Smith"));
-
- var first;
- this.firstName = ko.observable(first).extend({ required: "Please enter a first name", logChange: "first name" });
-
- var upperCaseName = ko.computed(function () {
- return name.toUpperCase();
- }).extend({ throttle: 500 });
-
- function AppViewModel() {
- this.instantaneousValue = ko.observable();
- this.throttledValue = ko.computed(this.instantaneousValue)
- .extend({ throttle: 400 });
-
- this.loggedValues = ko.observableArray([]);
- this.throttledValue.subscribe(function (val) {
- if (val !== '')
- this.loggedValues.push(val);
- }, this);
- }
-
- function GridViewModel() {
- this.pageSize = ko.observable(20);
- this.pageIndex = ko.observable(1);
- this.currentPageData = ko.observableArray();
-
- ko.computed(function () {
- var params = { page: this.pageIndex(), size: this.pageSize() };
- $.getJSON('/Some/Json/Service', params, this.currentPageData);
- }, this);
- }
- this.setPageSize = function (newPageSize) {
- this.pageSize(newPageSize);
- this.pageIndex(1);
- }
-
- ko.computed(function () {
- var params = { page: this.pageIndex(), size: this.pageSize() };
- $.getJSON('/Some/Json/Service', params, this.currentPageData);
- }, this).extend({ throttle: 1 });
-
- $(".remove").click(function () {
- viewModel.pets.remove(ko.dataFor(this));
- });
- $(".remove").live("click", function () {
- viewModel.pets.remove(ko.dataFor(this));
- });
-
- $("#people").delegate(".remove", "click", function () {
-
- var context = ko.contextFor(this),
- parentArray = context.$parent.people || context.$parent.children;
-
- parentArray.remove(context.$data);
-
- return false;
- });
- $("#people").delegate(".add", "click", function () {
- var context = ko.contextFor(this),
- childName = context.$data.name() + " child",
- parentArray = context.$data.people || context.$data.children;
-
- context.$root.addChild(childName, parentArray);
-
- return false;
- });
- ko.observableArray.fn.filterByProperty = function (propName, matchValue) {
- return ko.computed(function () {
- var allItems = this(), matchingItems = [];
- for (var i = 0; i < allItems.length; i++) {
- var current = allItems[i];
- if (ko.utils.unwrapObservable(current[propName]) === matchValue)
- matchingItems.push(current);
- }
- return matchingItems;
- }, this);
- }
- function Task(title, done) {
- this.title = ko.observable(title);
- this.done = ko.observable(done);
- }
-
- function AppViewModel() {
- this.tasks = ko.observableArray([
- new Task('Find new desktop background', true),
- new Task('Put shiny stickers on laptop', false),
- new Task('Request more reggae music in the office', true)
- ]);
-
- this.doneTasks = this.tasks.filterByProperty("done", true);
- }
-
- ko.applyBindings(new AppViewModel());
- this.doneTasks = ko.computed(function () {
- var all = this.tasks(), done = [];
- for (var i = 0; i < all.length; i++)
- if (all[i].done())
- done.push(all[i]);
- return done;
- }, this);
-}
-
-function test_mappingplugin() {
- var viewModel = {
- serverTime: ko.observable(),
- numUsers: ko.observable()
- }
- var data = {
- serverTime: '2010-01-07',
- numUsers: 3
- };
- viewModel.serverTime(data.serverTime);
- viewModel.numUsers(data.numUsers);
-
- var viewModel = ko.mapping.fromJS(data);
- ko.mapping.fromJS(data, viewModel);
- var unmapped = ko.mapping.toJS(viewModel);
-
- var viewModel = ko.mapping.fromJS(data);
- ko.mapping.fromJS(data, viewModel);
-
- var myChildModel = function (data) {
- ko.mapping.fromJS(data, {}, this);
-
- this.nameLength = ko.computed(function () {
- return this.name().length;
- }, this);
- }
-
- var oldOptions = ko.mapping.defaultOptions().include;
- ko.mapping.defaultOptions().include = ["alwaysIncludeThis"];
-
- var oldOptions = ko.mapping.defaultOptions().copy;
- ko.mapping.defaultOptions().copy = ["alwaysCopyThis"];
-
- var someObject;
- ko.mapping.fromJS(data, {}, someObject);
- ko.mapping.fromJS(data, {}, this);
-
- var alice, aliceMappingOptions, bob, bobMappingOptions;
- var viewModel = ko.mapping.fromJS(alice, aliceMappingOptions);
- ko.mapping.fromJS(bob, bobMappingOptions, viewModel);
-
- var obj;
- var result = ko.mapping.fromJS(obj, {
- key: function (item) {
- return ko.utils.unwrapObservable(item.id);
- }
- });
-
- result.mappedRemove({ id: 2 });
- var newItem = result.mappedCreate({ id: 3 });
-}
-
-// Define your own functions
-interface KnockoutSubscribableFunctions {
- publishOn(topic: string): any;
- subscribeTo(topic: string): any;
-}
-
-interface KnockoutBindingHandlers {
- isolatedOptions: KnockoutBindingHandler;
-}
-
-function test_misc() {
- // define dummy vars
- var callback: any;
- var target: any;
- var topic: any;
- var vm: any;
- var value: any;
-
- var postbox = new ko.subscribable();
- postbox.subscribe(callback, target, topic);
-
- postbox.subscribe(function (newValue) {
- this.latestTopic(newValue);
- }, vm, "mytopic");
- postbox.notifySubscribers(value, "mytopic");
-
- ko.subscribable.fn.publishOn = function (topic) {
- this.subscribe(function (newValue) {
- postbox.notifySubscribers(newValue, topic);
- });
-
- return this;
- };
-
- this.myObservable = ko.observable("myValue").publishOn("myTopic");
-
- ko.subscribable.fn.subscribeTo = function (topic) {
- postbox.subscribe(this, null, topic);
-
- return this;
- };
-
- this.observableFromAnotherVM = ko.observable().subscribeTo("myTopic");
-
- postbox.subscribe(function (newValue) {
- this(newValue);
- }, this, topic);
-
- ko.bindingHandlers.isolatedOptions = {
- init: function (element, valueAccessor) {
- var args = arguments;
- ko.computed({
- read: function () {
- ko.utils.unwrapObservable(valueAccessor());
- ko.bindingHandlers.options.update.apply(this, args);
- },
- owner: this,
- disposeWhenNodeIsRemoved: element
- });
- }
- };
-
- ko.subscribable.fn.publishOn = function (topic) {
- this.subscribe(function (newValue) {
- postbox.notifySubscribers(newValue, topic);
- });
-
- return this;
- };
-
- this.myObservable = ko.observable("myValue").publishOn("myTopic");
-
- var x = ko.observableArray([1, 2, 3]);
-
- var element;
- ko.utils.domNodeDisposal.addDisposeCallback(element, function () {
- $(element).datepicker("destroy");
- });
+/// null
+ };
+ viewModel.hasALotOfPets = ko.computed(function () {
+ return this.pets().length > 2
+ }, viewModel);
+ var plainJs = ko.toJS(viewModel);
+
+ ko.extenders.logChange = function (target, option) {
+ target.subscribe(function (newValue) {
+ console.log(option + ": " + newValue);
+ });
+ return target;
+ };
+
+ ko.extenders.numeric = function (target, precision) {
+ var result = ko.computed({
+ read: target,
+ write: function (newValue) {
+ var current = target(),
+ roundingMultiplier = Math.pow(10, precision),
+ newValueAsNum = isNaN(newValue) ? 0 : parseFloat(newValue),
+ valueToWrite = Math.round(newValueAsNum * roundingMultiplier) / roundingMultiplier;
+
+ if (valueToWrite !== current) {
+ target(valueToWrite);
+ } else {
+ if (newValue !== current) {
+ target.notifySubscribers(valueToWrite);
+ }
+ }
+ }
+ });
+
+ result(target());
+
+ return result;
+ };
+
+ function AppViewModel(one, two) {
+ this.myNumberOne = ko.observable(one).extend({ numeric: 0 });
+ this.myNumberTwo = ko.observable(two).extend({ numeric: 2 });
+ }
+
+ ko.applyBindings(new AppViewModel(221.2234, 123.4525));
+
+ ko.extenders.required = function (target, overrideMessage) {
+
+ target.hasError = ko.observable();
+ target.validationMessage = ko.observable();
+
+ function validate(newValue) {
+ target.hasError(newValue ? false : true);
+ target.validationMessage(newValue ? "" : overrideMessage || "This field is required");
+ }
+
+ validate(target());
+
+ target.subscribe(validate);
+
+ return target;
+ };
+
+ function AppViewModel(first, last) {
+ this.firstName = ko.observable(first).extend({ required: "Please enter a first name" });
+ this.lastName = ko.observable(last).extend({ required: "" });
+ }
+
+ ko.applyBindings(new AppViewModel("Bob", "Smith"));
+
+ var first;
+ this.firstName = ko.observable(first).extend({ required: "Please enter a first name", logChange: "first name" });
+
+ var upperCaseName = ko.computed(function () {
+ return name.toUpperCase();
+ }).extend({ throttle: 500 });
+
+ function AppViewModel() {
+ this.instantaneousValue = ko.observable();
+ this.throttledValue = ko.computed(this.instantaneousValue)
+ .extend({ throttle: 400 });
+
+ this.loggedValues = ko.observableArray([]);
+ this.throttledValue.subscribe(function (val) {
+ if (val !== '')
+ this.loggedValues.push(val);
+ }, this);
+ }
+
+ function GridViewModel() {
+ this.pageSize = ko.observable(20);
+ this.pageIndex = ko.observable(1);
+ this.currentPageData = ko.observableArray();
+
+ ko.computed(function () {
+ var params = { page: this.pageIndex(), size: this.pageSize() };
+ $.getJSON('/Some/Json/Service', params, this.currentPageData);
+ }, this);
+ }
+ this.setPageSize = function (newPageSize) {
+ this.pageSize(newPageSize);
+ this.pageIndex(1);
+ }
+
+ ko.computed(function () {
+ var params = { page: this.pageIndex(), size: this.pageSize() };
+ $.getJSON('/Some/Json/Service', params, this.currentPageData);
+ }, this).extend({ throttle: 1 });
+
+ $(".remove").click(function () {
+ viewModel.pets.remove(ko.dataFor(this));
+ });
+ $(".remove").live("click", function () {
+ viewModel.pets.remove(ko.dataFor(this));
+ });
+
+ $("#people").delegate(".remove", "click", function () {
+
+ var context = ko.contextFor(this),
+ parentArray = context.$parent.people || context.$parent.children;
+
+ parentArray.remove(context.$data);
+
+ return false;
+ });
+ $("#people").delegate(".add", "click", function () {
+ var context = ko.contextFor(this),
+ childName = context.$data.name() + " child",
+ parentArray = context.$data.people || context.$data.children;
+
+ context.$root.addChild(childName, parentArray);
+
+ return false;
+ });
+ ko.observableArray.fn.filterByProperty = function (propName, matchValue) {
+ return ko.computed(function () {
+ var allItems = this(), matchingItems = [];
+ for (var i = 0; i < allItems.length; i++) {
+ var current = allItems[i];
+ if (ko.utils.unwrapObservable(current[propName]) === matchValue)
+ matchingItems.push(current);
+ }
+ return matchingItems;
+ }, this);
+ }
+ function Task(title, done) {
+ this.title = ko.observable(title);
+ this.done = ko.observable(done);
+ }
+
+ function AppViewModel() {
+ this.tasks = ko.observableArray([
+ new Task('Find new desktop background', true),
+ new Task('Put shiny stickers on laptop', false),
+ new Task('Request more reggae music in the office', true)
+ ]);
+
+ this.doneTasks = this.tasks.filterByProperty("done", true);
+ }
+
+ ko.applyBindings(new AppViewModel());
+ this.doneTasks = ko.computed(function () {
+ var all = this.tasks(), done = [];
+ for (var i = 0; i < all.length; i++)
+ if (all[i].done())
+ done.push(all[i]);
+ return done;
+ }, this);
+}
+
+function test_mappingplugin() {
+ var viewModel = {
+ serverTime: ko.observable(),
+ numUsers: ko.observable()
+ }
+ var data = {
+ serverTime: '2010-01-07',
+ numUsers: 3
+ };
+ viewModel.serverTime(data.serverTime);
+ viewModel.numUsers(data.numUsers);
+
+ var viewModel = ko.mapping.fromJS(data);
+ ko.mapping.fromJS(data, viewModel);
+ var unmapped = ko.mapping.toJS(viewModel);
+
+ var viewModel = ko.mapping.fromJS(data);
+ ko.mapping.fromJS(data, viewModel);
+
+ var myChildModel = function (data) {
+ ko.mapping.fromJS(data, {}, this);
+
+ this.nameLength = ko.computed(function () {
+ return this.name().length;
+ }, this);
+ }
+
+ var oldOptions = ko.mapping.defaultOptions().include;
+ ko.mapping.defaultOptions().include = ["alwaysIncludeThis"];
+
+ var oldOptions = ko.mapping.defaultOptions().copy;
+ ko.mapping.defaultOptions().copy = ["alwaysCopyThis"];
+
+ var someObject;
+ ko.mapping.fromJS(data, {}, someObject);
+ ko.mapping.fromJS(data, {}, this);
+
+ var alice, aliceMappingOptions, bob, bobMappingOptions;
+ var viewModel = ko.mapping.fromJS(alice, aliceMappingOptions);
+ ko.mapping.fromJS(bob, bobMappingOptions, viewModel);
+
+ var obj;
+ var result = ko.mapping.fromJS(obj, {
+ key: function (item) {
+ return ko.utils.unwrapObservable(item.id);
+ }
+ });
+
+ result.mappedRemove({ id: 2 });
+ var newItem = result.mappedCreate({ id: 3 });
+}
+
+// Define your own functions
+interface KnockoutSubscribableFunctions {
+ publishOn(topic: string): any;
+ subscribeTo(topic: string): any;
+}
+
+interface KnockoutBindingHandlers {
+ isolatedOptions: KnockoutBindingHandler;
+}
+
+function test_misc() {
+ // define dummy vars
+ var callback: any;
+ var target: any;
+ var topic: any;
+ var vm: any;
+ var value: any;
+
+ var postbox = new ko.subscribable();
+ postbox.subscribe(callback, target, topic);
+
+ postbox.subscribe(function (newValue) {
+ this.latestTopic(newValue);
+ }, vm, "mytopic");
+ postbox.notifySubscribers(value, "mytopic");
+
+ ko.subscribable.fn.publishOn = function (topic) {
+ this.subscribe(function (newValue) {
+ postbox.notifySubscribers(newValue, topic);
+ });
+
+ return this;
+ };
+
+ this.myObservable = ko.observable("myValue").publishOn("myTopic");
+
+ ko.subscribable.fn.subscribeTo = function (topic) {
+ postbox.subscribe(this, null, topic);
+
+ return this;
+ };
+
+ this.observableFromAnotherVM = ko.observable().subscribeTo("myTopic");
+
+ postbox.subscribe(function (newValue) {
+ this(newValue);
+ }, this, topic);
+
+ ko.bindingHandlers.isolatedOptions = {
+ init: function (element, valueAccessor) {
+ var args = arguments;
+ ko.computed({
+ read: function () {
+ ko.utils.unwrapObservable(valueAccessor());
+ ko.bindingHandlers.options.update.apply(this, args);
+ },
+ owner: this,
+ disposeWhenNodeIsRemoved: element
+ });
+ }
+ };
+
+ ko.subscribable.fn.publishOn = function (topic) {
+ this.subscribe(function (newValue) {
+ postbox.notifySubscribers(newValue, topic);
+ });
+
+ return this;
+ };
+
+ this.myObservable = ko.observable("myValue").publishOn("myTopic");
+
+ var x = ko.observableArray([1, 2, 3]);
+
+ var element;
+ ko.utils.domNodeDisposal.addDisposeCallback(element, function () {
+ $(element).datepicker("destroy");
+ });
}
\ No newline at end of file
diff --git a/leaflet/leaflet.d.ts b/leaflet/leaflet.d.ts
new file mode 100644
index 0000000000..62dd73be11
--- /dev/null
+++ b/leaflet/leaflet.d.ts
@@ -0,0 +1,2953 @@
+// Type definitions for Leaflet.js 0.5
+// Project: https://github.com/Leaflet/Leaflet
+// Definitions by: Vladimir
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+
+declare module L {
+ export interface MapOptions {
+ /**
+ * Initial geographical center of the map.
+ */
+ center?: LatLng;
+
+ /**
+ * Initial map zoom.
+ */
+ zoom?: number;
+
+ /**
+ * Layers that will be added to the map initially.
+ */
+ layers?: ILayer[];
+
+ /**
+ * Minimum zoom level of the map. Overrides any minZoom set on map layers.
+ */
+ minZoom?: number;
+
+ /**
+ * Maximum zoom level of the map. This overrides any maxZoom set on map layers.
+ */
+ maxZoom?: number;
+
+ /**
+ * When this option is set, the map restricts the view to the given geographical
+ * bounds, bouncing the user back when he tries to pan outside the view, and also
+ * not allowing to zoom out to a view that's larger than the given bounds (depending
+ * on the map size). To set the restriction dynamically, use setMaxBounds method
+ */
+ maxBounds?: LatLngBounds;
+
+ /**
+ * Coordinate Reference System to use. Don't change this if you're not sure
+ * what it means.
+ */
+ crs?: ICRS;
+
+ /**
+ * Whether the map be draggable with mouse/touch or not.
+ */
+ dragging?: bool;
+
+ /**
+ * Whether the map can be zoomed by touch-dragging with two fingers.
+ */
+ touchZoom?: bool;
+
+ /**
+ * Whether the map can be zoomed by using the mouse wheel.
+ */
+ scrollWheelZoom?: bool;
+
+ /**
+ * Whether the map can be zoomed in by double clicking on it.
+ */
+ doubleClickZoom?: bool;
+
+ /**
+ * Whether the map can be zoomed to a rectangular area specified by dragging
+ * the mouse while pressing shift.
+ */
+ boxZoom?: bool;
+
+ /**
+ * Whether the map automatically handles browser window resize to update itself.
+ */
+ trackResize?: bool;
+
+ /**
+ * With this option enabled, the map tracks when you pan to another "copy" of
+ * the world and seamlessly jumps to the original one so that all overlays like
+ * markers and vector layers are still visible.
+ */
+ worldCopyJump?: bool;
+
+ /**
+ * Set it to false if you don't want popups to close when user clicks the map.
+ */
+ closePopupOnClick?: bool;
+
+ /**
+ * Makes the map focusable and allows users to navigate the map with keyboard
+ * arrows and +/- keys.
+ */
+ keyboard?: bool;
+
+ /**
+ * Amount of pixels to pan when pressing an arrow key.
+ */
+ keyboardPanOffset?: number;
+
+ /**
+ * Number of zoom levels to change when pressing + or - key.
+ */
+ keyboardZoomOffset?: number;
+
+ /**
+ * If enabled, panning of the map will have an inertia effect where the map builds
+ * momentum while dragging and continues moving in the same direction for some
+ * time. Feels especially nice on touch devices.
+ */
+ inertia?: bool;
+
+ /**
+ * The rate with which the inertial movement slows down, in pixels/second2.
+ */
+ inertiaDeceleration?: number;
+
+ /**
+ * Max speed of the inertial movement, in pixels/second.
+ */
+ inertiaMaxSpeed?: number;
+
+ /**
+ * Amount of milliseconds that should pass between stopping the movement and
+ * releasing the mouse or touch to prevent inertial movement. 32 for touch devices
+ * and 14 for the rest by default.
+ */
+ inertiaThreshold?: number;
+
+ /**
+ * Whether the zoom control is added to the map by default.
+ */
+ zoomControl?: bool;
+
+ /**
+ * Whether the attribution control is added to the map by default.
+ */
+ attributionControl?: bool;
+
+ /**
+ * Whether the tile fade animation is enabled. By default it's enabled in all
+ * browsers that support CSS3 Transitions except Android.
+ */
+ fadeAnimation?: bool;
+
+ /**
+ * Whether the tile zoom animation is enabled. By default it's enabled in all
+ * browsers that support CSS3 Transitions except Android.
+ */
+ zoomAnimation?: bool;
+
+ /**
+ * Whether markers animate their zoom with the zoom animation, if disabled
+ * they will disappear for the length of the animation. By default it's enabled
+ * in all browsers that support CSS3 Transitions except Android.
+ */
+ markerZoomAnimation?: bool;
+
+ }
+
+ export interface LocateOptions {
+ /**
+ * If true, starts continous watching of location changes (instead of detecting
+ * it once) using W3C watchPosition method. You can later stop watching using
+ * map.stopLocate() method.
+ */
+ watch?: bool;
+
+ /**
+ * If true, automatically sets the map view to the user location with respect
+ * to detection accuracy, or to world view if geolocation failed.
+ */
+ setView?: bool;
+
+ /**
+ * The maximum zoom for automatic view setting when using `setView` option.
+ */
+ maxZoom?: number;
+
+ /**
+ * Number of millisecond to wait for a response from geolocation before firing
+ * a locationerror event.
+ */
+ timeout?: number;
+
+ /**
+ * Maximum age of detected location. If less than this amount of milliseconds
+ * passed since last geolocation response, locate will return a cached location.
+ */
+ maximumAge?: number;
+
+ /**
+ * Enables high accuracy, see description in the W3C spec.
+ */
+ enableHighAccuracy?: bool;
+
+ }
+
+ export interface MapPanes {
+ /**
+ * Pane that contains all other map panes.
+ */
+ mapPane: HTMLElement;
+
+ /**
+ * Pane for tile layers.
+ */
+ tilePane: HTMLElement;
+
+ /**
+ * Pane that contains all the panes except tile pane.
+ */
+ objectsPane: HTMLElement;
+
+ /**
+ * Pane for overlay shadows (e.g. marker shadows).
+ */
+ shadowPane: HTMLElement;
+
+ /**
+ * Pane for overlays like polylines and polygons.
+ */
+ overlayPane: HTMLElement;
+
+ /**
+ * Pane for marker icons.
+ */
+ markerPane: HTMLElement;
+
+ /**
+ * Pane for popups.
+ */
+ popupPane: HTMLElement;
+
+ }
+
+ export class Map implements IEventPowered {
+ /**
+ * Instantiates a map object given a div element (or its id) and optionally an
+ * object literal with map options described below.
+ */
+ constructor(id: HTMLElement, options?: MapOptions);
+
+ /**
+ * Instantiates a map object given a div element (or its id) and optionally an
+ * object literal with map options described below.
+ */
+ constructor(id: string, options?: MapOptions);
+
+ /**
+ * Sets the view of the map (geographical center and zoom). If forceReset is
+ * set to true, the map is reloaded even if it's eligible for pan or zoom animation
+ * (false by default).
+ */
+ setView(center: LatLng, zoom: number, forceReset?: bool): Map;
+
+ /**
+ * Sets the zoom of the map.
+ */
+ setZoom(zoom: number): Map;
+
+ /**
+ * Increases the zoom of the map by delta (1 by default).
+ */
+ zoomIn(delta?: number): Map;
+
+ /**
+ * Decreases the zoom of the map by delta (1 by default).
+ */
+ zoomOut(delta?: number): Map;
+
+ /**
+ * Sets a map view that contains the given geographical bounds with the maximum
+ * zoom level possible.
+ */
+ fitBounds(bounds: LatLngBounds): Map;
+
+ /**
+ * Sets a map view that mostly contains the whole world with the maximum zoom
+ * level possible.
+ */
+ fitWorld(): Map;
+
+ /**
+ * Pans the map to a given center. Makes an animated pan if new center is not more
+ * than one screen away from the current one.
+ */
+ panTo(latlng: LatLng): Map;
+
+ /**
+ * Pans the map to the closest view that would lie inside the given bounds (if
+ * it's not already).
+ */
+ panInsideBounds(bounds: LatLngBounds): Map;
+
+ /**
+ * Pans the map by a given number of pixels (animated).
+ */
+ panBy(point: Point): Map;
+
+ /**
+ * Checks if the map container size changed and updates the map if so — call it
+ * after you've changed the map size dynamically. If animate is true, map animates
+ * the update.
+ */
+ invalidateSize(animate?: bool): Map;
+
+ /**
+ * Restricts the map view to the given bounds (see map maxBounds option).
+ */
+ setMaxBounds(bounds: LatLngBounds): Map;
+
+ /**
+ * Tries to locate the user using Geolocation API, firing locationfound event
+ * with location data on success or locationerror event on failure, and optionally
+ * sets the map view to the user location with respect to detection accuracy
+ * (or to the world view if geolocation failed). See Locate options for more
+ * details.
+ */
+ locate(options?: LocateOptions): Map;
+
+ /**
+ * Stops watching location previously initiated by map.locate({watch: true}).
+ */
+ stopLocate(): Map;
+
+ /**
+ * Returns the geographical center of the map view.
+ */
+ getCenter(): LatLng;
+
+ /**
+ * Returns the current zoom of the map view.
+ */
+ getZoom(): number;
+
+ /**
+ * Returns the minimum zoom level of the map.
+ */
+ getMinZoom(): number;
+
+ /**
+ * Returns the maximum zoom level of the map.
+ */
+ getMaxZoom(): number;
+
+ /**
+ * Returns the LatLngBounds of the current map view.
+ */
+ getBounds(): LatLngBounds;
+
+ /**
+ * Returns the maximum zoom level on which the given bounds fit to the map view
+ * in its entirety. If inside (optional) is set to true, the method instead returns
+ * the minimum zoom level on which the map view fits into the given bounds in its
+ * entirety.
+ */
+ getBoundsZoom(bounds: LatLngBounds, inside?: bool): number;
+
+ /**
+ * Returns the current size of the map container.
+ */
+ getSize(): Point;
+
+ /**
+ * Returns the bounds of the current map view in projected pixel coordinates
+ * (sometimes useful in layer and overlay implementations).
+ */
+ getPixelBounds(): Bounds;
+
+ /**
+ * Returns the projected pixel coordinates of the top left point of the map layer
+ * (useful in custom layer and overlay implementations).
+ */
+ getPixelOrigin(): Point;
+
+ /**
+ * Adds the given layer to the map. If optional insertAtTheBottom is set to true,
+ * the layer is inserted under all others (useful when switching base tile layers).
+ */
+ addLayer(layer: ILayer, insertAtTheBottom?: bool): Map;
+
+ /**
+ * Removes the given layer from the map.
+ */
+ removeLayer(layer: ILayer): Map;
+
+ /**
+ * Returns true if the given layer is currently added to the map.
+ */
+ hasLayer(layer: ILayer): bool;
+
+ /**
+ * Opens the specified popup while closing the previously opened (to make sure
+ * only one is opened at one time for usability).
+ */
+ openPopup(popup: Popup): Map;
+
+ /**
+ * Closes the popup opened with openPopup.
+ */
+ closePopup(): Map;
+
+ /**
+ * Adds the given control to the map.
+ */
+ addControl(control: IControl): Map;
+
+ /**
+ * Removes the given control from the map.
+ */
+ removeControl(control: IControl): Map;
+
+ /**
+ * Returns the map layer point that corresponds to the given geographical coordinates
+ * (useful for placing overlays on the map).
+ */
+ latLngToLayerPoint(latlng: LatLng): Point;
+
+ /**
+ * Returns the geographical coordinates of a given map layer point.
+ */
+ layerPointToLatLng(point: Point): LatLng;
+
+ /**
+ * Converts the point relative to the map container to a point relative to the
+ * map layer.
+ */
+ containerPointToLayerPoint(point: Point): Point;
+
+ /**
+ * Converts the point relative to the map layer to a point relative to the map
+ * container.
+ */
+ layerPointToContainerPoint(point: Point): Point;
+
+ /**
+ * Returns the map container point that corresponds to the given geographical
+ * coordinates.
+ */
+ latLngToContainerPoint(latlng: LatLng): Point;
+
+ /**
+ * Returns the geographical coordinates of a given map container point.
+ */
+ containerPointToLatLng(point: Point): LatLng;
+
+ /**
+ * Projects the given geographical coordinates to absolute pixel coordinates
+ * for the given zoom level (current zoom level by default).
+ */
+ project(latlng: LatLng, zoom?: number): Point;
+
+ /**
+ * Projects the given absolute pixel coordinates to geographical coordinates
+ * for the given zoom level (current zoom level by default).
+ */
+ unproject(point: Point, zoom?: number): LatLng;
+
+ /**
+ * Returns the pixel coordinates of a mouse click (relative to the top left corner
+ * of the map) given its event object.
+ */
+ mouseEventToContainerPoint(event: LeafletMouseEvent): Point;
+
+ /**
+ * Returns the pixel coordinates of a mouse click relative to the map layer given
+ * its event object.
+ */
+ mouseEventToLayerPoint(event: LeafletMouseEvent): Point;
+
+ /**
+ * Returns the geographical coordinates of the point the mouse clicked on given
+ * the click's event object.
+ */
+ mouseEventToLatLng(event: LeafletMouseEvent): LatLng;
+
+ /**
+ * Returns the container element of the map.
+ */
+ getContainer(): HTMLElement;
+
+ /**
+ * Returns an object with different map panes (to render overlays in).
+ */
+ getPanes(): MapPanes;
+
+ /**
+ * Runs the given callback when the map gets initialized with a place and zoom,
+ * or immediately if it happened already, optionally passing a function context.
+ */
+ whenReady(fn: Function, context?: any): Map;
+
+ /**
+ * Map dragging handler (by both mouse and touch).
+ */
+ dragging: IHandler;
+
+ /**
+ * Touch zoom handler.
+ */
+ touchZoom: IHandler;
+
+ /**
+ * Double click zoom handler.
+ */
+ doubleClickZoom: IHandler;
+
+ /**
+ * Scroll wheel zoom handler.
+ */
+ scrollWheelZoom: IHandler;
+
+ /**
+ * Box (shift-drag with mouse) zoom handler.
+ */
+ boxZoom: IHandler;
+
+ /**
+ * Keyboard navigation handler.
+ */
+ keyboard: IHandler;
+
+ /**
+ * Zoom control.
+ */
+ zoomControl: Zoom;
+
+ /**
+ * Attribution control.
+ */
+ attributionControl: Attribution;
+
+ ////////////
+ //// IEventPowered members
+ ////////////
+
+ addEventListener(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ addEventListener(eventMap: any, context?: any): IEventPowered;
+ removeEventListener(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ removeEventListener(eventMap: any, context?: any): IEventPowered;
+ hasEventListeners(type: string): bool;
+ fireEvent(type: string, data?: any): IEventPowered;
+ on(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ on(eventMap: any, context?: any): IEventPowered;
+ off(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ off(eventMap: any, context?: any): IEventPowered;
+ fire(type: string, data?: any): IEventPowered;
+ }
+
+ export interface MarkerOptions {
+ /**
+ * Icon class to use for rendering the marker. See Icon documentation for details
+ * on how to customize the marker icon. Set to new L.Icon.Default() by default.
+ */
+ icon?: Icon;
+
+ /**
+ * If false, the marker will not emit mouse events and will act as a part of the
+ * underlying map.
+ */
+ clickable?: bool;
+
+ /**
+ * Whether the marker is draggable with mouse/touch or not.
+ */
+ draggable?: bool;
+
+ /**
+ * Text for the browser tooltip that appear on marker hover (no tooltip by default).
+ */
+ title?: string;
+
+ /**
+ * By default, marker images zIndex is set automatically based on its latitude.
+ * You this option if you want to put the marker on top of all others (or below),
+ * specifying a high value like 1000 (or high negative value, respectively).
+ */
+ zIndexOffset?: number;
+
+ /**
+ * The opacity of the marker.
+ */
+ opacity?: number;
+
+ /**
+ * If true, the marker will get on top of others when you hover the mouse over it.
+ */
+ riseOnHover?: bool;
+
+ /**
+ * The z-index offset used for the riseOnHover feature.
+ */
+ riseOffset?: number;
+
+ }
+
+ export class Marker implements ILayer, IEventPowered {
+ /**
+ * Instantiates a Marker object given a geographical point and optionally
+ * an options object.
+ */
+ constructor(latlng: LatLng, options?: MarkerOptions);
+
+ /**
+ * Adds the marker to the map.
+ */
+ addTo(map: Map): Marker;
+
+ /**
+ * Returns the current geographical position of the marker.
+ */
+ getLatLng(): LatLng;
+
+ /**
+ * Changes the marker position to the given point.
+ */
+ setLatLng(latlng: LatLng): Marker;
+
+ /**
+ * Changes the marker icon.
+ */
+ setIcon(icon: Icon): Marker;
+
+ /**
+ * Changes the zIndex offset of the marker.
+ */
+ setZIndexOffset(offset: number): Marker;
+
+ /**
+ * Changes the opacity of the marker.
+ */
+ setOpacity(opacity: number): Marker;
+
+ /**
+ * Updates the marker position, useful if coordinates of its latLng object
+ * were changed directly.
+ */
+ update(): Marker;
+
+ /**
+ * Binds a popup with a particular HTML content to a click on this marker. You
+ * can also open the bound popup with the Marker openPopup method.
+ */
+ bindPopup(htmlContent: string, options?: PopupOptions): Marker;
+
+ /**
+ * Unbinds the popup previously bound to the marker with bindPopup.
+ */
+ unbindPopup(): Marker;
+
+ /**
+ * Opens the popup previously bound by the bindPopup method.
+ */
+ openPopup(): Marker;
+
+ /**
+ * Closes the bound popup of the marker if it's opened.
+ */
+ closePopup(): Marker;
+
+ ////////////
+ //// ILayer members
+ ////////////
+
+ /**
+ * Should contain code that creates DOM elements for the overlay, adds them
+ * to map panes where they should belong and puts listeners on relevant map events.
+ * Called on map.addLayer(layer).
+ */
+ onAdd(map: Map): void;
+
+ /**
+ * Should contain all clean up code that removes the overlay's elements from
+ * the DOM and removes listeners previously added in onAdd. Called on map.removeLayer(layer).
+ */
+ onRemove(map: Map): void;
+
+ ////////////
+ //// IEventPowered members
+ ////////////
+
+ addEventListener(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ addEventListener(eventMap: any, context?: any): IEventPowered;
+ removeEventListener(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ removeEventListener(eventMap: any, context?: any): IEventPowered;
+ hasEventListeners(type: string): bool;
+ fireEvent(type: string, data?: any): IEventPowered;
+ on(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ on(eventMap: any, context?: any): IEventPowered;
+ off(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ off(eventMap: any, context?: any): IEventPowered;
+ fire(type: string, data?: any): IEventPowered;
+ }
+
+ export interface PopupOptions {
+ /**
+ * Max width of the popup.
+ */
+ maxWidth?: number;
+
+ /**
+ * Min width of the popup.
+ */
+ minWidth?: number;
+
+ /**
+ * If set, creates a scrollable container of the given height inside a popup
+ * if its content exceeds it.
+ */
+ maxHeight?: number;
+
+ /**
+ * Set it to false if you don't want the map to do panning animation to fit the opened
+ * popup.
+ */
+ autoPan?: bool;
+
+ /**
+ * Controls the presense of a close button in the popup.
+ */
+ closeButton?: bool;
+
+ /**
+ * The offset of the popup position. Useful to control the anchor of the popup
+ * when opening it on some overlays.
+ */
+ offset?: Point;
+
+ /**
+ * The margin between the popup and the edges of the map view after autopanning
+ * was performed.
+ */
+ autoPanPadding?: Point;
+
+ /**
+ * Whether to animate the popup on zoom. Disable it if you have problems with
+ * Flash content inside popups.
+ */
+ zoomAnimation?: bool;
+
+ }
+
+ export class Popup implements ILayer {
+ /**
+ * Instantiates a Popup object given an optional options object that describes
+ * its appearance and location and an optional object that is used to tag the
+ * popup with a reference to the source object to which it refers.
+ */
+ constructor(options?: PopupOptions, source?: any);
+
+ /**
+ * Adds the popup to the map.
+ */
+ addTo(map: Map): Popup;
+
+ /**
+ * Adds the popup to the map and closes the previous one. The same as map.openPopup(popup).
+ */
+ openOn(map: Map): Popup;
+
+ /**
+ * Sets the geographical point where the popup will open.
+ */
+ setLatLng(latlng: LatLng): Popup;
+
+ /**
+ * Sets the HTML content of the popup.
+ */
+ setContent(htmlContent: string): Popup;
+
+ ////////////
+ //// ILayer members
+ ////////////
+
+ /**
+ * Should contain code that creates DOM elements for the overlay, adds them
+ * to map panes where they should belong and puts listeners on relevant map events.
+ * Called on map.addLayer(layer).
+ */
+ onAdd(map: Map): void;
+
+ /**
+ * Should contain all clean up code that removes the overlay's elements from
+ * the DOM and removes listeners previously added in onAdd. Called on map.removeLayer(layer).
+ */
+ onRemove(map: Map): void;
+
+ }
+
+ export interface TileLayerOptions {
+ /**
+ * Minimum zoom number.
+ */
+ minZoom?: number;
+
+ /**
+ * Maximum zoom number.
+ */
+ maxZoom?: number;
+
+ /**
+ * Tile size (width and height in pixels, assuming tiles are square).
+ */
+ tileSize?: number;
+
+ /**
+ * Subdomains of the tile service. Can be passed in the form of one string (where
+ * each letter is a subdomain name) or an array of strings.
+ */
+ subdomains?: string;
+
+ /**
+ * URL to the tile image to show in place of the tile that failed to load.
+ */
+ errorTileUrl?: string;
+
+ /**
+ * e.g. "© CloudMade" — the string used by the attribution control, describes
+ * the layer data.
+ */
+ attribution?: string;
+
+ /**
+ * If true, inverses Y axis numbering for tiles (turn this on for TMS services).
+ */
+ tms?: bool;
+
+ /**
+ * If set to true, the tile coordinates won't be wrapped by world width (-180
+ * to 180 longitude) or clamped to lie within world height (-90 to 90). Use this
+ * if you use Leaflet for maps that don't reflect the real world (e.g. game, indoor
+ * or photo maps).
+ */
+ continuousWorld?: bool;
+
+ /**
+ * If set to true, the tiles just won't load outside the world width (-180 to 180
+ * longitude) instead of repeating.
+ */
+ noWrap?: bool;
+
+ /**
+ * The zoom number used in tile URLs will be offset with this value.
+ */
+ zoomOffset?: number;
+
+ /**
+ * If set to true, the zoom number used in tile URLs will be reversed (maxZoom
+ * - zoom instead of zoom)
+ */
+ zoomReverse?: bool;
+
+ /**
+ * The opacity of the tile layer.
+ */
+ opacity?: number;
+
+ /**
+ * The explicit zIndex of the tile layer. Not set by default.
+ */
+ zIndex?: number;
+
+ /**
+ * If true, all the tiles that are not visible after panning are removed (for
+ * better performance). true by default on mobile WebKit, otherwise false.
+ */
+ unloadInvisibleTiles?: bool;
+
+ /**
+ * If false, new tiles are loaded during panning, otherwise only after it (for
+ * better performance). true by default on mobile WebKit, otherwise false.
+ */
+ updateWhenIdle?: bool;
+
+ /**
+ * If true and user is on a retina display, it will request four tiles of half the
+ * specified size and a bigger zoom level in place of one to utilize the high resolution.
+ */
+ detectRetina?: bool;
+
+ /**
+ * If true, all the tiles that are not visible after panning are placed in a reuse
+ * queue from which they will be fetched when new tiles become visible (as opposed
+ * to dynamically creating new ones). This will in theory keep memory usage
+ * low and eliminate the need for reserving new memory whenever a new tile is
+ * needed.
+ */
+ reuseTiles?: bool;
+
+ }
+
+ export class TileLayer implements ILayer, IEventPowered {
+ /**
+ * Instantiates a tile layer object given a URL template and optionally an options
+ * object.
+ */
+ constructor(urlTemplate: string, options?: TileLayerOptions);
+
+ /**
+ * Adds the layer to the map.
+ */
+ addTo(map: Map): TileLayer;
+
+ /**
+ * Brings the tile layer to the top of all tile layers.
+ */
+ bringToFront(): TileLayer;
+
+ /**
+ * Brings the tile layer to the bottom of all tile layers.
+ */
+ bringToBack(): TileLayer;
+
+ /**
+ * Changes the opacity of the tile layer.
+ */
+ setOpacity(opacity: number): TileLayer;
+
+ /**
+ * Sets the zIndex of the tile layer.
+ */
+ setZIndex(zIndex: number): TileLayer;
+
+ /**
+ * Causes the layer to clear all the tiles and request them again.
+ */
+ redraw(): TileLayer;
+
+ /**
+ * Updates the layer's URL template and redraws it.
+ */
+ setUrl(urlTemplate: string): TileLayer;
+
+ static WMS: new () => WMS;
+
+ static Canvas: new () => Canvas;
+
+ ////////////
+ //// ILayer members
+ ////////////
+
+ /**
+ * Should contain code that creates DOM elements for the overlay, adds them
+ * to map panes where they should belong and puts listeners on relevant map events.
+ * Called on map.addLayer(layer).
+ */
+ onAdd(map: Map): void;
+
+ /**
+ * Should contain all clean up code that removes the overlay's elements from
+ * the DOM and removes listeners previously added in onAdd. Called on map.removeLayer(layer).
+ */
+ onRemove(map: Map): void;
+
+ ////////////
+ //// IEventPowered members
+ ////////////
+
+ addEventListener(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ addEventListener(eventMap: any, context?: any): IEventPowered;
+ removeEventListener(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ removeEventListener(eventMap: any, context?: any): IEventPowered;
+ hasEventListeners(type: string): bool;
+ fireEvent(type: string, data?: any): IEventPowered;
+ on(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ on(eventMap: any, context?: any): IEventPowered;
+ off(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ off(eventMap: any, context?: any): IEventPowered;
+ fire(type: string, data?: any): IEventPowered;
+ }
+
+ export interface WMSOptions {
+ /**
+ * (required) Comma-separated list of WMS layers to show.
+ */
+ layers?: string;
+
+ /**
+ * Comma-separated list of WMS styles.
+ */
+ styles?: string;
+
+ /**
+ * WMS image format (use 'image/png' for layers with transparency).
+ */
+ format?: string;
+
+ /**
+ * If true, the WMS service will return images with transparency.
+ */
+ transparent?: bool;
+
+ /**
+ * Version of the WMS service to use.
+ */
+ version?: string;
+
+ }
+
+ export class WMS {
+ /**
+ * Instantiates a WMS tile layer object given a base URL of the WMS service and
+ * a WMS parameters/options object.
+ */
+ constructor(baseUrl: string, options: WMSOptions);
+
+ /**
+ * Merges an object with the new parameters and re-requests tiles on the current
+ * screen (unless noRedraw was set to true).
+ */
+ setParams(params: WMS, noRedraw?: bool): WMS;
+
+ }
+
+ export class Canvas {
+ /**
+ * Instantiates a Canvas tile layer object given an options object (optionally).
+ */
+ constructor(options?: TileLayerOptions);
+
+ /**
+ * You need to define this method after creating the instance to draw tiles;
+ * canvas is the actual canvas tile on which you can draw, tilePoint represents
+ * the tile numbers, and zoom is the current zoom.
+ */
+ drawTile(canvas: HTMLCanvasElement, tilePoint: Point, zoom: number): Canvas;
+
+ /**
+ * Calling redraw will cause the drawTile method to be called for all tiles.
+ * May be used for updating dynamic content drawn on the Canvas
+ */
+ redraw(): Canvas;
+
+ }
+
+ export interface ImageOverlayOptions {
+ /**
+ * The opacity of the image overlay.
+ */
+ opacity?: number;
+
+ }
+
+ export class ImageOverlay implements ILayer {
+ /**
+ * Instantiates an image overlay object given the URL of the image and the geographical
+ * bounds it is tied to.
+ */
+ constructor(imageUrl: string, bounds: LatLngBounds, options?: ImageOverlayOptions);
+
+ /**
+ * Adds the overlay to the map.
+ */
+ addTo(map: Map): ImageOverlay;
+
+ /**
+ * Sets the opacity of the overlay.
+ */
+ setOpacity(opacity: number): ImageOverlay;
+
+ /**
+ * Brings the layer to the top of all overlays.
+ */
+ bringToFront(): ImageOverlay;
+
+ /**
+ * Brings the layer to the bottom of all overlays.
+ */
+ bringToBack(): ImageOverlay;
+
+ ////////////
+ //// ILayer members
+ ////////////
+
+ /**
+ * Should contain code that creates DOM elements for the overlay, adds them
+ * to map panes where they should belong and puts listeners on relevant map events.
+ * Called on map.addLayer(layer).
+ */
+ onAdd(map: Map): void;
+
+ /**
+ * Should contain all clean up code that removes the overlay's elements from
+ * the DOM and removes listeners previously added in onAdd. Called on map.removeLayer(layer).
+ */
+ onRemove(map: Map): void;
+
+ }
+
+ export interface PathOptions {
+ /**
+ * Whether to draw stroke along the path. Set it to false to disable borders on
+ * polygons or circles.
+ */
+ stroke?: bool;
+
+ /**
+ * Stroke color.
+ */
+ color?: string;
+
+ /**
+ * Stroke width in pixels.
+ */
+ weight?: number;
+
+ /**
+ * Stroke opacity.
+ */
+ opacity?: number;
+
+ /**
+ * Whether to fill the path with color. Set it to false to disable filling on polygons
+ * or circles.
+ */
+ fill?: bool;
+
+ /**
+ * Fill color.
+ */
+ fillColor?: string;
+
+ /**
+ * Fill opacity.
+ */
+ fillOpacity?: number;
+
+ /**
+ * A string that defines the stroke dash pattern. Doesn't work on canvas-powered
+ * layers (e.g. Android 2).
+ */
+ dashArray?: string;
+
+ /**
+ * If false, the vector will not emit mouse events and will act as a part of the
+ * underlying map.
+ */
+ clickable?: bool;
+
+ }
+
+ export class Path implements ILayer, IEventPowered {
+ /**
+ * Adds the layer to the map.
+ */
+ addTo(map: Map): Path;
+
+ /**
+ * Binds a popup with a particular HTML content to a click on this path.
+ */
+ bindPopup(htmlContent: string, options?: PopupOptions): Path;
+
+ /**
+ * Unbinds the popup previously bound to the path with bindPopup.
+ */
+ unbindPopup(): Path;
+
+ /**
+ * Opens the popup previously bound by the bindPopup method in the given point,
+ * or in one of the path's points if not specified.
+ */
+ openPopup(latlng?: LatLng): Path;
+
+ /**
+ * Closes the path's bound popup if it is opened.
+ */
+ closePopup(): Path;
+
+ /**
+ * Changes the appearance of a Path based on the options in the Path options object.
+ */
+ setStyle(object: PathOptions): Path;
+
+ /**
+ * Returns the LatLngBounds of the path.
+ */
+ getBounds(): LatLngBounds;
+
+ /**
+ * Brings the layer to the top of all path layers.
+ */
+ bringToFront(): Path;
+
+ /**
+ * Brings the layer to the bottom of all path layers.
+ */
+ bringToBack(): Path;
+
+ /**
+ * Redraws the layer. Sometimes useful after you changed the coordinates that
+ * the path uses.
+ */
+ redraw(): Path;
+
+ /**
+ * True if SVG is used for vector rendering (true for most modern browsers).
+ */
+ static SVG: bool;
+
+ /**
+ * True if VML is used for vector rendering (IE 6-8).
+ */
+ static VML: bool;
+
+ /**
+ * True if Canvas is used for vector rendering (Android 2). You can also force
+ * this by setting global variable L_PREFER_CANVAS to true before the Leaflet
+ * include on your page — sometimes it can increase performance dramatically
+ * when rendering thousands of circle markers, but currently suffers from
+ * a bug that causes removing such layers to be extremely slow.
+ */
+ static CANVAS: bool;
+
+ /**
+ * How much to extend the clip area around the map view (relative to its size,
+ * e.g. 0.5 is half the screen in each direction). Smaller values mean that you
+ * will see clipped ends of paths while you're dragging the map, and bigger values
+ * decrease drawing performance.
+ */
+ static CLIP_PADDING: number;
+
+ ////////////
+ //// ILayer members
+ ////////////
+
+ /**
+ * Should contain code that creates DOM elements for the overlay, adds them
+ * to map panes where they should belong and puts listeners on relevant map events.
+ * Called on map.addLayer(layer).
+ */
+ onAdd(map: Map): void;
+
+ /**
+ * Should contain all clean up code that removes the overlay's elements from
+ * the DOM and removes listeners previously added in onAdd. Called on map.removeLayer(layer).
+ */
+ onRemove(map: Map): void;
+
+ ////////////
+ //// IEventPowered members
+ ////////////
+
+ addEventListener(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ addEventListener(eventMap: any, context?: any): IEventPowered;
+ removeEventListener(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ removeEventListener(eventMap: any, context?: any): IEventPowered;
+ hasEventListeners(type: string): bool;
+ fireEvent(type: string, data?: any): IEventPowered;
+ on(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ on(eventMap: any, context?: any): IEventPowered;
+ off(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ off(eventMap: any, context?: any): IEventPowered;
+ fire(type: string, data?: any): IEventPowered;
+ }
+
+ export interface PolylineOptions {
+ /**
+ * How much to simplify the polyline on each zoom level. More means better performance
+ * and smoother look, and less means more accurate representation.
+ */
+ smoothFactor?: number;
+
+ /**
+ * Disabled polyline clipping.
+ */
+ noClip?: bool;
+
+ }
+
+ export class Polyline extends Path {
+ /**
+ * Instantiates a polyline object given an array of geographical points and
+ * optionally an options object.
+ */
+ constructor(latlngs: LatLng[], options?: PolylineOptions);
+
+ /**
+ * Adds a given point to the polyline.
+ */
+ addLatLng(latlng: LatLng): Polyline;
+
+ /**
+ * Replaces all the points in the polyline with the given array of geographical
+ * points.
+ */
+ setLatLngs(latlngs: LatLng[]): Polyline;
+
+ /**
+ * Returns an array of the points in the path.
+ */
+ getLatLngs(): LatLng[];
+
+ /**
+ * Allows adding, removing or replacing points in the polyline. Syntax is the
+ * same as in Array#splice. Returns the array of removed points (if any).
+ */
+ spliceLatLngs(index: number, pointsToRemove: number, ...latlngs: LatLng[]): LatLng[];
+
+ /**
+ * Returns the LatLngBounds of the polyline.
+ */
+ getBounds(): LatLngBounds;
+
+ }
+
+ export class MultiPolyline extends FeatureGroup {
+ /**
+ * Instantiates a multi-polyline object given an array of arrays of geographical
+ * points (one for each individual polyline) and optionally an options object.
+ */
+ constructor(latlngs: LatLng[][], options?: PolylineOptions);
+
+ }
+
+ export class Polygon extends Polyline {
+ /**
+ * Instantiates a polygon object given an array of geographical points and
+ * optionally an options object (the same as for Polyline). You can also create
+ * a polygon with holes by passing an array of arrays of latlngs, with the first
+ * latlngs array representing the exterior ring while the remaining represent
+ * the holes inside.
+ */
+ constructor(latlngs: LatLng[], options?: PolylineOptions);
+
+ }
+
+ export class MultiPolygon extends FeatureGroup {
+ /**
+ * Instantiates a multi-polyline object given an array of latlngs arrays (one
+ * for each individual polygon) and optionally an options object (the same
+ * as for MultiPolyline).
+ */
+ constructor(latlngs: LatLng[][], options?: PolylineOptions);
+
+ }
+
+ export class Rectangle extends Polygon {
+ /**
+ * Instantiates a rectangle object with the given geographical bounds and
+ * optionally an options object.
+ */
+ constructor(bounds: LatLngBounds, options?: PathOptions);
+
+ /**
+ * Redraws the rectangle with the passed bounds.
+ */
+ setBounds(bounds: LatLngBounds): Rectangle;
+
+ }
+
+ export class Circle extends Path {
+ /**
+ * Instantiates a circle object given a geographical point, a radius in meters
+ * and optionally an options object.
+ */
+ constructor(latlng: LatLng, radius: number, options?: PathOptions);
+
+ /**
+ * Returns the current geographical position of the circle.
+ */
+ getLatLng(): LatLng;
+
+ /**
+ * Returns the current radius of a circle. Units are in meters.
+ */
+ getRadius(): number;
+
+ /**
+ * Sets the position of a circle to a new location.
+ */
+ setLatLng(latlng: LatLng): Circle;
+
+ /**
+ * Sets the radius of a circle. Units are in meters.
+ */
+ setRadius(radius: number): Circle;
+
+ }
+
+ export class CircleMarker extends Circle {
+ /**
+ * Instantiates a circle marker given a geographical point and optionally
+ * an options object. The default radius is 10 and can be altered by passing a
+ * "radius" member in the path options object.
+ */
+ constructor(latlng: LatLng, options?: PathOptions);
+
+ /**
+ * Sets the position of a circle marker to a new location.
+ */
+ setLatLng(latlng: LatLng): CircleMarker;
+
+ /**
+ * Sets the radius of a circle marker. Units are in pixels.
+ */
+ setRadius(radius: number): CircleMarker;
+
+ }
+
+ export class LayerGroup implements ILayer {
+ /**
+ * Create a layer group, optionally given an initial set of layers.
+ */
+ constructor(layers?: ILayer[]);
+
+ /**
+ * Adds the group of layers to the map.
+ */
+ addTo(map: Map): LayerGroup;
+
+ /**
+ * Adds a given layer to the group.
+ */
+ addLayer(layer: ILayer): LayerGroup;
+
+ /**
+ * Removes a given layer from the group.
+ */
+ removeLayer(layer: ILayer): LayerGroup;
+
+ /**
+ * Removes all the layers from the group.
+ */
+ clearLayers(): LayerGroup;
+
+ /**
+ * Iterates over the layers of the group, optionally specifying context of
+ * the iterator function.
+ */
+ eachLayer(fn: (layer: ILayer) => void, context?: any): LayerGroup;
+
+ ////////////
+ //// ILayer members
+ ////////////
+
+ /**
+ * Should contain code that creates DOM elements for the overlay, adds them
+ * to map panes where they should belong and puts listeners on relevant map events.
+ * Called on map.addLayer(layer).
+ */
+ onAdd(map: Map): void;
+
+ /**
+ * Should contain all clean up code that removes the overlay's elements from
+ * the DOM and removes listeners previously added in onAdd. Called on map.removeLayer(layer).
+ */
+ onRemove(map: Map): void;
+
+ }
+
+ export class FeatureGroup implements ILayer, IEventPowered {
+ /**
+ * Create a layer group, optionally given an initial set of layers.
+ */
+ constructor(layers?: ILayer[]);
+
+ /**
+ * Binds a popup with a particular HTML content to a click on any layer from the
+ * group that has a bindPopup method.
+ */
+ bindPopup(htmlContent: string, options?: PopupOptions): FeatureGroup;
+
+ /**
+ * Returns the LatLngBounds of the Feature Group (created from bounds and coordinates
+ * of its children).
+ */
+ getBounds(): LatLngBounds;
+
+ /**
+ * Sets the given path options to each layer of the group that has a setStyle method.
+ */
+ setStyle(style: PathOptions): FeatureGroup;
+
+ /**
+ * Brings the layer group to the top of all other layers.
+ */
+ bringToFront(): FeatureGroup;
+
+ /**
+ * Brings the layer group to the bottom of all other layers.
+ */
+ bringToBack(): FeatureGroup;
+
+ ////////////
+ //// ILayer members
+ ////////////
+
+ /**
+ * Should contain code that creates DOM elements for the overlay, adds them
+ * to map panes where they should belong and puts listeners on relevant map events.
+ * Called on map.addLayer(layer).
+ */
+ onAdd(map: Map): void;
+
+ /**
+ * Should contain all clean up code that removes the overlay's elements from
+ * the DOM and removes listeners previously added in onAdd. Called on map.removeLayer(layer).
+ */
+ onRemove(map: Map): void;
+
+ ////////////
+ //// IEventPowered members
+ ////////////
+
+ addEventListener(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ addEventListener(eventMap: any, context?: any): IEventPowered;
+ removeEventListener(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ removeEventListener(eventMap: any, context?: any): IEventPowered;
+ hasEventListeners(type: string): bool;
+ fireEvent(type: string, data?: any): IEventPowered;
+ on(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ on(eventMap: any, context?: any): IEventPowered;
+ off(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ off(eventMap: any, context?: any): IEventPowered;
+ fire(type: string, data?: any): IEventPowered;
+ }
+
+ export interface GeoJSONOptions {
+ /**
+ * Function that will be used for creating layers for GeoJSON points (if not
+ * specified, simple markers will be created).
+ */
+ pointToLayer?: (featureData: any, latlng: LatLng) => ILayer;
+
+ /**
+ * Function that will be used to get style options for vector layers created
+ * for GeoJSON features.
+ */
+ style?: (featureData: any) => any;
+
+ /**
+ * Function that will be called on each created feature layer. Useful for attaching
+ * events and popups to features.
+ */
+ onEachFeature?: (featureData: any, layer: ILayer) => void;
+
+ /**
+ * Function that will be used to decide whether to show a feature or not.
+ */
+ filter?: (featureData: any, layer: ILayer) => bool;
+
+ }
+
+ export class GeoJSON extends FeatureGroup {
+ /**
+ * Creates a GeoJSON layer. Optionally accepts an object in GeoJSON format
+ * to display on the map (you can alternatively add it later with addData method)
+ * and an options object.
+ */
+ constructor(geojson?: any, options?: GeoJSONOptions);
+
+ /**
+ * Adds a GeoJSON object to the layer.
+ */
+ addData(data: any): bool;
+
+ /**
+ * NOTE: A fake signature to allow an overriding overload.
+ */
+ setStyle(style: PathOptions): FeatureGroup;
+
+ /**
+ * Changes styles of GeoJSON vector layers with the given style function.
+ */
+ setStyle(style: (featureData: any) => any): GeoJSON;
+
+ /**
+ * Resets the the given vector layer's style to the original GeoJSON style,
+ * useful for resetting style after hover events.
+ */
+ resetStyle(layer: Path): GeoJSON;
+
+ /**
+ * Creates a layer from a given GeoJSON feature.
+ */
+ static geometryToLayer(featureData: GeoJSON, pointToLayer?: (featureData: any, latlng: LatLng) => ILayer): ILayer;
+
+ /**
+ * Creates a LatLng object from an array of 2 numbers (latitude, longitude)
+ * used in GeoJSON for points. If reverse is set to true, the numbers will be interpreted
+ * as (longitude, latitude).
+ */
+ static coordsToLatlng(coords: Array, reverse?: bool): LatLng;
+
+ /**
+ * Creates a multidimensional array of LatLng objects from a GeoJSON coordinates
+ * array. levelsDeep specifies the nesting level (0 is for an array of points,
+ * 1 for an array of arrays of points, etc., 0 by default). If reverse is set to
+ * true, the numbers will be interpreted as (longitude, latitude).
+ */
+ static coordsToLatlngs(coords: Array, levelsDeep?: number, reverse?: bool): Array;
+
+ }
+
+ export class LatLng {
+ /**
+ * Creates an object representing a geographical point with the given latitude
+ * and longitude.
+ */
+ constructor(latitude: number, longitude: number);
+
+ /**
+ * Returns the distance (in meters) to the given LatLng calculated using the
+ * Haversine formula. See description on wikipedia
+ */
+ distanceTo(otherLatlng: LatLng): number;
+
+ /**
+ * Returns true if the given LatLng point is at the same position (within a small
+ * margin of error).
+ */
+ equals(otherLatlng: LatLng): bool;
+
+ /**
+ * Returns a string representation of the point (for debugging purposes).
+ */
+ toString(): string;
+
+ /**
+ * Returns a new LatLng object with the longitude wrapped around left and right
+ * boundaries (-180 to 180 by default).
+ */
+ wrap(left: number, right: number): LatLng;
+
+ /**
+ * Latitude in degrees.
+ */
+ lat: number;
+
+ /**
+ * Longitude in degrees.
+ */
+ lng: number;
+
+ }
+
+ export class LatLngBounds {
+ /**
+ * Creates a LatLngBounds object by defining south-west and north-east corners
+ * of the rectangle.
+ */
+ constructor(southWest: LatLng, northEast: LatLng);
+
+ /**
+ * Extends the bounds to contain the given point or bounds.
+ */
+ extend(latlng: LatLng): LatLngBounds;
+
+ /**
+ * Extends the bounds to contain the given point or bounds.
+ */
+ extend(latlng: LatLngBounds): LatLngBounds;
+
+ /**
+ * Returns the south-west point of the bounds.
+ */
+ getSouthWest(): LatLng;
+
+ /**
+ * Returns the north-east point of the bounds.
+ */
+ getNorthEast(): LatLng;
+
+ /**
+ * Returns the north-west point of the bounds.
+ */
+ getNorthWest(): LatLng;
+
+ /**
+ * Returns the south-east point of the bounds.
+ */
+ getSouthEast(): LatLng;
+
+ /**
+ * Returns the center point of the bounds.
+ */
+ getCenter(): LatLng;
+
+ /**
+ * Returns true if the rectangle contains the given one.
+ */
+ contains(otherBounds: LatLngBounds): bool;
+
+ /**
+ * Returns true if the rectangle contains the given point.
+ */
+ contains(latlng: LatLng): bool;
+
+ /**
+ * Returns true if the rectangle intersects the given bounds.
+ */
+ intersects(otherBounds: LatLngBounds): bool;
+
+ /**
+ * Returns true if the rectangle is equivalent (within a small margin of error)
+ * to the given bounds.
+ */
+ equals(otherBounds: LatLngBounds): bool;
+
+ /**
+ * Returns a string with bounding box coordinates in a 'southwest_lng,southwest_lat,northeast_lng,northeast_lat'
+ * format. Useful for sending requests to web services that return geo data.
+ */
+ toBBoxString(): string;
+
+ /**
+ * Returns bigger bounds created by extending the current bounds by a given
+ * percentage in each direction.
+ */
+ pad(bufferRatio: number): LatLngBounds;
+
+ /**
+ * Returns true if the bounds are properly initialized.
+ */
+ isValid(): bool;
+
+ }
+
+ export class Point {
+ /**
+ * Creates a Point object with the given x and y coordinates. If optional round
+ * is set to true, rounds the x and y values.
+ */
+ constructor(x: number, y: number, round?: bool);
+
+ /**
+ * Returns the result of addition of the current and the given points.
+ */
+ add(otherPoint: Point): Point;
+
+ /**
+ * Returns the result of subtraction of the given point from the current.
+ */
+ subtract(otherPoint: Point): Point;
+
+ /**
+ * Returns the result of multiplication of the current point by the given number.
+ */
+ multiplyBy(number: number): Point;
+
+ /**
+ * Returns the result of division of the current point by the given number. If
+ * optional round is set to true, returns a rounded result.
+ */
+ divideBy(number: number, round?: bool): Point;
+
+ /**
+ * Returns the distance between the current and the given points.
+ */
+ distanceTo(otherPoint: Point): number;
+
+ /**
+ * Returns a copy of the current point.
+ */
+ clone(): Point;
+
+ /**
+ * Returns a copy of the current point with rounded coordinates.
+ */
+ round(): Point;
+
+ /**
+ * Returns true if the given point has the same coordinates.
+ */
+ equals(otherPoint: Point): bool;
+
+ /**
+ * Returns a string representation of the point for debugging purposes.
+ */
+ toString(): string;
+
+ /**
+ * The x coordinate.
+ */
+ x: number;
+
+ /**
+ * The y coordinate.
+ */
+ y: number;
+
+ }
+
+ export class Bounds {
+ /**
+ * Creates a Bounds object from two coordinates (usually top-left and bottom-right
+ * corners).
+ */
+ constructor(topLeft: Point, bottomRight: Point);
+
+ /**
+ * Extends the bounds to contain the given point.
+ */
+ extend(point: Point): void;
+
+ /**
+ * Returns the center point of the bounds.
+ */
+ getCenter(): Point;
+
+ /**
+ * Returns true if the rectangle contains the given one.
+ */
+ contains(otherBounds: Bounds): bool;
+
+ /**
+ * Returns true if the rectangle contains the given point.
+ */
+ contains(point: Point): bool;
+
+ /**
+ * Returns true if the rectangle intersects the given bounds.
+ */
+ intersects(otherBounds: Bounds): bool;
+
+ /**
+ * Returns true if the bounds are properly initialized.
+ */
+ isValid(): bool;
+
+ /**
+ * Returns the size of the given bounds.
+ */
+ getSize(): Point;
+
+ /**
+ * The top left corner of the rectangle.
+ */
+ min: Point;
+
+ /**
+ * The bottom right corner of the rectangle.
+ */
+ max: Point;
+
+ }
+
+ export interface IconOptions {
+ /**
+ * (required) The URL to the icon image (absolute or relative to your script
+ * path).
+ */
+ iconUrl?: string;
+
+ /**
+ * The URL to a retina sized version of the icon image (absolute or relative to
+ * your script path). Used for Retina screen devices.
+ */
+ iconRetinaUrl?: string;
+
+ /**
+ * Size of the icon image in pixels.
+ */
+ iconSize?: Point;
+
+ /**
+ * The coordinates of the "tip" of the icon (relative to its top left corner).
+ * The icon will be aligned so that this point is at the marker's geographical
+ * location. Centered by default if size is specified, also can be set in CSS
+ * with negative margins.
+ */
+ iconAnchor?: Point;
+
+ /**
+ * The URL to the icon shadow image. If not specified, no shadow image will be
+ * created.
+ */
+ shadowUrl?: string;
+
+ /**
+ * The URL to the retina sized version of the icon shadow image. If not specified,
+ * no shadow image will be created. Used for Retina screen devices.
+ */
+ shadowRetinaUrl?: string;
+
+ /**
+ * Size of the shadow image in pixels.
+ */
+ shadowSize?: Point;
+
+ /**
+ * The coordinates of the "tip" of the shadow (relative to its top left corner)
+ * (the same as iconAnchor if not specified).
+ */
+ shadowAnchor?: Point;
+
+ /**
+ * The coordinates of the point from which popups will "open", relative to the
+ * icon anchor.
+ */
+ popupAnchor?: Point;
+
+ /**
+ * A custom class name to assign to both icon and shadow images. Empty by default.
+ */
+ className?: string;
+
+ }
+
+ export class Icon {
+ /**
+ * Creates an icon instance with the given options.
+ */
+ constructor(options: IconOptions);
+
+ }
+
+ export interface DivIconOptions {
+ /**
+ * Size of the icon in pixels. Can be also set through CSS.
+ */
+ iconSize?: Point;
+
+ /**
+ * The coordinates of the "tip" of the icon (relative to its top left corner).
+ * The icon will be aligned so that this point is at the marker's geographical
+ * location. Centered by default if size is specified, also can be set in CSS
+ * with negative margins.
+ */
+ iconAnchor?: Point;
+
+ /**
+ * A custom class name to assign to the icon. 'leaflet-div-icon' by default.
+ */
+ className?: string;
+
+ /**
+ * A custom HTML code to put inside the div element, empty by default.
+ */
+ html?: string;
+
+ }
+
+ export class DivIcon {
+ /**
+ * Creates a div icon instance with the given options.
+ */
+ constructor(options: DivIconOptions);
+
+ }
+
+ export interface ControlOptions {
+ /**
+ * The initial position of the control (one of the map corners). See control
+ * positions.
+ */
+ position: string;
+
+ }
+
+ export class Control implements IControl {
+ /**
+ * Creates a control with the given options.
+ */
+ constructor(options?: ControlOptions);
+
+ /**
+ * Sets the position of the control. See control positions.
+ */
+ setPosition(position: string): Control;
+
+ /**
+ * Returns the current position of the control.
+ */
+ getPosition(): string;
+
+ /**
+ * Adds the control to the map.
+ */
+ addTo(map: Map): Control;
+
+ /**
+ * Removes the control from the map.
+ */
+ removeFrom(map: Map): Control;
+
+ static Zoom: new () => Zoom;
+
+ static Attribution: new () => Attribution;
+
+ static Layers: new () => Layers;
+
+ static Scale: new () => Scale;
+
+ ////////////
+ //// IControl members
+ ////////////
+
+ /**
+ * Should contain code that creates all the neccessary DOM elements for the
+ * control, adds listeners on relevant map events, and returns the element
+ * containing the control. Called on map.addControl(control) or control.addTo(map).
+ */
+ onAdd(map: Map): HTMLElement;
+
+ /**
+ * Optional, should contain all clean up code (e.g. removes control's event
+ * listeners). Called on map.removeControl(control) or control.removeFrom(map).
+ * The control's DOM container is removed automatically.
+ */
+ onRemove(map: Map): void;
+
+ }
+
+ export interface ZoomOptions {
+ /**
+ * The position of the control (one of the map corners). See control positions.
+ */
+ position?: string;
+
+ }
+
+ export class Zoom extends Control {
+ /**
+ * Creates a zoom control.
+ */
+ constructor(options?: ZoomOptions);
+
+ }
+
+ export interface AttributionOptions {
+ /**
+ * The position of the control (one of the map corners). See control positions.
+ */
+ position?: string;
+
+ /**
+ * The HTML text shown before the attributions. Pass false to disable.
+ */
+ prefix?: string;
+
+ }
+
+ export class Attribution extends Control {
+ /**
+ * Creates an attribution control.
+ */
+ constructor(options?: AttributionOptions);
+
+ /**
+ * Sets the text before the attributions.
+ */
+ setPrefix(prefix: string): Attribution;
+
+ /**
+ * Adds an attribution text (e.g. 'Vector data © CloudMade').
+ */
+ addAttribution(text: string): Attribution;
+
+ /**
+ * Removes an attribution text.
+ */
+ removeAttribution(text: string): Attribution;
+
+ }
+
+ export interface LayersOptions {
+ /**
+ * The position of the control (one of the map corners). See control positions.
+ */
+ position?: string;
+
+ /**
+ * If true, the control will be collapsed into an icon and expanded on mouse hover
+ * or touch.
+ */
+ collapsed?: bool;
+
+ /**
+ * If true, the control will assign zIndexes in increasing order to all of its
+ * layers so that the order is preserved when switching them on/off.
+ */
+ autoZIndex?: bool;
+
+ }
+
+ export class Layers extends Control implements IEventPowered {
+ /**
+ * Creates an attribution control with the given layers. Base layers will be
+ * switched with radio buttons, while overlays will be switched with checkboxes.
+ */
+ constructor(baseLayers?: any, overlays?: any, options?: LayersOptions);
+
+ /**
+ * Adds a base layer (radio button entry) with the given name to the control.
+ */
+ addBaseLayer(layer: ILayer, name: string): Layers;
+
+ /**
+ * Adds an overlay (checkbox entry) with the given name to the control.
+ */
+ addOverlay(layer: ILayer, name: string): Layers;
+
+ /**
+ * Remove the given layer from the control.
+ */
+ removeLayer(layer: ILayer): Layers;
+
+ ////////////
+ //// IEventPowered members
+ ////////////
+
+ addEventListener(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ addEventListener(eventMap: any, context?: any): IEventPowered;
+ removeEventListener(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ removeEventListener(eventMap: any, context?: any): IEventPowered;
+ hasEventListeners(type: string): bool;
+ fireEvent(type: string, data?: any): IEventPowered;
+ on(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ on(eventMap: any, context?: any): IEventPowered;
+ off(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ off(eventMap: any, context?: any): IEventPowered;
+ fire(type: string, data?: any): IEventPowered;
+ }
+
+ export interface ScaleOptions {
+ /**
+ * The position of the control (one of the map corners). See control positions.
+ */
+ position?: string;
+
+ /**
+ * Maximum width of the control in pixels. The width is set dynamically to show
+ * round values (e.g. 100, 200, 500).
+ */
+ maxWidth?: number;
+
+ /**
+ * Whether to show the metric scale line (m/km).
+ */
+ metric?: bool;
+
+ /**
+ * Whether to show the imperial scale line (mi/ft).
+ */
+ imperial?: bool;
+
+ /**
+ * If true, the control is updated on moveend, otherwise it's always up-to-date
+ * (updated on move).
+ */
+ updateWhenIdle?: bool;
+
+ }
+
+ export class Scale extends Control {
+ /**
+ * Creates an scale control with the given options.
+ */
+ constructor(options?: ScaleOptions);
+
+ }
+
+ export interface IEventPowered {
+ /**
+ * Adds a listener function (fn) to a particular event type of the object. You
+ * can optionally specify the context of the listener (object the this keyword
+ * will point to). You can also pass several space-separated types (e.g. 'click
+ * dblclick').
+ */
+ addEventListener(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+
+ /**
+ * Adds a set of type/listener pairs, e.g. {click: onClick, mousemove: onMouseMove}
+ */
+ addEventListener(eventMap: any, context?: any): IEventPowered;
+
+ /**
+ * Removes a previously added listener function. If no function is specified,
+ * it will remove all the listeners of that particular event from the object.
+ */
+ removeEventListener(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+
+ /**
+ * Removes a set of type/listener pairs.
+ */
+ removeEventListener(eventMap: any, context?: any): IEventPowered;
+
+ /**
+ * Returns true if a particular event type has some listeners attached to it.
+ */
+ hasEventListeners(type: string): bool;
+
+ /**
+ * Fires an event of the specified type. You can optionally provide an data object
+ * — the first argument of the listener function will contain its properties.
+ */
+ fireEvent(type: string, data?: any): IEventPowered;
+
+ /**
+ * Alias to addEventListener.
+ */
+ on(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+
+ /**
+ * Alias to addEventListener.
+ */
+ on(eventMap: any, context?: any): IEventPowered;
+
+ /**
+ * Alias to removeEventListener.
+ */
+ off(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+
+ /**
+ * Alias to removeEventListener.
+ */
+ off(eventMap: any, context?: any): IEventPowered;
+
+ /**
+ * Alias to fireEvent.
+ */
+ fire(type: string, data?: any): IEventPowered;
+
+ }
+
+ export interface LeafletEvent {
+ /**
+ * The event type (e.g. 'click').
+ */
+ type: string;
+
+ /**
+ * The object that fired the event.
+ */
+ target: any;
+
+ }
+
+ export interface LeafletMouseEvent {
+ /**
+ * The geographical point where the mouse event occured.
+ */
+ latlng: LatLng;
+
+ /**
+ * Pixel coordinates of the point where the mouse event occured relative to
+ * the map layer.
+ */
+ layerPoint: Point;
+
+ /**
+ * Pixel coordinates of the point where the mouse event occured relative to
+ * the map сontainer.
+ */
+ containerPoint: Point;
+
+ /**
+ * The original DOM mouse event fired by the browser.
+ */
+ originalEvent: MouseEvent;
+
+ }
+
+ export interface LeafletLocationEvent {
+ /**
+ * Detected geographical location of the user.
+ */
+ latlng: LatLng;
+
+ /**
+ * Geographical bounds of the area user is located in (with respect to the accuracy
+ * of location).
+ */
+ bounds: LatLngBounds;
+
+ /**
+ * Accuracy of location in meters.
+ */
+ accuracy: number;
+
+ }
+
+ export interface LeafletErrorEvent {
+ /**
+ * Error message.
+ */
+ message: string;
+
+ /**
+ * Error code (if applicable).
+ */
+ code: number;
+
+ }
+
+ export interface LeafletLayerEvent {
+ /**
+ * The layer that was added or removed.
+ */
+ layer: ILayer;
+
+ }
+
+ export interface LeafletTileEvent {
+ /**
+ * The tile element (image).
+ */
+ tile: HTMLElement;
+
+ /**
+ * The source URL of the tile.
+ */
+ url: string;
+
+ }
+
+ export interface LeafletGeoJSONEvent {
+ /**
+ * The layer for the GeoJSON feature that is being added to the map.
+ */
+ layer: ILayer;
+
+ /**
+ * GeoJSON properties of the feature.
+ */
+ properties: any;
+
+ /**
+ * GeoJSON geometry type of the feature.
+ */
+ geometryType: string;
+
+ /**
+ * GeoJSON ID of the feature (if present).
+ */
+ id: string;
+
+ }
+
+ export interface LeafletPopupEvent {
+ /**
+ * The popup that was opened or closed.
+ */
+ popup: Popup;
+
+ }
+
+ export class Class {
+ }
+
+ export class Browser {
+ /**
+ * true for all Internet Explorer versions.
+ */
+ static ie: bool;
+
+ /**
+ * true for Internet Explorer 6.
+ */
+ static ie6: bool;
+
+ /**
+ * true for Internet Explorer 6.
+ */
+ static ie7: bool;
+
+ /**
+ * true for webkit-based browsers like Chrome and Safari (including mobile
+ * versions).
+ */
+ static webkit: bool;
+
+ /**
+ * true for webkit-based browsers that support CSS 3D transformations.
+ */
+ static webkit3d: bool;
+
+ /**
+ * true for Android mobile browser.
+ */
+ static android: bool;
+
+ /**
+ * true for old Android stock browsers (2 and 3).
+ */
+ static android23: bool;
+
+ /**
+ * true for modern mobile browsers (including iOS Safari and different Android
+ * browsers).
+ */
+ static mobile: bool;
+
+ /**
+ * true for mobile webkit-based browsers.
+ */
+ static mobileWebkit: bool;
+
+ /**
+ * true for mobile Opera.
+ */
+ static mobileOpera: bool;
+
+ /**
+ * true for all browsers on touch devices.
+ */
+ static touch: bool;
+
+ /**
+ * true for browsers with Microsoft touch model (e.g. IE10).
+ */
+ static msTouch: bool;
+
+ /**
+ * true for devices with Retina screens.
+ */
+ static retina: bool;
+
+ }
+
+ export class Util {
+ /**
+ * Merges the properties of the src object (or multiple objects) into dest object
+ * and returns the latter. Has an L.extend shortcut.
+ */
+ static extend(dest: any, ...sources: any[]): any;
+
+ /**
+ * Returns a function which executes function fn with the given scope obj (so
+ * that this keyword refers to obj inside the function code). Has an L.bind shortcut.
+ */
+ static bind(fn: Function, obj: any): Function;
+
+ /**
+ * Applies a unique key to the object and returns that key. Has an L.stamp shortcut.
+ */
+ static stamp(obj: any): string;
+
+ /**
+ * Returns a wrapper around the function fn that makes sure it's called not more
+ * often than a certain time interval time, but as fast as possible otherwise
+ * (for example, it is used for checking and requesting new tiles while dragging
+ * the map), optionally passing the scope (context) in which the function will
+ * be called.
+ */
+ static limitExecByInterval(fn: Function, time: number, context?: any): Function;
+
+ /**
+ * Returns a function which always returns false.
+ */
+ static falseFn(): () => bool;
+
+ /**
+ * Returns the number num rounded to digits decimals.
+ */
+ static formatNum(num: number, digits: number): number;
+
+ /**
+ * Trims and splits the string on whitespace and returns the array of parts.
+ */
+ static splitWords(str: string): string[];
+
+ /**
+ * Merges the given properties to the options of the obj object, returning the
+ * resulting options. See Class options. Has an L.setOptions shortcut.
+ */
+ static setOptions(obj: any, options: any): any;
+
+ /**
+ * Converts an object into a parameter URL string, e.g. {a: "foo", b: "bar"}
+ * translates to '?a=foo&b=bar'.
+ */
+ static getParamString(obj: any): string;
+
+ /**
+ * Simple templating facility, creates a string by applying the values of the
+ * data object of a form {a: 'foo', b: 'bar', …} to a template string of the form
+ * 'Hello {a}, {b}' — in this example you will get 'Hello foo, bar'.
+ */
+ static template(str: string, data: any): string;
+
+ /**
+ * Returns true if the given object is an array.
+ */
+ static isArray(obj: any): bool;
+
+ /**
+ * Data URI string containing a base64-encoded empty GIF image. Used as a hack
+ * to free memory from unused images on WebKit-powered mobile devices (by setting
+ * image src to this string).
+ */
+ static emptyImageUrl: string;
+
+ }
+
+ export class Transformation {
+ /**
+ * Creates a transformation object with the given coefficients.
+ */
+ constructor(a: number, b: number, c: number, d: number);
+
+ /**
+ * Returns a transformed point, optionally multiplied by the given scale.
+ * Only accepts real L.Point instances, not arrays.
+ */
+ transform(point: Point, scale?: number): Point;
+
+ /**
+ * Returns the reverse transformation of the given point, optionally divided
+ * by the given scale. Only accepts real L.Point instances, not arrays.
+ */
+ untransform(point: Point, scale?: number): Point;
+
+ }
+
+ export class LineUtil {
+ /**
+ * Dramatically reduces the number of points in a polyline while retaining
+ * its shape and returns a new array of simplified points. Used for a huge performance
+ * boost when processing/displaying Leaflet polylines for each zoom level
+ * and also reducing visual noise. tolerance affects the amount of simplification
+ * (lesser value means higher quality but slower and with more points). Also
+ * released as a separated micro-library Simplify.js.
+ */
+ static simplify(points: Point[], tolerance: number): Point[];
+
+ /**
+ * Returns the distance between point p and segment p1 to p2.
+ */
+ static pointToSegmentDistance(p: Point, p1: Point, p2: Point): number;
+
+ /**
+ * Returns the closest point from a point p on a segment p1 to p2.
+ */
+ static closestPointOnSegment(p: Point, p1: Point, p2: Point): number;
+
+ /**
+ * Clips the segment a to b by rectangular bounds (modifying the segment points
+ * directly!). Used by Leaflet to only show polyline points that are on the screen
+ * or near, increasing performance.
+ */
+ static clipSegment(a: Point, b: Point, bounds: Bounds): void;
+
+ }
+
+ export class PolyUtil {
+ /**
+ * Clips the polygon geometry defined by the given points by rectangular bounds.
+ * Used by Leaflet to only show polygon points that are on the screen or near,
+ * increasing performance. Note that polygon points needs different algorithm
+ * for clipping than polyline, so there's a seperate method for it.
+ */
+ static clipPolygon(points: Point[], bounds: Bounds): Point[];
+
+ }
+
+ export class DomEvent {
+ /**
+ * Adds a listener fn to the element's DOM event of the specified type. this keyword
+ * inside the listener will point to context, or to the element if not specified.
+ */
+ static addListener(el: HTMLElement, type: string, fn: (e: Event) => void, context?: any): DomEvent;
+
+ /**
+ * Removes an event listener from the element.
+ */
+ static removeListener(el: HTMLElement, type: string, fn: (e: Event) => void): DomEvent;
+
+ /**
+ * Stop the given event from propagation to parent elements. Used inside the
+ * listener functions:
+ * L.DomEvent.addListener(div, 'click', function
+ * (e) {
+ * L.DomEvent.stopPropagation(e);
+ * });
+ */
+ static stopPropagation(e: Event): DomEvent;
+
+ /**
+ * Prevents the default action of the event from happening (such as following
+ * a link in the href of the a element, or doing a POST request with page reload
+ * when form is submitted). Use it inside listener functions.
+ */
+ static preventDefault(e: Event): DomEvent;
+
+ /**
+ * Does stopPropagation and preventDefault at the same time.
+ */
+ static stop(e: Event): DomEvent;
+
+ /**
+ * Adds stopPropagation to the element's 'click', 'doubleclick', 'mousedown'
+ * and 'touchstart' events.
+ */
+ static disableClickPropagation(el: HTMLElement): DomEvent;
+
+ /**
+ * Gets normalized mouse position from a DOM event relative to the container
+ * or to the whole page if not specified.
+ */
+ static getMousePosition(e: Event, container?: HTMLElement): Point;
+
+ /**
+ * Gets normalized wheel delta from a mousewheel DOM event.
+ */
+ static getWheelDelta(e: Event): number;
+
+ }
+
+ export class DomUtil {
+ /**
+ * Returns an element with the given id if a string was passed, or just returns
+ * the element if it was passed directly.
+ */
+ static get(id: string): HTMLElement;
+
+ /**
+ * Returns the value for a certain style attribute on an element, including
+ * computed values or values set through CSS.
+ */
+ static getStyle(el: HTMLElement, style: string): string;
+
+ /**
+ * Returns the offset to the viewport for the requested element.
+ */
+ static getViewportOffset(el: HTMLElement): Point;
+
+ /**
+ * Creates an element with tagName, sets the className, and optionally appends
+ * it to container element.
+ */
+ static create(tagName: string, className: string, container?: HTMLElement): HTMLElement;
+
+ /**
+ * Makes sure text cannot be selected, for example during dragging.
+ */
+ static disableTextSelection(): void;
+
+ /**
+ * Makes text selection possible again.
+ */
+ static enableTextSelection(): void;
+
+ /**
+ * Returns true if the element class attribute contains name.
+ */
+ static hasClass(el: HTMLElement, name: string): bool;
+
+ /**
+ * Adds name to the element's class attribute.
+ */
+ static addClass(el: HTMLElement, name: string): void;
+
+ /**
+ * Removes name from the element's class attribute.
+ */
+ static removeClass(el: HTMLElement, name: string): void;
+
+ /**
+ * Set the opacity of an element (including old IE support). Value must be from
+ * 0 to 1.
+ */
+ static setOpacity(el: HTMLElement, value: number): void;
+
+ /**
+ * Goes through the array of style names and returns the first name that is a valid
+ * style name for an element. If no such name is found, it returns false. Useful
+ * for vendor-prefixed styles like transform.
+ */
+ static testProp(props: String[]): string;
+
+ /**
+ * Returns a CSS transform string to move an element by the offset provided in
+ * the given point. Uses 3D translate on WebKit for hardware-accelerated transforms
+ * and 2D on other browsers.
+ */
+ static getTranslateString(point: Point): string;
+
+ /**
+ * Returns a CSS transform string to scale an element (with the given scale origin).
+ */
+ static getScaleString(scale: number, origin: Point): string;
+
+ /**
+ * Sets the position of an element to coordinates specified by point, using
+ * CSS translate or top/left positioning depending on the browser (used by
+ * Leaflet internally to position its layers). Forces top/left positioning
+ * if disable3D is true.
+ */
+ static setPosition(el: HTMLElement, point: Point, disable3D?: bool): void;
+
+ /**
+ * Returns the coordinates of an element previously positioned with setPosition.
+ */
+ static getPosition(el: HTMLElement): Point;
+
+ /**
+ * Vendor-prefixed transition style name (e.g. 'webkitTransition' for WebKit).
+ */
+ static TRANSITION: string;
+
+ /**
+ * Vendor-prefixed transform style name.
+ */
+ static TRANSFORM: string;
+
+ }
+
+ export class PosAnimation implements IEventPowered {
+ /**
+ * Creates a PosAnimation object.
+ */
+ constructor();
+
+ /**
+ * Run an animation of a given element to a new position, optionally setting
+ * duration in seconds (0.25 by default) and easing linearity factor (3rd argument
+ * of the cubic bezier curve, 0.5 by default)
+ */
+ run(element: HTMLElement, newPos: Point, duration?: number, easeLinearity?: number): PosAnimation;
+
+ ////////////
+ //// IEventPowered members
+ ////////////
+
+ addEventListener(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ addEventListener(eventMap: any, context?: any): IEventPowered;
+ removeEventListener(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ removeEventListener(eventMap: any, context?: any): IEventPowered;
+ hasEventListeners(type: string): bool;
+ fireEvent(type: string, data?: any): IEventPowered;
+ on(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ on(eventMap: any, context?: any): IEventPowered;
+ off(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ off(eventMap: any, context?: any): IEventPowered;
+ fire(type: string, data?: any): IEventPowered;
+ }
+
+ export class Draggable implements IEventPowered {
+ /**
+ * Creates a Draggable object for moving the given element when you start dragging
+ * the dragHandle element (equals the element itself by default).
+ */
+ constructor(element: HTMLElement, dragHandle?: HTMLElement);
+
+ /**
+ * Enables the dragging ability.
+ */
+ enable(): void;
+
+ /**
+ * Disables the dragging ability.
+ */
+ disable(): void;
+
+ ////////////
+ //// IEventPowered members
+ ////////////
+
+ addEventListener(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ addEventListener(eventMap: any, context?: any): IEventPowered;
+ removeEventListener(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ removeEventListener(eventMap: any, context?: any): IEventPowered;
+ hasEventListeners(type: string): bool;
+ fireEvent(type: string, data?: any): IEventPowered;
+ on(type: string, fn: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ on(eventMap: any, context?: any): IEventPowered;
+ off(type: string, fn?: (e: LeafletEvent) => void, context?: any): IEventPowered;
+ off(eventMap: any, context?: any): IEventPowered;
+ fire(type: string, data?: any): IEventPowered;
+ }
+
+ export interface IHandler {
+ /**
+ * Enables the handler.
+ */
+ enable(): void;
+
+ /**
+ * Disables the handler.
+ */
+ disable(): void;
+
+ /**
+ * Returns true if the handler is enabled.
+ */
+ enabled(): bool;
+
+ }
+
+ export interface ILayer {
+ /**
+ * Should contain code that creates DOM elements for the overlay, adds them
+ * to map panes where they should belong and puts listeners on relevant map events.
+ * Called on map.addLayer(layer).
+ */
+ onAdd(map: Map): void;
+
+ /**
+ * Should contain all clean up code that removes the overlay's elements from
+ * the DOM and removes listeners previously added in onAdd. Called on map.removeLayer(layer).
+ */
+ onRemove(map: Map): void;
+
+ }
+
+ export interface IControl {
+ /**
+ * Should contain code that creates all the neccessary DOM elements for the
+ * control, adds listeners on relevant map events, and returns the element
+ * containing the control. Called on map.addControl(control) or control.addTo(map).
+ */
+ onAdd(map: Map): HTMLElement;
+
+ /**
+ * Optional, should contain all clean up code (e.g. removes control's event
+ * listeners). Called on map.removeControl(control) or control.removeFrom(map).
+ * The control's DOM container is removed automatically.
+ */
+ onRemove(map: Map): void;
+
+ }
+
+ export class Projection {
+ /**
+ * Spherical Mercator projection — the most common projection for online maps,
+ * used by almost all free and commercial tile providers. Assumes that Earth
+ * is a sphere. Used by the EPSG:3857 CRS.
+ */
+ static SphericalMercator: IProjection;
+
+ /**
+ * Elliptical Mercator projection — more complex than Spherical Mercator.
+ * Takes into account that Earth is a geoid, not a perfect sphere. Used by the
+ * EPSG:3395 CRS.
+ */
+ static Mercator: IProjection;
+
+ /**
+ * Equirectangular, or Plate Carree projection — the most simple projection,
+ * mostly used by GIS enthusiasts. Directly maps x as longitude, and y as latitude.
+ * Also suitable for flat worlds, e.g. game maps. Used by the EPSG:3395 and Simple
+ * CRS.
+ */
+ static LonLat: IProjection;
+
+ }
+
+ export interface IProjection {
+ /**
+ * Projects geographical coordinates into a 2D point.
+ */
+ project(latlng: LatLng): Point;
+
+ /**
+ * The inverse of project. Projects a 2D point into geographical location.
+ */
+ unproject(point: Point): LatLng;
+
+ }
+
+ export class CRS {
+ /**
+ * The most common CRS for online maps, used by almost all free and commercial
+ * tile providers. Uses Spherical Mercator projection. Set in by default in
+ * Map's crs option.
+ */
+ static EPSG3857: ICRS;
+
+ /**
+ * A common CRS among GIS enthusiasts. Uses simple Equirectangular projection.
+ */
+ static EPSG4326: ICRS;
+
+ /**
+ * Rarely used by some commercial tile providers. Uses Elliptical Mercator
+ * projection.
+ */
+ static EPSG3395: ICRS;
+
+ /**
+ * A simple CRS that maps longitude and latitude into x and y directly. May be
+ * used for maps of flat surfaces (e.g. game maps). Note that the y axis should
+ * still be inverted (going from bottom to top).
+ */
+ static Simple: ICRS;
+
+ }
+
+ export interface ICRS {
+ /**
+ * Projection that this CRS uses.
+ */
+ projection: IProjection;
+
+ /**
+ * Transformation that this CRS uses to turn projected coordinates into screen
+ * coordinates for a particular tile service.
+ */
+ transformation: Transformation;
+
+ /**
+ * Standard code name of the CRS passed into WMS services (e.g. 'EPSG:3857').
+ */
+ code: string;
+
+ /**
+ * Projects geographical coordinates on a given zoom into pixel coordinates.
+ */
+ latLngToPoint(latlng: LatLng, zoom: number): Point;
+
+ /**
+ * The inverse of latLngToPoint. Projects pixel coordinates on a given zoom
+ * into geographical coordinates.
+ */
+ pointToLatLng(point: Point, zoom: number): LatLng;
+
+ /**
+ * Projects geographical coordinates into coordinates in units accepted
+ * for this CRS (e.g. meters for EPSG:3857, for passing it to WMS services).
+ */
+ project(latlng: LatLng): Point;
+
+ /**
+ * Returns the scale used when transforming projected coordinates into pixel
+ * coordinates for a particular zoom. For example, it returns 256 * 2^zoom for
+ * Mercator-based CRS.
+ */
+ scale(zoom: number): number;
+
+ }
+
+ /**
+ * This method restores the L global variale to the original value it had
+ * before Leaflet inclusion, and returns the real Leaflet namespace.
+ */
+ export var noConflict: () => L;
+
+ /**
+ * A constant that represents the Leaflet version in use.
+ */
+ export var version: string;
+}
+
+/**
+ * Forces Leaflet to use the Canvas back-end (if available) for vector layers
+ * instead of SVG. This can increase performance considerably in some cases
+ * (e.g. many thousands of circle markers on the map).
+ */
+declare var L_PREFER_CANVAS: bool;
+
+/**
+ * Forces Leaflet to not use touch events even if it detects them.
+ */
+declare var L_NO_TOUCH: bool;
+
+/**
+ * Forces Leaflet to not use hardware-accelerated CSS 3D transforms for positioning
+ * (which may cause glitches in some rare environments) even if they're supported.
+ */
+declare var L_DISABLE_3D: bool;
diff --git a/libxmljs/libxmljs-tests.ts b/libxmljs/libxmljs-tests.ts
new file mode 100644
index 0000000000..bf73a6d98d
--- /dev/null
+++ b/libxmljs/libxmljs-tests.ts
@@ -0,0 +1,49 @@
+/// ' +
+ '' +
+ 'grandchild content ' +
+ ' ' +
+ 'with content! ' +
+ ' ';
+
+var xmlDoc = libxmljs.parseXmlString(xml);
+
+// xpath queries
+var gchild = xmlDoc.get('//grandchild');
+
+console.log(gchild.text()); // prints "grandchild content"
+
+var children = xmlDoc.root().childNodes();
+var child = children[0];
+
+console.log(child.attr('foo').value()); // prints "bar"
+
+var parser = new libxmljs.SaxParser();
+
+parser.on('startDocument', null);
+parser.on('startElement', null);
+
+var parser2 = new libxmljs.SaxPushParser();
+
+// connect any callbacks here
+parser2
+ .on('startDocument', null)
+ .on('startElement', null)
+
+var xmlChunk: any;
+
+while(xmlChunk) {
+ parser2.push(xmlChunk);
+}
+
+var doc = new libxmljs.Document();
+ doc.node('root')
+ .node('child').attr({foo: 'bar'})
+ .node('grandchild', 'grandchild content').attr({baz: 'fizbuzz'})
+ .parent()
+ .parent()
+ .node('sibling', 'with content!');
diff --git a/libxmljs/libxmljs.d.ts b/libxmljs/libxmljs.d.ts
new file mode 100644
index 0000000000..b26aeabf15
--- /dev/null
+++ b/libxmljs/libxmljs.d.ts
@@ -0,0 +1,111 @@
+// Type definitions for Libxmljs
+// Project: https://github.com/polotek/libxmljs
+// Definitions by: François de Campredon
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+
+declare module "libxmljs" {
+ export function parseXmlString(source:string):XMLDocument;
+ export function parseHtmlString(source:string):HTMLDocument;
+
+
+ export class XMLDocument {
+ constructor(version:number, encoding:string);
+ child(idx:number):Element;
+ childNodes():Element[];
+ errors():SyntaxError[];
+ encoding():string;
+ encoding(enc:string):void;
+ find(xpath:string):Element[];
+ get(xpath:string):Element;
+ node(name:string, content:string):Element;
+ root():Element;
+ toString():string;
+ version():Number;
+ }
+
+ export class HTMLDocument extends XMLDocument {
+
+ }
+
+
+ export class Element {
+ constructor(doc:XMLDocument, name:string, content?:string);
+ name():string;
+ name(newName:string):void;
+ text():string;
+ attr(name:string):string;
+ attr(attr:Attribute);
+ attr(attrObject:{[key:string]:string;}):void;
+ attrs():Attribute[];
+ parent():Element;
+ doc():XMLDocument;
+ child(idx:number):Element;
+ childNodes():Element[];
+ addChild(child:Element);
+ nextSibling():Element;
+ nextElement():Element;
+ addNextSibling(siblingNode:Element):Element;
+ prevSibling():Element;
+ prevElement():Element;
+ addPrevSibling(siblingNode:Element);
+ find(xpath:string):Element[];
+ find(xpath:string, ns_uri:string):Element[];
+ get(xpath:string, ns_uri:string):Element;
+ find(xpath:string, namespaces:{[key:string]:string;}):Element[];
+ get(xpath, ns_uri:{[key:string]:string;}):Element;
+ defineNamespace(href:string):Namespace;
+ defineNamespace(prefix:string, href:string):Namespace;
+ namespace():Namespace;
+ namespace(ns:Namespace):void;
+ namespace(href:string):void;
+ namespace(prefix:string, href:string):void;
+ remove():void;
+ path():string;
+ type():string;
+ }
+
+
+ export class Attribute {
+ constructor(node:Element, name:string, value:string);
+ constructor(node:Element, name:string, value:string, ns:Namespace);
+ name():string;
+ namespace():Namespace;
+ namespace(ns:Namespace):Namespace;
+ nextSibling():Attribute;
+ node():Element;
+ prevSibling():Attribute;
+ remove():void;
+ value():string;
+ }
+
+ export class Namespace {
+ constructor(node:Element, prefix:string, href:string);
+ href():string;
+ prefix():string;
+ }
+
+ export class SaxParser {
+ parseString(source:string):bool;
+ addListener(event: string, listener: Function);
+ on(event: string, listener: Function): any;
+ once(event: string, listener: Function): void;
+ removeListener(event: string, listener: Function): void;
+ removeAllListener(event: string): void;
+ setMaxListeners(n: number): void;
+ listeners(event: string): { Function; }[];
+ emit(event: string, arg1?: any, arg2?: any): void;
+ }
+
+
+ export class SaxPushParser {
+ push(source:string):bool;
+ addListener(event: string, listener: Function);
+ on(event: string, listener: Function): any;
+ once(event: string, listener: Function): void;
+ removeListener(event: string, listener: Function): void;
+ removeAllListener(event: string): void;
+ setMaxListeners(n: number): void;
+ listeners(event: string): { Function; }[];
+ emit(event: string, arg1?: any, arg2?: any): void;
+ }
+}
\ No newline at end of file
diff --git a/linq/linq.3.0.3-Beta4.d.ts b/linq/linq.3.0.3-Beta4.d.ts
new file mode 100755
index 0000000000..f8c30f6276
--- /dev/null
+++ b/linq/linq.3.0.3-Beta4.d.ts
@@ -0,0 +1,195 @@
+// Type definitions for linq.js, ver 3.0.3-Beta4
+// Project: http://linqjs.codeplex.com/
+// Definitions by: neuecc (http://www.codeplex.com/site/users/view/neuecc)
+
+declare module linqjs {
+ interface IEnumerator {
+ current(): any;
+ moveNext(): bool;
+ dispose(): void;
+ }
+
+ interface EnumerableStatic {
+ Utils: {
+ createLambda(expression: any): (...params: any[]) => any;
+ createEnumerable(getEnumerator: () => IEnumerator): Enumerable;
+ createEnumerator(initialize: () => void , tryGetNext: () => bool, dispose: () => void ): IEnumerator;
+ extendTo(type: any): void;
+ };
+ choice(...params: any[]): Enumerable;
+ cycle(...params: any[]): Enumerable;
+ empty(): Enumerable;
+ from(): Enumerable;
+ from(obj: Enumerable): Enumerable;
+ from(obj: string): Enumerable;
+ from(obj: number): Enumerable;
+ from(obj: { length: number;[x: number]: any; }): Enumerable;
+ from(obj: any): Enumerable;
+ make(element: any): Enumerable;
+ matches(input: string, pattern: RegExp): Enumerable;
+ matches(input: string, pattern: string, flags?: string): Enumerable;
+ range(start: number, count: number, step?: number): Enumerable;
+ rangeDown(start: number, count: number, step?: number): Enumerable;
+ rangeTo(start: number, to: number, step?: number): Enumerable;
+ repeat(element: any, count?: number): Enumerable;
+ repeatWithFinalize(initializer: () => any, finalizer: (element) => void ): Enumerable;
+ generate(func: () => any, count?: number): Enumerable;
+ toInfinity(start?: number, step?: number): Enumerable;
+ toNegativeInfinity(start?: number, step?: number): Enumerable;
+ unfold(seed: any, func: (value: any) => any): Enumerable;
+ defer(enumerableFactory: () => Enumerable): Enumerable;
+ }
+
+ interface Enumerable {
+ constructor (getEnumerator: () => IEnumerator);
+ getEnumerator(): IEnumerator;
+
+ // Extension Methods
+ traverseBreadthFirst(func: (element: any) => Enumerable, resultSelector?: (element: any, nestLevel: number) => any): Enumerable;
+ traverseDepthFirst(func: (element: any) => Enumerable, resultSelector?: (element: any, nestLevel: number) => any): Enumerable;
+ flatten(): Enumerable;
+ pairwise(selector: (prev: any, current: any) => any): Enumerable;
+ scan(func: (prev: any, current: any) => any): Enumerable;
+ scan(seed: any, func: (prev: any, current: any) => any): Enumerable;
+ select(selector: (element: any, index: number) => any): Enumerable;
+ selectMany(collectionSelector: (element: any, index: number) => any[], resultSelector?: (outer: any, inner: any) => any): Enumerable;
+ selectMany(collectionSelector: (element: any, index: number) => Enumerable, resultSelector?: (outer: any, inner: any) => any): Enumerable;
+ selectMany(collectionSelector: (element: any, index: number) => { length: number;[x: number]: any; }, resultSelector?: (outer: any, inner: any) => any): Enumerable;
+ where(predicate: (element: any, index: number) => bool): Enumerable;
+ choose(selector: (element: any, index: number) => any): Enumerable;
+ ofType(type: any): Enumerable;
+ zip(second: any[], resultSelector: (first: any, second: any, index: number) => any): Enumerable;
+ zip(second: Enumerable, resultSelector: (first: any, second: any, index: number) => any): Enumerable;
+ zip(second: { length: number;[x: number]: any; }, resultSelector: (first: any, second: any, index: number) => any): Enumerable;
+ zip(...params: any[]): Enumerable; // last one is selector
+ merge(second: any[], resultSelector: (first: any, second: any, index: number) => any): Enumerable;
+ merge(second: Enumerable, resultSelector: (first: any, second: any, index: number) => any): Enumerable;
+ merge(second: { length: number;[x: number]: any; }, resultSelector: (first: any, second: any, index: number) => any): Enumerable;
+ merge(...params: any[]): Enumerable; // last one is selector
+ join(inner: Enumerable, outerKeySelector: (outer: any) =>any, innerKeySelector: (inner: any) =>any, resultSelector: (outer: any, inner: any) => any, compareSelector?: (obj: any) => any): Enumerable;
+ groupJoin(inner: Enumerable, outerKeySelector: (outer: any) =>any, innerKeySelector: (inner: any) =>any, resultSelector: (outer: any, inner: any) => any, compareSelector?: (obj: any) => any): Enumerable;
+ all(predicate: (element: any) => bool): bool;
+ any(predicate?: (element: any) => bool): bool;
+ isEmpty(): bool;
+ concat(...sequences: any[]): Enumerable;
+ insert(index: number, second: any[]): Enumerable;
+ insert(index: number, second: Enumerable): Enumerable;
+ insert(index: number, second: { length: number;[x: number]: any; }): Enumerable;
+ alternate(alternateValue: any): Enumerable;
+ alternate(alternateSequence: any[]): Enumerable;
+ alternate(alternateSequence: Enumerable): Enumerable;
+ contains(value: any, compareSelector: (element: any) => any): Enumerable;
+ contains(value: any): Enumerable;
+ defaultIfEmpty(defaultValue?: any): Enumerable;
+ distinct(compareSelector?: (element: any) => any): Enumerable;
+ distinctUntilChanged(compareSelector: (element: any) => any): Enumerable;
+ except(second: any[], compareSelector?: (element: any) => any): Enumerable;
+ except(second: { length: number;[x: number]: any; }, compareSelector?: (element: any) => any): Enumerable;
+ except(second: Enumerable, compareSelector?: (element: any) => any): Enumerable;
+ intersect(second: any[], compareSelector?: (element: any) => any): Enumerable;
+ intersect(second: { length: number;[x: number]: any; }, compareSelector?: (element: any) => any): Enumerable;
+ intersect(second: Enumerable, compareSelector?: (element: any) => any): Enumerable;
+ sequenceEqual(second: any[], compareSelector?: (element: any) => any): Enumerable;
+ sequenceEqual(second: { length: number;[x: number]: any; }, compareSelector?: (element: any) => any): Enumerable;
+ sequenceEqual(second: Enumerable, compareSelector?: (element: any) => any): Enumerable;
+ union(second: any[], compareSelector?: (element: any) => any): Enumerable;
+ union(second: { length: number;[x: number]: any; }, compareSelector?: (element: any) => any): Enumerable;
+ union(second: Enumerable, compareSelector?: (element: any) => any): Enumerable;
+ orderBy(keySelector: (element: any) => any): OrderedEnumerable;
+ orderByDescending(keySelector: (element: any) => any): OrderedEnumerable;
+ reverse(): Enumerable;
+ shuffle(): Enumerable;
+ weightedSample(weightSelector: (element: any) => any): Enumerable;
+ groupBy(keySelector: (element: any) => any, elementSelector?: (element: any) => any, resultSelector?: (key: any, element: any) => any, compareSelector?: (element: any) => any): Enumerable;
+ partitionBy(keySelector: (element: any) => any, elementSelector?: (element: any) => any, resultSelector?: (key: any, element: any) => any, compareSelector?: (element: any) => any): Enumerable;
+ buffer(count: number): Enumerable;
+ aggregate(func: (prev: any, current: any) => any): any;
+ aggregate(seed: any, func: (prev: any, current: any) => any, resultSelector?: (last: any) => any): any;
+ average(selector?: (element: any) => any): number;
+ count(predicate?: (element: any, index: number) => bool): number;
+ max(selector?: (element: any) => any): number;
+ min(selector?: (element: any) => any): number;
+ maxBy(keySelector: (element: any) => any): any;
+ minBy(keySelector: (element: any) => any): any;
+ sum(selector?: (element: any) => any): number;
+ elementAt(index: number): any;
+ elementAtOrDefault(index: number, defaultValue?: any): any;
+ first(predicate?: (element: any, index: number) => bool): any;
+ firstOrDefault(predicate?: (element: any, index: number) => bool, defaultValue?: any): any;
+ last(predicate?: (element: any, index: number) => bool): any;
+ lastOrDefault(predicate?: (element: any, index: number) => bool, defaultValue?: any): any;
+ single(predicate?: (element: any, index: number) => bool): any;
+ singleOrDefault(predicate?: (element: any, index: number) => bool, defaultValue?: any): any;
+ skip(count: number): Enumerable;
+ skipWhile(predicate: (element: any, index: number) => bool): Enumerable;
+ take(count: number): Enumerable;
+ takeWhile(predicate: (element: any, index: number) => bool): Enumerable;
+ takeExceptLast(count?: number): Enumerable;
+ takeFromLast(count: number): Enumerable;
+ indexOf(item: any): number;
+ indexOf(predicate: (element: any, index: number) => bool): number;
+ lastIndexOf(item: any): number;
+ lastIndexOf(predicate: (element: any, index: number) => bool): number;
+ asEnumerable(): Enumerable;
+ toArray(): any[];
+ toLookup(keySelector: (element: any) => any, elementSelector?: (element: any) => any, compareSelector?: (element: any) => any): Lookup;
+ toObject(keySelector: (element: any) => any, elementSelector?: (element: any) => any): Object;
+ toDictionary(keySelector: (element: any) => any, elementSelector?: (element: any) => any, compareSelector?: (element: any) => any): Dictionary;
+ toJSONString(replacer: (key: string, value: any) => any): string;
+ toJSONString(replacer: any[]): string;
+ toJSONString(replacer: (key: string, value: any) => any, space: any): string;
+ toJSONString(replacer: any[], space: any): string;
+ toJoinedString(separator?: string, selector?: (element: any, index: number) => any): string;
+ doAction(action: (element: any, index: number) => void ): Enumerable;
+ doAction(action: (element: any, index: number) => bool): Enumerable;
+ forEach(action: (element: any, index: number) => void ): void;
+ forEach(action: (element: any, index: number) => bool): void;
+ write(separator?: string, selector?: (element: any) => any): void;
+ writeLine(selector?: (element: any) => any): void;
+ force(): void;
+ letBind(func: (source: Enumerable) => any[]): Enumerable;
+ letBind(func: (source: Enumerable) => { length: number;[x: number]: any; }): Enumerable;
+ letBind(func: (source: Enumerable) => Enumerable): Enumerable;
+ share(): DisposableEnumerable;
+ memoize(): DisposableEnumerable;
+ catchError(handler: (exception: any) => void ): Enumerable;
+ finallyAction(finallyAction: () => void ): Enumerable;
+ log(selector?: (element: any) => void ): Enumerable;
+ trace(message?: string, selector?: (element: any) => void ): Enumerable;
+ }
+
+ interface OrderedEnumerable extends Enumerable {
+ createOrderedEnumerable(keySelector: (element: any) => any, descending: bool): OrderedEnumerable;
+ thenBy(keySelector: (element: any) => any): OrderedEnumerable;
+ thenByDescending(keySelector: (element: any) => any): OrderedEnumerable;
+ }
+
+ interface DisposableEnumerable extends Enumerable {
+ dispose(): void;
+ }
+
+ interface Dictionary {
+ add(key: any, value: any): void;
+ get(key: any): any;
+ set(key: any, value: any): bool;
+ contains(key: any): bool;
+ clear(): void;
+ remove(key: any): void;
+ count(): number;
+ toEnumerable(): Enumerable; // Enumerable
+ }
+
+ interface Lookup {
+ count(): number;
+ get(key: any): Enumerable;
+ contains(key: any): bool;
+ toEnumerable(): Enumerable; // Enumerable
+ }
+
+ interface Grouping extends Enumerable {
+ key(): any;
+ }
+}
+
+// export definition
+declare var Enumerable: linqjs.EnumerableStatic;
\ No newline at end of file
diff --git a/linq/linq.jquery.d.ts b/linq/linq.jquery.d.ts
new file mode 100755
index 0000000000..456da22680
--- /dev/null
+++ b/linq/linq.jquery.d.ts
@@ -0,0 +1,16 @@
+// Type definitions for linq.jquery (from linq.js)
+// Project: http://linqjs.codeplex.com/
+// Definitions by: neuecc (http://www.codeplex.com/site/users/view/neuecc)
+
+///
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+
declare module "marked" {
export function (src: string, opt?: Options): string;
export function lexer(src: string, opt?: Options): Array;
diff --git a/moment/moment-tests.ts b/moment/moment-tests.ts
index 1bb236ea3e..5d77aa3d3a 100644
--- a/moment/moment-tests.ts
+++ b/moment/moment-tests.ts
@@ -126,13 +126,6 @@ moment([2007, 0, 29]).fromNow();
moment([2007, 0, 29]).fromNow();
moment([2007, 0, 29]).fromNow(true);
-moment.humanizeDuration(1000 * 60);
-moment.humanizeDuration(1, "seconds");
-moment.humanizeDuration(60000, true);
-moment.humanizeDuration(1, "minutes", true);
-moment.humanizeDuration(-60000, true);
-moment.humanizeDuration(-1, "minutes", true);
-
var a8 = moment([2007, 0, 29]);
var b8 = moment([2007, 0, 28]);
a8.diff(b8) ;
@@ -235,4 +228,154 @@ moment.duration(500).asMilliseconds();
moment.duration(500).seconds();
moment.duration(500).asSeconds();
moment.duration().minutes();
-moment.duration().asMinutes();
\ No newline at end of file
+moment.duration().asMinutes();
+
+moment.lang('en', {
+ months : [
+ "January", "February", "March", "April", "May", "June", "July",
+ "August", "September", "October", "November", "December"
+ ]
+});
+
+moment.lang('en', {
+ months : function (momentToFormat, format) {
+ // momentToFormat is the moment currently being formatted
+ // format is the formatting string
+ if (/^MMMM/.test(format)) { // if the format starts with 'MMMM'
+ return this.nominative[momentToFormat.month()];
+ } else {
+ return this.subjective[momentToFormat.month()];
+ }
+ }
+});
+
+moment.lang('en', {
+ monthsShort : [
+ "Jan", "Feb", "Mar", "Apr", "May", "Jun",
+ "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"
+ ]
+});
+
+moment.lang('en', {
+ monthsShort : function (momentToFormat, format) {
+ if (/^MMMM/.test(format)) {
+ return this.nominative[momentToFormat.month()];
+ } else {
+ return this.subjective[momentToFormat.month()];
+ }
+ }
+});
+
+moment.lang('en', {
+ weekdays : [
+ "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"
+ ]
+});
+
+moment.lang('en', {
+ weekdays : function (momentToFormat, format) {
+ return this.weekdays[momentToFormat.day()];
+ }
+});
+
+moment.lang('en', {
+ weekdaysShort : ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"]
+});
+
+moment.lang('en', {
+ weekdaysShort : function (momentToFormat, format) {
+ return this.weekdaysShort[momentToFormat.day()];
+ }
+});
+
+moment.lang('en', {
+ weekdaysMin : ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"]
+});
+
+moment.lang('en', {
+ weekdaysMin : function (momentToFormat, format) {
+ return this.weekdaysMin[momentToFormat.day()];
+ }
+});
+
+moment.lang('en', {
+ longDateFormat : {
+ LT: "h:mm A",
+ L: "MM/DD/YYYY",
+ l: "M/D/YYYY",
+ LL: "MMMM Do YYYY",
+ ll: "MMM D YYYY",
+ LLL: "MMMM Do YYYY LT",
+ lll: "MMM D YYYY LT",
+ LLLL: "dddd, MMMM Do YYYY LT",
+ llll: "ddd, MMM D YYYY LT"
+ }
+});
+
+moment.lang('en', {
+ longDateFormat : {
+ LT: "h:mm A",
+ L: "MM/DD/YYYY",
+ LL: "MMMM Do YYYY",
+ LLL: "MMMM Do YYYY LT",
+ LLLL: "dddd, MMMM Do YYYY LT"
+ }
+});
+
+moment.lang('en', {
+ relativeTime : {
+ future: "in %s",
+ past: "%s ago",
+ s: "seconds",
+ m: "a minute",
+ mm: "%d minutes",
+ h: "an hour",
+ hh: "%d hours",
+ d: "a day",
+ dd: "%d days",
+ M: "a month",
+ MM: "%d months",
+ y: "a year",
+ yy: "%d years"
+ }
+});
+
+moment.lang('en', {
+ meridiem : function (hour, minute, isLowercase) {
+ if (hour < 9) {
+ return "早上";
+ } else if (hour < 11 && minute < 30) {
+ return "上午";
+ } else if (hour < 13 && minute < 30) {
+ return "中午";
+ } else if (hour < 18) {
+ return "下午";
+ } else {
+ return "晚上";
+ }
+ }
+});
+
+moment.lang('en', {
+ calendar : {
+ lastDay : '[Yesterday at] LT',
+ sameDay : '[Today at] LT',
+ nextDay : function () {
+ return '[hoy a la' + ((this.hours() !== 1) ? 's' : '') + '] LT';
+ },
+ lastWeek : '[last] dddd [at] LT',
+ nextWeek : 'dddd [at] LT',
+ sameElse : 'L'
+ }
+});
+
+moment.lang('en', {
+ ordinal : function (number) {
+ var b = number % 10;
+ var output = (~~ (number % 100 / 10) === 1) ? 'th' :
+ (b === 1) ? 'st' :
+ (b === 2) ? 'nd' :
+ (b === 3) ? 'rd' : 'th';
+ return number + output;
+ }
+});
diff --git a/moment/moment.d.ts b/moment/moment.d.ts
index 7a7b7d70cc..2ba80d175c 100644
--- a/moment/moment.d.ts
+++ b/moment/moment.d.ts
@@ -51,7 +51,6 @@ interface Duration {
}
-
interface Moment {
format(format: string): string;
@@ -122,6 +121,64 @@ interface Moment {
}
+interface MomentCalendar {
+
+ lastDay: any;
+ sameDay: any;
+ nextDay: any;
+ lastWeek: any;
+ nextWeek: any;
+ sameElse: any;
+
+}
+
+interface MomentLanguage {
+
+ months?: any;
+ monthsShort?: any;
+ weekdays?: any;
+ weekdaysShort?: any;
+ weekdaysMin?: any;
+ longDateFormat?: MomentLongDateFormat;
+ relativeTime?: MomentRelativeTime;
+ meridiem?: (hour: number, minute: number, isLowercase: bool) => string;
+ calendar?: MomentCalendar;
+ ordinal?: (num: number) => string;
+
+}
+
+interface MomentLongDateFormat {
+
+ L: string;
+ LL: string;
+ LLL: string;
+ LLLL: string;
+ LT: string;
+ l?: string;
+ ll?: string;
+ lll?: string;
+ llll?: string;
+ lt?: string;
+
+}
+
+interface MomentRelativeTime {
+
+ future: any;
+ past: any;
+ s: any;
+ m: any;
+ mm: any;
+ h: any;
+ hh: any;
+ d: any;
+ dd: any;
+ M: any;
+ MM: any;
+ y: any;
+ yy: any;
+
+}
interface MomentStatic {
@@ -146,7 +203,7 @@ interface MomentStatic {
isMoment(): bool;
isMoment(m: any): bool;
lang(language: string);
- lang(language: string, definition: any); // TODO definition
+ lang(language: string, definition: MomentLanguage);
months: string[];
monthsShort: string[];
weekdays: string[];
@@ -154,7 +211,7 @@ interface MomentStatic {
weekdaysMin: string[];
longDateFormat: any;
relativeTime: any;
- meridiem: (hour, minute, isLower) => string;
+ meridiem: (hour: number, minute: number, isLowercase: bool) => string;
calendar: any;
ordinal: (num: number) => string;
@@ -165,4 +222,4 @@ interface MomentStatic {
duration(): Duration;
}
-declare var moment: MomentStatic;
\ No newline at end of file
+declare var moment: MomentStatic;
diff --git a/mustache/mustache-tests.ts b/mustache/mustache-tests.ts
index 744e855852..9b42131ef1 100644
--- a/mustache/mustache-tests.ts
+++ b/mustache/mustache-tests.ts
@@ -5,4 +5,7 @@ var output = Mustache.render("{{title}} spends {{calc}}", view);
var person;
var template = "document.getElementById('noVNC_canvas');
+
+ rfb = new RFB({
+ target: canvas,
+ encrypt: true,
+ repeaterID: "myrepeaterid",
+ true_color: true,
+ local_cursor: true,
+ shared: true,
+ view_only: true,
+ updateState: true,
+ onPasswordRequired: (rfb: RFB) => { }
+ });
+ rfb.connect(host, port, password, path);
+};
diff --git a/noVNC/noVNC.d.ts b/noVNC/noVNC.d.ts
new file mode 100644
index 0000000000..ff6f690ecb
--- /dev/null
+++ b/noVNC/noVNC.d.ts
@@ -0,0 +1,140 @@
+// Type definitions for noVNC
+// Project: https://github.com/kanaka/noVNC
+// Definitions by: Ken Smith
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+
+/// redis.print],
["incr", "multifoo"],
["incr", "multibar"]
]).exec(function (err, replies) {
@@ -180,7 +180,7 @@ function test9() {
});
var max = 3, min = 1, offset = 1, count = 2;
- var args2 = ['myzset', max, min, 'WITHSCORES', 'LIMIT', offset, count];
+ var args2 = ['myzset', max, min, 'WITHSCORES', 'LIMIT', offset, count];
client.zrevrangebyscore(args2, function (err, response) {
if (err) throw err;
console.log('example2', response);
@@ -322,14 +322,14 @@ tests.MULTI_2 = function () {
// test nested multi-bulk replies
client.multi([
- ["mget", "multifoo", "multibar", function (err, res) {
+ ["mget", "multifoo", "multibar", function (err, res) {
assert.strictEqual(2, res.length, name);
assert.strictEqual("12", res[0].toString(), name);
assert.strictEqual("22", res[1].toString(), name);
}],
- ["set", "foo2", require_error(name)],
- ["incr", "multifoo", require_number(13, name)],
- ["incr", "multibar", require_number(23, name)]
+ ["set", "foo2", require_error(name)],
+ ["incr", "multifoo", require_number(13, name)],
+ ["incr", "multibar", require_number(23, name)]
]).exec(function (err, replies) {
assert.strictEqual(2, replies[0].length, name);
assert.strictEqual("12", replies[0][0].toString(), name);
@@ -393,7 +393,7 @@ tests.MULTI_5 = function () {
// test nested multi-bulk replies with nulls.
client.multi([
- ["mget", ["multifoo", "some", "random value", "keys"]],
+ ["mget", ["multifoo", "some", "random value", "keys"]],
["incr", "multifoo"]
])
.exec(function (err, replies) {
@@ -947,7 +947,7 @@ tests.TYPE = function () {
client.rpush(["list key", "should be a list"], require_number_pos(name));
client.sadd(["set key", "should be a set"], require_number_any(name));
client.zadd(["zset key", "10.0", "should be a zset"], require_number_any(name));
- client.hset(["hash key", "hashtest", "should be a hash"], require_number_any(0, name));
+ client.hset(["hash key", "hashtest", "should be a hash"], require_number_any(name));
client.TYPE(["string key"], require_string("string", name));
client.TYPE(["list key"], require_string("list", name));
@@ -1685,7 +1685,7 @@ tests.TTL = function () {
client.set(["ttl key", "ttl val"], require_string("OK", name));
client.expire(["ttl key", "100"], require_number_pos(name));
setTimeout(function () {
- client.TTL(["ttl key"], last(name, require_number_pos(0, name)));
+ client.TTL(["ttl key"], last(name, require_number_pos(name)));
}, 500);
};
diff --git a/node_redis/node_redis.d.ts b/node_redis/node_redis.d.ts
index 16fadff95b..74652ab332 100644
--- a/node_redis/node_redis.d.ts
+++ b/node_redis/node_redis.d.ts
@@ -342,7 +342,7 @@ declare module 'redis' {
once(eventName: string, callback: Function): void;
removeListener(eventName: string, callback: Function): void;
- multi(): Multi;
+ multi(commands?: any[]): Multi;
MULTI(): Multi;
}
}
\ No newline at end of file
diff --git a/nodemailer/nodemailer-tests.ts b/nodemailer/nodemailer-tests.ts
new file mode 100644
index 0000000000..d4458199c5
--- /dev/null
+++ b/nodemailer/nodemailer-tests.ts
@@ -0,0 +1,83 @@
+/// ',
+
+ // Comma separated list of recipients
+ to: '"Receiver Name" ',
+
+ // Subject of the message
+ subject: 'Nodemailer is unicode friendly ✔', //
+
+ // plaintext body
+ text: 'Hello to myself!',
+
+ // HTML body
+ html: '
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+
+interface Phantom {
+
+ // Properties
+ args: string[]; // DEPRECATED
+ cookies: Cookie[];
+ cookiesEnabled: bool;
+ libraryPath: string;
+ scriptName: string; // DEPRECATED
+ version: any;
+
+ // Functions
+ addCookie(cookie: Cookie): bool;
+ clearCookies();
+ deleteCookie(cookieName: string): bool;
+ exit(returnValue: any): bool;
+ injectJs(filename: string): bool;
+
+ // Callbacks
+ onError: Function;
+}
+
+interface System {
+ pid: number;
+ platform: string;
+ os: OS;
+ env: any;
+ args: string[];
+}
+
+interface OS {
+ architecture: string;
+ name: string;
+ version: string;
+}
+
+interface WebPage {
+
+ // Properties
+ canGoBack: bool;
+ canGoForward: bool;
+ clipRect: ClipRect;
+ content: string;
+ cookies: Cookie[];
+ customHeaders: any;
+ event;
+ focusedFrameName: string;
+ frameContent: string;
+ frameName: string;
+ framePlainText: string;
+ frameTitle: string;
+ frameUrl: string;
+ framesCount: number;
+ framesName;
+ libraryPath: string;
+ navigationLocked: bool;
+ offlineStoragePath: string;
+ offlineStorageQuota: number;
+ ownsPages: bool;
+ pages;
+ pagesWindowName: string;
+ paperSize: PaperSize;
+ plainText: string;
+ scrollPosition: TopLeft;
+ settings: WebPageSettings;
+ title: string;
+ url: string;
+ viewportSize: Size;
+ windowName: string;
+ zoomFactor: number;
+
+ // Functions
+ addCookie(cookie: Cookie): bool;
+ childFramesCount(): number; // DEPRECATED
+ childFramesName(): string; // DEPRECATED
+ clearCookies();
+ close();
+ currentFrameName(): string; // DEPRECATED
+ deleteCookie(cookieName: string): bool;
+ evaluate(fn: Function, ...args: any[]): any;
+ evaluateAsync(fn: Function);
+ evaluateJavascript(str: string);
+ getPage(windowName: string);
+ go(index: number);
+ goBack();
+ goForward();
+ includeJs(url: string, callback: Function);
+ injectJs(filename: string): bool;
+ open(url: string, callback: (status: string) => void);
+ openUrl(url: string, httpConf: any, settings: any);
+ release(); // DEPRECATED
+ reload();
+ render(filename: string);
+ renderBase64(format: any): string;
+ sendEvent(mouseEventType: string, mouseX?: number, mouseY?: number, button?: string);
+ sendEvent(keyboardEventType: string, keyOrKeys, aNull?, bNull?, modifier?);
+ setContent(content: string, url: string);
+ stop();
+ switchToFocusedFrame();
+ switchToFrame(frameName: string);
+ switchToFrame(framePosition);
+ switchToChildFrame(frameName: string);
+ switchToChildFrame(framePosition);
+ switchToMainFrame(); // DEPRECATED
+ switchToParentFrame(); // DEPRECATED
+ uploadFile(selector: string, filename: string);
+
+ // Callbacks
+ onAlert: Function;
+ onCallback: Function; // EXPERIMENTAL
+ onClosing: Function;
+ onConfirm: Function;
+ onConsoleMessage: Function;
+ onError: Function;
+ onFilePicker: Function;
+ onInitialized: Function;
+ onLoadFinished: Function;
+ onLoadStarted: Function;
+ onNavigationRequested: Function;
+ onPageCreated: Function;
+ onPrompt: Function;
+ onResourceRequested: Function;
+ onResourceReceived: Function;
+ onUrlChanged: Function;
+
+ // Callback triggers
+ closing(page);
+ initialized();
+ javaScriptAlertSent(message: string);
+ javaScriptConsoleMessageSent(message: string);
+ loadFinished(status);
+ loadStarted();
+ navigationRequested(url: string, navigationType, navigationLocked, isMainFrame: bool);
+ rawPageCreated(page);
+ resourceReceived(request);
+ resourceRequested(resource);
+ urlChanged(url: string);
+}
+
+interface PaperSize {
+ width: string;
+ height: string;
+ border: string;
+ format: string;
+ orientation: string;
+}
+
+interface WebPageSettings {
+ javascriptEnabled: bool;
+ loadImages: bool;
+ localToRemoteUrlAccessEnabled: bool;
+ userAgent: string;
+ password: string;
+ XSSAuditingEnabled: bool;
+ webSecurityEnabled: bool;
+}
+
+interface FileSystem {
+
+ // Properties
+ separator: string;
+ workingDirectory: string;
+
+ // Functions
+
+ // Query Functions
+ list(path: string): string[];
+ absolute(path: string): string;
+ exists(path: string): bool;
+ isDirectory(path: string): bool;
+ isFile(path: string): bool;
+ isAbsolute(path: string): bool;
+ isExecutable(path: string): bool;
+ isReadable(path: string): bool;
+ isWritable(path: string): bool;
+ isLink(path: string): bool;
+ readLink(path: string): string;
+
+ // Directory Functions
+ changeWorkingDirectory(path: string);
+ makeDirectory(path: string);
+ makeTree(path: string);
+ removeDirectory(path: string);
+ removeTree(path: string);
+ copyTree(source: string, destination: string);
+
+ // File Functions
+ open(path: string, mode: string): Stream;
+ read(path: string): string;
+ write(path: string, content: string, mode: string);
+ size(path: string): number;
+ remove(path: string);
+ copy(source: string, destination: string);
+ move(source: string, destination: string);
+ touch(path: string);
+}
+
+interface Stream {
+ read(): string;
+ readLine(): string;
+ write(data: string);
+ writeLine(data: string);
+ flush();
+ close();
+}
+
+interface WebServer {
+ port: number;
+ listen(port: number, cb?:(request, response) => void): bool;
+ listen(ipAddressPort: string, cb?:(request, response) => void): bool;
+ close();
+}
+
+interface Request {
+ method: string;
+ url: string;
+ httpVersion: number;
+ headers: any;
+ post: string;
+ postRaw: string;
+}
+
+interface Response {
+ headers: any;
+ setHeader(name: string, value: string);
+ header(name: string): string;
+ statusCode: number;
+ setEncoding(encoding: string);
+ write(data: string);
+ writeHead(statusCode: number, headers?: any);
+ close();
+ closeGracefully();
+}
+
+interface TopLeft {
+ top: number;
+ left: number;
+}
+
+interface Size {
+ width: number;
+ height: number;
+}
+
+interface ClipRect extends TopLeft, Size {
+ width: number;
+ height: number;
+}
+
+interface Cookie {
+ name: string;
+ value: string;
+}
diff --git a/phonegap/phonegap-tests.ts b/phonegap/phonegap-tests.ts
index 1dafd8d797..843ac9fbba 100644
--- a/phonegap/phonegap-tests.ts
+++ b/phonegap/phonegap-tests.ts
@@ -64,12 +64,12 @@ function test_camera() {
}
var popover = new CameraPopoverOptions(300, 300, 100, 100, 1);
- var options = { quality: 50, destinationType: 1, sourceType: 1, popoverOptions: popover };
+ var options = { quality: 50, destinationType: 1, sourceType: 1, popoverOptions: popover };
navigator.camera.getPicture(onSuccess, onFail, options);
function onSuccess(imageData) {
- var image = document.getElementById('myImage');
+ var image = document.getElementById('myImage');
image.src = "data:image/jpeg;base64," + imageData;
}
@@ -111,7 +111,7 @@ function test_capture() {
var options = { limit: 3, duration: 10 };
navigator.device.capture.captureAudio(captureSuccess, captureError, options);
var captureSuccess = function (mediaFiles) {
- var i, path, len;
+ var i, path, len;
for (i = 0, len = mediaFiles.length; i < len; i += 1) {
path = mediaFiles[i].fullPath;
}
@@ -150,7 +150,7 @@ function test_capture() {
{ fileName: name });
}
function captureSuccess(mediaFiles) {
- var i, len;
+ var i, len;
for (i = 0, len = mediaFiles.length; i < len; i += 1) {
uploadFile(mediaFiles[i]);
}
@@ -256,8 +256,7 @@ function test_contacts() {
function onDeviceReady() {
var options = new ContactFindOptions();
options.filter = "Bob";
- var fields = ["displayName", "name"];
- navigator.contacts.find(fields, onSuccess, onError, options);
+ navigator.contacts.find(["displayName", "name"], onSuccess, onError, options);
}
function onSuccess(contacts) {
for (var i = 0; i < contacts.length; i++) {
@@ -303,6 +302,7 @@ function test_contacts() {
options.filter = "";
var filter = ["displayName", "addresses"];
navigator.contacts.find(filter, onSuccess, onError, options);
+ var contacts: Contact[] = [];
for (var i = 0; i < contacts.length; i++) {
for (var j = 0; j < contacts[i].addresses.length; j++) {
@@ -333,11 +333,13 @@ function test_contacts() {
}
function test_device() {
+ var element = document.getElementById('deviceProperties');
element.innerHTML = 'Device Name: ' + device.name + '
' + 'Device Cordova: ' + device.cordova + '
' + 'Device Platform: ' + device.platform + '
' + 'Device UUID: ' + device.uuid + '
' + - 'Device Version: ' + device.version + '
'; + 'Device Model: ' + device.model + '
' + + 'Device Version: ' + device.version + '
'; } function test_file() { @@ -421,6 +423,8 @@ function test_file() { } var onGetFileWin = function (parent) { var data = {}; + var metadataKey: any; + var metadataValue: any; data[metadataKey] = metadataValue; parent.setMetadata(onSetMetadataWin, onSetMetadataFail, data); } @@ -428,15 +432,18 @@ function test_file() { console.log("error getting file") } var onFSWin = function (fileSystem) { + var filePath = ''; fileSystem.root.getFile(filePath, { create: true, exclusive: false }, onGetFileWin, onGetFileFail); } var onFSFail = function (evt) { console.log(evt.target.error.code); } + var localFileSystem:any; window.requestFileSystem(localFileSystem, 0, onFSWin, onFSFail); + var success: any; var entry: FileEntry; - var parent = document.getElementById('parent').value, + var parent = (document.getElementById('parent')).value,
parentName = parent.substring(parent.lastIndexOf('/') + 1),
parentEntry = new DirectoryEntry(parentName, parent);
entry.moveTo(parentEntry, "newFile.txt", success, fail);
@@ -458,11 +465,12 @@ function test_file() {
console.log("upload error target " + error.target);
}
var uri = encodeURI("http://some.server.com/upload.php");
+ var fileURI = "";
var options = new FileUploadOptions();
options.fileKey = "file";
options.fileName = fileURI.substr(fileURI.lastIndexOf('/') + 1);
options.mimeType = "text/plain";
- var params = {};
+ var params:any = {};
params.headers = { 'headerParam': 'headerValue' };
options.params = params;
var ft = new FileTransfer();
@@ -590,8 +598,15 @@ function test_globalization() {
);
}
+function test_inAppBrowser() {
+ var ref = window.open('http://apache.org', '_blank', 'location=yes');
+ ref.addEventListener('loadstart', function () { alert(event.url); });
+ ref.removeEventListener('loadstart', null);
+ ref.close();
+}
+
function test_media() {
- var my_media = new Media(src, onSuccess, onError);
+ var my_media = new Media(src, ()=>{}, ()=>{});
var mediaTimer = setInterval(function () {
my_media.getCurrentPosition(
function (position) {
@@ -628,7 +643,7 @@ function test_media() {
});
my_media.play();
setTimeout(function () {
- media.pause();
+ my_media.pause();
}, 10000);
}
@@ -643,6 +658,9 @@ function test_media() {
my_media.play();
}
+ var onSuccess: any;
+ var onError: any;
+
var my_media = new Media(src, onSuccess, onError);
my_media.play();
my_media.stop();
@@ -650,7 +668,7 @@ function test_media() {
setTimeout(function () {
my_media.seekTo(10000);
}, 5000);
- media.stopRecord();
+ my_media.stopRecord();
var src = "myrecording.mp3";
var mediaRec = new Media(src,
@@ -664,6 +682,8 @@ function test_media() {
mediaRec.startRecord();
}
+var onConfirm: any;
+
function test_notification() {
function alertDismissed() { }
navigator.notification.alert(
@@ -707,13 +727,13 @@ function test_storage() {
function queryDB(tx) {
tx.executeSql('SELECT * FROM DEMO', [], querySuccess, errorCB);
}
- function querySuccess(tx, results) {
- console.log("Returned rows = " + results.rows.length);
+ function querySuccess(tx, resultSet) {
+ console.log("Returned rows = " + resultSet.rows.length);
if (!resultSet.rowsAffected) {
console.log('No rows affected!');
return false;
}
- console.log("Last inserted row ID = " + results.insertId);
+ console.log("Last inserted row ID = " + resultSet.insertId);
}
var db = window.openDatabase("Database", "1.0", "Cordova Demo", 200000);
db.transaction(queryDB, errorCB);
diff --git a/phonegap/phonegap.d.ts b/phonegap/phonegap.d.ts
index a3794dc3bc..8ecca80ca4 100644
--- a/phonegap/phonegap.d.ts
+++ b/phonegap/phonegap.d.ts
@@ -1,8 +1,16 @@
-// Type definitions for PhoneGap 2.2
+// Type definitions for PhoneGap 2.3
// Project: http://phonegap.com
// Definitions by: Boris Yankov
// Definitions: https://github.com/borisyankov/DefinitelyTyped
@@ -18,49 +18,73 @@ module createjs {
progress: number;
// methods
- cancel(): void;
- getItem(): Object;
+ close(): void;
+ getItem(value: string): Object;
load(): void;
+ toString(): string;
// events
- onComplete: () => any;
- onError: () => any;
- onFileLoad: () => any;
- onFileProgress: () => any;
- onLoadStart: () => any;
- onProgress: () => any;
+ complete: (event: Object) => any;
+ error: (event: Object) => any;
+ fileload: (event: Object) => any;
+ fileprogress: (event: Object) => any;
+ loadStart: (event: Object) => any;
+
+ // EventDispatcher mixins
+ addEventListener(type: string, listener: (eventObj: Object) => bool): Function;
+ addEventListener(type: string, listener: (eventObj: Object) => bool): Object;
+ removeEventListener(type: string, listener: (eventObj: Function) => bool): void;
+ removeEventListener(type: string, listener: (eventObj: Object) => bool): void;
+ removeAllEventListeners(type: string): void;
+ dispatchEvent(eventObj: string, target: Object): bool;
+ dispatchEvent(eventObj: Object, target: Object): bool;
+ hasEventListener(type: string): bool;
}
+ export class PreloadJS {
+ version: string;
+ buildDate: string;
+ }
- export class PreloadJS extends AbstractLoader {
- constructor (useXHR2?: bool);
+ export class LoadQueue extends AbstractLoader {
+ constructor (useXHR?: bool);
// properties
+ static BINARY: string;
static CSS: string;
static IMAGE: string;
static JAVASCRIPT: string;
static JSON: string;
- maintainScriptOrder: bool;
- next: PreloadJS;
static SOUND: string;
- stopOnError: bool;
+ static SVG: string;
static TEXT: string;
- static TIMEOUT_TIME: number;
- useXHR: bool;
+ static LOAD_TIMEOUT: number;
static XML: string;
+ maintainScriptOrder: bool;
+ next: LoadQueue;
+ stopOnError: bool;
+ useXHR: bool;
+
// methods
BrowserDetect(): Object;
+ init(useXHR?: bool): void;
close(): void;
- getResult(value: string): Object;
initialize(useXHR: bool): void;
installPlugin(plugin: () => any): void;
load(): void;
- loadFile(file: Object, loadNow: bool): void;
- loadFile(file: string, loadNow: bool): void;
- loadManifest(manifest: Object[], loadNow: bool): void;
- loadManifest(manifest: string[], loadNow: bool): void;
+ loadFile(file: Object, loadNow?: bool): void;
+ loadFile(file: string, loadNow?: bool): void;
+ loadManifest(manifest: Object[], loadNow?: bool): void;
+ loadManifest(manifest: string[], loadNow?: bool): void;
+ getItem(value: string): Object;
+ getResult(value: string, rawResult?: bool): Object;
+ removeAll(): void;
+ remove(idsOrUrls: string): void;
+ remove(idsOrUrls: Array): void;
+ reset(): void;
setMaxConnections(value: number): void;
+ setUseXHR(value: bool): void;
setPaused(value: bool): void;
}
@@ -68,10 +92,13 @@ module createjs {
export class TagLoader extends AbstractLoader {
constructor (item: Object, srcAttr: string, useXHR: bool);
constructor (item: string, srcAttr: string, useXHR: bool);
+ getResult(): HTMLImageElement;
+ getResult(): HTMLAudioElement;
}
export class XHRLoader extends AbstractLoader {
constructor (file: Object);
+ getResult(rawResult?: bool);
}
-}
\ No newline at end of file
+}
diff --git a/qunit/qunit.d.ts b/qunit/qunit.d.ts
index a57d945f56..b8ba3bb4a4 100644
--- a/qunit/qunit.d.ts
+++ b/qunit/qunit.d.ts
@@ -5,40 +5,127 @@
interface DoneCallbackObject {
+ /**
+ * The number of failed assertions
+ */
failed: number;
+
+ /**
+ * The number of passed assertions
+ */
passed: number;
+
+ /**
+ * The total number of assertions
+ */
total: number;
+
+ /**
+ * The time in milliseconds it took tests to run from start to finish.
+ */
runtime: number;
}
interface LogCallbackObject {
+ /**
+ * The boolean result of an assertion, true means passed, false means failed.
+ */
result: bool;
+
+ /**
+ * One side of a comparision assertion. Can be undefined when ok() is used.
+ */
actual: Object;
+
+ /**
+ * One side of a comparision assertion. Can be undefined when ok() is used.
+ */
expected: Object;
+
+ /**
+ * A string description provided by the assertion.
+ */
message: string;
+
+ /**
+ * The associated stacktrace, either from an exception or pointing to the source
+ * of the assertion. Depends on browser support for providing stacktraces, so can be
+ * undefined.
+ */
+ source: string;
+}
+
+interface ModuleStartCallbackObject {
+ /**
+ * Name of the next module to run
+ */
+ name: string;
}
interface ModuleDoneCallbackObject {
+ /**
+ * Name of this module
+ */
name: string;
+
+ /**
+ * The number of failed assertions
+ */
failed: number;
+
+ /**
+ * The number of passed assertions
+ */
passed: number;
+
+ /**
+ * The total number of assertions
+ */
total: number;
}
interface TestDoneCallbackObject {
+ /**
+ * TName of the next test to run
+ */
name: string;
+
+ /**
+ * Name of the current module
+ */
module: string;
+
+ /**
+ * The number of failed assertions
+ */
failed: number;
+
+ /**
+ * The number of passed assertions
+ */
passed: number;
+
+ /**
+ * The total number of assertions
+ */
total: number;
+
+ /**
+ * The total runtime, including setup and teardown
+ */
+ duration: number;
}
interface TestStartCallbackObject {
+ /**
+ * Name of the next test to run
+ */
name: string;
+
+ /**
+ * Name of the current module
+ */
module: string;
- failed: number;
- passed: number;
- total: number;
}
interface Config {
@@ -52,7 +139,14 @@ interface Config {
}
interface LifecycleObject {
+ /**
+ * Runs before each test
+ */
setup?: () => any;
+
+ /**
+ * Runs after each test
+ */
teardown?: () => any;
}
@@ -62,95 +156,558 @@ interface QUnitAssert {
current_testEnvironment: any;
jsDump: any;
+ /**
+ * A deep recursive comparison assertion, working on primitive types, arrays, objects,
+ * regular expressions, dates and functions.
+ *
+ * The deepEqual() assertion can be used just like equal() when comparing the value of
+ * objects, such that { key: value } is equal to { key: value }. For non-scalar values,
+ * identity will be disregarded by deepEqual.
+ *
+ * @param actual Object or Expression being tested
+ * @param expected Known comparison value
+ * @param message A short description of the assertion
+ */
deepEqual(actual: any, expected: any, message?: string);
+
+ /**
+ * A non-strict comparison assertion, roughly equivalent to JUnit assertEquals.
+ *
+ * The equal assertion uses the simple comparison operator (==) to compare the actual
+ * and expected arguments. When they are equal, the assertion passes; otherwise, it fails.
+ * When it fails, both actual and expected values are displayed in the test result,
+ * in addition to a given message.
+ *
+ * @param actual Expression being tested
+ * @param expected Known comparison value
+ * @param message A short description of the assertion
+ */
equal(actual: any, expected: any, message?: string);
+
+ /**
+ * An inverted deep recursive comparison assertion, working on primitive types,
+ * arrays, objects, regular expressions, dates and functions.
+ *
+ * The notDeepEqual() assertion can be used just like equal() when comparing the
+ * value of objects, such that { key: value } is equal to { key: value }. For non-scalar
+ * values, identity will be disregarded by notDeepEqual.
+ *
+ * @param actual Object or Expression being tested
+ * @param expected Known comparison value
+ * @param message A short description of the assertion
+ */
notDeepEqual(actual: any, expected: any, message?: string);
+
+ /**
+ * A non-strict comparison assertion, checking for inequality.
+ *
+ * The notEqual assertion uses the simple inverted comparison operator (!=) to compare
+ * the actual and expected arguments. When they aren't equal, the assertion passes;
+ * otherwise, it fails. When it fails, both actual and expected values are displayed
+ * in the test result, in addition to a given message.
+ *
+ * @param actual Expression being tested
+ * @param expected Known comparison value
+ * @param message A short description of the assertion
+ */
notEqual(actual: any, expected: any, message?: string);
+
notPropEqual(actual: any, expected: any, message?: string);
+
propEqual(actual: any, expected: any, message?: string);
+
+ /**
+ * A non-strict comparison assertion, checking for inequality.
+ *
+ * The notStrictEqual assertion uses the strict inverted comparison operator (!==)
+ * to compare the actual and expected arguments. When they aren't equal, the assertion
+ * passes; otherwise, it fails. When it fails, both actual and expected values are
+ * displayed in the test result, in addition to a given message.
+ *
+ * @param actual Expression being tested
+ * @param expected Known comparison value
+ * @param message A short description of the assertion
+ */
notStrictEqual(actual: any, expected: any, message?: string);
+
+ /**
+ * A boolean assertion, equivalent to CommonJS’s assert.ok() and JUnit’s assertTrue().
+ * Passes if the first argument is truthy.
+ *
+ * The most basic assertion in QUnit, ok() requires just one argument. If the argument
+ * evaluates to true, the assertion passes; otherwise, it fails. If a second message
+ * argument is provided, it will be displayed in place of the result.
+ *
+ * @param state Expression being tested
+ * @param message A short description of the assertion
+ */
ok(state: any, message?: string);
+
+ /**
+ * A strict type and value comparison assertion.
+ *
+ * The strictEqual() assertion provides the most rigid comparison of type and value with
+ * the strict equality operator (===)
+ *
+ * @param actual Expression being tested
+ * @param expected Known comparison value
+ * @param message A short description of the assertion
+ */
strictEqual(actual: any, expected: any, message?: string);
+
+ /**
+ * Assertion to test if a callback throws an exception when run.
+ *
+ * When testing code that is expected to throw an exception based on a specific set of
+ * circumstances, use throws() to catch the error object for testing and comparison.
+ *
+ * @param block Function to execute
+ * @param expected Error Object to compare
+ * @param message A short description of the assertion
+ */
throws(block: () => any, expected: any, message?: string);
+
+ /**
+ * @param block Function to execute
+ * @param message A short description of the assertion
+ */
throws(block: () => any, message?: string);
}
interface QUnitStatic extends QUnitAssert{
/* ASYNC CONTROL */
+
+ /**
+ * Start running tests again after the testrunner was stopped. See stop().
+ *
+ * When your async test has multiple exit points, call start() for the corresponding number of stop() increments.
+ *
+ * @param decrement Optional argument to merge multiple start() calls into one. Use with multiple corrsponding stop() calls.
+ */
start(decrement?: number);
+
+ /**
+ * Stop the testrunner to wait for async tests to run. Call start() to continue.
+ *
+ * When your async test has multiple exit points, call stop() with the increment argument, corresponding to the number of start() calls you need.
+ *
+ * On Blackberry 5.0, window.stop is a native read-only function. If you deal with that browser, use QUnit.stop() instead, which will work anywhere.
+ *
+ * @param decrement Optional argument to merge multiple stop() calls into one. Use with multiple corrsponding start() calls.
+ */
stop(increment? : number);
/* CALLBACKS */
+
+ /**
+ * Register a callback to fire whenever the test suite begins.
+ *
+ * QUnit.begin() is called once before running any tests. (a better would've been QUnit.start,
+ * but thats already in use elsewhere and can't be changed.)
+ *
+ * @param callback Callback to execute
+ */
begin(callback: () => any);
+
+ /**
+ * Register a callback to fire whenever the test suite ends.
+ *
+ * @param callback Callback to execute.
+ */
done(callback: (details: DoneCallbackObject) => any);
+
+ /**
+ * Register a callback to fire whenever an assertion completes.
+ *
+ * This is one of several callbacks QUnit provides. Its intended for integration scenarios like
+ * PhantomJS or Jenkins. The properties of the details argument are listed below as options.
+ *
+ * @param callback Callback to execute.
+ */
log(callback: (details: LogCallbackObject) => any);
+
+ /**
+ * Register a callback to fire whenever a module ends.
+ *
+ * @param callback Callback to execute.
+ */
moduleDone(callback: (details: ModuleDoneCallbackObject) => any);
- moduleStart(callback: (name: string) => any);
+
+ /**
+ * Register a callback to fire whenever a module begins.
+ *
+ * @param callback Callback to execute.
+ */
+ moduleStart(callback: (details: ModuleStartCallbackObject) => any);
+
+ /**
+ * Register a callback to fire whenever a test ends.
+ *
+ * @param callback Callback to execute.
+ */
testDone(callback: (details: TestDoneCallbackObject) => any);
+
+ /**
+ * Register a callback to fire whenever a test begins.
+ *
+ * @param callback Callback to execute.
+ */
testStart(callback: (details: TestStartCallbackObject) => any);
/* CONFIGURATION */
+
+ /**
+ * QUnit has a bunch of internal configuration defaults, some of which are
+ * useful to override. Check the description for each option for details.
+ */
config: Config;
/* TEST */
+
+ /**
+ * Add an asynchronous test to run. The test must include a call to start().
+ *
+ * For testing asynchronous code, asyncTest will automatically stop the test runner
+ * and wait for your code to call start() to continue.
+ *
+ * @param name Title of unit being tested
+ * @param expected Number of assertions in this test
+ * @param test Function to close over assertions
+ */
asyncTest(name: string, expected: number, test: () => any);
+
+ /**
+ * Add an asynchronous test to run. The test must include a call to start().
+ *
+ * For testing asynchronous code, asyncTest will automatically stop the test runner
+ * and wait for your code to call start() to continue.
+ *
+ * @param name Title of unit being tested
+ * @param test Function to close over assertions
+ */
asyncTest(name: string, test: () => any);
+
+ /**
+ * Specify how many assertions are expected to run within a test.
+ *
+ * To ensure that an explicit number of assertions are run within any test, use
+ * expect( number ) to register an expected count. If the number of assertions
+ * run does not match the expected count, the test will fail.
+ *
+ * @param amount Number of assertions in this test.
+ */
expect(amount: number);
+
+ /**
+ * Group related tests under a single label.
+ *
+ * All tests that occur after a call to module() will be grouped into that module.
+ * The test names will all be preceded by the module name in the test results.
+ * You can then use that module name to select tests to run.
+ *
+ * @param name Label for this group of tests
+ * @param lifecycle Callbacks to run before and after each test
+ */
module(name: string, lifecycle?: LifecycleObject);
+
+ /**
+ * Add a test to run.
+ *
+ * When testing the most common, synchronous code, use test().
+ * The assert argument to the callback contains all of QUnit's assertion methods.
+ * If you are avoiding using any of QUnit's globals, you can use the assert
+ * argument instead.
+ *
+ * @param title Title of unit being tested
+ * @param expected Number of assertions in this test
+ * @param test Function to close over assertions
+ */
test(title: string, expected: number, test: (assert: QUnitAssert) => any);
+
+ /**
+ * @param title Title of unit being tested
+ * @param test Function to close over assertions
+ */
test(title: string, test: (assert: QUnitAssert) => any);
- // https://github.com/jquery/qunit/blob/master/qunit/qunit.js#L1568
+ /**
+ * https://github.com/jquery/qunit/blob/master/qunit/qunit.js#L1568
+ */
equiv(a: any, b: any);
// https://github.com/jquery/qunit/blob/master/qunit/qunit.js#L661
raises: any;
- // https://github.com/jquery/qunit/blob/master/qunit/qunit.js#L897
+ /**
+ * https://github.com/jquery/qunit/blob/master/qunit/qunit.js#L897
+ */
push(result, actual, expected, message): any;
- // https://github.com/jquery/qunit/blob/master/qunit/qunit.js#L839
+ /**
+ * https://github.com/jquery/qunit/blob/master/qunit/qunit.js#L839
+ */
reset(): any;
}
/* ASSERT */
-declare var deepEqual: (actual: any, expected: any, message?: string) => any;
-declare var equal: (actual: any, expected: any, message?: string) => any;
-declare var notDeepEqual: (actual: any, expected: any, message?: string) => any;
-declare var notEqual: (actual: any, expected: any, message?: string) => any;
-declare var notStrictEqual: (actual: any, expected: any, message?: string) => any;
-declare var ok: (state: any, message?: string) => any;
-declare var strictEqual: (actual: any, expected: any, message?: string) => any;
-// ** I Can't make overload here! :(s
-//declare var throws: (block: () => void, expected: Object, message: string) => any;
-declare var throws: (block: () => void, expected?: any, message?: string) => any;
+
+/**
+* A deep recursive comparison assertion, working on primitive types, arrays, objects,
+* regular expressions, dates and functions.
+*
+* The deepEqual() assertion can be used just like equal() when comparing the value of
+* objects, such that { key: value } is equal to { key: value }. For non-scalar values,
+* identity will be disregarded by deepEqual.
+*
+* @param actual Object or Expression being tested
+* @param expected Known comparison value
+* @param message A short description of the assertion
+*/
+declare function deepEqual(actual: any, expected: any, message?: string);
+
+/**
+* A non-strict comparison assertion, roughly equivalent to JUnit assertEquals.
+*
+* The equal assertion uses the simple comparison operator (==) to compare the actual
+* and expected arguments. When they are equal, the assertion passes; otherwise, it fails.
+* When it fails, both actual and expected values are displayed in the test result,
+* in addition to a given message.
+*
+* @param actual Expression being tested
+* @param expected Known comparison value
+* @param message A short description of the assertion
+*/
+declare function equal(actual: any, expected: any, message?: string);
+
+/**
+* An inverted deep recursive comparison assertion, working on primitive types,
+* arrays, objects, regular expressions, dates and functions.
+*
+* The notDeepEqual() assertion can be used just like equal() when comparing the
+* value of objects, such that { key: value } is equal to { key: value }. For non-scalar
+* values, identity will be disregarded by notDeepEqual.
+*
+* @param actual Object or Expression being tested
+* @param expected Known comparison value
+* @param message A short description of the assertion
+*/
+declare function notDeepEqual(actual: any, expected: any, message?: string);
+
+/**
+* A non-strict comparison assertion, checking for inequality.
+*
+* The notEqual assertion uses the simple inverted comparison operator (!=) to compare
+* the actual and expected arguments. When they aren't equal, the assertion passes;
+* otherwise, it fails. When it fails, both actual and expected values are displayed
+* in the test result, in addition to a given message.
+*
+* @param actual Expression being tested
+* @param expected Known comparison value
+* @param message A short description of the assertion
+*/
+declare function notEqual(actual: any, expected: any, message?: string);
+
+/**
+* A non-strict comparison assertion, checking for inequality.
+*
+* The notStrictEqual assertion uses the strict inverted comparison operator (!==)
+* to compare the actual and expected arguments. When they aren't equal, the assertion
+* passes; otherwise, it fails. When it fails, both actual and expected values are
+* displayed in the test result, in addition to a given message.
+*
+* @param actual Expression being tested
+* @param expected Known comparison value
+* @param message A short description of the assertion
+*/
+declare function notStrictEqual(actual: any, expected: any, message?: string);
+
+/**
+* A boolean assertion, equivalent to CommonJS’s assert.ok() and JUnit’s assertTrue().
+* Passes if the first argument is truthy.
+*
+* The most basic assertion in QUnit, ok() requires just one argument. If the argument
+* evaluates to true, the assertion passes; otherwise, it fails. If a second message
+* argument is provided, it will be displayed in place of the result.
+*
+* @param state Expression being tested
+* @param message A short description of the assertion
+*/
+declare function ok(state: any, message?: string);
+
+/**
+* A strict type and value comparison assertion.
+*
+* The strictEqual() assertion provides the most rigid comparison of type and value with
+* the strict equality operator (===)
+*
+* @param actual Expression being tested
+* @param expected Known comparison value
+* @param message A short description of the assertion
+*/
+declare function strictEqual(actual: any, expected: any, message?: string);
+
+/**
+* Assertion to test if a callback throws an exception when run.
+*
+* When testing code that is expected to throw an exception based on a specific set of
+* circumstances, use throws() to catch the error object for testing and comparison.
+*
+* @param block Function to execute
+* @param expected Error Object to compare
+* @param message A short description of the assertion
+*/
+declare function throws(block: () => any, expected: any, message?: string);
+
+/**
+* @param block Function to execute
+* @param message A short description of the assertion
+*/
+declare function throws(block: () => any, message?: string);
/* ASYNC CONTROL */
-declare var start: (decrement?: number) => any;
-declare var stop: (increment? : number) => any;
+
+/**
+* Start running tests again after the testrunner was stopped. See stop().
+*
+* When your async test has multiple exit points, call start() for the corresponding number of stop() increments.
+*
+* @param decrement Optional argument to merge multiple start() calls into one. Use with multiple corrsponding stop() calls.
+*/
+declare function start(decrement?: number);
+
+/**
+* Stop the testrunner to wait for async tests to run. Call start() to continue.
+*
+* When your async test has multiple exit points, call stop() with the increment argument, corresponding to the number of start() calls you need.
+*
+* On Blackberry 5.0, window.stop is a native read-only function. If you deal with that browser, use QUnit.stop() instead, which will work anywhere.
+*
+* @param decrement Optional argument to merge multiple stop() calls into one. Use with multiple corrsponding start() calls.
+*/
+declare function stop(increment? : number);
/* CALLBACKS */
-declare var begin: (callback: () => any) => any;
-declare var done: (callback: (details: DoneCallbackObject) => any) => any;
-declare var log: (callback: (details: LogCallbackObject) => any) => any;
-declare var moduleDone: (callback: (details: ModuleDoneCallbackObject) => any) => any;
-declare var moduleStart: (callback: (name: string) => any) => any;
-declare var testDone: (callback: (details: TestDoneCallbackObject) => any) => any;
-declare var testStart: (callback: (details: TestStartCallbackObject) => any) => any;
+
+/**
+* Register a callback to fire whenever the test suite begins.
+*
+* QUnit.begin() is called once before running any tests. (a better would've been QUnit.start,
+* but thats already in use elsewhere and can't be changed.)
+*
+* @param callback Callback to execute
+*/
+declare function begin(callback: () => any);
+
+/**
+* Register a callback to fire whenever the test suite ends.
+*
+* @param callback Callback to execute.
+*/
+declare function done(callback: (details: DoneCallbackObject) => any);
+
+/**
+* Register a callback to fire whenever an assertion completes.
+*
+* This is one of several callbacks QUnit provides. Its intended for integration scenarios like
+* PhantomJS or Jenkins. The properties of the details argument are listed below as options.
+*
+* @param callback Callback to execute.
+*/
+declare function log(callback: (details: LogCallbackObject) => any);
+
+/**
+* Register a callback to fire whenever a module ends.
+*
+* @param callback Callback to execute.
+*/
+declare function moduleDone(callback: (details: ModuleDoneCallbackObject) => any);
+
+/**
+* Register a callback to fire whenever a module begins.
+*
+* @param callback Callback to execute.
+*/
+declare function moduleStart(callback: (name: string) => any);
+
+/**
+* Register a callback to fire whenever a test ends.
+*
+* @param callback Callback to execute.
+*/
+declare function testDone(callback: (details: TestDoneCallbackObject) => any);
+
+/**
+* Register a callback to fire whenever a test begins.
+*
+* @param callback Callback to execute.
+*/
+declare function testStart(callback: (details: TestStartCallbackObject) => any);
/* TEST */
-declare var asyncTest: (name: string, expected?: any, test?: () => any) => any;
-declare var expect: (amount: number) => any;
+
+/**
+* Add an asynchronous test to run. The test must include a call to start().
+*
+* For testing asynchronous code, asyncTest will automatically stop the test runner
+* and wait for your code to call start() to continue.
+*
+* @param name Title of unit being tested
+* @param expected Number of assertions in this test
+* @param test Function to close over assertions
+*/
+declare function asyncTest(name: string, expected?: any, test?: () => any);
+
+/**
+* Add an asynchronous test to run. The test must include a call to start().
+*
+* For testing asynchronous code, asyncTest will automatically stop the test runner
+* and wait for your code to call start() to continue.
+*
+* @param name Title of unit being tested
+* @param test Function to close over assertions
+*/
+declare function asyncTest(name: string, test: () => any);
+
+/**
+* Specify how many assertions are expected to run within a test.
+*
+* To ensure that an explicit number of assertions are run within any test, use
+* expect( number ) to register an expected count. If the number of assertions
+* run does not match the expected count, the test will fail.
+*
+* @param amount Number of assertions in this test.
+*/
+declare function expect(amount: number);
+
// ** conflict with TypeScript module keyword. Must be used on QUnit namespace
//declare var module: (name: string, lifecycle?: LifecycleObject) => any;
-// ** I can't make an overload here! :(
-//declare var test: (title: string, expected?: any, test?: (assert?: any) => any) => any;
-declare var test: (title: string, test: (assert?: QUnitAssert) => any) => any;
-declare var notPropEqual: (actual: any, expected: any, message?: string) => any;
-declare var propEqual: (actual: any, expected: any, message?: string) => any;
+
+/**
+* Add a test to run.
+*
+* When testing the most common, synchronous code, use test().
+* The assert argument to the callback contains all of QUnit's assertion methods.
+* If you are avoiding using any of QUnit's globals, you can use the assert
+* argument instead.
+*
+* @param title Title of unit being tested
+* @param expected Number of assertions in this test
+* @param test Function to close over assertions
+*/
+declare function test(title: string, expected: number, test: (assert?: QUnitAssert) => any);
+
+/**
+* @param title Title of unit being tested
+* @param test Function to close over assertions
+*/
+declare function test(title: string, test: (assert?: QUnitAssert) => any);
+
+declare function notPropEqual(actual: any, expected: any, message?: string);
+
+declare function propEqual(actual: any, expected: any, message?: string);
// https://github.com/jquery/qunit/blob/master/qunit/qunit.js#L1568
-declare var equiv: (a: any, b: any) => any;
+declare function equiv(a: any, b: any);
// https://github.com/jquery/qunit/blob/master/qunit/qunit.js#L661
declare var raises: any;
diff --git a/requirejs/require.d.ts b/requirejs/require.d.ts
index 1d6934041b..e9351aa469 100644
--- a/requirejs/require.d.ts
+++ b/requirejs/require.d.ts
@@ -202,5 +202,5 @@ interface RequireDefine {
}
// Ambient declarations for 'require' and 'define'
-var require: Require;
-var define: RequireDefine;
+declare var require: Require;
+declare var define: RequireDefine;
diff --git a/restify/restify.d.ts b/restify/restify.d.ts
index 6b85260baf..11752d7be4 100644
--- a/restify/restify.d.ts
+++ b/restify/restify.d.ts
@@ -1,3 +1,8 @@
+// Type definitions for node.js REST framework 2.0
+// Project: https://github.com/mcavage/node-restify
+// Definitions by: Bret Little
+// Definitions: https://github.com/borisyankov/DefinitelyTyped
+
interface addressInterface {
port: number;
family: string;
diff --git a/scroller/scroller-tests.ts b/scroller/scroller-tests.ts
index 9daaab4983..ff12a8639e 100644
--- a/scroller/scroller-tests.ts
+++ b/scroller/scroller-tests.ts
@@ -1,5 +1,11 @@
/// content.getElementsByTagName("div")[0];
var scroller = new Scroller(render, {
scrollingX: false
});
@@ -61,7 +67,7 @@ function test_domlist() {
var row = document.createElement("div");
row.className = "row";
row.style.backgroundColor = i % 2 > 0 ? "#ddd" : "";
- row.innerHTML = Math.random();
+ row.innerHTML = Math.random();
if (content.firstChild == content.lastChild) {
content.appendChild(row);
} else {
@@ -74,14 +80,14 @@ function test_domlist() {
if ('ontouchstart' in window) {
container.addEventListener("touchstart", function (e) {
// Don't react if initial down happens on a form element
- if (e.target.tagName.match(/input|textarea|select/i)) {
+ if ((e.target).tagName.match(/input|textarea|select/i)) {
return;
}
- scroller.doTouchStart(e.touches, e.timeStamp);
+ scroller.doTouchStart((e).touches, e.timeStamp);
e.preventDefault();
}, false);
document.addEventListener("touchmove", function (e) {
- scroller.doTouchMove(e.touches, e.timeStamp);
+ scroller.doTouchMove((e).touches, e.timeStamp);
}, false);
document.addEventListener("touchend", function (e) {
scroller.doTouchEnd(e.timeStamp);
@@ -89,12 +95,12 @@ function test_domlist() {
} else {
var mousedown = false;
container.addEventListener("mousedown", function (e) {
- if (e.target.tagName.match(/input|textarea|select/i)) {
+ if ((e.target).tagName.match(/input|textarea|select/i)) {
return;
}
scroller.doTouchStart([{
- pageX: e.pageX,
- pageY: e.pageY
+ pageX: (e).pageX,
+ pageY: (e).pageY
}], e.timeStamp);
mousedown = true;
}, false);
@@ -103,8 +109,8 @@ function test_domlist() {
return;
}
scroller.doTouchMove([{
- pageX: e.pageX,
- pageY: e.pageY
+ pageX: (e).pageX,
+ pageY: (e).pageY
}], e.timeStamp);
mousedown = true;
}, false);
@@ -124,10 +130,10 @@ function test_dompaging() {
var size = 400;
var frag = document.createDocumentFragment();
for (var cell = 0, cl = content.clientWidth / size; cell < cl; cell++) {
- elem = document.createElement("div");
+ var elem = document.createElement("div");
elem.className = "cell";
elem.style.backgroundColor = cell % 2 > 0 ? "#ddd" : "";
- elem.innerHTML = cell;
+ elem.innerHTML = cell;
frag.appendChild(elem);
}
content.appendChild(frag);
@@ -140,14 +146,14 @@ function test_dompaging() {
scroller.setDimensions(container.clientWidth, container.clientHeight, content.offsetWidth, content.offsetHeight);
if ('ontouchstart' in window) {
container.addEventListener("touchstart", function (e) {
- if (e.target.tagName.match(/input|textarea|select/i)) {
+ if ((e.target).tagName.match(/input|textarea|select/i)) {
return;
}
- scroller.doTouchStart(e.touches, e.timeStamp);
+ scroller.doTouchStart((e).touches, e.timeStamp);
e.preventDefault();
}, false);
document.addEventListener("touchmove", function (e) {
- scroller.doTouchMove(e.touches, e.timeStamp);
+ scroller.doTouchMove((e).touches, e.timeStamp);
}, false);
document.addEventListener("touchend", function (e) {
scroller.doTouchEnd(e.timeStamp);
@@ -155,12 +161,12 @@ function test_dompaging() {
} else {
var mousedown = false;
container.addEventListener("mousedown", function (e) {
- if (e.target.tagName.match(/input|textarea|select/i)) {
+ if ((e.target).tagName.match(/input|textarea|select/i)) {
return;
}
scroller.doTouchStart([{
- pageX: e.pageX,
- pageY: e.pageY
+ pageX: (e).pageX,
+ pageY: (e).pageY
}], e.timeStamp);
mousedown = true;
}, false);
@@ -169,8 +175,8 @@ function test_dompaging() {
return;
}
scroller.doTouchMove([{
- pageX: e.pageX,
- pageY: e.pageY
+ pageX: (e).pageX,
+ pageY: (e).pageY
}], e.timeStamp);
mousedown = true;
}, false);
@@ -192,7 +198,7 @@ function test_domsnapping() {
var frag = document.createDocumentFragment();
for (var row = 0, rl = content.clientHeight / size; row < rl; row++) {
for (var cell = 0, cl = content.clientWidth / size; cell < cl; cell++) {
- elem = document.createElement("div");
+ var elem = document.createElement("div");
elem.className = "cell";
elem.style.backgroundColor = row % 2 + cell % 2 > 0 ? "#ddd" : "";
elem.innerHTML = row + "," + cell;
@@ -209,14 +215,14 @@ function test_domsnapping() {
scroller.setSnapSize(100, 100);
if ('ontouchstart' in window) {
container.addEventListener("touchstart", function (e) {
- if (e.target.tagName.match(/input|textarea|select/i)) {
+ if ((e.target).tagName.match(/input|textarea|select/i)) {
return;
}
- scroller.doTouchStart(e.touches, e.timeStamp);
+ scroller.doTouchStart((e).touches, e.timeStamp);
e.preventDefault();
}, false);
document.addEventListener("touchmove", function (e) {
- scroller.doTouchMove(e.touches, e.timeStamp);
+ scroller.doTouchMove((e).touches, e.timeStamp);
}, false);
document.addEventListener("touchend", function (e) {
scroller.doTouchEnd(e.timeStamp);
@@ -224,12 +230,12 @@ function test_domsnapping() {
} else {
var mousedown = false;
container.addEventListener("mousedown", function (e) {
- if (e.target.tagName.match(/input|textarea|select/i)) {
+ if ((e.target).tagName.match(/input|textarea|select/i)) {
return;
}
scroller.doTouchStart([{
- pageX: e.pageX,
- pageY: e.pageY
+ pageX: (e).pageX,
+ pageY: (e).pageY
}], e.timeStamp);
mousedown = true;
}, false);
@@ -238,8 +244,8 @@ function test_domsnapping() {
return;
}
scroller.doTouchMove([{
- pageX: e.pageX,
- pageY: e.pageY
+ pageX: (e).pageX,
+ pageY: (e).pageY
}], e.timeStamp);
mousedown = true;
}, false);
diff --git a/sinon/sinon-1.5.d.ts b/sinon/sinon-1.5.d.ts
new file mode 100644
index 0000000000..07c4926508
--- /dev/null
+++ b/sinon/sinon-1.5.d.ts
@@ -0,0 +1,390 @@
+// Type definitions for Sinon 1.5
+// Project: http://sinonjs.org/
+// Definitions by: William Sears
+// DefinitelyTyped: https://github.com/borisyankov/DefinitelyTyped
+
+interface SinonSpyCallApi {
+ // Properties
+ thisValue: any;
+ args: any[];
+ exception: any;
+ returnValue: any;
+
+ // Methods
+ calledOn(obj: any): bool;
+ calledWith(...args: any[]): bool;
+ calledWithExactly(...args: any[]): bool;
+ calledWithMatch(...args: SinonMatcher[]): bool;
+ notCalledWith(...args: any[]): bool;
+ notCalledWithMatch(...args: SinonMatcher[]): bool;
+ returned(value: any): bool;
+ threw(): bool;
+ threw(type: string): bool;
+ threw(obj: any): bool;
+ callArg(pos: number): void;
+ callArgOn(pos: number, obj: any, ...args: any[]): void;
+ callArgWith(pos: number, ...args: any[]): void;
+ callArgOnWith(pos: number, obj: any, ...args: any[]): void;
+ yield(...args: any[]): void;
+ yieldOn(obj: any, ...args: any[]): void;
+ yieldTo(property: string, ...args: any[]): void;
+ yieldToOn(property: string, obj: any, ...args: any[]): void;
+}
+
+interface SinonSpyCall extends SinonSpyCallApi {
+ calledBefore(call: SinonSpyCall): bool;
+ calledAfter(call: SinonSpyCall): bool;
+ calledWithNew(call: SinonSpyCall): bool;
+}
+
+interface SinonSpy extends SinonSpyCallApi {
+ // Properties
+ callCount: number;
+ called: bool;
+ notCalled: bool;
+ calledOnce: bool;
+ calledTwice: bool;
+ calledThrice: bool;
+ firstCall: SinonSpyCall;
+ secondCall: SinonSpyCall;
+ thirdCall: SinonSpyCall;
+ lastCall: SinonSpyCall;
+ thisValues: any[];
+ args: any[][];
+ exceptions: any[];
+ returnValues: any[];
+
+ // Methods
+ (...args: any[]): any;
+ calledBefore(anotherSpy: SinonSpy): bool;
+ calledAfter(anotherSpy: SinonSpy): bool;
+ calledWithNew(spy: SinonSpy): bool;
+ withArgs(...args: any[]): void;
+ alwaysCalledOn(obj: any);
+ alwaysCalledWith(...args: any[]);
+ alwaysCalledWithExactly(...args: any[]);
+ alwaysCalledWithMatch(...args: SinonMatcher[]);
+ neverCalledWith(...args: any[]);
+ neverCalledWithMatch(...args: SinonMatcher[]);
+ alwaysThrew(): bool;
+ alwaysThrew(type: string);
+ alwaysThrew(obj: any);
+ alwaysReturned(): bool;
+ invokeCallback(...args: any[]): void;
+ getCall(n: number): SinonSpyCall;
+ reset(): void;
+ printf(format: string, ...args: any[]);
+ restore(): void;
+}
+
+interface SinonSpyStatic {
+ (): SinonSpy;
+ (func: any): SinonSpy;
+ (obj: any, method: string): SinonSpy;
+}
+
+interface SinonStatic {
+ spy: SinonSpyStatic;
+}
+
+interface SinonStub extends SinonSpy {
+ resetBehavior(): void;
+ returns(obj: any): SinonStub;
+ returnsArg(index: number): SinonStub;
+ throws(type?: string): SinonStub;
+ throws(obj: any): SinonStub;
+ callsArg(index: number): SinonStub;
+ callsArgOn(index: number, context: any): SinonStub;
+ callsArgWith(index: number, ...args: any[]): SinonStub;
+ callsArgOnWith(index: number, context: any, ...args: any[]): SinonStub;
+ callsArgAsync(index: number): SinonStub;
+ callsArgOnAsync(index: number, context: any): SinonStub;
+ callsArgWithAsync(index: number, ...args: any[]): SinonStub;
+ callsArgOnWithAsync(index: number, context: any, ...args: any[]): SinonStub;
+ yields(...args: any[]): SinonStub;
+ yieldsOn(context: any, ...args: any[]): SinonStub;
+ yieldsTo(property: string, ...args: any[]): SinonStub;
+ yieldsToOn(property: string, context: any, ...args: any[]): SinonStub;
+ yieldsAsync(...args: any[]): SinonStub;
+ yieldsOnAsync(context: any, ...args: any[]): SinonStub;
+ yieldsToAsync(property: string, ...args: any[]): SinonStub;
+ yieldsToOnAsync(property: string, context: any, ...args: any[]): SinonStub;
+}
+
+interface SinonStubStatic {
+ (): SinonStub;
+ (obj: any): SinonStub;
+ (obj: any, method: string): SinonStub;
+ (obj: any, method: string, func: any): SinonStub;
+}
+
+interface SinonStatic {
+ stub: SinonStubStatic;
+}
+
+interface SinonExpectation {
+ atLeast(n: number): SinonExpectation;
+ atMost(n: number): SinonExpectation;
+ never(): SinonExpectation;
+ once(): SinonExpectation;
+ twice(): SinonExpectation;
+ thrice(): SinonExpectation;
+ exactly(n: number): SinonExpectation;
+ withArgs(...args: any[]): SinonExpectation;
+ withExactArgs(...args: any[]): SinonExpectation;
+ on(obj: any): SinonExpectation;
+ verify(): SinonExpectation;
+ restore(): void;
+}
+
+interface SinonExpectationStatic {
+ create(methodName?: string): SinonExpectation;
+}
+
+interface SinonMock {
+ expects(method: string): SinonExpectation;
+ restore(): void;
+ verify(): void;
+}
+
+interface SinonMockStatic {
+ (): SinonExpectation;
+ (obj: any): SinonMock;
+}
+
+interface SinonStatic {
+ expectation: SinonExpectationStatic;
+ mock: SinonMockStatic;
+}
+
+interface SinonFakeTimers {
+ now: number;
+ create(now: number): SinonFakeTimers;
+ setTimeout(callback: (...args: any[]) => void , timeout: number, ...args: any[]): number;
+ clearTimeout(id: number): void;
+ setInterval(callback: (...args: any[]) => void , timeout: number, ...args: any[]): number;
+ clearInterval(id: number): void;
+ tick(ms: number): number;
+ reset(): void;
+ Date(): Date;
+ Date(year: number): Date;
+ Date(year: number, month: number): Date;
+ Date(year: number, month: number, day: number): Date;
+ Date(year: number, month: number, day: number, hour: number): Date;
+ Date(year: number, month: number, day: number, hour: number, minute: number): Date;
+ Date(year: number, month: number, day: number, hour: number, minute: number, second: number): Date;
+ Date(year: number, month: number, day: number, hour: number, minute: number, second: number, ms: number): Date;
+ restore(): void;
+}
+
+interface SinonFakeTimersStatic {
+ (): SinonFakeTimers;
+ (...timers: string[]): SinonFakeTimers;
+ (now: number, ...timers: string[]): SinonFakeTimers;
+}
+
+interface SinonStatic {
+ useFakeTimers: SinonFakeTimersStatic;
+ clock: SinonFakeTimers;
+}
+
+interface SinonFakeXMLHttpRequest {
+ // Properties
+ onCreate: (xhr: SinonFakeXMLHttpRequest) => void;
+ url: string;
+ method: string;
+ requestHeaders: any;
+ requestBody: string;
+ status: number;
+ statusText: string;
+ async: bool;
+ username: string;
+ password: string;
+ responseXML: Document;
+ getResponseHeader(header: string): string;
+ getAllResponseHeaders(): any;
+
+ // Methods
+ restore(): void;
+ useFilters: bool;
+ addFilter(filter: (method, url, async, username, password) => bool): void;
+ setResponseHeaders(headers: any): void;
+ setResponseBody(body: string): void;
+ respond(status: number, headers: any, body: string): void;
+ autoRespond(ms: number): void;
+}
+
+interface SinonFakeXMLHttpRequestStatic {
+ (): SinonFakeXMLHttpRequest;
+}
+
+interface SinonStatic {
+ useFakeXMLHttpRequest: SinonFakeXMLHttpRequestStatic;
+ FakeXMLHttpRequest: SinonFakeXMLHttpRequest;
+}
+
+interface SinonFakeServer {
+ // Properties
+ autoRespond: bool;
+ autoRespondAfter: number;
+ fakeHTTPMethods: bool;
+ getHTTPMethod: (request: SinonFakeXMLHttpRequest) => string;
+
+ // Methods
+ respondWith(body: string): void;
+ respondWith(response: any[]): void;
+ respondWith(fn: (SinonFakeXMLHttpRequest) => void ): void;
+ respondWith(url: string, body: string): void;
+ respondWith(url: string, response: any[]): void;
+ respondWith(url: string, fn: (SinonFakeXMLHttpRequest) => void ): void;
+ respondWith(method: string, url: string, body: string): void;
+ respondWith(method: string, url: string, response: any[]): void;
+ respondWith(method: string, url: string, fn: (SinonFakeXMLHttpRequest) => void ): void;
+ respondWith(url: RegExp, body: string): void;
+ respondWith(url: RegExp, response: any[]): void;
+ respondWith(url: RegExp, fn: (SinonFakeXMLHttpRequest) => void ): void;
+ respondWith(method: string, url: RegExp, body: string): void;
+ respondWith(method: string, url: RegExp, response: any[]): void;
+ respondWith(method: string, url: RegExp, fn: (SinonFakeXMLHttpRequest) => void ): void;
+ respond(): void;
+ restore(): void;
+}
+
+interface SinonFakeServerStatic {
+ create(): SinonFakeServer;
+}
+
+interface SinonStatic {
+ fakeServer: SinonFakeServerStatic;
+ fakeServerWithClock: SinonFakeServerStatic;
+}
+
+interface SinonExposeOptions {
+ prefix?: string;
+ includeFail?: bool;
+}
+
+interface SinonAssert {
+ // Properties
+ failException: string;
+ fail: (message?: string) => void; // Overridable
+ pass: (assertion: any) => void; // Overridable
+
+ // Methods
+ notCalled(spy: SinonSpy): void;
+ called(spy: SinonSpy): void;
+ calledOnce(spy: SinonSpy): void;
+ calledTwice(spy: SinonSpy): void;
+ calledThrice(spy: SinonSpy): void;
+ callCount(spy: SinonSpy, count: number): void;
+ callOrder(...spies: SinonSpy[]): void;
+ calledOn(spy: SinonSpy, obj: any): void;
+ alwaysCalledOn(spy: SinonSpy, obj: any): void;
+ calledWith(spy: SinonSpy, ...args: any[]): void;
+ alwaysCalledWith(spy: SinonSpy, ...args: any[]): void;
+ neverCalledWith(spy: SinonSpy, ...args: any[]): void;
+ calledWithExactly(spy: SinonSpy, ...args: any[]): void;
+ alwaysCalledWithExactly(spy: SinonSpy, ...args: any[]): void;
+ calledWithMatch(spy: SinonSpy, ...args: SinonMatcher[]): void;
+ alwaysCalledWithMatch(spy: SinonSpy, ...args: SinonMatcher[]): void;
+ neverCalledWithMatch(spy: SinonSpy, ...args: SinonMatcher[]): void;
+ threw(spy: SinonSpy): void;
+ threw(spy: SinonSpy, exception: string): void;
+ threw(spy: SinonSpy, exception: any): void;
+ alwaysThrew(spy: SinonSpy): void;
+ alwaysThrew(spy: SinonSpy, exception: string): void;
+ alwaysThrew(spy: SinonSpy, exception: any): void;
+ expose(obj: any, options?: SinonExposeOptions): void;
+}
+
+interface SinonStatic {
+ assert: SinonAssert;
+}
+
+interface SinonMatcher {
+ and(expr: SinonMatch): SinonMatcher;
+ or(expr: SinonMatch): SinonMatcher;
+}
+
+interface SinonMatch {
+ (value: number): SinonMatcher;
+ (value: string): SinonMatcher;
+ (expr: RegExp): SinonMatcher;
+ (obj: any): SinonMatcher;
+ (callback: (value: any) => bool): SinonMatcher;
+ any: SinonMatcher;
+ defined: SinonMatcher;
+ truthy: SinonMatcher;
+ falsy: SinonMatcher;
+ bool: SinonMatcher;
+ number: SinonMatcher;
+ string: SinonMatcher;
+ object: SinonMatcher;
+ func: SinonMatcher;
+ array: SinonMatcher;
+ regexp: SinonMatcher;
+ date: SinonMatcher;
+ same(obj: any): SinonMatcher;
+ typeOf(type: string): SinonMatcher;
+ instanceOf(type: any): SinonMatcher;
+ has(property: string, expect?: any): SinonMatcher;
+ hasOwn(property: string, expect?: any): SinonMatcher;
+}
+
+interface SinonStatic {
+ match: SinonMatch;
+}
+
+interface SinonSandboxConfig {
+ injectInto?: any;
+ properties?: string[];
+ useFakeTimers?: any;
+ useFakeServer?: any;
+}
+
+interface SinonSandbox {
+ clock: SinonFakeTimers;
+ requests: SinonFakeXMLHttpRequest;
+ server: SinonFakeServer;
+ spy(): SinonSpy;
+ stub(): SinonStub;
+ mock(): SinonMock;
+ useFakeTimers: SinonFakeTimers;
+ useFakeXMLHttpRequest: SinonFakeXMLHttpRequest;
+ restore(): void;
+}
+
+interface SinonSandboxStatic {
+ create(): SinonSandbox;
+ create(config: SinonSandboxConfig): SinonSandbox;
+}
+
+interface SinonStatic {
+ sandbox: SinonSandboxStatic;
+}
+
+interface SinonTestConfig {
+ injectIntoThis?: bool;
+ injectInto?: any;
+ properties?: string[];
+ useFakeTimers?: bool;
+ useFakeServer?: bool;
+}
+
+interface SinonTestWrapper extends SinonSandbox {
+ (...args: any[]): any;
+}
+
+interface SinonStatic {
+ config: SinonTestConfig;
+ test(fn: (...args: any[]) => any): SinonTestWrapper;
+ testCase(tests: any): any;
+}
+
+// Utility overridables
+interface SinonStatic {
+ format: (obj: any) => string;
+ log: (message: string) => void;
+}
+
+var sinon: SinonStatic;
diff --git a/sinon/sinon-tests.ts b/sinon/sinon-tests.ts
new file mode 100644
index 0000000000..8247e36b31
--- /dev/null
+++ b/sinon/sinon-tests.ts
@@ -0,0 +1,85 @@
+///
// Definitions: https://github.com/borisyankov/DefinitelyTyped
@@ -19,33 +19,95 @@ module createjs {
// methods
create(src: string): SoundInstance;
+ preload(src: string, instance: Object): void;
static generateCapabilities(): void;
static isSupported(): bool;
- register(src: string, instances: number): Object;
+ isPreloadStarted(src: string): bool;
+ register(src: string, instances: Number): Object;
+ setVolume(value: Number): bool;
+ getVolume(): Number;
+ setMute(isMuted: bool): Boolean;
+ toString(): string;
+
+ // Flash API
+ unregisterPreloadInstance(flashId: string): void;
+ unregisterSoundInstance(flashId: string): void;
+ flashLog(data: string): void;
+ handleSoundEvent(flashId: string, method: string): void;
+ handlePreloadEvent(flashId: string, method: string): void;
+ handleEvent(method: string): void;
+ handleErrorEvent(error: string): void;
}
export class HTMLAudioPlugin {
// properties
static capabilities: Object;
static MAX_INSTANCES: number;
+ static AUDIO_READY: string;
+ static AUDIO_ENDED: string;
+ static AUDIO_ERROR: string;
+ static AUDIO_STALLED: string;
+ capabilities:Object;
+ defaultNumChannels: number;
// methods
create(src: string): SoundInstance;
static generateCapabilities(): void;
static isSupported(): bool;
register(src: string, instances: number): Object;
+ isPreloadStarted(src: string): bool;
+ preload(src: string, instance: Object): void;
+ toString(): string;
+ }
+
+ export class WebAudioPlugin {
+ // properties
+ static capabilities: Object;
+ static MAX_INSTANCES: number;
+ static AUDIO_READY: string;
+ static AUDIO_ENDED: string;
+ static AUDIO_ERROR: string;
+ static AUDIO_STALLED: string;
+ arrayBuffers: ArrayBuffer[];
+ capabilities:Object;
+ defaultNumChannels: number;
+ dynamicsCompressorNode: Object;
+ gainNode: Object;
+ volume: number;
+ context: any;
+ WebAudioLoader(src: string, owner: Object): Function;
+
+ // methods
+ create(src: string): SoundInstance;
+ static generateCapabilities(): void;
+ static isSupported(): bool;
+ setVolume(value: Number): bool;
+ getVolume(): number;
+ register(src: string, instances: number): Object;
+ isPreloadStarted(src: string): bool;
+ preload(src: string, instance: Object): void;
+ isPreloadComplete(src : string): bool;
+ removeFromPreload(src: string);
+ setMute(value: number): bool;
+ toString(): string;
}
export class SoundInstance {
- constructor (src: string);
+ constructor (src: string, owner: string, flash: string);
// properties
muted: bool;
owner: HTMLAudioPlugin;
+ offset: number;
paused: bool;
+ delay: number;
+ pan: number;
+ duration: number;
playState: string;
+ delayTimeoutId: number;
src: string;
uniqueId: any; //HERE string or number
+ volume: number;
// methods
getDuration(): number;
@@ -62,15 +124,26 @@ module createjs {
stop(): bool;
// events
- onComplete: () => any;
- onLoop: () => any;
- onPlayFailed: () => any;
- onPlayInterrupted: () => any;
- onReady: () => any;
+ complete: () => any;
+ loop: () => any;
+ failed: () => any;
+ interrupted: () => any;
+ succeeded: () => any;
+ ready: () => any;
+
+ // EventDispatcher mixins
+ addEventListener(type: string, listener: (eventObj: Object) => bool): Function;
+ addEventListener(type: string, listener: (eventObj: Object) => bool): Object;
+ removeEventListener(type: string, listener: (eventObj: Function) => bool): void;
+ removeEventListener(type: string, listener: (eventObj: Object) => bool): void;
+ removeAllEventListeners(type: string): void;
+ dispatchEvent(eventObj: string, target: Object): bool;
+ dispatchEvent(eventObj: Object, target: Object): bool;
+ hasEventListener(type: string): bool;
}
- export class SoundJS {
+ export class Sound {
// properties
static activePlugin: Object;
static AUDIO_TIMEOUT: number;
@@ -85,23 +158,57 @@ module createjs {
static PLAY_INITED: string;
static PLAY_INTERRUPTED: string;
static PLAY_SUCCEEDED: string;
+ static SUPPORTED_EXTENSIONS: Array;
+ static EXTENSION_MAP: Object;
+ static defaultInterruptBehavior: string;
// methods
static checkPlugin(initializeDefault: bool): bool;
+ static createInstance(src: string): SoundInstance;
static getCapabilities(): Object;
static getCapability(key: string): any; //HERE can return string | number | bool
static getInstanceById(uniqueId: string): SoundInstance;
+ static getMute(): number;
static getMasterVolume(): number;
static getSrcFromId(value: string): string;
+ static getVolume(): number;
static isReady(): bool;
static pause(id: string): void;
- static play(value: string, interrupt?: string, delay?: number, offset?: number, loop?: number, volume?: number, pan?: number): SoundInstance;
+ static play(src: string, interrupt?: string, delay?: number, offset?: number, loop?: number, volume?: number, pan?: number): SoundInstance;
static registerPlugin(plugin: Object): bool;
static registerPlugins(plugins: Object[]): bool;
+ static registerSound(src: Object, id: string, data: Object, preload?: bool): Object;
+ static registerManifest(manifest: Array);
static resume(id: string): void;
static setMasterVolume(value: number): bool;
static setMute(isMuted: bool, id: string): bool;
static setVolume(value: number, id?: string): bool;
- static stop(id?: string): bool;
+ static stop(): bool;
+
+ // events
+ loadComplete: () => any;
+
+ // EventDispatcher mixins
+ addEventListener(type: string, listener: (eventObj: Object) => bool): Function;
+ addEventListener(type: string, listener: (eventObj: Object) => bool): Object;
+ removeEventListener(type: string, listener: (eventObj: Function) => bool): void;
+ removeEventListener(type: string, listener: (eventObj: Object) => bool): void;
+ removeAllEventListeners(type: string): void;
+ dispatchEvent(eventObj: string, target: Object): bool;
+ dispatchEvent(eventObj: Object, target: Object): bool;
+ hasEventListener(type: string): bool;
}
+
+ export class BrowserDetect {
+ // properties
+ static isFirefox: bool;
+ static isOpera: bool;
+ static isChrome: bool;
+ static isIOS: bool;
+ static isAndroid: bool;
+ static isBlackberry: bool;
+
+ // methods
+ static init();
+ }
}
diff --git a/state-machine/state-machine-tests.ts b/state-machine/state-machine-tests.ts
index c82259050e..98b6ccf7c5 100644
--- a/state-machine/state-machine-tests.ts
+++ b/state-machine/state-machine-tests.ts
@@ -1,6 +1,13 @@
///
+// Updated: 2013/01/25 by William Sears
-
-interface ErrorCallback {
+interface StateMachineErrorCallback {
(eventName?: string, from?: string, to?: string, args?: any[], errorCode?: number, errorMessage?: string, ex?: Error): void; // NB. errorCode? See: StateMachine.Error
}
-interface StateMachineEvent {
+interface StateMachineEventDef {
name: string;
from: string;
to: string;
}
+interface StateMachineEvent {
+ (...args: any[]): void;
+}
+
interface StateMachineConfig {
initial?: any; // string or { state: 'foo', event: 'setup', defer: true|false }
- events?: StateMachineEvent[];
+ events?: StateMachineEventDef[];
callbacks?: {
[s: string]: (event?: string, from?: string, to?: string, ...args: any[]) => any;
};
- target?: any;
- error?: ErrorCallback;
+ target?: StateMachine;
+ error?: StateMachineErrorCallback;
}
interface StateMachineStatic {
@@ -44,24 +48,34 @@ interface StateMachineStatic {
INVALID_CALLBACK: number; // = 300, caller provided callback function threw an exception
};
- create(config: StateMachineConfig, target?: any): StateMachine;
+ create(config: StateMachineConfig, target?: StateMachine): StateMachine;
+}
+
+interface StateMachineTransition {
+ (): void;
+ cancel(): void;
+}
+
+interface StateMachineIs {
+ (state: string): bool;
+}
+
+interface StateMachineCan {
+ (evt: string): bool;
}
interface StateMachine {
current: string;
- is(state: string): bool;
- can(event: StateMachineEvent): bool;
- cannot(event: StateMachineEvent): bool;
- error: ErrorCallback;
+ is: StateMachineIs;
+ can: StateMachineCan;
+ cannot: StateMachineCan;
+ error: StateMachineErrorCallback;
/* transition - only available when performing async state transitions; otherwise null. Can be a:
- [1] function without arguments (see: https://github.com/jakesgordon/javascript-state-machine#asynchronous-state-transitions)
- [2] property with a cancel function to cancel the ASYNC event. Example usages:
-
- [1] fsm.transition(); // called form async callback
+ [1] fsm.transition(); // called from async callback
[2] fsm.transition.cancel();
*/
- transition?: any;
+ transition: StateMachineTransition;
}
declare var StateMachine: StateMachineStatic;
\ No newline at end of file
diff --git a/storejs/storejs-tests.ts b/storejs/storejs-tests.ts
new file mode 100644
index 0000000000..06387a728d
--- /dev/null
+++ b/storejs/storejs-tests.ts
@@ -0,0 +1,23 @@
+// Tests for storagejs.d.ts
+/// at [index]. Negative values are also allowed.
- * @param str String to add.
- * @param index Index where str is added. Default = str.length
- * @returns String
- * @extra %insert% is provided as an alias, and is generally more readable when using an index.
- * @example
- *
- * 'schfifty'.add(' five') -> schfifty five
- * 'dopamine'.insert('e', 3) -> dopeamine
- * 'spelling eror'.insert('r', -3) -> spelling error
- *
- ***/
- add(str: string, index?: number): string;
- insert(str: string, index?: number): string;
-
- /***
- * @short Assigns variables to tokens in a string.
- * @method assign(, , ...)
- * @returns String
- * @extra If an object is passed, it's properties can be assigned using
- * the object's keys. If a non-object (string, number, etc.)
- * is passed it can be accessed by the argument number beginning
- * with 1 (as with regex tokens). Multiple objects can be passed
- * and will be merged together (original objects are unaffected).
- * @example
- *
- * 'Welcome, Mr. {name}.'.assign({ name: 'Franklin' }) -> 'Welcome, Mr. Franklin.'
- * 'You are {1} years old today.'.assign(14) -> 'You are 14 years old today.'
- * '{n} and {r}'.assign({ n: 'Cheech' }, { r: 'Chong' }) -> 'Cheech and Chong'
- *
- ***/
- assign(str: string): string;
- assign(strs: string[]): string;
- assign(num: number): string;
- assign(nums: number[]): string;
- assign(obj: { }): string;
- assign(...objs: { }[]): string;
-
- /***
- * @short Gets the character(s) at a given index.
- * @method at(, [loop] = true)
- * @param index Index of the character.
- * @param loop Default = true
- * @returns String or String[]
- * @extra When [loop] is true, overshooting the end of the string
- * (or the beginning) will begin counting from the other end.
- * As an alternate syntax, passing multiple indexes will get
- * the characters at those indexes.
- * @example
- *
- * 'jumpy'.at(0) -> 'j'
- * 'jumpy'.at(2) -> 'm'
- * 'jumpy'.at(5) -> 'j'
- * 'jumpy'.at(5, false) -> ''
- * 'jumpy'.at(-1) -> 'y'
- * 'lucky charms'.at(2,4,6,8) -> ['u','k','y',c']
- *
- ***/
- at(index: number, loop?: bool): string;
- at(indexes: number[], loop?: bool): string[];
-
- /***
- * @short Converts underscores and hyphens to camel case.
- * If [first] is true the first letter will also be capitalized.
- * @method camelize([first] = true)
- * @param first Default = true
- * @returns String
- * @extra If the Inflections package is included acryonyms can also
- * be defined that will be used when camelizing.
- * @example
- *
- * 'caps_lock'.camelize() -> 'CapsLock'
- * 'moz-border-radius'.camelize() -> 'MozBorderRadius'
- * 'moz-border-radius'.camelize(false) -> 'mozBorderRadius'
- *
- ***/
- camelize(first?: bool): string;
-
- /***
- * @short Capitalizes the first character in the string.
- * @method capitalize([all] = false)
- * @param all Default = false
- * @returns String
- * @extra If [all] is true, all words in the string will be capitalized.
- * @example
- *
- * 'hello'.capitalize() -> 'Hello'
- * 'hello kitty'.capitalize() -> 'Hello kitty'
- * 'hello kitty'.capitalize(true) -> 'Hello Kitty'
- *
- ***/
- capitalize(all: bool): string;
-
- /***
- * @short Runs callback [fn] against each character in the string.
- * Returns an array of characters.
- * @method chars([fn])
- * @param fn Callback function.
- * @returns String[]
- * @example
- *
- * 'jumpy'.chars() -> ['j','u','m','p','y']
- * 'jumpy'.chars(function(c) {
- * // Called 5 times: "j","u","m","p","y"
- * });
- *
- ***/
- chars(fn?: Function): string[];
-
- /***
- * @short Runs callback [fn] against each character code in the string.
- Returns an array of character codes.
- * @method codes([fn])
- * @param fn Callback function.
- * @returns number[]
- * @example
- *
- * 'jumpy'.codes() -> [106,117,109,112,121]
- * 'jumpy'.codes(function(c) {
- * // Called 5 times: 106, 117, 109, 112, 121
- * });
- *
- ***/
- codes(fn?: Function): number[];
-
- /***
- * @short Compacts all white space in the string to
- * a single space and trims the ends.
- * @method compact()
- * @returns String
- * @example
- *
- * 'too \n much \n space'.compact() -> 'too much space'
- * 'enough \n '.compact() -> 'enought'
- *
- ***/
- compact(): string;
-
- /***
- * @short Converts underscores and camel casing to hypens.
- * @method dasherize()
- * @returns String
- * @example
- *
- * 'a_farewell_to_arms'.dasherize() -> 'a-farewell-to-arms'
- * 'capsLock'.dasherize() -> 'caps-lock'
- *
- ***/
- dasherize(): string;
-
- /***
- * @short Decodes the string from base64 encoding.
- * @method decodeBase64()
- * @returns String
- * @extra This method wraps the browser native %atob% when available,
- and uses a custom implementation when not available.
- * @example
- *
- * 'aHR0cDovL3R3aXR0ZXIuY29tLw=='.decodeBase64() -> 'http://twitter.com/'
- * 'anVzdCBnb3QgZGVjb2RlZA=='.decodeBase64() -> 'just got decoded!'
- *
- ***/
- decodeBase64(): string;
-
- /***
- * @short Runs callback [fn] against each occurence of [search].
- * @method each([search] = single character, [fn])
- * @returns Array
- * @extra Returns an array of matches. [search] may be either
- * a string or regex, and defaults to every character in the string.
- * @example
- *
- * 'jumpy'.each() -> ['j','u','m','p','y']
- * 'jumpy'.each(/[r-z]/) -> ['u','y']
- * 'jumpy'.each(/[r-z]/, function(m) {
- * // Called twice: "u", "y"
- * });
- *
- ***/
- each(): string[];
- each(search: string, fn?: Function): string[];
- each(search: RegExp, fn?: Function): string[];
- each(search: Function): string[];
-
- /***
- * @short Encodes the string into base64 encoding.
- * @method encodeBase64()
- * @returns String
- * @extra This method wraps the browser native %btoa% when available,
- * and uses a custom implementation when not available.
- * @example
- *
- * 'gonna get encoded!'.encodeBase64() -> 'Z29ubmEgZ2V0IGVuY29kZWQh'
- * 'http://twitter.com/'.encodeBase64() -> 'aHR0cDovL3R3aXR0ZXIuY29tLw=='
- *
- ***/
- encodeBase64(): string;
-
- /***
- * @short Returns true if the string ends with .
- * @method endsWith(, [case] = true)
- * @returns Boolean
- * @extra may be either a string or regex. Case
- * sensitive if [case] is true.
- * @example
- *
- * 'jumpy'.endsWith('py') -> true
- * 'jumpy'.endsWith(/[q-z]/) -> true
- * 'jumpy'.endsWith('MPY') -> false
- * 'jumpy'.endsWith('MPY', false) -> true
- *
- ***/
- endsWith(find: string, case_?: bool): bool;
- endsWith(find: RegExp, case_?: bool): bool;
-
- /***
- * @short Converts HTML characters to their entity equivalents.
- * @method escapeHTML()
- * @returns String
- * @example
- *
- * '.
- * @method has()
- * @returns Boolean
- * @extra may be a string or regex.
- * @example
- *
- * 'jumpy'.has('py') -> true
- * 'broken'.has(/[a-n]/) -> true
- * 'broken'.has(/[s-z]/) -> false
- *
- ***/
- has(find: string): bool;
- has(find: RegExp): bool;
-
- /***
- * @short Returns true if the string contains any characters in that script.
- * @method has[Script]()
- * @returns Boolean
- *
- * @set
- * hasArabic
- * hasCyrillic
- * hasGreek
- * hasHangul
- * hasHan
- * hasKanji
- * hasHebrew
- * hasHiragana
- * hasKana
- * hasKatakana
- * hasLatin
- * hasThai
- * hasDevanagari
- *
- * @example
- *
- * 'أتكلم'.hasArabic() -> true
- * 'визит'.hasCyrillic() -> true
- * '잘 먹겠습니다!'.hasHangul() -> true
- * 'ミックスです'.hasKatakana() -> true
- * "l'année".hasLatin() -> true
- *
- ***/
- hasArabic(): bool;
- hasCyrillic(): bool;
- hasGreek(): bool;
- hasHangul(): bool;
- hasHan(): bool;
- hasKanji(): bool;
- hasHebrew(): bool;
- hasHiragana(): bool;
- hasKana(): bool;
- hasKatakana(): bool;
- hasLatin(): bool;
- hasThai(): bool;
- hasDevanagari(): bool;
-
- /***
- * @method hiragana([all] = true)
- * @returns String
- * @short Converts katakana into hiragana.
- * @extra If [all] is false, only full-width katakana will be converted.
- * @example
- *
- * 'カタカナ'.hiragana() -> 'かたかな'
- * 'コンニチハ'.hiragana() -> 'こんにちは'
- * 'ｶﾀｶﾅ'.hiragana() -> 'かたかな'
- * 'ｶﾀｶﾅ'.hiragana(false) -> 'ｶﾀｶﾅ'
- *
- ***/
- hiragana(all?: bool): string;
-
- /***
- * @method humanize()
- * @returns String
- * @short Creates a human readable string.
- * @extra Capitalizes the first word and turns underscores into spaces and strips a trailing '_id', if any. Like String#titleize, this is meant for creating pretty output.
- * @example
- *
- * 'employee_salary'.humanize() -> 'Employee salary'
- * 'author_id'.humanize() -> 'Author'
- *
- ***/
- humanize(): string;
-
- /***
- * @short Returns true if the string has a length of 0 or contains only whitespace.
- * @method isBlank()
- * @returns Boolean
- * @example
- *
- * ''.isBlank() -> true
- * ' '.isBlank() -> true
- * 'noway'.isBlank() -> false
- *
- ***/
- isBlank(): bool;
-
- /***
- * @short Returns true if the string contains only characters in that script. Whitespace is ignored.
- * @method is[Script]()
- * @returns Boolean
- *
- * @set
- * isArabic
- * isCyrillic
- * isGreek
- * isHangul
- * isHan
- * isKanji
- * isHebrew
- * isHiragana
- * isKana
- * isKatakana
- * isKatakana
- * isThai
- * isDevanagari
- *
- * @example
- *
- * 'أتكلم'.isArabic() -> true
- * 'визит'.isCyrillic() -> true
- * '잘 먹겠습니다!'.isHangul() -> true
- * 'ミックスです'.isKatakana() -> false
- * "l'année".isLatin() -> true
- *
- ***/
- isArabic(): bool;
- isCyrillic(): bool;
- isGreek(): bool;
- isHangul(): bool;
- isHan(): bool;
- isKanji(): bool;
- isHebrew(): bool;
- isHiragana(): bool;
- isKana(): bool;
- isKatakana(): bool;
- isLatin(): bool;
- isThai(): bool;
- isDevanagari(): bool;
-
- /***
- * @short Converts hiragana into katakana.
- * @method katakana()
- * @returns String
- * @example
- *
- * 'かたかな'.katakana() -> 'カタカナ'
- * 'こんにちは'.katakana() -> 'コンニチハ'
- *
- ***/
- katakana(): string;
-
- /***
- * @short Returns the last [n] characters of the string.
- * @method last([n] = 1)
- * @returns String
- * @example
- *
- * 'lucky charms'.last() -> 's'
- * 'lucky charms'.last(3) -> 'rms'
- *
- ***/
- last(n?: number): string;
-
- /***
- * @short Runs callback [fn] against each line in the string.
- * Returns an array of lines.
- * @method lines([fn])
- * @returns Array
- * @example
- *
- * 'broken wear\nand\njumpy jump'.lines() -> ['broken wear','and','jumpy jump']
- * 'broken wear\nand\njumpy jump'.lines(function(l) {
- * // Called three times: "broken wear", "and", "jumpy jump"
- * });
- *
- ***/
- lines(fn?: Function): string[];
-
- /***
- * @short Finds the namespace or property indicated by the string.
- * @method namespace([init] = global)
- * @returns Mixed
- * @extra [init] can be passed to provide a starting context,
- * otherwise the global context will be used. If any
- * level returns a falsy value, that will be the final result.
- * @example
- *
- * 'Path.To.Namespace'.namespace() -> Path.To.Namespace
- * '$.fn'.namespace() -> $.fn
- *
- ***/
- namespace(init?: any): any;
-
- /***
- * @short Returns the string with accented and non-standard Latin-based
- * characters converted into ASCII approximate equivalents.
- * @method normalize()
- * @returns String
- * @example
- *
- * 'á'.normalize() -> 'a'
- * 'Ménage à trois'.normalize() -> 'Menage a trois'
- * 'Volkswagen'.normalize() -> 'Volkswagen'
- * 'ＦＵＬＬＷＩＤＴＨ'.normalize() -> 'FULLWIDTH'
- *
- ***/
- normalize(): string;
-
- /***
- * @short Pads either/both sides of the string.
- * @method pad[Side]( = '', [num] = 1)
- * @returns String
- * @extra [num] is the number of characters on each side,
- * and [padding] is the character to pad with.
- *
- * @set
- * pad
- * padLeft
- * padRight
- *
- * @example
- *
- * 'wasabi'.pad('-') -> '-wasabi-'
- * 'wasabi'.pad('-', 2) -> '--wasabi--'
- * 'wasabi'.padLeft('-', 2) -> '--wasabi'
- * 'wasabi'.padRight('-', 2) -> 'wasabi--'
- *
- ***/
- pad(padding: string, num?: number): string;
- padLeft(padding: string, num?: number): string;
- padRight(padding: string, num?: number): string;
-
- /***
- * @short Runs callback [fn] against each paragraph in the string.
- * Returns an array of paragraphs.
- * @method paragraphs([fn])
- * @returns Array
- * @extra A paragraph here is defined as a block of text bounded
- * by two or more line breaks.
- * @example
- *
- * 'Once upon a time.\n\nIn the land of oz...'.paragraphs() -> ['Once upon a time.','In the land of oz...']
- * 'Once upon a time.\n\nIn the land of oz...'.paragraphs(function(p) {
- * // Called twice: "Once upon a time.", "In teh land of oz..."
- * });
- *
- ***/
- paragraphs(fn?: Function): string[];
-
- /***
- * @short Replaces special characters in a string so that it may
- * be used as part of a pretty URL.
- * @method parameterize()
- * @returns String
- * @example
- *
- * 'hell, no!'.parameterize() -> 'hell-no'
- *
- ***/
- parameterize(): string;
-
- /***
- * @short Returns the plural form of the word in the string.
- * @method pluralize()
- * @returns String
- * @example
- *
- * 'post'.pluralize() -> 'posts'
- * 'octopus'.pluralize() -> 'octopi'
- * 'sheep'.pluralize() -> 'sheep'
- * 'words'.pluralize() -> 'words'
- * 'CamelOctopus'.pluralize() -> 'CamelOctopi'
- *
- ***/
- pluralize(): string;
-
- /***
- * @short Removes any part of the string that matches .
- * @method remove()
- * @returns String
- * @extra can be a string or a regex.
- * @example
- *
- * 'schfifty five'.remove('f') -> 'schity ive'
- * 'schfifty five'.remove(/[a-f]/g) -> 'shity iv'
- *
- ***/
- remove(find: string): string;
- remove(find: RegExp): string;
-
- /***
- * @short Removes all HTML tags and their contents from the string.
- * @method removeTags([tag1], [tag2], ...)
- * @returns String
- * @extra Tags to remove may be enumerated in the parameters,
- * otherwise will remove all.
- * @example
- *
- * ' places in the character map.
- * @method shift()
- * @returns Array
- * @example
- *
- * 'a'.shift(1) -> 'b'
- * 'ク'.shift(1) -> 'グ'
- *
- ***/
- shift(num: number): string[];
-
- /***
- * @short The reverse of String#pluralize.
- * Returns the singular form of a word in a string.
- * @method singularize()
- * @returns String
- * @example
- *
- * 'posts'.singularize() -> 'post'
- * 'octopi'.singularize() -> 'octopus'
- * 'sheep'.singularize() -> 'sheep'
- * 'word'.singularize() -> 'word'
- * 'CamelOctopi'.singularize() -> 'CamelOctopus'
- *
- ***/
- singularize(): string;
-
- /***
- * @short Converts camel case, underscores, and hyphens to a properly spaced string.
- * @method spacify()
- * @returns String
- * @example
- *
- * 'camelCase'.spacify() -> 'camel case'
- * 'an-ugly-string'.spacify() -> 'an ugly string'
- * 'oh-no_youDid-not'.spacify().capitalize(true) -> 'something else'
- *
- ***/
- spacify(): string;
-
- /***
- * @short Returns true if the string starts with .
- * @method startsWith(, [case] = true)
- * @returns Boolean
- * @extra may be either a string or regex.
- * Case sensitive if [case] is true.
- * @example
- *
- * 'hello'.startsWith('hell') -> true
- * 'hello'.startsWith(/[a-h]/) -> true
- * 'hello'.startsWith('HELL') -> false
- * 'hello'.startsWith('HELL', false) -> true
- *
- ***/
- startsWith(find: string, case_?: bool): bool;
- startsWith(find: RegExp, case_?: bool): bool;
-
- /***
- * @short Strips all HTML tags from the string.
- * @method stripTags([tag1], [tag2], ...)
- * @returns String
- * @extra Tags to strip may be enumerated in the parameters,
- * otherwise will strip all.
- * @example
- *
- * ', [split] = true, [from] = 'right', [ellipsis] = '...')
- * @returns Object
- * @extra If [split] is %false%, will not split words up, and instead
- * discard the word where the truncation occurred. [from] can
- * also be %"middle"% or %"left"%.
- * @example
- *
- * 'just sittin on the dock of the bay'.truncate(20) -> 'just sittin on the do...'
- * 'just sittin on the dock of the bay'.truncate(20, false) -> 'just sittin on the...'
- * 'just sittin on the dock of the bay'.truncate(20, true, 'middle') -> 'just sitt...of the bay'
- * 'just sittin on the dock of the bay'.truncate(20, true, 'left') -> '...the dock of the bay'
- *
- ***/
- truncate(length: number, split?: bool, from?: string, ellipsis?: string): string;
-
- /***
- * @short Converts hyphens and camel casing to underscores.
- * @method underscore()
- * @returns String
- * @example
- *
- * 'a-farewell-to-arms'.underscore() -> 'a_farewell_to_arms'
- * 'capsLock'.underscore() -> 'caps_lock'
- *
- ***/
- underscore(): string;
-
- /***
- * @short Restores escaped HTML characters.
- * @method unescapeHTML([partial] = false)
- * @returns String
- * @example
- *
- * '<p>some text</p>'.unescapeHTML() -> '.
- * @method ceil( = 0)
- * @returns Number
- *
- * @example
- *
- * (3.241).ceil() -> 4
- * (-3.241).ceil() -> -3
- * (3.241).ceil(2) -> 3.25
- * (3748).ceil(-2) -> 3800
- *
- ***/
- ceil(precision?: number): number;
-
- /***
- * @short Returns a string at the code point of the number.
- * @method chr()
- * @returns String
- * @example
- *
- * (65).chr() -> "A"
- * (75).chr() -> "K"
- *
- ***/
- chr(): string;
-
- /***
- * @short Returns an array containing numbers from the number down to .
- * @method downto(, [fn], [step] = 1)
- * @returns Array
- * @extra Optionally calls [fn] callback for each number in that array.
- * [step] allows multiples greater than 1.
- * @example
- *
- * (8).downto(3) -> [8, 7, 6, 5, 4, 3]
- * (8).downto(3, function(n) {
- * // This function is called 6 times receiving n as the value.
- * });
- * (8).downto(2, null, 2) -> [8, 6, 4, 2]
- *
- ***/
- downto(num: number, fn?: Function, step?: number): number[];
-
- /***
- * @short Takes the number as milliseconds and returns a unit-
- * adjusted localized string.
- * @method duration([locale] = currentLocale)
- * @returns String
- * @extra This method is the same as %Date#relative% without
- * the localized equivalent of "from now" or "ago".
- * [locale] can be passed as the first (and only) parameter.
- * Note that this method is only available when the dates
- * package is included.
- * @example
- *
- * (500).duration() -> '500 milliseconds'
- * (1200).duration() -> '1 second'
- * (75).minutes().duration() -> '1 hour'
- * (75).minutes().duration('es') -> '1 hora'
- *
- ***/
- duration(locale?: string): string;
-
- /***
- * @short Shortcut for %Math.floor% that also allows a .
- * @method floor( = 0)
- * @returns Number
- * @example
- *
- * (3.241).floor() -> 3
- * (-3.841).floor() -> -4
- * (3.241).floor(2) -> 3.24
- * (3748).floor(-2) -> 3700
- *
- ***/
- floor(precision?: number): number;
-
- /***
- * @short Formats the number to a readable string.
- * @method format([place] = 0, [thousands] = ',', [decimal] = '.')
- * @returns String
- * @extra If [place] is %undefined%, will automatically determine the place.
- * [thousands] is the character used for the thousands separator.
- * [decimal] is the character used for the decimal point.
- * @example
- *
- * (56782).format() -> '56,782'
- * (56782).format(2) -> '56,782.00'
- * (4388.43).format(2, ' ') -> '4 388.43'
- * (4388.43).format(2, '.', ',') -> '4.388,43'
- *
- ***/
- format(place?: number, thousands?: string, decimal?: string): string;
-
- /***
- * @short Converts the number to hexidecimal.
- * @method hex([pad] = 1)
- * @returns String
- * @extra [pad] will pad the resulting string to that many places.
- * @example
- *
- * (255).hex() -> 'ff';
- * (255).hex(4) -> '00ff';
- * (23654).hex() -> '5c66';
- *
- ***/
- hex(pad?: number): string;
-
- /***
- * @short Returns true if the number is even.
- * @method isEven()
- * @returns Boolean
- * @example
- *
- * (6).isEven() -> true
- * (17).isEven() -> false
- *
- ***/
- isEven(): bool;
-
- /***
- * @short Returns true if the number has no trailing decimal.
- * @method isInteger()
- * @returns Boolean
- * @example
- *
- * (420).isInteger() -> true
- * (4.5).isInteger() -> false
- *
- ***/
- isInteger(): bool;
-
- /***
- * @short Returns true if the number is a multiple of .
- * @method isMultipleOf()
- * @returns Boolean
- * @example
- *
- * (6).isMultipleOf(2) -> true
- * (17).isMultipleOf(2) -> false
- * (32).isMultipleOf(4) -> true
- * (34).isMultipleOf(4) -> false
- *
- ***/
- isMultipleOf(num: number): bool;
-
- /***
- * @short Returns true if the number is odd.
- * @method isOdd()
- * @returns Boolean
- * @example
- *
- * (3).isOdd() -> true
- * (18).isOdd() -> false
- *
- ***/
- isOdd(): bool;
-
- /***
- * @short Returns the logarithm of the number with base .
- * @method pad( = 0, [sign] = false, [base] = 10)
- * @returns String
- * @extra [sign] allows you to force the sign as well (+05, etc). [base] can change the base for numeral conversion.
- * @example
- *
- * (5).pad(2) -> '05'
- * (-5).pad(4) -> '-0005'
- * (82).pad(3, true) -> '+082'
- *
- ***/
- pad(place?: number, sign?: bool, base?: number): string;
-
- /***
- * @short Shortcut for %Math.round% that also allows a .
- * @method round( = 0)
- * @returns Number
- *
- * @example
- *
- * (3.241).round() -> 3
- * (-3.841).round() -> -4
- * (3.241).round(2) -> 3.24
- * (3748).round(-2) -> 3800
- *
- ***/
- round(precision?: number): number;
-
- /***
- * @short Calls a number of times equivalent to the number.
- * @method times()
- * @returns Number
- * @example
- *
- * (8).times(function(i) {
- * // This function is called 8 times.
- * });
- *
- ***/
- times(fn: Function): number;
-
- /***
- * @short Returns a number. This is mostly for compatibility reasons.
- * @method toNumber()
- * @returns Number
- * @example
- *
- * (420).toNumber() -> 420
- *
- ***/
- toNumber(): number;
-
- /***
- * @short Takes the number as a corresponding unit of time and
- * converts to milliseconds.
- * @method [unit]()
- * @returns Number
- * @extra Method names can be both singular and plural.
- * Note that as "a month" is ambiguous as a unit of time,
- * %months% will be equivalent to 30.4375 days, the average
- * number in a month. Be careful using %months% if you need
- * exact precision.
- *
- * @set
- * millisecond
- * milliseconds
- * second
- * seconds
- * minute
- * minutes
- * hour
- * hours
- * day
- * days
- * week
- * weeks
- * month
- * months
- * year
- * years
- *
- * @example
- *
- * (5).milliseconds() -> 5
- * (10).hours() -> 36000000
- * (1).day() -> 86400000
- *
- ***/
- millisecond(): number;
- milliseconds(): number;
- second(): number;
- seconds(): number;
- minute(): number;
- minutes(): number;
- hour(): number;
- hours(): number;
- day(): number;
- days(): number;
- week(): number;
- weeks(): number;
- month(): number;
- months(): number;
- year(): number;
- years(): number;
-
- /***
- * @short Returns a date units after [d], where is the number.
- * @method [unit]After([d], [locale] = currentLocale)
- * @returns Date
- * @extra [d] will accept a date object, timestamp, or text format.
- * Note that "months" is ambiguous as a unit of time. If the
- * target date falls on a day that does not exist
- * (ie. August 31 -> February 31), the date will be shifted
- * to the last day of the month. Be careful using %monthsAfter%
- * if you need exact precision. See @date_format for more.
- *
- * @set
- * millisecondAfter
- * millisecondsAfter
- * secondAfter
- * secondsAfter
- * minuteAfter
- * minutesAfter
- * hourAfter
- * hoursAfter
- * dayAfter
- * daysAfter
- * weekAfter
- * weeksAfter
- * monthAfter
- * monthsAfter
- * yearAfter
- * yearsAfter
- *
- * @example
- *
- * (5).daysAfter('tuesday') -> 5 days after tuesday of this week
- * (1).yearAfter('January 23, 1997') -> January 23, 1998
- *
- ***/
- millisecondAfter(d: string, locale?: string): Date;
- millisecondAfter(d: Date, locale?: string): Date;
- millisecondsAfter(d: string, locale?: string): Date;
- millisecondsAfter(d: Date, locale?: string): Date;
- secondAfter(d: string, locale?: string): Date;
- secondAfter(d: Date, locale?: string): Date;
- secondsAfter(d: string, locale?: string): Date;
- secondsAfter(d: Date, locale?: string): Date;
- minuteAfter(d: string, locale?: string): Date;
- minuteAfter(d: Date, locale?: string): Date;
- minutesAfter(d: string, locale?: string): Date;
- minutesAfter(d: Date, locale?: string): Date;
- hourAfter(d: string, locale?: string): Date;
- hourAfter(d: Date, locale?: string): Date;
- hoursAfter(d: string, locale?: string): Date;
- hoursAfter(d: Date, locale?: string): Date;
- dayAfter(d: string, locale?: string): Date;
- dayAfter(d: Date, locale?: string): Date;
- daysAfter(d: string, locale?: string): Date;
- daysAfter(d: Date, locale?: string): Date;
- weekAfter(d: string, locale?: string): Date;
- weekAfter(d: Date, locale?: string): Date;
- weeksAfter(d: string, locale?: string): Date;
- weeksAfter(d: Date, locale?: string): Date;
- monthAfter(d: string, locale?: string): Date;
- monthAfter(d: Date, locale?: string): Date;
- monthsAfter(d: string, locale?: string): Date;
- yearAfter(d: string, locale?: string): Date;
- yearAfter(d: Date, locale?: string): Date;
- yearsAfter(d: string, locale?: string): Date;
- yearsAfter(d: Date, locale?: string): Date;
-
- /***
- * @short Returns a date that is units ago.
- * @method [unit]Ago()
- * @returns Date
- * @extra Note that "months" is ambiguous as a unit of time.
- * If the target date falls on a day that does not exist
- * (ie. August 31 -> February 31), the date will be shifted
- * to the last day of the month. Be careful using %monthsAgo%
- * if you need exact precision.
- *
- * @set
- * millisecondAgo
- * millisecondsAgo
- * secondAgo
- * secondsAgo
- * minuteAgo
- * minutesAgo
- * hourAgo
- * hoursAgo
- * dayAgo
- * daysAgo
- * weekAgo
- * weeksAgo
- * monthAgo
- * monthsAgo
- * yearAgo
- * yearsAgo
- *
- * @example
- *
- * (5).weeksAgo() -> 5 weeks ago
- * (1).yearAgo() -> January 23, 1996
- *
- ***/
- millisecondAgo(): Date;
- millisecondsAgo(): Date;
- secondAgo(): Date;
- secondsAgo(): Date;
- minuteAgo(): Date;
- minutesAgo(): Date;
- hourAgo(): Date;
- hoursAgo(): Date;
- dayAgo(): Date;
- daysAgo(): Date;
- weekAgo(): Date;
- weeksAgo(): Date;
- monthAgo(): Date;
- monthsAgo(): Date;
- yearAgo(): Date;
- yearsAgo(): Date;
-
- /***
- * @short Returns a date that is units before [d], where is the number.
- * @method [unit]Before([d], [locale] = currentLocale)
- * @returns Date
- * @extra [d] will accept a date object, timestamp, or text format.
- * Note that "months" is ambiguous as a unit of time. If the
- * target date falls on a day that does not exist
- * (ie. August 31 -> February 31), the date will be shifted to
- * the last day of the month. Be careful using %monthsBefore%
- * if you need exact precision. See @date_format for more.
- *
- * @set
- * millisecondBefore
- * millisecondsBefore
- * secondBefore
- * secondsBefore
- * minuteBefore
- * minutesBefore
- * hourBefore
- * hoursBefore
- * dayBefore
- * daysBefore
- * weekBefore
- * weeksBefore
- * monthBefore
- * monthsBefore
- * yearBefore
- * yearsBefore
- *
- * @example
- *
- * (5).daysBefore('tuesday') -> 5 days before tuesday of this week
- * (1).yearBefore('January 23, 1997') -> January 23, 1996
- *
- ***/
- millisecondBefore(d: string, locale?: string): Date;
- millisecondBefore(d: Date, locale?: string): Date;
- millisecondsBefore(d: string, locale?: string): Date;
- millisecondsBefore(d: Date, locale?: string): Date;
- secondBefore(d: string, locale?: string): Date;
- secondBefore(d: Date, locale?: string): Date;
- secondsBefore(d: string, locale?: string): Date;
- secondsBefore(d: Date, locale?: string): Date;
- minuteBefore(d: string, locale?: string): Date;
- minuteBefore(d: Date, locale?: string): Date;
- minutesBefore(d: string, locale?: string): Date;
- minutesBefore(d: Date, locale?: string): Date;
- hourBefore(d: string, locale?: string): Date;
- hourBefore(d: Date, locale?: string): Date;
- hoursBefore(d: string, locale?: string): Date;
- hoursBefore(d: Date, locale?: string): Date;
- dayBefore(d: string, locale?: string): Date;
- dayBefore(d: Date, locale?: string): Date;
- daysBefore(d: string, locale?: string): Date;
- daysBefore(d: Date, locale?: string): Date;
- weekBefore(d: string, locale?: string): Date;
- weekBefore(d: Date, locale?: string): Date;
- weeksBefore(d: string, locale?: string): Date;
- weeksBefore(d: Date, locale?: string): Date;
- monthBefore(d: string, locale?: string): Date;
- monthBefore(d: Date, locale?: string): Date;
- monthsBefore(d: string, locale?: string): Date;
- monthsBefore(d: Date, locale?: string): Date;
- yearBefore(d: string, locale?: string): Date;
- yearBefore(d: Date, locale?: string): Date;
- yearsBefore(d: string, locale?: string): Date;
- yearsBefore(d: Date, locale?: string): Date;
-
- /***
- * @short Returns a date units from now.
- * @method [unit]FromNow()
- * @returns Date
- * @extra Note that "months" is ambiguous as a unit of time.
- * If the target date falls on a day that does not exist
- * (ie. August 31 -> February 31), the date will be shifted
- * to the last day of the month. Be careful using %monthsFromNow%
- * if you need exact precision.
- *
- * @set
- * millisecondFromNow
- * millisecondsFromNow
- * secondFromNow
- * secondsFromNow
- * minuteFromNow
- * minutesFromNow
- * hourFromNow
- * hoursFromNow
- * dayFromNow
- * daysFromNow
- * weekFromNow
- * weeksFromNow
- * monthFromNow
- * monthsFromNow
- * yearFromNow
- * yearsFromNow
- *
- * @example
- *
- * (5).weeksFromNow() -> 5 weeks ago
- * (1).yearFromNow() -> January 23, 1998
- *
- ***/
- millisecondFromNow(): Date;
- millisecondsFromNow(): Date;
- secondFromNow(): Date;
- secondsFromNow(): Date;
- minuteFromNow(): Date;
- minutesFromNow(): Date;
- hourFromNow(): Date;
- hoursFromNow(): Date;
- dayFromNow(): Date;
- daysFromNow(): Date;
- weekFromNow(): Date;
- weeksFromNow(): Date;
- monthFromNow(): Date;
- monthsFromNow(): Date;
- yearFromNow(): Date;
- yearsFromNow(): Date;
-
- /***
- * @short Returns an array containing numbers from the number up to .
- * @method upto(
" + this.src); + }, + after: function () { + $('#output').html("Scroll complete for:
" + this.src) + .append('
' + this.alt + '
'); + } +}); + +$('#s6').cycle({ + fx: 'scrollUp', + timeout: 6000, + delay: -2000 +}); + +$('#s7').cycle({ + fx: 'scrollRight', + delay: -1000 +}); + +/* Advanced Demos (Part 1) */ + +$('#s1').cycle({ + fx: 'zoom', + speedIn: 2500, + speedOut: 500, + easeIn: 'easeInBounce', + easeOut: 'easeOutElastic', + sync: false, + delay: -4000 +}); + +$('#s2').cycle({ + fx: 'scrollDown', + speedIn: 2000, + speedOut: 500, + easeIn: 'easeInCirc', + easeOut: 'easeOutBounce', + delay: -2000 +}); + +$('#s3').cycle({ + fx: 'custom', + cssBefore: { + left: 232, + top: -232, + display: 'block' + }, + animIn: { + left: 0, + top: 0 + }, + animOut: { + left: 232, + top: 232 + }, + delay: -3000 +}); + +$('#s4').cycle({ + fx: 'custom', + sync: false, + cssBefore: { + top: 0, + left: 232, + display: 'block' + }, + animIn: { + left: 0 + }, + animOut: { + top: 232 + }, + delay: -1000 +}); + +$('#s5').cycle({ + fx: 'custom', + cssBefore: { + left: 115, + top: 115, + width: 0, + height: 0, + opacity: 1, + display: 'block' + }, + animOut: { + opacity: 0 + }, + animIn: { + left: 0, + top: 0, + width: 200, + height: 200 + }, + cssAfter: { + zIndex: 0 + }, + delay: -3000 +}); + +$('#s6').cycle({ + fx: 'custom', + cssBefore: { + top: 0, + left: 0, + width: 0, + height: 0, + display: 'block' + }, + animIn: { + width: 200, + height: 200 + }, + animOut: { + top: 200, + left: 200, + width: 0, + height: 0 + }, + cssAfter: { + zIndex: 0 + }, + delay: -1000 +}); + +/* Advanced Demos (Part 2) */ + +$('#s6').cycle({ + fx: 'custom', + cssBefore: { + top: 0, + left: 0, + width: 0, + height: 0, + zIndex: 1 + }, + animIn: { + width: 200, + height: 200 + }, + animOut: { + top: 200, + left: 200, + width: 0, + height: 0 + }, + cssAfter: { + zIndex: 0 + } +}); + +$.fn.cycle.transitions.pinch = function ($cont, $slides, opts) { + var $el = $($slides[0]); + var w = $el.width(); + var h = $el.height(); + opts.cssBefore = { top: 0, left: 0, width: 0, height: 0, zIndex: 1 }; + opts.animIn = { width: w, height: h }; + opts.animOut = { top: h, left: w, width: 0, height: 0 }; + opts.cssAfter = { zIndex: 0 }; +}; + +$('#s1').cycle('pinch'); + +$('#s2').cycle({ + fx: 'pinch', + delay: 2000 +}); + +/* More Demos (from the more demos page) */ + +// Using multiple transition effects in a single slide slideshow +$('#slideshow2').cycle({ + fx: 'scrollLeft,scrollDown,scrollRight,scrollUp', + randomizeEffects: false, + easing: 'easeInBack' // easing supported via the easing plugin +}); + +// Another Advanced "pager" Demo +$('#slideshow').cycle({ + fx: 'turnDown', + speed: 'fast', + timeout: 0, + pager: '#nav', + pagerAnchorBuilder: function (idx, slide) { + // return selector string for existing anchor + return '#nav li:eq(' + idx + ') a'; + } +}); + +// Using the 'slideExpr' option +$('#slideshow').cycle({ slideExpr: 'img' }); + +// Defeating IE's ClearType bug +$('#slideshow').cycle({ + cleartype: false // disable cleartype corrections +}); + +// Using the 'nowrap' option (manual slideshow) +$('#s1').cycle({ + fx: 'scrollHorz', + prev: '#prev1', + next: '#next1', + nowrap: true, + timeout: 0 +}); + +// Using a continually transitioning slideshow (the 'continuous' option) +$('#slideshow').cycle({ + fx: 'shuffle', + continuous: true +}); \ No newline at end of file diff --git a/jquery.cycle/jquery.cycle.d.ts b/jquery.cycle/jquery.cycle.d.ts new file mode 100644 index 0000000000..db9f3a1a3b --- /dev/null +++ b/jquery.cycle/jquery.cycle.d.ts @@ -0,0 +1,93 @@ +// Type definitions for jQuery.cycle.js 2.9999.81 (15-JAN-2013) +// Project: http://jquery.malsup.com/cycle/ +// Definitions by: Franois GuillotMy new text
').appendTo('body'); $('Node Names:
" ); + $( "inner via inline binding: 2inner via external binding: 1
");
+
+ ko.bindingProvider.instance = originalBindingProvider;
+ });
+
+ it('Data binding syntax should support \'foreach\' option, whereby it renders for each item in an array but doesn\'t rerender everything if you push or splice', function () {
+ var myArray = new ko.observableArray([{ personName: "Bob" }, { personName: "Frank"}]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "The item is [js: personName]
" }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("the item is bob
the item is frank
");
+ var originalBobNode = testNode.childNodes[0].childNodes[0];
+ var originalFrankNode = testNode.childNodes[0].childNodes[1];
+
+ myArray.push({ personName: "Steve" });
+ expect(testNode.childNodes[0]).toContainHtml("the item is bob
the item is frank
the item is steve
");
+ expect(testNode.childNodes[0].childNodes[0]).toEqual(originalBobNode);
+ expect(testNode.childNodes[0].childNodes[1]).toEqual(originalFrankNode);
+ });
+
+ it('Data binding \'foreach\' option should apply bindings within the context of each item in the array', function () {
+ var myArray = new ko.observableArray([{ personName: "Bob" }, { personName: "Frank"}]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "The item is " }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("the item is bobthe item is frank");
+ });
+
+ it('Data binding \'foreach\' options should only bind each group of output nodes once', function() {
+ var initCalls = 0;
+ (original
");
+
+ // Now replace the entire array contents with one different entry.
+ // UI just shows "new" (previously with bug, showed "original" AND "new")
+ myArray(["new"]);
+ expect(testNode.childNodes[0]).toContainHtml("new
");
+ });
+
+ it('Data binding \'foreach\' should handle chained templates in which the very first node has a binding', function() {
+ // See https://github.com/SteveSanderson/knockout/pull/440 and https://github.com/SteveSanderson/knockout/pull/144
+ ko.setTemplateEngine(new dummyTemplateEngine({
+ outerTemplate: "[renderTemplate:innerTemplate]x", // [renderTemplate:...] is special syntax supported by dummy template engine
+ innerTemplate: "inner "
+ }));
+ testNode.innerHTML = "";
+
+ // Bind against initial array containing one entry.
+ var myArray = ko.observableArray(["original"]);
+ ko.applyBindings({ items: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("original
inner 123x");
+
+ // Now replace the entire array contents with one different entry.
+ myArray(["new"]);
+ expect(testNode.childNodes[0]).toContainHtml("new
inner 123x");
+ });
+
+ it('Data binding \'foreach\' should handle templates in which the very first node has a binding but it does not reference any observables', function() {
+ // Represents https://github.com/SteveSanderson/knockout/issues/739
+ // Previously, the rewriting (which introduces a comment node before the bound node) was interfering
+ // with the array-to-DOM-node mapping state tracking
+ ko.setTemplateEngine(new dummyTemplateEngine({ mytemplate: "[js:name()]
" }));
+ testNode.innerHTML = "";
+
+ // Bind against array, referencing an observable property
+ var myItem = { name: ko.observable("a") };
+ ko.applyBindings({ items: [myItem] }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("a
");
+
+ // Modify the observable property and check that UI is updated
+ // Previously with the bug, it wasn't updated because the removal of the memo comment caused the array-to-DOM-node computed to be disposed
+ myItem.name("b");
+ expect(testNode.childNodes[0]).toContainHtml("b
");
+ });
+
+ it('Data binding \'foreach\' option should apply bindings with an $index in the context', function () {
+ var myArray = new ko.observableArray([{ personName: "Bob" }, { personName: "Frank"}]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "The item # is " }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("the item # is 0the item # is 1");
+ });
+
+ it('Data binding \'foreach\' option should update bindings that reference an $index if the list changes', function () {
+ var myArray = new ko.observableArray([{ personName: "Bob" }, { personName: "Frank"}]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "The item is " }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("the item bobis 0the item frankis 1");
+
+ var frank = myArray.pop(); // remove frank
+ expect(testNode.childNodes[0]).toContainHtml("the item bobis 0");
+
+ myArray.unshift(frank); // put frank in the front
+ expect(testNode.childNodes[0]).toContainHtml("the item frankis 0the item bobis 1");
+
+ });
+
+ it('Data binding \'foreach\' option should accept array with "undefined" and "null" items', function () {
+ var myArray = new ko.observableArray([undefined, null]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "The item is " }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("the item is undefinedthe item is null");
+ });
+
+ it('Data binding \'foreach\' option should update DOM nodes when a dependency of their mapping function changes', function() {
+ var myObservable = new ko.observable("Steve");
+ var myArray = new ko.observableArray([{ personName: "Bob" }, { personName: myObservable }, { personName: "Another" }]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "The item is [js: ko.utils.unwrapObservable(personName)]
" }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("the item is bob
the item is steve
the item is another
");
+ var originalBobNode = testNode.childNodes[0].childNodes[0];
+
+ myObservable("Steve2");
+ expect(testNode.childNodes[0]).toContainHtml("the item is bob
the item is steve2
the item is another
");
+ expect(testNode.childNodes[0].childNodes[0]).toEqual(originalBobNode);
+
+ // Ensure we can still remove the corresponding nodes (even though they've changed), and that doing so causes the subscription to be disposed
+ expect(myObservable.getSubscriptionsCount()).toEqual(1);
+ myArray.splice(1, 1);
+ expect(testNode.childNodes[0]).toContainHtml("the item is bob
the item is another
");
+ myObservable("Something else"); // Re-evaluating the observable causes the orphaned subscriptions to be disposed
+ expect(myObservable.getSubscriptionsCount()).toEqual(0);
+ });
+
+ it('Data binding \'foreach\' option should treat a null parameter as meaning \'no items\'', function() {
+ var myArray = new ko.observableArray(["A", "B"]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "hello" }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(testNode.childNodes[0].childNodes.length).toEqual(2);
+
+ // Now set the observable to null and check it's treated like an empty array
+ // (because how else should null be interpreted?)
+ myArray(null);
+ expect(testNode.childNodes[0].childNodes.length).toEqual(0);
+ });
+
+ it('Data binding \'foreach\' option should accept an \"as\" option to define an alias for the iteration variable', function() {
+ // Note: There are more detailed specs (e.g., covering nesting) associated with the "foreach" binding which
+ // uses this templating functionality internally.
+ var myArray = new ko.observableArray(["A", "B"]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "[js:myAliasedItem]" }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainText("AB");
+ });
+
+ it('Data binding \'foreach\' option should stop tracking inner observables when the container node is removed', function() {
+ var innerObservable = ko.observable("some value");
+ var myArray = new ko.observableArray([{obsVal:innerObservable}, {obsVal:innerObservable}]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "The item is [js: ko.utils.unwrapObservable(obsVal)]" }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(innerObservable.getSubscriptionsCount()).toEqual(2);
+
+ ko.removeNode(testNode.childNodes[0]);
+ expect(innerObservable.getSubscriptionsCount()).toEqual(0);
+ });
+
+ it('Data binding \'foreach\' option should stop tracking inner observables related to each array item when that array item is removed', function() {
+ var innerObservable = ko.observable("some value");
+ var myArray = new ko.observableArray([{obsVal:innerObservable}, {obsVal:innerObservable}]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "The item is [js: ko.utils.unwrapObservable(obsVal)]" }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(innerObservable.getSubscriptionsCount()).toEqual(2);
+
+ myArray.splice(1, 1);
+ expect(innerObservable.getSubscriptionsCount()).toEqual(1);
+ myArray([]);
+ expect(innerObservable.getSubscriptionsCount()).toEqual(0);
+ });
+
+ it('Data binding syntax should omit any items whose \'_destroy\' flag is set (unwrapping the flag if it is observable)', function() {
+ var myArray = new ko.observableArray([{ someProp: 1 }, { someProp: 2, _destroy: 'evals to true' }, { someProp : 3 }, { someProp: 4, _destroy: ko.observable(false) }]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "someProp=[js: someProp]
" }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("someprop=1
someprop=3
someprop=4
");
+ });
+
+ it('Data binding syntax should include any items whose \'_destroy\' flag is set if you use includeDestroyed', function() {
+ var myArray = new ko.observableArray([{ someProp: 1 }, { someProp: 2, _destroy: 'evals to true' }, { someProp : 3 }]);
+ ko.setTemplateEngine(new dummyTemplateEngine({ itemTemplate: "someProp=[js: someProp]
" }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({ myCollection: myArray }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("someprop=1
someprop=2
someprop=3
");
+ });
+
+ it('Data binding syntax should support \"if\" condition', function() {
+ ko.setTemplateEngine(new dummyTemplateEngine({ myTemplate: "Value: [js: myProp().childProp]" }));
+ testNode.innerHTML = "";
+
+ var viewModel = { myProp: ko.observable({ childProp: 'abc' }) };
+ ko.applyBindings(viewModel, testNode);
+
+ // Initially there is a value
+ expect(testNode.childNodes[0]).toContainText("Value: abc");
+
+ // Causing the condition to become false causes the output to be removed
+ viewModel.myProp(null);
+ expect(testNode.childNodes[0]).toContainText("");
+
+ // Causing the condition to become true causes the output to reappear
+ viewModel.myProp({ childProp: 'def' });
+ expect(testNode.childNodes[0]).toContainText("Value: def");
+ });
+
+ it('Data binding syntax should support \"ifnot\" condition', function() {
+ ko.setTemplateEngine(new dummyTemplateEngine({ myTemplate: "Hello" }));
+ testNode.innerHTML = "";
+
+ var viewModel = { shouldHide: ko.observable(true) };
+ ko.applyBindings(viewModel, testNode);
+
+ // Initially there is no output (shouldHide=true)
+ expect(testNode.childNodes[0]).toContainText("");
+
+ // Causing the condition to become false causes the output to be displayed
+ viewModel.shouldHide(false);
+ expect(testNode.childNodes[0]).toContainText("Hello");
+
+ // Causing the condition to become true causes the output to disappear
+ viewModel.shouldHide(true);
+ expect(testNode.childNodes[0]).toContainText("");
+ });
+
+ it('Data binding syntax should support \"if\" condition in conjunction with foreach', function() {
+ ko.setTemplateEngine(new dummyTemplateEngine({ myTemplate: "Value: [js: myProp().childProp]" }));
+ testNode.innerHTML = "";
+
+ var viewModel = { myProp: ko.observable({ childProp: 'abc' }) };
+ ko.applyBindings(viewModel, testNode);
+ expect(testNode.childNodes[0].childNodes[0].nodeValue).toEqual("Value: abc");
+ expect(testNode.childNodes[0].childNodes[1].nodeValue).toEqual("Value: abc");
+ expect(testNode.childNodes[0].childNodes[2].nodeValue).toEqual("Value: abc");
+
+ // Causing the condition to become false causes the output to be removed
+ viewModel.myProp(null);
+ expect(testNode.childNodes[0]).toContainText("");
+
+ // Causing the condition to become true causes the output to reappear
+ viewModel.myProp({ childProp: 'def' });
+ expect(testNode.childNodes[0].childNodes[0].nodeValue).toEqual("Value: def");
+ expect(testNode.childNodes[0].childNodes[1].nodeValue).toEqual("Value: def");
+ expect(testNode.childNodes[0].childNodes[2].nodeValue).toEqual("Value: def");
+ });
+
+ it('Should be able to populate checkboxes from inside templates, despite IE6 limitations', function () {
+ ko.setTemplateEngine(new dummyTemplateEngine({ someTemplate: "" }));
+ ko.renderTemplate("someTemplate", null, { templateRenderingVariablesInScope: { isChecked: true } }, testNode);
+ expect(testNode.childNodes[0].checked).toEqual(true);
+ });
+
+ it('Should be able to populate radio buttons from inside templates, despite IE6 limitations', function () {
+ ko.setTemplateEngine(new dummyTemplateEngine({ someTemplate: "" }));
+ ko.renderTemplate("someTemplate", null, { templateRenderingVariablesInScope: { someValue: 'abc' } }, testNode);
+ expect(testNode.childNodes[0].checked).toEqual(true);
+ });
+
+ it('Should be able to render a different template for each array entry by passing a function as template name, with the array entry\'s binding context available as a second parameter', function() {
+ var myArray = new ko.observableArray([
+ { preferredTemplate: 1, someProperty: 'firstItemValue' },
+ { preferredTemplate: 2, someProperty: 'secondItemValue' }
+ ]);
+ ko.setTemplateEngine(new dummyTemplateEngine({
+ firstTemplate: "Template1Output, [js:someProperty]
",
+ secondTemplate: "Template2Output, [js:someProperty]
"
+ }));
+ testNode.innerHTML = "";
+
+ var getTemplate = function(dataItem, bindingContext) {
+ // Having the item's binding context available means you can read sibling or parent level properties
+ expect(bindingContext.$parent.anotherProperty).toEqual(123);
+
+ return dataItem.preferredTemplate == 1 ? 'firstTemplate' : 'secondTemplate';
+ };
+ ko.applyBindings({ myCollection: myArray, getTemplateModelProperty: getTemplate, anotherProperty: 123 }, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("template1output, firstitemvalue
template2output, seconditemvalue
");
+ });
+
+ it('Data binding \'templateOptions\' should be passed to template', function() {
+ var myModel = {
+ someAdditionalData: { myAdditionalProp: "someAdditionalValue" },
+ people: new ko.observableArray([
+ { name: "Alpha" },
+ { name: "Beta" }
+ ])
+ };
+ ko.setTemplateEngine(new dummyTemplateEngine({myTemplate: "Person [js:name] has additional property [js:templateOptions.myAdditionalProp]
"}));
+ testNode.innerHTML = "";
+
+ ko.applyBindings(myModel, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("person alpha has additional property someadditionalvalue
person beta has additional property someadditionalvalue
");
+ });
+
+ it('If the template binding is updated, should dispose any template subscriptions previously associated with the element', function() {
+ var myObservable = ko.observable("some value"),
+ myModel = {
+ subModel: ko.observable({ myObservable: myObservable })
+ };
+ ko.setTemplateEngine(new dummyTemplateEngine({myTemplate: "The value is [js:myObservable()]"}));
+ testNode.innerHTML = "";
+ ko.applyBindings(myModel, testNode);
+
+ // Right now the template references myObservable, so there should be exactly one subscription on it
+ expect(testNode.childNodes[0]).toContainText("The value is some value");
+ expect(myObservable.getSubscriptionsCount()).toEqual(1);
+ var renderedNode1 = testNode.childNodes[0].childNodes[0];
+
+ // By changing the object for subModel, we force the data-bind value to be re-evaluated and the template to be re-rendered,
+ // setting up a new template subscription, so there have now existed two subscriptions on myObservable...
+ myModel.subModel({ myObservable: myObservable });
+ expect(testNode.childNodes[0].childNodes[0]).not.toEqual(renderedNode1);
+
+ // ...but, because the old subscription should have been disposed automatically, there should only be one left
+ expect(myObservable.getSubscriptionsCount()).toEqual(1);
+ });
+
+ it('Should be able to specify a template engine instance using data-bind syntax', function() {
+ ko.setTemplateEngine(new dummyTemplateEngine({ theTemplate: "Default output" })); // Not going to use this one
+ var alternativeTemplateEngine = new dummyTemplateEngine({ theTemplate: "Alternative output" });
+
+ testNode.innerHTML = "";
+ ko.applyBindings({ chosenEngine: alternativeTemplateEngine }, testNode);
+
+ expect(testNode.childNodes[0]).toContainText("Alternative output");
+ });
+
+ it('Should be able to bind $data to an alias using \'as\'', function() {
+ ko.setTemplateEngine(new dummyTemplateEngine({
+ myTemplate: "ValueLiteral: [js:item.prop], ValueBound: "
+ }));
+ testNode.innerHTML = "";
+ ko.applyBindings({ someItem: { prop: 'Hello' } }, testNode);
+ expect(testNode.childNodes[0]).toContainText("ValueLiteral: Hello, ValueBound: Hello");
+ });
+
+ it('Data-bind syntax should expose parent binding context as $parent if binding with an explicit \"data\" value', function() {
+ ko.setTemplateEngine(new dummyTemplateEngine({
+ myTemplate: "ValueLiteral: [js:$parent.parentProp], ValueBound: "
+ }));
+ testNode.innerHTML = "";
+ ko.applyBindings({ someItem: {}, parentProp: 'Hello' }, testNode);
+ expect(testNode.childNodes[0]).toContainText("ValueLiteral: Hello, ValueBound: Hello");
+ });
+
+ it('Data-bind syntax should expose all ancestor binding contexts as $parents', function() {
+ ko.setTemplateEngine(new dummyTemplateEngine({
+ outerTemplate: "",
+ middleTemplate: "",
+ innerTemplate: "(Data:[js:$data.val], Parent:[[js:$parents[0].val]], Grandparent:[[js:$parents[1].val]], Root:[js:$root.val], Depth:[js:$parents.length])"
+ }));
+ testNode.innerHTML = "";
+
+ ko.applyBindings({
+ val: "ROOT",
+ outerItem: {
+ val: "OUTER",
+ middleItem: {
+ val: "MIDDLE",
+ innerItem: { val: "INNER" }
+ }
+ }
+ }, testNode);
+ expect(testNode.childNodes[0].childNodes[0]).toContainText("(Data:INNER, Parent:MIDDLE, Grandparent:OUTER, Root:ROOT, Depth:3)");
+ });
+
+ it('Should not be allowed to rewrite templates that embed anonymous templates', function() {
+ // The reason is that your template engine's native control flow and variable evaluation logic is going to run first, independently
+ // of any KO-native control flow, so variables would get evaluated in the wrong context. Example:
+ //
+ //
+ // ${ somePropertyOfEachArrayItem } <-- This gets evaluated *before* the foreach binds, so it can't reference array entries
+ //
+ //
+ // It should be perfectly OK to fix this just by preventing anonymous templates within rewritten templates, because
+ // (1) The developer can always use their template engine's native control flow syntax instead of the KO-native ones - that will work
+ // (2) The developer can use KO's native templating instead, if they are keen on KO-native control flow or anonymous templates
+
+ ko.setTemplateEngine(new dummyTemplateEngine({
+ myTemplate: "Childprop: [js: childProp]
"
+ }));
+ testNode.innerHTML = "";
+
+ var didThrow = false;
+ try {
+ ko.applyBindings({ someData: { childProp: 'abc' } }, testNode);
+ } catch(ex) {
+ didThrow = true;
+ expect(ex.message).toEqual("This template engine does not support anonymous templates nested within its templates");
+ }
+ expect(didThrow).toEqual(true);
+ });
+
+ it('Should not be allowed to rewrite templates that embed control flow bindings', function() {
+ // Same reason as above
+ ko.utils.arrayForEach(['if', 'ifnot', 'with', 'foreach'], function(bindingName) {
+ ko.setTemplateEngine(new dummyTemplateEngine({ myTemplate: "Hello
" }));
+ testNode.innerHTML = "";
+
+ var didThrow = false;
+ ko.utils.domData.clear(testNode);
+ try { ko.applyBindings({ someData: { childProp: 'abc' } }, testNode) }
+ catch (ex) {
+ didThrow = true;
+ expect(ex.message).toEqual("This template engine does not support the '" + bindingName + "' binding within its templates");
+ }
+ if (!didThrow)
+ throw new Error("Did not prevent use of " + bindingName);
+ });
+ });
+
+ it('Data binding syntax should permit nested templates using virtual containers (with arbitrary internal whitespace and newlines)', function() {
+ ko.setTemplateEngine(new dummyTemplateEngine({
+ outerTemplate: "Outer ",
+ innerTemplate: "Inner via inline binding: "
+ }));
+ var model = { };
+ testNode.innerHTML = "";
+ ko.applyBindings(model, testNode);
+ expect(testNode.childNodes[0]).toContainHtml("outer inner via inline binding: sometext");
+ });
+
+ it('Should be able to render anonymous templates using virtual containers', function() {
+ ko.setTemplateEngine(new dummyTemplateEngine());
+ testNode.innerHTML = "Start Childprop: [js: childProp] End";
+ ko.applyBindings({ someData: { childProp: 'abc' } }, testNode);
+ expect(testNode).toContainHtml("start childprop: abcend");
+ });
+
+ it('Should be able to use anonymous templates that contain first-child comment nodes', function() {
+ // This represents issue https://github.com/SteveSanderson/knockout/issues/188
+ // (IE < 9 strips out leading comment nodes when you use .innerHTML)
+ ko.setTemplateEngine(new dummyTemplateEngine({}));
+ testNode.innerHTML = "start hello
";
+ ko.applyBindings(null, testNode);
+ expect(testNode).toContainHtml('start hellohello
');
+ });
+
+ it('Should allow anonymous templates output to include top-level virtual elements, and will bind their virtual children only once', function() {
+ delete (";
+ ko.applyBindings(null, testNode);
+ expect(initCalls).toEqual(1);
+ });
+
+ it('Should not throw errors if trying to apply text to a non-rendered node', function() {
+ // Represents https://github.com/SteveSanderson/knockout/issues/660
+ // A can't go directly into a
{{firstName}} {{lastName}}
Blog: {{blogURL}}"; -var html = Mustache.to_html(template, person); \ No newline at end of file +var html = Mustache.to_html(template, person); + +var writer = Mustache.compile(template); +var writerOutput = writer(view); diff --git a/mustache/mustache.d.ts b/mustache/mustache.d.ts index 1bc1a6cdd2..c1be75afd7 100644 --- a/mustache/mustache.d.ts +++ b/mustache/mustache.d.ts @@ -24,6 +24,7 @@ interface MustacheContext { } interface MustacheWriter { + (view: any): string; clearCache(); compile(template: string, tags); compilePartial(name, template, tags); @@ -42,6 +43,7 @@ interface MustacheStatic { parse(template: string, tags); clearCache(): MustacheWriter; + compile(template: string): MustacheWriter; compile(template: string, tags): MustacheWriter; compilePartial(name: string, template: string, tags): MustacheWriter; compileTokens(tokens, template: string): MustacheWriter; diff --git a/noVNC/noVNC-tests.ts b/noVNC/noVNC-tests.ts new file mode 100644 index 0000000000..5d4eb579f9 --- /dev/null +++ b/noVNC/noVNC-tests.ts @@ -0,0 +1,32 @@ +///Hello to myself
Here\'s a nyan cat for you as an embedded attachment:
' + 'Device Cordova: ' + device.cordova + '
' + 'Device Platform: ' + device.platform + '
' + 'Device UUID: ' + device.uuid + '
' + - 'Device Version: ' + device.version + '
'; + 'Device Model: ' + device.model + '
' + + 'Device Version: ' + device.version + '
'; } function test_file() { @@ -421,6 +423,8 @@ function test_file() { } var onGetFileWin = function (parent) { var data = {}; + var metadataKey: any; + var metadataValue: any; data[metadataKey] = metadataValue; parent.setMetadata(onSetMetadataWin, onSetMetadataFail, data); } @@ -428,15 +432,18 @@ function test_file() { console.log("error getting file") } var onFSWin = function (fileSystem) { + var filePath = ''; fileSystem.root.getFile(filePath, { create: true, exclusive: false }, onGetFileWin, onGetFileFail); } var onFSFail = function (evt) { console.log(evt.target.error.code); } + var localFileSystem:any; window.requestFileSystem(localFileSystem, 0, onFSWin, onFSFail); + var success: any; var entry: FileEntry; - var parent = document.getElementById('parent').value, + var parent = (
some text
'.escapeHTML(); // - > '<p>some text</p>' +'one & two'.escapeHTML(); // - > 'one & two' + +'really?'.escapeRegExp(); // - > 'really\?' +'yes.'.escapeRegExp(); // - > 'yes\.' +'(not really)'.escapeRegExp(); // - > '\(not really\)' + +'http://foo.com/"bar"'.escapeURL(); // - > 'http://foo.com/%22bar%22' +'http://foo.com/"bar"'.escapeURL(true); // - > 'http%3A%2F%2Ffoo.com%2F%22bar%22' + +'lucky charms'.first(); // - > 'l' +'lucky charms'.first(3); // - > 'luc' + +'lucky charms'.from(); // - > 'lucky charms' +'lucky charms'.from(7); // - > 'harms' + +// visual studio is not liking these characters very much. +'??? YAMADA??!'.hankaku(); // - > '??? YAMADA??!' +'??? YAMADA??!'.hankaku('a'); // - > '??? YAMADA??!' +'??? YAMADA??!'.hankaku('alphabet'); // - > '??? YAMADA??!' +'?????! 25???!'.hankaku('katakana', 'numbers'); // - > '?????! 25???!' +'?????! 25???!'.hankaku('k', 'n'); // - > '?????! 25???!' +'?????! 25???!'.hankaku('kn'); // - > '?????! 25???!' +'?????! 25???!'.hankaku('sp'); // - > '?????! 25???!' + +'jumpy'.has('py'); // - > true +'broken'.has(/[a-n]/); // - > true +'broken'.has(/[s-z]/); // - > false + +// visual studio is not liking these characters very much. +'?????'.hasArabic(); // - > true +'?????'.hasCyrillic(); // - > true +'? ?????!'.hasHangul(); // - > true +'??????'.hasKatakana(); // - > true +"l'anne".hasLatin(); // - > true + +// visual studio is not liking these characters very much. +'????'.hiragana(); // - > '????' +'?????'.hiragana(); // - > '?????' +'????'.hiragana(); // - > '????' +'????'.hiragana(false); // - > '????' + +'employee_salary'.humanize(); // - > 'Employee salary' +'author_id'.humanize(); // - > 'Author' + +''.isBlank(); // - > true +' '.isBlank(); // - > true +'noway'.isBlank(); // - > false + +// visual studio is not liking these characters very much. +'?????'.isArabic(); // - > true +'?????'.isCyrillic(); // - > true +'? ?????!'.isHangul(); // - > true +'??????'.isKatakana(); // - > false +"l'anne".isLatin(); // - > true + +// visual studio is not liking these characters very much. +'????'.katakana(); // - > '????' +'?????'.katakana(); // - > '?????' + +'lucky charms'.last(); // - > 's' +'lucky charms'.last(3); // - > 'rms' + +'broken wear\nand\njumpy jump'.lines(); // - > ['broken wear', 'and', 'jumpy jump'] +'broken wear\nand\njumpy jump'.lines(function (l) { + // Called three times: "broken wear", "and", "jumpy jump" +}); + +''.normalize(); // - > 'a' +'Mnage trois'.normalize(); // - > 'Menage a trois' +'Volkswagen'.normalize(); // - > 'Volkswagen' +'FULLWIDTH'.normalize(); // - > 'FULLWIDTH' + +'wasabi'.pad('-'); // - > '-wasabi-' +'wasabi'.pad('-', 2); // - > '--wasabi--' +'wasabi'.padLeft('-', 2); // - > '--wasabi' +'wasabi'.padRight('-', 2); // - > 'wasabi--' + +'Once upon a time.\n\nIn the land of oz...'.paragraphs(); // - > ['Once upon a time.', 'In the land of oz...'] +'Once upon a time.\n\nIn the land of oz...'.paragraphs(function (p) { + // Called twice: "Once upon a time.", "In teh land of oz..." +}); + +'hell, no!'.parameterize(); // - > 'hell-no' + +'post'.pluralize(); // - > 'posts' +'octopus'.pluralize(); // - > 'octopi' +'sheep'.pluralize(); // - > 'sheep' +'words'.pluralize(); // - > 'words' +'CamelOctopus'.pluralize(); // - > 'CamelOctopi' + +'schfifty five'.remove('f'); // - > 'schity ive' +'schfifty five'.remove(/[a-f]/g); // - > 'shity iv' + +'just some text
'.removeTags(); // - > '' +'just some text
'.removeTags('b'); // - > 'just text
' + +'jumpy'.repeat(2); // - > 'jumpyjumpy' +'a'.repeat(5); // - > 'aaaaa' +'a'.repeat(0); // - > '' + +'jumpy'.reverse(); // - > 'ypmuj' +'lucky charms'.reverse(); // - > 'smrahc ykcul' + +'a'.shift(1); // - > 'b' +'?'.shift(1); //- > '?' + +'posts'.singularize(); // -> 'post' +'octopi'.singularize(); // -> 'octopus' +'sheep'.singularize(); // -> 'sheep' +'word'.singularize(); // -> 'word' +'CamelOctopi'.singularize(); // -> 'CamelOctopus' + +'camelCase'.spacify(); // - > 'camel case' +'an-ugly-string'.spacify(); // - > 'an ugly string' +'oh-no_youDid-not'.spacify().capitalize(true); // - > 'something else' + +'hello'.startsWith('hell'); // - > true +'hello'.startsWith(/[a-h]/); // - > true +'hello'.startsWith('HELL'); // - > false +'hello'.startsWith('HELL', false); // - > true + +'just some text
'.stripTags(); // - > 'just some text' +'just some text
'.stripTags('p'); // - > 'just some text' + +'man from the boondocks'.titleize(); // - > 'Man from the Boondocks' +'x-men: the last stand'.titleize(); // - > 'X Men: The Last Stand' +'TheManWithoutAPast'.titleize(); // - > 'The Man Without a Past' +'raiders_of_the_lost_ark'.titleize(); // - > 'Raiders of the Lost Ark' + +'lucky charms'.to(); // - > 'lucky charms' +'lucky charms'.to(7); // - > 'lucky ch' + +'153'.toNumber(); // - > 153 +'12,000'.toNumber(); // - > 12000 +'10px'.toNumber(); // - > 10 +'ff'.toNumber(16); // - > 255 + +' wasabi '.trim(); // - > 'wasabi' +' wasabi '.trimLeft(); // - > 'wasabi ' +' wasabi '.trimRight(); // - > ' wasabi' + +'just sittin on the dock of the bay'.truncate(20); // - > 'just sittin on the do...' +'just sittin on the dock of the bay'.truncate(20, false); // - > 'just sittin on the...' +'just sittin on the dock of the bay'.truncate(20, true, 'middle'); // - > 'just sitt...of the bay' +'just sittin on the dock of the bay'.truncate(20, true, 'left'); // - > '...the dock of the bay' + +'a-farewell-to-arms'.underscore(); // - > 'a_farewell_to_arms' +'capsLock'.underscore(); // - > 'caps_lock' + +'<p>some text</p>'.unescapeHTML(); // - > 'some text
' +'one & two'.unescapeHTML(); // - > 'one & two' + +'http%3A%2F%2Ffoo.com%2Fthe%20bar'.unescapeURL(); // - > 'http://foo.com/the bar' +'http%3A%2F%2Ffoo.com%2Fthe%20bar'.unescapeURL(true); // - > 'http%3A%2F%2Ffoo.com%2Fthe bar' + +'broken wear'.words(); // - > ['broken', 'wear'] +'broken wear'.words(function (w) { + // Called twice: "broken", "wear" +}); + +'??? YAMADA??!'.zenkaku(); // - > '??? YAMADA??!' +'??? YAMADA??!'.zenkaku('a'); // - > '??? YAMADA??!' +'??? YAMADA??!'.zenkaku('alphabet'); // - > '??? YAMADA??!' +'?????! 25???!'.zenkaku('katakana', 'numbers'); // - > '?????! 25???!' +'?????! 25???!'.zenkaku('k', 'n'); // - > '?????! 25???!' +'?????! 25???!'.zenkaku('kn'); // - > '?????! 25???!' +'?????! 25???!'.zenkaku('sp'); // - > '?????! 25???!' + +// static +//Number.random(50, 100); // - > ex.85 +//Number.random(50); // - > ex.27 +//Number.random(); // - > ex.0 + +(1000).abbr(); // - > "1k" +(1000000).abbr(); // - > "1m" +(1280).abbr(1); // - > "1.3k" + +(1000).bytes(); // - > "1kB" +(1000).bytes(2); // - > "0.98kB" +((10).pow(20)).bytes(); // - > "90,949,470TB" +((10).pow(20)).bytes(0, false); // - > "87EB" + +(1000).bytes(); // - > "1kB" +(1000).bytes(2); // - > "0.98kB" +((10).pow(20)).bytes(); // - > "90,949,470TB" +((10).pow(20)).bytes(0, false); // - > "87EB" + +(3.241).ceil(); // - > 4 +(-3.241).ceil(); // - > -3 +(3.241).ceil(2); // - > 3.25 +(3748).ceil(-2); // - > 3800 + +(65).chr(); // - > "A" +(75).chr(); // - > "K" + +(8).downto(3); // - > [8, 7, 6, 5, 4, 3] +(8).downto(3, function (n) { + // This function is called 6 times receiving n as the value. +}); +(8).downto(2, null, 2); // - > [8, 6, 4, 2] + +(500).duration(); // - > '500 milliseconds' +(1200).duration(); // - > '1 second' +(75).minutes().duration(); // - > '1 hour' +(75).minutes().duration('es'); // - > '1 hora' + +(3.241).floor(); // - > 3 +(-3.841).floor(); // - > -4 +(3.241).floor(2); // - > 3.24 +(3748).floor(-2); // - > 3700 + +(56782).format(); //- > '56,782' +(56782).format(2); // - > '56,782.00' +(4388.43).format(2, ' '); // - > '4 388.43' +(4388.43).format(2, '.', ','); // - > '4.388,43' + +(255).hex(); // - > 'ff'; +(255).hex(4); // - > '00ff'; +(23654).hex(); // - > '5c66'; + +(6).isEven(); // - > true +(17).isEven(); // - > false + +(420).isInteger(); // - > true +(4.5).isInteger(); // - > false + +(6).isMultipleOf(2); // - > true +(17).isMultipleOf(2); // - > false +(32).isMultipleOf(4); // - > true +(34).isMultipleOf(4); // - > false + +(3).isOdd(); // - > true +(18).isOdd(); // - > false + +(64).log(2); // - > 6 +(9).log(3); // - > 2 +(5).log(); // - > 1.6094379124341003 + +(3).pow(3); // - > 27 +(-3).abs(); // - > 3 +(1024).sqrt(); // - > 32 + +(1000).metric(); // - > "1k" +(1000000).metric(); // - > "1,000k" +(1000000).metric(0, false); // - > "1M" +(1249).metric(2) + 'g'; // - > "1.25kg" +(0.025).metric() + 'm'; // - > "25mm" + +(1).ordinalize(); // - > '1st' +(2).ordinalize(); // - > '2nd' +(8).ordinalize(); // - > '8th' + +(5).pad(2); // - > '05' +(-5).pad(4); // - > '-0005' +(82).pad(3, true); // - > '+082' + +(3.241).round(); // - > 3 +(-3.841).round(); // - > -4 +(3.241).round(2); // - > 3.24 +(3748).round(-2); // - > 3800 + +(8).times(function (i) { + // This function is called 8 times. +}); + +(420).toNumber(); // - > 420 + +(5).milliseconds(); // - > 5 +(10).hours(); // - > 36000000 +(1).day(); // - > 86400000 + +(5).daysAfter('tuesday'); // - > 5 days after tuesday of this week +(1).yearAfter('January 23, 1997'); // - > January 23, 1998 + +(5).weeksAgo(); // - > 5 weeks ago +(1).yearAgo(); // - > January 23, 1996 + +(5).daysBefore('tuesday'); // - > 5 days before tuesday of this week +(1).yearBefore('January 23, 1997'); // - > January 23, 1996 + +(5).weeksFromNow(); // - > 5 weeks ago +(1).yearFromNow(); // - > January 23, 1998 + +(2).upto(6); // - > [2, 3, 4, 5, 6] +(2).upto(6, function (n) { + // This function is called 5 times receiving n as the value. +}); +(2).upto(8, null, 2); // - > [2, 4, 6, 8] diff --git a/sugar/sugar.d.ts b/sugar/sugar.d.ts index a2291551dc..936c3121d6 100644 --- a/sugar/sugar.d.ts +++ b/sugar/sugar.d.ts @@ -1,4042 +1,4515 @@ -// sugar-1.3.6.d.ts -// (c) 2012 Josh Baldwin -// sugar.d.ts may be freely distributed under the MIT license. -// For all details and documentation: -// https://github.com/jbaldwin/sugar.d.ts - -interface String { - - /*** - * @short Addssome text
'.escapeHTML() -> '<p>some text</p>' - * 'one & two'.escapeHTML() -> 'one & two' - * - ***/ - escapeHTML(): string; - - /*** - * @short Escapes all RegExp tokens in the string. - * @method escapeRegExp() - * @returns String - * @example - * - * 'really?'.escapeRegExp() -> 'really\?' - * 'yes.'.escapeRegExp() -> 'yes\.' - * '(not really)'.escapeRegExp() -> '\(not really\)' - * - ***/ - escapeRegExp(): string; - - /*** - * @short Escapes characters in a string to make a valid URL. - * @method escapeURL([param] = false) - * @returns String - * @extra If [param] is true, it will also escape valid URL - * characters for use as a URL parameter. - * @example - * - * 'http://foo.com/"bar"'.escapeURL() -> 'http://foo.com/%22bar%22' - * 'http://foo.com/"bar"'.escapeURL(true) -> 'http%3A%2F%2Ffoo.com%2F%22bar%22' - * - ***/ - escapeURL(param?: bool): string; - - /*** - * @short Returns the first [n] characters of the string. - * @method first([n] = 1) - * @returns String - * @example - * - * 'lucky charms'.first() -> 'l' - * 'lucky charms'.first(3) -> 'luc' - * - ***/ - first(n?: number): string; - - /*** - * @short Returns a section of the string starting from [index]. - * @method from([index] = 0) - * @returns String - * @example - * - * 'lucky charms'.from() -> 'lucky charms' - * 'lucky charms'.from(7) -> 'harms' - * - ***/ - from(index?: number): string; - - /*** - * @short Converts full-width characters (zenkaku) to half-width (hankaku). - * @method hankaku([mode] = 'all') - * @returns String - * @extra [mode] accepts any combination of - * "a" (alphabet), - * "n" (numbers), - * "k" (katakana), - * "s" (spaces), - * "p" (punctuation), - * or "all". - * @example - * - * 'タロウ ＹＡＭＡＤＡです！'.hankaku() -> 'ﾀﾛｳ YAMADAです!' - * 'タロウ ＹＡＭＡＤＡです！'.hankaku('a') -> 'タロウ YAMADAです！' - * 'タロウ ＹＡＭＡＤＡです！'.hankaku('alphabet') -> 'タロウ YAMADAです！' - * 'タロウです！ ２５歳です！'.hankaku('katakana', 'numbers') -> 'ﾀﾛｳです！ 25歳です！' - * 'タロウです！ ２５歳です！'.hankaku('k', 'n') -> 'ﾀﾛｳです！ 25歳です！' - * 'タロウです！ ２５歳です！'.hankaku('kn') -> 'ﾀﾛｳです！ 25歳です！' - * 'タロウです！ ２５歳です！'.hankaku('sp') -> 'タロウです! ２５歳です!' - * - ***/ - hankaku(mode?: string): string; - - /*** - * @short Returns true if the string matchesjust some text
'.removeTags() -> '' - * 'just some text
'.removeTags('b') -> 'just text
' - * - ***/ - removeTags(): string; - removeTags(tag: string): string; - removeTags(...tags: string[]): string; - - /*** - * @short Returns the string repeated [num] times. - * @method repeat([num] = 0) - * @returns String - * @example - * - * 'jumpy'.repeat(2) -> 'jumpyjumpy' - * 'a'.repeat(5) -> 'aaaaa' - * 'a'.repeat(0) -> '' - * - ***/ - repeat(num?: number): string; - - /*** - * @short Reverses the string. - * @method reverse() - * @returns String - * @example - * - * 'jumpy'.reverse() -> 'ypmuj' - * 'lucky charms'.reverse() -> 'smrahc ykcul' - * - ***/ - reverse(): string; - - /*** - * @short Shifts each character in the stringjust some text
'.stripTags() -> 'just some text' - * 'just some text
'.stripTags('p') -> 'just some text' - * - ***/ - stripTags(): string; - stripTags(tag: string): string; - stripTags(...tags: string[]): string; - - /*** - * @short Creates a title version of the string. - * @method titleize() - * @returns String - * @extra Capitalizes all the words and replaces some characters - * in the string to create a nicer looking title. - * String#titleize is meant for creating pretty output. - * @example - * - * 'man from the boondocks'.titleize() -> 'Man from the Boondocks' - * 'x-men: the last stand'.titleize() -> 'X Men: The Last Stand' - * 'TheManWithoutAPast'.titleize() -> 'The Man Without a Past' - * 'raiders_of_the_lost_ark'.titleize() -> 'Raiders of the Lost Ark' - * - ***/ - titleize(): string; - - /*** - * @short Returns a section of the string ending at [index]. - * @method to([index] = end) - * @returns String - * @example - * - * 'lucky charms'.to() -> 'lucky charms' - * 'lucky charms'.to(7) -> 'lucky ch' - * - ***/ - to(index?: number): string; - - /*** - * @short Converts the string into a number. - * @method toNumber([base] = 10) - * @returns Number - * @extra Any value with a "." fill be converted to a floating point value, - * otherwise an integer. - * @example - * - * '153'.toNumber() -> 153 - * '12,000'.toNumber() -> 12000 - * '10px'.toNumber() -> 10 - * 'ff'.toNumber(16) -> 255 - * - ***/ - toNumber(base?: number): number; - - /*** - * @short Removes leading and/or trailing whitespace from the string. - * @method trim[Side]() - * @returns String - * @extra Whitespace is defined as line breaks, tabs, and any character - * in the "Space, Separator" Unicode category, conforming to the - * the ES5 spec. The standard %trim% method is only added when - * not fully supported natively. - * - * @set - * trim - * trimLeft - * trimRight - * - * @example - * - * ' wasabi '.trim() -> 'wasabi' - * ' wasabi '.trimLeft() -> 'wasabi ' - * ' wasabi '.trimRight() -> ' wasabi' - * - ***/ - // Duplicate from lib.d.ts - // trim(): string; - trimLeft(): string; - trimRight(): string; - - /*** - * @short Truncates a string. - * @method truncate(some text
' - * 'one & two'.unescapeHTML() -> 'one & two' - * - ***/ - unescapeHTML(partial?: bool): string; - - /*** - * @short Restores escaped characters in a URL escaped string. - * @method unescapeURL([partial] = false) - * @returns String - * @extra If [partial] is true, it will only unescape non-valid URL characters. [partial] is included here for completeness, but should very rarely be needed. - * @example - * - * 'http%3A%2F%2Ffoo.com%2Fthe%20bar'.unescapeURL() -> 'http://foo.com/the bar' - * 'http%3A%2F%2Ffoo.com%2Fthe%20bar'.unescapeURL(true) -> 'http%3A%2F%2Ffoo.com%2Fthe bar' - * - ***/ - unescapeURL(partial?: bool): string; - - /*** - * @short Runs callback [fn] against each word in the string. - * Returns an array of words. - * @method words([fn]) - * @returns String[] - * @extra A "word" here is defined as any sequence of non-whitespace characters. - * @example - * - * 'broken wear'.words() -> ['broken','wear'] - * 'broken wear'.words(function(w) { - * // Called twice: "broken", "wear" - * }); - * - ***/ - words(fn?: Function): string[]; - - /*** - * @short Converts half-width characters (hankaku) to full-width (zenkaku). - * @method zenkaku([mode] = 'all') - * @returns String - * @extra [mode] accepts any combination of - * "a" (alphabet), - * "n" (numbers), - * "k" (katakana), - * "s" (spaces), - * "p" (punctuation), - * or "all". - * @example - * - * 'ﾀﾛｳ YAMADAです!'.zenkaku() -> 'タロウ ＹＡＭＡＤＡです！' - * 'ﾀﾛｳ YAMADAです!'.zenkaku('a') -> 'ﾀﾛｳ ＹＡＭＡＤＡです!' - * 'ﾀﾛｳ YAMADAです!'.zenkaku('alphabet') -> 'ﾀﾛｳ ＹＡＭＡＤＡです!' - * 'ﾀﾛｳです! 25歳です!'.zenkaku('katakana', 'numbers') -> 'タロウです! ２５歳です!' - * 'ﾀﾛｳです! 25歳です!'.zenkaku('k', 'n') -> 'タロウです! ２５歳です!' - * 'ﾀﾛｳです! 25歳です!'.zenkaku('kn') -> 'タロウです! ２５歳です!' - * 'ﾀﾛｳです! 25歳です!'.zenkaku('sp') -> 'ﾀﾛｳです！ 25歳です！' - * - ***/ - zenkaku(mode?: string): string; -} - -interface Number { - - /*** - * @short Returns a random integer between [n1] and [n2]. - * @method Number.random([n1], [n2]) - * @returns Number - * @extra If only 1 number is passed, the other will be 0. If none are passed, the number will be either 0 or 1. - * @example - * - * Number.random(50, 100) -> ex. 85 - * Number.random(50) -> ex. 27 - * Number.random() -> ex. 0 - * - ***/ - random(n1?: number, n2?: number): number; - - /*** - * @short Returns an abbreviated form of the number. - * @method abbr([precision] = 0) - * @returns String - * @extra [precision] will round to the given precision. - * @example - * - * (1000).abbr() -> "1k" - * (1000000).abbr() -> "1m" - * (1280).abbr(1) -> "1.3k" - * - ***/ - abbr(precision?: number): string; - - /*** - * @short Returns an abbreviated form of the number, considered to be "Bytes". - * @method bytes([precision] = 0, [limit] = 4) - * @returns String - * @extra [precision] will round to the given precision. - * [limit] is the upper limit for the units. - * The default is %4%, which is "terabytes" (TB). - * If [limit] is %false%, the upper limit will be "exa". - * @example - * - * (1000).bytes() -> "1kB" - * (1000).bytes(2) -> "0.98kB" - * ((10).pow(20)).bytes() -> "90,949,470TB" - * ((10).pow(20)).bytes(0, false) -> "87EB" - * - ***/ - bytes(precision?: number, limit?: number): string; - bytes(precision?: number, limit?: bool): string; - - /*** - * @short Shortcut for %Math.ceil% that also allows a