; =====================================================================
; CBS Cruncher v5.5 - Screen 5-8 reusable-buffer decruncher v1.2
; =====================================================================
; Assembled size:
;   - 358 bytes (dynamic Screen 5-8, dynamic VDP port init (CBS_INIT_MSX))
;   - Category range: 319 to 358 bytes (321 B fixed Screen 5/7, 358 B dynamic)
;
; Decrunches a C3h v5.5 image or a C4h sequence of independent v5.5 chunks.
; Every EOS uploads the completed RAM chunk with HMMC. C4h then advances Y and
; reuses the same caller-selected buffer until the complete image is restored.
;
; Interrupt & Stack Safety:
;   - 100% safe with MSX BIOS interrupts (EI) enabled during token parsing.
;   - Never uses SP as a data pointer or reads below SP.
;   - Uses DI during atomic VDP port setup and HMMC transfer.
;   - Preserves alternate register set (BC', DE', HL' are untouched).
;
; Input:
;   HL = CBS image container (C3h or C4h)
;   DE = packed destination coordinate (D = packed X, E = Y)
;   IX = start of the selected 1/2/4/8/16 KB reusable RAM buffer
;   A  = call route (bits 3-2 = VRAM command page 0-3, bits 1-0 = source)
;
; Public entry points:
;   CBS_INIT_MSX    call once after copying the decoder to RAM
;   CBS_INIT_SCREEN A = 5, 6, 7 or 8; call when Screen mode changes
;   CBS_DECRUNCH    normal image-decompression entry
; =====================================================================
CBS_INIT_MSX:
        JP      CBS_V52_INIT_MSX
CBS_INIT_SCREEN:
        JP      CBS_V52_INIT_SCREEN
CBS_DECRUNCH:

CBS_V52_SCREEN58_RAM_TO_VRAM:
        AND     0Ch
        RRCA
        RRCA
        LD      B,D                     ; B = packed X
        LD      D,A                     ; DE = (page << 8) | Y
        LD      (CBS_V52_VRAM_DY),DE

        EX      DE,HL                   ; DE = container
        LD      L,B
        LD      H,00h
CBS_V52_SCREEN_SHIFT_X:
        ADD     HL,HL
        NOP
        LD      (CBS_V52_VRAM_DX),HL
        EX      DE,HL                   ; HL = container

        LD      A,(HL)                  ; C3h or C4h
        INC     HL
        CP      C4h
        LD      A,(HL)                  ; packed width (0 = 256)
        INC     HL
        LD      C,01h                   ; 1 chunk for C3h
        JR      NZ,CBS_V52_VRAM_HEADER_READY
        INC     HL                      ; skip C4h total height
        LD      C,(HL)                  ; C4h chunk count
        INC     HL
CBS_V52_VRAM_HEADER_READY:
        EX      DE,HL
        DEC     A
        LD      L,A
        LD      H,00h
        INC     HL                      ; HL = 16-bit byte width (1..256)
        LD      (CBS_V52_VRAM_ROW_WIDTH+1),HL
CBS_V52_SCREEN_SHIFT_NX:
        ADD     HL,HL
        NOP
        LD      A,H
        AND     01h                     ; command NX wraps 512 dots to 000h
        LD      H,A
        LD      (CBS_V52_VRAM_NX),HL
        EX      DE,HL
        LD      A,C
        LD      (CBS_V52_VRAM_CHUNKS+1),A

CBS_V52_VRAM_CHUNK_START:
        LD      A,(HL)                  ; chunk line count (0 = 256)
        INC     HL
        DEC     A
        LD      C,A
        LD      B,00h
        INC     BC
        LD      (CBS_V52_VRAM_NY),BC

        PUSH    IX
        POP     DE                      ; DE = start of reusable RAM buffer
        LD      A,80h                   ; sentinel control-bit reservoir
        LD      BC,FFFFh                ; default negative offset = -1
        PUSH    BC                      ; persistent last offset on stack

; ---------------------------------------------------------------------
; v5.5 line-aware parser.
; ---------------------------------------------------------------------
CBS_V52_VRAM_ROW_START:
        CALL    CBS_V52_VRAM_GET_GAMMA
        JR      CBS_V52_VRAM_COPY_LITERALS

CBS_V52_VRAM_AFTER_LITERAL:
        CALL    CBS_V52_VRAM_GET_BIT
        JR      C,CBS_V52_VRAM_NEW_OFFSET
        CALL    CBS_V52_VRAM_GET_GAMMA_EOS

CBS_V52_VRAM_COPY_MATCH:
        EX      (SP),HL                 ; HL = offset, stack = packed pointer
        PUSH    HL
        ADD     HL,DE                   ; HL = RAM match source
        LDIR
        POP     HL                      ; negative offset
        EX      (SP),HL                 ; restore packed pointer and offset

CBS_V52_VRAM_AFTER_MATCH:
        CALL    CBS_V52_VRAM_GET_BIT
        JR      C,CBS_V52_VRAM_NEW_OFFSET
        CALL    CBS_V52_VRAM_GET_GAMMA_EOS

CBS_V52_VRAM_COPY_LITERALS:
        LDIR
        JR      CBS_V52_VRAM_AFTER_LITERAL

; ---------------------------------------------------------------------
; New offset: selector 0 = whole-line distance, selector 1 = compact general.
; ---------------------------------------------------------------------
CBS_V52_VRAM_NEW_OFFSET:
        CALL    CBS_V52_VRAM_GET_BIT
        JR      C,CBS_V52_VRAM_GENERAL_OFFSET

CBS_V52_VRAM_ROW_OFFSET:
        CALL    CBS_V52_VRAM_GET_NEG_GAMMA
        INC     BC                      ; C = negative row count (FFh = -1, etc.)
        PUSH    DE
        PUSH    HL
CBS_V52_VRAM_ROW_WIDTH:
        LD      DE,0000h                ; patched 16-bit packed width (1..256)
        LD      HL,0000h
CBS_V52_VRAM_MULTIPLY:
        OR      A
        SBC     HL,DE
        INC     C
        JR      NZ,CBS_V52_VRAM_MULTIPLY
        LD      B,H
        LD      C,L                     ; BC = negative byte distance
        POP     HL
        POP     DE
        CALL    CBS_V52_VRAM_GET_BIT
        JR      CBS_V52_VRAM_STORE_OFFSET

CBS_V52_VRAM_GENERAL_OFFSET:
        CALL    CBS_V52_VRAM_GET_NEG_GAMMA
        INC     BC
        RR      B
        LD      B,C
        LD      C,(HL)
        INC     HL
        RR      B
        RR      C                       ; BC = negative distance, CF = 1st len bit

CBS_V52_VRAM_STORE_OFFSET:
        EX      (SP),HL
        POP     HL
        PUSH    BC
        LD      BC,0001h
        CALL    NC,CBS_V52_VRAM_GAMMA_LOOP
        INC     BC
        JR      CBS_V52_VRAM_COPY_MATCH

; ---------------------------------------------------------------------
; Upload completed RAM chunk at IX via 11-byte R36..R46 HMMC block.
; ---------------------------------------------------------------------
CBS_V52_VRAM_FINISHED:
        POP     BC                      ; discard persistent last offset
        PUSH    HL                      ; preserve next packed chunk pointer

        PUSH    IX
        POP     HL
        LD      A,(HL)
        INC     HL
        LD      (CBS_V52_VRAM_CLR),A    ; seed R44 with first pixel byte
        EX      DE,HL                   ; DE = IX + 1

        DI
        LD      HL,CBS_V52_VRAM_COMMAND_DATA
CBS_V52_PORT_CONTROL:
        LD      C,99h                   ; patched once from BIOS VDP.DW
        LD      A,24h
        OUT     (C),A
        LD      A,91h                   ; R#17 = 36 with auto-increment
        OUT     (C),A
        INC     C
        INC     C                       ; C = indirect register port (9Bh)
        LD      B,0Bh                   ; emit R36..R46 (starts HMMC!)
        OTIR

        DEC     C
        DEC     C                       ; C = control port (99h)
        LD      A,44 + 80h              ; R#44 without auto-increment
        OUT     (C),A
        LD      A,91h
        OUT     (C),A
        INC     C
        INC     C                       ; C = indirect register port (9Bh)

        EX      DE,HL                   ; HL = IX + 1
        LD      A,(CBS_V52_VRAM_NY)
        LD      D,A                     ; D = line counter (0 = 256)
        JR      CBS_V52_VRAM_COPY_FIRST

CBS_V52_VRAM_COPY:
        LD      A,(CBS_V52_VRAM_ROW_WIDTH+1)
        LD      B,A
CBS_V52_VRAM_COPY_L:
        LD      A,(HL)
        INC     HL
        OUT     (C),A
CBS_V52_VRAM_COPY_FIRST:
        DJNZ    CBS_V52_VRAM_COPY_L
        DEC     D
        JR      NZ,CBS_V52_VRAM_COPY

        DEC     C
        DEC     C                       ; C = control port (99h)
        LD      A,02h                   ; select status register 2
        OUT     (C),A
        LD      A,8Fh
        OUT     (C),A
CBS_V52_VRAM_EXIT_WAIT:
        IN      A,(C)
        RRCA                            ; Carry = CE
        JR      C,CBS_V52_VRAM_EXIT_WAIT
        XOR     A                       ; restore status register 0
        OUT     (C),A
        LD      A,8Fh
        OUT     (C),A

        LD      HL,CBS_V52_VRAM_DY
        LD      A,(CBS_V52_VRAM_NY)
        ADD     A,(HL)
        LD      (HL),A                  ; advance destination Y
        POP     HL                      ; next chunk header after this EOS
CBS_V52_VRAM_CHUNKS:
        LD      A,00h
        DEC     A
        RET     Z
        LD      (CBS_V52_VRAM_CHUNKS+1),A
        EI                              ; parsing runs with BIOS interrupts enabled
        JP      CBS_V52_VRAM_CHUNK_START

; ---------------------------------------------------------------------
; Interlaced gamma and bit-stream readers.
; ---------------------------------------------------------------------
CBS_V52_VRAM_GET_GAMMA_EOS:
        LD      BC,0001h
        CALL    CBS_V52_VRAM_GET_BIT
        JR      NC,CBS_V52_VRAM_GAMMA_LOOP
        CALL    CBS_V52_VRAM_GET_BIT
        RET     NC
        POP     BC                      ; discard caller return address
        JR      CBS_V52_VRAM_FINISHED

CBS_V52_VRAM_GET_GAMMA:
        LD      BC,0001h
        JR      CBS_V52_VRAM_GAMMA_ENTRY

CBS_V52_VRAM_GET_NEG_GAMMA:
        LD      BC,FFFEh
CBS_V52_VRAM_GAMMA_ENTRY:
        CALL    CBS_V52_VRAM_GET_BIT
        RET     C
CBS_V52_VRAM_GAMMA_LOOP:
        CALL    CBS_V52_VRAM_GET_BIT
        RL      C
        RL      B
        JR      CBS_V52_VRAM_GAMMA_ENTRY

CBS_V52_VRAM_GET_BIT:
        ADD     A,A
        RET     NZ
        LD      A,(HL)
        INC     HL
        RLA
        RET

; ---------------------------------------------------------------------
; One-time MSX VDP port and Screen 5-8 mode initializers.
; ---------------------------------------------------------------------
CBS_V52_INIT_MSX:
        LD      A,(0007h)
        INC     A
        LD      (CBS_V52_PORT_CONTROL+1),A
        RET

CBS_V52_INIT_SCREEN:
        LD      HL,0000h                ; Screen 8: NOP, NOP (0 shifts)
        CP      08h
        JR      Z,CBS_V52_SET_SHIFTS
        LD      L,29h                   ; Screen 5/7: ADD HL,HL + NOP (1 shift)
        CP      06h
        JR      NZ,CBS_V52_SET_SHIFTS
        LD      H,L                     ; Screen 6: ADD HL,HL + ADD HL,HL (2 shifts)
CBS_V52_SET_SHIFTS:
        LD      (CBS_V52_SCREEN_SHIFT_X),HL
        LD      (CBS_V52_SCREEN_SHIFT_NX),HL
        RET

; ---------------------------------------------------------------------
; Writable R36-R46 HMMC parameter block (11 bytes).
; ---------------------------------------------------------------------
CBS_V52_VRAM_COMMAND_DATA:
CBS_V52_VRAM_DX:
        DW      0
CBS_V52_VRAM_DY:
        DW      0
CBS_V52_VRAM_NX:
        DW      0
CBS_V52_VRAM_NY:
        DW      0
CBS_V52_VRAM_CLR:
        DB      0                       ; R44: seeded with 1st byte of buffer
        DB      00h                     ; R45: ARG = 0
        DB      F0h                     ; R46: CMD = HMMC
