<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
    <channel>
        <title>Trackunit IrisX - Change Log</title>
        <link>https://developers.trackunit.com/changelog/</link>
        <description>New APIs, SDK updates and platform changes.</description>
        <lastBuildDate>Wed, 04 Nov 2026 00:00:00 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>https://github.com/jpmonette/feed</generator>
        <language>en</language>
        <copyright>Copyright © 2026 Trackunit Corporation.</copyright>
        <item>
            <title><![CDATA[REST APIs: Retry-After header on rate limited responses]]></title>
            <link>https://developers.trackunit.com/changelog/2026/11/04/rest-api-retry-after-header/</link>
            <guid>https://developers.trackunit.com/changelog/2026/11/04/rest-api-retry-after-header/</guid>
            <pubDate>Wed, 04 Nov 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Rate limited requests to the Trackunit REST APIs now get a Retry-After header on the 429 Too Many Requests response. It gives the number of seconds to wait before sending the request again.]]></description>
            <content:encoded><![CDATA[<p>Rate limited requests to the Trackunit REST APIs now get a <code>Retry-After</code> header on the <code>429 Too Many Requests</code> response. It gives the number of seconds to wait before sending the request again.</p>
<div class="language-http codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-http codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">HTTP/1.1 429 Too Many Requests</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">Retry-After: 42</span><br></div></code></pre></div></div>
<p>The value includes a small random delay, so clients that were limited at the same time don't all retry at the same moment. Wait at least that long before retrying; retrying sooner is likely to be rate limited again. The value is an estimate, so keep handling <code>429</code> with a backoff. Requests that are rate limited don't count towards your rate limits.</p>
<p>For the AEMP ISO 15143-3 API, expect a second or two for the per-second limits, and up to 15 minutes once the 15-minute limit and the pool of additional requests are used up.</p>
<p>See <a class="" href="https://developers.trackunit.com/docs/reference/rest-apis-overview/rate-limit/#retry-after-header">Rate &amp; Size Limiting</a> for details.</p>]]></content:encoded>
            <category>Added</category>
        </item>
        <item>
            <title><![CDATA[Breaking: custom-field table helpers move out of @trackunit/react-table-helpers]]></title>
            <link>https://developers.trackunit.com/changelog/2026/10/29/custom-field-table-helpers-split/</link>
            <guid>https://developers.trackunit.com/changelog/2026/10/29/custom-field-table-helpers-split/</guid>
            <pubDate>Thu, 29 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[@trackunit/react-table-helpers (from 3.0.0) no longer exports the custom-field column helpers. Those APIs now live in the new @trackunit/custom-field-table-helpers package. If your Iris App still imports them from react-table-helpers, bumping that dependency without running the migration is a compile failure. Apps that only use ExportTableButton are unaffected.]]></description>
            <content:encoded><![CDATA[<p><code>@trackunit/react-table-helpers</code> (from <code>3.0.0</code>) no longer exports the custom-field column helpers. Those APIs now live in the new <code>@trackunit/custom-field-table-helpers</code> package. If your Iris App still imports them from <code>react-table-helpers</code>, bumping that dependency without running the migration is a compile failure. Apps that only use <code>ExportTableButton</code> are unaffected.</p>
<p>Run these two commands in the consuming repo after bumping the dependency:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">npx nx g @trackunit/migrations:migrate</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nx g @trackunit/migrations:run-migrations</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="why-this-changed">Why this changed<a href="https://developers.trackunit.com/changelog/2026/10/29/custom-field-table-helpers-split/#why-this-changed" class="hash-link" aria-label="Direct link to Why this changed" title="Direct link to Why this changed" translate="no">​</a></h3>
<p>The custom-field column helpers depended on <code>@trackunit/custom-field-api</code>, which pulls in GraphQL documents that require <code>site.view</code>. Keeping them next to <code>ExportTableButton</code> forced every app that only exported a table to declare that scope. Moving the helpers into <code>@trackunit/custom-field-table-helpers</code> leaves export-only apps on the lighter package.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="when-it-affects-you">When it affects you<a href="https://developers.trackunit.com/changelog/2026/10/29/custom-field-table-helpers-split/#when-it-affects-you" class="hash-link" aria-label="Direct link to When it affects you" title="Direct link to When it affects you" translate="no">​</a></h3>
<p>Nothing changes until you bump <code>@trackunit/react-table-helpers</code> to <code>3.0.0</code> or later. At that version, these named exports are gone from <code>@trackunit/react-table-helpers</code> and must come from <code>@trackunit/custom-field-table-helpers</code> instead:</p>
<ul>
<li class=""><code>useColumnDefinitionsFromCustomFieldDefinition</code></li>
<li class=""><code>customFieldToCell</code></li>
<li class=""><code>customFieldToExportString</code></li>
<li class=""><code>CustomFieldData</code></li>
<li class=""><code>DataWithCustomFields</code></li>
</ul>
<p><code>ExportTableButton</code> stays on <code>@trackunit/react-table-helpers</code>.</p>
<div class="language-ts codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-ts codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// before</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  ExportTableButton</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  useColumnDefinitionsFromCustomFieldDefinition</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@trackunit/react-table-helpers"</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// after</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> ExportTableButton </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@trackunit/react-table-helpers"</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> useColumnDefinitionsFromCustomFieldDefinition </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@trackunit/custom-field-table-helpers"</span><span class="token punctuation" style="color:#393A34">;</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="what-the-migration-does">What the migration does<a href="https://developers.trackunit.com/changelog/2026/10/29/custom-field-table-helpers-split/#what-the-migration-does" class="hash-link" aria-label="Direct link to What the migration does" title="Direct link to What the migration does" translate="no">​</a></h3>
<p>The package includes the <code>v3-0-0-move-custom-field-table-helpers</code> migration.</p>
<ul>
<li class="">rewrites named imports and named re-exports (including <code>import type</code>) of those five symbols from <code>@trackunit/react-table-helpers</code> to <code>@trackunit/custom-field-table-helpers</code></li>
<li class="">splits the import declaration when <code>ExportTableButton</code> is imported alongside them</li>
<li class="">adds <code>@trackunit/custom-field-table-helpers</code> to the consumer's <code>package.json</code></li>
<li class="">reports anything it cannot safely rewrite as <code>file:line</code> for manual review: <code>export *</code> and <code>export * as</code>, namespace imports, dynamic <code>import()</code> and <code>import()</code> types, <code>require()</code> and <code>import = require()</code>, and <code>vi.mock</code> / <code>jest.mock</code> of <code>@trackunit/react-table-helpers</code></li>
</ul>
<p>For the complete update process, see <a class="" href="https://developers.trackunit.com/docs/apps-and-extensions/overview/iris-app-sdk-reference/maintaining-your-app/">Maintaining Your Application</a>.</p>]]></content:encoded>
            <category>Added</category>
            <category>Removed</category>
        </item>
        <item>
            <title><![CDATA[trackunit/iris-app — new workspaces include Trackunit linting]]></title>
            <link>https://developers.trackunit.com/changelog/2026/10/28/iris-app-trackunit-eslint/</link>
            <guid>https://developers.trackunit.com/changelog/2026/10/28/iris-app-trackunit-eslint/</guid>
            <pubDate>Wed, 28 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Workspaces created with npx @trackunit/create-iris-app-workspace now come with @trackunit/eslint-plugin-trackunit set up. The root eslint.config.cjs applies the plugin's base and react presets, and every app and extension gets a lint target. Freshly generated apps and extensions pass lint with zero errors and zero warnings. To lint the whole workspace, run:]]></description>
            <content:encoded><![CDATA[<p>Workspaces created with <code>npx @trackunit/create-iris-app-workspace</code> now come with <a href="https://www.npmjs.com/package/@trackunit/eslint-plugin-trackunit" target="_blank" rel="noopener noreferrer" class=""><code>@trackunit/eslint-plugin-trackunit</code></a> set up. The root <code>eslint.config.cjs</code> applies the plugin's <code>base</code> and <code>react</code> presets, and every app and extension gets a <code>lint</code> target. Freshly generated apps and extensions pass lint with zero errors and zero warnings. To lint the whole workspace, run:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">npx nx run-many </span><span class="token parameter variable" style="color:#36acaa">-t</span><span class="token plain"> lint</span><br></div></code></pre></div></div>
<p>Upgrading the <code>@trackunit/*</code> packages in an existing workspace doesn't set up Trackunit linting for you. To adopt Trackunit linting in a workspace you already have, follow <a class="" href="https://developers.trackunit.com/docs/apps-and-extensions/overview/iris-app-sdk-reference/linting/">Linting</a>.</p>
<p>The published presets also no longer include Jest rules; see below if your projects use Jest.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="jest-rules-removed-from-the-published-presets">Jest rules removed from the published presets<a href="https://developers.trackunit.com/changelog/2026/10/28/iris-app-trackunit-eslint/#jest-rules-removed-from-the-published-presets" class="hash-link" aria-label="Direct link to Jest rules removed from the published presets" title="Direct link to Jest rules removed from the published presets" translate="no">​</a></h3>
<p><code>configs.base</code> and <code>configs.react</code> no longer configure <code>eslint-plugin-jest</code>, so linting no longer fails with <code>Unable to detect Jest version</code> in Vitest-only workspaces. <code>configs.react</code> declares the Vitest globals instead. The presets also no longer enable <code>@trackunit/no-jest-mock-trackunit-react-core-hooks</code>; set it to <code>"error"</code> in your config if your specs use Jest.</p>
<p>If your ESLint config or <code>eslint-disable</code> comments reference <code>jest/*</code> rules, ESLint now reports that the <code>jest</code> plugin or rule can't be found. Install <a href="https://www.npmjs.com/package/eslint-plugin-jest" target="_blank" rel="noopener noreferrer" class=""><code>eslint-plugin-jest</code></a> and add its flat config to your ESLint config yourself, or remove those references. The <a href="https://www.npmjs.com/package/@trackunit/eslint-plugin-trackunit#presets" target="_blank" rel="noopener noreferrer" class="">plugin README</a> lists what each preset includes.</p>]]></content:encoded>
            <category>Improved</category>
            <category>Removed</category>
        </item>
        <item>
            <title><![CDATA[GraphQL: command operationId can be null, and queued command statuses]]></title>
            <link>https://developers.trackunit.com/changelog/2026/10/26/graphql-command-operation-id-and-queued-statuses/</link>
            <guid>https://developers.trackunit.com/changelog/2026/10/26/graphql-command-operation-id-and-queued-statuses/</guid>
            <pubDate>Mon, 26 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[CommandExecution.operationId on the public GraphQL API can now be null until the command is sent. CommandStatusType includes QUEUED and QUEUED_CANCELLED.]]></description>
            <content:encoded><![CDATA[<p><code>CommandExecution.operationId</code> on the public GraphQL API can now be null until the command is sent. <code>CommandStatusType</code> includes <code>QUEUED</code> and <code>QUEUED_CANCELLED</code>.</p>
<p>If your client was generated when <code>operationId</code> was non-null (<code>String!</code>), treat it as optional. The identifier is absent until the command is sent.</p>
<p><code>CommandStatusType</code> now includes:</p>
<ul>
<li class=""><code>QUEUED</code></li>
<li class=""><code>QUEUED_CANCELLED</code></li>
</ul>
<p>Clients that match on every command status should handle these values.</p>
<p><a class="" href="https://developers.trackunit.com/docs/reference/graphql-api/graphql-api-introduction/">GraphQL API</a></p>]]></content:encoded>
            <category>Improved</category>
            <category>Added</category>
        </item>
        <item>
            <title><![CDATA[Breaking: router-coupled hooks and Breadcrumb moved to @trackunit/react-router-components]]></title>
            <link>https://developers.trackunit.com/changelog/2026/10/26/react-router-components-lib/</link>
            <guid>https://developers.trackunit.com/changelog/2026/10/26/react-router-components-lib/</guid>
            <pubDate>Mon, 26 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[@trackunit/react-components 4.0.0 removes usePersistedState, useSearchParamSync, useCursorUrlSync, MAXURLLENGTH, the UrlPersistenceLocation type and Breadcrumb. They now live in the new package @trackunit/react-router-components (first published as 1.0.2), with no compatibility shim: if your code imports any of them, bumping to 4.0.0 without running the migration is a compile failure, not a deprecation warning. Repos that never used them are unaffected.]]></description>
            <content:encoded><![CDATA[<p><code>@trackunit/react-components</code> <code>4.0.0</code> removes <code>usePersistedState</code>, <code>useSearchParamSync</code>, <code>useCursorUrlSync</code>, <code>MAX_URL_LENGTH</code>, the <code>UrlPersistenceLocation</code> type and <code>Breadcrumb</code>. They now live in the new package <code>@trackunit/react-router-components</code> (first published as <code>1.0.2</code>), <strong>with no compatibility shim</strong>: if your code imports any of them, bumping to <code>4.0.0</code> without running the migration is a compile failure, not a deprecation warning. Repos that never used them are unaffected.</p>
<p>Run these two commands in the consuming repo:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">npx nx g @trackunit/migrations:migrate</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nx g @trackunit/migrations:run-migrations</span><br></div></code></pre></div></div>
<p>Then re-install dependencies (<code>npm install</code>), because the migration adds <code>@trackunit/react-router-components</code> to your <code>package.json</code>.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="why-this-changed">Why this changed<a href="https://developers.trackunit.com/changelog/2026/10/26/react-router-components-lib/#why-this-changed" class="hash-link" aria-label="Direct link to Why this changed" title="Direct link to Why this changed" translate="no">​</a></h3>
<p>These hooks and <code>Breadcrumb</code> read and write the URL through <a href="https://tanstack.com/router" target="_blank" rel="noopener noreferrer" class="">TanStack Router</a>. <code>@trackunit/react-router-components</code> is now the one published package for components and hooks that depend on <code>@tanstack/react-router</code>, so router-aware code has a single home instead of being spread across general-purpose packages. Trackunit's own published packages are now linted against importing <code>@tanstack/react-router</code> directly. That rule does not apply to your app code.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="when-it-affects-you">When it affects you<a href="https://developers.trackunit.com/changelog/2026/10/26/react-router-components-lib/#when-it-affects-you" class="hash-link" aria-label="Direct link to When it affects you" title="Direct link to When it affects you" translate="no">​</a></h3>
<p>Nothing changes until you bump the package. From <code>@trackunit/react-components</code> <code>4.0.0</code>, the names below are no longer exported from it and any import of them stops compiling until migrated:</p>








































<table><thead><tr><th>Export</th><th>Before</th><th>After</th></tr></thead><tbody><tr><td><code>usePersistedState</code></td><td><code>@trackunit/react-components</code></td><td><code>@trackunit/react-router-components</code></td></tr><tr><td><code>UrlPersistenceLocation</code> (type)</td><td><code>@trackunit/react-components</code></td><td><code>@trackunit/react-router-components</code></td></tr><tr><td><code>useSearchParamSync</code></td><td><code>@trackunit/react-components</code></td><td><code>@trackunit/react-router-components</code></td></tr><tr><td><code>MAX_URL_LENGTH</code></td><td><code>@trackunit/react-components</code></td><td><code>@trackunit/react-router-components</code></td></tr><tr><td><code>useCursorUrlSync</code></td><td><code>@trackunit/react-components</code></td><td><code>@trackunit/react-router-components</code></td></tr><tr><td><code>Breadcrumb</code></td><td><code>@trackunit/react-components</code></td><td><code>@trackunit/react-router-components</code></td></tr></tbody></table>
<p>Names, props and behavior are unchanged; only the import path moves. Everything else, including <code>Prompt</code>, is still imported from <code>@trackunit/react-components</code>.</p>
<p><code>@trackunit/react-router-components</code> declares <code>@tanstack/react-router</code> (<code>^1.114.29</code>) and <code>react</code> (<code>^19.0.0</code>) as peer dependencies, the same peers <code>@trackunit/react-components</code> <code>4.0.0</code> declares, so an app that already runs <code>react-components</code> needs no new peer.</p>
<div class="language-tsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-tsx codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// before</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token imports punctuation" style="color:#393A34">{</span><span class="token imports"> </span><span class="token imports maybe-class-name">Breadcrumb</span><span class="token imports punctuation" style="color:#393A34">,</span><span class="token imports"> </span><span class="token imports maybe-class-name">Button</span><span class="token imports punctuation" style="color:#393A34">,</span><span class="token imports"> usePersistedState </span><span class="token imports punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@trackunit/react-components"</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// after</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token imports punctuation" style="color:#393A34">{</span><span class="token imports"> </span><span class="token imports maybe-class-name">Button</span><span class="token imports"> </span><span class="token imports punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@trackunit/react-components"</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token imports punctuation" style="color:#393A34">{</span><span class="token imports"> </span><span class="token imports maybe-class-name">Breadcrumb</span><span class="token imports punctuation" style="color:#393A34">,</span><span class="token imports"> usePersistedState </span><span class="token imports punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@trackunit/react-router-components"</span><span class="token punctuation" style="color:#393A34">;</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="what-the-migration-does">What the migration does<a href="https://developers.trackunit.com/changelog/2026/10/26/react-router-components-lib/#what-the-migration-does" class="hash-link" aria-label="Direct link to What the migration does" title="Direct link to What the migration does" translate="no">​</a></h3>
<p>The <code>@trackunit/react-components</code> <code>4.0.0</code> migration (<code>v4-0-0-move-to-router-components</code>) runs as part of <code>run-migrations</code>:</p>
<ul>
<li class="">It rewrites imports and re-exports of the moved names to <code>@trackunit/react-router-components</code>, including type-only and aliased imports. In an import that mixes moved and unmoved names, it splits the import and keeps the other names on <code>@trackunit/react-components</code>.</li>
<li class="">When it rewrote anything, it adds <code>@trackunit/react-router-components</code> to your root <code>package.json</code>, next to <code>@trackunit/react-components</code> (in <code>dependencies</code> or <code>devDependencies</code>, wherever that one is). It keeps an existing entry. Other <code>package.json</code> files that declare <code>@trackunit/react-components</code> are listed in the log: add the new package there yourself if that project uses the moved names.</li>
<li class="">Any usage it can't rewrite with confidence is <strong>left untouched and logged as <code>manual review needed at &lt;file&gt;:&lt;line&gt;</code></strong> rather than guessed at. That covers namespace imports (<code>import * as RC from "@trackunit/react-components"</code>) that use a moved name, <code>export * from "@trackunit/react-components"</code> (the moved names silently drop out of it), <code>export * as</code>, <code>require()</code> and dynamic <code>import()</code>, <code>import()</code> types, and <code>vi.mock()</code>/<code>jest.mock()</code> calls on <code>@trackunit/react-components</code> in files that use a moved name.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="also-in-trackunitreact-router-components">Also in <code>@trackunit/react-router-components</code><a href="https://developers.trackunit.com/changelog/2026/10/26/react-router-components-lib/#also-in-trackunitreact-router-components" class="hash-link" aria-label="Direct link to also-in-trackunitreact-router-components" title="Direct link to also-in-trackunitreact-router-components" translate="no">​</a></h3>
<p>The package also exports <code>useRouterDrawer</code>, which keeps a <code>Drawer</code>'s selected id in a search or path param, and <code>RouteLink</code>, a text link to a route inside your app. Use <code>ExternalLink</code> from <code>@trackunit/react-components</code> for links that leave the app.</p>]]></content:encoded>
            <category>Removed</category>
            <category>Added</category>
        </item>
        <item>
            <title><![CDATA[Compaction API: lastEdit.customerId and lastEdit.userId deprecated]]></title>
            <link>https://developers.trackunit.com/changelog/2026/10/21/compaction-api-lastedit-ids-deprecated/</link>
            <guid>https://developers.trackunit.com/changelog/2026/10/21/compaction-api-lastedit-ids-deprecated/</guid>
            <pubDate>Wed, 21 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[The customerId and userId fields in the lastEdit object of a trip filter in the Compaction API are deprecated. Trackunit is retiring classic customer and user IDs, and from an upcoming release both fields will always return null.]]></description>
            <content:encoded><![CDATA[<p>The <code>customerId</code> and <code>userId</code> fields in the <code>lastEdit</code> object of a trip filter in the Compaction API are deprecated. Trackunit is retiring classic customer and user IDs, and from an upcoming release both fields will always return <code>null</code>.</p>
<p><code>lastEdit.customerName</code>, <code>lastEdit.userName</code> and <code>lastEdit.editTime</code> are not affected and keep returning the same values. The deprecated fields stay in the v1 contract, so responses keep the same shape.</p>
<p>Affected endpoint:</p>
<blockquote>
<p>GET: <code>/api/compaction/v1/compactions/trips/{tripId}/filter</code></p>
</blockquote>
<p><a class="" href="https://developers.trackunit.com/docs/api-reference/compaction-api/get-trip-filter/">Get filter settings for a single trip</a></p>
<p>If your integration reads <code>lastEdit.customerId</code> or <code>lastEdit.userId</code>, make sure it accepts <code>null</code>, and use <code>lastEdit.customerName</code> and <code>lastEdit.userName</code> to see who last edited the filter.</p>]]></content:encoded>
            <category>Removed</category>
        </item>
        <item>
            <title><![CDATA[Breaking: @trackunit/iris-app-playwright 0.3.1 requires awaiting irisApp()]]></title>
            <link>https://developers.trackunit.com/changelog/2026/10/19/iris-app-playwright-v1-await-iris-app/</link>
            <guid>https://developers.trackunit.com/changelog/2026/10/19/iris-app-playwright-v1-await-iris-app/</guid>
            <pubDate>Mon, 19 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[@trackunit/iris-app-playwright 0.3.1 is a breaking release: irisApp() now returns a Promise in every environment. Because the package is still pre-1.0, the break shipped as a minor release, so a ^0.2.x range does not pick it up but any 0.3.x does.]]></description>
            <content:encoded><![CDATA[<p><code>@trackunit/iris-app-playwright</code> 0.3.1 is a breaking release: <code>irisApp()</code> now returns a <code>Promise&lt;FrameLocator&gt;</code> in every environment. Because the package is still pre-1.0, the break shipped as a minor release, so a <code>^0.2.x</code> range does not pick it up but any <code>0.3.x</code> does.</p>
<p><em>Updated 2026-10-28: corrected the version. This entry previously said <code>v1.0.0</code>, which was never released; the change first shipped in <code>0.3.1</code>.</em></p>
<p>Await it before using the app fixture:</p>
<div class="language-ts codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-ts codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Before — no longer works</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> app </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">irisApp</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">await</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">irisApp</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">getByTestId</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">"asset-list"</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">click</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// After</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> app </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">await</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">irisApp</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">await</span><span class="token plain"> app</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">getByTestId</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">"asset-list"</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">click</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Or parenthesize a receiver chain</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">await</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">await</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">irisApp</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">getByTestId</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">"asset-list"</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token function" style="color:#d73a49">click</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="why-this-changed">Why this changed<a href="https://developers.trackunit.com/changelog/2026/10/19/iris-app-playwright-v1-await-iris-app/#why-this-changed" class="hash-link" aria-label="Direct link to Why this changed" title="Direct link to Why this changed" translate="no">​</a></h3>
<p>The stable promise contract allows tests that run against a feature branch to wait for the matching Iris App iframe before making page assertions. If that iframe never appears, the failure can be classified as <code>host never became ready</code> instead of surfacing as a misleading app assertion failure.</p>
<p>In normal external development, where <code>NX_FEATURE_BRANCH_BASE_URL</code> is not set, there is no additional wait: <code>irisApp()</code> resolves immediately while retaining the same promise-based API. The shared fixture also selects the first matching iframe, avoiding Playwright strict-mode failures when several matching iframes are present.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="migrate-your-tests">Migrate your tests<a href="https://developers.trackunit.com/changelog/2026/10/19/iris-app-playwright-v1-await-iris-app/#migrate-your-tests" class="hash-link" aria-label="Direct link to Migrate your tests" title="Direct link to Migrate your tests" translate="no">​</a></h3>
<p>The package includes the <code>v0-3-0-await-iris-app</code> migration. Update your Trackunit dependencies and run their migrations:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">npx nx g @trackunit/migrations:migrate</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nx g @trackunit/migrations:run-migrations</span><br></div></code></pre></div></div>
<p>The migration:</p>
<ul>
<li class="">awaits <code>irisApp()</code> calls inside async functions</li>
<li class="">changes local <code>() =&gt; FrameLocator</code> fixture types to <code>() =&gt; Promise&lt;FrameLocator&gt;</code></li>
<li class="">leaves calls that are already awaited unchanged</li>
<li class="">reports synchronous locations as <code>file:line</code> so you can update them manually</li>
</ul>
<p>For the complete update process, see <a class="" href="https://developers.trackunit.com/docs/apps-and-extensions/overview/iris-app-sdk-reference/maintaining-your-app/">Maintaining Your Application</a>.</p>]]></content:encoded>
            <category>Removed</category>
        </item>
        <item>
            <title><![CDATA[AEMP ISO 15143-3: equipment identifiers containing slashes]]></title>
            <link>https://developers.trackunit.com/changelog/2026/10/15/aemp-iso-encoded-slash-identifiers/</link>
            <guid>https://developers.trackunit.com/changelog/2026/10/15/aemp-iso-encoded-slash-identifiers/</guid>
            <pubDate>Thu, 15 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[The Export ISO 15143-3 (AEMP 2.0) equipment endpoints now accept OEM ISO identifiers that contain a forward slash, such as the PIN AB/12345. Send the slash URL-encoded as %2F, for example /15143/-3/Fleet/Equipment/ID/AB%2F12345. Previously, these requests were rejected with 400 Bad Request.]]></description>
            <content:encoded><![CDATA[<p>The Export ISO 15143-3 (AEMP 2.0) equipment endpoints now accept OEM ISO identifiers that contain a forward slash, such as the PIN <code>AB/12345</code>. Send the slash URL-encoded as <code>%2F</code>, for example <code>/15143/-3/Fleet/Equipment/ID/AB%2F12345</code>. Previously, these requests were rejected with 400 Bad Request.</p>
<p>A raw <code>/</code> in the identifier is still read as a path separator, and the request returns 404 Not Found. See <a class="" href="https://developers.trackunit.com/docs/api-reference/aemp-iso-api/aemp-iso-api/#identifiers-containing-slashes">Identifiers Containing Slashes</a> for details.</p>]]></content:encoded>
            <category>Fixed</category>
        </item>
        <item>
            <title><![CDATA[Classic AEMP 1.2 fleet feed moving to the Trackunit Iris platform]]></title>
            <link>https://developers.trackunit.com/changelog/2026/10/14/aemp-1-2-moving-to-iris/</link>
            <guid>https://developers.trackunit.com/changelog/2026/10/14/aemp-1-2-moving-to-iris/</guid>
            <pubDate>Wed, 14 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Over the coming days, the Trackunit Classic AEMP 1.2 fleet endpoint (api.trackunit.com/aemp) will start getting its fleet data from the Trackunit Iris platform. We are rolling this out gradually, account by account. The endpoint URL, authentication and response format stay the same, and you don't need to do anything.]]></description>
            <content:encoded><![CDATA[<p>Over the coming days, the Trackunit Classic AEMP 1.2 fleet endpoint (<code>api.trackunit.com/aemp</code>) will start getting its fleet data from the Trackunit Iris platform. We are rolling this out gradually, account by account. The endpoint URL, authentication and response format stay the same, and you don't need to do anything.</p>
<p>Once your account has moved, the data comes from the same source as the rest of the Trackunit platform, so you may notice small differences compared to earlier responses:</p>
<ul>
<li class="">Some machines may now report values they didn't report before.</li>
<li class="">Response times for very large fleets may be somewhat longer.</li>
</ul>
<p>If you see unexpected changes in your AEMP data, contact Trackunit Support.</p>]]></content:encoded>
            <category>Improved</category>
        </item>
        <item>
            <title><![CDATA[trackunit/iris-app-sdk-vite v1.7.0 - reproduce production-only React issues with --productionReact]]></title>
            <link>https://developers.trackunit.com/changelog/2026/10/05/iris-app-sdk-vite-production-react/</link>
            <guid>https://developers.trackunit.com/changelog/2026/10/05/iris-app-sdk-vite-production-react/</guid>
            <pubDate>Mon, 05 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[serve now has a --productionReact option so you can reproduce issues that only show up in a published app, without leaving your local dev loop.]]></description>
            <content:encoded><![CDATA[<p><code>serve</code> now has a <code>--productionReact</code> option so you can reproduce issues that only show up in a published app, without leaving your local dev loop.</p>
<p>A published IrisX App runs React's <strong>production</strong> runtime, while <code>serve</code> always used React's <strong>development</strong> runtime (development warnings, coded vs. verbose errors, React Fast Refresh). If something works locally but breaks once the app is submitted, serve with React's production runtime instead:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">npx nx run </span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">name-of-your-app</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">:serve </span><span class="token parameter variable" style="color:#36acaa">--productionReact</span><br></div></code></pre></div></div>
<p>With <code>--productionReact</code>:</p>
<ul>
<li class="">React runs without development warnings, and React errors show up as coded messages (see <a href="https://react.dev/errors" target="_blank" rel="noopener noreferrer" class="">react.dev/errors</a>).</li>
<li class="">React Fast Refresh is turned off, so a code change reloads the page instead of hot-swapping the component.</li>
<li class="">Everything else works as usual, including "Use Local Apps" in Manager and the dev server routes.</li>
</ul>
<p>The option only affects <code>serve</code> — <code>build</code> already produces React's production runtime, so it's unaffected. Leave <code>--productionReact</code> off for day-to-day development; turn it on when you need to rule out a dev-only React behavior.</p>
<p>See <a class="" href="https://developers.trackunit.com/docs/apps-and-extensions/overview/getting-started/running-the-iris-app-sdk/">Run your IrisX App</a> for the full walkthrough.</p>]]></content:encoded>
            <category>Improved</category>
        </item>
        <item>
            <title><![CDATA[trackunit/iris-app v2.8.5 - extend generator now scaffolds Vitest, not Jest]]></title>
            <link>https://developers.trackunit.com/changelog/2026/10/01/iris-app-extend-vitest-generator/</link>
            <guid>https://developers.trackunit.com/changelog/2026/10/01/iris-app-extend-vitest-generator/</guid>
            <pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Running npx nx g @trackunit/iris-app:extend now scaffolds your extension's unit tests with Vitest instead of Jest, matching the @trackunit/react-vite-test-setup preset already used elsewhere in the SDK's testing guides.]]></description>
            <content:encoded><![CDATA[<p>Running <code>npx nx g @trackunit/iris-app:extend</code> now scaffolds your extension's unit tests with <strong>Vitest</strong> instead of Jest, matching the <code>@trackunit/react-vite-test-setup</code> preset already used elsewhere in the SDK's testing guides.</p>
<p><strong>Breaking change:</strong> the generator's <code>extendJestPreset</code> option has been removed. If a script or CI step invokes the generator with <code>--extendJestPreset</code>, drop that flag — the generator no longer recognizes it.</p>
<p>For each newly generated extension, the generator now:</p>
<ul>
<li class="">sets <code>unitTestRunner: "vitest"</code> on the generated project instead of <code>"jest"</code></li>
<li class="">writes a type-appropriate <code>vitest.config.ts</code> built on the <code>@trackunit/react-vite-test-setup</code> preset, instead of wiring the extension into the root <code>jest.preset.js</code></li>
<li class="">generates <code>*.spec.tsx</code> / <code>*.spec.ts</code> samples built on <code>trackunitProviders()</code>, as shown in <a class="" href="https://developers.trackunit.com/docs/apps-and-extensions/overview/getting-started/creating-a-new-extension/">Creating a new extension</a></li>
</ul>
<p>Extensions generated before this version, and any Jest configuration they already have, are left untouched — the generator only changes what it writes for new extensions going forward. See <a class="" href="https://developers.trackunit.com/docs/apps-and-extensions/overview/test-iris-apps/">Testing IrisX App</a> for mocking GraphQL calls and runtime hooks under the new setup.</p>]]></content:encoded>
            <category>Improved</category>
        </item>
        <item>
            <title><![CDATA[Breaking: CustomFieldDefinition owner.marketplaceEntry removed — use owner.irisApp]]></title>
            <link>https://developers.trackunit.com/changelog/2026/09/23/custom-field-owner-marketplaceentry-removed/</link>
            <guid>https://developers.trackunit.com/changelog/2026/09/23/custom-field-owner-marketplaceentry-removed/</guid>
            <pubDate>Wed, 23 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[@trackunit/custom-field-api (from 2.20.1) replaces owner.marketplaceEntry with owner.irisApp on every custom field definition returned by useCustomFieldDefinitions, useAllCustomFieldDefinitions, and useCustomFieldsValueAndDefinition — with no compatibility field. If your app reads definition.owner?.marketplaceEntry, bumping the dependency is a compile failure, not a deprecation warning. Apps that only use owner.irisAppId, or don't read owner at all, are unaffected.]]></description>
            <content:encoded><![CDATA[<p><code>@trackunit/custom-field-api</code> (from <code>2.20.1</code>) replaces <code>owner.marketplaceEntry</code> with <code>owner.irisApp</code> on every custom field definition returned by <code>useCustomFieldDefinitions</code>, <code>useAllCustomFieldDefinitions</code>, and <code>useCustomFieldsValueAndDefinition</code> — <strong>with no compatibility field</strong>. If your app reads <code>definition.owner?.marketplaceEntry</code>, bumping the dependency is a compile failure, not a deprecation warning. Apps that only use <code>owner.irisAppId</code>, or don't read <code>owner</code> at all, are unaffected.</p>
<p><em>Updated 2026-10-28: corrected the version. This entry previously said <code>2.20.0</code>, which was never published; the change first shipped in <code>2.20.1</code>.</em></p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="why-this-changed">Why this changed<a href="https://developers.trackunit.com/changelog/2026/09/23/custom-field-owner-marketplaceentry-removed/#why-this-changed" class="hash-link" aria-label="Direct link to Why this changed" title="Direct link to Why this changed" translate="no">​</a></h3>
<p>Custom field ownership is being modeled directly against the owning Iris App rather than its marketplace listing. <code>owner.irisApp</code> carries the same display name as the old <code>marketplaceEntry.name</code>, plus the app's <code>irisAppId</code> alongside it, so you no longer need to cross-reference <code>owner.irisAppId</code> separately to get both the ID and the name in one place.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="when-it-affects-you">When it affects you<a href="https://developers.trackunit.com/changelog/2026/09/23/custom-field-owner-marketplaceentry-removed/#when-it-affects-you" class="hash-link" aria-label="Direct link to When it affects you" title="Direct link to When it affects you" translate="no">​</a></h3>
<p>Nothing changes until you bump <code>@trackunit/custom-field-api</code> to <code>2.20.1</code> or later. At or above that version, <code>owner.marketplaceEntry</code> is gone from the type and from the data returned over the wire — any code reading it stops compiling.</p>
<div class="language-ts codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-ts codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// before</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> ownerName </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> definition</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">owner</span><span class="token operator" style="color:#393A34">?.</span><span class="token plain">marketplaceEntry</span><span class="token operator" style="color:#393A34">?.</span><span class="token plain">name </span><span class="token operator" style="color:#393A34">??</span><span class="token plain"> definition</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">owner</span><span class="token operator" style="color:#393A34">?.</span><span class="token plain">irisAppId</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// after</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> ownerName </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> definition</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">owner</span><span class="token operator" style="color:#393A34">?.</span><span class="token plain">irisApp</span><span class="token operator" style="color:#393A34">?.</span><span class="token plain">name </span><span class="token operator" style="color:#393A34">??</span><span class="token plain"> definition</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">owner</span><span class="token operator" style="color:#393A34">?.</span><span class="token plain">irisAppId</span><span class="token punctuation" style="color:#393A34">;</span><br></div></code></pre></div></div>
<p>See <a class="" href="https://developers.trackunit.com/docs/apps-and-extensions/overview/save-data-from-your-app/using-a-custom-field/">Using a Custom Field</a> for the full hook reference.</p>]]></content:encoded>
            <category>Removed</category>
        </item>
        <item>
            <title><![CDATA[New: useHold hook and Drawer isExiting for content that survives the exit animation]]></title>
            <link>https://developers.trackunit.com/changelog/2026/09/17/usehold-drawer-isexiting/</link>
            <guid>https://developers.trackunit.com/changelog/2026/09/17/usehold-drawer-isexiting/</guid>
            <pubDate>Thu, 17 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Drawer callsites that clear their selected value on close (e.g. isOpen={Boolean(selectedRow)}) used to hand-roll a useRef/useState "last non-null value" snapshot just to keep the panel's content visible through the ~400ms exit slide — otherwise it blanked instantly. @trackunit/react-components and @trackunit/react-drawer now ship a shared primitive for this.]]></description>
            <content:encoded><![CDATA[<p>Drawer callsites that clear their selected value on close (e.g. <code>isOpen={Boolean(selectedRow)}</code>) used to hand-roll a <code>useRef</code>/<code>useState</code> "last non-null value" snapshot just to keep the panel's content visible through the ~400ms exit slide — otherwise it blanked instantly. <code>@trackunit/react-components</code> and <code>@trackunit/react-drawer</code> now ship a shared primitive for this.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="new-usehold-hook">New: <code>useHold</code> hook<a href="https://developers.trackunit.com/changelog/2026/09/17/usehold-drawer-isexiting/#new-usehold-hook" class="hash-link" aria-label="Direct link to new-usehold-hook" title="Direct link to new-usehold-hook" translate="no">​</a></h2>
<p><code>useHold&lt;T&gt;(value: T, isExiting: boolean): T</code>, exported from <code>@trackunit/react-components</code>. It freezes <code>value</code> at its last snapshot while <code>isExiting</code> is <code>true</code>, and releases it back to the live value the instant <code>isExiting</code> flips to <code>false</code>. It's a standalone, overlay-agnostic hook — no dependency on <code>Drawer</code>, <code>Sheet</code>, or <code>Modal</code>.</p>
<div class="language-tsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-tsx codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token imports punctuation" style="color:#393A34">{</span><span class="token imports"> useHold </span><span class="token imports punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@trackunit/react-components"</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> heldRow </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">useHold</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">selectedRow</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> drawer</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">isExiting</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><br></div></code></pre></div></div>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="new-isexiting-on-usedrawer">New: <code>isExiting</code> on <code>useDrawer</code><a href="https://developers.trackunit.com/changelog/2026/09/17/usehold-drawer-isexiting/#new-isexiting-on-usedrawer" class="hash-link" aria-label="Direct link to new-isexiting-on-usedrawer" title="Direct link to new-isexiting-on-usedrawer" translate="no">​</a></h2>
<p><code>useDrawer()</code>'s return value gains <code>isExiting: boolean</code> — <code>true</code> from the moment a close is committed until the exit animation genuinely completes, derived from <code>Drawer</code>'s existing internal exit-complete signal. Feed it straight into <code>useHold</code>:</p>
<div class="language-tsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-tsx codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token imports punctuation" style="color:#393A34">{</span><span class="token imports"> </span><span class="token imports maybe-class-name">Drawer</span><span class="token imports punctuation" style="color:#393A34">,</span><span class="token imports"> useDrawer </span><span class="token imports punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@trackunit/react-drawer"</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token imports punctuation" style="color:#393A34">{</span><span class="token imports"> useHold </span><span class="token imports punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">from</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"@trackunit/react-components"</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> drawer </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">useDrawer</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> isOpen</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> selectedRow </span><span class="token operator" style="color:#393A34">!=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">null</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">const</span><span class="token plain"> heldRow </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">useHold</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">selectedRow</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> drawer</span><span class="token punctuation" style="color:#393A34">.</span><span class="token property-access">isExiting</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag class-name" style="color:#00009f">Drawer</span><span class="token tag" style="color:#00009f"> </span><span class="token tag spread punctuation" style="color:#393A34">{</span><span class="token tag spread operator" style="color:#393A34">...</span><span class="token tag spread" style="color:#00009f">drawer</span><span class="token tag spread punctuation" style="color:#393A34">}</span><span class="token tag" style="color:#00009f"> </span><span class="token tag attr-name" style="color:#00a4db">ariaLabel</span><span class="token tag attr-value punctuation attr-equals" style="color:#393A34">=</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag attr-value" style="color:#e3116c">Details</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain-text">  </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">heldRow </span><span class="token operator" style="color:#393A34">&amp;&amp;</span><span class="token plain"> </span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag class-name" style="color:#00009f">DetailsBody</span><span class="token tag" style="color:#00009f"> </span><span class="token tag attr-name" style="color:#00a4db">row</span><span class="token tag script language-javascript script-punctuation punctuation" style="color:#393A34">=</span><span class="token tag script language-javascript punctuation" style="color:#393A34">{</span><span class="token tag script language-javascript" style="color:#00009f">heldRow</span><span class="token tag script language-javascript punctuation" style="color:#393A34">}</span><span class="token tag" style="color:#00009f"> </span><span class="token tag punctuation" style="color:#393A34">/&gt;</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain-text"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain-text"></span><span class="token tag punctuation" style="color:#393A34">&lt;/</span><span class="token tag class-name" style="color:#00009f">Drawer</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">;</span><br></div></code></pre></div></div>
<p>Closing the drawer now plays its full exit slide with the last-selected content still visible, instead of blanking as soon as the selection clears.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="where-to-look">Where to look<a href="https://developers.trackunit.com/changelog/2026/09/17/usehold-drawer-isexiting/#where-to-look" class="hash-link" aria-label="Direct link to Where to look" title="Direct link to Where to look" translate="no">​</a></h2>
<ul>
<li class=""><code>libs/react/drawer/README.md</code>'s "Surviving the exit animation" section documents this as the recommended pattern for Pattern B/C drawer callers.</li>
<li class="">Storybook: <code>useHold</code>'s own docs/stories in <code>@trackunit/react-components</code>, and a <code>HoldDuringExit</code> story on <code>Drawer</code>.</li>
</ul>]]></content:encoded>
            <category>Added</category>
        </item>
        <item>
            <title><![CDATA[Breaking: CopyableText and CopyableCell removed — use CopyButton or CopyableValue]]></title>
            <link>https://developers.trackunit.com/changelog/2026/09/16/copyabletext-copyablecell-removed/</link>
            <guid>https://developers.trackunit.com/changelog/2026/09/16/copyabletext-copyablecell-removed/</guid>
            <pubDate>Wed, 16 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[@trackunit/react-components (from 3.0.1) removes CopyableText, and @trackunit/react-table-base-components (from 2.8.1, a minor release) removes CopyableCell, with no compatibility shim — if any of your code imports either, bumping the dependency without running the migration is a compile failure, not a deprecation warning. Repos that never used them are unaffected.]]></description>
            <content:encoded><![CDATA[<p><code>@trackunit/react-components</code> (from <code>3.0.1</code>) removes <code>CopyableText</code>, and <code>@trackunit/react-table-base-components</code> (from <code>2.8.1</code>, a minor release) removes <code>CopyableCell</code>, <strong>with no compatibility shim</strong> — if any of your code imports either, bumping the dependency without running the migration is a compile failure, not a deprecation warning. Repos that never used them are unaffected.</p>
<p><em>Updated 2026-10-07: corrected the versions (this entry previously said <code>3.0.0</code> for both packages) and the <code>CopyableCell</code> migration, which now produces <code>CopyableValue</code> from <code>@trackunit/react-table-base-components</code> <code>2.12.1</code>.</em></p>
<p>Run these two commands in the consuming repo after bumping the dependencies:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">nx g @trackunit/migrations:migrate</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">nx g @trackunit/migrations:run-migrations</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="why-this-changed">Why this changed<a href="https://developers.trackunit.com/changelog/2026/09/16/copyabletext-copyablecell-removed/#why-this-changed" class="hash-link" aria-label="Direct link to Why this changed" title="Direct link to Why this changed" translate="no">​</a></h3>
<p>Click-to-copy text had two problems every surface kept re-fixing: the displayed value was itself the click target (so selecting the text copied it by accident, and clickable rows had to fight the copy area), and each call site hand-rolled its own labels and feedback. <code>CopyButton</code> is now the one copy control: the value renders as plain, selectable text and only the adjacent icon button copies it, with localized "Copy"/"Copied!" defaults, a persistent checkmark confirmation, and an accessible per-instance label via <code>copyLabel</code>. <code>CopyableValue</code> (from <code>@trackunit/react-components</code> <code>3.7.0</code>) packages that value-plus-button pair as a single component.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="when-it-affects-you">When it affects you<a href="https://developers.trackunit.com/changelog/2026/09/16/copyabletext-copyablecell-removed/#when-it-affects-you" class="hash-link" aria-label="Direct link to When it affects you" title="Direct link to When it affects you" translate="no">​</a></h3>
<p>Nothing changes until you bump the packages. At or above <code>@trackunit/react-components</code> <code>3.0.1</code> (<code>CopyableText</code>) or <code>@trackunit/react-table-base-components</code> <code>2.8.1</code> (<code>CopyableCell</code>), the components are gone and any import stops compiling until migrated. Because the table package removal shipped in a minor release, a <code>^2.x</code> range picks it up without an explicit major bump.  When you upgrade <code>@trackunit/react-table-base-components</code> to <code>2.12.1</code> or later, also upgrade <code>@trackunit/react-components</code> to <code>3.7.0</code> or later: the <code>CopyableCell</code> codemod's output imports <code>CopyableValue</code> from it.</p>
<div class="language-tsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-tsx codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// before</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag class-name" style="color:#00009f">CopyableText</span><span class="token tag" style="color:#00009f"> </span><span class="token tag attr-name" style="color:#00a4db">text</span><span class="token tag script language-javascript script-punctuation punctuation" style="color:#393A34">=</span><span class="token tag script language-javascript punctuation" style="color:#393A34">{</span><span class="token tag script language-javascript" style="color:#00009f">assetId</span><span class="token tag script language-javascript punctuation" style="color:#393A34">}</span><span class="token tag" style="color:#00009f"> </span><span class="token tag punctuation" style="color:#393A34">/&gt;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// after</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag" style="color:#00009f">span</span><span class="token tag" style="color:#00009f"> </span><span class="token tag attr-name" style="color:#00a4db">className</span><span class="token tag attr-value punctuation attr-equals" style="color:#393A34">=</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag attr-value" style="color:#e3116c">flex min-w-0 max-w-full items-center gap-0.5</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain-text">  </span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag class-name" style="color:#00009f">Text</span><span class="token tag" style="color:#00009f"> </span><span class="token tag attr-name" style="color:#00a4db">className</span><span class="token tag attr-value punctuation attr-equals" style="color:#393A34">=</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag attr-value" style="color:#e3116c">min-w-0 truncate</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag" style="color:#00009f"> </span><span class="token tag attr-name" style="color:#00a4db">type</span><span class="token tag attr-value punctuation attr-equals" style="color:#393A34">=</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag attr-value" style="color:#e3116c">span</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">assetId</span><span class="token punctuation" style="color:#393A34">}</span><span class="token tag punctuation" style="color:#393A34">&lt;/</span><span class="token tag class-name" style="color:#00009f">Text</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><span class="token plain-text"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain-text">  </span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag class-name" style="color:#00009f">CopyButton</span><span class="token tag" style="color:#00009f"> </span><span class="token tag attr-name" style="color:#00a4db">className</span><span class="token tag attr-value punctuation attr-equals" style="color:#393A34">=</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag attr-value" style="color:#e3116c">shrink-0</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag" style="color:#00009f"> </span><span class="token tag attr-name" style="color:#00a4db">value</span><span class="token tag script language-javascript script-punctuation punctuation" style="color:#393A34">=</span><span class="token tag script language-javascript punctuation" style="color:#393A34">{</span><span class="token tag script language-javascript" style="color:#00009f">assetId</span><span class="token tag script language-javascript punctuation" style="color:#393A34">}</span><span class="token tag" style="color:#00009f"> </span><span class="token tag punctuation" style="color:#393A34">/&gt;</span><span class="token plain-text"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain-text"></span><span class="token tag punctuation" style="color:#393A34">&lt;/</span><span class="token tag" style="color:#00009f">span</span><span class="token tag punctuation" style="color:#393A34">&gt;</span><br></div></code></pre></div></div>
<div class="language-tsx codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-tsx codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// before</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag class-name" style="color:#00009f">CopyableCell</span><span class="token tag" style="color:#00009f"> </span><span class="token tag attr-name" style="color:#00a4db">text</span><span class="token tag script language-javascript script-punctuation punctuation" style="color:#393A34">=</span><span class="token tag script language-javascript punctuation" style="color:#393A34">{</span><span class="token tag script language-javascript" style="color:#00009f">code</span><span class="token tag script language-javascript punctuation" style="color:#393A34">}</span><span class="token tag" style="color:#00009f"> </span><span class="token tag attr-name" style="color:#00a4db">secondary</span><span class="token tag script language-javascript script-punctuation punctuation" style="color:#393A34">=</span><span class="token tag script language-javascript punctuation" style="color:#393A34">{</span><span class="token tag script language-javascript punctuation" style="color:#393A34">{</span><span class="token tag script language-javascript" style="color:#00009f"> text</span><span class="token tag script language-javascript operator" style="color:#393A34">:</span><span class="token tag script language-javascript" style="color:#00009f"> name </span><span class="token tag script language-javascript punctuation" style="color:#393A34">}</span><span class="token tag script language-javascript punctuation" style="color:#393A34">}</span><span class="token tag" style="color:#00009f"> </span><span class="token tag punctuation" style="color:#393A34">/&gt;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// after</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token tag punctuation" style="color:#393A34">&lt;</span><span class="token tag class-name" style="color:#00009f">MultiRowTableCell</span><span class="token tag" style="color:#00009f"></span><br></div><div class="token-line" style="color:#393A34"><span class="token tag" style="color:#00009f">  </span><span class="token tag attr-name" style="color:#00a4db">className</span><span class="token tag attr-value punctuation attr-equals" style="color:#393A34">=</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag attr-value" style="color:#e3116c">w-fit overflow-hidden</span><span class="token tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag" style="color:#00009f"></span><br></div><div class="token-line" style="color:#393A34"><span class="token tag" style="color:#00009f">  </span><span class="token tag attr-name" style="color:#00a4db">main</span><span class="token tag script language-javascript script-punctuation punctuation" style="color:#393A34">=</span><span class="token tag script language-javascript punctuation" style="color:#393A34">{</span><span class="token tag script language-javascript tag punctuation" style="color:#393A34">&lt;</span><span class="token tag script language-javascript tag class-name" style="color:#00009f">CopyableValue</span><span class="token tag script language-javascript tag" style="color:#00009f"> </span><span class="token tag script language-javascript tag attr-name" style="color:#00a4db">size</span><span class="token tag script language-javascript tag attr-value punctuation attr-equals" style="color:#393A34">=</span><span class="token tag script language-javascript tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag script language-javascript tag attr-value" style="color:#e3116c">extraSmall</span><span class="token tag script language-javascript tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag script language-javascript tag" style="color:#00009f"> </span><span class="token tag script language-javascript tag attr-name" style="color:#00a4db">value</span><span class="token tag script language-javascript tag script language-javascript script-punctuation punctuation" style="color:#393A34">=</span><span class="token tag script language-javascript tag script language-javascript punctuation" style="color:#393A34">{</span><span class="token tag script language-javascript tag script language-javascript" style="color:#00009f">code</span><span class="token tag script language-javascript tag script language-javascript punctuation" style="color:#393A34">}</span><span class="token tag script language-javascript tag" style="color:#00009f"> </span><span class="token tag script language-javascript tag punctuation" style="color:#393A34">/&gt;</span><span class="token tag script language-javascript punctuation" style="color:#393A34">}</span><span class="token tag" style="color:#00009f"></span><br></div><div class="token-line" style="color:#393A34"><span class="token tag" style="color:#00009f">  </span><span class="token tag attr-name" style="color:#00a4db">secondary</span><span class="token tag script language-javascript script-punctuation punctuation" style="color:#393A34">=</span><span class="token tag script language-javascript punctuation" style="color:#393A34">{</span><span class="token tag script language-javascript tag punctuation" style="color:#393A34">&lt;</span><span class="token tag script language-javascript tag class-name" style="color:#00009f">CopyableValue</span><span class="token tag script language-javascript tag" style="color:#00009f"> </span><span class="token tag script language-javascript tag attr-name" style="color:#00a4db">size</span><span class="token tag script language-javascript tag attr-value punctuation attr-equals" style="color:#393A34">=</span><span class="token tag script language-javascript tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag script language-javascript tag attr-value" style="color:#e3116c">extraSmall</span><span class="token tag script language-javascript tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag script language-javascript tag" style="color:#00009f"> </span><span class="token tag script language-javascript tag attr-name" style="color:#00a4db">textSize</span><span class="token tag script language-javascript tag attr-value punctuation attr-equals" style="color:#393A34">=</span><span class="token tag script language-javascript tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag script language-javascript tag attr-value" style="color:#e3116c">small</span><span class="token tag script language-javascript tag attr-value punctuation" style="color:#393A34">"</span><span class="token tag script language-javascript tag" style="color:#00009f"> </span><span class="token tag script language-javascript tag attr-name" style="color:#00a4db">value</span><span class="token tag script language-javascript tag script language-javascript script-punctuation punctuation" style="color:#393A34">=</span><span class="token tag script language-javascript tag script language-javascript punctuation" style="color:#393A34">{</span><span class="token tag script language-javascript tag script language-javascript" style="color:#00009f">name</span><span class="token tag script language-javascript tag script language-javascript punctuation" style="color:#393A34">}</span><span class="token tag script language-javascript tag" style="color:#00009f"> </span><span class="token tag script language-javascript tag punctuation" style="color:#393A34">/&gt;</span><span class="token tag script language-javascript punctuation" style="color:#393A34">}</span><span class="token tag" style="color:#00009f"></span><br></div><div class="token-line" style="color:#393A34"><span class="token tag" style="color:#00009f"></span><span class="token tag punctuation" style="color:#393A34">/&gt;</span><br></div></code></pre></div></div>
<p>A single-row <code>CopyableCell</code> becomes just <code>&lt;CopyableValue size="extraSmall" value={…} /&gt;</code>.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="what-the-migration-does">What the migration does<a href="https://developers.trackunit.com/changelog/2026/09/16/copyabletext-copyablecell-removed/#what-the-migration-does" class="hash-link" aria-label="Direct link to What the migration does" title="Direct link to What the migration does" translate="no">​</a></h3>
<ul>
<li class="">The <code>CopyableText</code> codemod rewrites it into the <code>Text</code> + <code>CopyButton</code> pair above, carrying over <code>copyLabel</code>, <code>copiedLabel</code>, <code>data-testid</code>, <code>style</code>, and string-literal classNames. <code>size="xs"</code> maps to <code>Text size="small"</code> plus <code>CopyButton size="extraSmall"</code> (the icon-only size that fits a single text line in fixed-height rows).</li>
<li class="">The <code>CopyableCell</code> codemod (<code>@trackunit/react-table-base-components:v2-8-0-copyablecell-to-copyablevalue</code>) rewrites it into <code>CopyableValue</code> as shown above, carrying over <code>data-testid</code>.</li>
<li class="">Any usage the codemods can't rewrite with confidence is <strong>left untouched and counted as a manual-review location in the migration log</strong> rather than guessed at: spread props, <code>ref</code>s, dynamic <code>className</code> expressions, any <code>className</code> on <code>CopyableCell</code>, <code>secondary</code> values that aren't inline object literals, and files referencing the removed <code>CopyableTextProps</code>/<code>CopyableCellProps</code> types.</li>
<li class=""><strong>The detail most likely to bite you:</strong> in the <code>CopyableText</code> output, the <code>text</code> expression appears twice — once as the rendered children and once as the button's <code>value</code>. That is fine for identifiers and literals; if you passed a function call or other non-trivial expression, hoist it to a variable after migrating.</li>
</ul>
<p>If you already migrated <code>CopyableCell</code> with an earlier release of the codemod, your cells use the <code>Text</code> + <code>CopyButton</code> pair instead of <code>CopyableValue</code>. That code is valid and needs no change. The updated codemod may show up as pending in <code>trackunit-migrations.json</code>; once no <code>CopyableCell</code> remains, running it changes nothing.</p>
<p><code>CopyButton</code> and <code>CopyableValue</code> ship localized default labels, so most call sites need no <code>copyLabel</code> at all — pass one only when the context needs a specific accessible name (for example one button per table row, where each should announce what it copies).</p>]]></content:encoded>
            <category>Removed</category>
        </item>
        <item>
            <title><![CDATA[Breaking: cva 1.0 upgrade removes cvaMerge from @trackunit/css-class-variance-utilities]]></title>
            <link>https://developers.trackunit.com/changelog/2026/09/08/cva-1-0-upgrade/</link>
            <guid>https://developers.trackunit.com/changelog/2026/09/08/cva-1-0-upgrade/</guid>
            <pubDate>Tue, 08 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[@trackunit/css-class-variance-utilities (from 2.0.0) has upgraded to the upstream cva@1.0.0-beta.8 package. cvaMerge is removed with no compatibility shim — if any of your code calls it, bumping this dependency without running the migration is a compile failure, not a deprecation warning. Repos that never called cvaMerge are unaffected.]]></description>
            <content:encoded><![CDATA[<p><code>@trackunit/css-class-variance-utilities</code> (from <code>2.0.0</code>) has upgraded to the upstream <a href="https://cva.style/beta" target="_blank" rel="noopener noreferrer" class=""><code>cva@1.0.0-beta.8</code></a> package. <code>cvaMerge</code> is <strong>removed with no compatibility shim</strong> — if any of your code calls it, bumping this dependency without running the migration is a compile failure, not a deprecation warning. Repos that never called <code>cvaMerge</code> are unaffected.</p>
<p>Run these two commands in the consuming repo after bumping the dependency:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">nx g @trackunit/migrations:migrate</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">nx g @trackunit/migrations:run-migrations</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="why-this-changed">Why this changed<a href="https://developers.trackunit.com/changelog/2026/09/08/cva-1-0-upgrade/#why-this-changed" class="hash-link" aria-label="Direct link to Why this changed" title="Direct link to Why this changed" translate="no">​</a></h3>
<p><code>cvaMerge</code> was a hand-written wrapper around <code>class-variance-authority</code> that merged conflicting Tailwind classes. <code>cva@1.0</code> ships that integration natively via <code>defineConfig({ hooks: { onComplete } })</code>, so the custom wrapper became maintenance we don't need to carry. <code>cva</code> is now a thin wrapper over the upstream <code>cva</code> package with <a href="https://github.com/dcastil/tailwind-merge" target="_blank" rel="noopener noreferrer" class=""><code>tailwind-merge</code></a> wired into its <code>onComplete</code> hook — callers should stop calling <code>twMerge</code> themselves, since <code>cx</code> and <code>compose</code> resolve conflicts automatically.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="when-it-affects-you">When it affects you<a href="https://developers.trackunit.com/changelog/2026/09/08/cva-1-0-upgrade/#when-it-affects-you" class="hash-link" aria-label="Direct link to When it affects you" title="Direct link to When it affects you" translate="no">​</a></h3>
<p>Nothing changes until you bump <code>@trackunit/css-class-variance-utilities</code>. At or above <code>2.0.0</code>, <code>cvaMerge</code> is gone and any call site still using the old shape stops compiling until migrated.</p>
<p>The old call took the base classes as a positional argument; <code>cva</code> takes a single config object with a <code>base</code> property:</p>
<div class="language-ts codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-ts codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// before</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token function" style="color:#d73a49">cvaMerge</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">[</span><span class="token string" style="color:#e3116c">"grid"</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"h-full"</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> variants</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">...</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// after</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token function" style="color:#d73a49">cva</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> base</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token string" style="color:#e3116c">"grid"</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"h-full"</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> variants</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">...</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="what-the-migration-does">What the migration does<a href="https://developers.trackunit.com/changelog/2026/09/08/cva-1-0-upgrade/#what-the-migration-does" class="hash-link" aria-label="Direct link to What the migration does" title="Direct link to What the migration does" translate="no">​</a></h3>
<ul>
<li class=""><code>migrate</code> discovers the package's pending migration and writes it to <code>trackunit-migrations.json</code>. <code>run-migrations</code> applies it. A second run is a no-op — already-applied identities are recorded and skipped.</li>
<li class="">The codemod rewrites the imports and the call shape, preserving comments and formatting.</li>
<li class="">Any call site it can't rewrite with confidence — a base or config built at runtime, or an aliased import — is <strong>reported with its file and line rather than guessed at</strong>. Fix those by hand.</li>
<li class=""><strong>What it does not fix — <code>null</code> variant props.</strong> <code>cva 0.7</code> accepted <code>null</code> for a variant prop and suppressed that variant; <code>cva 1.0</code>'s types reject <code>null</code>, and at runtime <code>null</code> falls through to the variant's <code>defaultVariants</code> entry. The codemod rewrites variant <em>definitions</em>, not their consumers, so these surface as type errors after migrating. <code>undefined</code> is the replacement, but the two are only equivalent when that variant key has <strong>no</strong> <code>defaultVariants</code> entry — where a default exists, <code>undefined</code> silently applies the default class instead of no class. This bit us at two call sites internally, and it's the detail most likely to bite you too.</li>
</ul>
<p>For the <code>.variants.ts</code> authoring guide, see Storybook <a href="https://design.iris.trackunit.com/?path=/docs/foundations-styling-variants--docs" target="_blank" rel="noopener noreferrer" class="">Foundations → Styling variants</a>.</p>]]></content:encoded>
            <category>Removed</category>
        </item>
        <item>
            <title><![CDATA[New `connection.view`, `connection.manage`, `partner.view`, and `partner.manage` scopes]]></title>
            <link>https://developers.trackunit.com/changelog/2026/09/03/connection-partner-account-scopes/</link>
            <guid>https://developers.trackunit.com/changelog/2026/09/03/connection-partner-account-scopes/</guid>
            <pubDate>Thu, 03 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Your app can now request four new manifest scopes to check an account's connections and partnerships through the public GraphQL API: connection.view, connection.manage, partner.view, and partner.manage.]]></description>
            <content:encoded><![CDATA[<p>Your app can now request four new manifest scopes to check an account's connections and partnerships through the public GraphQL API: <code>connection.view</code>, <code>connection.manage</code>, <code>partner.view</code>, and <code>partner.manage</code>.</p>
<p>Declare the scope your app needs in <code>iris-app-manifest.ts</code>, then query the corresponding action under <code>Account.actions</code>:</p>
<div class="language-graphql codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-graphql codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">query</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token property-query">account</span><span class="token punctuation" style="color:#393A34">(</span><span class="token attr-name" style="color:#00a4db">id</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">"..."</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token object">actions</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token object">viewConnections</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token property" style="color:#36acaa">allowed</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token object">manageConnections</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token property" style="color:#36acaa">allowed</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token object">viewPartners</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token property" style="color:#36acaa">allowed</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token object">managePartners</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token property" style="color:#36acaa">allowed</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></div></code></pre></div></div>
<p>If your manifest previously declared <code>account.partner.manage</code> expecting it to gate <code>managePartners</code>, switch to the new unprefixed <code>partner.manage</code> — the <code>account.</code>-prefixed scope doesn't satisfy this action's authorization check. <code>account.partner.manage</code> remains a valid, separately-scoped manifest entry for other purposes.</p>
<p>See the <a class="" href="https://developers.trackunit.com/docs/apps-and-extensions/overview/iris-app-sdk-reference/app-manifest/#available-scopes">available scopes reference</a> for the full scope list.</p>]]></content:encoded>
            <category>Added</category>
        </item>
        <item>
            <title><![CDATA[trackunit/iris-app v2.6.0 - new AI agent skill for Databricks Unity Catalog access]]></title>
            <link>https://developers.trackunit.com/changelog/2026/09/03/databricks-unity-catalog-agent-skill/</link>
            <guid>https://developers.trackunit.com/changelog/2026/09/03/databricks-unity-catalog-agent-skill/</guid>
            <pubDate>Thu, 03 Sep 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[New Iris App workspaces now scaffold a databricks-unity-catalog skill under .agents/skills/, alongside the existing graphql, create-app, and other skills. It guides Claude, Cursor, and other coding agents through building a SERVERSIDEAPIEXTENSION that reads or writes customer-uploaded or app-owned tables in your IrisX Analytics Unity Catalog workspace — for data that Trackunit's GraphQL API can't serve.]]></description>
            <content:encoded><![CDATA[<p>New Iris App workspaces now scaffold a <code>databricks-unity-catalog</code> skill under <code>.agents/skills/</code>, alongside the existing <code>graphql</code>, <code>create-app</code>, and other skills. It guides Claude, Cursor, and other coding agents through building a <code>SERVERSIDE_API_EXTENSION</code> that reads or writes customer-uploaded or app-owned tables in your IrisX Analytics Unity Catalog workspace — for data that Trackunit's GraphQL API can't serve.</p>
<p>The skill covers the parts that are easy to get wrong when wiring up Unity Catalog access: confirming the right catalog against the app creator's IrisX workspace rather than the invoking user's, adding the exact Databricks workspace hostname to <code>cspHeader['connect-src']</code> in <code>iris-app-manifest.ts</code> (required for the extension's server-side network sandbox, not just browser CSP), reading the <code>DATABRICKS_*</code> app-level secrets Trackunit provisions, and validating any identifier before it reaches a SQL statement.</p>
<p>Existing workspaces can pull it in with:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">nx g @trackunit/iris-app:ai-agent-sync</span><br></div></code></pre></div></div>
<p>This requires <code>@trackunit/iris-app</code> to be at its latest version — the generator errors out with upgrade instructions if it isn't.</p>]]></content:encoded>
            <category>Added</category>
        </item>
        <item>
            <title><![CDATA[Outdated `@trackunit/*` dependency warning now points to the migrations generator]]></title>
            <link>https://developers.trackunit.com/changelog/2026/08/28/iris-app-migrations-upgrade-guidance/</link>
            <guid>https://developers.trackunit.com/changelog/2026/08/28/iris-app-migrations-upgrade-guidance/</guid>
            <pubDate>Fri, 28 Aug 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[If your Iris App build warned you about outdated @trackunit/* dependencies, it used to tell you to reach for npm-check-updates — a command that never actually applied our migrations, leaving you on a path that didn't work. That warning now points at the right tool.]]></description>
            <content:encoded><![CDATA[<p>If your Iris App build warned you about outdated <code>@trackunit/*</code> dependencies, it used to tell you to reach for <code>npm-check-updates</code> — a command that never actually applied our migrations, leaving you on a path that didn't work. That warning now points at the right tool.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="what-changed">What changed<a href="https://developers.trackunit.com/changelog/2026/08/28/iris-app-migrations-upgrade-guidance/#what-changed" class="hash-link" aria-label="Direct link to What changed" title="Direct link to What changed" translate="no">​</a></h3>
<p><em>Updated 2026-10-28: corrected the versions (this entry previously said <code>v2.4.25</code> and <code>v2.5.26</code>) and removed the claim that new workspaces get an <code>update:trackunit</code> script; they don't.</em></p>
<p>The outdated-dependency check in <code>@trackunit/iris-app-build-utilities</code> (from v2.4.19) now recommends the <code>@trackunit/migrations</code> generator instead of <code>npm-check-updates</code>:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token function" style="color:#d73a49">npm</span><span class="token plain"> i </span><span class="token parameter variable" style="color:#36acaa">-D</span><span class="token plain"> @trackunit/migrations   </span><span class="token comment" style="color:#999988;font-style:italic"># only needed once</span><span class="token plain"></span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nx g @trackunit/migrations:migrate</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nx g @trackunit/migrations:run-migrations</span><br></div></code></pre></div></div>
<p><code>migrate</code> updates every <code>@trackunit/*</code> dependency in your <code>package.json</code> and installs them; <code>run-migrations</code> then applies any code migrations those new versions ship.</p>
<p>Workspaces scaffolded with <code>@trackunit/iris-app</code> v2.5.20 or later come with <code>@trackunit/migrations</code> already added as a devDependency, so the command in the warning works immediately. They no longer get an <code>update:trackunit</code> script. If your workspace predates this, add the package once as shown above — an <code>update:trackunit</code> script you already have (for example one calling <code>npm-check-updates</code> from CI) is left as-is, so nothing breaks under you.</p>
<p>See <a class="" href="https://developers.trackunit.com/docs/apps-and-extensions/overview/iris-app-sdk-reference/maintaining-your-app/">Maintaining Your Application</a> for the full upgrade guide.</p>]]></content:encoded>
            <category>Fixed</category>
        </item>
        <item>
            <title><![CDATA[Iris Apps opt into AI navigation with @trackunit/iris-app-api 2.4.0]]></title>
            <link>https://developers.trackunit.com/changelog/2026/08/25/ai-navigation/</link>
            <guid>https://developers.trackunit.com/changelog/2026/08/25/ai-navigation/</guid>
            <pubDate>Tue, 25 Aug 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Your extensions can now describe their own pages to Trackunit Manager's AI assistant. Add an]]></description>
            <content:encoded><![CDATA[<p>Your extensions can now describe their own pages to Trackunit Manager's AI assistant. Add an
<code>aiNavigation</code> field to a manifest — a list of in-app routes, each with a <code>path</code>, a <code>title</code>, and a
<code>description</code> — and the assistant can take a user straight to the page inside your app that answers
their question instead of dropping them on its root.</p>
<p>This works today for every extension type that has a page a user can land on: <strong>Fleet</strong>, <strong>Admin</strong>,
<strong>App Settings</strong>, <strong>Asset Home</strong>, <strong>Site Home</strong>, <strong>Customer Home</strong>, and <strong>Asset Events Actions</strong>. The
field is opt-in and purely additive — apps that don't declare it behave exactly as before.</p>
<p>See <a class="" href="https://developers.trackunit.com/docs/apps-and-extensions/overview/getting-started/extension-points/#ai-navigation">Extension Point Types — AI navigation</a>
for the full reference: the manifest shape, both Tanstack Router styles, and in-app paths for
entity-scoped extensions.</p>
<p>If your app routes with Tanstack Router you don't have to keep a second copy of your routes in the
manifest. Annotate the routes you want to expose with <code>staticData.aiNavigation</code> and derive the field
with <code>extractAiNavigationFromTanstackRouter(routeTree)</code>. Routes without the annotation are skipped, so
you opt in page by page.</p>
<p><code>@trackunit/iris-app-api</code> 2.4.0 also ships a migration that does the mechanical part of that setup: it
adds the <code>staticData.aiNavigation</code> type augmentation to your router and derives <code>aiNavigation</code> from
your route tree in navigable extension manifests. Annotating individual routes is left to you.</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">nx g @trackunit/migrations:migrate</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">nx g @trackunit/migrations:run-migrations</span><br></div></code></pre></div></div>
<p><strong>Included migration</strong></p>
<ul>
<li class=""><code>v2-4-0-add-ai-navigation</code> (from <code>@trackunit/iris-app-api</code> 2.4.0) — only touches extension types
that support <code>aiNavigation</code> and leaves everything else untouched.</li>
</ul>]]></content:encoded>
            <category>Added</category>
        </item>
        <item>
            <title><![CDATA[Iris Apps — content owns padding from @trackunit/iris-app 2.5.13 (Asset Home / Site Home / Admin)]]></title>
            <link>https://developers.trackunit.com/changelog/2026/08/20/iris-app-content-owns-padding/</link>
            <guid>https://developers.trackunit.com/changelog/2026/08/20/iris-app-content-owns-padding/</guid>
            <pubDate>Thu, 20 Aug 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[Manager is moving content inset for Asset Home, Site Home, and Admin extension iframes]]></description>
            <content:encoded><![CDATA[<p>Manager is moving content inset for <strong>Asset Home</strong>, <strong>Site Home</strong>, and <strong>Admin</strong> extension iframes
onto each app. After you upgrade <code>@trackunit/iris-app</code> to <strong>2.5.13 or later</strong>, the host stops
applying its transitional <code>1rem</code> inset. Your extension must pad itself with <code>p-content-space</code> on the
scrollable content region (or intentionally stay edge-to-edge).</p>
<p>Run the automated migration <strong>before or as part of</strong> that SDK upgrade — not as optional cleanup
afterward. It ships as <code>v2-5-12-p-content-space-codemod</code> in <code>@trackunit/iris-app</code> 2.5.13.</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><div class="token-line" style="color:#393A34"><span class="token plain">npx nx g @trackunit/migrations:migrate</span><br></div><div class="token-line" style="color:#393A34"><span class="token plain">npx nx g @trackunit/migrations:run-migrations</span><br></div></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="why-this-changed">Why this changed<a href="https://developers.trackunit.com/changelog/2026/08/20/iris-app-content-owns-padding/#why-this-changed" class="hash-link" aria-label="Direct link to Why this changed" title="Direct link to Why this changed" translate="no">​</a></h3>
<p>The host used to pad those three extension iframes for you. That fought flush headers, side-panel
layouts, and correct scrollbars. Content now owns its own inset via <code>p-content-space</code> — the same
utility host pages use. <strong>Fleet and Customer Home were always flush</strong> and are unaffected by inset
removal (they still get the <code>page-content</code> → <code>p-content-space</code> class swap if you use <code>page-content</code>).</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="when-it-affects-you">When it affects you<a href="https://developers.trackunit.com/changelog/2026/08/20/iris-app-content-owns-padding/#when-it-affects-you" class="hash-link" aria-label="Direct link to When it affects you" title="Direct link to When it affects you" translate="no">​</a></h3>
<p>Nothing changes until you rebuild and publish with <code>@trackunit/iris-app</code> <strong>2.5.13 or later</strong>. That
is the first published SDK that ships this change: at or above it, Asset/Site/Admin hosts apply
no inset, regardless of whether you have added your own padding. Upgrading without adopting
<code>p-content-space</code> on those surfaces makes the pages go edge-to-edge. The Iris App build prints a
warning if the cutoff is crossed and the app source does not reference <code>p-content-space</code>.</p>
<p>Apps that never rebuild keep the host inset until <strong>2027-08-20</strong>. After that sunset date the host
applies none, even if the app was built against an older SDK.</p>
<p>If you already self-pad with <code>p-content-space</code>, you are unaffected by inset removal.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="what-the-migration-does">What the migration does<a href="https://developers.trackunit.com/changelog/2026/08/20/iris-app-content-owns-padding/#what-the-migration-does" class="hash-link" aria-label="Direct link to What the migration does" title="Direct link to What the migration does" translate="no">​</a></h3>
<ul>
<li class="">Rewrites known <code>page-content</code> patterns to <code>overflow-auto p-content-space</code> (slightly less padding on
large viewports than the old responsive step-up — flat <code>1rem</code>).</li>
<li class="">Invents or converts <code>p-content-space</code> on high-confidence <strong>inventable overflow content shells</strong>.</li>
<li class="">Never edits your manifest.</li>
<li class=""><strong>Reports</strong> surfaces it cannot safely resolve instead of guessing.</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="inventable-overflow-content-shell">Inventable overflow content shell<a href="https://developers.trackunit.com/changelog/2026/08/20/iris-app-content-owns-padding/#inventable-overflow-content-shell" class="hash-link" aria-label="Direct link to Inventable overflow content shell" title="Direct link to Inventable overflow content shell" translate="no">​</a></h3>
<p>Auto-invent only runs when the migration can point at one clear page box — the scroll owner inside
the iframe (the same region the host used to inset):</p>
<ol>
<li class="">A <code>div</code> / <code>main</code> / <code>section</code> with an editable <code>className</code> (not a bare design-system <code>Card</code> or
opaque custom root).</li>
<li class="">That element itself owns scrolling (<code>overflow-auto</code> / <code>overflow-y-auto</code> / <code>scroll</code>).</li>
<li class="">One candidate — not multi-route graphs with competing shells, and not a shell that also hosts
<code>PageHeader</code> / <code>Topbar</code> / <code>Header</code> (headers stay flush; pad the body below).</li>
</ol>
<p>If invent cannot find that shape, console output lists the extension and explains why. That is
normal for card-only UIs, multi-route apps, and intentional full-bleed surfaces. Add
<code>p-content-space</code> manually on the correct scroll owner, or keep the surface edge-to-edge on purpose.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="incidental-padding-size-note">Incidental padding-size note<a href="https://developers.trackunit.com/changelog/2026/08/20/iris-app-content-owns-padding/#incidental-padding-size-note" class="hash-link" aria-label="Direct link to Incidental padding-size note" title="Direct link to Incidental padding-size note" translate="no">​</a></h3>
<p>Even Fleet/Customer-only apps that use <code>page-content</code> will see the class swap’s flat <code>1rem</code> (and
explicit <code>overflow-auto</code>) instead of the old responsive <code>1rem</code> → <code>1.5rem</code> step. That is independent
of inset removal.</p>]]></content:encoded>
            <category>Improved</category>
        </item>
    </channel>
</rss>