@gentbajko/slopify 3.18.0 → 3.18.2

package/dist/patch-notes/3.18.1.md

@@ -0,0 +1,11 @@
+# Slopify 3.18.1
+
+Released 11 October 2026.
+
+- **Your images are kept with your video.** Every image the video shows now sits in the project's `Upload/Images/` folder, in order, and each short's images sit beside that short in `Upload/Shorts/<n> - <title>/`. An older version's images go to `Upload/Images/Earlier/<date>/` instead of `History/`. They used to be under `Working/` and `History/`.
+- **Cleanup no longer deletes images.** **Keep outputs only**, **Free space**, **Delete old versions** and **Clean up everything** keep every image the video and shorts used, from every version. Before, they deleted them as working files, and making them again never gives the same pictures.
+
+## Upgrading from 3.18.0
+
+- On the first start, finished projects move their images from `Working/` and `History/` into `Upload/` by themselves. Nothing is copied, so this takes no extra space.
+- Images an earlier cleanup already deleted can't be brought back by this update. A backup made before the cleanup still has them; otherwise remaking the images makes new ones.

package/dist/patch-notes/3.18.2.md

@@ -0,0 +1,10 @@
+# Slopify 3.18.2
+
+Released 11 October 2026.
+
+- **Each image is named by its scene.** In a project's Images, every image is titled by its own scene, for example "Explorers scramble along a rock shelf above a fossil sea…", instead of the prompt's opening, which was the same on every image.
+- **The full-size view says the prompt once.** The scene is on the top bar and the whole prompt is under the picture, instead of the whole prompt in both places.
+
+## Upgrading from 3.18.1
+
+- Nothing becomes outdated; existing images get their titles at once.

package/dist/patch-notes/index.json

@@ -1,4 +1,16 @@
 [
+  {
+    "id": "3.18.2",
+    "title": "Slopify 3.18.2",
+    "version": "3.18.2",
+    "date": "2026-10-11"
+  },
+  {
+    "id": "3.18.1",
+    "title": "Slopify 3.18.1",
+    "version": "3.18.1",
+    "date": "2026-10-11"
+  },
   {
     "id": "3.18.0",
     "title": "Slopify 3.18.0",

package/dist/slices/storage/arrange.js

@@ -5,7 +5,13 @@ import { backupsFolderName, projectDir, renderCacheFolder } from "./layout.js";
 // The file in each project folder that says which project it is, for when the database and
 // the folders disagree (a restored database, a folder renamed by hand). Reconcile keeps it.
 export const projectMarker = ".slopify-project";
-// What makes a project's arrangement current: its title, head version and files. A project
+// The pictures a video or short shows. Every version's stay in Upload, an older version's under
+// Images/Earlier/<date>/, never in History: making them again never gives the same ones.
+const imageRoles = new Set(["image", "animated_image", "short_image"]);
+// Raised when a role's place changes, so every project arranged by the older places is moved
+// once: 2 put every version's images the video and shorts show into Upload (3.18.1).
+const layoutVersion = 2;
+// What makes a project's arrangement current: the layout, its title, head version and files. A project
 // whose key is unchanged since it was last arranged is left alone.
 export function arrangeKeys(db) {
     const keys = new Map();
@@ -16,7 +22,10 @@ export function arrangeKeys(db) {
         (SELECT count(*)||':'||COALESCE(max(r.id),'') FROM revision_outputs r WHERE r.project_id=p.id AND r.selected=1 AND r.revision_id=h.revision_id) AS current
        FROM projects p LEFT JOIN project_heads h ON h.project_id=p.id`)
         .all())
-        keys.set(String(row.id), [row.title, row.revision_id, row.assets, row.legacy, row.current].map(String).join("|"));
+        keys.set(String(row.id), [
+            `layout ${layoutVersion}`,
+            ...[row.title, row.revision_id, row.assets, row.legacy, row.current].map(String),
+        ].join("|"));
     return keys;
 }
 // Whether anything of the project runs or may start: its files stay where they are until then.
@@ -241,7 +250,9 @@ export function desiredPlaces(db, projectId) {
         const place = placeFor(reference, order, titles);
         out.set(reference.path, reference.current
             ? place
-            : `History/${day(reference.createdAt)}/${place.replace(/^Upload\//u, "")}`);
+            : imageRoles.has(reference.role)
+                ? `Upload/Images/Earlier/${day(reference.createdAt)}/${place.replace(/^Upload\/(?:Images\/)?/u, "")}`
+                : `History/${day(reference.createdAt)}/${place.replace(/^Upload\//u, "")}`);
     }
     return out;
 }
@@ -286,14 +297,16 @@ function placeFor(reference, order, titles) {
             const key = /^image:(.+)$/u.exec(slot)?.[1];
             const at = key === undefined ? undefined : order.get(key);
             return at === undefined
-                ? `Working/Images/${file}`
-                : `Working/Images/${pad(at + 1)}${extension}`;
+                ? `Upload/Images/${file}`
+                : `Upload/Images/${pad(at + 1)}${extension}`;
         }
         case "short_image": {
             const match = /^shorts:([0-9]+):image:([0-9]+)$/u.exec(slot);
-            return match === null
-                ? `Working/Shorts/${file}`
-                : `Working/Shorts/Short ${match[1]}/image ${match[2]}${extension}`;
+            if (match === null)
+                return `Upload/Shorts/Images/${file}`;
+            // Beside the short's video, in a folder named like it: Shorts/3 - Title/image 1.png.
+            const title = titles.get(Number(match[1]));
+            return `Upload/Shorts/${match[1]}${title === undefined || title === "" ? "" : ` - ${clean(title)}`}/image ${match[2]}${extension}`;
         }
         case "figure_card":
             return `Working/Cards/${file}`;

package/dist/slices/storage/trim.js

@@ -5,8 +5,9 @@ import { liveProject, projectExists, projectPaused, stagesOf } from "../admissio
 import { projectSettled } from "./arrange.js";
 import { backupsFolderName, outputPath, projectDir } from "./layout.js";
 import { pieceFile } from "./reconcile.js";
-// Keep outputs only: a finished project drops the working files it was made from (images,
-// narration parts, subtitle timing, render settings) and keeps what gets published. Two
+// Keep outputs only: a finished project drops the working files it was made from (narration
+// parts, subtitle timing, render settings) and keeps what gets published, the images the
+// video and shorts show included: making them again costs money and never gives the same ones. Two
 // rules keep it safe. A file the user supplied is never removed, because nothing could make
 // it again. And only files a project record names are removed: anything else in the folder
 // is reconcile's business (`reconcile.ts`), which leaves the Backups folder alone.
@@ -28,6 +29,9 @@ export const outputRoles = [
     "audio_export",
     "subtitles_srt",
     "subtitles_vtt",
+    "image",
+    "animated_image",
+    "short_image",
 ];
 export function projectStorage(deps, projectId) {
     const files = filesOf(deps.paths, projectId);

package/dist/tutorials/Project-Page.md

@@ -197,7 +197,7 @@ Only generated steps can have a checkpoint. Pausing the project still applies on
 
 ## Free space
 
-A finished project can drop the working files it was made from (images, narration parts, subtitle timing, render settings) and keep what gets published: the video, shorts, thumbnail, article, description, document and anything you uploaded. In the right rail, **Free space** shows the size of both, for example "Outputs 1.4 GB · working files 1.2 GB", with the button **Free 1.2 GB: keep the outputs, drop the working files**.
+A finished project can drop the working files it was made from (narration parts, subtitle timing, render settings) and keep what gets published: the video, shorts, the images they show, thumbnail, article, description, document and anything you uploaded. In the right rail, **Free space** shows the size of both, for example "Outputs 1.4 GB · working files 1.2 GB", with the button **Free 1.2 GB: keep the outputs, drop the working files**.
 
 1. Press the button.
 2. Read what goes, then confirm with **Free 1.2 GB**, or press **Keep the working files**.

package/dist/tutorials/Settings-Reference.md

@@ -198,7 +198,7 @@ After importing, enter your keys again in Settings → Providers. You can also r
 |---|---|
 | **Disk space** | What Slopify stores: the total, project files, staged uploads, and deleted projects still in the trash (freed when the trash removes them after 30 days, or with **Delete now**). |
 | Storage by project | Each project's size, split into outputs and working files, largest first. A finished project's page offers the same on its own (**Free space**, see [Project Page](Project-Page#free-space)). |
-| **Keep outputs only** | On a finished project, deletes the working files (images, narration parts, subtitle timing, render settings) and keeps the video, shorts, thumbnail, article, description, document and your uploads. You confirm first. Changing the project later makes those files again, which takes time and provider credits. |
+| **Keep outputs only** | On a finished project, deletes the working files (narration parts, subtitle timing, render settings) and keeps the video, shorts, the images they show, thumbnail, article, description, document and your uploads. You confirm first. Changing the project later makes those files again, which takes time and provider credits. |
 
 ### Sample projects
 

package/dist/tutorials/Where-Your-Files-Live.md

@@ -31,8 +31,8 @@ Each project has one folder in `Projects/`, named after its title (`Lolth | D&D
 
 | Folder | What is in it | Safe to delete? |
 | --- | --- | --- |
-| `Upload/` | The current version, ready to publish: `video.mp4`, `thumbnail.png` (and `thumbnail 2.png`…), `subtitles.srt` and `.vtt`, `description.txt`, `tags.txt`, `titles.txt`, `pinned comment.txt`, `document.pdf`, `article.md`, and `Shorts/1 - <title>.mp4`… | No: it is what you upload. |
-| `Working/` | What the current version was made from: `Images/`, `Narration/` (each chunk, the joined and levelled narration), `Research/`, `Article/`, `Subtitles/`, `Render/`, `Shorts/` (each short's images). | Only to free space on a finished video: changing that project later makes these again, which takes time and provider credits. **Keep outputs only** does it for you. |
+| `Upload/` | The current version, ready to publish: `video.mp4`, `thumbnail.png` (and `thumbnail 2.png`…), `subtitles.srt` and `.vtt`, `description.txt`, `tags.txt`, `titles.txt`, `pinned comment.txt`, `document.pdf`, `article.md`, `Images/` (every image the video shows, in order; an older version's images in `Images/Earlier/<date>/`), and `Shorts/1 - <title>.mp4`… with each short's images beside it in `Shorts/1 - <title>/`. No cleanup ever deletes these images. | No: it is what you upload. |
+| `Working/` | What the current version was made from: `Narration/` (each chunk, the joined and levelled narration), `Research/`, `Article/`, `Subtitles/`, `Render/`. | Only to free space on a finished video: changing that project later makes these again, which takes time and provider credits. **Keep outputs only** does it for you. |
 | `History/<date>/` | Files of older versions, by the day they were made (an earlier render, the narration before a voice change). | Yes. Delete a day's folder, or all of `History/`, to free its space. Going back to that version in History makes its files again. |
 
 A hidden `.slopify-project` file tells Slopify which project the folder holds and where its files went. Leave it there.
@@ -132,7 +132,7 @@ Deleted projects free their space when the trash removes them after 30 days, or
 
 ### Keep outputs only
 
-On a finished project, **Keep outputs only** deletes the working files it was made from (images, narration parts, subtitle timing, render settings) and keeps the video, shorts, thumbnail, article, description, document and your uploads.
+On a finished project, **Keep outputs only** deletes the working files it was made from (narration parts, subtitle timing, render settings) and keeps the video, shorts, the images they show, thumbnail, article, description, document and your uploads.
 
 1. Find the project in the **Disk space** list. The button says how much it frees.
 2. Press **Keep outputs only**.