# Kida 0.2.2

URL: /releases/0.2.2/
Section: releases
Tags: release, changelog, slots, components, macros, error-codes
Date: 2026-02-18

--------------------------------------------------------------------------------

v0.2.2 Status: Released February 18, 2026. This release improves component composition with named slots and strengthens macro import safety with explicit circular-import detection. Highlights Named slots in &#123;% call %&#125; — Use &#123;% slot name %&#125;...&#123;% end %&#125; inside call blocks and map content to &#123;% slot name %&#125; placeholders in &#123;% def %&#125;. More expressive component APIs — caller() supports default and named slot dispatch (caller(&quot;header_actions&quot;)). Safer macro imports — Direct and transitive circular imports now raise TemplateRuntimeError with K-TPL-003. Slot-aware compiler/analysis passes — Validation and partial evaluation now walk slot bodies in call blocks. Added Named Slots for Call Blocks Kida now supports named slot blocks within &#123;% call %&#125; for multi-region components: &#123;% def card(title) %&#125; &lt;article&gt; &lt;h2&gt;{{ title }}&lt;/h2&gt; &lt;div class=&quot;actions&quot;&gt;&#123;% slot header_actions %&#125;&lt;/div&gt; &lt;div class=&quot;body&quot;&gt;&#123;% slot %&#125;&lt;/div&gt; &lt;/article&gt; &#123;% end %&#125; &#123;% call card(&quot;Settings&quot;) %&#125; &#123;% slot header_actions %&#125;&lt;button&gt;Save&lt;/button&gt;&#123;% end %&#125; &lt;p&gt;Body content.&lt;/p&gt; &#123;% end %&#125; Existing default-slot usage remains compatible. Changed Slot Dispatch in caller() Functions invoked via &#123;% call %&#125; can now read: caller() for default slot content caller(&quot;slot_name&quot;) for named slot content This makes it easier to build composable template components without custom context plumbing. Analysis and Optimization Over Slot Bodies Static analysis and partial-evaluation passes now traverse slot bodies in CallBlock, so slot-contained expressions receive the same checks and transformations as top-level call content. Fixed Circular Macro Imports (K-TPL-003) When using &#123;% from &quot;template.html&quot; import macro_name %&#125;, direct and transitive cycles are now detected and reported as a clear TemplateRuntimeError: Code: K-TPL-003 Message: Circular import detected This replaces recursion-driven failures with deterministic, actionable errors. Upgrade Notes No breaking template syntax changes — Existing &#123;% call %&#125; + default slot templates continue to work. Optional migration path — Adopt named slots incrementally where components need multiple insertion regions. Error handling — If you catch TemplateRuntimeError, include code checks for K-TPL-003 where macro imports are dynamic. Links PyPI GitHub Full Changelog

--------------------------------------------------------------------------------

Metadata:
- Word Count: 318
- Reading Time: 2 minutes