DefinitelyTyped/types/polymer/index.d.ts

// Type definitions for polymer v1.2.6
// Project: https://github.com/Polymer/polymer
// Definitions by: Louis Grignon <https://github.com/lgrignon>, Suguru Inatomi <https://github.com/laco0416>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped

import { CustomElementConstructor } from "webcomponents.js";

declare global {
  namespace polymer {

    type PropConstructorType = StringConstructor | ObjectConstructor | BooleanConstructor | NumberConstructor | DateConstructor | ArrayConstructor;

    interface PropObjectType {
      type: PropConstructorType;
      value?: boolean | number | string | Function | Object;
      reflectToAttribute?: boolean;
      readOnly?: boolean;
      notify?: boolean;
      computed?: string;
      observer?: string;
    }

    interface CommonBase {
      /* polymer-micro */

      // Attributes

      hostAttributes?: {[name: string]: any};

      reflectPropertiesToAttribute?(name: string): void;

      serializeValueToAttribute?
          (value: any, attribute: string, node?: Element): void;

      deserialize?(value: string, type: NumberConstructor): number;
      deserialize?(value: string, type: BooleanConstructor): boolean;
      deserialize?(value: string, type: ObjectConstructor): Object;
      deserialize?(value: string, type: ArrayConstructor): any[];
      deserialize?(value: string, type: DateConstructor): Date;
      deserialize?(value: string, type: StringConstructor): string;

      serialize?(value: any): string;

      // Behaviors

      behaviors?:Object[];

      // Constructors

      factoryImpl?(...args: any[]): void;

      // Debouncer

      debounce?(jobName: string, callback: Function, wait?: number): void;

      isDebouncerActive?(jobName: string): boolean;

      flushDebouncer?(jobName: string): void;

      cancelDebouncer?(jobName: string): void;

      // Extends

      extends?: string;

      getNativePrototype?(tag: string): Object;

      // Properties

      properties?:{[prop:string]:(PropConstructorType|PropObjectType);};

      getPropertyInfo?(property: string): Object;

      // Tag

      is: string;

      /* polymer-mini */

      // Ready

      ready?(): void;

      attachedCallback?(): void;

      // Shady

      domHost?(): Element;

      distributeContent?(): void;

      elementMatches?(selector: string, node?: Element): boolean;

      // Template {

      instanceTemplate?(template: HTMLElement): DocumentFragment;

      /* polymer-standard */


      // Annotations

      $?: any;

      // Events

      listeners?: {[key:string]:string;};

      listen?(node: Element, eventName: string, methodName: string): void;

      unlisten?(node: Element, eventName: string, methodName: string): void;

      // Gestures

      setScrollDirection?(direction: string, node?: HTMLElement): void;

      // NotifyPath

      notifyPath?(path: string, value: any, fromAbove: any): void;

      set?<Value>(path: string|(string|number)[], value: Value, root?: Object):
          void;

      get?(path: string|(string|number)[], root?: Object): any;

      linkPaths?(to: string, from?: string): void;

      unlinkPaths?(path: string): void;

      push?(path: string, ...item: any[]): number;

      pop?(path: string): any;

      splice?(path: string, index: number, removeCount: number, ...item: any[]):
          number;

      shift?(path: string): any;

      unshift?(path: string, ...item: any[]): number;

      notifySplices?
          (path: string, splices: ReadonlyArray<polymer.PolymerSplice>): void;

      // ResolveUrl

      resolveUrl?(url: string): string;

      // Styling

      scopeSubtree?(container: Element, shouldObserve: boolean): void;

      // Utils

      $$?(selector: string): Element;

      toggleClass?(name: string, bool?: boolean, node?: HTMLElement): void;

      classFollows?(name: string, toElement: HTMLElement, fromElement: HTMLElement): void;

      attributeFollows?(name: string, toElement: HTMLElement, fromElement: HTMLElement): void;

      getContentChildNodes?(selector: string): Node[];

      getContentChildren?(selector: string): HTMLElement[];

      fire?(type: string, detail?: any, options?: Object): CustomEvent;

      async?(callback: ()=>void, waitTime?: number): number;

      cancelAsync?(handle: number): void;

      arrayDelete?(path: string|any[], item: any): any[];

      transform?(transform: string, node?: HTMLElement): void;

      translate3d?(x: number, y: number, z: number, node?: HTMLElement): void;

      importHref?(href: string, onload?: Function, onerror?: Function): HTMLLinkElement;

      create?(tag: string, props: Object): Element;

      isLightDescendant?(node: HTMLElement): boolean;

      isLocalDescendant?(node: HTMLElement): boolean

      // XStyling

      updateStyles?(styles?: {[prop: string]: string;}): void;

      /* common api */

      registerCallback?():void;

      createdCallback?():void;

      detachedCallback?():void;

      attributeChangedCallback?(name: string):void;

      extend?(prototype: Object, api: Object):Object;

      mixin?(target: Object, source: Object):Object;

      copyOwnProperty?(name: string, source: Object, target: Object):void;

      observers?: string[];

      beforeRegister?(): void;

      registered?(): void;

      created?(): void;

      attached?(): void;

      detached?(): void;

      attributeChanged?(name: string, oldValue: any, newValue: any): void;
        
      getEffectiveChildren?(): Node[];

      getEffectiveChildNodes?(): Node[];
    }

    // This is the type of a Polymer element after it has gone through the
    // Polymer() function.
    interface PolymerElement extends CommonBase, HTMLElement {}

    interface Base extends CommonBase {
      /** Need to allow all properties for callback methods. */
      [prop: string]: any;

      // Has to live on Base because it is incompatible with
      // HTMLElement#toggleAttribute
      toggleAttribute?(name: string, bool?: boolean, node?: HTMLElement): void;
    }

    interface DomApiStatic {

      (obj: Node|Base):DomApi;

      (obj: Event):EventApi;

      flush():void;
    }

    interface ObservedNodeInfo {
      target: Node;
      addedNodes: Node[];
      removedNode: Node[];
    }

    interface DomApi {

      appendChild(node: Node): Node;

      insertBefore(node: Node, refNode?: Node):Node;

      removeChild(node: Node):Node;

      replaceChild(node: Node, refNode: Node):Node;

      getOwnerRoot():Node;

      querySelector(selector: string):Node;

      querySelectorAll(selector: string):Node[];

      getDestinationInsertionPoints():Node[];

      getDistributedNodes():Node[];

      queryDistributedElements(selector: string):Node[];

      setAttribute(name: string, value: any):void;

      removeAttribute(name: string):void;

      observeNodes(callback: (info: ObservedNodeInfo) => void): {};

      unobserveNodes(observer: {}): void;

      getEffectiveChildNodes(): Node[];

      childNodes:Node[];

      children:Element[];

      parentNode:Node;

      firstChild:Node;

      lastChild:Node;

      nextSibling:Node;

      previousSibling:Node;

      firstElementChild:Element;

      lastElementChild:Element;

      nextElementSibling:Element;

      previousElementSibling:Element;

      textContent:string;

      innerHTML:string;
    }

    interface EventApi {

      rootTarget:EventTarget;

      localTarget:EventTarget;

      path:Node[];
    }

    interface Settings {
        hasNativeCSSProperties: boolean
        hasNativeImports: boolean
        hasShadow: boolean
        nativeShadow: boolean
        useNativeCSSProperties: boolean
        useNativeCustomElements: boolean
        useNativeImports: boolean
        useNativeShadow: boolean
        usePolyfillProto: boolean
        useShadow: boolean
        wantShadow: boolean
    }

    interface RenderStatus {
      afterNextRender(element: Element, fn: Function, args?: any): void;
      hasRendered(): boolean;
      whenReady(cb: Function): void;
    }

    interface PolymerSplice {
      index: number;
      removed: Array<{}>;
      addedCount: number;
      object: Array<{}>;
      type: string;
    }

    interface ArraySplice {
      calculateSplices<T>(current: ReadonlyArray<T>, previous: ReadonlyArray<T>): PolymerSplice[];
    }

    interface ImportStatus extends RenderStatus {
      whenLoaded(cb: Function): void;
    }

    interface Templatizer {
      templatize(template: HTMLTemplateElement, mutableData?: boolean): void;
      stamp(model: {}): Base;
      modelForElement: (elem: HTMLElement) => Base;
    }

    interface PolymerStatic {
      Settings: Settings;

      isInstance(element: string): boolean;
      Base: Base;
      dom: DomApiStatic;

      (prototype: Base | { new (): Base }): CustomElementConstructor;

      Class(prototype: Base | { new (): Base }): CustomElementConstructor;

      RenderStatus: RenderStatus;

      ArraySplice: ArraySplice;

      /** @deprecated */
      ImportStatus: ImportStatus;

      Templatizer: Templatizer;
    }
  }

  var Polymer: polymer.PolymerStatic;
}