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

@webstir-io/webstir-frontend 0.1.40

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 (167) hide show

package/LICENSE +21 -0
package/README.md +158 -0
package/dist/assets/assetManifest.d.ts +16 -0
package/dist/assets/assetManifest.js +31 -0
package/dist/assets/imageOptimizer.d.ts +6 -0
package/dist/assets/imageOptimizer.js +93 -0
package/dist/assets/precompression.d.ts +1 -0
package/dist/assets/precompression.js +21 -0
package/dist/builders/contentBuilder.d.ts +2 -0
package/dist/builders/contentBuilder.js +1052 -0
package/dist/builders/cssBuilder.d.ts +2 -0
package/dist/builders/cssBuilder.js +439 -0
package/dist/builders/htmlBuilder.d.ts +2 -0
package/dist/builders/htmlBuilder.js +430 -0
package/dist/builders/index.d.ts +2 -0
package/dist/builders/index.js +14 -0
package/dist/builders/jsBuilder.d.ts +2 -0
package/dist/builders/jsBuilder.js +300 -0
package/dist/builders/staticAssetsBuilder.d.ts +2 -0
package/dist/builders/staticAssetsBuilder.js +158 -0
package/dist/builders/types.d.ts +12 -0
package/dist/builders/types.js +1 -0
package/dist/cli.d.ts +2 -0
package/dist/cli.js +105 -0
package/dist/config/manifest.d.ts +7 -0
package/dist/config/manifest.js +17 -0
package/dist/config/paths.d.ts +3 -0
package/dist/config/paths.js +11 -0
package/dist/config/schema.d.ts +413 -0
package/dist/config/schema.js +44 -0
package/dist/config/setup.d.ts +2 -0
package/dist/config/setup.js +12 -0
package/dist/config/workspace.d.ts +2 -0
package/dist/config/workspace.js +131 -0
package/dist/config/workspaceManifest.d.ts +23 -0
package/dist/config/workspaceManifest.js +1 -0
package/dist/core/constants.d.ts +70 -0
package/dist/core/constants.js +70 -0
package/dist/core/diagnostics.d.ts +15 -0
package/dist/core/diagnostics.js +21 -0
package/dist/core/index.d.ts +3 -0
package/dist/core/index.js +3 -0
package/dist/core/pages.d.ts +6 -0
package/dist/core/pages.js +23 -0
package/dist/hooks.d.ts +19 -0
package/dist/hooks.js +115 -0
package/dist/html/criticalCss.d.ts +4 -0
package/dist/html/criticalCss.js +192 -0
package/dist/html/htmlSecurity.d.ts +5 -0
package/dist/html/htmlSecurity.js +73 -0
package/dist/html/lazyLoad.d.ts +6 -0
package/dist/html/lazyLoad.js +21 -0
package/dist/html/pageScaffold.d.ts +10 -0
package/dist/html/pageScaffold.js +51 -0
package/dist/html/resourceHints.d.ts +7 -0
package/dist/html/resourceHints.js +64 -0
package/dist/index.d.ts +5 -0
package/dist/index.js +5 -0
package/dist/modes/ssg/index.d.ts +4 -0
package/dist/modes/ssg/index.js +4 -0
package/dist/modes/ssg/metadata.d.ts +5 -0
package/dist/modes/ssg/metadata.js +50 -0
package/dist/modes/ssg/routing.d.ts +2 -0
package/dist/modes/ssg/routing.js +186 -0
package/dist/modes/ssg/seo.d.ts +4 -0
package/dist/modes/ssg/seo.js +208 -0
package/dist/modes/ssg/validation.d.ts +3 -0
package/dist/modes/ssg/validation.js +27 -0
package/dist/modes/ssg/views.d.ts +2 -0
package/dist/modes/ssg/views.js +236 -0
package/dist/operations.d.ts +5 -0
package/dist/operations.js +102 -0
package/dist/pipeline.d.ts +7 -0
package/dist/pipeline.js +71 -0
package/dist/provider.d.ts +2 -0
package/dist/provider.js +176 -0
package/dist/types.d.ts +61 -0
package/dist/types.js +1 -0
package/dist/utils/changedFile.d.ts +8 -0
package/dist/utils/changedFile.js +26 -0
package/dist/utils/fs.d.ts +11 -0
package/dist/utils/fs.js +39 -0
package/dist/utils/hash.d.ts +1 -0
package/dist/utils/hash.js +5 -0
package/dist/utils/pagePaths.d.ts +5 -0
package/dist/utils/pagePaths.js +36 -0
package/dist/utils/pathMatch.d.ts +3 -0
package/dist/utils/pathMatch.js +29 -0
package/dist/watch/frontendFiles.d.ts +3 -0
package/dist/watch/frontendFiles.js +25 -0
package/dist/watch/hotUpdateTracker.d.ts +51 -0
package/dist/watch/hotUpdateTracker.js +205 -0
package/dist/watch/pipelineHelpers.d.ts +26 -0
package/dist/watch/pipelineHelpers.js +177 -0
package/dist/watch/types.d.ts +27 -0
package/dist/watch/types.js +1 -0
package/dist/watch/watchCoordinator.d.ts +36 -0
package/dist/watch/watchCoordinator.js +551 -0
package/dist/watch/watchDaemon.d.ts +17 -0
package/dist/watch/watchDaemon.js +127 -0
package/dist/watch/watchReporter.d.ts +21 -0
package/dist/watch/watchReporter.js +64 -0
package/package.json +92 -0
package/scripts/publish.sh +101 -0
package/scripts/smoke.mjs +35 -0
package/scripts/update-contract.sh +121 -0
package/src/assets/assetManifest.ts +51 -0
package/src/assets/imageOptimizer.ts +112 -0
package/src/assets/precompression.ts +25 -0
package/src/builders/contentBuilder.ts +1400 -0
package/src/builders/cssBuilder.ts +552 -0
package/src/builders/htmlBuilder.ts +540 -0
package/src/builders/index.ts +16 -0
package/src/builders/jsBuilder.ts +358 -0
package/src/builders/staticAssetsBuilder.ts +174 -0
package/src/builders/types.ts +15 -0
package/src/cli.ts +108 -0
package/src/config/manifest.ts +24 -0
package/src/config/paths.ts +14 -0
package/src/config/schema.ts +49 -0
package/src/config/setup.ts +14 -0
package/src/config/workspace.ts +150 -0
package/src/config/workspaceManifest.ts +27 -0
package/src/core/constants.ts +73 -0
package/src/core/diagnostics.ts +40 -0
package/src/core/index.ts +3 -0
package/src/core/pages.ts +31 -0
package/src/hooks.ts +175 -0
package/src/html/criticalCss.ts +214 -0
package/src/html/htmlSecurity.ts +86 -0
package/src/html/lazyLoad.ts +30 -0
package/src/html/pageScaffold.ts +70 -0
package/src/html/resourceHints.ts +91 -0
package/src/index.ts +5 -0
package/src/modes/ssg/index.ts +4 -0
package/src/modes/ssg/metadata.ts +63 -0
package/src/modes/ssg/routing.ts +230 -0
package/src/modes/ssg/seo.ts +261 -0
package/src/modes/ssg/validation.ts +37 -0
package/src/modes/ssg/views.ts +309 -0
package/src/operations.ts +138 -0
package/src/pipeline.ts +88 -0
package/src/provider.ts +249 -0
package/src/types.ts +67 -0
package/src/utils/changedFile.ts +39 -0
package/src/utils/fs.ts +48 -0
package/src/utils/hash.ts +6 -0
package/src/utils/pagePaths.ts +43 -0
package/src/utils/pathMatch.ts +36 -0
package/src/watch/frontendFiles.ts +32 -0
package/src/watch/hotUpdateTracker.ts +285 -0
package/src/watch/pipelineHelpers.ts +242 -0
package/src/watch/types.ts +23 -0
package/src/watch/watchCoordinator.ts +666 -0
package/src/watch/watchDaemon.ts +144 -0
package/src/watch/watchReporter.ts +98 -0
package/tests/add-page-defaults.test.js +64 -0
package/tests/content-pages.test.js +81 -0
package/tests/css-app-imports.test.js +64 -0
package/tests/css-page-imports.test.js +100 -0
package/tests/diagnostics.test.js +48 -0
package/tests/features.test.js +63 -0
package/tests/hooks.test.js +71 -0
package/tests/provider.integration.test.js +137 -0
package/tests/ssg-defaults.test.js +201 -0
package/tests/ssg-guardrails.test.js +69 -0
package/tsconfig.json +27 -0

package/tests/hooks.test.js ADDED Viewed

@@ -0,0 +1,71 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+async function loadRunBuildOrSkip(t) {
+  try {
+    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);
+    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');
+    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');
+    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');
+    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);
+    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));
+    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');
+});

package/tests/provider.integration.test.js ADDED Viewed

@@ -0,0 +1,137 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import fssync from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+async function loadProviderOrSkip(t) {
+  try {
+    const mod = await import('../dist/index.js');
+    return mod.frontendProvider;
+  } catch (err) {
+    // Likely due to optional native deps like sharp; skip gracefully.
+    console.warn('[frontend-tests] Skipping provider integration: optional dependency unavailable:', err?.message ?? err);
+    t?.diagnostic?.('skip: missing optional dependency');
+    return null;
+  }
+}
+async function createWorkspace() {
+  const root = await fs.mkdtemp(path.join(os.tmpdir(), 'webstir-frontend-workspace-'));
+  const appDir = path.join(root, 'src', 'frontend', 'app');
+  const pageDir = path.join(root, 'src', 'frontend', 'pages', 'home');
+  await fs.mkdir(appDir, { recursive: true });
+  await fs.mkdir(pageDir, { recursive: true });
+  // Minimal app template and page fragment
+  await fs.writeFile(path.join(appDir, 'app.html'), '<!DOCTYPE html><html><head><title>App</title></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');
+  return root;
+}
+async function createWorkspaceWithClientNav() {
+  const root = await fs.mkdtemp(path.join(os.tmpdir(), 'webstir-frontend-workspace-'));
+  const appDir = path.join(root, 'src', 'frontend', 'app');
+  const featureDir = path.join(appDir, 'scripts', 'features');
+  const pageDir = path.join(root, 'src', 'frontend', 'pages', 'home');
+  await fs.mkdir(appDir, { recursive: true });
+  await fs.mkdir(featureDir, { recursive: true });
+  await fs.mkdir(pageDir, { recursive: true });
+  const pkg = {
+    name: 'webstir-project',
+    version: '1.0.0',
+    webstir: {
+      mode: 'ssg',
+      enable: {
+        clientNav: true
+      }
+    }
+  };
+  await fs.writeFile(path.join(root, 'package.json'), JSON.stringify(pkg, null, 2), 'utf8');
+  await fs.writeFile(path.join(appDir, 'app.html'), '<!DOCTYPE html><html><head><title>App</title></head><body><main></main></body></html>', 'utf8');
+  await fs.writeFile(path.join(appDir, 'app.ts'), 'import "./scripts/features/client-nav.js";', 'utf8');
+  await fs.writeFile(path.join(featureDir, 'client-nav.ts'), 'export {};', 'utf8');
+  await fs.writeFile(path.join(pageDir, 'index.html'), '<head></head><main><section>Home</section></main>', 'utf8');
+  return root;
+}
+test('frontend provider build emits JS bundle and manifest entry', async (t) => {
+  const frontendProvider = await loadProviderOrSkip(t);
+  if (!frontendProvider) return; // skip
+  const workspace = await createWorkspace();
+  const result = await frontendProvider.build({
+    workspaceRoot: workspace,
+    env: { WEBSTIR_MODULE_MODE: 'build' },
+    incremental: false,
+  });
+  const jsOut = path.join(workspace, 'build', 'frontend', 'pages', 'home', 'index.js');
+  assert.equal(fssync.existsSync(jsOut), true, 'expected build/frontend/pages/home/index.js');
+  assert.ok(Array.isArray(result.manifest.entryPoints));
+  assert.ok(result.manifest.entryPoints.some((e) => e.endsWith('pages/home/index.js')));
+});
+test('frontend provider publish produces dist assets and preserves entry in manifest', async (t) => {
+  const frontendProvider = await loadProviderOrSkip(t);
+  if (!frontendProvider) return; // skip
+  const workspace = await createWorkspace();
+  // Run build first so manifest has entries from build/frontend
+  await frontendProvider.build({ workspaceRoot: workspace, env: { WEBSTIR_MODULE_MODE: 'build' }, incremental: false });
+  const publishResult = await frontendProvider.build({ workspaceRoot: workspace, env: { WEBSTIR_MODULE_MODE: 'publish' }, incremental: false });
+  // Dist should contain a hashed JS file
+  const distPageDir = path.join(workspace, 'dist', 'frontend', 'pages', 'home');
+  const files = fssync.existsSync(distPageDir) ? fssync.readdirSync(distPageDir) : [];
+  assert.ok(files.some((f) => f.startsWith('index-') && f.endsWith('.js')));
+  // Manifest still reflects build/frontend entry points by design
+  assert.ok(publishResult.manifest.entryPoints.some((e) => e.endsWith('pages/home/index.js')));
+});
+test('enable.clientNav uses feature module (no legacy helper injection)', async (t) => {
+  const frontendProvider = await loadProviderOrSkip(t);
+  if (!frontendProvider) return; // skip
+  const workspace = await createWorkspaceWithClientNav();
+  await frontendProvider.build({ workspaceRoot: workspace, env: { WEBSTIR_MODULE_MODE: 'build' }, incremental: false });
+  await frontendProvider.build({ workspaceRoot: workspace, env: { WEBSTIR_MODULE_MODE: 'publish' }, incremental: false });
+  const distClientNav = path.join(workspace, 'dist', 'frontend', 'clientNav.js');
+  assert.equal(fssync.existsSync(distClientNav), false, 'did not expect dist/frontend/clientNav.js');
+  const distHtml = await fs.readFile(path.join(workspace, 'dist', 'frontend', 'index.html'), 'utf8');
+  assert.ok(!distHtml.includes('clientNav.js'), 'did not expect client-nav script injected');
+  assert.ok(!distHtml.includes('index.js'), 'should not inject page index.js when none exists');
+});
+test('enable.clientNav without feature module fails fast', async (t) => {
+  const frontendProvider = await loadProviderOrSkip(t);
+  if (!frontendProvider) return; // skip
+  const workspace = await createWorkspace();
+  const pkg = {
+    name: 'webstir-project',
+    version: '1.0.0',
+    webstir: {
+      mode: 'ssg',
+      enable: {
+        clientNav: true
+      }
+    }
+  };
+  await fs.writeFile(path.join(workspace, 'package.json'), JSON.stringify(pkg, null, 2), 'utf8');
+  await assert.rejects(
+    () => frontendProvider.build({ workspaceRoot: workspace, env: { WEBSTIR_MODULE_MODE: 'build' }, incremental: false }),
+    /Enabled feature module\(s\) missing: client-nav/
+  );
+});

package/tests/ssg-defaults.test.js ADDED Viewed

@@ -0,0 +1,201 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import fssync from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { applySsgRouting, generateSsgViewData } from '../dist/modes/ssg/index.js';
+async function createWorkspace() {
+    const root = await fs.mkdtemp(path.join(os.tmpdir(), 'webstir-frontend-ssg-defaults-'));
+    const distFrontend = path.join(root, 'dist', 'frontend');
+    const distPages = path.join(distFrontend, 'pages');
+    await fs.mkdir(path.join(distPages, 'home'), { recursive: true });
+    await fs.mkdir(path.join(distPages, 'about'), { recursive: true });
+    await fs.writeFile(path.join(distPages, 'home', 'index.html'), '<!doctype html><main>home</main>', 'utf8');
+    await fs.writeFile(path.join(distPages, 'about', 'index.html'), '<!doctype html><main>about</main>', 'utf8');
+    const pkg = {
+        name: 'webstir-project',
+        version: '1.0.0',
+        webstir: {
+            mode: 'ssg',
+            moduleManifest: {
+                views: [
+                    {
+                        name: 'AboutView',
+                        path: '/about',
+                        staticPaths: ['/about', '/about/team']
+                    }
+                ]
+            }
+        }
+    };
+    await fs.writeFile(path.join(root, 'package.json'), JSON.stringify(pkg, null, 2), 'utf8');
+    return root;
+}
+test('ssg workspace defaults views to renderMode=ssg when omitted', async () => {
+    const workspace = await createWorkspace();
+    const distFrontend = path.join(workspace, 'dist', 'frontend');
+    const distPages = path.join(distFrontend, 'pages');
+    try {
+        await applySsgRouting({
+            version: 1,
+            paths: {
+                workspace,
+                dist: {
+                    root: path.join(workspace, 'dist'),
+                    frontend: distFrontend,
+                    app: path.join(distFrontend, 'app'),
+                    pages: distPages,
+                    content: path.join(distPages, 'docs'),
+                    images: path.join(distFrontend, 'images'),
+                    fonts: path.join(distFrontend, 'fonts'),
+                    media: path.join(distFrontend, 'media')
+                },
+                build: {
+                    root: path.join(workspace, 'build'),
+                    frontend: path.join(workspace, 'build', 'frontend'),
+                    app: path.join(workspace, 'build', 'frontend', 'app'),
+                    pages: path.join(workspace, 'build', 'frontend', 'pages'),
+                    content: path.join(workspace, 'build', 'frontend', 'pages', 'docs'),
+                    images: path.join(workspace, 'build', 'frontend', 'images'),
+                    fonts: path.join(workspace, 'build', 'frontend', 'fonts'),
+                    media: path.join(workspace, 'build', 'frontend', 'media')
+                },
+                src: {
+                    root: path.join(workspace, 'src'),
+                    frontend: path.join(workspace, 'src', 'frontend'),
+                    app: path.join(workspace, 'src', 'frontend', 'app'),
+                    pages: path.join(workspace, 'src', 'frontend', 'pages'),
+                    content: path.join(workspace, 'src', 'frontend', 'content'),
+                    images: path.join(workspace, 'src', 'frontend', 'images'),
+                    fonts: path.join(workspace, 'src', 'frontend', 'fonts'),
+                    media: path.join(workspace, 'src', 'frontend', 'media')
+                }
+            },
+            features: {
+                htmlSecurity: true,
+                imageOptimization: true,
+                precompression: true
+            }
+        });
+        const nestedAlias = path.join(distFrontend, 'about', 'team', 'index.html');
+        assert.equal(fssync.existsSync(nestedAlias), true, `expected nested alias at ${nestedAlias}`);
+    } finally {
+        await fs.rm(workspace, { recursive: true, force: true });
+    }
+});
+test('ssg workspace defaults staticPaths to [path] for view data', async () => {
+    const workspace = await fs.mkdtemp(path.join(os.tmpdir(), 'webstir-frontend-ssg-default-paths-'));
+    const distFrontend = path.join(workspace, 'dist', 'frontend');
+    const distPages = path.join(distFrontend, 'pages');
+    const buildBackend = path.join(workspace, 'build', 'backend');
+    await fs.mkdir(path.join(distPages, 'about'), { recursive: true });
+    await fs.writeFile(path.join(distPages, 'about', 'index.html'), '<!doctype html><main>about</main>', 'utf8');
+    await fs.mkdir(buildBackend, { recursive: true });
+    await fs.writeFile(
+        path.join(buildBackend, 'module.mjs'),
+        [
+            "export const module = {",
+            "  views: [",
+            "    {",
+            "      definition: { name: 'AboutView', path: '/about' },",
+            "      load: async () => ({ title: 'about' })",
+            "    }",
+            "  ]",
+            "};"
+        ].join('\n'),
+        'utf8'
+    );
+    await fs.writeFile(
+        path.join(workspace, 'package.json'),
+        JSON.stringify(
+            {
+                name: 'webstir-project',
+                version: '1.0.0',
+                webstir: {
+                    mode: 'ssg',
+                    moduleManifest: {
+                        views: [
+                            {
+                                name: 'AboutView',
+                                path: '/about'
+                            }
+                        ]
+                    }
+                }
+            },
+            null,
+            2
+        ),
+        'utf8'
+    );
+    const config = {
+        version: 1,
+        paths: {
+            workspace,
+            dist: {
+                root: path.join(workspace, 'dist'),
+                frontend: distFrontend,
+                app: path.join(distFrontend, 'app'),
+                pages: distPages,
+                content: path.join(distPages, 'docs'),
+                images: path.join(distFrontend, 'images'),
+                fonts: path.join(distFrontend, 'fonts'),
+                media: path.join(distFrontend, 'media')
+            },
+            build: {
+                root: path.join(workspace, 'build'),
+                frontend: path.join(workspace, 'build', 'frontend'),
+                app: path.join(workspace, 'build', 'frontend', 'app'),
+                pages: path.join(workspace, 'build', 'frontend', 'pages'),
+                content: path.join(workspace, 'build', 'frontend', 'pages', 'docs'),
+                images: path.join(workspace, 'build', 'frontend', 'images'),
+                fonts: path.join(workspace, 'build', 'frontend', 'fonts'),
+                media: path.join(workspace, 'build', 'frontend', 'media')
+            },
+            src: {
+                root: path.join(workspace, 'src'),
+                frontend: path.join(workspace, 'src', 'frontend'),
+                app: path.join(workspace, 'src', 'frontend', 'app'),
+                pages: path.join(workspace, 'src', 'frontend', 'pages'),
+                content: path.join(workspace, 'src', 'frontend', 'content'),
+                images: path.join(workspace, 'src', 'frontend', 'images'),
+                fonts: path.join(workspace, 'src', 'frontend', 'fonts'),
+                media: path.join(workspace, 'src', 'frontend', 'media')
+            }
+        },
+        features: {
+            htmlSecurity: true,
+            imageOptimization: true,
+            precompression: true
+        }
+    };
+    try {
+        await generateSsgViewData(config);
+        const dataPath = path.join(distPages, 'about', 'view-data.json');
+        assert.equal(fssync.existsSync(dataPath), true, `expected view data at ${dataPath}`);
+        const raw = await fs.readFile(dataPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        assert.equal(Array.isArray(parsed), true);
+        assert.equal(parsed[0]?.path, '/about');
+        assert.deepEqual(parsed[0]?.data, { title: 'about' });
+    } finally {
+        await fs.rm(workspace, { recursive: true, force: true });
+    }
+});

package/tests/ssg-guardrails.test.js ADDED Viewed

@@ -0,0 +1,69 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { runPublish } from '../dist/index.js';
+async function createWorkspace(pkg) {
+    const root = await fs.mkdtemp(path.join(os.tmpdir(), 'webstir-frontend-ssg-guard-'));
+    await fs.writeFile(path.join(root, 'package.json'), JSON.stringify(pkg, null, 2), 'utf8');
+    return root;
+}
+test('ssg publish rejects route-level renderMode/staticPaths/ssg metadata', async () => {
+    const workspace = await createWorkspace({
+        name: 'webstir-project',
+        version: '1.0.0',
+        webstir: {
+            moduleManifest: {
+                routes: [
+                    {
+                        name: 'ApiRoute',
+                        method: 'GET',
+                        path: '/api/route',
+                        renderMode: 'ssg'
+                    }
+                ]
+            }
+        }
+    });
+    try {
+        await assert.rejects(
+            runPublish({ workspaceRoot: workspace, publishMode: 'ssg' }),
+            /SSG publish expects SSG metadata under `webstir\.moduleManifest\.views`/i
+        );
+    } finally {
+        await fs.rm(workspace, { recursive: true, force: true });
+    }
+});
+test('ssg publish rejects route-level staticPaths without renderMode', async () => {
+    const workspace = await createWorkspace({
+        name: 'webstir-project',
+        version: '1.0.0',
+        webstir: {
+            moduleManifest: {
+                routes: [
+                    {
+                        name: 'ApiRoute',
+                        method: 'GET',
+                        path: '/api/route',
+                        staticPaths: ['/']
+                    }
+                ]
+            }
+        }
+    });
+    try {
+        await assert.rejects(
+            runPublish({ workspaceRoot: workspace, publishMode: 'ssg' }),
+            /SSG publish expects SSG metadata under `webstir\.moduleManifest\.views`/i
+        );
+    } finally {
+        await fs.rm(workspace, { recursive: true, force: true });
+    }
+});

package/tsconfig.json ADDED Viewed

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "declarationMap": false,
+    "sourceMap": false,
+    "types": [
+      "node"
+    ],
+    "resolveJsonModule": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "dist",
+    "node_modules"
+  ]
+}