codeplay-common 4.10.5 → 4.10.6

package/CHANGELOG.md

@@ -1,77 +1,77 @@
-# Changelog
-
-## 4.10.5 — 2026-10-23
-
-Version name: 4.10.5. Version code/build number: not applicable to this npm package.
-
-Files changed: `package.json`, `scripts/sync-files.js`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
-
-- Migrate known legacy filename lookups in an existing app configurator after installing shared scripts.
-- Prefer unversioned pre-build and package-ID helpers while retaining the versioned fallback.
-- Correct the known old sync-hook folder assignment without replacing app-specific configuration or adding a configurator to apps that do not have one.
-
-## 4.10.4 — 2026-10-23
-
-Version name: 4.10.4. Version code/build number: not applicable to this npm package.
-
-Files changed: `package.json`, `files/scripts-common/run-codeplay-sync-after.js`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
-
-- Ship an updated sync-after hook for apps retaining the custom hook command after script migration.
-- Run unversioned splash helpers instead of searching for removed versioned filenames.
-- Resolve baseline profile setup from `scripts-common/` and preserve the existing native splash when no splash icon is configured.
-
-## 4.10.3 — 2026-10-23
-
-Version name: 4.10.3. Version code/build number: not applicable to this npm package.
-
-Files changed: `package.json`, `files/finalrelease`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
-
-- Allow ad-free apps with `plugins.AdMob.ADMOB_ENABLED: false` to pass release validation without an AdMob alias or controller.
-- Continue requiring a production AdMob alias when advertising is enabled or the enabled flag is unspecified.
-- Preserve rejection of test aliases, commented or duplicate aliases, and missing production controllers for apps with ads enabled.
-
-## 4.10.0 — 2026-10-23
-
-Version name: 4.10.0. Version code/build number: not applicable to this npm package.
-Bundled pre-build script: 6.7.
-
-Files changed: `package.json`, `files/buildCodeplay/project-scripts.cjs`, `scripts/sync-files.js`, `scripts/uninstall.js`, `files/finalrelease`, `files/buildCodeplay/`, `files/scripts-common/`, `files/take-screen-image.js`, `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
-
-- Copy shared build scripts and the versions manifest into each app; run local scripts with unversioned filenames.
-- Rename app helper scripts to scripts-common automatically, migrate command paths, and preserve existing files without overwriting folder conflicts.
-- Migrate app build/store/sync paths automatically and remove only superseded versioned helpers; preserve app-owned configuration and screenshot data.
-- Resolve app sources/native targets from the consuming app directory while keeping bundled assets inside the plugin.
-- Download IAP and AdMob directly from htmlcodeplay.com, without bundling archives or adding a separate fallback.
-- Automatically migrate deferred ownership verification, purchase-safe advertising, and Home Pro visibility according to each store IAP flag.
-- Copy the full finalrelease implementation so it can be tested from the application folder.
-- Preserve working files during preinstall and avoid downgrading local/newer plugin installations to an older registry release.
-
-## 4.9.8 — 2026-10-22
-
-Version name: 4.9.8. Version code/build number: not applicable to this npm package.
-Bundled pre-build script: 6.5.
-
-Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/codeplayBeforeBuild-6.5.js`, `files/buildCodeplay/sync-admob-nextgen.js`, `files/buildCodeplay/versions.json`, `files/finalrelease`, `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
-
-- Install AdMob as `src/js/Ads/admob-nextgen-4.0/` with stable `admob-emi-nextgen.js` and `app-open-state.js` filenames.
-- Automatically migrate loose-file references, folder references and Vite aliases during installation and before builds.
-- Preserve app-owned ad configuration and select each app's existing IAP analytics module.
-- Download every AdMob folder ZIP from htmlcodeplay.com; no AdMob archive is included in this npm package.
-- Validate ZIP contents before switching imports; retain the working package when a remote update fails.
-- Validate the selected folder controller during final-release checks while continuing to reject test aliases.
-
-## 4.7.7 — 2026-10-07
-
-Version name: 4.7.7. Version code/build number: not applicable to this npm package.
-Bundled pre-build script: 6.4.
-
-Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/codeplayBeforeBuild-6.4.js`
-(replaces `codeplayBeforeBuild-6.3.js`), `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
-
-- Keep `npm run build` as the Android default on every host; add `npm run build:ios` automatically during installation.
-- Route `build-capacitor-android` through the same pre-build validation before copying the web build.
-- Migrate direct save-gallery imports to `@saveGallery` and select the matching platform helper in Vite after one detailed Enter/y confirmation.
-- Stop without import writes on cancellation, missing helpers, mixed versions, unsupported query/hash aliases or concurrent source edits.
-- Reuse source directory traversal and combine gallery, retired OneSignal import, StatusBar and editor checks in one content pass.
-- Automatically remove an installed/declared `onesignal-cordova-plugin` with a warning; skip legacy OneSignal patching/helper downloads and stop on remaining package imports.
-- Keep `agent-temp/` ignored and remove existing `buildCodeplay/` ignore entries without adding them in future projects.
+# Changelog
+
+## 4.10.5 — 2026-10-23
+
+Version name: 4.10.5. Version code/build number: not applicable to this npm package.
+
+Files changed: `package.json`, `scripts/sync-files.js`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Migrate known legacy filename lookups in an existing app configurator after installing shared scripts.
+- Prefer unversioned pre-build and package-ID helpers while retaining the versioned fallback.
+- Correct the known old sync-hook folder assignment without replacing app-specific configuration or adding a configurator to apps that do not have one.
+
+## 4.10.4 — 2026-10-23
+
+Version name: 4.10.4. Version code/build number: not applicable to this npm package.
+
+Files changed: `package.json`, `files/scripts-common/run-codeplay-sync-after.js`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Ship an updated sync-after hook for apps retaining the custom hook command after script migration.
+- Run unversioned splash helpers instead of searching for removed versioned filenames.
+- Resolve baseline profile setup from `scripts-common/` and preserve the existing native splash when no splash icon is configured.
+
+## 4.10.3 — 2026-10-23
+
+Version name: 4.10.3. Version code/build number: not applicable to this npm package.
+
+Files changed: `package.json`, `files/finalrelease`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Allow ad-free apps with `plugins.AdMob.ADMOB_ENABLED: false` to pass release validation without an AdMob alias or controller.
+- Continue requiring a production AdMob alias when advertising is enabled or the enabled flag is unspecified.
+- Preserve rejection of test aliases, commented or duplicate aliases, and missing production controllers for apps with ads enabled.
+
+## 4.10.0 — 2026-10-23
+
+Version name: 4.10.0. Version code/build number: not applicable to this npm package.
+Bundled pre-build script: 6.7.
+
+Files changed: `package.json`, `files/buildCodeplay/project-scripts.cjs`, `scripts/sync-files.js`, `scripts/uninstall.js`, `files/finalrelease`, `files/buildCodeplay/`, `files/scripts-common/`, `files/take-screen-image.js`, `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Copy shared build scripts and the versions manifest into each app; run local scripts with unversioned filenames.
+- Rename app helper scripts to scripts-common automatically, migrate command paths, and preserve existing files without overwriting folder conflicts.
+- Migrate app build/store/sync paths automatically and remove only superseded versioned helpers; preserve app-owned configuration and screenshot data.
+- Resolve app sources/native targets from the consuming app directory while keeping bundled assets inside the plugin.
+- Download IAP and AdMob directly from htmlcodeplay.com, without bundling archives or adding a separate fallback.
+- Automatically migrate deferred ownership verification, purchase-safe advertising, and Home Pro visibility according to each store IAP flag.
+- Copy the full finalrelease implementation so it can be tested from the application folder.
+- Preserve working files during preinstall and avoid downgrading local/newer plugin installations to an older registry release.
+
+## 4.9.8 — 2026-10-22
+
+Version name: 4.9.8. Version code/build number: not applicable to this npm package.
+Bundled pre-build script: 6.5.
+
+Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/codeplayBeforeBuild-6.5.js`, `files/buildCodeplay/sync-admob-nextgen.js`, `files/buildCodeplay/versions.json`, `files/finalrelease`, `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Install AdMob as `src/js/Ads/admob-nextgen-4.0/` with stable `admob-emi-nextgen.js` and `app-open-state.js` filenames.
+- Automatically migrate loose-file references, folder references and Vite aliases during installation and before builds.
+- Preserve app-owned ad configuration and select each app's existing IAP analytics module.
+- Download every AdMob folder ZIP from htmlcodeplay.com; no AdMob archive is included in this npm package.
+- Validate ZIP contents before switching imports; retain the working package when a remote update fails.
+- Validate the selected folder controller during final-release checks while continuing to reject test aliases.
+
+## 4.7.7 — 2026-10-07
+
+Version name: 4.7.7. Version code/build number: not applicable to this npm package.
+Bundled pre-build script: 6.4.
+
+Files changed: `package.json`, `scripts/sync-files.js`, `files/buildCodeplay/codeplayBeforeBuild-6.4.js`
+(replaces `codeplayBeforeBuild-6.3.js`), `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`.
+
+- Keep `npm run build` as the Android default on every host; add `npm run build:ios` automatically during installation.
+- Route `build-capacitor-android` through the same pre-build validation before copying the web build.
+- Migrate direct save-gallery imports to `@saveGallery` and select the matching platform helper in Vite after one detailed Enter/y confirmation.
+- Stop without import writes on cancellation, missing helpers, mixed versions, unsupported query/hash aliases or concurrent source edits.
+- Reuse source directory traversal and combine gallery, retired OneSignal import, StatusBar and editor checks in one content pass.
+- Automatically remove an installed/declared `onesignal-cordova-plugin` with a warning; skip legacy OneSignal patching/helper downloads and stop on remaining package imports.
+- Keep `agent-temp/` ignored and remove existing `buildCodeplay/` ignore entries without adding them in future projects.

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,215 +1,215 @@
-# 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
-
-
-## App helper folder
-
-Application helper scripts are kept in `scripts-common/`. Installation migrates the old `scripts/` folder and package command paths automatically, preserving every existing file. A conflicting destination file stops migration before any files are moved. The plugin’s internal npm lifecycle folder remains `scripts/`.
-
-## Shared unversioned build files (4.10.0)
-
-The plugin keeps the master build templates in files/buildCodeplay and copies them into each app's buildCodeplay folder during installation/update. Test changes in the application folder, then update these master templates for distribution to other apps.
-
-App package scripts run local files: node buildCodeplay/codeplayBeforeBuild.js, node buildCodeplay/packageidBaseModification.js, node buildCodeplay/add-splash-screen.js and node buildCodeplay/setSplashAnimation.js. Filenames have no version suffixes. The versions.json plugin manifest remains alongside these scripts and is copied too.
-
-Installation migrates both legacy versioned filenames and the temporary node_modules runner commands to these local paths. It removes only superseded versioned build scripts, preserves app-owned release configuration and splash XML overrides, and keeps screenshot data and custom helpers. The root finalrelease script is also copied as a local implementation.
-
-Before-build includes the automatic IAP startup and Home Pro-button migrations. IAP and AdMob ZIPs are downloaded directly from https://htmlcodeplay.com/code-play-plugin/ using the existing update flow. No plugin ZIPs are bundled in this npm package. App-specific configuration and designs remain in the app.
-
-## AdMob folder packages
-
-The next before-build automatically migrates AdMob to at least:
-
-`src/js/Ads/admob-nextgen-4.1/admob-emi-nextgen.js`
-
-`src/js/Ads/admob-nextgen-4.1/app-open-state.js`
-
-Existing `@admob` imports continue to work. Direct imports of the controller or
-lightweight state module are rewritten to the selected folder, including relative
-paths, `@/` paths and static dynamic imports. App-owned
-`src/js/Ads/admob-ad-configuration-nextgen.json` remains outside the package;
-installation does not replace its values. The controller's analytics import is
-aligned with the newest installed IAP folder containing `firebase-analytics.js`.
-
-The pre-build script downloads IAP before migrating AdMob so the corresponding imports exist. Postinstall does not independently update AdMob ahead of IAP.
-ZIPs may contain the files directly or one matching versioned folder. A complete
-controller and state module are required before imports switch. An unavailable or
-invalid remote ZIP leaves the installed package in use, with a warning. Unresolved
-import targets stop migration before old packages are removed.
-
-For future AdMob releases, upload `admob-nextgen-X.Y.zip` to
-`https://htmlcodeplay.com/code-play-plugin/` and set `"admob-nextgen": "X.Y"`
-in that server's `versions.json`. Version the folder, and keep module filenames
-stable. The previous `admob-emi-nextgen` manifest key is accepted for versions
-4.0 and later during the transition. Apps automatically select a newer ZIP during
-their next normal pre-build; no per-app import changes are needed.
-For older manifests without a folder release entry, migration checks the required
-`admob-nextgen-4.1.zip` directly from the same server. If offline, an existing compatible
-installation is preserved; a missing required package stops the build.
-
-## Platform builds and shared validation
-
-Installing or updating `codeplay-common` updates the consuming project's `package.json`
-to use the copied unversioned 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-common/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
+
+
+## App helper folder
+
+Application helper scripts are kept in `scripts-common/`. Installation migrates the old `scripts/` folder and package command paths automatically, preserving every existing file. A conflicting destination file stops migration before any files are moved. The plugin’s internal npm lifecycle folder remains `scripts/`.
+
+## Shared unversioned build files (4.10.0)
+
+The plugin keeps the master build templates in files/buildCodeplay and copies them into each app's buildCodeplay folder during installation/update. Test changes in the application folder, then update these master templates for distribution to other apps.
+
+App package scripts run local files: node buildCodeplay/codeplayBeforeBuild.js, node buildCodeplay/packageidBaseModification.js, node buildCodeplay/add-splash-screen.js and node buildCodeplay/setSplashAnimation.js. Filenames have no version suffixes. The versions.json plugin manifest remains alongside these scripts and is copied too.
+
+Installation migrates both legacy versioned filenames and the temporary node_modules runner commands to these local paths. It removes only superseded versioned build scripts, preserves app-owned release configuration and splash XML overrides, and keeps screenshot data and custom helpers. The root finalrelease script is also copied as a local implementation.
+
+Before-build includes the automatic IAP startup and Home Pro-button migrations. IAP and AdMob ZIPs are downloaded directly from https://htmlcodeplay.com/code-play-plugin/ using the existing update flow. No plugin ZIPs are bundled in this npm package. App-specific configuration and designs remain in the app.
+
+## AdMob folder packages
+
+The next before-build automatically migrates AdMob to at least:
+
+`src/js/Ads/admob-nextgen-4.1/admob-emi-nextgen.js`
+
+`src/js/Ads/admob-nextgen-4.1/app-open-state.js`
+
+Existing `@admob` imports continue to work. Direct imports of the controller or
+lightweight state module are rewritten to the selected folder, including relative
+paths, `@/` paths and static dynamic imports. App-owned
+`src/js/Ads/admob-ad-configuration-nextgen.json` remains outside the package;
+installation does not replace its values. The controller's analytics import is
+aligned with the newest installed IAP folder containing `firebase-analytics.js`.
+
+The pre-build script downloads IAP before migrating AdMob so the corresponding imports exist. Postinstall does not independently update AdMob ahead of IAP.
+ZIPs may contain the files directly or one matching versioned folder. A complete
+controller and state module are required before imports switch. An unavailable or
+invalid remote ZIP leaves the installed package in use, with a warning. Unresolved
+import targets stop migration before old packages are removed.
+
+For future AdMob releases, upload `admob-nextgen-X.Y.zip` to
+`https://htmlcodeplay.com/code-play-plugin/` and set `"admob-nextgen": "X.Y"`
+in that server's `versions.json`. Version the folder, and keep module filenames
+stable. The previous `admob-emi-nextgen` manifest key is accepted for versions
+4.0 and later during the transition. Apps automatically select a newer ZIP during
+their next normal pre-build; no per-app import changes are needed.
+For older manifests without a folder release entry, migration checks the required
+`admob-nextgen-4.1.zip` directly from the same server. If offline, an existing compatible
+installation is preserved; a missing required package stops the build.
+
+## Platform builds and shared validation
+
+Installing or updating `codeplay-common` updates the consuming project's `package.json`
+to use the copied unversioned 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-common/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)