SolarMeter FINAL RELEASE — Professional Motion v2.1

Base: SolarMeter_FINAL_RELEASE_SCENE06_07_08_ANIMATED_v2.0.c3p
Version: 2.1.0.0

Upgrade focus:
- Centralized motion durations and easing
- Consistent button hover/press/disabled/selected/success/warning feedback
- Fade + directional slide scene transitions with content stagger and NavigationLock
- Subtle ambient lab motion
- Scene 03 smooth modal animation, 3D intro settle and smooth FIT reset
- Scene 04 live tween response + sequential apply confirmation
- Scene 05 enhanced lift/move/orient/insert/lock motion, connection focus, cable draw, completion sweep
- Scene 06 deterministic DCV sampling and stable-reading feedback
- Scene 07 staged DCA reconfiguration, probe transfer and load response
- Scene 08 animated data pipeline, formula calculation, count-up and save-to-history motion
- Reduced Motion support and transform/opacity performance policy

No external runtime dependency added. Existing 15 native 3D model assets remain local.


SolarMeter v2.2 Anti-Flicker Hotfix
- Persistent shell: background/topbar/ambient DOM no longer rebuild on every interaction.
- Same-scene state changes no longer replay scene fade/stagger animations.
- Next/Back/Home transitions remain enabled.
- Main glass/topbar backdrop-filter removed to avoid Chrome/Windows compositor flashes.
- Repeating opacity blink indicators converted to steady state cues.
- Sound/music toggles update in-place.


SolarMeter v2.3 Cover + Clean UI
- Home screen replaced with the supplied SolarMeter cover artwork.
- Three transparent accessible hotspots preserve Studi Kasus, Panduan Alat and Mulai Praktikum navigation.
- Removed global top progress strip as marked in screenshots.
- Removed the marked primary scene labels from Scenes 03–10/report while preserving internal panel labels.
- Removed the marked Scene 03 bottom-right next button; station status retains the same continueTools function.
- No changes to simulator state, scoring, 3D inspection, experiments, calculations, persistence, offline behavior or anti-flicker logic.


SolarMeter v2.3.1 Cover Hotfix
- Fixes blank/broken home artwork in preview.construct.net.
- Uses runtime.assets.getProjectFileUrl("solarmeter-cover.png") before UI initialization.
- No learning logic, state, scoring, 3D inspection, assembly, measurement, analysis, reset or persistence behavior changed.


SolarMeter v2.4
- Replaced cover with menu-free supplied/generated artwork; home navigation is rendered by script/CSS.
- Added animated Studi Kasus, Panduan Alat and Mulai Praktikum cards without baking controls into the image.
- Fixed Scene 09 Add Scenario flow: saved snapshots are upserted/deduplicated into ExperimentHistory, re-numbered canonically, and the last two scenarios are selected for comparison.
- When Add Scenario is launched from Scene 09, saving the completed new scenario automatically returns to Scene 09 so the new table row is immediately visible.
- Existing simulator functionality remains intact.

SolarMeter v2.5 — Unified Solar Bright Theme
- Visual-only theme harmonization with the dynamic home cover.
- Bright royal-blue/cyan panels, solar-yellow primary CTAs, consistent cyan borders and solar accents across Scene 02–11.
- No changes to experiment state, navigation, 3D inspection, comparison logic, scoring, persistence, reset, audio, or offline behavior.


SolarMeter v2.8 — Fixed 16:9 UI + Scene 03 Space Optimization
- Internal canvas locked to 1600x900 (16:9) and uniformly scaled to browser viewport.
- Responsive reflow media rules removed; text and controls are never hidden due to narrow browser width.
- Scene 03 workbench uses more vertical space; 15 equipment cards enlarged with 5x3 fixed grid.
- Labels enlarged and kept visible; inspection summary remains present.
- Existing interaction/state/3D/experiment functions unchanged.


SolarMeter v2.9 Centered 16:9 hotfix
- Fixed root centering under CSS !important rules.
- Uses VisualViewport dimensions when available.
- Applies left/top/transform as inline !important so letterboxing is equal on both sides.
- Keeps fixed 1600x900 internal canvas and existing functionality.


V3 Hotfix — DCA cable + Scene 04 light control
- DCA red lead is now explicitly red from terminal block to meter A and separated visually from black COM return.
- Added distinct A/COM endpoint nodes to avoid perceived red-to-black cable conversion.
- Scene 04 intensity slider now has robust pointer mapping under the fixed 16:9 CSS scale.
- Sun/beam/rays are clickable as an additional intensity control and visibly respond to light level.
- Beam brightness, opacity and scale response strengthened.


V4 Mobile Legibility: enlarged small text across Scene 02-11 while preserving fixed 16:9 layout and all logic.

V5 Extra Large Mobile Legibility: enlarged remaining tiny instructional text, especially Scene 05 Assembly Coach tip, task list and procedure notes.


V6 proportional polish: rebalanced Scene 02-11 panels, increased small-text legibility, and upgraded Study Case cinematic observation flow. Logic/state preserved.


V7: Fixed clipped DCV/DCA procedure cards by restoring vertical grid; upgraded Scene 02 case-study cinematic with sequential observational focus, controlled cloud/light/lamp response, and calm post-intro motion. Existing practicum logic preserved.


V8 AUDIO INTEGRATION
- Installed 118 MP3 files from Audio Solar meter.zip as local project files.
- Added exclusive narration channel: starting any narration stops/resets the previous narration.
- Added scene narration, 15 equipment narrations, guided assembly step narrations, DCV/DCA narrations, power/energy, scenario comparison, evaluation/reflection, final completion, and MP3 SFX mapping.
- Added Narration toggle and Replay narration controls in the top bar.
- Music ducks while narration is speaking and restores afterward.
- All audio remains local/offline; no external URLs.


V8.2 SCENE BACKGROUND + BACKSOUND INTEGRATION
- Scene 01 keeps the existing SolarMeter cover and menu.
- The 10 supplied 16:9 images are installed sequentially as Scene 02–11 backgrounds.
- Backgrounds are optimized to 1600x900 WebP and rendered behind the existing interface with a dark readability veil; no content, controls, scoring, 3D, or interaction is replaced.
- User-supplied "Upbeat Decent Mayhem" MP3 is installed as the project BGM and loops continuously once browser audio is unlocked by user interaction.
- BGM starts at 8% volume and ducks to 1.8% while narration is active, then restores smoothly.
- Existing narration stays exclusive single-channel; SFX and all local narration files are retained unchanged.
- Existing Music toggle controls the new BGM.


V8.3 SOLAR FRESH EDU — LIGHT MULTICOLOR + 10 QUESTION EVALUATION
- Replaced dark blue-dominant functional UI with a bright educational palette: warm white, solar yellow, orange, sky blue, teal, green, purple and pink accents.
- Added a light readability veil over Scene 02–11 photographic backgrounds; content panels are near-white with dark text and stronger contrast.
- Preserved Scene 01 cover, all 3D, assembly, measurement, persistence, narration, SFX and V8.2 BGM/ducking.
- Expanded evaluation from 5 to 10 questions. Each correct answer is worth 10 points; total remains 100.
- Added questions on light intensity, panel angle, polarity, short-circuit safety and evidence-based comparison.
- Upgraded Scene 09 chart with multicolor scenario bars, average reference line, minimum/average/maximum summary cards, clearer labels and brighter tooltips.
- Upgraded Scene 10 mini power chart to use the same multicolor scenario identity.
- Saved-state scoring is recalculated from the 10-question bank using a dynamic 100/quiz.length value.


V8.4 SUNRISE SMART LAB — MAIN THEME FINAL
- Sunrise Smart Lab is now the main UI theme: warm cream, peach, solar amber, sky blue, turquoise, coral and lilac.
- High-opacity near-white/cream reading cards and dark ink text preserve readability over every Scene 02–11 photo background.
- No blur is applied to text or reading panels; scene art is only brightened/softened with a translucent color veil.
- The 10-question evaluation from V8.3 is retained: 10 points per correct answer, 100 points total.
- Scene 09 comparison chart keeps min/average/max cards and average guide line, with a new six-color Sunrise scenario palette and warmer chart canvas.
- Scene 10 mini chart uses the same scenario color identity for visual continuity.
- Backgrounds, upbeat BGM, BGM ducking, narration, SFX, 3D inspection, assembly, DCV/DCA measurement, scenario persistence and Scene 01–11 flow are preserved.


V8.5 BLUE SPECTRUM + 3 THEME SWITCHER — FINAL
- Blue Spectrum is the default theme and restores the original blue identity with cyan, turquoise, amber, coral and violet accents.
- Added three compact theme icons in the top bar: Blue Spectrum, Eco Tech and Sunrise Lab. Theme choice persists for the current session.
- All three themes avoid white-dominant visual surfaces. Reading panels use strongly tinted medium/dark surfaces with high-contrast text.
- Eco Tech uses teal/emerald/amber; Sunrise Lab uses coral/amber/plum/violet rather than cream/white.
- The 10-question evaluation remains 10 x 10 points = 100.
- Scene 09/10 comparison graphics keep the upgraded chart structure and now use a balanced six-color spectrum.
- Backgrounds, BGM + ducking, narration, SFX, 3D inspection, assembly, DCV/DCA, data persistence and Scene 01–11 flow are preserved.


V8.6 — ONE ICON THEME + FULLSCREEN
- Theme control simplified from three theme buttons to one cycling icon.
- Cycle order: Blue Spectrum (default) -> Aqua Modern (medium-bright) -> Sunrise Pop (bright) -> Blue Spectrum.
- Theme 2 and 3 use colored, non-white reading surfaces with dark high-contrast text.
- Added fullscreen icon in the top controls and on the home cover.
- Fullscreen supports standard and WebKit fullscreen events, and re-fits the fixed 16:9 viewport after changes.
- Existing 10-question evaluation, charts, backgrounds, BGM ducking, narration, SFX, 3D inspection and Scene 01-11 flow remain unchanged.


V8.7 — IBU ANISA VIRTUAL GUIDE
- Added SM_GUIDE_IBU_ANISA.png as the narration character asset.
- Every narration routed through playNarration() now shows Ibu Anisa plus readable narration companion text.
- Guide changes text automatically for queued narration clips and disappears automatically when narration ends/stops/errors.
- Guide is responsive and theme-aware for Blue Spectrum, Aqua Modern/Eco Tech, and Sunrise Pop.
- Existing BGM ducking, narration single-channel behavior, SFX, 10-question evaluation, backgrounds, fullscreen and theme controls are preserved.


V8.8 — HALF-BODY IBU ANISA + AUDIO-SYNC TYPEWRITER
- Ibu Anisa is now presented as a larger half-body/upper-body guide using responsive visual cropping of the existing transparent PNG.
- Replaced the previous shortened companion text with all 96 canonical narration transcripts supplied by the user.
- Transcript reveal is synchronised to the real narration HTMLAudioElement currentTime/duration, including punctuation-weighted pacing.
- Typewriter pauses with audio progress, restarts on replay, changes automatically across queued clips, completes at audio end, then guide fades out.
- Added narration progress line and typing caret while preserving BGM ducking, one-channel narration, SFX, three themes, fullscreen, 10-question evaluation and all Scene 01–11 interactions.

V8.9 Scene 02 Professional Study Case Upgrade
- Integrated 10 dedicated PNG assets for the investigation scene.
- Asset-driven panel/lamp cinematic, scan sweep, glow, staged factor cards, and hypothesis reveal.
- Existing narration, Ibu Anisa, themes, quiz, graph, audio ducking, and experiment logic preserved.

============================================================
V9.0 — SCIENCE CORRECTION FOR SMK (2026-09-27)
============================================================
Substansi keilmuan diselaraskan untuk pembelajaran SMK tanpa mengubah alur interaktif utama:
1. Variabel cahaya pada simulasi ditegaskan sebagai IRRADIANSI MODEL dengan satuan W/m², bukan lux.
2. Lux dan W/m² dijelaskan sebagai besaran berbeda. Tampilan W/m² berasal dari parameter/model simulasi, bukan konversi langsung lux meter.
3. Model sudut panel menggunakan geometri sederhana G_efektif = G × cos(theta_i). Sumber cahaya virtual tetap pada elevasi 60°, sehingga tilt 30° tegak lurus terhadap sumber pada konfigurasi simulasi ini; 30° bukan sudut optimum universal.
4. Temperatur sel dianggap tetap agar fokus eksperimen SMK berada pada irradiansi, orientasi panel, waktu pengujian, dan beban ekuivalen.
5. Respons PV disederhanakan: arus lebih sensitif terhadap irradiansi efektif, sedangkan tegangan berubah lebih moderat. Nilai bukan kurva I-V hasil kalibrasi modul nyata.
6. Istilah beban diperjelas menjadi beban ekuivalen ringan/sedang/berat.
7. Hipotesis 'rangkaian bermasalah' diposisikan sebagai diagnosis awal; rangkaian wajib diperbaiki sebelum pengukuran dan tidak diperlakukan sebagai variabel eksperimen kuantitatif.
8. Soal evaluasi tentang irradiansi dan sudut diperbaiki agar tidak memunculkan miskonsepsi.
9. Grafik/tabel/refleksi memakai istilah irradiansi dan beban ekuivalen secara lebih konsisten.
10. Rumus DC tetap: P = V × I dan E = P × t (untuk daya dianggap tetap selama interval simulasi).

Catatan pedagogis: model ini ditujukan untuk pemahaman konsep dan prosedur pengukuran level SMK, bukan desain/rekayasa sistem PV presisi.


V9.1 — SCENE 02 ANIMATION POLISH
- Scene 02 animation retimed to a calmer professional STEM cinematic.
- Sequence: problem focus -> panel inspection -> scan -> dim lamp symptom -> observation factors -> hypothesis workspace.
- Reduced excessive glow/scan motion and softened transforms.
- Hypothesis controls remain locked until the cinematic intro completes (~6.25 s).
- Ambient motion after intro is slower and less distracting.
- No scientific content, scoring, narration, themes, or other scenes were changed.


============================================================
V9.2 — FINAL RELEASE LOCK (2026-09-28)
============================================================
- Release metadata unified to SolarMeter V9.2 FINAL RELEASE / project version 9.2.0.0.
- Final session export identity updated to FINAL-V9.2-RELEASE-SMK.
- Removed two unused duplicate legacy ElevenLabs MP3 assets from the project registry and package.
- Scene 02 hypothesis controls are now narration-safe: while Ibu Anisa plays Intro Kasus -> Observasi -> Pertanyaan Pemantik, choices remain visible but disabled.
- Choices unlock automatically after S02_03_PertanyaanPemantik.mp3 completes.
- If narration is disabled, hypothesis controls unlock immediately.
- Replaying Scene 02 narration temporarily re-locks hypothesis controls until the prompt finishes, preventing accidental narration interruption.
- Returning to Scene 02 after the intro has already completed does not automatically replay the full intro; Replay Narration remains available.
- V9.1 cinematic polish, V9.0 SMK science corrections, all 3 themes, fullscreen, Ibu Anisa typewriter, 10-question evaluation, charts, 3D, assembly, DCV/DCA, backgrounds and BGM ducking remain intact.
- Feature scope is locked for release; subsequent changes should be bug fixes only.
