templates/script.ts

   1 // -*- JavaScript -*-
   2
   3 // Copyright 2020-2021 Ian Jackson and contributors to Otter
   4 // SPDX-License-Identifier: AGPL-3.0-or-later
   5 // There is NO WARRANTY.
   6
   7 // elemnts for a piece
   8 //
   9 // In svg toplevel
  10 //
  11 //   uelem
  12 //      #use{}
  13 //      <use id="use{}", href="#piece{}" x= y= >
  14 //         .piece   piece id (static)
  15 //      container to allow quick movement and hang stuff off
  16 //
  17 //   delem
  18 //      #defs{}
  19 //      <def id="defs{}">
  20 //
  21 // And in each delem
  22 //
  23 //   pelem
  24 //   #piece{}
  25 //         .dragraise   dragged more than this ?  raise to top!
  26 //         .special     enum RenderSpecial
  27 //      <g id="piece{}" >
  28 //      currently-displayed version of the piece
  29 //      to allow addition/removal of selected indication
  30 //      contains 1 or 3 subelements:
  31 //      one is straight from server and not modified
  32 //      one is possible <use href="#select{}" >
  33 //      one is possible <use href="#halo{}" >
  34 //
  35 //   #select{}
  36 //      generated by server, referenced by JS in pelem for selection
  37 //
  38 //   #def.{}.stuff
  39 //      generated by server, reserved for Piece trait impl
  40
  41 type PieceId = string;
  42 type PlayerId = string;
  43 type Pos = [number, number];
  44 type Rect = [Pos, Pos];
  45 type ClientSeq = number;
  46 type Generation = number;
  47 type UoKind = 'Client' | "Global"| "Piece" | "ClientExtra" | "GlobalExtra";
  48 type WhatResponseToClientOp = "Predictable" | "Unpredictable" | "UpdateSvg";
  49 type HeldUsRaising = "NotYet" | "Lowered" | "Raised"
  50 type Timestamp = number; // unix time_t, will break in 285My
  51 type Layout = 'Portrait' | 'Landscape';
  52 type PieceMoveable = "No" | "IfWresting" | "Yes";
  53 type CompassAngle = number;
  54 type FaceId = number;
  55
  56 type UoDescription = {
  57   kind: UoKind;
  58   wrc: WhatResponseToClientOp,
  59   def_key: string,
  60   opname: string,
  61   desc: string,
  62 }
  63
  64 type UoRecord = UoDescription & {
  65   targets: PieceId[] | null,
  66 }
  67
  68 type ZCoord = string;
  69
  70 // On load, starts from SessionPieceLoadJson (Rust-only)
  71 // On update, updated field-by-field from PreparedPieceState (Rust&JS)
  72 type PieceInfo = {
  73   held : PlayerId | null,
  74   cseq_main : number | null,
  75   cseq_loose: number | null,
  76   cseq_updatesvg : number | null,
  77   z : ZCoord,
  78   zg : Generation,
  79   angle: CompassAngle,
  80   pinned: boolean,
  81   moveable: PieceMoveable,
  82   rotateable: boolean,
  83   multigrab: boolean,
  84   desc: string,
  85   uos : UoDescription[],
  86   uelem : SVGGraphicsElement,
  87   delem : SVGGraphicsElement,
  88   pelem : SVGGraphicsElement,
  89   queued_moves : number,
  90   last_seen_moved : DOMHighResTimeStamp | null, // non-0 means halo'd
  91   held_us_inoccult: boolean,
  92   held_us_raising: HeldUsRaising,
  93   bbox: Rect,
  94   drag_delta: number,
  95   special: SpecialRendering | null,
  96 }
  97
  98 type SpecialRendering = {
  99   kind: string,
 100   stop: SpecialRenderingCallback,
 101 }
 102
 103 let wasm : InitOutput;
 104
 105 var pieces : { [piece: string]: PieceInfo } = Object.create(null);
 106
 107 type MessageHandler = (op: Object) => void;
 108 type PieceHandler = (piece: PieceId, p: PieceInfo, info: Object) => void;
 109 type PieceErrorHandler = (piece: PieceId, p: PieceInfo, m: PieceOpError)
 110   => boolean;
 111 type SpecialRenderingCallback =
 112   (piece: PieceId, p: PieceInfo, s: SpecialRendering) => void;
 113 interface DispatchTable<H> { [key: string]: H };
 114
 115 var otter_debug: boolean;
 116
 117 // from header
 118 var movehist_len_i: number;
 119 var movehist_len_max: number;
 120 var movehist_lens: number[];
 121
 122 // todo turn all var into let
 123 // todo any exceptions should have otter in them or something
 124 var globalinfo_elem : HTMLElement;
 125 var layout: Layout;
 126 var held_surround_colour: string;
 127 var general_timeout : number = 10000;
 128 var messages : DispatchTable<MessageHandler> = Object();
 129 var special_renderings : DispatchTable<SpecialRenderingCallback> = Object();
 130 var pieceops : DispatchTable<PieceHandler> = Object();
 131 var update_error_handlers : DispatchTable<MessageHandler> = Object();
 132 var piece_error_handlers : DispatchTable<PieceErrorHandler> = Object();
 133 var our_dnd_type = "text/puvnex-game-server-dummy";
 134 var api_queue : [string, Object][] = [];
 135 var api_posting = false;
 136 var us : PlayerId;
 137 var gen : Generation = 0;
 138 var cseq : ClientSeq = 0;
 139 var ctoken : string;
 140 var uo_map : { [k: string]: UoRecord | null } = Object.create(null);
 141 var keyops_local : { [opname: string]: (uo: UoRecord) => void } = Object();
 142 var last_log_ts: wasm_bindgen.TimestampAbbreviator;
 143 var last_zoom_factor : number = 1.0;
 144 var firefox_bug_zoom_factor_compensation : number = 1.0;
 145 var test_update_hook : () => void;
 146
 147 var svg_ns : string;
 148 var space : SVGGraphicsElement;
 149 var pieces_marker : SVGGraphicsElement;
 150 var defs_marker : SVGGraphicsElement;
 151 var movehist_start: SVGGraphicsElement;
 152 var movehist_end: SVGGraphicsElement;
 153 var rectsel_path: SVGGraphicsElement;
 154 var log_elem : HTMLElement;
 155 var logscroll_elem : HTMLElement;
 156 var status_node : HTMLElement;
 157 var uos_node : HTMLElement;
 158 var zoom_val : HTMLInputElement;
 159 var zoom_btn : HTMLInputElement;
 160 var links_elem : HTMLElement;
 161 var was_wresting: boolean;
 162 var wresting: boolean;
 163 var occregions: wasm_bindgen.RegionList;
 164 let special_count: number | null;
 165
 166 var movehist_gen: number = 0;
 167 const MOVEHIST_ENDS = 2.5;
 168 const SPECIAL_MULTI_DELTA_EACH = 3;
 169 const SPECIAL_MULTI_DELTA_MAX = 18;
 170
 171 type PaneName = string;
 172 const pane_keys : { [key: string]: PaneName } = {
 173   "H" : "help",
 174   "U" : "players",
 175   "B" : "bundles",
 176 };
 177
 178 const uo_kind_prec : { [kind: string]: number } = {
 179   'GlobalExtra' :  50,
 180   'Client'      :  70,
 181   'Global'      : 100,
 182   'Piece'       : 200,
 183   'ClientExtra' : 500,
 184 }
 185
 186 type PlayerInfo = {
 187   dasharray : string,
 188   nick: string,
 189 }
 190 var players : { [player: string]: PlayerInfo };
 191
 192 type MovementRecord = { // for yellow halo, unrelasted to movehist
 193   piece: PieceId,
 194   p: PieceInfo,
 195   this_motion: DOMHighResTimeStamp,
 196 }
 197 var movements : MovementRecord[] = [];
 198
 199 function xhr_post_then(url : string, data: string,
 200                        good : (xhr: XMLHttpRequest) => void) {
 201   var xhr : XMLHttpRequest = new XMLHttpRequest();
 202   xhr.onreadystatechange = function(){
 203     if (xhr.readyState != XMLHttpRequest.DONE) { return; }
 204     if (xhr.status != 200) { xhr_report_error(xhr); }
 205     else { good(xhr); }
 206   };
 207   xhr.timeout = general_timeout;
 208   xhr.open('POST',url);
 209   xhr.setRequestHeader('Content-Type','application/json');
 210   xhr.send(data);
 211 }
 212
 213 function xhr_report_error(xhr: XMLHttpRequest) {
 214   json_report_error({
 215     statusText : xhr.statusText,
 216     responseText : xhr.responseText,
 217   });
 218 }
 219
 220 function json_report_error(error_for_json: Object) {
 221   let error_message = JSON.stringify(error_for_json);
 222   string_report_error(error_message);
 223 }
 224
 225 function string_report_error(error_message: String) {
 226   string_report_error_raw('Error (reloading may help?): ' + error_message)
 227 }
 228 function string_report_error_raw(error_message: String) {
 229   let errornode = document.getElementById('error')!;
 230   errornode.textContent += '\n' + error_message;
 231   console.error("ERROR reported via log", error_message);
 232   // todo want to fix this for at least basic game reconfigs, auto-reload?
 233 }
 234
 235 function api_immediate(meth: string, data: Object) {
 236   api_queue.push([meth, data]);
 237   api_check();
 238 }
 239 function api_delay(meth: string, data: Object) {
 240   if (api_queue.length==0) window.setTimeout(api_check, 10);
 241   api_queue.push([meth, data]);
 242 }
 243 function api_check() {
 244   if (api_posting) { return; }
 245   if (!api_queue.length) { test_update_hook(); return; }
 246   do {
 247     var [meth, data] = api_queue.shift()!;
 248     if (meth != 'm') break;
 249     let piece = (data as any).piece;
 250     let p = pieces[piece];
 251     if (p == null) break;
 252     p.queued_moves--;
 253     if (p.queued_moves == 0) break;
 254   } while (api_queue.length);
 255   api_posting = true;
 256   xhr_post_then('/_/api/'+meth, JSON.stringify(data), api_posted);
 257 }
 258 function api_posted() {
 259   api_posting = false;
 260   api_check();
 261 }
 262
 263 function api_piece_x(f: (meth: string, payload: Object) => void,
 264                      loose: boolean,
 265                      meth: string,
 266                      piece: PieceId, p: PieceInfo,
 267                      op: Object) {
 268   clear_halo(piece,p);
 269   cseq += 1;
 270   if (loose) {
 271     p.cseq_loose = cseq;
 272   } else {
 273     p.cseq_main = cseq;
 274     p.cseq_loose = null;
 275   }
 276   f(meth, {
 277     ctoken : ctoken,
 278     piece : piece,
 279     gen : gen,
 280     cseq : cseq,
 281     op : op,
 282     loose: loose,
 283   })
 284 }
 285 function api_piece(meth: string,
 286                    piece: PieceId, p: PieceInfo,
 287                    op: Object) {
 288   api_piece_x(api_immediate, false,meth, piece, p, op);
 289 }
 290
 291 function svg_element(id: string): SVGGraphicsElement | null {
 292   let elem = document.getElementById(id);
 293   return elem as unknown as (SVGGraphicsElement | null);
 294 }
 295 function piece_element(base: string, piece: PieceId): SVGGraphicsElement | null
 296 {
 297   return svg_element(base+piece);
 298 }
 299
 300 function piece_moveable(p: PieceInfo) {
 301   return p.moveable == 'Yes' || p.moveable == 'IfWresting' && wresting;
 302 }
 303 function treat_as_pinned(p: { pinned: boolean }): boolean {
 304   return p.pinned && !wresting;
 305 }
 306 function pinned_log_message(p: PieceInfo) {
 307   add_log_message('That piece ('+p.desc+') is pinned to the table.');
 308 }
 309
 310 // ----- key handling -----
 311
 312 function recompute_keybindings() {
 313   uo_map = Object.create(null);
 314   let all_targets = [];
 315   for (let piece of Object.keys(pieces)) {
 316     let p = pieces[piece];
 317     if (p.held != us) continue;
 318     all_targets.push(piece);
 319     for (var uo of p.uos) {
 320       let currently = uo_map[uo.def_key];
 321       if (currently === null) continue;
 322       if (currently !== undefined) {
 323         if (currently.opname != uo.opname) {
 324           uo_map[uo.def_key] = null;
 325           continue;
 326         }
 327       } else {
 328         currently = {
 329           targets: [],
 330           ...uo
 331         };
 332         uo_map[uo.def_key] = currently;
 333       }
 334       currently.desc = currently.desc < uo.desc ? currently.desc : uo.desc;
 335       currently.targets!.push(piece);
 336     }
 337   }
 338   all_targets.sort(pieceid_z_cmp);
 339   let add_uo = function(targets: PieceId[] | null, uo: UoDescription) {
 340     uo_map[uo.def_key] = {
 341       targets: targets,
 342       ...uo
 343     };
 344   };
 345   if (all_targets.length) {
 346     let got_rotateable = false;
 347     for (let t of all_targets) {
 348       if (pieces[t]!.rotateable)
 349         got_rotateable = true;
 350     }
 351     if (got_rotateable) {
 352       add_uo(all_targets, {
 353         def_key: 'l',
 354         kind: 'Client',
 355         wrc: 'Predictable',
 356         opname: "left",
 357         desc: "rotate left",
 358       });
 359       add_uo(all_targets, {
 360         def_key: 'r',
 361         kind: 'Client',
 362         wrc: 'Predictable',
 363         opname: "right",
 364         desc: "rotate right",
 365       });
 366     }
 367     add_uo(all_targets, {
 368       def_key: 'b',
 369       kind: 'Client',
 370       wrc: 'Predictable',
 371       opname: "lower",
 372       desc: "send to bottom (below other pieces)",
 373     });
 374     add_uo(all_targets, {
 375       def_key: 't',
 376       kind: 'Client',
 377       wrc: 'Predictable',
 378       opname: "raise",
 379       desc: "raise to top",
 380     });
 381   }
 382   if (all_targets.length) {
 383     let got = 0;
 384     for (let t of all_targets) {
 385       got |= 1 << Number(pieces[t]!.pinned);
 386     }
 387     if (got == 1) {
 388       add_uo(all_targets, {
 389         def_key: 'P',
 390         kind: 'ClientExtra',
 391         opname: 'pin',
 392         desc: 'Pin to table',
 393         wrc: 'Predictable',
 394       });
 395     } else if (got == 2) {
 396       add_uo(all_targets, {
 397         def_key: 'P',
 398         kind: 'ClientExtra',
 399         opname: 'unpin',
 400         desc: 'Unpin from table',
 401         wrc: 'Predictable',
 402       });
 403     }
 404   }
 405   add_uo(null, {
 406     def_key: wresting ? 'W SPC' /* won't match, handle ad-hoc */ : 'W',
 407     kind: 'ClientExtra',
 408     opname: 'wrest',
 409     desc: wresting ? 'Exit wresting mode' : 'Enter wresting mode',
 410     wrc: 'Predictable',
 411   });
 412   if (special_count != null) {
 413     let desc;
 414     if (special_count == 0) {
 415       desc = 'select bottommost';
 416     } else {
 417       desc = `select ${special_count}`;
 418     }
 419     desc = `cancel <strong style="color:purple">${desc}</strong>`;
 420     add_uo(null, {
 421       def_key: 'SPC', // won't match key event; we handle this ad-hoc
 422       kind: 'ClientExtra',
 423       opname: 'cancel-special',
 424       desc: desc,
 425       wrc: 'Predictable',
 426     });
 427   }
 428   add_uo(null, {
 429     def_key: 'h',
 430     kind: 'ClientExtra',
 431     opname: 'motion-hint-history',
 432     desc: 'Recent history display',
 433     wrc: 'Predictable',
 434   });
 435   var uo_keys = Object.keys(uo_map);
 436   uo_keys.sort(function (ak,bk) {
 437     let a = uo_map[ak];
 438     let b = uo_map[bk];
 439     if (a==null || b==null) return (
 440       ( (!!a) as any ) -
 441       ( (!!b) as any )
 442     );
 443     return uo_kind_prec[a.kind] - uo_kind_prec[b.kind]
 444       || ak.localeCompare(bk);
 445   });
 446   let mid_elem = null;
 447   for (let celem = uos_node.firstElementChild;
 448        celem != null;
 449        celem = nextelem) {
 450     var nextelem = celem.nextElementSibling;
 451     let cid = celem.getAttribute("id");
 452     if (cid == "uos-mid") mid_elem = celem;
 453     else if (celem.getAttribute("class") == 'uos-mid') { }
 454     else celem.remove();
 455   }
 456   for (var kk of uo_keys) {
 457     let uo = uo_map[kk];
 458     if (!uo) continue;
 459     let prec = uo_kind_prec[uo.kind];
 460     let ent = document.createElement('div');
 461     ent.innerHTML = '<b>' + kk + '</b> ' + uo.desc;
 462     if (prec < 400) {
 463       ent.setAttribute('class','uokey-l');
 464       uos_node.insertBefore(ent, mid_elem);
 465     } else {
 466       ent.setAttribute('class','uokey-r');
 467       uos_node.appendChild(ent);
 468     }
 469   }
 470 }
 471
 472 function some_keydown(e: KeyboardEvent) {
 473   // https://developer.mozilla.org/en-US/docs/Web/API/Document/keydown_event
 474   // says to do this, something to do with CJK composition.
 475   // https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent
 476   // says that keyCode is deprecated
 477   // my tsc says this isComposing thing doesn't exist.  wat.
 478   if ((e as any).isComposing /* || e.keyCode === 229 */) return;
 479   if (e.ctrlKey || e.altKey || e.metaKey) return;
 480   if (e.target) {
 481     // someone else is dealing with it ?
 482     let tag = (e.target as HTMLElement).tagName;
 483     if (tag == 'INPUT') return;
 484   }
 485
 486   let y = function() { e.preventDefault(); e.stopPropagation(); }
 487
 488   let pane = pane_keys[e.key];
 489   if (pane) {
 490     y();
 491     return pane_switch(pane);
 492   }
 493
 494   let special_count_key = parseInt(e.key);
 495   if (isFinite(special_count_key)) {
 496     y();
 497     if (special_count == null) special_count = 0;
 498     special_count *= 10;
 499     special_count += special_count_key;
 500     special_count %= 100000;
 501     mousecursor_etc_reupdate();
 502     return;
 503   }
 504   if (e.key == ' ' || (e.key == 'W' && wresting)) {
 505     y();
 506     special_count = null;
 507     wresting = false;
 508     mousecursor_etc_reupdate();
 509     return;
 510   }
 511   if (e.key == 'Backspace') {
 512     if (special_count == null) {
 513       wresting = false;
 514     } else if (special_count >= 10) {
 515       special_count = Math.round(special_count / 10 - .45);
 516     } else {
 517       special_count = null;
 518     }
 519     mousecursor_etc_reupdate();
 520     return;
 521   }
 522
 523   let uo = uo_map[e.key];
 524   if (uo === undefined || uo === null) return;
 525
 526   y();
 527   console.log('KEY UO', e, uo);
 528   if (uo.kind == 'Client' || uo.kind == 'ClientExtra') {
 529     let f = keyops_local[uo.opname];
 530     f(uo);
 531     return;
 532   }
 533   if (!(uo.kind == 'Global' || uo.kind == 'GlobalExtra' || uo.kind == 'Piece'))
 534     throw 'bad kind '+uo.kind;
 535
 536   for (var piece of uo.targets!) {
 537     let p = pieces[piece]!;
 538     api_piece('k', piece, p, { opname: uo.opname, wrc: uo.wrc });
 539     if (uo.wrc == 'UpdateSvg') {
 540       // No UpdateSvg is loose, so no need to check p.cseq_loose
 541       p.cseq_updatesvg = p.cseq_main;
 542       redisplay_ancillaries(piece,p);
 543     }
 544   }
 545 }
 546
 547 function pane_switch(newpane: PaneName) {
 548   let new_e;
 549   for (;;) {
 550     new_e = document.getElementById('pane_' + newpane)!;
 551     let style = new_e.getAttribute('style');
 552     if (style || newpane == 'help') break;
 553     newpane = 'help';
 554   }
 555   for (let old_e = new_e.parentElement!.firstElementChild;
 556        old_e;
 557        old_e = old_e.nextElementSibling) {
 558     old_e.setAttribute('style','display: none;');
 559   }
 560   new_e.removeAttribute('style');
 561 }
 562
 563 function mousecursor_etc_reupdate() {
 564   let style_elem = document.getElementById("space-cursor-style")!;
 565   let style_text;
 566   let svg;
 567   let xy;
 568   let path = 'stroke-linecap="square" d="M -10 -10 10 10 M 10 -10 -10 10"';
 569
 570   document.getElementById('wresting-warning')!.innerHTML = !wresting ? "" :
 571     " <strong>(wresting mode!)</strong>";
 572
 573   if (wresting != was_wresting) {
 574     ungrab_all();
 575     was_wresting = wresting;
 576   }
 577
 578   if (wresting) {
 579     let text;
 580     if (special_count == null) {
 581       text = "WREST";
 582     } else if (special_count == 0) {
 583       text = "W v";
 584     } else {
 585       text = "W " + special_count;
 586     }
 587     xy = '60 15';
 588     svg =
 589 `<svg xmlns="http://www.w3.org/2000/svg"
 590      viewBox="-60 -15 120 60" width="120" height="60">
 591   <g transform="translate(0 0)">
 592     <path stroke-width="8" stroke="black" ${path}/>
 593     <path stroke-width="4" stroke="#cc0" ${path}/>
 594  <text x="0" y="40" fill="black" stroke="#cc0" stroke-width="1.7" text-align="center" text-anchor="middle"
 595  font-family="sans-serif" font-size="30">${text}</text>
 596   </g></svg>`;
 597   } else if (special_count == null) {
 598   } else {
 599     if (special_count != 0) {
 600       let text_len = special_count.toString().length;
 601       let text_x = text_len <= 3 ? 0 : -15;
 602       let text_size = text_len <= 3 ? 50 : 45 * (4/text_len);
 603       xy = '15 50';
 604       svg =
 605 `<svg xmlns="http://www.w3.org/2000/svg"
 606      viewBox="-15 0 120 65" width="120" height="65">
 607   <g transform="translate(0 50)">
 608     <path stroke-width="8" stroke="#fcf" ${path}/>
 609     <path stroke-width="4" stroke="purple" ${path}/>
 610     <text x="${text_x}" y="0" fill="purple" stroke="#fcf" stroke-width="2"
 611        font-family="sans-serif" font-size="${text_size}">${special_count}</text>
 612   </g></svg>`;
 613     } else {
 614       let path = 'stroke-linecap="square" d="M -10 -10 0 0 10 -10 M 0 0 0 -20"';
 615       xy = '15 30';
 616       svg =
 617 `<svg xmlns="http://www.w3.org/2000/svg"
 618      viewBox="-15 -25 30 30" width="30" height="30">
 619   <g transform="translate(0 0)">
 620     <path stroke-width="8" stroke="#fcf" ${path}/>
 621     <path stroke-width="4" stroke="purple" ${path}/>
 622   </g></svg>`;
 623     }
 624   }
 625   // Empirically, setting this to '' and then back to the SVG data
 626   // seems to cause Firefox to update it more promptly.
 627   style_elem.innerHTML = '';
 628   if (svg !== undefined) {
 629     let svg_data = btoa(svg);
 630     style_text =
 631 `svg[id=space] {
 632   cursor: url(data:image/svg+xml;base64,${svg_data}) ${xy}, auto;
 633 }`;
 634     style_elem.innerHTML = style_text;
 635   }
 636   recompute_keybindings();
 637 }
 638
 639 keyops_local['left' ] = function (uo: UoRecord) { rotate_targets(uo, +1); }
 640 keyops_local['right'] = function (uo: UoRecord) { rotate_targets(uo, -1); }
 641
 642 function rotate_targets(uo: UoRecord, dangle: number): boolean {
 643   for (let piece of uo.targets!) {
 644     let p = pieces[piece]!;
 645     if (!p.rotateable) continue;
 646     p.angle += dangle + 8;
 647     p.angle %= 8;
 648     let transform = wasm_bindgen.angle_transform(p.angle);
 649     p.pelem.setAttributeNS(null,'transform',transform);
 650     api_piece('rotate', piece,p, p.angle);
 651   }
 652   recompute_keybindings();
 653   return true;
 654 }
 655
 656 // ----- lower -----
 657
 658 type LowerTodoItem = {
 659   piece: PieceId,
 660   p: PieceInfo,
 661   heavy: boolean,
 662 };
 663
 664 type LowerTodoList = { [piece: string]: LowerTodoItem };
 665
 666 keyops_local['lower'] = function (uo: UoRecord) { lower_targets(uo); }
 667
 668 function lower_heavy(p: PieceInfo): boolean {
 669   return wresting || p.pinned || p.moveable == "No";
 670 }
 671
 672 function lower_targets(uo: UoRecord): boolean {
 673   let targets_todo : LowerTodoList = Object.create(null);
 674
 675   for (let piece of uo.targets!) {
 676     let p = pieces[piece]!;
 677     let heavy = lower_heavy(p);
 678     targets_todo[piece] = { p, piece, heavy, };
 679   }
 680   let problem = lower_pieces(targets_todo);
 681   if (problem !== null) {
 682     add_log_message('Cannot lower: ' + problem);
 683     return false;
 684   }
 685   return true;
 686 }
 687
 688 function lower_pieces(targets_todo: LowerTodoList):
 689  string | null
 690 {
 691   // This is a bit subtle.  We don't want to lower below heavy pieces
 692   // (unless we are heavy too, or the user is wresting).  But maybe
 693   // the heavy pieces aren't already at the bottom.  For now we will
 694   // declare that all heavy pieces "should" be below all light
 695   // ones.  Not as an invariant, but as a thing we will do here to try
 696   // to make a sensible result.  We implement this as follows: if we
 697   // find heavy pieces above light pieces, we move those heavy
 698   // pieces to the bottom too, just below us, preserving their
 699   // relative order.
 700   //
 701   // Disregarding heavy targets:
 702   //
 703   // Z     <some stuff not including any light targets>
 704   // Z
 705   //       topmost light target           *
 706   // B (
 707   // B     light non-target
 708   // B |   light target                   *
 709   // B |   heavy non-target, mis-stacked  *
 710   // B )*
 711   // B
 712   //       bottommost light non-target
 713   //        if that is below topmost light target
 714   //            <- tomove_light: insert targets from * here           Q ->
 715   //            <- tomove_misstacked: insert non-targets from * here  Q ->
 716   //            <- heavy non-targets with clashing Z Coords           X ->
 717   // A
 718   // A     heavy non-targets (nomove_heavy)
 719   //            <- tomove_heavy: insert all heavy targets here        P ->
 720   //
 721   // When wresting, treat all targets as heavy.
 722
 723   type Entry = {
 724     piece: PieceId,
 725     p: PieceInfo,
 726   };
 727   // bottom of the stack order first
 728   let tomove_light       : Entry[] = [];
 729   let tomove_misstacked  : Entry[] = [];
 730   let nomove_heavy       : Entry[] = [];
 731   let tomove_heavy       : Entry[] = [];
 732
 733                                                     //  A      B      Z
 734   let q_z_top : ZCoord | null = null;               //  null   some   some
 735   let n_targets_todo_light = 0;                     //                0
 736
 737   let any_targets = false;
 738   for (const piece of Object.keys(targets_todo)) {
 739     any_targets = true;
 740     let p = targets_todo[piece];
 741     if (!p.heavy) n_targets_todo_light++;
 742   }
 743   if (!any_targets) return 'Nothing to lower!';
 744
 745   let walk = pieces_marker;
 746   for (;;) { // starting at the bottom of the stack order
 747     if (Object.keys(targets_todo).length == 0 &&
 748        q_z_top !== null) {
 749       // no targets left, state Z, we can stop now
 750       console.log('LOWER STATE Z FINISHED');
 751       break;
 752     }
 753
 754     let new_walk = walk.nextElementSibling;
 755     if (new_walk == null) {
 756       console.log('LOWER WALK NO SIBLING!');
 757       break;
 758     }
 759     walk = new_walk as SVGGraphicsElement;
 760     let piece = walk.dataset.piece;
 761     if (piece == null) {
 762       console.log('LOWER WALK REACHED TOP');
 763       break;
 764     }
 765
 766     let p = pieces[piece]!;
 767     let todo = targets_todo[piece];
 768     if (todo) {
 769       let xst = '';
 770       if (q_z_top === null && !todo.heavy) {
 771         q_z_top = p.z;
 772         xst = 'STATE -> B';
 773       }
 774       console.log('LOWER WALK', piece, 'TODO', todo.heavy ? "H" : "_", xst);
 775       delete targets_todo[piece];
 776       if (!todo.heavy) n_targets_todo_light--;
 777       (todo.heavy ? tomove_heavy : tomove_light).push(todo);
 778       continue;
 779     }
 780
 781     let p_heavy = lower_heavy(p);
 782     if (q_z_top === null) { // state A
 783       if (!p_heavy) {
 784         console.log('LOWER WALK', piece, 'STATE A -> Z');
 785         q_z_top = p.z;
 786       } else {
 787         console.log('LOWER WALK', piece, 'STATE A');
 788         nomove_heavy.push({ p, piece });
 789       }
 790       continue;
 791     }
 792
 793     // state B
 794     if (p_heavy) {
 795       console.log('LOWER WALK', piece, 'STATE B MIS-STACKED');
 796       tomove_misstacked.push({ p, piece });
 797     } else {
 798       console.log('LOWER WALK', piece, 'STATE B');
 799     }
 800   }
 801
 802   if (q_z_top === null) {
 803     // Somehow we didn't find the top of Q, so we didn't meet any
 804     // targets.  (In the walk loop, we always set q_z_top if todo.)
 805     q_z_top =
 806       tomove_misstacked.length ? tomove_misstacked[0].p.z :
 807       tomove_light     .length ? tomove_light     [0].p.z :
 808                                  tomove_heavy     [0].p.z;
 809   }
 810
 811   while (nomove_heavy.length &&
 812          (tomove_light.length || tomove_misstacked.length) &&
 813          nomove_heavy[nomove_heavy.length-1].p.z == q_z_top) {
 814     // Yowzer.  We have to reset the Z coordinates on these heavy
 815     // pieces, whose Z coordinate is the same as the stuff we are not
 816     // touching, because otherwise there is no gap.
 817     //
 818     // Treating them as misstacked instead is sufficient, provided
 819     // we put them at the front (bottom end) of the misstacked list.
 820     //
 821     // This is X in the chart.
 822     //
 823     let restack = nomove_heavy.pop()!;
 824     console.log('LOWER CLASHING Z - RESTACKING', restack);
 825     tomove_misstacked.unshift(restack);
 826   }
 827
 828   type PlanEntry = {
 829     content: Entry[], // bottom to top
 830     z_top: ZCoord,
 831     z_bot: ZCoord | null,
 832   };
 833
 834   let plan : PlanEntry[] = [];
 835
 836   console.log('LOWER PARTQ X', tomove_misstacked);
 837   console.log('LOWER PARTQ L', tomove_light);
 838   console.log('LOWER PARTP H', tomove_heavy);
 839   let partQ = tomove_misstacked.concat(tomove_light);
 840   let partP = tomove_heavy;
 841
 842   if (nomove_heavy.length == 0) {
 843     plan.push({
 844       content: partP.concat(partQ),
 845       z_top: q_z_top,
 846       z_bot : null,
 847     });
 848   } else {
 849     plan.push({
 850       content: partQ,
 851       z_top: q_z_top,
 852       z_bot: nomove_heavy[nomove_heavy.length-1].p.z,
 853     }, {
 854       content: partP,
 855       z_top: nomove_heavy[0].p.z,
 856       z_bot: null,
 857     });
 858   }
 859
 860   console.log('LOWER PLAN', plan);
 861
 862   for (const pe of plan) {
 863     for (const e of pe.content) {
 864       if (e.p.held != null && e.p.held != us) {
 865         return "lowering would disturb a piece held by another player";
 866       }
 867     }
 868   }
 869
 870   for (const pe of plan) {
 871     let z_top = pe.z_top;
 872     let z_bot = pe.z_bot;
 873     if (! pe.content.length) continue;
 874     if (z_bot == null) {
 875       let first_z = pe.content[0].p.z;
 876       if (z_top >= first_z)
 877         z_top = first_z;
 878     }
 879     let zrange = wasm_bindgen.range(z_bot, z_top, pe.content.length);
 880     console.log('LOQER PLAN PE',
 881                 pe, z_bot, z_top, pe.content.length, zrange.debug());
 882     for (const e of pe.content) {
 883       let p = e.p;
 884       p.held_us_raising = "Lowered";
 885       piece_set_zlevel(e.piece, p, (oldtop_piece) => {
 886         let z = zrange.next();
 887         p.z = z;
 888         api_piece("setz", e.piece, e.p, { z });
 889       });
 890     }
 891   }
 892   return null;
 893 }
 894
 895 keyops_local['wrest'] = function (uo: UoRecord) {
 896   wresting = !wresting;
 897   mousecursor_etc_reupdate();
 898 }
 899
 900 keyops_local['motion-hint-history'] = function (uo: UoRecord) {
 901   movehist_len_i ++;
 902   movehist_len_i %= movehist_lens.length;
 903   movehist_revisible();
 904 }
 905
 906 keyops_local['pin'  ] = function (uo) {
 907   if (!lower_targets(uo)) return;
 908   pin_unpin(uo, true);
 909 }
 910 keyops_local['unpin'] = function (uo) {
 911   pin_unpin(uo, false);
 912 }
 913
 914 function pin_unpin(uo: UoRecord, newpin: boolean) {
 915   for (let piece of uo.targets!) {
 916     let p = pieces[piece]!;
 917     p.pinned = newpin;
 918     api_piece('pin', piece,p, newpin);
 919     redisplay_ancillaries(piece,p);
 920   }
 921   recompute_keybindings();
 922 }
 923
 924 // ----- raising -----
 925
 926 keyops_local['raise'] = function (uo: UoRecord) { raise_targets(uo); }
 927
 928 function raise_targets(uo: UoRecord) {
 929   let any = false;
 930   for (let piece of uo.targets!) {
 931     let p = pieces[piece]!;
 932     if (p.pinned || !piece_moveable(p)) continue;
 933     any = true;
 934     piece_raise(piece, p, "NotYet");
 935   }
 936   if (!any) {
 937     add_log_message('No pieces could be raised.');
 938   }
 939 }
 940
 941 function piece_raise(piece: PieceId, p: PieceInfo,
 942                      new_held_us_raising: HeldUsRaising,
 943   implement: (piece: PieceId, p: PieceInfo, z: ZCoord) => void
 944   = function(piece: PieceId, p: PieceInfo, z: ZCoord) {
 945     api_piece("setz", piece,p, { z: z });
 946   })
 947 {
 948   p.held_us_raising = new_held_us_raising;
 949   piece_set_zlevel(piece,p, (oldtop_piece) => {
 950     let oldtop_p = pieces[oldtop_piece]!;
 951     let z = wasm_bindgen.increment(oldtop_p.z);
 952     p.z = z;
 953     implement(piece,p,z);
 954   });
 955 }
 956
 957 // ----- clicking/dragging pieces -----
 958
 959 type DragInfo = {
 960   piece : PieceId,
 961   dox : number,
 962   doy : number,
 963 }
 964
 965 enum DRAGGING { // bitmask
 966   NO           = 0x00,
 967   MAYBE_GRAB   = 0x01,
 968   MAYBE_UNGRAB = 0x02,
 969   YES          = 0x04,
 970   RAISED       = 0x08,
 971 };
 972
 973 var drag_pieces : DragInfo[] = [];
 974 var dragging = DRAGGING.NO;
 975 var dcx : number | null;
 976 var dcy : number | null;
 977
 978 const DRAGTHRESH = 5;
 979
 980 let rectsel_start: Pos | null;
 981 let rectsel_shifted: boolean | null;
 982 const RECTSELTHRESH = 5;
 983
 984 function piece_xy(p: PieceInfo): Pos {
 985   return [ parseFloat(p.uelem.getAttributeNS(null,"x")!),
 986            parseFloat(p.uelem.getAttributeNS(null,"y")!) ];
 987 }
 988
 989 function drag_start_prepare(new_dragging: DRAGGING) {
 990   dragging = new_dragging;
 991
 992   let spos_map = Object.create(null);
 993   for (let piece of Object.keys(pieces)) {
 994     let p = pieces[piece]!;
 995     if (p.held != us) continue;
 996     let spos = piece_xy(p);
 997     let sposk = `${spos[0]} ${spos[1]}`;
 998     if (spos_map[sposk] === undefined) spos_map[sposk] = [spos, []];
 999     spos_map[sposk][1].push([spos, piece,p]);
1000   }
1001
1002   for (let sposk of Object.keys(spos_map)) {
1003     let [[dox, doy], ents] = spos_map[sposk];
1004     for (let i=0; i<ents.length; i++) {
1005       let [p, piece] = ents[i];
1006       let delta = (-(ents.length-1)/2 + i) * SPECIAL_MULTI_DELTA_EACH;
1007       p.drag_delta = Math.min(Math.max(delta, -SPECIAL_MULTI_DELTA_MAX),
1008                                               +SPECIAL_MULTI_DELTA_MAX);
1009       drag_pieces.push({
1010         piece: piece,
1011         dox: dox + p.drag_delta,
1012         doy: doy,
1013       });
1014     }
1015   }
1016 }
1017
1018 function some_mousedown(e : MouseEvent) {
1019   console.log('mousedown', e, e.clientX, e.clientY, e.target);
1020
1021   if (e.button != 0) { return }
1022   if (e.altKey) { return }
1023   if (e.metaKey) { return }
1024   if (e.ctrlKey) {
1025     return;
1026   } else {
1027     drag_mousedown(e, e.shiftKey);
1028   }
1029 }
1030
1031 type MouseFindClicked = null | {
1032   clicked: PieceId[],
1033   held: PlayerId | null,
1034   pinned: boolean,
1035   multigrab?: number,
1036 };
1037
1038 type PieceSet = { [piece: string]: true };
1039
1040 function grab_clicked(clicked: PieceId[], loose: boolean,
1041                       multigrab: number | undefined) {
1042   for (let piece of clicked) {
1043     let p = pieces[piece]!;
1044     set_grab_us(piece,p);
1045     if (multigrab === undefined) {
1046       api_piece_x(api_immediate, loose,
1047                   wresting ? 'wrest' : 'grab', piece,p, { });
1048     } else {
1049       piece_raise(piece,p, 'Raised', function(piece,p,z) {
1050         api_piece_x(api_immediate, loose, 'multigrab',
1051                     piece,p, { n: multigrab, z: z });
1052       })
1053     }
1054   }
1055 }
1056 function ungrab_clicked(clicked: PieceId[]) {
1057   let todo: [PieceId, PieceInfo][] = [];
1058   for (let tpiece of clicked) {
1059     let tp = pieces[tpiece]!;
1060     todo.push([tpiece, tp]);
1061   }
1062   do_ungrab_n(todo);
1063 }
1064
1065 function mouse_clicked_one(piece: PieceId, p: PieceInfo): MouseFindClicked {
1066   let held = p.held;
1067   let pinned = p.pinned;
1068   return { clicked: [piece], held, pinned };
1069 }
1070
1071 function mouse_find_predicate(
1072   wanted: number | null,
1073   allow_for_deselect: boolean,
1074   note_already: PieceSet | null,
1075   predicate: (p: PieceInfo) => boolean
1076 ): MouseFindClicked {
1077   let clicked: PieceId[];
1078   let held: string | null;
1079   let pinned = false;
1080   let already_count = 0;
1081
1082   clicked = [];
1083   let uelem = defs_marker;
1084   while (wanted == null || (clicked.length + already_count) < wanted) {
1085     let i = clicked.length;
1086     uelem = uelem.previousElementSibling as any;
1087     if (uelem == pieces_marker) {
1088       if (wanted != null) {
1089         add_log_message(`Not enough pieces!  Stopped after ${i}.`);
1090         return null;
1091       }
1092       break;
1093     }
1094     let piece = uelem.dataset.piece!;
1095
1096     function is_already() {
1097       if (note_already != null) {
1098         already_count++;
1099         note_already[piece] = true;
1100       }
1101     }
1102
1103     let p = pieces[piece];
1104     if (treat_as_pinned(p)) continue;
1105     if (p.held && p.held != us && !wresting) continue;
1106     if (i > 0 && !piece_moveable(p))
1107       continue;
1108     if (!predicate(p)) {
1109       continue;
1110     }
1111     if (p.pinned) pinned = true;
1112
1113     if (i == 0) {
1114       held = p.held;
1115       if (held == us && !allow_for_deselect) held = null;
1116     }
1117     if (held! == us) {
1118       // user is going to be deselecting
1119       if (p.held != us) {
1120         // skip ones we don't have
1121         is_already();
1122         continue;
1123       }
1124     } else { // user is going to be selecting
1125       if (p.held == us) {
1126         is_already();
1127         continue; // skip ones we have already
1128       } else if (p.held == null) {
1129       } else {
1130         held = p.held; // wrestish
1131       }
1132     }
1133     clicked.push(piece);
1134   }
1135   if (clicked.length == 0) return null;
1136   else return { clicked, held: held!, pinned: pinned! };
1137 }
1138
1139 function mouse_find_lowest(e: MouseEvent) {
1140   let clickpos = mouseevent_pos(e);
1141   let uelem = pieces_marker;
1142   for (;;) {
1143     uelem = uelem.nextElementSibling as any;
1144     if (uelem == defs_marker) break;
1145     let piece = uelem.dataset.piece!;
1146     let p = pieces[piece]!;
1147     if (p_bbox_contains(p, clickpos)) {
1148       return mouse_clicked_one(piece, p);
1149     }
1150   }
1151   return null;
1152 }
1153
1154 function mouse_find_clicked(e: MouseEvent,
1155                             target: SVGGraphicsElement, piece: PieceId,
1156                             count_allow_for_deselect: boolean,
1157                             note_already: PieceSet | null,
1158                             ): MouseFindClicked
1159 {
1160   let p = pieces[piece]!;
1161   if (special_count == null) {
1162     return mouse_clicked_one(piece, p);
1163   } else if (special_count == 0) {
1164     return mouse_find_lowest(e);
1165   } else { // special_count > 0
1166     if (p.multigrab && !wresting) {
1167       let clicked = mouse_clicked_one(piece, p);
1168       if (clicked) clicked.multigrab = special_count;
1169       return clicked;
1170     } else {
1171       if (special_count > 99) {
1172         add_log_message(
1173           `Refusing to try to select ${special_count} pieces (max is 99)`);
1174         return null;
1175       }
1176       let clickpos = mouseevent_pos(e);
1177       return mouse_find_predicate(
1178         special_count, count_allow_for_deselect, note_already,
1179         function(p) { return p_bbox_contains(p, clickpos); }
1180       )
1181     }
1182   }
1183 }
1184
1185 function drag_mousedown(e : MouseEvent, shifted: boolean) {
1186   let target = e.target as SVGGraphicsElement; // we check this just now!
1187   let piece: PieceId | undefined = target.dataset.piece;
1188
1189   if (!piece) {
1190     rectsel_start = mouseevent_pos(e);
1191     rectsel_shifted = shifted;
1192     window.addEventListener('mousemove', rectsel_mousemove, true);
1193     window.addEventListener('mouseup',   rectsel_mouseup,   true);
1194     return;
1195   }
1196
1197   let note_already = shifted ? null : Object.create(null);
1198
1199   let c = mouse_find_clicked(e, target, piece, false, note_already);
1200   if (c == null) return;
1201   let clicked = c.clicked;
1202   let held = c.held;
1203   let multigrab = c.multigrab;
1204
1205   special_count = null;
1206   mousecursor_etc_reupdate();
1207   drag_cancel();
1208
1209   drag_pieces = [];
1210   if (held == us) {
1211     if (shifted) {
1212       ungrab_clicked(clicked);
1213       return;
1214     }
1215     drag_start_prepare(DRAGGING.MAYBE_UNGRAB);
1216   } else if (held == null || wresting) {
1217     if (!shifted) {
1218       ungrab_all_except(note_already);
1219     }
1220     if (treat_as_pinned(c)) {
1221       pinned_log_message(pieces[c.clicked[0]!]!);
1222       return;
1223     }
1224     grab_clicked(clicked, !wresting, multigrab);
1225     drag_start_prepare(DRAGGING.MAYBE_GRAB);
1226   } else {
1227     add_log_message('That piece is held by another player.');
1228     return;
1229   }
1230   dcx = e.clientX;
1231   dcy = e.clientY;
1232
1233   window.addEventListener('mousemove', drag_mousemove, true);
1234   window.addEventListener('mouseup',   drag_mouseup,   true);
1235 }
1236
1237 function mouseevent_pos(e: MouseEvent): Pos {
1238   let ctm = space.getScreenCTM()!;
1239   let px = (e.clientX - ctm.e)/(ctm.a * firefox_bug_zoom_factor_compensation);
1240   let py = (e.clientY - ctm.f)/(ctm.d * firefox_bug_zoom_factor_compensation);
1241   let pos: Pos = [px, py];
1242   console.log('mouseevent_pos', pos);
1243   return pos;
1244 }
1245
1246 function p_bbox_contains(p: PieceInfo, test: Pos) {
1247   let ctr = piece_xy(p);
1248   for (let i of [0,1]) {
1249     let offset = test[i] - ctr[i];
1250     if (offset < p.bbox[0][i] || offset > p.bbox[1][i])
1251       return false;
1252   }
1253   return true;
1254 }
1255
1256 function do_ungrab_n(todo: [PieceId, PieceInfo][]) {
1257   function sort_with(a: [PieceId, PieceInfo],
1258                      b: [PieceId, PieceInfo]): number {
1259     return piece_z_cmp(a[1], b[1]);
1260   }
1261   todo.sort(sort_with);
1262   for (let [tpiece, tp] of todo) {
1263     do_ungrab_1(tpiece, tp);
1264   }
1265 }
1266 function ungrab_all_except(dont: PieceSet | null) {
1267   let todo: [PieceId, PieceInfo][] =  [];
1268   for (let tpiece of Object.keys(pieces)) {
1269     if (dont && dont[tpiece]) continue;
1270     let tp = pieces[tpiece]!;
1271     if (tp.held == us) {
1272       todo.push([tpiece, tp]);
1273     }
1274   }
1275   do_ungrab_n(todo);
1276 }
1277 function ungrab_all() {
1278   ungrab_all_except(null);
1279 }
1280
1281 function set_grab_us(piece: PieceId, p: PieceInfo) {
1282   p.held = us;
1283   p.held_us_raising = "NotYet";
1284   p.drag_delta = 0;
1285   redisplay_ancillaries(piece,p);
1286   recompute_keybindings();
1287 }
1288 function do_ungrab_1(piece: PieceId, p: PieceInfo) {
1289   let autoraise = p.held_us_raising == "Raised";
1290   p.held = null;
1291   p.held_us_raising = "NotYet";
1292   p.drag_delta = 0;
1293   redisplay_ancillaries(piece,p);
1294   recompute_keybindings();
1295   api_piece('ungrab', piece,p, { autoraise });
1296 }
1297
1298 function clear_halo(piece: PieceId, p: PieceInfo) {
1299   let was = p.last_seen_moved;
1300   p.last_seen_moved = null;
1301   if (was) redisplay_ancillaries(piece,p);
1302 }
1303
1304 function ancillary_node(piece: PieceId, stroke: string): SVGGraphicsElement {
1305   var nelem = document.createElementNS(svg_ns,'use');
1306   nelem.setAttributeNS(null,'href','#surround'+piece);
1307   nelem.setAttributeNS(null,'stroke',stroke);
1308   nelem.setAttributeNS(null,'fill','none');
1309   return nelem as any;
1310 }
1311
1312 function redisplay_ancillaries(piece: PieceId, p: PieceInfo) {
1313   let href = '#surround'+piece;
1314   console.log('REDISPLAY ANCILLARIES',href);
1315
1316   for (let celem = p.pelem.firstElementChild;
1317        celem != null;
1318        celem = nextelem) {
1319     var nextelem = celem.nextElementSibling
1320     let thref = celem.getAttributeNS(null,"href");
1321     if (thref == href) {
1322       celem.remove();
1323     }
1324   }
1325
1326   let halo_colour = null;
1327   if (p.cseq_updatesvg != null) {
1328     halo_colour = 'purple';
1329   } else if (p.last_seen_moved != null) {
1330     halo_colour = 'yellow';
1331   } else if (p.held != null && p.pinned) {
1332     halo_colour = '#8cf';
1333   }
1334   if (halo_colour != null) {
1335     let nelem = ancillary_node(piece, halo_colour);
1336     if (p.held != null) {
1337       // value 2ps is also in src/pieces.rs SELECT_STROKE_WIDTH
1338       nelem.setAttributeNS(null,'stroke-width','2px');
1339     }
1340     p.pelem.prepend(nelem);
1341   }
1342   if (p.held != null) {
1343     let da = null;
1344     if (p.held != us) {
1345       da = players[p.held!]!.dasharray;
1346     } else {
1347       let [px, py] = piece_xy(p);
1348       let inoccult = occregions.contains_pos(px, py);
1349       p.held_us_inoccult = inoccult;
1350       if (inoccult) {
1351         da = "0.9 0.6"; // dotted dasharray
1352       }
1353     }
1354     let nelem = ancillary_node(piece, held_surround_colour);
1355     if (da !== null) {
1356       nelem.setAttributeNS(null,'stroke-dasharray',da);
1357     }
1358     p.pelem.appendChild(nelem);
1359   }
1360 }
1361
1362 function drag_mousemove(e: MouseEvent) {
1363   var ctm = space.getScreenCTM()!;
1364   var ddx = (e.clientX - dcx!)/(ctm.a * firefox_bug_zoom_factor_compensation);
1365   var ddy = (e.clientY - dcy!)/(ctm.d * firefox_bug_zoom_factor_compensation);
1366   var ddr2 = ddx*ddx + ddy*ddy;
1367   if (!(dragging & DRAGGING.YES)) {
1368     if (ddr2 > DRAGTHRESH) {
1369       for (let dp of drag_pieces) {
1370         let tpiece = dp.piece;
1371         let tp = pieces[tpiece]!;
1372         if (tp.moveable == "Yes") {
1373           continue;
1374         } else if (tp.moveable == "IfWresting") {
1375           if (wresting) continue;
1376           add_log_message('That piece can only be moved when Wresting.');
1377         } else {
1378           add_log_message('That piece cannot be moved at the moment.');
1379         }
1380         return ddr2;
1381       }
1382       dragging |= DRAGGING.YES;
1383     }
1384   }
1385   //console.log('mousemove', ddx, ddy, dragging);
1386   if (dragging & DRAGGING.YES) {
1387     console.log('DRAG PIECES',drag_pieces);
1388     for (let dp of drag_pieces) {
1389       console.log('DRAG PIECES PIECE',dp);
1390       let tpiece = dp.piece;
1391       let tp = pieces[tpiece]!;
1392       var x = Math.round(dp.dox + ddx);
1393       var y = Math.round(dp.doy + ddy);
1394       let need_redisplay_ancillaries = (
1395         tp.held == us &&
1396         occregions.contains_pos(x,y) != tp.held_us_inoccult
1397       );
1398       piece_set_pos_core(tp, x, y);
1399       tp.queued_moves++;
1400       api_piece_x(api_delay, false, 'm', tpiece,tp, [x, y] );
1401       if (need_redisplay_ancillaries) redisplay_ancillaries(tpiece, tp);
1402     }
1403     if (!(dragging & DRAGGING.RAISED)) {
1404       sort_drag_pieces();
1405       for (let dp of drag_pieces) {
1406         let piece = dp.piece;
1407         let p = pieces[piece]!;
1408         if (p.held_us_raising == "Lowered") continue;
1409         let dragraise = +p.pelem.dataset.dragraise!;
1410         if (dragraise > 0 && ddr2 >= dragraise*dragraise) {
1411           dragging |= DRAGGING.RAISED;
1412           console.log('CHECK RAISE ', dragraise, dragraise*dragraise, ddr2);
1413           piece_raise(piece,p,"Raised");
1414         }
1415       }
1416     }
1417   }
1418   return ddr2;
1419 }
1420 function sort_drag_pieces() {
1421   function sort_with(a: DragInfo, b: DragInfo): number {
1422     return pieceid_z_cmp(a.piece,
1423                          b.piece);
1424   }
1425   drag_pieces.sort(sort_with);
1426 }
1427
1428 function drag_mouseup(e: MouseEvent) {
1429   console.log('mouseup', dragging);
1430   let ddr2 : number = drag_mousemove(e);
1431   drag_end();
1432 }
1433
1434 function drag_end() {
1435   if (dragging == DRAGGING.MAYBE_UNGRAB ||
1436       (dragging & ~DRAGGING.RAISED) == (DRAGGING.MAYBE_GRAB | DRAGGING.YES)) {
1437     sort_drag_pieces();
1438     for (let dp of drag_pieces) {
1439       let piece = dp.piece;
1440       let p = pieces[piece]!;
1441       do_ungrab_1(piece,p);
1442     }
1443   }
1444   drag_cancel();
1445 }
1446
1447 function drag_cancel() {
1448   window.removeEventListener('mousemove', drag_mousemove, true);
1449   window.removeEventListener('mouseup',   drag_mouseup,   true);
1450   dragging = DRAGGING.NO;
1451   drag_pieces = [];
1452 }
1453
1454 function rectsel_nontrivial_pos2(e: MouseEvent): Pos | null {
1455   let pos2 = mouseevent_pos(e);
1456   let d2 = 0;
1457   for (let i of [0,1]) {
1458     let d = pos2[i] - rectsel_start![i];
1459     d2 += d*d;
1460   }
1461   return d2 > RECTSELTHRESH*RECTSELTHRESH ? pos2 : null;
1462 }
1463
1464 function rectsel_mousemove(e: MouseEvent) {
1465   let pos2 = rectsel_nontrivial_pos2(e);
1466   let path;
1467   if (pos2 == null) {
1468     path = "";
1469   } else {
1470     let pos1 = rectsel_start!;
1471     path = `M ${ pos1 [0]} ${ pos1 [1] }
1472               ${ pos2 [0]} ${ pos1 [1] }
1473             M ${ pos1 [0]} ${ pos2 [1] }
1474               ${ pos2 [0]} ${ pos2 [1] }
1475             M ${ pos1 [0]} ${ pos1 [1] }
1476               ${ pos1 [0]} ${ pos2 [1] }
1477             M ${ pos2 [0]} ${ pos1 [1] }
1478               ${ pos2 [0]} ${ pos2 [1] }`;
1479   }
1480   rectsel_path.firstElementChild!.setAttributeNS(null,'d',path);
1481 }
1482
1483 function rectsel_mouseup(e: MouseEvent) {
1484   console.log('rectsel mouseup');
1485   window.removeEventListener('mousemove', rectsel_mousemove, true);
1486   window.removeEventListener('mouseup',   rectsel_mouseup,   true);
1487   rectsel_path.firstElementChild!.setAttributeNS(null,'d','');
1488   let pos2 = rectsel_nontrivial_pos2(e);
1489
1490   if (pos2 == null) {
1491     // clicked not on a piece, and didn't drag
1492     special_count = null;
1493     mousecursor_etc_reupdate();
1494     // we'll bail in a moment, after possibly unselecting things
1495   }
1496
1497   let note_already = Object.create(null);
1498   let c = null;
1499
1500   if (pos2 != null) {
1501     if (special_count != null && special_count == 0) {
1502       add_log_message(`Cannot drag-select lowest.`);
1503       return;
1504     }
1505     let tl = [0,0];
1506     let br = [0,0];
1507     for (let i of [0,1]) {
1508       tl[i] = Math.min(rectsel_start![i], pos2[i]);
1509       br[i] = Math.max(rectsel_start![i], pos2[i]);
1510     }
1511     c = mouse_find_predicate(
1512       special_count, rectsel_shifted!, note_already,
1513       function(p: PieceInfo) {
1514         let pp = piece_xy(p);
1515         for (let i of [0,1]) {
1516           if (pp[i] < tl[i] || pp[i] > br[i]) return false;
1517         }
1518         return true;
1519       }
1520     );
1521   }
1522
1523   if (!c) {
1524     // clicked not on a piece, didn't end up selecting anything
1525     // either because drag region had nothing in it, or special
1526     // failed, or some such.
1527     if (!rectsel_shifted) {
1528       let mr;
1529       while (mr = movements.pop()) {
1530         mr.p.last_seen_moved = null;
1531         redisplay_ancillaries(mr.piece, mr.p);
1532       }
1533       ungrab_all();
1534     }
1535     return;
1536   }
1537
1538   // did the special
1539   special_count = null;
1540   mousecursor_etc_reupdate();
1541
1542   if (rectsel_shifted && c.held == us) {
1543     ungrab_clicked(c.clicked);
1544     return;
1545   } else {
1546     if (!rectsel_shifted) {
1547       ungrab_all_except(note_already);
1548     }
1549     grab_clicked(c.clicked, false, undefined);
1550   }
1551 }
1552
1553 // ----- general -----
1554
1555 type PlayersUpdate = { new_info_pane: string };
1556
1557 messages.SetPlayer = <MessageHandler>function
1558 (j: { player: string, data: PlayerInfo } & PlayersUpdate) {
1559   players[j.player] = j.data;
1560   player_info_pane_set(j);
1561 }
1562
1563 messages.RemovePlayer = <MessageHandler>function
1564 (j: { player: string } & PlayersUpdate ) {
1565   delete players[j.player];
1566   player_info_pane_set(j);
1567 }
1568
1569 function player_info_pane_set(j: PlayersUpdate) {
1570   document.getElementById('player_list')!
1571     .innerHTML = j.new_info_pane;
1572 }
1573
1574 messages.UpdateBundles = <MessageHandler>function
1575 (j: { new_info_pane: string }) {
1576   document.getElementById('bundle_list')!
1577     .innerHTML = j.new_info_pane;
1578 }
1579
1580 messages.SetTableSize = <MessageHandler>function
1581 ([x, y]: [number, number]) {
1582   function set_attrs(elem: Element, l: [string,string][]) {
1583     for (let a of l) {
1584       elem.setAttributeNS(null,a[0],a[1]);
1585     }
1586   }
1587   let rect = document.getElementById('table_rect')!;
1588   set_attrs(space, wasm_bindgen.space_table_attrs(x, y));
1589   set_attrs(rect,  wasm_bindgen.space_table_attrs(x, y));
1590 }
1591
1592 messages.SetTableColour = <MessageHandler>function
1593 (c: string) {
1594   let rect = document.getElementById('table_rect')!;
1595   rect.setAttributeNS(null, 'fill', c);
1596 }
1597
1598 messages.SetLinks = <MessageHandler>function
1599 (msg: string) {
1600   if (msg.length != 0 && layout == 'Portrait') {
1601     msg += " |";
1602   }
1603   links_elem.innerHTML = msg
1604 }
1605
1606 // ---------- movehist ----------
1607
1608 type MoveHistEnt = {
1609   held: PlayerId,
1610   posx: [MoveHistPosx, MoveHistPosx],
1611   diff: { 'Moved': { d: number } },
1612 }
1613 type MoveHistPosx = {
1614   pos: Pos,
1615   angle: CompassAngle,
1616   facehint: FaceId | null,
1617 }
1618
1619 messages.MoveHistEnt = <MessageHandler>movehist_record;
1620 messages.MoveHistClear = <MessageHandler>function() {
1621   movehist_revisible_custmax(0);
1622 }
1623
1624 function movehist_record(ent: MoveHistEnt) {
1625   let old_pos = ent.posx[0].pos;
1626   let new_pos = ent.posx[1].pos;
1627
1628   movehist_gen++;
1629   movehist_gen %= (movehist_len_max * 2);
1630   let meid = 'motionhint-marker-' + movehist_gen;
1631
1632   let moved = ent.diff['Moved'];
1633   if (moved) {
1634     let d = moved.d;
1635     let ends = [];
1636     for (let end of [0,1]) {
1637       let s = (!end ? MOVEHIST_ENDS : d - MOVEHIST_ENDS) / d;
1638       ends.push([ (1-s) * old_pos[0] + s * new_pos[0],
1639                   (1-s) * old_pos[1] + s * new_pos[1] ]);
1640     }
1641     let g = document.createElementNS(svg_ns,'g');
1642     let sz = 4;
1643     let pi = players[ent.held];
1644     let nick = pi ? pi.nick : '';
1645     // todo: would be nice to place text variously along arrow, rotated
1646     let svg = `
1647       <marker id="${meid}" viewBox="2 0 ${sz} ${sz}"
1648         refX="${sz}" refY="${sz/2}"
1649         markerWidth="${sz + 2}" markerHeight="${sz}"
1650         stroke="yellow" fill="none"
1651         orient="auto-start-reverse" stroke-linejoin="miter">
1652         <path d="M 0 0 L ${sz} ${sz/2} L 0 ${sz}" />
1653       </marker>
1654       <line x1="${ends[0][0].toString()}"
1655             y1="${ends[0][1].toString()}"
1656             x2="${ends[1][0].toString()}"
1657             y2="${ends[1][1].toString()}"
1658             stroke="yellow"
1659             stroke-width="1" pointer-events="none"
1660             marker-end="url(#${meid})" />
1661       <text x="${((ends[0][0] + ends[1][0]) / 2).toString()}"
1662             y="${((ends[0][1] + ends[1][1]) / 2).toString()}"
1663             font-size="5" pointer-events="none"
1664             stroke-width="0.1">${nick}</text>
1665     `;
1666     g.innerHTML = svg;
1667     space.insertBefore(g, movehist_end);
1668     movehist_revisible();
1669   }
1670 }
1671
1672 function movehist_revisible() {
1673   movehist_revisible_custmax(movehist_len_max);
1674 }
1675
1676 function movehist_revisible_custmax(len_max: number) {
1677   let n = movehist_lens[movehist_len_i];
1678   let i = 0;
1679   let node = movehist_end;
1680   while (i < len_max) {
1681     i++; // i now eg 1..10
1682     node = node.previousElementSibling! as SVGGraphicsElement;
1683     if (node == movehist_start)
1684       return;
1685     let prop = i > n ? 0 : (n-i+1)/n;
1686     let stroke = (prop * 1.0).toString();
1687     let marker = node.firstElementChild!;
1688     marker.setAttributeNS(null,'stroke-width',stroke);
1689     let line = marker.nextElementSibling!;
1690     line.setAttributeNS(null,'stroke-width',stroke);
1691     let text = line.nextElementSibling!;
1692     if (!prop) {
1693       text.setAttributeNS(null,'stroke','none');
1694       text.setAttributeNS(null,'fill','none');
1695     } else {
1696       text.setAttributeNS(null,'fill','yellow');
1697       text.setAttributeNS(null,'stroke','orange');
1698     }
1699   }
1700   for (;;) {
1701     let del = node.previousElementSibling!;
1702     if (del == movehist_start)
1703       return;
1704     del.remove();
1705   }
1706 }
1707
1708 // ----- logs -----
1709
1710 messages.Log = <MessageHandler>function
1711 (j: { when: string, logent: { html: string } }) {
1712   add_timestamped_log_message(j.when, j.logent.html);
1713 }
1714
1715 function add_log_message(msg_html: string) {
1716   add_timestamped_log_message('', msg_html);
1717 }
1718
1719 function add_timestamped_log_message(ts_html: string, msg_html: string) {
1720   var lastent = log_elem.lastElementChild;
1721   var in_scrollback =
1722     lastent == null ||
1723     // inspired by
1724     //   https://stackoverflow.com/questions/487073/how-to-check-if-element-is-visible-after-scrolling/21627295#21627295
1725     // rejected
1726       //   https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API
1727       (() => {
1728         let le_top = lastent.getBoundingClientRect()!.top;
1729         let le_bot = lastent.getBoundingClientRect()!.bottom;
1730         let ld_bot = logscroll_elem.getBoundingClientRect()!.bottom;
1731         console.log("ADD_LOG_MESSAGE bboxes: le t b, bb",
1732                     le_top, le_bot, ld_bot);
1733         return 0.5 * (le_bot + le_top) > ld_bot;
1734       })();
1735
1736   console.log('ADD LOG MESSAGE ',in_scrollback, layout, msg_html);
1737
1738   var ne : HTMLElement;
1739
1740   function add_thing(elemname: string, cl: string, html: string) {
1741     var ie = document.createElement(elemname);
1742     ie.innerHTML = html;
1743     ie.setAttribute("class", cl);
1744     ne.appendChild(ie);
1745   }
1746
1747   if (layout == 'Portrait') {
1748     ne = document.createElement('tr');
1749     add_thing('td', 'logmsg', msg_html);
1750     add_thing('td', 'logts',  ts_html);
1751   } else if (layout == 'Landscape') {
1752     ts_html = last_log_ts.update(ts_html);
1753     ne = document.createElement('div');
1754     add_thing('span', 'logts',  ts_html);
1755     ne.appendChild(document.createElement('br'));
1756     add_thing('span', 'logmsg', msg_html);
1757     ne.appendChild(document.createElement('br'));
1758   } else {
1759     throw 'bad layout ' + layout;
1760   }
1761   log_elem.appendChild(ne);
1762
1763   if (!in_scrollback) {
1764     logscroll_elem.scrollTop = logscroll_elem.scrollHeight;
1765   }
1766 }
1767
1768 // ----- zoom -----
1769
1770 function zoom_pct (): number | undefined {
1771   let str = zoom_val.value;
1772   let val = parseFloat(str);
1773   if (isNaN(val)) {
1774     return undefined;
1775   } else {
1776     return val;
1777   }
1778 }
1779
1780 function zoom_enable() {
1781   zoom_btn.disabled = (zoom_pct() === undefined);
1782 }
1783
1784 function zoom_activate() {
1785   let pct = zoom_pct();
1786   if (pct !== undefined) {
1787     let fact = pct * 0.01;
1788     let last_ctm_a = space.getScreenCTM()!.a;
1789     (document.getElementsByTagName('body')[0] as HTMLElement)
1790       .style.transform = 'scale('+fact+','+fact+')';
1791     if (fact != last_zoom_factor) {
1792       if (last_ctm_a == space.getScreenCTM()!.a) {
1793         console.log('FIREFOX GETSCREENCTM BUG');
1794         firefox_bug_zoom_factor_compensation = fact;
1795       } else {
1796         console.log('No firefox getscreenctm bug');
1797         firefox_bug_zoom_factor_compensation = 1.0;
1798       }
1799       last_zoom_factor = fact;
1800     }
1801   }
1802   zoom_btn.disabled = true;
1803 }
1804
1805 // ----- test counter, startup -----
1806
1807 type TransmitUpdateEntry_Piece = {
1808   piece: PieceId,
1809   op: Object,
1810 };
1811 type ErrorTransmitUpdateEntry_Piece = TransmitUpdateEntry_Piece & {
1812   cseq: ClientSeq | null,
1813 };
1814
1815 function handle_piece_update(j: TransmitUpdateEntry_Piece) {
1816   console.log('PIECE UPDATE ',j)
1817   var piece = j.piece;
1818   var m = j.op as { [k: string]: Object };
1819   var k = Object.keys(m)[0];
1820   let p = pieces[piece];
1821   pieceops[k](piece,p, m[k]);
1822 };
1823
1824 messages.Piece = <MessageHandler>handle_piece_update;
1825
1826 type PreparedPieceState = {
1827   pos: Pos,
1828   svg: string,
1829   desc: string,
1830   held: PlayerId | null,
1831   z: ZCoord,
1832   zg: Generation,
1833   pinned: boolean,
1834   angle: number,
1835   uos: UoDescription[],
1836   moveable: PieceMoveable,
1837   rotateable: boolean,
1838   multigrab: boolean,
1839   occregion: string | null,
1840   bbox: Rect,
1841 }
1842
1843 pieceops.ModifyQuiet = <PieceHandler>function
1844 (piece: PieceId, p: PieceInfo, info: PreparedPieceState) {
1845   console.log('PIECE UPDATE MODIFY QUIET ',piece,info)
1846   piece_modify(piece, p, info);
1847 }
1848
1849 pieceops.Modify = <PieceHandler>function
1850 (piece: PieceId, p: PieceInfo, info: PreparedPieceState) {
1851   console.log('PIECE UPDATE MODIFY LOuD ',piece,info)
1852   piece_note_moved(piece,p);
1853   piece_modify(piece, p, info);
1854 }
1855
1856 pieceops.InsertQuiet = <PieceHandler>(insert_piece as any);
1857 pieceops.Insert = <PieceHandler>function
1858 (piece: PieceId, xp: any, info: PreparedPieceState) {
1859   let p = insert_piece(piece,xp,info);
1860   piece_note_moved(piece,p);
1861 }
1862
1863 function insert_piece(piece: PieceId, xp: any,
1864                       info: PreparedPieceState): PieceInfo
1865 {
1866   console.log('PIECE UPDATE INSERT ',piece,info)
1867   let delem = document.createElementNS(svg_ns,'defs');
1868   delem.setAttributeNS(null,'id','defs'+piece);
1869   delem.innerHTML = info.svg;
1870   defs_marker.insertAdjacentElement('afterend', delem);
1871   let pelem = piece_element('piece',piece);
1872   let uelem = document.createElementNS(svg_ns,'use');
1873   uelem.setAttributeNS(null,'id',"use"+piece);
1874   uelem.setAttributeNS(null,'href',"#piece"+piece);
1875   uelem.setAttributeNS(null,'data-piece',piece);
1876   let p = {
1877     uelem: uelem,
1878     pelem: pelem,
1879     delem: delem,
1880   } as any as PieceInfo; // fudge this, piece_modify_core will fix it
1881   pieces[piece] = p;
1882   p.uos = info.uos;
1883   p.queued_moves = 0;
1884   piece_resolve_special(piece, p);
1885   piece_modify_core(piece, p, info);
1886   return p;
1887 }
1888
1889 pieceops.Delete = <PieceHandler>function
1890 (piece: PieceId, p: PieceInfo, info: {}) {
1891   console.log('PIECE UPDATE DELETE ', piece)
1892   piece_stop_special(piece, p);
1893   p.uelem.remove();
1894   p.delem.remove();
1895   delete pieces[piece];
1896   if (p.held == us) {
1897     recompute_keybindings();
1898   }
1899 }
1900
1901 piece_error_handlers.PosOffTable = <PieceErrorHandler>function()
1902 { return true ; }
1903 piece_error_handlers.Conflict = <PieceErrorHandler>function()
1904 { return true ; }
1905
1906 function piece_modify_image(piece: PieceId, p: PieceInfo,
1907                             info: PreparedPieceImage) {
1908   p.delem.innerHTML = info.svg;
1909   p.pelem= piece_element('piece',piece)!;
1910   p.uos = info.uos;
1911   p.bbox = info.bbox;
1912   p.desc = info.desc;
1913   piece_resolve_special(piece, p);
1914 }
1915
1916 function piece_resolve_special(piece: PieceId, p: PieceInfo) {
1917   let new_special =
1918       p.pelem.dataset.special ?
1919       JSON.parse(p.pelem.dataset.special) : null;
1920   let new_special_kind = new_special ? new_special.kind : '';
1921   let old_special_kind = p  .special ? p  .special.kind : '';
1922
1923   if (new_special_kind != old_special_kind) {
1924     piece_stop_special(piece, p);
1925   }
1926   if (new_special) {
1927     console.log('SPECIAL START', new_special);
1928     new_special.stop = function() { };
1929     p.special = new_special;
1930     special_renderings[new_special_kind](piece, p, new_special);
1931   }
1932 }
1933
1934 function piece_stop_special(piece: PieceId, p: PieceInfo) {
1935   let s = p.special;
1936   p.special = null;
1937   if (s) {
1938     console.log('SPECIAL STOP', s);
1939     s.stop(piece, p, s);
1940   }
1941 }
1942
1943 function piece_modify(piece: PieceId, p: PieceInfo, info: PreparedPieceState) {
1944   piece_modify_image(piece, p, info);
1945   piece_modify_core(piece, p, info);
1946 }
1947
1948 function piece_set_pos_core(p: PieceInfo, x: number, y: number) {
1949   p.uelem.setAttributeNS(null, "x", x+"");
1950   p.uelem.setAttributeNS(null, "y", y+"");
1951 }
1952
1953 function piece_modify_core(piece: PieceId, p: PieceInfo,
1954                            info: PreparedPieceState) {
1955   p.uelem.setAttributeNS(null, "x", info.pos[0]+"");
1956   p.uelem.setAttributeNS(null, "y", info.pos[1]+"");
1957   p.held = info.held;
1958   p.held_us_raising = "NotYet";
1959   p.pinned = info.pinned;
1960   p.moveable = info.moveable;
1961   p.rotateable = info.rotateable;
1962   p.multigrab = info.multigrab;
1963   p.angle = info.angle;
1964   p.bbox = info.bbox;
1965   piece_set_zlevel_from(piece,p,info);
1966   let occregions_changed = occregion_update(piece, p, info);
1967   piece_checkconflict_nrda(piece,p);
1968   redisplay_ancillaries(piece,p);
1969   if (occregions_changed) redisplay_held_ancillaries();
1970   recompute_keybindings();
1971   console.log('MODIFY DONE');
1972 }
1973 function occregion_update(piece: PieceId, p: PieceInfo,
1974                           info: PreparedPieceState) {
1975   let occregions_changed = (
1976     info.occregion != null
1977       ? occregions.insert(piece, info.occregion)
1978       : occregions.remove(piece)
1979   );
1980   return occregions_changed;
1981 }
1982 function redisplay_held_ancillaries() {
1983   for (let piece of Object.keys(pieces)) {
1984     let p = pieces[piece];
1985     if (p.held != us) continue;
1986     redisplay_ancillaries(piece,p);
1987   }
1988 }
1989
1990 type PreparedPieceImage = {
1991   svg: string,
1992   desc: string,
1993   uos: UoDescription[],
1994   bbox: Rect,
1995 }
1996
1997 type TransmitUpdateEntry_Image = {
1998   piece: PieceId,
1999   im: PreparedPieceImage,
2000 };
2001
2002 messages.Image = <MessageHandler>function(j: TransmitUpdateEntry_Image) {
2003   console.log('IMAGE UPDATE ',j)
2004   var piece = j.piece;
2005   let p = pieces[piece]!;
2006   piece_modify_image(piece, p, j.im);
2007   redisplay_ancillaries(piece,p);
2008   recompute_keybindings();
2009   console.log('IMAGE DONE');
2010 }
2011
2012 function piece_set_zlevel(piece: PieceId, p: PieceInfo,
2013                           modify : (oldtop_piece: PieceId) => void) {
2014   // Calls modify, which should set .z and/or .gz, and/or
2015   // make any necessary API call.
2016   //
2017   // Then moves uelem to the right place in the DOM.  This is done
2018   // by assuming that uelem ought to go at the end, so this is
2019   // O(new depth), which is right (since the UI for inserting
2020   // an object is itself O(new depth) UI operations to prepare.
2021
2022   let oldtop_elem = (defs_marker.previousElementSibling! as
2023                      unknown as SVGGraphicsElement);
2024   let oldtop_piece = oldtop_elem.dataset.piece!;
2025   modify(oldtop_piece);
2026
2027   let ins_before = defs_marker
2028   let earlier_elem;
2029   for (; ; ins_before = earlier_elem) {
2030     earlier_elem = (ins_before.previousElementSibling! as
2031                    unknown as SVGGraphicsElement);
2032     if (earlier_elem == pieces_marker) break;
2033     if (earlier_elem == p.uelem) continue;
2034     let earlier_p = pieces[earlier_elem.dataset.piece!]!;
2035     if (!piece_z_before(p, earlier_p)) break;
2036   }
2037   if (ins_before != p.uelem)
2038     space.insertBefore(p.uelem, ins_before);
2039
2040   check_z_order();
2041 }
2042
2043 function check_z_order() {
2044   if (!otter_debug) return;
2045   let s = pieces_marker;
2046   let last_z = "";
2047   for (;;) {
2048     s = s.nextElementSibling as SVGGraphicsElement;
2049     if (s == defs_marker) break;
2050     let piece = s.dataset.piece!;
2051     let z = pieces[piece].z;
2052     if (z < last_z) {
2053       json_report_error(['Z ORDER INCONSISTENCY!', piece, z, last_z]);
2054     }
2055     last_z = z;
2056   }
2057 }
2058
2059 function piece_note_moved(piece: PieceId, p: PieceInfo) {
2060   let now = performance.now();
2061
2062   let need_redisplay = p.last_seen_moved == null;
2063   p.last_seen_moved = now;
2064   if (need_redisplay) redisplay_ancillaries(piece,p);
2065
2066   let cutoff = now-1000.;
2067   while (movements.length > 0 && movements[0].this_motion < cutoff) {
2068     let mr = movements.shift()!;
2069     if (mr.p.last_seen_moved != null &&
2070         mr.p.last_seen_moved < cutoff) {
2071       mr.p.last_seen_moved = null;
2072       redisplay_ancillaries(mr.piece,mr.p);
2073     }
2074   }
2075
2076   movements.push({ piece: piece, p: p, this_motion: now });
2077 }
2078
2079 function piece_z_cmp(a: PieceInfo, b: PieceInfo) {
2080   if (a.z  < b.z ) return -1;
2081   if (a.z  > b.z ) return +1;
2082   if (a.zg < b.zg) return -1;
2083   if (a.zg > b.zg) return +1;
2084   return 0;
2085 }
2086
2087 function piece_z_before(a: PieceInfo, b: PieceInfo) {
2088   return piece_z_cmp(a,
2089                      b) < 0;
2090 }
2091
2092 function pieceid_z_cmp(a: PieceId, b: PieceId) {
2093   return piece_z_cmp(pieces[a]!,
2094                      pieces[b]!);
2095 }
2096
2097 pieceops.Move = <PieceHandler>function
2098 (piece,p, info: Pos ) {
2099   piece_checkconflict_nrda(piece,p);
2100   piece_note_moved(piece, p);
2101   piece_set_pos_core(p, info[0], info[1]);
2102 }
2103
2104 pieceops.MoveQuiet = <PieceHandler>function
2105 (piece,p, info: Pos ) {
2106   piece_checkconflict_nrda(piece,p);
2107   piece_set_pos_core(p, info[0], info[1]);
2108 }
2109
2110 pieceops.SetZLevel = <PieceHandler>function
2111 (piece,p, info: { z: ZCoord, zg: Generation }) {
2112   piece_note_moved(piece,p);
2113   piece_set_zlevel_from(piece,p,info);
2114 }
2115
2116 pieceops.SetZLevelQuiet = <PieceHandler>function
2117 (piece,p, info: { z: ZCoord, zg: Generation }) {
2118   piece_set_zlevel_from(piece,p,info);
2119 }
2120
2121 function piece_set_zlevel_from(piece: PieceId, p: PieceInfo,
2122                                info: { z: ZCoord, zg: Generation }) {
2123   piece_set_zlevel(piece,p, (oldtop_piece)=>{
2124     p.z  = info.z;
2125     p.zg = info.zg;
2126   });
2127 }
2128
2129 messages.Recorded = <MessageHandler>function
2130 (j: { piece: PieceId, cseq: ClientSeq,
2131       zg: Generation|null, svg: string | null, desc: string | null } ) {
2132   let piece = j.piece;
2133   let p = pieces[piece]!;
2134   piece_recorded_cseq(p, j);
2135   if (p.cseq_updatesvg != null && j.cseq >= p.cseq_updatesvg) {
2136     p.cseq_updatesvg = null;
2137     redisplay_ancillaries(piece,p);
2138   }
2139   if (j.svg != null) {
2140     p.delem.innerHTML = j.svg;
2141     p.pelem= piece_element('piece',piece)!;
2142     piece_resolve_special(piece, p);
2143     redisplay_ancillaries(piece,p);
2144   }
2145   if (j.zg != null) {
2146     var zg_new = j.zg; // type narrowing doesn't propagate :-/
2147     piece_set_zlevel(piece,p, (oldtop_piece: PieceId)=>{
2148       p.zg = zg_new;
2149     });
2150   }
2151   if (j.desc != null) {
2152     p.desc = j.desc;
2153   }
2154 }
2155
2156 function piece_recorded_cseq(p: PieceInfo, j: { cseq: ClientSeq }) {
2157   if (p.cseq_main  != null && j.cseq >= p.cseq_main ) { p.cseq_main  = null; }
2158   if (p.cseq_loose != null && j.cseq >= p.cseq_loose) { p.cseq_loose = null; }
2159 }
2160
2161 messages.RecordedUnpredictable = <MessageHandler>function
2162 (j: { piece: PieceId, cseq: ClientSeq, ns: PreparedPieceState } ) {
2163   let piece = j.piece;
2164   let p = pieces[piece]!;
2165   piece_recorded_cseq(p, j);
2166   piece_modify(piece, p, j.ns);
2167 }
2168
2169 messages.Error = <MessageHandler>function
2170 (m: any) {
2171   console.log('ERROR UPDATE ', m);
2172   var k = Object.keys(m)[0];
2173   update_error_handlers[k](m[k]);
2174 }
2175
2176 type PieceOpError = {
2177   error: string,
2178   error_msg: string,
2179   state: ErrorTransmitUpdateEntry_Piece,
2180 };
2181
2182 update_error_handlers.PieceOpError = <MessageHandler>function
2183 (m: PieceOpError) {
2184   let piece = m.state.piece;
2185   let cseq = m.state.cseq;
2186   let p = pieces[piece];
2187   console.log('ERROR UPDATE PIECE ', piece, cseq, m, m.error_msg, p);
2188   if (p == null) return; // who can say!
2189   if (m.error != 'Conflict') {
2190     // Our gen was high enough we we sent this, that it ought to have
2191     // worked.  Report it as a problem, then.
2192     add_log_message('Problem manipulating piece: ' + m.error_msg);
2193     // Mark aus as having no outstanding requests, and cancel any drag.
2194     piece_checkconflict_nrda(piece, p, true);
2195   }
2196   handle_piece_update(m.state);
2197 }
2198
2199 function piece_checkconflict_nrda(piece: PieceId, p: PieceInfo,
2200                                   already_logged: boolean = false) {
2201   // Our state machine for cseq:
2202   //
2203   // When we send an update (api_piece_x) we always set cseq.  If the
2204   // update is loose we also set cseq_beforeloose.  Whenever we
2205   // clear cseq we clear cseq_beforeloose too.
2206   //
2207   // The result is that if cseq_beforeloose is non-null precisely if
2208   // the last op we sent was loose.
2209   //
2210   // We track separately the last loose, and the last non-loose,
2211   // outstanding API request.  (We discard our idea of the last
2212   // loose request if we follow it with a non-loose one.)
2213   //
2214   // So
2215   //     cseq_main > cseq_loose         one loose request then some non-loose
2216   //     cseq_main, no cseq_loose       just non-loose requests
2217   //     no cseq_main, but cseq_loose   just one loose request
2218   //     neither                        no outstanding requests
2219   //
2220   // If our only outstanding update is loose, we ignore a detected
2221   // conflict.  We expect the server to send us a proper
2222   // (non-Conflict) error later.
2223   if (p.cseq_main != null || p.cseq_loose != null) {
2224     if (drag_pieces.some(function(dp) { return dp.piece == piece; })) {
2225       console.log('drag end due to conflict');
2226       drag_end();
2227     }
2228   }
2229   if (p.cseq_main != null) {
2230     if (!already_logged)
2231       add_log_message('Conflict! - simultaneous update');
2232   }
2233   p.cseq_main = null;
2234   p.cseq_loose = null;
2235 }
2236
2237 function test_swap_stack() {
2238   let old_bot = pieces_marker.nextElementSibling!;
2239   let container = old_bot.parentElement!;
2240   container.insertBefore(old_bot, defs_marker);
2241   window.setTimeout(test_swap_stack, 1000);
2242 }
2243
2244 function startup() {
2245   console.log('STARTUP');
2246   console.log(wasm_bindgen.setup("OK"));
2247
2248   var body = document.getElementById("main-body")!;
2249   zoom_btn = document.getElementById("zoom-btn") as any;
2250   zoom_val = document.getElementById("zoom-val") as any;
2251   links_elem = document.getElementById("links") as any;
2252   ctoken = body.dataset.ctoken!;
2253   us = body.dataset.us!;
2254   gen = +body.dataset.gen!;
2255   let sse_url_prefix = body.dataset.sseUrlPrefix!;
2256   status_node = document.getElementById('status')!;
2257   status_node.innerHTML = 'js-done';
2258   log_elem = document.getElementById("log")!;
2259   logscroll_elem = document.getElementById("logscroll") || log_elem;
2260   let dataload = JSON.parse(body.dataset.load!);
2261   held_surround_colour = dataload.held_surround_colour!;
2262   players = dataload.players!;
2263   delete body.dataset.load;
2264   uos_node = document.getElementById("uos")!;
2265   occregions = wasm_bindgen.empty_region_list();
2266
2267   space = svg_element('space')!;
2268   pieces_marker = svg_element("pieces_marker")!;
2269   defs_marker = svg_element("defs_marker")!;
2270   movehist_start = svg_element('movehist_marker')!;
2271   movehist_end = svg_element('movehist_end')!;
2272   rectsel_path = svg_element('rectsel_path')!;
2273   svg_ns = space.getAttribute('xmlns')!;
2274
2275   for (let uelem = pieces_marker.nextElementSibling! as SVGGraphicsElement;
2276        uelem != defs_marker;
2277        uelem = uelem.nextElementSibling! as SVGGraphicsElement) {
2278     let piece = uelem.dataset.piece!;
2279     let p = JSON.parse(uelem.dataset.info!);
2280     p.uelem = uelem;
2281     p.delem = piece_element('defs',piece);
2282     p.pelem = piece_element('piece',piece);
2283     p.queued_moves = 0;
2284     occregion_update(piece, p, p); delete p.occregion;
2285     delete uelem.dataset.info;
2286     pieces[piece] = p;
2287     piece_resolve_special(piece,p);
2288     redisplay_ancillaries(piece,p);
2289   }
2290
2291   if (test_update_hook == null) test_update_hook = function() { };
2292   test_update_hook();
2293
2294   last_log_ts = wasm_bindgen.timestamp_abbreviator(dataload.last_log_ts);
2295
2296   for (let ent of dataload.movehist.hist) {
2297     movehist_record(ent);
2298   }
2299
2300   var es = new EventSource(
2301     sse_url_prefix + "/_/updates?ctoken="+ctoken+'&gen='+gen
2302   );
2303   es.onmessage = function(event) {
2304     console.log('GOTEVE', event.data);
2305     var k;
2306     var m;
2307     try {
2308       var [tgen, ms] = JSON.parse(event.data);
2309       for (m of ms) {
2310         k = Object.keys(m)[0];
2311         messages[k](m[k]);
2312       }
2313       gen = tgen;
2314       test_update_hook();
2315     } catch (exc) {
2316       var s = exc.toString();
2317       string_report_error('exception handling update '
2318                           + k + ': ' + JSON.stringify(m) + ': ' + s);
2319     }
2320   }
2321   es.addEventListener('commsworking', function(event) {
2322     console.log('GOTDATA', (event as any).data);
2323     status_node.innerHTML = (event as any).data;
2324   });
2325   es.addEventListener('player-gone', function(event) {
2326     console.log('PLAYER-GONE', event);
2327     status_node.innerHTML = (event as any).data;
2328     add_log_message('<strong>You are no longer in the game</strong>');
2329     space.removeEventListener('mousedown', some_mousedown);
2330     document.removeEventListener('keydown', some_keydown);
2331     es.close();
2332   });
2333   es.addEventListener('updates-expired', function(event) {
2334     console.log('UPDATES-EXPIRED', event);
2335     string_report_error('connection to server interrupted too long');
2336   });
2337   es.onerror = function(e) {
2338     let info = {
2339       updates_error : e,
2340       updates_event_source : es,
2341       updates_event_source_ready : es.readyState,
2342       update_oe : (e as any).className,
2343     };
2344     if (es.readyState == 2) {
2345       json_report_error({
2346         reason: "TOTAL SSE FAILURE",
2347         info: info,
2348       })
2349     } else {
2350       console.log('SSE error event', info);
2351     }
2352   }
2353   recompute_keybindings();
2354   space.addEventListener('mousedown', some_mousedown);
2355   space.addEventListener('dragstart', function (e) {
2356     e.preventDefault();
2357     e.stopPropagation();
2358   }, true);
2359   document.addEventListener('keydown',   some_keydown);
2360   check_z_order();
2361 }
2362
2363 type DieSpecialRendering = SpecialRendering & {
2364   cd_path: SVGPathElement,
2365   loaded_ts: DOMHighResTimeStamp,
2366   loaded_remprop: number,
2367   total_ms: number,
2368   radius: number,
2369   anim_id: number | null,
2370 };
2371 special_renderings['Die'] = function(piece: PieceId, p: PieceInfo,
2372                                      s: DieSpecialRendering) {
2373   let cd_path = document.getElementById('def.'+piece+'.die.cd');
2374   if (!cd_path) return;
2375
2376   s.cd_path = cd_path as any as SVGPathElement;
2377   s.loaded_ts = performance.now();
2378   s.loaded_remprop = parseFloat(cd_path.dataset.remprop!)!;
2379   s.total_ms       = parseFloat(cd_path.dataset.total_ms!)!;
2380   s.radius         = parseFloat(cd_path.dataset.radius!)!;
2381
2382   s.stop = die_rendering_stop as any;
2383   die_request_animation(piece, p, s);
2384 } as any;
2385 function die_request_animation(piece: PieceId, p: PieceInfo,
2386                                s: DieSpecialRendering) {
2387   s.anim_id = window.requestAnimationFrame(
2388     function(ts) { die_render_frame(piece, p, s, ts) }
2389   );
2390 }
2391 function die_render_frame(piece: PieceId, p: PieceInfo,
2392                           s: DieSpecialRendering, ts: DOMHighResTimeStamp) {
2393   s.anim_id = null;
2394   let remprop = s.loaded_remprop - (ts - s.loaded_ts) / s.total_ms;
2395   //console.log('DIE RENDER', piece, s, remprop);
2396   if (remprop <= 0) {
2397     console.log('DIE COMPLETE', piece, s, remprop);
2398     let to_remove: Element = s.cd_path;
2399     for (;;) {
2400       let previous = to_remove.previousElementSibling!;
2401       // see dice/overlya-template-extractor
2402       if (to_remove.tagName == 'text') break;
2403       to_remove.remove();
2404       to_remove = previous;
2405     }
2406   } else {
2407     let path_d = wasm_bindgen.die_cooldown_path(s.radius, remprop);
2408     s.cd_path.setAttributeNS(null, "d", path_d);
2409     die_request_animation(piece, p, s);
2410   }
2411 }
2412 function die_rendering_stop(piece: PieceId, p: PieceInfo,
2413                             s: DieSpecialRendering) {
2414   let anim_id = s.anim_id;
2415   if (anim_id == null) return;
2416   s.anim_id = null;
2417   window.cancelAnimationFrame(anim_id);
2418 }
2419
2420 declare var wasm_input : any;
2421 var wasm_promise : Promise<any>;;
2422
2423 function doload(){
2424   console.log('DOLOAD');
2425   globalinfo_elem = document.getElementById('global-info')!;
2426   layout = globalinfo_elem!.dataset!.layout! as any;
2427   var elem = document.getElementById('loading_token')!;
2428   var ptoken = elem.dataset.ptoken;
2429   xhr_post_then('/_/session/' + layout,
2430                 JSON.stringify({ ptoken : ptoken }),
2431                 loaded);
2432
2433   wasm_promise = wasm_input
2434     .then(wasm_bindgen);
2435 }
2436
2437 function loaded(xhr: XMLHttpRequest){
2438   console.log('LOADED');
2439   var body = document.getElementById('loading_body')!;
2440   wasm_promise.then((got_wasm) => {
2441     wasm = got_wasm;
2442     body.outerHTML = xhr.response;
2443     try {
2444       startup();
2445     } catch (exc) {
2446       let s = exc.toString();
2447       string_report_error_raw('Exception on load, unrecoverable: ' + s);
2448     }
2449   });
2450 }
2451
2452 // todo scroll of log messages to bottom did not always work somehow
2453 //    think I have fixed this with approximation
2454
2455 //@@notest
2456 doload();