@goldstack/utils-docs 0.3.17

package/README.md

@@ -0,0 +1,7 @@
+# Goldstack Documentation Utilities
+
+Utilities for generating documentation based on the way [Next.js are generating their documentation](https://github.com/vercel/next-site/tree/e2cb07a057bf75bded2571a1b639b0017572f4b8/lib/docs)
+
+The logic for embedding Markdown files draws from [gatsby-remark-embed-markdown](https://github.com/jtstodola/gatsby-remark-embed-markdown).
+
+This library is used for generating the [Goldstack Documentation](https://docs.goldstack.party/docs/goldstack/about).

package/dist/githubConstants.d.ts

@@ -0,0 +1,5 @@
+export declare const GITHUB_URL = "https://github.com";
+export declare const GITHUB_API_URL = "https://api.github.com";
+export declare const RAW_GITHUB_URL = "https://raw.githubusercontent.com";
+export declare const REPO_NAME = "goldstack/goldstack";
+//# sourceMappingURL=githubConstants.d.ts.map

package/dist/githubConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"githubConstants.d.ts","sourceRoot":"","sources":["../src/githubConstants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,uBAAuB,CAAC;AAE/C,eAAO,MAAM,cAAc,2BAA2B,CAAC;AAEvD,eAAO,MAAM,cAAc,sCAAsC,CAAC;AAElE,eAAO,MAAM,SAAS,wBAAwB,CAAC"}

package/dist/githubConstants.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPO_NAME = exports.RAW_GITHUB_URL = exports.GITHUB_API_URL = exports.GITHUB_URL = void 0;
+exports.GITHUB_URL = 'https://github.com';
+exports.GITHUB_API_URL = 'https://api.github.com';
+exports.RAW_GITHUB_URL = 'https://raw.githubusercontent.com';
+exports.REPO_NAME = 'goldstack/goldstack';
+//# sourceMappingURL=githubConstants.js.map

package/dist/githubConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"githubConstants.js","sourceRoot":"","sources":["../src/githubConstants.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG,oBAAoB,CAAC;AAElC,QAAA,cAAc,GAAG,wBAAwB,CAAC;AAE1C,QAAA,cAAc,GAAG,mCAAmC,CAAC;AAErD,QAAA,SAAS,GAAG,qBAAqB,CAAC"}

package/dist/markdownToHtml.d.ts

@@ -0,0 +1,2 @@
+export declare function markdownToHtml(filePath: any, tag: any, md: any): Promise<string>;
+//# sourceMappingURL=markdownToHtml.d.ts.map

package/dist/markdownToHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownToHtml.d.ts","sourceRoot":"","sources":["../src/markdownToHtml.ts"],"names":[],"mappings":"AAkCA,wBAAsB,cAAc,CAAC,QAAQ,KAAA,EAAE,GAAG,KAAA,EAAE,EAAE,KAAA,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBvE"}

package/dist/markdownToHtml.js

@@ -0,0 +1,64 @@
+"use strict";
+// based on https://github.com/vercel/next-site/blob/e2cb07a057bf75bded2571a1b639b0017572f4b8/lib/docs/markdown-to-html.js
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.markdownToHtml = void 0;
+const unified_1 = __importDefault(require("unified"));
+const remark_parse_1 = __importDefault(require("remark-parse"));
+const remark_rehype_1 = __importDefault(require("remark-rehype"));
+const rehype_raw_1 = __importDefault(require("rehype-raw"));
+const rehype_prism_1 = __importDefault(require("@mapbox/rehype-prism"));
+const rehype_stringify_1 = __importDefault(require("rehype-stringify"));
+// https://github.com/syntax-tree/hast-util-sanitize/blob/master/lib/github.json
+const github_json_1 = __importDefault(require("hast-util-sanitize/lib/github.json"));
+const rehypeDocs_1 = __importDefault(require("./rehypeDocs"));
+const rehypeMarkdownToHtml_1 = __importDefault(require("./rehypeMarkdownToHtml"));
+// Allow className for all elements
+github_json_1.default.attributes['*'].push('className');
+const handlers = {
+    // Add a className to inlineCode so we can differentiate between it and code fragments
+    inlineCode(h, node) {
+        return {
+            ...node,
+            type: 'element',
+            tagName: 'code',
+            properties: { className: 'inline' },
+            children: [
+                {
+                    type: 'text',
+                    value: node.value,
+                },
+            ],
+        };
+    },
+};
+async function markdownToHtml(filePath, tag, md) {
+    try {
+        // Init the processor with our custom plugin
+        let processor = undefined;
+        processor = (0, unified_1.default)()
+            .use(remark_parse_1.default)
+            .use(rehypeMarkdownToHtml_1.default, { filePath, tag, processor: () => processor })
+            .use(remark_rehype_1.default, { handlers, allowDangerousHTML: true })
+            // Add custom HTML found in the markdown file to the AST
+            .use(rehype_raw_1.default)
+            // Sanitize the HTML
+            // .use(sanitize, githubSchema)
+            // Add syntax highlighting to the sanitized HTML
+            .use(rehype_prism_1.default)
+            .use(rehype_stringify_1.default)
+            .freeze()()
+            .use(rehypeDocs_1.default, { filePath, tag, processor });
+        const file = await processor.process(md);
+        // Replace non-breaking spaces (char code 160) with normal spaces to avoid style issues
+        return file.contents.replace(/\xA0/g, ' ');
+    }
+    catch (error) {
+        console.error(`Markdown to HTML error: ${error}`);
+        throw error;
+    }
+}
+exports.markdownToHtml = markdownToHtml;
+//# sourceMappingURL=markdownToHtml.js.map

package/dist/markdownToHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownToHtml.js","sourceRoot":"","sources":["../src/markdownToHtml.ts"],"names":[],"mappings":";AAAA,0HAA0H;;;;;;AAE1H,sDAA8B;AAC9B,gEAAoC;AACpC,kEAA2C;AAC3C,4DAA6B;AAC7B,wEAAyC;AACzC,wEAAoC;AACpC,gFAAgF;AAChF,qFAA8D;AAC9D,8DAAgC;AAChC,kFAAoD;AAEpD,mCAAmC;AACnC,qBAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAE/C,MAAM,QAAQ,GAAG;IACf,sFAAsF;IACtF,UAAU,CAAC,CAAC,EAAE,IAAI;QAChB,OAAO;YACL,GAAG,IAAI;YACP,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;YACnC,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE,IAAI,CAAC,KAAK;iBAClB;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEK,KAAK,UAAU,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE;IACpD,IAAI;QACF,4CAA4C;QAC5C,IAAI,SAAS,GAAQ,SAAS,CAAC;QAC/B,SAAS,GAAG,IAAA,iBAAO,GAAE;aAClB,GAAG,CAAC,sBAAe,CAAC;aACpB,GAAG,CAAC,8BAAc,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;aAClE,GAAG,CAAC,uBAAc,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;YAC5D,wDAAwD;aACvD,GAAG,CAAC,oBAAG,CAAC;YACT,oBAAoB;YACpB,+BAA+B;YAC/B,gDAAgD;aAC/C,GAAG,CAAC,sBAAK,CAAC;aACV,GAAG,CAAC,0BAAI,CAAC;aACT,MAAM,EAAE,EAAE;aACV,GAAG,CAAC,oBAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEzC,uFAAuF;QACvF,OAAQ,IAAI,CAAC,QAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;KACrD;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,CAAC,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC;KACb;AACH,CAAC;AAzBD,wCAyBC"}

package/dist/markdownToHtml.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=markdownToHtml.spec.d.ts.map

package/dist/markdownToHtml.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownToHtml.spec.d.ts","sourceRoot":"","sources":["../src/markdownToHtml.spec.ts"],"names":[],"mappings":""}

package/dist/markdownToHtml.spec.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const markdownToHtml_1 = require("./markdownToHtml");
+const utils_sh_1 = require("@goldstack/utils-sh");
+describe('markdownToHtml', () => {
+    it('Should render documentation markdown to html', async () => {
+        const result = await (0, markdownToHtml_1.markdownToHtml)(__dirname + '/markdown/configure.md', {}, (0, utils_sh_1.read)(__dirname + '/markdown/configure.md'));
+        expect(result).toContain('<p>');
+        expect(result).toContain('<a');
+    });
+    it('Should render documentation with embedded documents', async () => {
+        const file = __dirname + '/markdown/template-s3.md';
+        const result = await (0, markdownToHtml_1.markdownToHtml)(file, {}, (0, utils_sh_1.read)(file));
+        expect(result).toContain('<p>');
+        expect(result).toContain('<a');
+    });
+});
+//# sourceMappingURL=markdownToHtml.spec.js.map

package/dist/markdownToHtml.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownToHtml.spec.js","sourceRoot":"","sources":["../src/markdownToHtml.spec.ts"],"names":[],"mappings":";;AAAA,qDAAkD;AAClD,kDAA2C;AAE3C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,MAAM,GAAG,MAAM,IAAA,+BAAc,EACjC,SAAS,GAAG,wBAAwB,EACpC,EAAE,EACF,IAAA,eAAI,EAAC,SAAS,GAAG,wBAAwB,CAAC,CAC3C,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,IAAI,GAAG,SAAS,GAAG,0BAA0B,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAA,+BAAc,EAAC,IAAI,EAAE,EAAE,EAAE,IAAA,eAAI,EAAC,IAAI,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/permalinkIconAst.d.ts

@@ -0,0 +1,3 @@
+declare const permalinkIcon: any;
+export default permalinkIcon;
+//# sourceMappingURL=permalinkIconAst.d.ts.map

package/dist/permalinkIconAst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permalinkIconAst.d.ts","sourceRoot":"","sources":["../src/permalinkIconAst.ts"],"names":[],"mappings":"AAuBA,QAAA,MAAM,aAAa,KAGjB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/permalinkIconAst.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const unified_1 = __importDefault(require("unified"));
+const rehype_raw_1 = __importDefault(require("rehype-raw"));
+const ICON_HTML = `<svg viewBox="0 0 16 16" width="16" height="16">
+  <g strokeWidth="1" fill="#000000" stroke="#000000">
+    <path
+      fill="none"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      strokeMiterlimit="10"
+      d="M8.995,7.005 L8.995,7.005c1.374,1.374,1.374,3.601,0,4.975l-1.99,1.99c-1.374,1.374-3.601,1.374-4.975,0l0,0c-1.374-1.374-1.374-3.601,0-4.975 l1.748-1.698"
+    />
+    <path
+      fill="none"
+      stroke="#000000"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      strokeMiterlimit="10"
+      d="M7.005,8.995 L7.005,8.995c-1.374-1.374-1.374-3.601,0-4.975l1.99-1.99c1.374-1.374,3.601-1.374,4.975,0l0,0c1.374,1.374,1.374,3.601,0,4.975 l-1.748,1.698"
+    />
+  </g>
+</svg>`;
+const permalinkIcon = (0, unified_1.default)().use(rehype_raw_1.default).runSync({
+    type: 'raw',
+    value: ICON_HTML,
+});
+exports.default = permalinkIcon;
+//# sourceMappingURL=permalinkIconAst.js.map

package/dist/permalinkIconAst.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permalinkIconAst.js","sourceRoot":"","sources":["../src/permalinkIconAst.ts"],"names":[],"mappings":";;;;;AAAA,sDAA8B;AAC9B,4DAA6B;AAE7B,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;OAkBX,CAAC;AAER,MAAM,aAAa,GAAG,IAAA,iBAAO,GAAE,CAAC,GAAG,CAAC,oBAAG,CAAC,CAAC,OAAO,CAAC;IAC/C,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,SAAS;CACjB,CAAC,CAAC;AAEH,kBAAe,aAAa,CAAC"}

package/dist/rehypeDocs.d.ts

@@ -0,0 +1,6 @@
+export default function rehypeDocs({ filePath, tag, processor }: {
+    filePath: any;
+    tag: any;
+    processor: any;
+}): (tree: any) => void;
+//# sourceMappingURL=rehypeDocs.d.ts.map

package/dist/rehypeDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehypeDocs.d.ts","sourceRoot":"","sources":["../src/rehypeDocs.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE;;;;CAAA,UAmE3B,GAAG,KAAG,IAAI,CAI7C"}

package/dist/rehypeDocs.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const unist_util_visit_1 = __importDefault(require("unist-util-visit"));
+const mdast_util_to_string_1 = __importDefault(require("mdast-util-to-string"));
+const github_slugger_1 = __importDefault(require("github-slugger"));
+const permalinkIconAst_1 = __importDefault(require("./permalinkIconAst"));
+const ABSOLUTE_URL = /^(https?:\/\/|\/\/)/i;
+// The headers will be updated to include a link to their hash
+const HEADINGS = ['h2', 'h3', 'h4', 'h5', 'h6'];
+function rehypeDocs({ filePath, tag, processor }) {
+    const slugger = new github_slugger_1.default();
+    const anchorSlugger = new github_slugger_1.default();
+    function visitAnchor(node) {
+        const props = node.properties;
+        const href = props === null || props === void 0 ? void 0 : props.href;
+        if (!href)
+            return;
+        if (props.href === href) {
+            const isAbsoluteUrl = ABSOLUTE_URL.test(href);
+            // const isHash = href[0] === '#';
+            // const isRepoUrl = !isHash;
+            if (isAbsoluteUrl) {
+                props.className = 'absolute';
+                props.target = '_blank';
+                props.rel = 'noopener noreferrer';
+                return;
+            }
+        }
+        const [relativePath, hash] = props.href.split('#');
+        // Reset the slugger because single pages can have multiple urls to the same hash
+        anchorSlugger.reset();
+        // The URL is relative at this point
+        props.className = 'relative';
+        // Update the hash used by anchors to match the one set for headers
+        props.href = hash
+            ? `${relativePath}#${anchorSlugger.slug(hash)}`
+            : relativePath;
+    }
+    function visitHeading(node) {
+        const text = (0, mdast_util_to_string_1.default)(node);
+        if (!text)
+            return;
+        const id = slugger.slug(text);
+        node.properties.className = 'heading';
+        node.children = [
+            {
+                type: 'element',
+                tagName: 'span',
+                properties: { id },
+            },
+            {
+                type: 'element',
+                tagName: 'a',
+                properties: {
+                    href: `#${id}`,
+                },
+                children: node.children,
+            },
+            {
+                type: 'element',
+                tagName: 'span',
+                properties: { className: 'permalink' },
+                children: [permalinkIconAst_1.default],
+            },
+        ];
+    }
+    return function transformer(tree) {
+        (0, unist_util_visit_1.default)(tree, (node) => node.tagName === 'a', visitAnchor);
+        (0, unist_util_visit_1.default)(tree, (node) => HEADINGS.includes(node.tagName), visitHeading);
+    };
+}
+exports.default = rehypeDocs;
+//# sourceMappingURL=rehypeDocs.js.map

package/dist/rehypeDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehypeDocs.js","sourceRoot":"","sources":["../src/rehypeDocs.ts"],"names":[],"mappings":";;;;;AAAA,wEAAqC;AACrC,gFAA4C;AAC5C,oEAA2C;AAC3C,0EAA+C;AAE/C,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAC5C,8DAA8D;AAC9D,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEhD,SAAwB,UAAU,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE;IAC7D,MAAM,OAAO,GAAG,IAAI,wBAAa,EAAE,CAAC;IACpC,MAAM,aAAa,GAAG,IAAI,wBAAa,EAAE,CAAC;IAE1C,SAAS,WAAW,CAAC,IAAS;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,IAAI,CAAC;QAEzB,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE;YACvB,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,kCAAkC;YAClC,6BAA6B;YAE7B,IAAI,aAAa,EAAE;gBACjB,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC;gBAC7B,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;gBACxB,KAAK,CAAC,GAAG,GAAG,qBAAqB,CAAC;gBAElC,OAAO;aACR;SACF;QAED,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEnD,iFAAiF;QACjF,aAAa,CAAC,KAAK,EAAE,CAAC;QACtB,oCAAoC;QACpC,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC;QAC7B,mEAAmE;QACnE,KAAK,CAAC,IAAI,GAAG,IAAI;YACf,CAAC,CAAC,GAAG,YAAY,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC/C,CAAC,CAAC,YAAY,CAAC;IACnB,CAAC;IAED,SAAS,YAAY,CAAC,IAAS;QAC7B,MAAM,IAAI,GAAG,IAAA,8BAAQ,EAAC,IAAI,CAAC,CAAC;QAE5B,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,IAAI,CAAC,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG;YACd;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE,EAAE,EAAE,EAAE;aACnB;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,GAAG;gBACZ,UAAU,EAAE;oBACV,IAAI,EAAE,IAAI,EAAE,EAAE;iBACf;gBACD,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE;gBACtC,QAAQ,EAAE,CAAC,0BAAa,CAAC;aAC1B;SACF,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,WAAW,CAAC,IAAS;QACnC,IAAA,0BAAK,EAAC,IAAI,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,GAAG,EAAE,WAAW,CAAC,CAAC;QAC9D,IAAA,0BAAK,EAAC,IAAI,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC;IAC5E,CAAC,CAAC;AACJ,CAAC;AAvED,6BAuEC"}

package/dist/rehypeMarkdownToHtml.d.ts

@@ -0,0 +1,6 @@
+export default function rehypeDocs({ filePath, tag, processor }: {
+    filePath: any;
+    tag: any;
+    processor: any;
+}): any;
+//# sourceMappingURL=rehypeMarkdownToHtml.d.ts.map

package/dist/rehypeMarkdownToHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehypeMarkdownToHtml.d.ts","sourceRoot":"","sources":["../src/rehypeMarkdownToHtml.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE;;;;CAAA,GAAG,GAAG,CAkFpE"}

package/dist/rehypeMarkdownToHtml.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = require("path");
+const unist_util_visit_1 = __importDefault(require("unist-util-visit"));
+const path_2 = __importDefault(require("path"));
+function rehypeDocs({ filePath, tag, processor }) {
+    function visitInlineCode(node) {
+        const value = node.value;
+        if (value.startsWith('markdown:')) {
+            const file = value.substr(9);
+            const combinedPath = path_2.default.normalize((0, path_1.dirname)(filePath) + '/' + file);
+            if (!fs_1.default.existsSync(combinedPath)) {
+                throw Error(`Invalid fragment specified; no such file "${combinedPath}"`);
+            }
+            const code = fs_1.default.readFileSync(combinedPath, 'utf8');
+            const markdown = processor();
+            try {
+                node.value = `<div class=\"markdown-fragment\">${markdown.processSync(code)}</div>`;
+                node.type = 'html';
+            }
+            catch (e) {
+                throw Error(`${e.message} \nFile: ${file}`);
+            }
+        }
+    }
+    function visitLink(node) {
+        if (node.children.length > 0 && node.children[0].value === '!embed') {
+            const file = node.url;
+            const path = (0, path_1.dirname)(filePath) + '/' + file;
+            if (!fs_1.default.existsSync(path)) {
+                throw Error(`Invalid fragment specified; no such file "${path}"`);
+            }
+            const code = fs_1.default.readFileSync(path, 'utf8');
+            const markdown = processor();
+            try {
+                node.value = `<div class=\"markdown-fragment\">${markdown.processSync(code)}</div>`;
+                node.type = 'html';
+            }
+            catch (e) {
+                throw Error(`${e.message} \nFile: ${file}`);
+            }
+        }
+        if (node.children.length > 0 && node.children[0].value.indexOf('%') === 0) {
+            node.value = `
+      <div class="card card-bordered bg-soft-info">
+        <div class="card-body">
+        <h5 class="card-title">${node.children[0].value.substring(1)}</h5>
+          <div class="card-text">
+            <div class="embed-responsive embed-responsive-16by9">
+              <iframe class="embed-responsive-item" src="${node.url}" allowfullscreen></iframe>
+            </div>
+          </div>
+        </div>
+      </div>`;
+            // node.value = `<iframe
+            //   width="560"
+            //   height="315"
+            //   src="${node.url}"
+            //   frameborder="0"
+            //   allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+            //   allowfullscreen>
+            // </iframe>`;
+            node.type = 'html';
+        }
+    }
+    return function transformer(tree) {
+        (0, unist_util_visit_1.default)(tree, 'inlineCode', visitInlineCode);
+        (0, unist_util_visit_1.default)(tree, (node) => node.type === 'link', visitLink);
+        return tree;
+    };
+}
+exports.default = rehypeDocs;
+//# sourceMappingURL=rehypeMarkdownToHtml.js.map

package/dist/rehypeMarkdownToHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehypeMarkdownToHtml.js","sourceRoot":"","sources":["../src/rehypeMarkdownToHtml.ts"],"names":[],"mappings":"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"}

package/dist/rehypeMarkdownToMarkdown.d.ts

@@ -0,0 +1,4 @@
+export default function rehypeDocs({ filePath }: {
+    filePath: any;
+}): any;
+//# sourceMappingURL=rehypeMarkdownToMarkdown.d.ts.map

package/dist/rehypeMarkdownToMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehypeMarkdownToMarkdown.d.ts","sourceRoot":"","sources":["../src/rehypeMarkdownToMarkdown.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EAAE,QAAQ,EAAE;;CAAA,GAAG,GAAG,CA8DpD"}

package/dist/rehypeMarkdownToMarkdown.js

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = require("path");
+const unist_util_visit_1 = __importDefault(require("unist-util-visit"));
+const path_2 = __importDefault(require("path"));
+const utils_sh_1 = require("@goldstack/utils-sh");
+const unified_1 = __importDefault(require("unified"));
+const remark_parse_1 = __importDefault(require("remark-parse"));
+const gray_matter_1 = __importDefault(require("gray-matter"));
+function fileToMarkdownTree(filePath) {
+    const data = (0, gray_matter_1.default)((0, utils_sh_1.read)(filePath)).content;
+    const tree = (0, unified_1.default)()
+        .use(remark_parse_1.default)
+        .parse(data);
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define
+    return rehypeDocs({ filePath })(tree);
+}
+function rehypeDocs({ filePath }) {
+    function visitInlineCode(node) {
+        const value = node.value;
+        if (value.startsWith('markdown:')) {
+            const file = value.substr(9);
+            const combinedPath = path_2.default.normalize((0, path_1.dirname)(filePath) + '/' + file);
+            if (!fs_1.default.existsSync(combinedPath)) {
+                throw Error(`Invalid fragment specified; no such file "${combinedPath}"`);
+            }
+            const tree = fileToMarkdownTree(combinedPath);
+            try {
+                node.children = tree.children;
+                node.value = '';
+                node.type = 'root';
+            }
+            catch (e) {
+                throw Error(`${e.message} \nFile: ${file}`);
+            }
+        }
+    }
+    function visitLink(node) {
+        if (node.children.length > 0 && node.children[0].value === '!embed') {
+            const file = node.url;
+            const path = (0, path_1.dirname)(filePath) + '/' + file;
+            if (!fs_1.default.existsSync(path)) {
+                throw Error(`Invalid fragment specified; no such file "${path}"`);
+            }
+            const tree = fileToMarkdownTree(path);
+            try {
+                node.children = tree.children;
+                node.value = '';
+                node.type = 'root';
+            }
+            catch (e) {
+                throw Error(`${e.message} \nFile: ${file}`);
+            }
+        }
+        if (node.children.length > 0 &&
+            node.children[0].value &&
+            node.children[0].value.indexOf('%') === 0) {
+            node.value = `[Video: ${node.children[0].value.substring(1)}](${node.url})`;
+            node.type = 'text';
+        }
+    }
+    return function transformer(tree) {
+        (0, unist_util_visit_1.default)(tree, 'inlineCode', visitInlineCode);
+        (0, unist_util_visit_1.default)(tree, (node) => node.type === 'link', visitLink);
+        return tree;
+    };
+}
+exports.default = rehypeDocs;
+//# sourceMappingURL=rehypeMarkdownToMarkdown.js.map

package/dist/rehypeMarkdownToMarkdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rehypeMarkdownToMarkdown.js","sourceRoot":"","sources":["../src/rehypeMarkdownToMarkdown.ts"],"names":[],"mappings":"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"}

package/dist/resolveMarkdown.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveMarkdown(filePath: string): Promise<string>;
+//# sourceMappingURL=resolveMarkdown.d.ts.map

package/dist/resolveMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveMarkdown.d.ts","sourceRoot":"","sources":["../src/resolveMarkdown.ts"],"names":[],"mappings":"AASA,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBvE"}

package/dist/resolveMarkdown.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveMarkdown = void 0;
+const unified_1 = __importDefault(require("unified"));
+const remark_parse_1 = __importDefault(require("remark-parse"));
+const rehypeMarkdownToMarkdown_1 = __importDefault(require("./rehypeMarkdownToMarkdown"));
+// import stringify from 'rehype-stringify';
+const mdast_util_to_markdown_1 = __importDefault(require("mdast-util-to-markdown"));
+const gray_matter_1 = __importDefault(require("gray-matter"));
+const utils_sh_1 = require("@goldstack/utils-sh");
+async function resolveMarkdown(filePath) {
+    try {
+        let tree = undefined;
+        tree = (0, unified_1.default)()
+            .use(remark_parse_1.default)
+            // .use(rehypeMarkdown, { filePath })
+            .parse((0, gray_matter_1.default)((0, utils_sh_1.read)(filePath)).content);
+        tree = (0, rehypeMarkdownToMarkdown_1.default)({ filePath })(tree);
+        // const file = await processor.process(md);
+        // console.log(JSON.stringify(tree, null, 2));
+        const file = (0, mdast_util_to_markdown_1.default)(tree, {});
+        // Replace non-breaking spaces (char code 160) with normal spaces to avoid style issues
+        return file.replace(/\xA0/g, ' ');
+    }
+    catch (error) {
+        console.error(`Markdown to Markdown error: ${error}`);
+        throw error;
+    }
+}
+exports.resolveMarkdown = resolveMarkdown;
+//# sourceMappingURL=resolveMarkdown.js.map

package/dist/resolveMarkdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveMarkdown.js","sourceRoot":"","sources":["../src/resolveMarkdown.ts"],"names":[],"mappings":";;;;;;AAAA,sDAA8B;AAC9B,gEAAoC;AACpC,0FAAwD;AACxD,4CAA4C;AAC5C,oFAA+C;AAE/C,8DAAiC;AACjC,kDAA2C;AAEpC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,IAAI;QACF,IAAI,IAAI,GAAQ,SAAS,CAAC;QAC1B,IAAI,GAAG,IAAA,iBAAO,GAAE;aACb,GAAG,CAAC,sBAAe,CAAC;YACrB,qCAAqC;aACpC,KAAK,CAAC,IAAA,qBAAM,EAAC,IAAA,eAAI,EAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,GAAG,IAAA,kCAAc,EAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1C,4CAA4C;QAC5C,8CAA8C;QAC9C,MAAM,IAAI,GAAG,IAAA,gCAAS,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAEjC,uFAAuF;QACvF,OAAQ,IAAY,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;KAC5C;IAAC,OAAO,KAAK,EAAE;QACd,OAAO,CAAC,KAAK,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,CAAC;KACb;AACH,CAAC;AAlBD,0CAkBC"}

package/dist/resolveMarkdown.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolveMarkdown.spec.d.ts.map

package/dist/resolveMarkdown.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveMarkdown.spec.d.ts","sourceRoot":"","sources":["../src/resolveMarkdown.spec.ts"],"names":[],"mappings":""}

package/dist/resolveMarkdown.spec.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const resolveMarkdown_1 = require("./resolveMarkdown");
+describe('markdownToMarkdown', () => {
+    it('Should render documentation markdown to markdown', async () => {
+        const result = await (0, resolveMarkdown_1.resolveMarkdown)(__dirname + '/markdown/configure.md');
+        expect(result).toContain('[AWS region]');
+    });
+    it('Should render documentation with embedded documents', async () => {
+        const file = __dirname + '/markdown/template-s3.md';
+        const result = await (0, resolveMarkdown_1.resolveMarkdown)(file);
+        expect(result).toContain('[AWS region]');
+        expect(result).toContain('s3 = connect()');
+    });
+});
+//# sourceMappingURL=resolveMarkdown.spec.js.map

package/dist/resolveMarkdown.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveMarkdown.spec.js","sourceRoot":"","sources":["../src/resolveMarkdown.spec.ts"],"names":[],"mappings":";;AAAA,uDAAoD;AAEpD,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,MAAM,GAAG,MAAM,IAAA,iCAAe,EAAC,SAAS,GAAG,wBAAwB,CAAC,CAAC;QAC3E,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,IAAI,GAAG,SAAS,GAAG,0BAA0B,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAA,iCAAe,EAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utilsDocs.d.ts

@@ -0,0 +1,8 @@
+export { markdownToHtml } from './markdownToHtml';
+export { resolveMarkdown } from './resolveMarkdown';
+export interface RenderPageResult {
+    html: string;
+    data: any;
+}
+export declare const renderPage: (filePath: string) => Promise<RenderPageResult>;
+//# sourceMappingURL=utilsDocs.d.ts.map

package/dist/utilsDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilsDocs.d.ts","sourceRoot":"","sources":["../src/utilsDocs.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC;CACX;AAED,eAAO,MAAM,UAAU,aACX,MAAM,KACf,QAAQ,gBAAgB,CAS1B,CAAC"}

package/dist/utilsDocs.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPage = exports.resolveMarkdown = exports.markdownToHtml = void 0;
+const gray_matter_1 = __importDefault(require("gray-matter"));
+const utils_sh_1 = require("@goldstack/utils-sh");
+const markdownToHtml_1 = require("./markdownToHtml");
+const path_1 = __importDefault(require("path"));
+var markdownToHtml_2 = require("./markdownToHtml");
+Object.defineProperty(exports, "markdownToHtml", { enumerable: true, get: function () { return markdownToHtml_2.markdownToHtml; } });
+var resolveMarkdown_1 = require("./resolveMarkdown");
+Object.defineProperty(exports, "resolveMarkdown", { enumerable: true, get: function () { return resolveMarkdown_1.resolveMarkdown; } });
+const renderPage = async (filePath) => {
+    const fileContent = (0, utils_sh_1.read)(filePath);
+    const { data, content } = (0, gray_matter_1.default)(fileContent);
+    const result = await (0, markdownToHtml_1.markdownToHtml)(path_1.default.resolve(filePath), data, content);
+    return {
+        html: result,
+        data,
+    };
+};
+exports.renderPage = renderPage;
+//# sourceMappingURL=utilsDocs.js.map

package/dist/utilsDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilsDocs.js","sourceRoot":"","sources":["../src/utilsDocs.ts"],"names":[],"mappings":";;;;;;AAAA,8DAAiC;AAEjC,kDAA2C;AAC3C,qDAAkD;AAClD,gDAAwB;AAExB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAOjB,MAAM,UAAU,GAAG,KAAK,EAC7B,QAAgB,EACW,EAAE;IAC7B,MAAM,WAAW,GAAG,IAAA,eAAI,EAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAA,qBAAM,EAAC,WAAW,CAAC,CAAC;IAE9C,MAAM,MAAM,GAAG,MAAM,IAAA,+BAAc,EAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3E,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI;KACL,CAAC;AACJ,CAAC,CAAC;AAXW,QAAA,UAAU,cAWrB"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@goldstack/utils-docs",
+  "version": "0.3.17",
+  "description": "Utilities for working with Markdown documentation",
+  "keywords": [
+    "goldstack",
+    "utility",
+    "documentation",
+    "markdown",
+    "html",
+    "markdown to html",
+    "rehype",
+    "generator"
+  ],
+  "homepage": "https://goldstack.party",
+  "bugs": {
+    "url": "https://github.com/goldstack/goldstack/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/goldstack/goldstack.git"
+  },
+  "license": "MIT",
+  "author": "Max Rohde",
+  "sideEffects": false,
+  "main": "dist/utilsDocs.js",
+  "scripts": {
+    "build": "yarn clean && yarn compile",
+    "build:watch": "yarn clean && yarn compile:watch",
+    "clean": "rm -rf ./dist",
+    "compile": "tsc -p tsconfig.json",
+    "compile:watch": "tsc -p tsconfig.json --watch",
+    "compile:watch:light": "nodemon --watch ./src/ -e '*' --exec 'yarn compile'",
+    "coverage": "jest --collect-coverage --passWithNoTests --config=./jest.config.js",
+    "prepublishOnly": "yarn run build",
+    "publish": "utils-git changed --exec \"yarn npm publish $@\"",
+    "test": "jest --config=./jest.config.js --watch",
+    "test:ci": "jest --passWithNoTests --config=./jest.config.js",
+    "version:apply": "utils-git changed --exec \"yarn version $@ && yarn version apply\"",
+    "version:apply:force": "yarn version $@ && yarn version apply"
+  },
+  "dependencies": {
+    "@goldstack/utils-sh": "0.4.13",
+    "@mapbox/rehype-prism": "0.3.1",
+    "github-slugger": "1.2.0",
+    "gray-matter": "^4.0.2",
+    "hast-util-sanitize": "^3.0.0",
+    "mdast-util-to-markdown": "0.5.3",
+    "mdast-util-to-string": "1.0.7",
+    "rehype-raw": "4.0.1",
+    "rehype-sanitize": "3.0.0",
+    "rehype-stringify": "6.0.0",
+    "remark-parse": "7.0.1",
+    "remark-rehype": "5.0.0",
+    "unified": "8.4.1",
+    "unist-util-visit": "2.0.0"
+  },
+  "devDependencies": {
+    "@goldstack/utils-git": "0.1.26",
+    "@types/jest": "^26.0.21",
+    "@types/node": "^14.0.6",
+    "jest": "^26.6.3",
+    "ts-jest": "^26.5.4",
+    "typescript": "^4.4.3"
+  }
+}