fix: remove base presentation layer

docs/Concepts.md

@@ -109,7 +109,6 @@ const presentationState = constructPresentationState(presentations);
 
 Presentation state includes:
 
-- `base`: Base layout/screen configuration
 - `background`: Current background or CG
 - `dialogue`: Speaker, text content, mode (ADV/NVL)
 - `character`: Character sprites and positions

docs/RouteEngine.md

@@ -420,7 +420,6 @@ Actions that can be attached to lines to control presentation:
 
 | Action       | Properties                                                  | Description                                                                                       |
 | ------------ | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
-| `base`       | `{ resourceId }`                                            | Set base layout                                                                                   |
 | `background` | `{ resourceId, animations? }`                               | Set background/CG                                                                                 |
 | `dialogue`   | `{ characterId?, character?, content, mode?, ui?, clear? }` | Display dialogue                                                                                  |
 | `character`  | `{ items }`                                                 | Display character sprites. Each item can have optional `x` and `y` to override transform position |

package.json

@@ -1,6 +1,6 @@
 {
   "name": "route-engine-js",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "A lightweight Visual Novel engine built in JavaScript for creating interactive narrative games with branching storylines",
   "repository": {
     "type": "git",

spec/system/constructPresentationState.spec.yaml

@@ -5,13 +5,13 @@ suites: [constructPresentationState]
 suite: constructPresentationState
 exportName: constructPresentationState
 ---
-case: construct presentation state with single base action
+case: construct presentation state with single background action
 in:
-  - - base:
-        resourceId: "mainBase"
+  - - background:
+        resourceId: "mainBackground"
 out:
-  base:
-    resourceId: "mainBase"
+  background:
+    resourceId: "mainBackground"
 ---
 case: construct presentation state with control action
 in:
@@ -39,16 +39,12 @@ out:
 ---
 case: construct presentation state with multiple actions in one presentation
 in:
-  - - base:
-        resourceId: "mainBase"
-      background:
+  - - background:
         resourceId: "bgImage"
       bgm:
         resourceId: "backgroundMusic"
         loop: true
 out:
-  base:
-    resourceId: "mainBase"
   background:
     resourceId: "bgImage"
   bgm:
@@ -58,15 +54,11 @@ out:
 case: construct presentation state with clean all and multiple presentations
 in:
   - - cleanAll: true
-      base:
-        resourceId: "oldBase"
-    - base:
-        resourceId: "newBase"
       background:
+        resourceId: "oldBg"
+    - background:
         resourceId: "newBg"
 out:
-  base:
-    resourceId: "newBase"
   background:
     resourceId: "newBg"
 ---

spec/system/constructRenderState.spec.yaml

@@ -5,70 +5,94 @@ suites: [constructRenderState]
 suite: constructRenderState
 exportName: constructRenderState
 ---
-case: construct render state with single base action
+case: construct render state with single background layout action
 in:
   - - presentationState:
-        base:
-          resourceId: "mainBase"
+        background:
+          resourceId: "mainBackground"
       resources:
         layouts:
-          mainBase:
+          mainBackground:
             elements:
               - type: "container"
-                id: "base-container"
+                id: "background-container"
 out:
   elements:
     - id: "story"
       type: "container"
       x: 0
       y: 0
       children:
-        - id: "base"
+        - id: "bg-cg-mainBackground"
           type: "container"
           children:
             - type: "container"
-              id: "base-container"
+              id: "background-container"
   animations: []
   audio: []
   global: {}
 ---
-case: construct render state with multiple actions in one presentation
+case: construct render state keeps controls behind background and layout
 in:
   - - presentationState:
-        base:
-          resourceId: "mainBase"
+        control:
+          resourceId: "gameplay"
         background:
           resourceId: "bgImage"
+        layout:
+          resourceId: "foregroundLayout"
       resources:
-        layouts:
-          mainBase:
-            elements:
-              - type: "container"
-                id: "base-container"
         images:
           bgImage:
             fileId: "background.jpg"
             width: 1920
             height: 1080
+        controls:
+          gameplay:
+            elements:
+              - id: "control-hitbox"
+                type: "rect"
+                x: 0
+                y: 0
+                width: 100
+                height: 100
+        layouts:
+          foregroundLayout:
+            elements:
+              - type: "container"
+                id: "foreground-container"
 out:
   elements:
     - id: "story"
       type: "container"
       x: 0
       y: 0
       children:
-        - id: "base"
+        - id: "control-gameplay"
           type: "container"
+          x: 0
+          y: 0
           children:
-            - type: "container"
-              id: "base-container"
+            - id: "control-hitbox"
+              type: "rect"
+              x: 0
+              y: 0
+              width: 100
+              height: 100
         - id: "bg-cg-bgImage"
           type: "sprite"
           x: 0
           y: 0
           src: "background.jpg"
           width: 1920
           height: 1080
+        - id: "layout-foregroundLayout"
+          type: "container"
+          x: 0
+          y: 0
+          children:
+            - type: "container"
+              id: "foreground-container"
   animations: []
   audio: []
   global: {}
@@ -77,25 +101,18 @@ case: construct render state with clean all and multiple presentations
 in:
   - - presentationState:
         cleanAll: true
-        base:
-          resourceId: "oldBase"
+        background:
+          resourceId: "oldBg"
       resources:
         layouts:
-          oldBase:
+          oldBg:
             elements:
               - type: "container"
                 id: "old-container"
     - presentationState:
-        base:
-          resourceId: "newBase"
         background:
           resourceId: "newBg"
       resources:
-        layouts:
-          newBase:
-            elements:
-              - type: "container"
-                id: "new-container"
         images:
           newBg:
             fileId: "new-background.jpg"
@@ -108,12 +125,7 @@ out:
       x: 0
       y: 0
       children:
-        - id: "base"
-          type: "container"
-          children:
-            - type: "container"
-              id: "new-container"
-        - id: "base"
+        - id: "bg-cg-oldBg"
           type: "container"
           children:
             - type: "container"
@@ -127,4 +139,4 @@ out:
           height: 1080
   animations: []
   audio: []
-  global: {}
+  global: {}