@nativescript/windows-quickjs 0.1.0-alpha.0

package/framework/__PROJECT_NAME__/Directory.Build.targets

@@ -0,0 +1,106 @@
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <!-- Directory.Build.targets for the Windows project template.
+       This file applies manifest overrides at build time using XmlPoke.
+       Place in the template root so generated projects inherit it. -->
+  <!-- Default properties are provided in Directory.Build.props so they can be
+       easily overridden per-app or via MSBuild /p: properties. -->
+
+  <PropertyGroup>
+    <ManifestMergerAssembly Condition="'$(ManifestMergerAssembly)' == ''">$(MSBuildThisFileDirectory)..\tools\ManifestMerger\ManifestMerger.dll</ManifestMergerAssembly>
+    <ValidateMergedManifest Condition="'$(ValidateMergedManifest)' == ''">false</ValidateMergedManifest>
+    <TreatManifestValidationErrorsAsWarnings Condition="'$(TreatManifestValidationErrorsAsWarnings)' == ''">false</TreatManifestValidationErrorsAsWarnings>
+    <LogManifestMergeDiagnosticsAsWarnings Condition="'$(LogManifestMergeDiagnosticsAsWarnings)' == ''">false</LogManifestMergeDiagnosticsAsWarnings>
+  </PropertyGroup>
+
+  <UsingTask TaskName="MergeAppxManifest" AssemblyFile="$(ManifestMergerAssembly)" Condition="Exists('$(ManifestMergerAssembly)')" />
+
+  <Target Name="MergeAppResourcesManifest" AfterTargets="ApplyManifestOverrides" Condition="Exists('$(MSBuildProjectDirectory)\Package.appxmanifest')">
+    <PropertyGroup>
+      <_AppResourcesManifest>$(MSBuildProjectDirectory)\App_Resources\Windows\Package.appxmanifest</_AppResourcesManifest>
+      <!-- Allow CLI or callers to override the source manifest via MSBuild property 'AppResourcesManifestPath' -->
+      <_AppResourcesManifest Condition="'$(AppResourcesManifestPath)' != ''">$(AppResourcesManifestPath)</_AppResourcesManifest>
+      <!-- Fallback template manifest name (no '.partial' suffix) -->
+      <_PartialManifest>$(MSBuildProjectDirectory)\Package.appxmanifest</_PartialManifest>
+      <_ManifestToMerge>$(_PartialManifest)</_ManifestToMerge>
+      <_ManifestToMerge Condition="Exists('$(_AppResourcesManifest)')">$(_AppResourcesManifest)</_ManifestToMerge>
+    </PropertyGroup>
+    <ItemGroup>
+      <_ManifestMergerSchemaFiles Include="$(ManifestMergerSchemaFiles)" Condition="'$(ManifestMergerSchemaFiles)' != ''" />
+    </ItemGroup>
+    <Message Text="Merging app manifest (if present) into generated Package.appxmanifest (app wins)" Importance="Low" />
+    <MergeAppxManifest SourceManifest="$(_ManifestToMerge)"
+                       TargetManifest="$(MSBuildProjectDirectory)\Package.appxmanifest"
+                       ValidateMergedManifest="$(ValidateMergedManifest)"
+                       TreatValidationErrorsAsWarnings="$(TreatManifestValidationErrorsAsWarnings)"
+                       LogMergeDiagnosticsAsWarnings="$(LogManifestMergeDiagnosticsAsWarnings)"
+                       SchemaFiles="@(_ManifestMergerSchemaFiles)"
+                       Condition="Exists('$(ManifestMergerAssembly)') and Exists('$(_ManifestToMerge)')" />
+  </Target>
+
+  <Target Name="WarnMissingManifestMerger"
+          BeforeTargets="MergeAppResourcesManifest"
+          Condition="Exists('$(MSBuildProjectDirectory)\Package.appxmanifest') and !Exists('$(ManifestMergerAssembly)')">
+    <Warning Text="ManifestMerger task assembly was not found at '$(ManifestMergerAssembly)'; app manifest resources will not be merged." />
+  </Target>
+
+  <Target Name="ApplyManifestOverrides" BeforeTargets="BeforeBuild" Condition="Exists('$(MSBuildProjectDirectory)\Package.appxmanifest')">
+    <Message Text="Applying manifest overrides (VisualElements, logos, splash) via XmlPoke..." Importance="High" />
+
+    <!-- DisplayName (app tile / taskbar / Start / alt-tab) -->
+    <XmlPoke XmlInputPath="$(MSBuildProjectDirectory)\Package.appxmanifest"
+             Query="/*[local-name()='Package']/*[local-name()='Applications']/*[local-name()='Application']/*[local-name()='VisualElements']/@DisplayName"
+             Value="$(AppDisplayName)"
+             Condition="'$(AppDisplayName)' != ''" />
+
+    <!-- Package DisplayName (Properties) — keep it in sync with the app name instead of leaving the
+         raw project name. The XmlPoke above only touches the per-app VisualElements name. -->
+    <XmlPoke XmlInputPath="$(MSBuildProjectDirectory)\Package.appxmanifest"
+             Query="/*[local-name()='Package']/*[local-name()='Properties']/*[local-name()='DisplayName']"
+             Value="$(AppDisplayName)"
+             Condition="'$(AppDisplayName)' != ''" />
+
+    <!-- Description -->
+    <XmlPoke XmlInputPath="$(MSBuildProjectDirectory)\Package.appxmanifest"
+             Query="/*[local-name()='Package']/*[local-name()='Applications']/*[local-name()='Application']/*[local-name()='VisualElements']/@Description"
+             Value="$(AppDescription)"
+             Condition="'$(AppDescription)' != ''" />
+
+    <!-- Logos -->
+    <XmlPoke XmlInputPath="$(MSBuildProjectDirectory)\Package.appxmanifest"
+             Query="/*[local-name()='Package']/*[local-name()='Applications']/*[local-name()='Application']/*[local-name()='VisualElements']/@Square150x150Logo"
+             Value="$(Square150x150Logo)"
+             Condition="'$(Square150x150Logo)' != ''" />
+
+    <XmlPoke XmlInputPath="$(MSBuildProjectDirectory)\Package.appxmanifest"
+             Query="/*[local-name()='Package']/*[local-name()='Applications']/*[local-name()='Application']/*[local-name()='VisualElements']/@Square44x44Logo"
+             Value="$(Square44x44Logo)"
+             Condition="'$(Square44x44Logo)' != ''" />
+
+    <XmlPoke XmlInputPath="$(MSBuildProjectDirectory)\Package.appxmanifest"
+             Query="/*[local-name()='Package']/*[local-name()='Applications']/*[local-name()='Application']/*[local-name()='VisualElements']/*[local-name()='DefaultTile']/@Wide310x150Logo"
+             Value="$(Wide310x150Logo)"
+             Condition="'$(Wide310x150Logo)' != ''" />
+
+    <XmlPoke XmlInputPath="$(MSBuildProjectDirectory)\Package.appxmanifest"
+             Query="/*[local-name()='Package']/*[local-name()='Applications']/*[local-name()='Application']/*[local-name()='VisualElements']/@StoreLogo"
+             Value="$(StoreLogo)"
+             Condition="'$(StoreLogo)' != ''" />
+
+    <XmlPoke XmlInputPath="$(MSBuildProjectDirectory)\Package.appxmanifest"
+             Query="/*[local-name()='Package']/*[local-name()='Applications']/*[local-name()='Application']/*[local-name()='VisualElements']/@LockScreenLogo"
+             Value="$(LockScreenLogo)"
+             Condition="'$(LockScreenLogo)' != ''" />
+
+    <!-- BackgroundColor and SplashScreen image -->
+    <XmlPoke XmlInputPath="$(MSBuildProjectDirectory)\Package.appxmanifest"
+             Query="/*[local-name()='Package']/*[local-name()='Applications']/*[local-name()='Application']/*[local-name()='VisualElements']/@BackgroundColor"
+             Value="$(SplashBackgroundColor)"
+             Condition="'$(SplashBackgroundColor)' != ''" />
+
+    <XmlPoke XmlInputPath="$(MSBuildProjectDirectory)\Package.appxmanifest"
+             Query="/*[local-name()='Package']/*[local-name()='Applications']/*[local-name()='Application']/*[local-name()='VisualElements']/*[local-name()='SplashScreen']/@Image"
+             Value="$(SplashImage)"
+             Condition="'$(SplashImage)' != ''" />
+
+  </Target>
+</Project>

package/framework/__PROJECT_NAME__/Package.appxmanifest

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Package
+  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
+  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
+  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
+  IgnorableNamespaces="uap rescap">
+  <Identity Name="__APP_IDENTIFIER__" Publisher="CN=__PROJECT_NAME__" Version="1.0.0.0" />
+  <Properties>
+    <DisplayName>__PROJECT_NAME__</DisplayName>
+    <PublisherDisplayName>__PROJECT_NAME__</PublisherDisplayName>
+    <Logo>Assets\StoreLogo.png</Logo>
+  </Properties>
+  <Dependencies>
+    <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.17763.0" MaxVersionTested="10.0.26100.0" />
+    <!-- WinUI3 / Windows App SDK 1.6 framework package (framework-dependent). Required so the
+         registered app can activate Microsoft.UI.Xaml.* (else REGDB_E_CLASSNOTREG at startup). -->
+    <PackageDependency Name="Microsoft.WindowsAppRuntime.1.6" MinVersion="6000.0.0.0" Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US" />
+  </Dependencies>
+  <Resources>
+    <Resource Language="en-US" />
+  </Resources>
+  <Applications>
+    <Application Id="App" Executable="$targetnametoken$.exe" EntryPoint="Windows.FullTrustApplication">
+      <uap:VisualElements DisplayName="__PROJECT_NAME__" Square150x150Logo="Assets\Square150x150Logo.png" Square44x44Logo="Assets\Square44x44Logo.png" Description="A NativeScript Windows application" BackgroundColor="#65ADF1">
+        <uap:DefaultTile Wide310x150Logo="Assets\Wide310x150Logo.png" />
+        <uap:SplashScreen Image="Assets\SplashScreen.png" />
+      </uap:VisualElements>
+    </Application>
+  </Applications>
+  <Capabilities>
+    <rescap:Capability Name="runFullTrust" />
+    <Capability Name="internetClient" />
+    <Capability Name="privateNetworkClientServer" />
+  </Capabilities>
+</Package>

package/framework/__PROJECT_NAME__/Program.cs

@@ -0,0 +1,34 @@
+using System;
+using System.Threading;
+using Microsoft.UI.Dispatching;
+using Microsoft.UI.Xaml;
+using WinRT;
+
+// Windows-only WinUI desktop app. The custom entry point (DISABLE_XAML_GENERATED_MAIN)
+// has no platform attribute, so CA1416 treats every Windows API call site as "reachable
+// on all platforms." Declaring the assembly's supported platform once tells the analyzer
+// the whole assembly only runs on Windows >= 17763, silencing those false positives.
+[assembly: System.Runtime.Versioning.SupportedOSPlatform("windows10.0.17763.0")]
+
+namespace __PROJECT_NAME__
+{
+    public static class Program
+    {
+        [System.STAThread]
+        public static void Main(string[] args)
+        {
+            ComWrappersSupport.InitializeComWrappers();
+
+            Application.Start((_callbackParams) =>
+            {
+                var dispatcherQueue = DispatcherQueue.GetForCurrentThread();
+                if (dispatcherQueue != null)
+                {
+                    SynchronizationContext.SetSynchronizationContext(new DispatcherQueueSynchronizationContext(dispatcherQueue));
+                }
+
+				new App();
+            });
+        }
+    }
+}

package/framework/__PROJECT_NAME__/Properties/Default.rd.xml

@@ -0,0 +1,9 @@
+<!--
+    Runtime Directives for .NET Native.
+    See https://go.microsoft.com/fwlink/?LinkID=391919
+-->
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">
+  <Application>
+    <Assembly Name="*Application*" Dynamic="Required All" />
+  </Application>
+</Directives>

package/framework/__PROJECT_NAME__/RuntimeHost.cs

@@ -0,0 +1,359 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Reflection;
+using System.Runtime.InteropServices;
+using System.Text.Json;
+
+namespace __PROJECT_NAME__
+{
+    internal sealed class RuntimeHost : IDisposable
+    {
+        private const string NativeScriptLibrary = "nativescript";
+
+        [DllImport("kernel32.dll")]
+        private static extern bool AttachConsole(int dwProcessId);
+
+        private const int ATTACH_PARENT_PROCESS = -1;
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_init))]
+        private static extern long runtime_init([MarshalAs(UnmanagedType.LPUTF8Str)] string appRoot);
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_deinit))]
+        private static extern void runtime_deinit(long runtime);
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_runscript))]
+        private static extern void runtime_runscript(long runtime, [MarshalAs(UnmanagedType.LPUTF8Str)] string script, [MarshalAs(UnmanagedType.LPUTF8Str)] string filename);
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_install_ctrlc_handler))]
+        private static extern void runtime_install_ctrlc_handler(int exitCode);
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_set_local_folder))]
+        private static extern void runtime_set_local_folder([MarshalAs(UnmanagedType.LPUTF8Str)] string localFolder);
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_get_last_js_error))]
+        private static extern IntPtr runtime_get_last_js_error();
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_free_js_error))]
+        private static extern void runtime_free_js_error(IntPtr ptr);
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_has_devtools))]
+        private static extern bool runtime_has_devtools();
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_pump_timers))]
+        private static extern void runtime_pump_timers();
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_notify_app_event))]
+        private static extern void runtime_notify_app_event(long runtime, int kind, [MarshalAs(UnmanagedType.LPUTF8Str)] string message);
+
+        public void NotifyAppEvent(int kind, string message = null)
+        {
+            if (!_initialized) return;
+            try { runtime_notify_app_event(_runtime, kind, message); }
+            catch { }
+        }
+
+    #if DEBUG
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(ns_set_log_to_console))]
+        private static extern int ns_set_log_to_console(int enabled);
+
+        public static bool TrySetLogToConsole(bool enabled)
+        {
+            try { return ns_set_log_to_console(enabled ? 1 : 0) == 1; }
+            catch { return false; }
+        }
+    #else
+        public static bool TrySetLogToConsole(bool enabled) => false;
+    #endif
+
+        public void PumpTimers()
+        {
+            if (!_initialized) return;
+            try { runtime_pump_timers(); }
+            catch { }
+        }
+
+#if DEBUG
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_devtools_start))]
+        private static extern IntPtr runtime_devtools_start(long runtime, ushort port);
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_devtools_pump))]
+        private static extern void runtime_devtools_pump(long runtime);
+
+        [DllImport(NativeScriptLibrary, EntryPoint = nameof(runtime_free_string))]
+        private static extern void runtime_free_string(IntPtr ptr);
+
+        public string DevtoolsFrontendUrl { get; private set; }
+
+        private bool _devtoolsAvailable;
+
+        public void PumpDevtools()
+        {
+            if (!_initialized || !_devtoolsAvailable) return;
+            try { runtime_devtools_pump(_runtime); }
+            catch (Exception ex)
+            {
+                System.Diagnostics.Debug.WriteLine($"[NativeScript DevTools] Pump failed: {ex.Message}");
+            }
+        }
+
+        private void StartDevtoolsSafely()
+        {
+            if (!runtime_has_devtools()) return;
+            IntPtr urlPtr = IntPtr.Zero;
+            try
+            {
+                urlPtr = runtime_devtools_start(_runtime, 42000);
+                if (urlPtr == IntPtr.Zero) return;
+                var wsUrl = Marshal.PtrToStringUTF8(urlPtr);
+                DevtoolsFrontendUrl = wsUrl != null
+                    ? $"devtools://devtools/bundled/inspector.html?ws={wsUrl.Replace("ws://", "")}"
+                    : null;
+                if (DevtoolsFrontendUrl != null)
+                {
+                    _devtoolsAvailable = true;
+                    System.Diagnostics.Debug.WriteLine($"[NativeScript DevTools] {DevtoolsFrontendUrl}");
+                }
+            }
+            catch (Exception ex)
+            {
+                DevtoolsFrontendUrl = null;
+                System.Diagnostics.Debug.WriteLine($"[NativeScript DevTools] Start failed: {ex.Message}");
+            }
+            finally
+            {
+                if (urlPtr != IntPtr.Zero) runtime_free_string(urlPtr);
+            }
+        }
+#endif
+
+        private long _runtime;
+        private bool _initialized;
+
+        public void Initialize()
+        {
+            if (_initialized) return;
+            bool attached = false;
+            try { attached = AttachConsole(ATTACH_PARENT_PROCESS); } catch { }
+            runtime_install_ctrlc_handler(0);
+            runtime_set_local_folder(Windows.Storage.ApplicationData.Current.LocalFolder.Path);
+            _runtime = runtime_init(AppContext.BaseDirectory);
+#if DEBUG
+            var trySet = TrySetLogToConsole(true);
+            System.Diagnostics.Debug.WriteLine($"[NativeScript] TrySetLogToConsole returned={trySet}");
+
+            // Also notify the managed bridge (if present) so managed-side
+            // diagnostics follow the runtime toggle. Use reflection to avoid a
+            // hard compile-time dependency on the bridge assembly.
+            try
+            {
+                foreach (var asm in AppDomain.CurrentDomain.GetAssemblies())
+                {
+                    try
+                    {
+                        var t = asm.GetType("NativeScriptBridge.Bridge");
+                        if (t is null) continue;
+                        var m = t.GetMethod("SetLogToConsole", BindingFlags.Public | BindingFlags.Static);
+                        if (m is null) continue;
+                        m.Invoke(null, new object[] { true });
+                        System.Diagnostics.Debug.WriteLine($"[NativeScript] Invoked Bridge.SetLogToConsole on {asm.GetName().Name}");
+                        break;
+                    }
+                    catch { }
+                }
+            }
+            catch { }
+            if (ConsumeDebugBreakMarker())
+                StartDevtoolsSafely();
+#endif
+            _initialized = true;
+        }
+
+#if DEBUG
+        /// <summary>
+        /// Returns true and deletes the marker if the CLI wrote ns-debugbreak to LocalFolder,
+        /// matching the Android sentinel-file pattern used by the NativeScript CLI.
+        /// </summary>
+        private static bool ConsumeDebugBreakMarker()
+        {
+            try
+            {
+                var markerPath = System.IO.Path.Combine(
+                    Windows.Storage.ApplicationData.Current.LocalFolder.Path,
+                    "ns-debugbreak");
+                if (!System.IO.File.Exists(markerPath))
+                    return false;
+                System.IO.File.Delete(markerPath);
+                return true;
+            }
+            catch { return false; }
+        }
+#endif
+
+        public void RunMainScript()
+        {
+            if (!_initialized)
+                throw new InvalidOperationException("Runtime must be initialized before running scripts.");
+
+            var entryPath = ResolveEntryScriptPath();
+            if (entryPath == null)
+            {
+                System.Diagnostics.Debug.WriteLine("[NativeScript Runtime] No entry script found — bundle missing from app directory.");
+                return;
+            }
+
+            var dir = Path.GetDirectoryName(Path.GetFullPath(entryPath));
+            var chunks = new List<string>();
+            foreach (var chunkName in new[] { "runtime.js", "vendor.js" })
+            {
+                var chunkPath = Path.Combine(dir, chunkName);
+                if (File.Exists(chunkPath) &&
+                    !string.Equals(chunkPath, Path.GetFullPath(entryPath), StringComparison.OrdinalIgnoreCase))
+                {
+                    chunks.Add(chunkPath);
+                }
+            }
+            chunks.Add(entryPath);
+
+            foreach (var scriptPath in chunks)
+            {
+                var script = File.ReadAllText(Path.GetFullPath(scriptPath));
+                try
+                {
+                    runtime_runscript(_runtime, script, Path.GetFileName(scriptPath));
+                }
+                catch (Exception ex)
+                {
+                    CrashDiagnostics.WriteExceptionReport("RuntimeHost.RunMainScript", ex, "Script=" + scriptPath);
+                    System.Diagnostics.Debug.WriteLine($"[NativeScript Runtime] Script execution failed ({scriptPath}): {ex}");
+                    throw;
+                }
+            }
+        }
+
+        private sealed class RuntimePackageConfig
+        {
+            public string Main { get; set; } = string.Empty;
+            public string WindowsMain { get; set; } = string.Empty;
+        }
+
+        private static string ResolveEntryScriptPath()
+        {
+            var baseDir = AppContext.BaseDirectory;
+            // EXE lives in <project>/bin/; webpack bundle lives in <project>/app/.
+            var parentDir = Path.GetDirectoryName(
+                baseDir.TrimEnd(Path.DirectorySeparatorChar, Path.AltDirectorySeparatorChar))
+                ?? baseDir;
+
+            // Candidate app directories: sibling of bin/ first, then directly under baseDir.
+            var appDirCandidates = new[]
+            {
+                Path.Combine(parentDir, "app"),
+                Path.Combine(parentDir, "App"),
+                Path.Combine(baseDir, "app"),
+                Path.Combine(baseDir, "App"),
+            };
+
+            string packageJsonPath = null;
+            string resolvedBaseDir = null;
+            foreach (var dir in appDirCandidates)
+            {
+                var candidate = Path.Combine(dir, "package.json");
+                if (File.Exists(candidate))
+                {
+                    packageJsonPath = candidate;
+                    resolvedBaseDir = dir;
+                    break;
+                }
+            }
+
+            // Also accept package.json at the project root (parent of bin/).
+            if (packageJsonPath == null && File.Exists(Path.Combine(parentDir, "package.json")))
+            {
+                packageJsonPath = Path.Combine(parentDir, "package.json");
+                resolvedBaseDir = parentDir;
+            }
+
+            string Fallback() =>
+                appDirCandidates
+                    .SelectMany(d => new[] { Path.Combine(d, "bundle.js"), Path.Combine(d, "bundle.mjs") })
+                    .FirstOrDefault(File.Exists);
+
+            if (packageJsonPath == null)
+                return Fallback();
+
+            try
+            {
+                var config = ParsePackageConfig(packageJsonPath);
+                if (!string.IsNullOrWhiteSpace(config.WindowsMain))
+                {
+                    var p = ResolveScriptPath(resolvedBaseDir, config.WindowsMain);
+                    if (p != null) return p;
+                }
+                if (!string.IsNullOrWhiteSpace(config.Main))
+                {
+                    var p = ResolveScriptPath(resolvedBaseDir, config.Main);
+                    if (p != null) return p;
+                }
+            }
+            catch { }
+
+            return Fallback();
+        }
+
+        private static RuntimePackageConfig ParsePackageConfig(string packageJsonPath)
+        {
+            using var doc = JsonDocument.Parse(File.ReadAllText(packageJsonPath));
+            var config = new RuntimePackageConfig();
+            if (doc.RootElement.TryGetProperty("main", out var main) && main.ValueKind == JsonValueKind.String)
+                config.Main = main.GetString();
+            if (doc.RootElement.TryGetProperty("windows", out var win) && win.ValueKind == JsonValueKind.Object &&
+                win.TryGetProperty("main", out var winMain) && winMain.ValueKind == JsonValueKind.String)
+                config.WindowsMain = winMain.GetString();
+            return config;
+        }
+
+        private static string ResolveScriptPath(string baseDir, string scriptPath)
+        {
+            if (string.IsNullOrWhiteSpace(scriptPath)) return null;
+            var normalized = scriptPath.Replace('/', Path.DirectorySeparatorChar);
+            foreach (var candidate in new[] { normalized, normalized + ".js", normalized + ".mjs" })
+            {
+                var direct = Path.IsPathRooted(candidate) ? candidate : Path.Combine(baseDir, candidate);
+                if (File.Exists(direct)) return direct;
+                var appLower = Path.Combine(baseDir, "app", candidate);
+                if (File.Exists(appLower)) return appLower;
+                var appUpper = Path.Combine(baseDir, "App", candidate);
+                if (File.Exists(appUpper)) return appUpper;
+            }
+            return null;
+        }
+
+        /// Returns the last JavaScript error (message + stack trace) captured during
+        /// script execution, or null if no error was recorded since the last call.
+        public string GetLastJsError()
+        {
+            if (!_initialized) return null;
+            IntPtr ptr = IntPtr.Zero;
+            try
+            {
+                ptr = runtime_get_last_js_error();
+                return ptr == IntPtr.Zero ? null : Marshal.PtrToStringUTF8(ptr);
+            }
+            catch { return null; }
+            finally
+            {
+                if (ptr != IntPtr.Zero) runtime_free_js_error(ptr);
+            }
+        }
+
+        public void Dispose()
+        {
+            if (!_initialized) return;
+            runtime_deinit(_runtime);
+            _runtime = 0;
+            _initialized = false;
+        }
+    }
+}