codeplay-common 4.8.2 → 4.8.3

package/README.md

@@ -33,6 +33,21 @@ If `onesignal-cordova-plugin` is declared or installed, the pre-build script war
 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.

package/files/take-screen-image.js

@@ -26,12 +26,12 @@ const path = require('node:path');
 const readline = require('node:readline/promises');
 const { spawn, spawnSync } = require('node:child_process');
 const sharp = require('sharp');
-const { frameStyles, createFrameSamples } = require('./scripts-screenshot/screenshot/frame-samples.js');
+const { frameStyles, createFrameSamples } = require('./scripts/screenshot/frame-samples.js');
 const {
   getDecorationSeed,
   createPromotionalDecorations,
   getPromotionalDecorationStyles,
-} = require('./scripts-screenshot/screenshot/background-decorations.js');
+} = require('./scripts/screenshot/background-decorations.js');
 
 const screenshotDirectory = path.join(__dirname, 'Auto-Screenshot', 'Store-image-Screenshot');
 const inFrameDirectory = path.join(__dirname, 'Auto-Screenshot', 'Store-image-Frame');
@@ -727,6 +727,20 @@ function deleteMatchingImages(input) {
   for (const filePath of deletedFiles) console.log(`Deleted: ${filePath}`);
 }
 
+function initializeScreenshotData() {
+  for (const [filePath, version] of [
+    [screenshotCopyPath, 1],
+    [screenshotInfoPath, 2],
+  ]) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    try {
+      fs.writeFileSync(filePath, `${JSON.stringify({ version, screenshots: {} }, null, 2)}\n`, { flag: 'wx' });
+    } catch (error) {
+      if (error.code !== 'EEXIST') throw error;
+    }
+  }
+}
+
 function readScreenshotRecordSource(filePath) {
   if (!fs.existsSync(filePath)) return { screenshots: {} };
 
@@ -3793,6 +3807,10 @@ async function main() {
 
   options = await getInteractiveOptions(options);
 
+  if (!options.dryRun) {
+    initializeScreenshotData();
+  }
+
   if (!options.dryRun && !options.refreshInfo) {
     reconcileScreenshotRecords();
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeplay-common",
-  "version": "4.8.2",
+  "version": "4.8.3",
   "description": "Common build scripts and files",
   "scripts": {
 	"postinstall": "node scripts/sync-files.js",

package/scripts/sync-files.js

@@ -25,6 +25,8 @@ function copyFolderSync(source, destination) {
 
 // Copy all files from `common-build-files/files/` to the project root
 fs.readdirSync(commonBuildPath).forEach(file => {
+    // Never distribute or overwrite app-owned screenshot data.
+    if (file === "scripts-screenshot") return;
     const sourcePath = path.join(commonBuildPath, file);
     const destPath = path.join(projectRoot, file);
 

package/scripts/uninstall.js

@@ -70,7 +70,8 @@ filesInProject.forEach(file => {
 if (fs.existsSync(commonBuildPath)) {
     fs.readdirSync(commonBuildPath).forEach(file => {
         const destPath = path.join(projectRoot, file);
-        if (file === "scripts" || isAgentInstructionAsset(file)) {
+        // Screenshot data belongs to the app, including folders from older releases.
+        if (file === "scripts" || file === "scripts-screenshot" || isAgentInstructionAsset(file)) {
             return;
         }
         if (fs.existsSync(destPath)) {
@@ -88,6 +89,19 @@ if (fs.existsSync(commonBuildPath)) {
     });
 }
 
+for (const helperDirectory of [
+    path.join(projectRoot, "scripts", "screenshot"),
+    path.join(projectRoot, "scripts-screenshot", "screenshot")
+]) {
+    for (const helperName of ["frame-samples.js", "background-decorations.js"]) {
+        const helperPath = path.join(helperDirectory, helperName);
+        if (fs.existsSync(helperPath)) {
+            fs.unlinkSync(helperPath);
+            process.stdout.write(`🗑️ Removed file: ${helperPath}\n`);
+        }
+    }
+}
+
 if (fs.existsSync(baselineProfileSetupScript)) {
     try {
         fs.unlinkSync(baselineProfileSetupScript);

package/files/scripts-screenshot/screenshot/screenshot-copy.json

@@ -1,3 +0,0 @@
-{
-  
-}