@asteby/metacore-runtime-react 18.28.3 → 19.0.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @asteby/metacore-runtime-react
 
+## 19.0.0
+
+### Major Changes
+
+- feat(kanban): new `DynamicKanban` view-type renderer, a sibling of `DynamicTable` sharing the same contract (`model` + `endpoint` + injected `ApiProvider`). Reads `view_type`/`group_by` from the table metadata (RFC §1.2) and derives board lanes from the model-level `stages[]` (or, as a fallback, the `group_by` column's status `options`). Records are fetched through the same `/data/:model` path and bucketed by `row[group_by]`; cards render through the existing `ActivityValueRenderer` (title + 2-3 fields) and reuse the `ActionModalDispatcher`/`useModelActions('row')` plumbing for the per-card action menu.
+
+  Drag-to-move (via `@dnd-kit/core`) is **optimistic**: dropping a card into another lane mutates local state immediately and fires `PUT /data/:model/me/:id { <group_by>: <dest> }`; on failure the move reverts and a toast surfaces — sidestepping the "refetch loses scroll/selection" gap. When the metadata declares `transitions[]`, a card may only drop into a stage reachable from its current one (disallowed lanes dim and reject the drop; the kernel still validates server-side).
+
+  Also adds `DynamicView`, a metadata-driven dispatcher that routes `view_type === 'kanban'` → `DynamicKanban`, else → `DynamicTable`, plus the pure helpers `deriveStages`, `groupByStage`, `isTransitionAllowed`, `applyOptimisticMove`, `selectCardColumns`, `resolveViewRenderer`. New `TableMetadata` fields (`view_type`, `group_by`, `stages`, `transitions`) and `StageMeta`/`StageTransition` types are purely additive. New deps: `@dnd-kit/core`, `@dnd-kit/sortable`, `@dnd-kit/utilities`.
 ## 18.28.3
 
 ### Patch Changes

package/dist/dynamic-kanban.d.ts

@@ -0,0 +1,66 @@
+import * as React from 'react';
+import type { TableMetadata, ColumnDefinition, StageMeta, StageTransition } from './types';
+/**
+ * Resolves the board lanes for a kanban view. Prefers the model-level
+ * `metadata.stages` (the kernel's `stages[]`); falls back to the `group_by`
+ * column's `options` (the kernel projects the stage machine onto the status
+ * display). Returns lanes sorted by `order` (then declared order). Empty when
+ * neither source is present — the caller renders a "no stages" notice.
+ */
+export declare function deriveStages(metadata: TableMetadata): StageMeta[];
+/**
+ * Buckets records into a `stageKey → rows[]` map, one entry per declared stage
+ * (in stage order), plus a trailing `__unassigned__` bucket for rows whose
+ * stage value matches no declared lane (so nothing silently vanishes). Empty
+ * lanes are kept so the board always shows every stage.
+ */
+export declare const UNASSIGNED_LANE = "__unassigned__";
+export declare function groupByStage(records: any[], groupByKey: string, stages: StageMeta[]): Map<string, any[]>;
+/**
+ * Whether a card may move `from → to` given the declared transitions. No
+ * transitions declared → unrestricted (the kernel still validates server-side).
+ * A move to the same stage is always a no-op "allowed". `'*'` is a wildcard on
+ * either side.
+ */
+export declare function isTransitionAllowed(transitions: StageTransition[] | undefined, from: string, to: string): boolean;
+/**
+ * Returns a NEW grouping with `cardId` moved from `fromStage` to `toStage`
+ * (appended to the destination lane). Pure — does not mutate the input map.
+ * Used by the optimistic drop handler so the board updates before the PUT
+ * resolves, and so the previous grouping can be restored on failure.
+ */
+export declare function applyOptimisticMove(grouped: Map<string, any[]>, cardId: string | number, fromStage: string, toStage: string, groupByKey: string): Map<string, any[]>;
+/**
+ * Picks the columns shown on a card: a `title` column (first searchable column,
+ * else first text-ish column) and up to `maxFields` secondary columns. Excludes
+ * the group_by column (it's the lane itself) and any column hidden from the
+ * table view (visibility modal/list, or `hidden`).
+ */
+export declare function selectCardColumns(metadata: TableMetadata, maxFields?: number): {
+    title: ColumnDefinition | null;
+    fields: ColumnDefinition[];
+};
+export interface DynamicKanbanProps {
+    /** Model key as registered on the backend (e.g. "issue"). */
+    model: string;
+    /**
+     * Data endpoint base. Defaults to `/data/<model>`. The optimistic update
+     * PUTs to `<base>/me/<id>`.
+     */
+    endpoint?: string;
+    /** Bump to force a metadata + records refetch (same contract as DynamicTable). */
+    refreshTrigger?: any;
+    /** Called when a card is clicked (outside its action menu). */
+    onCardClick?: (row: any) => void;
+    /**
+     * Max cards fetched per lane render. Kanban shows all cards at once (no
+     * pagination UI), so it requests a single large page. Defaults to 200.
+     */
+    pageSize?: number;
+    /** IANA timezone for datetime card fields (org config). */
+    timeZone?: string;
+    /** ISO 4217 currency for money card fields (org config). */
+    currency?: string;
+}
+export declare function DynamicKanban({ model, endpoint, refreshTrigger, onCardClick, pageSize, timeZone, currency, }: DynamicKanbanProps): React.JSX.Element;
+//# sourceMappingURL=dynamic-kanban.d.ts.map

package/dist/dynamic-kanban.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-kanban.d.ts","sourceRoot":"","sources":["../src/dynamic-kanban.tsx"],"names":[],"mappings":"AAyBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAqC9B,OAAO,KAAK,EACR,aAAa,EACb,gBAAgB,EAGhB,SAAS,EACT,eAAe,EAClB,MAAM,SAAS,CAAA;AAMhB;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,EAAE,CAejE;AAQD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAE/C,wBAAgB,YAAY,CACxB,OAAO,EAAE,GAAG,EAAE,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EAAE,GACpB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAepB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAC/B,WAAW,EAAE,eAAe,EAAE,GAAG,SAAS,EAC1C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACX,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAC3B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACnB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAYpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,aAAa,EACvB,SAAS,SAAI,GACd;IAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAkBhE;AA8BD,MAAM,WAAW,kBAAkB;IAC/B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kFAAkF;IAClF,cAAc,CAAC,EAAE,GAAG,CAAA;IACpB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,aAAa,CAAC,EAC1B,KAAK,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,QAAc,EACd,QAAQ,EACR,QAAQ,GACX,EAAE,kBAAkB,qBA+RpB"}

package/dist/dynamic-kanban.js

@@ -0,0 +1,341 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { DndContext, DragOverlay, PointerSensor, useSensor, useSensors, useDraggable, useDroppable, } from '@dnd-kit/core';
+import { MoreHorizontal } from 'lucide-react';
+import { toast } from 'sonner';
+import { Badge, Button, Card, CardContent, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger, ScrollArea, Skeleton, } from '@asteby/metacore-ui/primitives';
+import { generateBadgeStyles, optionColor } from '@asteby/metacore-ui/lib';
+import { useApi } from './api-context';
+import { useMetadataCache } from './metadata-cache';
+import { ActivityValueRenderer } from './activity-value-renderer';
+import { ActionModalDispatcher } from './action-modal-dispatcher';
+import { useModelActions } from './model-action-toolbar';
+import { DynamicIcon } from './dynamic-icon';
+import { isColumnVisibleInTable } from './column-visibility';
+import { isActionAllowedForRowState } from './dynamic-columns';
+// ---------------------------------------------------------------------------
+// Pure helpers (exported for unit tests — no React, no transport)
+// ---------------------------------------------------------------------------
+/**
+ * Resolves the board lanes for a kanban view. Prefers the model-level
+ * `metadata.stages` (the kernel's `stages[]`); falls back to the `group_by`
+ * column's `options` (the kernel projects the stage machine onto the status
+ * display). Returns lanes sorted by `order` (then declared order). Empty when
+ * neither source is present — the caller renders a "no stages" notice.
+ */
+export function deriveStages(metadata) {
+    const fromMeta = metadata.stages;
+    if (fromMeta && fromMeta.length > 0) {
+        return [...fromMeta].sort(sortByOrder);
+    }
+    const groupBy = metadata.group_by;
+    if (!groupBy)
+        return [];
+    const col = metadata.columns.find((c) => c.key === groupBy);
+    const opts = col?.options ?? [];
+    return opts.map((o, i) => ({
+        key: String(o.value),
+        label: o.label,
+        color: o.color,
+        order: i,
+    }));
+}
+function sortByOrder(a, b) {
+    const ao = a.order ?? Number.MAX_SAFE_INTEGER;
+    const bo = b.order ?? Number.MAX_SAFE_INTEGER;
+    return ao - bo;
+}
+/**
+ * Buckets records into a `stageKey → rows[]` map, one entry per declared stage
+ * (in stage order), plus a trailing `__unassigned__` bucket for rows whose
+ * stage value matches no declared lane (so nothing silently vanishes). Empty
+ * lanes are kept so the board always shows every stage.
+ */
+export const UNASSIGNED_LANE = '__unassigned__';
+export function groupByStage(records, groupByKey, stages) {
+    const map = new Map();
+    for (const s of stages)
+        map.set(s.key, []);
+    const known = new Set(stages.map((s) => s.key));
+    for (const row of records) {
+        const raw = row?.[groupByKey];
+        const key = raw === null || raw === undefined ? '' : String(raw);
+        if (known.has(key)) {
+            map.get(key).push(row);
+        }
+        else {
+            if (!map.has(UNASSIGNED_LANE))
+                map.set(UNASSIGNED_LANE, []);
+            map.get(UNASSIGNED_LANE).push(row);
+        }
+    }
+    return map;
+}
+/**
+ * Whether a card may move `from → to` given the declared transitions. No
+ * transitions declared → unrestricted (the kernel still validates server-side).
+ * A move to the same stage is always a no-op "allowed". `'*'` is a wildcard on
+ * either side.
+ */
+export function isTransitionAllowed(transitions, from, to) {
+    if (from === to)
+        return true;
+    if (!transitions || transitions.length === 0)
+        return true;
+    return transitions.some((t) => (t.from === from || t.from === '*') && (t.to === to || t.to === '*'));
+}
+/**
+ * Returns a NEW grouping with `cardId` moved from `fromStage` to `toStage`
+ * (appended to the destination lane). Pure — does not mutate the input map.
+ * Used by the optimistic drop handler so the board updates before the PUT
+ * resolves, and so the previous grouping can be restored on failure.
+ */
+export function applyOptimisticMove(grouped, cardId, fromStage, toStage, groupByKey) {
+    const next = new Map();
+    for (const [k, rows] of grouped)
+        next.set(k, [...rows]);
+    const fromRows = next.get(fromStage) ?? [];
+    const idx = fromRows.findIndex((r) => String(r.id) === String(cardId));
+    if (idx === -1)
+        return next;
+    const [moved] = fromRows.splice(idx, 1);
+    const updated = { ...moved, [groupByKey]: toStage };
+    const toRows = next.get(toStage) ?? [];
+    toRows.push(updated);
+    next.set(toStage, toRows);
+    return next;
+}
+/**
+ * Picks the columns shown on a card: a `title` column (first searchable column,
+ * else first text-ish column) and up to `maxFields` secondary columns. Excludes
+ * the group_by column (it's the lane itself) and any column hidden from the
+ * table view (visibility modal/list, or `hidden`).
+ */
+export function selectCardColumns(metadata, maxFields = 3) {
+    const groupBy = metadata.group_by;
+    const visible = metadata.columns.filter((c) => c.key !== groupBy &&
+        !c.hidden &&
+        isColumnVisibleInTable(c) &&
+        c.key !== 'id');
+    const title = visible.find((c) => c.searchable) ??
+        visible.find((c) => c.type === 'text' || c.cellStyle === 'truncate-text') ??
+        visible[0] ??
+        null;
+    const fields = visible
+        .filter((c) => c.key !== title?.key)
+        .slice(0, maxFields);
+    return { title, fields };
+}
+// ---------------------------------------------------------------------------
+// Theme hook (mirrors the private one in dynamic-columns / activity-renderer)
+// ---------------------------------------------------------------------------
+function useIsDarkTheme() {
+    const [isDark, setIsDark] = useState(() => typeof document !== 'undefined' &&
+        document.documentElement.classList.contains('dark'));
+    useEffect(() => {
+        if (typeof document === 'undefined')
+            return;
+        const sync = () => setIsDark(document.documentElement.classList.contains('dark'));
+        const observer = new MutationObserver(sync);
+        observer.observe(document.documentElement, {
+            attributes: true,
+            attributeFilter: ['class'],
+        });
+        return () => observer.disconnect();
+    }, []);
+    return isDark;
+}
+export function DynamicKanban({ model, endpoint, refreshTrigger, onCardClick, pageSize = 200, timeZone, currency, }) {
+    const { t, i18n } = useTranslation();
+    const api = useApi();
+    const isDark = useIsDarkTheme();
+    const { getMetadata, setMetadata: cacheMetadata } = useMetadataCache();
+    const cachedMeta = getMetadata(model);
+    const [metadata, setMetadata] = useState(cachedMeta || null);
+    const [records, setRecords] = useState([]);
+    const [loading, setLoading] = useState(!cachedMeta);
+    const [loadingData, setLoadingData] = useState(true);
+    // Active drag card id (for the DragOverlay + drop-zone highlighting).
+    const [activeId, setActiveId] = useState(null);
+    const [actionModal, setActionModal] = useState({ action: null, record: null });
+    const sensors = useSensors(useSensor(PointerSensor, { activationConstraint: { distance: 5 } }));
+    // ---- metadata fetch (same path as DynamicTable) ----
+    useEffect(() => {
+        let cancelled = false;
+        const cached = getMetadata(model);
+        if (cached) {
+            setMetadata(cached);
+            setLoading(false);
+        }
+        else {
+            setLoading(true);
+        }
+        api
+            .get(`/metadata/table/${model}`)
+            .then((res) => {
+            if (cancelled)
+                return;
+            const body = res.data;
+            if (body.success) {
+                setMetadata(body.data);
+                cacheMetadata(model, body.data);
+            }
+        })
+            .catch((err) => {
+            if (!cancelled && !cached)
+                console.error('Error al cargar la configuración del tablero', err);
+        })
+            .finally(() => {
+            if (!cancelled)
+                setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [model]);
+    // ---- records fetch (same path as DynamicTable, single large page) ----
+    const fetchData = useCallback(async () => {
+        if (!metadata)
+            return;
+        setLoadingData(true);
+        try {
+            const res = (await api.get(endpoint || `/data/${model}`, {
+                params: { page: 1, per_page: pageSize },
+            }));
+            if (res.data.success)
+                setRecords(res.data.data || []);
+        }
+        catch (err) {
+            console.error('Error al cargar las tarjetas', err);
+        }
+        finally {
+            setLoadingData(false);
+        }
+    }, [api, endpoint, model, metadata, pageSize]);
+    useEffect(() => {
+        if (metadata)
+            void fetchData();
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [metadata, refreshTrigger]);
+    const stages = useMemo(() => (metadata ? deriveStages(metadata) : []), [metadata]);
+    const groupByKey = metadata?.group_by || '';
+    const transitions = metadata?.transitions;
+    const grouped = useMemo(() => groupByStage(records, groupByKey, stages), [records, groupByKey, stages]);
+    const { title: titleCol, fields: fieldCols } = useMemo(() => (metadata ? selectCardColumns(metadata) : { title: null, fields: [] }), [metadata]);
+    // Row-placement actions reused verbatim from the table's plumbing.
+    const rowActions = useModelActions(model, ['row'], metadata?.actions);
+    const cardById = useMemo(() => {
+        const m = new Map();
+        for (const r of records)
+            m.set(String(r.id), r);
+        return m;
+    }, [records]);
+    const stageOfCard = useCallback((id) => {
+        const card = cardById.get(id);
+        const raw = card?.[groupByKey];
+        return raw === null || raw === undefined ? '' : String(raw);
+    }, [cardById, groupByKey]);
+    const onDragStart = useCallback((e) => {
+        setActiveId(String(e.active.id));
+    }, []);
+    const onDragEnd = useCallback(async (e) => {
+        setActiveId(null);
+        const { active, over } = e;
+        if (!over)
+            return;
+        const cardId = String(active.id);
+        const destStage = String(over.id);
+        const srcStage = stageOfCard(cardId);
+        if (srcStage === destStage)
+            return;
+        if (!isTransitionAllowed(transitions, srcStage, destStage)) {
+            toast.error(t('kanban.invalidTransition', {
+                defaultValue: 'Movimiento no permitido entre estas etapas',
+            }));
+            return;
+        }
+        // OPTIMISTIC: move the card in local state immediately.
+        const prevRecords = records;
+        setRecords((rs) => rs.map((r) => String(r.id) === cardId ? { ...r, [groupByKey]: destStage } : r));
+        try {
+            const base = endpoint || `/data/${model}`;
+            const res = (await api.put(`${base}/me/${cardId}`, {
+                [groupByKey]: destStage,
+            }));
+            if (res?.data && res.data.success === false) {
+                throw new Error(res.data.message || 'update_failed');
+            }
+        }
+        catch (err) {
+            // REVERT + toast on failure.
+            setRecords(prevRecords);
+            toast.error(t('kanban.moveFailed', {
+                defaultValue: 'No se pudo mover la tarjeta',
+            }) +
+                (err?.response?.data?.message
+                    ? `: ${err.response.data.message}`
+                    : ''));
+        }
+    }, [api, endpoint, groupByKey, model, records, stageOfCard, t, transitions]);
+    if (loading) {
+        return (_jsx("div", { className: "flex gap-4 overflow-x-auto p-1", children: [0, 1, 2, 3].map((i) => (_jsxs("div", { className: "w-72 shrink-0 space-y-3", children: [_jsx(Skeleton, { className: "h-8 w-full" }), _jsx(Skeleton, { className: "h-24 w-full" }), _jsx(Skeleton, { className: "h-24 w-full" })] }, i))) }));
+    }
+    if (!metadata || !groupByKey || stages.length === 0) {
+        return (_jsx("div", { className: "rounded-md border border-dashed p-8 text-center text-sm text-muted-foreground", children: t('kanban.noStages', {
+                defaultValue: 'Este modelo no declara etapas para la vista de tablero.',
+            }) }));
+    }
+    const activeCard = activeId ? cardById.get(activeId) : null;
+    const activeStage = activeId ? stageOfCard(activeId) : '';
+    const lanes = [...stages];
+    if (grouped.has(UNASSIGNED_LANE)) {
+        lanes.push({
+            key: UNASSIGNED_LANE,
+            label: t('kanban.unassigned', { defaultValue: 'Sin etapa' }),
+            color: 'slate',
+            order: Number.MAX_SAFE_INTEGER,
+        });
+    }
+    return (_jsxs(DndContext, { sensors: sensors, onDragStart: onDragStart, onDragEnd: onDragEnd, children: [_jsx("div", { className: "flex gap-4 overflow-x-auto p-1", "data-testid": "kanban-board", children: lanes.map((stage) => {
+                    const cards = grouped.get(stage.key) ?? [];
+                    const droppableAllowed = !activeId ||
+                        stage.key === activeStage ||
+                        isTransitionAllowed(transitions, activeStage, stage.key);
+                    return (_jsx(KanbanLane, { stage: stage, count: cards.length, isDark: isDark, dimmed: !!activeId && !droppableAllowed, disabled: !!activeId && !droppableAllowed, children: loadingData && cards.length === 0 ? (_jsxs(_Fragment, { children: [_jsx(Skeleton, { className: "h-20 w-full" }), _jsx(Skeleton, { className: "h-20 w-full" })] })) : cards.length === 0 ? (_jsx("p", { className: "px-1 py-6 text-center text-xs text-muted-foreground", children: t('kanban.emptyLane', { defaultValue: 'Sin tarjetas' }) })) : (cards.map((card) => (_jsx(KanbanCard, { card: card, titleCol: titleCol, fieldCols: fieldCols, actions: rowActions, locale: i18n.language, timeZone: timeZone, currency: currency, onClick: onCardClick, onAction: (action, record) => setActionModal({ action, record }) }, String(card.id))))) }, stage.key));
+                }) }), _jsx(DragOverlay, { children: activeCard ? (_jsx(CardPreview, { card: activeCard, titleCol: titleCol, fieldCols: fieldCols, locale: i18n.language, timeZone: timeZone, currency: currency })) : null }), actionModal.action && (_jsx(ActionModalDispatcher, { open: !!actionModal.action, onOpenChange: (open) => {
+                    if (!open)
+                        setActionModal({ action: null, record: null });
+                }, action: actionModal.action, model: model, record: actionModal.record ?? {}, endpoint: endpoint ?? `/data/${model}/me`, onSuccess: () => {
+                    setActionModal({ action: null, record: null });
+                    void fetchData();
+                } }))] }));
+}
+function KanbanLane({ stage, count, isDark, dimmed, disabled, children }) {
+    const { setNodeRef, isOver } = useDroppable({ id: stage.key, disabled });
+    const headerStyle = generateBadgeStyles(stage.color || optionColor(stage.key), {
+        isDark,
+    });
+    return (_jsxs("div", { ref: setNodeRef, className: "flex w-72 shrink-0 flex-col rounded-lg border bg-muted/30 transition-opacity", style: {
+            opacity: dimmed ? 0.45 : 1,
+            outline: isOver && !disabled ? '2px solid var(--ring, #3b82f6)' : 'none',
+            outlineOffset: 2,
+        }, "data-stage": stage.key, "data-disabled": disabled || undefined, children: [_jsxs("div", { className: "flex items-center justify-between gap-2 px-3 py-2.5", children: [_jsx(Badge, { variant: "outline", className: "border-0 text-xs font-semibold", style: headerStyle, children: stage.label }), _jsx("span", { className: "text-xs font-medium tabular-nums text-muted-foreground", children: count })] }), _jsx(ScrollArea, { className: "max-h-[70vh]", children: _jsx("div", { className: "flex flex-col gap-2 px-2 pb-3", children: children }) })] }));
+}
+function KanbanCard({ card, titleCol, fieldCols, actions, locale, timeZone, currency, onClick, onAction, }) {
+    const { attributes, listeners, setNodeRef, isDragging } = useDraggable({
+        id: String(card.id),
+    });
+    const visibleActions = actions.filter((a) => isActionAllowedForRowState(a, card));
+    return (_jsx(Card, { ref: setNodeRef, ...attributes, ...listeners, className: "cursor-grab active:cursor-grabbing border-border/70 shadow-sm", style: { opacity: isDragging ? 0.4 : 1 }, onClick: () => onClick?.(card), "data-card-id": String(card.id), children: _jsxs(CardContent, { className: "space-y-1.5 p-3", children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsx("div", { className: "min-w-0 flex-1 text-sm font-medium leading-snug", children: titleCol ? (_jsx(ActivityValueRenderer, { value: card[titleCol.key], col: titleCol, locale: locale, timeZone: timeZone, currency: currency })) : (_jsx("span", { className: "truncate", children: String(card.id) })) }), visibleActions.length > 0 && (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { variant: "ghost", size: "icon", className: "h-6 w-6 shrink-0 -mr-1 -mt-1", 
+                                        // Don't start a drag / card click from the menu button.
+                                        onPointerDown: (e) => e.stopPropagation(), onClick: (e) => e.stopPropagation(), children: _jsx(MoreHorizontal, { className: "h-4 w-4" }) }) }), _jsx(DropdownMenuContent, { align: "end", onClick: (e) => e.stopPropagation(), children: visibleActions.map((a) => (_jsxs(DropdownMenuItem, { onClick: (e) => {
+                                            e.stopPropagation();
+                                            onAction(a, card);
+                                        }, children: [_jsx(DynamicIcon, { name: a.icon || 'Zap', className: "mr-2 h-4 w-4" }), a.label] }, a.key))) })] }))] }), fieldCols.map((col) => (_jsxs("div", { className: "flex items-center gap-1.5 text-xs text-muted-foreground", children: [_jsxs("span", { className: "shrink-0 opacity-70", children: [col.label, ":"] }), _jsx("span", { className: "min-w-0 truncate", children: _jsx(ActivityValueRenderer, { value: card[col.key], col: col, locale: locale, timeZone: timeZone, currency: currency }) })] }, col.key)))] }) }));
+}
+// Static preview rendered inside the DragOverlay (no dnd hooks, no menu).
+function CardPreview({ card, titleCol, fieldCols, locale, timeZone, currency, }) {
+    return (_jsx(Card, { className: "w-72 cursor-grabbing border-primary/40 shadow-lg", children: _jsxs(CardContent, { className: "space-y-1.5 p-3", children: [_jsx("div", { className: "text-sm font-medium leading-snug", children: titleCol ? (_jsx(ActivityValueRenderer, { value: card[titleCol.key], col: titleCol, locale: locale, timeZone: timeZone, currency: currency })) : (String(card.id)) }), fieldCols.map((col) => (_jsxs("div", { className: "flex items-center gap-1.5 text-xs text-muted-foreground", children: [_jsxs("span", { className: "shrink-0 opacity-70", children: [col.label, ":"] }), _jsx("span", { className: "min-w-0 truncate", children: _jsx(ActivityValueRenderer, { value: card[col.key], col: col, locale: locale, timeZone: timeZone, currency: currency }) })] }, col.key)))] }) }));
+}

package/dist/dynamic-view.d.ts

@@ -0,0 +1,18 @@
+import { type DynamicTableProps } from './dynamic-table';
+import { type DynamicKanbanProps } from './dynamic-kanban';
+/**
+ * Pure routing decision: which renderer a `view_type` maps onto. Exported so a
+ * host that resolves metadata itself can branch without mounting this wrapper.
+ */
+export declare function resolveViewRenderer(viewType: string | undefined): 'kanban' | 'table';
+export interface DynamicViewProps extends DynamicTableProps {
+    /**
+     * Props forwarded to <DynamicKanban> when the model resolves to a kanban
+     * view. `model`/`endpoint`/`refreshTrigger`/`timeZone`/`currency` are shared
+     * with the table props and forwarded automatically; this is for the
+     * kanban-only extras (e.g. `onCardClick`, `pageSize`).
+     */
+    kanbanProps?: Partial<Omit<DynamicKanbanProps, 'model' | 'endpoint'>>;
+}
+export declare function DynamicView({ kanbanProps, ...tableProps }: DynamicViewProps): import("react").JSX.Element | null;
+//# sourceMappingURL=dynamic-view.d.ts.map

package/dist/dynamic-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-view.d.ts","sourceRoot":"","sources":["../src/dynamic-view.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAGzE;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B,QAAQ,GAAG,OAAO,CAEpB;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACvD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC,CAAA;CACxE;AAED,wBAAgB,WAAW,CAAC,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE,EAAE,gBAAgB,sCAwD3E"}

package/dist/dynamic-view.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// DynamicView — the single entry point a host renders for a model's "list"
+// surface. It picks the renderer from the model's `view_type`:
+//   - `'kanban'` → <DynamicKanban>
+//   - anything else / absent → <DynamicTable> (the default)
+//
+// The decision is metadata-driven (RFC §1.2): the kernel serves `view_type` +
+// `group_by` on the table metadata, derived from the nav item. A host that
+// already knows the view type can skip this and render the concrete component
+// directly; a generic host route (e.g. ops `/m/$model`) mounts <DynamicView>
+// and lets the metadata decide, so the same model can expose a `table` nav and
+// a `kanban` nav with no host code change.
+//
+// Both child components fetch their own metadata (cache-backed), so the extra
+// read this wrapper does to learn `view_type` is served from the same cache —
+// no duplicate network round-trip in practice.
+import { useEffect, useState } from 'react';
+import { useApi } from './api-context';
+import { useMetadataCache } from './metadata-cache';
+import { DynamicTable } from './dynamic-table';
+import { DynamicKanban } from './dynamic-kanban';
+/**
+ * Pure routing decision: which renderer a `view_type` maps onto. Exported so a
+ * host that resolves metadata itself can branch without mounting this wrapper.
+ */
+export function resolveViewRenderer(viewType) {
+    return viewType === 'kanban' ? 'kanban' : 'table';
+}
+export function DynamicView({ kanbanProps, ...tableProps }) {
+    const { model, endpoint, refreshTrigger, timeZone, currency } = tableProps;
+    const api = useApi();
+    const cached = useMetadataCache((s) => s.getMetadata(model));
+    const setMeta = useMetadataCache((s) => s.setMetadata);
+    const [viewType, setViewType] = useState(cached?.view_type);
+    const [resolved, setResolved] = useState(!!cached);
+    useEffect(() => {
+        let cancelled = false;
+        const c = useMetadataCache.getState().getMetadata(model);
+        if (c) {
+            setViewType(c.view_type);
+            setResolved(true);
+        }
+        api
+            .get(`/metadata/table/${model}`)
+            .then((res) => {
+            if (cancelled)
+                return;
+            const body = res.data;
+            const meta = body?.success ? body.data : res.data;
+            if (meta) {
+                setViewType(meta.view_type);
+                setMeta(model, meta);
+            }
+        })
+            .catch(() => {
+            /* fall back to the table renderer */
+        })
+            .finally(() => {
+            if (!cancelled)
+                setResolved(true);
+        });
+        return () => {
+            cancelled = true;
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [model]);
+    // Until we know the view type, render nothing transient-heavy: default to the
+    // table renderer only once resolved to avoid a table→kanban flash.
+    if (!resolved && !cached)
+        return null;
+    if (resolveViewRenderer(viewType) === 'kanban') {
+        return (_jsx(DynamicKanban, { model: model, endpoint: endpoint, refreshTrigger: refreshTrigger, timeZone: timeZone, currency: currency, ...kanbanProps }));
+    }
+    return _jsx(DynamicTable, { ...tableProps });
+}

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export * from './types';
 export * from './options-context';
 export * from './dynamic-table';
+export { DynamicKanban, type DynamicKanbanProps, deriveStages, groupByStage, isTransitionAllowed, applyOptimisticMove, selectCardColumns, UNASSIGNED_LANE, } from './dynamic-kanban';
+export { DynamicView, resolveViewRenderer, type DynamicViewProps, } from './dynamic-view';
 export * from './dynamic-form';
 export { ActionModalDispatcher, type ActionModalProps, } from './action-modal-dispatcher';
 export { ModelActionToolbar, useModelActions, type ModelActionToolbarProps, type ActionPlacement, } from './model-action-toolbar';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,SAAS,CAAA;AACvB,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EACH,aAAa,EACb,KAAK,kBAAkB,EACvB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAClB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACH,WAAW,EACX,mBAAmB,EACnB,KAAK,gBAAgB,GACxB,MAAM,gBAAgB,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EACH,qBAAqB,EACrB,KAAK,gBAAgB,GACxB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACH,kBAAkB,EAClB,eAAe,EACf,KAAK,uBAAuB,EAC5B,KAAK,eAAe,GACvB,MAAM,wBAAwB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EACH,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,wBAAwB,GAChC,MAAM,wBAAwB,CAAA;AAC/B,cAAc,QAAQ,CAAA;AACtB,cAAc,mBAAmB,CAAA;AACjC,OAAO,EACH,mBAAmB,EACnB,MAAM,EACN,oBAAoB,EACpB,OAAO,EACP,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,KAAK,KAAK,EACV,KAAK,wBAAwB,GAChC,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACH,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,OAAO,EACZ,KAAK,SAAS,GACjB,MAAM,uBAAuB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,OAAO,EACH,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,8BAA8B,GACtC,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACH,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,EACX,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,GAC9B,MAAM,yBAAyB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,YAAY,EACR,kBAAkB,EAClB,YAAY,IAAI,yBAAyB,EACzC,iBAAiB,EACjB,oBAAoB,GACvB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACH,wBAAwB,EACxB,4BAA4B,EAC5B,cAAc,EACd,oBAAoB,EACpB,KAAK,qBAAqB,GAC7B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EACH,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,KAAK,mBAAmB,EACxB,KAAK,SAAS,IAAI,uBAAuB,GAC5C,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzE,YAAY,EAAE,wBAAwB,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,YAAY,EACR,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EACH,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC9B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,GACjB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACH,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,KAAK,qBAAqB,GAC7B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GAC3B,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACH,sBAAsB,EACtB,uBAAuB,GAC1B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,kBAAkB,EAClB,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,GAChC,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,eAAe,GACvB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,GACvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACH,qBAAqB,EACrB,KAAK,0BAA0B,GAClC,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACH,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACH,aAAa,EACb,KAAK,kBAAkB,GAC1B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACH,gBAAgB,EAChB,KAAK,qBAAqB,GAC7B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,aAAa,EACb,eAAe,GAClB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACR,UAAU,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GACvB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACH,UAAU,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,cAAc,EACd,KAAK,iBAAiB,GACzB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,cAAc,EACd,cAAc,EACd,SAAS,EACT,UAAU,EACV,KAAK,mBAAmB,GAC3B,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACH,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,KAAK,eAAe,GACvB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACH,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,eAAe,GACvB,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -6,6 +6,8 @@
 export * from './types';
 export * from './options-context';
 export * from './dynamic-table';
+export { DynamicKanban, deriveStages, groupByStage, isTransitionAllowed, applyOptimisticMove, selectCardColumns, UNASSIGNED_LANE, } from './dynamic-kanban';
+export { DynamicView, resolveViewRenderer, } from './dynamic-view';
 export * from './dynamic-form';
 export { ActionModalDispatcher, } from './action-modal-dispatcher';
 export { ModelActionToolbar, useModelActions, } from './model-action-toolbar';

package/dist/types.d.ts

@@ -19,6 +19,52 @@ export interface TableMetadata {
      * and attachments. Absent on hosts/older kernels — purely additive.
      */
     relations?: RelationMeta[];
+    /**
+     * Which renderer the host should use for this view. `'table'` (default, or
+     * absent) → `DynamicTable`; `'kanban'` → `DynamicKanban`. Served by the
+     * kernel from the nav item's `view_type` (RFC §1.2). Purely additive — older
+     * kernels omit it and the SDK falls back to the table renderer.
+     */
+    view_type?: 'table' | 'kanban' | (string & {});
+    /**
+     * Column key the board groups by when `view_type === 'kanban'` (the stage
+     * column, e.g. `'stage'`). Each distinct value of this column becomes a board
+     * lane. Mirrors the nav item's `group_by` (RFC §1.2).
+     */
+    group_by?: string;
+    /**
+     * Board lanes (the stage machine of the `group_by`/`stage_field` column).
+     * When present the kanban renders one lane per stage in `order`. When absent
+     * the SDK derives lanes from the `group_by` column's `options` (the kernel
+     * already projects `stages[]` onto the status display — RFC §1.1). Snake_case
+     * keys as the kernel serves them.
+     */
+    stages?: StageMeta[];
+    /**
+     * Allowed stage transitions (RFC §1.1). When present, the kanban only lets a
+     * card drop into a lane reachable from its current stage; disallowed lanes
+     * are dimmed and reject the drop. `from`/`to` accept `'*'` as a wildcard.
+     * Absent → any move is allowed (the kernel still validates server-side).
+     */
+    transitions?: StageTransition[];
+}
+/**
+ * One board lane / pipeline stage. Mirrors the kernel v3 `Stage` (RFC §1.1).
+ * `color` is a semantic palette name (`'slate'`, `'blue'`, `'amber'`, `'green'`)
+ * or a hex literal — resolved through the same `generateBadgeStyles` helper as
+ * option badges. `is_final` flags a terminal stage (e.g. "Done").
+ */
+export interface StageMeta {
+    key: string;
+    label: string;
+    color?: string;
+    order?: number;
+    is_final?: boolean;
+}
+/** Allowed `from → to` stage transition (RFC §1.1). `'*'` is a wildcard. */
+export interface StageTransition {
+    from: string;
+    to: string;
 }
 /**
  * Describes one child relation of a parent model, mirroring the kernel