perspective 1.6.4

A frontend for Perspective
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

/******************************************************************************
 *
 * Copyright (c) 2018, the Perspective Authors.
 *
 * This file is part of the Perspective library, distributed under the terms
 * of the Apache License 2.0.  The full license can be found in the LICENSE
 * file.
 *
 */

// Forked from gist
// https://gist.github.com/davideicardi/787df4a9dc0de66c1db8f5a57e511230

const fs = require("fs");
const {Transform, PassThrough} = require("stream");
const puppeteer = require("puppeteer");

function concatStreams(streams) {
    let pass = new PassThrough();
    let waiting = streams.length;
    for (let stream of streams) {
        pass = stream.pipe(pass, {end: false});
        stream.once("end", () => --waiting === 0 && pass.emit("end"));
    }
    return pass;
}

class AddEndOfLine extends Transform {
    constructor(options) {
        super(options);
    }
    _transform(data, encoding, callback) {
        this.push(data);
        this.push("\n\n");
        callback();
    }
}

class ConvertLinksToAnchors extends Transform {
    constructor(options) {
        super(options);
    }
    _transform(data, encoding, callback) {
        const pattern = /\[(.+)\]\((.+\.md)?(#(.+))?\)/g;
        const newData = data.toString().replace(pattern, (m, p1, p2, p3) => {
            const anchor = `${p3 && p3.length > 0 ? p3.slice(1) : p1}`;
            return `[${p1}](#${anchor})`;
        });

        this.push(newData);
        callback();
    }
}

const inPaths = [
    "./dist/docs/README.md",
    "./dist/docs/interfaces/IPerspectiveViewerElement.md",
    "./dist/docs/interfaces/IPerspectiveViewerPlugin.md",
];

const outPath = "./README.md";
const inputs = inPaths.map((x) => fs.createReadStream(x));
const output = fs.createWriteStream(outPath);

concatStreams(inputs)
    .pipe(new AddEndOfLine())
    .pipe(new ConvertLinksToAnchors())
    .pipe(output)
    .on("finish", function () {
        console.log("Done merging!");
    });

async function capture_exprtk() {
    const browser = await puppeteer.launch({headless: true});
    const page = await browser.newPage();
    await page.addScriptTag({path: "dist/umd/perspective-viewer.js"});
    const data = await page.evaluate(async () => {
        await customElements.whenDefined("perspective-viewer");
        const commands = await customElements
            .get("perspective-viewer")
            .getExprTKCommands();

        return JSON.stringify(commands, null, 4);
    });

    let md = `---
id: perspective-viewer-exprtk
title: ExprTK Function Reference
---

## ExprTK Function Reference

`;
    for (const item of JSON.parse(data)) {
        if (item.kind === 1) {
            md += `#### \`${item.label}\`

${item.documentation}

\`\`\`
${item.insertText}
\`\`\`

`;
        }
    }

    fs.writeFileSync("./exprtk.md", md);
    await page.close();
    await browser.close();
}

capture_exprtk();