Updates

Major restructure:
- Remove Paper feature entirely (IPaperSurface, PaperSurface, PaperSurfaceModule).
  Paper is just RectTransforms in the ColorBook scene, exposed via a
  ColorBookSceneRefs MonoBehaviour the scope registers as a singleton.
- Simplify IGalleryService to a single SaveToDeviceAsync(byte[], albumName)
  shim over a native gallery plugin. Drop ListAsync / LoadFullAsync /
  LoadThumbnailAsync / DeleteAsync / GetLatestThumbnailAsync /
  SavedArtworkDTO / sidecar JSON / persistentDataPath gallery folder.
- Drop ArtBook feature (no in-app gallery — users view captures in phone
  Photos). Removes ArtBookLifetimeScope, GalleryPresenter, IExternalShareService.
- Replace ArtworkCapturedSignal / ArtworkSavedSignal with PaperCapturedSignal /
  PaperSavedSignal (templateId only).
- Capture and Gallery are now independent: ICaptureService produces PNG bytes,
  IGalleryService writes them to native Photos. CaptureController orchestrates
  the chain.
- Rewrite §11 Persistence — only ProtectedPlayerPrefs for settings/progression;
  no app-side image store.
- Remove §28 SavedArtwork JSON Schema; replace with §28 Native Gallery
  Integration (plugin recommendations, permission flows).
- Add §31b: Scripts Inventory by Domain — comprehensive path-by-path table
  of every script (existing and planned) across Core / Libs / Services /
  Features / App, with status markers.
- Update Readme.docx — better formatting (page break before each numbered
  section, blue heading underlines, alternating row shading on tables,
  monospace code blocks with left accent bar, expanded title page).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Assets/Darkmatter/Code/Core/Contracts/Services/Gallery/IGalleryService.cs

@@ -1,3 +1,4 @@
+using System.Threading;
 using Cysharp.Threading.Tasks;
 using UnityEngine;
 
@@ -5,6 +6,7 @@ namespace Darkmatter.Core.Contracts.Services.Gallery
 {
     public interface IGalleryService
     {
-        void SaveImageAsync(Texture2D sprite, string fileName);
+        UniTask SaveImageAsync(Texture2D sprite, string fileName,
+            CancellationToken cancellationToken);
     }
 }

Assets/Darkmatter/Code/Services/Gallery/Core/GalleryService.cs

@@ -1,3 +1,6 @@
+using System;
+using System.Threading;
+using Cysharp.Threading.Tasks;
 using Darkmatter.Core.Contracts.Services.Gallery;
 using UnityEngine;
 
@@ -5,9 +8,36 @@ namespace Darkmatter.Services.Gallery
 {
     public class GalleryService : IGalleryService
     {
-        public void SaveImageAsync(Texture2D image, string fileName)
+        public async UniTask SaveImageAsync(Texture2D image, string fileName, CancellationToken cancellationToken)
         {
-            NativeGallery.SaveImageToGallery(image, "ColorBook", fileName);
+            var permission = await NativeGallery.RequestPermissionAsync(NativeGallery.PermissionType.Write,
+                NativeGallery.MediaType.Image);
+
+            if (permission != NativeGallery.Permission.Granted)
+            {
+                return;
+            }
+
+            var tcs = new UniTaskCompletionSource();
+            var registration = cancellationToken.Register(() => tcs.TrySetCanceled(cancellationToken));
+
+            NativeGallery.SaveImageToGallery(image, "Colorbook",
+                filename: $"colorbook_{DateTime.UtcNow:yyyyMMdd_HHmmss}.png", callback: (success, path) =>
+                {
+                    registration.Dispose();
+                    if (!success)
+                    {
+                        Debug.LogError("Failed to save image to gallery.");
+                    }
+                    else
+                    {
+                        Debug.Log($"Image saved to gallery at: {path}");
+                    }
+
+                    tcs.TrySetResult();
+                });
+
+            await tcs.Task;
         }
     }
 }

Assets/Darkmatter/Code/Services/Gallery/Services.Gallery.asmdef

@@ -5,7 +5,8 @@
         "GUID:6a0a834eb41764f12ba55c3fb04a40cb",
         "GUID:c1c03c0e5b2f4412b9f2be1c20d6a9b1",
         "GUID:b0214a6008ed146ff8f122a6a9c2f6cc",
-        "GUID:6e5063adab271564ba0098a06a8cebda"
+        "GUID:6e5063adab271564ba0098a06a8cebda",
+        "GUID:f51ebe6a0ceec4240a699833d6309b23"
     ],
     "includePlatforms": [],
     "excludePlatforms": [],