From 1900efbdfc6784a0df49af1af1496eb61a22feda Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Tue, 17 Feb 2026 01:22:06 +0000
Subject: [PATCH 1/2] feat: add * structural directive aliases

Co-authored-by: Yanlong Wang <yanlong.wang@naiver.org>
---
 examples/conditionals-and-loops/app.ts |  8 ++++----
 examples/simple-component/app.ts       |  2 +-
 src/protocol.ts                        | 13 ++++++++-----
 3 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/examples/conditionals-and-loops/app.ts b/examples/conditionals-and-loops/app.ts
index 896c25f..b681a31 100644
--- a/examples/conditionals-and-loops/app.ts
+++ b/examples/conditionals-and-loops/app.ts
@@ -7,11 +7,11 @@ import { CivComponent, Reactive, Template, css, html } from 'civ-fe';
     <button @click="list.pop()">Pop Number</button>
     <button @click="list.reverse()">Reverse List</button>
 
-    <ul v-if="show && list.length">
-        <li v-for="item of list">{{ item }}</li>
+    <ul *if="show && list.length">
+        <li *for="item of list">{{ item }}</li>
     </ul>
-    <p v-else-if="list.length">List is not empty, but hidden.</p>
-    <p v-else>List is empty.</p>
+    <p *else-if="list.length">List is not empty, but hidden.</p>
+    <p *else>List is empty.</p>
 </div>
 `)
 export default class ConditionalsAndLoops extends CivComponent {
diff --git a/examples/simple-component/app.ts b/examples/simple-component/app.ts
index 6515cc5..85e0565 100644
--- a/examples/simple-component/app.ts
+++ b/examples/simple-component/app.ts
@@ -13,7 +13,7 @@ export class TodoItem extends CivComponent {
 @ResolveComponents({ TodoItem })
 @Template(html`
 <ol>
-    <TodoItem v-for="item of groceryList" prop:todo="item" />
+    <TodoItem *for="item of groceryList" prop:todo="item" />
 </ol>
 `)
 export default class SimpleComponent extends CivComponent {
diff --git a/src/protocol.ts b/src/protocol.ts
index 9053f68..2df011b 100644
--- a/src/protocol.ts
+++ b/src/protocol.ts
@@ -124,16 +124,16 @@ export function isMagicModel(name: string) {
     return name === `${pseudoNamespacePrefix}model` || name === 'v-model';
 }
 export function isMagicForAttr(name: string) {
-    return name === `${pseudoNamespacePrefix}for` || name === `render:for` || name === 'v-for';
+    return name === `${pseudoNamespacePrefix}for` || name === `render:for` || name === 'v-for' || name === '*for';
 }
 export function isMagicIfAttr(name: string) {
-    return name === `${pseudoNamespacePrefix}if` || name === `render:if` || name === 'v-if';
+    return name === `${pseudoNamespacePrefix}if` || name === `render:if` || name === 'v-if' || name === '*if';
 }
 export function isMagicElifAttr(name: string) {
-    return name === `${pseudoNamespacePrefix}elif` || name === `render:elif` || name === 'v-else-if';
+    return name === `${pseudoNamespacePrefix}elif` || name === `render:elif` || name === 'v-else-if' || name === '*else-if';
 }
 export function isMagicElseAttr(name: string) {
-    return name === `${pseudoNamespacePrefix}else` || name === `render:else` || name === 'v-else';
+    return name === `${pseudoNamespacePrefix}else` || name === `render:else` || name === 'v-else' || name === '*else';
 }
 export function isMagicHTMLAttr(name: string) {
     return name === `${pseudoNamespacePrefix}html` || name === `render:html` || name === 'v-html';
@@ -215,7 +215,10 @@ export function attrToTrait(attrName: string, expr: string): Traits[number] | un
 }
 
 export function isMagicForTemplateElement(elem: Element) {
-    return elem.hasAttribute(`${pseudoNamespacePrefix}for`) || elem.hasAttribute('v-for');
+    return elem.hasAttribute(`${pseudoNamespacePrefix}for`) ||
+        elem.hasAttribute('render:for') ||
+        elem.hasAttribute('v-for') ||
+        elem.hasAttribute('*for');
 }
 
 export const attachedEventName = `${pseudoNamespacePrefix}attached`;

From d1b3c24ac198069122f69538957133652e4b52c7 Mon Sep 17 00:00:00 2001
From: Cursor Agent <cursoragent@cursor.com>
Date: Tue, 17 Feb 2026 01:25:04 +0000
Subject: [PATCH 2/2] feat: prioritize star structural aliases

Co-authored-by: Yanlong Wang <yanlong.wang@naiver.org>
---
 src/civ-component.ts | 29 +++++++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/src/civ-component.ts b/src/civ-component.ts
index ee562de..21aeda0 100644
--- a/src/civ-component.ts
+++ b/src/civ-component.ts
@@ -3,7 +3,7 @@ import { INJECTED_NS_PREFIX, REACTIVE_TEMPLATE_DOM, REACTIVE_TEMPLATE_SHEET, Rea
 import { activateReactivity, initReactivity, REACTIVE_KIT, ReactivityHost } from "./lib/reactive";
 import {
     attachedEventName, detachEventName, moveEventName, movedEventName,
-    attrToTrait, componentFlagClass, isMagicForAttr, isMagicForTemplateElement,
+    attrToTrait, componentFlagClass, isMagicElifAttr, isMagicElseAttr, isMagicForAttr, isMagicForTemplateElement, isMagicIfAttr,
     significantFlagClass, subtreeTemplateFlagClass,
     Traits, EventHandlerTrait,
 } from "./protocol";
@@ -420,6 +420,7 @@ export class CivComponent extends EventTarget {
             }
             const elemTraits: Traits = [];
             const magicAttrs: Attr[] = [];
+            const structuralTraitAttrMap = new Map<'for' | 'if' | 'elif' | 'else', string>();
             if (Reflect.get(components, elem.tagName.toUpperCase())) {
                 elem.classList.add(componentFlagClass);
             }
@@ -433,7 +434,31 @@ export class CivComponent extends EventTarget {
                 if (!trait) {
                     continue;
                 }
-                elemTraits.push(trait);
+                const structuralTrait = isMagicForAttr(name) ? 'for' :
+                    isMagicIfAttr(name) ? 'if' :
+                        isMagicElifAttr(name) ? 'elif' :
+                            isMagicElseAttr(name) ? 'else' :
+                                undefined;
+                if (structuralTrait) {
+                    const existingTraitIndex = elemTraits.findIndex(([t]) => t === structuralTrait);
+                    if (existingTraitIndex !== -1) {
+                        const existingAttrName = structuralTraitAttrMap.get(structuralTrait) || '';
+                        const existingIsStarAlias = existingAttrName.startsWith('*');
+                        const currentIsStarAlias = name.startsWith('*');
+                        if (!existingIsStarAlias && currentIsStarAlias) {
+                            elemTraits[existingTraitIndex] = trait;
+                            structuralTraitAttrMap.set(structuralTrait, name);
+                        } else {
+                            magicAttrs.push(attr);
+                            continue;
+                        }
+                    } else {
+                        elemTraits.push(trait);
+                        structuralTraitAttrMap.set(structuralTrait, name);
+                    }
+                } else {
+                    elemTraits.push(trait);
+                }
                 magicAttrs.push(attr);
                 if (trait.length === 1 || !trait.includes(expr)) {
                     continue;