@progress/kendo-typescript-api-tasks 3.0.2-dev.3 → 3.0.2-dev.35

package/lib/comment.js

@@ -13,7 +13,7 @@ const commentTags = (comment, member) =>
 
             if (tag.tag === '@example') {
                 text = text.replace(/_@/g, '@');
-            } else if (tag.tag === '@see') {
+            } else if (tag.tag === '@see' && member.packageName) {
                 const linkSlug = slug(member.packageName, text);
                 text = `\n\nSee [${text}]({% slug ${linkSlug} %})`;
             } else {

package/lib/generator.js

@@ -212,9 +212,35 @@ const writeFile = (name, content) => {
     fs.writeFileSync(name, content);
 };
 
+const stripPlatformContent = (input, platform) => {
+    if (typeof platform !== 'string') {
+        return input;
+    }
+
+    const extractContent = (_, platformMatch, platformContent) => (
+        platform.toLowerCase() === platformMatch.trim().toLowerCase() ? `${platformContent}` : ""
+    );
+
+    // Replace platform_content blocks on newlines
+    let content = input.replace(
+        /^[ \t]*{%\s*platform_content\s+([a-zA-Z0-9_-]+)\s*%}\r?\n?([\s\S]*?)^[ \t]*{%\s*endplatform_content\s*%}\r?\n?/gm,
+        extractContent
+    );
+
+    // Replace platform_content blocks without newlines (e.g. in comments)
+    content = content.replace(
+        /{%\s*platform_content\s+([a-zA-Z0-9_-]+)\s*%}([\s\S]*?){%\s*endplatform_content\s*%}/g,
+        extractContent
+    );
+
+    return content;
+};
+
 const writeMember = (path, member, info) => {
-    let sub = member.module ? member.module + '/' : '';
-    writeFile(`${path}/${sub}${member.url}.md`, memberPage(member, info));
+    const sub = member.module ? member.module + '/' : '';
+    const content = stripPlatformContent(memberPage(member, info), info.platform);
+
+    writeFile(`${path}/${sub}${member.url}.md`, content);
 };
 
 const groupMembers = (members) => {
@@ -266,7 +292,7 @@ const generate = (done, config, packageInfo) => {
 };
 
 module.exports = {
-    generate: generate,
-    extractMembers: extractMembers
+    generate,
+    extractMembers,
+    stripPlatformContent
 };
-

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@progress/kendo-typescript-api-tasks",
     "description": "Kendo UI API docs package gulp tasks",
-    "version": "3.0.2-dev.3+504d23b",
+    "version": "3.0.2-dev.35+a81fc3a",
     "author": "Progress",
     "license": "Apache-2.0",
     "main": "index.js",
@@ -31,5 +31,5 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "504d23bcd75c4263dcf2d16393d04c102e6faa9f"
+    "gitHead": "a81fc3aad00eb94d6b027b54acfcfb3c73896b1d"
 }

package/test/api.js

@@ -348,5 +348,41 @@ describe('API generation', () => {
             expect(/#\s{1}Foo\s{1}API/.test(page)).toBe(true);
         });
     });
+
+    describe('stripPlatformContent', () => {
+        it('strips platform content', () => {
+            const content = `
+                HEADER
+
+                {% platform_content angular %}
+                ANGULAR CONTENT
+                {% endplatform_content %}
+                {% platform_content react %}
+                REACT CONTENT
+                {% endplatform_content %}
+
+                FOOTER
+            `;
+
+            const output = generator.stripPlatformContent(content, 'react');
+
+            expect(output).toBe(`
+                HEADER
+
+                REACT CONTENT
+
+                FOOTER
+            `);
+        });
+
+        it('strips inline platform content', () => {
+            const content =
+                "HEADER {% platform_content angular %}ANGULAR CONTENT{% endplatform_content %}{% platform_content react %}REACT CONTENT{% endplatform_content %} FOOTER";
+
+            const output = generator.stripPlatformContent(content, 'react');
+
+            expect(output).toBe("HEADER REACT CONTENT FOOTER");
+        });
+    });
 });