Release 1.9.0

[FlorianRappl]

New Pull Request

For more information, see the CONTRIBUTING guide.

Prerequisites

Please make sure you can check the following boxes:

• I have read the CONTRIBUTING document
• My code follows the code style of this project
• All new and existing tests passed

Type(s) of Changes

Contribution Type

What types of changes does your code introduce? Put an x in all the boxes that apply:

• Bug fix (non-breaking change which fixes an issue, please reference the issue id)
• New feature (non-breaking change which adds functionality, make sure to open an associated issue first)
• Breaking change (fix or feature that would cause existing functionality to change)
• I have updated the documentation accordingly
• I have added tests to cover my changes

Description

This is the next iteration of Piral, which brings some smaller enhancements as well as a quite cool convenience feature (remote types). Using remote types you can easily (i.e., without requiring effort within the pilets) get remote type definitions for all your micro frontends into a pilet - such that you can, e.g., see all defined extension slots and never miss using the right type.

The feature works by declaring a remote type source via the remoteTypesSource property in the piral.json. This is then picked up by the Piral CLI and integrated into the emulator (website or package). When the Piral CLI used in a pilet sees that the used app shell has remote types defined, it will create a new file (and keep that updated) in the pilet's source code. The location of the file can be determined using remoteTypesTarget.

Right now we make this opt-in, i.e., just because your Piral instance sets the remoteTypesSource does not mean that the file is written. Instead, if the remoteTypesTarget value is missing (default) then nothing is generated. You can either set it to a path of your desire (e.g., "./src/remote.d.ts") or just to true. In the latter case a default path (/src/remote.d.ts) is used. Make sure to exclude it from source control for maximum efficiency.

Remarks

The boundaries for the pilets are not explained in the feed service spec. The main reason for this is that the types / declaration feature is something optional, which is not part of the feed service core responsibility. The whole feature is rather meant as a convenience than a requirement. Potentially, we'll spec that out in the future.

[Copilot]

Pull Request Overview

This PR introduces release 1.9.0 of Piral with several enhancements and bug fixes. The centerpiece is a new remote types feature that enables automatic distribution of TypeScript declarations from pilets to other micro frontends, along with various improvements to error handling, debugging output, and dependency management.

• Remote types functionality allowing pilets to share TypeScript declarations via remoteTypesSource and remoteTypesTarget configuration
• Enhanced error handling and debugging output across npm client wrappers and template resolution
• Updates to various dependencies including migration from oidc-client to oidc-client-ts

Reviewed Changes

Copilot reviewed 72 out of 73 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
src/utilities/piral-debug-utils/src/overlay.ts	Removes unused container property from ErrorOverlayProps interface
src/utilities/piral-debug-utils/src/decycle.ts	Adds protected value handling for cross-context security errors
src/tooling/piral-cli/src/types/internal.ts	Adds remoteTypesTarget property to PiletDefinition interface
src/tooling/piral-cli/src/types/common.ts	Extends interfaces with remote types and shared dependencies support
src/tooling/piral-cli/src/common/package.ts	Implements core remote types functionality with retrieval and processing logic
src/tooling/piral-cli/src/common/website.ts	Adds retrieveExtraTypings function for downloading remote type definitions
src/tooling/piral-cli/src/common/emulator.ts	Integrates remote types source into emulator manifests
src/tooling/piral-cli/src/npm-clients/*.ts	Improves error output by logging command output when npm operations fail
src/tooling/piral-cli-webpack5/src/helpers.ts	Adds support for async webpack configurations and ESM module handling
src/plugins/piral-oidc/src/*.ts	Updates to use modern oidc-client-ts library with API changes
Various package.json files	Updates dependency versions with more flexible version ranges
Documentation files	Updates README files for converter packages with modern usage patterns

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}