codeplay-common 4.8.6 → 4.8.8

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

@@ -1358,6 +1358,28 @@ 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');
 
+function syncAndroidCodeOptimization() {
+  if (buildPlatform !== 'android') return;
+
+  if (!fs.existsSync(androidAppBuildGradlePath)) {
+    throw new Error(`Android app build.gradle not found: ${androidAppBuildGradlePath}`);
+  }
+
+  const currentContent = fs.readFileSync(androidAppBuildGradlePath, 'utf8');
+  const nextContent = currentContent.replace(
+    /getDefaultProguardFile\(\s*(['"])proguard-android\.txt\1\s*\)/g,
+    "getDefaultProguardFile('proguard-android-optimize.txt')"
+  );
+
+  if (!/getDefaultProguardFile\(\s*(['"])proguard-android-optimize\.txt\1\s*\)/.test(nextContent)) {
+    throw new Error('Android code optimisation setup failed: expected default ProGuard configuration was not found.');
+  }
+
+  if (nextContent !== currentContent) {
+    fs.writeFileSync(androidAppBuildGradlePath, nextContent, 'utf8');
+  }
+}
+
 function fileExists(filePath) {
   return fs.existsSync(filePath);
 }
@@ -4305,6 +4327,7 @@ async function main() {
   checkAndupdateDropInViteConfig();
   checkAdmobConfigurationProperty();
   syncAndroidAdIdPermission();
+  syncAndroidCodeOptimization();
 }
 
 await main();
@@ -4320,6 +4343,7 @@ await main();
 Release Notes
 
   6.5
+    Android builds use the optimisation-enabled default ProGuard rules without changing minification settings or custom keep rules.
     Kids ad configuration disables iOS ATT prompts and excludes Android AD_ID during builds.
     Non-kids apps retain tracking prompts and normal permission behavior.
     Ad configuration migration preserves newer local configuration versions.

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

@@ -742,6 +742,71 @@ function findGradleBlock(content, headerPattern) {
     return null;
 }
 
+function ensureReleaseCodeOptimization() {
+    const currentContent = readFileSync(gradleFilePath, 'utf8');
+    const releaseBlock = findGradleBlock(currentContent, /buildTypes\s*\{[\s\S]*?\brelease\s*/);
+    if (!releaseBlock) throw new Error('Release build configuration was not found.');
+
+    const releaseContent = currentContent.slice(releaseBlock.start, releaseBlock.end);
+    const optimizedContent = releaseContent.replace(
+        /getDefaultProguardFile\(\s*(['"])proguard-android\.txt\1\s*\)/g,
+        "getDefaultProguardFile('proguard-android-optimize.txt')"
+    );
+    if (!/getDefaultProguardFile\(\s*(['"])proguard-android-optimize\.txt\1\s*\)/.test(optimizedContent)) {
+        throw new Error('Release build must use the optimisation-enabled default ProGuard rules.');
+    }
+    if (optimizedContent !== releaseContent) {
+        writeFileSync(gradleFilePath, currentContent.slice(0, releaseBlock.start)
+            + optimizedContent + currentContent.slice(releaseBlock.end), 'utf8');
+    }
+}
+
+function signReleaseBundleWithSha256() {
+    const buildOptions = readCapacitorConfig().android?.buildOptions;
+    if (!buildOptions?.keystorePath || !buildOptions.keystorePassword
+        || !buildOptions.keystoreAlias || !buildOptions.keystoreAliasPassword) {
+        throw new Error('Android AAB signing requires the existing keystore path, alias and passwords.');
+    }
+
+    const keystorePath = resolve(__dirname, 'android', buildOptions.keystorePath);
+    const bundleDirectory = join(__dirname, 'android', 'app', 'build', 'outputs', 'bundle', 'release');
+    const unsignedBundle = join(bundleDirectory, 'app-release.aab');
+    const signedBundle = join(bundleDirectory, 'app-release-signed.aab');
+    if (!existsSync(keystorePath) || !existsSync(unsignedBundle)) {
+        throw new Error('The configured upload keystore or release AAB was not found.');
+    }
+
+    const jarsigner = process.env.JAVA_HOME
+        ? join(process.env.JAVA_HOME, 'bin', process.platform === 'win32' ? 'jarsigner.exe' : 'jarsigner')
+        : 'jarsigner';
+    try {
+        // Keep passwords out of command arguments and error output.
+        execFileSync(jarsigner, [
+            '-sigalg', 'SHA256withRSA', '-digestalg', 'SHA-256',
+            '-keystore', keystorePath,
+            '-storepass:env', 'CODEPLAY_AAB_STORE_PASSWORD',
+            '-keypass:env', 'CODEPLAY_AAB_KEY_PASSWORD',
+            '-signedjar', signedBundle, unsignedBundle, buildOptions.keystoreAlias,
+        ], {
+            stdio: 'pipe',
+            env: {
+                ...process.env,
+                CODEPLAY_AAB_STORE_PASSWORD: buildOptions.keystorePassword,
+                CODEPLAY_AAB_KEY_PASSWORD: buildOptions.keystoreAliasPassword,
+            },
+        });
+        const verification = execFileSync(jarsigner, [
+            '-J-Duser.language=en', '-J-Duser.country=US', '-verify', signedBundle,
+        ], { encoding: 'utf8', stdio: 'pipe' });
+        if (!verification.includes('jar verified.') || verification.includes('treated as unsigned')) {
+            throw new Error('Signature verification failed.');
+        }
+    } catch {
+        throw new Error('SHA-256 AAB signing or verification failed. Check the configured upload key and JDK; release stopped.');
+    }
+    console.log('✅ Release AAB signed with SHA-256 using the existing upload key and signature verified.');
+}
+
 const amazonWindowExtensionsDependency = 'implementation "androidx.window.extensions.core:core:1.0.0"';
 const amazonWindowExtensionsDependencyPattern = /^[ \t]*implementation\s+["']androidx\.window\.extensions\.core:core:[^"']+["'][ \t]*(?:\r?\n)?/gm;
 
@@ -1013,11 +1078,14 @@ rl.question('Enter new versionCode (press enter to keep current): ', (newVersion
 
                 execSync('npx cap sync android', { stdio: 'inherit' });
 
+                ensureReleaseCodeOptimization();
+
                 if (buildType === "APK") {
                     console.log("📦 Using custom Node signing script for APK build...");
                     execSync('node buildCodeplay/apk-store-builder.js', { stdio: 'inherit' });
                 } else {
                     execSync(`npx cap build android --androidreleasetype=${buildType}`, { stdio: 'inherit' });
+                    signReleaseBundleWithSha256();
                 }
 
 

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