codeplay-common 4.7.1 → 4.7.2

package/.gitattributes

@@ -1,2 +1,2 @@
-# Auto detect text files and perform LF normalization
-* text=auto
+# Auto detect text files and perform LF normalization
+* text=auto

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Merbin Joe
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Merbin Joe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,33 +1,33 @@
-# codeplay-common
- Everything automatted in Capacitor apps, easy to maintain many apps in capacitor. It will reduce your 40% of work, with common file code.
-
-
-Easy add splashscreen and set animation
-Admob id automatically from capacitor.config.json file
-Make three build file for different store as per our requirement
-Based on store install various IAP plugins
-Make it to ionic project
-
-## Agent instructions
-
-Agent instructions are updated during `npm run build`, not during npm installation.
-The build script reads the `agents` version from
-`https://htmlcodeplay.com/code-play-plugin/versions.json` and downloads the matching
-`agents-<version>.zip` archive when the project has no agent instructions or the
-server version is newer.
-
-The ZIP root must contain `AGENTS.md` and `AGENTS/`. These are copied directly to
-the project root. The installed version is stored in `AGENTS/.codeplay-version`.
-Existing files with matching names are replaced; project-only files with other
-names inside `AGENTS/` are preserved.
-
-For example, publish `agents-1.1.zip` and add this entry to the server's
-`versions.json`:
-
-```json
-"agents": "1.1"
-```
-
+# codeplay-common
+ Everything automatted in Capacitor apps, easy to maintain many apps in capacitor. It will reduce your 40% of work, with common file code.
+
+
+Easy add splashscreen and set animation
+Admob id automatically from capacitor.config.json file
+Make three build file for different store as per our requirement
+Based on store install various IAP plugins
+Make it to ionic project
+
+## Agent instructions
+
+Agent instructions are updated during `npm run build`, not during npm installation.
+The build script reads the `agents` version from
+`https://htmlcodeplay.com/code-play-plugin/versions.json` and downloads the matching
+`agents-<version>.zip` archive when the project has no agent instructions or the
+server version is newer.
+
+The ZIP root must contain `AGENTS.md` and `AGENTS/`. These are copied directly to
+the project root. The installed version is stored in `AGENTS/.codeplay-version`.
+Existing files with matching names are replaced; project-only files with other
+names inside `AGENTS/` are preserved.
+
+For example, publish `agents-1.1.zip` and add this entry to the server's
+`versions.json`:
+
+```json
+"agents": "1.1"
+```
+
 Donate to get full code including many common functions
 https://ko-fi.com/codeplay
 
@@ -37,93 +37,93 @@ Version 4.6.1
 
 4.2.8
   baseline profile code modifications
-
-Version 4.2.3
-  Added build warning confirmation when android.ORIENTATION is not "auto" or android.RESIZEABLE_ACTIVITY is not true.
-
-Version 4.2.2
-  Added "bannerDisabledPages" property and its default value
-  The admob configuration default value priority is updated
-
-Version 4.2.1
-  Updated AdMob nextgen file validation to match admob-emi-nextgen file names.
-
-Version 4.2.0
-  Firebase related automatic changes updated
-
-Version 4.1.9
-  Added AdMob nextgen 1.7 validation/default support for "overlappingHeight", "bannerTypeAndroidLandscape", and "bannerTypeiOSLandscape".
-
-Version 4.1.8
-  "consentDebug: false" is added
-
-Version 4.1.7
-  admob configuration automatically added.
-
-Version 4.1.6
-  "setup-baseline-profile.js" modification, duplicate validation error fixed
-
-Version 4.1.5
-  While isTesting is true it is not validated from our new configuration admob file, now it is solved
-
-Version 4.1.4
-  hardcoded version is removed for the admob-emi-nextgen
-
-
-Version 4.1.3
-"consentDebug": false automatically adds if not
-
-Version 4.1.2
-  Speedup
-
-Version 4.1.1
-  Auto admob integration updated
-
-
-version 4.0.9
-  packageJson.scripts["ionic:serve"] = "cross-env NODE_ENV=development vite"; this line updated in "sync-files.js"
-
-
-version 4.0.8
-  safearea plugin is checked and removed automatically
-  Automatically added following in capacitor.config.json file
-      "SystemBars": {
-        "insetsHandling": "css"
-      }
-  patchFile() method is removed
-
-
-
-
-Version 4.0.6
-  IAP related some automatic variable creation and validation
-   Fetch from vite.config.json file
-      'import.meta.env.VITE_APP_UNIQUE_ID': JSON.stringify(APP_UNIQUE_ID),
-      'import.meta.env.VITE_ANDROID_ANALYTICS_ENABLED': JSON.stringify(ANDROID_ANALYTICS_ENABLED),
-      'import.meta.env.VITE_IOS_ANALYTICS_ENABLED': JSON.stringify(IOS_ANALYTICS_ENABLED),
-      'import.meta.env.VITE_IAP_DESIGN': JSON.stringify(IAP_DESIGN),
-
-
-Version 4.0.5
-  In "files\buildCodeplay\packageidBaseModification-1.4.js" SCHEDULE_EXACT_ALARM permission added for the app unique id 2 (resume generator app)
-
-
-Version 4.0.4
-  patchFile(); method is disabled, Due to "@capacitor/android:8.4.2" this update. I think it is realted to  safearea issue fixed in this latest version, file in "SystemBars.java"
-
-Version 4.0.3
-  Old admob check performs through plugin location, but not it is validated from capacitor.config.json 
-
-
-Version: 4.0.2
-  After check & install/download the latest version, the re-check is cancelled now
-
-Version: 4.0.1
-    Base profile script added
-
-
-  "version": "",
-Version : 4.0.0 (Previous version 3.2.19)
-    1) In here we are completly remove the admob-emi and use "capacitor-admob-nextgen"
-    2) Removed "modify-plugin-xml.js"
-    3) 
+
+Version 4.2.3
+  Added build warning confirmation when android.ORIENTATION is not "auto" or android.RESIZEABLE_ACTIVITY is not true.
+
+Version 4.2.2
+  Added "bannerDisabledPages" property and its default value
+  The admob configuration default value priority is updated
+
+Version 4.2.1
+  Updated AdMob nextgen file validation to match admob-emi-nextgen file names.
+
+Version 4.2.0
+  Firebase related automatic changes updated
+
+Version 4.1.9
+  Added AdMob nextgen 1.7 validation/default support for "overlappingHeight", "bannerTypeAndroidLandscape", and "bannerTypeiOSLandscape".
+
+Version 4.1.8
+  "consentDebug: false" is added
+
+Version 4.1.7
+  admob configuration automatically added.
+
+Version 4.1.6
+  "setup-baseline-profile.js" modification, duplicate validation error fixed
+
+Version 4.1.5
+  While isTesting is true it is not validated from our new configuration admob file, now it is solved
+
+Version 4.1.4
+  hardcoded version is removed for the admob-emi-nextgen
+
+
+Version 4.1.3
+"consentDebug": false automatically adds if not
+
+Version 4.1.2
+  Speedup
+
+Version 4.1.1
+  Auto admob integration updated
+
+
+version 4.0.9
+  packageJson.scripts["ionic:serve"] = "cross-env NODE_ENV=development vite"; this line updated in "sync-files.js"
+
+
+version 4.0.8
+  safearea plugin is checked and removed automatically
+  Automatically added following in capacitor.config.json file
+      "SystemBars": {
+        "insetsHandling": "css"
+      }
+  patchFile() method is removed
+
+
+
+
+Version 4.0.6
+  IAP related some automatic variable creation and validation
+   Fetch from vite.config.json file
+      'import.meta.env.VITE_APP_UNIQUE_ID': JSON.stringify(APP_UNIQUE_ID),
+      'import.meta.env.VITE_ANDROID_ANALYTICS_ENABLED': JSON.stringify(ANDROID_ANALYTICS_ENABLED),
+      'import.meta.env.VITE_IOS_ANALYTICS_ENABLED': JSON.stringify(IOS_ANALYTICS_ENABLED),
+      'import.meta.env.VITE_IAP_DESIGN': JSON.stringify(IAP_DESIGN),
+
+
+Version 4.0.5
+  In "files\buildCodeplay\packageidBaseModification-1.4.js" SCHEDULE_EXACT_ALARM permission added for the app unique id 2 (resume generator app)
+
+
+Version 4.0.4
+  patchFile(); method is disabled, Due to "@capacitor/android:8.4.2" this update. I think it is realted to  safearea issue fixed in this latest version, file in "SystemBars.java"
+
+Version 4.0.3
+  Old admob check performs through plugin location, but not it is validated from capacitor.config.json 
+
+
+Version: 4.0.2
+  After check & install/download the latest version, the re-check is cancelled now
+
+Version: 4.0.1
+    Base profile script added
+
+
+  "version": "",
+Version : 4.0.0 (Previous version 3.2.19)
+    1) In here we are completly remove the admob-emi and use "capacitor-admob-nextgen"
+    2) Removed "modify-plugin-xml.js"
+    3) 

package/files/buildCodeplay/codeplayBeforeBuild-6.3.js

@@ -1270,6 +1270,7 @@ const androidAppBuildGradlePath = path.join(process.cwd(), 'android', 'app', 'bu
 const AMAZON_WINDOW_EXTENSIONS_DEPENDENCY = 'implementation "androidx.window.extensions.core:core:1.0.0"';
 const AMAZON_WINDOW_EXTENSIONS_DEPENDENCY_PATTERN = /^[ \t]*implementation\s+["']androidx\.window\.extensions\.core:core:[^"']+["'][ \t]*(?:\r?\n)?/gm;
 const infoPlistPath = path.join(process.cwd(), 'ios', 'App', 'App', 'Info.plist');
+const iosSceneDelegatePath = path.join(process.cwd(), 'ios', 'App', 'App', 'SceneDelegate.swift');
 const resourcesPath = path.join(process.cwd(), 'resources', 'res');
 const androidResPath = path.join(process.cwd(), 'android', 'app', 'src', 'main', 'res');
 const localNotificationsPluginPath = path.join(process.cwd(), 'node_modules', '@capacitor', 'local-notifications');
@@ -1593,6 +1594,62 @@ function updateInfoPlist(admobConfig) {
   console.log('AdMob IDs and additional configurations successfully updated in Info.plist');
 }
 
+function updateIOSSceneDelegateForATT() {
+  if (!fileExists(iosSceneDelegatePath)) {
+    console.warn('SceneDelegate.swift not found. Skipping the iOS ATT scene update.');
+    return;
+  }
+
+  let content = fs.readFileSync(iosSceneDelegatePath, 'utf8');
+  if (content.includes('ATTrackingManager.requestTrackingAuthorization')) return;
+
+  const newline = content.includes('\r\n') ? '\r\n' : '\n';
+  const sceneClass = /class SceneDelegate\s*:\s*[^\{]+\{/;
+  if (!sceneClass.test(content) || !/import UIKit\r?\n/.test(content) || !content.trimEnd().endsWith('}')) {
+    console.warn('SceneDelegate.swift has an unexpected structure. Skipping the iOS ATT scene update.');
+    return;
+  }
+
+  if (!content.includes('import AppTrackingTransparency')) {
+    content = content.replace(/import UIKit\r?\n/, (match) => `${match}import AppTrackingTransparency${newline}`);
+  }
+
+  if (!content.includes('isTrackingAuthorizationRequestScheduled')) {
+    content = content.replace(sceneClass, (match) =>
+      `${match}${newline}    private var isTrackingAuthorizationRequestScheduled = false`
+    );
+  }
+
+  const requestBody = [
+    '        if ATTrackingManager.trackingAuthorizationStatus == .notDetermined &&',
+    '            !isTrackingAuthorizationRequestScheduled {',
+    '            isTrackingAuthorizationRequestScheduled = true',
+    '',
+    '            DispatchQueue.main.asyncAfter(deadline: .now() + 1) { [weak self] in',
+    '                self?.isTrackingAuthorizationRequestScheduled = false',
+    '',
+    '                guard UIApplication.shared.applicationState == .active,',
+    '                      ATTrackingManager.trackingAuthorizationStatus == .notDetermined else { return }',
+    '',
+    '                ATTrackingManager.requestTrackingAuthorization { _ in }',
+    '            }',
+    '        }',
+  ].join(newline);
+
+  const activeSceneMethod = /func sceneDidBecomeActive\s*\(\s*_ scene:\s*UIScene\s*\)\s*\{/;
+  if (activeSceneMethod.test(content)) {
+    content = content.replace(activeSceneMethod, (match) => `${match}${newline}${requestBody}`);
+  } else {
+    const classEnd = content.lastIndexOf('}');
+    content = `${content.slice(0, classEnd).trimEnd()}${newline}${newline}` +
+      `    func sceneDidBecomeActive(_ scene: UIScene) {${newline}${requestBody}${newline}    }${newline}` +
+      content.slice(classEnd);
+  }
+
+  fs.writeFileSync(iosSceneDelegatePath, content, 'utf8');
+  console.log('iOS SceneDelegate updated to request ATT when the app becomes active.');
+}
+
 
 try {
   if (!fileExists(configPath)) {
@@ -1622,6 +1679,7 @@ try {
 
     if (fileExists(iosPlatformPath)) {
       updateInfoPlist(_admobConfig);
+      updateIOSSceneDelegateForATT();
     }
   }
 

package/files/buildCodeplay/release-sync.config.json

@@ -1,4 +1,4 @@
-{
-  "url": "https://htmlcodeplay.com/codeplay/api/v1/release/sync",
-  "token": "b_TiY0Lu7q7Yb0Kx9djVxA6ST8k4CFiwFQNxgci7AAU"
-}
+{
+  "url": "https://htmlcodeplay.com/codeplay/api/v1/release/sync",
+  "token": "b_TiY0Lu7q7Yb0Kx9djVxA6ST8k4CFiwFQNxgci7AAU"
+}

package/files/finalrelease

@@ -7,7 +7,7 @@ node finalrelease "1,2,7"
 
 import { existsSync, readFileSync, readdirSync, promises, constants, writeFileSync, unlinkSync, mkdirSync, renameSync } from 'fs';
 import { join, resolve } from 'path';
-import { execSync, execFileSync } from 'child_process';
+import { execSync, execFileSync } from 'child_process';
 import { createInterface } from 'readline';
 
 import { fileURLToPath } from 'url';
@@ -179,49 +179,49 @@ const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
 
 const _appUniqueId = config.android?.APP_UNIQUE_ID;
 const _appName=config.appName;
-const _appPackageId=config.appId;
-
-const releaseSyncConfigPath = join(__dirname, 'buildCodeplay', 'release-sync.config.json');
-let releaseSyncConfig = {};
-if (existsSync(releaseSyncConfigPath)) {
-    try {
-        releaseSyncConfig = JSON.parse(readFileSync(releaseSyncConfigPath, 'utf8'));
-    } catch (error) {
-        console.warn(`⚠️ Could not read ${releaseSyncConfigPath}: ${error.message}`);
-    }
-}
-const RELEASE_SYNC_URL = process.env.CODEPLAY_RELEASE_SYNC_URL || releaseSyncConfig.url || 'https://htmlcodeplay.com/codeplay/api/v1/release/sync';
-const RELEASE_SYNC_TOKEN = process.env.CODEPLAY_RELEASE_SYNC_TOKEN || releaseSyncConfig.token || '';
-const RELEASE_PLATFORM_IDS = { PlayStore: 1, SamsungStore: 13, AmazonStore: 17, MiStore: 15, HuaweiStore: 12, OppoStore: 14, VivoStore: 16 };
-
-function syncReleaseToCodeplay(storeName, finalVersionName, finalVersionCode, releasedDate) {
-    if (!RELEASE_SYNC_TOKEN) {
-        console.warn(`⚠️ Codeplay release sync skipped: add a token to ${releaseSyncConfigPath}.`);
-        return;
-    }
-    const payload = JSON.stringify({
-        app_name: _appName,
-        package_id: _appPackageId,
-        version_name: String(finalVersionName),
-        version_code: String(finalVersionCode),
-        released_date: releasedDate,
-        language_id: 0,
-        language_name: 'Capacitor+ Framework 7',
-        notes: 'Automated release update',
-        status: 1,
-        folder_name: path.basename(process.cwd()),
-        app_unique_id: String(_appUniqueId || ''),
-        platform_id: RELEASE_PLATFORM_IDS[storeName],
-    });
-    try {
-        const response = execFileSync('curl.exe', ['-sS', '--fail-with-body', '-X', 'POST', RELEASE_SYNC_URL,
-            '-H', 'Content-Type: application/json', '-H', `X-Release-Token: ${RELEASE_SYNC_TOKEN}`, '--data-binary', payload],
-            { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
-        console.log(`✅ Codeplay sync (${storeName}): ${response.trim()}`);
-    } catch (error) {
-        console.warn(`⚠️ Codeplay sync failed for ${storeName}; continuing release builds: ${error.message}`);
-    }
-}
+const _appPackageId=config.appId;
+
+const releaseSyncConfigPath = join(__dirname, 'buildCodeplay', 'release-sync.config.json');
+let releaseSyncConfig = {};
+if (existsSync(releaseSyncConfigPath)) {
+    try {
+        releaseSyncConfig = JSON.parse(readFileSync(releaseSyncConfigPath, 'utf8'));
+    } catch (error) {
+        console.warn(`⚠️ Could not read ${releaseSyncConfigPath}: ${error.message}`);
+    }
+}
+const RELEASE_SYNC_URL = process.env.CODEPLAY_RELEASE_SYNC_URL || releaseSyncConfig.url || 'https://htmlcodeplay.com/codeplay/api/v1/release/sync';
+const RELEASE_SYNC_TOKEN = process.env.CODEPLAY_RELEASE_SYNC_TOKEN || releaseSyncConfig.token || '';
+const RELEASE_PLATFORM_IDS = { PlayStore: 1, SamsungStore: 13, AmazonStore: 17, MiStore: 15, HuaweiStore: 12, OppoStore: 14, VivoStore: 16 };
+
+function syncReleaseToCodeplay(storeName, finalVersionName, finalVersionCode, releasedDate) {
+    if (!RELEASE_SYNC_TOKEN) {
+        console.warn(`⚠️ Codeplay release sync skipped: add a token to ${releaseSyncConfigPath}.`);
+        return;
+    }
+    const payload = JSON.stringify({
+        app_name: _appName,
+        package_id: _appPackageId,
+        version_name: String(finalVersionName),
+        version_code: String(finalVersionCode),
+        released_date: releasedDate,
+        language_id: 0,
+        language_name: 'Capacitor+ Framework 7',
+        notes: 'Automated release update',
+        status: 1,
+        folder_name: path.basename(process.cwd()),
+        app_unique_id: String(_appUniqueId || ''),
+        platform_id: RELEASE_PLATFORM_IDS[storeName],
+    });
+    try {
+        const response = execFileSync('curl.exe', ['-sS', '--fail-with-body', '-X', 'POST', RELEASE_SYNC_URL,
+            '-H', 'Content-Type: application/json', '-H', `X-Release-Token: ${RELEASE_SYNC_TOKEN}`, '--data-binary', payload],
+            { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+        console.log(`✅ Codeplay sync (${storeName}): ${response.trim()}`);
+    } catch (error) {
+        console.warn(`⚠️ Codeplay sync failed for ${storeName}; continuing release builds: ${error.message}`);
+    }
+}
 
 const FLOWCHART_API_APP_ID = 228;
 const FLOWCHART_SHARED_PATH = join('public', 'src', 'shared.js');
@@ -1036,11 +1036,11 @@ rl.question('Enter new versionCode (press enter to keep current): ', (newVersion
                 const checkFullPath = join("AAB", newFileName.replace(/\.aab$/, `.${newExt}`));
 
                 // Rename the output file
-                if (existsSync(oldFilePath)) {
-                    renameSync(oldFilePath, checkFullPath);
-                    console.log(`✅ Renamed output ${newExt.toUpperCase()} file to: ${path.basename(checkFullPath)}`);
-                    syncReleaseToCodeplay(storeName, finalVersionName, finalVersionCode, new Date().toISOString().slice(0, 10));
-                } else {
+                if (existsSync(oldFilePath)) {
+                    renameSync(oldFilePath, checkFullPath);
+                    console.log(`✅ Renamed output ${newExt.toUpperCase()} file to: ${path.basename(checkFullPath)}`);
+                    syncReleaseToCodeplay(storeName, finalVersionName, finalVersionCode, new Date().toISOString().slice(0, 10));
+                } else {
                     console.error(`❌ ${newExt.toUpperCase()} file not found after build.`);
                 }
 

package/files/generate-ai-promo-video.js

@@ -86,8 +86,8 @@ const analysisFrameDirectory = path.join(temporaryDirectory, 'ai-analysis');
 const endCardBannerPath = path.join(outputVideoDirectory, `${appFilePrefix}-ai-end-card-banner.png`);
 const promoCopySchemaPath = path.join(temporaryDirectory, 'promo-copy-schema.json');
 const promoCopyResultPath = path.join(temporaryDirectory, 'promo-copy-result.json');
-const ffmpegFallbackDirectory = String(process.env.FFMPEG_BIN || '').trim()
-  || path.join(projectDirectory, 'tools', 'ffmpeg');
+const ffmpegFallbackDirectory = String(process.env.FFMPEG_BIN || '').trim()
+  || path.join(projectDirectory, 'tools', 'ffmpeg');
 const minimumSceneCount = 7;
 const minimumSourceDuration = 12;
 let expectedDuration = 34;
@@ -209,15 +209,15 @@ async function ensureEndCardBanner() {
       + '- Keep all logos and badge text sharp, correctly proportioned, and completely visible.\n'
       + '- Match the background colors and visual style to the actual app icon.\n'
       + '- Create a polished, professional background related to the app’s purpose.\n'
-      + '- Keep the background subtle so it does not compete with the icon, title, feature text, or download badges.\n'
+      + '- Keep the background subtle so it does not compete with the icon, title, feature text, or download badges.\n'
       + '- Use a balanced landscape composition:\n'
       + '  - Large actual app icon on the left.\n'
       + '  - App Store badge followed by Google Play badge on the right.\n'
       + '  - Maintain comfortable margins and clear space around every element.\n'
-      + '- Add the application title prominently.\n'
-      + '- Add concise promotional text describing the application’s actual features, presenting each feature one by one.\n'
-      + '- Keep the title and feature text sharp, readable, accurate, and visually balanced with the icon and download badges.\n'
-      + '- Do not invent unsupported features or add unrelated marketing text.\n'
+      + '- Add the application title prominently.\n'
+      + '- Add concise promotional text describing the application’s actual features, presenting each feature one by one.\n'
+      + '- Keep the title and feature text sharp, readable, accurate, and visually balanced with the icon and download badges.\n'
+      + '- Do not invent unsupported features or add unrelated marketing text.\n'
       + '- Do not add watermarks, fake UI, generated symbols, or unrelated decorations.\n'
       + '- Rounded corners and a subtle shadow may be applied around the app icon, but its internal artwork must remain unchanged.\n'
       + '- Use image generation only for the background.\n'
@@ -467,12 +467,12 @@ function commandExists(command) {
   return !result.error && result.status === 0;
 }
 
-function getExecutable(command) {
-  const executableName = process.platform === 'win32' ? `${command}.exe` : command;
-  const fallbackPath = path.join(ffmpegFallbackDirectory, executableName);
-  if (fs.existsSync(fallbackPath)) return fallbackPath;
-  return commandExists(command) ? command : '';
-}
+function getExecutable(command) {
+  const executableName = process.platform === 'win32' ? `${command}.exe` : command;
+  const fallbackPath = path.join(ffmpegFallbackDirectory, executableName);
+  if (fs.existsSync(fallbackPath)) return fallbackPath;
+  return commandExists(command) ? command : '';
+}
 
 function detectRedundantStaticRanges(ffmpegCommand, inputPath, sourceDuration) {
   const minimumStaticDuration = Math.max(2, Math.min(4, sourceDuration / 60));
@@ -640,7 +640,7 @@ function resolvePromoLayout(requestedLayout) {
 }
 
 function getPythonExecutable() {
-  for (const candidate of ['py', 'python', 'python3']) {
+  for (const candidate of ['py', 'python', 'python3']) {
     const result = spawnSync(candidate, ['-m', 'edge_tts', '--version'], {
       encoding: 'utf8',
       windowsHide: true,
@@ -915,7 +915,7 @@ Rules:
 - footer_keywords must contain exactly 3 distinct, natural app-search phrases, each 2-24 characters.
 - Generate a YouTube upload title and description from the same verified features.
 - YouTube title: 40-100 characters, include ${JSON.stringify(appName)} and one strong natural search phrase, without clickbait.
-- YouTube description: 350-1500 characters with readable paragraphs. Put the clearest app summary and primary search phrase in the opening two lines, explain the demonstrated features, add a simple call to action, then insert a newline and finish with exactly 3 relevant hashtags on that separate final line. The hashtags must not be appended to the preceding paragraph.
+- YouTube description: 350-1500 characters with readable paragraphs. Put the clearest app summary and primary search phrase in the opening two lines, explain the demonstrated features, add a simple call to action, then insert a newline and finish with exactly 3 relevant hashtags on that separate final line. The hashtags must not be appended to the preceding paragraph.
 - Do not add download links or URLs; the script will append the verified Google Play URL built from the configured package ID. Do not add chapter timestamps or unsupported availability claims.
 - Keep YouTube text natural and useful; do not repeat keywords unnaturally.
 - Avoid prices, ratings, awards, competitor names, unsupported superlatives, and words such as best, guaranteed, or free.
@@ -1025,14 +1025,14 @@ function validatePromoCopy(value) {
     throw new Error(`The final scene must mention the app name ${JSON.stringify(appName)}.`);
   }
 
-  const youtubeTitle = cleanGeneratedString(value.youtube.title);
-  let youtubeDescription = cleanGeneratedDescription(value.youtube.description);
-  const trailingHashtagGroup = youtubeDescription.match(
-    /(?:^|\s)(#[\p{L}\p{N}_]+\s+#[\p{L}\p{N}_]+\s+#[\p{L}\p{N}_]+)\s*$/u,
-  );
-  if (trailingHashtagGroup) {
-    youtubeDescription = `${youtubeDescription.slice(0, trailingHashtagGroup.index).trimEnd()}\n${trailingHashtagGroup[1]}`;
-  }
+  const youtubeTitle = cleanGeneratedString(value.youtube.title);
+  let youtubeDescription = cleanGeneratedDescription(value.youtube.description);
+  const trailingHashtagGroup = youtubeDescription.match(
+    /(?:^|\s)(#[\p{L}\p{N}_]+\s+#[\p{L}\p{N}_]+\s+#[\p{L}\p{N}_]+)\s*$/u,
+  );
+  if (trailingHashtagGroup) {
+    youtubeDescription = `${youtubeDescription.slice(0, trailingHashtagGroup.index).trimEnd()}\n${trailingHashtagGroup[1]}`;
+  }
   if (youtubeTitle.length < 40 || youtubeTitle.length > 100) {
     throw new Error('YouTube title must be 40-100 characters.');
   }