@praxisui/table 10.0.0-rc.27 → 10.0.0-rc.29

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-15T22:42:56.841Z",
+  "generatedAt": "2026-10-16T14:27:38.517Z",
   "packageName": "@praxisui/table",
-  "packageVersion": "10.0.0-rc.27",
+  "packageVersion": "10.0.0-rc.29",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 3,

package/fesm2022/praxisui-table-authoring.mjs

@@ -389,8 +389,141 @@ function inspectInlineDetailSchema(schema, config) {
         Object.values(node).forEach(visit);
     };
     visit(schema);
+    const offContract = hasOffContractRichChildren([schema]);
+    if (offContract.cardGrid)
+        issues.push('cardGridContent');
+    if (offContract.compose)
+        issues.push('composeContent');
     return issues;
 }
+/** Rich node types accepted as `cardGrid` card content by the canonical `TableDetailCardGridCardNode` contract. */
+const TABLE_DETAIL_CARD_GRID_PRESENTER_TYPES = new Set([
+    'text', 'icon', 'image', 'badge', 'avatar', 'metric', 'progress', 'progressBar',
+    'microVisualization', 'link', 'chip', 'button', 'rating',
+]);
+/** `RichComposeNode.items` accepts presenters only (no nested compose). */
+function isTableDetailComposeItemNode(node) {
+    if (!node || typeof node !== 'object' || Array.isArray(node))
+        return false;
+    return TABLE_DETAIL_CARD_GRID_PRESENTER_TYPES.has(String(node['type'] || '').trim());
+}
+function isTableDetailCardGridContentNode(node) {
+    if (!node || typeof node !== 'object' || Array.isArray(node))
+        return false;
+    const type = String(node['type'] || '').trim();
+    return type === 'compose' || TABLE_DETAIL_CARD_GRID_PRESENTER_TYPES.has(type);
+}
+/**
+ * Projects an authored node into canonical `cardGrid` card content (`RichPresenterNode | RichComposeNode`).
+ * Table-detail `value` fields become `metric` (labelled) or `text` presenters; structural blocks that
+ * cannot live inside a rich card (stack, tabs, card, timeline, chartRef, richContent) return `null`.
+ */
+function toTableDetailCardGridContentNode(node) {
+    if (isTableDetailCardGridContentNode(node))
+        return node;
+    const type = String(node?.['type'] || '').trim();
+    if (type === 'cardGrid') {
+        const first = Array.isArray(node['cards']) ? node['cards'][0]?.content?.[0] : undefined;
+        return first ? toTableDetailCardGridContentNode(structuredClone(first)) : null;
+    }
+    if (type !== 'value')
+        return null;
+    const field = String(node['field'] || node['valueField'] || '').trim();
+    const authoredExpr = typeof node['valueExpr'] === 'string' ? node['valueExpr'].trim().replace(/^=\s*/, '') : '';
+    const valueExpr = authoredExpr || (field ? `row.${field}` : '');
+    if (!valueExpr)
+        return null;
+    const label = typeof node['label'] === 'string' ? node['label'].trim() : '';
+    return {
+        ...(node['id'] ? { id: node['id'] } : {}),
+        ...(label ? { type: 'metric', label, valueExpr } : { type: 'text', textExpr: valueExpr }),
+        ...(node['visibleWhen'] != null ? { visibleWhen: node['visibleWhen'] } : {}),
+    };
+}
+/** Projects an authored node into a canonical compose item (presenter); a compose result yields its first presenter. */
+function toTableDetailComposeItemNode(node) {
+    const projected = toTableDetailCardGridContentNode(node);
+    if (!projected)
+        return null;
+    if (projected['type'] !== 'compose')
+        return projected;
+    const first = Array.isArray(projected['items'])
+        ? projected['items'].find((item) => isTableDetailComposeItemNode(item))
+        : undefined;
+    return first ? structuredClone(first) : null;
+}
+/** True when a cardGrid card or a compose (outside richContent documents) holds off-contract children. */
+function hasOffContractRichChildren(nodes) {
+    const result = { cardGrid: false, compose: false };
+    const visit = (value) => {
+        if (!Array.isArray(value))
+            return;
+        for (const node of value) {
+            if (!node || typeof node !== 'object' || Array.isArray(node))
+                continue;
+            const record = node;
+            if (record['type'] === 'richContent')
+                continue;
+            if (record['type'] === 'cardGrid' && Array.isArray(record['cards'])) {
+                for (const card of record['cards']) {
+                    const content = card?.['content'];
+                    if (Array.isArray(content) && content.some((item) => !isTableDetailCardGridContentNode(item))) {
+                        result.cardGrid = true;
+                    }
+                }
+            }
+            if (record['type'] === 'compose' && Array.isArray(record['items'])
+                && record['items'].some((item) => !isTableDetailComposeItemNode(item))) {
+                result.compose = true;
+            }
+            visit(record['items']);
+            visit(record['content']);
+            visit(record['cards']);
+        }
+    };
+    visit(nodes);
+    return result;
+}
+/**
+ * Losslessly rewrites legacy table-detail `value` fields that sit inside cardGrid cards or compose items
+ * into canonical presenters. Structural blocks are left untouched (still reported) to avoid data loss.
+ * Returns the number of rewritten nodes.
+ */
+function normalizeTableDetailRichChildren(schema) {
+    let rewritten = 0;
+    const rewrite = (list, project, accepts) => {
+        if (!Array.isArray(list))
+            return;
+        list.forEach((item, index) => {
+            if (accepts(item) || item?.['type'] !== 'value')
+                return;
+            const projected = project(item);
+            if (projected) {
+                list[index] = projected;
+                rewritten += 1;
+            }
+        });
+    };
+    const visit = (value) => {
+        if (!Array.isArray(value))
+            return;
+        for (const node of value) {
+            if (!node || typeof node !== 'object' || Array.isArray(node) || node['type'] === 'richContent')
+                continue;
+            if (node['type'] === 'cardGrid' && Array.isArray(node['cards'])) {
+                for (const card of node['cards'])
+                    rewrite(card?.['content'], toTableDetailCardGridContentNode, isTableDetailCardGridContentNode);
+            }
+            if (node['type'] === 'compose')
+                rewrite(node['items'], toTableDetailComposeItemNode, isTableDetailComposeItemNode);
+            visit(node['items']);
+            visit(node['content']);
+            visit(node['cards']);
+        }
+    };
+    visit([schema]);
+    return rewritten;
+}
 /** Edits the original authoring tree; keys exist only in the editor's WeakMap. */
 class TableDetailTreeDraft {
     keys = new WeakMap();
@@ -449,8 +582,11 @@ class TableDetailTreeDraft {
         entry.siblings.splice(next, 0, entry.node);
     }
     add(node, nested = false) {
-        const selected = this.selected()?.node;
+        const selectedEntry = this.selected();
+        const selected = selectedEntry?.node;
         const isCardLike = selected?.type === 'card' || (!selected?.type && Array.isArray(selected?.content));
+        // Cards stored in `cardGrid.cards` follow TableDetailCardGridCardNode: rich presenters/compose only.
+        const isCardGridCard = !!selectedEntry && isCardLike && this.entries().some((entry) => entry.node['type'] === 'cardGrid' && entry.node['cards'] === selectedEntry.siblings);
         const childKey = selected?.type === 'cardGrid'
             ? 'cards'
             : (isCardLike || selected?.type === 'tab')
@@ -466,23 +602,40 @@ class TableDetailTreeDraft {
                 node = structuredClone(node.cards[0]);
             }
             else if (node.type === 'card') {
+                const content = (Array.isArray(node.content) ? node.content : [])
+                    .map((child) => toTableDetailCardGridContentNode(child))
+                    .filter((child) => !!child);
                 node = {
                     ...(node.id ? { id: node.id } : {}),
                     title: node.title ?? '',
                     ...(node.subtitle !== undefined ? { subtitle: node.subtitle } : {}),
-                    content: Array.isArray(node.content) && node.content.length
-                        ? node.content
-                        : [{ type: 'text', text: node.title || 'Detalhe' }],
+                    content: content.length ? content : [{ type: 'text', text: node.title || 'Detalhe' }],
                 };
             }
             else if (!Array.isArray(node.content)) {
+                const content = toTableDetailCardGridContentNode(node);
+                if (!content)
+                    return null;
                 node = {
                     title: node.title || node.label || '',
-                    content: [node],
+                    content: [content],
                 };
             }
         }
-        else if (nested && (isCardLike || selected?.type === 'compose') && node.type === 'cardGrid' && Array.isArray(node.cards)) {
+        else if (nested && isCardGridCard) {
+            const content = toTableDetailCardGridContentNode(node);
+            if (!content)
+                return null;
+            node = content;
+        }
+        else if (nested && selected?.type === 'compose') {
+            // RichComposeNode.items accepts presenters only; the runtime drops anything else silently.
+            const item = toTableDetailComposeItemNode(node);
+            if (!item)
+                return null;
+            node = item;
+        }
+        else if (nested && isCardLike && node.type === 'cardGrid' && Array.isArray(node.cards)) {
             const firstCardContent = node.cards[0]?.content;
             if (Array.isArray(firstCardContent) && firstCardContent.length > 0) {
                 node = structuredClone(firstCardContent[0]);
@@ -492,6 +645,7 @@ class TableDetailTreeDraft {
             parent[key] = [];
         parent[key].push(node);
         this.selectedKey = this.entries().find(entry => entry.node === node)?.key ?? null;
+        return node;
     }
 }