@mdn/fred 1.2.0 → 1.3.0

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,26 @@
 # Changelog
 
+## [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/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,10 @@ 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);
+    return process.env[fullName] || getEnv(name);
   }
-  return globalThis.__MDNEnv?.[name];
+  return globalThis.__MDNEnv?.[fullName];
 }

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