Releases · FHIR/sushi

@cmoesel

The SUSHI 3.16.0 release adds support for using NPM aliases when declaring dependencies. This allows authors to declare dependencies on multiple versions of the same package. The syntax for NPM aliases is alias@npm:packageId. For example:

dependencies:
  hl7.fhir.us.core: 7.0.0
  v610@npm:hl7.fhir.us.core: 6.1.0
  v311@npm:hl7.fhir.us.core: 3.1.1

Notes:

The alias (prefix before @npm:) follows the same rules as ids, allowing for A-Z, a-z, 0-9, -, and ..
These aliases can also be used in the longer-form dependency syntax (for manually specifying an id, uri, reason, etc.).
The alias cannot be referenced in FSH content; its only purpose is to allow multiple versions of the same dependency package.
When resolving versionless references to resources that are in multiple packages, SUSHI will resolve to the latest version.
This feature is not yet fully supported in all FHIR tools. We don't recommend using it until you see an announcement on Zulip.

What's Changed

Support for NPM aliases in dependencies by @cmoesel in #1568

Full Changelog: v3.15.1...v3.16.0

Install or Update

SUSHI 3.16.0 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.16.0, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release, run the following command:

$ npm install -g fsh-sushi@3.15.1

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

@cmoesel

SUSHI 3.15.1 fixes an issue generating the ImplementationGuide JSON when dependencies are specified using the .x wildcard patch version. It also updates FHIR Package Loader to v2.1.2, which downgrades an error to a warning when a #current dependency can't be downloaded from the build server but already exists in the cache (so processing can continue).

What's Changed

Fix bug detecting dependency uri when wildcard patch is used by @cmoesel in #1566
Update FPL to v2.1.2 by @cmoesel in #1567

Full Changelog: 3.15.0...v3.15.1

Install or Update

SUSHI 3.15.1 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.15.1, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release, run the following command:

$ npm install -g fsh-sushi@3.15.0

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

@costateixeira

SUSHI 3.15.0 is a minor release that moves the generated fsh-index.json file from fsh-generated to fsh-generated/data. This allows for the fsh-index.json file to be more easily leveraged by templates and tooling. Many thanks to @costateixeira for this contribution!

What's Changed

place fsh-index.json in the data folder by @costateixeira in #1556
Dependency Updates March 2025 by @cmoesel in #1562

Full Changelog: v3.14.0...v3.15.0

@cmoesel

SUSHI 3.14.0 (almost pi) is a minor release with several enhancements and bug fixes. The most notable changes are:

When resolving the Canonical keyword (e.g., Canonical(MyResource)), SUSHI now considers all canonical resources in your appropriate input/* folders and dependency packages. Previous versions only resolved canonicals for StructureDefinitions, ValueSets, and CodeSystems.
When resolving the Canonical keyword, SUSHI will consider the target type (where the canonical is being assigned), choosing the appropriate resolution when there are multiple matches. Previous versions of SUSHI always selected the first match, even if it was of the wrong type.
SUSHI now properly encodes URLs for cross-version extensions representing choice elements (i.e., elements with names ending in [x]). For example, the cross-version extension for R5's Questionnaire.versionAlgorithm[x] now correctly specifies its URL as http://hl7.org/fhir/5.0/StructureDefinition/extension-Questionnaire.versionAlgorithm%5Bx%5D.
The automatic hl7.fhir.uv.tools dependency now resolves to the latest published release-specific version of the package (e.g., hl7.fhir.uv.tools.r4#0.3.0). This aligns more closely with the behavior of the IG Publisher.

What's Changed

Support fishing all resource types from dependency packages and input/* by @cmoesel in #1548
URL Encode Cross-Version Extension URLs by @cmoesel in #1549
Use latest hl7.fhir.uv.tools release-specific package by @cmoesel in #1551
Improve error message for ValueSet compose component without any concept by @KaelynJefferson in #1540
Check exported resources for presence of multiple choice values by @mint-thompson in #1537
Entities with same name by @KaelynJefferson in #1528

Install or Update

SUSHI 3.14.0 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.14.0, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release, run the following command:

$ npm install -g fsh-sushi@3.13.1

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.13.1...v3.14.0

@cmoesel

SUSHI 3.13.1 is a patch release that fixes issues in SUSHI 3.13.0's file system interaction that occurred for users using Node 18 versions prior to Node 18.20.0.

What's Changed

Update FPL and avoid using readdirSync w/ recursive flag by @cmoesel in #1546

Install or Update

SUSHI 3.13.1 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.13.1, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release (3.12.1, since 3.13.0 contained significant bugs in Node < 18.20.0), run the following command:

$ npm install -g fsh-sushi@3.12.1

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.13.0...v3.13.1

@jafeltra

SUSHI 3.13.0 integrates the brand new FHIR Package Loader (FPL) 2.0.0. While this SUSHI release does not introduce any significant new features related to FPL 2.0.0, it sets up SUSHI to more easily support future enhancements and fixes to dependency handling.

SUSHI 3.13.0 also includes several bug fixes and minor enhancements.

What's Changed

Support fully defining resources using caret rules by @mint-thompson in #1530
Allow assigning an inline instance of a primitive by @jafeltra in #1539
Support "position" slicing discriminator by @mint-thompson in #1538
Handle missing snapshot when checking isModifierExtension by @jafeltra in #1541
Integrate FHIR Package Loader v2 by @cmoesel in #1543
v3.13.0 by @cmoesel in #1545

Install or Update

SUSHI 3.13.0 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.13.0, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release (3.12.1), run the following command:

$ npm install -g fsh-sushi@3.12.1

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.12.1...v3.13.0

@mint-thompson

SUSHI 3.12.1 is a patch release that contains a fix for a bug related to using FHIR R6 ballot versions. R5 terminology and extension packages will be automatically loaded when building a FHIR R6 project. This is because R6 versions of these packages are not yet available.

What's Changed

Update dependencies by @mint-thompson in #1532
Load automatic dependencies for FHIR R6 versions by @mint-thompson in #1534

Install or Update

SUSHI 3.12.1 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.12.1, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release (3.12.0), run the following command:

$ npm install -g fsh-sushi@3.12.0

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.12.0...v3.12.1

@mint-thompson

SUSHI 3.12.0 contains several enhancements and bug fixes, the most notable of which is support for FHIR R6 ballot 2. To base an IG on FHIR R6 ballot 2, specify fhirVersion as follows in your sushi-config.yaml:

fhirVersion: 6.0.0-ballot2

What's Changed

Software Changes

Allow 6.x versions of FHIR by @mint-thompson in #1517
Allow ValueSet to reference contained inline CodeSystem by @mint-thompson in #1520
Only return FshType id from rule value if the value is a string by @mint-thompson in #1524
Improve handling of ValueSet with self-reference by @KaelynJefferson in #1503
Fix FSH Finder URL for regression script by @cmoesel in #1523

Documentation Changes

Replace MITRE in project statement "maintainers" section by @mint-thompson in #1507
Link to Knowledge Sharing Sessions by @jafeltra in #1521
Correct date in DEPENDENCY-NOTES.md by @cmoesel in #1506

Install or Update

SUSHI 3.12.0 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.12.0, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release (3.11.1), run the following command:

$ npm install -g fsh-sushi@3.11.1

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.11.1...v3.12.0

@mint-thompson

What's Changed

Software Changes

Improve performance when processing predefined resources by @mint-thompson in #1500
Fix caret rules for versioned codes in ValueSets by @sebg-mio42 in #1493
Warn when reference values do not resolve and have incorrect format by @KaelynJefferson in #1468
Minor code cleanup by @cmoesel in #1498
Update dependencies by @mint-thompson in #1473, @cmoesel in #1496, and @cmoesel in #1502

Documentation Changes

Add security policy by @mint-thompson in #1471
Add contribution policy by @jafeltra in #1470
Add best practices by @jafeltra in #1474
Add FHIR Foundation project statement to README by @KaelynJefferson in #1472

New Contributors

@sebg-mio42 made their first contribution in #1493

Install or Update

SUSHI 3.11.1 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.11.1, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release (3.10.0), run the following command:

$ npm install -g fsh-sushi@3.11.0

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.11.0...v3.11.1

@joepaquette

SUSHI 3.11.0 contains the following enhancements and bug fixes:

What's Changed

Add new snapshot option to FshToFhir API by @joepaquette in #1465
Remove releaseLabel coded options from sushi-config.yaml created by sushi init by @jafeltra in #1462
Warn when sushi-config.yaml does not include a menu and there is no provided menu.xml by @KaelynJefferson in #1464
Set a default for Logical Model and Resource root elements to prevent empty/missing definition by @KaelynJefferson in #1466

New Contributors

@KaelynJefferson made their first contribution in #1464

Install or Update

SUSHI 3.11.0 is the latest stable release of fsh-sushi. To install or update to SUSHI 3.11.0, run the following command:

$ npm install -g fsh-sushi

To revert to the previous SUSHI stable release (3.10.0), run the following command:

$ npm install -g fsh-sushi@3.10.0

To check or confirm what version of SUSHI you have installed, you can run the following command:

$ sushi -v

Full Changelog: v3.10.0...v3.11.0

Releases: FHIR/sushi

SUSHI 3.16.0

What's Changed

Install or Update

Contributors

Uh oh!

SUSHI 3.15.1

What's Changed

Install or Update

Contributors

Uh oh!

SUSHI 3.15.0

What's Changed

Contributors

Uh oh!

SUSHI 3.14.0

What's Changed

Install or Update

Contributors

Uh oh!

SUSHI 3.13.1

What's Changed

Install or Update

Contributors

Uh oh!

SUSHI 3.13.0

What's Changed

Install or Update

Contributors

Uh oh!

SUSHI 3.12.1

What's Changed

Install or Update

Contributors

Uh oh!

SUSHI 3.12.0

What's Changed

Software Changes

Documentation Changes

Install or Update

Contributors

Uh oh!

SUSHI 3.11.1

What's Changed

Software Changes

Documentation Changes

New Contributors

Install or Update

Contributors

Uh oh!

SUSHI 3.11.0

What's Changed

New Contributors

Install or Update

Contributors

Uh oh!