@asteby/metacore-runtime-react 12.0.0 → 13.1.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @asteby/metacore-runtime-react
 
+## 13.1.0
+
+### Minor Changes
+
+- 8d9c602: AddonLoader carga remotes de federación ESM vía `import()` dinámico (fix "Cannot use import statement outside a module").
+
+  Los remotes built con Vite/@originjs `format:"esm"` (el estándar de `metacoreFederationShared`) son módulos ES que hacen `import` top-level y exportan `{ init, get }` — DEBEN cargarse como módulo. El `AddonLoader` los inyectaba como `<script>` clásico → el browser tiraba `Cannot use import statement outside a module` y la UI federada nunca cargaba. Ahora hace `import()` dinámico (vía `new Function` para que ningún bundler reescriba el import del URL externo) y usa el namespace del módulo como container; los remotes legacy "var"/window siguen soportados con fallback a `<script>` + `window[scope]`.
+
+## 13.0.0
+
+### Minor Changes
+
+- 7ea7caa: Acciones con `placement` (`row` | `table` | `create`) y nuevo primitivo `<ModelActionToolbar>`.
+
+  `ActionMetadata`/`ActionDefinition` ganan `placement`, espejando `manifest/v3` Action.placement del kernel (v0.30.0):
+  - `row` (default) — acción por fila dentro de `<DynamicTable>` (comportamiento actual).
+  - `table` — botón en la toolbar de la página, sin contexto de record.
+  - `create` — botón en la toolbar que **reemplaza** el botón "crear" genérico, para addons que traen una experiencia de creación custom (p.ej. un asiento contable con líneas débito/crédito).
+
+  `<ModelActionToolbar>` (+ hook `useModelActions`) es el primitivo genérico que renderiza esos triggers de nivel página y monta el `ActionModalDispatcher` (record vacío para `create`). Resuelve tanto modales federados custom (vía el action registry) como el form declarativo genérico. `DynamicCRUDPage` lo consume internamente y suprime su botón crear cuando existe una acción `create`; `DynamicTable` excluye los placements `table`/`create` de la columna de acciones por fila. Los hosts ya no reimplementan el plumbing de botones de acción — montan `<ModelActionToolbar>` y listo.
+
+### Patch Changes
+
+- Updated dependencies [7ea7caa]
+- Updated dependencies [3b40ed5]
+  - @asteby/metacore-sdk@3.1.0
+  - @asteby/metacore-ui@2.1.0
+
 ## 12.0.0
 
 ### Minor Changes

package/dist/addon-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addon-loader.d.ts","sourceRoot":"","sources":["../src/addon-loader.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGjE,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;QAClB,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QAC3D,wBAAwB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACrD;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC7B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;IACX,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,GAAG,EAAE,QAAQ,CAAA;IACb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;IAC9B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC7B;AAuCD,wBAAgB,WAAW,CAAC,EACxB,KAAK,EACL,GAAG,EACH,MAAqB,EACrB,GAAG,EACH,QAAe,EACf,OAAO,EACP,OAAO,EACP,MAAM,EACN,QAAQ,GACX,EAAE,gBAAgB,2CAsClB"}
+{"version":3,"file":"addon-loader.d.ts","sourceRoot":"","sources":["../src/addon-loader.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGjE,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,MAAM;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;QAClB,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QAC3D,wBAAwB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACrD;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC7B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAA;IACX,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,GAAG,EAAE,QAAQ,CAAA;IACb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;IAC9B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC7B;AAqFD,wBAAgB,WAAW,CAAC,EACxB,KAAK,EACL,GAAG,EACH,MAAqB,EACrB,GAAG,EACH,QAAe,EACf,OAAO,EACP,OAAO,EACP,MAAM,EACN,QAAQ,GACX,EAAE,gBAAgB,2CAoClB"}

package/dist/addon-loader.js

@@ -4,6 +4,10 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 // addon's `register(api)` export with the AddonAPI injected by the host.
 import { useEffect, useRef, useState } from 'react';
 import { useDeclareAddonLayout } from './addon-layout-context';
+// Runtime dynamic import of an external URL. Wrapped in `new Function` so no
+// build tool (tsc here, Vite in the consuming host) tries to statically
+// analyse or rewrite the import — it stays a genuine runtime ESM fetch.
+const importModule = new Function('u', 'return import(u)');
 const loadedScripts = new Map();
 function loadScript(url, scope) {
     const key = `${scope}::${url}`;
@@ -22,15 +26,53 @@ function loadScript(url, scope) {
     loadedScripts.set(key, promise);
     return promise;
 }
-async function loadRemote(scope, module) {
+const esmContainers = new Map();
+// Resolve a federation container for the remote. Vite/@originjs remotes built
+// with `format:"esm"` (our standard) are ES modules that top-level `import`
+// their preload helper and export `{ init, get }` — they MUST be loaded as a
+// module (a classic <script> throws "Cannot use import statement outside a
+// module"), so we dynamic-import them and use the module namespace as the
+// container. Legacy "var"/window remotes (which assign `window[scope]`) are
+// still supported via the classic <script> fallback.
+async function resolveContainer(scope, url) {
+    const key = `${scope}::${url}`;
+    const cached = esmContainers.get(key);
+    if (cached)
+        return cached;
+    const p = (async () => {
+        try {
+            const mod = await importModule(url);
+            if (mod && typeof mod.init === 'function' && typeof mod.get === 'function') {
+                return mod;
+            }
+        }
+        catch {
+            // Not an importable module (legacy var-format remote) — fall back.
+        }
+        await loadScript(url, scope);
+        return window[scope];
+    })();
+    esmContainers.set(key, p);
+    p.catch(() => esmContainers.delete(key));
+    return p;
+}
+async function loadRemote(scope, url, module) {
     if (typeof window.__webpack_init_sharing__ === 'function') {
         await window.__webpack_init_sharing__('default');
     }
-    const container = window[scope];
-    if (!container)
-        throw new Error(`Addon container "${scope}" not found on window`);
-    if (typeof container.init === 'function' && window.__webpack_share_scopes__) {
-        await container.init(window.__webpack_share_scopes__.default);
+    const container = await resolveContainer(scope, url);
+    if (!container) {
+        throw new Error(`Addon container "${scope}" not found (neither ESM export nor window[scope])`);
+    }
+    if (typeof container.init === 'function') {
+        const shareScope = window.__webpack_share_scopes__?.default ??
+            (window.__METACORE_SHARE_SCOPE__ ??= {});
+        try {
+            await container.init(shareScope);
+        }
+        catch {
+            // Container already initialized (re-entrant load) — safe to ignore.
+        }
     }
     const factory = await container.get(module);
     return factory();
@@ -48,10 +90,7 @@ export function AddonLoader({ scope, url, module = './register', api, fallback =
         let cancelled = false;
         (async () => {
             try {
-                await loadScript(url, scope);
-                if (cancelled)
-                    return;
-                const mod = await loadRemote(scope, module);
+                const mod = await loadRemote(scope, url, module);
                 if (cancelled)
                     return;
                 if (!didRegister.current && typeof mod?.register === 'function') {

package/dist/dynamic-crud-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-crud-page.d.ts","sourceRoot":"","sources":["../src/dynamic-crud-page.tsx"],"names":[],"mappings":"AAwBA,OAAO,KAKN,MAAM,OAAO,CAAA;AAWd,MAAM,WAAW,sBAAsB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;mDAC+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AASD,MAAM,WAAW,sBAAsB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,sBAAsB,CAAA;IAC7B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC/B,sDAAsD;IACtD,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,2CAsL1D"}
+{"version":3,"file":"dynamic-crud-page.d.ts","sourceRoot":"","sources":["../src/dynamic-crud-page.tsx"],"names":[],"mappings":"AAwBA,OAAO,KAKN,MAAM,OAAO,CAAA;AAYd,MAAM,WAAW,sBAAsB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;mDAC+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AASD,MAAM,WAAW,sBAAsB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,sBAAsB,CAAA;IAC7B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC/B,sDAAsD;IACtD,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACxB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,2CA+L1D"}

package/dist/dynamic-crud-page.js

@@ -32,6 +32,7 @@ import { DynamicRecordDialog } from './dialogs/dynamic-record';
 import { ExportDialog } from './dialogs/export';
 import { ImportDialog } from './dialogs/import';
 import { getModelExtension } from './model-extension-registry';
+import { ModelActionToolbar } from './model-action-toolbar';
 const defaultStrings = {
     refresh: 'Refresh',
     export: 'Export',
@@ -84,7 +85,10 @@ export function DynamicCRUDPage(props) {
         return t.charAt(0).toUpperCase() + t.slice(1);
     }, [title]);
     const enableCRUD = metadata?.enableCRUDActions ?? false;
-    const effectiveHideCreate = hideCreate || ext?.hideCreate;
+    // A "create"-placement action ships a custom create experience — it
+    // replaces the generic create button (the ModelActionToolbar renders it).
+    const hasCreateAction = metadata?.actions?.some((a) => a.placement === 'create') ?? false;
+    const effectiveHideCreate = hideCreate || ext?.hideCreate || hasCreateAction;
     const effectiveHideExport = hideExport || ext?.hideExport;
     const effectiveHideImport = hideImport || ext?.hideImport;
     // Refresh defaults to hidden in the page header — <DynamicTable> ships
@@ -106,5 +110,5 @@ export function DynamicCRUDPage(props) {
     const titleCls = classes?.title ?? 'text-2xl font-bold tracking-tight';
     const toolbarCls = classes?.toolbar ?? 'flex items-center gap-2';
     const tableWrapperCls = classes?.tableWrapper ?? 'flex-1 min-h-0';
-    return (_jsxs("div", { className: rootCls, children: [_jsxs("div", { className: containerCls, children: [ext?.headerExtras && _jsx(ext.headerExtras, { model: model, onRefresh: handleRefresh }), headerExtras, _jsxs("div", { className: headerCls, children: [metadata ? (_jsx("h1", { className: titleCls, children: title })) : (_jsx("div", { className: 'h-8 w-48 bg-muted rounded animate-pulse' })), _jsxs("div", { className: toolbarCls, children: [showRefresh && (_jsx("button", { type: 'button', onClick: handleRefresh, "aria-label": strings.refresh, className: 'inline-flex items-center justify-center size-9 rounded-md border border-border bg-background hover:bg-accent text-foreground', children: _jsx(RefreshCw, { className: 'size-4' }) })), metadata && showExport && (_jsxs("button", { type: 'button', onClick: () => setOpenExport(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md border border-border bg-background hover:bg-accent text-sm font-medium text-foreground', children: [_jsx(Download, { className: 'size-4' }), strings.export] })), metadata && showImport && (_jsxs("button", { type: 'button', onClick: () => setOpenImport(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md border border-border bg-background hover:bg-accent text-sm font-medium text-foreground', children: [_jsx(Upload, { className: 'size-4' }), strings.import] })), ext?.toolbarExtras && _jsx(ext.toolbarExtras, { model: model, onRefresh: handleRefresh }), toolbarExtras, showCreate && (_jsxs("button", { type: 'button', onClick: () => setOpenCreate(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md bg-primary text-primary-foreground hover:opacity-90 text-sm font-medium', children: [_jsx(Plus, { className: 'size-4' }), resolvedNewLabel ?? `${strings.newPrefix} ${singular}`] }))] })] }), _jsx("div", { className: tableWrapperCls, children: _jsx(DynamicTable, { model: model, endpoint: dataEndpoint, refreshTrigger: refreshKey }, model) })] }), showCreate && (_jsx(DynamicRecordDialog, { open: openCreate, onOpenChange: setOpenCreate, mode: 'create', model: model, endpoint: dataEndpoint, onSaved: handleRefresh })), metadata && showExport && (_jsx(ExportDialog, { open: openExport, onOpenChange: setOpenExport, model: model, metadata: metadata })), metadata && showImport && (_jsx(ImportDialog, { open: openImport, onOpenChange: setOpenImport, model: model, metadata: metadata, onImported: handleRefresh }))] }));
+    return (_jsxs("div", { className: rootCls, children: [_jsxs("div", { className: containerCls, children: [ext?.headerExtras && _jsx(ext.headerExtras, { model: model, onRefresh: handleRefresh }), headerExtras, _jsxs("div", { className: headerCls, children: [metadata ? (_jsx("h1", { className: titleCls, children: title })) : (_jsx("div", { className: 'h-8 w-48 bg-muted rounded animate-pulse' })), _jsxs("div", { className: toolbarCls, children: [showRefresh && (_jsx("button", { type: 'button', onClick: handleRefresh, "aria-label": strings.refresh, className: 'inline-flex items-center justify-center size-9 rounded-md border border-border bg-background hover:bg-accent text-foreground', children: _jsx(RefreshCw, { className: 'size-4' }) })), metadata && showExport && (_jsxs("button", { type: 'button', onClick: () => setOpenExport(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md border border-border bg-background hover:bg-accent text-sm font-medium text-foreground', children: [_jsx(Download, { className: 'size-4' }), strings.export] })), metadata && showImport && (_jsxs("button", { type: 'button', onClick: () => setOpenImport(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md border border-border bg-background hover:bg-accent text-sm font-medium text-foreground', children: [_jsx(Upload, { className: 'size-4' }), strings.import] })), ext?.toolbarExtras && _jsx(ext.toolbarExtras, { model: model, onRefresh: handleRefresh }), toolbarExtras, _jsx(ModelActionToolbar, { model: model, endpoint: dataEndpoint, actions: metadata?.actions, onChange: handleRefresh }), showCreate && (_jsxs("button", { type: 'button', onClick: () => setOpenCreate(true), className: 'inline-flex items-center gap-2 h-9 px-3 rounded-md bg-primary text-primary-foreground hover:opacity-90 text-sm font-medium', children: [_jsx(Plus, { className: 'size-4' }), resolvedNewLabel ?? `${strings.newPrefix} ${singular}`] }))] })] }), _jsx("div", { className: tableWrapperCls, children: _jsx(DynamicTable, { model: model, endpoint: dataEndpoint, refreshTrigger: refreshKey }, model) })] }), showCreate && (_jsx(DynamicRecordDialog, { open: openCreate, onOpenChange: setOpenCreate, mode: 'create', model: model, endpoint: dataEndpoint, onSaved: handleRefresh })), metadata && showExport && (_jsx(ExportDialog, { open: openExport, onOpenChange: setOpenExport, model: model, metadata: metadata })), metadata && showImport && (_jsx(ImportDialog, { open: openImport, onOpenChange: setOpenImport, model: model, metadata: metadata, onImported: handleRefresh }))] }));
 }

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

@@ -1 +1 @@
-{"version":3,"file":"dynamic-table.d.ts","sourceRoot":"","sources":["../src/dynamic-table.tsx"],"names":[],"mappings":"AAiBA,OAAO,EAKH,KAAK,SAAS,EAajB,MAAM,uBAAuB,CAAA;AA+B9B,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAUnF,UAAU,iBAAiB;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;IAC7C,cAAc,CAAC,EAAE,GAAG,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACpC,YAAY,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAA;IAC/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACxC;AAED,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,aAAoB,EACpB,aAAkB,EAClB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,YAAiB,EACjB,iBAA4C,GAC/C,EAAE,iBAAiB,2CA+sBnB"}
+{"version":3,"file":"dynamic-table.d.ts","sourceRoot":"","sources":["../src/dynamic-table.tsx"],"names":[],"mappings":"AAiBA,OAAO,EAKH,KAAK,SAAS,EAajB,MAAM,uBAAuB,CAAA;AA+B9B,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAUnF,UAAU,iBAAiB;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;IAC7C,cAAc,CAAC,EAAE,GAAG,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACpC,YAAY,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAA;IAC/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACxC;AAED,wBAAgB,YAAY,CAAC,EACzB,KAAK,EACL,QAAQ,EACR,aAAoB,EACpB,aAAkB,EAClB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,YAAiB,EACjB,iBAA4C,GAC/C,EAAE,iBAAiB,2CAqtBnB"}

package/dist/dynamic-table.js

@@ -532,7 +532,13 @@ export function DynamicTable({ model, endpoint, enableUrlSync = true, hiddenColu
     const columns = useMemo(() => {
         if (!metadata)
             return [];
-        const baseColumns = getDynamicColumns(metadata, handleInternalAction, t, i18n.language, columnFilterConfigs);
+        // Row-action column only renders per-row actions. Table-level placements
+        // ("table"/"create") are surfaced by <ModelActionToolbar> at the page
+        // level, so strip them here to avoid a meaningless per-row button.
+        const rowMetadata = metadata.actions?.some((a) => a.placement === 'table' || a.placement === 'create')
+            ? { ...metadata, actions: metadata.actions.filter((a) => !a.placement || a.placement === 'row') }
+            : metadata;
+        const baseColumns = getDynamicColumns(rowMetadata, handleInternalAction, t, i18n.language, columnFilterConfigs);
         const filteredBase = baseColumns.filter((col) => !hiddenColumns.includes(col.id));
         const actionsCol = filteredBase.find((c) => c.id === 'actions');
         const otherCols = filteredBase.filter((c) => c.id !== 'actions');

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './options-context';
 export * from './dynamic-table';
 export * from './dynamic-form';
 export { ActionModalDispatcher, type ActionModalProps, } from './action-modal-dispatcher';
+export { ModelActionToolbar, useModelActions, type ModelActionToolbarProps, type ActionPlacement, } from './model-action-toolbar';
 export * from './addon-loader';
 export { AddonLayoutProvider, useAddonLayout, useAddonLayoutControl, useDeclareAddonLayout, type AddonLayout, type AddonLayoutProviderProps, } from './addon-layout-context';
 export * from './slot';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"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,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EACH,qBAAqB,EACrB,KAAK,gBAAgB,GACxB,MAAM,2BAA2B,CAAA;AAClC,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,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,KAAK,qBAAqB,GAC7B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,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,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,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -8,6 +8,7 @@ export * from './options-context';
 export * from './dynamic-table';
 export * from './dynamic-form';
 export { ActionModalDispatcher, } from './action-modal-dispatcher';
+export { ModelActionToolbar, useModelActions, } from './model-action-toolbar';
 export * from './addon-loader';
 export { AddonLayoutProvider, useAddonLayout, useAddonLayoutControl, useDeclareAddonLayout, } from './addon-layout-context';
 export * from './slot';

package/dist/model-action-toolbar.d.ts

@@ -0,0 +1,27 @@
+import type { ActionDefinition } from './types';
+export type ActionPlacement = 'row' | 'table' | 'create';
+export interface ModelActionToolbarProps {
+    /** Model key as registered on the backend (e.g. "JournalEntry"). */
+    model: string;
+    /** Data endpoint passed to the dispatcher. Defaults to `/data/<model>/me`. */
+    endpoint?: string;
+    /**
+     * Pre-fetched action definitions. When omitted the toolbar reads them from
+     * the metadata cache, falling back to `/metadata/table/<model>`. Pass this
+     * when the host page already holds the metadata to avoid a second fetch.
+     */
+    actions?: ActionDefinition[];
+    /** Which placements to render. Defaults to `['table', 'create']`. */
+    placements?: ActionPlacement[];
+    /** Fired after an action's modal reports success. */
+    onChange?: () => void;
+    /** Extra classes on the button row container. */
+    className?: string;
+}
+/**
+ * Returns the model's actions matching the requested placements. Reads from the
+ * `actions` prop when provided, else the metadata cache, else fetches once.
+ */
+export declare function useModelActions(model: string, placements?: ActionPlacement[], provided?: ActionDefinition[]): ActionDefinition[];
+export declare function ModelActionToolbar({ model, endpoint, actions, placements, onChange, className, }: ModelActionToolbarProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=model-action-toolbar.d.ts.map

package/dist/model-action-toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-action-toolbar.d.ts","sourceRoot":"","sources":["../src/model-action-toolbar.tsx"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,gBAAgB,EAAiC,MAAM,SAAS,CAAA;AAE9E,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;AAExD,MAAM,WAAW,uBAAuB;IACpC,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B,qEAAqE;IACrE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAmBD;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,eAAe,EAAuB,EAClD,QAAQ,CAAC,EAAE,gBAAgB,EAAE,GAC9B,gBAAgB,EAAE,CA2BpB;AAED,wBAAgB,kBAAkB,CAAC,EAC/B,KAAK,EACL,QAAQ,EACR,OAAO,EACP,UAA+B,EAC/B,QAAQ,EACR,SAAS,GACZ,EAAE,uBAAuB,kDA4CzB"}

package/dist/model-action-toolbar.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+// ModelActionToolbar — renders page-level (toolbar) triggers for a model's
+// declarative actions and owns the modal dispatch for them.
+//
+// A model's actions carry a `placement` hint (see manifest/v3 Action.placement):
+//   "row" (default) — rendered per-row inside <DynamicTable>'s action column.
+//   "table"         — a plain toolbar button (no record context).
+//   "create"        — a primary toolbar button that replaces the generic
+//                     "create" button, for addons shipping a custom create
+//                     experience (e.g. a journal entry with debit/credit lines).
+//
+// This component renders the buttons for the placements it's asked to surface
+// (default: table + create) and mounts the <ActionModalDispatcher>, which
+// resolves either a custom federated modal (registered via the action registry)
+// or the generic declarative form. For create-style actions there is no record
+// yet, so the dispatcher receives an empty record `{}`.
+//
+// It is the single generic primitive every host consumes — DynamicCRUDPage uses
+// it internally, and bespoke host pages (e.g. ops `/m/$model`) mount it directly
+// next to their own toolbar. Hosts never reimplement action-button plumbing.
+import { useEffect, useMemo, useState } from 'react';
+import { Button } from '@asteby/metacore-ui/primitives';
+import { useApi } from './api-context';
+import { useMetadataCache } from './metadata-cache';
+import { DynamicIcon } from './dynamic-icon';
+import { ActionModalDispatcher } from './action-modal-dispatcher';
+const DEFAULT_PLACEMENTS = ['table', 'create'];
+function toActionMetadata(a) {
+    return {
+        key: a.key,
+        label: a.label,
+        icon: a.icon || 'Zap',
+        color: a.color,
+        confirm: a.confirm,
+        confirmMessage: a.confirmMessage,
+        fields: a.fields,
+        requiresState: a.requiresState,
+        executable: a.executable,
+        placement: a.placement,
+    };
+}
+/**
+ * Returns the model's actions matching the requested placements. Reads from the
+ * `actions` prop when provided, else the metadata cache, else fetches once.
+ */
+export function useModelActions(model, placements = DEFAULT_PLACEMENTS, provided) {
+    const api = useApi();
+    const cached = useMetadataCache((s) => s.getMetadata(model));
+    const [fetched, setFetched] = useState(null);
+    const haveSource = provided != null || cached != null;
+    useEffect(() => {
+        if (haveSource)
+            return;
+        let cancelled = false;
+        api
+            .get(`/metadata/table/${model}`)
+            .then((res) => {
+            if (!cancelled)
+                setFetched((res.data?.data ?? res.data));
+        })
+            .catch(() => {
+            if (!cancelled)
+                setFetched(null);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [model, haveSource, api]);
+    const all = provided ?? cached?.actions ?? fetched?.actions ?? [];
+    return useMemo(() => all.filter((a) => placements.includes((a.placement ?? 'row'))), [all, placements]);
+}
+export function ModelActionToolbar({ model, endpoint, actions, placements = DEFAULT_PLACEMENTS, onChange, className, }) {
+    const surfaced = useModelActions(model, placements, actions);
+    const [active, setActive] = useState(null);
+    const dataEndpoint = endpoint ?? `/data/${model}/me`;
+    if (surfaced.length === 0)
+        return null;
+    return (_jsxs(_Fragment, { children: [_jsx("div", { className: className ?? 'flex items-center gap-2', children: surfaced.map((a) => {
+                    const isCreate = (a.placement ?? 'row') === 'create';
+                    return (_jsxs(Button, { variant: isCreate ? 'default' : 'outline', onClick: () => setActive(toActionMetadata(a)), style: a.color && !isCreate ? { borderColor: a.color, color: a.color } : undefined, children: [_jsx(DynamicIcon, { name: a.icon || (isCreate ? 'Plus' : 'Zap'), className: "mr-2 h-4 w-4" }), a.label] }, a.key));
+                }) }), active && (_jsx(ActionModalDispatcher, { open: !!active, onOpenChange: (open) => {
+                    if (!open)
+                        setActive(null);
+                }, action: active, model: model, record: {}, endpoint: dataEndpoint, onSuccess: () => {
+                    setActive(null);
+                    onChange?.();
+                } }))] }));
+}

package/dist/types.d.ts

@@ -147,6 +147,13 @@ export interface ActionDefinition {
     fields?: ActionFieldDef[];
     requiresState?: string[];
     executable?: boolean;
+    /**
+     * Where the host surfaces the trigger. Mirrors manifest/v3 Action.placement.
+     *   "row" (default) — per-row table action.
+     *   "table"         — page toolbar button (no record context).
+     *   "create"        — toolbar button that replaces the generic create button.
+     */
+    placement?: 'row' | 'table' | 'create';
 }
 export interface ApiResponse<T> {
     success: boolean;
@@ -173,5 +180,6 @@ export interface ActionMetadata {
     fields?: ActionFieldDef[];
     requiresState?: string[];
     executable?: boolean;
+    placement?: 'row' | 'table' | 'create';
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,MAAM,CAAA;IACnE,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACrF,cAAc,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjF,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,qBAAqB,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,GAAG,OAAO,CAAA;IAC3I,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC3E;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,UAAU,CAAC,EAAE,eAAe,CAAA;CAC/B;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAA;IACxC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC3B;AASD,MAAM,WAAW,eAAe;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAID,MAAM,MAAM,WAAW,GACjB,MAAM,GACN,UAAU,GACV,UAAU,GACV,OAAO,GACP,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,QAAQ,CAAA;AAEd,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC5C,YAAY,CAAC,EAAE,GAAG,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;IAC7B;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAA;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;IACpD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;CACzC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,CAAC,CAAA;IACP,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CAChB;AAKD,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;CACzC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "12.0.0",
+  "version": "13.1.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",
@@ -32,8 +32,8 @@
     "lucide-react": ">=0.460",
     "date-fns": ">=3",
     "react-day-picker": ">=8",
-    "@asteby/metacore-sdk": "^3.0.0",
-    "@asteby/metacore-ui": "^2.0.1"
+    "@asteby/metacore-sdk": "^3.1.0",
+    "@asteby/metacore-ui": "^2.1.0"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-router": {
@@ -60,8 +60,8 @@
     "typescript": "^6.0.0",
     "vitest": "^4.0.0",
     "zustand": "^5.0.0",
-    "@asteby/metacore-sdk": "3.0.0",
-    "@asteby/metacore-ui": "2.0.1"
+    "@asteby/metacore-sdk": "3.1.0",
+    "@asteby/metacore-ui": "2.1.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/addon-loader.tsx

@@ -43,6 +43,18 @@ export interface AddonLoaderProps {
     children?: React.ReactNode
 }
 
+interface FederationContainer {
+    init: (shareScope: unknown) => Promise<void>
+    get: (module: string) => Promise<() => any>
+}
+
+// Runtime dynamic import of an external URL. Wrapped in `new Function` so no
+// build tool (tsc here, Vite in the consuming host) tries to statically
+// analyse or rewrite the import — it stays a genuine runtime ESM fetch.
+const importModule = new Function('u', 'return import(u)') as (
+    u: string,
+) => Promise<Record<string, unknown>>
+
 const loadedScripts = new Map<string, Promise<void>>()
 
 function loadScript(url: string, scope: string): Promise<void> {
@@ -62,19 +74,53 @@ function loadScript(url: string, scope: string): Promise<void> {
     return promise
 }
 
-interface FederationContainer {
-    init: (shareScope: unknown) => Promise<void>
-    get: (module: string) => Promise<() => any>
+const esmContainers = new Map<string, Promise<FederationContainer | undefined>>()
+
+// Resolve a federation container for the remote. Vite/@originjs remotes built
+// with `format:"esm"` (our standard) are ES modules that top-level `import`
+// their preload helper and export `{ init, get }` — they MUST be loaded as a
+// module (a classic <script> throws "Cannot use import statement outside a
+// module"), so we dynamic-import them and use the module namespace as the
+// container. Legacy "var"/window remotes (which assign `window[scope]`) are
+// still supported via the classic <script> fallback.
+async function resolveContainer(scope: string, url: string): Promise<FederationContainer | undefined> {
+    const key = `${scope}::${url}`
+    const cached = esmContainers.get(key)
+    if (cached) return cached
+    const p = (async () => {
+        try {
+            const mod = await importModule(url)
+            if (mod && typeof mod.init === 'function' && typeof mod.get === 'function') {
+                return mod as unknown as FederationContainer
+            }
+        } catch {
+            // Not an importable module (legacy var-format remote) — fall back.
+        }
+        await loadScript(url, scope)
+        return (window as any)[scope] as FederationContainer | undefined
+    })()
+    esmContainers.set(key, p)
+    p.catch(() => esmContainers.delete(key))
+    return p
 }
 
-async function loadRemote(scope: string, module: string) {
+async function loadRemote(scope: string, url: string, module: string) {
     if (typeof window.__webpack_init_sharing__ === 'function') {
         await window.__webpack_init_sharing__('default')
     }
-    const container = window[scope] as FederationContainer | undefined
-    if (!container) throw new Error(`Addon container "${scope}" not found on window`)
-    if (typeof container.init === 'function' && window.__webpack_share_scopes__) {
-        await container.init(window.__webpack_share_scopes__.default)
+    const container = await resolveContainer(scope, url)
+    if (!container) {
+        throw new Error(`Addon container "${scope}" not found (neither ESM export nor window[scope])`)
+    }
+    if (typeof container.init === 'function') {
+        const shareScope =
+            window.__webpack_share_scopes__?.default ??
+            ((window as any).__METACORE_SHARE_SCOPE__ ??= {})
+        try {
+            await container.init(shareScope)
+        } catch {
+            // Container already initialized (re-entrant load) — safe to ignore.
+        }
     }
     const factory = await container.get(module)
     return factory()
@@ -105,9 +151,7 @@ export function AddonLoader({
         let cancelled = false
         ;(async () => {
             try {
-                await loadScript(url, scope)
-                if (cancelled) return
-                const mod = await loadRemote(scope, module)
+                const mod = await loadRemote(scope, url, module)
                 if (cancelled) return
                 if (!didRegister.current && typeof mod?.register === 'function') {
                     didRegister.current = true

package/src/dynamic-crud-page.tsx

@@ -36,6 +36,7 @@ import { DynamicRecordDialog } from './dialogs/dynamic-record'
 import { ExportDialog } from './dialogs/export'
 import { ImportDialog } from './dialogs/import'
 import { getModelExtension } from './model-extension-registry'
+import { ModelActionToolbar } from './model-action-toolbar'
 import type { TableMetadata } from './types'
 
 export interface DynamicCRUDPageStrings {
@@ -153,7 +154,10 @@ export function DynamicCRUDPage(props: DynamicCRUDPageProps) {
     }, [title])
 
     const enableCRUD = metadata?.enableCRUDActions ?? false
-    const effectiveHideCreate = hideCreate || ext?.hideCreate
+    // A "create"-placement action ships a custom create experience — it
+    // replaces the generic create button (the ModelActionToolbar renders it).
+    const hasCreateAction = metadata?.actions?.some((a) => a.placement === 'create') ?? false
+    const effectiveHideCreate = hideCreate || ext?.hideCreate || hasCreateAction
     const effectiveHideExport = hideExport || ext?.hideExport
     const effectiveHideImport = hideImport || ext?.hideImport
     // Refresh defaults to hidden in the page header — <DynamicTable> ships
@@ -222,6 +226,12 @@ export function DynamicCRUDPage(props: DynamicCRUDPageProps) {
                         )}
                         {ext?.toolbarExtras && <ext.toolbarExtras model={model} onRefresh={handleRefresh} />}
                         {toolbarExtras}
+                        <ModelActionToolbar
+                            model={model}
+                            endpoint={dataEndpoint}
+                            actions={metadata?.actions}
+                            onChange={handleRefresh}
+                        />
                         {showCreate && (
                             <button
                                 type='button'

package/src/dynamic-table.tsx

@@ -569,7 +569,13 @@ export function DynamicTable({
 
     const columns = useMemo(() => {
         if (!metadata) return []
-        const baseColumns = getDynamicColumns(metadata, handleInternalAction, t, i18n.language, columnFilterConfigs)
+        // Row-action column only renders per-row actions. Table-level placements
+        // ("table"/"create") are surfaced by <ModelActionToolbar> at the page
+        // level, so strip them here to avoid a meaningless per-row button.
+        const rowMetadata = metadata.actions?.some((a) => a.placement === 'table' || a.placement === 'create')
+            ? { ...metadata, actions: metadata.actions.filter((a) => !a.placement || a.placement === 'row') }
+            : metadata
+        const baseColumns = getDynamicColumns(rowMetadata, handleInternalAction, t, i18n.language, columnFilterConfigs)
         const filteredBase = baseColumns.filter((col: ColumnDef<any>) => !hiddenColumns.includes(col.id as string))
         const actionsCol = filteredBase.find((c: ColumnDef<any>) => c.id === 'actions')
         const otherCols = filteredBase.filter((c: ColumnDef<any>) => c.id !== 'actions')

package/src/index.ts

@@ -11,6 +11,12 @@ export {
     ActionModalDispatcher,
     type ActionModalProps,
 } from './action-modal-dispatcher'
+export {
+    ModelActionToolbar,
+    useModelActions,
+    type ModelActionToolbarProps,
+    type ActionPlacement,
+} from './model-action-toolbar'
 export * from './addon-loader'
 export {
     AddonLayoutProvider,

package/src/model-action-toolbar.tsx

@@ -0,0 +1,154 @@
+// ModelActionToolbar — renders page-level (toolbar) triggers for a model's
+// declarative actions and owns the modal dispatch for them.
+//
+// A model's actions carry a `placement` hint (see manifest/v3 Action.placement):
+//   "row" (default) — rendered per-row inside <DynamicTable>'s action column.
+//   "table"         — a plain toolbar button (no record context).
+//   "create"        — a primary toolbar button that replaces the generic
+//                     "create" button, for addons shipping a custom create
+//                     experience (e.g. a journal entry with debit/credit lines).
+//
+// This component renders the buttons for the placements it's asked to surface
+// (default: table + create) and mounts the <ActionModalDispatcher>, which
+// resolves either a custom federated modal (registered via the action registry)
+// or the generic declarative form. For create-style actions there is no record
+// yet, so the dispatcher receives an empty record `{}`.
+//
+// It is the single generic primitive every host consumes — DynamicCRUDPage uses
+// it internally, and bespoke host pages (e.g. ops `/m/$model`) mount it directly
+// next to their own toolbar. Hosts never reimplement action-button plumbing.
+import { useEffect, useMemo, useState } from 'react'
+import { Button } from '@asteby/metacore-ui/primitives'
+import { useApi } from './api-context'
+import { useMetadataCache } from './metadata-cache'
+import { DynamicIcon } from './dynamic-icon'
+import { ActionModalDispatcher } from './action-modal-dispatcher'
+import type { ActionDefinition, ActionMetadata, TableMetadata } from './types'
+
+export type ActionPlacement = 'row' | 'table' | 'create'
+
+export interface ModelActionToolbarProps {
+    /** Model key as registered on the backend (e.g. "JournalEntry"). */
+    model: string
+    /** Data endpoint passed to the dispatcher. Defaults to `/data/<model>/me`. */
+    endpoint?: string
+    /**
+     * Pre-fetched action definitions. When omitted the toolbar reads them from
+     * the metadata cache, falling back to `/metadata/table/<model>`. Pass this
+     * when the host page already holds the metadata to avoid a second fetch.
+     */
+    actions?: ActionDefinition[]
+    /** Which placements to render. Defaults to `['table', 'create']`. */
+    placements?: ActionPlacement[]
+    /** Fired after an action's modal reports success. */
+    onChange?: () => void
+    /** Extra classes on the button row container. */
+    className?: string
+}
+
+const DEFAULT_PLACEMENTS: ActionPlacement[] = ['table', 'create']
+
+function toActionMetadata(a: ActionDefinition): ActionMetadata {
+    return {
+        key: a.key,
+        label: a.label,
+        icon: a.icon || 'Zap',
+        color: a.color,
+        confirm: a.confirm,
+        confirmMessage: a.confirmMessage,
+        fields: a.fields,
+        requiresState: a.requiresState,
+        executable: a.executable,
+        placement: a.placement,
+    }
+}
+
+/**
+ * Returns the model's actions matching the requested placements. Reads from the
+ * `actions` prop when provided, else the metadata cache, else fetches once.
+ */
+export function useModelActions(
+    model: string,
+    placements: ActionPlacement[] = DEFAULT_PLACEMENTS,
+    provided?: ActionDefinition[],
+): ActionDefinition[] {
+    const api = useApi()
+    const cached = useMetadataCache((s) => s.getMetadata(model))
+    const [fetched, setFetched] = useState<TableMetadata | null>(null)
+
+    const haveSource = provided != null || cached != null
+    useEffect(() => {
+        if (haveSource) return
+        let cancelled = false
+        api
+            .get(`/metadata/table/${model}`)
+            .then((res) => {
+                if (!cancelled) setFetched((res.data?.data ?? res.data) as TableMetadata)
+            })
+            .catch(() => {
+                if (!cancelled) setFetched(null)
+            })
+        return () => {
+            cancelled = true
+        }
+    }, [model, haveSource, api])
+
+    const all = provided ?? cached?.actions ?? fetched?.actions ?? []
+    return useMemo(
+        () => all.filter((a) => placements.includes((a.placement ?? 'row') as ActionPlacement)),
+        [all, placements],
+    )
+}
+
+export function ModelActionToolbar({
+    model,
+    endpoint,
+    actions,
+    placements = DEFAULT_PLACEMENTS,
+    onChange,
+    className,
+}: ModelActionToolbarProps) {
+    const surfaced = useModelActions(model, placements, actions)
+    const [active, setActive] = useState<ActionMetadata | null>(null)
+    const dataEndpoint = endpoint ?? `/data/${model}/me`
+
+    if (surfaced.length === 0) return null
+
+    return (
+        <>
+            <div className={className ?? 'flex items-center gap-2'}>
+                {surfaced.map((a) => {
+                    const isCreate = (a.placement ?? 'row') === 'create'
+                    return (
+                        <Button
+                            key={a.key}
+                            variant={isCreate ? 'default' : 'outline'}
+                            onClick={() => setActive(toActionMetadata(a))}
+                            style={a.color && !isCreate ? { borderColor: a.color, color: a.color } : undefined}
+                        >
+                            <DynamicIcon name={a.icon || (isCreate ? 'Plus' : 'Zap')} className="mr-2 h-4 w-4" />
+                            {a.label}
+                        </Button>
+                    )
+                })}
+            </div>
+
+            {active && (
+                <ActionModalDispatcher
+                    open={!!active}
+                    onOpenChange={(open) => {
+                        if (!open) setActive(null)
+                    }}
+                    action={active}
+                    model={model}
+                    record={{}}
+                    endpoint={dataEndpoint}
+                    onSuccess={() => {
+                        setActive(null)
+                        onChange?.()
+                    }}
+                />
+            )}
+        </>
+    )
+}

package/src/types.ts

@@ -162,6 +162,13 @@ export interface ActionDefinition {
     fields?: ActionFieldDef[]
     requiresState?: string[]
     executable?: boolean
+    /**
+     * Where the host surfaces the trigger. Mirrors manifest/v3 Action.placement.
+     *   "row" (default) — per-row table action.
+     *   "table"         — page toolbar button (no record context).
+     *   "create"        — toolbar button that replaces the generic create button.
+     */
+    placement?: 'row' | 'table' | 'create'
 }
 
 export interface ApiResponse<T> {
@@ -194,4 +201,5 @@ export interface ActionMetadata {
     fields?: ActionFieldDef[]
     requiresState?: string[]
     executable?: boolean
+    placement?: 'row' | 'table' | 'create'
 }