@norskvideo/ctl-dev-kit 0.1.17 → 0.1.18

package/build/flake.nix

@@ -20,7 +20,7 @@
   description = "norsk-ctl product build + dev shell";
 
   inputs = {
-    nixpkgs.url = "github:NixOS/nixpkgs/d233902339c02a9c334e7e593de68855ad26c4cb"; # nixpkgs-unstable 2026-05-15, bun 1.3.13
+    nixpkgs.url = "github:NixOS/nixpkgs/d233902339c02a9c334e7e593de68855ad26c4cb"; # nixpkgs-unstable 2026-05-15, bun 1.3.13, chromium 148.0.7778.167
     # Biome must match the version pinned in package.json (@biomejs/biome 2.5.5)
     # exactly: 2.4.x can't parse this repo's biome.json (`rules.preset` is a
     # 2.5 key) and any other 2.5.x emits a version-mismatch info that breaks the
@@ -92,22 +92,49 @@
             pkgs.git
             pkgs.ffmpeg # integration suites spawn a local ffmpeg (e.g. SRT egress capture)
           ];
+
+          # Playwright doc-guide browser. nix-pinned headless Chromium needs a
+          # real X display on a truly headless box (page.fill silently no-ops on
+          # plain HTML inputs; some pages crash the renderer). Ubuntu's apt Xvfb
+          # is too old for Chromium 148's input dispatch — the nix xorg-server
+          # works. A product's scripts/with-display.sh wraps playwright in
+          # xvfb-run iff DISPLAY is unset.
+          linuxBrowser = pkgs.lib.optionals pkgs.stdenv.isLinux [
+            pkgs.chromium
+            pkgs.xvfb-run
+            pkgs.xorg.xorgserver
+          ];
+          # Headless Chromium finds no system fonts on NixOS, so text renders at
+          # zero advance width — invisible, and every toBeVisible() on text times
+          # out. Point fontconfig at a minimal bundled set so glyphs have real
+          # metrics.
+          fontsConf = pkgs.makeFontsConf {
+            fontDirectories = [ pkgs.dejavu_fonts pkgs.liberation_ttf ];
+          };
+          browserHook = pkgs.lib.optionalString pkgs.stdenv.isLinux ''
+            export BROWSER_FOR_TESTING=${pkgs.chromium}/bin/chromium
+            export PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
+            export FONTCONFIG_FILE=${fontsConf}
+          '';
         in {
           # Everyday dev shell — build tools + the pinned norsk-ctl daemon.
           # `nix develop` and `nix develop .#dev` are equivalent.
           default = pkgs.mkShell {
             BIOME_BINARY = "${biome}/bin/biome";
-            buildInputs = buildTools ++ [ (mkCtl system) ];
+            buildInputs = buildTools ++ linuxBrowser ++ [ (mkCtl system) ];
+            shellHook = browserHook;
           };
           dev = pkgs.mkShell {
             BIOME_BINARY = "${biome}/bin/biome";
-            buildInputs = buildTools ++ [ (mkCtl system) ];
+            buildInputs = buildTools ++ linuxBrowser ++ [ (mkCtl system) ];
+            shellHook = browserHook;
           };
           # Lean shell for CI (build-image / integration) — no ctl fetch, so
           # image builds never depend on the ctl binary channel.
           build = pkgs.mkShell {
             BIOME_BINARY = "${biome}/bin/biome";
-            buildInputs = buildTools;
+            buildInputs = buildTools ++ linuxBrowser;
+            shellHook = browserHook;
           };
         });
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-dev-kit",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "type": "module",
   "exports": {
     "./package.json": "./package.json",