windows-development-sandbox 1.23.2 → 1.25.1

package/dist/shared/unreal/vs-check.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+export declare const VsSetupReportSchema: z.ZodObject<{
+    setupError: z.ZodString;
+    instances: z.ZodArray<z.ZodObject<{
+        instanceId: z.ZodString;
+        installationPath: z.ZodString;
+        installationVersion: z.ZodString;
+        productId: z.ZodString;
+        state: z.ZodNumber;
+        isComplete: z.ZodBoolean;
+        isLaunchable: z.ZodBoolean;
+        packages: z.ZodArray<z.ZodString>;
+        toolchains: z.ZodArray<z.ZodObject<{
+            version: z.ZodString;
+            cl: z.ZodBoolean;
+            link: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    kitsRoots: z.ZodArray<z.ZodObject<{
+        where: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strip>>;
+    sdks: z.ZodArray<z.ZodObject<{
+        version: z.ZodString;
+        root: z.ZodString;
+        windowsH: z.ZodBoolean;
+        kernel32: z.ZodBoolean;
+        ucrt: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type VsSetupReport = z.output<typeof VsSetupReportSchema>;
+/** The oldest MSVC Unreal 5.4+ builds with. */
+export declare const MIN_MSVC: readonly [14, 38];
+export interface VsVerdict {
+    readonly ok: boolean;
+    readonly text: string;
+}
+/** What UnrealBuildTool would find, in plain words. */
+export declare function vsVerdict(r: VsSetupReport): VsVerdict;

package/dist/shared/unreal/vs-check.js

@@ -0,0 +1,79 @@
+// Whether UnrealBuildTool would find a compiler: the verdict on what sandbox\scripts\get-vs-setup.ps1 reports. UBT
+// (MicrosoftPlatformSDK / VCToolChain) lists Visual Studio instances through the Setup Configuration API
+// (EnumAllInstances), takes those with the MSVC x64 tools (Microsoft.VisualStudio.Component.VC.Tools.x86.x64) and a
+// VC\Tools\MSVC\<version> with Hostx64\x64\cl.exe, and a Windows SDK under the KitsRoot10 the registry names with its
+// headers and libraries. Unreal 5.4 and later want MSVC 14.38 or newer. Pure.
+import { z } from 'zod';
+export const VsSetupReportSchema = z.object({
+    setupError: z.string().max(2000),
+    instances: z
+        .array(z.object({
+        instanceId: z.string().max(100),
+        installationPath: z.string().max(400),
+        installationVersion: z.string().max(60),
+        productId: z.string().max(200),
+        state: z.number().int().min(0),
+        isComplete: z.boolean(),
+        isLaunchable: z.boolean(),
+        packages: z.array(z.string().max(200)).max(50),
+        toolchains: z.array(z.object({ version: z.string().max(40), cl: z.boolean(), link: z.boolean() })).max(50),
+    }))
+        .max(20),
+    kitsRoots: z.array(z.object({ where: z.string().max(40), path: z.string().max(400) })).max(10),
+    sdks: z
+        .array(z.object({
+        version: z.string().max(40),
+        root: z.string().max(400),
+        windowsH: z.boolean(),
+        kernel32: z.boolean(),
+        ucrt: z.boolean(),
+    }))
+        .max(50),
+});
+/** The oldest MSVC Unreal 5.4+ builds with. */
+export const MIN_MSVC = [14, 38];
+const parts = (v) => v.split('.').map((p) => parseInt(p, 10) || 0);
+const newer = (a, b) => {
+    const x = parts(a);
+    const y = parts(b);
+    for (let i = 0; i < Math.max(x.length, y.length); i++)
+        if ((x[i] ?? 0) !== (y[i] ?? 0))
+            return (x[i] ?? 0) - (y[i] ?? 0);
+    return 0;
+};
+/** What UnrealBuildTool would find, in plain words. */
+export function vsVerdict(r) {
+    if (r.setupError)
+        return { ok: false, text: 'the Setup Configuration API failed: ' + r.setupError.slice(0, 300) };
+    const usable = r.instances.filter((i) => (i.state & 1) === 1 && i.isComplete && i.packages.includes('Microsoft.VisualStudio.Component.VC.Tools.x86.x64'));
+    if (!usable.length)
+        return {
+            ok: false,
+            text: r.instances.length
+                ? 'Visual Studio is listed, but no complete instance has the C++ x64 tools'
+                : 'the Setup Configuration API lists no Visual Studio',
+        };
+    const tools = usable
+        .flatMap((i) => i.toolchains.filter((t) => t.cl && t.link).map((t) => ({ i, t })))
+        .sort((a, b) => newer(b.t.version, a.t.version));
+    const best = tools[0];
+    if (!best)
+        return { ok: false, text: 'Visual Studio has no MSVC with the x64 compiler (VC\\Tools\\MSVC)' };
+    const [major, minor] = parts(best.t.version);
+    const oldMsvc = major < MIN_MSVC[0] || (major === MIN_MSVC[0] && minor < MIN_MSVC[1]);
+    const sdk = r.sdks.filter((s) => s.windowsH && s.kernel32 && s.ucrt).sort((a, b) => newer(b.version, a.version))[0];
+    const where = 'Visual Studio ' + best.i.installationVersion + ' at ' + best.i.installationPath;
+    if (!sdk)
+        return { ok: false, text: where + ', MSVC ' + best.t.version + ', but no complete Windows SDK' };
+    return {
+        ok: !oldMsvc,
+        text: where +
+            ', MSVC ' +
+            best.t.version +
+            (oldMsvc ? ' (too old: Unreal 5.4 and later need 14.38 or newer)' : '') +
+            ', Windows SDK ' +
+            sdk.version +
+            ' at ' +
+            sdk.root,
+    };
+}

package/dist/sync/watcher.js

@@ -68,7 +68,11 @@ export function watcherRunning(dataPath) {
     }
 }
 /** The ways the sandbox itself ends badly (the PC going down takes the watcher with it, so it never gets here). */
-const RESTARTABLE = ['sandboxCrash', 'memory', 'gpu', 'hyperv', 'vanished'];
+/**
+ * Ends that start the sandbox again: only those Windows logged. A "vanished" end (busy, no word of leaving, nothing
+ * in the log) is also what closing the Windows Sandbox window looks like, so it gets a report but no restart.
+ */
+const RESTARTABLE = ['sandboxCrash', 'memory', 'gpu', 'hyperv'];
 /**
  * The background watcher of one data folder: while the sandbox runs it syncs history back every minute, guards the
  * projects' git folders, keeps filtered workspaces in step, forwards ports, marks downloaded files, records the audit

package/dist/web/index.html

@@ -6,7 +6,7 @@
     <title>Sandbox</title>
     <link rel="icon" href="data:," />
     <link rel="stylesheet" href="/main-XT7T6ODM.css" />
-    <script type="module" src="/main-CCILLX2M.js"></script>
+    <script type="module" src="/main-FNE6XEHA.js"></script>
   </head>
   <body>
     <div id="root"></div>