codeplay-common 4.8.4 → 4.8.6

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,169 +1,169 @@
-# 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
-
-## Platform builds and shared validation
-
-Installing or updating `codeplay-common` updates the consuming project's `package.json`
-to use the latest bundled pre-build script and adds these commands:
-
-- `npm run build`: Android by default, including on macOS.
-- `npm run build:ios`: sets `CODEPLAY_BUILD_PLATFORM=ios` and runs the same build pipeline.
-- `npm run build-capacitor-android`: runs the shared checks and copies the web build to Android.
-
-The pre-build script migrates direct `saveToGalleryAndSaveAnyFile` imports to
-`@saveGallery` and sets the Vite alias to the matching Android or iOS helper.
-Before changing source imports or the alias, it lists the build target, affected files,
-and exact replacements. Press Enter or type `y` to continue; any other answer cancels.
-Correct imports and alias targets continue without prompting. Missing helpers, mixed
-versions and query/hash imports stop with an actionable error.
-
-Source validation reuses a directory inventory and combines the gallery and editor
-checks in one content pass. The inventory refreshes when generated or downloaded
-files change the source tree.
-
-Builds also keep `agent-temp/` ignored and remove existing `buildCodeplay/` ignore entries.
-If `onesignal-cordova-plugin` is declared or installed, the pre-build script warns and
-runs `npm uninstall onesignal-cordova-plugin`. It stops if removal fails or active
-package imports remain. Legacy OneSignal patching and helper downloads are disabled.
-
-## Screenshot data
-
-Shared screenshot helpers are installed into `scripts/screenshot/` and updated with
-the package. App-specific data is not bundled with the package.
-During an upgrade, cleanup removes only the two legacy helpers `frame-samples.js`
-and `background-decorations.js` from `scripts-screenshot/screenshot/`, preserving
-the folder, JSON data, and other app files.
-
-`take-screen-image.js` creates `scripts-screenshot/screenshot/` and empty
-`screenshot-copy.json` and `screenshot-info.json` files when needed. Existing files
-are preserved during initialization, package installation, and cleanup. Capture
-updates screenshot information; the AI text-generation workflow fills screenshot
-copy. `--delete` removes matching records, and screenshot runs reconcile records
-against the captured images (except dry runs and `--refresh-info`).
-
-## 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
-
-Version 4.6.1
-  Added automatic IAP startup integration for Framework7 home pages.
-  Updated minimum shared versions to IAP 4.2 and AdMob nextgen 2.5.
-
-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) 
+# 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
+
+## Platform builds and shared validation
+
+Installing or updating `codeplay-common` updates the consuming project's `package.json`
+to use the latest bundled pre-build script and adds these commands:
+
+- `npm run build`: Android by default, including on macOS.
+- `npm run build:ios`: sets `CODEPLAY_BUILD_PLATFORM=ios` and runs the same build pipeline.
+- `npm run build-capacitor-android`: runs the shared checks and copies the web build to Android.
+
+The pre-build script migrates direct `saveToGalleryAndSaveAnyFile` imports to
+`@saveGallery` and sets the Vite alias to the matching Android or iOS helper.
+Before changing source imports or the alias, it lists the build target, affected files,
+and exact replacements. Press Enter or type `y` to continue; any other answer cancels.
+Correct imports and alias targets continue without prompting. Missing helpers, mixed
+versions and query/hash imports stop with an actionable error.
+
+Source validation reuses a directory inventory and combines the gallery and editor
+checks in one content pass. The inventory refreshes when generated or downloaded
+files change the source tree.
+
+Builds also keep `agent-temp/` ignored and remove existing `buildCodeplay/` ignore entries.
+If `onesignal-cordova-plugin` is declared or installed, the pre-build script warns and
+runs `npm uninstall onesignal-cordova-plugin`. It stops if removal fails or active
+package imports remain. Legacy OneSignal patching and helper downloads are disabled.
+
+## Screenshot data
+
+Shared screenshot helpers are installed into `scripts/screenshot/` and updated with
+the package. App-specific data is not bundled with the package.
+During an upgrade, cleanup removes only the two legacy helpers `frame-samples.js`
+and `background-decorations.js` from `scripts-screenshot/screenshot/`, preserving
+the folder, JSON data, and other app files.
+
+`take-screen-image.js` creates `scripts-screenshot/screenshot/` and empty
+`screenshot-copy.json` and `screenshot-info.json` files when needed. Existing files
+are preserved during initialization, package installation, and cleanup. Capture
+updates screenshot information; the AI text-generation workflow fills screenshot
+copy. `--delete` removes matching records, and screenshot runs reconcile records
+against the captured images (except dry runs and `--refresh-info`).
+
+## 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
+
+Version 4.6.1
+  Added automatic IAP startup integration for Framework7 home pages.
+  Updated minimum shared versions to IAP 4.2 and AdMob nextgen 2.5.
+
+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) 

package/files/buildCodeplay/codeplayBeforeBuild-6.4.js

@@ -2956,7 +2956,8 @@ const CODEPLAY_SYSTEM_BARS_PLUGIN = "capacitor-codeplay-system-bars";
 function ensureMandatoryCapacitorPlugins() {
   const requiredPackages = [
     "@capacitor/device",
-    "@capacitor-community/in-app-review"
+    "@capacitor-community/in-app-review",
+    "@capawesome/capacitor-app-update"
   ];
 
   for (const packageName of requiredPackages) {

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.');
   }