From 172f5a51332b24c1027ea0f22d7e71b516dcd7d5 Mon Sep 17 00:00:00 2001
From: Kitson Kelly <me@kitsonkelly.com>
Date: Fri, 9 Nov 2018 15:07:48 +1100
Subject: [PATCH] Cleanups for runtime lib declarations.

---
 js/io.ts        | 9 ++++-----
 js/libdeno.ts   | 1 +
 js/resources.ts | 9 +++++++--
 3 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/js/io.ts b/js/io.ts
index 74b30cd949..10908b7244 100644
--- a/js/io.ts
+++ b/js/io.ts
@@ -116,12 +116,11 @@ export async function copy(dst: Writer, src: Reader): Promise<number> {
   return n;
 }
 
-/**
- * Turns `r` into async iterator.
+/** Turns `r` into async iterator.
  *
- *    for await (const chunk of readerIterator(reader)) {
- *        console.log(chunk)
- *    }
+ *      for await (const chunk of readerIterator(reader)) {
+ *          console.log(chunk)
+ *      }
  */
 export function toAsyncIterator(r: Reader): AsyncIterableIterator<Uint8Array> {
   const b = new Uint8Array(1024);
diff --git a/js/libdeno.ts b/js/libdeno.ts
index 9745365b0f..c61027324c 100644
--- a/js/libdeno.ts
+++ b/js/libdeno.ts
@@ -45,4 +45,5 @@ interface Libdeno {
 }
 
 const window = globalEval("this");
+// @internal
 export const libdeno = window.libdeno as Libdeno;
diff --git a/js/resources.ts b/js/resources.ts
index a28270fca6..c40d52b4e5 100644
--- a/js/resources.ts
+++ b/js/resources.ts
@@ -4,7 +4,12 @@ import * as flatbuffers from "./flatbuffers";
 import { assert } from "./util";
 import * as dispatch from "./dispatch";
 
-export function resources(): { [key: number]: string } {
+export type ResourceMap = { [rid: number]: string };
+
+/** Returns a map of open _file like_ resource ids along with their string
+ * representation.
+ */
+export function resources(): ResourceMap {
   const builder = flatbuffers.createBuilder();
   msg.Resources.startResources(builder);
   const inner = msg.Resource.endResource(builder);
@@ -14,7 +19,7 @@ export function resources(): { [key: number]: string } {
   const res = new msg.ResourcesRes();
   assert(baseRes!.inner(res) !== null);
 
-  const resources: { [key: number]: string } = {};
+  const resources = {} as ResourceMap;
 
   for (let i = 0; i < res.resourcesLength(); i++) {
     const item = res.resources(i)!;