@jhlagado/azm 0.2.6 → 0.2.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +170 -69
- package/dist/src/api-artifacts.d.ts +20 -0
- package/dist/src/api-artifacts.js +165 -0
- package/dist/src/api-compile.d.ts +8 -2
- package/dist/src/api-compile.js +31 -230
- package/dist/src/api-register-contracts.d.ts +9 -0
- package/dist/src/api-register-contracts.js +77 -0
- package/dist/src/api-tooling.d.ts +2 -2
- package/dist/src/api-tooling.js +1 -1
- package/dist/src/assembly/address-planning.d.ts +1 -2
- package/dist/src/assembly/address-planning.js +119 -218
- package/dist/src/assembly/address-symbols.d.ts +12 -0
- package/dist/src/assembly/address-symbols.js +118 -0
- package/dist/src/assembly/fixup-emission.js +30 -48
- package/dist/src/assembly/program-emission.js +163 -164
- package/dist/src/cli/artifact-files.d.ts +15 -0
- package/dist/src/cli/artifact-files.js +86 -0
- package/dist/src/cli/parse-args.d.ts +6 -5
- package/dist/src/cli/parse-args.js +162 -136
- package/dist/src/cli/run.js +4 -1
- package/dist/src/cli/usage.d.ts +1 -0
- package/dist/src/cli/usage.js +33 -0
- package/dist/src/cli/write-artifacts.js +18 -91
- package/dist/src/core/compile.js +51 -274
- package/dist/src/core/conditional-assembly.d.ts +6 -0
- package/dist/src/core/conditional-assembly.js +181 -0
- package/dist/src/expansion/op-constant-expression.d.ts +3 -0
- package/dist/src/expansion/op-constant-expression.js +52 -0
- package/dist/src/expansion/op-expand-selected.d.ts +5 -0
- package/dist/src/expansion/op-expand-selected.js +143 -0
- package/dist/src/expansion/op-expansion.d.ts +5 -53
- package/dist/src/expansion/op-expansion.js +85 -815
- package/dist/src/expansion/op-instruction-instantiation.d.ts +3 -0
- package/dist/src/expansion/op-instruction-instantiation.js +194 -0
- package/dist/src/expansion/op-local-labels.d.ts +8 -0
- package/dist/src/expansion/op-local-labels.js +166 -0
- package/dist/src/expansion/op-operand-splitting.d.ts +1 -0
- package/dist/src/expansion/op-operand-splitting.js +44 -0
- package/dist/src/expansion/op-operands.d.ts +53 -0
- package/dist/src/expansion/op-operands.js +66 -0
- package/dist/src/expansion/op-selection.d.ts +18 -0
- package/dist/src/expansion/op-selection.js +172 -0
- package/dist/src/index.d.ts +2 -1
- package/dist/src/index.js +1 -1
- package/dist/src/model/diagnostic.d.ts +4 -0
- package/dist/src/model/diagnostic.js +4 -0
- package/dist/src/outputs/asm80-expression-evaluation.d.ts +10 -0
- package/dist/src/outputs/asm80-expression-evaluation.js +75 -0
- package/dist/src/outputs/asm80-expressions.d.ts +5 -0
- package/dist/src/outputs/asm80-expressions.js +47 -0
- package/dist/src/outputs/asm80-instruction-operands.d.ts +16 -0
- package/dist/src/outputs/asm80-instruction-operands.js +38 -0
- package/dist/src/outputs/asm80-instructions.d.ts +5 -0
- package/dist/src/outputs/asm80-instructions.js +272 -0
- package/dist/src/outputs/asm80-ld-operands.d.ts +10 -0
- package/dist/src/outputs/asm80-ld-operands.js +157 -0
- package/dist/src/outputs/asm80-strings.d.ts +4 -0
- package/dist/src/outputs/asm80-strings.js +14 -0
- package/dist/src/outputs/d8-files.d.ts +10 -0
- package/dist/src/outputs/d8-files.js +103 -0
- package/dist/src/outputs/d8-helpers.d.ts +21 -0
- package/dist/src/outputs/d8-helpers.js +136 -0
- package/dist/src/outputs/hex.js +26 -18
- package/dist/src/outputs/types.d.ts +16 -10
- package/dist/src/outputs/write-asm80.js +68 -597
- package/dist/src/outputs/write-d8.js +6 -216
- package/dist/src/register-contracts/accept-output.d.ts +2 -0
- package/dist/src/register-contracts/analyze-helpers.d.ts +29 -0
- package/dist/src/register-contracts/analyze-helpers.js +162 -0
- package/dist/src/{register-care → register-contracts}/analyze.d.ts +6 -6
- package/dist/src/register-contracts/analyze.js +73 -0
- package/dist/src/register-contracts/annotate.d.ts +11 -0
- package/dist/src/{register-care → register-contracts}/annotate.js +3 -3
- package/dist/src/register-contracts/annotations.d.ts +8 -0
- package/dist/src/{register-care → register-contracts}/annotations.js +3 -3
- package/dist/src/register-contracts/boundaryHints.d.ts +3 -0
- package/dist/src/register-contracts/boundaryHints.js +24 -0
- package/dist/src/register-contracts/carriers.d.ts +2 -0
- package/dist/src/register-contracts/constants.d.ts +4 -0
- package/dist/src/register-contracts/constants.js +51 -0
- package/dist/src/register-contracts/controlFlow.d.ts +5 -0
- package/dist/src/register-contracts/controlFlow.js +55 -0
- package/dist/src/register-contracts/fix.d.ts +11 -0
- package/dist/src/{register-care → register-contracts}/fix.js +47 -30
- package/dist/src/register-contracts/instruction-head.d.ts +2 -0
- package/dist/src/register-contracts/instruction-head.js +3 -0
- package/dist/src/register-contracts/instruction-operands.d.ts +3 -0
- package/dist/src/register-contracts/instruction-operands.js +101 -0
- package/dist/src/register-contracts/instruction-predicates.d.ts +6 -0
- package/dist/src/register-contracts/instruction-predicates.js +44 -0
- package/dist/src/register-contracts/interfaceContracts.d.ts +2 -0
- package/dist/src/register-contracts/interfaceContracts.js +68 -0
- package/dist/src/register-contracts/liveness.d.ts +3 -0
- package/dist/src/{register-care → register-contracts}/liveness.js +111 -79
- package/dist/src/register-contracts/operand-register-name.d.ts +2 -0
- package/dist/src/register-contracts/operand-register-name.js +13 -0
- package/dist/src/{register-care → register-contracts}/profiles.d.ts +5 -5
- package/dist/src/{register-care → register-contracts}/profiles.js +13 -2
- package/dist/src/register-contracts/programModel-boundaries.d.ts +6 -0
- package/dist/src/register-contracts/programModel-boundaries.js +64 -0
- package/dist/src/register-contracts/programModel-routines.d.ts +7 -0
- package/dist/src/register-contracts/programModel-routines.js +128 -0
- package/dist/src/register-contracts/programModel.d.ts +3 -0
- package/dist/src/register-contracts/programModel.js +14 -0
- package/dist/src/register-contracts/report.d.ts +5 -0
- package/dist/src/{register-care → register-contracts}/report.js +34 -17
- package/dist/src/register-contracts/routine-summaries.d.ts +6 -0
- package/dist/src/{register-care → register-contracts}/routine-summaries.js +11 -1
- package/dist/src/register-contracts/smartCommentBlocks.d.ts +5 -0
- package/dist/src/register-contracts/smartCommentBlocks.js +30 -0
- package/dist/src/register-contracts/smartCommentParsing.d.ts +3 -0
- package/dist/src/register-contracts/smartCommentParsing.js +80 -0
- package/dist/src/register-contracts/smartComments.d.ts +5 -0
- package/dist/src/register-contracts/smartComments.js +92 -0
- package/dist/src/register-contracts/summaries.d.ts +12 -0
- package/dist/src/{register-care → register-contracts}/summaries.js +7 -7
- package/dist/src/register-contracts/summary-boundary.d.ts +2 -0
- package/dist/src/register-contracts/summary-boundary.js +40 -0
- package/dist/src/register-contracts/summary-contract.d.ts +2 -0
- package/dist/src/register-contracts/summary-contract.js +45 -0
- package/dist/src/register-contracts/summary-result.d.ts +7 -0
- package/dist/src/register-contracts/summary-result.js +122 -0
- package/dist/src/register-contracts/summary-state.d.ts +23 -0
- package/dist/src/register-contracts/summary-state.js +88 -0
- package/dist/src/register-contracts/summary-token-transfer.d.ts +3 -0
- package/dist/src/register-contracts/summary-token-transfer.js +67 -0
- package/dist/src/register-contracts/summary.d.ts +3 -0
- package/dist/src/register-contracts/summary.js +266 -0
- package/dist/src/register-contracts/tooling.d.ts +57 -0
- package/dist/src/{register-care → register-contracts}/tooling.js +8 -6
- package/dist/src/register-contracts/types.d.ts +188 -0
- package/dist/src/semantics/binary-operators.d.ts +2 -0
- package/dist/src/semantics/binary-operators.js +15 -0
- package/dist/src/semantics/byte-functions.d.ts +2 -0
- package/dist/src/semantics/byte-functions.js +7 -0
- package/dist/src/semantics/constant-operator-types.d.ts +10 -0
- package/dist/src/semantics/constant-operator-types.js +1 -0
- package/dist/src/semantics/constant-operators.d.ts +3 -0
- package/dist/src/semantics/constant-operators.js +3 -0
- package/dist/src/semantics/diagnostics.d.ts +3 -0
- package/dist/src/semantics/diagnostics.js +10 -0
- package/dist/src/semantics/expression-evaluation.d.ts +11 -19
- package/dist/src/semantics/expression-evaluation.js +22 -334
- package/dist/src/semantics/layout-evaluation.d.ts +23 -0
- package/dist/src/semantics/layout-evaluation.js +202 -0
- package/dist/src/semantics/layout-format.d.ts +5 -0
- package/dist/src/semantics/layout-format.js +31 -0
- package/dist/src/semantics/layout-path.d.ts +24 -0
- package/dist/src/semantics/layout-path.js +58 -0
- package/dist/src/semantics/unary-operators.d.ts +2 -0
- package/dist/src/semantics/unary-operators.js +8 -0
- package/dist/src/source/line-comment-scanner.d.ts +1 -0
- package/dist/src/source/line-comment-scanner.js +51 -0
- package/dist/src/source/strip-line-comment.js +8 -44
- package/dist/src/syntax/directive-aliases.js +36 -22
- package/dist/src/syntax/expression-tokenizer.d.ts +30 -0
- package/dist/src/syntax/expression-tokenizer.js +310 -0
- package/dist/src/syntax/parse-directive-statement.d.ts +14 -0
- package/dist/src/syntax/parse-directive-statement.js +307 -0
- package/dist/src/syntax/parse-expression.d.ts +2 -2
- package/dist/src/syntax/parse-expression.js +7 -568
- package/dist/src/syntax/parse-layout-declarations.d.ts +9 -0
- package/dist/src/syntax/parse-layout-declarations.js +180 -0
- package/dist/src/syntax/parse-layout-expression.d.ts +5 -0
- package/dist/src/syntax/parse-layout-expression.js +175 -0
- package/dist/src/syntax/parse-line.js +4 -272
- package/dist/src/syntax/parse-token-expression.d.ts +3 -0
- package/dist/src/syntax/parse-token-expression.js +133 -0
- package/dist/src/tooling/case-style.js +47 -30
- package/dist/src/z80/effect-groups.d.ts +38 -0
- package/dist/src/z80/effect-groups.js +265 -0
- package/dist/src/z80/effect-units.d.ts +18 -0
- package/dist/src/z80/effect-units.js +165 -0
- package/dist/src/z80/effects.d.ts +1 -1
- package/dist/src/z80/effects.js +94 -557
- package/dist/src/z80/encode-core.d.ts +2 -0
- package/dist/src/z80/encode-core.js +42 -0
- package/dist/src/z80/encode-ld-helpers.d.ts +25 -0
- package/dist/src/z80/encode-ld-helpers.js +172 -0
- package/dist/src/z80/encode-ld.d.ts +2 -0
- package/dist/src/z80/encode-ld.js +285 -0
- package/dist/src/z80/encode.js +190 -542
- package/dist/src/z80/ld-support.d.ts +3 -0
- package/dist/src/z80/ld-support.js +146 -0
- package/dist/src/z80/operand-split-state.d.ts +8 -0
- package/dist/src/z80/operand-split-state.js +46 -0
- package/dist/src/z80/operand-split.d.ts +1 -0
- package/dist/src/z80/operand-split.js +13 -0
- package/dist/src/z80/parse-basic.d.ts +4 -0
- package/dist/src/z80/parse-basic.js +39 -0
- package/dist/src/z80/parse-branch.d.ts +4 -0
- package/dist/src/z80/parse-branch.js +218 -0
- package/dist/src/z80/parse-conditions.d.ts +6 -0
- package/dist/src/z80/parse-conditions.js +10 -0
- package/dist/src/z80/parse-exchange.d.ts +2 -0
- package/dist/src/z80/parse-exchange.js +30 -0
- package/dist/src/z80/parse-instruction.js +224 -1010
- package/dist/src/z80/parse-io-control.d.ts +5 -0
- package/dist/src/z80/parse-io-control.js +108 -0
- package/dist/src/z80/parse-ld.d.ts +2 -0
- package/dist/src/z80/parse-ld.js +83 -0
- package/dist/src/z80/parse-operands.d.ts +41 -0
- package/dist/src/z80/parse-operands.js +259 -0
- package/docs/reference/cli.md +42 -35
- package/docs/reference/tooling-api.md +20 -16
- package/package.json +1 -1
- package/dist/src/register-care/accept-output.d.ts +0 -2
- package/dist/src/register-care/analyze.js +0 -166
- package/dist/src/register-care/annotate.d.ts +0 -11
- package/dist/src/register-care/annotations.d.ts +0 -8
- package/dist/src/register-care/boundaryHints.d.ts +0 -3
- package/dist/src/register-care/boundaryHints.js +0 -80
- package/dist/src/register-care/carriers.d.ts +0 -2
- package/dist/src/register-care/controlFlow.d.ts +0 -5
- package/dist/src/register-care/controlFlow.js +0 -38
- package/dist/src/register-care/fix.d.ts +0 -11
- package/dist/src/register-care/instruction-shape.d.ts +0 -11
- package/dist/src/register-care/instruction-shape.js +0 -129
- package/dist/src/register-care/liveness.d.ts +0 -3
- package/dist/src/register-care/programModel.d.ts +0 -3
- package/dist/src/register-care/programModel.js +0 -266
- package/dist/src/register-care/report.d.ts +0 -5
- package/dist/src/register-care/routine-summaries.d.ts +0 -6
- package/dist/src/register-care/smartComments.d.ts +0 -5
- package/dist/src/register-care/smartComments.js +0 -243
- package/dist/src/register-care/summaries.d.ts +0 -12
- package/dist/src/register-care/summary.d.ts +0 -3
- package/dist/src/register-care/summary.js +0 -474
- package/dist/src/register-care/tooling.d.ts +0 -43
- package/dist/src/register-care/types.d.ts +0 -172
- /package/dist/src/{register-care → register-contracts}/accept-output.js +0 -0
- /package/dist/src/{register-care → register-contracts}/carriers.js +0 -0
- /package/dist/src/{register-care → register-contracts}/sourceText.d.ts +0 -0
- /package/dist/src/{register-care → register-contracts}/sourceText.js +0 -0
- /package/dist/src/{register-care → register-contracts}/types.js +0 -0
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
export const FLAG_WRITES = ['sign', 'zero', 'halfCarry', 'parity', 'carry'];
|
|
2
|
+
export const INC_DEC_FLAG_WRITES = ['sign', 'zero', 'halfCarry', 'parity'];
|
|
3
|
+
export const ROTATE_SHIFT_FLAG_WRITES = [
|
|
4
|
+
'sign',
|
|
5
|
+
'zero',
|
|
6
|
+
'halfCarry',
|
|
7
|
+
'parity',
|
|
8
|
+
'carry',
|
|
9
|
+
];
|
|
10
|
+
export const BIT_FLAG_WRITES = ['sign', 'zero', 'halfCarry', 'parity'];
|
|
11
|
+
export const STACK_POINTER_UNITS = ['SPH', 'SPL'];
|
|
12
|
+
const UNKNOWN_UNITS = [
|
|
13
|
+
'A',
|
|
14
|
+
'B',
|
|
15
|
+
'C',
|
|
16
|
+
'D',
|
|
17
|
+
'E',
|
|
18
|
+
'H',
|
|
19
|
+
'L',
|
|
20
|
+
'IXH',
|
|
21
|
+
'IXL',
|
|
22
|
+
'IYH',
|
|
23
|
+
'IYL',
|
|
24
|
+
'SPH',
|
|
25
|
+
'SPL',
|
|
26
|
+
'carry',
|
|
27
|
+
'zero',
|
|
28
|
+
'sign',
|
|
29
|
+
'parity',
|
|
30
|
+
'halfCarry',
|
|
31
|
+
];
|
|
32
|
+
export function baseEffect() {
|
|
33
|
+
return {
|
|
34
|
+
reads: [],
|
|
35
|
+
writes: [],
|
|
36
|
+
stack: { kind: 'none' },
|
|
37
|
+
control: { kind: 'fallthrough' },
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
export function unknownEffect() {
|
|
41
|
+
return {
|
|
42
|
+
reads: UNKNOWN_UNITS,
|
|
43
|
+
writes: UNKNOWN_UNITS,
|
|
44
|
+
stack: { kind: 'unknown' },
|
|
45
|
+
control: { kind: 'unknown' },
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
export function concatUnique(...groups) {
|
|
49
|
+
const out = [];
|
|
50
|
+
for (const group of groups) {
|
|
51
|
+
appendUnique(out, group);
|
|
52
|
+
}
|
|
53
|
+
return out;
|
|
54
|
+
}
|
|
55
|
+
export function reg8Units(raw) {
|
|
56
|
+
const reg = raw.toLowerCase();
|
|
57
|
+
if (reg === 'a')
|
|
58
|
+
return ['A'];
|
|
59
|
+
if (reg === 'b')
|
|
60
|
+
return ['B'];
|
|
61
|
+
if (reg === 'c')
|
|
62
|
+
return ['C'];
|
|
63
|
+
if (reg === 'd')
|
|
64
|
+
return ['D'];
|
|
65
|
+
if (reg === 'e')
|
|
66
|
+
return ['E'];
|
|
67
|
+
if (reg === 'h')
|
|
68
|
+
return ['H'];
|
|
69
|
+
if (reg === 'l')
|
|
70
|
+
return ['L'];
|
|
71
|
+
return [];
|
|
72
|
+
}
|
|
73
|
+
export function reg16Units(raw) {
|
|
74
|
+
const reg = raw.toLowerCase();
|
|
75
|
+
if (reg === 'bc')
|
|
76
|
+
return ['B', 'C'];
|
|
77
|
+
if (reg === 'de')
|
|
78
|
+
return ['D', 'E'];
|
|
79
|
+
if (reg === 'hl')
|
|
80
|
+
return ['H', 'L'];
|
|
81
|
+
if (reg === 'sp')
|
|
82
|
+
return ['SPH', 'SPL'];
|
|
83
|
+
if (reg === 'ix')
|
|
84
|
+
return ['IXH', 'IXL'];
|
|
85
|
+
if (reg === 'iy')
|
|
86
|
+
return ['IYH', 'IYL'];
|
|
87
|
+
if (reg === 'af')
|
|
88
|
+
return ['A', ...FLAG_WRITES];
|
|
89
|
+
return [];
|
|
90
|
+
}
|
|
91
|
+
export function regHalfUnits(raw) {
|
|
92
|
+
const reg = raw.toLowerCase();
|
|
93
|
+
if (reg === 'ixh')
|
|
94
|
+
return ['IXH'];
|
|
95
|
+
if (reg === 'ixl')
|
|
96
|
+
return ['IXL'];
|
|
97
|
+
if (reg === 'iyh')
|
|
98
|
+
return ['IYH'];
|
|
99
|
+
if (reg === 'iyl')
|
|
100
|
+
return ['IYL'];
|
|
101
|
+
return [];
|
|
102
|
+
}
|
|
103
|
+
export function expressionSymbol(expression) {
|
|
104
|
+
return expression.kind === 'symbol' ? expression.name : undefined;
|
|
105
|
+
}
|
|
106
|
+
export function operandReads(op) {
|
|
107
|
+
switch (op.kind) {
|
|
108
|
+
case 'reg8':
|
|
109
|
+
return reg8Units(op.register);
|
|
110
|
+
case 'reg16':
|
|
111
|
+
case 'reg-index16':
|
|
112
|
+
return reg16Units(op.register);
|
|
113
|
+
case 'reg-half-index':
|
|
114
|
+
return regHalfUnits(op.register);
|
|
115
|
+
case 'special8':
|
|
116
|
+
return [];
|
|
117
|
+
case 'reg-indirect':
|
|
118
|
+
return reg16Units(op.register);
|
|
119
|
+
case 'indexed':
|
|
120
|
+
return reg16Units(op.register);
|
|
121
|
+
case 'mem-abs':
|
|
122
|
+
case 'imm':
|
|
123
|
+
return [];
|
|
124
|
+
default:
|
|
125
|
+
return undefined;
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
export function operandWrites(op) {
|
|
129
|
+
switch (op.kind) {
|
|
130
|
+
case 'reg8':
|
|
131
|
+
return reg8Units(op.register);
|
|
132
|
+
case 'reg16':
|
|
133
|
+
return reg16Units(op.register);
|
|
134
|
+
case 'reg-index16':
|
|
135
|
+
return reg16Units(op.register);
|
|
136
|
+
case 'reg-half-index':
|
|
137
|
+
return regHalfUnits(op.register);
|
|
138
|
+
default:
|
|
139
|
+
return undefined;
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
export function conditionFlagRead(condition) {
|
|
143
|
+
switch (condition) {
|
|
144
|
+
case 'z':
|
|
145
|
+
case 'nz':
|
|
146
|
+
return ['zero'];
|
|
147
|
+
case 'c':
|
|
148
|
+
case 'nc':
|
|
149
|
+
return ['carry'];
|
|
150
|
+
case 'm':
|
|
151
|
+
case 'p':
|
|
152
|
+
return ['sign'];
|
|
153
|
+
case 'pe':
|
|
154
|
+
case 'po':
|
|
155
|
+
return ['parity'];
|
|
156
|
+
default:
|
|
157
|
+
return [];
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
function appendUnique(out, units) {
|
|
161
|
+
for (const unit of units) {
|
|
162
|
+
if (!out.includes(unit))
|
|
163
|
+
out.push(unit);
|
|
164
|
+
}
|
|
165
|
+
}
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import type { InstructionEffect } from '../register-
|
|
1
|
+
import type { InstructionEffect } from '../register-contracts/types.js';
|
|
2
2
|
import type { Z80Instruction } from './instruction.js';
|
|
3
3
|
export declare function getZ80InstructionEffect(instruction: Z80Instruction): InstructionEffect;
|