/// <reference path="kmwexthtml.ts" />  // Includes KMW-added property declaration extensions for HTML elements.
/// <reference path="kmwstring.ts" />  // Includes KMW string extension declarations.

/***
   KeymanWeb 10.0
   Copyright 2017 SIL International
***/

// If KMW is already initialized, the KMW script has been loaded more than once. We wish to prevent resetting the 
// KMW system, so we use the fact that 'initialized' is only 1 / true after all scripts are loaded for the initial
// load of KMW.
if(!window['keyman']['initialized']) { 

  /******************************************************************
   *  Main Keyman Web Module    
   *   
   *  Code enclosed as an anonymous function to protect name space                          
   *    
   ******************************************************************/

  (function() 
  { 
    // Declare KeymanWeb, OnScreen Keyboard and Util objects
    var keymanweb=window['keyman'],osk=keymanweb['osk'],util=keymanweb['util'],device=util.device;
    var kbdInterface=keymanweb['interface'];

    /**
     * Function     debug
     * Scope        Private
     * @param       {(string|Object)}     s   string (or object) to print
     * Description  Simple debug display (upper right of screen)
     *              Extended to support multiple arguments May 2015   
     */       
    keymanweb['debug']=keymanweb.debug=function(s){
      var p;
      if(keymanweb.debugElement == null)
      {
        var d=document.createElement('DIV'),ds=d.style;
        ds.position='absolute';ds.width='30%';ds.maxHeight='50%';ds.top='0';ds.right='0';
        ds.minHeight='50px'; ds.border='1px solid blue'; ds.whiteSpace='pre-line';ds.overflowY='scroll';
        p=document.createElement('P'); p.id='debug_output';p.style.margin='2px';
        d.appendChild(p);
        document.body.appendChild(d);   
        keymanweb.debugElement=p;  
      } 
      if((p=document.getElementById('debug_output')) == null) return; 

      if(arguments.length == 0)
        if(typeof p.textContent != 'undefined') p.textContent=''; else p.innerHTML='';
      else
      {
        var ts=new Date().toTimeString().substr(3,5),t=ts+' ',t1,k,m,sx;
        for(k=0; k<arguments.length; k++)
        {
          if(k > 0) t = t + '; ';
          sx = arguments[k];
          if(typeof sx == 'object')
          {
            if(sx == null)
            {
              t = t + 'null';
            }
            else
            {
              t1 = '';
              for(m in sx) 
              {
                if(t1.length > 0) t1 = t1 + ', ';
                t1 = t1 + m + ':';              
                switch(typeof sx[m])
                {
                  case 'string':
                  case 'number':
                  case 'boolean':
                    t1 = t1 + sx[m]; break;
                  default:
                    t1 = t1 + typeof sx[m]; break;
                }
                if(t1.length > 1024) 
                {
                  t1 = t1.substr(0,1000)+'...'; break;
                }
              }
              if(t1.length > 0) t = t + '{' + t1 + '}';
            }
          }
          else
          {
            t = t + sx;
          }
        } 
        // Truncate if necessary to avoid memory problems
        if(t.length > 1500) t = t.substr(0,1500) + ' (more)';  
        
        if(typeof p.textContent != 'undefined')
          p.textContent=t+'\n'+p.textContent;
        else
          p.innerHTML=t+'<br />'+p.innerHTML;
        
      }
    }
    keymanweb.debugElement=null;
    var dbg=keymanweb.debug;
        
    /**
     * Function     addEventListener
     * Scope        Public
     * @param       {string}            event     event to handle
     * @param       {function(Event)}   func      event handler function
     * @return      {boolean}                     value returned by util.addEventListener
     * Description  Wrapper function to add and identify KeymanWeb-specific event handlers
     */       
    keymanweb['addEventListener'] = keymanweb.addEventListener = function(event, func)
    {
      return util.addEventListener('kmw.'+event, func);
    }

    /**
     * Function    setUpTouchDevice
     * Scope       Private
     * Description Initialize event handling and duplicate input fields for touch-input devices
     */       
    keymanweb.setupTouchDevice = function()
    { 
      /**
       * Ideally, OSK behaviour should emulate internal keyboard, but 
       * it is not possible to do that while allowing native scrolling.
       * The compromise adopted is that a touchstart or touchmove event
       * on any part of the page other than an input element or the OSK 
       * itself will temporarily hide the OSK until the touchend or 
       * window.scroll event is fired. Hiding the OSK in this way seems
       * less disturbing than having it move as the page is scrolled.
       * 
       * All of this may be better if we can reliably get the y-offset 
       * from the CSS transform and apply that to repositioning the OSK
       * using a timed event loop.           
       */  

      /**
       * Close OSK and remove simulated caret on losing focus
       */          
      keymanweb.cancelInput = function()
      { 
        keymanweb._ActiveElement=null; 
        keymanweb.hideCaret(); 
        osk.hideNow();
      };

      /**
       * Handle losing focus from simulated input field 
       *
       * @param       {Event}      e    event
       */
      keymanweb.setBlur = function(e)
      {
        // This works OK for iOS, but may need something else for other platforms
        if(('relatedTarget' in e) && e.relatedTarget)
        {
          if(e.relatedTarget.nodeName != 'DIV' || e.relatedTarget.className.indexOf('keymanweb-input') == -1)
          {
            keymanweb.cancelInput(); return;
          }
        }
        //Hide the OSK
        if(!keymanweb.focusing) keymanweb.cancelInput();
      }
      
      /**
       * Handle receiving focus by simulated input field 
       *      
       * @param       {Event=}     e    event
       */       
      keymanweb.setFocus=function(e) {                     
        //e.stopPropagation();  // not doing anything useful, no child elements
        //e.preventDefault();   // prevents user selection or scrolling, may be better if they are allowed?
        keymanweb.focusing=true;
        keymanweb.focusTimer=window.setTimeout(function(){keymanweb.focusing=false;},1000);
  
        var tEvent=e;      
        if(e) {
          if(typeof e.touches == 'object') {
            tEvent=e.touches[0];
          }
        } else { // Allow external code to set focus and thus display the OSK on touch devices if required (KMEW-123)
          tEvent={clientX:0,clientY:0}
          // Will usually be called from setActiveElement, which should define _LastActiveElement
          if(keymanweb._LastActiveElement) {
            tEvent.target = keymanweb._LastActiveElement['kmw_ip'];
          // but will default to first input or text area on page if _LastActiveElement is null
        } else {
            tEvent.target = keymanweb.sortedInputs[0]['kmw_ip'];
          }
        }    
        
        var touchX=tEvent.clientX,touchY=tEvent.clientY,tTarg=tEvent.target,scroller;
    
        // Identify the scroller element
        if(tTarg.nodeName == 'SPAN') {
          scroller=tTarg.parentNode;
        } else if(tTarg.className != null && tTarg.className.indexOf('keymanweb-input') >= 0) {
          scroller=tTarg.firstChild;
        } else {
          scroller=tTarg;
        }

        // And the actual target element        
        var target=scroller.parentNode;

        // Move the caret and refocus if necessary     
        if(keymanweb._ActiveElement != target) {
          // Hide the KMW caret
          keymanweb.hideCaret(); 
          keymanweb._ActiveElement=target;
          // The issue here is that touching a DIV does not actually set the focus for iOS, even when enabled to accept focus (by setting tabIndex=0)
          // We must explicitly set the focus in order to remove focus from any non-KMW input
          target.focus();  //Android native browsers may not like this, but it is needed for Chrome, Safari
        }  
        
        // Correct element directionality if required
        keymanweb._SetTargDir(target);  
        // What we really want to do is to blur any active element that is not a KMW input, 
        // but the following line does not work as might be expected, even though the correct element is referenced.
        // It is as though blur is ignored if focus is supposed to have been moved, even if it has not in fact been moved?
        //if(document.activeElement.nodeName != 'DIV' && document.activeElement.nodeName != 'BODY') document.activeElement.blur();
        
        // Refresh the internal keyboard flag state
        keymanweb.useInternalKeyboard=false;
        
        // And display the OSK if not already visible
        if(osk.ready && !osk._Visible) {
          osk._Show();
        }
        
        // If clicked on DIV, set caret to end of text
        if(tTarg.nodeName == 'DIV' ) { 
          var x,cp;
          x=util._GetAbsoluteX(scroller.firstChild);        
          if(target.dir == 'rtl') { 
            x += scroller.firstChild.offsetWidth;        
            cp=(touchX > x ? 0 : 100000);
          } else {
            cp=(touchX<x ? 0 : 100000);
          }
      
          keymanweb.setTextCaret(target,cp);
          keymanweb.scrollInput(target);        
        } else { // Otherwise, if clicked on text in SPAN, set at touch position
          var caret,cp,cpMin,cpMax,x,y,dy,yRow,iLoop;
          caret=scroller.childNodes[1]; //caret span
          cpMin=0;
          cpMax=keymanweb.getText(target)._kmwLength();
          cp=keymanweb.getTextCaret(target);
          dy=document.body.scrollTop;

          // Vertical scrolling
          if(target.base.nodeName == 'TEXTAREA')
          {
            yRow=Math.round(target.base.offsetHeight/target.base.rows);     
            for(iLoop=0; iLoop<16; iLoop++)
            {
              y=util._GetAbsoluteY(caret)-dy;  //top of caret            
              if(y > touchY && cp > cpMin && cp != cpMax) {cpMax=cp; cp=Math.round((cp+cpMin)/2);}
              else if(y < touchY-yRow && cp < cpMax && cp != cpMin) {cpMin=cp; cp=Math.round((cp+cpMax)/2);}
              else break;
              keymanweb.setTextCaret(target,cp);
            }
            while(util._GetAbsoluteY(caret)-dy > touchY && cp > cpMin)keymanweb.setTextCaret(target,--cp);
            while(util._GetAbsoluteY(caret)-dy < touchY-yRow && cp < cpMax) keymanweb.setTextCaret(target,++cp);
          }

          // Caret repositioning for horizontal scrolling of RTL text

          // snapOrder - 'snaps' the touch location in a manner corresponding to the 'ltr' vs 'rtl' orientation.
          // Think of it as performing a floor() function, but the floor depends on the origin's direction.
          var snapOrder;
          if(target.dir == 'rtl') {  // I would use arrow functions, but IE doesn't like 'em.
            snapOrder = function(a, b) {
              return a < b; 
            };
          } else {
            snapOrder = function(a, b) { 
              return a > b; 
            };
          }

          for(iLoop=0; iLoop<16; iLoop++) {
            x=util._GetAbsoluteX(caret);  //left of caret            
            if(snapOrder(x, touchX) && cp > cpMin && cp != cpMax) {
              cpMax=cp; 
              cp=Math.round((cp+cpMin)/2);
            } else if(!snapOrder(x, touchX) && cp < cpMax && cp != cpMin) {
              cpMin=cp; 
              cp=Math.round((cp+cpMax)/2);
            } else {
              break;
            }
            keymanweb.setTextCaret(target,cp);
          }

          while(snapOrder(util._GetAbsoluteX(caret), touchX) && cp > cpMin) {
            keymanweb.setTextCaret(target,--cp);
          }
          while(!snapOrder(util._GetAbsoluteX(caret), touchX) && cp < cpMax) {
            keymanweb.setTextCaret(target,++cp);
          }
        }

        /**
         * This event will trigger before keymanweb.setBlur is triggered.  Now that we're allowing independent keyboard settings
         * for controls, we have to act here to preserve the outgoing control's keyboard settings.
         *
         * If we 'just activated' the KeymanWeb UI, we need to save the new keyboard change as appropriate.
         */  
        keymanweb._BlurKeyboardSettings();

        // With the attachment API update, we now directly track the old legacy control behavior.
        keymanweb._LastActiveElement = target;

        /**
         * If we 'just activated' the KeymanWeb UI, we need to save the new keyboard change as appropriate.
         * If not, we need to activate the control's preferred keyboard.
         */
        keymanweb._FocusKeyboardSettings(false);
        
        // Always do the common focus stuff, instantly returning if we're in an editable iframe.
        // This parallels the if-statement in _ControlFocus - it may be needed as this if-statement in the future,
        // despite its present redundancy.
        if(keymanweb._CommonFocusHelper(target)) {
          return;
        }
      }

      /**
       * Create a caret to be appended to the scroller of the focussed input field. 
       * The caret is appended to the scroller so that it will automatically be clipped 
       * when the user manually scrolls it outside the element boundaries.          
       * It is positioned exactly over the hidden span that is inserted between the
       * text spans before and after the insertion point.          
       */
      keymanweb.caret=document.createElement('DIV');
      var cs=keymanweb.caret.style;
      cs.position='absolute';
      cs.height='16px';           // default height, actual height set from element properties
      cs.width='2px';
      cs.backgroundColor='blue';
      cs.border='none';
      cs.left=cs.top='0px';           // actual position set relative to parent when displayed
      cs.display='block';         
      cs.visibility='hidden';
      cs.zIndex='9998';           // immediately below the OSK
      
      /**
       * Position the caret at the start of the second span within the scroller
       *      
       * @param   {Object}  e   input DIV element (copy of INPUT or TEXTAREA)
       */
      keymanweb.showCaret=function(e)
      {                          
        if(!e || !e.firstChild || (e.firstChild.childNodes.length<3)) return;

        var scroller=e.firstChild,cs=keymanweb.caret.style,sp2=scroller.childNodes[1];
        
        // Attach the caret to this scroller and position it over the caret span
        if(keymanweb.caret.parentNode != scroller) scroller.appendChild(keymanweb.caret);
        cs.left=sp2.offsetLeft+'px'; 
        cs.top=sp2.offsetTop+'px';
        cs.height=(sp2.offsetHeight-1)+'px';
        cs.visibility='hidden';   // best to wait for timer to display caret
        
        // Scroll into view if required
        keymanweb.scrollBody(e);
      
        // Display and position the scrollbar if necessary
        keymanweb.setScrollBar(e);
      }

      /**
       * Display and position a scrollbar in the input field if needed
       * 
       * @param   {Object}  e   input DIV element (copy of INPUT or TEXTAREA)
       */
      keymanweb.setScrollBar=function(e)
      {
        // Display the scrollbar if necessary.  Added TEXTAREA condition to correct rotation issue KMW-5.  Fixed for 310 beta.
        var scroller=e.childNodes[0],sbs=e.childNodes[1].style;
        if((scroller.offsetWidth > e.offsetWidth || scroller.offsetLeft < 0) && (e.base.nodeName != 'TEXTAREA')) 
        {
          sbs.height='4px';
          sbs.width=100*(e.offsetWidth/scroller.offsetWidth)+'%';
          sbs.left=100*(-scroller.offsetLeft/scroller.offsetWidth)+'%';
          sbs.top='0';
          sbs.visibility='visible';  
        }
        else if(scroller.offsetHeight > e.offsetHeight || scroller.offsetTop < 0)
        {
          sbs.width='4px';
          sbs.height=100*(e.offsetHeight/scroller.offsetHeight)+'%';
          sbs.top=100*(-scroller.offsetTop/scroller.offsetHeight)+'%';
          sbs.left='0';    
          sbs.visibility='visible';        
        }
        else
        {
          sbs.visibility='hidden';
        }
      }                    

      /**
       * Description Toggle state of caret in simulated input field
       */         
      keymanweb.flashCaret = function()
      {
        if(device.touchable && keymanweb._ActiveElement != null)
        {
          var cs=keymanweb.caret.style;
          if(cs.visibility != 'visible') cs.visibility='visible'; else cs.visibility='hidden';
        }
      }
    
      /**
       * Hide caret in simulated input field, update underlying INPUT or TEXTAREA
       */         
      keymanweb.hideCaret = function()
      {
        var e=keymanweb._LastActiveElement,s=null;
        if(e && e.className != null && e.className.indexOf('keymanweb-input') >= 0)
        {
          // Always copy text back to underlying field on blur
          e.base.value = keymanweb.getText(e);
          
          // And set the scroller caret to the end of the element content
          keymanweb.setText(e,null,100000);
          
          // Set the element scroll to zero (or max for RTL INPUT)
          var ss=e.firstChild.style;
          if(e.base.nodeName == 'TEXTAREA')
            ss.top='0'; 
          else
          {
            if(e.base.dir == 'rtl') ss.left=(e.offsetWidth-e.firstChild.offsetWidth-8)+'px';
            else ss.left='0';
          }
          
          
          // And hide the caret and scrollbar       
          if(keymanweb.caret.parentNode) keymanweb.caret.parentNode.removeChild(keymanweb.caret);
          keymanweb.caret.style.visibility='hidden';
          if(e.childNodes.length > 1 ) e.childNodes[1].style.visibility='hidden';
        }    
      }
      
      // Start the caret flash timer
      keymanweb.timerId = window.setInterval(keymanweb.flashCaret,500);

      /**
       * Insert text into simulated input field at indicated character position
       * 
       * @param       {Object}      e     simulated input field DIV
       * @param       {?string}     t     text to insert in element
       * @param       {?number}     cp    caret position (characters)     
       */         
      keymanweb.setText = function(e,t,cp)
      {
        if(e && e.childNodes.length > 0)
        {
          var d=e.firstChild,tLen=0;
          if(d.childNodes.length >= 3)
          {
            var s1=d.childNodes[0],s2=d.childNodes[2],t1,t2;
            
            // Read current text if null passed (for caret positioning)
            if(t === null)
            {
              t1=(typeof(s1.textContent) == 'string' ? s1.textContent : s1.innerText);
              t2=(typeof(s2.textContent) == 'string' ? s2.textContent : s2.innerText);
              t=t1+t2;        
            }
            if(cp < 0) cp = 0;    //if(typeof t._kmwLength == 'undefined') return; 
            tLen=t._kmwLength();
            
            if(cp === null || cp > tLen) cp=tLen;
            t1=t._kmwSubstr(0,cp); t2=t._kmwSubstr(cp);
                                
            if(typeof(s1.textContent) == 'string') s1.textContent=t1; else s1.innerText=t1;
            if(typeof(s2.textContent) == 'string') s2.textContent=t2; else s2.innerText=t2;          
          }
        }
        keymanweb.updateBaseElement(e,tLen); // KMW-3, KMW-29
      }

      /**
       * Set content, visibility, background and borders of input and base elements (KMW-3,KMW-29) 
       *
       * @param       {Object}        e     input element 
       * @param       {number}        n     length of text in field
       */                      
      keymanweb.updateBaseElement=function(e,n)
      {
        e.base.value=keymanweb.getText(e); //KMW-29
        e.style.backgroundColor=(n==0?'transparent':window.getComputedStyle(e.base,null).backgroundColor);
        if(device.OS == 'iOS')
        {
          e.base.style.visibility=(n==0?'visible':'hidden');
        }
      }
      
      /**
       * Get simulated input field content
       * 
       * @param       {Object}        e     simulated input field DIV
       * @return      {string}              entire text in simulated input field
       */         
      keymanweb.getText=function(e)
      {
        if(e == null) return '';
        return (typeof(e.textContent) == 'string' ? e.textContent : e.innerText);
      } 
    
      /**
       * Get text up to the caret from simulated input field 
       * 
       * @param       {Object}        e     simulated input field DIV
       * @return      {string}              Context for simulated input field
       */         
      keymanweb.getTextBeforeCaret=function(e)
      {
        if(e && e.childNodes.length > 1) 
        {
          var d=e.firstChild;
          if(d.childNodes.length > 0) 
          {
            var s1=d.childNodes[0];
            if('textContent' in s1)
              return s1.textContent;
            if('innerText' in s1)
              return s1.innerText;
          }
        }
        return '';    
      }
    
      /**
       * Replace text up to the caret in the simulated input field 
       * 
       * @param       {Object}        e     simulated input field DIV
       * @param       {string}        t     string to insert 
       */         
      keymanweb.setTextBeforeCaret=function(e,t)
      {
        if(e && e.childNodes.length > 0) 
        {
          var d=e.firstChild,tLen=0;
          if(d.childNodes.length > 1) 
          {
            var s1=d.childNodes[0],s2=d.childNodes[2];
            // Collapse (trailing) whitespace to a single space for INPUT fields (also prevents wrapping)
            if(e.base.nodeName != 'TEXTAREA') t=t.replace(/\s+$/,' ');
            if('textContent' in s1) s1.textContent=t;
            else if('innerText' in s1) s1.innerText=t; 
            // Test total length in order to control base element visibility 
            tLen=t.length;
            if('textContent' in s2) tLen=tLen+s2.textContent.length;
            else if('innerText' in s2) tLen=tLen+s2.innerText.length;            
          }
        }
        
        // Update the base element then scroll into view if necessary      
        keymanweb.updateBaseElement(e,tLen); //KMW-3, KMW-29      
        keymanweb.scrollInput(e); 
            
      }
      
      /**
       * Description  Get current position of caret in simulated input field 
       * 
       * @param       {Object}        e     simulated input field DIV
       * @return      {number}              caret character position in simulated input field
       */         
      keymanweb.getTextCaret=function(e)
      {
        return keymanweb.getTextBeforeCaret(e)._kmwLength();
      }

      /**
       * Set current position of caret in simulated input field then display the caret 
       * 
       * @param       {Object}        e     element (object) or element id (string) of simulated input field
       * @param       {number}        cp    caret position (character index)
       */         
      keymanweb.setTextCaret=function(e,cp)
      {
        keymanweb.setText(e,null,cp);
        keymanweb.showCaret(e);
      }

      /**
       * Handle the touch move event for an input element
       * 
       * @param       {Event}           e     touchmove event
       */         
      keymanweb.dragInput=function(e)
      {    
        // Prevent dragging window 
        e.preventDefault();  e.stopPropagation();      

        // Identify the target from the touch list or the event argument (IE 10 only) 
        var target=(typeof e.targetTouches == 'object' ? e.targetTouches[0].target : e.target);     
        if(target == null) return;
        
        // Identify the input element from the touch event target (touched element may be contained by input)
        if(target.className == null || target.className.indexOf('keymanweb-input') < 0) target=target.parentNode;
        if(target.className == null || target.className.indexOf('keymanweb-input') < 0) target=target.parentNode;
        if(target.className == null || target.className.indexOf('keymanweb-input') < 0) return;
        
        var x=(typeof e.touches == 'object' ? e.touches[0].screenX : e.screenX),       
            y=(typeof e.touches == 'object' ? e.touches[0].screenY : e.screenY);
                  
        // Allow content of input elements to be dragged horizontally or vertically
        if(typeof keymanweb.firstTouch == 'undefined' || keymanweb.firstTouch == null)
          keymanweb.firstTouch={x:x,y:y};
        else
        {
          var x0=keymanweb.firstTouch.x,y0=keymanweb.firstTouch.y,
            scroller=target.firstChild,dx,dy,x1;
          
          if(target.base.nodeName == 'TEXTAREA')
          {
            var yOffset=parseInt(scroller.style.top,10);
            if(isNaN(yOffset)) yOffset=0;
            dy=y0-y;
            if(dy < -4 || dy > 4)
            {
              scroller.style.top=(yOffset<dy?yOffset-dy:0)+'px';
              keymanweb.firstTouch.y=y;  
            } 
          }
          else
          {
            var xOffset=parseInt(scroller.style.left,10);
            if(isNaN(xOffset)) xOffset=0;
            dx=x0-x;
            if(dx < -4 || dx > 4)
            {
              // Limit dragging beyond the defined text (to avoid dragging the text completely out of view)
              var xMin=0,xMax=util._GetAbsoluteX(target)+target.offsetWidth-scroller.offsetWidth-32;
              if(target.base.dir == 'rtl')xMin=16; else xMax=xMax-24;            
              x1=xOffset-dx;
              if(x1 > xMin) x1=xMin;
              if(x1 < xMax) x1=xMax;
              scroller.style.left=x1+'px';
              keymanweb.firstTouch.x=x;       
            }    
          }
        }
        keymanweb.setScrollBar(target);
      }

      /**
       * Scroll the input field horizontally (INPUT base element) or 
       * vertically (TEXTAREA base element) to bring the caret into view
       * as text is entered or deleted form an element     
       *      
       * @param       {Object}      e        simulated input field object with focus
       */         
      keymanweb.scrollInput=function(e)
      {
        if(!e || !e.firstChild || e.className == null || e.className.indexOf('keymanweb-input') < 0 ) return;

        var scroller=e.firstChild;
        if(scroller.childNodes.length < 3) return;
  
        // Get the actual absolute position of the caret and the element 
        var s2=scroller.childNodes[1],
          cx=util._GetAbsoluteX(s2),cy=util._GetAbsoluteY(s2),
          ex=util._GetAbsoluteX(e),ey=util._GetAbsoluteY(e),
          x=parseInt(scroller.style.left,10),
          y=parseInt(scroller.style.top,10),
          dx=0,dy=0; 
        
        // Scroller offsets must default to zero
        if(isNaN(x)) x=0; if(isNaN(y)) y=0;
  
        // Scroll input field vertically if necessary
        if(e.base.nodeName == 'TEXTAREA')
        { 
          var rowHeight=Math.round(e.offsetHeight/e.base.rows);
          if(cy < ey) dy=cy-ey;
          if(cy > ey+e.offsetHeight-rowHeight) dy=cy-ey-e.offsetHeight+rowHeight;   
          if(dy != 0)scroller.style.top=(y<dy?y-dy:0)+'px';
        } 
        // or scroll horizontally if needed
        else
        {
          if(cx < ex+8) dx=cx-ex-12;
          if(cx > ex+e.offsetWidth-12) dx=cx-ex-e.offsetWidth+12;   
          if(dx != 0)scroller.style.left=(x<dx?x-dx:0)+'px';
        }    

        // Display the caret (and scroll into view if necessary)
        keymanweb.showCaret(e);
      }

      /**
       * Scroll the document body vertically to bring the active input into view
       * 
       * @param       {Object}      e        simulated input field object being focussed
       */         
      keymanweb.scrollBody=function(e)
      { 
        if(!e || e.className == null || e.className.indexOf('keymanweb-input') < 0 || !osk.ready) return;

        // Get the absolute position of the caret
        var s2=e.firstChild.childNodes[1],y=util._GetAbsoluteY(s2),t=window.pageYOffset,dy=0;
        if(y < t) 
        {
          dy=y-t;
        }
        else
        {
          dy=y-t-(window.innerHeight-osk._Box.offsetHeight-s2.offsetHeight-2);
          if(dy < 0) dy=0;
        }    
        // Hide OSK, then scroll, then re-anchor OSK with absolute position (on end of scroll event)
        if(dy != 0) 
          window.scrollTo(0,dy+window.pageYOffset);
      }

      /**
       *  Correct the position and size of a duplicated input element
       *  @param  {Element}  x   simulated input element
       **/              
      keymanweb.updateInput = function(x)
      {
        var xs=x.style,b=x.base,
            s=window.getComputedStyle(b,null),
            mLeft=parseInt(s.marginLeft,10),
            mTop=parseInt(s.marginTop,10),
            x1=util._GetAbsoluteX(b),y1=util._GetAbsoluteY(b);
  
        var p=x.offsetParent;
        if(p)
        {
          x1=x1-util._GetAbsoluteX(p); y1=y1-util._GetAbsoluteY(p);
        }
        
        if(isNaN(mLeft)) mLeft=0; if(isNaN(mTop)) mTop=0;
        
        xs.left=(x1-mLeft)+'px'; xs.top=(y1-mTop)+'px';

        // FireFox does not want the offset!
        if(typeof(s.MozBoxSizing) != 'undefined') {xs.left=x1+'px'; xs.top=y1+'px';}     

        var w=b.offsetWidth,h=b.offsetHeight,
            pLeft=parseInt(s.paddingLeft,10),pRight=parseInt(s.paddingRight,10),      
            pTop=parseInt(s.paddingTop,10),pBottom=parseInt(s.paddingBottom,10),
            bLeft=parseInt(s.borderLeft,10),bRight=parseInt(s.borderRight,10),    
            bTop=parseInt(s.borderTop,10),bBottom=parseInt(s.borderBottom,10);
      
        // If using content-box model, must subtract the padding and border, 
        // but *not* for border-box (as for WordPress PlugIn)
        var boxSizing='undefined';
        if(typeof(s.boxSizing) != 'undefined') boxSizing=s.boxSizing;
        else if(typeof(s.MozBoxSizing) != 'undefined') boxSizing=s.MozBoxSizing;
        if(boxSizing == 'content-box')
        {
          if(!isNaN(pLeft)) w -= pLeft; if(!isNaN(pRight)) w -= pRight;
          if(!isNaN(bLeft)) w -= bLeft; if(!isNaN(bRight)) w -= bRight;
          
          if(!isNaN(pTop)) h -= pTop; if(!isNaN(pBottom)) h -= pBottom;
          if(!isNaN(bTop)) h -= bTop; if(!isNaN(bBottom)) h -= bBottom;
        }
      
        if(device.OS == 'Android') 
        {
          // FireFox - adjust padding to match input and text area defaults 
          if(typeof(s.MozBoxSizing) != 'undefined') 
          {
            xs.paddingTop=(pTop+1)+'px';
            xs.paddingLeft=pLeft+'px';
            
            if(x.base.nodeName == 'TEXTAREA')
              xs.marginTop='1px';
            else
              xs.marginLeft='1px';
    
            w--;h--;
          }
          // Chrome, Opera, native browser (?)
          else
          {
            w++;h++;
          }
        }
        xs.width=w+'px'; xs.height=h+'px';   
      }

      /**
       * Function     enableTouchElement
       * Scope        Private
       * @param       {Element}  Pelem   An input or textarea element from the page.
       * @return      {boolean}  Returns true if it creates a simulated input element for Pelem; false if not.
       * Description  Creates a simulated input element for the specified INPUT or TEXTAREA, comprising:
       *              an outer DIV, matching the position, size and style of the base element
       *              a scrollable DIV within that outer element
       *              two SPAN elements within the scrollable DIV, to hold the text before and after the caret
       *    
       *              The left border of the second SPAN is flashed on and off as a visible caret  
       * 
       *              Also ensures the element is registered on keymanweb's internal input list.
       */
      keymanweb.enableTouchElement = function(Pelem)
      {
        // Touch doesn't worry about iframes.
        if(Pelem.tagName.toLowerCase() == 'iframe') {
          return false;
        }

        if(keymanweb.isKMWDisabled(Pelem)) {
          keymanweb.setupNonKMWTouchElement(Pelem);
          return false;
        } else {
          // Initialize and protect input elements for touch-screen devices (but never for apps)
          // NB: now set disabled=true rather than readonly, since readonly does not always 
          // prevent element from getting focus, e.g. within a LABEL element.
          // c.f. http://kreotekdev.wordpress.com/2007/11/08/disabled-vs-readonly-form-fields/ 
          Pelem.kmwInput = true;
        }

        // Remove any handlers for "NonKMWTouch" elements, since we're enabling it here.
        Pelem.removeEventListener('touchstart', keymanweb.nonKMWTouchHandler);

        /*
        *  Does this element already have a simulated touch element established?  If so,
        *  just reuse it - if it isn't still in the input list!
        */
        if(Pelem['kmw_ip']) {

          if(keymanweb.inputList.indexOf(Pelem['kmw_ip']) != -1) {
            return false;
          }

          keymanweb.inputList.push(Pelem['kmw_ip']);
          
          console.log("Unexpected state - this element's simulated input DIV should have been removed from the page!");

          return true;   // May need setup elsewhere since it's just been re-added!
        }

        // The simulated touch element doesn't already exist?  Time to initialize it.
        var x=document.createElement('DIV'); 
        x['base']=x.base=Pelem;
        x._kmwAttachment = Pelem._kmwAttachment; // It's an object reference we need to alias.
        
        // Set font for base element
        keymanweb.enableInputElement(x, true);

        // Add the exposed member 'kmw_ip' to allow page to refer to duplicated element
        Pelem['kmw_ip']=x;
        Pelem.disabled = true;

        // Superimpose custom input fields for each input or textarea, unless readonly or disabled 

        // Copy essential styles from each base element to the new DIV      
        var d,s1,s2,s3,bs,xs,ds,ss1,ss2,ss3,x1,y1;

        x.className='keymanweb-input';
        x.dir=x.base.dir;
        
        // Add a scrollable interior div 
        d=document.createElement('DIV'); 
        bs=window.getComputedStyle(x.base,null);
        xs=x.style;
        xs.overflow='hidden';
        xs.position='absolute';
        //xs.border='1px solid gray';
        xs.border='hidden';      // hide when element empty - KMW-3
        xs.border='none';
        xs.borderRadius='5px';

        // Add a scroll bar (horizontal for INPUT elements, vertical for TEXTAREA elements)
        var sb=document.createElement('DIV'), sbs=sb.style;
        sbs.position='absolute';
        sbs.height=sbs.width='4px';
        sbs.left=sbs.top='0';
        sbs.display='block';
        sbs.visibility='hidden';          
        sbs.backgroundColor='#808080';
        sbs.borderRadius='2px';
        
        // And add two spans for the text content before and after the caret, and a caret span
        s1=document.createElement('SPAN');
        s2=document.createElement('SPAN');
        s3=document.createElement('SPAN');      
        s1.innerHTML=s2.innerHTML=s3.innerHTML='';
        s1.className=s2.className=s3.className='keymanweb-font';
        d.appendChild(s1);d.appendChild(s3);d.appendChild(s2);
        x.appendChild(d); x.appendChild(sb);

        // Adjust input element properties so that it matches the base element as closely as possible
        ds=d.style; ds.position='absolute'; 

        ss1=s1.style;ss2=s2.style;ss3=s3.style;ss1.border=ss2.border='none';
        //ss1.backgroundColor='rgb(220,220,255)';ss2.backgroundColor='rgb(220,255,220)'; //only for testing 
        ss1.height=ss2.height='100%';          
        ss1.fontFamily=ss2.fontFamily=ds.fontFamily=bs.fontFamily;
  
        // Set vertical centering for input elements
        if(x.base.nodeName.toLowerCase() == 'input') {
          if(!isNaN(parseInt(bs.height,10))) {
            ss1.lineHeight=ss2.lineHeight=bs.height;      
          }
        }
        
        // The invisible caret-positioning span must have a border to ensure that 
        // it remains in the layout, but colour doesn't matter, as it is never visible.
        // Span margins are adjusted to compensate for the border and maintain text positioning.  
        ss3.border='1px solid red';  
        ss3.visibility='hidden';       
        ss3.marginLeft=ss3.marginRight='-1px';
        
        // Set the outer element padding *after* appending the element, 
        // otherwise Firefox misaligns the two elements
        xs.padding='8px';
        
        // Set internal padding to match the TEXTAREA and INPUT elements
        ds.padding='0px 2px'; // OK for iPad, possibly device-dependent
    
        if(device.OS == 'Android' && bs.backgroundColor == 'transparent') {
          ds.backgroundColor='#fff';
        } else {
          ds.backgroundColor=bs.backgroundColor;
        }
        
        // Set the tabindex to 0 to allow a DIV to accept focus and keyboard input 
        // c.f. http://www.w3.org/WAI/GL/WCAG20/WD-WCAG20-TECHS/SCR29.html
        x.tabIndex=0; 

        // Disable (internal) pan and zoom on KMW input elements for IE10
        x.style.msTouchAction='none';

        // On touch event, reposition the text caret and prepare for OSK input
        // Removed 'onfocus=' as that resulted in handling the event twice (on iOS, anyway) 
        
        x.addEventListener('touchstart', keymanweb.setFocus);
        x.onmspointerdown=function(e) {
          e.preventDefault();
          e.stopPropagation();
          return keymanweb.setFocus(e);
        };

        x.addEventListener('touchend', function(e) {
          e.stopPropagation();
        });

        x.onmspointerup=function(e) {
          e.stopPropagation();
        };
        
        // Disable internal scroll when input element in focus 
        x.addEventListener('touchmove', keymanweb.dragInput, false);
        x.onmspointermove=keymanweb.dragInput;
        
        // Hide keyboard and caret when losing focus from simulated input field
        x.onblur=keymanweb.setBlur;
        
        // Note that touchend event propagates and is processed by body touchend handler
        // re-setting the first touch point for a drag

        if(x.base.nodeName.toLowerCase() == 'textarea') {
          s1.style.whiteSpace=s2.style.whiteSpace='pre-wrap'; //scroll vertically
        } else {
          s1.style.whiteSpace=s2.style.whiteSpace='pre';      //scroll horizontally
        }
        
        x.base.parentNode.appendChild(x);
      
        // Refresh style pointers, and match the field sizes
        keymanweb.updateInput(x);
        xs=x.style; 
        xs.color=bs.color; //xs.backgroundColor=bs.backgroundColor; 
        xs.fontFamily=bs.fontFamily; xs.fontSize=bs.fontSize;
        xs.fontWeight=bs.fontWeight; xs.textDecoration=bs.textDecoration;
        xs.padding=bs.padding; xs.margin=bs.margin; 
        xs.border=bs.border; xs.borderRadius=bs.borderRadius;
      
        //xs.color='red';  //use only for checking alignment
    
        // Prevent highlighting of underlying element (Android)
        if('webkitTapHighlightColor' in xs) {
          xs.webkitTapHighlightColor='rgba(0,0,0,0)';
        }

        if(x.base.nodeName.toLowerCase() == 'textarea') {
          // Correct rows value if defaulted and box height set by CSS
          // The rows value is used when setting the caret vertically
          var baseArea = <HTMLTextAreaElement> x.base;
          if(baseArea.rows == 2) { // 2 is default value
            var h=parseInt(bs.height,10)-parseInt(bs.paddingTop,10)-parseInt(bs.paddingBottom,10),
              dh=parseInt(bs.fontSize,10),calcRows=Math.round(h/dh);
            if(calcRows > baseArea.rows+1) {
              baseArea.rows=calcRows;
            }
          }
          ds.width=xs.width; ds.minHeight=xs.height;
        } else {
          ds.minWidth=xs.width; ds.height=xs.height;
        }
        x.base.style.visibility='hidden'; // hide by default: KMW-3
        
        // Add an explicit event listener to allow the duplicated input element 
        // to be adjusted for any changes in base element location or size
        // This will be called for each element after any rotation, as well as after user-initiated changes
        // It has to be wrapped in an anonymous function to preserve scope and be applied to each element.
        (function(xx){
          xx._kmwResizeHandler = function(e){
            /* A timeout is needed to let the base element complete its resizing before our 
            * simulated element can properly resize itself.
            * 
            * Not doing this causes errors if the input elements are resized for whatever reason, such as
            * changing languages to a text with greater height.
            */
            window.setTimeout(function (){
              keymanweb.updateInput(xx);
            }, 1);
          };

          xx.base.addEventListener('resize', xx._kmwResizeHandler, false);
        })(x);

        var textValue: string;

        switch(x.base.nodeName.toLowerCase()) {
          case 'textarea':
          case 'input':
            textValue = (<HTMLInputElement> x.base).value;
            break;
          default:
            textValue = x.base.textContent;
            break;
        }
          
        // And copy the text content
        keymanweb.setText(x, textValue, null);  

        return true;
      }

      /**
       * Function     disableTouchElement
       * Scope        Private
       * @param       {Element}  Pelem   An input or textarea element from the page.
       * Description  Destroys the simulated input element for the specified INPUT or TEXTAREA and reverts
       *              back to desktop-style 'enablement' for the base control.
       */
      keymanweb.disableTouchElement = function(Pelem)
      {
        // Do not check for the element being officially disabled - it's also used for detachment.

        // Touch doesn't worry about iframes.
        if(Pelem.tagName.toLowerCase() == 'iframe') {
          return; // If/when we do support this, we'll need an iframe-level manager for it.
        }

        if(Pelem['kmw_ip']) {
          var index = keymanweb.inputList.indexOf(Pelem['kmw_ip']);
          if(index != -1) {
            keymanweb.inputList.splice(index, 1);
          }

          Pelem.style.visibility='visible'; // hide by default: KMW-3
          Pelem.disabled = false;
          Pelem.removeEventListener('resize', Pelem['kmw_ip']._kmwResizeHandler);

          // Disable touch-related handling code.
          keymanweb.disableInputElement(Pelem['kmw_ip']);
          
          // We get weird repositioning errors if we don't remove our simulated input element - and permanently.
          Pelem.parentNode.removeChild(Pelem['kmw_ip']);
          delete Pelem['kmw_ip'];
        }

        keymanweb.setupNonKMWTouchElement(Pelem);
      }

      /** 
       * Function     nonKMWTouchHandler
       * Scope        Private
       * Description  A handler for KMW-touch-disabled elements when operating on touch devices.
       */
      keymanweb.nonKMWTouchHandler = function(x) {
        keymanweb.focusing=false;
        clearTimeout(keymanweb.focusTimer);
        osk.hideNow();
      }

      /**
       * Function     setupNonKMWTouchElement
       * Scope        Private
       * @param       {Element}    x  A child element of document.
       * Description  Performs handling for the specified disabled input element on touch-based systems.
       */
      keymanweb.setupNonKMWTouchElement = function(x) {
        x.addEventListener('touchstart', keymanweb.nonKMWTouchHandler, false);

        // Signify that touch isn't enabled on the control.
        if(keymanweb.isAttached(x)) {
          x._kmwAttachment.touchEnabled = false;
        }
      }
    }
    
    /*********************************************************
     *  
     * End of main touch-device initialization.
     *     
     *********************************************************/
    
    /**
     * Function     enableInputElement
     * Scope        Private
     * @param       {Element}   Pelem   An element from the document to be enabled with full KMW handling.
     * @param       {boolean=}   isAlias A flag that indicates if the element is a simulated input element for touch.
     * Description  Performs the basic enabling setup for one element and adds it to the inputList if it is an input element.
     *              Note that this method is called for both desktop and touch control routes; the touch route calls it from within
     *              enableTouchElement as it must first establish the simulated touch element to serve as the alias "input element" here.
     *              Note that the 'kmw-disabled' property is managed by the MutationObserver and by the surface API calls.
     */       
    keymanweb.enableInputElement = function(Pelem, isAlias) { 
      var baseElement = isAlias ? Pelem['base'] : Pelem;
      if(!keymanweb.isKMWDisabled(baseElement)) {
        if(Pelem.tagName.toLowerCase() == 'iframe') {
          keymanweb._AttachToIframe(Pelem);
        } else { 
          baseElement.className = baseElement.className ? baseElement.className + ' keymanweb-font' : 'keymanweb-font';
          keymanweb.inputList.push(Pelem);

          util.attachDOMEvent(baseElement,'focus', keymanweb._ControlFocus);
          util.attachDOMEvent(baseElement,'blur', keymanweb._ControlBlur);

          // These need to be on the actual input element, as otherwise the keyboard will disappear on touch.
          Pelem.onkeypress = keymanweb._KeyPress;
          Pelem.onkeydown = keymanweb._KeyDown;
          Pelem.onkeyup = keymanweb._KeyUp;      
        }
      } 
    }; 

    /**
     * Function     disableInputElement
     * Scope        Private
     * @param       {Element}   Pelem   An element from the document to be enabled with full KMW handling.
     * @param       {boolean=}   isAlias A flag that indicates if the element is a simulated input element for touch.
     * Description  Inverts the process of enableInputElement, removing all event-handling from the element.
     *              Note that the 'kmw-disabled' property is managed by the MutationObserver and by the surface API calls.
     */       
    keymanweb.disableInputElement = function(Pelem, isAlias) { 
      var baseElement = isAlias ? Pelem['base'] : Pelem;
      // Do NOT test for pre-disabledness - we also use this to fully detach without officially 'disabling' via kmw-disabled.
      if(Pelem.tagName.toLowerCase() == 'iframe') {
        keymanweb._DetachFromIframe(Pelem);
      } else { 
        var cnIndex = baseElement.className.indexOf('keymanweb-font');
        if(cnIndex > 0 && !isAlias) { // See note about the alias below.
          baseElement.className = baseElement.className.replace('keymanweb-font', '').trim();
        }

        // Remove the element from our internal input tracking.
        var index = keymanweb.inputList.indexOf(Pelem);
        if(index > -1) {
          keymanweb.inputList.splice(index, 1);
        }

        if(!isAlias) { // See note about the alias below.
          util.detachDOMEvent(baseElement,'focus', keymanweb._ControlFocus);
          util.detachDOMEvent(baseElement,'blur', keymanweb._ControlBlur);
        }
        // These need to be on the actual input element, as otherwise the keyboard will disappear on touch.
        Pelem.onkeypress = null;
        Pelem.onkeydown = null;
        Pelem.onkeyup = null;      
      }

      // If we're disabling an alias, we should fully enable the base version.  (Thinking ahead to toggleable-touch mode.)
      if(isAlias) {
        keymanweb.inputList.push(baseElement);

        baseElement.onkeypress = keymanweb._KeyPress;
        baseElement.onkeydown = keymanweb._KeyDown;
        baseElement.onkeyup = keymanweb._KeyUp;  
      }
      return;
    };

    /**
     * Get the user-specified (or default) font for the first mapped input or textarea element
     * before applying any keymanweb styles or classes
     * 
     *  @return   {string}
     **/                 
    keymanweb.getBaseFont = function()
    {
      var ipInput = document.getElementsByTagName('INPUT'),
          ipTextArea=document.getElementsByTagName('TEXTAREA'),
          n=0,fs,fsDefault='Arial,sans-serif';
      
      if(ipInput.length == 0 && ipTextArea.length == 0) n=0;
      else if(ipInput.length > 0 && ipTextArea.length == 0) n=1;
      else if(ipInput.length == 0 && ipTextArea.length > 0) n=2;
      else {
        var firstInput = <HTMLInputElement>(<any>ipInput[0]);
        var firstTextArea = <HTMLTextAreaElement>(<any>ipTextArea[0]);

        if(firstInput.offsetTop < firstTextArea.offsetTop) {
          n=1;    
        } else if(firstInput.offsetTop > firstTextArea.offsetTop) {
          n=2;
        } else if(firstInput.offsetLeft < firstTextArea.offsetLeft) {
          n=1;    
        } else if(firstInput.offsetLeft > firstTextArea.offsetLeft) {
          n=2;
        }
      }
      
      switch(n)
      {
        case 0:
          fs=fsDefault;
        case 1:     
          fs=util.getStyleValue(ipInput[0],'font-family');
        case 2:       
          fs=util.getStyleValue(ipTextArea[0],'font-family');
      }
      if(typeof(fs) == 'undefined' || fs == 'monospace') fs=fsDefault;
      
      return fs;
    }
  
    /**
     * Input element stub functions, redefined when a touch device is initialized
     */  
      
    /**
     * Function stub, for desktop browsers
     *    
     * @param       {Event=}        e     event
     */       
    keymanweb.setFocus = function(e){};
    keymanweb.timerID = null;
    
    /**
     * Function stub, for desktop browsers
     *    
     * @param       {Object}        e     element (object) or element id (string) of simulated input field
     * @return      {string}              entire text in simulated input field
     */       
    keymanweb.getText = function(e){return '';};
    
    /**
     * Function stub, for desktop browsers
     *    
     * @param       {Object}        e     element (object) or element id (string) of simulated input field
     * @param       {?string}       t     text to insert in element
     * @param       {?number}       cp    caret position (characters)     
     */       
    keymanweb.setText = function(e,t,cp){};
    
    /**
     * Function stub, for desktop browsers
     *    
     * @return      {string}   
     */       
    keymanweb.getTextBeforeCaret = function(){return '';};

    /**
     * Function stub, for desktop browsers
     *    
     * @param       {Object}        e     element (object) or element id (string) of simulated input field
     * @return      {string}              Context for simulated input field
     */       
    keymanweb.setTextBeforeCaret = function(e){};

    /**
     * Function stub, for desktop browsers
     *    
     * @param       {Object}        e     element (object) or element id (string) of simulated input field
     * @return      {number}              caret character position in simulated input field
     */       
    keymanweb.getTextCaret = function(e){return 0;};
    
    /**
     * Function stub, for desktop browsers
     *    
     * @param       {Object}        e     element (object) or element id (string) of simulated input field
     * @param       {number}        cp    caret character position in simulated input field
     */       
    keymanweb.setTextCaret = function(e,cp){};
    
    /**
     * Function stub, for desktop browser    
     */       
    keymanweb.hideCaret = function(){};
    
    /**
     * Function stub, for desktop browsers    
     */       
    keymanweb.flashCaret = function(){};

    /**
     * Function stub, for desktop browsers
     *    
     * @param       {Object}        x     element
     */       
    keymanweb.updateInput=function(x){};
  
    // End of I3363 (Build 301) additions

    /**
     * Function     resetContext
     * Scope        Public
     * Description  Revert OSK to default layer and clear any deadkeys and modifiers
     */
    keymanweb['resetContext'] = keymanweb.resetContext = function() {
      osk.layerId = 'default';

      kbdInterface.clearDeadkeys();
      kbdInterface.resetContextCache();
      keymanweb._ResetVKShift();

      osk._Show();
    };

    /**
     * Exposed function to load keyboards by name. One or more arguments may be used
     * 
     * @param {string|Object} x keyboard name string or keyboard metadata JSON object
     * 
     */  
    keymanweb['addKeyboards'] = function(x) {                       
      if(arguments.length == 0) {
        keymanweb.keyboardManager.keymanCloudRequest('',false);
      } else {
        keymanweb.keyboardManager.addKeyboardArray(arguments);
      }
    }
    
    /**
     *  Add default or all keyboards for a given language
     *  
     *  @param  {string}   arg    Language name (multiple arguments allowed)
     **/           
    keymanweb['addKeyboardsForLanguage'] = function(arg)
    {
      keymanweb.keyboardManager.addLanguageKeyboards(arguments);
    }
    
    /**
     * Call back from cloud for adding keyboard metadata
     * 
     * @param {Object}    x   metadata object
     **/                  
    keymanweb['register'] = function(x) {                     
      keymanweb.keyboardManager.register(x);
    }

    /**
     * Build 362: removeKeyboards() remove keyboard from list of available keyboards
     * 
     * @param {string} x keyboard name string
     * 
     */  
    keymanweb['removeKeyboards'] = function(x) {
      return keymanweb.keyboardManager.removeKeyboards(x);
    }


    
    /**
     * Browser dependent initialization
     */       
    if(document.selection)          // only defined for IE
    {
      var appVer=navigator.appVersion;
    // Legacy support variables
      if(appVer.indexOf('MSIE 6.0') >= 0) keymanweb._IE = 6;
      else if(appVer.indexOf('MSIE 7.0') >= 0) keymanweb._IE = 7;
      else if(appVer.indexOf('MSIE 8.0') >= 0) keymanweb._IE = 8;
      if(keymanweb._IE && document.compatMode=='BackCompat') keymanweb._IE = 6;
    }

    // I732 START - Support for European underlying keyboards #1
    if(typeof(window['KeymanWeb_BaseLayout']) !== 'undefined') 
      osk._BaseLayout = window['KeymanWeb_BaseLayout'];
    else
      osk._BaseLayout = 'us';    
    
    
    keymanweb._BrowserIsSafari = (navigator.userAgent.indexOf('AppleWebKit') >= 0);  // I732 END - Support for European underlying keyboards #1 

    /**
     * Function     _GetEventObject
     * Scope        Private   
     * @param       {Event=}     e     Event object if passed by browser
     * @return      {Event|null}       Event object              
     * Description Gets the event object from the window when using Internet Explorer
     *             and handles getting the event correctly in frames 
     */     
    keymanweb._GetEventObject=function(e)   // I2404 - Attach to controls in IFRAMEs
    {
      if (!e) {
        e = window.event;
        if(!e) {
          var elem = keymanweb._GetLastActiveElement();
          if(elem) {
            elem = elem.ownerDocument;
            if(elem) {
              elem = elem.parentWindow;
            }
            if(!elem) {
              return null;
            }
            e = elem.event;
          }
        }
      }
      return e;    
    }

    /**
     * Function     _push
     * Scope        Private   
     * @param       {Array}     Parray    Array   
     * @param       {*}         Pval      Value to be pushed or appended to array   
     * @return      {Array}               Returns extended array
     * Description  Push (if possible) or append a value to an array 
     */  
    keymanweb._push = function(Parray, Pval)
    {
      if(Parray.push) Parray.push(Pval);
      else Parray=Parray.concat(Pval);
      return Parray;
    }
    
    /**
     * Function     attachToControl
     * Scope        Public
     * @param       {Element}    Pelem       Element to which KMW will be attached
     * Description  Attaches KMW to control (or IFrame) 
     */  
    keymanweb['attachToControl'] = keymanweb.attachToControl = function(Pelem)
    {
      if(keymanweb.isAttached(Pelem)) {
        return; // We're already attached.
      }

      if(keymanweb.isKMWInput(Pelem)) {
        keymanweb.setupElementAttachment(Pelem);
        if(!keymanweb.isKMWDisabled(Pelem)) {
          if(device.touchable) {
            keymanweb.enableTouchElement(Pelem);
          } else {
            keymanweb.enableInputElement(Pelem);
          }
        } else {
          if(device.touchable) {
            keymanweb.setupNonKMWTouchElement(Pelem);
          }
        }
      } else if(device.touchable) {
        keymanweb.setupNonKMWTouchElement(Pelem);
      }
    }

    /**
     * Function     detachFromControl
     * Scope        Public
     * @param       {Element}    Pelem       Element from which KMW will detach
     * Description  Detaches KMW from a control (or IFrame) 
     */  
    keymanweb['detachFromControl'] = keymanweb.detachFromControl = function(Pelem)
    {
      if(!keymanweb.isAttached(Pelem)) {
        return;  // We never were attached.
      }

      // #1 - if element is enabled, disable it.  But don't manipulate the 'kmw-disabled' tag.
      if(keymanweb.isKMWInput(Pelem)) {
        // Is it already disabled?
        if(!keymanweb.isKMWDisabled(Pelem)) {
          keymanweb._DisableControl(Pelem);
        } 
      }

      // #2 - clear attachment data.      
      keymanweb.clearElementAttachment(Pelem);
    }
        
    /**
     * Function     _AttachToIframe
     * Scope        Private
     * @param       {Element}      Pelem       IFrame to which KMW will be attached
     * Description  Attaches KeymanWeb to IFrame 
     */  
    keymanweb._AttachToIframe = function(Pelem)
    {      
      try
      {
        var Lelem=Pelem.contentWindow.document;
        /* editable Iframe */
        if(Lelem)
        {
          if(Lelem.parentWindow)
          {
            // Internet Explorer
            if(Lelem.designMode.toLowerCase() == 'on' || Lelem.body.isContentEditable)   // I1295 - fix non-attachment for some forms of IFRAMEs
            {
              // I1480 - Attach to IFRAME instead of document
              util.attachDOMEvent(Pelem,'focus', keymanweb._ControlFocus);
              util.attachDOMEvent(Pelem,'blur', keymanweb._ControlBlur);
              util.attachDOMEvent(Lelem,'keydown', keymanweb._KeyDown);   // I2404 - Update for attaching to elements within IFRAMEs, don't attach to read-only IFRAMEs
              util.attachDOMEvent(Lelem,'keypress', keymanweb._KeyPress);
              util.attachDOMEvent(Lelem,'keyup', keymanweb._KeyUp);
              
              // I1481 - Attach to the selectionchange in the iframe (and do a selchange to get the new selection)
              /* IE: call _SelectionChange when the user changes the selection */
              util.attachDOMEvent(Lelem, 'selectionchange', keymanweb._SelectionChange);
              keymanweb._SelectionChange();
              
            }
            else {
              // Lelem is the IFrame's internal document; set 'er up!
              keymanweb._SetupDocument(Lelem);
            }
          }
          else
          {
            if(Lelem.designMode.toLowerCase() == 'on')
            {
              // Mozilla      // I2404 - Attach to  IFRAMEs child objects, only editable IFRAMEs here
              util.attachDOMEvent(Lelem,'focus', keymanweb._ControlFocus);
              util.attachDOMEvent(Lelem,'blur', keymanweb._ControlBlur);
              util.attachDOMEvent(Lelem,'keydown', keymanweb._KeyDown);
              util.attachDOMEvent(Lelem,'keypress', keymanweb._KeyPress);
              util.attachDOMEvent(Lelem,'keyup', keymanweb._KeyUp);
            }
            else
            {
              // Lelem is the IFrame's internal document; set 'er up!
              keymanweb._SetupDocument(Lelem);	   // I2404 - Manage IE events in IFRAMEs
            }
          }
        }
      }
      catch(err)
      {
        // do not attempt to attach to the iframe as it is from another domain - XSS denied!
      }  
    }

        /**
     * Function     _DetachFromIframe
     * Scope        Private
     * @param       {Element}      Pelem       IFrame to which KMW will be attached
     * Description  Detaches KeymanWeb from an IFrame 
     */  
    keymanweb._DetachFromIframe = function(Pelem)
    {      
      try
      {
        var Lelem=Pelem.contentWindow.document;
        /* editable Iframe */
        if(Lelem)
        {
          if(Lelem.parentWindow)
          {
            // Internet Explorer
            if(Lelem.designMode.toLowerCase() == 'on' || Lelem.body.isContentEditable)   // I1295 - fix non-attachment for some forms of IFRAMEs
            {
              // I1480 - Attach to IFRAME instead of document
              util.detachDOMEvent(Pelem,'focus', keymanweb._ControlFocus);
              util.detachDOMEvent(Pelem,'blur', keymanweb._ControlBlur);
              util.detachDOMEvent(Lelem,'keydown', keymanweb._KeyDown);   // I2404 - Update for attaching to elements within IFRAMEs, don't attach to read-only IFRAMEs
              util.detachDOMEvent(Lelem,'keypress', keymanweb._KeyPress);
              util.detachDOMEvent(Lelem,'keyup', keymanweb._KeyUp);
              
              // I1481 - Attach to the selectionchange in the iframe (and do a selchange to get the new selection)
              /* IE: call _SelectionChange when the user changes the selection */
              util.detachDOMEvent(Lelem, 'selectionchange', keymanweb._SelectionChange);
              keymanweb._SelectionChange();
            }
            else {
              // Lelem is the IFrame's internal document; set 'er up!
              keymanweb._ClearDocument(Lelem);
            }
          }
          else
          {
            if(Lelem.designMode.toLowerCase() == 'on')
            {
              // Mozilla      // I2404 - Attach to  IFRAMEs child objects, only editable IFRAMEs here
              util.detachDOMEvent(Lelem,'focus', keymanweb._ControlFocus);
              util.detachDOMEvent(Lelem,'blur', keymanweb._ControlBlur);
              util.detachDOMEvent(Lelem,'keydown', keymanweb._KeyDown);
              util.detachDOMEvent(Lelem,'keypress', keymanweb._KeyPress);
              util.detachDOMEvent(Lelem,'keyup', keymanweb._KeyUp);
            }
            else
            {
              // Lelem is the IFrame's internal document; set 'er up!
              keymanweb._ClearDocument(Lelem);	   // I2404 - Manage IE events in IFRAMEs
            }
          }
        }
      }
      catch(err)
      {
        // do not attempt to attach to the iframe as it is from another domain - XSS denied!
      }  
    }
      
    /**
     * Function     GetEnabled
     * Scope        Private
     * @return      {boolean}      True if KMW enabled
     * Description Test if KMW enabled 
     */    
    keymanweb.GetEnabled = function()
    {
      return keymanweb._Enabled;
    }
    
    /**
     * Function     SetEnabled
     * Scope        Private
     * @param       {(boolean|number)}     Pvalue   True to enable KMW
     * Description  Enable or disable KMW
     */    
    keymanweb.SetEnabled = function(Pvalue)
    {
      if(Pvalue) Pvalue=1; else Pvalue=0;
      if(keymanweb._Enabled != Pvalue)
      {
        keymanweb._Enabled = Pvalue;
        if((!Pvalue) && keymanweb['HideInterface']) keymanweb['HideInterface'](); //JMD 3/9/10
      }
    }  
    
    /**
     * Function     disableControl
     * Scope        Public
     * @param       {Element}      Pelem       Element to be disabled
     * Description  Disables a KMW control element 
     */    
    keymanweb['disableControl'] = keymanweb.disableControl = function(Pelem) {
      if(!keymanweb.isAttached(Pelem)) {
        console.warn("KeymanWeb is not attached to element " + Pelem);
      } 

      var cn = Pelem.className;
      if(cn.indexOf('kmw-disabled') < 0) { // if not already explicitly disabled...
        Pelem.className = cn ? cn + ' kmw-disabled' : 'kmw-disabled';
      }

      // The rest is triggered within MutationObserver code.
      // See keymanweb._EnablementMutationObserverCore.
    }

    /**
     * Function     enableControl
     * Scope        Public
     * @param       {Element}      Pelem       Element to be disabled
     * Description  Disables a KMW control element 
     */    
    keymanweb['enableControl'] = keymanweb.enableControl = function(Pelem) {
      if(!keymanweb.isAttached(Pelem)) {
        console.warn("KeymanWeb is not attached to element " + Pelem);
      } 

      var cn = Pelem.className;
      var tagIndex = cn.indexOf('kmw-disabled');
      if(tagIndex >= 0) { // if already explicitly disabled...
        Pelem.className = cn.replace('kmw-disabled', '').trim();
      }

      // The rest is triggered within MutationObserver code.
      // See keymanweb._EnablementMutationObserverCore.
    }

    /**
     * Function     _DisableControl
     * Scope        Private
     * @param       {Element}      Pelem       Element to be disabled
     * Description  Disable KMW control element 
     */    
    keymanweb._DisableControl = function(Pelem) {
      if(keymanweb.isAttached(Pelem)) { // Only operate on attached elements!  
        if(keymanweb._LastActiveElement == Pelem || keymanweb._LastActiveElement == Pelem['kmw_ip']) {
          keymanweb._LastActiveElement = null;
          keymanweb.keyboardManager.setActiveKeyboard(keymanweb.globalKeyboard, keymanweb.globalLanguageCode);
          keymanweb['osk']._Hide();
        }
        
        if(device.touchable) {
          keymanweb.disableTouchElement(Pelem);
          keymanweb.setupNonKMWTouchElement(Pelem);
        
          // If a touch alias was removed, chances are it's gonna mess up our touch-based layout scheme, so let's update the touch elements.
          window.setTimeout(function() {
            keymanweb.listInputs();

            for(var k = 0; k < keymanweb.sortedInputs.length; k++) {
              if(keymanweb.sortedInputs[k]['kmw_ip']) {
                keymanweb.updateInput(keymanweb.sortedInputs[k]['kmw_ip']);
              }
            }
          }, 1);
        } else {
          keymanweb.listInputs(); // Fix up our internal input ordering scheme.
        }
        
        keymanweb.disableInputElement(Pelem);
      }
    }

    /**
     * Function     _EnableControl
     * Scope        Private
     * @param       {Element}    Pelem   Element to be enabled
     * Description  Enable KMW control element 
     */    
    keymanweb._EnableControl = function(Pelem) {
      if(keymanweb.isAttached(Pelem)) { // Only operate on attached elements!
        if(device.touchable) {
          keymanweb.enableTouchElement(Pelem);

          // If we just added a new input alias, some languages will mess up our touch-based layout scheme
          // if we don't update the touch elements.
          window.setTimeout(function() {
            keymanweb.listInputs();

            for(var k = 0; k < keymanweb.sortedInputs.length; k++) {
              if(keymanweb.sortedInputs[k]['kmw_ip']) {
                keymanweb.updateInput(keymanweb.sortedInputs[k]['kmw_ip']);
              }
            }
          }, 1);
        } else {
          keymanweb.enableInputElement(Pelem);
        }
      }
    }
    
    /**
     * Function     setKeyboardForControl
     * Scope        Public   
     * @param       {Element}    Pelem    Control element 
     * @param       {string|null=}    Pkbd     Keyboard (Clears the set keyboard if set to null.)  
     * @param       {string|null=}     Plc      Language Code
     * Description  Set default keyboard for the control 
     */    
    keymanweb['setKeyboardForControl'] = keymanweb.setKeyboardForControl = function(Pelem, Pkbd, Plc) {
      /* pass null for kbd to specify no default, or '' to specify the default system keyboard. */
      if(Pkbd !== null && Pkbd !== undefined) {
        var index = Pkbd.indexOf("Keyboard_");
        if(index < 0 && Pkbd != '') {
          Pkbd = "Keyboard_" + Pkbd;
        }
      } else {
        Plc = null;
      }

      if(Pelem.tagName.toLowerCase() == "iframe") {
        console.warn("'keymanweb.setKeyboardForControl' cannot set keyboard on iframes.");
        return;
      }

      if(!keymanweb.isAttached(Pelem)) {
        console.error("KeymanWeb is not attached to element " + Pelem);
        return;
      } else {
        Pelem._kmwAttachment.keyboard = Pkbd;
        Pelem._kmwAttachment.languageCode = Plc;

        // If Pelem is the focused element/active control, we should set the keyboard in place now.
        // 'kmw_ip' is the touch-alias for the original page's control.
        if((keymanweb._LastActiveElement == Pelem || keymanweb._LastActiveElement == Pelem['kmw_ip']) 
            && keymanweb._LastActiveElement) {
            
          if(Pkbd != null && Plc != null) { // Second part necessary for Closure.
            keymanweb.keyboardManager.setActiveKeyboard(Pkbd, Plc);
          } 
        }
      }
    }

    /**
     * Function     getKeyboardForControl
     * Scope        Public   
     * @param       {Element}    Pelem    Control element 
     * @return      {string|null}         The independently-managed keyboard for the control.
     * Description  Returns the keyboard ID of the current independently-managed keyboard for this control.
     *              If it is currently following the global keyboard setting, returns null instead.
     */
    keymanweb['getKeyboardForControl'] = keymanweb.getKeyboardForControl = function(Pelem) {
      if(!keymanweb.isAttached(Pelem)) {
        console.error("KeymanWeb is not attached to element " + Pelem);
        return null;
      } else {
        return Pelem._kmwAttachment.keyboard;  // Should we have a version for the language code, too?
      }
    }
      
    /**
     * Set focus to last active target element (browser-dependent)
     */    
    keymanweb['focusLastActiveElement'] = keymanweb._FocusLastActiveElement = function()
    {
      if(!keymanweb._LastActiveElement) return;

      keymanweb._JustActivatedKeymanWebUI = 1;
      if(keymanweb._IsMozillaEditableIframe(keymanweb._LastActiveElement,0))
        keymanweb._LastActiveElement.defaultView.focus(); // I3363 (Build 301)
      else if(keymanweb._LastActiveElement.focus) keymanweb._LastActiveElement.focus();
    }
    
    /**
     * Get the last active target element *before* KMW activated (I1297)
     * 
     * @return      {Object}        
     */    
    keymanweb['getLastActiveElement'] = keymanweb._GetLastActiveElement = function()
    {
      return keymanweb._LastActiveElement;
    }

    /**
     *  Set the active input element directly optionally setting focus 
     * 
     *  @param  {Object|string} e         element id or element
     *  @param  {boolean=}      setFocus  optionally set focus  (KMEW-123) 
     **/
    keymanweb['setActiveElement']=keymanweb.setActiveElement=function(e,setFocus)
    {
      if(typeof(e) == 'string') e=document.getElementById(e);
      keymanweb._ActiveElement=keymanweb._LastActiveElement=e; 
      // Allow external focusing KMEW-123
      if(arguments.length > 1 && setFocus)
      {
        if(device.touchable) keymanweb.setFocus();
        else keymanweb['focusLastActiveElement']();
      }
    }
    
    /**
     * Function     getUIState
     * Scope        Public   
     * @return      {Object.<string,(boolean|number)>}
     * Description  Return object with activation state of UI:
     *                activationPending (bool):   KMW being activated
     *                activated         (bool):   KMW active    
     */    
    keymanweb['getUIState'] = keymanweb.getUIState = function() {
      var p={
        activationPending: keymanweb._IsActivatingKeymanWebUI,
        activated: keymanweb._JustActivatedKeymanWebUI
      };
      p['activationPending'] = p.activationPending;
      p['activated'] = p.activated;
      return p;
    }

    /**
     * Set or clear the IsActivatingKeymanWebUI flag (exposed function)
     * 
     * @param       {(boolean|number)}  state  Activate (true,false)
     */
    keymanweb['activatingUI'] = function(state)
    {
      keymanweb._IsActivatingKeymanWebUI = (state ? 1 : 0);
    }      

  //TODO: add more complete description of what ControlFocus really does

    /**
     * Respond to KeymanWeb-aware input element receiving focus 
     * 
     * @param       {Event}       e       Event object
     * @return      {boolean}             always true  (?) 
     */    
    keymanweb._ControlFocus = function(e) {
      var Ltarg, Ln;
      if(!keymanweb._Enabled) {
        return true;
      }
      e = keymanweb._GetEventObject(e);     // I2404 - Manage IE events in IFRAMEs
      Ltarg = util.eventTarget(e);
      if (Ltarg == null) {
        return true;
      }
    
      // Prevent any action if a protected input field
      if(device.touchable && (Ltarg.className == null || Ltarg.className.indexOf('keymanweb-input') < 0)) {
        return true;
      }

      // Or if not a remappable input field
      var en=Ltarg.nodeName.toLowerCase();
      if(en == 'input') {
        var et=Ltarg.type.toLowerCase();
        if(!(et == 'text' || et == 'search')) {
          return true;
        }
      } else if((device.touchable || !Ltarg.isContentEditable) && en != 'textarea') {
        return true;
      }

      keymanweb._ActiveElement=Ltarg;  // I3363 (Build 301)  

      if (Ltarg.nodeType == 3) { // defeat Safari bug
        Ltarg = Ltarg.parentNode;
      }
        
      var LfocusTarg = Ltarg;

      // Ensure that focussed element is visible above the keyboard
      if(device.touchable && (Ltarg.className == null || Ltarg.className.indexOf('keymanweb-input') < 0)) {
        keymanweb.scrollBody(Ltarg);
      }
          
      if(Ltarg.tagName=='IFRAME') { //**TODO: check case reference
        keymanweb._AttachToIframe(Ltarg);
        Ltarg=Ltarg.contentWindow.document;
      }
          
      //??keymanweb._Selection = null;

      // We condition on 'priorElement' below as a check to allow KMW to set a default active keyboard.
      var priorElement = keymanweb._LastActiveElement;
      keymanweb._LastActiveElement = Ltarg;

      if(keymanweb._JustActivatedKeymanWebUI) {
        keymanweb._BlurKeyboardSettings();
      } else {
        keymanweb._FocusKeyboardSettings(priorElement ? false : true);
      }

      // Always do the common focus stuff, instantly returning if we're in an editable iframe.
      if(keymanweb._CommonFocusHelper(Ltarg)) {
        return true;
      };

      Ltarg._KeymanWebSelectionStart = Ltarg._KeymanWebSelectionEnd = null; // I3363 (Build 301)

      // Set element directionality (but only if element is empty)
      keymanweb._SetTargDir(Ltarg); 

      //Execute external (UI) code needed on focus if required
      keymanweb.doControlFocused(LfocusTarg,keymanweb._LastActiveElement);
    
      // Force display of OSK for touch input device, or if a CJK keyboard, to ensure visibility of pick list
      if(device.touchable) {
        osk._Enabled=1;
      } else {
        // Conditionally show the OSK when control receives the focus
        if(osk.ready) {
          if(keymanweb.keyboardManager.isCJK()) {
            osk._Enabled=1;
          }
          if(osk._Enabled) {
            osk._Show();
          } else {
            osk._Hide(false);
          }
        }
      }

      return true;
    }  
    
    /**
     * Function             _BlurKeyboardSettings
     * Description          Stores the last active element's keyboard settings.  Should be called
     *                      whenever a KMW-enabled page element loses control.
     */
    keymanweb._BlurKeyboardSettings = function() {
      var keyboardID = keymanweb.keyboardManager.activeKeyboard ? keymanweb.keyboardManager.activeKeyboard['KI'] : '';
      
      if(keymanweb._LastActiveElement && keymanweb._LastActiveElement._kmwAttachment.keyboard != null) {
        keymanweb._LastActiveElement._kmwAttachment.keyboard = keyboardID;
        keymanweb._LastActiveElement._kmwAttachment.languageCode = keymanweb.getActiveLanguage();
      } else {
        keymanweb.globalKeyboard = keyboardID;
        keymanweb.globalLanguageCode = keymanweb.getActiveLanguage();
      }
    }

    /**
     * Function             _FocusKeyboardSettings
     * @param   {boolean}   blockGlobalChange   A flag indicating if the global keyboard setting should be ignored for this call.
     * Description          Restores the newly active element's keyboard settings.  Should be called
     *                      whenever a KMW-enabled page element gains control, but only once the prior
     *                      element's loss of control is guaranteed.
     */ 
    keymanweb._FocusKeyboardSettings = function(blockGlobalChange) {      
      if(keymanweb._LastActiveElement._kmwAttachment.keyboard != null) {      
        keymanweb.keyboardManager.setActiveKeyboard(keymanweb._LastActiveElement._kmwAttachment.keyboard, 
          keymanweb._LastActiveElement._kmwAttachment.languageCode); 
      } else if(!blockGlobalChange) { 
        keymanweb.keyboardManager.setActiveKeyboard(keymanweb.globalKeyboard, keymanweb.globalLanguageCode);
      }
    }

    /**
     * Function             _CommonFocusHelper
     * @param   {Element}   target 
     * @returns {boolean}
     * Description          Performs common state management for the various focus events of KeymanWeb.                      
     *                      The return value indicates whether (true) or not (false) the calling event handler 
     *                      should be terminated immediately after the call.
     */
    keymanweb._CommonFocusHelper = function(target) {
      //TODO: the logic of the following line doesn't look right!!  Both variables are true, but that doesn't make sense!
      //_Debug(keymanweb._IsIEEditableIframe(Ltarg,1) + '...' +keymanweb._IsMozillaEditableIframe(Ltarg,1));
      if(!keymanweb._IsIEEditableIframe(target,1) || !keymanweb._IsMozillaEditableIframe(target,1)) {
        keymanweb._DisableInput = 1; 
        return true;
      }
      keymanweb._DisableInput = 0;
  
      if(!keymanweb._JustActivatedKeymanWebUI) {
        keymanweb._DeadKeys = [];
        keymanweb._NotifyKeyboard(0,target,1);  // I2187
      }
    
      if(!keymanweb._JustActivatedKeymanWebUI  &&  keymanweb._SelectionControl != target) {
        keymanweb._IsActivatingKeymanWebUI = 0;
      }
      keymanweb._JustActivatedKeymanWebUI = 0;
  
      keymanweb._SelectionControl = target;
      return false;
    }
    
    /**
     * Function     _IsIEEditableIframe
     * Scope        Private
     * @param       {Object}          Pelem         Iframe element
     *              {boolean|number}  PtestOn       1 to test if frame content is editable (TODO: unclear exactly what this is doing!)   
     * @return      {boolean}
     * Description  Test if element is an IE editable IFrame 
     */    
    keymanweb._IsIEEditableIframe = function(Pelem,PtestOn)
    {
      var Ldv, Lvalid = Pelem  &&  (Ldv=Pelem.tagName)  &&  Ldv.toLowerCase() == 'body'  &&  (Ldv=Pelem.ownerDocument)  &&  Ldv.parentWindow;
      return (!PtestOn  &&  Lvalid) || (PtestOn  &&  (!Lvalid || Pelem.isContentEditable));
    }

    /**
     * Function     _IsMozillaEditableIframe
     * Scope        Private
     * @param       {Object}           Pelem    Iframe element
     * @param       {boolean|number}   PtestOn  1 to test if 'designMode' is 'ON'    
     * @return      {boolean} 
     * Description  Test if element is a Mozilla editable IFrame 
     */    
    keymanweb._IsMozillaEditableIframe = function(Pelem,PtestOn)
    {
      var Ldv, Lvalid = Pelem  &&  (Ldv=Pelem.defaultView)  &&  Ldv.frameElement;
      return (!PtestOn  &&  Lvalid) || (PtestOn  &&  (!Lvalid || Ldv.document.designMode.toLowerCase()=='on'));
    }
      
    /**
     * Respond to KMW losing focus on event
     * 
     * @param       {Event}       e       Event object
     * @return      {boolean}             Always true  (?) 
     */    
    keymanweb._ControlBlur = function(e) {
      var Ltarg;  

      if(!keymanweb._Enabled) {
        return true;
      }

      e = keymanweb._GetEventObject(e);   // I2404 - Manage IE events in IFRAMEs
      Ltarg = util.eventTarget(e);
      if (Ltarg == null) {
        return true;
      }

      keymanweb._ActiveElement = null; // I3363 (Build 301)

      // Hide the touch device input caret, if applicable  I3363 (Build 301)
      if(device.touchable) {
        keymanweb.hideCaret();
      }
          
      if (Ltarg.nodeType == 3) { // defeat Safari bug
        Ltarg = Ltarg.parentNode;
      }

      if(Ltarg.tagName=='IFRAME') {
        Ltarg=Ltarg.contentWindow.document;
      }
        
      if (Ltarg.setSelectionRange) {                                           
        //Ltarg._KeymanWebSelectionStart = Ltarg.selectionStart;
        //Ltarg._KeymanWebSelectionEnd = Ltarg.selectionEnd;
        Ltarg._KeymanWebSelectionStart = Ltarg.value._kmwCodeUnitToCodePoint(Ltarg.selectionStart);  //I3319
        Ltarg._KeymanWebSelectionEnd = Ltarg.value._kmwCodeUnitToCodePoint(Ltarg.selectionEnd);  //I3319
        
      }
      
      ////keymanweb._SelectionControl = null;    
      keymanweb._BlurKeyboardSettings();

      // Now that we've handled all prior-element maintenance, update the 'last active element'.
      keymanweb._LastActiveElement = Ltarg;

      /* If the KeymanWeb UI is active as a user changes controls, all UI-based effects should be restrained to this control in case
      * the user is manually specifying languages on a per-control basis.
      */
      keymanweb._JustActivatedKeymanWebUI = 0;
      
      if(!keymanweb._IsActivatingKeymanWebUI) {
        keymanweb._NotifyKeyboard(0,Ltarg,0);  // I2187
      }

      e = keymanweb._GetEventObject(e);   // I2404 - Manage IE events in IFRAMEs  //TODO: is this really needed again????
      keymanweb.doControlBlurred(Ltarg,e,keymanweb._IsActivatingKeymanWebUI);

      // Hide the OSK when the control is blurred, unless the UI is being temporarily selected
      if(osk.ready && !keymanweb._IsActivatingKeymanWebUI) {
        osk._Hide(false);
      }

      return true;
    }

    /****************************************************************
     *  
     * Provide for external processing on events
     *    
     ***************************************************************/     
    
    /**
     * Function     doControlBlurred
     * Scope        Private
     * @param       {Object}            _target       element losing focus
     * @param       {Event}             _event        event object
     * @param       {(boolean|number)}  _isActivating activation state
     * @return      {boolean}      
     * Description  Execute external (UI) code needed on blur
     */       
    keymanweb.doControlBlurred = function(_target,_event,_isActivating)
    {
      var p={}; p['target']=_target; p['event']=_event; p['isActivating']=_isActivating;
      return util.callEvent('kmw.controlblurred',p);
    }

    /**
     * Function     doControlFocused
     * Scope        Private
     * @param       {Object}            _target         element gaining focus
     * @param       {Object}            _activeControl  currently active control
     * @return      {boolean}   
     * Description  Execute external (UI) code needed on focus
     */       
    keymanweb.doControlFocused = function(_target,_activeControl)
    {
      var p={}; p['target']=_target; p['activeControl']=_activeControl;  
      return util.callEvent('kmw.controlfocused',p);
    }

    /**
     * Function     doUnloadOSK
     * Scope        Private
     * @return      {boolean}   
     * Description  Execute external (UI) code if any needed after unloading OSK (probably not required)
     */       
    keymanweb.doUnloadOSK = function()
    {
      var p={};
      return util.callEvent('kmw.unloadosk',p);
    }

    /**
     * Function     doLoadUI
     * Scope        Private
     * @return      {boolean}   
     * Description  Execute UI initialization code after loading the UI
     */       
    keymanweb.doLoadUI = function()
    {
      var p={};
      return util.callEvent('kmw.loaduserinterface',p);
    }

    /**
     * Function     doUnloadUI
     * Scope        Private
     * @return      {boolean}   
     * Description  Execute UI cleanup code before unloading the UI (may not be required?)
     */       
    keymanweb.doUnloadUI = function()
    {
      var p={};
      return util.callEvent('kmw.unloaduserinterface',p);
    }

    /*****************************************************************************
     *  
     * Provide for handling the initial focus event differently
     * The first focus event can happen before we get the WindowLoad, 
     * e.g. if the page activates a control on WindowLoad itself,
     * so trap that and run it through to the page 
     * 
     *****************************************************************************/

    /**
     * Function     _BubbledFocus
     * Scope        Private
     * @param       {Event}       e         Event object
     * Description  Respond to KMW receiving bubbled focus on event (TODO: may not be needed, not currently doing anything) 
     */    
    keymanweb._BubbledFocus = function(e) { /*KeymanWeb._WindowLoad(e);*/ }
      
    if (window.addEventListener)
      window.addEventListener('focus', keymanweb._BubbledFocus, true);  

    /**
     * Function     _GetEventKeyCode
     * Scope        Private
     * @param       {Event}       e         Event object
     * Description  Finds the key code represented by the event.
     */
    keymanweb._GetEventKeyCode = function(e) {
      if (e.keyCode) {
        return e.keyCode;
      } else if (e.which) {
        return e.which;
      } else {
        return null;
      }
    }

    /**
     * Function     _GetKeyEventProperties
     * Scope        Private
     * @param       {Event}       e         Event object
     * @param       {boolean=}    keyState  true if call results from a keyDown event, false if keyUp, undefined if keyPress
     * @return      {Object.<string,*>}     KMW keyboard event object: 
     * Description  Get object with target element, key code, shift state, virtual key state 
     *                Ltarg=target element
     *                Lcode=keyCode
     *                Lmodifiers=shiftState
     *                LisVirtualKeyCode e.g. ctrl/alt key
     *                LisVirtualKey     e.g. Virtual key or non-keypress event
     */    
    keymanweb._GetKeyEventProperties = function(e, keyState) {
      class KeyEvent {
        Ltarg: any;
        Lcode: any;
        Lstates: any;
        LmodifierChange: any;
        Lmodifiers: any;
        LisVirtualKeyCode: any;
        LisVirtualKey: any;
      };

      var s = new KeyEvent();

      e = keymanweb._GetEventObject(e);   // I2404 - Manage IE events in IFRAMEs
      s.Ltarg = util.eventTarget(e);
      if (s.Ltarg == null) {
        return null;
      }
      if(e.cancelBubble === true) {
        return null; // I2457 - Facebook meta-event generation mess -- two events generated for a keydown in Facebook contentEditable divs
      }      

      if (s.Ltarg.nodeType == 3) {// defeat Safari bug
        s.Ltarg = s.Ltarg.parentNode;
      }

      s.Lcode = keymanweb._GetEventKeyCode(e);
      if (s.Lcode == null) {
        return null;
      }
      
      // Stage 1 - track the true state of the keyboard's modifiers.
      var osk = keymanweb['osk'], prevModState = keymanweb.modStateFlags, curModState = 0x0000;
      var ctrlEvent = false, altEvent = false;
      
      switch(s.Lcode) {
        case osk.keyCodes['K_CTRL']:      // The 3 shorter "K_*CTRL" entries exist in some legacy keyboards.
        case osk.keyCodes['K_LCTRL']:
        case osk.keyCodes['K_RCTRL']:
        case osk.keyCodes.K_CONTROL:
        case osk.keyCodes.K_LCONTROL:
        case osk.keyCodes.K_RCONTROL:
          ctrlEvent = true;
          break;
        case osk.keyCodes['K_LMENU']:     // The 2 "K_*MENU" entries exist in some legacy keyboards.
        case osk.keyCodes['K_RMENU']:
        case osk.keyCodes.K_ALT:
        case osk.keyCodes.K_LALT:
        case osk.keyCodes.K_RALT:
          altEvent = true;
          break;
      }

      /**
       * Two separate conditions exist that should trigger chiral modifier detection.  Examples below use CTRL but also work for ALT.
       * 
       * 1.  The user literally just pressed CTRL, so the event has a valid `location` property we can utilize.  
       *     Problem: its layer isn't presently activated within the OSK.
       * 
       * 2.  CTRL has been held a while, so the OSK layer is valid, but the key event doesn't tell us the chirality of the active CTRL press.
       *     Bonus issue:  RAlt simulation may cause erasure of this location property, but it should ONLY be empty if pressed in this case.
       *     We default to the 'left' variants since they're more likely to exist and cause less issues with RAlt simulation handling.
       * 
       * In either case, `e.ctrlKey` is set to true, but as a result does nothing to tell us which case is active.
       * 
       * `e.location != 0` if true matches condition 1 and matches condition 2 if false.
       */

      curModState |= (e.shiftKey ? 0x10 : 0);      

      if(e.ctrlKey) {
        curModState |= ((e.location != 0 && ctrlEvent) ? 
          (e.location == 1 ? osk.modifierCodes.LCTRL : osk.modifierCodes.RCTRL) : // Condition 1
          prevModState & 0x0003);                                                       // Condition 2
      }
      if(e.altKey) {
        curModState |= ((e.location != 0 && altEvent) ? 
          (e.location == 1 ? osk.modifierCodes.LALT : osk.modifierCodes.RALT) :   // Condition 1
          prevModState & 0x000C);                                                       // Condition 2
      }

      // Stage 2 - detect state key information.  It can be looked up per keypress with no issue.
      s.Lstates = 0;
      
      if(e.getModifierState("CapsLock")) {
        s.Lstates = osk.modifierCodes.CAPS;
      } else {
        s.Lstates = osk.modifierCodes.NO_CAPS;
      }

      if(e.getModifierState("NumLock")) {
        s.Lstates |= osk.modifierCodes.NUM_LOCK;
      } else {
        s.Lstates |= osk.modifierCodes.NO_NUM_LOCK;
      }

      if(e.getModifierState("ScrollLock") || e.getModifierState("Scroll")) {  // "Scroll" for IE9.
        s.Lstates |= osk.modifierCodes.SCROLL_LOCK;
      } else {
        s.Lstates |= osk.modifierCodes.NO_SCROLL_LOCK;
      }

      // We need these states to be tracked as well for proper OSK updates.
      curModState |= s.Lstates;

      // Stage 3 - Set our modifier state tracking variable and perform basic AltGr-related management.
      s.LmodifierChange = keymanweb.modStateFlags != curModState;
      keymanweb.modStateFlags = curModState;

      // For European keyboards, not all browsers properly send both key-up events for the AltGr combo.
      var altGrMask = osk.modifierCodes.RALT | osk.modifierCodes.LCTRL;
      if((prevModState & altGrMask) == altGrMask && (curModState & altGrMask) != altGrMask) {
        // We just released AltGr - make sure it's all released.
        curModState &= ~ altGrMask;
      }
      // Perform basic filtering for Windows-based ALT_GR emulation on European keyboards.
      if(curModState & osk.modifierCodes.RALT) {
        curModState &= ~osk.modifierCodes.LCTRL;
      }

      // Stage 4 - map the modifier set to the appropriate keystroke's modifiers.
      if(keymanweb.isChiral()) {
        s.Lmodifiers = curModState & osk.modifierBitmasks.CHIRAL;

        // Note for future - embedding a kill switch here or in keymanweb.osk.emulatesAltGr would facilitate disabling
        // AltGr / Right-alt simulation.
        if(osk.emulatesAltGr() && (s.Lmodifiers & osk.modifierBitmasks.ALT_GR_SIM) == osk.modifierBitmasks.ALT_GR_SIM) {
          s.Lmodifiers ^= osk.modifierBitmasks.ALT_GR_SIM;
          s.Lmodifiers |= osk.modifierCodes.RALT;
        }
      } else {
        // No need to sim AltGr here; we don't need chiral ALTs.
        s.Lmodifiers = 
          (e.shiftKey ? 0x10 : 0) |
          ((curModState & (osk.modifierCodes.LCTRL | osk.modifierCodes.RCTRL)) ? 0x20 : 0) | 
          ((curModState & (osk.modifierCodes.LALT | osk.modifierCodes.RALT))   ? 0x40 : 0); 
      }

      // The 0x6F used to be 0x60 - this adjustment now includes the chiral alt and ctrl modifiers in that check.
      s.LisVirtualKeyCode = (typeof e.charCode != 'undefined' && e.charCode != null  &&  (e.charCode == 0 || (s.Lmodifiers & 0x6F) != 0));
      s.LisVirtualKey = s.LisVirtualKeyCode || e.type != 'keypress';
      
      return s;
    }

    /**
     * Function   _SelectionChange
     * Scope      Private
     * @return    {boolean} 
     * Description Respond to selection change event 
     */
    keymanweb._SelectionChange = function()
    {
      if(keymanweb._IgnoreNextSelChange)
      {
        keymanweb._IgnoreNextSelChange--;
      }
      else
      {
        var Ls=document.selection;
        if(Ls.type.toLowerCase()!='control') //  &&  document.selection.createRange().parentElement() == keymanweb._SelectionControl) //  &&  window.event.srcElement == keymanweb._SelectionControl)
        {
          var Lrange=Ls.createRange();
          if(!keymanweb._Selection || !keymanweb._Selection.isEqual(Lrange))
          {
            keymanweb._Selection = Lrange;

            /* Delete deadkeys for IE when certain keys pressed */
            kbdInterface.clearDeadkeys();
          }
        }
      }
      return true;
    }
    
    /**
     * Function     _NotifyKeyboard
     * Scope        Private
     * @param       {number}    _PCommand     event code (16,17,18) or 0
     * @param       {Object}    _PTarget      target element
     * @param       {number}    _PData        1 or 0    
     * Description  Notifies keyboard of keystroke or other event
     */    
    keymanweb._NotifyKeyboard = function(_PCommand,_PTarget,_PData) { // I2187
      var activeKeyboard = keymanweb.keyboardManager.activeKeyboard;

      if(activeKeyboard != null && typeof(activeKeyboard['KNS']) == 'function') {
        activeKeyboard['KNS'](_PCommand,_PTarget,_PData);
      }
    }
    
    
    /**
     * Function     _KeyDown
     * Scope        Private
     * @param       {Event}       e     event
     * @return      {boolean}           
     * Description  Processes keydown event and passes data to keyboard. 
     */ 
    keymanweb._KeyDown = function(e) {
      var Ldv,eClass='';
      var activeKeyboard = keymanweb.keyboardManager.activeKeyboard;

      keymanweb._KeyPressToSwallow = 0;
      if(!keymanweb._Enabled || keymanweb._DisableInput || activeKeyboard == null) {
        return true;
      }

      // Prevent mapping element is readonly or tagged as kmw-disabled
      var el=util.eventTarget(e);
      if(device.touchable) {
        if(el && typeof el.kmwInput != 'undefined' && el.kmwInput == false) {
          return true;
        }
      } else if(el && el.className.indexOf('kmw-disabled') >= 0) {
        return true; 
      }
      
      // Or if OSK not yet ready (for any reason)
      if(!osk.ready) {
        return true;
      }
      
      // Get event properties  
      var Levent = keymanweb._GetKeyEventProperties(e, true);
      if(Levent == null) {
        return true;
      }

      switch(Levent.Lcode) {
        case 8: 
          kbdInterface.clearDeadkeys();
          break; // I3318 (always clear deadkeys after backspace) 
        case 16: //"K_SHIFT":16,"K_CONTROL":17,"K_ALT":18
        case 17: 
        case 18: 
        case 20: //"K_CAPS":20, "K_NUMLOCK":144,"K_SCROLL":145
        case 144:
        case 145:
          // For eventual integration - we bypass an OSK update for physical keystrokes when in touch mode.
          keymanweb._NotifyKeyboard(Levent.Lcode,Levent.Ltarg,1); 
          if(!device.touchable) {
            return osk._UpdateVKShift(Levent, Levent.Lcode-15, 1); // I2187
          } else {
            return true;
          }
      }

      if(Levent.LmodifierChange) {
        keymanweb._NotifyKeyboard(0,Levent.Ltarg,1); 
        osk._UpdateVKShift(Levent, 0, 1);
      }
      
      // I1207
      if((Ldv=Levent.Ltarg.ownerDocument)  &&  (Ldv=Ldv.selection)  &&  (Levent.Lcode<33 || Levent.Lcode>40)) {
        Ldv.createRange().select();
      }

      if(!window.event) {
        // I1466 - Convert the - keycode on mnemonic as well as positional layouts
        // FireFox, Mozilla Suite
        if(keymanweb._VKMap_FF_IE['k'+Levent.Lcode]) {
          Levent.Lcode=keymanweb._VKMap_FF_IE['k'+Levent.Lcode];
        }
      }
      //else 
      //{
      // Safari, IE, Opera?
      //}
      
      if(!activeKeyboard['KM']) {
        // Positional Layout

        var LeventMatched=0;
        /* 13/03/2007 MCD: Swedish: Start mapping of keystroke to US keyboard */
        var Lbase=keymanweb._VKMap[osk._BaseLayout];
        if(Lbase && Lbase['k'+Levent.Lcode]) {
          Levent.Lcode=Lbase['k'+Levent.Lcode];
        }
        /* 13/03/2007 MCD: Swedish: End mapping of keystroke to US keyboard */
        
        if(typeof(activeKeyboard['KM'])=='undefined'  &&  !(Levent.Lmodifiers & 0x60)) {
          // Support version 1.0 KeymanWeb keyboards that do not define positional vs mnemonic
          var Levent2={Lcode:keymanweb._USKeyCodeToCharCode(Levent),Ltarg:Levent.Ltarg,Lmodifiers:0,LisVirtualKey:0};
          if(kbdInterface.processKeystroke(util.physicalDevice, Levent2.Ltarg,Levent2)) {
            LeventMatched=1;
          }
        }
        
        LeventMatched = LeventMatched || kbdInterface.processKeystroke(util.physicalDevice,Levent.Ltarg,Levent);
        
        // Support backspace in simulated input DIV from physical keyboard where not matched in rule  I3363 (Build 301)
        if(Levent.Lcode == 8 && !LeventMatched && Levent.Ltarg.className != null && Levent.Ltarg.className.indexOf('keymanweb-input') >= 0) {
          kbdInterface.output(1,keymanweb._LastActiveElement,"");
        }
      } else {
        // Mnemonic layout
        if(Levent.Lcode == 8) { // I1595 - Backspace for mnemonic
          keymanweb._KeyPressToSwallow = 1;
          if(!kbdInterface.processKeystroke(util.physicalDevice,Levent.Ltarg,Levent)) {
            kbdInterface.output(1,keymanweb._LastActiveElement,""); // I3363 (Build 301)
          }
          return false;  //added 16/3/13 to fix double backspace on mnemonic layouts on desktop
        }
        else {
          keymanweb._KeyPressToSwallow = 0;
        }
      }

      if(!LeventMatched  &&  Levent.Lcode >= 96  &&  Levent.Lcode <= 111) {
        // Number pad, numlock on
  //      _Debug('KeyPress NumPad code='+Levent.Lcode+'; Ltarg='+Levent.Ltarg.tagName+'; LisVirtualKey='+Levent.LisVirtualKey+'; _KeyPressToSwallow='+keymanweb._KeyPressToSwallow+'; keyCode='+(e?e.keyCode:'nothing'));

        if(Levent.Lcode < 106) {
          var Lch = Levent.Lcode-48;
        } else {
          Lch = Levent.Lcode-64;
        }
        kbdInterface.output(0, Levent.Ltarg, String._kmwFromCharCode(Lch)); //I3319

        LeventMatched = 1;
      }
    
      if(LeventMatched) {
        if(e  &&  e.preventDefault) {
          e.preventDefault();
          e.stopPropagation();
        }
        keymanweb._KeyPressToSwallow = (e?keymanweb._GetEventKeyCode(e):0);
        return false;
      } else {
        keymanweb._KeyPressToSwallow = 0;
      }
      
      if(Levent.Lcode == 8) {
        /* Backspace - delete deadkeys, also special rule if desired? */
        // This is needed to prevent jumping to previous page, but why???  // I3363 (Build 301)
        if(Levent.Ltarg.className != null && Levent.Ltarg.className.indexOf('keymanweb-input') >= 0) {
          return false;
        }
      }

      if(typeof(Levent.Ltarg.base) != 'undefined') {
        // Simulated touch elements have no default text-processing - we need to rely on a strategy similar to
        // that of the OSK here.
        var ch = osk.defaultKeyOutput('',Levent.Lcode,Levent.Lmodifiers,false,Levent.Ltarg);
        if(ch) {
          kbdInterface.output(0, Levent.Ltarg, ch);
          return false;
        }
      }
      return true;
    }                

    /**
     * Function     _KeyPress
     * Scope        Private
     * @param       {Event}       e     event
     * @return      {boolean}           
     * Description Processes keypress event (does not pass data to keyboard)
     */       
    keymanweb._KeyPress = function(e) {
      if(e._kmw_block) { // A custom event property added for bugfix-oriented simulated keypress events.
        return false;
      }

      var Levent;
      if(!keymanweb._Enabled || keymanweb._DisableInput || keymanweb.keyboardManager.activeKeyboard == null) {
        return true;
      }

      Levent = keymanweb._GetKeyEventProperties(e);
      if(Levent == null || Levent.LisVirtualKey) {
        return true;
      }

  //    _Debug('KeyPress code='+Levent.Lcode+'; Ltarg='+Levent.Ltarg.tagName+'; LisVirtualKey='+Levent.LisVirtualKey+'; _KeyPressToSwallow='+keymanweb._KeyPressToSwallow+'; keyCode='+(e?e.keyCode:'nothing'));

      /* I732 START - 13/03/2007 MCD: Swedish: Start positional keyboard layout code: prevent keystroke */
      if(!keymanweb.keyboardManager.activeKeyboard['KM']) {
        if(!keymanweb._KeyPressToSwallow) {
          return true;
        }
        if(Levent.Lcode < 0x20 || (keymanweb._BrowserIsSafari  &&  (Levent.Lcode > 0xF700  &&  Levent.Lcode < 0xF900))) {
          return true;
        }
        e = keymanweb._GetEventObject(e);   // I2404 - Manage IE events in IFRAMEs
        if(e) {
          e.returnValue = false;
        }
        return false;
      }
      /* I732 END - 13/03/2007 MCD: Swedish: End positional keyboard layout code */
      
      if(keymanweb._KeyPressToSwallow || kbdInterface.processKeystroke(util.physicalDevice,Levent.Ltarg,Levent)) {
        keymanweb._KeyPressToSwallow=0;
        if(e  &&  e.preventDefault) {
          e.preventDefault();
          e.stopPropagation();
        }
        return false;
      }
      keymanweb._KeyPressToSwallow=0;
      return true;
    }

    /**
     * Function     _KeyUp
     * Scope        Private
     * @param       {Event}       e     event
     * @return      {boolean}           
     * Description Processes keyup event and passes event data to keyboard
     */       
    keymanweb._KeyUp = function(e) {
      var Levent = keymanweb._GetKeyEventProperties(e, false);
      if(Levent == null || !osk.ready) {
        return true;
      }

      switch(Levent.Lcode) {
        case 13:  
          if(Levent.Ltarg.nodeName == 'TEXTAREA') {
            break;
          }
        
          if(Levent.Ltarg.base && Levent.Ltarg.base.nodeName == 'TEXTAREA') {
            break;
          }

          // For input fields, move to next input element
          if(Levent.Ltarg.type == 'search' || Levent.Ltarg.type == 'submit') {
            Levent.Ltarg.form.submit();
          } else {
            keymanweb.moveToNext(false);
          }
          return true;        
                  
        case 16: //"K_SHIFT":16,"K_CONTROL":17,"K_ALT":18
        case 17: 
        case 18: 
        case 20: //"K_CAPS":20, "K_NUMLOCK":144,"K_SCROLL":145
        case 144:
        case 145:
          keymanweb._NotifyKeyboard(Levent.Lcode,Levent.Ltarg,0);
          if(!device.touchable) {
            return osk._UpdateVKShift(Levent, Levent.Lcode-15, 1);  // I2187
          } else {
            return true;
          }
      }
      
      if(Levent.LmodifierChange){
        keymanweb._NotifyKeyboard(0,Levent.Ltarg,0); 
        osk._UpdateVKShift(Levent, 0, 1);  // I2187
      }

      // I736 start
      var Ldv;
      if((Ldv=Levent.Ltarg.ownerDocument)  &&  (Ldv=Ldv.selection)  &&  Ldv.type != 'control') { // I1479 - avoid createRange on controls
        Ldv=Ldv.createRange();
        //if(Ldv.parentElement()==Levent.Ltarg) //I1505
        keymanweb._Selection = Ldv;
      }
      // I736 end
      
      return false;
    }
    
  //TODO: check return of _KeyUp - what happens if returning true or false ?? what if null returned?

    /**
    * Move focus to next (or previous) input or text area element on TAB
    *   Uses list of actual input elements
    *     
    *   Note that _ActiveElement on touch devices returns the DIV that overlays
    *   the input element, not the element itself.
    * 
    * @param      {number|boolean}  bBack     Direction to move (0 or 1)
    */
    keymanweb.moveToNext=function(bBack) {
      var i,t=keymanweb.sortedInputs, activeBase=keymanweb._ActiveElement;
      
      if(t.length == 0) {
        return;
      }

      // For touchable devices, get the base element of the DIV
      if(device.touchable) {
        activeBase=activeBase.base;
      }

      // Identify the active element in the list of inputs ordered by position
      for(i=0; i<t.length; i++) {          
        if(t[i] == activeBase) break;
      }   

      // Find the next (or previous) element in the list
      i = bBack ? i-1 : i+1;
      // Treat the list as circular, wrapping the index if necessary.
      i = i >= t.length ? i-t.length : i;
      i = i < 0 ? i+t.length : i;

      // Move to the selected element
      if(device.touchable) {                     
        // Set focusing flag to prevent OSK disappearing 
        keymanweb.focusing=true;
        var target=t[i]['kmw_ip'];

        // Focus if next element is non-mapped
        if(typeof(target) == 'undefined') {
          t[i].focus();
        } else { // Or reposition the caret on the input DIV if mapped
          keymanweb._ActiveElement=keymanweb._LastActiveElement=target;    
          keymanweb.setTextCaret(target,10000);                            
          keymanweb.scrollInput(target);   // mousedown check
          target.focus();
        } 
      } else { // Behaviour for desktop browsers
        t[i].focus();
      }    
    }          

    /**
     * Move focus to user-specified element
     * 
     *  @param  {string|Object}   e   element or element id
     *           
     **/
    keymanweb['moveToElement'] = function(e)
    {
      var i;
      
      if(typeof(e) == 'string') e=document.getElementById(e);
      
      if(device.touchable && e['kmw_ip'])
        e['kmw_ip'].focus();
      else
        e.focus();
    }

    /**
     * Function    isCJK
     * Scope       Public
     * @param      {Object=}  k0 
     * @return     {boolean}
     * Description Tests if active keyboard (or optional argument) uses a pick list (Chinese, Japanese, Korean, etc.)
     *             (This function accepts either keyboard structure.)   
     */    
    keymanweb['isCJK'] = function(k0) { 
      return keymanweb.keyboardManager.isCJK(k0);
    }

    /**
     * Function     isChiral
     * Scope        Public
     * @param       {string|Object=}   k0
     * @return      {boolean}
     * Description  Tests if the active keyboard (or optional argument) uses chiral modifiers.
     */
    keymanweb.isChiral = keymanweb['isChiral'] = function(k0) {
      if(typeof(k0) == "string") {
        k0 = keymanweb.keyboardManager.getKeyboardByID(k0);
      }

      return !!(keymanweb.getKeyboardModifierBitmask(k0) & keymanweb['osk'].modifierBitmasks.IS_CHIRAL);
    }

    /**
     * Function     getKeyboardModifierBitmask
     * Scope        Private
     * @param       {Object=}   k0
     * @return      {number}
     * Description  Obtains the currently-active modifier bitmask for the active keyboard.
     */
    keymanweb.getKeyboardModifierBitmask = function(k0) {
      var k=keymanweb.keyboardManager.activeKeyboard;
      
      if(arguments.length > 0 && typeof k0 != 'undefined') {
        k = k0;
      }

      if(!k) {
        return 0x0000;
      }

      if(k['KMBM']) {
        return k['KMBM'];
      }

      return osk.modifierBitmasks['NON_CHIRAL'];
    }
    
    /**
     * Allow to change active keyboard by (internal) keyboard name
     * 
     * @param       {string}    PInternalName   Internal name
     * @param       {string}    PLgCode         Language code
     */    
    keymanweb['setActiveKeyboard'] = function(PInternalName,PLgCode) {
      keymanweb.keyboardManager.setActiveKeyboard(PInternalName,PLgCode);
    }
    
    /**
     * Function     getActiveKeyboard
     * Scope        Public
     * @return      {string}      Name of active keyboard
     * Description  Return internal name of currently active keyboard
     */    
    keymanweb['getActiveKeyboard'] = function() {
      return keymanweb.keyboardManager.getActiveKeyboardName();
    }

    /**
     * Function    getActiveLanguage
     * Scope       Public
     * @return     {string}         language code
     * Description Return language code for currently selected language
     */    
    keymanweb['getActiveLanguage'] = keymanweb.getActiveLanguage = function()
    {
      if((<KeymanBase>keymanweb).keyboardManager.activeStub == null) return '';
      return (<KeymanBase>keymanweb).keyboardManager.activeStub['KLC'];
    }

  //TODO: find all references to next three routines and disambiguate!!
    
    /**
     * Get keyboard meta data for the selected keyboard and language
     * 
     * @param       {string}    PInternalName     Internal name of keyboard
     * @param       {string=}   PlgCode           language code
     * @return      {Object}                      Details of named keyboard 
     *                                            
     **/    
    keymanweb['getKeyboard'] = function(PInternalName, PlgCode?) {
      var Ln, Lrn;

      var kbdList = keymanweb.keyboardManager.getDetailedKeyboards();

      for(Ln=0; Ln < kbdList.length; Ln++) {
        Lrn = kbdList[Ln];

        if(Lrn['InternalName'] == PInternalName || Lrn['InternalName'] == "Keyboard_" + PInternalName) { 
          if(arguments.length < 2) {
            return Lrn;
          }

          if(Lrn['LanguageCode'] == PlgCode) {
            return Lrn;
          }
        } 
      }

      return null;
    }
    
    /**
     * Get array of available keyboard stubs 
     * 
     * @return   {Array}     Array of available keyboards
     * 
     */    
    keymanweb['getKeyboards'] = function() {
      return keymanweb.keyboardManager.getDetailedKeyboards();
    }
    
    /**
     * Function     _WindowUnload
     * Scope        Private
     * Description  Remove handlers before detaching KMW window  
     */    
    keymanweb._WindowUnload = function()
    {
      // Allow the UI to release its own resources
      keymanweb.doUnloadUI();
      
      // Allow the OSK to release its own resources
      if(osk.ready) osk._Unload(); // I3363 (Build 301)
      
      keymanweb._LastActiveElement = 0;
    }
    
      // Complete page initialization only after the page is fully loaded, including any embedded fonts
    // This avoids the need to use a timer to test for the fonts
    
    util.attachDOMEvent(window, 'load',function(e){
      //keymanweb.completeInitialization();
      // Always return to top of page after a page reload
      document.body.scrollTop=0;
      if(typeof document.documentElement != 'undefined') document.documentElement.scrollTop=0;
      },false);
    
    // Attach this handler to window unload event  
    util.attachDOMEvent(window, 'unload', keymanweb._WindowUnload,false);  // added fourth argument (default value)

    /**
     * Function     isKMWInput
     * Scope        Private
     * @param       {Element}   x   An element from the page.
     * @return      {boolean}      true if the element is viable for KMW attachment.
     * Description  Examines potential input elements to determine whether or not they are viable for KMW attachment.
     *              Also filters elements not supported for touch devices when device.touchable == true.
     */ 
    keymanweb.isKMWInput = function(x) {
      var c, lcTagName = x.tagName.toLowerCase();

      if(lcTagName == 'textarea') {
          return true;
      } else if(lcTagName == 'input' && x.type.toLowerCase() == 'text') {
        if(x.type == 'text' || x.type == 'search') {
          return true;  
        } 
      } else if(lcTagName == 'iframe' && !device.touchable) { // Do not allow iframe attachment if in 'touch' mode.
        try {
          if(x.contentWindow.document) {  // Only allow attachment if the iframe's internal document is valid.
            return true;
          }
        }
        catch(err) { /* Do not attempt to access iframes outside this site */ }
      } else if(x.isContentEditable && !device.touchable) { // Only allow contentEditable attachment outside of 'touch' mode.
        return true;
      }

      return false;     
    }

    /**
     * Function     isKMWDisabled
     * Scope        Private
     * @param       {Element}   x   An element from the page.
     * @return      {boolean}      true if the element's properties indicate a 'disabled' state.
     * Description  Examines attachable elements to determine their default enablement state.
     */ 
    keymanweb.isKMWDisabled = function(x) {
      var c = x.className, lcTagName = x.tagName.toLowerCase();

      if(x.readOnly) {
        return true;
      } else if(c && c.indexOf('kmw-disabled') >= 0) {
        return true;
      }

      return false;     
    }

    /**
     * Function     isAttached
     * Scope        Private
     * @param       {Element}   x   An element from the page.
     * @return      {boolean}       true if KMW is attached to the element, otherwise false.
     */
    keymanweb.isAttached = function(x) {
      return x._kmwAttachment ? true : false;
    }

    /**
     * Function     setupElementAttachment
     * Scope        Private
     * @param       {Element}   x   An element from the page valid for KMW attachment
     * Description  Establishes the base KeymanWeb data for newly-attached elements.
     *              Does not establish input hooks, which are instead handled during enablement.  
     */
    keymanweb.setupElementAttachment = function(x) {
      // The `_kmwAttachment` property tag maintains all relevant KMW-maintained data regarding the element.
      // It is disgarded upon de-attachment.
      x._kmwAttachment = {
        keyboard:       null,               // Tracks the control's independent keyboard selection, when applicable.
        touchEnabled:   device.touchable    // Tracks if the control has an aliased control for touch functionality.
                                            // (Necessary for managing the touch/non-touch event handlers.)
      };
    }

    /**
     * Function     clearElementAttachment
     * Scope        Private
     * @param       {Element}   x   An element from the page valid for KMW attachment
     * Description  Establishes the base KeymanWeb data for newly-attached elements.
     *              Does not establish input hooks, which are instead handled during enablement.  
     */
    keymanweb.clearElementAttachment = function(x) {
      // We need to clear the object when de-attaching; helps prevent memory leaks.
      x._kmwAttachment = null;
    }

    /**
     * Function     _GetDocumentEditables
     * Scope        Private
     * @param       {Element}     Pelem     HTML element
     * @return      {Array<Element>}        A list of potentially-editable controls.  Further filtering [as with isKMWInput() and
     *                                      isKMWDisabled()] is required.
     */
    keymanweb._GetDocumentEditables = function(Pelem) {
      var possibleInputs = [];

      if(Pelem.tagName) {
        var tagName = Pelem.tagName.toLowerCase();
        if(tagName == 'input' || tagName == 'textarea' || tagName == 'iframe') {
          possibleInputs.push(Pelem);
        }
      } else if(Pelem.nodeName == "#text") {
        return [];
      }

      // Constructing it like this also allows for individual element filtering for the auto-attach MutationObserver without errors.
      if(Pelem.getElementsByTagName) {
        /**
         * Function     LiTmp
         * Scope        Private
         * @param       {string}    _colon    type of element
         * @return      {Array<Element>}  array of elements of specified type                       
         * Description  Local function to get list of editable controls
         */    
        var LiTmp = function(_colon){
          return util.arrayFromNodeList(Pelem.getElementsByTagName(_colon));
        };

        // Note that isKMWInput() will block IFRAME elements as necessary for touch-based devices.
        possibleInputs = possibleInputs.concat(LiTmp('INPUT'), LiTmp('TEXTAREA'), LiTmp('IFRAME'));
      }
      
      // Not all active browsers may support the method, but only those that do would work with contenteditables anyway.
      if(Pelem.querySelectorAll) {
        possibleInputs = possibleInputs.concat(util.arrayFromNodeList(Pelem.querySelectorAll('[contenteditable]')));
      }
      
      if(Pelem.isContentEditable) {
        possibleInputs.push(Pelem);
      }

      return possibleInputs;
    }

    /**
     * Function     _SetupDocument
     * Scope        Private
     * @param       {Element}     Pelem - the root element of a document, including IFrame documents.
     * Description  Used to automatically attach KMW to editable controls, regardless of control path.
     */
    keymanweb._SetupDocument = function(Pelem) { // I1961
      var possibleInputs = keymanweb._GetDocumentEditables(Pelem);

      for(var Li = 0; Li < possibleInputs.length; Li++) {
        var input = possibleInputs[Li];

        // It knows how to handle pre-loaded iframes appropriately.
        keymanweb.attachToControl(possibleInputs[Li]);
      }
    }

        /**
     * Function     _ClearDocument
     * Scope        Private
     * @param       {Element}     Pelem - the root element of a document, including IFrame documents.
     * Description  Used to automatically detach KMW from editable controls, regardless of control path.
     *              Mostly used to clear out all controls of a detached IFrame.
     */
    keymanweb._ClearDocument = function(Pelem) { // I1961
      var possibleInputs = keymanweb._GetDocumentEditables(Pelem);

      for(var Li = 0; Li < possibleInputs.length; Li++) {
        var input = possibleInputs[Li];

        // It knows how to handle pre-loaded iframes appropriately.
        keymanweb.detachFromControl(possibleInputs[Li]);
      }
    }
    
    /**
     * Return a path that has is always terminated by a slash
     *    
     * @param   {string}  p folder path   
     * @return  {string}   
    **/      
    keymanweb.fixPath = function(p)
    {
      if(p.length == 0) return p;
      var q=p.substr(p.length-1,1);
      if(q == '/' || q == '\\') return p;
      return p+'/'; 
    }          


    /**
     * Function     Initialization
     * Scope        Public
     * @param       {Object}  arg     object array of user-defined properties
     * Description  KMW window initialization  
     */    
    keymanweb['init'] = keymanweb.init = function(arg) 
    { 
      var i,j,c,e,p,eTextArea,eInput,opt,dTrailer,ds;

      // Local function to convert relative to absolute URLs
      // with respect to the source path, server root and protocol 
      var fixPath = function(p) {
        if(p.length == 0) return p;
        
        // Add delimiter if missing
        if(p.substr(p.length-1,1) != '/') p = p+'/';

        // Absolute
        if((p.replace(/^(http)s?:.*/,'$1') == 'http') 
            || (p.replace(/^(file):.*/,'$1') == 'file'))
          return p;         
          
        // Absolute (except for protocol)
        if(p.substr(0,2) == '//')
          return keymanweb.protocol+p;
        
        // Relative to server root
        if(p.substr(0,1) == '/')
          return keymanweb.rootPath+p.substr(1);

        // Otherwise, assume relative to source path
        return keymanweb.srcPath+p;
      }            
      
      // Explicit (user-defined) parameter initialization       
      opt=keymanweb.options;
      if(typeof(arg) == 'object' && arg !== null)
      {
        for(p in opt)
        { 
          if(arg.hasOwnProperty(p)) opt[p] = arg[p];
        }
      }
    
      // Get default paths and device options
      if(opt['root'] != '') keymanweb.rootPath = fixPath(opt['root']); 
  
      // Keyboards and fonts are located with respect to the server root by default          
      //if(opt['keyboards'] == '') opt['keyboards'] = keymanweb.rootPath+'keyboard/';
      //if(opt['fonts'] == '') opt['fonts'] = keymanweb.rootPath+'font/';
    
      // Resources are located with respect to the engine by default 
      if(opt['resources'] == '') opt['resources'] = keymanweb.srcPath;
    
      // Convert resource, keyboard and font paths to absolute URLs
      opt['resources'] = fixPath(opt['resources']);
      opt['keyboards'] = fixPath(opt['keyboards']);
      opt['fonts'] = fixPath(opt['fonts']);    

      // Set element attachment type    
      if(opt['attachType'] == '') opt['attachType'] = 'auto';

  /*    

      // Only initialize options the first time init is called   
      if(typeof(keymanweb.options['resources']) == 'undefined') 
      {
        var root='',fontSource='',resources='',keyboards='';
            
        // Get values of global variables if defined 
        if(typeof(window['KeymanWeb_Root']) == 'string') root=window['KeymanWeb_Root'];
        if(typeof(window['KeymanWeb_Resources']) == 'string') resources=window['KeymanWeb_Resources'];
        if(typeof(window['KeymanWeb_Keyboards']) == 'string') keyboards=window['KeymanWeb_Keyboards'];
        if(typeof(window['KeymanWeb_FontUriBasePath']) == 'string') fontSource=window['KeymanWeb_FontUriBasePath'];
    
        var opt={};
        opt['root']=root;
        opt['resources']=resources;
        opt['keyboards']=keyboards;
        opt['fonts'] = fontSource;      

        if(typeof(window['KeymanWeb_AttachType']) == 'string') 
          opt['attachType']=window['KeymanWeb_AttachType'];
        else
        opt['attachType'] = (device.touchable ? 'manual' : 'auto');
  
        if(typeof(window['KeymanWeb_FloatUI']) == 'object') 
          opt['ui'] = window['KeymanWeb_FloatUI'];
        else
          opt['ui'] = '';
        
        if(device.touchable) opt['ui'] = 'none';
  
        keymanweb.options = opt;    
      }
      else
      {
        var opt=keymanweb.options;
      }
      
      // Update the option if required by a subsequent call
      if(arguments.length > 0 && typeof(arg)=='object' && arg != null)
      { 
        for(var p in opt)
        { 
          if(arg.hasOwnProperty(p)) opt[p] = arg[p];
        }
      }

      // Get default root path and device options
      if(opt['root'] == '') opt['root'] = keymanweb.rootPath;

      // Use root-relative paths for resources and keyboards unless set by page source
      if(opt['resources'] == '') opt['resources']=opt['root'];
      if(opt['keyboards'] == '') opt['keyboards']=opt['root']+'kbd/';
      if(opt['fonts'] == '') opt['fonts']=opt['root']+'font/';
  */   
      
      // Set default device options
      keymanweb.setDefaultDeviceOptions(opt);   
      
      // Only do remainder of initialization once!  
      if(keymanweb.initialized) {
        return;
      }

      // Do not initialize until the document has been fully loaded
      if(document.readyState !== 'complete')
      {
        window.setTimeout(function(){keymanweb.init(arg);},50);
        return;
      }

      keymanweb._MasterDocument = window.document;

      /**
       * Initialization of touch devices and browser interfaces must be done 
       * after all resources are loaded, during final stage of initialization
       *        
       */            
      
      // Treat Android devices as phones if either (reported) screen dimension is less than 4" 
      if(device.OS == 'Android')
      {
        // Determine actual device characteristics  I3363 (Build 301)
        // TODO: device.dpi may no longer be needed - if so, get rid of it.
        device.dpi = util.getDPI(); //TODO: this will not work when called from HEAD!!
        device.formFactor=((screen.height < 4.0*device.dpi) || (screen.width < 4.0*device.dpi)) ? 'phone' : 'tablet';
      }

      if (window.removeEventListener)
        window.removeEventListener('focus', keymanweb._BubbledFocus, true);
    
      // Set exposed initialization flag member for UI (and other) code to use 
      keymanweb.setInitialized(1);
  
      // Finish keymanweb and OSK initialization once all necessary resources are available
      osk.prepare();
    
      // Create and save the remote keyboard loading delay indicator
      util.prepareWait();

      // Register deferred keyboard stubs (addKeyboards() format)
      keymanweb.keyboardManager.registerDeferredStubs();
    
      // Initialize the desktop UI
      keymanweb.initializeUI();
    
      // Register deferred keyboards 
      keymanweb.keyboardManager.registerDeferredKeyboards();
    
      // Exit initialization here if we're using an embedded code path.
      if(keymanweb.isEmbedded) {
        if(!keymanweb.keyboardManager.setDefaultKeyboard()) {
          console.error("No keyboard stubs exist - cannot initialize keyboard!");
        }
        return;
      }

      // Determine the default font for mapped elements
      keymanweb.appliedFont=keymanweb.baseFont=keymanweb.getBaseFont();

      // Add orientationchange event handler to manage orientation changes on mobile devices
      // Initialize touch-screen device interface  I3363 (Build 301)
      if(device.touchable) {
        keymanweb.handleRotationEvents();
        keymanweb.setupTouchDevice();
      }    
      // Initialize browser interface

      if(keymanweb.options['attachType'] != 'manual') {
        keymanweb._SetupDocument(document.documentElement);
      }

      // Create an ordered list of all input and textarea fields
      keymanweb.listInputs();
    
      // Initialize the OSK and set default OSK styles
      // Note that this should *never* be called before the OSK has been initialized.
      // However, it possibly may be called before the OSK has been fully defined with the current keyboard, need to check.    
      //osk._Load(); 
      
      //document.body.appendChild(osk._Box); 

      //osk._Load(false);
      
      // I3363 (Build 301)
      if(device.touchable)
      {
        // Handle OSK touchend events (prevent propagation)
        osk._Box.addEventListener('touchend',function(e){e.stopPropagation();},false);

        // Add a blank DIV to the bottom of the page to allow the bottom of the page to be shown
        dTrailer=document.createElement('DIV'); ds=dTrailer.style;
        ds.width='100%';ds.height=(screen.width/2)+'px';
        document.body.appendChild(dTrailer);  
        
        // On Chrome, scrolling up or down causes the URL bar to be shown or hidden 
        // according to whether or not the document is at the top of the screen.
        // But when doing that, each OSK row top and height gets modified by Chrome
        // looking very ugly.  Itwould be best to hide the OSK then show it again 
        // when the user scroll finishes, but Chrome has no way to reliably report
        // the touch end event after a move. c.f. http://code.google.com/p/chromium/issues/detail?id=152913
        // The best compromise behaviour is simply to hide the OSK whenever any 
        // non-input and non-OSK element is touched.
        if(device.OS == 'Android' && navigator.userAgent.indexOf('Chrome') > 0)
        {
          keymanweb.hideOskWhileScrolling=function(e)
          {           
            if(typeof(osk._Box) == 'undefined') return;
            if(typeof(osk._Box.style) == 'undefined') return;

            // The following tests are needed to prevent the OSK from being hidden during normal input!
            p=e.target.parentNode;
            if(typeof(p) != 'undefined' && p != null)
            {
              if(p.className.indexOf('keymanweb-input') >= 0) return; 
              if(p.className.indexOf('kmw-key-') >= 0) return; 
              if(typeof(p.parentNode) != 'undefined')
              {
                p=p.parentNode;
                if(p.className.indexOf('keymanweb-input') >= 0) return; 
                if(p.className.indexOf('kmw-key-') >= 0) return; 
              }
            }          
            osk.hideNow(); 
          }        
          document.body.addEventListener('touchstart',keymanweb.hideOskWhileScrolling,false);
        } 
        else
        {          
          keymanweb.conditionallyHideOsk = function()
          {
            // Should not hide OSK if simply closing the language menu (30/4/15)
            if(keymanweb.hideOnRelease && !osk.lgList) osk.hideNow();
            keymanweb.hideOnRelease=false;
          }
          keymanweb.hideOskIfOnBody = function(e)
          {
            keymanweb.touchY=e.touches[0].screenY;
            keymanweb.hideOnRelease=true;
          }
          keymanweb.cancelHideIfScrolling = function(e)
          {
            var y=e.touches[0].screenY,y0=keymanweb.touchY;    
            if(y-y0 > 5 || y0-y < 5) keymanweb.hideOnRelease = false;
          }
          document.body.addEventListener('touchstart',keymanweb.hideOskIfOnBody,false);      
          document.body.addEventListener('touchmove',keymanweb.cancelHideIfScrolling,false);      
          document.body.addEventListener('touchend',keymanweb.conditionallyHideOsk,false);      
        } 
      }

      //document.body.appendChild(keymanweb._StyleBlock);

      // IE: call _SelectionChange when the user changes the selection 
      if(document.selection)
        util.attachDOMEvent(document, 'selectionchange', keymanweb._SelectionChange);
    
      // Restore and reload the currently selected keyboard, selecting a default keyboard if necessary.
      keymanweb.keyboardManager.restoreCurrentKeyboard(); 

      /* Setup of handlers for dynamically-added and (eventually) dynamically-removed elements.
        * Reference: https://developer.mozilla.org/en/docs/Web/API/MutationObserver
        * 
        * We place it here so that it loads after most of the other UI loads, reducing the MutationObserver's overhead.
        * Of course, we only want to dynamically add elements if the user hasn't enabled the manual attachment option.
        */

      var observationTarget = document.querySelector('body'), observationConfig;
      if(keymanweb.options['attachType'] != 'manual') { //I1961
        keymanweb.mutationObserver = new MutationObserver(keymanweb._AutoAttachObserverCore);

        observationConfig = { childList: true, subtree: true};
        keymanweb.mutationObserver.observe(observationTarget, observationConfig);
      }

      /**
       * Setup of handlers for dynamic detection of the kmw-disabled class tag that controls enablement.
       */
      observationConfig = { subtree: true, attributes: true, attributeOldValue: true, attributeFilter: ['class', 'readonly']};
      new MutationObserver(keymanweb._EnablementMutationObserverCore).observe(observationTarget, observationConfig);

      // Set exposed initialization flag to 2 to indicate deferred initialization also complete
      keymanweb.setInitialized(2);
    }

    keymanweb._EnablementMutationObserverCore = function(mutations) {
      for(var i=0; i < mutations.length; i++) {
        var mutation = mutations[i];

        // ( ? : ) needed as a null check.
        var disabledBefore = mutation.oldValue ? mutation.oldValue.indexOf('kmw-disabled') >= 0 : false;
        var disabledAfter = mutation.target.className.indexOf('kmw-disabled') >= 0;
        
        if(disabledBefore && !disabledAfter) {
          keymanweb._EnableControl(mutation.target);
        } else if(!disabledBefore && disabledAfter) {
          keymanweb._DisableControl(mutation.target);
        }

        // 'readonly' triggers on whether or not the attribute exists, not its value.
        if(!disabledAfter && mutation.attributeName == "readonly") {
          var readonlyBefore = mutation.oldValue ? mutation.oldValue != null : false;
          var readonlyAfter = mutation.target.readOnly;

          if(readonlyBefore && !readonlyAfter) {
            keymanweb._EnableControl(mutation.target);
          } else if(!readonlyBefore && readonlyAfter) {
            keymanweb._DisableControl(mutation.target);
          }
        }
      }
    }

    keymanweb._AutoAttachObserverCore = function(mutations) {
      var inputElementAdditions = [];
      var inputElementRemovals = [];

      for(var i=0; i < mutations.length; i++) {
        var mutation = mutations[i];
        
        for(var j=0; j < mutation.addedNodes.length; j++) {
          inputElementAdditions = inputElementAdditions.concat(keymanweb._GetDocumentEditables(mutation.addedNodes[j]));
        }          

        for(j = 0; j < mutation.removedNodes.length; j++) {
          inputElementRemovals = inputElementRemovals.concat(keymanweb._GetDocumentEditables(mutation.removedNodes[j]));
        }
      }

      for(var k = 0; k < inputElementAdditions.length; k++) {
        if(keymanweb.isKMWInput(inputElementAdditions[k])) { // Apply standard element filtering!
          keymanweb._MutationAdditionObserved(inputElementAdditions[k]);
        }
      }

      for(k = 0; k < inputElementRemovals.length; k++) {
        if(keymanweb.isKMWInput(inputElementRemovals[k])) { // Apply standard element filtering!
          keymanweb._MutationRemovalObserved(inputElementRemovals[k]);
        }
      }

      /* After all mutations have been handled, we need to recompile our .sortedInputs array, but only
        * if any have actually occurred.
        */
      if(inputElementAdditions.length || inputElementRemovals.length) {
        if(!device.touchable) {
          keymanweb.listInputs();
        } else if(device.touchable) {   // If something was added or removed, chances are it's gonna mess up our touch-based layout scheme, so let's update the touch elements.
          window.setTimeout(function() {
            keymanweb.listInputs();

            for(var k = 0; k < keymanweb.sortedInputs.length; k++) {
              if(keymanweb.sortedInputs[k]['kmw_ip']) {
                keymanweb.updateInput(keymanweb.sortedInputs[k]['kmw_ip']);
              }
            }
          }, 1);
        }
      }
    }

    /** 
     * Function     _MutationAdditionObserved
     * Scope        Private
     * @param       {Element}  Pelem     A page input, textarea, or iframe element.
     * Description  Used by the MutationObserver event handler to properly setup any elements dynamically added to the document post-initialization.
     * 
     */
    keymanweb._MutationAdditionObserved = function(Pelem) {
      if(Pelem.tagName.toLowerCase() == 'iframe' && !device.touchable) {
        //Problem:  the iframe is loaded asynchronously, and we must wait for it to load fully before hooking in.

        var attachFunctor = function() {  // Triggers at the same time as iframe's onload property, after its internal document loads.
          keymanweb.attachToControl(Pelem);
        };

        Pelem.addEventListener('load', attachFunctor);

        /* If the iframe has somehow already loaded, we can't expect the onload event to be raised.  We ought just
        * go ahead and perform our callback's contents.
        * 
        * keymanweb.attachToControl() is now idempotent, so even if our call 'whiffs', it won't cause long-lasting
        * problems.
        */
        if(Pelem.contentDocument.readyState == 'complete') {
          attachFunctor();
        }
      } else {
        keymanweb.attachToControl(Pelem);
      }  
    }

    // Used by the mutation event handler to properly decouple any elements dynamically removed from the document.
    keymanweb._MutationRemovalObserved = function(Pelem) {
      var element = Pelem;
      if(device.touchable) {
        keymanweb.disableTouchElement(Pelem);
      }

      keymanweb.disableInputElement(Pelem); // Remove all KMW event hooks, styling.
      keymanweb.clearElementAttachment(element);  // Memory management & auto de-attachment upon removal.
    }

    // Create an ordered list of all text and search input elements and textarea elements
    // except any tagged with class 'kmw-disabled'
    // TODO: email and url types should perhaps use default keyboard only
    keymanweb.listInputs = function()
    {
      var i,eList=[],
        t1=document.getElementsByTagName('INPUT'),
        t2=document.getElementsByTagName('TEXTAREA');

      for(i=0; i<t1.length; i++) { 
        var inputElement = <HTMLInputElement><any> t1[i];
        switch(inputElement.type) {
          case 'text':
          case 'search':
          case 'email':
          case 'url':
            if(t1[i].className.indexOf('kmw-disabled') < 0) {
              eList.push({ip:t1[i],x:util._GetAbsoluteX(t1[i]),y:util._GetAbsoluteY(t1[i])});
            }
            break;    
        }
      }
      for(i=0; i<t2.length; i++) { 
        if(t2[i].className.indexOf('kmw-disabled') < 0)
          eList.push({ip:t2[i],x:util._GetAbsoluteX(t2[i]),y:util._GetAbsoluteY(t2[i])});
      }
      
      /**
       * Local function to sort by screen position
       * 
       * @param       {Object}     e1     first object
       * @param       {Object}     e2     second object
       * @return      {number}            y-difference between object positions, or x-difference if y values the same
       */       
      var xySort=function(e1,e2)
      {
        if(e1.y != e2.y) return e1.y-e2.y;
        return e1.x-e2.x;    
      }
      
      // Sort elements by Y then X
      eList.sort(xySort);
      
      // Create a new list of sorted elements
      var tList=[];
      for(i=0;i<eList.length;i++)
        tList.push(eList[i].ip);
    
      // Return the sorted element list
      keymanweb.sortedInputs=tList;
    }
    
    /**
     * Initialize the desktop user interface as soon as it is ready
    **/       
    keymanweb.initializeUI = function()
    {
      if(typeof(keymanweb['ui']['initialize'])=='function')
      {
        keymanweb['ui']['initialize']();
        // Display the OSK (again) if enabled, in order to set its position correctly after
        // adding the UI to the page 
        osk._Show();     
      }
      else
        window.setTimeout(keymanweb.initializeUI,1000);
    }      
    /**
     * Test if caret position is determined from the active element, or 
     * from the synthesized overlay element (touch devices)
     * 
     * @return  {boolean}
     **/          
    keymanweb.isPositionSynthesized = function()
    {
      return device.touchable;
    }
    
    /**
     * Function     _SelPos
     * Scope        Private
     * @param       {Object}  Pelem   Element
     * @return      {number}          Selection start
     * Description  Get start of selection (with supplementary plane modifications)
     */   
    keymanweb._SelPos = function(Pelem)
    {
      var Ldoc, Ldv, isMSIE=(util._GetIEVersion()<999); // I3363 (Build 301)

      if(keymanweb.isPositionSynthesized())
        return keymanweb.getTextCaret(Pelem);

      if(Pelem._KeymanWebSelectionStart) 
        return Pelem._KeymanWebSelectionStart;
      
      // Mozilla, IE9 
      else if (Pelem.setSelectionRange)  
        return Pelem.value.substr(0,Pelem.selectionStart)._kmwLength();        
    
      // contentEditable elements, Mozilla midas
      else if((Ldv=Pelem.ownerDocument)  &&  (Ldv=Ldv.defaultView)  &&  Ldv.getSelection
        &&  Pelem.ownerDocument.designMode.toLowerCase() == 'on') {
        var Lsel = Ldv.getSelection();
        if(Lsel.focusNode.nodeType == 3) 
          return Lsel.focusNode.substringData(0,Lsel.focusOffset)._kmwLength(); 
      }
      
      // IE8 and earlier
      else if(isMSIE)
      { 
        // Get position within input or textarea element       
        if(typeof(Pelem.value) == 'string') {
          var ss=keymanweb.getInputSelection(Pelem);               
          return Pelem.value.substr(0,ss.start)._kmwLength();        
        }
        
        // Get position within content-editable region
        if(Pelem.body) Ldoc=Pelem; else Ldoc=Pelem.ownerDocument;	// I1481 - integration with rich editors not working 100%

        if(Ldoc) Ldv=Ldoc.selection; else return 0;
            
        var Lrange = Ldv.createRange();
        Lrange.moveStart('textedit',-1);
        return Lrange.text._kmwLength();    
      }
      return 0;
    }  

    /*    Old code without SMP mods
    
    keymanweb._SelPos = function(Pelem)
    {
      var Ldv;
      if(Pelem._KeymanWebSelectionStart) return Pelem._KeymanWebSelectionStart;
      else if (Pelem.setSelectionRange)
        return Pelem.selectionStart;
      else if((Ldv=Pelem.ownerDocument)  &&  (Ldv=Ldv.defaultView)  &&  Ldv.getSelection  &&  Pelem.ownerDocument.designMode.toLowerCase() == 'on') //  &&  Pelem.tagName == 'HTML')
      {
        var Lsel = Ldv.getSelection();
        if(Lsel.focusNode.nodeType == 3) return Lsel.focusOffset;
      }
      return 0;
    }*/   
    
    /**
     * Function     getInputSelection
     * Scope        Private
     * @param       {Object}      el          element
     * @return      {Object.<string,number>}  selection start
     * Description Get input selection for all(?) browsers, per Tim Down
     *            http://stackoverflow.com/questions/3053542/how-to-get-the-start-and-end-points-of-selection-in-text-area/3053640#3053640 
     *            But only works for input fields, not for content editable fields!!!  
     **/            
    keymanweb.getInputSelection = function(el)
    { 
      var start = 0, end = 0, normalizedValue = '', range, textInputRange, len = 0, endRange; 
  
      if(typeof el.selectionStart == "number" && typeof el.selectionEnd == "number") { 
        start = el.selectionStart; end = el.selectionEnd; 
      } else { 
        range = document.selection.createRange(); 
  
        if(range && range.parentElement() == el) { 
          len = el.value.length; 
          normalizedValue = el.value.replace(/\r\n/g, "\n"); 
              
          // Create a working TextRange that lives only in the input 
          textInputRange = el.createTextRange(); 
          textInputRange.moveToBookmark(range.getBookmark()); 
  
          // Check if the start and end of the selection are at the very end of the input,
          // since moveStart/moveEnd doesn't return what we want in those cases 
          endRange = el.createTextRange(); 
          endRange.collapse(false); 
  
          if(textInputRange.compareEndPoints("StartToEnd", endRange) > -1) { 
            start = end = len; 
          } else { 
            start = -textInputRange.moveStart("character", -len); 
            start += normalizedValue.slice(0, start).split("\n").length - 1; 
  
            if(textInputRange.compareEndPoints("EndToEnd", endRange) > -1) { 
              end = len; 
            } else { 
              end = -textInputRange.moveEnd("character", -len); 
              end += normalizedValue.slice(0, end).split("\n").length - 1; 
            } 
          } 
        } 
      } 
      return {start: start, end: end}; 
    }
    // *** I3319 Supplementary Plane modifications - end new code
  
    /**
     * Set target element text direction (LTR or RTL), but only if the element is empty
     *    
     * If the element base directionality is changed after it contains content, unless all the text
     * has the same directionality, text runs will be re-ordered which is confusing and causes
     * incorrect caret positioning
     *    
     * @param       {Object}      Ptarg      Target element
     */    
    keymanweb._SetTargDir = function(Ptarg) {  
      var elDir=((keymanweb.keyboardManager.activeKeyboard != null) && (keymanweb.keyboardManager.activeKeyboard['KRTL'])) ? 'rtl' : 'ltr';  
      if(Ptarg) {
        if(device.touchable) {
          if(Ptarg.textContent.length == 0) {
            Ptarg.base.dir=Ptarg.dir=elDir;
            keymanweb.setTextCaret(Ptarg,10000);
          }
        } else {
          if(typeof Ptarg.value == "string") {
            if(Ptarg.value.length == 0) {
              Ptarg.dir=elDir;
            }
          } else if(typeof Ptarg.textContent == "string" && Ptarg.textContent.length == 0) { // As with contenteditable DIVs, for example.
            Ptarg.dir=elDir;
          }
        }
      }
    }
    
    /**
     * Reset OSK shift states when entering or exiting the active element
     **/    
    keymanweb._ResetVKShift = function()
    {
      if(!keymanweb._IsActivatingKeymanWebUI) 
      {
        if(osk._UpdateVKShift) osk._UpdateVKShift(null,15,0);  //this should be enabled !!!!! TODO
      }
    }

    /**
     * Function     addHotKey
     * Scope        Public
     * @param       {number}            keyCode
     * @param       {number}            shiftState
     * @param       {function(Object)}  handler
     * Description  Add hot key handler to array of document-level hotkeys triggered by key up event
     */
    keymanweb['addHotKey'] = keymanweb.addHotKey = function(keyCode,shiftState,handler)
    {
      // Test if existing handler for this code and replace it if so
      for(var i=0; i<keymanweb._HotKeys.length; i++)
      {
        if(keymanweb._HotKeys[i].Code == keyCode && keymanweb._HotKeys[i].Shift == shiftState)
        {
          keymanweb._HotKeys[i].Handler = handler; return;
        }
      }
      // Otherwise add it to the array
      keymanweb._HotKeys.push({Code:keyCode,Shift:shiftState,Handler:handler});
    }              

    /**
     * Function     removeHotKey
     * Scope        Public
     * @param       {number}        keyCode
     * @param       {number}        shiftState
     * Description  Remove a hot key handler from array of document-level hotkeys triggered by key up event
     */
    keymanweb['removeHotKey'] = keymanweb.removeHotKey = function(keyCode,shiftState)
    {
      for(var i=0; i<keymanweb._HotKeys.length; i++)
      {
        if(keymanweb._HotKeys[i].Code == keyCode && keymanweb._HotKeys[i].Shift == shiftState)
        {
          keymanweb._HotKeys.splice(i,1); return;
        }
      }
    }
                  
    /**
     * Function     _ProcessHotKeys
     * Scope        Private
     * @param       {Event}       e       event
     * Description  Passes control to handlers according to the hotkey pressed
     */
    keymanweb._ProcessHotKeys = function(e) {
      if(!e) {
        e = window.event;
      }

      var _Lcode = keymanweb._GetEventKeyCode(e);
      if(_Lcode == null) {
        return null;
      }
      
      // Removed testing of e.shiftKey==null  I3363 (Build 301)
      var _Lmodifiers = 
        (e.shiftKey ? 0x10 : 0) |
        (e.ctrlKey ? (e.ctrlLeft ? 0x20 : 0x20) : 0) | 
        (e.altKey ? (e.altLeft ? 0x40 : 0x40) : 0);

      for(var i=0; i<keymanweb._HotKeys.length; i++) {  
        if(_Lcode == keymanweb._HotKeys[i].Code) { 
          if(_Lmodifiers == keymanweb._HotKeys[i].Shift) { 
            keymanweb._HotKeys[i].Handler(); 
            e.returnValue = 0; 
            if(e && e.preventDefault) e.preventDefault(); 
            e.cancelBubble = true; 
            return false; 
          }
        }
      }
      return true;
    }

    util.attachDOMEvent(document, 'keyup', keymanweb._ProcessHotKeys,false);  

    /**
     * Gets the cookie for the name and language code of the most recently active keyboard
     * 
     *  Defaults to US English, but this needs to be user-set in later revision (TODO)      
     * 
     * @return      {string}          InternalName:LanguageCode 
     **/    
    keymanweb['getSavedKeyboard'] = function() {
      return keymanweb.keyboardManager.getSavedKeyboard();  
    }

    util.attachDOMEvent(window, 'focus', keymanweb._ResetVKShift,false);  // I775
    util.attachDOMEvent(window, 'blur', keymanweb._ResetVKShift,false);   // I775
    
    // Initialize supplementary plane string extensions
    String.kmwEnableSupplementaryPlane(false);    

  })();
}