@trackunit/iris-app-sdk-vite 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+## 0.0.2 (2026-02-18)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 1.12.41
+- Updated iris-app-api to 1.14.38

package/LICENSE.txt

@@ -0,0 +1,191 @@
+Copyright 2023 Trackunit.
+
+Trackunit® Software Development Kit (“Trackunit SDK”) 
+License Agreement
+
+THIS IS A LICENSE AGREEMENT BETWEEN YOU AND TRACKUNIT APS (“TRACKUNIT”). BEFORE YOU USE THE TRACKUNIT SDK, PLEASE READ ALL OF THE TERMS AND CONDITIONS SET OUT IN THIS LICENSE AGREEMENT (THIS “AGREEMENT”) CAREFULLY. YOUR USE OF THE TRACKUNIT SDK IS SUBJECT TO THE TERMS AND CONDITIONS SET FORTH IN THIS AGREEMENT. BY CLICKING THE “I AGREE” BUTTON OR BY USING ANY PART OF THE TRACKUNIT SDK, YOU AGREE (ON BEHALF OF YOURSELF AND/OR YOUR COMPANY) TO THE TERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT OR CANNOT AGREE TO THE TERMS AND CONDITIONS OF THIS AGREEMENT, YOU MUST NOT DOWNLOAD OR USE THE TRACKUNIT SDK.
+
+1.  License Granted:  Trackunit hereby grants to You a non-exclusive, non-transferable, revocable, royalty-free worldwide license to use the Trackunit SDK in accordance with the terms and conditions of this Agreement.
+
+2.  Use Rights:  Subject to the restrictions below, you may use the Trackunit SDK for the purpose of creating software that communicates with Trackunit Products (“Developer Software”). You are permitted to re-distribute, modify, or create derivative works as part of your Developer Software for non-commercial or commercial use.  Open source software components provided with the Trackunit SDK are licensed to you under the terms of the applicable license agreements included with such open source software components. The applicable open source software licenses are listed in Appendix A.  
+
+3.  Restrictions:  You agree that you will not (1) use the Trackunit SDK to create, design or develop anything other than Developer Software; (2) make any more copies of the Trackunit SDK than are reasonably necessary for the authorized use and backup and archival purposes; (3) modify, create derivative works of, reverse engineer, reverse compile, or disassemble the Trackunit SDK except as expressly permitted in Section 2; or (4) distribute, sell, lease, rent, or lend any part of the Trackunit SDK to any third party except as expressly permitted in Section 2.
+
+4.  Title and Interest: Trackunit retains ownership of the Trackunit SDK and all intellectual property rights embodied in the Trackunit SDK, including without limitation all copyrights, trade secrets and patents. You may not remove, delete or modify any of Trackunit’s copyright statements in the Trackunit SDK.  ALL RIGHTS NOT EXPRESSLY GRANTED HEREUNDER ARE RESERVED TO TRACKUNIT.
+
+5.  Trademarks: You may not use Trackunit’s name, trademarks or service marks in connection with your Developer Software in a way that suggests your Developer Software is certified or endorsed by Trackunit. 
+
+6.  Term and Termination: This Agreement shall continue as long as you are in compliance with the terms of this Agreement or until otherwise terminated.  Either party may terminate this Agreement for any reason at any time.  You agree, upon termination, to destroy all copies of the Trackunit SDK within your possession or control. 
+
+7.  Confidential Information: “Confidential Information” means any information disclosed by Trackunit to you pursuant to this Agreement that is marked “Confidential,” “Proprietary,” or in some similar manner and any information which you knew or reasonably should have known to be confidential.  You shall treat as confidential all Confidential Information and shall not use such Confidential Information except to exercise your rights or perform your obligations under this Agreement.  You will protect Confidential Information from unauthorized use, access, or disclosure in the same manner as you protect your own confidential or proprietary information of a similar nature but with no less than reasonable care.  You shall not disclose such Confidential Information to any third party during or after the term of this Agreement.  This paragraph will not apply to any Confidential Information that: (a) was rightfully in your possession prior to receipt of such Confidential Information from Trackunit; (b) is or becomes a matter of public knowledge through no fault of you; (c) is rightfully received from a third party without a duty of confidentiality; (d) is independently developed by you without breach of any confidentiality obligations; (e) is disclosed by you with Trackunit’s prior written approval; or (f) you are required to disclose by applicable law or court order, provided that you notify Trackunit of such required disclosure promptly in writing and cooperate with Trackunit in any lawful action to contest or limit the scope of such required disclosure.  You acknowledge that breach of this Section 7 will cause irreparable damage to Trackunit for which monetary damages will be an inadequate remedy.   Accordingly, Trackunit will be entitled to seek and obtain injunctive and any other relief (legal or equitable) to restrain any breach or anticipated breach of this Section 7.
+
+8.  Warranty and Limitation of Liability:  THE TRACKUNIT SDK IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND. TRACKUNIT DOES NOT WARRANT THAT THE USE OF THE TRACKUNIT SDK WILL NOT INFRINGE ANY THIRD PARTY’S INTELLECTUAL PROPERTY RIGHTS. TRACKUNIT DOES NOT WARRANT THAT THE TRACKUNIT SDK IS ERROR FREE AND MAKES NO WARRANTIES, EXPRESS OR IMPLIED, WITH RESPECT TO THE TRACKUNIT SDK, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL TRACKUNIT BE LIABLE FOR PERSONAL INJURY OR ANY INCIDENTAL, SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES WHATSOEVER, OR FOR LOSS OF PROFITS, LOSS OF DATA, BUSINESS INTERRUPTION, OR FOR ANY PECUNIARY DAMAGES OR LOSSES, ARISING OUT OF OR RELATED TO YOUR GRANT OF LICENSE HEREIN OR OTHERWISE ARISING OUT OF THE USE OF THE TRACKUNIT SDK, OR IN CONNECTION WITH ANY PROVISION OF THIS AGREEMENT, HOWEVER CAUSED, REGARDLESS OF THE THEORY OF LIABILITY (CONTRACT, TORT OR OTHERWISE) AND EVEN IF TRACKUNIT HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+9.  Indemnification: You agree to defend, indemnify and hold harmless Trackunit, and any of its directors, officers, employees, affiliates and agents, from and against any and all claims, losses, damages, liabilities and other expenses (including reasonable attorneys’ fees), arising from the distribution or use of the Developer Software by you or anyone else, or your breach of this Agreement.
+
+10.  Data Privacy: You shall at all times uphold applicable legislation, any violation of applicable legislation relating to Data Privacy, shall be regarded as a breach of this Agreement, and any license given under this Agreement shall be deemed as revoked. 
+
+11.  General Terms: These terms are governed by the laws of Denmark without regard to conflict of laws principles.  The United Nations Convention for the International Sale of Goods shall not apply.  You may not assign this Agreement in whole or in part. Any attempted assignment by You shall be void. This Agreement constitutes the entire agreement between You and Trackunit with respect to the subject matter hereof and supersedes all prior written or oral communications, understandings and agreements. Any waiver of these terms must be in writing and signed by the waiving party to be effective. If any provision of these terms is found to be invalid or unenforceable, the remaining terms will continue to be valid and enforceable to the fullest extent permitted by law. 
+
+APPENDIX A
+Open Source Software Licenses
+
+IMPORTANT READ CAREFULLY
+The applicable open source licenses are identified below. You agree to comply with all such licenses. If you do not agree to such terms and conditions, you may not install, download, or otherwise use the Trackunit SDK.
+
+Apache License
+Version 2.0, January 2004
+
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+•	1. Definitions.
+"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
+"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
+"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
+"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
+"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
+"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
+"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
+"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
+2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
+3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
+4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
+(a) You must give any other recipients of the Work or Derivative Works a copy of this License; and
+(b) You must cause any modified files to carry prominent notices stating that You changed the files; and
+(c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
+(d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.
+You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
+5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
+6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
+8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
+9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
+END OF TERMS AND CONDITIONS 
+
+MIT License
+https://opensource.org/licenses/MIT
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+ISC License
+https://www.isc.org/licenses/
+Permission to use, copy, modify, and /or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+The Unlicense
+
+https://unlicense.org/
+
+This is free and unencumbered software released into the public domain.
+Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
+In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+BSD-3-Clause 
+https://opensource.org/licenses/BSD-3-Clause
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+BSD-2-Clause
+
+https://opensource.org/licenses/BSD-2-Clause
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+Creative Commons Zero v1.0 Universal
+https://creativecommons.org/publicdomain/zero/1.0/legalcode
+Creative Commons Legal Code
+CC0 1.0 Universal
+CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED HEREUNDER.
+Statement of Purpose
+The laws of most jurisdictions throughout the world automatically confer exclusive Copyright and Related Rights (defined below) upon the creator and subsequent owner(s) (each and all, an "owner") of an original work of authorship and/or a database (each, a "Work").
+Certain owners wish to permanently relinquish those rights to a Work for the purpose of contributing to a commons of creative, cultural and scientific works ("Commons") that the public can reliably and without fear of later claims of infringement build upon, modify, incorporate in other works, reuse and redistribute as freely as possible in any form whatsoever and for any purposes, including without limitation commercial purposes. These owners may contribute to the Commons to promote the ideal of a free culture and the further production of creative, cultural and scientific works, or to gain reputation or greater distribution for their Work in part through the use and efforts of others.
+For these and/or other purposes and motivations, and without any expectation of additional consideration or compensation, the person associating CC0 with a Work (the "Affirmer"), to the extent that he or she is an owner of Copyright and Related Rights in the Work, voluntarily elects to apply CC0 to the Work and publicly distribute the Work under its terms, with knowledge of his or her Copyright and Related Rights in the Work and the meaning and intended legal effect of CC0 on those rights.
+1. Copyright and Related Rights. A Work made available under CC0 may be protected by copyright and related or neighboring rights ("Copyright and Related Rights"). Copyright and Related Rights include, but are not limited to, the following:
+i. the right to reproduce, adapt, distribute, perform, display, communicate, and translate a Work;
+ii. moral rights retained by the original author(s) and/or performer(s);
+iii. publicity and privacy rights pertaining to a person's image or likeness depicted in a Work;
+iv. rights protecting against unfair competition in regards to a Work, subject to the limitations in paragraph 4(a), below;
+v. rights protecting the extraction, dissemination, use and reuse of data in a Work;
+vi. database rights (such as those arising under Directive 96/9/EC of the European Parliament and of the Council of 11 March 1996 on the legal protection of databases, and under any national implementation thereof, including any amended or successor version of such directive); and
+vii. other similar, equivalent or corresponding rights throughout the world based on applicable law or treaty, and any national implementations thereof.
+2. Waiver. To the greatest extent permitted by, but not in contravention of, applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and unconditionally waives, abandons, and surrenders all of Affirmer's Copyright and Related Rights and associated claims and causes of action, whether now known or unknown (including existing as well as future claims and causes of action), in the Work (i) in all territories worldwide, (ii) for the maximum duration provided by applicable law or treaty (including future time extensions), (iii) in any current or future medium and for any number of copies, and (iv) for any purpose whatsoever, including without limitation commercial, advertising or promotional purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each member of the public at large and to the detriment of Affirmer's heirs and successors, fully intending that such Waiver shall not be subject to revocation, rescission, cancellation, termination, or any other legal or equitable action to disrupt the quiet enjoyment of the Work by the public as contemplated by Affirmer's express Statement of Purpose.
+3. Public License Fallback. Should any part of the Waiver for any reason be judged legally invalid or ineffective under applicable law, then the Waiver shall be preserved to the maximum extent permitted taking into account Affirmer's express Statement of Purpose. In addition, to the extent the Waiver is so judged Affirmer hereby grants to each affected person a royalty-free, non transferable, non sublicensable, non exclusive, irrevocable and unconditional license to exercise Affirmer's Copyright and Related Rights in the Work (i) in all territories worldwide, (ii) for the maximum duration provided by applicable law or treaty (including future time extensions), (iii) in any current or future medium and for any number of copies, and (iv) for any purpose whatsoever, including without limitation commercial, advertising or promotional purposes (the "License"). The License shall be deemed effective as of the date CC0 was applied by Affirmer to the Work. Should any part of the License for any reason be judged legally invalid or ineffective under applicable law, such partial invalidity or ineffectiveness shall not invalidate the remainder of the License, and in such case Affirmer hereby affirms that he or she will not (i) exercise any of his or her remaining Copyright and Related Rights in the Work or (ii) assert any associated claims and causes of action with respect to the Work, in either case contrary to Affirmer's express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+a. No trademark or patent rights held by Affirmer are waived, abandoned, surrendered, licensed or otherwise affected by this document.
+b. Affirmer offers the Work as-is and makes no representations or warranties of any kind concerning the Work, express, implied, statutory or otherwise, including without limitation warranties of title, merchantability, fitness for a particular purpose, non infringement, or the absence of latent or other defects, accuracy, or the present or absence of errors, whether or not discoverable, all to the greatest extent permissible under applicable law.
+c. Affirmer disclaims responsibility for clearing rights of other persons that may apply to the Work or any use thereof, including without limitation any person's Copyright and Related Rights in the Work. Further, Affirmer disclaims responsibility for obtaining any necessary consents, permissions or other rights required for any use of the Work.
+d. Affirmer understands and acknowledges that Creative Commons is not a party to this document and has no duty or obligation with respect to this CC0 or use of the Work.
+
+
+Creative Commons Attribution 3.0 Unported
+https://creativecommons.org/licenses/by/3.0/legalcode
+CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE LEGAL SERVICES. DISTRIBUTION OF THIS LICENSE DOES NOT CREATE AN ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES REGARDING THE INFORMATION PROVIDED, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM ITS USE.
+License
+THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
+BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS LICENSE MAY BE CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.
+1. Definitions
+a. "Adaptation" means a work based upon the Work, or upon the Work and other pre-existing works, such as a translation, adaptation, derivative work, arrangement of music or other alterations of a literary or artistic work, or phonogram or performance and includes cinematographic adaptations or any other form in which the Work may be recast, transformed, or adapted including in any form recognizably derived from the original, except that a work that constitutes a Collection will not be considered an Adaptation for the purpose of this License. For the avoidance of doubt, where the Work is a musical work, performance or phonogram, the synchronization of the Work in timed-relation with a moving image ("synching") will be considered an Adaptation for the purpose of this License.
+b. "Collection" means a collection of literary or artistic works, such as encyclopedias and anthologies, or performances, phonograms or broadcasts, or other works or subject matter other than works listed in Section 1(f) below, which, by reason of the selection and arrangement of their contents, constitute intellectual creations, in which the Work is included in its entirety in unmodified form along with one or more other contributions, each constituting separate and independent works in themselves, which together are assembled into a collective whole. A work that constitutes a Collection will not be considered an Adaptation (as defined above) for the purposes of this License.
+c. "Distribute" means to make available to the public the original and copies of the Work or Adaptation, as appropriate, through sale or other transfer of ownership.
+d. "Licensor" means the individual, individuals, entity or entities that offer(s) the Work under the terms of this License.
+e. "Original Author" means, in the case of a literary or artistic work, the individual, individuals, entity or entities who created the Work or if no individual or entity can be identified, the publisher; and in addition (i) in the case of a performance the actors, singers, musicians, dancers, and other persons who act, sing, deliver, declaim, play in, interpret or otherwise perform literary or artistic works or expressions of folklore; (ii) in the case of a phonogram the producer being the person or legal entity who first fixes the sounds of a performance or other sounds; and, (iii) in the case of broadcasts, the organization that transmits the broadcast.
+f. "Work" means the literary and/or artistic work offered under the terms of this License including without limitation any production in the literary, scientific and artistic domain, whatever may be the mode or form of its expression including digital form, such as a book, pamphlet and other writing; a lecture, address, sermon or other work of the same nature; a dramatic or dramatico-musical work; a choreographic work or entertainment in dumb show; a musical composition with or without words; a cinematographic work to which are assimilated works expressed by a process analogous to cinematography; a work of drawing, painting, architecture, sculpture, engraving or lithography; a photographic work to which are assimilated works expressed by a process analogous to photography; a work of applied art; an illustration, map, plan, sketch or three-dimensional work relative to geography, topography, architecture or science; a performance; a broadcast; a phonogram; a compilation of data to the extent it is protected as a copyrightable work; or a work performed by a variety or circus performer to the extent it is not otherwise considered a literary or artistic work.
+g. "You" means an individual or entity exercising rights under this License who has not previously violated the terms of this License with respect to the Work, or who has received express permission from the Licensor to exercise rights under this License despite a previous violation.
+h. "Publicly Perform" means to perform public recitations of the Work and to communicate to the public those public recitations, by any means or process, including by wire or wireless means or public digital performances; to make available to the public Works in such a way that members of the public may access these Works from a place and at a place individually chosen by them; to perform the Work to the public by any means or process and the communication to the public of the performances of the Work, including by public digital performance; to broadcast and rebroadcast the Work by any means including signs, sounds or images.
+i. "Reproduce" means to make copies of the Work by any means including without limitation by sound or visual recordings and the right of fixation and reproducing fixations of the Work, including storage of a protected performance or phonogram in digital form or other electronic medium.
+2. Fair Dealing Rights. Nothing in this License is intended to reduce, limit, or restrict any uses free from copyright or rights arising from limitations or exceptions that are provided for in connection with the copyright protection under copyright law or other applicable laws.
+3. License Grant. Subject to the terms and conditions of this License, Licensor hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the duration of the applicable copyright) license to exercise the rights in the Work as stated below:
+a. to Reproduce the Work, to incorporate the Work into one or more Collections, and to Reproduce the Work as incorporated in the Collections;
+b. to create and Reproduce Adaptations provided that any such Adaptation, including any translation in any medium, takes reasonable steps to clearly label, demarcate or otherwise identify that changes were made to the original Work. For example, a translation could be marked "The original work was translated from English to Spanish," or a modification could indicate "The original work has been modified.";
+c. to Distribute and Publicly Perform the Work including as incorporated in Collections; and,
+d. to Distribute and Publicly Perform Adaptations.
+e. For the avoidance of doubt:
+i. Non-waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme cannot be waived, the Licensor reserves the exclusive right to collect such royalties for any exercise by You of the rights granted under this License;
+ii. Waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme can be waived, the Licensor waives the exclusive right to collect such royalties for any exercise by You of the rights granted under this License; and,
+iii. Voluntary License Schemes. The Licensor waives the right to collect royalties, whether individually or, in the event that the Licensor is a member of a collecting society that administers voluntary licensing schemes, via that society, from any exercise by You of the rights granted under this License.
+The above rights may be exercised in all media and formats whether now known or hereafter devised. The above rights include the right to make such modifications as are technically necessary to exercise the rights in other media and formats. Subject to Section 8(f), all rights not expressly granted by Licensor are hereby reserved.
+4. Restrictions. The license granted in Section 3 above is expressly made subject to and limited by the following restrictions:
+a. You may Distribute or Publicly Perform the Work only under the terms of this License. You must include a copy of, or the Uniform Resource Identifier (URI) for, this License with every copy of the Work You Distribute or Publicly Perform. You may not offer or impose any terms on the Work that restrict the terms of this License or the ability of the recipient of the Work to exercise the rights granted to that recipient under the terms of the License. You may not sublicense the Work. You must keep intact all notices that refer to this License and to the disclaimer of warranties with every copy of the Work You Distribute or Publicly Perform. When You Distribute or Publicly Perform the Work, You may not impose any effective technological measures on the Work that restrict the ability of a recipient of the Work from You to exercise the rights granted to that recipient under the terms of the License. This Section 4(a) applies to the Work as incorporated in a Collection, but this does not require the Collection apart from the Work itself to be made subject to the terms of this License. If You create a Collection, upon notice from any Licensor You must, to the extent practicable, remove from the Collection any credit as required by Section 4(b), as requested. If You create an Adaptation, upon notice from any Licensor You must, to the extent practicable, remove from the Adaptation any credit as required by Section 4(b), as requested.
+b. If You Distribute, or Publicly Perform the Work or any Adaptations or Collections, You must, unless a request has been made pursuant to Section 4(a), keep intact all copyright notices for the Work and provide, reasonable to the medium or means You are utilizing: (i) the name of the Original Author (or pseudonym, if applicable) if supplied, and/or if the Original Author and/or Licensor designate another party or parties (e.g., a sponsor institute, publishing entity, journal) for attribution ("Attribution Parties") in Licensor's copyright notice, terms of service or by other reasonable means, the name of such party or parties; (ii) the title of the Work if supplied; (iii) to the extent reasonably practicable, the URI, if any, that Licensor specifies to be associated with the Work, unless such URI does not refer to the copyright notice or licensing information for the Work; and (iv), consistent with Section 3(b), in the case of an Adaptation, a credit identifying the use of the Work in the Adaptation (e.g., "French translation of the Work by Original Author," or "Screenplay based on original Work by Original Author"). The credit required by this Section 4 (b) may be implemented in any reasonable manner; provided, however, that in the case of a Adaptation or Collection, at a minimum such credit will appear, if a credit for all contributing authors of the Adaptation or Collection appears, then as part of these credits and in a manner at least as prominent as the credits for the other contributing authors. For the avoidance of doubt, You may only use the credit required by this Section for the purpose of attribution in the manner set out above and, by exercising Your rights under this License, You may not implicitly or explicitly assert or imply any connection with, sponsorship or endorsement by the Original Author, Licensor and/or Attribution Parties, as appropriate, of You or Your use of the Work, without the separate, express prior written permission of the Original Author, Licensor and/or Attribution Parties.
+c. Except as otherwise agreed in writing by the Licensor or as may be otherwise permitted by applicable law, if You Reproduce, Distribute or Publicly Perform the Work either by itself or as part of any Adaptations or Collections, You must not distort, mutilate, modify or take other derogatory action in relation to the Work which would be prejudicial to the Original Author's honor or reputation. Licensor agrees that in those jurisdictions (e.g. Japan), in which any exercise of the right granted in Section 3(b) of this License (the right to make Adaptations) would be deemed to be a distortion, mutilation, modification or other derogatory action prejudicial to the Original Author's honor and reputation, the Licensor will waive or not assert, as appropriate, this Section, to the fullest extent permitted by the applicable national law, to enable You to reasonably exercise Your right under Section 3(b) of this License (right to make Adaptations) but not otherwise. 
+5. Representations, Warranties and Disclaimer
+UNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING, LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.
+6. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+7. Termination
+a. This License and the rights granted hereunder will terminate automatically upon any breach by You of the terms of this License. Individuals or entities who have received Adaptations or Collections from You under this License, however, will not have their licenses terminated provided such individuals or entities remain in full compliance with those licenses. Sections 1, 2, 5, 6, 7, and 8 will survive any termination of this License.
+b. Subject to the above terms and conditions, the license granted here is perpetual (for the duration of the applicable copyright in the Work). Notwithstanding the above, Licensor reserves the right to release the Work under different license terms or to stop distributing the Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been, or is required to be, granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.
+8. Miscellaneous
+a. Each time You Distribute or Publicly Perform the Work or a Collection, the Licensor offers to the recipient a license to the Work on the same terms and conditions as the license granted to You under this License.
+b. Each time You Distribute or Publicly Perform an Adaptation, Licensor offers to the recipient a license to the original Work on the same terms and conditions as the license granted to You under this License.
+c. If any provision of this License is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this License, and without further action by the parties to this agreement, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.
+d. No term or provision of this License shall be deemed waived and no breach consented to unless such waiver or consent shall be in writing and signed by the party to be charged with such waiver or consent. This License constitutes the entire agreement between the parties with respect to the Work licensed here. There are no understandings, agreements or representations with respect to the Work not specified here. Licensor shall not be bound by any additional provisions that may appear in any communication from You.
+e. This License may not be modified without the mutual written agreement of the Licensor and You.
+f. The rights granted under, and the subject matter referenced, in this License were drafted utilizing the terminology of the Berne Convention for the Protection of Literary and Artistic Works (as amended on September 28, 1979), the Rome Convention of 1961, the WIPO Copyright Treaty of 1996, the WIPO Performances and Phonograms Treaty of 1996 and the Universal Copyright Convention (as revised on July 24, 1971). These rights and subject matter take effect in the relevant jurisdiction in which the License terms are sought to be enforced according to the corresponding provisions of the implementation of those treaty provisions in the applicable national law. If the standard suite of rights granted under applicable copyright law includes additional rights not granted under this License, such additional rights are deemed to be included in the License; this License is not intended to restrict the license of any rights under applicable law.
+Creative Commons Notice
+Creative Commons is not a party to this License, and makes no warranty whatsoever in connection with the Work. Creative Commons will not be liable to You or any party on any legal theory for any damages whatsoever, including without limitation any general, special, incidental or consequential damages arising in connection to this license. Notwithstanding the foregoing two (2) sentences, if Creative Commons has expressly identified itself as the Licensor hereunder, it shall have all rights and obligations of Licensor.
+Except for the limited purpose of indicating to the public that the Work is licensed under the CCPL, Creative Commons does not authorize the use by either party of the trademark "Creative Commons" or any related trademark or logo of Creative Commons without the prior written consent of Creative Commons. Any permitted use will be in compliance with Creative Commons' then-current trademark usage guidelines, as may be published on its website or otherwise made available upon request from time to time. For the avoidance of doubt, this trademark restriction does not form part of this License.
+
+
+BSD Zero Clause License
+https://opensource.org/licenses/0BSD
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,213 @@
+# @trackunit/iris-app-sdk-vite
+
+Custom NX executors for building and serving Iris Apps using Vite.
+
+Trackunit Iris App SDK are used by developers to integrate custom functionality into [the Trackunit Manager platform](https://www.trackunit.com/services/manager/).
+
+For more info and a full guide on Iris App SDK Development, please visit our [Developer Hub](https://developers.trackunit.com/).
+
+## Installation
+
+This package is included as part of the Iris App SDK. Run through the getting started guide here: [Getting Started](https://developers.trackunit.com/docs/getting-started)
+
+## Usage
+
+### Serve Executor
+
+Start the Vite dev server for your Iris App:
+
+```bash
+nx run your-app:serve
+```
+
+Add to your `project.json`:
+
+```json
+{
+  "targets": {
+    "serve": {
+      "executor": "@trackunit/iris-app-sdk-vite:serve",
+      "options": {}
+    }
+  }
+}
+```
+
+### Build Executor
+
+Build your Iris App for production:
+
+```bash
+nx run your-app:build
+```
+
+Add to your `project.json`:
+
+```json
+{
+  "targets": {
+    "build": {
+      "executor": "@trackunit/iris-app-sdk-vite:build",
+      "options": {
+        "outputPath": "dist/apps/your-app"
+      },
+      "outputs": ["{options.outputPath}"]
+    }
+  }
+}
+```
+
+## Configuration Options
+
+### Serve Options
+
+| Option       | Type   | Required | Description                                             |
+| ------------ | ------ | -------- | ------------------------------------------------------- |
+| `port`       | number | No       | Dev server port (default: auto-select from 22220-22229) |
+| `host`       | string | No       | Dev server host (default: "localhost")                  |
+| `viteConfig` | string | No       | Path to optional custom vite config file for overrides  |
+
+### Build Options
+
+| Option       | Type   | Required | Description                                            |
+| ------------ | ------ | -------- | ------------------------------------------------------ |
+| `outputPath` | string | Yes      | Output directory for the build                         |
+| `viteConfig` | string | No       | Path to optional custom vite config file for overrides |
+
+## Custom Vite Configuration
+
+By default, no `vite.config.ts` file is required - the executor automatically handles everything based on your `iris-app-manifest.ts`.
+
+If you need to customize the Vite config, create a `vite.config.ts` file in your app directory:
+
+```typescript
+import type { UserConfig } from "vite";
+
+export default async (defaultConfig: UserConfig): Promise<UserConfig> => {
+  return {
+    ...defaultConfig,
+    // Your customizations here
+    // Example: Add custom plugins
+    plugins: [...(defaultConfig.plugins ?? []), myCustomPlugin()],
+  };
+};
+```
+
+Then reference it in your `project.json`:
+
+```json
+{
+  "targets": {
+    "build": {
+      "executor": "@trackunit/iris-app-sdk-vite:build",
+      "options": {
+        "outputPath": "dist/apps/your-app",
+        "viteConfig": "apps/your-app/vite.config.ts"
+      }
+    },
+    "serve": {
+      "executor": "@trackunit/iris-app-sdk-vite:serve",
+      "options": {
+        "viteConfig": "apps/your-app/vite.config.ts"
+      }
+    }
+  }
+}
+```
+
+**Note:** Your custom config function receives the default config with all Iris App plugins already applied. You should spread the default config to preserve the required functionality.
+
+## Migration from @nx/vite
+
+If you were using `@nx/vite` executors directly, update your `project.json` to use these executors instead:
+
+**Before:**
+
+```json
+{
+  "targets": {
+    "build": {
+      "executor": "@nx/vite:build",
+      "options": {
+        "outputPath": "dist/apps/your-app"
+      }
+    },
+    "serve": {
+      "executor": "@nx/vite:dev-server",
+      "options": {}
+    }
+  }
+}
+```
+
+**After:**
+
+```json
+{
+  "targets": {
+    "build": {
+      "executor": "@trackunit/iris-app-sdk-vite:build",
+      "options": {
+        "outputPath": "dist/apps/your-app"
+      }
+    },
+    "serve": {
+      "executor": "@trackunit/iris-app-sdk-vite:serve",
+      "options": {}
+    }
+  }
+}
+```
+
+### Key Differences
+
+These executors solve the tsconfig paths resolution problem that occurs when using Vite directly:
+
+1. **Automatic tsconfig paths registration** - Registers tsconfig paths before loading any modules
+2. **Automatic manifest loading** - Loads your `iris-app-manifest.ts` automatically
+3. **Pre-configured plugins** - Applies all required Iris App Vite plugins automatically
+4. **No config file required** - The executor handles everything based on your manifest
+
+## Debugging
+
+### Verbose Mode
+
+Run with the `--verbose` flag to see detailed configuration information:
+
+```bash
+nx run your-app:serve --verbose
+nx run your-app:build --verbose
+```
+
+This will output the Vite plugins configuration being used.
+
+### React DevTools
+
+Run a global install of [react-devtools](https://www.npmjs.com/package/react-devtools).
+
+With volta:
+
+```bash
+volta install react-devtools
+```
+
+Run react-devtools from the terminal to launch the standalone DevTools app:
+
+```bash
+react-devtools
+```
+
+React-devtools will automatically connect to whichever Iris App is running in your browser.
+
+### Common Issues
+
+**"Failed to resolve dependency" warnings**
+
+These warnings during development are typically harmless and occur during Vite's dependency pre-bundling. If your app loads correctly, they can be ignored.
+
+## Trackunit
+
+This package was developed by Trackunit ApS.
+Trackunit is the leading SaaS-based IoT solution for the construction industry, offering an ecosystem of hardware, fleet management software & telematics.
+
+![The Trackunit logo](https://trackunit.com/wp-content/uploads/2022/03/top-logo.svg)

package/executors.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "executors": {
+    "serve": {
+      "implementation": "./src/executors/serve/executor",
+      "schema": "./src/executors/serve/schema.json",
+      "description": "Serve Iris App using Vite dev server"
+    },
+    "build": {
+      "implementation": "./src/executors/build/executor",
+      "schema": "./src/executors/build/schema.json",
+      "description": "Build Iris App using Vite"
+    }
+  }
+}
+

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@trackunit/iris-app-sdk-vite",
+  "version": "0.0.2",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "repository": "https://github.com/Trackunit/manager",
+  "executors": "./executors.json",
+  "engines": {
+    "node": ">=24.x"
+  },
+  "dependencies": {
+    "@nx/devkit": "22.0.4",
+    "rxjs": "7.8.1",
+    "win-ca": "^3.5.1",
+    "@trackunit/iris-app-build-utilities": "1.12.41",
+    "@trackunit/iris-app-api": "1.14.38",
+    "tslib": "^2.6.2",
+    "vite": "7.3.1"
+  },
+  "types": "./src/index.d.ts",
+  "main": "./src/index.js",
+  "type": "commonjs"
+}

package/src/executors/build/executor.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = buildExecutor;
+const tslib_1 = require("tslib");
+const rxjs_for_await_1 = require("@nx/devkit/src/utils/rxjs-for-await");
+const iris_app_build_utilities_1 = require("@trackunit/iris-app-build-utilities");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const rxjs_1 = require("rxjs");
+const op = tslib_1.__importStar(require("rxjs/operators"));
+require("win-ca");
+const defaultViteConfig_1 = require("../utils/defaultViteConfig");
+const deleteOutputDir = (root, outputPath) => {
+    const resolvedOutputPath = (0, path_1.resolve)(root, outputPath);
+    if (resolvedOutputPath === root) {
+        throw new Error("Output path MUST not be project root directory!");
+    }
+    (0, fs_1.rmSync)(resolvedOutputPath, { recursive: true, force: true });
+};
+/**
+ * Build executor for building Iris Apps with Vite.
+ *
+ * @param {BuildExecutorSchema} options build executor options for this nx executor
+ * @param {ExecutorContext} context build executor context for this nx executor
+ * @yields {NodeBuildEvent} the build event
+ */
+async function* buildExecutor(options, context) {
+    await (0, iris_app_build_utilities_1.checkPackageVersion)(false);
+    // eslint-disable-next-line local-rules/no-typescript-assertion, @typescript-eslint/no-non-null-assertion
+    const projectRoot = context.projectsConfigurations.projects[context.projectName].root;
+    const projectRootDir = (0, path_1.join)(context.root, projectRoot);
+    const manifestPath = (0, path_1.join)(context.root, projectRoot, "iris-app-manifest.ts");
+    // ✅ CRITICAL: Register tsconfig paths BEFORE any @trackunit/* imports
+    (0, iris_app_build_utilities_1.enableTsConfigPath)({
+        projectRootDir,
+    });
+    // Now we can safely import the manifest (it uses @trackunit/* imports)
+    const IrisAppManifest = (await Promise.resolve(`${manifestPath}`).then(s => tslib_1.__importStar(require(s)))).default;
+    // Get default config (internally imports @trackunit/iris-app-vite-plugin)
+    const defaultConfig = await (0, defaultViteConfig_1.getDefaultViteConfig)("production", context.root, projectRootDir, IrisAppManifest, context);
+    // Load optional custom config
+    let finalConfig = defaultConfig;
+    if (options.viteConfig || (0, fs_1.existsSync)((0, path_1.join)(projectRootDir, "vite.config.ts"))) {
+        const customConfigFile = await Promise.resolve(`${options.viteConfig ?? (0, path_1.join)(projectRootDir, "vite.config.ts")}`).then(s => tslib_1.__importStar(require(s)));
+        let customConfig = customConfigFile.default(defaultConfig);
+        const isPromise = customConfig instanceof Promise;
+        if (isPromise) {
+            customConfig = await customConfig;
+        }
+        finalConfig = customConfig;
+    }
+    // Set output path
+    finalConfig.build = {
+        ...finalConfig.build,
+        outDir: (0, path_1.resolve)(context.root, options.outputPath),
+        emptyOutDir: true,
+    };
+    // Delete existing output
+    deleteOutputDir(context.root, options.outputPath);
+    if (context.isVerbose) {
+        // eslint-disable-next-line no-console
+        console.log("Using Vite config", JSON.stringify(finalConfig.plugins, null, 2));
+    }
+    const observable = new rxjs_1.Observable(subscriber => {
+        void (async () => {
+            try {
+                const { build } = await Promise.resolve().then(() => tslib_1.__importStar(require("vite")));
+                const buildResult = await build(finalConfig);
+                // Log build stats if available
+                if (context.isVerbose) {
+                    // eslint-disable-next-line no-console
+                    console.log("Build completed:", buildResult);
+                }
+                subscriber.next({
+                    success: true,
+                    outfile: (0, path_1.resolve)(context.root, options.outputPath),
+                });
+                subscriber.complete();
+            }
+            catch (error) {
+                // eslint-disable-next-line no-console
+                console.error("Vite build error:", error);
+                subscriber.next({
+                    success: false,
+                    outfile: (0, path_1.resolve)(context.root, options.outputPath),
+                });
+                subscriber.complete();
+            }
+        })();
+    }).pipe(op.tap(({ success, outfile }) => {
+        if (success) {
+            // eslint-disable-next-line no-console
+            console.info(`\n  ✅ Iris App build completed: ${outfile}\n`);
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.error(`\n  ❌ Iris App build failed\n`);
+        }
+    }));
+    return yield* (0, rxjs_for_await_1.eachValueFrom)(observable);
+}
+//# sourceMappingURL=executor.js.map

package/src/executors/build/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/vite/src/executors/build/executor.ts"],"names":[],"mappings":"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","sourcesContent":["import { ExecutorContext } from \"@nx/devkit\";\nimport { eachValueFrom } from \"@nx/devkit/src/utils/rxjs-for-await\";\nimport { checkPackageVersion, enableTsConfigPath } from \"@trackunit/iris-app-build-utilities\";\nimport { existsSync, rmSync } from \"fs\";\nimport { join, resolve } from \"path\";\nimport { Observable } from \"rxjs\";\nimport * as op from \"rxjs/operators\";\nimport \"win-ca\";\nimport { getDefaultViteConfig } from \"../utils/defaultViteConfig\";\nimport { BuildExecutorSchema } from \"./schema\";\n\nexport type NodeBuildEvent = {\n  outfile: string;\n  success: boolean;\n};\n\nconst deleteOutputDir = (root: string, outputPath: string) => {\n  const resolvedOutputPath = resolve(root, outputPath);\n  if (resolvedOutputPath === root) {\n    throw new Error(\"Output path MUST not be project root directory!\");\n  }\n  rmSync(resolvedOutputPath, { recursive: true, force: true });\n};\n\n/**\n * Build executor for building Iris Apps with Vite.\n *\n * @param {BuildExecutorSchema} options build executor options for this nx executor\n * @param {ExecutorContext} context build executor context for this nx executor\n * @yields {NodeBuildEvent} the build event\n */\nexport default async function* buildExecutor(\n  options: BuildExecutorSchema,\n  context: ExecutorContext\n): AsyncGenerator<NodeBuildEvent> {\n  await checkPackageVersion(false);\n\n  // eslint-disable-next-line local-rules/no-typescript-assertion, @typescript-eslint/no-non-null-assertion\n  const projectRoot = context.projectsConfigurations.projects[context.projectName!]!.root;\n  const projectRootDir = join(context.root, projectRoot);\n  const manifestPath = join(context.root, projectRoot, \"iris-app-manifest.ts\");\n\n  // ✅ CRITICAL: Register tsconfig paths BEFORE any @trackunit/* imports\n  enableTsConfigPath({\n    projectRootDir,\n  });\n\n  // Now we can safely import the manifest (it uses @trackunit/* imports)\n  const IrisAppManifest = (await import(manifestPath)).default;\n\n  // Get default config (internally imports @trackunit/iris-app-vite-plugin)\n  const defaultConfig = await getDefaultViteConfig(\n    \"production\",\n    context.root,\n    projectRootDir,\n    IrisAppManifest,\n    context\n  );\n\n  // Load optional custom config\n  let finalConfig = defaultConfig;\n  if (options.viteConfig || existsSync(join(projectRootDir, \"vite.config.ts\"))) {\n    const customConfigFile = await import(options.viteConfig ?? join(projectRootDir, \"vite.config.ts\"));\n    let customConfig = customConfigFile.default(defaultConfig);\n    const isPromise = customConfig instanceof Promise;\n    if (isPromise) {\n      customConfig = await customConfig;\n    }\n    finalConfig = customConfig;\n  }\n\n  // Set output path\n  finalConfig.build = {\n    ...finalConfig.build,\n    outDir: resolve(context.root, options.outputPath),\n    emptyOutDir: true,\n  };\n\n  // Delete existing output\n  deleteOutputDir(context.root, options.outputPath);\n\n  if (context.isVerbose) {\n    // eslint-disable-next-line no-console\n    console.log(\"Using Vite config\", JSON.stringify(finalConfig.plugins, null, 2));\n  }\n\n  const observable = new Observable<NodeBuildEvent>(subscriber => {\n    void (async () => {\n      try {\n        const { build } = await import(\"vite\");\n\n        const buildResult = await build(finalConfig);\n\n        // Log build stats if available\n        if (context.isVerbose) {\n          // eslint-disable-next-line no-console\n          console.log(\"Build completed:\", buildResult);\n        }\n\n        subscriber.next({\n          success: true,\n          outfile: resolve(context.root, options.outputPath),\n        });\n        subscriber.complete();\n      } catch (error) {\n        // eslint-disable-next-line no-console\n        console.error(\"Vite build error:\", error);\n        subscriber.next({\n          success: false,\n          outfile: resolve(context.root, options.outputPath),\n        });\n        subscriber.complete();\n      }\n    })();\n  }).pipe(\n    op.tap(({ success, outfile }) => {\n      if (success) {\n        // eslint-disable-next-line no-console\n        console.info(`\\n  ✅ Iris App build completed: ${outfile}\\n`);\n      } else {\n        // eslint-disable-next-line no-console\n        console.error(`\\n  ❌ Iris App build failed\\n`);\n      }\n    })\n  );\n\n  return yield* eachValueFrom(observable);\n}\n"]}

package/src/executors/build/schema.json

@@ -0,0 +1,25 @@
+{
+  "version": 2,
+  "outputCapture": "direct-nodejs",
+  "$schema": "http://json-schema.org/schema",
+  "title": "Build executor for Iris Apps using Vite",
+  "description": "Builds an Iris App using Vite",
+  "type": "object",
+  "properties": {
+    "viteConfig": {
+      "type": "string",
+      "description": "Path to optional custom vite config file for overrides",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What is the path for the vite config for this app? (optional)"
+    },
+    "outputPath": {
+      "type": "string",
+      "description": "Output directory for the build"
+    }
+  },
+  "required": ["outputPath"]
+}
+

package/src/executors/serve/executor.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = serveExecutor;
+const tslib_1 = require("tslib");
+const rxjs_for_await_1 = require("@nx/devkit/src/utils/rxjs-for-await");
+const iris_app_build_utilities_1 = require("@trackunit/iris-app-build-utilities");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const rxjs_1 = require("rxjs");
+const op = tslib_1.__importStar(require("rxjs/operators"));
+require("win-ca");
+const defaultViteConfig_1 = require("../utils/defaultViteConfig");
+/**
+ * Serve executor for serving Iris Apps with Vite.
+ *
+ * @param {ServeExecutorSchema} options serve executor options for this nx executor
+ * @param {ExecutorContext} context serve executor context for this nx executor
+ * @yields {ServeResult} the serve result
+ */
+async function* serveExecutor(options, context) {
+    await (0, iris_app_build_utilities_1.checkPackageVersion)(false);
+    // eslint-disable-next-line local-rules/no-typescript-assertion, @typescript-eslint/no-non-null-assertion
+    const projectRoot = context.projectsConfigurations.projects[context.projectName].root;
+    const projectRootDir = (0, path_1.join)(context.root, projectRoot);
+    const manifestPath = (0, path_1.join)(context.root, projectRoot, "iris-app-manifest.ts");
+    // ✅ CRITICAL: Register tsconfig paths BEFORE any @trackunit/* imports
+    (0, iris_app_build_utilities_1.enableTsConfigPath)({
+        projectRootDir,
+    });
+    // Now we can safely import the manifest (it uses @trackunit/* imports)
+    const IrisAppManifest = (await Promise.resolve(`${manifestPath}`).then(s => tslib_1.__importStar(require(s)))).default;
+    // Get default config (internally imports @trackunit/iris-app-vite-plugin)
+    const defaultConfig = await (0, defaultViteConfig_1.getDefaultViteConfig)("development", context.root, projectRootDir, IrisAppManifest, context);
+    // Load optional custom config
+    let finalConfig = defaultConfig;
+    if (options.viteConfig || (0, fs_1.existsSync)((0, path_1.join)(projectRootDir, "vite.config.ts"))) {
+        const customConfigFile = await Promise.resolve(`${options.viteConfig ?? (0, path_1.join)(projectRootDir, "vite.config.ts")}`).then(s => tslib_1.__importStar(require(s)));
+        let customConfig = customConfigFile.default(defaultConfig);
+        const isPromise = customConfig instanceof Promise;
+        if (isPromise) {
+            customConfig = await customConfig;
+        }
+        finalConfig = customConfig;
+    }
+    // Apply port override if specified
+    if (options.port !== undefined) {
+        finalConfig.server = { ...finalConfig.server, port: options.port };
+    }
+    if (options.host) {
+        finalConfig.server = { ...finalConfig.server, host: options.host };
+    }
+    if (context.isVerbose) {
+        // eslint-disable-next-line no-console
+        console.log("Using Vite config", JSON.stringify(finalConfig.plugins, null, 2));
+    }
+    // Create and start Vite dev server
+    const observable = new rxjs_1.Observable(subscriber => {
+        void (async () => {
+            try {
+                // Dynamic import vite to avoid issues
+                const { createServer } = await Promise.resolve().then(() => tslib_1.__importStar(require("vite")));
+                const server = await createServer(finalConfig);
+                await server.listen();
+                const address = server.httpServer?.address();
+                const port = typeof address === "object" && address !== null ? address.port : (options.port ?? 22220);
+                const host = options.host ?? "localhost";
+                const baseUrl = `http://${host}:${port}`;
+                server.printUrls();
+                subscriber.next({
+                    baseUrl,
+                    success: true,
+                });
+                // Keep alive - server continues running until interrupted
+            }
+            catch (error) {
+                // eslint-disable-next-line no-console
+                console.error("Vite server error:", error);
+                subscriber.error(error);
+            }
+        })();
+        return () => {
+            // Cleanup on unsubscribe - handled by Vite's signal handling
+        };
+    }).pipe(op.tap(({ baseUrl }) => {
+        // eslint-disable-next-line no-console
+        console.info(`\n  🚀 Iris App dev server running at: ${baseUrl}\n`);
+    }), op.map(({ baseUrl, success }) => ({
+        baseUrl,
+        success,
+    })));
+    return yield* (0, rxjs_for_await_1.eachValueFrom)(observable);
+}
+//# sourceMappingURL=executor.js.map

package/src/executors/serve/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/vite/src/executors/serve/executor.ts"],"names":[],"mappings":"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","sourcesContent":["import { ExecutorContext } from \"@nx/devkit\";\nimport { eachValueFrom } from \"@nx/devkit/src/utils/rxjs-for-await\";\nimport { checkPackageVersion, enableTsConfigPath } from \"@trackunit/iris-app-build-utilities\";\nimport { existsSync } from \"fs\";\nimport { join } from \"path\";\nimport { Observable } from \"rxjs\";\nimport * as op from \"rxjs/operators\";\nimport \"win-ca\";\nimport { getDefaultViteConfig } from \"../utils/defaultViteConfig\";\nimport { ServeExecutorSchema } from \"./schema\";\n\ntype ServeResult = { baseUrl: string; success: boolean };\n\n/**\n * Serve executor for serving Iris Apps with Vite.\n *\n * @param {ServeExecutorSchema} options serve executor options for this nx executor\n * @param {ExecutorContext} context serve executor context for this nx executor\n * @yields {ServeResult} the serve result\n */\nexport default async function* serveExecutor(\n  options: ServeExecutorSchema,\n  context: ExecutorContext\n): AsyncGenerator<ServeResult> {\n  await checkPackageVersion(false);\n\n  // eslint-disable-next-line local-rules/no-typescript-assertion, @typescript-eslint/no-non-null-assertion\n  const projectRoot = context.projectsConfigurations.projects[context.projectName!]!.root;\n  const projectRootDir = join(context.root, projectRoot);\n  const manifestPath = join(context.root, projectRoot, \"iris-app-manifest.ts\");\n\n  // ✅ CRITICAL: Register tsconfig paths BEFORE any @trackunit/* imports\n  enableTsConfigPath({\n    projectRootDir,\n  });\n\n  // Now we can safely import the manifest (it uses @trackunit/* imports)\n  const IrisAppManifest = (await import(manifestPath)).default;\n\n  // Get default config (internally imports @trackunit/iris-app-vite-plugin)\n  const defaultConfig = await getDefaultViteConfig(\n    \"development\",\n    context.root,\n    projectRootDir,\n    IrisAppManifest,\n    context\n  );\n\n  // Load optional custom config\n  let finalConfig = defaultConfig;\n  if (options.viteConfig || existsSync(join(projectRootDir, \"vite.config.ts\"))) {\n    const customConfigFile = await import(options.viteConfig ?? join(projectRootDir, \"vite.config.ts\"));\n    let customConfig = customConfigFile.default(defaultConfig);\n    const isPromise = customConfig instanceof Promise;\n    if (isPromise) {\n      customConfig = await customConfig;\n    }\n    finalConfig = customConfig;\n  }\n\n  // Apply port override if specified\n  if (options.port !== undefined) {\n    finalConfig.server = { ...finalConfig.server, port: options.port };\n  }\n  if (options.host) {\n    finalConfig.server = { ...finalConfig.server, host: options.host };\n  }\n\n  if (context.isVerbose) {\n    // eslint-disable-next-line no-console\n    console.log(\"Using Vite config\", JSON.stringify(finalConfig.plugins, null, 2));\n  }\n\n  // Create and start Vite dev server\n  const observable = new Observable<{ baseUrl: string; success: boolean }>(subscriber => {\n    void (async () => {\n      try {\n        // Dynamic import vite to avoid issues\n        const { createServer } = await import(\"vite\");\n\n        const server = await createServer(finalConfig);\n        await server.listen();\n\n        const address = server.httpServer?.address();\n        const port = typeof address === \"object\" && address !== null ? address.port : (options.port ?? 22220);\n        const host = options.host ?? \"localhost\";\n        const baseUrl = `http://${host}:${port}`;\n\n        server.printUrls();\n\n        subscriber.next({\n          baseUrl,\n          success: true,\n        });\n\n        // Keep alive - server continues running until interrupted\n      } catch (error) {\n        // eslint-disable-next-line no-console\n        console.error(\"Vite server error:\", error);\n        subscriber.error(error);\n      }\n    })();\n\n    return () => {\n      // Cleanup on unsubscribe - handled by Vite's signal handling\n    };\n  }).pipe(\n    op.tap(({ baseUrl }) => {\n      // eslint-disable-next-line no-console\n      console.info(`\\n  🚀 Iris App dev server running at: ${baseUrl}\\n`);\n    }),\n    op.map(({ baseUrl, success }) => ({\n      baseUrl,\n      success,\n    }))\n  );\n\n  return yield* eachValueFrom(observable);\n}\n"]}

package/src/executors/serve/schema.json

@@ -0,0 +1,30 @@
+{
+  "version": 2,
+  "outputCapture": "direct-nodejs",
+  "$schema": "http://json-schema.org/schema",
+  "title": "Serve executor for Iris Apps using Vite",
+  "description": "Starts the Vite dev server for an Iris App",
+  "type": "object",
+  "properties": {
+    "viteConfig": {
+      "type": "string",
+      "description": "Path to optional custom vite config file for overrides",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What is the path for the vite config for this app? (optional)"
+    },
+    "port": {
+      "type": "number",
+      "description": "Dev server port (default: auto-select from 22220-22229)"
+    },
+    "host": {
+      "type": "string",
+      "description": "Dev server host",
+      "default": "localhost"
+    }
+  },
+  "required": []
+}
+

package/src/executors/utils/defaultViteConfig.js

@@ -0,0 +1,110 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultViteConfig = void 0;
+const path_1 = require("path");
+// Package name stored in variable to prevent TypeScript from statically analyzing
+// the import path during build. At runtime, enableTsConfigPath() must be called
+// first to register the path mapping.
+const VITE_PLUGIN_PACKAGE = "@trackunit/iris-app-vite-plugin";
+/**
+ * Gets the default Vite config for Iris Apps.
+ *
+ * IMPORTANT: This function MUST be called AFTER enableTsConfigPath() has been called,
+ * because it dynamically imports @trackunit/iris-app-vite-plugin which uses tsconfig paths.
+ *
+ * @param mode - "production" or "development"
+ * @param nxRootDir - the root of the nx workspace
+ * @param appDir - the app directory
+ * @param _irisAppManifest - the iris app manifest (used for logging/validation)
+ * @param context - NX executor context
+ * @returns {Promise<UserConfig>} the default Vite config
+ */
+const getDefaultViteConfig = async (mode, nxRootDir, appDir, _irisAppManifest, context) => {
+    // Dynamic import - safe after enableTsConfigPath() is called
+    const { getTrackunitIrisAppVitePlugins } = await Promise.resolve(`${VITE_PLUGIN_PACKAGE}`).then(s => __importStar(require(s)));
+    const irisAppPlugins = await getTrackunitIrisAppVitePlugins({
+        appDir,
+        workspaceRoot: nxRootDir,
+        config: { mode },
+    });
+    return {
+        root: appDir,
+        mode,
+        plugins: [...irisAppPlugins],
+        // Optimize dependency pre-bundling
+        optimizeDeps: {
+            // Force include common dependencies to speed up dev server startup
+            include: ["react", "react-dom", "react/jsx-runtime"],
+            // Use esbuild for faster dependency scanning
+            esbuildOptions: {
+                target: "esnext",
+            },
+        },
+        build: {
+            outDir: `dist/apps/${context.projectName}`,
+            emptyOutDir: true,
+            // Target modern browsers - faster builds, no legacy transforms
+            target: "esnext",
+            // Use esbuild for minification (MUCH faster than terser)
+            minify: "esbuild",
+            // Disable source maps in production for faster builds
+            sourcemap: false,
+            // Increase chunk size warning limit
+            chunkSizeWarningLimit: 1000,
+            // Put remoteEntry.js at root (not in assets/) to match rspack
+            assetsDir: "",
+            // Use JavaScript entry instead of index.html for Module Federation remotes
+            // The MF plugin generates remoteEntry.js as the actual bundle entry
+            rollupOptions: {
+                // this is just a dummy input to make the build pass - as Iris apps are module federation apps
+                input: (0, path_1.join)(__dirname, "index.ts"),
+                // Preserve the entry file name for Module Federation compatibility
+                output: {
+                    // ESM format for Module Federation
+                    format: "esm",
+                    // Entry files at root level (same as rspack)
+                    entryFileNames: "[name].js",
+                    // Chunks with hash
+                    chunkFileNames: "[name]-[hash].js",
+                    // Static assets
+                    assetFileNames: "static/[name]-[hash][extname]",
+                },
+            },
+        },
+    };
+};
+exports.getDefaultViteConfig = getDefaultViteConfig;
+//# sourceMappingURL=defaultViteConfig.js.map

package/src/executors/utils/defaultViteConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultViteConfig.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/vite/src/executors/utils/defaultViteConfig.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,+BAA4B;AAG5B,kFAAkF;AAClF,gFAAgF;AAChF,sCAAsC;AACtC,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AAE9D;;;;;;;;;;;;GAYG;AACI,MAAM,oBAAoB,GAAG,KAAK,EACvC,IAAkC,EAClC,SAAiB,EACjB,MAAc,EACd,gBAAiC,EACjC,OAAwB,EACH,EAAE;IACvB,6DAA6D;IAC7D,MAAM,EAAE,8BAA8B,EAAE,GAAG,yBAAa,mBAAmB,uCAAC,CAAC;IAE7E,MAAM,cAAc,GAAG,MAAM,8BAA8B,CAAC;QAC1D,MAAM;QACN,aAAa,EAAE,SAAS;QACxB,MAAM,EAAE,EAAE,IAAI,EAAE;KACjB,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,IAAI;QACJ,OAAO,EAAE,CAAC,GAAG,cAAc,CAAC;QAC5B,mCAAmC;QACnC,YAAY,EAAE;YACZ,mEAAmE;YACnE,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,mBAAmB,CAAC;YACpD,6CAA6C;YAC7C,cAAc,EAAE;gBACd,MAAM,EAAE,QAAQ;aACjB;SACF;QACD,KAAK,EAAE;YACL,MAAM,EAAE,aAAa,OAAO,CAAC,WAAW,EAAE;YAC1C,WAAW,EAAE,IAAI;YACjB,+DAA+D;YAC/D,MAAM,EAAE,QAAQ;YAChB,yDAAyD;YACzD,MAAM,EAAE,SAAS;YACjB,sDAAsD;YACtD,SAAS,EAAE,KAAK;YAChB,oCAAoC;YACpC,qBAAqB,EAAE,IAAI;YAC3B,8DAA8D;YAC9D,SAAS,EAAE,EAAE;YACb,2EAA2E;YAC3E,oEAAoE;YACpE,aAAa,EAAE;gBACb,8FAA8F;gBAC9F,KAAK,EAAE,IAAA,WAAI,EAAC,SAAS,EAAE,UAAU,CAAC;gBAClC,mEAAmE;gBACnE,MAAM,EAAE;oBACN,mCAAmC;oBACnC,MAAM,EAAE,KAAK;oBACb,6CAA6C;oBAC7C,cAAc,EAAE,WAAW;oBAC3B,mBAAmB;oBACnB,cAAc,EAAE,kBAAkB;oBAClC,gBAAgB;oBAChB,cAAc,EAAE,+BAA+B;iBAChD;aACF;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AA7DW,QAAA,oBAAoB,wBA6D/B","sourcesContent":["import { ExecutorContext } from \"@nx/devkit\";\nimport type { IrisAppManifest } from \"@trackunit/iris-app-api\";\nimport { join } from \"path\";\nimport type { UserConfig } from \"vite\";\n\n// Package name stored in variable to prevent TypeScript from statically analyzing\n// the import path during build. At runtime, enableTsConfigPath() must be called\n// first to register the path mapping.\nconst VITE_PLUGIN_PACKAGE = \"@trackunit/iris-app-vite-plugin\";\n\n/**\n * Gets the default Vite config for Iris Apps.\n *\n * IMPORTANT: This function MUST be called AFTER enableTsConfigPath() has been called,\n * because it dynamically imports @trackunit/iris-app-vite-plugin which uses tsconfig paths.\n *\n * @param mode - \"production\" or \"development\"\n * @param nxRootDir - the root of the nx workspace\n * @param appDir - the app directory\n * @param _irisAppManifest - the iris app manifest (used for logging/validation)\n * @param context - NX executor context\n * @returns {Promise<UserConfig>} the default Vite config\n */\nexport const getDefaultViteConfig = async (\n  mode: \"production\" | \"development\",\n  nxRootDir: string,\n  appDir: string,\n  _irisAppManifest: IrisAppManifest,\n  context: ExecutorContext\n): Promise<UserConfig> => {\n  // Dynamic import - safe after enableTsConfigPath() is called\n  const { getTrackunitIrisAppVitePlugins } = await import(VITE_PLUGIN_PACKAGE);\n\n  const irisAppPlugins = await getTrackunitIrisAppVitePlugins({\n    appDir,\n    workspaceRoot: nxRootDir,\n    config: { mode },\n  });\n\n  return {\n    root: appDir,\n    mode,\n    plugins: [...irisAppPlugins],\n    // Optimize dependency pre-bundling\n    optimizeDeps: {\n      // Force include common dependencies to speed up dev server startup\n      include: [\"react\", \"react-dom\", \"react/jsx-runtime\"],\n      // Use esbuild for faster dependency scanning\n      esbuildOptions: {\n        target: \"esnext\",\n      },\n    },\n    build: {\n      outDir: `dist/apps/${context.projectName}`,\n      emptyOutDir: true,\n      // Target modern browsers - faster builds, no legacy transforms\n      target: \"esnext\",\n      // Use esbuild for minification (MUCH faster than terser)\n      minify: \"esbuild\",\n      // Disable source maps in production for faster builds\n      sourcemap: false,\n      // Increase chunk size warning limit\n      chunkSizeWarningLimit: 1000,\n      // Put remoteEntry.js at root (not in assets/) to match rspack\n      assetsDir: \"\",\n      // Use JavaScript entry instead of index.html for Module Federation remotes\n      // The MF plugin generates remoteEntry.js as the actual bundle entry\n      rollupOptions: {\n        // this is just a dummy input to make the build pass - as Iris apps are module federation apps\n        input: join(__dirname, \"index.ts\"),\n        // Preserve the entry file name for Module Federation compatibility\n        output: {\n          // ESM format for Module Federation\n          format: \"esm\",\n          // Entry files at root level (same as rspack)\n          entryFileNames: \"[name].js\",\n          // Chunks with hash\n          chunkFileNames: \"[name]-[hash].js\",\n          // Static assets\n          assetFileNames: \"static/[name]-[hash][extname]\",\n        },\n      },\n    },\n  };\n};\n"]}

package/src/executors/utils/index.js

@@ -0,0 +1,4 @@
+"use strict";
+// eslint-disable-next-line local-rules/no-internal-barrel-files
+// dummy file to build - as Iris apps are module federation apps.
+//# sourceMappingURL=index.js.map

package/src/executors/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/vite/src/executors/utils/index.ts"],"names":[],"mappings":";AAAA,gEAAgE;AAChE,iEAAiE","sourcesContent":["// eslint-disable-next-line local-rules/no-internal-barrel-files\n// dummy file to build - as Iris apps are module federation apps."]}

package/src/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/vite/src/index.ts"],"names":[],"mappings":"","sourcesContent":[""]}