npm - @webstir-io/webstir-frontend - Versions diffs - 0.1.40 → 0.1.41 - Mend

@webstir-io/webstir-frontend 0.1.40 → 0.1.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (138) hide show

package/README.md +124 -60
package/dist/assets/imageOptimizer.js +10 -15
package/dist/assets/precompression.js +1 -1
package/dist/builders/contentBuilder.js +102 -90
package/dist/builders/cssBuilder.js +25 -19
package/dist/builders/htmlBuilder.js +57 -42
package/dist/builders/index.js +1 -1
package/dist/builders/jsBuilder.js +219 -76
package/dist/builders/staticAssetsBuilder.js +27 -9
package/dist/builders/types.d.ts +1 -0
package/dist/cli.d.ts +1 -1
package/dist/cli.js +6 -30
package/dist/config/manifest.js +7 -6
package/dist/config/paths.js +2 -2
package/dist/config/schema.d.ts +8 -0
package/dist/config/schema.js +7 -6
package/dist/config/setup.js +1 -1
package/dist/config/workspace.js +11 -9
package/dist/core/constants.d.ts +1 -1
package/dist/core/constants.js +5 -5
package/dist/core/diagnostics.js +1 -1
package/dist/core/pages.js +4 -4
package/dist/hooks.js +3 -3
package/dist/html/criticalCss.js +6 -3
package/dist/html/htmlSecurity.d.ts +6 -1
package/dist/html/htmlSecurity.js +28 -14
package/dist/html/lazyLoad.js +1 -1
package/dist/html/pageScaffold.js +1 -1
package/dist/html/resourceHints.js +5 -2
package/dist/index.d.ts +2 -0
package/dist/index.js +2 -0
package/dist/inspect.d.ts +2 -0
package/dist/inspect.js +110 -0
package/dist/modes/ssg/metadata.js +4 -4
package/dist/modes/ssg/routing.js +2 -5
package/dist/modes/ssg/seo.js +5 -5
package/dist/modes/ssg/views.js +17 -11
package/dist/operations.js +18 -10
package/dist/pipeline.d.ts +1 -0
package/dist/pipeline.js +6 -1
package/dist/provider.js +28 -24
package/dist/runtime/boundary.d.ts +28 -0
package/dist/runtime/boundary.js +247 -0
package/dist/runtime/index.d.ts +1 -0
package/dist/runtime/index.js +1 -0
package/dist/types.d.ts +52 -0
package/dist/utils/fs.d.ts +11 -10
package/dist/utils/fs.js +48 -20
package/dist/utils/glob.d.ts +8 -0
package/dist/utils/glob.js +21 -0
package/dist/utils/hash.js +1 -2
package/dist/utils/pagePaths.js +2 -2
package/package.json +19 -14
package/scripts/publish.sh +2 -94
package/scripts/update-contract.sh +12 -10
package/src/assets/assetManifest.ts +39 -29
package/src/assets/imageOptimizer.ts +91 -82
package/src/assets/precompression.ts +22 -16
package/src/builders/contentBuilder.ts +1224 -1149
package/src/builders/cssBuilder.ts +466 -417
package/src/builders/htmlBuilder.ts +511 -448
package/src/builders/index.ts +7 -7
package/src/builders/jsBuilder.ts +538 -280
package/src/builders/staticAssetsBuilder.ts +166 -135
package/src/builders/types.ts +7 -6
package/src/cli.ts +66 -90
package/src/config/manifest.ts +16 -14
package/src/config/paths.ts +5 -5
package/src/config/schema.ts +38 -37
package/src/config/setup.ts +7 -7
package/src/config/workspace.ts +118 -116
package/src/config/workspaceManifest.ts +14 -14
package/src/core/constants.ts +62 -62
package/src/core/diagnostics.ts +26 -26
package/src/core/pages.ts +19 -19
package/src/hooks.ts +128 -118
package/src/html/criticalCss.ts +84 -77
package/src/html/htmlSecurity.ts +107 -66
package/src/html/lazyLoad.ts +22 -19
package/src/html/pageScaffold.ts +37 -28
package/src/html/resourceHints.ts +83 -74
package/src/index.ts +2 -0
package/src/inspect.ts +158 -0
package/src/modes/ssg/metadata.ts +53 -51
package/src/modes/ssg/routing.ts +177 -177
package/src/modes/ssg/seo.ts +208 -200
package/src/modes/ssg/validation.ts +31 -25
package/src/modes/ssg/views.ts +257 -238
package/src/operations.ts +105 -95
package/src/pipeline.ts +81 -69
package/src/provider.ts +184 -176
package/src/runtime/boundary.ts +325 -0
package/src/runtime/index.ts +1 -0
package/src/types.ts +107 -48
package/src/utils/changedFile.ts +22 -22
package/src/utils/fs.ts +73 -26
package/src/utils/glob.ts +38 -0
package/src/utils/hash.ts +2 -4
package/src/utils/pagePaths.ts +35 -23
package/src/utils/pathMatch.ts +26 -23
package/tests/add-page-defaults.test.js +44 -39
package/tests/bundlerParity.test.js +252 -0
package/tests/cli.contract.test.js +13 -0
package/tests/content-pages.test.js +108 -13
package/tests/css-app-imports.test.js +22 -11
package/tests/css-page-imports.test.js +26 -13
package/tests/diagnostics.test.js +39 -36
package/tests/features.test.js +48 -43
package/tests/hooks.test.js +58 -42
package/tests/htmlSecurity.test.js +66 -0
package/tests/inspect.test.js +148 -0
package/tests/provider.integration.test.js +71 -20
package/tests/runtime.test.js +493 -0
package/tests/ssg-defaults.test.js +284 -177
package/tests/ssg-guardrails.test.js +51 -51
package/tsconfig.json +3 -10
package/dist/watch/frontendFiles.d.ts +0 -3
package/dist/watch/frontendFiles.js +0 -25
package/dist/watch/hotUpdateTracker.d.ts +0 -51
package/dist/watch/hotUpdateTracker.js +0 -205
package/dist/watch/pipelineHelpers.d.ts +0 -26
package/dist/watch/pipelineHelpers.js +0 -177
package/dist/watch/types.d.ts +0 -27
package/dist/watch/types.js +0 -1
package/dist/watch/watchCoordinator.d.ts +0 -36
package/dist/watch/watchCoordinator.js +0 -551
package/dist/watch/watchDaemon.d.ts +0 -17
package/dist/watch/watchDaemon.js +0 -127
package/dist/watch/watchReporter.d.ts +0 -21
package/dist/watch/watchReporter.js +0 -64
package/scripts/smoke.mjs +0 -35
package/src/watch/frontendFiles.ts +0 -32
package/src/watch/hotUpdateTracker.ts +0 -285
package/src/watch/pipelineHelpers.ts +0 -242
package/src/watch/types.ts +0 -23
package/src/watch/watchCoordinator.ts +0 -666
package/src/watch/watchDaemon.ts +0 -144
package/src/watch/watchReporter.ts +0 -98

package/tests/content-pages.test.js CHANGED Viewed

@@ -5,12 +5,14 @@ import fssync from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-async function loadProviderOrSkip(t) {
+async function loadFrontendModuleOrSkip(t) {
   try {
-    const mod = await import('../dist/index.js');
-    return mod.frontendProvider;
+    return await import('../dist/index.js');
   } catch (err) {
-    console.warn('[frontend-tests] Skipping provider integration: optional dependency unavailable:', err?.message ?? err);
+    console.warn(
+      '[frontend-tests] Skipping provider integration: optional dependency unavailable:',
+      err?.message ?? err,
+    );
     t?.diagnostic?.('skip: missing optional dependency');
     return null;
   }
@@ -28,10 +30,29 @@ async function createWorkspaceWithContent() {
   await fs.writeFile(
     path.join(appDir, 'app.html'),
     '<!DOCTYPE html><html><head><title>My Site</title></head><body><main></main></body></html>',
-    'utf8'
+    'utf8',
   );
   await fs.writeFile(path.join(appDir, 'app.css'), 'body{font-family:sans-serif;}', 'utf8');
-  await fs.writeFile(path.join(pageDir, 'index.html'), '<head></head><main><section>Home</section></main>', 'utf8');
+  await fs.writeFile(
+    path.join(pageDir, 'index.html'),
+    '<head></head><main><section>Home</section></main>',
+    'utf8',
+  );
+  await fs.writeFile(
+    path.join(root, 'package.json'),
+    JSON.stringify(
+      {
+        name: 'content-test',
+        private: true,
+        webstir: {
+          mode: 'ssg',
+        },
+      },
+      null,
+      2,
+    ),
+    'utf8',
+  );
   await fs.writeFile(
     path.join(contentDir, 'readme.md'),
@@ -44,23 +65,53 @@ async function createWorkspaceWithContent() {
       '',
       '# Content pipeline',
       '',
-      'Hello from markdown.'
+      'Hello from markdown.',
     ].join('\n'),
-    'utf8'
+    'utf8',
+  );
+  await fs.writeFile(
+    path.join(contentDir, '_sidebar.json'),
+    JSON.stringify(
+      {
+        pages: [
+          {
+            path: '/docs/readme/',
+            title: 'Guide v1',
+            order: 1,
+          },
+        ],
+      },
+      null,
+      2,
+    ),
+    'utf8',
   );
   return root;
 }
 test('content builder strips frontmatter and injects app styles', async (t) => {
-  const frontendProvider = await loadProviderOrSkip(t);
-  if (!frontendProvider) return;
+  const frontend = await loadFrontendModuleOrSkip(t);
+  if (!frontend) return;
+  const { frontendProvider } = frontend;
   const workspace = await createWorkspaceWithContent();
   try {
-    await frontendProvider.build({ workspaceRoot: workspace, env: { WEBSTIR_MODULE_MODE: 'build' }, incremental: false });
+    await frontendProvider.build({
+      workspaceRoot: workspace,
+      env: { WEBSTIR_MODULE_MODE: 'build' },
+      incremental: false,
+    });
-    const htmlPath = path.join(workspace, 'build', 'frontend', 'pages', 'docs', 'readme', 'index.html');
+    const htmlPath = path.join(
+      workspace,
+      'build',
+      'frontend',
+      'pages',
+      'docs',
+      'readme',
+      'index.html',
+    );
     assert.equal(fssync.existsSync(htmlPath), true, `expected ${htmlPath}`);
     const html = await fs.readFile(htmlPath, 'utf8');
@@ -74,7 +125,51 @@ test('content builder strips frontmatter and injects app styles', async (t) => {
     const nav = JSON.parse(await fs.readFile(navPath, 'utf8'));
     assert.ok(Array.isArray(nav) && nav.length > 0, 'expected docs-nav.json to contain entries');
-    assert.ok(nav.some((entry) => entry.path === '/docs/readme/'), 'expected docs-nav.json to include /docs/readme/');
+    assert.ok(
+      nav.some((entry) => entry.path === '/docs/readme/'),
+      'expected docs-nav.json to include /docs/readme/',
+    );
+  } finally {
+    await fs.rm(workspace, { recursive: true, force: true });
+  }
+});
+test('content rebuild updates docs-nav when _sidebar.json changes', async (t) => {
+  const frontend = await loadFrontendModuleOrSkip(t);
+  if (!frontend) return;
+  const { runBuild, runRebuild } = frontend;
+  const workspace = await createWorkspaceWithContent();
+  try {
+    await runBuild({ workspaceRoot: workspace });
+    const navPath = path.join(workspace, 'build', 'frontend', 'docs-nav.json');
+    let nav = JSON.parse(await fs.readFile(navPath, 'utf8'));
+    assert.equal(nav[0]?.title, 'Guide v1');
+    const sidebarPath = path.join(workspace, 'src', 'frontend', 'content', '_sidebar.json');
+    await fs.writeFile(
+      sidebarPath,
+      JSON.stringify(
+        {
+          pages: [
+            {
+              path: '/docs/readme/',
+              title: 'Guide v2',
+              order: 1,
+            },
+          ],
+        },
+        null,
+        2,
+      ),
+      'utf8',
+    );
+    await runRebuild({ workspaceRoot: workspace, changedFile: sidebarPath });
+    nav = JSON.parse(await fs.readFile(navPath, 'utf8'));
+    assert.equal(nav[0]?.title, 'Guide v2');
   } finally {
     await fs.rm(workspace, { recursive: true, force: true });
   }

package/tests/css-app-imports.test.js CHANGED Viewed

@@ -10,7 +10,10 @@ async function loadProviderOrSkip(t) {
     const mod = await import('../dist/index.js');
     return mod.frontendProvider;
   } catch (err) {
-    console.warn('[frontend-tests] Skipping provider integration: optional dependency unavailable:', err?.message ?? err);
+    console.warn(
+      '[frontend-tests] Skipping provider integration: optional dependency unavailable:',
+      err?.message ?? err,
+    );
     t?.diagnostic?.('skip: missing optional dependency');
     return null;
   }
@@ -27,18 +30,23 @@ async function createWorkspace() {
   await fs.writeFile(
     path.join(appDir, 'app.html'),
     '<!DOCTYPE html><html><head><title>App</title></head><body><main></main></body></html>',
-    'utf8'
+    'utf8',
   );
   await fs.writeFile(
     path.join(appDir, 'app.css'),
-    [
-      '@layer reset, base;',
-      '@import "./styles/base.css";'
-    ].join('\n'),
-    'utf8'
+    ['@layer reset, base;', '@import "./styles/base.css";'].join('\n'),
+    'utf8',
+  );
+  await fs.writeFile(
+    path.join(stylesDir, 'base.css'),
+    '@layer base { body { background: blue; } }',
+    'utf8',
+  );
+  await fs.writeFile(
+    path.join(pageDir, 'index.html'),
+    '<head></head><main><section>Home</section></main>',
+    'utf8',
   );
-  await fs.writeFile(path.join(stylesDir, 'base.css'), '@layer base { body { background: blue; } }', 'utf8');
-  await fs.writeFile(path.join(pageDir, 'index.html'), '<head></head><main><section>Home</section></main>', 'utf8');
   await fs.writeFile(path.join(pageDir, 'index.css'), '@import "@app/app.css";', 'utf8');
   return root;
@@ -50,7 +58,11 @@ test('development app.css import URLs include a cache-busting version', async (t
   const workspace = await createWorkspace();
   try {
-    await frontendProvider.build({ workspaceRoot: workspace, env: { WEBSTIR_MODULE_MODE: 'build' }, incremental: false });
+    await frontendProvider.build({
+      workspaceRoot: workspace,
+      env: { WEBSTIR_MODULE_MODE: 'build' },
+      incremental: false,
+    });
     const appCssPath = path.join(workspace, 'build', 'frontend', 'app', 'app.css');
     assert.equal(fssync.existsSync(appCssPath), true, `expected ${appCssPath}`);
@@ -61,4 +73,3 @@ test('development app.css import URLs include a cache-busting version', async (t
     await fs.rm(workspace, { recursive: true, force: true });
   }
 });

package/tests/css-page-imports.test.js CHANGED Viewed

@@ -10,7 +10,10 @@ async function loadProviderOrSkip(t) {
     const mod = await import('../dist/index.js');
     return mod.frontendProvider;
   } catch (err) {
-    console.warn('[frontend-tests] Skipping provider integration: optional dependency unavailable:', err?.message ?? err);
+    console.warn(
+      '[frontend-tests] Skipping provider integration: optional dependency unavailable:',
+      err?.message ?? err,
+    );
     t?.diagnostic?.('skip: missing optional dependency');
     return null;
   }
@@ -27,40 +30,44 @@ async function createWorkspace() {
   await fs.writeFile(
     path.join(appDir, 'app.html'),
     '<!DOCTYPE html><html><head><title>App</title></head><body><main></main></body></html>',
-    'utf8'
+    'utf8',
   );
   await fs.writeFile(path.join(appDir, 'app.css'), '', 'utf8');
-  await fs.writeFile(path.join(pageDir, 'index.html'), '<head></head><main><section>Home</section></main>', 'utf8');
+  await fs.writeFile(
+    path.join(pageDir, 'index.html'),
+    '<head></head><main><section>Home</section></main>',
+    'utf8',
+  );
   await fs.writeFile(
     path.join(pageDir, 'index.css'),
     [
       '@layer overrides { .home { color: red; } }',
       '@import "./layout.css";',
-      '@import url("./partials/colors.css");'
+      '@import url("./partials/colors.css");',
     ].join('\n'),
-    'utf8'
+    'utf8',
   );
   await fs.writeFile(
     path.join(pageDir, 'layout.css'),
     [
       '@layer overrides { .layout { display: grid; } }',
-      '@import "./partials/typography.css";'
+      '@import "./partials/typography.css";',
     ].join('\n'),
-    'utf8'
+    'utf8',
   );
   await fs.writeFile(
     path.join(partialsDir, 'colors.css'),
     '@layer overrides { .colors { color: blue; } }',
-    'utf8'
+    'utf8',
   );
   await fs.writeFile(
     path.join(partialsDir, 'typography.css'),
     '@layer overrides { .type { font-weight: 700; } }',
-    'utf8'
+    'utf8',
   );
   return root;
@@ -72,7 +79,11 @@ test('build inlines page-local CSS @import files', async (t) => {
   const workspace = await createWorkspace();
   try {
-    await frontendProvider.build({ workspaceRoot: workspace, env: { WEBSTIR_MODULE_MODE: 'build' }, incremental: false });
+    await frontendProvider.build({
+      workspaceRoot: workspace,
+      env: { WEBSTIR_MODULE_MODE: 'build' },
+      incremental: false,
+    });
     const cssPath = path.join(workspace, 'build', 'frontend', 'pages', 'home', 'index.css');
     assert.equal(fssync.existsSync(cssPath), true, `expected ${cssPath}`);
@@ -80,12 +91,14 @@ test('build inlines page-local CSS @import files', async (t) => {
     assert.equal(
       fssync.existsSync(path.join(workspace, 'build', 'frontend', 'pages', 'home', 'layout.css')),
       true,
-      'expected imported layout.css copied for dev server'
+      'expected imported layout.css copied for dev server',
     );
     assert.equal(
-      fssync.existsSync(path.join(workspace, 'build', 'frontend', 'pages', 'home', 'partials', 'colors.css')),
+      fssync.existsSync(
+        path.join(workspace, 'build', 'frontend', 'pages', 'home', 'partials', 'colors.css'),
+      ),
       true,
-      'expected imported nested css copied for dev server'
+      'expected imported nested css copied for dev server',
     );
     const css = await fs.readFile(cssPath, 'utf8');

package/tests/diagnostics.test.js CHANGED Viewed

@@ -4,45 +4,48 @@ import assert from 'node:assert/strict';
 import { emitDiagnostic, STRUCTURED_DIAGNOSTIC_PREFIX } from '../dist/core/index.js';
 test('emitDiagnostic emits human-readable and structured output', () => {
-    const originalLog = console.log;
-    const originalWarn = console.warn;
-    const logs = [];
-    const warnings = [];
+  const originalLog = console.log;
+  const originalWarn = console.warn;
+  const logs = [];
+  const warnings = [];
-    console.log = (message) => {
-        logs.push(message);
-    };
-    console.warn = (message) => {
-        warnings.push(message);
-    };
+  console.log = (message) => {
+    logs.push(message);
+  };
+  console.warn = (message) => {
+    warnings.push(message);
+  };
-    try {
-        emitDiagnostic({
-            code: 'frontend.test.warning',
-            kind: 'test',
-            stage: 'unit',
-            severity: 'warning',
-            message: 'Sample diagnostic for testing.',
-            data: { flag: true }
-        });
-    } finally {
-        console.log = originalLog;
-        console.warn = originalWarn;
-    }
+  try {
+    emitDiagnostic({
+      code: 'frontend.test.warning',
+      kind: 'test',
+      stage: 'unit',
+      severity: 'warning',
+      message: 'Sample diagnostic for testing.',
+      data: { flag: true },
+    });
+  } finally {
+    console.log = originalLog;
+    console.warn = originalWarn;
+  }
-    assert.equal(warnings.length, 1);
-    assert.match(warnings[0], /\[webstir-frontend]\[frontend\.test\.warning\] Sample diagnostic for testing\./);
+  assert.equal(warnings.length, 1);
+  assert.match(
+    warnings[0],
+    /\[webstir-frontend]\[frontend\.test\.warning\] Sample diagnostic for testing\./,
+  );
-    assert.equal(logs.length, 1);
-    const structuredLine = logs[0];
-    assert.ok(structuredLine.startsWith(STRUCTURED_DIAGNOSTIC_PREFIX));
+  assert.equal(logs.length, 1);
+  const structuredLine = logs[0];
+  assert.ok(structuredLine.startsWith(STRUCTURED_DIAGNOSTIC_PREFIX));
-    const payload = JSON.parse(structuredLine.slice(STRUCTURED_DIAGNOSTIC_PREFIX.length));
-    assert.equal(payload.type, 'diagnostic');
-    assert.equal(payload.code, 'frontend.test.warning');
-    assert.equal(payload.kind, 'test');
-    assert.equal(payload.stage, 'unit');
-    assert.equal(payload.severity, 'warning');
-    assert.equal(payload.message, 'Sample diagnostic for testing.');
-    assert.deepEqual(payload.data, { flag: true });
+  const payload = JSON.parse(structuredLine.slice(STRUCTURED_DIAGNOSTIC_PREFIX.length));
+  assert.equal(payload.type, 'diagnostic');
+  assert.equal(payload.code, 'frontend.test.warning');
+  assert.equal(payload.kind, 'test');
+  assert.equal(payload.stage, 'unit');
+  assert.equal(payload.severity, 'warning');
+  assert.equal(payload.message, 'Sample diagnostic for testing.');
+  assert.deepEqual(payload.data, { flag: true });
 });

package/tests/features.test.js CHANGED Viewed

@@ -7,57 +7,62 @@ import os from 'node:os';
 import { buildConfig } from '../dist/config/workspace.js';
 async function createWorkspace(frontendConfig) {
-    const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'webstir-frontend-'));
-    const workspaceRoot = path.join(tempRoot, 'workspace');
-    const frontendRoot = path.join(workspaceRoot, 'src', 'frontend');
-    await fs.mkdir(frontendRoot, { recursive: true });
-    if (frontendConfig !== undefined) {
-        const configPath = path.join(frontendRoot, 'frontend.config.json');
-        await fs.writeFile(configPath, JSON.stringify(frontendConfig, null, 2), 'utf8');
-    }
-    return {
-        workspaceRoot,
-        cleanup: () => fs.rm(tempRoot, { recursive: true, force: true })
-    };
+  const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'webstir-frontend-'));
+  const workspaceRoot = path.join(tempRoot, 'workspace');
+  const frontendRoot = path.join(workspaceRoot, 'src', 'frontend');
+  await fs.mkdir(frontendRoot, { recursive: true });
+  if (frontendConfig !== undefined) {
+    const configPath = path.join(frontendRoot, 'frontend.config.json');
+    await fs.writeFile(configPath, JSON.stringify(frontendConfig, null, 2), 'utf8');
+  }
+  return {
+    workspaceRoot,
+    cleanup: () => fs.rm(tempRoot, { recursive: true, force: true }),
+  };
 }
 test('buildConfig returns defaults when frontend.config.json is absent', async (t) => {
-    const workspace = await createWorkspace();
-    t.after(workspace.cleanup);
+  const workspace = await createWorkspace();
+  t.after(workspace.cleanup);
-    const config = buildConfig(workspace.workspaceRoot);
-    assert.equal(config.features.htmlSecurity, true);
-    assert.equal(config.features.imageOptimization, true);
-    assert.equal(config.features.precompression, true);
+  const config = buildConfig(workspace.workspaceRoot);
+  assert.equal(config.features.htmlSecurity, true);
+  assert.equal(config.features.externalResourceIntegrity, false);
+  assert.equal(config.features.imageOptimization, true);
+  assert.equal(config.features.precompression, true);
 });
 test('buildConfig applies overrides from nested features key', async (t) => {
-    const workspace = await createWorkspace({
-        features: {
-            htmlSecurity: false,
-            precompression: false
-        }
-    });
-    t.after(workspace.cleanup);
-    const config = buildConfig(workspace.workspaceRoot);
-    assert.equal(config.features.htmlSecurity, false);
-    assert.equal(config.features.precompression, false);
-    assert.equal(config.features.imageOptimization, true);
+  const workspace = await createWorkspace({
+    features: {
+      htmlSecurity: false,
+      externalResourceIntegrity: true,
+      precompression: false,
+    },
+  });
+  t.after(workspace.cleanup);
+  const config = buildConfig(workspace.workspaceRoot);
+  assert.equal(config.features.htmlSecurity, false);
+  assert.equal(config.features.externalResourceIntegrity, true);
+  assert.equal(config.features.precompression, false);
+  assert.equal(config.features.imageOptimization, true);
 });
 test('buildConfig accepts top-level feature flags', async (t) => {
-    const workspace = await createWorkspace({
-        htmlSecurity: false,
-        imageOptimization: false,
-        precompression: true
-    });
-    t.after(workspace.cleanup);
-    const config = buildConfig(workspace.workspaceRoot);
-    assert.equal(config.features.htmlSecurity, false);
-    assert.equal(config.features.imageOptimization, false);
-    assert.equal(config.features.precompression, true);
+  const workspace = await createWorkspace({
+    htmlSecurity: false,
+    externalResourceIntegrity: true,
+    imageOptimization: false,
+    precompression: true,
+  });
+  t.after(workspace.cleanup);
+  const config = buildConfig(workspace.workspaceRoot);
+  assert.equal(config.features.htmlSecurity, false);
+  assert.equal(config.features.externalResourceIntegrity, true);
+  assert.equal(config.features.imageOptimization, false);
+  assert.equal(config.features.precompression, true);
 });

package/tests/hooks.test.js CHANGED Viewed

@@ -9,63 +9,79 @@ async function loadRunBuildOrSkip(t) {
     const mod = await import('../dist/operations.js');
     return mod.runBuild;
   } catch (err) {
-    console.warn('[frontend-tests] Skipping hooks test: optional dependency unavailable:', err?.message ?? err);
+    console.warn(
+      '[frontend-tests] Skipping hooks test: optional dependency unavailable:',
+      err?.message ?? err,
+    );
     t?.diagnostic?.('skip: missing optional dependency');
     return null;
   }
 }
 async function createWorkspaceWithHooks() {
-    const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'webstir-hooks-'));
-    const workspaceRoot = path.join(tempRoot, 'workspace');
-    const appDir = path.join(workspaceRoot, 'src', 'frontend', 'app');
-    const pageDir = path.join(workspaceRoot, 'src', 'frontend', 'pages', 'home');
+  const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'webstir-hooks-'));
+  const workspaceRoot = path.join(tempRoot, 'workspace');
+  const appDir = path.join(workspaceRoot, 'src', 'frontend', 'app');
+  const pageDir = path.join(workspaceRoot, 'src', 'frontend', 'pages', 'home');
-    await fs.mkdir(appDir, { recursive: true });
-    await fs.mkdir(pageDir, { recursive: true });
+  await fs.mkdir(appDir, { recursive: true });
+  await fs.mkdir(pageDir, { recursive: true });
-    await fs.writeFile(path.join(appDir, 'app.html'), '<!DOCTYPE html><html><head></head><body><main></main></body></html>', 'utf8');
-    await fs.writeFile(path.join(pageDir, 'index.html'), '<head></head><main><section>Home</section></main>', 'utf8');
-    await fs.writeFile(path.join(pageDir, 'index.ts'), 'console.log("home");', 'utf8');
-    await fs.writeFile(path.join(pageDir, 'index.css'), 'body { color: blue; }', 'utf8');
+  await fs.writeFile(
+    path.join(appDir, 'app.html'),
+    '<!DOCTYPE html><html><head></head><body><main></main></body></html>',
+    'utf8',
+  );
+  await fs.writeFile(
+    path.join(pageDir, 'index.html'),
+    '<head></head><main><section>Home</section></main>',
+    'utf8',
+  );
+  await fs.writeFile(path.join(pageDir, 'index.ts'), 'console.log("home");', 'utf8');
+  await fs.writeFile(path.join(pageDir, 'index.css'), 'body { color: blue; }', 'utf8');
-    const packageJson = {
-        name: 'webstir-hooks-fixture',
-        version: '0.0.0',
-        private: true,
-        type: 'module'
-    };
-    await fs.writeFile(path.join(workspaceRoot, 'package.json'), JSON.stringify(packageJson, null, 2), 'utf8');
+  const packageJson = {
+    name: 'webstir-hooks-fixture',
+    version: '0.0.0',
+    private: true,
+    type: 'module',
+  };
+  await fs.writeFile(
+    path.join(workspaceRoot, 'package.json'),
+    JSON.stringify(packageJson, null, 2),
+    'utf8',
+  );
-    const hookConfig = `import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nasync function record(event, context) {\n  const logPath = path.join(context.workspaceRoot, 'hook-log.json');\n  const payload = JSON.stringify({ event, mode: context.mode, builder: context.builderName ?? null });\n  await fs.appendFile(logPath, payload + '\\n', 'utf8');\n}\n\nexport default {\n  hooks: {\n    pipeline: {\n      beforeAll: (context) => record('pipeline-before', context),\n      afterAll: (context) => record('pipeline-after', context)\n    },\n    builders: {\n      javascript: {\n        before: (context) => record('javascript-before', context),\n        after: (context) => record('javascript-after', context)\n      }\n    }\n  }\n};\n`;
-    await fs.writeFile(path.join(workspaceRoot, 'webstir.config.js'), hookConfig, 'utf8');
+  const hookConfig = `import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nasync function record(event, context) {\n  const logPath = path.join(context.workspaceRoot, 'hook-log.json');\n  const payload = JSON.stringify({ event, mode: context.mode, builder: context.builderName ?? null });\n  await fs.appendFile(logPath, payload + '\\n', 'utf8');\n}\n\nexport default {\n  hooks: {\n    pipeline: {\n      beforeAll: (context) => record('pipeline-before', context),\n      afterAll: (context) => record('pipeline-after', context)\n    },\n    builders: {\n      javascript: {\n        before: (context) => record('javascript-before', context),\n        after: (context) => record('javascript-after', context)\n      }\n    }\n  }\n};\n`;
+  await fs.writeFile(path.join(workspaceRoot, 'webstir.config.js'), hookConfig, 'utf8');
-    return {
-        workspaceRoot,
-        cleanup: () => fs.rm(tempRoot, { recursive: true, force: true })
-    };
+  return {
+    workspaceRoot,
+    cleanup: () => fs.rm(tempRoot, { recursive: true, force: true }),
+  };
 }
 test('pipeline hooks execute in order', async (t) => {
-    const runBuild = await loadRunBuildOrSkip(t);
-    if (!runBuild) return; // skip
-    const workspace = await createWorkspaceWithHooks();
-    t.after(workspace.cleanup);
+  const runBuild = await loadRunBuildOrSkip(t);
+  if (!runBuild) return; // skip
+  const workspace = await createWorkspaceWithHooks();
+  t.after(workspace.cleanup);
-    await runBuild({ workspaceRoot: workspace.workspaceRoot });
+  await runBuild({ workspaceRoot: workspace.workspaceRoot });
-    const logPath = path.join(workspace.workspaceRoot, 'hook-log.json');
-    const raw = await fs.readFile(logPath, 'utf8');
-    const entries = raw.trim().split('\n').map((line) => JSON.parse(line));
+  const logPath = path.join(workspace.workspaceRoot, 'hook-log.json');
+  const raw = await fs.readFile(logPath, 'utf8');
+  const entries = raw
+    .trim()
+    .split('\n')
+    .map((line) => JSON.parse(line));
-    assert.equal(entries.length, 4);
-    assert.deepEqual(entries.map((entry) => entry.event), [
-        'pipeline-before',
-        'javascript-before',
-        'javascript-after',
-        'pipeline-after'
-    ]);
-    assert(entries.every((entry) => entry.mode === 'build'));
-    assert.equal(entries[1].builder, 'javascript');
-    assert.equal(entries[2].builder, 'javascript');
+  assert.equal(entries.length, 4);
+  assert.deepEqual(
+    entries.map((entry) => entry.event),
+    ['pipeline-before', 'javascript-before', 'javascript-after', 'pipeline-after'],
+  );
+  assert(entries.every((entry) => entry.mode === 'build'));
+  assert.equal(entries[1].builder, 'javascript');
+  assert.equal(entries[2].builder, 'javascript');
 });