@andrivet/z80-assembler 1.2.0 → 1.3.0

package/lib/compiler/Ast.d.ts

@@ -16,13 +16,13 @@
  * License:			GPLv3
  * Copyrights: 	Copyright (C) 2023 Sebastien Andrivet
  */
-import { bytes } from '../types/Types';
+import { Address, bytes } from '../types/Types';
 import { ByteValue, Expression, PosInfo, WordValue } from "../grammar/z80";
 /**
- * A function taking no argument and returning a number (if it is known) or null (if it is unknown).
+ * A function returning a number (if it is known) or null (if it is unknown).
  * Une function qui ne prend pas d'argument et qui retourne un nombre (s'il est connu) ou null (s'il est inconnu).
  */
-export type EvalFunc = () => number | null;
+export type EvalFunc = (pc: Address, mustExist: boolean) => number | null;
 /**
  * An abstract element generated by the parser.
  * Un élément abstrait générà par l'analyseur.
@@ -177,15 +177,20 @@ export declare function value16LE(pos: PosInfo, e: Expression): AstElement;
  */
 export declare function value8(pos: PosInfo, e: Expression): AstElement;
 /**
- * Returns an AST element that represents an 8-bit signed value.
- * Retourne un élément de l'AST qui représente une valeur 8 bits signée.
- * @param pos The position of the element in the source.
- *            La position de l'élément dans le code source.
- * @param s The sign of the value.
- * @param e The 8-bit signed value
- *          La valeur 8-bit signée.
+ * Returns an AST element that represents an 8-bit signed offset for IX or IY.
+ * Retourne un élément de l'AST qui représente un décalage 8 bits signé pour IX ou IY.
+ * @offset The offset for IX or IY with:
+ * pos The position of the element in the source.
+ *     La position de l'élément dans le code source.
+ * s The sign of the value.
+ * e The 8-bit signed décalage
+ *   Le décalage 8-bit signée.
  */
-export declare function svalue8(pos: PosInfo, s: string, e: Expression): AstElement;
+export declare function index(offset: {
+    pos: PosInfo;
+    s: string;
+    d: Expression;
+} | null): AstElement;
 /**
  * Returns an AST element that represents an offset for a JR (jump relative) opcode.
  * Retourne un élément de l'AST qui représente un décalage pour un saut relatif JR.
@@ -253,4 +258,6 @@ export declare function dataWords(_: PosInfo, data0: WordValue, data: InnerWord[
  *              La valeur utilisée pour initialiser le bloc.
  */
 export declare function dataBlock(pos0: PosInfo, length: Expression, pos1: PosInfo | undefined, value: Expression | undefined): AstElement;
+export declare function labelValue(pos: PosInfo, name: string): (pc: Address, mustExist: boolean) => number | null;
+export declare function value(nn: number): (pc: Address, mustExist: boolean) => number;
 export {};

package/lib/compiler/Labels.d.ts

@@ -17,11 +17,13 @@
  * Copyrights: 	Copyright (C) 2023 Sebastien Andrivet
  */
 import { Expression, PosInfo } from "../grammar/z80";
+import { Address, Position } from '../types/Types';
 /**
  * Reset the labels.
  * Supprime toutes les étiquettes.
  */
 declare function resetLabels(): void;
+declare function resetLabelsRecursion(): void;
 /**
  * Add a label.
  * Ajoute une étiquette.
@@ -32,7 +34,7 @@ declare function resetLabels(): void;
  * @param value The value of the label (if known) or null (if unknown).
  *              La valeur de l'étiquette (si connue) ou null (si inconnue).
  */
-declare function addLabel(pos: PosInfo, name: string, value: number | null): void;
+declare function addLabel(pos: Position, name: string, value: number | null): void;
 /**
  * Add a label and its associated expression.
  * Ajoute une étiquette et son expression associée.
@@ -47,14 +49,16 @@ declare function addLabelExpression(_: PosInfo, name: string, expression: Expres
 /**
  * Get the value associated with a label.
  * Obtient la valeur associée avec une étiquette.
+ * @param pc: Current program counter (PC).
  * @param name The name of the label.
  *             Le nom de l'étiquette.
- * @param setUsed Set the used flag or not.
- *                Est-ce que l'on doit lever le drapeau d'utilisation ?
+ * @param pos Where this label is used.
+ * @param setUsed If set, mark the label as used.
+ * @param mustExist If set, the value of the label has to be known (not null).
  * @return The value associated with a label or null if it is unknown.
  *         La valeur associée avec l'étiquette ou null si elle est inconnue.
  */
-declare function getLabelValue(name: string, setUsed?: boolean): number | null;
+declare function getLabelValue(pc: Address, name: string, pos: Position, setUsed: boolean, mustExist: boolean): number | null;
 /**
  * Is a label used in the program or only declared?
  * Est-ce qu'une étiquette a été utilisée ou seulement déclarée ?
@@ -64,9 +68,4 @@ declare function getLabelValue(name: string, setUsed?: boolean): number | null;
  *         true si l'étiquette a été utilisée, false sinon.
  */
 declare function isLabelUsed(name: string): boolean | undefined;
-/**
- * Get the list of labels with an unknown value.
- * Retourne la liste des étiquettes avec une valeur inconnue.
- */
-declare function getUnknownLabels(): string[];
-export { resetLabels, addLabel, addLabelExpression, getLabelValue, isLabelUsed, getUnknownLabels };
+export { resetLabels, resetLabelsRecursion, addLabel, addLabelExpression, getLabelValue, isLabelUsed };