`!ref` was previously deprecated, and has now been removed

[pcolby]

Expected

I expected all of the *.dsl files in the dsl directory to be processable by the current Structurizr CLI release (2025.05.28).

Actual

The following errors on:

• dsl/big-bank-plc/internet-banking-system/workspace.dsl and
• dsl/big-bank-plc/system-landscape/workspace.dsl

com.structurizr.dsl.StructurizrDslParserException: !ref was previously deprecated, and has now been removed - please use !element or !relationship instead at line 8 of /home/paul/.../dsl/big-bank-plc/internet-banking-system/workspace.dsl: !ref internetbankingsystem {
        at com.structurizr.dsl.StructurizrDslParser.parse(StructurizrDslParser.java:1214)
        at com.structurizr.dsl.StructurizrDslParser.parse(StructurizrDslParser.java:159)
        at com.structurizr.cli.AbstractCommand.loadWorkspace(AbstractCommand.java:94)
        at com.structurizr.cli.export.ExportCommand.run(ExportCommand.java:108)
        at com.structurizr.cli.StructurizrCliApplication.run(StructurizrCliApplication.java:83)
        at com.structurizr.cli.StructurizrCliApplication.main(StructurizrCliApplication.java:104)

com.structurizr.dsl.StructurizrDslParserException: !ref was previously deprecated, and has now been removed - please use !element or !relationship instead at line 8 of /home/paul/.../dsl/big-bank-plc/system-landscape/workspace.dsl: !ref internetbankingsystem {
        at com.structurizr.dsl.StructurizrDslParser.parse(StructurizrDslParser.java:1214)
        at com.structurizr.dsl.StructurizrDslParser.parse(StructurizrDslParser.java:159)
        at com.structurizr.cli.AbstractCommand.loadWorkspace(AbstractCommand.java:94)
        at com.structurizr.cli.export.ExportCommand.run(ExportCommand.java:108)
        at com.structurizr.cli.StructurizrCliApplication.run(StructurizrCliApplication.java:83)
        at com.structurizr.cli.StructurizrCliApplication.main(StructurizrCliApplication.java:104)

Steps to reproduce

1. install Structurizr CLI
2. checkout this repo
3. run structurizr.sh on either file, like:

structurizr.sh export --format json --workspace dsl/big-bank-plc/internet-banking-system/workspace.dsl
structurizr.sh export --format json --workspace dsl/big-bank-plc/system-landscape/workspace.dsl

Version/build information

Using the current HEAD of this repo (217be8b):

$ git log -n1
commit 217be8b4f507c4b3ef6492e173b77c3bb779edc1 (HEAD -> main, origin/main, origin/HEAD)
Author: Simon Brown <1009874+simonbrowndotje@users.noreply.github.com>
Date:   Sun May 11 10:08:23 2025 +0100

    .
$ git status --porcelain=v2
$ 

And Structurizr CLI 2025.05.28:

$ structurizr.sh version
structurizr-cli: 2025.05.28
structurizr-java: 4.1.0
Java: 21.0.7/Ubuntu (/usr/lib/jvm/java-21-openjdk-amd64)
OS: Linux 6.11.0-29-generic (amd64)

Severity

Minor

Priority

Low (I'm willing to make a pull request - please add a comment below summarising your approach before making a PR)

More information

No response