; ======================================================================
; CS617 CHAPTER 03 - RANDOM LAB - r006 POST-DELIVERY UI CANDIDATE
; PB-2000C / AI-1000 standalone language-card ROM
; Source-only r006 from accepted SHELL r005; do NOT recast historical
; delivery or claim a new machine acceptance before build and runtime gates.
; Product UI decision: sol/DECISION_RECORD_CH03_UI_r006_20261011.md
; Startup: TM-sampled auto-advance replaces startup EXE only. Error EXE stays.
;
; PURPOSE
;   Final human-facing consumer of the accepted Chapter 03 numerical layer.
;
;   FK1 SEED  enter/reset unsigned 16-bit seed (0..65535)
;   FK2 NEXT  advance accepted LCG exactly once and display x
;   FK3 N     enter positive unsigned 16-bit sample count (1..65535)
;   FK4 SIM   reseed from configured SEED, generate exactly N values,
;             and display mean + population sigma
;
; SIM CONTRACT
;   SIM always starts from the configured SEED, independent of prior NEXTs.
;   On completion, the LCG state is the final simulation state; a following
;   NEXT continues from that point.
;
; NEW CODE IN THIS FILE
;   keyboard/menu/display glue, decimal u16 entry, shell state, and the
;   parameterized statistics driver STATS_RUN_CFG.
;
; ACCEPTED SURFACES ARE REUSED; NO NEW NUMERICAL PRIMITIVE IS INTRODUCED.
; ======================================================================

        ORG     0
        LEVEL   0

OFFCHK: EQU     &H04EF

FK1:    EQU     &HFC
FK2:    EQU     &HFD
FK3:    EQU     &HFE
FK4:    EQU     &HFF
KEYBS:  EQU     &H08
KEYEXE: EQU     &H0D

; ----------------------------------------------------------------------
; RAM workspace.  These addresses follow the already accepted Chapter 03
; ROM-test convention: code executes from the language card while IX data
; accesses reach writable machine RAM.
; ----------------------------------------------------------------------
WS_STATE: EQU   &H2000
WS_TMP:   EQU   &H2010
WS_DEN:   EQU   &H2020
WS_X:     EQU   &H2030
WS_SUM:   EQU   &H2040
WS_SUMSQ: EQU   &H2050
WS_NFP:   EQU   &H2060
WS_MEAN:  EQU   &H2070
WS_M2:    EQU   &H2080
WS_VAR:   EQU   &H2090
WS_SIG:   EQU   &H20A0
WS_COUNT: EQU   &H20B0
WS_NBIN:  EQU   &H20B2
WS_SEED:  EQU   &H20B4
WS_NCFG:  EQU   &H20B6
WS_HAVEX: EQU   &H20B8
WS_HAVEST:EQU   &H20B9
WS_SBUF:  EQU   &H20C0
WS_SLEN:  EQU   &H20C5
WS_NBUF:  EQU   &H20D0
WS_NLEN:  EQU   &H20D5
WS_NEW:   EQU   &H20D6
WS_FBUF:  EQU   &H20E0
WS_FLEN:  EQU   &H20F0
WS_CUR:   EQU   &H20F1
WS_TICK:  EQU   &H20F2
WS_EDIT:  EQU   &H20F3

; ----------------------------------------------------------------------
; Language-card header.
; ----------------------------------------------------------------------
        DB      &H43,&H4D
        DB      &HFF,&HFF,&HFF,&HFF
        DB      &H01,&H04,&H10,&H10
        DB      &HFF,&HFF,&HFF,&HFF
        DB      &HFF,&HFF,&HFF,&HFF
        DB      &HFF,&HFF,&HFF,&HFF
        DB      &HFF,&HFF,&HFF,&HFF
        DB      &HFF
        DB      &H03
        DB      &HC0
        DB      &HFF,&HFF,&HFF

; ======================================================================
; ACCEPTED DIRECT KEYBOARD SCANNER / KEYSCAN CONVENTION
; Reused from the Chapter 01/02 standalone PB-2000C line.
; ======================================================================
        ORG     &H0C60

INKEY:
        CAL     OFFCHK
        LD      $17,$31
        LD      $0,&H4B

IKEYLP:
        PST     IA,$0
        GRE     KY,$1
        GRE     KY,$1
        DID     $2
        ANCW    $1,$1
        JR      Z,IKEY40

        SBC     $0,&H41
        JP      Z,APP_START

IKEY10:
        LD      $3,$31
IKEY20:
        BIDW    $2
        JR      C,IKEY30
        AD      $3,$30,IKEY20
IKEY30:
        LD      $5,$0
        SB      $5,$30
        BIU     $5
        BIU     $5
        LD      $4,$5
        BIU     $4
        BIU     $4
        SB      $4,$5
        PST     UA,&H44
        PRE     IX,KEYSCAN
        LDD     $0,(IX+$4)
        LDD     $0,(IX+$3)
        PST     UA,&H54
        JR      IKEY50
IKEY40:
        SB      $0,$30
        JR      LNZ,IKEYLP
        LD      $0,$31
IKEY50:
        AN      $0,$0
        JR      Z,IKEYRET
        LD      $17,$30
IKEYRET:
        RTN

; ----------------------------------------------------------------------
; Canonical standalone vector table.
; ----------------------------------------------------------------------
        ORG     &H0D80

        JP      MAIN
        JP      TRAP
        JP      &H01AA
        JP      &H01BC
        JP      TRAP
        JP      TRAP
        JP      TRAP
        JP      &H00E3

DEFRT:  RTN
        DB      &HFF,&HFF
        RTN
        DB      &HFF,&HFF
        JP      DEFRT
        JP      POFF
        JP      DEFRT
        JP      DEFRT
        JP      MAIN
        JP      DEFRT
        JP      DEFRT
        JP      DEFRT
        JP      DEFRT
        DB      &H11
        DB      &H10

TRAP:   RTNI
POFF:   OFF
        OFF
        OFF
        JR      POFF

; ----------------------------------------------------------------------
; BOOT-ROM key translation table.
; ----------------------------------------------------------------------
KEYSCAN:
        DB      0,0,0,0,0,0,0,1,0,0,0,0
        DB      "W","Q","A",0,"Z",0,0,0,0,0,"'",7
        DB      "R","E","D","S","C","X",0,0,&HFC,0,&H29,&H28
        DB      "Y","T","G","F","B","V",0,0,&HFD,0,&H5D,&H5B
        DB      "I","U","J","H","M","N",0,0,&HFE,0,&H90,&H7C
        DB      "P","O","L","K",&H20,",",0,0,&HFF,0,&H93,&H94
        DB      0,"=",":",";",0,0,0,0,&H95,0,0,&H9B
        DB      "5","4","2","1",0,"0",0,"7",0,0,0,0
        DB      "-","6","+","3",&H0D,".",0,"9",0,0,0,0
        DB      &H9D,&H1C,"/",&H08,0,0,0,"*",0,0,&H9C,&H11
        DB      &H1F,&H1D,&H0C,0,0,0,0,"8",0,0,&H1E,&H12


; ----------------------------------------------------------------------
; Bootstrap remains intentionally tiny.  All shell/application code lives
; after the accepted numerical surface layout.
; ----------------------------------------------------------------------
        ORG     &H0E80
MAIN:
        PRE     SS,&H0100
        LD      $30,1
        LD      $31,0
        PSR     SZ,0
        PSR     SY,30
        PSR     SX,31
        PST     UA,&H14
        JP      APP_START

; ======================================================================
; ACCEPTED CHAPTER 03 NUMERICAL SURFACES
; Layout preserves the accepted Sprint 10 dependency map and adds the
; accepted PRESENT r002 BCD_TO_F32 donor at 1000.
; ======================================================================
        ORG     &H0F00
#INCLUDE (../lib/bcd_mod.inc)
#LIST

        ORG     &H0F40
#INCLUDE (../lib/bcd_div.inc)
#LIST

        ORG     &H0F60
#INCLUDE (../lib/bcd_mul.inc)
#LIST

        ORG     &H0F70
#INCLUDE (../lib/bcd_sub.inc)
#LIST

        ORG     &H0F80
#INCLUDE (../lib/bcd_from_u16.inc)
#LIST

        ORG     &H0FB0
#INCLUDE (../lib/bcd_add.inc)
#LIST

        ORG     &H0FD0
#INCLUDE (../lib/bcd_sqrt.inc)
#LIST

        ORG     &H1000
#INCLUDE (../lib/bcd_to_f32_r002.inc)
#LIST

; ======================================================================
; FINAL APPLICATION / GLUE
; ======================================================================
        ORG     &H1100

; ----------------------------------------------------------------------
; Native-FP workspace helpers.
; ----------------------------------------------------------------------
STORE_STATE:
        PRE     IX,WS_STATE
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_STATE:
        PRE     IX,WS_STATE
        LDIM    $10,(IX+$SX),8
        LDD     $18,(IX+$SX)
        RTN
STORE_TMP:
        PRE     IX,WS_TMP
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_TMP:
        PRE     IX,WS_TMP
        LDIM    $10,(IX+$SX),8
        LDD     $18,(IX+$SX)
        RTN
STORE_DEN:
        PRE     IX,WS_DEN
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_DEN_B:
        PRE     IX,WS_DEN
        LDIM    $0,(IX+$SX),8
        LDD     $8,(IX+$SX)
        RTN
STORE_X:
        PRE     IX,WS_X
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_X:
        PRE     IX,WS_X
        LDIM    $10,(IX+$SX),8
        LDD     $18,(IX+$SX)
        RTN
STORE_SUM:
        PRE     IX,WS_SUM
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_SUM:
        PRE     IX,WS_SUM
        LDIM    $10,(IX+$SX),8
        LDD     $18,(IX+$SX)
        RTN
STORE_SUMSQ:
        PRE     IX,WS_SUMSQ
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_SUMSQ:
        PRE     IX,WS_SUMSQ
        LDIM    $10,(IX+$SX),8
        LDD     $18,(IX+$SX)
        RTN
STORE_NFP:
        PRE     IX,WS_NFP
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_NFP_B:
        PRE     IX,WS_NFP
        LDIM    $0,(IX+$SX),8
        LDD     $8,(IX+$SX)
        RTN
STORE_MEAN:
        PRE     IX,WS_MEAN
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_MEAN:
        PRE     IX,WS_MEAN
        LDIM    $10,(IX+$SX),8
        LDD     $18,(IX+$SX)
        RTN
STORE_M2:
        PRE     IX,WS_M2
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_M2:
        PRE     IX,WS_M2
        LDIM    $10,(IX+$SX),8
        LDD     $18,(IX+$SX)
        RTN
STORE_VAR:
        PRE     IX,WS_VAR
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_VAR:
        PRE     IX,WS_VAR
        LDIM    $10,(IX+$SX),8
        LDD     $18,(IX+$SX)
        RTN
STORE_SIG:
        PRE     IX,WS_SIG
        STIM    $10,(IX+$SX),8
        STI     $18,(IX+$SX)
        RTN
LOAD_SIG:
        PRE     IX,WS_SIG
        LDIM    $10,(IX+$SX),8
        LDD     $18,(IX+$SX)
        RTN

; ----------------------------------------------------------------------
; Accepted LCG glue, unchanged in substance from Sprint 09.
; ----------------------------------------------------------------------
LCG_SEED_U16:
        CAL     BCD_FROM_U16
        JP      STORE_STATE

LCG_NEXT:
        LDW     $15,&H6255
        CAL     BCD_FROM_U16
        LDM     $0,$10,8
        LD      $8,$18
        CAL     LOAD_STATE
        CAL     BCD_MUL
        CAL     STORE_TMP

        LDW     $15,&H3619
        CAL     BCD_FROM_U16
        LDM     $0,$10,8
        LD      $8,$18
        CAL     LOAD_TMP
        CAL     BCD_ADD
        CAL     STORE_TMP

        LDW     $15,&H8000
        CAL     BCD_FROM_U16
        LDM     $0,$10,8
        LD      $8,$18
        CAL     BCD_ADD
        CAL     STORE_DEN

        CAL     LOAD_DEN_B
        CAL     LOAD_TMP
        CAL     BCD_MOD
        CAL     STORE_STATE

        CAL     LOAD_DEN_B
        CAL     LOAD_STATE
        CAL     BCD_DIV
        RTN

; ----------------------------------------------------------------------
; STATS_RUN_CFG
;
; Input $24,$25 = positive N.
; SIM policy: reseed from WS_SEED, generate exactly N values, and leave the
; final LCG state in WS_STATE.  Arithmetic/statistics body is the accepted
; Sprint 10 algorithm; only seed sourcing is shell policy.
; ----------------------------------------------------------------------
STATS_RUN_CFG:
        PRE     IX,WS_NBIN
        STM     $24,(IX+$SX),2
        PRE     IX,WS_COUNT
        STM     $24,(IX+$SX),2

        PRE     IX,WS_SEED
        LDM     $15,(IX+$SX),2
        CAL     LCG_SEED_U16

        XRM     $10,$10,8
        CAL     STORE_SUM
        CAL     STORE_SUMSQ

ST_LOOP:
        PRE     IX,WS_COUNT
        LDM     $24,(IX+$SX),2
        ANCW    $24,$24
        JP      Z,ST_FINISH

        CAL     LCG_NEXT
        CAL     STORE_X

        LDM     $0,$10,8
        LD      $8,$18
        CAL     LOAD_SUM
        CAL     BCD_ADD
        CAL     STORE_SUM

        CAL     LOAD_X
        LDM     $0,$10,8
        LD      $8,$18
        CAL     BCD_MUL
        CAL     STORE_TMP

        LDM     $0,$10,8
        LD      $8,$18
        CAL     LOAD_SUMSQ
        CAL     BCD_ADD
        CAL     STORE_SUMSQ

        PRE     IX,WS_COUNT
        LDM     $24,(IX+$SX),2
        SBW     $24,$SY
        STM     $24,(IX+$SX),2
        JP      ST_LOOP

ST_FINISH:
        PRE     IX,WS_NBIN
        LDM     $15,(IX+$SX),2
        CAL     BCD_FROM_U16
        CAL     STORE_NFP

        CAL     LOAD_NFP_B
        CAL     LOAD_SUM
        CAL     BCD_DIV
        CAL     STORE_MEAN

        CAL     LOAD_NFP_B
        CAL     LOAD_SUMSQ
        CAL     BCD_DIV
        CAL     STORE_M2

        CAL     LOAD_MEAN
        LDM     $0,$10,8
        LD      $8,$18
        CAL     BCD_MUL
        CAL     STORE_TMP

        LDM     $0,$10,8
        LD      $8,$18
        CAL     LOAD_M2
        CAL     BCD_SUB
        CAL     STORE_VAR

        CAL     BCD_SQRT
        CAL     STORE_SIG
        RTN

; ----------------------------------------------------------------------
; Accepted PRESENT r002 formatter glue for nonnegative 0 <= x < 1.
; ----------------------------------------------------------------------
FMT_UNIT_FP:
        CAL     BCD_TO_F32
        LD      $20,$15
        LD      $21,$16
        LD      $22,$17
        LD      $23,$18

        PRE     IX,WS_FBUF
        LD      $13,0
        LD      $16,"0"
        CAL     FPUT
        LD      $16,"."
        CAL     FPUT

        AN      $23,$23
        JR      NZ,FMT_NONZERO
        LD      $14,6
FMT_ZLOOP:
        LD      $16,"0"
        CAL     FPUT
        SB      $14,$SY
        JR      NZ,FMT_ZLOOP
        JR      FMT_DONE

FMT_NONZERO:
        LD      $14,$23
        AN      $14,&H3F
        SB      $14,$SY
FMT_LEAD:
        AN      $14,$14
        JR      Z,FMT_DIGITS
        LD      $16,"0"
        CAL     FPUT
        SB      $14,$SY
        JR      FMT_LEAD
FMT_DIGITS:
        LD      $12,$22
        CAL     FPAIR
        LD      $12,$21
        CAL     FPAIR
        LD      $12,$20
        CAL     FPAIR
FMT_DONE:
        PRE     IX,WS_FLEN
        ST      $13,(IX+$SX)
        RTN
FPUT:
        STI     $16,(IX+$SX)
        AD      $13,$SY
        RTN
FPAIR:
        LD      $16,$12
        DID     $16
        AN      $16,&H0F
        AD      $16,&H30
        CAL     FPUT
        LD      $16,$12
        AN      $16,&H0F
        AD      $16,&H30
        CAL     FPUT
        RTN

; ======================================================================
; SHELL STATE AND DECIMAL INPUT
; ======================================================================

INIT_CFG:
; Default seed = 1, N = 100.
        PRE     IX,WS_SEED
        LDW     $15,1
        STW     $15,(IX+$SX)
        PRE     IX,WS_NCFG
        LDW     $15,100
        STW     $15,(IX+$SX)

        PRE     IX,WS_SBUF
        LD      $0,"1"
        ST      $0,(IX+$SX)
        PRE     IX,WS_SLEN
        LD      $0,1
        ST      $0,(IX+$SX)

        PRE     IX,WS_NBUF
        LD      $0,"1"
        ST      $0,(IX+$SX)
        LD      $0,"0"
        ST      $0,(IX+$SY)
        LD      $13,2
        ST      $0,(IX+$13)
        PRE     IX,WS_NLEN
        LD      $0,3
        ST      $0,(IX+$SX)

        PRE     IX,WS_HAVEX
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,WS_HAVEST
        ST      $0,(IX+$SX)

        LDW     $15,1
        CAL     LCG_SEED_U16
        RTN

; Parse 0..5 ASCII digits at IX into unsigned word $15,$16.
; $13 = length.  $4=0 success, $4=1 invalid/overflow.
PARSE_U16:
        AN      $13,$13
        JR      Z,PU_BAD
        SBW     $15,$15
        LD      $12,0
PU_LOOP:
        SBC     $12,$13
        JR      NC,PU_OK

        LD      $5,(IX+$12)
        SB      $5,&H30

; value *= 10 using word additions, checking carry at every step.
        LDW     $20,$15
        ADW     $15,$15
        JR      C,PU_BAD
        ADW     $15,$15
        JR      C,PU_BAD
        ADW     $15,$15
        JR      C,PU_BAD
        ADW     $15,$20
        JR      C,PU_BAD
        ADW     $15,$20
        JR      C,PU_BAD

        LD      $6,0
        ADW     $15,$5
        JR      C,PU_BAD

        AD      $12,$SY
        JR      PU_LOOP
PU_OK:
        LD      $4,0
        RTN
PU_BAD:
        LD      $4,1
        RTN

; ----------------------------------------------------------------------
; Main menu dispatch.
; ----------------------------------------------------------------------
MENU_LOOP:
        CAL     DRAW_MAIN
MN_WAIT:
        CAL     INKEY
        PST     UA,&H14
        AN      $17,$17
        JR      Z,MN_WAIT
        LD      $12,$0
        SBC     $12,FK1
        JR      Z,MN_SEED
        SBC     $12,FK2
        JR      Z,MN_NEXT
        SBC     $12,FK3
        JR      Z,MN_N
        SBC     $12,FK4
        JR      Z,MN_SIM
        CAL     WAIT_RELEASE
        JR      MN_WAIT

MN_SEED:
        CAL     WAIT_RELEASE
        CAL     EDIT_SEED
        JP      MENU_LOOP

MN_N:
        CAL     WAIT_RELEASE
        CAL     EDIT_N
        JP      MENU_LOOP

MN_NEXT:
        CAL     WAIT_RELEASE
        CAL     LCG_NEXT
        CAL     STORE_X
        PRE     IX,WS_HAVEX
        LD      $0,1
        ST      $0,(IX+$SX)
        PRE     IX,WS_HAVEST
        LD      $0,0
        ST      $0,(IX+$SX)
        JP      MENU_LOOP

MN_SIM:
        CAL     WAIT_RELEASE
        CAL     DRAW_BUSY
        PRE     IX,WS_NCFG
        LDM     $24,(IX+$SX),2
        CAL     STATS_RUN_CFG
        PRE     IX,WS_HAVEST
        LD      $0,1
        ST      $0,(IX+$SX)
        PRE     IX,WS_HAVEX
        LD      $0,0
        ST      $0,(IX+$SX)
        JP      MENU_LOOP

; ----------------------------------------------------------------------
; SEED editor.  First digit/BS starts a replacement; EXE with no edit keeps
; the old value.  Invalid values stay in the editor after a concise error.
; ----------------------------------------------------------------------
EDIT_SEED:
        PRE     IX,WS_EDIT
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,WS_NEW
        LD      $0,1
        ST      $0,(IX+$SX)
        CAL     RESET_BLINK
        CAL     DRAW_SEED
        CAL     DRAW_ECUR
ES_WAIT:
        CAL     INKEY
        PST     UA,&H14
        AN      $17,$17
        JR      NZ,ES_READY
        CAL     BLINK_TICK
        JR      ES_WAIT
ES_READY:
        LD      $12,$0
        CAL     RESET_BLINK
        SBC     $12,&H30
        JR      C,ES_OTHER
        SBC     $12,&H3A
        JR      NC,ES_OTHER
        CAL     S_DIGIT
        CAL     WAIT_RELEASE
        CAL     DRAW_EFIELD
        CAL     DRAW_ECUR
        JR      ES_WAIT
ES_OTHER:
        SBC     $12,KEYBS
        JR      Z,ES_BS
        SBC     $12,KEYEXE
        JR      Z,ES_EXE
        CAL     WAIT_RELEASE
        CAL     DRAW_ECUR
        JR      ES_WAIT
ES_BS:
        CAL     S_BACKSP
        CAL     WAIT_RELEASE
        CAL     DRAW_EFIELD
        CAL     DRAW_ECUR
        JR      ES_WAIT
ES_EXE:
        CAL     WAIT_RELEASE
        PRE     IX,WS_NEW
        LD      $0,(IX+$SX)
        AN      $0,$0
        RTN     NZ

        PRE     IX,WS_SLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_SBUF
        CAL     PARSE_U16
        AN      $4,$4
        JR      NZ,ES_BAD

        PRE     IX,WS_SEED
        STW     $15,(IX+$SX)
        CAL     LCG_SEED_U16
        PRE     IX,WS_HAVEX
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,WS_HAVEST
        ST      $0,(IX+$SX)
        RTN
ES_BAD:
        CAL     ERR_SEED
        CAL     RESET_BLINK
        CAL     DRAW_SEED
        CAL     DRAW_ECUR
        JP      ES_WAIT

S_DIGIT:
        PRE     IX,WS_NEW
        LD      $0,(IX+$SX)
        AN      $0,$0
        JR      Z,SD_ACTIVE
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,WS_SLEN
        ST      $0,(IX+$SX)
SD_ACTIVE:
        PRE     IX,WS_SLEN
        LD      $13,(IX+$SX)
        SBC     $13,5
        RTN     NC
        PRE     IX,WS_SBUF
        ST      $12,(IX+$13)
        AD      $13,$SY
        PRE     IX,WS_SLEN
        ST      $13,(IX+$SX)
        RTN

S_BACKSP:
        PRE     IX,WS_NEW
        LD      $0,(IX+$SX)
        AN      $0,$0
        JR      Z,SB_ACTIVE
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,WS_SLEN
        ST      $0,(IX+$SX)
        RTN
SB_ACTIVE:
        PRE     IX,WS_SLEN
        LD      $13,(IX+$SX)
        AN      $13,$13
        RTN     Z
        SB      $13,$SY
        ST      $13,(IX+$SX)
        RTN

; ----------------------------------------------------------------------
; N editor.  N=0 is rejected after successful u16 parsing.
; ----------------------------------------------------------------------
EDIT_N:
        PRE     IX,WS_EDIT
        LD      $0,1
        ST      $0,(IX+$SX)
        PRE     IX,WS_NEW
        LD      $0,1
        ST      $0,(IX+$SX)
        CAL     RESET_BLINK
        CAL     DRAW_N
        CAL     DRAW_ECUR
EN_WAIT:
        CAL     INKEY
        PST     UA,&H14
        AN      $17,$17
        JR      NZ,EN_READY
        CAL     BLINK_TICK
        JR      EN_WAIT
EN_READY:
        LD      $12,$0
        CAL     RESET_BLINK
        SBC     $12,&H30
        JR      C,EN_OTHER
        SBC     $12,&H3A
        JR      NC,EN_OTHER
        CAL     N_DIGIT
        CAL     WAIT_RELEASE
        CAL     DRAW_EFIELD
        CAL     DRAW_ECUR
        JR      EN_WAIT
EN_OTHER:
        SBC     $12,KEYBS
        JR      Z,EN_BS
        SBC     $12,KEYEXE
        JR      Z,EN_EXE
        CAL     WAIT_RELEASE
        CAL     DRAW_ECUR
        JR      EN_WAIT
EN_BS:
        CAL     N_BACKSP
        CAL     WAIT_RELEASE
        CAL     DRAW_EFIELD
        CAL     DRAW_ECUR
        JR      EN_WAIT
EN_EXE:
        CAL     WAIT_RELEASE
        PRE     IX,WS_NEW
        LD      $0,(IX+$SX)
        AN      $0,$0
        RTN     NZ

        PRE     IX,WS_NLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_NBUF
        CAL     PARSE_U16
        AN      $4,$4
        JR      NZ,EN_BAD
        ANCW    $15,$15
        JR      Z,EN_BAD

        PRE     IX,WS_NCFG
        STW     $15,(IX+$SX)
        PRE     IX,WS_HAVEST
        LD      $0,0
        ST      $0,(IX+$SX)
        RTN
EN_BAD:
        CAL     ERR_N
        CAL     RESET_BLINK
        CAL     DRAW_N
        CAL     DRAW_ECUR
        JP      EN_WAIT

N_DIGIT:
        PRE     IX,WS_NEW
        LD      $0,(IX+$SX)
        AN      $0,$0
        JR      Z,ND_ACTIVE
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,WS_NLEN
        ST      $0,(IX+$SX)
ND_ACTIVE:
        PRE     IX,WS_NLEN
        LD      $13,(IX+$SX)
        SBC     $13,5
        RTN     NC
        PRE     IX,WS_NBUF
        ST      $12,(IX+$13)
        AD      $13,$SY
        PRE     IX,WS_NLEN
        ST      $13,(IX+$SX)
        RTN

N_BACKSP:
        PRE     IX,WS_NEW
        LD      $0,(IX+$SX)
        AN      $0,$0
        JR      Z,NB_ACTIVE
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,WS_NLEN
        ST      $0,(IX+$SX)
        RTN
NB_ACTIVE:
        PRE     IX,WS_NLEN
        LD      $13,(IX+$SX)
        AN      $13,$13
        RTN     Z
        SB      $13,$SY
        ST      $13,(IX+$SX)
        RTN

; ----------------------------------------------------------------------
; Field-only editor redraw.
; Rewrites row 1 VALUE: + the active buffer and blanks the remaining field
; cells.  This avoids clearing/repainting the whole 32x4 screen per key.
; ----------------------------------------------------------------------
DRAW_EFIELD:
        LD      $6,&H20
        PRE     IZ,TXT_VALUE
        CAL     PRINTZ

        PRE     IX,WS_EDIT
        LD      $9,(IX+$SX)
        AN      $9,$9
        JR      NZ,DEF_N

        PRE     IX,WS_SLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_SBUF
        JR      DEF_PRINT

DEF_N:
        PRE     IX,WS_NLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_NBUF

DEF_PRINT:
        CAL     PRINT_BUF

; Blank from current length through five digits plus the cursor cell.
        LD      $14,6
        SB      $14,$13
DEF_BLANK:
        AN      $14,$14
        RTN     Z
        LD      $16,&H20
        CAL     PUTC
        SB      $14,$SY
        JR      DEF_BLANK

; ----------------------------------------------------------------------
; Accepted small blinking '_' editor convention.
; WS_NEW=1: cursor starts at position 0 and typing replaces current value.
; WS_NEW=0: cursor follows the active replacement text.
; ----------------------------------------------------------------------
RESET_BLINK:
        PRE     IX,WS_CUR
        LD      $0,1
        ST      $0,(IX+$SX)
        PRE     IX,WS_TICK
        LD      $0,0
        ST      $0,(IX+$SX)
        RTN

BLINK_TICK:
        PRE     IX,WS_TICK
        LD      $0,(IX+$SX)
        AD      $0,$SY
        SBC     $0,128
        JR      Z,BT_TOGGLE
        ST      $0,(IX+$SX)
        RTN

BT_TOGGLE:
        LD      $0,0
        ST      $0,(IX+$SX)
        PRE     IX,WS_CUR
        LD      $1,(IX+$SX)
        AN      $1,$1
        JR      Z,BT_ON
        LD      $1,0
        ST      $1,(IX+$SX)
        JP      DRAW_ECUR
BT_ON:
        LD      $1,1
        ST      $1,(IX+$SX)
        JP      DRAW_ECUR

DRAW_ECUR:
; Cursor position: 0 before replacement begins, otherwise at current length.
        PRE     IX,WS_NEW
        LD      $9,(IX+$SX)
        AN      $9,$9
        JR      Z,DEC_ACTIVE
        LD      $10,0
        JR      DEC_POS
DEC_ACTIVE:
        PRE     IX,WS_EDIT
        LD      $9,(IX+$SX)
        AN      $9,$9
        JR      NZ,DEC_NPOS
        PRE     IX,WS_SLEN
        LD      $10,(IX+$SX)
        JR      DEC_POS
DEC_NPOS:
        PRE     IX,WS_NLEN
        LD      $10,(IX+$SX)
DEC_POS:
; Both edit screens put VALUE: at row 1, columns 0..6.
        LD      $6,&H27
        AD      $6,$10
        PRE     IX,WS_CUR
        LD      $8,(IX+$SX)
        PRE     IX,WS_EDIT
        LD      $9,(IX+$SX)
        AN      $9,$9
        JR      NZ,DEC_N
        PRE     IX,WS_SLEN
        LD      $11,(IX+$SX)
        PRE     IX,WS_SBUF
        JR      DEC_CHAR
DEC_N:
        PRE     IX,WS_NLEN
        LD      $11,(IX+$SX)
        PRE     IX,WS_NBUF
DEC_CHAR:
        AN      $8,$8
        JR      Z,DEC_OFF
        LD      $16,&H5F
        JP      PUTC
DEC_OFF:
        SBC     $10,$11
        JR      NC,DEC_SPACE
        LD      $16,(IX+$10)
        JP      PUTC
DEC_SPACE:
        LD      $16,&H20
        JP      PUTC

; ======================================================================
; DISPLAY
; ======================================================================
APP_START:
        CAL     SCREEN_INIT
        CAL     INIT_CFG
        CAL     SHOW_SPLASH
        CAL     WAIT_SPLASH_R006
        JP      MENU_LOOP

SCREEN_INIT:
        PST     UA,&H14
        CAL     OFFCHK
        PPO     &HC0
        LDW     $0,&H12B5
SI_DELAY:
        SBW     $0,$SY
        JR      NZ,SI_DELAY
        CAL     &H02D4
        PPO     &HC3
        LD      $0,&H0C
        LDW     $1,&H3000
        STLM    $0,3
        CAL     &H0304
        CAL     &H0306
        RTN

CLEAR_ALL:
        LD      $6,$SX
        LD      $8,128
        CAL     &H018D
        RTN

SHOW_SPLASH:
        CAL     CLEAR_ALL
        LD      $6,$SX
        PRE     IZ,TXT_SPL0
        CAL     PRINTZ
        LD      $6,&H20
        PRE     IZ,TXT_SPL1
        CAL     PRINTZ
        LD      $6,&H40
        PRE     IZ,TXT_SPL2
        CAL     PRINTZ
        LD      $6,&H60
        PRE     IZ,TXT_SPL3
        CAL     PRINTZ
        RTN

; Post-delivery UI readiness r006, not part of the original r005 WHAT:
; auto-advance the STARTUP splash after three stabilized TM transitions.
; Reuses the accepted Chapter 01/02 family pattern. We call OFFCHK directly
; because the accepted Chapter 03 INKEY/SCREEN_INIT already use this firmware
; convention; do not copy Chapter 02's different bank-bridge semantics.
; No EXE is consumed here. The original WAIT_EXE still serves ERR_SEED/ERR_N.
; This change is deliberately limited to the APP_START splash lifecycle.
WAIT_SPLASH_R006:
        CAL     SAMPLE_TM_R006
        LD      $22,$8
        LD      $23,0
R6_WSP_LOOP:
        CAL     OFFCHK
        CAL     SAMPLE_TM_R006
        SBC     $8,$22
        JR      Z,R6_WSP_LOOP
        LD      $22,$8
        AD      $23,$SY
        SBC     $23,3
        JR      NZ,R6_WSP_LOOP
        RTN

; Avoid torn TM reads: require two consecutive equal samples.
SAMPLE_TM_R006:
        GST     TM,$8
R6_STM_AGAIN:
        LD      $9,$8
        GST     TM,$8
        SBC     $8,$9
        JR      NZ,R6_STM_AGAIN
        LD      $9,0
        RTN

DRAW_MAIN:
        CAL     CLEAR_ALL

; Row 0: configured seed and N.
        LD      $6,$SX
        PRE     IZ,TXT_SEED
        CAL     PRINTZ
        PRE     IX,WS_SLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_SBUF
        CAL     PRINT_BUF
        PRE     IZ,TXT_NSEP
        CAL     PRINTZ
        PRE     IX,WS_NLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_NBUF
        CAL     PRINT_BUF

; After SIM, devote one full row to each statistic.
        PRE     IX,WS_HAVEST
        LD      $0,(IX+$SX)
        AN      $0,$0
        JR      Z,DM_NEXTMODE

        LD      $6,&H20
        PRE     IZ,TXT_MEAN
        CAL     PRINTZ
        CAL     LOAD_MEAN
        CAL     FMT_UNIT_FP
        CAL     PRINT_FBUF

        LD      $6,&H40
        PRE     IZ,TXT_SDEV
        CAL     PRINTZ
        CAL     LOAD_SIG
        CAL     FMT_UNIT_FP
        CAL     PRINT_FBUF
        JR      DM_KEYS

; Otherwise show the most recent explicit NEXT value; row 2 remains quiet.
DM_NEXTMODE:
        LD      $6,&H20
        PRE     IZ,TXT_X
        CAL     PRINTZ
        PRE     IX,WS_HAVEX
        LD      $0,(IX+$SX)
        AN      $0,$0
        JR      Z,DM_NOX
        CAL     LOAD_X
        CAL     FMT_UNIT_FP
        CAL     PRINT_FBUF
        JR      DM_KEYS
DM_NOX:
        PRE     IZ,TXT_DASH
        CAL     PRINTZ

DM_KEYS:
        LD      $6,&H60
        PRE     IZ,TXT_KEYS
        CAL     PRINTZ
        RTN

DRAW_BUSY:
        CAL     CLEAR_ALL
        LD      $6,$SX
        PRE     IZ,TXT_SIM
        CAL     PRINTZ
        LD      $6,&H20
        PRE     IZ,TXT_SEED
        CAL     PRINTZ
        PRE     IX,WS_SLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_SBUF
        CAL     PRINT_BUF
        PRE     IZ,TXT_NSEP
        CAL     PRINTZ
        PRE     IX,WS_NLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_NBUF
        CAL     PRINT_BUF
        LD      $6,&H40
        PRE     IZ,TXT_WORK
        CAL     PRINTZ
        RTN

DRAW_SEED:
        CAL     CLEAR_ALL
        LD      $6,$SX
        PRE     IZ,TXT_SETSEED
        CAL     PRINTZ
        LD      $6,&H20
        PRE     IZ,TXT_VALUE
        CAL     PRINTZ
        PRE     IX,WS_SLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_SBUF
        CAL     PRINT_BUF
        LD      $6,&H40
        PRE     IZ,TXT_REPLACE
        CAL     PRINTZ
        LD      $6,&H60
        PRE     IZ,TXT_EDIT
        CAL     PRINTZ
        RTN

DRAW_N:
        CAL     CLEAR_ALL
        LD      $6,$SX
        PRE     IZ,TXT_SETN
        CAL     PRINTZ
        LD      $6,&H20
        PRE     IZ,TXT_VALUE
        CAL     PRINTZ
        PRE     IX,WS_NLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_NBUF
        CAL     PRINT_BUF
        LD      $6,&H40
        PRE     IZ,TXT_REPLACE
        CAL     PRINTZ
        LD      $6,&H60
        PRE     IZ,TXT_EDIT
        CAL     PRINTZ
        RTN

ERR_SEED:
        CAL     CLEAR_ALL
        LD      $6,$SX
        PRE     IZ,TXT_BADSEED
        CAL     PRINTZ
        LD      $6,&H20
        PRE     IZ,TXT_SEEDRNG
        CAL     PRINTZ
        LD      $6,&H60
        PRE     IZ,TXT_EXE
        CAL     PRINTZ
        JP      WAIT_EXE

ERR_N:
        CAL     CLEAR_ALL
        LD      $6,$SX
        PRE     IZ,TXT_BADN
        CAL     PRINTZ
        LD      $6,&H20
        PRE     IZ,TXT_NRNG
        CAL     PRINTZ
        LD      $6,&H60
        PRE     IZ,TXT_EXE
        CAL     PRINTZ
        JP      WAIT_EXE

PRINT_FBUF:
        PRE     IX,WS_FLEN
        LD      $13,(IX+$SX)
        PRE     IX,WS_FBUF
        JP      PRINT_BUF

; IX -> RAM text, $13 = length.
PRINT_BUF:
        LD      $12,0
PB_LOOP:
        SBC     $12,$13
        RTN     NC
        LD      $16,(IX+$12)
        CAL     PUTC
        AD      $12,$SY
        JR      PB_LOOP

PUTC:
        LD      $7,$16
        LD      $0,$7
        DIU     $7
        DID     $0
        OR      $7,$SZ
        CAL     &H0197
        RTN

PRINTZ:
        LDI     $7,(IZ+$SX)
        LD      $0,$7
        DIU     $7
        DID     $0
        OR      $7,$SZ
        RTN     Z
        CAL     &H0197
        JR      PRINTZ

WAIT_RELEASE:
WR_LOOP:
        CAL     INKEY
        PST     UA,&H14
        AN      $17,$17
        JR      NZ,WR_LOOP
        RTN

WAIT_EXE:
WE_WAIT:
        CAL     INKEY
        PST     UA,&H14
        AN      $17,$17
        JR      Z,WE_WAIT
        SBC     $0,KEYEXE
        JR      Z,WE_REL
WE_IGN:
        CAL     INKEY
        PST     UA,&H14
        AN      $17,$17
        JR      NZ,WE_IGN
        JR      WE_WAIT
WE_REL:
        CAL     INKEY
        PST     UA,&H14
        AN      $17,$17
        JR      NZ,WE_REL
        RTN

; ----------------------------------------------------------------------
; ROM strings.
; ----------------------------------------------------------------------
TXT_SPL0:
        DB      "         Xandrian Labs          ",0
TXT_SPL1:
        DB      "       CS617 - Chapter 03       ",0
TXT_SPL2:
        DB      "           Random Lab           ",0
TXT_SPL3:
        DB      "              r006              ",0

TXT_SEED:
        DB      "SEED=",0
TXT_NSEP:
        DB      "  N=",0
TXT_N:
        DB      "N=",0
TXT_X:
        DB      "X=",0
TXT_MEAN:
        DB      "MEAN=",0
TXT_SDEV:
        DB      "SDEV=",0
TXT_DASH:
        DB      "--",0
TXT_KEYS:
        DB      "[seed  ][next  ][n     ][sim   ]",0
TXT_SIM:
        DB      "Simulation",0
TXT_WORK:
        DB      "Working...",0
TXT_SETSEED:
        DB      "Set seed 0..65535",0
TXT_SETN:
        DB      "Set N 1..65535",0
TXT_VALUE:
        DB      "Value: ",0
TXT_REPLACE:
        DB      "Typing replaces current value",0
TXT_EDIT:
        DB      "0-9 type  BS erase  EXE save",0
TXT_BADSEED:
        DB      "Invalid seed",0
TXT_SEEDRNG:
        DB      "Use 0..65535",0
TXT_BADN:
        DB      "Invalid N",0
TXT_NRNG:
        DB      "Use 1..65535",0
TXT_EXE:
        DB      "Press EXE",0

        ORG     &HFFFF
        DB      0
