Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: ByteBardOrg/AsyncAPI.NET
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: docs/reference-updates
Choose a base ref
...
head repository: ByteBardOrg/AsyncAPI.NET
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: vnext
Choose a head ref
Checking mergeability… Don’t worry, you can still create the pull request.
  • 14 commits
  • 34 files changed
  • 3 contributors

Commits on Oct 25, 2026

  1. docs: use shiki for syntax highlighting (#65)

    * docs: document reference escaping, writing and version conversion
    
    - references: local references are JSON pointers in a URI, so "/" and "~"
      in a key are escaped as "~1" and "~0", and the pointer is percent-decoded;
      add how references are written, including inlining references whose
      target the written document does not have.
    - version conversion: list which references stay references and which are
      written inline, how V2 channel references map to V3 channel keys, and the
      operations and messages a downgrade drops.
    - README: drop the JsonPointer.Net attribution, which is no longer a
      dependency, and fix the ReferenceResolutionSetting name and a server
      reference example.
    
    * docs: highlight code with Shiki
    
    Prism's C# grammar has no raw string literals, so the AsyncAPI documents
    embedded in examples were highlighted as C# code, and as a regex-based
    grammar it leaves identifiers and properties plain. Its themes also gave
    types the same color as numbers and booleans.
    
    Code blocks now use Shiki with Visual Studio Code's grammars and its
    Light+ and Dark+ themes, through a swizzled CodeBlock/Content that keeps
    the theme's line rendering, so line numbers, highlighted lines and the copy
    button still work. Highlighting is synchronous, so pages render the same on
    the server and in the browser. C#, JSON, YAML and shell are loaded; other
    languages render as plain text.
    VisualBean authored Oct 25, 2026
    Configuration menu
    Copy the full SHA
    78b8b45 View commit details
    Browse the repository at this point in the history
  2. docs: list object models in tables, and soften dark mode contrast

    Binding pages described their properties in sentences such as "Server
    fields: ... Channel fields: ...". Each binding page now has an object model
    section with a table per class: the property, its YAML field, its .NET type
    and a description, taken from the binding classes, their deserializers and
    doc comments. Value unions, enums and policy types get their own tables.
    
    The Avro guide gets a type reference with a table per schema class,
    AvroField and the logical types, which were not documented before. The
    readers, schema parser members and reference resolution settings are
    tables as well.
    
    Dark mode used full white text and grey table and inline code colors on
    the purple background. Body text is now 80% white and headings 90%, and
    tables and inline code use neutral tints. Table headers are left-aligned.
    VisualBean committed Oct 25, 2026
    Configuration menu
    Copy the full SHA
    4b7b594 View commit details
    Browse the repository at this point in the history

Commits on Oct 30, 2026

  1. Configuration menu
    Copy the full SHA
    6592b58 View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    b6a36ec View commit details
    Browse the repository at this point in the history
  3. ci: trusted publishing

    VisualBean committed Oct 30, 2026
    Configuration menu
    Copy the full SHA
    f863e7a View commit details
    Browse the repository at this point in the history
  4. Update CHANGELOG for version 4.0.0

    Updated the changelog for version 4.0.0, detailing bug fixes, features, and breaking changes.
    
    Signed-off-by: Alex Wichmann <VisualBean@users.noreply.github.com>
    VisualBean authored Oct 30, 2026
    Configuration menu
    Copy the full SHA
    78ef45b View commit details
    Browse the repository at this point in the history
  5. Configuration menu
    Copy the full SHA
    f84f95e View commit details
    Browse the repository at this point in the history
  6. Configuration menu
    Copy the full SHA
    871976a View commit details
    Browse the repository at this point in the history
  7. Update README to remove GitHub Pages deployment note

    Removed mention of GitHub Pages configuration for deployment.
    
    Signed-off-by: Alex Wichmann <VisualBean@users.noreply.github.com>
    VisualBean authored Oct 30, 2026
    Configuration menu
    Copy the full SHA
    9ea3fbe View commit details
    Browse the repository at this point in the history
  8. docs: slim down the readme

    VisualBean committed Oct 30, 2026
    Configuration menu
    Copy the full SHA
    8795da5 View commit details
    Browse the repository at this point in the history
  9. Configuration menu
    Copy the full SHA
    cc1e7a5 View commit details
    Browse the repository at this point in the history

Commits on Nov 5, 2026

  1. fix: align identifier validation with spec constraints (#68)

    * fix: align identifier validation with spec constraints
    
    Use URL-safe ASCII identifier keys (letters, digits, dots, underscores,
    and hyphens) as the library baseline, with stricter rules wherever the
    specification requires them.
    
    - Reject dots in server keys.
    - Restrict component keys to ASCII.
    - Preserve the existing channel-key restriction.
    - Correct channel-address expression detection to include 0 and require
      nonempty names.
    - Add regression coverage for validation and parameter serialization.
    
    Compatibility: dotted server keys and Unicode component keys now produce
    validation errors, while their values remain preserved in the model.
    
    * fix(validation): reject server keys containing newlines
    
    Use the strict \z end-of-string anchor for server key validation so keys
    with a trailing newline cannot pass through the $ anchor.
    
    Add regression cases for trailing LF, CRLF, and embedded newlines in
    AsyncAPI 2.6.0 and 3.0.0. Escape carriage returns and newlines in
    double-quoted YAML keys so the tests preserve these characters for
    validation.
    VisualBean authored Nov 5, 2026
    Configuration menu
    Copy the full SHA
    2d0c046 View commit details
    Browse the repository at this point in the history

Commits on Nov 11, 2026

  1. feat: add net11.0 target (#70)

    bielu authored Nov 11, 2026
    Configuration menu
    Copy the full SHA
    cf14ea7 View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    3dc1870 View commit details
    Browse the repository at this point in the history
Loading