@antglobal/copilot-cards-core 0.0.20260806095059-dev.1 → 0.0.20260811080429-dev.5

package/dist/index.cjs

@@ -1937,6 +1937,7 @@ function validateSchema(input) {
 }
 const REPEAT_SLOT_LAYOUTS = new Set([
     'default',
+    'flex',
     'list',
     'grid',
     'horizontalScroll',
@@ -2050,11 +2051,15 @@ function readRepeatBindingFields(value) {
     const template = readOwnData(value, 'template');
     const item = readOwnData(value, 'item');
     const index = readOwnData(value, 'index');
+    const emptyTemplate = readOwnData(value, 'emptyTemplate');
     return {
         source: source.kind === 'value' ? source.value : undefined,
         template: template.kind === 'value' ? template.value : undefined,
-        item: item.kind === 'value' ? item.value : undefined,
+        ...(item.kind === 'value' ? { item: item.value } : {}),
         ...(index.kind === 'value' ? { index: index.value } : {}),
+        ...(emptyTemplate.kind === 'value'
+            ? { emptyTemplate: emptyTemplate.value }
+            : {}),
     };
 }
 function slotStaticReferences(slot) {
@@ -2179,6 +2184,10 @@ function elementReferences(element) {
         if (typeof binding?.template === 'string' && binding.template) {
             references.push(binding.template);
         }
+        if (typeof binding?.emptyTemplate === 'string'
+            && binding.emptyTemplate) {
+            references.push(binding.emptyTemplate);
+        }
         const a2ui = getA2UIChildBinding(slot);
         if (typeof a2ui?.templateId === 'string' && a2ui.templateId) {
             references.push(a2ui.templateId);
@@ -2257,13 +2266,27 @@ function validateRepeatBindings(schema, errors) {
             else if (!getOwnElement(schema, binding.template)) {
                 errors.push(`Element "${id}" slot "${slotName}" repeat references unknown template "${binding.template}"`);
             }
-            validateAlias(id, slotName, 'item', binding.item, errors);
+            if (binding.item !== undefined) {
+                validateAlias(id, slotName, 'item', binding.item, errors);
+            }
             if (binding.index !== undefined) {
                 validateAlias(id, slotName, 'index', binding.index, errors);
             }
-            if (binding.index !== undefined && binding.item === binding.index) {
+            if (binding.index !== undefined
+                && (binding.item ?? '$item') === binding.index) {
                 errors.push(`Element "${id}" slot "${slotName}" repeat item and index aliases must be different`);
             }
+            if (binding.emptyTemplate !== undefined) {
+                if (typeof binding.emptyTemplate !== 'string') {
+                    errors.push(`Element "${id}" slot "${slotName}" repeat emptyTemplate must be a string`);
+                }
+                else if (!binding.emptyTemplate) {
+                    errors.push(`Element "${id}" slot "${slotName}" repeat emptyTemplate must be a non-empty string`);
+                }
+                else if (!getOwnElement(schema, binding.emptyTemplate)) {
+                    errors.push(`Element "${id}" slot "${slotName}" repeat references unknown empty template "${binding.emptyTemplate}"`);
+                }
+            }
         }
     }
     validateRepeatNesting(schema, dynamicBindings, errors);
@@ -2283,6 +2306,17 @@ function validateAlias(owner, slotName, kind, alias, errors) {
 function validateRepeatNesting(schema, bindings, errors) {
     const reportedCycles = new Set();
     const reportedCollisions = new Set();
+    function effectiveAliases(binding) {
+        if (!binding)
+            return [];
+        if (binding.item !== undefined) {
+            return [binding.item, binding.index].filter((alias) => typeof alias === 'string');
+        }
+        return [
+            '$item',
+            binding.index === undefined ? '$index' : binding.index,
+        ].filter((alias) => typeof alias === 'string');
+    }
     function visitElement(id, activeAliases, repeatPath, visitedStatic) {
         const element = getOwnElement(schema, id);
         if (!element || visitedStatic.has(id))
@@ -2297,8 +2331,10 @@ function validateRepeatNesting(schema, bindings, errors) {
                 ? readRepeatBindingFields(repeat.value)
                 : undefined;
             const a2uiBinding = getA2UIChildBinding(slot);
-            const template = nativeBinding?.template ?? a2uiBinding?.templateId;
-            if (typeof template === 'string' && template) {
+            const itemTemplate = nativeBinding?.template ?? a2uiBinding?.templateId;
+            const visitDynamicTemplate = (template, aliases) => {
+                if (!template)
+                    return;
                 const cycleAt = repeatPath.indexOf(template);
                 if (cycleAt >= 0) {
                     const cycle = [...repeatPath.slice(cycleAt), template].join(' -> ');
@@ -2308,9 +2344,8 @@ function validateRepeatNesting(schema, bindings, errors) {
                             ? `Element "${id}" slot "${slotName}" has repeat template cycle: ${cycle}`
                             : `Element "${id}" slot "${slotName}" has dynamic template cycle: ${cycle}`);
                     }
-                    continue;
+                    return;
                 }
-                const aliases = [nativeBinding?.item, nativeBinding?.index].filter((alias) => typeof alias === 'string');
                 for (const alias of aliases) {
                     if (activeAliases.has(alias)) {
                         const key = `${id}:${slotName}:${alias}`;
@@ -2324,7 +2359,9 @@ function validateRepeatNesting(schema, bindings, errors) {
                 for (const alias of aliases)
                     nestedAliases.add(alias);
                 visitElement(template, nestedAliases, [...repeatPath, template], new Set());
-            }
+            };
+            visitDynamicTemplate(itemTemplate, effectiveAliases(nativeBinding));
+            visitDynamicTemplate(nativeBinding?.emptyTemplate, []);
             for (const child of slotStaticReferences(slot)) {
                 visitElement(child, activeAliases, repeatPath, nextVisitedStatic);
             }
@@ -2332,10 +2369,14 @@ function validateRepeatNesting(schema, bindings, errors) {
     }
     for (const dynamic of bindings) {
         const { owner, binding, template } = dynamic;
-        const aliases = new Set([binding?.item, binding?.index].filter((alias) => typeof alias === 'string'));
+        const aliases = new Set(effectiveAliases(binding));
         if (typeof template === 'string' && template) {
             visitElement(template, aliases, [owner, template], new Set());
         }
+        if (typeof binding?.emptyTemplate === 'string'
+            && binding.emptyTemplate) {
+            visitElement(binding.emptyTemplate, new Set(), [owner, binding.emptyTemplate], new Set());
+        }
     }
 }
 function validateDynamicClosures(schema, repeats, errors) {
@@ -2882,6 +2923,7 @@ function materializeCard(input, variables, options = {}) {
                         template: native.template,
                         item: native.item,
                         index: native.index,
+                        emptyTemplate: native.emptyTemplate,
                     };
                 }
                 else {
@@ -2909,6 +2951,9 @@ function materializeCard(input, variables, options = {}) {
                     sourceOwnerId: sourceId,
                     slot: slotName,
                     templateId: binding.template,
+                    ...(binding.emptyTemplate
+                        ? { emptyTemplateId: binding.emptyTemplate }
+                        : {}),
                     ...(sourcePath === undefined ? {} : { sourcePath }),
                     dataPath: activeScope.dataPath,
                     instancePath,
@@ -2920,6 +2965,9 @@ function materializeCard(input, variables, options = {}) {
                 repeatOwners.set(ownerKey, owner);
                 slotOwners.set(slotName, { owner, binding, sourcePath, depth });
                 addDependency('component', binding.template, ownerKey);
+                if (binding.emptyTemplate) {
+                    addDependency('component', binding.emptyTemplate, ownerKey);
+                }
                 const runtimeKeys = runtimeOwnerKeys.get(id) ?? [];
                 if (runtimeKeys.length > 0) {
                     for (const key of runtimeKeys)
@@ -3000,15 +3048,30 @@ function materializeCard(input, variables, options = {}) {
             Reflect.deleteProperty(slot, 'repeat');
             Reflect.deleteProperty(slot, A2UI_CHILD_BINDING);
             slot.children = [];
+            if (items.length === 0
+                && binding.dialect === 'native'
+                && binding.emptyTemplate) {
+                const emptyPath = appendOccurrence(structuralPath, 'item', sourceId, slotName, `${binding.emptyTemplate}:empty`);
+                const empty = buildNode(binding.emptyTemplate, activeScope, emptyPath, emptyPath, true, id, depth, owner.key, nextActiveDefinitions);
+                slot.children.push(empty.id);
+                node.children.push(empty);
+            }
             items.forEach((item, index) => {
                 const dataPath = sourcePath === undefined
                     ? activeScope.dataPath
                     : joinPointer(sourcePath, [String(index)]);
-                const locals = binding.dialect === 'native' && binding.item
-                    ? {
-                        [binding.item]: item,
-                        ...(binding.index ? { [binding.index]: index } : {}),
-                    }
+                const locals = binding.dialect === 'native'
+                    ? binding.item !== undefined
+                        ? {
+                            [binding.item]: item,
+                            ...(binding.index === undefined
+                                ? {}
+                                : { [binding.index]: index }),
+                        }
+                        : {
+                            $item: item,
+                            [binding.index ?? '$index']: index,
+                        }
                     : {};
                 const childScope = {
                     root: rootVariables,
@@ -3018,14 +3081,23 @@ function materializeCard(input, variables, options = {}) {
                     bindingDialect: binding.dialect,
                 };
                 const aliases = new Map();
-                if (binding.dialect === 'native' && binding.item) {
-                    aliases.set(binding.item, sourcePath === undefined ? undefined : dataPath);
-                    if (binding.index)
-                        aliases.set(binding.index, sourcePath);
+                if (binding.dialect === 'native') {
+                    const itemAlias = binding.item ?? '$item';
+                    const indexAlias = binding.item === undefined
+                        ? binding.index ?? '$index'
+                        : binding.index;
+                    aliases.set(itemAlias, sourcePath === undefined ? undefined : dataPath);
+                    if (indexAlias !== undefined) {
+                        aliases.set(indexAlias, sourcePath);
+                    }
                 }
                 scopeAliasPaths.set(childScope, aliases);
-                scopeIndexAliases.set(childScope, new Set(binding.dialect === 'native' && binding.index
-                    ? [binding.index]
+                scopeIndexAliases.set(childScope, new Set(binding.dialect === 'native'
+                    ? binding.item === undefined
+                        ? [binding.index ?? '$index']
+                        : binding.index === undefined
+                            ? []
+                            : [binding.index]
                     : []));
                 const itemPath = appendOccurrence(structuralPath, 'item', sourceId, slotName, `${binding.template}:${index}`);
                 const child = buildNode(binding.template, childScope, itemPath, itemPath, true, id, depth, owner.key, nextActiveDefinitions);

package/dist/index.d.ts

@@ -151,6 +151,7 @@ interface ExpressionValue {
 /**
  * Slot layout mode — the key name in `props.slots` determines the layout:
  * - default: no special layout, children appended directly
+ * - flex: one-dimensional Flexbox layout applied to the host container
  * - columns: multi-column layout using groups (each group = one column)
  * - grid: CSS grid with configurable column count and gap
  * - horizontalScroll: horizontal scrollable container with drag and snap
@@ -158,13 +159,14 @@ interface ExpressionValue {
  * - list: vertical list with optional ordered/unordered markers
  * - float: relative container with absolutely positioned overlays
  */
-type SlotLayout = 'default' | 'columns' | 'grid' | 'horizontalScroll' | 'carousel' | 'list' | 'float' | 'keyValue' | 'table' | 'chart';
+type SlotLayout = 'default' | 'flex' | 'columns' | 'grid' | 'horizontalScroll' | 'carousel' | 'list' | 'float' | 'keyValue' | 'table' | 'chart';
 /** Binds a slot to a template that is instantiated once per source item. */
 interface RepeatBinding {
     source: string;
     template: string;
-    item: string;
+    item?: string;
     index?: string;
+    emptyTemplate?: string;
 }
 /**
  * Content of a named slot.
@@ -468,6 +470,7 @@ interface RepeatOwner {
     sourceOwnerId: string;
     slot: SlotLayout;
     templateId: string;
+    emptyTemplateId?: string;
     sourcePath?: string;
     dataPath: string;
     instancePath: string;

package/dist/index.js

@@ -1935,6 +1935,7 @@ function validateSchema(input) {
 }
 const REPEAT_SLOT_LAYOUTS = new Set([
     'default',
+    'flex',
     'list',
     'grid',
     'horizontalScroll',
@@ -2048,11 +2049,15 @@ function readRepeatBindingFields(value) {
     const template = readOwnData(value, 'template');
     const item = readOwnData(value, 'item');
     const index = readOwnData(value, 'index');
+    const emptyTemplate = readOwnData(value, 'emptyTemplate');
     return {
         source: source.kind === 'value' ? source.value : undefined,
         template: template.kind === 'value' ? template.value : undefined,
-        item: item.kind === 'value' ? item.value : undefined,
+        ...(item.kind === 'value' ? { item: item.value } : {}),
         ...(index.kind === 'value' ? { index: index.value } : {}),
+        ...(emptyTemplate.kind === 'value'
+            ? { emptyTemplate: emptyTemplate.value }
+            : {}),
     };
 }
 function slotStaticReferences(slot) {
@@ -2177,6 +2182,10 @@ function elementReferences(element) {
         if (typeof binding?.template === 'string' && binding.template) {
             references.push(binding.template);
         }
+        if (typeof binding?.emptyTemplate === 'string'
+            && binding.emptyTemplate) {
+            references.push(binding.emptyTemplate);
+        }
         const a2ui = getA2UIChildBinding(slot);
         if (typeof a2ui?.templateId === 'string' && a2ui.templateId) {
             references.push(a2ui.templateId);
@@ -2255,13 +2264,27 @@ function validateRepeatBindings(schema, errors) {
             else if (!getOwnElement(schema, binding.template)) {
                 errors.push(`Element "${id}" slot "${slotName}" repeat references unknown template "${binding.template}"`);
             }
-            validateAlias(id, slotName, 'item', binding.item, errors);
+            if (binding.item !== undefined) {
+                validateAlias(id, slotName, 'item', binding.item, errors);
+            }
             if (binding.index !== undefined) {
                 validateAlias(id, slotName, 'index', binding.index, errors);
             }
-            if (binding.index !== undefined && binding.item === binding.index) {
+            if (binding.index !== undefined
+                && (binding.item ?? '$item') === binding.index) {
                 errors.push(`Element "${id}" slot "${slotName}" repeat item and index aliases must be different`);
             }
+            if (binding.emptyTemplate !== undefined) {
+                if (typeof binding.emptyTemplate !== 'string') {
+                    errors.push(`Element "${id}" slot "${slotName}" repeat emptyTemplate must be a string`);
+                }
+                else if (!binding.emptyTemplate) {
+                    errors.push(`Element "${id}" slot "${slotName}" repeat emptyTemplate must be a non-empty string`);
+                }
+                else if (!getOwnElement(schema, binding.emptyTemplate)) {
+                    errors.push(`Element "${id}" slot "${slotName}" repeat references unknown empty template "${binding.emptyTemplate}"`);
+                }
+            }
         }
     }
     validateRepeatNesting(schema, dynamicBindings, errors);
@@ -2281,6 +2304,17 @@ function validateAlias(owner, slotName, kind, alias, errors) {
 function validateRepeatNesting(schema, bindings, errors) {
     const reportedCycles = new Set();
     const reportedCollisions = new Set();
+    function effectiveAliases(binding) {
+        if (!binding)
+            return [];
+        if (binding.item !== undefined) {
+            return [binding.item, binding.index].filter((alias) => typeof alias === 'string');
+        }
+        return [
+            '$item',
+            binding.index === undefined ? '$index' : binding.index,
+        ].filter((alias) => typeof alias === 'string');
+    }
     function visitElement(id, activeAliases, repeatPath, visitedStatic) {
         const element = getOwnElement(schema, id);
         if (!element || visitedStatic.has(id))
@@ -2295,8 +2329,10 @@ function validateRepeatNesting(schema, bindings, errors) {
                 ? readRepeatBindingFields(repeat.value)
                 : undefined;
             const a2uiBinding = getA2UIChildBinding(slot);
-            const template = nativeBinding?.template ?? a2uiBinding?.templateId;
-            if (typeof template === 'string' && template) {
+            const itemTemplate = nativeBinding?.template ?? a2uiBinding?.templateId;
+            const visitDynamicTemplate = (template, aliases) => {
+                if (!template)
+                    return;
                 const cycleAt = repeatPath.indexOf(template);
                 if (cycleAt >= 0) {
                     const cycle = [...repeatPath.slice(cycleAt), template].join(' -> ');
@@ -2306,9 +2342,8 @@ function validateRepeatNesting(schema, bindings, errors) {
                             ? `Element "${id}" slot "${slotName}" has repeat template cycle: ${cycle}`
                             : `Element "${id}" slot "${slotName}" has dynamic template cycle: ${cycle}`);
                     }
-                    continue;
+                    return;
                 }
-                const aliases = [nativeBinding?.item, nativeBinding?.index].filter((alias) => typeof alias === 'string');
                 for (const alias of aliases) {
                     if (activeAliases.has(alias)) {
                         const key = `${id}:${slotName}:${alias}`;
@@ -2322,7 +2357,9 @@ function validateRepeatNesting(schema, bindings, errors) {
                 for (const alias of aliases)
                     nestedAliases.add(alias);
                 visitElement(template, nestedAliases, [...repeatPath, template], new Set());
-            }
+            };
+            visitDynamicTemplate(itemTemplate, effectiveAliases(nativeBinding));
+            visitDynamicTemplate(nativeBinding?.emptyTemplate, []);
             for (const child of slotStaticReferences(slot)) {
                 visitElement(child, activeAliases, repeatPath, nextVisitedStatic);
             }
@@ -2330,10 +2367,14 @@ function validateRepeatNesting(schema, bindings, errors) {
     }
     for (const dynamic of bindings) {
         const { owner, binding, template } = dynamic;
-        const aliases = new Set([binding?.item, binding?.index].filter((alias) => typeof alias === 'string'));
+        const aliases = new Set(effectiveAliases(binding));
         if (typeof template === 'string' && template) {
             visitElement(template, aliases, [owner, template], new Set());
         }
+        if (typeof binding?.emptyTemplate === 'string'
+            && binding.emptyTemplate) {
+            visitElement(binding.emptyTemplate, new Set(), [owner, binding.emptyTemplate], new Set());
+        }
     }
 }
 function validateDynamicClosures(schema, repeats, errors) {
@@ -2880,6 +2921,7 @@ function materializeCard(input, variables, options = {}) {
                         template: native.template,
                         item: native.item,
                         index: native.index,
+                        emptyTemplate: native.emptyTemplate,
                     };
                 }
                 else {
@@ -2907,6 +2949,9 @@ function materializeCard(input, variables, options = {}) {
                     sourceOwnerId: sourceId,
                     slot: slotName,
                     templateId: binding.template,
+                    ...(binding.emptyTemplate
+                        ? { emptyTemplateId: binding.emptyTemplate }
+                        : {}),
                     ...(sourcePath === undefined ? {} : { sourcePath }),
                     dataPath: activeScope.dataPath,
                     instancePath,
@@ -2918,6 +2963,9 @@ function materializeCard(input, variables, options = {}) {
                 repeatOwners.set(ownerKey, owner);
                 slotOwners.set(slotName, { owner, binding, sourcePath, depth });
                 addDependency('component', binding.template, ownerKey);
+                if (binding.emptyTemplate) {
+                    addDependency('component', binding.emptyTemplate, ownerKey);
+                }
                 const runtimeKeys = runtimeOwnerKeys.get(id) ?? [];
                 if (runtimeKeys.length > 0) {
                     for (const key of runtimeKeys)
@@ -2998,15 +3046,30 @@ function materializeCard(input, variables, options = {}) {
             Reflect.deleteProperty(slot, 'repeat');
             Reflect.deleteProperty(slot, A2UI_CHILD_BINDING);
             slot.children = [];
+            if (items.length === 0
+                && binding.dialect === 'native'
+                && binding.emptyTemplate) {
+                const emptyPath = appendOccurrence(structuralPath, 'item', sourceId, slotName, `${binding.emptyTemplate}:empty`);
+                const empty = buildNode(binding.emptyTemplate, activeScope, emptyPath, emptyPath, true, id, depth, owner.key, nextActiveDefinitions);
+                slot.children.push(empty.id);
+                node.children.push(empty);
+            }
             items.forEach((item, index) => {
                 const dataPath = sourcePath === undefined
                     ? activeScope.dataPath
                     : joinPointer(sourcePath, [String(index)]);
-                const locals = binding.dialect === 'native' && binding.item
-                    ? {
-                        [binding.item]: item,
-                        ...(binding.index ? { [binding.index]: index } : {}),
-                    }
+                const locals = binding.dialect === 'native'
+                    ? binding.item !== undefined
+                        ? {
+                            [binding.item]: item,
+                            ...(binding.index === undefined
+                                ? {}
+                                : { [binding.index]: index }),
+                        }
+                        : {
+                            $item: item,
+                            [binding.index ?? '$index']: index,
+                        }
                     : {};
                 const childScope = {
                     root: rootVariables,
@@ -3016,14 +3079,23 @@ function materializeCard(input, variables, options = {}) {
                     bindingDialect: binding.dialect,
                 };
                 const aliases = new Map();
-                if (binding.dialect === 'native' && binding.item) {
-                    aliases.set(binding.item, sourcePath === undefined ? undefined : dataPath);
-                    if (binding.index)
-                        aliases.set(binding.index, sourcePath);
+                if (binding.dialect === 'native') {
+                    const itemAlias = binding.item ?? '$item';
+                    const indexAlias = binding.item === undefined
+                        ? binding.index ?? '$index'
+                        : binding.index;
+                    aliases.set(itemAlias, sourcePath === undefined ? undefined : dataPath);
+                    if (indexAlias !== undefined) {
+                        aliases.set(indexAlias, sourcePath);
+                    }
                 }
                 scopeAliasPaths.set(childScope, aliases);
-                scopeIndexAliases.set(childScope, new Set(binding.dialect === 'native' && binding.index
-                    ? [binding.index]
+                scopeIndexAliases.set(childScope, new Set(binding.dialect === 'native'
+                    ? binding.item === undefined
+                        ? [binding.index ?? '$index']
+                        : binding.index === undefined
+                            ? []
+                            : [binding.index]
                     : []));
                 const itemPath = appendOccurrence(structuralPath, 'item', sourceId, slotName, `${binding.template}:${index}`);
                 const child = buildNode(binding.template, childScope, itemPath, itemPath, true, id, depth, owner.key, nextActiveDefinitions);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antglobal/copilot-cards-core",
-  "version": "0.0.20260806095059-dev.1",
+  "version": "0.0.20260811080429-dev.5",
   "description": "Core logic engine for copilot bot card SDK — no UI, pure logic (Expression Engine, Action Runner, Schema Parser, Lifecycle Manager)",
   "type": "module",
   "main": "./dist/index.cjs",