/*
 * © Copyright 2004-2009 Apple Computer, Inc., Mozilla Foundation, and Opera Software ASA.
 * You are granted a license to use, reproduce and create derivative works of this document.
 *
 * See HTML 5 Draft Recommendation — 30 March 2009 for more details:
 * http://www.whatwg.org/specs/web-apps/current-work/
 */

#ifndef _HTML5_IDL_
#define _HTML5_IDL_

#include "w3c/dom.idl"
#include "w3c/events.idl"
#include "w3c/css.idl"
#include "w3c/ranges.idl"

module webstorage {
  interface Database;
  interface Storage;
};

module html5 {

  typedef dom::Node Node;
  typedef dom::Document Document;
  typedef dom::NodeList NodeList;
  typedef dom::Element Element;
  typedef dom::DOMStringList DOMStringList;
  typedef views::AbstractView AbstractView;
  typedef events::Event Event;
  typedef events::EventTarget EventTarget;
  typedef events::MouseEvent MouseEvent;
  typedef css::CSSStyleDeclaration CSSStyleDeclaration;
  typedef ranges::Range Range;
  typedef webstorage::Database Database;
  typedef webstorage::Storage Storage;

  typedef sequence<MessagePort> MessagePortArray;

  // XXX
  typedef any Date;

  interface HTMLCollection {
    readonly attribute unsigned long length;
    getter Element item(in unsigned long index);
    caller getter Element namedItem(in DOMString name);
  };

  interface HTMLFormControlsCollection {
    readonly attribute unsigned long length;
    getter HTMLElement item(in unsigned long index);
    caller getter object namedItem(in DOMString name);
  };

  interface HTMLOptionsCollection {
             attribute unsigned long length;
    getter HTMLOptionElement item(in unsigned long index);
    caller getter object namedItem(in DOMString name);
    void add(in HTMLElement element, in optional HTMLElement before);
    void add(in HTMLElement element, in long before);
    void remove(in long index);
  };

  interface DOMTokenList {
    stringifier;
    readonly attribute unsigned long length;
    getter DOMString item(in unsigned long index);
    boolean has(in DOMString token);
    void add(in DOMString token);
    void remove(in DOMString token);
    boolean toggle(in DOMString token);
  };

  [NameCreator, NameDeleter, NameGetter, NameSetter]
  interface DOMStringMap {};

  Document implements HTMLDocument;
  [NameGetter=OverrideBuiltins]
  interface HTMLDocument {
    // resource metadata management
    [PutForwards=href] readonly attribute Location location;
    readonly attribute DOMString URL;
             attribute DOMString domain;
    readonly attribute DOMString referrer;
             attribute DOMString cookie;
    readonly attribute DOMString lastModified;
    readonly attribute DOMString compatMode;
             attribute DOMString charset;
    readonly attribute DOMString characterSet;
    readonly attribute DOMString defaultCharset;
    readonly attribute DOMString readyState;

    // DOM tree accessors
             attribute DOMString title;
             attribute DOMString dir;
             attribute HTMLElement body;
    readonly attribute HTMLCollection images;
    readonly attribute HTMLCollection embeds;
    readonly attribute HTMLCollection plugins;
    readonly attribute HTMLCollection links;
    readonly attribute HTMLCollection forms;
    readonly attribute HTMLCollection anchors;
    readonly attribute HTMLCollection scripts;
    NodeList getElementsByName(in DOMString elementName);
    NodeList getElementsByClassName(in DOMString classNames);

    // dynamic markup insertion
             attribute DOMString innerHTML;
    HTMLDocument open(in optional DOMString type, in optional DOMString replace);
    WindowProxy open(in DOMString url, in DOMString name, in DOMString features, in optional boolean replace);
    void close();
    void write(in DOMString... text);
    void writeln(in DOMString... text);

    // user interaction
    Selection getSelection();
    readonly attribute Element activeElement;
    boolean hasFocus();
             attribute DOMString designMode;
    boolean execCommand(in DOMString commandId);
    boolean execCommand(in DOMString commandId, in boolean showUI);
    boolean execCommand(in DOMString commandId, in boolean showUI, in DOMString value);
    boolean queryCommandEnabled(in DOMString commandId);
    boolean queryCommandIndeterm(in DOMString commandId);
    boolean queryCommandState(in DOMString commandId);
    boolean queryCommandSupported(in DOMString commandId);
    DOMString queryCommandValue(in DOMString commandId);
    readonly attribute HTMLCollection commands;
  };

  interface HTMLElement : Element {
    // DOM tree accessors
    NodeList getElementsByClassName(in DOMString classNames);

    // dynamic markup insertion
             attribute DOMString innerHTML;
             attribute DOMString outerHTML;
    void insertAdjacentHTML(in DOMString position, in DOMString text);

    // metadata attributes
             attribute DOMString id;
             attribute DOMString title;
             attribute DOMString lang;
             attribute DOMString dir;
             attribute DOMString className;
    readonly attribute DOMTokenList classList;
    readonly attribute DOMStringMap dataset;

    // user interaction
             attribute boolean hidden;
    void click();
    void scrollIntoView();
    void scrollIntoView(in boolean top);
             attribute long tabIndex;
    void focus();
    void blur();
             attribute boolean draggable;
             attribute DOMString contentEditable;
    readonly attribute boolean isContentEditable;
             attribute HTMLMenuElement contextMenu;
             attribute boolean spellcheck;

    // styling
    readonly attribute CSSStyleDeclaration style;

    // event handler DOM attributes
             attribute Function onabort;
             attribute Function onblur;
             attribute Function onchange;
             attribute Function onclick;
             attribute Function oncontextmenu;
             attribute Function ondblclick;
             attribute Function ondrag;
             attribute Function ondragend;
             attribute Function ondragenter;
             attribute Function ondragleave;
             attribute Function ondragover;
             attribute Function ondragstart;
             attribute Function ondrop;
             attribute Function onerror;
             attribute Function onfocus;
             attribute Function onkeydown;
             attribute Function onkeypress;
             attribute Function onkeyup;
             attribute Function onload;
             attribute Function onmousedown;
             attribute Function onmousemove;
             attribute Function onmouseout;
             attribute Function onmouseover;
             attribute Function onmouseup;
             attribute Function onmousewheel;
             attribute Function onscroll;
             attribute Function onselect;
             attribute Function onsubmit;
  };

  interface HTMLBaseElement : HTMLElement {
             attribute DOMString href;
             attribute DOMString target;
  };

  interface HTMLLinkElement : HTMLElement {
             attribute boolean disabled;
             attribute DOMString href;
             attribute DOMString rel;
    readonly attribute DOMTokenList relList;
             attribute DOMString media;
             attribute DOMString hreflang;
             attribute DOMString type;
             attribute DOMString sizes;
  };

  interface HTMLMetaElement : HTMLElement {
             attribute DOMString content;
             attribute DOMString name;
             attribute DOMString httpEquiv;
  };

  interface HTMLStyleElement : HTMLElement {
             attribute boolean disabled;
             attribute DOMString media;
             attribute DOMString type;
             attribute boolean scoped;
  };

  interface HTMLScriptElement : HTMLElement {
             attribute DOMString src;
             attribute boolean async;
             attribute boolean defer;
             attribute DOMString type;
             attribute DOMString charset;
             attribute DOMString text;
  };

  interface HTMLBodyElement : HTMLElement {
             attribute Function onbeforeunload;
             // attribute Function onerror;     // XXX defined in HTMLDocument
             attribute Function onhashchange;
             // attribute Function onload;      // XXX defined in HTMLDocument
             attribute Function onmessage;
             attribute Function onoffline;
             attribute Function ononline;
             attribute Function onpopstate;
             attribute Function onresize;
             attribute Function onstorage;
             attribute Function onunload;
  };

  interface HTMLQuoteElement : HTMLElement {
             attribute DOMString cite;
  };

  interface HTMLOListElement : HTMLElement {
             attribute boolean reversed;
             attribute long start;
  };

  interface HTMLLIElement : HTMLElement {
             attribute long value;
  };

  interface HTMLAnchorElement : HTMLElement {
             stringifier attribute DOMString href;
             attribute DOMString target;
             attribute DOMString ping;
             attribute DOMString rel;
    readonly attribute DOMTokenList relList;
             attribute DOMString media;
             attribute DOMString hreflang;
             attribute DOMString type;
  };

  interface HTMLTimeElement : HTMLElement {
             attribute DOMString dateTime;
    readonly attribute Date date;
    readonly attribute Date time;
    readonly attribute Date timezone;
  };

  interface HTMLProgressElement : HTMLElement {
             attribute float value;
             attribute float max;
    readonly attribute float position;
  };

  interface HTMLMeterElement : HTMLElement {
             attribute float value;
             attribute float min;
             attribute float max;
             attribute float low;
             attribute float high;
             attribute float optimum;
  };

  interface HTMLModElement : HTMLElement {
             attribute DOMString cite;
             attribute DOMString dateTime;
  };

  [NamedConstructor=Image(),
   NamedConstructor=Image(in unsigned long width),
   NamedConstructor=Image(in unsigned long width, in unsigned long height)]
  interface HTMLImageElement : HTMLElement {
             attribute DOMString alt;
             attribute DOMString src;
             attribute DOMString useMap;
             attribute boolean isMap;
             attribute unsigned long width;
             attribute unsigned long height;
    readonly attribute boolean complete;
  };

  interface HTMLIFrameElement : HTMLElement {
             attribute DOMString src;
             attribute DOMString name;
             attribute DOMString sandbox;
             attribute boolean seamless;
             attribute DOMString width;
             attribute DOMString height;
  };

  interface HTMLEmbedElement : HTMLElement {
             attribute DOMString src;
             attribute DOMString type;
             attribute DOMString width;
             attribute DOMString height;
  };

  interface HTMLObjectElement : HTMLElement {
             attribute DOMString data;
             attribute DOMString type;
             attribute DOMString name;
             attribute DOMString useMap;
    readonly attribute HTMLFormElement form;
             attribute DOMString width;
             attribute DOMString height;
  };

  interface HTMLParamElement : HTMLElement {
             attribute DOMString name;
             attribute DOMString value;
  };

  interface HTMLSourceElement : HTMLElement {
             attribute DOMString src;
             attribute DOMString type;
             attribute DOMString media;
  };

  interface HTMLMediaElement : HTMLElement {

    // error state
    readonly attribute MediaError error;

    // network state
             attribute DOMString src;
    readonly attribute DOMString currentSrc;
    const unsigned short NETWORK_EMPTY = 0;
    const unsigned short NETWORK_IDLE = 1;
    const unsigned short NETWORK_LOADING = 2;
    const unsigned short NETWORK_LOADED = 3;
    const unsigned short NETWORK_NO_SOURCE = 4;
    readonly attribute unsigned short networkState;
             attribute boolean autobuffer;

    readonly attribute TimeRanges buffered;
    void load();
    DOMString canPlayType(in DOMString type);

    // ready state
    const unsigned short HAVE_NOTHING = 0;
    const unsigned short HAVE_METADATA = 1;
    const unsigned short HAVE_CURRENT_DATA = 2;
    const unsigned short HAVE_FUTURE_DATA = 3;
    const unsigned short HAVE_ENOUGH_DATA = 4;
    readonly attribute unsigned short readyState;
    readonly attribute boolean seeking;

    // playback state
             attribute float currentTime;
    readonly attribute float duration;
    readonly attribute boolean paused;
             attribute float defaultPlaybackRate;
             attribute float playbackRate;
    readonly attribute TimeRanges played;
    readonly attribute TimeRanges seekable;
    readonly attribute boolean ended;
             attribute boolean autoplay;
             attribute boolean loop;
    void play();
    void pause();

    // cue ranges
    void addCueRange(in DOMString className, in DOMString id, in float start, in float end, in boolean pauseOnExit, in CueRangeCallback enterCallback, in CueRangeCallback exitCallback);
    void removeCueRanges(in DOMString className);

    // controls
             attribute boolean controls;
             attribute float volume;
             attribute boolean muted;
  };

  interface HTMLVideoElement : HTMLMediaElement {
             attribute DOMString width;
             attribute DOMString height;
    readonly attribute unsigned long videoWidth;
    readonly attribute unsigned long videoHeight;
             attribute DOMString poster;
  };

  [NamedConstructor=Audio(),
   NamedConstructor=Audio(in DOMString src)]
  interface HTMLAudioElement : HTMLMediaElement {
    // no members
  };

  [Callback=FunctionOnly, NoInterfaceObject]
  interface CueRangeCallback {
    void handleEvent(in DOMString id);
  };

  interface MediaError {
    const unsigned short MEDIA_ERR_ABORTED = 1;
    const unsigned short MEDIA_ERR_NETWORK = 2;
    const unsigned short MEDIA_ERR_DECODE = 3;
    const unsigned short MEDIA_ERR_NONE_SUPPORTED = 4;
    readonly attribute unsigned short code;
  };

  interface TimeRanges {
    readonly attribute unsigned long length;
    float start(in unsigned long index);
    float end(in unsigned long index);
  };

  interface HTMLCanvasElement : HTMLElement {
             attribute unsigned long width;
             attribute unsigned long height;

    DOMString toDataURL(in optional DOMString type, in any... args);

    object getContext(in DOMString contextId);
  };

  interface CanvasRenderingContext2D {

    // back-reference to the canvas
    readonly attribute HTMLCanvasElement canvas;

    // state
    void save(); // push state on state stack
    void restore(); // pop state stack and restore state

    // transformations (default transform is the identity matrix)
    void scale(in float x, in float y);
    void rotate(in float angle);
    void translate(in float x, in float y);
    void transform(in float m11, in float m12, in float m21, in float m22, in float dx, in float dy);
    void setTransform(in float m11, in float m12, in float m21, in float m22, in float dx, in float dy);

    // compositing
             attribute float globalAlpha; // (default 1.0)
             attribute DOMString globalCompositeOperation; // (default source-over)

    // colors and styles
             attribute any strokeStyle; // (default black)
             attribute any fillStyle; // (default black)
    CanvasGradient createLinearGradient(in float x0, in float y0, in float x1, in float y1);
    CanvasGradient createRadialGradient(in float x0, in float y0, in float r0, in float x1, in float y1, in float r1);
    CanvasPattern createPattern(in HTMLImageElement image, in DOMString repetition);
    CanvasPattern createPattern(in HTMLCanvasElement image, in DOMString repetition);

    // line caps/joins
             attribute float lineWidth; // (default 1)
             attribute DOMString lineCap; // "butt", "round", "square" (default "butt")
             attribute DOMString lineJoin; // "round", "bevel", "miter" (default "miter")
             attribute float miterLimit; // (default 10)

    // shadows
             attribute float shadowOffsetX; // (default 0)
             attribute float shadowOffsetY; // (default 0)
             attribute float shadowBlur; // (default 0)
             attribute DOMString shadowColor; // (default transparent black)

    // rects
    void clearRect(in float x, in float y, in float w, in float h);
    void fillRect(in float x, in float y, in float w, in float h);
    void strokeRect(in float x, in float y, in float w, in float h);

    // path API
    void beginPath();
    void closePath();
    void moveTo(in float x, in float y);
    void lineTo(in float x, in float y);
    void quadraticCurveTo(in float cpx, in float cpy, in float x, in float y);
    void bezierCurveTo(in float cp1x, in float cp1y, in float cp2x, in float cp2y, in float x, in float y);
    void arcTo(in float x1, in float y1, in float x2, in float y2, in float radius);
    void rect(in float x, in float y, in float w, in float h);
    void arc(in float x, in float y, in float radius, in float startAngle, in float endAngle, in boolean anticlockwise);
    void fill();
    void stroke();
    void clip();
    boolean isPointInPath(in float x, in float y);

    // text
             attribute DOMString font; // (default 10px sans-serif)
             attribute DOMString textAlign; // "start", "end", "left", "right", "center" (default: "start")
             attribute DOMString textBaseline; // "top", "hanging", "middle", "alphabetic", "ideographic", "bottom" (default: "alphabetic")
    void fillText(in DOMString text, in float x, in float y, in optional float maxWidth);
    void strokeText(in DOMString text, in float x, in float y, in optional float maxWidth);
    TextMetrics measureText(in DOMString text);

    // drawing images
    void drawImage(in HTMLImageElement image, in float dx, in float dy, in optional float dw, in float dh);
    void drawImage(in HTMLImageElement image, in float sx, in float sy, in float sw, in float sh, in float dx, in float dy, in float dw, in float dh);
    void drawImage(in HTMLCanvasElement image, in float dx, in float dy, in optional float dw, in float dh);
    void drawImage(in HTMLCanvasElement image, in float sx, in float sy, in float sw, in float sh, in float dx, in float dy, in float dw, in float dh);
    void drawImage(in HTMLVideoElement image, in float dx, in float dy, in optional float dw, in float dh);
    void drawImage(in HTMLVideoElement image, in float sx, in float sy, in float sw, in float sh, in float dx, in float dy, in float dw, in float dh);

    // pixel manipulation
    ImageData createImageData(in float sw, in float sh);
    ImageData getImageData(in float sx, in float sy, in float sw, in float sh);
    void putImageData(in ImageData imagedata, in float dx, in float dy, in optional float dirtyX, in float dirtyY, in float dirtyWidth, in float dirtyHeight);
  };

  interface CanvasGradient {
    // opaque object
    void addColorStop(in float offset, in DOMString color);
  };

  interface CanvasPattern {
    // opaque object
  };

  interface TextMetrics {
    readonly attribute float width;
  };

  interface ImageData {
    readonly attribute unsigned long width;
    readonly attribute unsigned long height;
    readonly attribute CanvasPixelArray data;
  };

  [IndexGetter, IndexSetter]
  interface CanvasPixelArray {
    readonly attribute unsigned long length;
  };

  interface HTMLMapElement : HTMLElement {
             attribute DOMString name;
    readonly attribute HTMLCollection areas;
    readonly attribute HTMLCollection images;
  };

  interface HTMLAreaElement : HTMLElement {
             attribute DOMString alt;
             attribute DOMString coords;
             attribute DOMString shape;
             attribute DOMString href;
             attribute DOMString target;
             attribute DOMString ping;
             attribute DOMString rel;
    readonly attribute DOMTokenList relList;
             attribute DOMString media;
             attribute DOMString hreflang;
             attribute DOMString type;
  };

  interface HTMLTableElement : HTMLElement {
             attribute HTMLTableCaptionElement caption;
    HTMLElement createCaption();
    void deleteCaption();
             attribute HTMLTableSectionElement tHead;
    HTMLElement createTHead();
    void deleteTHead();
             attribute HTMLTableSectionElement tFoot;
    HTMLElement createTFoot();
    void deleteTFoot();
    readonly attribute HTMLCollection tBodies;
    HTMLElement createTBody();
    readonly attribute HTMLCollection rows;
    HTMLElement insertRow(in optional long index);
    void deleteRow(in long index);
  };

  interface HTMLTableCaptionElement : HTMLElement {
             attribute DOMString       align;
  };

  interface HTMLTableColElement : HTMLElement {
             attribute unsigned long span;
  };

  interface HTMLTableSectionElement : HTMLElement {
    readonly attribute HTMLCollection rows;
    HTMLElement insertRow(in optional long index);
    void deleteRow(in long index);
  };

  interface HTMLTableRowElement : HTMLElement {
    readonly attribute long rowIndex;
    readonly attribute long sectionRowIndex;
    readonly attribute HTMLCollection cells;
    HTMLElement insertCell(in optional long index);
    void deleteCell(in long index);
  };

  interface HTMLTableCellElement : HTMLElement {
             attribute long colSpan;
             attribute long rowSpan;
             attribute DOMString headers;
    readonly attribute long cellIndex;
  };

  interface HTMLTableDataCellElement : HTMLTableCellElement {};

  interface HTMLTableHeaderCellElement : HTMLTableCellElement {
             attribute DOMString scope;
  };

  interface HTMLFormElement : HTMLElement {
             attribute DOMString acceptCharset;
             attribute DOMString action;
             attribute boolean autocomplete;
             attribute DOMString enctype;
             attribute DOMString method;
             attribute DOMString name;
             attribute boolean novalidate;
             attribute DOMString target;

    readonly attribute HTMLFormControlsCollection elements;
    readonly attribute long length;
    getter any item(in unsigned long index);
    [OverrideBuiltins] caller getter any namedItem(in DOMString name);

    void submit();
    void reset();
    boolean checkValidity();

    void dispatchFormInput();
    void dispatchFormChange();
  };

  interface HTMLFieldSetElement : HTMLElement {
             attribute boolean disabled;
    readonly attribute HTMLFormElement form;
             attribute DOMString name;

    readonly attribute DOMString type;

    readonly attribute HTMLFormControlsCollection elements;

    readonly attribute boolean willValidate;
    readonly attribute ValidityState validity;
    readonly attribute DOMString validationMessage;
    boolean checkValidity();
    void setCustomValidity(in DOMString error);
  };

  interface HTMLLabelElement : HTMLElement {
    readonly attribute HTMLFormElement form;
             attribute DOMString htmlFor;
    readonly attribute HTMLElement control;
  };

  interface HTMLInputElement : HTMLElement {
             attribute DOMString accept;
             attribute DOMString alt;
             attribute boolean autocomplete;
             attribute boolean autofocus;
             attribute boolean defaultChecked;
             attribute boolean checked;
             attribute boolean disabled;
    readonly attribute HTMLFormElement form;
             attribute DOMString formAction;
             attribute DOMString formEnctype;
             attribute DOMString formMethod;
             attribute boolean formNoValidate;
             attribute DOMString formTarget;
             attribute DOMString height;
             attribute boolean indeterminate;
    readonly attribute HTMLElement list;
             attribute DOMString max;
             attribute long maxLength;
             attribute DOMString min;
             attribute boolean multiple;
             attribute DOMString name;
             attribute DOMString pattern;
             attribute DOMString placeholder;
             attribute boolean readOnly;
             attribute boolean required;
             attribute unsigned long size;
             attribute DOMString src;
             attribute DOMString step;
             attribute DOMString type;
             attribute DOMString defaultValue;
             attribute DOMString value;
             attribute Date valueAsDate;
             attribute float valueAsNumber;
    readonly attribute HTMLOptionElement selectedOption;
             attribute DOMString width;

    void stepUp(in long n);
    void stepDown(in long n);

    readonly attribute boolean willValidate;
    readonly attribute ValidityState validity;
    readonly attribute DOMString validationMessage;
    boolean checkValidity();
    void setCustomValidity(in DOMString error);

    readonly attribute NodeList labels;

    void select();
             attribute unsigned long selectionStart;
             attribute unsigned long selectionEnd;
    void setSelectionRange(in unsigned long start, in unsigned long end);
  };

  interface HTMLButtonElement : HTMLElement {
             attribute boolean autofocus;
             attribute boolean disabled;
    readonly attribute HTMLFormElement form;
             attribute DOMString formaction;
             attribute DOMString formenctype;
             attribute DOMString formmethod;
             attribute DOMString formnoValidate;
             attribute DOMString formtarget;
             attribute DOMString name;
             attribute DOMString type;
             attribute DOMString value;

    readonly attribute boolean willValidate;
    readonly attribute ValidityState validity;
    readonly attribute DOMString validationMessage;
    boolean checkValidity();
    void setCustomValidity(in DOMString error);

    readonly attribute NodeList labels;
  };

  interface HTMLSelectElement : HTMLElement {
             attribute boolean autofocus;
             attribute boolean disabled;
    readonly attribute HTMLFormElement form;
             attribute boolean multiple;
             attribute DOMString name;
             attribute boolean size;

    readonly attribute DOMString type;

    readonly attribute HTMLOptionsCollection options;
             attribute unsigned long length;
    getter any item(in unsigned long index);
    caller getter any namedItem(in DOMString name);
    void add(in HTMLElement element, in optional HTMLElement before);
    void add(in HTMLElement element, in long before);
    void remove(in long index);

    readonly attribute HTMLCollection selectedOptions;
             attribute long selectedIndex;
             attribute DOMString value;

    readonly attribute boolean willValidate;
    readonly attribute ValidityState validity;
    readonly attribute DOMString validationMessage;
    boolean checkValidity();
    void setCustomValidity(in DOMString error);

    readonly attribute NodeList labels;
  };

  interface HTMLDataListElement : HTMLElement {
    readonly attribute HTMLCollection options;
  };

  interface HTMLOptGroupElement : HTMLElement {
             attribute boolean disabled;
             attribute DOMString label;
  };

  [NamedConstructor=Option(),
   NamedConstructor=Option(in DOMString text),
   NamedConstructor=Option(in DOMString text, in DOMString value),
   NamedConstructor=Option(in DOMString text, in DOMString value, in boolean defaultSelected),
   NamedConstructor=Option(in DOMString text, in DOMString value, in boolean defaultSelected, in boolean selected)]
  interface HTMLOptionElement : HTMLElement {
             attribute boolean disabled;
    readonly attribute HTMLFormElement form;
             attribute DOMString label;
             attribute boolean defaultSelected;
             attribute boolean selected;
             attribute DOMString value;

    readonly attribute DOMString text;
    readonly attribute long index;
  };

  interface HTMLTextAreaElement : HTMLElement {
             attribute boolean autofocus;
             attribute unsigned long cols;
             attribute boolean disabled;
    readonly attribute HTMLFormElement form;
             attribute long maxLength;
             attribute DOMString name;
             attribute DOMString placeholder;
             attribute boolean readOnly;
             attribute boolean required;
             attribute unsigned long rows;
             attribute DOMString wrap;

    readonly attribute DOMString type;
             attribute DOMString defaultValue;
             attribute DOMString value;

    readonly attribute boolean willValidate;
    readonly attribute ValidityState validity;
    readonly attribute DOMString validationMessage;
    boolean checkValidity();
    void setCustomValidity(in DOMString error);

    readonly attribute NodeList labels;

    void select();
             attribute unsigned long selectionStart;
             attribute unsigned long selectionEnd;
    void setSelectionRange(in unsigned long start, in unsigned long end);
  };

  interface HTMLOutputElement : HTMLElement {
             attribute DOMString htmlFor;
    readonly attribute HTMLFormElement form;
             attribute DOMString name;

    readonly attribute DOMString type;
             attribute DOMString defaultValue;
             attribute DOMString value;

    readonly attribute boolean willValidate;
    readonly attribute ValidityState validity;
    readonly attribute DOMString validationMessage;
    boolean checkValidity();
    void setCustomValidity(in DOMString error);
  };

  interface ValidityState {
    readonly attribute boolean valueMissing;
    readonly attribute boolean typeMismatch;
    readonly attribute boolean patternMismatch;
    readonly attribute boolean tooLong;
    readonly attribute boolean rangeUnderflow;
    readonly attribute boolean rangeOverflow;
    readonly attribute boolean stepMismatch;
    readonly attribute boolean customError;
    readonly attribute boolean valid;
  };

  interface HTMLDetailsElement : HTMLElement {
             attribute boolean open;
  };

  interface HTMLDataGridElement : HTMLElement {
             attribute DataGridDataProvider data;
    readonly attribute DataGridSelection selection;
             attribute boolean multiple;
             attribute boolean disabled;
    void updateEverything();
    void updateRowsChanged(in RowSpecification row, in unsigned long count);
    void updateRowsInserted(in RowSpecification row, in unsigned long count);
    void updateRowsRemoved(in RowSpecification row, in unsigned long count);
    void updateRowChanged(in RowSpecification row);
    void updateColumnChanged(in unsigned long column);
    void updateCellChanged(in RowSpecification row, in unsigned long column);
  };

  [NoInterfaceObject] interface RowSpecification {
    // binding-specific interface
  };

  // To be implemented by Web authors as a JS object
  [NoInterfaceObject] interface DataGridDataProvider {
    void initialize(in HTMLDataGridElement datagrid);
    unsigned long getRowCount(in RowSpecification row);
    unsigned long getChildAtPosition(in RowSpecification parentRow, in unsigned long position);
    unsigned long getColumnCount();
    DOMString getCaptionText(in unsigned long column);
    void getCaptionClasses(in unsigned long column, in DOMTokenList classes);
    DOMString getRowImage(in RowSpecification row);
    HTMLMenuElement getRowMenu(in RowSpecification row);
    void getRowClasses(in RowSpecification row, in DOMTokenList classes);
    DOMString getCellData(in RowSpecification row, in unsigned long column);
    void getCellClasses(in RowSpecification row, in unsigned long column, in DOMTokenList classes);
    void toggleColumnSortState(in unsigned long column);
    void setCellCheckedState(in RowSpecification row, in unsigned long column, in long state);
    void cycleCell(in RowSpecification row, in unsigned long column);
    void editCell(in RowSpecification row, in unsigned long column, in DOMString data);
  };

  interface DataGridSelection {
    readonly attribute unsigned long length;
    getter RowSpecification item(in unsigned long index);
    boolean isSelected(in RowSpecification row);
    void setSelected(in RowSpecification row, in boolean selected);

    void selectAll();
    void invert();
    void clear();
  };

  interface HTMLCommandElement : HTMLElement {
             attribute DOMString type;
             attribute DOMString label;
             attribute DOMString icon;
             attribute boolean disabled;
             attribute boolean checked;
             attribute DOMString radiogroup;
             attribute boolean defaultValue;  // XXX default
    // XXX void click(); // shadows HTMLElement.click()
  };

  interface HTMLBrowserButtonElement : HTMLElement {
             attribute DOMString type;
    readonly attribute boolean supported;
    readonly attribute boolean disabled;
  };

  interface HTMLMenuElement : HTMLElement {
             attribute DOMString type;
             attribute DOMString label;
  };

  [NoInterfaceObject] interface Command {
    readonly attribute DOMString commandType;
    readonly attribute DOMString id;
    readonly attribute DOMString label;
    readonly attribute DOMString title;
    readonly attribute DOMString icon;
    readonly attribute boolean hidden;
    readonly attribute boolean disabled;
    readonly attribute boolean checked;
    void click();
  };

  interface HTMLLegendElement : HTMLElement {
    readonly attribute HTMLFormElement form;
  };

  typedef Window WindowProxy;
  [IndexGetter, NameGetter=OverrideBuiltins]
  interface Window {
    // the current browsing context
    readonly attribute WindowProxy window;
    readonly attribute WindowProxy self;
             attribute DOMString name;
    [PutForwards=href] readonly attribute Location location;
    readonly attribute History history;
    readonly attribute UndoManager undoManager;
    Selection getSelection();
    [Replaceable] readonly attribute BarProp locationbar;
    [Replaceable] readonly attribute BarProp menubar;
    [Replaceable] readonly attribute BarProp personalbar;
    [Replaceable] readonly attribute BarProp scrollbars;
    [Replaceable] readonly attribute BarProp statusbar;
    [Replaceable] readonly attribute BarProp toolbar;
    void close();
    void focus();
    void blur();

    // other browsing contexts
    readonly attribute WindowProxy frames;
    readonly attribute unsigned long length;
    readonly attribute WindowProxy top;
    [Replaceable] readonly attribute WindowProxy opener;
    readonly attribute WindowProxy parent;
    readonly attribute Element frameElement;
    WindowProxy open(in optional DOMString url, in optional DOMString target, in optional DOMString features, in optional DOMString replace);

    // the user agent
    readonly attribute Navigator navigator;
    readonly attribute Storage localStorage;
    readonly attribute Storage sessionStorage;
    Database openDatabase(in DOMString name, in DOMString version, in DOMString displayName, in unsigned long estimatedSize);
    readonly attribute ApplicationCache applicationCache;

    // user prompts
    void alert(in DOMString message);
    boolean confirm(in DOMString message);
    DOMString prompt(in DOMString message, in optional DOMString defaultValue);
    void print();
    any showModalDialog(in DOMString url, in optional any argument);

    // cross-document messaging
    void postMessage(in any message, in DOMString targetOrigin);
    void postMessage(in any message, in MessagePortArray ports, in DOMString targetOrigin);

    // event handler DOM attributes
             attribute Function onabort;
             attribute Function onbeforeunload;
             attribute Function onblur;
             attribute Function onchange;
             attribute Function onclick;
             attribute Function oncontextmenu;
             attribute Function ondblclick;
             attribute Function ondrag;
             attribute Function ondragend;
             attribute Function ondragenter;
             attribute Function ondragleave;
             attribute Function ondragover;
             attribute Function ondragstart;
             attribute Function ondrop;
             attribute Function onerror;
             attribute Function onfocus;
             attribute Function onhashchange;
             attribute Function onkeydown;
             attribute Function onkeypress;
             attribute Function onkeyup;
             attribute Function onload;
             attribute Function onmessage;
             attribute Function onmousedown;
             attribute Function onmousemove;
             attribute Function onmouseout;
             attribute Function onmouseover;
             attribute Function onmouseup;
             attribute Function onmousewheel;
             attribute Function ononline;
             attribute Function onoffline;
             attribute Function onpopstate;
             attribute Function onresize;
             attribute Function onscroll;
             attribute Function onselect;
             attribute Function onstorage;
             attribute Function onsubmit;
             attribute Function onunload;
  };

  interface BarProp {
             attribute boolean visible;
  };

  [Callback=FunctionOnly, NoInterfaceObject]
  interface Function {
    any call(in any... arguments);
  };

  Window implements WindowModal;
  [NoInterfaceObject,  XXX] interface WindowModal {
    readonly attribute any dialogArguments;
             attribute DOMString returnValue;
  };

  interface Navigator {
    // objects implementing this interface also implement the interfaces given below
  };

  Navigator implements NavigatorID;
  [NoInterfaceObject] interface NavigatorID {
    readonly attribute DOMString appName;
    readonly attribute DOMString appVersion;
    readonly attribute DOMString platform;
    readonly attribute DOMString userAgent;
  };

  Navigator implements NavigatorOnLine;
  [NoInterfaceObject] interface NavigatorOnLine {
    readonly attribute boolean onLine;
  };

  Navigator implements NavigatorAbilities;
  [NoInterfaceObject] interface NavigatorAbilities {
    // content handler registration
    void registerProtocolHandler(in DOMString protocol, in DOMString url, in DOMString title);
    void registerContentHandler(in DOMString mimeType, in DOMString url, in DOMString title);
    void getStorageUpdates();
  };

  interface ApplicationCache {

    // update status
    const unsigned short UNCACHED = 0;
    const unsigned short IDLE = 1;
    const unsigned short CHECKING = 2;
    const unsigned short DOWNLOADING = 3;
    const unsigned short UPDATEREADY = 4;
    const unsigned short OBSOLETE = 5;
    readonly attribute unsigned short status;

    // updates
    void update();
    void swapCache();

    // events
             attribute Function onchecking;
             attribute Function onerror;
             attribute Function onnoupdate;
             attribute Function ondownloading;
             attribute Function onprogress;
             attribute Function onupdateready;
             attribute Function oncached;
             attribute Function onobsolete;

  };

  interface History {
    readonly attribute long length;
    void go(in optional long delta);
    void back();
    void forward();
    void pushState(in any data, in DOMString title, in optional DOMString url);
    void clearState();
  };

  interface PopStateEvent : Event {
    readonly attribute any state;
    void initPopStateEvent(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in any stateArg);
    void initPopStateEventNS(in DOMString namespaceURIArg, in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in any stateArg);
  };

  interface Location {
    readonly attribute DOMString href;
    void assign(in DOMString url);
    void replace(in DOMString url);
    void reload();

    // URL decomposition attributes
             attribute DOMString protocol;
             attribute DOMString host;
             attribute DOMString hostname;
             attribute DOMString port;
             attribute DOMString pathname;
             attribute DOMString search;
             attribute DOMString hash;

    // resolving relative URLs
    DOMString resolveURL(in DOMString url);
  };

  interface BeforeUnloadEvent : Event {
             attribute DOMString returnValue;
  };

  interface Selection {
    stringifier;
    readonly attribute Node anchorNode;
    readonly attribute long anchorOffset;
    readonly attribute Node focusNode;
    readonly attribute long focusOffset;
    readonly attribute boolean isCollapsed;
    void collapse(in Node parentNode, in long offset);
    void collapseToStart();
    void collapseToEnd();
    void selectAllChildren(in Node parentNode);
    void deleteFromDocument();
    readonly attribute long rangeCount;
    Range getRangeAt(in long index);
    void addRange(in Range range);
    void removeRange(in Range range);
    void removeAllRanges();
  };

  interface DragEvent : MouseEvent {
    readonly attribute DataTransfer dataTransfer;

    void initDragEvent(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in AbstractView viewArg, in long detailArg, in long screenXArg, in long screenYArg, in long clientXArg, in long clientYArg, in boolean ctrlKeyArg, in boolean altKeyArg, in boolean shiftKeyArg, in boolean metaKeyArg, in unsigned short buttonArg, in EventTarget relatedTargetArg, in DataTransfer dataTransferArg);
    void initDragEventNS(in DOMString namespaceURIArg, in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in AbstractView viewArg, in long detailArg, in long screenXArg, in long screenYArg, in long clientXArg, in long clientYArg, in unsigned short buttonArg, in EventTarget relatedTargetArg, in DOMString modifiersListArg, in DataTransfer dataTransferArg);
  };

  interface DataTransfer {
             attribute DOMString dropEffect;
             attribute DOMString effectAllowed;
    readonly attribute DOMStringList types;
    void clearData(in optional DOMString format);
    void setData(in DOMString format, in DOMString data);
    DOMString getData(in DOMString format);
    void setDragImage(in Element image, in long x, in long y);
    void addElement(in Element element);
  };

  interface UndoManager {
    readonly attribute unsigned long length;
    getter any item(in unsigned long index);
    readonly attribute unsigned long position;
    unsigned long add(in any data, in DOMString title);
    void remove(in unsigned long index);
    void clearUndo();
    void clearRedo();
  };

  interface UndoManagerEvent : Event {
    readonly attribute any data;
    void initUndoManagerEvent(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in any dataArg);
    void initUndoManagerEventNS(in DOMString namespaceURIArg, in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in any dataArg);
  };

  interface MessageEvent : Event {
    readonly attribute any data;
    readonly attribute DOMString origin;
    readonly attribute DOMString lastEventId;
    readonly attribute WindowProxy source;
    readonly attribute MessagePortArray ports;
    void initMessageEvent(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in any dataArg, in DOMString originArg, in DOMString lastEventIdArg, in WindowProxy sourceArg, in MessagePortArray portsArg);
    void initMessageEventNS(in DOMString namespaceURI, in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in any dataArg, in DOMString originArg, in DOMString lastEventIdArg, in WindowProxy sourceArg, in MessagePortArray portsArg);
  };

  [Constructor]
  interface MessageChannel {
    readonly attribute MessagePort port1;
    readonly attribute MessagePort port2;
  };

  interface MessagePort {
    readonly attribute boolean active;
    void postMessage(in any message, in optional MessagePortArray ports);
    void start();
    void close();

    // event handler attributes
             attribute Function onmessage;
  };

  Window implements WindowTimers;
  [NoInterfaceObject] interface WindowTimers {
    // timers
    long setTimeout(in TimeoutHandler handler, in long timeout, in any... arguments);
    long setTimeout(in DOMString code, in long timeout);
    long setTimeout(in DOMString code, in long timeout, in DOMString language);
    void clearTimeout(in long handle);
    long setInterval(in TimeoutHandler handler, in long timeout, in any... arguments);
    long setInterval(in DOMString code, in long timeout);
    long setInterval(in DOMString code, in long timeout, in DOMString language);
    void clearInterval(in long handle);
  };

  [Callback=FunctionOnly, NoInterfaceObject]
  interface TimeoutHandler {
    void handleEvent(in any... args);
  };

  AbstractView implements MediaModeAbstractView;
  [NoInterfaceObject] interface MediaModeAbstractView {
    readonly attribute DOMString mediaMode;
  };

  interface HTMLDivElement : HTMLElement {};

};

#endif // _HTML5_IDL_