@f5-sales-demo/docs-theme 4.4.6 → 4.4.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@f5-sales-demo/docs-theme",
-  "version": "4.4.6",
+  "version": "4.4.8",
   "description": "F5 Distributed Cloud branded Starlight documentation theme",
   "type": "module",
   "engines": {

package/src/utils/compact-scopes.mjs

@@ -0,0 +1,20 @@
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export async function compactProviderScopes(root) {
+  const files = (await readdir(root, { recursive: true })).filter((name) => /\.(html|css|js)$/.test(name));
+  const names = new Set();
+  for (const file of files) {
+    const text = await readFile(join(root, file), 'utf8');
+    for (const match of text.matchAll(/\bastro-[a-z0-9]{8}\b/g)) names.add(match[0]);
+  }
+  const aliases = new Map([...names].sort().map((name, index) => [name, `f5p${index.toString(36)}`]));
+  let savedBytes = 0;
+  for (const file of files) {
+    const path = join(root, file);
+    const text = await readFile(path, 'utf8');
+    const compact = text.replace(/\bastro-[a-z0-9]{8}\b/g, (name) => aliases.get(name));
+    savedBytes += Buffer.byteLength(text) - Buffer.byteLength(compact);
+    if (text !== compact) await writeFile(path, compact);
+  }
+  return { aliases: aliases.size, savedBytes };
+}

package/src/utils/compact-scopes.test.ts

@@ -0,0 +1,22 @@
+import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { expect, it } from 'vitest';
+import { compactProviderScopes } from './compact-scopes.mjs';
+
+it('keeps generated scope selectors consistent across HTML CSS and JS', async () => {
+  const root = await mkdtemp(join(tmpdir(), 'provider-scope-'));
+  try {
+    await writeFile(join(root, 'page.html'), '<div class="astro-abcdefgh">Reference</div>');
+    await writeFile(join(root, 'page.css'), '.astro-abcdefgh{color:red}');
+    await writeFile(join(root, 'page.js'), 'document.querySelector(".astro-abcdefgh")');
+    const result = await compactProviderScopes(root);
+    expect(result.aliases).toBe(1);
+    expect(await readFile(join(root, 'page.html'), 'utf8')).toBe('<div class="f5p0">Reference</div>');
+    expect(await readFile(join(root, 'page.css'), 'utf8')).toBe('.f5p0{color:red}');
+    expect(await readFile(join(root, 'page.js'), 'utf8')).toContain('.f5p0');
+    expect((await compactProviderScopes(root)).savedBytes).toBe(0);
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+});

package/src/utils/share-provider-assets.mjs

@@ -2,6 +2,7 @@ import { createHash } from 'node:crypto';
 import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
 import { join, posix } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { compactProviderScopes } from './compact-scopes.mjs';
 
 const hash = (value) => createHash('sha256').update(value).digest('hex').slice(0, 24);
 // Input is Astro-generated HTML. Keep each asset's original execution position
@@ -30,7 +31,10 @@ export async function shareProviderAssets(root, base = '/') {
       tokenStyles.set(name, style);
       return `<span class="${name}"`;
     });
-    html = html.replace(/href="https:\/\/f5-sales-demo.github.io(\/terraform-provider-xcsh\/[^"#]*)/g, 'href="$1');
+    html = html.replace(
+      /<a\b([^>]*?)href="https:\/\/f5-sales-demo.github.io(\/terraform-provider-xcsh\/[^"#]*)/g,
+      '<a$1href="$2',
+    );
     if (tokenStyles.size) html = html.replace('</head>', `<link rel="stylesheet" href="${prefix}tokens.css"></head>`);
     const islands = [];
     html = html.replace(/<astro-island\b[\s\S]*?<\/astro-island>/g, (island) => {
@@ -66,7 +70,8 @@ export async function shareProviderAssets(root, base = '/') {
     await writeFile(join(assetRoot, name), body);
     assetBytes += Buffer.byteLength(body);
   }
-  return { pages: files.length, assets: assets.size, savedBytes: saved - assetBytes };
+  const scopes = await compactProviderScopes(root);
+  return { pages: files.length, assets: assets.size, savedBytes: saved - assetBytes + scopes.savedBytes };
 }
 
 export default function providerSharedAssets() {

package/src/utils/share-provider-assets.test.ts

@@ -71,3 +71,17 @@ it('resolves file-route links from their containing directory', async () => {
     await rm(root, { recursive: true, force: true });
   }
 });
+
+it('preserves absolute canonical metadata while shortening anchor links', async () => {
+  const root = await mkdtemp(join(tmpdir(), 'provider-canonical-'));
+  try {
+    const url = 'https://f5-sales-demo.github.io/terraform-provider-xcsh/resources/';
+    await writeFile(join(root, 'index.html'), `<link rel="canonical" href="${url}"><a href="${url}">Resources</a>`);
+    await shareProviderAssets(root, '/terraform-provider-xcsh/');
+    const html = await readFile(join(root, 'index.html'), 'utf8');
+    expect(html).toContain(`<link rel="canonical" href="${url}">`);
+    expect(html).toContain('<a href="resources/">');
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+});