@hpcc-js/observablehq-compiler 1.1.1 → 1.1.2

package/src/index.ts

@@ -1,7 +1,7 @@
-export type { ohq } from "@hpcc-js/observable-shim";
-
-export * from "./compiler";
-export { ojs2notebook, omd2notebook, download } from "./util";
-export * from "./writer";
-
-import "../src/index.css";
+export type { ohq } from "@hpcc-js/observable-shim";
+
+export * from "./compiler";
+export { ojs2notebook, omd2notebook, download } from "./util";
+export * from "./writer";
+
+import "../src/index.css";

package/src/util.md

@@ -1,113 +1,113 @@
-# Utilities
-
-Various utilities and helpers.
-
----
-
-<a name="download" href="#download">#</a> **download**(_impUrl_) => Promise\<ohq.Module\> · [<>](https://github.com/hpcc-systems/Visualization/blob/trunk/packages/observablehq/compiler/src/util.ts "Source")
-
-* _impUrl_:  Full url to Obaservable HQ notebook as a string.
-* _returns_: Returns a Promise of a notebook (a JSON object).
-
-Downloads a notebook directly from [Observable HQ](https://observablehq.com/) as a JSON object.  The following example downloads the [@observablehq/plot](https://observablehq.com/@observablehq/plot) notebook as JSON:
-
-<ClientOnly>
-  <hpcc-vitepress style="width:100%;height:600px">
-    <hpcc-codemirror id="placeholder" mode="json" theme="dark" style="width:100%;height:100%">
-    </hpcc-codemirror>
-    <script type="module">
-      import "@hpcc-js/wc-editor";
-      import { download } from "@hpcc-js/observablehq-compiler";
-
-      const notebook = await download("https://observablehq.com/@observablehq/plot");
-      const placeholder = document.getElementById("placeholder");
-      placeholder.text = JSON.stringify(notebook, undefined, 4);
-    </script>
-  </hpcc-vitepress>
-</ClientOnly>
-
----
-
-<a name="ojs2notebook" href="#ojs2notebook">#</a> **ojs2notebook**(_ojs_) => ohq.Module · [<>](https://github.com/hpcc-systems/Visualization/blob/trunk/packages/observablehq/compiler/src/util.ts "Source")
-
-* _ojs_:  String containing Observable JavaScript.
-* _returns_: Returns the notebook as a JSON object.
-
-Transforms Observable JavaScript to a JSON notebook.
-
-<ClientOnly>
-  <hpcc-vitepress style="width:100%;height:600px">
-    <hpcc-codemirror id="placeholder" mode="json" theme="dark" style="width:100%;height:100%">
-    </hpcc-codemirror>
-    <script type="module">
-      import "@hpcc-js/wc-editor";
-      import { ojs2notebook } from "@hpcc-js/observablehq-compiler";
-
-      const notebook = ojs2notebook(`
-        md\`# Simple Notebook\`
-        a = 1
-        b = 2
-        c = a + b
-        d = {
-          yield 1;
-          yield 2;
-          yield 3;
-        }
-
-        viewof e = {
-          let output = {};
-          let listeners = [];
-          output.value = 10;
-          output.addEventListener = (listener) => listeners.push(listener);;
-          output.removeEventListener = (listener) => {
-            listeners = listeners.filter(l => l !== listener);
-          };
-          return output;
-        }
-      `);
-      const placeholder = document.getElementById("placeholder");
-      placeholder.text = JSON.stringify(notebook, undefined, 4);
-    </script>
-  </hpcc-vitepress>
-</ClientOnly>
-
-<a name="omd2notebook" href="#omd2notebook">#</a> **omd2notebook**(_omd_) => ohq.Module · [<>](https://github.com/hpcc-systems/Visualization/blob/trunk/packages/observablehq/compiler/src/util.ts "Source")
-
-* _omd_:  String containing Observable Markdown.
-* _returns_: Returns the notebook as a JSON object.
-
-Transforms Observable Markdown to a JSON notebook.
-
-<ClientOnly>
-  <hpcc-vitepress style="width:100%;height:600px">
-    <hpcc-codemirror id="placeholder" mode="json" theme="dark" style="width:100%;height:100%">
-    </hpcc-codemirror>
-    <script type="module">
-      import "@hpcc-js/wc-editor";
-      import { omd2notebook } from "@hpcc-js/observablehq-compiler";
-
-      const notebook = omd2notebook(`\
-        # Simple Notebook
-
-        * Set A
-        \`\`\`
-        a = 1
-        \`\`\`
-
-        * Set B
-        \`\`\`
-        b = 2
-        \`\`\`
-
-        * Calculate c
-
-        \`\`\`
-        c = a + b
-        \`\`\`
-      `);
-      const placeholder = document.getElementById("placeholder");
-      placeholder.text = JSON.stringify(notebook, undefined, 4);
-    </script>
-  </hpcc-vitepress>
-</ClientOnly>
-
+# Utilities
+
+Various utilities and helpers.
+
+---
+
+<a name="download" href="#download">#</a> **download**(_impUrl_) => Promise\<ohq.Module\> · [<>](https://github.com/hpcc-systems/Visualization/blob/trunk/packages/observablehq/compiler/src/util.ts "Source")
+
+* _impUrl_:  Full url to Obaservable HQ notebook as a string.
+* _returns_: Returns a Promise of a notebook (a JSON object).
+
+Downloads a notebook directly from [Observable HQ](https://observablehq.com/) as a JSON object.  The following example downloads the [@observablehq/plot](https://observablehq.com/@observablehq/plot) notebook as JSON:
+
+<ClientOnly>
+  <hpcc-vitepress style="width:100%;height:600px">
+    <hpcc-codemirror id="placeholder" mode="json" theme="dark" style="width:100%;height:100%">
+    </hpcc-codemirror>
+    <script type="module">
+      import "@hpcc-js/wc-editor";
+      import { download } from "@hpcc-js/observablehq-compiler";
+
+      const notebook = await download("https://observablehq.com/@observablehq/plot");
+      const placeholder = document.getElementById("placeholder");
+      placeholder.text = JSON.stringify(notebook, undefined, 4);
+    </script>
+  </hpcc-vitepress>
+</ClientOnly>
+
+---
+
+<a name="ojs2notebook" href="#ojs2notebook">#</a> **ojs2notebook**(_ojs_) => ohq.Module · [<>](https://github.com/hpcc-systems/Visualization/blob/trunk/packages/observablehq/compiler/src/util.ts "Source")
+
+* _ojs_:  String containing Observable JavaScript.
+* _returns_: Returns the notebook as a JSON object.
+
+Transforms Observable JavaScript to a JSON notebook.
+
+<ClientOnly>
+  <hpcc-vitepress style="width:100%;height:600px">
+    <hpcc-codemirror id="placeholder" mode="json" theme="dark" style="width:100%;height:100%">
+    </hpcc-codemirror>
+    <script type="module">
+      import "@hpcc-js/wc-editor";
+      import { ojs2notebook } from "@hpcc-js/observablehq-compiler";
+
+      const notebook = ojs2notebook(`
+        md\`# Simple Notebook\`
+        a = 1
+        b = 2
+        c = a + b
+        d = {
+          yield 1;
+          yield 2;
+          yield 3;
+        }
+
+        viewof e = {
+          let output = {};
+          let listeners = [];
+          output.value = 10;
+          output.addEventListener = (listener) => listeners.push(listener);;
+          output.removeEventListener = (listener) => {
+            listeners = listeners.filter(l => l !== listener);
+          };
+          return output;
+        }
+      `);
+      const placeholder = document.getElementById("placeholder");
+      placeholder.text = JSON.stringify(notebook, undefined, 4);
+    </script>
+  </hpcc-vitepress>
+</ClientOnly>
+
+<a name="omd2notebook" href="#omd2notebook">#</a> **omd2notebook**(_omd_) => ohq.Module · [<>](https://github.com/hpcc-systems/Visualization/blob/trunk/packages/observablehq/compiler/src/util.ts "Source")
+
+* _omd_:  String containing Observable Markdown.
+* _returns_: Returns the notebook as a JSON object.
+
+Transforms Observable Markdown to a JSON notebook.
+
+<ClientOnly>
+  <hpcc-vitepress style="width:100%;height:600px">
+    <hpcc-codemirror id="placeholder" mode="json" theme="dark" style="width:100%;height:100%">
+    </hpcc-codemirror>
+    <script type="module">
+      import "@hpcc-js/wc-editor";
+      import { omd2notebook } from "@hpcc-js/observablehq-compiler";
+
+      const notebook = omd2notebook(`\
+        # Simple Notebook
+
+        * Set A
+        \`\`\`
+        a = 1
+        \`\`\`
+
+        * Set B
+        \`\`\`
+        b = 2
+        \`\`\`
+
+        * Calculate c
+
+        \`\`\`
+        c = a + b
+        \`\`\`
+      `);
+      const placeholder = document.getElementById("placeholder");
+      placeholder.text = JSON.stringify(notebook, undefined, 4);
+    </script>
+  </hpcc-vitepress>
+</ClientOnly>
+

package/src/util.ts

@@ -1,154 +1,154 @@
-import type { ohq } from "@hpcc-js/observable-shim";
-import { parseModule } from "@hpcc-js/observable-shim";
-
-const FuncTypes = {
-    functionType: Object.getPrototypeOf(function () { }).constructor,
-    asyncFunctionType: Object.getPrototypeOf(async function () { }).constructor,
-    generatorFunctionType: Object.getPrototypeOf(function* () { }).constructor,
-    asyncGeneratorFunctionType: Object.getPrototypeOf(async function* () { }).constructor
-};
-
-function funcType(async: boolean = false, generator: boolean = false) {
-    if (!async && !generator) return FuncTypes.functionType;
-    if (async && !generator) return FuncTypes.asyncFunctionType;
-    if (!async && generator) return FuncTypes.generatorFunctionType;
-    return FuncTypes.asyncGeneratorFunctionType;
-}
-
-interface Ref {
-    start: number,
-    end: number,
-    newText: string
-}
-
-export interface Refs {
-    inputs: string[];
-    args: string[];
-    patches: Ref[];
-}
-
-export function createFunction(refs: Refs, async = false, generator = false, blockStatement = false, body?: string) {
-    if (body === undefined) {
-        return undefined;
-    }
-
-    refs.patches.sort((l, r) => r.start - l.start);
-    refs.patches.forEach(r => {
-        body = body!.substring(0, r.start) + r.newText + body!.substring(r.end);
-    });
-    return new (funcType(async, generator))(...refs.args, blockStatement ?
-        body.substring(1, body.length - 1).trim() :
-        `return (\n${body}\n);`);
-}
-
-//  Hide "import" from bundlers as they have a habit of replacing "import" with "require"
-export async function obfuscatedImport(url: string) {
-    return new FuncTypes.asyncFunctionType("url", "return import(url)")(url);
-}
-
-interface ParsedOJS {
-    ojs: string;
-    offset: number;
-    inlineMD: boolean;
-}
-
-export function encodeBacktick(str: string) {
-    return str
-        .split("`").join("\\`")
-        ;
-}
-
-function createParsedOJS(ojs: string, offset: number, inlineMD: boolean): ParsedOJS {
-    return {
-        ojs,
-        offset,
-        inlineMD
-    };
-}
-
-function parseOmd(_: string): ParsedOJS[] {
-    const retVal: ParsedOJS[] = [];
-    //  Load Markdown  ---
-    const re = /(```(?:\s|\S)[\s\S]*?```)/g;
-    let prevOffset = 0;
-    let match = re.exec(_);
-    while (match !== null) {
-        if (match.index > prevOffset) {
-            retVal.push(createParsedOJS(_.substring(prevOffset, match.index), prevOffset, true));
-        }
-
-        const outer = match[0];
-        if (outer.indexOf("``` ") === 0 || outer.indexOf("```\n") === 0 || outer.indexOf("```\r\n") === 0) {
-            const prefixLen = 3;
-            const inner = outer.substring(prefixLen, outer.length - prefixLen);
-            retVal.push(createParsedOJS(inner, match.index + prefixLen, false));
-        } else {
-            retVal.push(createParsedOJS(outer, match.index, true));
-        }
-
-        prevOffset = match.index + match[0].length;
-        match = re.exec(_);
-    }
-    if (_.length > prevOffset) {
-        retVal.push(createParsedOJS(_.substring(prevOffset, _.length), prevOffset, true));
-    }
-    return retVal;
-}
-
-export function notebook2ojs(_: string): ParsedOJS[] {
-    const parsed: ohq.Notebook = JSON.parse(_);
-    return parsed.nodes.map(node => createParsedOJS(node.value, 0, node.mode === "md"));
-}
-
-export function ojs2notebook(ojs: string): ohq.Notebook {
-    const cells = parseModule(ojs);
-    return {
-        files: [],
-        nodes: cells.map((cell, idx) => {
-            return {
-                id: idx,
-                mode: "js",
-                value: cell
-            };
-        })
-    } as ohq.Notebook;
-}
-
-export function omd2notebook(omd: string): ohq.Notebook {
-    const cells = parseOmd(omd);
-    return {
-        files: [],
-        nodes: cells.map((cell, idx) => {
-            return {
-                id: idx,
-                mode: cell.inlineMD ? "md" : "js",
-                value: cell.ojs
-            };
-        })
-    } as ohq.Notebook;
-}
-
-export function fetchEx(url: string) {
-    return fetch(url)
-        .then(response => {
-            if (response.ok) return response;
-            throw new Error("CORS?");
-        }).catch(e => {
-            const matches = url.match(/^(?:https?:\/\/)?(?:[^@\n]+@)?(?:www\.)?([^:\/\n?]+)/img);
-            url = "https://observable-cors.glitch.me/" + url;
-            return fetch(url, {
-                headers: {
-                    origin: matches[0],
-                    referer: url
-                }
-            });
-        });
-}
-
-export function download(impUrl: string): Promise<ohq.Notebook> {
-    const isShared = impUrl.indexOf("https://observablehq.com/d") === 0;
-    return fetchEx(impUrl.replace(`https://observablehq.com/${isShared ? "d/" : ""}`, "https://api.observablehq.com/document/"))
-        .then(r => r.json())
-        ;
-
+import type { ohq } from "@hpcc-js/observable-shim";
+import { parseModule } from "@hpcc-js/observable-shim";
+
+const FuncTypes = {
+    functionType: Object.getPrototypeOf(function () { }).constructor,
+    asyncFunctionType: Object.getPrototypeOf(async function () { }).constructor,
+    generatorFunctionType: Object.getPrototypeOf(function* () { }).constructor,
+    asyncGeneratorFunctionType: Object.getPrototypeOf(async function* () { }).constructor
+};
+
+function funcType(async: boolean = false, generator: boolean = false) {
+    if (!async && !generator) return FuncTypes.functionType;
+    if (async && !generator) return FuncTypes.asyncFunctionType;
+    if (!async && generator) return FuncTypes.generatorFunctionType;
+    return FuncTypes.asyncGeneratorFunctionType;
+}
+
+interface Ref {
+    start: number,
+    end: number,
+    newText: string
+}
+
+export interface Refs {
+    inputs: string[];
+    args: string[];
+    patches: Ref[];
+}
+
+export function createFunction(refs: Refs, async = false, generator = false, blockStatement = false, body?: string) {
+    if (body === undefined) {
+        return undefined;
+    }
+
+    refs.patches.sort((l, r) => r.start - l.start);
+    refs.patches.forEach(r => {
+        body = body!.substring(0, r.start) + r.newText + body!.substring(r.end);
+    });
+    return new (funcType(async, generator))(...refs.args, blockStatement ?
+        body.substring(1, body.length - 1).trim() :
+        `return (\n${body}\n);`);
+}
+
+//  Hide "import" from bundlers as they have a habit of replacing "import" with "require"
+export async function obfuscatedImport(url: string) {
+    return new FuncTypes.asyncFunctionType("url", "return import(url)")(url);
+}
+
+interface ParsedOJS {
+    ojs: string;
+    offset: number;
+    inlineMD: boolean;
+}
+
+export function encodeBacktick(str: string) {
+    return str
+        .split("`").join("\\`")
+        ;
+}
+
+function createParsedOJS(ojs: string, offset: number, inlineMD: boolean): ParsedOJS {
+    return {
+        ojs,
+        offset,
+        inlineMD
+    };
+}
+
+function parseOmd(_: string): ParsedOJS[] {
+    const retVal: ParsedOJS[] = [];
+    //  Load Markdown  ---
+    const re = /(```(?:\s|\S)[\s\S]*?```)/g;
+    let prevOffset = 0;
+    let match = re.exec(_);
+    while (match !== null) {
+        if (match.index > prevOffset) {
+            retVal.push(createParsedOJS(_.substring(prevOffset, match.index), prevOffset, true));
+        }
+
+        const outer = match[0];
+        if (outer.indexOf("``` ") === 0 || outer.indexOf("```\n") === 0 || outer.indexOf("```\r\n") === 0) {
+            const prefixLen = 3;
+            const inner = outer.substring(prefixLen, outer.length - prefixLen);
+            retVal.push(createParsedOJS(inner, match.index + prefixLen, false));
+        } else {
+            retVal.push(createParsedOJS(outer, match.index, true));
+        }
+
+        prevOffset = match.index + match[0].length;
+        match = re.exec(_);
+    }
+    if (_.length > prevOffset) {
+        retVal.push(createParsedOJS(_.substring(prevOffset, _.length), prevOffset, true));
+    }
+    return retVal;
+}
+
+export function notebook2ojs(_: string): ParsedOJS[] {
+    const parsed: ohq.Notebook = JSON.parse(_);
+    return parsed.nodes.map(node => createParsedOJS(node.value, 0, node.mode === "md"));
+}
+
+export function ojs2notebook(ojs: string): ohq.Notebook {
+    const cells = parseModule(ojs);
+    return {
+        files: [],
+        nodes: cells.map((cell, idx) => {
+            return {
+                id: idx,
+                mode: "js",
+                value: cell
+            };
+        })
+    } as ohq.Notebook;
+}
+
+export function omd2notebook(omd: string): ohq.Notebook {
+    const cells = parseOmd(omd);
+    return {
+        files: [],
+        nodes: cells.map((cell, idx) => {
+            return {
+                id: idx,
+                mode: cell.inlineMD ? "md" : "js",
+                value: cell.ojs
+            };
+        })
+    } as ohq.Notebook;
+}
+
+export function fetchEx(url: string) {
+    return fetch(url)
+        .then(response => {
+            if (response.ok) return response;
+            throw new Error("CORS?");
+        }).catch(e => {
+            const matches = url.match(/^(?:https?:\/\/)?(?:[^@\n]+@)?(?:www\.)?([^:\/\n?]+)/img);
+            url = "https://observable-cors.glitch.me/" + url;
+            return fetch(url, {
+                headers: {
+                    origin: matches[0],
+                    referer: url
+                }
+            });
+        });
+}
+
+export function download(impUrl: string): Promise<ohq.Notebook> {
+    const isShared = impUrl.indexOf("https://observablehq.com/d") === 0;
+    return fetchEx(impUrl.replace(`https://observablehq.com/${isShared ? "d/" : ""}`, "https://api.observablehq.com/document/"))
+        .then(r => r.json())
+        ;
+
 }