@asteby/metacore-runtime-react 19.0.0 → 20.0.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @asteby/metacore-runtime-react
 
+## 20.0.0
+
+### Minor Changes
+
+- dcd95c3: DynamicKanban: traduce el label de cada etapa via i18n (`t(stage.label)` con fallback al valor crudo) — antes mostraba la key cruda (ej. `integration_github.stage.backlog`) en vez de "Backlog". Y da min-height a las lanes para que el scroll horizontal del board quede abajo en vez de flotar cuando las columnas están vacías.
+- 3f41073: Sidebar nav: exact, view-aware active-state so sibling navs over the same model light up one at a time
+
+  The `NavGroup` active-state matcher (`checkIsActive`) now treats `view`/`group_by`
+  query params as the _identity_ of a view-style nav item. Two navs over the same
+  model that differ only by their view — e.g. a "Board" (`?view=kanban&group_by=stage`)
+  and an "Issues" (`?view=list`, or a query-less default list) — are mutually
+  exclusive: only the item whose view identity equals `currentHref` stays active,
+  fixing the bug where both lit up at once.
+  - `@asteby/metacore-ui`: the matcher is extracted into a pure, React-free
+    `layout/nav-active` module (`checkIsActive`, `splitHref`, `declaredFiltersMatch`,
+    `VIEW_PARAMS`) and re-exported from `@asteby/metacore-ui/layout` for hosts and
+    unit tests. `f_` filter and transient (page/sort/search) highlight behaviour is
+    unchanged — a query-less link still highlights under filters/pagination, and
+    per-status entries still light up one at a time.
+  - `@asteby/metacore-starter-core`: the scaffold's `nav-group` matcher gains the
+    same view/query/filter-aware logic.
+  - `@asteby/metacore-runtime-react`: `DynamicView` now reads the active view from
+    the per-nav signal — an explicit `view` prop (host router) or the `?view=`
+    query — and prefers it over the model-level `metadata.view_type`, so the same
+    model can route `?view=kanban` to `DynamicKanban` and `?view=list` to
+    `DynamicTable` with no per-model metadata change. New pure helpers
+    `readViewFromSearch` / `resolveActiveView` are exported.
+
+### Patch Changes
+
+- Updated dependencies [3f41073]
+  - @asteby/metacore-ui@2.6.0
+
 ## 19.0.0
 
 ### Major Changes
@@ -9,6 +42,7 @@
   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.js

@@ -313,6 +313,7 @@ export function DynamicKanban({ model, endpoint, refreshTrigger, onCardClick, pa
                 } }))] }));
 }
 function KanbanLane({ stage, count, isDark, dimmed, disabled, children }) {
+    const { t } = useTranslation();
     const { setNodeRef, isOver } = useDroppable({ id: stage.key, disabled });
     const headerStyle = generateBadgeStyles(stage.color || optionColor(stage.key), {
         isDark,
@@ -321,7 +322,7 @@ function KanbanLane({ stage, count, isDark, dimmed, disabled, children }) {
             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 }) })] }));
+        }, "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: t(stage.label, { defaultValue: stage.label }) }), _jsx("span", { className: "text-xs font-medium tabular-nums text-muted-foreground", children: count })] }), _jsx(ScrollArea, { className: "min-h-[55vh] 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({

package/dist/dynamic-view.d.ts

@@ -5,7 +5,31 @@ import { type DynamicKanbanProps } from './dynamic-kanban';
  * host that resolves metadata itself can branch without mounting this wrapper.
  */
 export declare function resolveViewRenderer(viewType: string | undefined): 'kanban' | 'table';
+/**
+ * Reads the `view` selector out of a URL search string (`?view=kanban`, a bare
+ * `view=kanban`, or a full href). Returns `undefined` when absent. The query is
+ * the per-NAV signal: the same model exposes a "Board" nav (`?view=kanban`) and
+ * an "Issues" nav (`?view=list`), so the query — not the model-level
+ * `metadata.view_type` — decides which surface to paint. SSR-safe.
+ */
+export declare function readViewFromSearch(search?: string): string | undefined;
+/**
+ * Resolves the effective view selector with the right precedence:
+ *   1. an explicit `view` prop the host passes (it owns the router), then
+ *   2. the `view` query param, then
+ *   3. the model-level `metadata.view_type` default.
+ * Exported pure for unit tests and host reuse.
+ */
+export declare function resolveActiveView(explicit: string | undefined, search: string | undefined, metadataViewType: string | undefined): string | undefined;
 export interface DynamicViewProps extends DynamicTableProps {
+    /**
+     * Explicit view selector from the host's router (e.g. the `view` search
+     * param resolved by tanstack-router). Takes precedence over the query string
+     * and the model's `metadata.view_type`. Pass this when the host owns routing
+     * so the same model can show `?view=kanban` (board) or `?view=list` (table)
+     * with no per-model metadata change.
+     */
+    view?: string;
     /**
      * Props forwarded to <DynamicKanban> when the model resolves to a kanban
      * view. `model`/`endpoint`/`refreshTrigger`/`timeZone`/`currency` are shared
@@ -14,5 +38,5 @@ export interface DynamicViewProps extends DynamicTableProps {
      */
     kanbanProps?: Partial<Omit<DynamicKanbanProps, 'model' | 'endpoint'>>;
 }
-export declare function DynamicView({ kanbanProps, ...tableProps }: DynamicViewProps): import("react").JSX.Element | null;
+export declare function DynamicView({ view, kanbanProps, ...tableProps }: DynamicViewProps): import("react").JSX.Element | null;
 //# sourceMappingURL=dynamic-view.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACrC,MAAM,GAAG,SAAS,CAEpB;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACvD;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC,CAAA;CACxE;AAED,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE,EAAE,gBAAgB,sCAiEjF"}

package/dist/dynamic-view.js

@@ -26,7 +26,32 @@ import { DynamicKanban } from './dynamic-kanban';
 export function resolveViewRenderer(viewType) {
     return viewType === 'kanban' ? 'kanban' : 'table';
 }
-export function DynamicView({ kanbanProps, ...tableProps }) {
+/**
+ * Reads the `view` selector out of a URL search string (`?view=kanban`, a bare
+ * `view=kanban`, or a full href). Returns `undefined` when absent. The query is
+ * the per-NAV signal: the same model exposes a "Board" nav (`?view=kanban`) and
+ * an "Issues" nav (`?view=list`), so the query — not the model-level
+ * `metadata.view_type` — decides which surface to paint. SSR-safe.
+ */
+export function readViewFromSearch(search) {
+    if (!search)
+        return undefined;
+    const qIndex = search.indexOf('?');
+    const qs = qIndex === -1 ? search : search.slice(qIndex + 1);
+    const v = new URLSearchParams(qs).get('view');
+    return v ?? undefined;
+}
+/**
+ * Resolves the effective view selector with the right precedence:
+ *   1. an explicit `view` prop the host passes (it owns the router), then
+ *   2. the `view` query param, then
+ *   3. the model-level `metadata.view_type` default.
+ * Exported pure for unit tests and host reuse.
+ */
+export function resolveActiveView(explicit, search, metadataViewType) {
+    return explicit ?? readViewFromSearch(search) ?? metadataViewType;
+}
+export function DynamicView({ view, kanbanProps, ...tableProps }) {
     const { model, endpoint, refreshTrigger, timeZone, currency } = tableProps;
     const api = useApi();
     const cached = useMetadataCache((s) => s.getMetadata(model));
@@ -64,11 +89,17 @@ export function DynamicView({ kanbanProps, ...tableProps }) {
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [model]);
+    // The per-nav `view` (explicit prop or `?view=` query) wins over the
+    // model-level metadata default so two navs on the same model route to
+    // different surfaces.
+    const search = typeof window !== 'undefined' ? window.location.search : undefined;
+    const effectiveView = resolveActiveView(view, search, viewType);
     // 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)
+    // table renderer only once resolved to avoid a table→kanban flash. An
+    // explicit/query view short-circuits the wait (we already know the surface).
+    if (!resolved && !cached && view === undefined && !readViewFromSearch(search))
         return null;
-    if (resolveViewRenderer(viewType) === 'kanban') {
+    if (resolveViewRenderer(effectiveView) === 'kanban') {
         return (_jsx(DynamicKanban, { model: model, endpoint: endpoint, refreshTrigger: refreshTrigger, timeZone: timeZone, currency: currency, ...kanbanProps }));
     }
     return _jsx(DynamicTable, { ...tableProps });

package/dist/index.d.ts

@@ -2,7 +2,7 @@ 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 { DynamicView, resolveViewRenderer, readViewFromSearch, resolveActiveView, 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":"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"}

package/dist/index.js

@@ -7,7 +7,7 @@ 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 { DynamicView, resolveViewRenderer, readViewFromSearch, resolveActiveView, } from './dynamic-view';
 export * from './dynamic-form';
 export { ActionModalDispatcher, } from './action-modal-dispatcher';
 export { ModelActionToolbar, useModelActions, } from './model-action-toolbar';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "19.0.0",
+  "version": "20.0.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",
@@ -37,8 +37,8 @@
     "react-i18next": ">=13",
     "sonner": ">=1.7",
     "zustand": ">=5",
-    "@asteby/metacore-ui": "^2.5.2",
-    "@asteby/metacore-sdk": "^3.2.0"
+    "@asteby/metacore-sdk": "^3.2.0",
+    "@asteby/metacore-ui": "^2.6.0"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-router": {
@@ -67,8 +67,8 @@
     "typescript": "^6.0.0",
     "vitest": "^4.0.0",
     "zustand": "^5.0.0",
-    "@asteby/metacore-ui": "2.5.2",
-    "@asteby/metacore-sdk": "3.2.0"
+    "@asteby/metacore-sdk": "3.2.0",
+    "@asteby/metacore-ui": "2.6.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/__tests__/dynamic-view.test.tsx

@@ -0,0 +1,62 @@
+// DynamicView routing decision: the same model exposes a "Board" nav
+// (`?view=kanban`) and an "Issues" nav (`?view=list`), so the per-nav `view`
+// signal — explicit prop or `?view=` query — must win over the model-level
+// `metadata.view_type`. These are the pure helpers behind that decision.
+import { describe, expect, it } from 'vitest'
+import {
+    resolveViewRenderer,
+    readViewFromSearch,
+    resolveActiveView,
+} from '../dynamic-view'
+
+describe('resolveViewRenderer', () => {
+    it('maps kanban → kanban and everything else → table', () => {
+        expect(resolveViewRenderer('kanban')).toBe('kanban')
+        expect(resolveViewRenderer('list')).toBe('table')
+        expect(resolveViewRenderer('table')).toBe('table')
+        expect(resolveViewRenderer(undefined)).toBe('table')
+    })
+})
+
+describe('readViewFromSearch', () => {
+    it('reads view from a leading-? search string', () => {
+        expect(readViewFromSearch('?view=kanban&group_by=stage')).toBe('kanban')
+    })
+    it('reads view from a bare query string', () => {
+        expect(readViewFromSearch('view=list')).toBe('list')
+    })
+    it('reads view from a full href', () => {
+        expect(readViewFromSearch('/m/github_issues?view=kanban')).toBe('kanban')
+    })
+    it('returns undefined when absent or empty', () => {
+        expect(readViewFromSearch('?page=2')).toBeUndefined()
+        expect(readViewFromSearch('')).toBeUndefined()
+        expect(readViewFromSearch(undefined)).toBeUndefined()
+    })
+})
+
+describe('resolveActiveView precedence', () => {
+    it('explicit prop wins over query and metadata', () => {
+        expect(resolveActiveView('kanban', '?view=list', 'table')).toBe('kanban')
+    })
+    it('query wins over metadata when no explicit prop', () => {
+        expect(resolveActiveView(undefined, '?view=kanban', 'table')).toBe(
+            'kanban',
+        )
+    })
+    it('falls back to metadata view_type when neither prop nor query present', () => {
+        expect(resolveActiveView(undefined, '?page=2', 'kanban')).toBe('kanban')
+        expect(resolveActiveView(undefined, undefined, 'table')).toBe('table')
+    })
+    it('Board vs Issues on the same model route to different surfaces', () => {
+        // model metadata default could be either; the nav query decides.
+        const boardView = resolveActiveView(
+            undefined,
+            '?view=kanban&group_by=stage',
+            'list',
+        )
+        const issuesView = resolveActiveView(undefined, '?view=list', 'list')
+        expect(resolveViewRenderer(boardView)).toBe('kanban')
+        expect(resolveViewRenderer(issuesView)).toBe('table')
+    })
+})

package/src/dynamic-kanban.tsx

@@ -568,6 +568,7 @@ interface KanbanLaneProps {
 }
 
 function KanbanLane({ stage, count, isDark, dimmed, disabled, children }: KanbanLaneProps) {
+    const { t } = useTranslation()
     const { setNodeRef, isOver } = useDroppable({ id: stage.key, disabled })
     const headerStyle = generateBadgeStyles(stage.color || optionColor(stage.key), {
         isDark,
@@ -590,13 +591,13 @@ function KanbanLane({ stage, count, isDark, dimmed, disabled, children }: Kanban
                     className="border-0 text-xs font-semibold"
                     style={headerStyle}
                 >
-                    {stage.label}
+                    {t(stage.label, { defaultValue: stage.label })}
                 </Badge>
                 <span className="text-xs font-medium tabular-nums text-muted-foreground">
                     {count}
                 </span>
             </div>
-            <ScrollArea className="max-h-[70vh]">
+            <ScrollArea className="min-h-[55vh] max-h-[70vh]">
                 <div className="flex flex-col gap-2 px-2 pb-3">{children}</div>
             </ScrollArea>
         </div>

package/src/dynamic-view.tsx

@@ -30,7 +30,45 @@ export function resolveViewRenderer(
     return viewType === 'kanban' ? 'kanban' : 'table'
 }
 
+/**
+ * Reads the `view` selector out of a URL search string (`?view=kanban`, a bare
+ * `view=kanban`, or a full href). Returns `undefined` when absent. The query is
+ * the per-NAV signal: the same model exposes a "Board" nav (`?view=kanban`) and
+ * an "Issues" nav (`?view=list`), so the query — not the model-level
+ * `metadata.view_type` — decides which surface to paint. SSR-safe.
+ */
+export function readViewFromSearch(search?: string): string | undefined {
+    if (!search) return undefined
+    const qIndex = search.indexOf('?')
+    const qs = qIndex === -1 ? search : search.slice(qIndex + 1)
+    const v = new URLSearchParams(qs).get('view')
+    return v ?? undefined
+}
+
+/**
+ * Resolves the effective view selector with the right precedence:
+ *   1. an explicit `view` prop the host passes (it owns the router), then
+ *   2. the `view` query param, then
+ *   3. the model-level `metadata.view_type` default.
+ * Exported pure for unit tests and host reuse.
+ */
+export function resolveActiveView(
+    explicit: string | undefined,
+    search: string | undefined,
+    metadataViewType: string | undefined,
+): string | undefined {
+    return explicit ?? readViewFromSearch(search) ?? metadataViewType
+}
+
 export interface DynamicViewProps extends DynamicTableProps {
+    /**
+     * Explicit view selector from the host's router (e.g. the `view` search
+     * param resolved by tanstack-router). Takes precedence over the query string
+     * and the model's `metadata.view_type`. Pass this when the host owns routing
+     * so the same model can show `?view=kanban` (board) or `?view=list` (table)
+     * with no per-model metadata change.
+     */
+    view?: string
     /**
      * Props forwarded to <DynamicKanban> when the model resolves to a kanban
      * view. `model`/`endpoint`/`refreshTrigger`/`timeZone`/`currency` are shared
@@ -40,7 +78,7 @@ export interface DynamicViewProps extends DynamicTableProps {
     kanbanProps?: Partial<Omit<DynamicKanbanProps, 'model' | 'endpoint'>>
 }
 
-export function DynamicView({ kanbanProps, ...tableProps }: DynamicViewProps) {
+export function DynamicView({ view, kanbanProps, ...tableProps }: DynamicViewProps) {
     const { model, endpoint, refreshTrigger, timeZone, currency } = tableProps
     const api = useApi()
     const cached = useMetadataCache((s) => s.getMetadata(model))
@@ -78,11 +116,20 @@ export function DynamicView({ kanbanProps, ...tableProps }: DynamicViewProps) {
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [model])
 
+    // The per-nav `view` (explicit prop or `?view=` query) wins over the
+    // model-level metadata default so two navs on the same model route to
+    // different surfaces.
+    const search =
+        typeof window !== 'undefined' ? window.location.search : undefined
+    const effectiveView = resolveActiveView(view, search, viewType)
+
     // 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
+    // table renderer only once resolved to avoid a table→kanban flash. An
+    // explicit/query view short-circuits the wait (we already know the surface).
+    if (!resolved && !cached && view === undefined && !readViewFromSearch(search))
+        return null
 
-    if (resolveViewRenderer(viewType) === 'kanban') {
+    if (resolveViewRenderer(effectiveView) === 'kanban') {
         return (
             <DynamicKanban
                 model={model}

package/src/index.ts

@@ -19,6 +19,8 @@ export {
 export {
     DynamicView,
     resolveViewRenderer,
+    readViewFromSearch,
+    resolveActiveView,
     type DynamicViewProps,
 } from './dynamic-view'
 export * from './dynamic-form'