@rm-industries/create-forge 0.4.0-beta.5 → 0.4.0-beta.6

package/dist/template/.lighthouserc.json

@@ -1,12 +1,9 @@
 {
   "ci": {
     "collect": {
-      "staticDistDir": "./dist",
-      "url": [
-        "http://localhost/",
-        "http://localhost/articles/",
-        "http://localhost/articles/designing-a-calm-starting-point/"
-      ],
+      "startServerCommand": "npm run preview -- --host 127.0.0.1",
+      "startServerReadyPattern": "Local",
+      "startServerReadyTimeout": 30000,
       "numberOfRuns": 3
     },
     "assert": {

package/dist/template/README.md

@@ -69,7 +69,8 @@ the complete Playwright and axe suite, and Lighthouse budgets in that order.
 Each stage is joined with `&&`, so the command stops immediately and returns a
 non-zero status when any stage fails. Browser tests and Lighthouse start from
 their own production build so they remain independently runnable and cannot
-accidentally inspect stale output.
+accidentally inspect stale output. Both use Astro's preview server and derive
+any deployment base path from the configured canonical site URL.
 
 The complete command is intentionally high cost. Use `npm run quality:static`
 for the quickest source-only feedback or `npm run quality:core` for every check
@@ -147,10 +148,12 @@ alternative-text quality.
 
 Lighthouse CI runs three times each against the production home, article
 listing, and article detail pages, then enforces median category scores and
-transfer budgets. The measured baseline, headroom, exclusions, and update rules
-are documented in `docs/performance-budget.md`. Reports are written to the
-generated `.lighthouseci/` directory; CI retains them for seven days even when
-an assertion fails.
+transfer budgets. Its typed runner prefixes those routes with a configured
+project path, so local checks exercise GitHub Pages project sites with the same
+asset URLs used in production. The measured baseline, headroom, exclusions, and
+update rules are documented in `docs/performance-budget.md`. Reports are written
+to the generated `.lighthouseci/` directory; CI retains them for seven days even
+when an assertion fails.
 
 The configured exclusions cover only generated output, dependency directories,
 and tool artifacts. Stylelint's exceptions recognize Tailwind and DaisyUI

package/dist/template/docs/performance-budget.md

@@ -3,7 +3,10 @@
 Lighthouse CI protects the generated site's public-page baseline. Run
 `npm run lighthouse:ci` after changes that can affect rendering, assets,
 metadata, or client behavior. The command builds the production site, collects
-three reports per route, and evaluates the median result.
+three reports per route from Astro's preview server, and evaluates the median
+result. The typed runner derives Astro's optional deployment base from
+`src/config/site.ts`, ensuring project-path assets and routes are measured at
+their production-relative locations.
 
 ## Enforced routes
 

package/dist/template/package-lock.json

@@ -9235,9 +9235,9 @@
       }
     },
     "node_modules/fast-uri": {
-      "version": "3.1.5",
-      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.5.tgz",
-      "integrity": "sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==",
+      "version": "3.1.7",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.7.tgz",
+      "integrity": "sha512-dOvZVzjdZdz7phd9v6jCbwxrBW3fK6n8Rc0CtdmM4bumzMnxywBYhuph6J819RRw/ku+rLbelwfMunktuzVVHg==",
       "dev": true,
       "funding": [
         {

package/dist/template/package.json

@@ -21,7 +21,8 @@
     "lint:css:fix": "stylelint --fix \"**/*.css\" --ignore-path .gitignore",
     "lint:markdown": "markdownlint \"**/*.md\" --ignore-path .gitignore",
     "lint:markdown:fix": "markdownlint --fix \"**/*.md\" --ignore-path .gitignore",
-    "lighthouse:ci": "npm run build && lhci autorun",
+    "lighthouse:autorun": "lhci autorun",
+    "lighthouse:ci": "npm run build && node scripts/run-lighthouse.ts",
     "spellcheck": "cspell \"**\"",
     "typecheck": "astro sync && tsc --noEmit",
     "test": "npm run test:unit",

package/dist/template/scripts/run-lighthouse.test.ts

@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest';
+
+import { getLighthouseUrls } from './run-lighthouse';
+
+describe('getLighthouseUrls', () => {
+  it('audits root deployments from the preview origin', () => {
+    expect(getLighthouseUrls('https://example.com')).toEqual([
+      'http://127.0.0.1:4321/',
+      'http://127.0.0.1:4321/articles/',
+      'http://127.0.0.1:4321/articles/designing-a-calm-starting-point/',
+    ]);
+  });
+
+  it('audits project deployments below their configured base path', () => {
+    expect(getLighthouseUrls('https://example.github.io/example-project')).toEqual([
+      'http://127.0.0.1:4321/example-project/',
+      'http://127.0.0.1:4321/example-project/articles/',
+      'http://127.0.0.1:4321/example-project/articles/designing-a-calm-starting-point/',
+    ]);
+  });
+});

package/dist/template/scripts/run-lighthouse.ts

@@ -0,0 +1,30 @@
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+
+import { getDeploymentConfig } from '../src/config/deployment.ts';
+import { site } from '../src/config/site.ts';
+import { resolveSiteHref } from '../src/lib/paths.ts';
+
+const previewOrigin = 'http://127.0.0.1:4321';
+const auditedPaths = ['/', '/articles/', '/articles/designing-a-calm-starting-point/'] as const;
+
+export const getLighthouseUrls = (siteUrl: string, origin = previewOrigin): string[] => {
+  const deployment = getDeploymentConfig(siteUrl);
+
+  return auditedPaths.map((path) => new URL(resolveSiteHref(path, deployment.base ?? '/'), origin).href);
+};
+
+export const runLighthouse = (): void => {
+  const lighthouseCli = createRequire(import.meta.url).resolve('@lhci/cli/src/cli.js');
+  const urlArguments = getLighthouseUrls(site.url).map((url) => `--collect.url=${url}`);
+  const result = spawnSync(process.execPath, [lighthouseCli, 'autorun', ...urlArguments], {
+    env: { ...process.env, ASTRO_PREVIEW_BACKGROUND: '0' },
+    stdio: 'inherit',
+  });
+
+  if (result.error) throw result.error;
+  if (result.status !== 0) process.exitCode = result.status ?? 1;
+};
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) runLighthouse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rm-industries/create-forge",
-  "version": "0.4.0-beta.5",
+  "version": "0.4.0-beta.6",
   "description": "Create a content-driven Forge website",
   "keywords": [
     "astro",