@andrivet/z80-assembler 1.3.2 → 1.4.0

package/libs/z80-assembler/.eslintrc.json

@@ -0,0 +1,18 @@
+{
+  "extends": ["../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    }
+  ]
+}

package/libs/z80-assembler/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@andrivet/z80-assembler",
+  "version": "1.3.2",
+  "description": "A Z80 assembler entirely written in Typescript and derived from a PEG grammar.",
+  "author": "Sebastien Andrivet",
+  "license": "GPLv3",
+  "type": "commonjs",
+  "keywords": [
+    "z80",
+    "assembler",
+    "ZX81"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/andrivet/z80-assembler"
+  }
+}

package/libs/z80-assembler/project.json

@@ -0,0 +1,35 @@
+{
+  "name": "z80-assembler",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/z80-assembler/src",
+  "projectType": "library",
+  "targets": {
+    "build": {
+      "executor": "@nx/vite:build",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/libs/z80-assembler"
+      }
+    },
+    "test": {
+      "executor": "@nx/vite:test",
+      "outputs": ["coverage/libs/z80-assembler"],
+      "options": {
+        "passWithNoTests": true,
+        "reportsDirectory": "../../coverage/libs/z80-assembler"
+      }
+    },
+    "lint": {
+      "executor": "@nx/linter:eslint",
+      "outputs": ["{options.outputFile}"],
+      "options": {
+        "lintFilePatterns": ["libs/z80-assembler/**/*.ts"]
+      }
+    },
+    "compile grammar": {
+      "command": "tspeg --regex-flags=i --include-grammar-comment=false ./libs/z80-assembler/src/lib/grammar/z80.peg ./libs/z80-assembler/src/lib/grammar/z80.ts",
+      "outputs": ["./libs/z80-assembler/src/lib/grammar/z80.ts"]
+    }
+  },
+  "tags": []
+}

package/libs/z80-assembler/public/README.md

@@ -0,0 +1,54 @@
+# z80-assembler
+
+A Z80 assembler library entirely written in Typescript and derived from a PEG grammar.
+It optimized for the old ZX81 computer but can also be used with any other Z80 targets.
+
+## Demo application
+
+A demo application is available: https://andrivet.github.io/z80-assembler/.
+
+## Quick guide to use the library
+
+To install the library:
+
+```
+$ npm install @andrivet/z80-assembler
+```
+
+The main function is simply called `compile`. It takes three arguments:
+
+* the name of the source file
+* the Z80 source code to compile
+* a function used to return the content of included files
+
+It returns an object of type `CompilationInfo` with the following fields:
+
+* `outputName`: The name of the output as set by the `output` directive.
+* `bytes`: A array of numbers. Each element represents a byte of the generated machine code.
+* `sld`: The Source Level Debugging data as a string. This is used in order to debug the code.
+* `errs`: An array of errors
+
+A typical way to use the function is:
+
+```
+const info = compile(filepath, code, handleGetFileCode);
+if(info.errs.length > 0)
+  displayErrors(info.errs);
+else
+  saveOutput(info.outputName, info.bytes);
+```
+
+You can find a complete example in the [demo application](https://github.com/andrivet/z80-assembler/), in particular in the `app.tsx` file.
+
+
+## Source code
+
+The source code is published on GitHub: https://github.com/andrivet/z80-assembler/.
+
+## Licence
+
+This library and associated application are released under GPLv3.
+
+## Copyrights
+
+Copyright (C) 2023 Sebastien Andrivet

package/{index.d.ts → libs/z80-assembler/src/index.ts}

@@ -7,7 +7,7 @@
  * License:		GPLv3
  * Copyrights: 	Copyright (C) 2023 Sebastien Andrivet
  */
-export * from './lib/types/Types';
+export * from './lib/types/Types'
 export * from './lib/types/Error';
 export * from './lib/compiler/Compiler';
 export * from './lib/compiler/Generator';

package/libs/z80-assembler/src/lib/assets/code/basic-end.zx81

@@ -0,0 +1,4 @@
+variables:
+variables_end:
+    byte $80
+edit_line:

package/libs/z80-assembler/src/lib/assets/code/basic-line1.zx81

@@ -0,0 +1,4 @@
+basic_line1:
+    byte 0,1
+    word basic_line1_end-basic_line1-4
+    byte _REM

package/libs/z80-assembler/src/lib/assets/code/basic-line2.zx81

@@ -0,0 +1,9 @@
+    byte _NL
+basic_line1_end:
+
+basic_line2:
+    byte 0,2
+    word basic_line2_end-basic_line2-4
+    byte _RAND,_USR,_VAL,_DQT,_1,_6,_5,_1,_4,_DQT
+    byte _NL
+basic_line2_end:

package/libs/z80-assembler/src/lib/assets/code/characters.zx81

@@ -0,0 +1,190 @@
+__          equ  $00
+_SPC        equ  $00
+_DQT        equ  $0b
+_PND        equ  $0c
+_DLR        equ  $0d
+_CLN        equ  $0e
+_QMK        equ  $0f
+_OBR        equ  $10
+_CBR        equ  $11
+_GTH        equ  $12
+_LTH        equ  $13
+_EQU        equ  $14
+_PLS        equ  $15
+_MNS        equ  $16
+_ASK        equ  $17
+_SLS        equ  $18
+_SMC        equ  $19
+_CMA        equ  $1a
+_FST        equ  $1b
+_0          equ  $1c
+_1          equ  $1d
+_2          equ  $1e
+_3          equ  $1f
+_4          equ  $20
+_5          equ  $21
+_6          equ  $22
+_7          equ  $23
+_8          equ  $24
+_9          equ  $25
+_A          equ  $26
+_B          equ  $27
+_C          equ  $28
+_D          equ  $29
+_E          equ  $2a
+_F          equ  $2b
+_G          equ  $2c
+_H          equ  $2d
+_I          equ  $2e
+_J          equ  $2f
+_K          equ  $30
+_L          equ  $31
+_M          equ  $32
+_N          equ  $33
+_O          equ  $34
+_P          equ  $35
+_Q          equ  $36
+_R          equ  $37
+_S          equ  $38
+_T          equ  $39
+_U          equ  $3a
+_V          equ  $3b
+_W          equ  $3c
+_X          equ  $3d
+_Y          equ  $3e
+_Z          equ  $3f
+
+_SPCV       equ  _SPC+$80
+_DQTV       equ  _DQT+$80
+_PNDV       equ  _PND+$80
+_DLRV       equ  _DLR+$80
+_CLNV       equ  _CLN+$80
+_QMKV       equ  _QMK+$80
+_OBRV       equ  _OBR+$80
+_CBRV       equ  _CBR+$80
+_GTHV       equ  _GTH+$80
+_LTHV       equ  _LTH+$80
+_EQUV       equ  _EQU+$80
+_PLSV       equ  _PLS+$80
+_MNSV       equ  _MNS+$80
+_ASKV       equ  _ASK+$80
+_SLSV       equ  _SLS+$80
+_SMCV       equ  _SMC+$80
+_CMAV       equ  _CMA+$80
+_FSTV       equ  _FST+$80
+_0V         equ  _0+$80
+_1V         equ  _1+$80
+_2V         equ  _2+$80
+_3V         equ  _3+$80
+_4V         equ  _4+$80
+_5V         equ  _5+$80
+_6V         equ  _6+$80
+_7V         equ  _7+$80
+_8V         equ  _8+$80
+_9V         equ  _9+$80
+_AV         equ  _A+$80
+_BV         equ  _B+$80
+_CV         equ  _C+$80
+_DV         equ  _D+$80
+_EV         equ  _E+$80
+_FV         equ  _F+$80
+_GV         equ  _G+$80
+_HV         equ  _H+$80
+_IV         equ  _I+$80
+_JV         equ  _J+$80
+_KV         equ  _K+$80
+_LV         equ  _L+$80
+_MV         equ  _M+$80
+_NV         equ  _N+$80
+_OV         equ  _O+$80
+_PV         equ  _P+$80
+_QV         equ  _Q+$80
+_RV         equ  _R+$80
+_SV         equ  _S+$80
+_TV         equ  _T+$80
+_UV         equ  _U+$80
+_VV         equ  _V+$80
+_WV         equ  _W+$80
+_XV         equ  _X+$80
+_YV         equ  _Y+$80
+_ZV         equ  _Z+$80
+
+_RND        equ  $40
+_INKEY$     equ  $41
+_PI         equ  $42
+_UP         equ  $70
+_DOWN       equ  $71
+_LEFT       equ  $72
+_RIGHT      equ  $73
+_GRAPHICS   equ  $74
+_EDIT       equ  $75
+_NEWLINE    equ  $76
+_NL         equ  $76
+_RUBOUT     equ  $77
+_KL_MODE    equ  $78
+_FUNCTION   equ  $79
+_NUMBER     equ  $7E
+_CURSOR     equ  $7F
+_DQUOTES    equ  $C0
+_AT         equ  $C1
+_TAB        equ  $C2
+_CODE       equ  $C4
+_VAL        equ  $C5
+_LEN        equ  $C6
+_SIN        equ  $C7
+_COS        equ  $C8
+_TAN        equ  $C9
+_ASN        equ  $CA
+_ACS        equ  $CB
+_ATN        equ  $CC
+_LN         equ  $CD
+_EXP        equ  $CE
+_INT        equ  $CF
+_SQR        equ  $D0
+_SGN        equ  $D1
+_ABS        equ  $D2
+_PEEK       equ  $D3
+_USR        equ  $D4
+_STR$       equ  $D5
+_CHR$       equ  $D6
+_NOT        equ  $D7
+_PWR        equ  $D8
+_OR         equ  $D9
+_AND        equ  $DA
+_LESS       equ  $DB
+_GREATER    equ  $DC
+_NOT_EQUAL  equ  $DD
+_THEN       equ  $DE
+_TO         equ  $DF
+_STEP       equ  $E0
+_LPRINT     equ  $E1
+_LLIST      equ  $E2
+_STOP       equ  $E3
+_SLOW       equ  $E4
+_FAST       equ  $E5
+_NEW        equ  $E6
+_SCROLL     equ  $E7
+_CONT       equ  $E8
+_DIM        equ  $E9
+_REM        equ  $EA
+_FOR        equ  $EB
+_GOTO       equ  $EC
+_GOSUB      equ  $ED
+_INPUT      equ  $EE
+_LOAD       equ  $EF
+_LIST       equ  $F0
+_LET        equ  $F1
+_PAUSE      equ  $F2
+_NEXT       equ  $F3
+_POKE       equ  $F4
+_PRINT      equ  $F5
+_PLOT       equ  $F6
+_RUN        equ  $F7
+_SAVE       equ  $F8
+_RAND       equ  $F9
+_IF         equ  $FA
+_CLS        equ  $FB
+_UNPLOT     equ  $FC
+_CLEAR      equ  $FD
+_RETURN     equ  $FE
+_COPY       equ  $FF

package/libs/z80-assembler/src/lib/assets/code/display.zx81

@@ -0,0 +1,50 @@
+display:
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL
+    block 32
+    byte _NL

package/libs/z80-assembler/src/lib/assets/code/system-variables.zx81

@@ -0,0 +1,46 @@
+
+ERR_NR    equ $4000
+FLAGS     equ $4001
+ERR_SP    equ $4002
+RAMTOP    equ $4004
+MODE      equ $4006
+PPC       equ $4007
+
+          org $4009
+
+VERSN:    byte  0
+E_PPC:    word  2
+D_FILE:   word  display
+DF_CC:    word  display+1
+VARS:     word  variables
+DEST:     word  0
+E_LINE:   word  edit_line
+CH_ADD:   word  edit_line+4
+X_PTR:    word  0
+STKBOT:   word  edit_line+5
+STKEND:   word  edit_line+5
+BERG:     byte  0
+MEM:      word  MEMBOT
+SPARE1:   byte  0
+DF_SZ:    byte  2
+S_TOP:    word  10
+LAST_K:   word  $ffff
+DB_ST:    byte  0
+MARGIN:   byte  55
+NXTLIN:   word  basic_line2
+OLDPPC:   word  0
+FLAGX:    byte  0
+STRLEN:   word  0
+T_ADDR:   word  0x0c8d
+SEED:     word  0
+FRAMES:   word  0
+COORDS:   byte  0
+          byte  0
+PR_CC:    byte  $bc
+S_POSN:   byte  $21
+          byte  $18
+CDFLAG:   byte  $40
+PRBUF:    block $20
+          byte  _NL
+MEMBOT:   block $1e
+SPARE2:   word  0

package/{lib/compiler/Assets.d.ts → libs/z80-assembler/src/lib/compiler/Assets.ts}

@@ -7,10 +7,15 @@
  * License:			GPLv3
  * Copyrights: 	Copyright (C) 2023 Sebastien Andrivet
  */
+
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+//@ts-nocheck
+
 import assetCharacters from '../assets/code/characters.zx81?raw';
 import assetSystemVariables from '../assets/code/system-variables.zx81?raw';
 import assetBasicLine1 from '../assets/code/basic-line1.zx81?raw';
 import assetBasicLine2 from '../assets/code/basic-line2.zx81?raw';
 import assetDisplay from '../assets/code/display.zx81?raw';
 import assetBasicEnd from '../assets/code/basic-end.zx81?raw';
-export { assetCharacters, assetSystemVariables, assetBasicLine1, assetBasicLine2, assetDisplay, assetBasicEnd };
+
+export {assetCharacters, assetSystemVariables, assetBasicLine1, assetBasicLine2, assetDisplay, assetBasicEnd}