@andrivet/z80-assembler 1.4.0 → 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,123 @@
+# Changelog
+
+## 2.0.0 - December 29, 2025
+
+* Fix propagation or source file name in case of compilation error.
+* Allowed device names are now:
+  - zx81: automatic generation of system variables, BASIC REM lines, etc. for the ZX81
+  - zx81-raw: without automatic generation of code but with translation for the ZX81 (characters)
+  - z80: Generic Z80 code without any generation or translation specific to the ZX81. Characters are treated as ASCII (i.e. they are not translated).
+* Strings are translated only for zx81 or zx81raw devices, not z80.
+* Add undocumented instructions
+  - Add support for IXh, IXl, IYh, IYl 8 bits registers
+  - Add support of these registers for ADC, ADD, AND, CP, DEC, INC, OR, SBC, SUB and XOR
+  - Add support of these registers for LD
+  - Add support of (IX+d), (IY+d) to RL, RLC, RR, RRC, SLA, SRA, SRL
+  - Add new instruction SSL
+  - Add IN F, (C)
+  - Add OUT (C), 0
+* Add fake instructions
+  - 16-bit rotate and shift
+    * rl qq
+    * rr qq
+    * sla qq
+    * sll qq, sli qq
+    * sra qq
+    * srl qq
+  - 16-bit load
+    * ld qq, qq
+    * ld qq, ix
+    * ld qq, iy
+    * ld qq, (hl)
+    * ld qq, (ix + nn)
+    * ld qq, (iy + nn)
+    * ld ix, qq
+    * ld iy, qq
+    * ld iy, ix
+    * ld ix, iy
+    * ld (hl), qq
+    * ld (ix + nn), qq
+    * ld (iy + nn), qq
+  - 16-bit load, increment
+    * ldi qq, (hl)
+    * ldi qq, (ix + nn)
+    * ldi qq, (iy + nn)
+    * ldi (hl), qq
+    * ldi (ix + nn), qq
+    * ldi (iy + nn), qq
+  - 8-bit load, increment
+    * ldi a, (bc)
+    * ldi a, (de)
+    * ldi r, (hl)
+    * ldi r, (ix + nn)
+    * ldi r, (iy + nn)
+    * ldi (bc), a
+    * ldi (de), a
+    * ldi (hl), r
+    * ldi (ix + nn), r
+    * ldi (iy + nn), r
+    * ldi (hl), n
+    * ldi (ix + nn), n
+    * ldi (iy + nn), n
+  - 8-bit load, decrement
+    * ldd a, (bc)
+    * ldd a, (de)
+    * ldd r, (hl)
+    * ldd r, (ix + nn)
+    * ldd r, (iy + nn)
+    * ldd (bc), a
+    * ldd (de), a
+    * ldd (hl), r
+    * ldd (ix + nn), r
+    * ldd (iy + nn), r
+    * ldd (hl), n
+    * ldd (ix + nn), n
+    * ldd (iy + nn), n
+  - 16-bit arithmetic
+    * adc de, ss
+    * add de, ss
+    * sbc de, ss
+    * sub de, ss
+    * sub hl, ss
+
+## 1.4.1 - December 22, 2025
+
+* Fix wrong publication
+
+## 1.4.0 - December 22, 2025
+
+* Fix #8: 'Invalid ZX81 character' when using '9', 'Z' or 'z' in a string.
+
+## 1.3.2 - November 20, 2024
+
+* Fix bugs introduced in commit 4bcb12ea82d38f83ce2079f8635909d0c5b5c57a
+* Add more compilation tests
+
+## 1.3.1 - November 20, 2024
+
+* Remove french comments
+* Fix issue #6 Labels are not generated in SLD when alone on a line
+
+## 1.3.0 - June 28, 2023
+
+* **1** - Allow (IX) and (IY) without an explicit offset. 
+* **2** - Define the pseudo value $ for PC.
+* **3** - Be more specific when an expression can't be evaluated.
+* **5** - Recursive labels are now properly detected (max 20 recursions).
+
+## 1.2.0 - June 20, 2023
+
+* Solve issue with expression starting with an open parenthesis
+* More comment (english and french)
+
+## 1.1.0 - June 13, 2023
+
+* Add special handling of ZX81 device
+* Only allow ZX81 string (ASCII string do not make sense)
+* Publication on GitHub Pages using GitHub Actions
+
+## 1.0.0 - June 5, 2023
+
+* First public version
+
+

package/README.md

@@ -1,79 +1,53 @@
 # z80-assembler
 
-![Z80](assets/images/logo.png)
+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.
 
-A Z80 assembler entirely written in Typescript and derived from a PEG grammar.
+## Demo application
 
-## Components
+A demo application is available: https://andrivet.github.io/z80-assembler/.
 
-* The first component is the library itself, `z80-assembler` that can be used like any npm library.
-* The second component is an application, `z80-assembler-app` that uses this library.
-  It can be used by itself or as an example of how to use the library. It is written in Typescript with React.
+## Quick guide to use the library
 
-![z80-assembler-app](assets/images/z80-assembler-app.png)
-
-This assembler is also used in the [ZX81 Debugger](https://github.com/andrivet/ZX81-Debugger).
-
-## How to build from source
+To install the library:
 
 ```
-npm --legacy-peer-deps install
-./node_modules/.bin/nx run z80-assembler-app:build:production
+$ npm install @andrivet/z80-assembler
 ```
 
-Notes: 
+The main function is simply called `compile`. It takes three arguments:
 
-* For the moment, you have to use `--legacy-peer-deps` because react-daisyui is not yet updated for DaisyUI 3.
-Once it is the case, this flag will no more be necessary.
+* the name of the source file
+* the Z80 source code to compile
+* a function used to return the content of included files
 
-* If you have installed NX globally, you do not need to specify its path.
+It returns an object of type `CompilationInfo` with the following fields:
 
-## How to run the application
+* `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:
 
 ```
-nx run z80-assembler-app:dev:production
+const info = compile(filepath, code, handleGetFileCode);
+if(info.errs.length > 0)
+  displayErrors(info.errs);
+else
+  saveOutput(info.outputName, info.bytes);
 ```
 
-Open a navigator at the URL http://localhost:4200/
-
-
-## Quick guide to use the application
-
-Under the **File** menu, you find the following commands:
-
-![Z80](assets/images/menu.png)
-
-* **Open Code**: Open a Z80 source file.
-* **Open Code Directory**: Open a directory with Z80 source files. This is especially useful if your source files contain includes.
-* **Save Code**: Save the current code file.
-* **Save Binary**: Save the compiled binary.
-* **Save SLD File**: Save the Source Level Debugging data in text format.
-* **Close Code**: Close the current code.
-* **Close All**: Close all the open codes.
-
-![Z80](assets/images/open-dir.png)
-
-Once one or more files are open, click on Compile to compile the code.
-The binary are displayed on the right side:
-
-![Z80](assets/images/compile.png)
-
-While writing your Z80 assembly code, you can display the list of Z80 opcodes by clicking on **Z80 Opcodes**:
-
-![Z80](assets/images/opcodes.png)
-
-Click on a category to see the corresponding opcodes:
-
-![Z80](assets/images/opcodes-load8.png)
+You can find a complete example in the [demo application](https://github.com/andrivet/z80-assembler/), in particular in the `app.tsx` file.
 
-## Z80 assembly
 
-The format of assembly source file is described in [Z80 Assembly Source Code Format](./docs/assembly.md).
+## Source code
 
+The source code is published on GitHub: https://github.com/andrivet/z80-assembler/.
 
 ## Licence
 
-This library and application are released under GPLv3.
+This library and associated application are released under GPLv3.
 
 ## Copyrights
 

package/{libs/z80-assembler/src/index.ts → index.d.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';