BITESIZE READING LIBRARY V4.8.0 — PHASE 3 READING STUDIO COMPANIONS
====================================================================

WHAT IS NEW
- Detects a registered Reading Studio product by its bitesize-resource.json "studio" block.
- Shows a dedicated Studio page with Teacher Mode, Student Mode, Print Center and Reading Toolkit.
- Preserves permanent Product IDs for Studio and the two related Core reading products.
- Reads VERIFIED "related_products" or "verified_related_product_index" relationships published by Catalogue Manager V4.1.0. Candidate/unverified links do not appear as confirmed.
- Enables safe, multi-file offline Studio setup: copy all files into Reading Library Files/studios/PRODUCT_ID via a folder picker where supported, or extract manually.
- Offers a separate student-only ZIP download when the imported Studio contains STUDENT_ONLY_SHARING.zip.
- Leaves the traditional Core reading, Digital Escape Room, assessment and verified standards routes intact.
- Keeps the purchased Studio ZIP stored inside the Library browser database; it is NOT included in the Reading Library software ZIP.

IMPORTANT: SAFEGUARD YOUR EXISTING READING LIBRARY
1. Back up your current Reading Library folder before replacing any files.
2. If your Library already contains resources or assessments, OPEN IT USING THE SAME BROWSER PROFILE as before. Installed ZIPs and classes are stored by the browser (IndexedDB/localStorage), not in this downloaded software ZIP.
3. For an in-place upgrade, use the V4.8.0 UPGRADE ONLY ZIP and copy its files into your EXISTING "Reading Library Files" folder, preserving the original path. Do not delete the existing folder and do not clear browser data.
4. Keep your original V4.7.4 ZIP as a rollback option.
5. Until this is a published production release, open START_READING_LIBRARY.html directly. Automatic software updates are managed separately and may deliver official public versions.

TO ADD HEADLESS HORSEMAN READING STUDIO
1. Use Product Registrar V1.5 to register your commercial Reading Studio ZIP. The Registrar generates a registered ZIP and a Catalogue Manager .bitesizepresentation import file. Keep the generated permanent Product ID for future versions.
2. Import and review the .bitesizepresentation in Catalogue Manager V4.1.0. Do not replace either existing Core product. Verify the two exact Core product relationships, export the updated catalog.json and publish it via your normal catalogue delivery route.
3. In Reading Library V4.8.0, select Add Resource and import the REGISTERED ZIP (not the original unregistered commercial ZIP and not the .bitesizepresentation alone).
4. The Library shows a special Reading Studio card. Open it.
5. Choose "Set up offline Studio". In Chrome or Edge, when the folder chooser appears, select the precise folder that already contains START_READING_LIBRARY.html. The Studio will be written under studios/PRODUCT_ID/.
6. If the folder picker is unavailable, choose Download installed ZIP and extract the contents manually into:
   Reading Library Files/studios/PRODUCT_ID/
   Ensure "index.html", "student.html", "studio.js", "studio.css" and "printables/" are directly inside that directory (not inside an extra nested folder). Then choose "I extracted the Studio here manually".
7. Open Teacher Mode, Student Mode, Print Center or Reading Toolkit from the Studio card. If you import a new Studio version with the SAME Product ID, use "Update local Studio files" to replace the local copies.
8. The Student Mode shortcut is for teacher-supervised use on the same machine. For independent pupil access, use the separate Student-Only Sharing ZIP. Do not share the full teacher ZIP because it includes teacher answer materials.

CATALOGUE MATCHING RULES
- Only exact permanent Product IDs are used for Studio/Core relationships.
- Only VERIFIED Catalogue Manager links count as companion relationships.
- Candidate links in a Registrar manifest must be approved in Catalogue Manager first.
- Installing Studio doesn't automatically verify standards, confer ownership of a Core product, or prove curriculum mastery.
- If you have approved the links but they don't appear, confirm your latest exported catalog.json has been published and the Library has refreshed its live catalogue (or cached it successfully).

OFFLINE & COMPATIBILITY
- Downloadable Studio ZIPs are stored in the browser's persistent storage after import.
- The Studio must be extracted to disk for complete JavaScript/CSS/image/PDF relative paths. A temporary blob URL, suitable for a one-file escape room, is not sufficient for Reading Studio.
- Automatic folder setup uses the File System Access API (recent Chromium browsers). It may not be offered by every browser, managed school device or operating system. Manual extraction is always possible.
- The existing Reading Library software does not bundle proprietary Studio lesson content. A purchased Studio still needs importing separately.
- The Library itself can be opened with START_READING_LIBRARY.html. The Studio runs as an ordinary local HTML resource after extraction.

TEST SCOPE
- JavaScript syntax: PASS.
- Registrar sample manifest/required files: PASS.
- Browser UI component smoke tests (no page errors): PASS.
- Studio buttons, Studio tagging, candidate/verified product relationship behavior: PASS.
- Folder setup and file writing exercised with a simulated directory picker: PASS.
- Normal end-to-end file:// browser launch and actual OS directory picker: NOT verified in this restricted environment. Verify on your own computer before publishing V4.8.0 widely.

© 2026 Bitesize Education
