مستندات فنی قالب XPay

private function createVersionedSourceMap(array $asset, ?string $version, string $versionedPath): void
{
    // بررسی وجود source map برای فایل JS
    $sourceMapPath = $asset['sourcePath'] . '.map';
    
    if (!file_exists($sourceMapPath)) {
        return;
    }
    
    // ساخت نام فایل ورژن‌دار .map
    $versionedMapFile = $version 
        ? "{$asset['filePrefix']}.v{$version}.{$asset['extension']}.map" 
        : "{$asset['filePrefix']}.{$asset['extension']}.map";
    
    $versionedMapPath = "{$asset['baseDir']}/{$versionedMapFile}";
    
    // کپی source map
    if (!file_exists($versionedMapPath)) {
        @copy($sourceMapPath, $versionedMapPath);
    }
    
    // به‌روزرسانی sourceMappingURL در فایل JS
    if (file_exists($versionedPath)) {
        $jsContent = file_get_contents($versionedPath);
        
        if ($jsContent !== false) {
            // Find and replace sourceMappingURL
            $oldMapRef = "//# sourceMappingURL={$asset['filePrefix']}.{$asset['extension']}.map";
            $newMapRef = "//# sourceMappingURL={$versionedMapFile}";
            
            $jsContent = str_replace($oldMapRef, $newMapRef, $jsContent);
            @file_put_contents($versionedPath, $jsContent);
        }
    }
}

public function processAll()
{
    foreach ($this->assets as &$asset) {
        $version = $asset['debug'] ? null : $this->getVersion($asset);
        
        // ... ساخت فایل ورژن‌دار ...
        
        // اضافه شده: ساخت source map برای JS
        if ($asset['extension'] === 'js') {
            $this->createVersionedSourceMap($asset, $version, $versionedPath);
        }
    }
}

private static function regenerateVersionedSourceMaps(): void
{
    $version = Env::get('ASSET_VERSION', '1.0.0');
    $jsDir = get_template_directory() . '/assets/js';
    
    // لیست به‌روز شده: 8 webpack bundle
    $webpackBundles = [
        'runtime',          // جدید (code splitting)
        'app-react',        // جدید (code splitting)
        'app-highcharts',   // جدید (code splitting)
        'app-datetime',     // جدید (code splitting)
        'app-vendor',       // قبلی
        'app-calculator',   // قبلی
        'app-chart',        // قبلی
        'app-coins'         // قبلی
    ];
    
    foreach ($webpackBundles as $bundle) {
        // کپی JS
        $baseJs = "{$jsDir}/{$bundle}.js";
        $versionedJs = "{$jsDir}/{$bundle}.v{$version}.js";
        @copy($baseJs, $versionedJs);
        
        // کپی و به‌روزرسانی source map
        $baseMap = "{$jsDir}/{$bundle}.js.map";
        if (file_exists($baseMap)) {
            $versionedMap = "{$jsDir}/{$bundle}.v{$version}.js.map";
            @copy($baseMap, $versionedMap);
            
            // به‌روزرسانی sourceMappingURL در JS
            $jsContent = file_get_contents($versionedJs);
            if ($jsContent !== false) {
                $oldRef = "//# sourceMappingURL={$bundle}.js.map";
                $newRef = "//# sourceMappingURL={$bundle}.v{$version}.js.map";
                $jsContent = str_replace($oldRef, $newRef, $jsContent);
                @file_put_contents($versionedJs, $jsContent);
            }
        }
    }
}

// Runtime (باید اول لود شود)
wp_enqueue_script('runtime', 
    $assetVersionManager->getUrl('runtime', 'js'), 
    [], 
    null, 
    true
);

// Libraries
wp_enqueue_script('app-react', 
    $assetVersionManager->getUrl('app-react', 'js'), 
    ['runtime'], 
    null, 
    true
);

// و ادامه برای سایر bundle ها...