npm - com.wallstop-studios.dxmessaging - Versions diffs - 2.1.3 → 2.1.5 - Mend

com.wallstop-studios.dxmessaging 2.1.3 → 2.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1222) hide show

package/site/reference/helpers/index.html ADDED Viewed

@@ -0,0 +1,475 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="High-performance type-safe messaging library for Unity"><meta name=author content="Wallstop Studios"><link href=https://wallstop.github.io/DxMessaging/reference/helpers/ rel=canonical><link href=../quick-reference/ rel=prev><link href=../faq/ rel=next><link rel=icon href=../../assets/images/favicon.png><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.7.1"><title>Helpers - DxMessaging Documentation</title><link rel=stylesheet href=../../assets/stylesheets/main.484c7ddc.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.ab4e12ef.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../css/timeago.css><link rel=stylesheet href=../../stylesheets/extra.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script></head> <body dir=ltr data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#helpers-and-source-generation class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class="md-header md-header--shadow md-header--lifted" data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="DxMessaging Documentation" class="md-header__button md-logo" aria-label="DxMessaging Documentation" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> DxMessaging Documentation </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Helpers </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme=default data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to dark mode" type=radio name=__palette id=__palette_0> <label class="md-header__button md-icon" title="Switch to dark mode" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> <input class=md-option data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme=slate data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to light mode" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_0 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> </form> <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <a href=javascript:void(0) class="md-search__icon md-icon" title=Share aria-label=Share data-clipboard data-clipboard-text data-md-component=search-share tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg> </a> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> <div class=md-search__suggest data-md-component=search-suggest></div> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> </nav> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Home </a> </li> <li class=md-tabs__item> <a href=../../getting-started/ class=md-tabs__link> Getting Started </a> </li> <li class=md-tabs__item> <a href=../../concepts/message-types/ class=md-tabs__link> Concepts </a> </li> <li class=md-tabs__item> <a href=../../guides/patterns/ class=md-tabs__link> Guides </a> </li> <li class=md-tabs__item> <a href=../../architecture/design-and-architecture/ class=md-tabs__link> Architecture </a> </li> <li class=md-tabs__item> <a href=../../advanced/emit-shorthands/ class=md-tabs__link> Advanced </a> </li> <li class=md-tabs__item> <a href=../../integrations/ class=md-tabs__link> Integrations </a> </li> <li class=md-tabs__item> <a href=../../examples/end-to-end/ class=md-tabs__link> Examples </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../reference/ class=md-tabs__link> Reference </a> </li> </ul> </div> </nav> </header> <div class=md-container data-md-component=container> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="DxMessaging Documentation" class="md-nav__button md-logo" aria-label="DxMessaging Documentation" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> DxMessaging Documentation </label> <div class=md-nav__source> <a href=https://github.com/wallstop/DxMessaging title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </div> <div class=md-source__repository> wallstop/DxMessaging </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Home </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_2> <div class="md-nav__link md-nav__container"> <a href=../../getting-started/ class="md-nav__link "> <span class=md-ellipsis> Getting Started </span> </a> <label class="md-nav__link " for=__nav_2 id=__nav_2_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_2_label aria-expanded=false> <label class=md-nav__title for=__nav_2> <span class="md-nav__icon md-icon"></span> Getting Started </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../getting-started/overview/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/install/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/quick-start/ class=md-nav__link> <span class=md-ellipsis> Quick Start </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/getting-started/ class=md-nav__link> <span class=md-ellipsis> Getting Started Guide </span> </a> </li> <li class=md-nav__item> <a href=../../getting-started/visual-guide/ class=md-nav__link> <span class=md-ellipsis> Visual Guide </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_3> <label class=md-nav__link for=__nav_3 id=__nav_3_label tabindex=0> <span class=md-ellipsis> Concepts </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3> <span class="md-nav__icon md-icon"></span> Concepts </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../concepts/message-types/ class=md-nav__link> <span class=md-ellipsis> Message Types </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/listening-patterns/ class=md-nav__link> <span class=md-ellipsis> Listening Patterns </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/targeting-and-context/ class=md-nav__link> <span class=md-ellipsis> Targeting & Context </span> </a> </li> <li class=md-nav__item> <a href=../../concepts/interceptors-and-ordering/ class=md-nav__link> <span class=md-ellipsis> Interceptors & Ordering </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_4> <label class=md-nav__link for=__nav_4 id=__nav_4_label tabindex=0> <span class=md-ellipsis> Guides </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_4_label aria-expanded=false> <label class=md-nav__title for=__nav_4> <span class="md-nav__icon md-icon"></span> Guides </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../guides/patterns/ class=md-nav__link> <span class=md-ellipsis> Patterns </span> </a> </li> <li class=md-nav__item> <a href=../../guides/unity-integration/ class=md-nav__link> <span class=md-ellipsis> Unity Integration </span> </a> </li> <li class=md-nav__item> <a href=../../guides/testing/ class=md-nav__link> <span class=md-ellipsis> Testing </span> </a> </li> <li class=md-nav__item> <a href=../../guides/diagnostics/ class=md-nav__link> <span class=md-ellipsis> Diagnostics </span> </a> </li> <li class=md-nav__item> <a href=../../guides/advanced/ class=md-nav__link> <span class=md-ellipsis> Advanced Topics </span> </a> </li> <li class=md-nav__item> <a href=../../guides/migration-guide/ class=md-nav__link> <span class=md-ellipsis> Migration Guide </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_5> <label class=md-nav__link for=__nav_5 id=__nav_5_label tabindex=0> <span class=md-ellipsis> Architecture </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_5_label aria-expanded=false> <label class=md-nav__title for=__nav_5> <span class="md-nav__icon md-icon"></span> Architecture </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../architecture/design-and-architecture/ class=md-nav__link> <span class=md-ellipsis> Design & Architecture </span> </a> </li> <li class=md-nav__item> <a href=../../architecture/comparisons/ class=md-nav__link> <span class=md-ellipsis> Comparisons </span> </a> </li> <li class=md-nav__item> <a href=../../architecture/performance/ class=md-nav__link> <span class=md-ellipsis> Performance </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Advanced </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Advanced </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../advanced/emit-shorthands/ class=md-nav__link> <span class=md-ellipsis> Emit Shorthands </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/message-bus-providers/ class=md-nav__link> <span class=md-ellipsis> Message Bus Providers </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/registration-builders/ class=md-nav__link> <span class=md-ellipsis> Registration Builders </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/runtime-configuration/ class=md-nav__link> <span class=md-ellipsis> Runtime Configuration </span> </a> </li> <li class=md-nav__item> <a href=../../advanced/string-messages/ class=md-nav__link> <span class=md-ellipsis> String Messages </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_7> <div class="md-nav__link md-nav__container"> <a href=../../integrations/ class="md-nav__link "> <span class=md-ellipsis> Integrations </span> </a> <label class="md-nav__link " for=__nav_7 id=__nav_7_label tabindex=0> <span class="md-nav__icon md-icon"></span> </label> </div> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Integrations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../integrations/vcontainer/ class=md-nav__link> <span class=md-ellipsis> VContainer </span> </a> </li> <li class=md-nav__item> <a href=../../integrations/zenject/ class=md-nav__link> <span class=md-ellipsis> Zenject </span> </a> </li> <li class=md-nav__item> <a href=../../integrations/reflex/ class=md-nav__link> <span class=md-ellipsis> Reflex </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Examples </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Examples </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../examples/end-to-end/ class=md-nav__link> <span class=md-ellipsis> End-to-End </span> </a> </li> <li class=md-nav__item> <a href=../../examples/end-to-end-scene-transitions/ class=md-nav__link> <span class=md-ellipsis> Scene Transitions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/ class=md-nav__link> <span class=md-ellipsis> API Reference (Practical) </span> </a> </li> <li class=md-nav__item> <a href=../quick-reference/ class=md-nav__link> <span class=md-ellipsis> Quick Reference </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Helpers </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Helpers </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#what-are-source-generators class=md-nav__link> <span class=md-ellipsis> What Are Source Generators </span> </a> <nav class=md-nav aria-label="What Are Source Generators"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#in-plain-english class=md-nav__link> <span class=md-ellipsis> In plain English </span> </a> <nav class=md-nav aria-label="In plain English"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#learn-more-about-source-generators class=md-nav__link> <span class=md-ellipsis> Learn more about source generators </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#dxmessaging-attributes-your-code-wizards class=md-nav__link> <span class=md-ellipsis> DxMessaging Attributes (Your Code Wizards) </span> </a> <nav class=md-nav aria-label="DxMessaging Attributes (Your Code Wizards)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#1-message-type-attributes-pick-your-message-category class=md-nav__link> <span class=md-ellipsis> 1. Message Type Attributes (Pick Your Message Category) </span> </a> <nav class=md-nav aria-label="1. Message Type Attributes (Pick Your Message Category)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#dxuntargetedmessage---global-messages class=md-nav__link> <span class=md-ellipsis> [DxUntargetedMessage] - Global Messages </span> </a> <nav class=md-nav aria-label="[DxUntargetedMessage] - Global Messages"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-it-generates class=md-nav__link> <span class=md-ellipsis> What it generates </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#dxtargetedmessage---messages-to-specific-targets class=md-nav__link> <span class=md-ellipsis> [DxTargetedMessage] - Messages to Specific Targets </span> </a> <nav class=md-nav aria-label="[DxTargetedMessage] - Messages to Specific Targets"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-it-generates_1 class=md-nav__link> <span class=md-ellipsis> What it generates </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#dxbroadcastmessage---messages-from-a-source class=md-nav__link> <span class=md-ellipsis> [DxBroadcastMessage] - Messages from a Source </span> </a> <nav class=md-nav aria-label="[DxBroadcastMessage] - Messages from a Source"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-it-generates_2 class=md-nav__link> <span class=md-ellipsis> What it generates </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#2-dxautoconstructor---automatic-constructors class=md-nav__link> <span class=md-ellipsis> 2. [DxAutoConstructor] - Automatic Constructors </span> </a> <nav class=md-nav aria-label="2. [DxAutoConstructor] - Automatic Constructors"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-get-auto-generated class=md-nav__link> <span class=md-ellipsis> What you get (auto-generated) </span> </a> <nav class=md-nav aria-label="What you get (auto-generated)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#rules class=md-nav__link> <span class=md-ellipsis> Rules </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#3-dxoptionalparameter---optional-constructor-parameters class=md-nav__link> <span class=md-ellipsis> 3. [DxOptionalParameter] - Optional Constructor Parameters </span> </a> <nav class=md-nav aria-label="3. [DxOptionalParameter] - Optional Constructor Parameters"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#how-it-works-with-dxautoconstructor class=md-nav__link> <span class=md-ellipsis> How It Works with DxAutoConstructor </span> </a> </li> <li class=md-nav__item> <a href=#generated-constructor class=md-nav__link> <span class=md-ellipsis> Generated constructor </span> </a> </li> <li class=md-nav__item> <a href=#calling-the-constructor class=md-nav__link> <span class=md-ellipsis> Calling the Constructor </span> </a> </li> <li class=md-nav__item> <a href=#supported-default-value-types class=md-nav__link> <span class=md-ellipsis> Supported Default Value Types </span> </a> <nav class=md-nav aria-label="Supported Default Value Types"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#examples-by-type class=md-nav__link> <span class=md-ellipsis> Examples by type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#using-type-defaults class=md-nav__link> <span class=md-ellipsis> Using Type Defaults </span> </a> </li> <li class=md-nav__item> <a href=#advanced-custom-expressions-for-any-type class=md-nav__link> <span class=md-ellipsis> Advanced: Custom Expressions for Any Type </span> </a> </li> <li class=md-nav__item> <a href=#code-examples class=md-nav__link> <span class=md-ellipsis> Code Examples </span> </a> </li> <li class=md-nav__item> <a href=#example-1-basic-optional-parameter-with-default-value class=md-nav__link> <span class=md-ellipsis> Example 1: Basic Optional Parameter with Default Value </span> </a> </li> <li class=md-nav__item> <a href=#example-2-multiple-optional-parameters class=md-nav__link> <span class=md-ellipsis> Example 2: Multiple Optional Parameters </span> </a> </li> <li class=md-nav__item> <a href=#example-3-mix-of-required-and-optional-fields class=md-nav__link> <span class=md-ellipsis> Example 3: Mix of Required and Optional Fields </span> </a> </li> <li class=md-nav__item> <a href=#example-4-game-settings-message class=md-nav__link> <span class=md-ellipsis> Example 4: Game Settings Message </span> </a> </li> <li class=md-nav__item> <a href=#best-practices class=md-nav__link> <span class=md-ellipsis> Best Practices </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#why-use-attributes-instead-of-manual-implementation class=md-nav__link> <span class=md-ellipsis> Why Use Attributes Instead of Manual Implementation </span> </a> <nav class=md-nav aria-label="Why Use Attributes Instead of Manual Implementation"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#-attribute-definition-clean-automatic class=md-nav__link> <span class=md-ellipsis> ✅ Attribute Definition (Clean, Automatic) </span> </a> </li> <li class=md-nav__item> <a href=#what-the-generator-emits-for-reference class=md-nav__link> <span class=md-ellipsis> What the generator emits (for reference) </span> </a> <nav class=md-nav aria-label="What the generator emits (for reference)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#complete-example-attribute-definition-vs-generated-output class=md-nav__link> <span class=md-ellipsis> Complete Example: Attribute Definition vs Generated Output </span> </a> <nav class=md-nav aria-label="Complete Example: Attribute Definition vs Generated Output"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#attribute-definition-8-lines class=md-nav__link> <span class=md-ellipsis> Attribute Definition (8 lines) </span> </a> </li> <li class=md-nav__item> <a href=#generated-output-20-lines-you-never-write class=md-nav__link> <span class=md-ellipsis> Generated Output (20 lines you never write) </span> </a> </li> <li class=md-nav__item> <a href=#result class=md-nav__link> <span class=md-ellipsis> Result </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#advanced-manual-implementation-when-attributes-arent-enough class=md-nav__link> <span class=md-ellipsis> Advanced: Manual Implementation (When Attributes Aren't Enough) </span> </a> <nav class=md-nav aria-label="Advanced: Manual Implementation (When Attributes Aren't Enough)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#generic-message-interfaces-zero-boxing-for-structs class=md-nav__link> <span class=md-ellipsis> Generic Message Interfaces (Zero-Boxing for Structs) </span> </a> </li> <li class=md-nav__item> <a href=#do-i-have-to-use-attributes class=md-nav__link> <span class=md-ellipsis> "Do I HAVE to use attributes?" </span> </a> </li> <li class=md-nav__item> <a href=#what-if-i-want-custom-constructor-logic class=md-nav__link> <span class=md-ellipsis> "What if I want custom constructor logic?" </span> </a> </li> <li class=md-nav__item> <a href=#can-i-mix-attribute-based-and-manual-messages class=md-nav__link> <span class=md-ellipsis> "Can I mix attribute-based and manual messages?" </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#extension-methods-emit-helpers class=md-nav__link> <span class=md-ellipsis> Extension Methods (Emit Helpers) </span> </a> <nav class=md-nav aria-label="Extension Methods (Emit Helpers)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#automatic-overload-selection class=md-nav__link> <span class=md-ellipsis> Automatic overload selection </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#local-bus-islands-isolated-testing class=md-nav__link> <span class=md-ellipsis> Local Bus Islands (Isolated Testing) </span> </a> <nav class=md-nav aria-label="Local Bus Islands (Isolated Testing)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-cases class=md-nav__link> <span class=md-ellipsis> Use cases </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#attributes-quick-reference class=md-nav__link> <span class=md-ellipsis> Attributes Quick Reference </span> </a> <nav class=md-nav aria-label="Attributes Quick Reference"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#message-type-attributes class=md-nav__link> <span class=md-ellipsis> Message Type Attributes </span> </a> </li> <li class=md-nav__item> <a href=#constructor-generation-attributes class=md-nav__link> <span class=md-ellipsis> Constructor Generation Attributes </span> </a> <nav class=md-nav aria-label="Constructor Generation Attributes"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#dxautoconstructor class=md-nav__link> <span class=md-ellipsis> [DxAutoConstructor] </span> </a> </li> <li class=md-nav__item> <a href=#dxoptionalparameter class=md-nav__link> <span class=md-ellipsis> [DxOptionalParameter] </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#supported-types class=md-nav__link> <span class=md-ellipsis> Supported Types </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#common-patterns-with-attributes class=md-nav__link> <span class=md-ellipsis> Common Patterns with Attributes </span> </a> <nav class=md-nav aria-label="Common Patterns with Attributes"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#pattern-1-simple-message-no-data class=md-nav__link> <span class=md-ellipsis> Pattern 1: Simple Message (No Data) </span> </a> </li> <li class=md-nav__item> <a href=#pattern-2-message-with-data class=md-nav__link> <span class=md-ellipsis> Pattern 2: Message with Data </span> </a> </li> <li class=md-nav__item> <a href=#pattern-3-message-with-optional-fields class=md-nav__link> <span class=md-ellipsis> Pattern 3: Message with Optional Fields </span> </a> </li> <li class=md-nav__item> <a href=#pattern-4-complex-message class=md-nav__link> <span class=md-ellipsis> Pattern 4: Complex Message </span> </a> </li> <li class=md-nav__item> <a href=#pattern-5-nested-types class=md-nav__link> <span class=md-ellipsis> Pattern 5: Nested Types </span> </a> <nav class=md-nav aria-label="Pattern 5: Nested Types"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits_1 class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-6-internal-types-assembly-private-messages class=md-nav__link> <span class=md-ellipsis> Pattern 6: Internal Types (Assembly-Private Messages) </span> </a> <nav class=md-nav aria-label="Pattern 6: Internal Types (Assembly-Private Messages)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-cases_1 class=md-nav__link> <span class=md-ellipsis> Use cases </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#faq-source-generators--attributes class=md-nav__link> <span class=md-ellipsis> FAQ: Source Generators &amp; Attributes </span> </a> <nav class=md-nav aria-label="FAQ: Source Generators & Attributes"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#do-i-have-to-use-attributes_1 class=md-nav__link> <span class=md-ellipsis> "Do I HAVE to use attributes?" </span> </a> </li> <li class=md-nav__item> <a href=#why-partial-when-using-attributes class=md-nav__link> <span class=md-ellipsis> "Why partial when using attributes?" </span> </a> </li> <li class=md-nav__item> <a href=#can-i-see-the-generated-code class=md-nav__link> <span class=md-ellipsis> "Can I see the generated code?" </span> </a> </li> <li class=md-nav__item> <a href=#what-if-i-want-custom-constructor-logic_1 class=md-nav__link> <span class=md-ellipsis> "What if I want custom constructor logic?" </span> </a> </li> <li class=md-nav__item> <a href=#do-attributes-affect-runtime-performance class=md-nav__link> <span class=md-ellipsis> "Do attributes affect runtime performance?" </span> </a> </li> <li class=md-nav__item> <a href=#can-i-mix-attributes-and-manual-implementation class=md-nav__link> <span class=md-ellipsis> "Can I mix attributes and manual implementation?" </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#troubleshooting-source-generators class=md-nav__link> <span class=md-ellipsis> Troubleshooting Source Generators </span> </a> </li> <li class=md-nav__item> <a href=#related-documentation class=md-nav__link> <span class=md-ellipsis> Related Documentation </span> </a> </li> <li class=md-nav__item> <a href=#summary class=md-nav__link> <span class=md-ellipsis> Summary </span> </a> <nav class=md-nav aria-label=Summary> <ul class=md-nav__list> <li class=md-nav__item> <a href=#source-generators--code-wizards-that-write-boilerplate-for-you class=md-nav__link> <span class=md-ellipsis> Source generators = Code wizards that write boilerplate for you </span> </a> <nav class=md-nav aria-label="Source generators = Code wizards that write boilerplate for you"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-attributes-for class=md-nav__link> <span class=md-ellipsis> Use attributes for </span> </a> <nav class=md-nav aria-label="Use attributes for"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-manual-implementation-for class=md-nav__link> <span class=md-ellipsis> Use manual implementation for </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../faq/ class=md-nav__link> <span class=md-ellipsis> FAQ </span> </a> </li> <li class=md-nav__item> <a href=../glossary/ class=md-nav__link> <span class=md-ellipsis> Glossary </span> </a> </li> <li class=md-nav__item> <a href=../troubleshooting/ class=md-nav__link> <span class=md-ellipsis> Troubleshooting </span> </a> </li> <li class=md-nav__item> <a href=../compatibility/ class=md-nav__link> <span class=md-ellipsis> Compatibility </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#what-are-source-generators class=md-nav__link> <span class=md-ellipsis> What Are Source Generators </span> </a> <nav class=md-nav aria-label="What Are Source Generators"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#in-plain-english class=md-nav__link> <span class=md-ellipsis> In plain English </span> </a> <nav class=md-nav aria-label="In plain English"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#learn-more-about-source-generators class=md-nav__link> <span class=md-ellipsis> Learn more about source generators </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#dxmessaging-attributes-your-code-wizards class=md-nav__link> <span class=md-ellipsis> DxMessaging Attributes (Your Code Wizards) </span> </a> <nav class=md-nav aria-label="DxMessaging Attributes (Your Code Wizards)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#1-message-type-attributes-pick-your-message-category class=md-nav__link> <span class=md-ellipsis> 1. Message Type Attributes (Pick Your Message Category) </span> </a> <nav class=md-nav aria-label="1. Message Type Attributes (Pick Your Message Category)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#dxuntargetedmessage---global-messages class=md-nav__link> <span class=md-ellipsis> [DxUntargetedMessage] - Global Messages </span> </a> <nav class=md-nav aria-label="[DxUntargetedMessage] - Global Messages"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-it-generates class=md-nav__link> <span class=md-ellipsis> What it generates </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#dxtargetedmessage---messages-to-specific-targets class=md-nav__link> <span class=md-ellipsis> [DxTargetedMessage] - Messages to Specific Targets </span> </a> <nav class=md-nav aria-label="[DxTargetedMessage] - Messages to Specific Targets"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-it-generates_1 class=md-nav__link> <span class=md-ellipsis> What it generates </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#dxbroadcastmessage---messages-from-a-source class=md-nav__link> <span class=md-ellipsis> [DxBroadcastMessage] - Messages from a Source </span> </a> <nav class=md-nav aria-label="[DxBroadcastMessage] - Messages from a Source"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-it-generates_2 class=md-nav__link> <span class=md-ellipsis> What it generates </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#2-dxautoconstructor---automatic-constructors class=md-nav__link> <span class=md-ellipsis> 2. [DxAutoConstructor] - Automatic Constructors </span> </a> <nav class=md-nav aria-label="2. [DxAutoConstructor] - Automatic Constructors"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#what-you-get-auto-generated class=md-nav__link> <span class=md-ellipsis> What you get (auto-generated) </span> </a> <nav class=md-nav aria-label="What you get (auto-generated)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#rules class=md-nav__link> <span class=md-ellipsis> Rules </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#3-dxoptionalparameter---optional-constructor-parameters class=md-nav__link> <span class=md-ellipsis> 3. [DxOptionalParameter] - Optional Constructor Parameters </span> </a> <nav class=md-nav aria-label="3. [DxOptionalParameter] - Optional Constructor Parameters"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#how-it-works-with-dxautoconstructor class=md-nav__link> <span class=md-ellipsis> How It Works with DxAutoConstructor </span> </a> </li> <li class=md-nav__item> <a href=#generated-constructor class=md-nav__link> <span class=md-ellipsis> Generated constructor </span> </a> </li> <li class=md-nav__item> <a href=#calling-the-constructor class=md-nav__link> <span class=md-ellipsis> Calling the Constructor </span> </a> </li> <li class=md-nav__item> <a href=#supported-default-value-types class=md-nav__link> <span class=md-ellipsis> Supported Default Value Types </span> </a> <nav class=md-nav aria-label="Supported Default Value Types"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#examples-by-type class=md-nav__link> <span class=md-ellipsis> Examples by type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#using-type-defaults class=md-nav__link> <span class=md-ellipsis> Using Type Defaults </span> </a> </li> <li class=md-nav__item> <a href=#advanced-custom-expressions-for-any-type class=md-nav__link> <span class=md-ellipsis> Advanced: Custom Expressions for Any Type </span> </a> </li> <li class=md-nav__item> <a href=#code-examples class=md-nav__link> <span class=md-ellipsis> Code Examples </span> </a> </li> <li class=md-nav__item> <a href=#example-1-basic-optional-parameter-with-default-value class=md-nav__link> <span class=md-ellipsis> Example 1: Basic Optional Parameter with Default Value </span> </a> </li> <li class=md-nav__item> <a href=#example-2-multiple-optional-parameters class=md-nav__link> <span class=md-ellipsis> Example 2: Multiple Optional Parameters </span> </a> </li> <li class=md-nav__item> <a href=#example-3-mix-of-required-and-optional-fields class=md-nav__link> <span class=md-ellipsis> Example 3: Mix of Required and Optional Fields </span> </a> </li> <li class=md-nav__item> <a href=#example-4-game-settings-message class=md-nav__link> <span class=md-ellipsis> Example 4: Game Settings Message </span> </a> </li> <li class=md-nav__item> <a href=#best-practices class=md-nav__link> <span class=md-ellipsis> Best Practices </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#why-use-attributes-instead-of-manual-implementation class=md-nav__link> <span class=md-ellipsis> Why Use Attributes Instead of Manual Implementation </span> </a> <nav class=md-nav aria-label="Why Use Attributes Instead of Manual Implementation"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#-attribute-definition-clean-automatic class=md-nav__link> <span class=md-ellipsis> ✅ Attribute Definition (Clean, Automatic) </span> </a> </li> <li class=md-nav__item> <a href=#what-the-generator-emits-for-reference class=md-nav__link> <span class=md-ellipsis> What the generator emits (for reference) </span> </a> <nav class=md-nav aria-label="What the generator emits (for reference)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#complete-example-attribute-definition-vs-generated-output class=md-nav__link> <span class=md-ellipsis> Complete Example: Attribute Definition vs Generated Output </span> </a> <nav class=md-nav aria-label="Complete Example: Attribute Definition vs Generated Output"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#attribute-definition-8-lines class=md-nav__link> <span class=md-ellipsis> Attribute Definition (8 lines) </span> </a> </li> <li class=md-nav__item> <a href=#generated-output-20-lines-you-never-write class=md-nav__link> <span class=md-ellipsis> Generated Output (20 lines you never write) </span> </a> </li> <li class=md-nav__item> <a href=#result class=md-nav__link> <span class=md-ellipsis> Result </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#advanced-manual-implementation-when-attributes-arent-enough class=md-nav__link> <span class=md-ellipsis> Advanced: Manual Implementation (When Attributes Aren't Enough) </span> </a> <nav class=md-nav aria-label="Advanced: Manual Implementation (When Attributes Aren't Enough)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#generic-message-interfaces-zero-boxing-for-structs class=md-nav__link> <span class=md-ellipsis> Generic Message Interfaces (Zero-Boxing for Structs) </span> </a> </li> <li class=md-nav__item> <a href=#do-i-have-to-use-attributes class=md-nav__link> <span class=md-ellipsis> "Do I HAVE to use attributes?" </span> </a> </li> <li class=md-nav__item> <a href=#what-if-i-want-custom-constructor-logic class=md-nav__link> <span class=md-ellipsis> "What if I want custom constructor logic?" </span> </a> </li> <li class=md-nav__item> <a href=#can-i-mix-attribute-based-and-manual-messages class=md-nav__link> <span class=md-ellipsis> "Can I mix attribute-based and manual messages?" </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#extension-methods-emit-helpers class=md-nav__link> <span class=md-ellipsis> Extension Methods (Emit Helpers) </span> </a> <nav class=md-nav aria-label="Extension Methods (Emit Helpers)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#automatic-overload-selection class=md-nav__link> <span class=md-ellipsis> Automatic overload selection </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#local-bus-islands-isolated-testing class=md-nav__link> <span class=md-ellipsis> Local Bus Islands (Isolated Testing) </span> </a> <nav class=md-nav aria-label="Local Bus Islands (Isolated Testing)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-cases class=md-nav__link> <span class=md-ellipsis> Use cases </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#attributes-quick-reference class=md-nav__link> <span class=md-ellipsis> Attributes Quick Reference </span> </a> <nav class=md-nav aria-label="Attributes Quick Reference"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#message-type-attributes class=md-nav__link> <span class=md-ellipsis> Message Type Attributes </span> </a> </li> <li class=md-nav__item> <a href=#constructor-generation-attributes class=md-nav__link> <span class=md-ellipsis> Constructor Generation Attributes </span> </a> <nav class=md-nav aria-label="Constructor Generation Attributes"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#dxautoconstructor class=md-nav__link> <span class=md-ellipsis> [DxAutoConstructor] </span> </a> </li> <li class=md-nav__item> <a href=#dxoptionalparameter class=md-nav__link> <span class=md-ellipsis> [DxOptionalParameter] </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#supported-types class=md-nav__link> <span class=md-ellipsis> Supported Types </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#common-patterns-with-attributes class=md-nav__link> <span class=md-ellipsis> Common Patterns with Attributes </span> </a> <nav class=md-nav aria-label="Common Patterns with Attributes"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#pattern-1-simple-message-no-data class=md-nav__link> <span class=md-ellipsis> Pattern 1: Simple Message (No Data) </span> </a> </li> <li class=md-nav__item> <a href=#pattern-2-message-with-data class=md-nav__link> <span class=md-ellipsis> Pattern 2: Message with Data </span> </a> </li> <li class=md-nav__item> <a href=#pattern-3-message-with-optional-fields class=md-nav__link> <span class=md-ellipsis> Pattern 3: Message with Optional Fields </span> </a> </li> <li class=md-nav__item> <a href=#pattern-4-complex-message class=md-nav__link> <span class=md-ellipsis> Pattern 4: Complex Message </span> </a> </li> <li class=md-nav__item> <a href=#pattern-5-nested-types class=md-nav__link> <span class=md-ellipsis> Pattern 5: Nested Types </span> </a> <nav class=md-nav aria-label="Pattern 5: Nested Types"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#benefits_1 class=md-nav__link> <span class=md-ellipsis> Benefits </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#pattern-6-internal-types-assembly-private-messages class=md-nav__link> <span class=md-ellipsis> Pattern 6: Internal Types (Assembly-Private Messages) </span> </a> <nav class=md-nav aria-label="Pattern 6: Internal Types (Assembly-Private Messages)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-cases_1 class=md-nav__link> <span class=md-ellipsis> Use cases </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#faq-source-generators--attributes class=md-nav__link> <span class=md-ellipsis> FAQ: Source Generators &amp; Attributes </span> </a> <nav class=md-nav aria-label="FAQ: Source Generators & Attributes"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#do-i-have-to-use-attributes_1 class=md-nav__link> <span class=md-ellipsis> "Do I HAVE to use attributes?" </span> </a> </li> <li class=md-nav__item> <a href=#why-partial-when-using-attributes class=md-nav__link> <span class=md-ellipsis> "Why partial when using attributes?" </span> </a> </li> <li class=md-nav__item> <a href=#can-i-see-the-generated-code class=md-nav__link> <span class=md-ellipsis> "Can I see the generated code?" </span> </a> </li> <li class=md-nav__item> <a href=#what-if-i-want-custom-constructor-logic_1 class=md-nav__link> <span class=md-ellipsis> "What if I want custom constructor logic?" </span> </a> </li> <li class=md-nav__item> <a href=#do-attributes-affect-runtime-performance class=md-nav__link> <span class=md-ellipsis> "Do attributes affect runtime performance?" </span> </a> </li> <li class=md-nav__item> <a href=#can-i-mix-attributes-and-manual-implementation class=md-nav__link> <span class=md-ellipsis> "Can I mix attributes and manual implementation?" </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#troubleshooting-source-generators class=md-nav__link> <span class=md-ellipsis> Troubleshooting Source Generators </span> </a> </li> <li class=md-nav__item> <a href=#related-documentation class=md-nav__link> <span class=md-ellipsis> Related Documentation </span> </a> </li> <li class=md-nav__item> <a href=#summary class=md-nav__link> <span class=md-ellipsis> Summary </span> </a> <nav class=md-nav aria-label=Summary> <ul class=md-nav__list> <li class=md-nav__item> <a href=#source-generators--code-wizards-that-write-boilerplate-for-you class=md-nav__link> <span class=md-ellipsis> Source generators = Code wizards that write boilerplate for you </span> </a> <nav class=md-nav aria-label="Source generators = Code wizards that write boilerplate for you"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-attributes-for class=md-nav__link> <span class=md-ellipsis> Use attributes for </span> </a> <nav class=md-nav aria-label="Use attributes for"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#use-manual-implementation-for class=md-nav__link> <span class=md-ellipsis> Use manual implementation for </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <nav class=md-path aria-label=Navigation> <ol class=md-path__list> <li class=md-path__item> <a href=../.. class=md-path__link> <span class=md-ellipsis> Home </span> </a> </li> <li class=md-path__item> <a href=../reference/ class=md-path__link> <span class=md-ellipsis> Reference </span> </a> </li> </ol> </nav> <article class="md-content__inner md-typeset"> <a href=https://github.com/wallstop/DxMessaging/edit/master/docs/reference/helpers.md title="Edit this page" class="md-content__button md-icon" rel=edit> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg> </a> <a href=https://github.com/wallstop/DxMessaging/raw/master/docs/reference/helpers.md title="View source of this page" class="md-content__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M17 18c.56 0 1 .44 1 1s-.44 1-1 1-1-.44-1-1 .44-1 1-1m0-3c-2.73 0-5.06 1.66-6 4 .94 2.34 3.27 4 6 4s5.06-1.66 6-4c-.94-2.34-3.27-4-6-4m0 6.5a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5M9.27 20H6V4h7v5h5v4.07c.7.08 1.36.25 2 .49V8l-6-6H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.5a8.2 8.2 0 0 1-1.23-2"/></svg> </a> <h1 id=helpers-and-source-generation>Helpers and Source Generation<a class=headerlink href=#helpers-and-source-generation title="Anchor link to this section">&para;</a></h1> <h2 id=what-are-source-generators>What Are Source Generators<a class=headerlink href=#what-are-source-generators title="Anchor link to this section">&para;</a></h2> <p><strong>Source generators</strong> are a C# feature (introduced in C# 9.0) that <strong>automatically write code for you at compile time</strong>. Think of them as smart code wizards that look at your code, see what you need, and generate the boilerplate automatically.</p> <h3 id=in-plain-english>In plain English<a class=headerlink href=#in-plain-english title="Anchor link to this section">&para;</a></h3> <ul> <li>You write: <code>[DxAutoConstructor]</code> on a struct</li> <li>Source generator sees: "Oh, they want a constructor!"</li> <li>Source generator creates: A constructor with all the fields as parameters</li> <li>You get: Less typing, fewer bugs, more consistent code</li> </ul> <h4 id=learn-more-about-source-generators>Learn more about source generators<a class=headerlink href=#learn-more-about-source-generators title="Anchor link to this section">&para;</a></h4> <ul> <li><a href=https://learn.microsoft.com/en-us/dotnet/csharp/roslyn-sdk/source-generators-overview>Microsoft Docs: Source Generators</a></li> <li><a href=https://devblogs.microsoft.com/dotnet/introducing-c-source-generators/ >Introduction to C# Source Generators</a></li> </ul> <h2 id=dxmessaging-attributes-your-code-wizards>DxMessaging Attributes (Your Code Wizards)<a class=headerlink href=#dxmessaging-attributes-your-code-wizards title="Anchor link to this section">&para;</a></h2> <p>DxMessaging provides <strong>3 main attributes</strong> that use source generators to eliminate boilerplate:</p> <h3 id=1-message-type-attributes-pick-your-message-category>1. Message Type Attributes (Pick Your Message Category)<a class=headerlink href=#1-message-type-attributes-pick-your-message-category title="Anchor link to this section">&para;</a></h3> <p>These tell the source generator what KIND of message you're making:</p> <h4 id=dxuntargetedmessage---global-messages><code>[DxUntargetedMessage]</code> - Global Messages<a class=headerlink href=#dxuntargetedmessage---global-messages title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-0-1><a id=__codelineno-0-1 name=__codelineno-0-1 href=#__codelineno-0-1></a><span class=na>[DxUntargetedMessage]</span><span class=w>  </span><span class=c1>// ← Tells generator: &quot;This is a global message&quot;</span>
+</span><span id=__span-0-2><a id=__codelineno-0-2 name=__codelineno-0-2 href=#__codelineno-0-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>GamePaused</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
+</span></code></pre></div> <h5 id=what-it-generates>What it generates<a class=headerlink href=#what-it-generates title="Anchor link to this section">&para;</a></h5> <ul> <li>Implements <code>IUntargetedMessage&lt;GamePaused&gt;</code></li> <li>Adds required plumbing for the message system</li> <li>Makes it work with <code>.Emit()</code> extension methods</li> </ul> <h4 id=dxtargetedmessage---messages-to-specific-targets><code>[DxTargetedMessage]</code> - Messages to Specific Targets<a class=headerlink href=#dxtargetedmessage---messages-to-specific-targets title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-1-1><a id=__codelineno-1-1 name=__codelineno-1-1 href=#__codelineno-1-1></a><span class=na>[DxTargetedMessage]</span><span class=w>  </span><span class=c1>// ← Tells generator: &quot;This goes to one specific target&quot;</span>
+</span><span id=__span-1-2><a id=__codelineno-1-2 name=__codelineno-1-2 href=#__codelineno-1-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Heal</span><span class=w> </span><span class=p>{</span>
+</span><span id=__span-1-3><a id=__codelineno-1-3 name=__codelineno-1-3 href=#__codelineno-1-3></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-1-4><a id=__codelineno-1-4 name=__codelineno-1-4 href=#__codelineno-1-4></a><span class=p>}</span>
+</span></code></pre></div> <h5 id=what-it-generates_1>What it generates<a class=headerlink href=#what-it-generates_1 title="Anchor link to this section">&para;</a></h5> <ul> <li>Implements <code>ITargetedMessage&lt;Heal&gt;</code></li> <li>Adds required plumbing for targeted emissions</li> <li>Makes it work with <code>.EmitGameObjectTargeted()</code> / <code>.EmitComponentTargeted()</code></li> </ul> <h4 id=dxbroadcastmessage---messages-from-a-source><code>[DxBroadcastMessage]</code> - Messages from a Source<a class=headerlink href=#dxbroadcastmessage---messages-from-a-source title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-2-1><a id=__codelineno-2-1 name=__codelineno-2-1 href=#__codelineno-2-1></a><span class=na>[DxBroadcastMessage]</span><span class=w>  </span><span class=c1>// ← Tells generator: &quot;This broadcasts from a source&quot;</span>
+</span><span id=__span-2-2><a id=__codelineno-2-2 name=__codelineno-2-2 href=#__codelineno-2-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>TookDamage</span><span class=w> </span><span class=p>{</span>
+</span><span id=__span-2-3><a id=__codelineno-2-3 name=__codelineno-2-3 href=#__codelineno-2-3></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-2-4><a id=__codelineno-2-4 name=__codelineno-2-4 href=#__codelineno-2-4></a><span class=p>}</span>
+</span></code></pre></div> <h5 id=what-it-generates_2>What it generates<a class=headerlink href=#what-it-generates_2 title="Anchor link to this section">&para;</a></h5> <ul> <li>Implements <code>IBroadcastMessage&lt;TookDamage&gt;</code></li> <li>Adds required plumbing for broadcast emissions</li> <li>Makes it work with <code>.EmitGameObjectBroadcast()</code> / <code>.EmitComponentBroadcast()</code></li> </ul> <h3 id=2-dxautoconstructor---automatic-constructors>2. <code>[DxAutoConstructor]</code> - Automatic Constructors<a class=headerlink href=#2-dxautoconstructor---automatic-constructors title="Anchor link to this section">&para;</a></h3> <p><strong>Problem:</strong> Writing constructors for every message is tedious and error-prone.</p> <p><strong>Solution:</strong> Let the source generator do it!</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-3-1><a id=__codelineno-3-1 name=__codelineno-3-1 href=#__codelineno-3-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-3-2><a id=__codelineno-3-2 name=__codelineno-3-2 href=#__codelineno-3-2></a><span class=na>[DxAutoConstructor]</span><span class=w>  </span><span class=c1>// ← Magic happens here!</span>
+</span><span id=__span-3-3><a id=__codelineno-3-3 name=__codelineno-3-3 href=#__codelineno-3-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>VideoSettingsChanged</span>
+</span><span id=__span-3-4><a id=__codelineno-3-4 name=__codelineno-3-4 href=#__codelineno-3-4></a><span class=p>{</span>
+</span><span id=__span-3-5><a id=__codelineno-3-5 name=__codelineno-3-5 href=#__codelineno-3-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>width</span><span class=p>;</span>
+</span><span id=__span-3-6><a id=__codelineno-3-6 name=__codelineno-3-6 href=#__codelineno-3-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>height</span><span class=p>;</span>
+</span><span id=__span-3-7><a id=__codelineno-3-7 name=__codelineno-3-7 href=#__codelineno-3-7></a><span class=p>}</span>
+</span></code></pre></div> <h4 id=what-you-get-auto-generated>What you get (auto-generated)<a class=headerlink href=#what-you-get-auto-generated title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-4-1><a id=__codelineno-4-1 name=__codelineno-4-1 href=#__codelineno-4-1></a><span class=c1>// You don&#39;t write this - it&#39;s generated for you!</span>
+</span><span id=__span-4-2><a id=__codelineno-4-2 name=__codelineno-4-2 href=#__codelineno-4-2></a><span class=k>public</span><span class=w> </span><span class=nf>VideoSettingsChanged</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>width</span><span class=p>,</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>height</span><span class=p>)</span>
+</span><span id=__span-4-3><a id=__codelineno-4-3 name=__codelineno-4-3 href=#__codelineno-4-3></a><span class=p>{</span>
+</span><span id=__span-4-4><a id=__codelineno-4-4 name=__codelineno-4-4 href=#__codelineno-4-4></a><span class=w>    </span><span class=k>this</span><span class=p>.</span><span class=n>width</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>width</span><span class=p>;</span>
+</span><span id=__span-4-5><a id=__codelineno-4-5 name=__codelineno-4-5 href=#__codelineno-4-5></a><span class=w>    </span><span class=k>this</span><span class=p>.</span><span class=n>height</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>height</span><span class=p>;</span>
+</span><span id=__span-4-6><a id=__codelineno-4-6 name=__codelineno-4-6 href=#__codelineno-4-6></a><span class=p>}</span>
+</span></code></pre></div> <h5 id=rules>Rules<a class=headerlink href=#rules title="Anchor link to this section">&para;</a></h5> <ul> <li>Creates constructor parameters in <strong>field declaration order</strong></li> <li>Only includes <code>public</code> fields</li> <li>Ignores <code>static</code> fields</li> <li>Works with <code>readonly</code> structs (recommended!)</li> <li>Supports nested types (types defined inside other classes/structs)</li> <li>Supports internal types (types with <code>internal</code> visibility)</li> </ul> <h3 id=3-dxoptionalparameter---optional-constructor-parameters>3. <code>[DxOptionalParameter]</code> - Optional Constructor Parameters<a class=headerlink href=#3-dxoptionalparameter---optional-constructor-parameters title="Anchor link to this section">&para;</a></h3> <p>The <code>DxOptionalParameterAttribute</code> marks a field as optional when used with <code>[DxAutoConstructor]</code>. The source generator emits a constructor parameter with a default value for annotated fields, making it easy to create messages with sensible defaults.</p> <h4 id=how-it-works-with-dxautoconstructor>How It Works with DxAutoConstructor<a class=headerlink href=#how-it-works-with-dxautoconstructor title="Anchor link to this section">&para;</a></h4> <p>When you combine <code>[DxOptionalParameter]</code> with <code>[DxAutoConstructor]</code>, the generator creates a constructor where:</p> <ol> <li><strong>Required fields</strong> (without the attribute) become regular constructor parameters</li> <li><strong>Optional fields</strong> (with the attribute) become parameters with default values</li> <li><strong>Parameter order</strong> follows field declaration order</li> <li><strong>C# rules apply</strong> - optional parameters must come after required parameters</li> </ol> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-5-1><a id=__codelineno-5-1 name=__codelineno-5-1 href=#__codelineno-5-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-5-2><a id=__codelineno-5-2 name=__codelineno-5-2 href=#__codelineno-5-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-5-3><a id=__codelineno-5-3 name=__codelineno-5-3 href=#__codelineno-5-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>SettingsChanged</span>
+</span><span id=__span-5-4><a id=__codelineno-5-4 name=__codelineno-5-4 href=#__codelineno-5-4></a><span class=p>{</span>
+</span><span id=__span-5-5><a id=__codelineno-5-5 name=__codelineno-5-5 href=#__codelineno-5-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>volume</span><span class=p>;</span><span class=w>                    </span><span class=c1>// Required (no attribute)</span>
+</span><span id=__span-5-6><a id=__codelineno-5-6 name=__codelineno-5-6 href=#__codelineno-5-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>quality</span><span class=p>;</span><span class=w>                     </span><span class=c1>// Required (no attribute)</span>
+</span><span id=__span-5-7><a id=__codelineno-5-7 name=__codelineno-5-7 href=#__codelineno-5-7></a><span class=w>    </span><span class=na>[DxOptionalParameter]</span><span class=w>                            </span><span class=c1>// Optional, defaults to false</span>
+</span><span id=__span-5-8><a id=__codelineno-5-8 name=__codelineno-5-8 href=#__codelineno-5-8></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>fullscreen</span><span class=p>;</span>
+</span><span id=__span-5-9><a id=__codelineno-5-9 name=__codelineno-5-9 href=#__codelineno-5-9></a><span class=w>    </span><span class=na>[DxOptionalParameter(100)]</span><span class=w>                       </span><span class=c1>// Optional, defaults to 100</span>
+</span><span id=__span-5-10><a id=__codelineno-5-10 name=__codelineno-5-10 href=#__codelineno-5-10></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>brightness</span><span class=p>;</span>
+</span><span id=__span-5-11><a id=__codelineno-5-11 name=__codelineno-5-11 href=#__codelineno-5-11></a><span class=p>}</span>
+</span></code></pre></div> <h4 id=generated-constructor>Generated constructor<a class=headerlink href=#generated-constructor title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-6-1><a id=__codelineno-6-1 name=__codelineno-6-1 href=#__codelineno-6-1></a><span class=k>public</span><span class=w> </span><span class=nf>SettingsChanged</span><span class=p>(</span><span class=kt>float</span><span class=w> </span><span class=n>volume</span><span class=p>,</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>quality</span><span class=p>,</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>fullscreen</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>default</span><span class=p>,</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>brightness</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=mi>100</span><span class=p>)</span>
+</span><span id=__span-6-2><a id=__codelineno-6-2 name=__codelineno-6-2 href=#__codelineno-6-2></a><span class=p>{</span>
+</span><span id=__span-6-3><a id=__codelineno-6-3 name=__codelineno-6-3 href=#__codelineno-6-3></a><span class=w>    </span><span class=k>this</span><span class=p>.</span><span class=n>volume</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>volume</span><span class=p>;</span>
+</span><span id=__span-6-4><a id=__codelineno-6-4 name=__codelineno-6-4 href=#__codelineno-6-4></a><span class=w>    </span><span class=k>this</span><span class=p>.</span><span class=n>quality</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>quality</span><span class=p>;</span>
+</span><span id=__span-6-5><a id=__codelineno-6-5 name=__codelineno-6-5 href=#__codelineno-6-5></a><span class=w>    </span><span class=k>this</span><span class=p>.</span><span class=n>fullscreen</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>fullscreen</span><span class=p>;</span>
+</span><span id=__span-6-6><a id=__codelineno-6-6 name=__codelineno-6-6 href=#__codelineno-6-6></a><span class=w>    </span><span class=k>this</span><span class=p>.</span><span class=n>brightness</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>brightness</span><span class=p>;</span>
+</span><span id=__span-6-7><a id=__codelineno-6-7 name=__codelineno-6-7 href=#__codelineno-6-7></a><span class=p>}</span>
+</span></code></pre></div> <h4 id=calling-the-constructor>Calling the Constructor<a class=headerlink href=#calling-the-constructor title="Anchor link to this section">&para;</a></h4> <p>Optional parameters support all standard C# calling conventions:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-7-1><a id=__codelineno-7-1 name=__codelineno-7-1 href=#__codelineno-7-1></a><span class=c1>// Provide all arguments</span>
+</span><span id=__span-7-2><a id=__codelineno-7-2 name=__codelineno-7-2 href=#__codelineno-7-2></a><span class=kt>var</span><span class=w> </span><span class=n>settings1</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>SettingsChanged</span><span class=p>(</span><span class=mf>0.8f</span><span class=p>,</span><span class=w> </span><span class=mi>2</span><span class=p>,</span><span class=w> </span><span class=k>true</span><span class=p>,</span><span class=w> </span><span class=mi>80</span><span class=p>);</span>
+</span><span id=__span-7-3><a id=__codelineno-7-3 name=__codelineno-7-3 href=#__codelineno-7-3></a>
+</span><span id=__span-7-4><a id=__codelineno-7-4 name=__codelineno-7-4 href=#__codelineno-7-4></a><span class=c1>// Use all defaults</span>
+</span><span id=__span-7-5><a id=__codelineno-7-5 name=__codelineno-7-5 href=#__codelineno-7-5></a><span class=kt>var</span><span class=w> </span><span class=n>settings2</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>SettingsChanged</span><span class=p>(</span><span class=mf>0.8f</span><span class=p>,</span><span class=w> </span><span class=mi>2</span><span class=p>);</span><span class=w>  </span><span class=c1>// fullscreen=false, brightness=100</span>
+</span><span id=__span-7-6><a id=__codelineno-7-6 name=__codelineno-7-6 href=#__codelineno-7-6></a>
+</span><span id=__span-7-7><a id=__codelineno-7-7 name=__codelineno-7-7 href=#__codelineno-7-7></a><span class=c1>// Use named arguments to skip some optionals</span>
+</span><span id=__span-7-8><a id=__codelineno-7-8 name=__codelineno-7-8 href=#__codelineno-7-8></a><span class=kt>var</span><span class=w> </span><span class=n>settings3</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>SettingsChanged</span><span class=p>(</span><span class=mf>0.8f</span><span class=p>,</span><span class=w> </span><span class=mi>2</span><span class=p>,</span><span class=w> </span><span class=n>fullscreen</span><span class=p>:</span><span class=w> </span><span class=k>true</span><span class=p>);</span><span class=w>  </span><span class=c1>// brightness=100</span>
+</span><span id=__span-7-9><a id=__codelineno-7-9 name=__codelineno-7-9 href=#__codelineno-7-9></a><span class=kt>var</span><span class=w> </span><span class=n>settings4</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>SettingsChanged</span><span class=p>(</span><span class=mf>0.8f</span><span class=p>,</span><span class=w> </span><span class=mi>2</span><span class=p>,</span><span class=w> </span><span class=n>brightness</span><span class=p>:</span><span class=w> </span><span class=mi>50</span><span class=p>);</span><span class=w>    </span><span class=c1>// fullscreen=false</span>
+</span></code></pre></div> <h4 id=supported-default-value-types>Supported Default Value Types<a class=headerlink href=#supported-default-value-types title="Anchor link to this section">&para;</a></h4> <p>The attribute provides constructor overloads for all common primitive types:</p> <div class="admonition info"> <p class=admonition-title>Built-in Type Support</p> <div class="tabbed-set tabbed-alternate" data-tabs=1:2><input checked=checked id=__tabbed_1_1 name=__tabbed_1 type=radio><input id=__tabbed_1_2 name=__tabbed_1 type=radio><div class=tabbed-labels><label for=__tabbed_1_1>Numeric</label><label for=__tabbed_1_2>Other</label></div> <div class=tabbed-content> <div class=tabbed-block> <table> <thead> <tr> <th>Category</th> <th>Types</th> </tr> </thead> <tbody> <tr> <td><strong>Signed Integers</strong></td> <td><code>sbyte</code>, <code>short</code>, <code>int</code>, <code>long</code></td> </tr> <tr> <td><strong>Unsigned Integers</strong></td> <td><code>byte</code>, <code>ushort</code>, <code>uint</code>, <code>ulong</code></td> </tr> <tr> <td><strong>Floating Point</strong></td> <td><code>float</code>, <code>double</code></td> </tr> </tbody> </table> </div> <div class=tabbed-block> <table> <thead> <tr> <th>Category</th> <th>Types</th> </tr> </thead> <tbody> <tr> <td><strong>Boolean</strong></td> <td><code>bool</code></td> </tr> <tr> <td><strong>Character</strong></td> <td><code>char</code></td> </tr> <tr> <td><strong>String</strong></td> <td><code>string</code></td> </tr> </tbody> </table> </div> </div> </div> <p>For enums, Unity types, and other complex types, use the <code>Expression</code> property.</p> </div> <h5 id=examples-by-type>Examples by type<a class=headerlink href=#examples-by-type title="Anchor link to this section">&para;</a></h5> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-8-1><a id=__codelineno-8-1 name=__codelineno-8-1 href=#__codelineno-8-1></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-8-2><a id=__codelineno-8-2 name=__codelineno-8-2 href=#__codelineno-8-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>TypeExamples</span>
+</span><span id=__span-8-3><a id=__codelineno-8-3 name=__codelineno-8-3 href=#__codelineno-8-3></a><span class=p>{</span>
+</span><span id=__span-8-4><a id=__codelineno-8-4 name=__codelineno-8-4 href=#__codelineno-8-4></a><span class=w>    </span><span class=c1>// Boolean</span>
+</span><span id=__span-8-5><a id=__codelineno-8-5 name=__codelineno-8-5 href=#__codelineno-8-5></a><span class=w>    </span><span class=na>[DxOptionalParameter(true)]</span>
+</span><span id=__span-8-6><a id=__codelineno-8-6 name=__codelineno-8-6 href=#__codelineno-8-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>isEnabled</span><span class=p>;</span>
+</span><span id=__span-8-7><a id=__codelineno-8-7 name=__codelineno-8-7 href=#__codelineno-8-7></a>
+</span><span id=__span-8-8><a id=__codelineno-8-8 name=__codelineno-8-8 href=#__codelineno-8-8></a><span class=w>    </span><span class=c1>// Character</span>
+</span><span id=__span-8-9><a id=__codelineno-8-9 name=__codelineno-8-9 href=#__codelineno-8-9></a><span class=w>    </span><span class=na>[DxOptionalParameter(&#39;X&#39;)]</span>
+</span><span id=__span-8-10><a id=__codelineno-8-10 name=__codelineno-8-10 href=#__codelineno-8-10></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>char</span><span class=w> </span><span class=n>grade</span><span class=p>;</span>
+</span><span id=__span-8-11><a id=__codelineno-8-11 name=__codelineno-8-11 href=#__codelineno-8-11></a>
+</span><span id=__span-8-12><a id=__codelineno-8-12 name=__codelineno-8-12 href=#__codelineno-8-12></a><span class=w>    </span><span class=c1>// String</span>
+</span><span id=__span-8-13><a id=__codelineno-8-13 name=__codelineno-8-13 href=#__codelineno-8-13></a><span class=w>    </span><span class=na>[DxOptionalParameter(&quot;unknown&quot;)]</span>
+</span><span id=__span-8-14><a id=__codelineno-8-14 name=__codelineno-8-14 href=#__codelineno-8-14></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>playerName</span><span class=p>;</span>
+</span><span id=__span-8-15><a id=__codelineno-8-15 name=__codelineno-8-15 href=#__codelineno-8-15></a>
+</span><span id=__span-8-16><a id=__codelineno-8-16 name=__codelineno-8-16 href=#__codelineno-8-16></a><span class=w>    </span><span class=c1>// Signed integers</span>
+</span><span id=__span-8-17><a id=__codelineno-8-17 name=__codelineno-8-17 href=#__codelineno-8-17></a><span class=w>    </span><span class=na>[DxOptionalParameter((sbyte)-1)]</span>
+</span><span id=__span-8-18><a id=__codelineno-8-18 name=__codelineno-8-18 href=#__codelineno-8-18></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>sbyte</span><span class=w> </span><span class=n>signedByte</span><span class=p>;</span>
+</span><span id=__span-8-19><a id=__codelineno-8-19 name=__codelineno-8-19 href=#__codelineno-8-19></a>
+</span><span id=__span-8-20><a id=__codelineno-8-20 name=__codelineno-8-20 href=#__codelineno-8-20></a><span class=w>    </span><span class=na>[DxOptionalParameter((short)100)]</span>
+</span><span id=__span-8-21><a id=__codelineno-8-21 name=__codelineno-8-21 href=#__codelineno-8-21></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>short</span><span class=w> </span><span class=n>shortValue</span><span class=p>;</span>
+</span><span id=__span-8-22><a id=__codelineno-8-22 name=__codelineno-8-22 href=#__codelineno-8-22></a>
+</span><span id=__span-8-23><a id=__codelineno-8-23 name=__codelineno-8-23 href=#__codelineno-8-23></a><span class=w>    </span><span class=na>[DxOptionalParameter(42)]</span>
+</span><span id=__span-8-24><a id=__codelineno-8-24 name=__codelineno-8-24 href=#__codelineno-8-24></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>score</span><span class=p>;</span>
+</span><span id=__span-8-25><a id=__codelineno-8-25 name=__codelineno-8-25 href=#__codelineno-8-25></a>
+</span><span id=__span-8-26><a id=__codelineno-8-26 name=__codelineno-8-26 href=#__codelineno-8-26></a><span class=w>    </span><span class=na>[DxOptionalParameter(9999999999L)]</span>
+</span><span id=__span-8-27><a id=__codelineno-8-27 name=__codelineno-8-27 href=#__codelineno-8-27></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>long</span><span class=w> </span><span class=n>bigNumber</span><span class=p>;</span>
+</span><span id=__span-8-28><a id=__codelineno-8-28 name=__codelineno-8-28 href=#__codelineno-8-28></a>
+</span><span id=__span-8-29><a id=__codelineno-8-29 name=__codelineno-8-29 href=#__codelineno-8-29></a><span class=w>    </span><span class=c1>// Unsigned integers</span>
+</span><span id=__span-8-30><a id=__codelineno-8-30 name=__codelineno-8-30 href=#__codelineno-8-30></a><span class=w>    </span><span class=na>[DxOptionalParameter((byte)255)]</span>
+</span><span id=__span-8-31><a id=__codelineno-8-31 name=__codelineno-8-31 href=#__codelineno-8-31></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>byte</span><span class=w> </span><span class=n>level</span><span class=p>;</span>
+</span><span id=__span-8-32><a id=__codelineno-8-32 name=__codelineno-8-32 href=#__codelineno-8-32></a>
+</span><span id=__span-8-33><a id=__codelineno-8-33 name=__codelineno-8-33 href=#__codelineno-8-33></a><span class=w>    </span><span class=na>[DxOptionalParameter((ushort)1000)]</span>
+</span><span id=__span-8-34><a id=__codelineno-8-34 name=__codelineno-8-34 href=#__codelineno-8-34></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>ushort</span><span class=w> </span><span class=n>maxHealth</span><span class=p>;</span>
+</span><span id=__span-8-35><a id=__codelineno-8-35 name=__codelineno-8-35 href=#__codelineno-8-35></a>
+</span><span id=__span-8-36><a id=__codelineno-8-36 name=__codelineno-8-36 href=#__codelineno-8-36></a><span class=w>    </span><span class=na>[DxOptionalParameter(50u)]</span>
+</span><span id=__span-8-37><a id=__codelineno-8-37 name=__codelineno-8-37 href=#__codelineno-8-37></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>uint</span><span class=w> </span><span class=n>count</span><span class=p>;</span>
+</span><span id=__span-8-38><a id=__codelineno-8-38 name=__codelineno-8-38 href=#__codelineno-8-38></a>
+</span><span id=__span-8-39><a id=__codelineno-8-39 name=__codelineno-8-39 href=#__codelineno-8-39></a><span class=w>    </span><span class=na>[DxOptionalParameter(100UL)]</span>
+</span><span id=__span-8-40><a id=__codelineno-8-40 name=__codelineno-8-40 href=#__codelineno-8-40></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>ulong</span><span class=w> </span><span class=n>totalPoints</span><span class=p>;</span>
+</span><span id=__span-8-41><a id=__codelineno-8-41 name=__codelineno-8-41 href=#__codelineno-8-41></a>
+</span><span id=__span-8-42><a id=__codelineno-8-42 name=__codelineno-8-42 href=#__codelineno-8-42></a><span class=w>    </span><span class=c1>// Floating point</span>
+</span><span id=__span-8-43><a id=__codelineno-8-43 name=__codelineno-8-43 href=#__codelineno-8-43></a><span class=w>    </span><span class=na>[DxOptionalParameter(1.5f)]</span>
+</span><span id=__span-8-44><a id=__codelineno-8-44 name=__codelineno-8-44 href=#__codelineno-8-44></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>speed</span><span class=p>;</span>
+</span><span id=__span-8-45><a id=__codelineno-8-45 name=__codelineno-8-45 href=#__codelineno-8-45></a>
+</span><span id=__span-8-46><a id=__codelineno-8-46 name=__codelineno-8-46 href=#__codelineno-8-46></a><span class=w>    </span><span class=na>[DxOptionalParameter(3.14159)]</span>
+</span><span id=__span-8-47><a id=__codelineno-8-47 name=__codelineno-8-47 href=#__codelineno-8-47></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>double</span><span class=w> </span><span class=n>precision</span><span class=p>;</span>
+</span><span id=__span-8-48><a id=__codelineno-8-48 name=__codelineno-8-48 href=#__codelineno-8-48></a><span class=p>}</span>
+</span></code></pre></div> <h4 id=using-type-defaults>Using Type Defaults<a class=headerlink href=#using-type-defaults title="Anchor link to this section">&para;</a></h4> <p>When you use <code>[DxOptionalParameter]</code> without a value, the field defaults to the type's default value:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-9-1><a id=__codelineno-9-1 name=__codelineno-9-1 href=#__codelineno-9-1></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-9-2><a id=__codelineno-9-2 name=__codelineno-9-2 href=#__codelineno-9-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>DefaultExamples</span>
+</span><span id=__span-9-3><a id=__codelineno-9-3 name=__codelineno-9-3 href=#__codelineno-9-3></a><span class=p>{</span>
+</span><span id=__span-9-4><a id=__codelineno-9-4 name=__codelineno-9-4 href=#__codelineno-9-4></a><span class=w>    </span><span class=na>[DxOptionalParameter]</span><span class=w>  </span><span class=c1>// Defaults to 0</span>
+</span><span id=__span-9-5><a id=__codelineno-9-5 name=__codelineno-9-5 href=#__codelineno-9-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>count</span><span class=p>;</span>
+</span><span id=__span-9-6><a id=__codelineno-9-6 name=__codelineno-9-6 href=#__codelineno-9-6></a>
+</span><span id=__span-9-7><a id=__codelineno-9-7 name=__codelineno-9-7 href=#__codelineno-9-7></a><span class=w>    </span><span class=na>[DxOptionalParameter]</span><span class=w>  </span><span class=c1>// Defaults to false</span>
+</span><span id=__span-9-8><a id=__codelineno-9-8 name=__codelineno-9-8 href=#__codelineno-9-8></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>isActive</span><span class=p>;</span>
+</span><span id=__span-9-9><a id=__codelineno-9-9 name=__codelineno-9-9 href=#__codelineno-9-9></a>
+</span><span id=__span-9-10><a id=__codelineno-9-10 name=__codelineno-9-10 href=#__codelineno-9-10></a><span class=w>    </span><span class=na>[DxOptionalParameter]</span><span class=w>  </span><span class=c1>// Defaults to null</span>
+</span><span id=__span-9-11><a id=__codelineno-9-11 name=__codelineno-9-11 href=#__codelineno-9-11></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>name</span><span class=p>;</span>
+</span><span id=__span-9-12><a id=__codelineno-9-12 name=__codelineno-9-12 href=#__codelineno-9-12></a>
+</span><span id=__span-9-13><a id=__codelineno-9-13 name=__codelineno-9-13 href=#__codelineno-9-13></a><span class=w>    </span><span class=na>[DxOptionalParameter]</span><span class=w>  </span><span class=c1>// Defaults to 0.0f</span>
+</span><span id=__span-9-14><a id=__codelineno-9-14 name=__codelineno-9-14 href=#__codelineno-9-14></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>multiplier</span><span class=p>;</span>
+</span><span id=__span-9-15><a id=__codelineno-9-15 name=__codelineno-9-15 href=#__codelineno-9-15></a><span class=p>}</span>
+</span></code></pre></div> <h4 id=advanced-custom-expressions-for-any-type>Advanced: Custom Expressions for Any Type<a class=headerlink href=#advanced-custom-expressions-for-any-type title="Anchor link to this section">&para;</a></h4> <p>For types that don't have built-in constructor overloads (enums, nullables, Unity types, custom structs), use the <code>Expression</code> property. The expression is inserted verbatim into the generated constructor, and the C# compiler enforces type safety:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-10-1><a id=__codelineno-10-1 name=__codelineno-10-1 href=#__codelineno-10-1></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-10-2><a id=__codelineno-10-2 name=__codelineno-10-2 href=#__codelineno-10-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>AdvancedDefaults</span>
+</span><span id=__span-10-3><a id=__codelineno-10-3 name=__codelineno-10-3 href=#__codelineno-10-3></a><span class=p>{</span>
+</span><span id=__span-10-4><a id=__codelineno-10-4 name=__codelineno-10-4 href=#__codelineno-10-4></a><span class=w>    </span><span class=c1>// Nullable types</span>
+</span><span id=__span-10-5><a id=__codelineno-10-5 name=__codelineno-10-5 href=#__codelineno-10-5></a><span class=w>    </span><span class=na>[DxOptionalParameter(Expression = &quot;null&quot;)]</span>
+</span><span id=__span-10-6><a id=__codelineno-10-6 name=__codelineno-10-6 href=#__codelineno-10-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int?</span><span class=w> </span><span class=n>optionalId</span><span class=p>;</span>
+</span><span id=__span-10-7><a id=__codelineno-10-7 name=__codelineno-10-7 href=#__codelineno-10-7></a>
+</span><span id=__span-10-8><a id=__codelineno-10-8 name=__codelineno-10-8 href=#__codelineno-10-8></a><span class=w>    </span><span class=c1>// Enum values</span>
+</span><span id=__span-10-9><a id=__codelineno-10-9 name=__codelineno-10-9 href=#__codelineno-10-9></a><span class=w>    </span><span class=na>[DxOptionalParameter(Expression = &quot;DamageType.Physical&quot;)]</span>
+</span><span id=__span-10-10><a id=__codelineno-10-10 name=__codelineno-10-10 href=#__codelineno-10-10></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=n>DamageType</span><span class=w> </span><span class=n>damageType</span><span class=p>;</span>
+</span><span id=__span-10-11><a id=__codelineno-10-11 name=__codelineno-10-11 href=#__codelineno-10-11></a>
+</span><span id=__span-10-12><a id=__codelineno-10-12 name=__codelineno-10-12 href=#__codelineno-10-12></a><span class=w>    </span><span class=c1>// Unity types</span>
+</span><span id=__span-10-13><a id=__codelineno-10-13 name=__codelineno-10-13 href=#__codelineno-10-13></a><span class=w>    </span><span class=na>[DxOptionalParameter(Expression = &quot;Vector3.zero&quot;)]</span>
+</span><span id=__span-10-14><a id=__codelineno-10-14 name=__codelineno-10-14 href=#__codelineno-10-14></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=n>Vector3</span><span class=w> </span><span class=n>position</span><span class=p>;</span>
+</span><span id=__span-10-15><a id=__codelineno-10-15 name=__codelineno-10-15 href=#__codelineno-10-15></a>
+</span><span id=__span-10-16><a id=__codelineno-10-16 name=__codelineno-10-16 href=#__codelineno-10-16></a><span class=w>    </span><span class=na>[DxOptionalParameter(Expression = &quot;Color.white&quot;)]</span>
+</span><span id=__span-10-17><a id=__codelineno-10-17 name=__codelineno-10-17 href=#__codelineno-10-17></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=n>Color</span><span class=w> </span><span class=n>tint</span><span class=p>;</span>
+</span><span id=__span-10-18><a id=__codelineno-10-18 name=__codelineno-10-18 href=#__codelineno-10-18></a>
+</span><span id=__span-10-19><a id=__codelineno-10-19 name=__codelineno-10-19 href=#__codelineno-10-19></a><span class=w>    </span><span class=c1>// Static constants</span>
+</span><span id=__span-10-20><a id=__codelineno-10-20 name=__codelineno-10-20 href=#__codelineno-10-20></a><span class=w>    </span><span class=na>[DxOptionalParameter(Expression = &quot;float.MaxValue&quot;)]</span>
+</span><span id=__span-10-21><a id=__codelineno-10-21 name=__codelineno-10-21 href=#__codelineno-10-21></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>range</span><span class=p>;</span>
+</span><span id=__span-10-22><a id=__codelineno-10-22 name=__codelineno-10-22 href=#__codelineno-10-22></a>
+</span><span id=__span-10-23><a id=__codelineno-10-23 name=__codelineno-10-23 href=#__codelineno-10-23></a><span class=w>    </span><span class=c1>// Named constants from your code</span>
+</span><span id=__span-10-24><a id=__codelineno-10-24 name=__codelineno-10-24 href=#__codelineno-10-24></a><span class=w>    </span><span class=na>[DxOptionalParameter(Expression = &quot;GameConstants.DefaultHealth&quot;)]</span>
+</span><span id=__span-10-25><a id=__codelineno-10-25 name=__codelineno-10-25 href=#__codelineno-10-25></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>health</span><span class=p>;</span>
+</span><span id=__span-10-26><a id=__codelineno-10-26 name=__codelineno-10-26 href=#__codelineno-10-26></a><span class=p>}</span>
+</span></code></pre></div> <div class="admonition tip"> <p class=admonition-title>Expression rules</p> <ul> <li>The expression is inserted <strong>verbatim</strong> into the generated code</li> <li>Must be a valid C# constant expression</li> <li>Type safety is enforced by the C# compiler at build time</li> <li>Perfect for enums, nullable types, static constants, or complex defaults</li> </ul> </div> <h4 id=code-examples>Code Examples<a class=headerlink href=#code-examples title="Anchor link to this section">&para;</a></h4> <h4 id=example-1-basic-optional-parameter-with-default-value>Example 1: Basic Optional Parameter with Default Value<a class=headerlink href=#example-1-basic-optional-parameter-with-default-value title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-11-1><a id=__codelineno-11-1 name=__codelineno-11-1 href=#__codelineno-11-1></a><span class=na>[DxTargetedMessage]</span>
+</span><span id=__span-11-2><a id=__codelineno-11-2 name=__codelineno-11-2 href=#__codelineno-11-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-11-3><a id=__codelineno-11-3 name=__codelineno-11-3 href=#__codelineno-11-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Heal</span>
+</span><span id=__span-11-4><a id=__codelineno-11-4 name=__codelineno-11-4 href=#__codelineno-11-4></a><span class=p>{</span>
+</span><span id=__span-11-5><a id=__codelineno-11-5 name=__codelineno-11-5 href=#__codelineno-11-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-11-6><a id=__codelineno-11-6 name=__codelineno-11-6 href=#__codelineno-11-6></a><span class=w>    </span><span class=na>[DxOptionalParameter(false)]</span>
+</span><span id=__span-11-7><a id=__codelineno-11-7 name=__codelineno-11-7 href=#__codelineno-11-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>isCritical</span><span class=p>;</span>
+</span><span id=__span-11-8><a id=__codelineno-11-8 name=__codelineno-11-8 href=#__codelineno-11-8></a><span class=p>}</span>
+</span><span id=__span-11-9><a id=__codelineno-11-9 name=__codelineno-11-9 href=#__codelineno-11-9></a>
+</span><span id=__span-11-10><a id=__codelineno-11-10 name=__codelineno-11-10 href=#__codelineno-11-10></a><span class=c1>// Usage:</span>
+</span><span id=__span-11-11><a id=__codelineno-11-11 name=__codelineno-11-11 href=#__codelineno-11-11></a><span class=kt>var</span><span class=w> </span><span class=n>normalHeal</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>Heal</span><span class=p>(</span><span class=mi>25</span><span class=p>);</span><span class=w>             </span><span class=c1>// isCritical = false</span>
+</span><span id=__span-11-12><a id=__codelineno-11-12 name=__codelineno-11-12 href=#__codelineno-11-12></a><span class=kt>var</span><span class=w> </span><span class=n>critHeal</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>Heal</span><span class=p>(</span><span class=mi>50</span><span class=p>,</span><span class=w> </span><span class=k>true</span><span class=p>);</span><span class=w>         </span><span class=c1>// isCritical = true</span>
+</span></code></pre></div> <h4 id=example-2-multiple-optional-parameters>Example 2: Multiple Optional Parameters<a class=headerlink href=#example-2-multiple-optional-parameters title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-12-1><a id=__codelineno-12-1 name=__codelineno-12-1 href=#__codelineno-12-1></a><span class=na>[DxBroadcastMessage]</span>
+</span><span id=__span-12-2><a id=__codelineno-12-2 name=__codelineno-12-2 href=#__codelineno-12-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-12-3><a id=__codelineno-12-3 name=__codelineno-12-3 href=#__codelineno-12-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>SpawnEffect</span>
+</span><span id=__span-12-4><a id=__codelineno-12-4 name=__codelineno-12-4 href=#__codelineno-12-4></a><span class=p>{</span>
+</span><span id=__span-12-5><a id=__codelineno-12-5 name=__codelineno-12-5 href=#__codelineno-12-5></a><span class=w>    </span><span class=na>[DxOptionalParameter(1.0f)]</span>
+</span><span id=__span-12-6><a id=__codelineno-12-6 name=__codelineno-12-6 href=#__codelineno-12-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>scale</span><span class=p>;</span>
+</span><span id=__span-12-7><a id=__codelineno-12-7 name=__codelineno-12-7 href=#__codelineno-12-7></a>
+</span><span id=__span-12-8><a id=__codelineno-12-8 name=__codelineno-12-8 href=#__codelineno-12-8></a><span class=w>    </span><span class=na>[DxOptionalParameter(Expression = &quot;Color.white&quot;)]</span>
+</span><span id=__span-12-9><a id=__codelineno-12-9 name=__codelineno-12-9 href=#__codelineno-12-9></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=n>Color</span><span class=w> </span><span class=n>color</span><span class=p>;</span>
+</span><span id=__span-12-10><a id=__codelineno-12-10 name=__codelineno-12-10 href=#__codelineno-12-10></a>
+</span><span id=__span-12-11><a id=__codelineno-12-11 name=__codelineno-12-11 href=#__codelineno-12-11></a><span class=w>    </span><span class=na>[DxOptionalParameter(5.0f)]</span>
+</span><span id=__span-12-12><a id=__codelineno-12-12 name=__codelineno-12-12 href=#__codelineno-12-12></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>duration</span><span class=p>;</span>
+</span><span id=__span-12-13><a id=__codelineno-12-13 name=__codelineno-12-13 href=#__codelineno-12-13></a>
+</span><span id=__span-12-14><a id=__codelineno-12-14 name=__codelineno-12-14 href=#__codelineno-12-14></a><span class=w>    </span><span class=na>[DxOptionalParameter(false)]</span>
+</span><span id=__span-12-15><a id=__codelineno-12-15 name=__codelineno-12-15 href=#__codelineno-12-15></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>looping</span><span class=p>;</span>
+</span><span id=__span-12-16><a id=__codelineno-12-16 name=__codelineno-12-16 href=#__codelineno-12-16></a><span class=p>}</span>
+</span><span id=__span-12-17><a id=__codelineno-12-17 name=__codelineno-12-17 href=#__codelineno-12-17></a>
+</span><span id=__span-12-18><a id=__codelineno-12-18 name=__codelineno-12-18 href=#__codelineno-12-18></a><span class=c1>// Usage:</span>
+</span><span id=__span-12-19><a id=__codelineno-12-19 name=__codelineno-12-19 href=#__codelineno-12-19></a><span class=kt>var</span><span class=w> </span><span class=n>defaultEffect</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>SpawnEffect</span><span class=p>();</span><span class=w>                          </span><span class=c1>// All defaults</span>
+</span><span id=__span-12-20><a id=__codelineno-12-20 name=__codelineno-12-20 href=#__codelineno-12-20></a><span class=kt>var</span><span class=w> </span><span class=n>largeEffect</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>SpawnEffect</span><span class=p>(</span><span class=mf>2.5f</span><span class=p>);</span><span class=w>                        </span><span class=c1>// Custom scale</span>
+</span><span id=__span-12-21><a id=__codelineno-12-21 name=__codelineno-12-21 href=#__codelineno-12-21></a><span class=kt>var</span><span class=w> </span><span class=n>redEffect</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>SpawnEffect</span><span class=p>(</span><span class=mf>1.0f</span><span class=p>,</span><span class=w> </span><span class=n>Color</span><span class=p>.</span><span class=n>red</span><span class=p>);</span><span class=w>               </span><span class=c1>// Custom color</span>
+</span><span id=__span-12-22><a id=__codelineno-12-22 name=__codelineno-12-22 href=#__codelineno-12-22></a><span class=kt>var</span><span class=w> </span><span class=n>customEffect</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>SpawnEffect</span><span class=p>(</span><span class=mf>1.5f</span><span class=p>,</span><span class=w> </span><span class=n>Color</span><span class=p>.</span><span class=n>blue</span><span class=p>,</span><span class=w> </span><span class=mf>10f</span><span class=p>,</span><span class=w> </span><span class=k>true</span><span class=p>);</span><span class=w> </span><span class=c1>// All custom</span>
+</span></code></pre></div> <h4 id=example-3-mix-of-required-and-optional-fields>Example 3: Mix of Required and Optional Fields<a class=headerlink href=#example-3-mix-of-required-and-optional-fields title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-13-1><a id=__codelineno-13-1 name=__codelineno-13-1 href=#__codelineno-13-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-13-2><a id=__codelineno-13-2 name=__codelineno-13-2 href=#__codelineno-13-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-13-3><a id=__codelineno-13-3 name=__codelineno-13-3 href=#__codelineno-13-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>GameEvent</span>
+</span><span id=__span-13-4><a id=__codelineno-13-4 name=__codelineno-13-4 href=#__codelineno-13-4></a><span class=p>{</span>
+</span><span id=__span-13-5><a id=__codelineno-13-5 name=__codelineno-13-5 href=#__codelineno-13-5></a><span class=w>    </span><span class=c1>// Required fields (must be provided)</span>
+</span><span id=__span-13-6><a id=__codelineno-13-6 name=__codelineno-13-6 href=#__codelineno-13-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>eventName</span><span class=p>;</span>
+</span><span id=__span-13-7><a id=__codelineno-13-7 name=__codelineno-13-7 href=#__codelineno-13-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>playerId</span><span class=p>;</span>
+</span><span id=__span-13-8><a id=__codelineno-13-8 name=__codelineno-13-8 href=#__codelineno-13-8></a>
+</span><span id=__span-13-9><a id=__codelineno-13-9 name=__codelineno-13-9 href=#__codelineno-13-9></a><span class=w>    </span><span class=c1>// Optional fields (have defaults)</span>
+</span><span id=__span-13-10><a id=__codelineno-13-10 name=__codelineno-13-10 href=#__codelineno-13-10></a><span class=w>    </span><span class=na>[DxOptionalParameter(0)]</span>
+</span><span id=__span-13-11><a id=__codelineno-13-11 name=__codelineno-13-11 href=#__codelineno-13-11></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>score</span><span class=p>;</span>
+</span><span id=__span-13-12><a id=__codelineno-13-12 name=__codelineno-13-12 href=#__codelineno-13-12></a>
+</span><span id=__span-13-13><a id=__codelineno-13-13 name=__codelineno-13-13 href=#__codelineno-13-13></a><span class=w>    </span><span class=na>[DxOptionalParameter(&quot;&quot;)]</span>
+</span><span id=__span-13-14><a id=__codelineno-13-14 name=__codelineno-13-14 href=#__codelineno-13-14></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>metadata</span><span class=p>;</span>
+</span><span id=__span-13-15><a id=__codelineno-13-15 name=__codelineno-13-15 href=#__codelineno-13-15></a>
+</span><span id=__span-13-16><a id=__codelineno-13-16 name=__codelineno-13-16 href=#__codelineno-13-16></a><span class=w>    </span><span class=na>[DxOptionalParameter(Expression = &quot;System.DateTime.UtcNow&quot;)]</span>
+</span><span id=__span-13-17><a id=__codelineno-13-17 name=__codelineno-13-17 href=#__codelineno-13-17></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=n>System</span><span class=p>.</span><span class=n>DateTime</span><span class=w> </span><span class=n>timestamp</span><span class=p>;</span>
+</span><span id=__span-13-18><a id=__codelineno-13-18 name=__codelineno-13-18 href=#__codelineno-13-18></a><span class=p>}</span>
+</span><span id=__span-13-19><a id=__codelineno-13-19 name=__codelineno-13-19 href=#__codelineno-13-19></a>
+</span><span id=__span-13-20><a id=__codelineno-13-20 name=__codelineno-13-20 href=#__codelineno-13-20></a><span class=c1>// Usage:</span>
+</span><span id=__span-13-21><a id=__codelineno-13-21 name=__codelineno-13-21 href=#__codelineno-13-21></a><span class=kt>var</span><span class=w> </span><span class=n>minimalEvent</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>GameEvent</span><span class=p>(</span><span class=s>&quot;LevelStart&quot;</span><span class=p>,</span><span class=w> </span><span class=mi>1</span><span class=p>);</span>
+</span><span id=__span-13-22><a id=__codelineno-13-22 name=__codelineno-13-22 href=#__codelineno-13-22></a><span class=kt>var</span><span class=w> </span><span class=n>scoredEvent</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>GameEvent</span><span class=p>(</span><span class=s>&quot;EnemyKilled&quot;</span><span class=p>,</span><span class=w> </span><span class=mi>1</span><span class=p>,</span><span class=w> </span><span class=mi>100</span><span class=p>);</span>
+</span><span id=__span-13-23><a id=__codelineno-13-23 name=__codelineno-13-23 href=#__codelineno-13-23></a><span class=kt>var</span><span class=w> </span><span class=n>fullEvent</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>GameEvent</span><span class=p>(</span><span class=s>&quot;Achievement&quot;</span><span class=p>,</span><span class=w> </span><span class=mi>1</span><span class=p>,</span><span class=w> </span><span class=mi>500</span><span class=p>,</span><span class=w> </span><span class=s>&quot;first_blood&quot;</span><span class=p>);</span>
+</span></code></pre></div> <h4 id=example-4-game-settings-message>Example 4: Game Settings Message<a class=headerlink href=#example-4-game-settings-message title="Anchor link to this section">&para;</a></h4> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-14-1><a id=__codelineno-14-1 name=__codelineno-14-1 href=#__codelineno-14-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-14-2><a id=__codelineno-14-2 name=__codelineno-14-2 href=#__codelineno-14-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-14-3><a id=__codelineno-14-3 name=__codelineno-14-3 href=#__codelineno-14-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>AudioSettingsChanged</span>
+</span><span id=__span-14-4><a id=__codelineno-14-4 name=__codelineno-14-4 href=#__codelineno-14-4></a><span class=p>{</span>
+</span><span id=__span-14-5><a id=__codelineno-14-5 name=__codelineno-14-5 href=#__codelineno-14-5></a><span class=w>    </span><span class=na>[DxOptionalParameter(1.0f)]</span>
+</span><span id=__span-14-6><a id=__codelineno-14-6 name=__codelineno-14-6 href=#__codelineno-14-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>masterVolume</span><span class=p>;</span>
+</span><span id=__span-14-7><a id=__codelineno-14-7 name=__codelineno-14-7 href=#__codelineno-14-7></a>
+</span><span id=__span-14-8><a id=__codelineno-14-8 name=__codelineno-14-8 href=#__codelineno-14-8></a><span class=w>    </span><span class=na>[DxOptionalParameter(0.8f)]</span>
+</span><span id=__span-14-9><a id=__codelineno-14-9 name=__codelineno-14-9 href=#__codelineno-14-9></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>musicVolume</span><span class=p>;</span>
+</span><span id=__span-14-10><a id=__codelineno-14-10 name=__codelineno-14-10 href=#__codelineno-14-10></a>
+</span><span id=__span-14-11><a id=__codelineno-14-11 name=__codelineno-14-11 href=#__codelineno-14-11></a><span class=w>    </span><span class=na>[DxOptionalParameter(1.0f)]</span>
+</span><span id=__span-14-12><a id=__codelineno-14-12 name=__codelineno-14-12 href=#__codelineno-14-12></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>sfxVolume</span><span class=p>;</span>
+</span><span id=__span-14-13><a id=__codelineno-14-13 name=__codelineno-14-13 href=#__codelineno-14-13></a>
+</span><span id=__span-14-14><a id=__codelineno-14-14 name=__codelineno-14-14 href=#__codelineno-14-14></a><span class=w>    </span><span class=na>[DxOptionalParameter(true)]</span>
+</span><span id=__span-14-15><a id=__codelineno-14-15 name=__codelineno-14-15 href=#__codelineno-14-15></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>muteWhenUnfocused</span><span class=p>;</span>
+</span><span id=__span-14-16><a id=__codelineno-14-16 name=__codelineno-14-16 href=#__codelineno-14-16></a><span class=p>}</span>
+</span><span id=__span-14-17><a id=__codelineno-14-17 name=__codelineno-14-17 href=#__codelineno-14-17></a>
+</span><span id=__span-14-18><a id=__codelineno-14-18 name=__codelineno-14-18 href=#__codelineno-14-18></a><span class=c1>// Apply all defaults</span>
+</span><span id=__span-14-19><a id=__codelineno-14-19 name=__codelineno-14-19 href=#__codelineno-14-19></a><span class=n>audioSettings</span><span class=p>.</span><span class=n>Emit</span><span class=p>();</span>
+</span><span id=__span-14-20><a id=__codelineno-14-20 name=__codelineno-14-20 href=#__codelineno-14-20></a>
+</span><span id=__span-14-21><a id=__codelineno-14-21 name=__codelineno-14-21 href=#__codelineno-14-21></a><span class=c1>// Only change music volume</span>
+</span><span id=__span-14-22><a id=__codelineno-14-22 name=__codelineno-14-22 href=#__codelineno-14-22></a><span class=k>new</span><span class=w> </span><span class=nf>AudioSettingsChanged</span><span class=p>(</span><span class=n>musicVolume</span><span class=p>:</span><span class=w> </span><span class=mf>0.5f</span><span class=p>).</span><span class=n>Emit</span><span class=p>();</span>
+</span><span id=__span-14-23><a id=__codelineno-14-23 name=__codelineno-14-23 href=#__codelineno-14-23></a>
+</span><span id=__span-14-24><a id=__codelineno-14-24 name=__codelineno-14-24 href=#__codelineno-14-24></a><span class=c1>// Change multiple settings</span>
+</span><span id=__span-14-25><a id=__codelineno-14-25 name=__codelineno-14-25 href=#__codelineno-14-25></a><span class=k>new</span><span class=w> </span><span class=nf>AudioSettingsChanged</span><span class=p>(</span><span class=mf>0.7f</span><span class=p>,</span><span class=w> </span><span class=mf>0.6f</span><span class=p>,</span><span class=w> </span><span class=mf>0.9f</span><span class=p>,</span><span class=w> </span><span class=k>false</span><span class=p>).</span><span class=n>Emit</span><span class=p>();</span>
+</span></code></pre></div> <h4 id=best-practices>Best Practices<a class=headerlink href=#best-practices title="Anchor link to this section">&para;</a></h4> <div class="admonition success"> <p class=admonition-title>Recommendations</p> <ol> <li><strong>Order matters</strong> — Place required fields before optional fields in your struct</li> <li><strong>Use meaningful defaults</strong> — Choose defaults that represent the most common use case</li> <li><strong>Prefer explicit values</strong> — Use <code>[DxOptionalParameter(0)]</code> instead of <code>[DxOptionalParameter]</code> when clarity helps</li> <li><strong>Use Expression for complex types</strong> — Don't fight the type system; use <code>Expression</code> for enums and Unity types</li> <li><strong>Document unusual defaults</strong> — If a default isn't obvious, add a comment explaining why</li> </ol> </div> <h2 id=why-use-attributes-instead-of-manual-implementation>Why Use Attributes Instead of Manual Implementation<a class=headerlink href=#why-use-attributes-instead-of-manual-implementation title="Anchor link to this section">&para;</a></h2> <h3 id=-attribute-definition-clean-automatic>✅ Attribute Definition (Clean, Automatic)<a class=headerlink href=#-attribute-definition-clean-automatic title="Anchor link to this section">&para;</a></h3> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-15-1><a id=__codelineno-15-1 name=__codelineno-15-1 href=#__codelineno-15-1></a><span class=na>[DxTargetedMessage]</span>
+</span><span id=__span-15-2><a id=__codelineno-15-2 name=__codelineno-15-2 href=#__codelineno-15-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-15-3><a id=__codelineno-15-3 name=__codelineno-15-3 href=#__codelineno-15-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Heal</span>
+</span><span id=__span-15-4><a id=__codelineno-15-4 name=__codelineno-15-4 href=#__codelineno-15-4></a><span class=p>{</span>
+</span><span id=__span-15-5><a id=__codelineno-15-5 name=__codelineno-15-5 href=#__codelineno-15-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-15-6><a id=__codelineno-15-6 name=__codelineno-15-6 href=#__codelineno-15-6></a><span class=p>}</span>
+</span></code></pre></div> <h3 id=what-the-generator-emits-for-reference>What the generator emits (for reference)<a class=headerlink href=#what-the-generator-emits-for-reference title="Anchor link to this section">&para;</a></h3> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-16-1><a id=__codelineno-16-1 name=__codelineno-16-1 href=#__codelineno-16-1></a><span class=c1>// Auto-generated by DxMessaging (no need to hand-write this)</span>
+</span><span id=__span-16-2><a id=__codelineno-16-2 name=__codelineno-16-2 href=#__codelineno-16-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Heal</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>ITargetedMessage</span><span class=o>&lt;</span><span class=n>Heal</span><span class=o>&gt;</span>
+</span><span id=__span-16-3><a id=__codelineno-16-3 name=__codelineno-16-3 href=#__codelineno-16-3></a><span class=p>{</span>
+</span><span id=__span-16-4><a id=__codelineno-16-4 name=__codelineno-16-4 href=#__codelineno-16-4></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-16-5><a id=__codelineno-16-5 name=__codelineno-16-5 href=#__codelineno-16-5></a>
+</span><span id=__span-16-6><a id=__codelineno-16-6 name=__codelineno-16-6 href=#__codelineno-16-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=nf>Heal</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>)</span>
+</span><span id=__span-16-7><a id=__codelineno-16-7 name=__codelineno-16-7 href=#__codelineno-16-7></a><span class=w>    </span><span class=p>{</span>
+</span><span id=__span-16-8><a id=__codelineno-16-8 name=__codelineno-16-8 href=#__codelineno-16-8></a><span class=w>        </span><span class=k>this</span><span class=p>.</span><span class=n>amount</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-16-9><a id=__codelineno-16-9 name=__codelineno-16-9 href=#__codelineno-16-9></a><span class=w>    </span><span class=p>}</span>
+</span><span id=__span-16-10><a id=__codelineno-16-10 name=__codelineno-16-10 href=#__codelineno-16-10></a>
+</span><span id=__span-16-11><a id=__codelineno-16-11 name=__codelineno-16-11 href=#__codelineno-16-11></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=n>Type</span><span class=w> </span><span class=n>MessageType</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=k>typeof</span><span class=p>(</span><span class=n>Heal</span><span class=p>);</span>
+</span><span id=__span-16-12><a id=__codelineno-16-12 name=__codelineno-16-12 href=#__codelineno-16-12></a><span class=p>}</span>
+</span></code></pre></div> <h4 id=benefits>Benefits<a class=headerlink href=#benefits title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ <strong>Less code</strong> - 50% fewer lines</li> <li>✅ <strong>Fewer bugs</strong> - Can't forget fields in constructor</li> <li>✅ <strong>Focused</strong> - Focus on data, not boilerplate</li> <li>✅ <strong>Refactor-safe</strong> - Add field? Constructor updates automatically!</li> </ul> <h2 id=complete-example-attribute-definition-vs-generated-output>Complete Example: Attribute Definition vs Generated Output<a class=headerlink href=#complete-example-attribute-definition-vs-generated-output title="Anchor link to this section">&para;</a></h2> <h3 id=attribute-definition-8-lines>Attribute Definition (8 lines)<a class=headerlink href=#attribute-definition-8-lines title="Anchor link to this section">&para;</a></h3> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-17-1><a id=__codelineno-17-1 name=__codelineno-17-1 href=#__codelineno-17-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Attributes</span><span class=p>;</span>
+</span><span id=__span-17-2><a id=__codelineno-17-2 name=__codelineno-17-2 href=#__codelineno-17-2></a>
+</span><span id=__span-17-3><a id=__codelineno-17-3 name=__codelineno-17-3 href=#__codelineno-17-3></a><span class=na>[DxBroadcastMessage]</span>
+</span><span id=__span-17-4><a id=__codelineno-17-4 name=__codelineno-17-4 href=#__codelineno-17-4></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-17-5><a id=__codelineno-17-5 name=__codelineno-17-5 href=#__codelineno-17-5></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>PlayerDamaged</span>
+</span><span id=__span-17-6><a id=__codelineno-17-6 name=__codelineno-17-6 href=#__codelineno-17-6></a><span class=p>{</span>
+</span><span id=__span-17-7><a id=__codelineno-17-7 name=__codelineno-17-7 href=#__codelineno-17-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-17-8><a id=__codelineno-17-8 name=__codelineno-17-8 href=#__codelineno-17-8></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>damageType</span><span class=p>;</span>
+</span><span id=__span-17-9><a id=__codelineno-17-9 name=__codelineno-17-9 href=#__codelineno-17-9></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=n>GameObject</span><span class=w> </span><span class=n>source</span><span class=p>;</span>
+</span><span id=__span-17-10><a id=__codelineno-17-10 name=__codelineno-17-10 href=#__codelineno-17-10></a><span class=p>}</span>
+</span></code></pre></div> <h3 id=generated-output-20-lines-you-never-write>Generated Output (20 lines you never write)<a class=headerlink href=#generated-output-20-lines-you-never-write title="Anchor link to this section">&para;</a></h3> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-18-1><a id=__codelineno-18-1 name=__codelineno-18-1 href=#__codelineno-18-1></a><span class=c1>// Auto-generated by DxMessaging (for reference only)</span>
+</span><span id=__span-18-2><a id=__codelineno-18-2 name=__codelineno-18-2 href=#__codelineno-18-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>PlayerDamaged</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>IBroadcastMessage</span><span class=o>&lt;</span><span class=n>PlayerDamaged</span><span class=o>&gt;</span>
+</span><span id=__span-18-3><a id=__codelineno-18-3 name=__codelineno-18-3 href=#__codelineno-18-3></a><span class=p>{</span>
+</span><span id=__span-18-4><a id=__codelineno-18-4 name=__codelineno-18-4 href=#__codelineno-18-4></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-18-5><a id=__codelineno-18-5 name=__codelineno-18-5 href=#__codelineno-18-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>damageType</span><span class=p>;</span>
+</span><span id=__span-18-6><a id=__codelineno-18-6 name=__codelineno-18-6 href=#__codelineno-18-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=n>GameObject</span><span class=w> </span><span class=n>source</span><span class=p>;</span>
+</span><span id=__span-18-7><a id=__codelineno-18-7 name=__codelineno-18-7 href=#__codelineno-18-7></a>
+</span><span id=__span-18-8><a id=__codelineno-18-8 name=__codelineno-18-8 href=#__codelineno-18-8></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=nf>PlayerDamaged</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>,</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>damageType</span><span class=p>,</span><span class=w> </span><span class=n>GameObject</span><span class=w> </span><span class=n>source</span><span class=p>)</span>
+</span><span id=__span-18-9><a id=__codelineno-18-9 name=__codelineno-18-9 href=#__codelineno-18-9></a><span class=w>    </span><span class=p>{</span>
+</span><span id=__span-18-10><a id=__codelineno-18-10 name=__codelineno-18-10 href=#__codelineno-18-10></a><span class=w>        </span><span class=k>this</span><span class=p>.</span><span class=n>amount</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-18-11><a id=__codelineno-18-11 name=__codelineno-18-11 href=#__codelineno-18-11></a><span class=w>        </span><span class=k>this</span><span class=p>.</span><span class=n>damageType</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>damageType</span><span class=p>;</span>
+</span><span id=__span-18-12><a id=__codelineno-18-12 name=__codelineno-18-12 href=#__codelineno-18-12></a><span class=w>        </span><span class=k>this</span><span class=p>.</span><span class=n>source</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>source</span><span class=p>;</span>
+</span><span id=__span-18-13><a id=__codelineno-18-13 name=__codelineno-18-13 href=#__codelineno-18-13></a><span class=w>    </span><span class=p>}</span>
+</span><span id=__span-18-14><a id=__codelineno-18-14 name=__codelineno-18-14 href=#__codelineno-18-14></a>
+</span><span id=__span-18-15><a id=__codelineno-18-15 name=__codelineno-18-15 href=#__codelineno-18-15></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=n>Type</span><span class=w> </span><span class=n>MessageType</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=k>typeof</span><span class=p>(</span><span class=n>PlayerDamaged</span><span class=p>);</span>
+</span><span id=__span-18-16><a id=__codelineno-18-16 name=__codelineno-18-16 href=#__codelineno-18-16></a><span class=p>}</span>
+</span></code></pre></div> <h3 id=result>Result<a class=headerlink href=#result title="Anchor link to this section">&para;</a></h3> <ul> <li>✅ Same functionality</li> <li>✅ Less code to maintain</li> <li>✅ Automatically updates when you add/remove fields</li> <li>✅ Works for class messages too</li> <li>✅ Zero effort once you mark the struct partial</li> </ul> <h2 id=advanced-manual-implementation-when-attributes-arent-enough>Advanced: Manual Implementation (When Attributes Aren't Enough)<a class=headerlink href=#advanced-manual-implementation-when-attributes-arent-enough title="Anchor link to this section">&para;</a></h2> <p>Attributes cover almost every scenario. If you intentionally drop <code>[DxTargetedMessage]</code>, <code>[DxUntargetedMessage]</code>, or <code>[DxBroadcastMessage]</code>, you'll need to hand-write the interface implementations and constructors shown in the “generated output” examples. Keep the attributes unless you have a very specific data-backed reason not to.</p> <h3 id=generic-message-interfaces-zero-boxing-for-structs>Generic Message Interfaces (Zero-Boxing for Structs)<a class=headerlink href=#generic-message-interfaces-zero-boxing-for-structs title="Anchor link to this section">&para;</a></h3> <p><code>readonly struct</code> messages marked with the attributes already implement the generic interfaces, so emissions stay allocation-free. You get the same performance characteristics as the manual approach without writing any plumbing.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-19-1><a id=__codelineno-19-1 name=__codelineno-19-1 href=#__codelineno-19-1></a><span class=na>[DxTargetedMessage]</span>
+</span><span id=__span-19-2><a id=__codelineno-19-2 name=__codelineno-19-2 href=#__codelineno-19-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-19-3><a id=__codelineno-19-3 name=__codelineno-19-3 href=#__codelineno-19-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Heal</span>
+</span><span id=__span-19-4><a id=__codelineno-19-4 name=__codelineno-19-4 href=#__codelineno-19-4></a><span class=p>{</span>
+</span><span id=__span-19-5><a id=__codelineno-19-5 name=__codelineno-19-5 href=#__codelineno-19-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-19-6><a id=__codelineno-19-6 name=__codelineno-19-6 href=#__codelineno-19-6></a><span class=p>}</span>
+</span></code></pre></div> <h3 id=do-i-have-to-use-attributes>"Do I HAVE to use attributes?"<a class=headerlink href=#do-i-have-to-use-attributes title="Anchor link to this section">&para;</a></h3> <p>Technically no—but without them you must write the constructor, interface implementation, and <code>MessageType</code> property yourself (for speed, you can optionally leave this off, but it might box on certain call paths). Leaving the attributes on keeps everything consistent for the whole team.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-20-1><a id=__codelineno-20-1 name=__codelineno-20-1 href=#__codelineno-20-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-20-2><a id=__codelineno-20-2 name=__codelineno-20-2 href=#__codelineno-20-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-20-3><a id=__codelineno-20-3 name=__codelineno-20-3 href=#__codelineno-20-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>MyMsg</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
+</span></code></pre></div> <h3 id=what-if-i-want-custom-constructor-logic>"What if I want custom constructor logic?"<a class=headerlink href=#what-if-i-want-custom-constructor-logic title="Anchor link to this section">&para;</a></h3> <p>Keep the attributes and add a factory/helper so you still benefit from the generated constructor:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-21-1><a id=__codelineno-21-1 name=__codelineno-21-1 href=#__codelineno-21-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-21-2><a id=__codelineno-21-2 name=__codelineno-21-2 href=#__codelineno-21-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-21-3><a id=__codelineno-21-3 name=__codelineno-21-3 href=#__codelineno-21-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>ComplexMessage</span>
+</span><span id=__span-21-4><a id=__codelineno-21-4 name=__codelineno-21-4 href=#__codelineno-21-4></a><span class=p>{</span>
+</span><span id=__span-21-5><a id=__codelineno-21-5 name=__codelineno-21-5 href=#__codelineno-21-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=k>value</span><span class=p>;</span>
+</span><span id=__span-21-6><a id=__codelineno-21-6 name=__codelineno-21-6 href=#__codelineno-21-6></a>
+</span><span id=__span-21-7><a id=__codelineno-21-7 name=__codelineno-21-7 href=#__codelineno-21-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=n>ComplexMessage</span><span class=w> </span><span class=nf>FromRaw</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>rawValue</span><span class=p>)</span>
+</span><span id=__span-21-8><a id=__codelineno-21-8 name=__codelineno-21-8 href=#__codelineno-21-8></a><span class=w>    </span><span class=p>{</span>
+</span><span id=__span-21-9><a id=__codelineno-21-9 name=__codelineno-21-9 href=#__codelineno-21-9></a><span class=w>        </span><span class=kt>int</span><span class=w> </span><span class=n>clamped</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Math</span><span class=p>.</span><span class=n>Clamp</span><span class=p>(</span><span class=n>rawValue</span><span class=p>,</span><span class=w> </span><span class=mi>0</span><span class=p>,</span><span class=w> </span><span class=mi>100</span><span class=p>);</span>
+</span><span id=__span-21-10><a id=__codelineno-21-10 name=__codelineno-21-10 href=#__codelineno-21-10></a><span class=w>        </span><span class=k>return</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=nf>ComplexMessage</span><span class=p>(</span><span class=n>clamped</span><span class=p>);</span>
+</span><span id=__span-21-11><a id=__codelineno-21-11 name=__codelineno-21-11 href=#__codelineno-21-11></a><span class=w>    </span><span class=p>}</span>
+</span><span id=__span-21-12><a id=__codelineno-21-12 name=__codelineno-21-12 href=#__codelineno-21-12></a><span class=p>}</span>
+</span></code></pre></div> <p>If you truly must write a custom constructor, drop <code>[DxAutoConstructor]</code> for that type but keep the <code>[DxUntargetedMessage]</code>/<code>[DxTargetedMessage]</code> attribute so the interface plumbing stays consistent.</p> <h3 id=can-i-mix-attribute-based-and-manual-messages>"Can I mix attribute-based and manual messages?"<a class=headerlink href=#can-i-mix-attribute-based-and-manual-messages title="Anchor link to this section">&para;</a></h3> <p>Yes. Attribute-driven messages happily coexist with string messages and any manual implementations you already have. You can migrate gradually by converting one message at a time:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-22-1><a id=__codelineno-22-1 name=__codelineno-22-1 href=#__codelineno-22-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-22-2><a id=__codelineno-22-2 name=__codelineno-22-2 href=#__codelineno-22-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-22-3><a id=__codelineno-22-3 name=__codelineno-22-3 href=#__codelineno-22-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>MessageA</span>
+</span><span id=__span-22-4><a id=__codelineno-22-4 name=__codelineno-22-4 href=#__codelineno-22-4></a><span class=p>{</span>
+</span><span id=__span-22-5><a id=__codelineno-22-5 name=__codelineno-22-5 href=#__codelineno-22-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=k>value</span><span class=p>;</span>
+</span><span id=__span-22-6><a id=__codelineno-22-6 name=__codelineno-22-6 href=#__codelineno-22-6></a><span class=p>}</span>
+</span><span id=__span-22-7><a id=__codelineno-22-7 name=__codelineno-22-7 href=#__codelineno-22-7></a>
+</span><span id=__span-22-8><a id=__codelineno-22-8 name=__codelineno-22-8 href=#__codelineno-22-8></a><span class=c1>// Existing manual message types keep working alongside attribute-driven ones.</span>
+</span></code></pre></div> <h2 id=extension-methods-emit-helpers>Extension Methods (Emit Helpers)<a class=headerlink href=#extension-methods-emit-helpers title="Anchor link to this section">&para;</a></h2> <p>DxMessaging provides extension methods to make emitting messages easy:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-23-1><a id=__codelineno-23-1 name=__codelineno-23-1 href=#__codelineno-23-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.Extensions</span><span class=p>;</span><span class=w>  </span><span class=c1>// ← Don&#39;t forget this!</span>
+</span><span id=__span-23-2><a id=__codelineno-23-2 name=__codelineno-23-2 href=#__codelineno-23-2></a><span class=k>using</span><span class=w> </span><span class=nn>UnityEngine</span><span class=p>;</span>
+</span><span id=__span-23-3><a id=__codelineno-23-3 name=__codelineno-23-3 href=#__codelineno-23-3></a>
+</span><span id=__span-23-4><a id=__codelineno-23-4 name=__codelineno-23-4 href=#__codelineno-23-4></a><span class=c1>// Untargeted (global)</span>
+</span><span id=__span-23-5><a id=__codelineno-23-5 name=__codelineno-23-5 href=#__codelineno-23-5></a><span class=kt>var</span><span class=w> </span><span class=n>settings</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>VideoSettingsChanged</span><span class=p>(</span><span class=mi>1920</span><span class=p>,</span><span class=w> </span><span class=mi>1080</span><span class=p>);</span>
+</span><span id=__span-23-6><a id=__codelineno-23-6 name=__codelineno-23-6 href=#__codelineno-23-6></a><span class=n>settings</span><span class=p>.</span><span class=n>Emit</span><span class=p>();</span>
+</span><span id=__span-23-7><a id=__codelineno-23-7 name=__codelineno-23-7 href=#__codelineno-23-7></a>
+</span><span id=__span-23-8><a id=__codelineno-23-8 name=__codelineno-23-8 href=#__codelineno-23-8></a><span class=c1>// Targeted - GameObject overload</span>
+</span><span id=__span-23-9><a id=__codelineno-23-9 name=__codelineno-23-9 href=#__codelineno-23-9></a><span class=kt>var</span><span class=w> </span><span class=n>heal</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>Heal</span><span class=p>(</span><span class=mi>10</span><span class=p>);</span>
+</span><span id=__span-23-10><a id=__codelineno-23-10 name=__codelineno-23-10 href=#__codelineno-23-10></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitGameObjectTargeted</span><span class=p>(</span><span class=n>playerGameObject</span><span class=p>);</span>
+</span><span id=__span-23-11><a id=__codelineno-23-11 name=__codelineno-23-11 href=#__codelineno-23-11></a>
+</span><span id=__span-23-12><a id=__codelineno-23-12 name=__codelineno-23-12 href=#__codelineno-23-12></a><span class=c1>// Targeted - Component overload</span>
+</span><span id=__span-23-13><a id=__codelineno-23-13 name=__codelineno-23-13 href=#__codelineno-23-13></a><span class=n>heal</span><span class=p>.</span><span class=n>EmitComponentTargeted</span><span class=p>(</span><span class=n>playerComponent</span><span class=p>);</span>
+</span><span id=__span-23-14><a id=__codelineno-23-14 name=__codelineno-23-14 href=#__codelineno-23-14></a>
+</span><span id=__span-23-15><a id=__codelineno-23-15 name=__codelineno-23-15 href=#__codelineno-23-15></a><span class=c1>// Broadcast - GameObject overload</span>
+</span><span id=__span-23-16><a id=__codelineno-23-16 name=__codelineno-23-16 href=#__codelineno-23-16></a><span class=kt>var</span><span class=w> </span><span class=n>dmg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>TookDamage</span><span class=p>(</span><span class=mi>25</span><span class=p>);</span>
+</span><span id=__span-23-17><a id=__codelineno-23-17 name=__codelineno-23-17 href=#__codelineno-23-17></a><span class=n>dmg</span><span class=p>.</span><span class=n>EmitGameObjectBroadcast</span><span class=p>(</span><span class=n>enemyGameObject</span><span class=p>);</span>
+</span><span id=__span-23-18><a id=__codelineno-23-18 name=__codelineno-23-18 href=#__codelineno-23-18></a>
+</span><span id=__span-23-19><a id=__codelineno-23-19 name=__codelineno-23-19 href=#__codelineno-23-19></a><span class=c1>// Broadcast - Component overload</span>
+</span><span id=__span-23-20><a id=__codelineno-23-20 name=__codelineno-23-20 href=#__codelineno-23-20></a><span class=n>dmg</span><span class=p>.</span><span class=n>EmitComponentBroadcast</span><span class=p>(</span><span class=n>enemyComponent</span><span class=p>);</span>
+</span><span id=__span-23-21><a id=__codelineno-23-21 name=__codelineno-23-21 href=#__codelineno-23-21></a>
+</span><span id=__span-23-22><a id=__codelineno-23-22 name=__codelineno-23-22 href=#__codelineno-23-22></a><span class=c1>// String convenience (for quick prototyping)</span>
+</span><span id=__span-23-23><a id=__codelineno-23-23 name=__codelineno-23-23 href=#__codelineno-23-23></a><span class=s>&quot;LevelCompleted&quot;</span><span class=p>.</span><span class=n>Emit</span><span class=p>();</span>
+</span></code></pre></div> <p><strong>Located in:</strong> <code>DxMessaging.Core.Extensions.MessageExtensions</code></p> <h3 id=automatic-overload-selection>Automatic overload selection<a class=headerlink href=#automatic-overload-selection title="Anchor link to this section">&para;</a></h3> <ul> <li>Extension methods pick the right overload based on type</li> <li>Defaults to global <code>MessageHandler.MessageBus</code></li> <li>Pass custom bus with optional parameter</li> </ul> <h2 id=local-bus-islands-isolated-testing>Local Bus Islands (Isolated Testing)<a class=headerlink href=#local-bus-islands-isolated-testing title="Anchor link to this section">&para;</a></h2> <p>Create isolated message buses for tests or subsystems:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-24-1><a id=__codelineno-24-1 name=__codelineno-24-1 href=#__codelineno-24-1></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core</span><span class=p>;</span>
+</span><span id=__span-24-2><a id=__codelineno-24-2 name=__codelineno-24-2 href=#__codelineno-24-2></a><span class=k>using</span><span class=w> </span><span class=nn>DxMessaging.Core.MessageBus</span><span class=p>;</span>
+</span><span id=__span-24-3><a id=__codelineno-24-3 name=__codelineno-24-3 href=#__codelineno-24-3></a>
+</span><span id=__span-24-4><a id=__codelineno-24-4 name=__codelineno-24-4 href=#__codelineno-24-4></a><span class=c1>// Create isolated bus</span>
+</span><span id=__span-24-5><a id=__codelineno-24-5 name=__codelineno-24-5 href=#__codelineno-24-5></a><span class=kt>var</span><span class=w> </span><span class=n>testBus</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageBus</span><span class=p>();</span>
+</span><span id=__span-24-6><a id=__codelineno-24-6 name=__codelineno-24-6 href=#__codelineno-24-6></a><span class=kt>var</span><span class=w> </span><span class=n>handler</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MessageHandler</span><span class=p>(</span><span class=k>new</span><span class=w> </span><span class=n>InstanceId</span><span class=p>(</span><span class=mi>1</span><span class=p>),</span><span class=w> </span><span class=n>testBus</span><span class=p>)</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=n>active</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>true</span><span class=w> </span><span class=p>};</span>
+</span><span id=__span-24-7><a id=__codelineno-24-7 name=__codelineno-24-7 href=#__codelineno-24-7></a><span class=kt>var</span><span class=w> </span><span class=n>token</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>MessageRegistrationToken</span><span class=p>.</span><span class=n>Create</span><span class=p>(</span><span class=n>handler</span><span class=p>,</span><span class=w> </span><span class=n>testBus</span><span class=p>);</span>
+</span><span id=__span-24-8><a id=__codelineno-24-8 name=__codelineno-24-8 href=#__codelineno-24-8></a>
+</span><span id=__span-24-9><a id=__codelineno-24-9 name=__codelineno-24-9 href=#__codelineno-24-9></a><span class=c1>// Register on isolated bus</span>
+</span><span id=__span-24-10><a id=__codelineno-24-10 name=__codelineno-24-10 href=#__codelineno-24-10></a><span class=n>_</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>token</span><span class=p>.</span><span class=n>RegisterUntargeted</span><span class=o>&lt;</span><span class=n>MyMessage</span><span class=o>&gt;</span><span class=p>(</span><span class=n>OnMessage</span><span class=p>);</span>
+</span><span id=__span-24-11><a id=__codelineno-24-11 name=__codelineno-24-11 href=#__codelineno-24-11></a>
+</span><span id=__span-24-12><a id=__codelineno-24-12 name=__codelineno-24-12 href=#__codelineno-24-12></a><span class=c1>// Emit to isolated bus (won&#39;t affect global bus!)</span>
+</span><span id=__span-24-13><a id=__codelineno-24-13 name=__codelineno-24-13 href=#__codelineno-24-13></a><span class=kt>var</span><span class=w> </span><span class=n>msg</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>MyMessage</span><span class=p>();</span>
+</span><span id=__span-24-14><a id=__codelineno-24-14 name=__codelineno-24-14 href=#__codelineno-24-14></a><span class=n>msg</span><span class=p>.</span><span class=n>Emit</span><span class=p>(</span><span class=n>testBus</span><span class=p>);</span>
+</span></code></pre></div> <h3 id=use-cases>Use cases<a class=headerlink href=#use-cases title="Anchor link to this section">&para;</a></h3> <ul> <li>Unit tests (no global side effects!)</li> <li>Subsystem isolation (UI has own bus)</li> <li>Sandboxing (mod systems, untrusted code)</li> </ul> <h2 id=attributes-quick-reference>Attributes Quick Reference<a class=headerlink href=#attributes-quick-reference title="Anchor link to this section">&para;</a></h2> <h3 id=message-type-attributes>Message Type Attributes<a class=headerlink href=#message-type-attributes title="Anchor link to this section">&para;</a></h3> <div class="tabbed-set tabbed-alternate" data-tabs=2:3><input checked=checked id=__tabbed_2_1 name=__tabbed_2 type=radio><input id=__tabbed_2_2 name=__tabbed_2 type=radio><input id=__tabbed_2_3 name=__tabbed_2 type=radio><div class=tabbed-labels><label for=__tabbed_2_1>Untargeted</label><label for=__tabbed_2_2>Targeted</label><label for=__tabbed_2_3>Broadcast</label></div> <div class=tabbed-content> <div class=tabbed-block> <p>Mark as a global message (no target):</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-25-1><a id=__codelineno-25-1 name=__codelineno-25-1 href=#__codelineno-25-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-25-2><a id=__codelineno-25-2 name=__codelineno-25-2 href=#__codelineno-25-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>GamePaused</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
+</span></code></pre></div> </div> <div class=tabbed-block> <p>Mark as a message sent to a specific target:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-26-1><a id=__codelineno-26-1 name=__codelineno-26-1 href=#__codelineno-26-1></a><span class=na>[DxTargetedMessage]</span>
+</span><span id=__span-26-2><a id=__codelineno-26-2 name=__codelineno-26-2 href=#__codelineno-26-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Heal</span>
+</span><span id=__span-26-3><a id=__codelineno-26-3 name=__codelineno-26-3 href=#__codelineno-26-3></a><span class=p>{</span>
+</span><span id=__span-26-4><a id=__codelineno-26-4 name=__codelineno-26-4 href=#__codelineno-26-4></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-26-5><a id=__codelineno-26-5 name=__codelineno-26-5 href=#__codelineno-26-5></a><span class=p>}</span>
+</span></code></pre></div> </div> <div class=tabbed-block> <p>Mark as a message broadcast from a source:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-27-1><a id=__codelineno-27-1 name=__codelineno-27-1 href=#__codelineno-27-1></a><span class=na>[DxBroadcastMessage]</span>
+</span><span id=__span-27-2><a id=__codelineno-27-2 name=__codelineno-27-2 href=#__codelineno-27-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>TookDamage</span>
+</span><span id=__span-27-3><a id=__codelineno-27-3 name=__codelineno-27-3 href=#__codelineno-27-3></a><span class=p>{</span>
+</span><span id=__span-27-4><a id=__codelineno-27-4 name=__codelineno-27-4 href=#__codelineno-27-4></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-27-5><a id=__codelineno-27-5 name=__codelineno-27-5 href=#__codelineno-27-5></a><span class=p>}</span>
+</span></code></pre></div> </div> </div> </div> <h3 id=constructor-generation-attributes>Constructor Generation Attributes<a class=headerlink href=#constructor-generation-attributes title="Anchor link to this section">&para;</a></h3> <h4 id=dxautoconstructor><code>[DxAutoConstructor]</code><a class=headerlink href=#dxautoconstructor title="Anchor link to this section">&para;</a></h4> <p>Automatically generates a constructor with all public fields as parameters:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-28-1><a id=__codelineno-28-1 name=__codelineno-28-1 href=#__codelineno-28-1></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-28-2><a id=__codelineno-28-2 name=__codelineno-28-2 href=#__codelineno-28-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Damage</span>
+</span><span id=__span-28-3><a id=__codelineno-28-3 name=__codelineno-28-3 href=#__codelineno-28-3></a><span class=p>{</span>
+</span><span id=__span-28-4><a id=__codelineno-28-4 name=__codelineno-28-4 href=#__codelineno-28-4></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-28-5><a id=__codelineno-28-5 name=__codelineno-28-5 href=#__codelineno-28-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>type</span><span class=p>;</span>
+</span><span id=__span-28-6><a id=__codelineno-28-6 name=__codelineno-28-6 href=#__codelineno-28-6></a><span class=p>}</span>
+</span><span id=__span-28-7><a id=__codelineno-28-7 name=__codelineno-28-7 href=#__codelineno-28-7></a><span class=c1>// Generates: Damage(int amount, string type)</span>
+</span></code></pre></div> <h4 id=dxoptionalparameter><code>[DxOptionalParameter]</code><a class=headerlink href=#dxoptionalparameter title="Anchor link to this section">&para;</a></h4> <p>Makes a constructor parameter optional. Three usage patterns:</p> <details class=example> <summary>Default Value (type default)</summary> <p>Uses the type's default value (<code>0</code>, <code>false</code>, <code>null</code>, etc.):</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-29-1><a id=__codelineno-29-1 name=__codelineno-29-1 href=#__codelineno-29-1></a><span class=na>[DxOptionalParameter]</span>
+</span><span id=__span-29-2><a id=__codelineno-29-2 name=__codelineno-29-2 href=#__codelineno-29-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>flag</span><span class=p>;</span>
+</span><span id=__span-29-3><a id=__codelineno-29-3 name=__codelineno-29-3 href=#__codelineno-29-3></a><span class=c1>// Generates: bool flag = default</span>
+</span></code></pre></div> </details> <details class=example> <summary>Custom Value (primitive)</summary> <p>Provides a specific default value:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-30-1><a id=__codelineno-30-1 name=__codelineno-30-1 href=#__codelineno-30-1></a><span class=na>[DxOptionalParameter(42)]</span>
+</span><span id=__span-30-2><a id=__codelineno-30-2 name=__codelineno-30-2 href=#__codelineno-30-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>count</span><span class=p>;</span>
+</span><span id=__span-30-3><a id=__codelineno-30-3 name=__codelineno-30-3 href=#__codelineno-30-3></a><span class=c1>// Generates: int count = 42</span>
+</span></code></pre></div> </details> <details class=example> <summary>Expression (complex types)</summary> <p>Uses a verbatim expression for enums, Unity types, etc.:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-31-1><a id=__codelineno-31-1 name=__codelineno-31-1 href=#__codelineno-31-1></a><span class=na>[DxOptionalParameter(Expression = &quot;DamageType.Physical&quot;)]</span>
+</span><span id=__span-31-2><a id=__codelineno-31-2 name=__codelineno-31-2 href=#__codelineno-31-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=n>DamageType</span><span class=w> </span><span class=n>damageType</span><span class=p>;</span>
+</span><span id=__span-31-3><a id=__codelineno-31-3 name=__codelineno-31-3 href=#__codelineno-31-3></a><span class=c1>// Generates: DamageType damageType = DamageType.Physical</span>
+</span></code></pre></div> </details> <h3 id=supported-types>Supported Types<a class=headerlink href=#supported-types title="Anchor link to this section">&para;</a></h3> <p>These attributes work with:</p> <ul> <li><strong>Top-level types</strong> — public structs and classes</li> <li><strong>Nested types</strong> — types inside other classes</li> <li><strong>Internal types</strong> — assembly-private messages</li> </ul> <h2 id=common-patterns-with-attributes>Common Patterns with Attributes<a class=headerlink href=#common-patterns-with-attributes title="Anchor link to this section">&para;</a></h2> <h3 id=pattern-1-simple-message-no-data>Pattern 1: Simple Message (No Data)<a class=headerlink href=#pattern-1-simple-message-no-data title="Anchor link to this section">&para;</a></h3> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-32-1><a id=__codelineno-32-1 name=__codelineno-32-1 href=#__codelineno-32-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-32-2><a id=__codelineno-32-2 name=__codelineno-32-2 href=#__codelineno-32-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>GamePaused</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
+</span><span id=__span-32-3><a id=__codelineno-32-3 name=__codelineno-32-3 href=#__codelineno-32-3></a><span class=c1>// No constructor needed - empty message</span>
+</span></code></pre></div> <h3 id=pattern-2-message-with-data>Pattern 2: Message with Data<a class=headerlink href=#pattern-2-message-with-data title="Anchor link to this section">&para;</a></h3> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-33-1><a id=__codelineno-33-1 name=__codelineno-33-1 href=#__codelineno-33-1></a><span class=na>[DxTargetedMessage]</span>
+</span><span id=__span-33-2><a id=__codelineno-33-2 name=__codelineno-33-2 href=#__codelineno-33-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-33-3><a id=__codelineno-33-3 name=__codelineno-33-3 href=#__codelineno-33-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Heal</span>
+</span><span id=__span-33-4><a id=__codelineno-33-4 name=__codelineno-33-4 href=#__codelineno-33-4></a><span class=p>{</span>
+</span><span id=__span-33-5><a id=__codelineno-33-5 name=__codelineno-33-5 href=#__codelineno-33-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-33-6><a id=__codelineno-33-6 name=__codelineno-33-6 href=#__codelineno-33-6></a><span class=p>}</span>
+</span><span id=__span-33-7><a id=__codelineno-33-7 name=__codelineno-33-7 href=#__codelineno-33-7></a><span class=c1>// Auto-generates: Heal(int amount)</span>
+</span></code></pre></div> <h3 id=pattern-3-message-with-optional-fields>Pattern 3: Message with Optional Fields<a class=headerlink href=#pattern-3-message-with-optional-fields title="Anchor link to this section">&para;</a></h3> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-34-1><a id=__codelineno-34-1 name=__codelineno-34-1 href=#__codelineno-34-1></a><span class=na>[DxBroadcastMessage]</span>
+</span><span id=__span-34-2><a id=__codelineno-34-2 name=__codelineno-34-2 href=#__codelineno-34-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-34-3><a id=__codelineno-34-3 name=__codelineno-34-3 href=#__codelineno-34-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Attack</span>
+</span><span id=__span-34-4><a id=__codelineno-34-4 name=__codelineno-34-4 href=#__codelineno-34-4></a><span class=p>{</span>
+</span><span id=__span-34-5><a id=__codelineno-34-5 name=__codelineno-34-5 href=#__codelineno-34-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>damage</span><span class=p>;</span>
+</span><span id=__span-34-6><a id=__codelineno-34-6 name=__codelineno-34-6 href=#__codelineno-34-6></a><span class=w>    </span><span class=na>[DxOptionalParameter]</span>
+</span><span id=__span-34-7><a id=__codelineno-34-7 name=__codelineno-34-7 href=#__codelineno-34-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>damageType</span><span class=p>;</span>
+</span><span id=__span-34-8><a id=__codelineno-34-8 name=__codelineno-34-8 href=#__codelineno-34-8></a><span class=p>}</span>
+</span><span id=__span-34-9><a id=__codelineno-34-9 name=__codelineno-34-9 href=#__codelineno-34-9></a><span class=c1>// Auto-generates: Attack(int damage, string damageType = default)</span>
+</span></code></pre></div> <h3 id=pattern-4-complex-message>Pattern 4: Complex Message<a class=headerlink href=#pattern-4-complex-message title="Anchor link to this section">&para;</a></h3> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-35-1><a id=__codelineno-35-1 name=__codelineno-35-1 href=#__codelineno-35-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-35-2><a id=__codelineno-35-2 name=__codelineno-35-2 href=#__codelineno-35-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-35-3><a id=__codelineno-35-3 name=__codelineno-35-3 href=#__codelineno-35-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>LevelCompleted</span>
+</span><span id=__span-35-4><a id=__codelineno-35-4 name=__codelineno-35-4 href=#__codelineno-35-4></a><span class=p>{</span>
+</span><span id=__span-35-5><a id=__codelineno-35-5 name=__codelineno-35-5 href=#__codelineno-35-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>level</span><span class=p>;</span>
+</span><span id=__span-35-6><a id=__codelineno-35-6 name=__codelineno-35-6 href=#__codelineno-35-6></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>float</span><span class=w> </span><span class=n>time</span><span class=p>;</span>
+</span><span id=__span-35-7><a id=__codelineno-35-7 name=__codelineno-35-7 href=#__codelineno-35-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>score</span><span class=p>;</span>
+</span><span id=__span-35-8><a id=__codelineno-35-8 name=__codelineno-35-8 href=#__codelineno-35-8></a><span class=w>    </span><span class=na>[DxOptionalParameter]</span>
+</span><span id=__span-35-9><a id=__codelineno-35-9 name=__codelineno-35-9 href=#__codelineno-35-9></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>bool</span><span class=w> </span><span class=n>perfectRun</span><span class=p>;</span>
+</span><span id=__span-35-10><a id=__codelineno-35-10 name=__codelineno-35-10 href=#__codelineno-35-10></a><span class=w>    </span><span class=na>[DxOptionalParameter]</span>
+</span><span id=__span-35-11><a id=__codelineno-35-11 name=__codelineno-35-11 href=#__codelineno-35-11></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>bonusReason</span><span class=p>;</span>
+</span><span id=__span-35-12><a id=__codelineno-35-12 name=__codelineno-35-12 href=#__codelineno-35-12></a><span class=p>}</span>
+</span><span id=__span-35-13><a id=__codelineno-35-13 name=__codelineno-35-13 href=#__codelineno-35-13></a><span class=c1>// All fields become constructor parameters, last two are optional</span>
+</span></code></pre></div> <h3 id=pattern-5-nested-types>Pattern 5: Nested Types<a class=headerlink href=#pattern-5-nested-types title="Anchor link to this section">&para;</a></h3> <p>Define messages inside other classes for better organization:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-36-1><a id=__codelineno-36-1 name=__codelineno-36-1 href=#__codelineno-36-1></a><span class=k>public</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>class</span><span class=w> </span><span class=nc>GameEvents</span>
+</span><span id=__span-36-2><a id=__codelineno-36-2 name=__codelineno-36-2 href=#__codelineno-36-2></a><span class=p>{</span>
+</span><span id=__span-36-3><a id=__codelineno-36-3 name=__codelineno-36-3 href=#__codelineno-36-3></a><span class=w>    </span><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-36-4><a id=__codelineno-36-4 name=__codelineno-36-4 href=#__codelineno-36-4></a><span class=w>    </span><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-36-5><a id=__codelineno-36-5 name=__codelineno-36-5 href=#__codelineno-36-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>LevelUp</span>
+</span><span id=__span-36-6><a id=__codelineno-36-6 name=__codelineno-36-6 href=#__codelineno-36-6></a><span class=w>    </span><span class=p>{</span>
+</span><span id=__span-36-7><a id=__codelineno-36-7 name=__codelineno-36-7 href=#__codelineno-36-7></a><span class=w>        </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>newLevel</span><span class=p>;</span>
+</span><span id=__span-36-8><a id=__codelineno-36-8 name=__codelineno-36-8 href=#__codelineno-36-8></a><span class=w>    </span><span class=p>}</span>
+</span><span id=__span-36-9><a id=__codelineno-36-9 name=__codelineno-36-9 href=#__codelineno-36-9></a>
+</span><span id=__span-36-10><a id=__codelineno-36-10 name=__codelineno-36-10 href=#__codelineno-36-10></a><span class=w>    </span><span class=na>[DxTargetedMessage]</span>
+</span><span id=__span-36-11><a id=__codelineno-36-11 name=__codelineno-36-11 href=#__codelineno-36-11></a><span class=w>    </span><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-36-12><a id=__codelineno-36-12 name=__codelineno-36-12 href=#__codelineno-36-12></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>GainExperience</span>
+</span><span id=__span-36-13><a id=__codelineno-36-13 name=__codelineno-36-13 href=#__codelineno-36-13></a><span class=w>    </span><span class=p>{</span>
+</span><span id=__span-36-14><a id=__codelineno-36-14 name=__codelineno-36-14 href=#__codelineno-36-14></a><span class=w>        </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=n>amount</span><span class=p>;</span>
+</span><span id=__span-36-15><a id=__codelineno-36-15 name=__codelineno-36-15 href=#__codelineno-36-15></a><span class=w>    </span><span class=p>}</span>
+</span><span id=__span-36-16><a id=__codelineno-36-16 name=__codelineno-36-16 href=#__codelineno-36-16></a><span class=p>}</span>
+</span><span id=__span-36-17><a id=__codelineno-36-17 name=__codelineno-36-17 href=#__codelineno-36-17></a>
+</span><span id=__span-36-18><a id=__codelineno-36-18 name=__codelineno-36-18 href=#__codelineno-36-18></a><span class=c1>// Usage:</span>
+</span><span id=__span-36-19><a id=__codelineno-36-19 name=__codelineno-36-19 href=#__codelineno-36-19></a><span class=kt>var</span><span class=w> </span><span class=n>levelUp</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=n>GameEvents</span><span class=p>.</span><span class=n>LevelUp</span><span class=p>(</span><span class=mi>5</span><span class=p>);</span>
+</span><span id=__span-36-20><a id=__codelineno-36-20 name=__codelineno-36-20 href=#__codelineno-36-20></a><span class=n>levelUp</span><span class=p>.</span><span class=n>Emit</span><span class=p>();</span>
+</span></code></pre></div> <h4 id=benefits_1>Benefits<a class=headerlink href=#benefits_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>Organizes related messages into namespaces or classes</li> <li>Reduces global namespace pollution</li> <li>Works identically to top-level messages</li> </ul> <h3 id=pattern-6-internal-types-assembly-private-messages>Pattern 6: Internal Types (Assembly-Private Messages)<a class=headerlink href=#pattern-6-internal-types-assembly-private-messages title="Anchor link to this section">&para;</a></h3> <p>Keep implementation details private to your assembly:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-37-1><a id=__codelineno-37-1 name=__codelineno-37-1 href=#__codelineno-37-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-37-2><a id=__codelineno-37-2 name=__codelineno-37-2 href=#__codelineno-37-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-37-3><a id=__codelineno-37-3 name=__codelineno-37-3 href=#__codelineno-37-3></a><span class=k>internal</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>InternalDebugMessage</span>
+</span><span id=__span-37-4><a id=__codelineno-37-4 name=__codelineno-37-4 href=#__codelineno-37-4></a><span class=p>{</span>
+</span><span id=__span-37-5><a id=__codelineno-37-5 name=__codelineno-37-5 href=#__codelineno-37-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>string</span><span class=w> </span><span class=n>debugInfo</span><span class=p>;</span>
+</span><span id=__span-37-6><a id=__codelineno-37-6 name=__codelineno-37-6 href=#__codelineno-37-6></a><span class=p>}</span>
+</span><span id=__span-37-7><a id=__codelineno-37-7 name=__codelineno-37-7 href=#__codelineno-37-7></a>
+</span><span id=__span-37-8><a id=__codelineno-37-8 name=__codelineno-37-8 href=#__codelineno-37-8></a><span class=c1>// Only visible within this assembly</span>
+</span><span id=__span-37-9><a id=__codelineno-37-9 name=__codelineno-37-9 href=#__codelineno-37-9></a><span class=c1>// Perfect for internal messaging that shouldn&#39;t leak to other packages</span>
+</span></code></pre></div> <h4 id=use-cases_1>Use cases<a class=headerlink href=#use-cases_1 title="Anchor link to this section">&para;</a></h4> <ul> <li>Implementation details that shouldn't be public API</li> <li>Plugin or package-internal messaging</li> <li>Test-only messages</li> </ul> <h2 id=faq-source-generators--attributes>FAQ: Source Generators &amp; Attributes<a class=headerlink href=#faq-source-generators--attributes title="Anchor link to this section">&para;</a></h2> <h3 id=do-i-have-to-use-attributes_1>"Do I HAVE to use attributes?"<a class=headerlink href=#do-i-have-to-use-attributes_1 title="Anchor link to this section">&para;</a></h3> <p><strong>No!</strong> You can implement interfaces manually:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-38-1><a id=__codelineno-38-1 name=__codelineno-38-1 href=#__codelineno-38-1></a><span class=c1>// Manual (works fine, just more code)</span>
+</span><span id=__span-38-2><a id=__codelineno-38-2 name=__codelineno-38-2 href=#__codelineno-38-2></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>MyMsg</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>IUntargetedMessage</span><span class=o>&lt;</span><span class=n>MyMsg</span><span class=o>&gt;</span>
+</span><span id=__span-38-3><a id=__codelineno-38-3 name=__codelineno-38-3 href=#__codelineno-38-3></a><span class=p>{</span>
+</span><span id=__span-38-4><a id=__codelineno-38-4 name=__codelineno-38-4 href=#__codelineno-38-4></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=n>Type</span><span class=w> </span><span class=n>MessageType</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=k>typeof</span><span class=p>(</span><span class=n>MyMsg</span><span class=p>);</span>
+</span><span id=__span-38-5><a id=__codelineno-38-5 name=__codelineno-38-5 href=#__codelineno-38-5></a><span class=p>}</span>
+</span><span id=__span-38-6><a id=__codelineno-38-6 name=__codelineno-38-6 href=#__codelineno-38-6></a>
+</span><span id=__span-38-7><a id=__codelineno-38-7 name=__codelineno-38-7 href=#__codelineno-38-7></a><span class=c1>// Attributes (same result, less code)</span>
+</span><span id=__span-38-8><a id=__codelineno-38-8 name=__codelineno-38-8 href=#__codelineno-38-8></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-38-9><a id=__codelineno-38-9 name=__codelineno-38-9 href=#__codelineno-38-9></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>MyMsg</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
+</span></code></pre></div> <p><strong>Recommendation:</strong> Use attributes unless you need explicit control.</p> <h3 id=why-partial-when-using-attributes>"Why <code>partial</code> when using attributes?"<a class=headerlink href=#why-partial-when-using-attributes title="Anchor link to this section">&para;</a></h3> <p>Source generators need to <strong>add code to your type</strong>. The <code>partial</code> keyword allows them to extend your struct/class in a separate file.</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-39-1><a id=__codelineno-39-1 name=__codelineno-39-1 href=#__codelineno-39-1></a><span class=c1>// Your file (MyMessage.cs)</span>
+</span><span id=__span-39-2><a id=__codelineno-39-2 name=__codelineno-39-2 href=#__codelineno-39-2></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-39-3><a id=__codelineno-39-3 name=__codelineno-39-3 href=#__codelineno-39-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>MyMessage</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
+</span><span id=__span-39-4><a id=__codelineno-39-4 name=__codelineno-39-4 href=#__codelineno-39-4></a>
+</span><span id=__span-39-5><a id=__codelineno-39-5 name=__codelineno-39-5 href=#__codelineno-39-5></a><span class=c1>// Generated file (MyMessage.g.cs - auto-created!)</span>
+</span><span id=__span-39-6><a id=__codelineno-39-6 name=__codelineno-39-6 href=#__codelineno-39-6></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>MyMessage</span><span class=w> </span><span class=p>:</span><span class=w> </span><span class=n>IUntargetedMessage</span><span class=o>&lt;</span><span class=n>MyMessage</span><span class=o>&gt;</span>
+</span><span id=__span-39-7><a id=__codelineno-39-7 name=__codelineno-39-7 href=#__codelineno-39-7></a><span class=p>{</span>
+</span><span id=__span-39-8><a id=__codelineno-39-8 name=__codelineno-39-8 href=#__codelineno-39-8></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=n>Type</span><span class=w> </span><span class=n>MessageType</span><span class=w> </span><span class=o>=&gt;</span><span class=w> </span><span class=k>typeof</span><span class=p>(</span><span class=n>MyMessage</span><span class=p>);</span>
+</span><span id=__span-39-9><a id=__codelineno-39-9 name=__codelineno-39-9 href=#__codelineno-39-9></a><span class=p>}</span>
+</span></code></pre></div> <p><strong>Forget <code>partial</code>?</strong> You'll get a compile error: "Type must be partial to use source generators"</p> <h3 id=can-i-see-the-generated-code>"Can I see the generated code?"<a class=headerlink href=#can-i-see-the-generated-code title="Anchor link to this section">&para;</a></h3> <p><strong>Yes!</strong> In Visual Studio/Rider:</p> <ol> <li>Right-click on the message type</li> <li>Select "Go to Implementation" or "Go to Definition"</li> <li>You'll see the auto-generated file</li> </ol> <p><strong>Or</strong> check your <code>obj/</code> folder for <code>.g.cs</code> files.</p> <h3 id=what-if-i-want-custom-constructor-logic_1>"What if I want custom constructor logic?"<a class=headerlink href=#what-if-i-want-custom-constructor-logic_1 title="Anchor link to this section">&para;</a></h3> <p>Keep the attributes and wrap the generated constructor with a helper so you can inject custom logic without losing the source-generated plumbing:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-40-1><a id=__codelineno-40-1 name=__codelineno-40-1 href=#__codelineno-40-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-40-2><a id=__codelineno-40-2 name=__codelineno-40-2 href=#__codelineno-40-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-40-3><a id=__codelineno-40-3 name=__codelineno-40-3 href=#__codelineno-40-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>ComplexMessage</span>
+</span><span id=__span-40-4><a id=__codelineno-40-4 name=__codelineno-40-4 href=#__codelineno-40-4></a><span class=p>{</span>
+</span><span id=__span-40-5><a id=__codelineno-40-5 name=__codelineno-40-5 href=#__codelineno-40-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=k>value</span><span class=p>;</span>
+</span><span id=__span-40-6><a id=__codelineno-40-6 name=__codelineno-40-6 href=#__codelineno-40-6></a>
+</span><span id=__span-40-7><a id=__codelineno-40-7 name=__codelineno-40-7 href=#__codelineno-40-7></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>static</span><span class=w> </span><span class=n>ComplexMessage</span><span class=w> </span><span class=nf>FromRaw</span><span class=p>(</span><span class=kt>int</span><span class=w> </span><span class=n>rawValue</span><span class=p>)</span>
+</span><span id=__span-40-8><a id=__codelineno-40-8 name=__codelineno-40-8 href=#__codelineno-40-8></a><span class=w>    </span><span class=p>{</span>
+</span><span id=__span-40-9><a id=__codelineno-40-9 name=__codelineno-40-9 href=#__codelineno-40-9></a><span class=w>        </span><span class=kt>int</span><span class=w> </span><span class=n>clamped</span><span class=w> </span><span class=o>=</span><span class=w> </span><span class=n>Math</span><span class=p>.</span><span class=n>Clamp</span><span class=p>(</span><span class=n>rawValue</span><span class=p>,</span><span class=w> </span><span class=mi>0</span><span class=p>,</span><span class=w> </span><span class=mi>100</span><span class=p>);</span>
+</span><span id=__span-40-10><a id=__codelineno-40-10 name=__codelineno-40-10 href=#__codelineno-40-10></a><span class=w>        </span><span class=k>return</span><span class=w> </span><span class=k>new</span><span class=w> </span><span class=nf>ComplexMessage</span><span class=p>(</span><span class=n>clamped</span><span class=p>);</span>
+</span><span id=__span-40-11><a id=__codelineno-40-11 name=__codelineno-40-11 href=#__codelineno-40-11></a><span class=w>    </span><span class=p>}</span>
+</span><span id=__span-40-12><a id=__codelineno-40-12 name=__codelineno-40-12 href=#__codelineno-40-12></a><span class=p>}</span>
+</span></code></pre></div> <p>If you truly need to hand-craft the constructor, drop <code>[DxAutoConstructor]</code> for that specific type but keep the <code>[DxUntargetedMessage]</code>/<code>[DxTargetedMessage]</code> attribute so the interface implementation is still generated.</p> <h3 id=do-attributes-affect-runtime-performance>"Do attributes affect runtime performance?"<a class=headerlink href=#do-attributes-affect-runtime-performance title="Anchor link to this section">&para;</a></h3> <p><strong>No!</strong> Source generation happens at <strong>compile time</strong>. Generated code is identical to hand-written code. Zero runtime overhead.</p> <h3 id=can-i-mix-attributes-and-manual-implementation>"Can I mix attributes and manual implementation?"<a class=headerlink href=#can-i-mix-attributes-and-manual-implementation title="Anchor link to this section">&para;</a></h3> <p>Yes. Attribute-driven messages happily coexist with any legacy manual messages or string messages you already emit. Convert types gradually—one message at a time:</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-41-1><a id=__codelineno-41-1 name=__codelineno-41-1 href=#__codelineno-41-1></a><span class=na>[DxUntargetedMessage]</span>
+</span><span id=__span-41-2><a id=__codelineno-41-2 name=__codelineno-41-2 href=#__codelineno-41-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-41-3><a id=__codelineno-41-3 name=__codelineno-41-3 href=#__codelineno-41-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>MessageA</span>
+</span><span id=__span-41-4><a id=__codelineno-41-4 name=__codelineno-41-4 href=#__codelineno-41-4></a><span class=p>{</span>
+</span><span id=__span-41-5><a id=__codelineno-41-5 name=__codelineno-41-5 href=#__codelineno-41-5></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=k>value</span><span class=p>;</span>
+</span><span id=__span-41-6><a id=__codelineno-41-6 name=__codelineno-41-6 href=#__codelineno-41-6></a><span class=p>}</span>
+</span><span id=__span-41-7><a id=__codelineno-41-7 name=__codelineno-41-7 href=#__codelineno-41-7></a>
+</span><span id=__span-41-8><a id=__codelineno-41-8 name=__codelineno-41-8 href=#__codelineno-41-8></a><span class=c1>// Existing manual messages keep working alongside attribute-driven ones.</span>
+</span></code></pre></div> <h2 id=troubleshooting-source-generators>Troubleshooting Source Generators<a class=headerlink href=#troubleshooting-source-generators title="Anchor link to this section">&para;</a></h2> <details class=warning> <summary>Attributes not working / code not generated</summary> <p><strong>Checklist:</strong></p> <ol> <li>✅ Is type marked <code>partial</code>?</li> <li>✅ Did you rebuild the project?</li> <li>✅ Is Unity 2021.3+ (Roslyn source generator support)?</li> <li>✅ Check <code>obj/</code> folder for <code>.g.cs</code> files</li> </ol> <p><strong>Fix:</strong></p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-42-1><a id=__codelineno-42-1 name=__codelineno-42-1 href=#__codelineno-42-1></a><span class=c1>// ❌ Missing partial, will not compile</span>
+</span><span id=__span-42-2><a id=__codelineno-42-2 name=__codelineno-42-2 href=#__codelineno-42-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-42-3><a id=__codelineno-42-3 name=__codelineno-42-3 href=#__codelineno-42-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>MyMsg</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
+</span><span id=__span-42-4><a id=__codelineno-42-4 name=__codelineno-42-4 href=#__codelineno-42-4></a>
+</span><span id=__span-42-5><a id=__codelineno-42-5 name=__codelineno-42-5 href=#__codelineno-42-5></a><span class=c1>// ✅ Correct</span>
+</span><span id=__span-42-6><a id=__codelineno-42-6 name=__codelineno-42-6 href=#__codelineno-42-6></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-42-7><a id=__codelineno-42-7 name=__codelineno-42-7 href=#__codelineno-42-7></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>MyMsg</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
+</span></code></pre></div> </details> <details class=warning> <summary>Constructor not generated</summary> <p><strong>Cause:</strong> No public fields to generate from</p> <div class="language-csharp highlight"><span class=filename>C#</span><pre><span></span><code><span id=__span-43-1><a id=__codelineno-43-1 name=__codelineno-43-1 href=#__codelineno-43-1></a><span class=c1>// ❌ No public fields</span>
+</span><span id=__span-43-2><a id=__codelineno-43-2 name=__codelineno-43-2 href=#__codelineno-43-2></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-43-3><a id=__codelineno-43-3 name=__codelineno-43-3 href=#__codelineno-43-3></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>Empty</span><span class=w> </span><span class=p>{</span><span class=w> </span><span class=p>}</span>
+</span><span id=__span-43-4><a id=__codelineno-43-4 name=__codelineno-43-4 href=#__codelineno-43-4></a>
+</span><span id=__span-43-5><a id=__codelineno-43-5 name=__codelineno-43-5 href=#__codelineno-43-5></a><span class=c1>// ✅ Has public field</span>
+</span><span id=__span-43-6><a id=__codelineno-43-6 name=__codelineno-43-6 href=#__codelineno-43-6></a><span class=na>[DxAutoConstructor]</span>
+</span><span id=__span-43-7><a id=__codelineno-43-7 name=__codelineno-43-7 href=#__codelineno-43-7></a><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=k>partial</span><span class=w> </span><span class=k>struct</span><span class=w> </span><span class=nc>WithData</span><span class=w> </span><span class=p>{</span>
+</span><span id=__span-43-8><a id=__codelineno-43-8 name=__codelineno-43-8 href=#__codelineno-43-8></a><span class=w>    </span><span class=k>public</span><span class=w> </span><span class=k>readonly</span><span class=w> </span><span class=kt>int</span><span class=w> </span><span class=k>value</span><span class=p>;</span>
+</span><span id=__span-43-9><a id=__codelineno-43-9 name=__codelineno-43-9 href=#__codelineno-43-9></a><span class=p>}</span>
+</span></code></pre></div> </details> <details class=warning> <summary>Unity can't find generated code</summary> <p><strong>Solution:</strong></p> <ol> <li>Close Unity</li> <li>Delete <code>Library/</code> folder</li> <li>Reopen Unity</li> <li>Let it reimport everything</li> </ol> </details> <h2 id=related-documentation>Related Documentation<a class=headerlink href=#related-documentation title="Anchor link to this section">&para;</a></h2> <ul> <li><strong><a href=../reference/ >API Reference</a></strong> — Complete API documentation</li> <li><strong><a href=../../concepts/message-types/ >Message Types</a></strong> — When to use Untargeted/Targeted/Broadcast</li> <li><strong><a href=../quick-reference/ >Quick Reference</a></strong> — Cheat sheet</li> <li><strong><a href=../../architecture/design-and-architecture/ >Design &amp; Architecture</a></strong> — How source generation works internally</li> </ul> <h2 id=summary>Summary<a class=headerlink href=#summary title="Anchor link to this section">&para;</a></h2> <h3 id=source-generators--code-wizards-that-write-boilerplate-for-you>Source generators = Code wizards that write boilerplate for you<a class=headerlink href=#source-generators--code-wizards-that-write-boilerplate-for-you title="Anchor link to this section">&para;</a></h3> <h4 id=use-attributes-for>Use attributes for<a class=headerlink href=#use-attributes-for title="Anchor link to this section">&para;</a></h4> <ul> <li>✅ Clean, maintainable code</li> <li>✅ Automatic constructor generation</li> <li>✅ Zero boilerplate</li> <li>✅ Refactor safety</li> </ul> <h5 id=use-manual-implementation-for>Use manual implementation for<a class=headerlink href=#use-manual-implementation-for title="Anchor link to this section">&para;</a></h5> <ul> <li>✅ Custom constructor logic</li> <li>✅ Explicit control</li> <li>✅ Understanding exactly what happens</li> </ul> <p><strong>Recommendation:</strong> Start with attributes (they cover most cases), switch to manual only when needed.</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 26, 2026 18:15:02 UTC"><span class=timeago datetime=2026-01-26T18:15:02+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 26, 2026 18:15:02 UTC">2026-01-26</span> </span> <span class=md-source-file__fact> <span class=md-icon title=Created> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M14.47 15.08 11 13V7h1.5v5.25l3.08 1.83c-.41.28-.79.62-1.11 1m-1.39 4.84c-.36.05-.71.08-1.08.08-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8c0 .37-.03.72-.08 1.08.69.1 1.33.32 1.92.64.1-.56.16-1.13.16-1.72 0-5.5-4.5-10-10-10S2 6.5 2 12s4.47 10 10 10c.59 0 1.16-.06 1.72-.16-.32-.59-.54-1.23-.64-1.92M18 15v3h-3v2h3v3h2v-3h3v-2h-3v-3z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-timeago" title="January 26, 2026 18:15:02 UTC"><span class=timeago datetime=2026-01-26T18:15:02+00:00 locale=en></span></span><span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-iso_date" title="January 26, 2026 18:15:02 UTC">2026-01-26</span> </span> </aside> </article> </div> <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg> Back to top </button> </main> <footer class=md-footer> <nav class="md-footer__inner md-grid" aria-label=Footer> <a href=../quick-reference/ class="md-footer__link md-footer__link--prev" aria-label="Previous: Quick Reference"> <div class="md-footer__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </div> <div class=md-footer__title> <span class=md-footer__direction> Previous </span> <div class=md-ellipsis> Quick Reference </div> </div> </a> <a href=../faq/ class="md-footer__link md-footer__link--next" aria-label="Next: FAQ"> <div class=md-footer__title> <span class=md-footer__direction> Next </span> <div class=md-ellipsis> FAQ </div> </div> <div class="md-footer__button md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg> </div> </a> </nav> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> <div class=md-copyright__highlight> Copyright &copy; 2017-2026 Wallstop Studios </div> </div> <div class=md-social> <a href=https://github.com/wallstop target=_blank rel=noopener title="Wallstop Studios on GitHub" class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg> </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-progress data-md-component=progress role=progressbar></div> <script id=__config type=application/json>{"annotate": null, "base": "../..", "features": ["announce.dismiss", "content.action.edit", "content.action.view", "content.code.annotate", "content.code.copy", "content.tabs.link", "navigation.expand", "navigation.footer", "navigation.indexes", "navigation.instant", "navigation.instant.prefetch", "navigation.instant.progress", "navigation.path", "navigation.sections", "navigation.tabs", "navigation.tabs.sticky", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script> <script src=../../assets/javascripts/bundle.79ae519e.min.js></script> <script src=../../js/timeago.min.js></script> <script src=../../js/timeago_mkdocs_material.js></script> <script src=https://unpkg.com/mermaid@11/dist/mermaid.min.js></script> <script src=../../javascripts/mermaid-config.js></script> <script src=../../javascripts/csharp-highlight.js></script> </body> </html>