@salesforcedevs/sfdocs-e2e 1.0.7 → 1.0.8-alpha.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforcedevs/sfdocs-e2e",
-  "version": "1.0.7",
+  "version": "1.0.8-alpha.0",
   "description": "E2E test suite for SFDocs static portal pages (SSG)",
   "license": "ISC",
   "bin": {

package/portal-wdio.conf.js

@@ -4,5 +4,9 @@ exports.config = {
     ...BASE_CONFIG.config,
     baseUrl: process.env.E2E_BASE_URL || 'http://localhost:3001',
     specs: ['./src/portal/specs/**/*.test.ts', './src/shared/specs/*.test.ts'],
-    exclude: ['./src/shared/specs/contentActionToolbar.test.ts'],
+    exclude: [
+        './src/shared/specs/contentActionToolbar.test.ts',
+        // Advanced liquid tests require previewFuture — not enabled in portal builds
+        './src/shared/specs/liquid-advanced.test.ts',
+    ],
 };

package/src/shared/specs/liquid-advanced.test.ts

@@ -0,0 +1,56 @@
+import GuidePage from '../pageobjects/guide.page';
+
+let page: GuidePage;
+let liquidEnabled = false;
+
+describe('Liquid Template Rendering — Advanced', () => {
+    before(async () => {
+        try {
+            page = new GuidePage('/docs/liquid-project/guide/liquid-quickstart.html');
+            await browser.url(page.path);
+            await page.waitPageLoad();
+
+            const content = await $('>>>doc-content-layout');
+            const text = await content.getText();
+
+            liquidEnabled = text.includes('Hello from data.yaml');
+        } catch (e) {
+            liquidEnabled = false;
+        }
+    });
+
+    beforeEach(async () => {
+        if (liquidEnabled) {
+            page = new GuidePage('/docs/liquid-project/guide/liquid-quickstart.html');
+            await browser.url(page.path);
+            await page.waitPageLoad();
+        }
+    });
+
+    it('Should render future block content when previewFuture is enabled', async function () {
+        if (!liquidEnabled) {
+            this.skip();
+        }
+
+        const content = await $('>>>doc-content-layout');
+        const text = await content.getText();
+
+        expect(text.includes('Coming Soon')).toBeTruthy();
+    });
+
+    it('Should render the future topic page when previewFuture is enabled', async function () {
+        if (!liquidEnabled) {
+            this.skip();
+        }
+
+        const futurePage = new GuidePage('/docs/liquid-project/guide/future-topic.html');
+        await browser.url(futurePage.path);
+        await futurePage.waitPageLoad();
+
+        const content = await $('>>>doc-content-layout');
+        const text = await content.getText();
+
+        expect(text.includes('Future Feature')).toBeTruthy();
+        expect(text.includes('previewFuture')).toBeTruthy();
+    });
+});

package/src/shared/specs/liquid.test.ts

@@ -7,7 +7,7 @@ describe('Liquid Template Rendering', () => {
     before(async () => {
         try {
             page = new GuidePage('/docs/liquid-project/guide/liquid-quickstart.html');
-            page.open();
+            await browser.url(page.path);
             await page.waitPageLoad();
 
             const content = await $('>>>doc-content-layout');
@@ -16,9 +16,9 @@ describe('Liquid Template Rendering', () => {
 
             const hasLiquidOutput = text.includes('Hello from data.yaml');
             const hasRawSyntax =
-                html.includes('{{ data.greeting }}') ||
-                html.includes('{{ topic }}') ||
-                (html.includes('{{') && html.includes('{%'));
+                html.includes('{% assign') ||
+                html.includes('{% include') ||
+                html.includes('{{ data.greeting }}');
 
             if (hasRawSyntax) {
                 liquidEnabled = false;
@@ -35,7 +35,7 @@ describe('Liquid Template Rendering', () => {
     beforeEach(async () => {
         if (liquidEnabled) {
             page = new GuidePage('/docs/liquid-project/guide/liquid-quickstart.html');
-            page.open();
+            await browser.url(page.path);
             await page.waitPageLoad();
         }
     });
@@ -50,10 +50,21 @@ describe('Liquid Template Rendering', () => {
 
         expect(text.includes('GitHub for writers')).toBeTruthy();
         expect(text.includes('Hello from data.yaml')).toBeTruthy();
+    });
 
+    it('Should render repository-level variables from content-config.yml', async function () {
+        if (!liquidEnabled) {
+            this.skip();
+        }
+
+        const content = await $('>>>doc-content-layout');
+        const text = await content.getText();
         const html = await content.getHTML();
-        expect(html.includes('{{ topic }}')).toBeFalsy();
-        expect(html.includes('{{ data.greeting }}')).toBeFalsy();
+
+        expect(text.includes('Salesforce Platform')).toBeTruthy();
+        expect(text.includes('62.0')).toBeTruthy();
+        expect(text.includes('sf')).toBeTruthy();
+        expect(html.includes('{{ variables.platform')).toBeFalsy();
     });
 
     it('Should render included templates from shared directory', async function () {
@@ -86,27 +97,29 @@ describe('Liquid Template Rendering', () => {
         const listItems = await content.$$('li');
         expect(listItems.length).toBeGreaterThan(5);
 
-        expect(html.includes('{% for')).toBeFalsy();
-        expect(html.includes('{%- for')).toBeFalsy();
-        expect(html.includes('{% endfor')).toBeFalsy();
+        expect(text.includes('supported_calls')).toBeFalsy();
+        expect(html.includes('for call in supported_calls')).toBeFalsy();
     });
 
-    it('Should not process Liquid syntax inside code blocks', async function () {
+    it('Should resolve {{ }} outputs inside code blocks but keep {% %} tags literal', async function () {
         if (!liquidEnabled) {
             this.skip();
         }
 
-        const content = await $('>>>doc-content-layout');
-        const html = await content.getHTML();
-        const codeBlock = await content.$('code');
+        const codeBlockElement = await $('>>>.code-block-content');
+        const codeBlock = await codeBlockElement.shadow$('code');
 
         expect(await codeBlock.isExisting()).toBeTruthy();
 
-        const codeHtml = await codeBlock.getHTML();
-        expect(codeHtml.includes('{{ data.greeting }}')).toBeTruthy();
-        expect(codeHtml.includes('{{ topic }}')).toBeTruthy();
-        expect(codeHtml.includes('{% for item in items %}')).toBeTruthy();
+        const codeText = await codeBlock.getText();
+        expect(codeText.includes('{{ data.greeting }}')).toBeFalsy();
+        expect(codeText.includes('{{ topic }}')).toBeFalsy();
+        expect(codeText.includes('Hello from data.yaml')).toBeTruthy();
+        expect(codeText.includes('GitHub for writers')).toBeTruthy();
+        expect(codeText.includes('{% for item in items %}')).toBeTruthy();
+        expect(codeText.includes('{{ item }}')).toBeTruthy();
 
+        const content = await $('>>>doc-content-layout');
         const text = await content.getText();
         expect(text.includes('Visit')).toBeTruthy();
     });
@@ -131,16 +144,76 @@ describe('Liquid Template Rendering', () => {
         expect(html.includes('{{ id2 }}')).toBeFalsy();
     });
 
-    it('Should not process Liquid when frontmatter has liquid.enabled as false', async function () {
+    it('Should render englishonly block content in production', async function () {
         if (!liquidEnabled) {
             this.skip();
         }
 
-        const disabledPage = new GuidePage(
+        const content = await $('>>>doc-content-layout');
+        const text = await content.getText();
+        const html = await content.getHTML();
+
+        expect(text.includes('This feature is currently only available in English')).toBeTruthy();
+        expect(html.includes('{% englishonly')).toBeFalsy();
+        expect(html.includes('{% endenglishonly')).toBeFalsy();
+    });
+
+    it('Should render liquid.data string format — single YAML file on root context', async function () {
+        if (!liquidEnabled) {
+            this.skip();
+        }
+
+        const content = await $('>>>doc-content-layout');
+        const text = await content.getText();
+
+        expect(text.includes('Hello from data.yaml')).toBeTruthy();
+    });
+
+    it('Should render liquid.data object format — multiple YAML files each under a named key', async function () {
+        if (!liquidEnabled) {
+            this.skip();
+        }
+
+        const multiDataPage = new GuidePage('/docs/liquid-project/guide/multi-data.html');
+        await browser.url(multiDataPage.path);
+        await multiDataPage.waitPageLoad();
+
+        const content = await $('>>>doc-content-layout');
+        const text = await content.getText();
+        const html = await content.getHTML();
+
+        expect(text.includes('Sample data file to check the multi-include')).toBeTruthy();
+        expect(html.includes('{{ two.summary }}')).toBeFalsy();
+        expect(html.includes('{{ data.one.summary }}')).toBeFalsy();
+    });
+
+    it('Should render the englishonly topic page', async function () {
+        if (!liquidEnabled) {
+            this.skip();
+        }
+
+        const englishOnlyPage = new GuidePage('/docs/liquid-project/guide/english-only-topic.html');
+        await browser.url(englishOnlyPage.path);
+        await englishOnlyPage.waitPageLoad();
+
+        const content = await $('>>>doc-content-layout');
+        const text = await content.getText();
+
+        expect(text.includes('English-Only Topic')).toBeTruthy();
+        expect(text.includes('filters: [englishonly]')).toBeTruthy();
+    });
+
+    it('Should render a file with no Liquid syntax as plain markdown', async function () {
+        if (!liquidEnabled) {
+            this.skip();
+        }
+
+        const plainPage = new GuidePage(
             '/docs/liquid-project/guide/liquid-learning-resources.html',
         );
-        disabledPage.open();
-        await disabledPage.waitPageLoad();
+
+        await browser.url(plainPage.path);
+        await plainPage.waitPageLoad();
 
         const content = await $('>>>doc-content-layout');
         const text = await content.getText();

package/static-dsc-portal-wdio.conf.js

@@ -18,7 +18,6 @@ exports.config = {
 
     // Exclude tests that require dynamic server features or pages not in static build
     exclude: [
-        './src/shared/specs/liquid.test.ts',
         './src/portal/specs/docs.api.test.ts',
         './src/portal/specs/docs.test.ts',
         './src/shared/specs/banner.test.ts',

package/static-portal-wdio.conf.js

@@ -18,7 +18,8 @@ exports.config = {
 
     // Exclude tests that require dynamic server features or pages not in static build
     exclude: [
-        './src/shared/specs/liquid.test.ts',
+        // Advanced liquid tests require previewFuture, variables — not in static build
+        './src/shared/specs/liquid-advanced.test.ts',
         // /docs/apis landing page doesn't exist in static builds
         './src/portal/specs/docs.api.test.ts',
         // /docs landing page doesn't exist in static builds