@mdn/fred 1.2.0 → 1.3.1

package/.env-dist

@@ -2,8 +2,8 @@
 CONTENT_ROOT=../content/files
 # https://github.com/mdn/translated-content
 CONTENT_TRANSLATED_ROOT=../translated-content/files
-# https://github.com/mdn/mdn-studio
-BLOG_ROOT=../mdn-studio/content/posts
+# https://github.com/mdn/blog
+BLOG_ROOT=../blog/content/posts
 # https://github.com/mdn/curriculum/
 CURRICULUM_ROOT=../curriculum
 # https://github.com/mdn/mdn-contributor-spotlight
@@ -29,4 +29,4 @@ RARI_URL="http://localhost:8083"
 REACT_APP_KUMA_HOST="localhost:3000"
 REACT_APP_FXA_SIGNIN_URL="/users/fxa/login/authenticate/"
 REACT_APP_FXA_SETTINGS_URL="https://accounts.stage.mozaws.net/settings/"
-REACT_APP_PLACEMENT_ENABLED="true"
+REACT_APP_PLACEMENT_ENABLED="true"

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [1.3.1](https://github.com/mdn/fred/compare/v1.3.0...v1.3.1) (2025-09-03)
+
+
+### Bug Fixes
+
+* **env:** remove inline script if no runtime variables are set ([#691](https://github.com/mdn/fred/issues/691)) ([771737e](https://github.com/mdn/fred/commit/771737eb0ccf60eab9af54bb011f4099af475e17))
+
+
+### Miscellaneous
+
+* **compat-table:** Port release label fix from yari ([#687](https://github.com/mdn/fred/issues/687)) ([3391cc4](https://github.com/mdn/fred/commit/3391cc4079cf9e6fed5c5b096d361793055fa94e))
+* **deps-dev:** bump the dev group with 5 updates ([#688](https://github.com/mdn/fred/issues/688)) ([bdff859](https://github.com/mdn/fred/commit/bdff8590ce1127286f9d0788ff60c5aa67afc9c8))
+
+## [1.3.0](https://github.com/mdn/fred/compare/v1.2.0...v1.3.0) (2025-09-01)
+
+
+### Features
+
+* **package/bin:** add fred-ssr executable ([#678](https://github.com/mdn/fred/issues/678)) ([faa175d](https://github.com/mdn/fred/commit/faa175dbf31d5cc715bccbcb9673572e8323e340))
+* **server:** allow specifiying port from env var ([#679](https://github.com/mdn/fred/issues/679)) ([eea7274](https://github.com/mdn/fred/commit/eea72742ed07d3e2230cc33c30a2f3a1fcc9b4d3))
+
+
+### Bug Fixes
+
+* **env:** prefix runtime var fallback only once ([eea7274](https://github.com/mdn/fred/commit/eea72742ed07d3e2230cc33c30a2f3a1fcc9b4d3))
+* **server:** omit Playground server link in output ([eea7274](https://github.com/mdn/fred/commit/eea72742ed07d3e2230cc33c30a2f3a1fcc9b4d3))
+
+
+### Miscellaneous
+
+* **deps-dev:** bump @mdn/browser-compat-data from 7.1.0 to 7.1.1 ([#677](https://github.com/mdn/fred/issues/677)) ([2a90bc2](https://github.com/mdn/fred/commit/2a90bc213785c778481299ae6fad996d3c5fe890))
+* **deps-dev:** bump the dev group with 2 updates ([#660](https://github.com/mdn/fred/issues/660)) ([08c2d3d](https://github.com/mdn/fred/commit/08c2d3d465ad31dcac9f0722856822d5da8f833c))
+* rename {mdn-studio => blog} ([#681](https://github.com/mdn/fred/issues/681)) ([39ab241](https://github.com/mdn/fred/commit/39ab241bf912f0f395634029d9fd11b784f28be1))
+
 ## [1.2.0](https://github.com/mdn/fred/compare/v1.1.1...v1.2.0) (2025-08-28)
 
 

package/build/ssr.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { readFile, writeFile } from "node:fs/promises";
 
 import { fdir } from "fdir";

package/components/env/README.md

@@ -26,3 +26,5 @@ Rspack will bundle **all** environment variables prefixed with `FRED_` into the
 By default, variables are baked into our bundle at build time. However, you can define variables as runtime environment variables, which can be changed when running a version of Fred built with `FRED_RUNTIME_ENV=true`.
 
 This is used in our npm package, so we can e.g. set `FRED_WRITER_MODE=true` in the `content` repo, without having to bake that into the npm package for all consumers.
+
+Runtime environment variables fall back to their build-time values if not set, and then to the default defined in code.

package/components/env/index.js

@@ -1,10 +1,16 @@
-import { parseBool, parseString } from "./utils.js";
+import { parseBool, parseInt, parseString } from "./utils.js";
 
 export const PLAYGROUND_BASE_HOST = parseString(
   "PLAYGROUND_BASE_HOST",
   "mdnplay.dev",
 );
-export const PLAYGROUND_LOCAL = parseBool("PLAYGROUND_LOCAL", false);
+export const PLAYGROUND_LOCAL = parseBool("PLAYGROUND_LOCAL", false, {
+  runtime: true,
+});
+export const PORT = parseInt("PORT", 3000, { runtime: true });
+export const PLAYGROUND_PORT = parseInt("PLAYGROUND_PORT", 3001, {
+  runtime: true,
+});
 
 export const FXA_SIGNIN_URL = parseString(
   "FXA_SIGNIN_URL",

package/components/env/utils.js

@@ -20,6 +20,17 @@ export function parseBool(name, fallback, options) {
   }
 }
 
+/**
+ * @param {string} name
+ * @param {number} fallback
+ * @param {Options} [options]
+ */
+export function parseInt(name, fallback, options) {
+  const stringValue = getEnv(name, options);
+  const numberValue = stringValue ? Number.parseInt(stringValue, 10) : fallback;
+  return Number.isNaN(numberValue) ? fallback : numberValue;
+}
+
 /**
  * @param {string} name
  * @param {string} fallback
@@ -36,10 +47,11 @@ export function parseString(name, fallback, options) {
  */
 function getEnv(name, options = {}) {
   const { runtime } = { runtime: false, ...options };
-  name = `FRED_${name}`;
+  const fullName = `FRED_${name}`;
   if (runtime && RUNTIME_ENV) {
-    runtimeVariables.push(name);
-    return process.env[name] || getEnv(name);
+    runtimeVariables.push(fullName);
+    // safely navigate if process is not defined
+    return globalThis.process?.env[fullName] || getEnv(name);
   }
-  return globalThis.__MDNEnv?.[name];
+  return globalThis.__MDNEnv?.[fullName];
 }

package/components/outer-layout/server.js

@@ -69,10 +69,8 @@ export class OuterLayout extends ServerComponent {
         ? "learn"
         : undefined;
 
-    const env = Object.fromEntries(
-      Object.entries(process.env).filter(([key]) =>
-        runtimeVariables.includes(key),
-      ),
+    const runtimeEnvEntries = Object.entries(process.env).filter(
+      ([key]) => key.startsWith("FRED_") && runtimeVariables.includes(key),
     );
 
     // if you want to put some script inline, put it in entry.inline.js
@@ -93,9 +91,9 @@ export class OuterLayout extends ServerComponent {
             content="width=device-width, initial-scale=1.0"
           />
           <title>${context.pageTitle || "MDN"}</title>
-          ${RUNTIME_ENV
+          ${RUNTIME_ENV && runtimeEnvEntries.length > 0
             ? unsafeHTML(`<script>process = {
-  env: ${JSON.stringify(env)}
+  env: ${JSON.stringify(Object.fromEntries(runtimeEnvEntries))}
 };</script>`)
             : nothing}
           ${unsafeHTML(`<script>${inlineScript}</script>`)}

package/components/play-runner/element.js

@@ -5,7 +5,12 @@ import { keyed } from "lit/directives/keyed.js";
 import { createRef, ref } from "lit/directives/ref.js";
 
 import { ThemeController } from "../color-theme/controller.js";
-import { PLAYGROUND_BASE_HOST, PLAYGROUND_LOCAL } from "../env/index.js";
+import {
+  PLAYGROUND_BASE_HOST,
+  PLAYGROUND_LOCAL,
+  PLAYGROUND_PORT,
+  PORT,
+} from "../env/index.js";
 import { compressAndBase64Encode } from "../playground/utils.js";
 
 import styles from "./element.css?lit";
@@ -101,7 +106,7 @@ export class MDNPlayRunner extends LitElement {
       const url = new URL(
         `${prefix}/runner.html`,
         PLAYGROUND_LOCAL
-          ? location.origin.replace("3000", "3001")
+          ? location.origin.replace(PORT.toString(), PLAYGROUND_PORT.toString())
           : `${location.protocol}//${this._subdomain}.${PLAYGROUND_BASE_HOST}`,
       );
       // pass the uuid for postMessage isolation

package/l10n/en-US.ftl

@@ -62,8 +62,8 @@ obs-mdn = The { -brand-name-obs } provides effective security insights, guided b
 
 compat-loading = Loading…
 
-compat-browser-version-date = { $browser } { $version } – Released { $date }
-compat-browser-version-released = Released { $date }
+compat-browser-version-date = { $browser } { $version } – Release date: { $date }
+compat-browser-version-released = Release date: { $date }
 
 compat-link-report-issue = Report problems with this compatibility data
 compat-link-report-issue-title = Report an issue with this compatibility data