@jhlagado/azm 0.2.9 → 0.2.11

package/docs/codebase/06-verification-and-maintenance.md

@@ -74,6 +74,11 @@ These tests compare AZM behaviour against ASM80 expectations, lowered output and
 real-program fixtures. For an assembler, a one-byte difference is a behavioural
 change.
 
+The chained-instruction feature currently lives in `test/asm80/` because it
+crosses parser, op expansion, D8 map output and case-style linting in one user
+visible source shape. `multi_instruction_lines.test.ts` is the focused
+acceptance suite for that contract.
+
 ## Fixtures and Helpers
 
 `test/fixtures/` contains small source programs named after the issue or
@@ -115,11 +120,11 @@ Use this map when choosing a verification lane:
 
 | Change                      | Tests                                                                |
 | --------------------------- | -------------------------------------------------------------------- |
-| Parser or expression syntax | `test/unit/syntax/**`, relevant integration tests.                   |
+| Parser or expression syntax | `test/unit/syntax/**`, relevant integration tests and `test/asm80/multi_instruction_lines.test.ts` when the change affects chained physical lines. |
 | Source loading or tooling provenance | `test/integration/stage-11-tooling-api.test.ts`, relevant unit tests in `test/unit/source/**`. |
 | Z80 instruction support     | `test/unit/z80/**`, diagnostic matrices, ASM80 parity when relevant. |
 | Layout semantics            | layout integration tests and output tests.                           |
-| Ops                         | `test/unit/expansion/**`, op integration tests.                      |
+| Ops                         | `test/unit/expansion/**`, op integration tests and `test/asm80/multi_instruction_lines.test.ts` for chained bodies and invocation segments. |
 | Register contracts          | register contract unit, integration and CLI tests.                   |
 | CLI options                 | `test/cli/**`.                                                       |
 | Output artifacts            | `test/unit/outputs/**`, CLI artifact tests.                          |
@@ -145,7 +150,8 @@ Ask what kind of fact the change affects:
   `core/compile.ts`.
 - Assembler-time facts belong in `assembly/` and `semantics/`.
 - Instruction forms belong in `z80/`.
-- Inline source generation belongs in `expansion/`.
+- Instruction-chain splitting belongs in `source/`, while inline source
+  generation and op template expansion belong in `expansion/`.
 - Routine contracts and liveness belong in `register-contracts/`.
 - Artifact shape belongs in `outputs/`.
 - User commands belong in `cli/`.

package/docs/codebase/appendices/a-directory-file-reference.md

@@ -172,21 +172,28 @@ you need to find the owner of a behaviour quickly.
 | `logical-lines.ts`        | Splits source text into logical line records.            |
 | `source-span.ts`          | Defines source span shape.                               |
 | `line-comment-scanner.ts` | Finds semicolon comments while respecting quoted text.   |
+| `instruction-chain.ts`    | Splits spaced-backslash instruction lines into segments. |
 | `strip-line-comment.ts`   | Removes semicolon comments while respecting quoted text. |
 
 ## `src/syntax/`
 
 | File                           | Role                                                  |
 | ------------------------------ | ----------------------------------------------------- |
-| `parse-line.ts`                | Parses single logical lines into source items.        |
-| `expression-tokenizer.ts`      | Tokenizes expression text.                            |
-| `parse-token-expression.ts`    | Parses tokenized expressions into ASTs.               |
-| `parse-expression.ts`          | Public expression parse wrapper.                      |
-| `parse-directive-statement.ts` | Parses directive statements with structured operands. |
-| `parse-layout-declarations.ts` | Parses layout declaration forms.                      |
-| `parse-layout-expression.ts`   | Parses layout type expressions.                       |
-| `parse-diagnostics.ts`         | Shared parse diagnostic helpers.                      |
-| `directive-aliases.ts`         | Built-in and project directive alias policy.          |
+| `parse-line.ts`                    | Parses single logical lines into source items.                    |
+| `expression-tokenizer.ts`          | Tokenizes expression text.                                        |
+| `parse-token-expression.ts`        | Parses tokenized expressions into ASTs.                           |
+| `parse-expression.ts`              | Public expression parse wrapper.                                  |
+| `names.ts`                         | Shared identifier, label and entry-label parsing primitives.      |
+| `parse-instruction-chain.ts`       | Parses spaced-backslash chained instruction segments.             |
+| `statement-classification.ts`      | Shared chained-line and op-invocation classification helpers.     |
+| `parse-directive-statement.ts`     | Dispatches directive statements to focused directive parsers.      |
+| `parse-data-directives.ts`         | Parses `.db`, `.dw`, `.ds`, `.cstr`, `.pstr` and `.istr`.         |
+| `parse-declaration-directives.ts`  | Parses `.equ`, `.enum` and quoted declaration payloads.           |
+| `parse-location-directives.ts`     | Parses `.org`, `.align`, `.binfrom` and `.binto`.                 |
+| `parse-layout-declarations.ts`     | Parses layout declaration forms.                                  |
+| `parse-layout-expression.ts`       | Parses layout type expressions.                                   |
+| `parse-diagnostics.ts`             | Shared parse diagnostic helpers.                                  |
+| `directive-aliases.ts`             | Built-in and project directive alias policy.                      |
 
 ## `src/tooling/`
 
@@ -232,7 +239,7 @@ you need to find the owner of a behaviour quickly.
 | `test/integration/`                    | Cross-stage compiler tests.                      |
 | `test/integration/register-contracts/` | End-to-end register contract tests.              |
 | `test/cli/`                            | CLI option, artifact and exit-code contracts.    |
-| `test/asm80/`                          | ASM80 compatibility and real-program acceptance. |
+| `test/asm80/`                          | ASM80 compatibility, real-program acceptance and chained-line behaviour. |
 | `test/differential/`                   | Differential comparison fixtures and runners.    |
 | `test/fixtures/`                       | Source fixture programs.                         |
 | `test/helpers/`                        | Shared test setup and helpers.                   |

package/docs/codebase/appendices/b-compile-flow-reference.md

@@ -30,9 +30,10 @@ compile(entryFile, options, deps)
     parseNextSourceItems()
       applyConditionalAssembly()
       collect op definitions
+      expand op invocations
+      split chained instruction lines
       tokenize and parse expressions
       parse layouts, aliases, enums, directives and instructions
-      expand op invocations
   analyzeProgramNext()
     assembleProgram() for symbols
     lintCaseStyleNext()
@@ -98,6 +99,6 @@ tooling integrations that still use the older name.
 | Parsing            | logical lines        | source items                          |
 | Analysis           | source items         | diagnostics, symbols                  |
 | Register contracts | loaded program       | summaries, conflicts, reports         |
-| Assembly           | source items         | byte map, symbols, source segments    |
+| Assembly           | source items         | byte map, symbols, source segments with per-item columns |
 | Outputs            | byte map and symbols | artifacts                             |
 | CLI                | artifacts            | files on disk                         |

package/docs/codebase/index.md

@@ -44,3 +44,7 @@ modules. The directory appendix is the current file map for those modules.
 - [Appendix A - Directory and File Reference](appendices/a-directory-file-reference.md)
 - [Appendix B - Compile Flow Reference](appendices/b-compile-flow-reference.md)
 - [Appendix C - Public Surface Reference](appendices/c-public-surface-reference.md)
+
+## Related References
+
+- [AZM Grammar Reference](../reference/azm-grammar.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhlagado/azm",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "AZM assembler for the Z80 family (Node.js CLI)",
   "license": "GPL-3.0-only",
   "engines": {