@asteby/metacore-runtime-react 13.1.0 → 13.3.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @asteby/metacore-runtime-react
 
+## 13.3.0
+
+### Minor Changes
+
+- 99477d6: feat(runtime-react): add `dynamic_select` field widget — async searchable FK picker
+
+  Declarative answer to "I don't want to type a raw FK UUID". A field with
+  `type: "dynamic_select"` (or `widget: "dynamic_select"`) + `ref` renders a
+  typeahead combobox that queries the canonical options endpoint as the user
+  types (`GET /api/options/<ref>?field=id&q=<text>&limit=<n>`), reusing
+  `useOptionsResolver` (debounced, abortable). Works both as a flat form field
+  and as a line-items column cell (e.g. the account_id per debit/credit row of a
+  journal entry). The metacore equivalent of 7leguas' `type: search`, driven
+  entirely from the manifest — addons get a searchable picker with zero custom
+  React, keeping custom federated frontends for genuinely page-level UIs (POS).
+
+## 13.2.0
+
+### Minor Changes
+
+- fb45ad4: Migrate federation tooling from the broken `@originjs/vite-plugin-federation` to the official `@module-federation/vite` + `@module-federation/runtime`.
+
+  **BREAKING (federation runtime swap — hosts and addons must rebuild):**
+  - `metacoreFederationShared()` (starter-config) now returns a `@module-federation/vite` `federation()` config instead of an `@originjs` config. Same signature/call-sites: `metacoreFederationShared({ host })` → host config (name + shared, empty remotes — remotes register dynamically at runtime); `metacoreFederationShared({ host, exposes })` → remote config (name + filename + exposes + shared). Hosts MUST switch their `vite.config.ts` to `import { federation } from '@module-federation/vite'`.
+  - The shared singleton list is now `{ singleton: true }` (no `requiredVersion: false`) and matches the addon + ops host contract exactly: `react`, `react-dom`, `react/jsx-runtime`, `react-i18next`, `i18next`, `@asteby/metacore-ui`, `@asteby/metacore-runtime-react`, `@asteby/metacore-sdk`, `@asteby/metacore-app-providers`, `@asteby/metacore-theme`, `@asteby/metacore-auth`. **Build-time gotcha:** `@module-federation/vite` resolves every shared bare specifier at build time, so each must be an installed (dev)dependency of the building package.
+  - `AddonLoader` (runtime-react) now uses `@module-federation/runtime` (`registerRemotes` + `loadRemote`) instead of the manual `init`/`get`/`window[scope]` machinery. The host's `@module-federation/vite` build auto-initialises the shared scope, so the remote consumes the HOST's React/SDK singletons — fixing the `useState`-null crash.
+  - `clearFederationContainer()` is now a deprecated no-op under the MF runtime (container replacement on hot-swap is handled by `registerRemotes(..., { force: true })`).
+
 ## 13.1.0
 
 ### Minor Changes

package/dist/addon-loader.d.ts

@@ -1,15 +1,8 @@
 import type { AddonAPI, AddonLayout } from '@asteby/metacore-sdk';
-declare global {
-    interface Window {
-        [key: string]: any;
-        __webpack_init_sharing__?: (scope: string) => Promise<void>;
-        __webpack_share_scopes__?: Record<string, unknown>;
-    }
-}
 export interface AddonLoaderProps {
     /** Unique key of the addon — maps to the federation container name. */
     scope: string;
-    /** URL of the addon's remoteEntry.js bundle. */
+    /** URL of the addon's remoteEntry.js bundle (may carry a `?v=` cache-bust). */
     url: string;
     /** Exposed module to import from the remote (e.g. './register'). */
     module?: string;

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;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"}
+{"version":3,"file":"addon-loader.d.ts","sourceRoot":"","sources":["../src/addon-loader.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGjE,MAAM,WAAW,gBAAgB;IAC7B,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,+EAA+E;IAC/E,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;AA6CD,wBAAgB,WAAW,CAAC,EACxB,KAAK,EACL,GAAG,EACH,MAAqB,EACrB,GAAG,EACH,QAAe,EACf,OAAO,EACP,OAAO,EACP,MAAM,EACN,QAAQ,GACX,EAAE,gBAAgB,2CA8ClB"}

package/dist/addon-loader.js

@@ -1,81 +1,46 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// Minimal federated-module addon loader. Injects a remoteEntry.js <script>,
-// waits for the `window[scope]` container to initialize, then calls the
-// addon's `register(api)` export with the AddonAPI injected by the host.
+// Federated-module addon loader, built on the official Module Federation
+// runtime (`@module-federation/runtime`). Per addon it registers the remote's
+// `remoteEntry.js` as an ESM container, loads the exposed `./register` module,
+// and calls `register(api)` with the AddonAPI injected by the host.
+//
+// Why @module-federation/runtime (not the old manual init/get machinery):
+// the host's Vite build uses `@module-federation/vite`'s `federation()` plugin,
+// which auto-initialises the shared scope at host boot. `registerRemotes` +
+// `loadRemote` then transparently wire the remote into that already-initialised
+// share scope — so the remote consumes the HOST's React/SDK singletons instead
+// of bundling its own. That's the whole point: it fixes the `useState`-null
+// crash WITHOUT this loader ever touching a share scope manually.
 import { useEffect, useRef, useState } from 'react';
+import { registerRemotes, loadRemote } from '@module-federation/runtime';
 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}`;
-    const existing = loadedScripts.get(key);
-    if (existing)
-        return existing;
-    const promise = new Promise((resolve, reject) => {
-        const el = document.createElement('script');
-        el.src = url;
-        el.type = 'text/javascript';
-        el.async = true;
-        el.onload = () => resolve();
-        el.onerror = () => reject(new Error(`Failed to load addon script: ${url}`));
-        document.head.appendChild(el);
-    });
-    loadedScripts.set(key, promise);
-    return promise;
+// `registerRemotes` is additive + idempotent across re-mounts; we still track
+// which scopes we've registered to avoid redundant `force` churn (each `force`
+// re-register wipes that remote's module cache and logs a runtime warning).
+const registered = new Set();
+// Derive the `loadRemote` id from the scope + exposed module name. MF resolves
+// `"<remoteName>/<expose>"` — e.g. `metacore_tickets/register` for the
+// `"./register"` expose. We strip the leading `./` of the expose path.
+function remoteId(scope, module) {
+    const expose = module.replace(/^\.\//, '');
+    return `${scope}/${expose}`;
 }
-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 = await resolveContainer(scope, url);
-    if (!container) {
-        throw new Error(`Addon container "${scope}" not found (neither ESM export nor window[scope])`);
+async function loadAddon(scope, url, module) {
+    // Register the remote container as an ES module. `type: 'module'` matches
+    // the `@module-federation/vite` remote (remoteEntry.js is an ESM bundle).
+    // The `url` already carries the `?v=` cache-bust the host computed, so the
+    // browser refetches a fresh remoteEntry when the addon version changes.
+    if (!registered.has(scope)) {
+        registerRemotes([{ name: scope, entry: url, type: 'module' }], 
+        // `force: true` so a re-registration with a new `?v=` URL (addon
+        // hot-swap / version bump) overwrites the stale entry + cache.
+        { force: true });
+        registered.add(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();
+    // loadRemote("<scope>/<expose>") returns the exposed module namespace (or
+    // null if it can't be resolved). No manual share-scope init — the host's
+    // federation runtime already initialised it.
+    return loadRemote(remoteId(scope, module));
 }
 export function AddonLoader({ scope, url, module = './register', api, fallback = null, onReady, onError, layout, children, }) {
     const [status, setStatus] = useState('loading');
@@ -90,12 +55,16 @@ export function AddonLoader({ scope, url, module = './register', api, fallback =
         let cancelled = false;
         (async () => {
             try {
-                const mod = await loadRemote(scope, url, module);
+                const mod = await loadAddon(scope, url, module);
                 if (cancelled)
                     return;
-                if (!didRegister.current && typeof mod?.register === 'function') {
+                const register = mod?.register ?? mod?.default;
+                if (typeof register !== 'function') {
+                    throw new Error(`Addon "${scope}" module "${module}" has no register() export`);
+                }
+                if (!didRegister.current) {
                     didRegister.current = true;
-                    await Promise.resolve(mod.register(api));
+                    await Promise.resolve(register(api));
                 }
                 setStatus('ready');
                 onReady?.();
@@ -103,12 +72,15 @@ export function AddonLoader({ scope, url, module = './register', api, fallback =
             catch (e) {
                 if (cancelled)
                     return;
-                setError(e);
+                const err = e instanceof Error ? e : new Error(String(e));
+                setError(err);
                 setStatus('error');
-                onError?.(e);
+                onError?.(err);
             }
         })();
-        return () => { cancelled = true; };
+        return () => {
+            cancelled = true;
+        };
     }, [scope, url, module]);
     if (status === 'loading')
         return _jsx(_Fragment, { children: fallback });

package/dist/dynamic-form-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-form-schema.d.ts","sourceRoot":"","sources":["../src/dynamic-form-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAmB,MAAM,KAAK,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,SAAS,CAAA;AAiB9D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,GAAG,IAAI,CAEzF;AAcD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE;;kBAMtD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,EAAE,CAGrE;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE/D;AAqDD,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAU3D"}
+{"version":3,"file":"dynamic-form-schema.d.ts","sourceRoot":"","sources":["../src/dynamic-form-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAmB,MAAM,KAAK,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,SAAS,CAAA;AAiB9D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS,GAAG,IAAI,CAEzF;AAcD,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE;;kBAMtD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,EAAE,CAGrE;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE/D;AAqDD,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAa3D"}

package/dist/dynamic-form-schema.js

@@ -116,6 +116,9 @@ export function resolveWidget(field) {
     switch (field.type) {
         case 'textarea': return 'textarea';
         case 'select': return 'select';
+        // Async searchable single-select against /api/options/<ref>. The
+        // declarative replacement for typing a raw FK UUID.
+        case 'dynamic_select': return 'dynamic_select';
         case 'boolean': return 'switch';
         case 'number': return 'number';
         case 'date': return 'date';

package/dist/dynamic-form.d.ts

@@ -2,6 +2,7 @@ import type { ActionFieldDef } from './types';
 import { buildZodSchema, resolveWidget } from './dynamic-form-schema';
 export { buildZodSchema, resolveWidget };
 export { DynamicLineItems } from './dynamic-line-items';
+export { DynamicSelectField } from './dynamic-select-field';
 export interface DynamicFormProps {
     fields: ActionFieldDef[];
     initialValues?: Record<string, any>;

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

@@ -1 +1 @@
-{"version":3,"file":"dynamic-form.d.ts","sourceRoot":"","sources":["../src/dynamic-form.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAoB,MAAM,uBAAuB,CAAA;AAIvF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEvD,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,WAAW,CAAC,EACxB,MAAM,EACN,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,WAAuB,EACvB,WAAwB,EACxB,QAAgB,GACnB,EAAE,gBAAgB,2CAoElB"}
+{"version":3,"file":"dynamic-form.d.ts","sourceRoot":"","sources":["../src/dynamic-form.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAoB,MAAM,uBAAuB,CAAA;AAKvF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,wBAAgB,WAAW,CAAC,EACxB,MAAM,EACN,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,WAAuB,EACvB,WAAwB,EACxB,QAAgB,GACnB,EAAE,gBAAgB,2CAoElB"}

package/dist/dynamic-form.js

@@ -7,8 +7,10 @@ import { Input, Textarea, Label, Switch, Button, Select, SelectContent, SelectIt
 import { buildZodSchema, resolveWidget, isLineItemsField } from './dynamic-form-schema';
 import { useOptionsResolver } from './use-options-resolver';
 import { DynamicLineItems } from './dynamic-line-items';
+import { DynamicSelectField } from './dynamic-select-field';
 export { buildZodSchema, resolveWidget };
 export { DynamicLineItems } from './dynamic-line-items';
+export { DynamicSelectField } from './dynamic-select-field';
 export function DynamicForm({ fields, initialValues, onSubmit, onCancel, submitLabel = 'Guardar', cancelLabel = 'Cancelar', disabled = false, }) {
     const [values, setValues] = useState({});
     const [errors, setErrors] = useState({});
@@ -58,6 +60,12 @@ function FieldRenderer({ field, value, onChange }) {
         return _jsx(DynamicLineItems, { field: field, value: value, onChange: onChange });
     }
     const widget = resolveWidget(field);
+    // Async searchable picker (typeahead against /api/options/<ref>?q=…).
+    // Preferred for FK fields with large option sets — no UUID typing, no
+    // dumping every row into a plain <select>.
+    if (widget === 'dynamic_select') {
+        return _jsx(DynamicSelectField, { field: field, value: value, onChange: onChange });
+    }
     // Ref-driven select: hook into useOptionsResolver so the canonical
     // /api/options/<ref>?field=id endpoint feeds the dropdown. This is
     // the path the kernel auto-derives for FK columns; legacy callers

package/dist/dynamic-line-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-line-items.d.ts","sourceRoot":"","sources":["../src/dynamic-line-items.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAI7C,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE,cAAc,CAAA;IACrB,KAAK,EAAE,GAAG,EAAE,GAAG,SAAS,CAAA;IACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAUD,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAgB,EAAE,EAAE,qBAAqB,2CAwEnG"}
+{"version":3,"file":"dynamic-line-items.d.ts","sourceRoot":"","sources":["../src/dynamic-line-items.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAK7C,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE,cAAc,CAAA;IACrB,KAAK,EAAE,GAAG,EAAE,GAAG,SAAS,CAAA;IACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAUD,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAgB,EAAE,EAAE,qBAAqB,2CAwEnG"}

package/dist/dynamic-line-items.js

@@ -11,6 +11,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Input, Textarea, Switch, Button, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '@asteby/metacore-ui/primitives';
 import { Plus, Trash2 } from 'lucide-react';
 import { resolveWidget, getItemFields } from './dynamic-form-schema';
+import { DynamicSelectField } from './dynamic-select-field';
 import { useOptionsResolver } from './use-options-resolver';
 function emptyRow(itemFields) {
     const row = {};
@@ -33,6 +34,11 @@ export function DynamicLineItems({ field, value, onChange, disabled = false }) {
 // a scalar widget).
 function CellRenderer({ field, value, onChange, disabled }) {
     const widget = resolveWidget(field);
+    // Async searchable picker per row cell — e.g. the account_id column of a
+    // journal entry's debit/credit lines. Same widget as the flat form.
+    if (widget === 'dynamic_select') {
+        return _jsx(DynamicSelectField, { field: field, value: value, onChange: onChange });
+    }
     if (widget === 'select' && field.ref) {
         return _jsx(RefCell, { field: field, value: value, onChange: onChange, disabled: disabled });
     }

package/dist/dynamic-select-field.d.ts

@@ -0,0 +1,9 @@
+import type { ActionFieldDef } from './types';
+export interface DynamicSelectFieldProps {
+    field: ActionFieldDef;
+    value: any;
+    onChange: (v: any) => void;
+}
+export declare function DynamicSelectField({ field, value, onChange }: DynamicSelectFieldProps): import("react/jsx-runtime").JSX.Element;
+export default DynamicSelectField;
+//# sourceMappingURL=dynamic-select-field.d.ts.map

package/dist/dynamic-select-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-select-field.d.ts","sourceRoot":"","sources":["../src/dynamic-select-field.tsx"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAW7C,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,cAAc,CAAA;IACrB,KAAK,EAAE,GAAG,CAAA;IACV,QAAQ,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;CAC7B;AAED,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,uBAAuB,2CA0GrF;AAED,eAAe,kBAAkB,CAAA"}

package/dist/dynamic-select-field.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// DynamicSelectField — async, searchable single-select for declarative forms.
+//
+// This is the declarative answer to "I don't want to type a raw FK UUID".
+// Instead of a plain <select> that dumps every option (RefSelect) or a free
+// text input, it renders a typeahead combobox that queries the canonical
+// options endpoint as the user types:
+//
+//   GET /api/options/<ref>?field=id&q=<text>&limit=<n>
+//
+// reusing `useOptionsResolver` (which already debounce-aborts in-flight
+// requests). It is the metacore equivalent of 7leguas' `search.go` / dynamic
+// `type: search` field, but driven entirely from the manifest — so an addon
+// declares `type: "dynamic_select"` + `ref` and gets a searchable picker with
+// zero custom React.
+//
+// Resolution path (highest priority first):
+//   1. field.ref          → /options/<ref>?field=id        (canonical, preferred)
+//   2. field.searchEndpoint→ used verbatim as the options endpoint (escape hatch)
+//
+// Edit-mode caveat: resolving an EXISTING value's label requires the id to be
+// in a fetched page (we match by id against loaded options, else show the raw
+// value). A dedicated `?ids=` lookup is a follow-up; create flows — the common
+// case — start empty and never hit this.
+import { useEffect, useState } from 'react';
+import { Button, Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, Popover, PopoverContent, PopoverTrigger, } from '@asteby/metacore-ui/primitives';
+import { Check, ChevronsUpDown, Loader2 } from 'lucide-react';
+import { useOptionsResolver } from './use-options-resolver';
+function useDebounced(value, ms) {
+    const [debounced, setDebounced] = useState(value);
+    useEffect(() => {
+        const t = setTimeout(() => setDebounced(value), ms);
+        return () => clearTimeout(t);
+    }, [value, ms]);
+    return debounced;
+}
+export function DynamicSelectField({ field, value, onChange }) {
+    const [open, setOpen] = useState(false);
+    const [search, setSearch] = useState('');
+    const debounced = useDebounced(search, 250);
+    // Remember the label of the option the user actually picked so the trigger
+    // shows a name (not a UUID) without a round-trip.
+    const [picked, setPicked] = useState(null);
+    const { options, loading } = useOptionsResolver({
+        modelKey: '',
+        fieldKey: 'id',
+        ref: field.ref,
+        // searchEndpoint only drives the URL when there's no ref — ref is the
+        // canonical, kernel-derived path and wins.
+        endpoint: field.ref ? undefined : field.searchEndpoint,
+        query: debounced,
+        limit: 20,
+        // Don't fetch until the popover opens (and keep fetching as the query
+        // changes while open).
+        enabled: open,
+    });
+    const selectedLabel = (picked && String(picked.id) === String(value) ? picked.label : null) ??
+        options.find((o) => String(o.id) === String(value))?.label ??
+        (value ? String(value) : '');
+    const handlePick = (opt) => {
+        setPicked(opt);
+        onChange(String(opt.id));
+        setOpen(false);
+        setSearch('');
+    };
+    return (_jsxs(Popover, { open: open, onOpenChange: setOpen, children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs(Button, { type: "button", variant: "outline", role: "combobox", "aria-expanded": open, id: field.key, className: "w-full justify-between font-normal", "data-empty": !value, children: [_jsx("span", { className: 'truncate ' + (selectedLabel ? '' : 'text-muted-foreground'), children: selectedLabel || field.placeholder || 'Buscar…' }), _jsx(ChevronsUpDown, { className: "ml-2 size-4 shrink-0 opacity-50" })] }) }), _jsx(PopoverContent, { className: "p-0", align: "start", 
+                // Match the trigger width without an arbitrary Tailwind class
+                // (those don't always survive a consuming app's Tailwind scan).
+                style: { width: 'var(--radix-popover-trigger-width)' }, children: _jsxs(Command, { shouldFilter: false, children: [_jsx(CommandInput, { placeholder: field.placeholder || 'Buscar…', value: search, onValueChange: setSearch }), _jsxs(CommandList, { children: [loading && (_jsxs("div", { className: "text-muted-foreground flex items-center justify-center gap-2 py-6 text-sm", children: [_jsx(Loader2, { className: "size-4 animate-spin" }), "Buscando\u2026"] })), !loading && options.length === 0 && (_jsx(CommandEmpty, { children: debounced ? 'Sin resultados' : 'Escribí para buscar…' })), !loading && options.length > 0 && (_jsx(CommandGroup, { className: "max-h-64 overflow-auto", children: options.map((opt) => {
+                                        const isSel = String(opt.id) === String(value);
+                                        return (_jsxs(CommandItem, { value: String(opt.id), onSelect: () => handlePick(opt), children: [_jsx(Check, { className: 'mr-2 size-4 ' + (isSel ? 'opacity-100' : 'opacity-0') }), _jsxs("div", { className: "flex min-w-0 flex-col", children: [_jsx("span", { className: "truncate", children: opt.label }), opt.description && (_jsx("span", { className: "text-muted-foreground truncate text-xs", children: opt.description }))] })] }, String(opt.id)));
+                                    }) }))] })] }) })] }));
+}
+export default DynamicSelectField;

package/dist/hotswap-reload-policy.d.ts

@@ -126,19 +126,15 @@ export declare function useHotSwapReload(client: ManifestHotSwapClient | undefin
  */
 export declare function withVersionParam(url: string, hash: string | undefined): string;
 /**
- * Remove the federation container previously registered on `window[scope]`.
- * Hosts call this from `onSwap` before letting the addon route re-mount
- * so the next `remoteEntry.js` injection creates a fresh container instead
- * of short-circuiting on the cached one.
+ * @deprecated Legacy `@originjs/vite-plugin-federation` helper. Under the
+ * current `@module-federation/runtime` loader ({@link AddonLoader}), container
+ * replacement on hot-swap is handled by `registerRemotes(..., { force: true })`
+ * with the new `?v=` URL — there is no `window[scope]` container to delete.
  *
- * Best-effort: if `window` is undefined (SSR) or the scope was never
- * registered, this is a no-op. Returns `true` if a container was actually
- * removed, `false` otherwise — useful for telemetry.
- *
- * **Caveat:** some federation runtimes wrap the container in a Proxy
- * whose internal state survives `delete`. If you hit `Container already
- * registered` after calling this, the federation runtime is holding the
- * reference internally and the only reliable swap is `"page-reload"`.
+ * Kept for backward compatibility so existing host `onSwap` wiring keeps
+ * compiling. Best-effort: removes a stale `window[scope]` if a legacy
+ * `@originjs` remote left one behind, otherwise a no-op. Returns `true` if a
+ * value was removed, `false` otherwise.
  */
 export declare function clearFederationContainer(scope: string): boolean;
 /**

package/dist/hotswap-reload-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hotswap-reload-policy.d.ts","sourceRoot":"","sources":["../src/hotswap-reload-policy.ts"],"names":[],"mappings":"AA+DA,OAAO,EAEH,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,8BAA8B,EACtC,MAAM,+BAA+B,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAA;AAEtE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IAChC;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAE,CACb,KAAK,EAAE,2BAA2B,KACjC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CACL,KAAK,EAAE,2BAA2B,EAClC,MAAM,EAAE,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,KACvD,IAAI,CAAA;IACT;;;OAGG;IACH,OAAO,CAAC,EAAE,8BAA8B,CAAC,SAAS,CAAC,CAAA;CACtD;AAED,MAAM,WAAW,sBAAsB;IACnC;;;;;;;;OAQG;IACH,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GACzB,OAAO,GACP,aAAa,GACb,WAAW,GACX,QAAQ,GACR,MAAM,CAAA;AAEZ,MAAM,WAAW,iBAAiB;IAC9B,0EAA0E;IAC1E,aAAa,EAAE,CACX,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAChE,IAAI,CAAA;IACT,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACpC,OAAO,EAAE,2BAA2B,EACpC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,iBAAiB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA6C9B;AAED,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,qBAAqB,GAAG,SAAS,GAAG,IAAI,EAChD,MAAM,GAAE,mBAAwB,GACjC,sBAAsB,CA2BxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAiB9E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAa/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOxE"}
+{"version":3,"file":"hotswap-reload-policy.d.ts","sourceRoot":"","sources":["../src/hotswap-reload-policy.ts"],"names":[],"mappings":"AAyDA,OAAO,EAEH,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,8BAA8B,EACtC,MAAM,+BAA+B,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAA;AAEtE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IAChC;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAE,CACb,KAAK,EAAE,2BAA2B,KACjC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CACL,KAAK,EAAE,2BAA2B,EAClC,MAAM,EAAE,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,KACvD,IAAI,CAAA;IACT;;;OAGG;IACH,OAAO,CAAC,EAAE,8BAA8B,CAAC,SAAS,CAAC,CAAA;CACtD;AAED,MAAM,WAAW,sBAAsB;IACnC;;;;;;;;OAQG;IACH,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GACzB,OAAO,GACP,aAAa,GACb,WAAW,GACX,QAAQ,GACR,MAAM,CAAA;AAEZ,MAAM,WAAW,iBAAiB;IAC9B,0EAA0E;IAC1E,aAAa,EAAE,CACX,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAChE,IAAI,CAAA;IACT,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACpC,OAAO,EAAE,2BAA2B,EACpC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,iBAAiB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA6C9B;AAED,wBAAgB,gBAAgB,CAC5B,MAAM,EAAE,qBAAqB,GAAG,SAAS,GAAG,IAAI,EAChD,MAAM,GAAE,mBAAwB,GACjC,sBAAsB,CA2BxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAiB9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAU/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOxE"}

package/dist/hotswap-reload-policy.js

@@ -44,21 +44,15 @@
 // ## Federation runtime caveat
 //
 // The `"rekey"` strategy re-fetches `remoteEntry.js` with a `?v=<hash8>` query
-// suffix (see {@link withVersionParam}). For the new container to replace the
-// old one, the federation loader **must** `delete window[Container]` before
-// loading the new script — otherwise the cached container object short-
-// circuits the loader and you get `Container already registered` style errors
-// or, worse, the old code silently keeps running. This module exports
-// {@link clearFederationContainer} for that purpose; the host's federation
-// loader should call it from its `onSwap` hook.
-//
-// We deliberately keep the `delete window[Container]` side-effect OUT of this
-// module's default behaviour. Some federation runtimes (vite-plugin-federation
-// in dev, webpack 5 with `runtime: false`) wrap the container in a `Proxy`
-// that mutates internal state on every access; blindly deleting it from
-// here would race against any unmounting consumer that still holds a
-// reference. Hosts that hit `Container already registered` should call
-// `clearFederationContainer(scope)` from `onSwap` as documented below.
+// suffix (see {@link withVersionParam}). With `@module-federation/runtime`, the
+// {@link AddonLoader} re-registers the remote on every rekey remount via
+// `registerRemotes([{ name, entry: <new ?v= url> }], { force: true })`. The
+// `force` flag overwrites the previously registered container AND wipes that
+// remote's loaded-module cache, so the new code takes effect without any manual
+// `window[scope]` deletion — the old `@originjs` requirement to `delete
+// window[Container]` no longer applies. {@link clearFederationContainer} is kept
+// for backward compatibility (legacy hosts may still call it from `onSwap`) but
+// is a no-op under the MF runtime.
 import { useMemo, useRef, useState } from 'react';
 import { useManifestHotSwapSubscriber, } from './manifest-hotswap-subscriber';
 /**
@@ -173,19 +167,15 @@ export function withVersionParam(url, hash) {
     return `${head}?${parts.join('&')}${fragment}`;
 }
 /**
- * Remove the federation container previously registered on `window[scope]`.
- * Hosts call this from `onSwap` before letting the addon route re-mount
- * so the next `remoteEntry.js` injection creates a fresh container instead
- * of short-circuiting on the cached one.
- *
- * Best-effort: if `window` is undefined (SSR) or the scope was never
- * registered, this is a no-op. Returns `true` if a container was actually
- * removed, `false` otherwise — useful for telemetry.
+ * @deprecated Legacy `@originjs/vite-plugin-federation` helper. Under the
+ * current `@module-federation/runtime` loader ({@link AddonLoader}), container
+ * replacement on hot-swap is handled by `registerRemotes(..., { force: true })`
+ * with the new `?v=` URL — there is no `window[scope]` container to delete.
  *
- * **Caveat:** some federation runtimes wrap the container in a Proxy
- * whose internal state survives `delete`. If you hit `Container already
- * registered` after calling this, the federation runtime is holding the
- * reference internally and the only reliable swap is `"page-reload"`.
+ * Kept for backward compatibility so existing host `onSwap` wiring keeps
+ * compiling. Best-effort: removes a stale `window[scope]` if a legacy
+ * `@originjs` remote left one behind, otherwise a no-op. Returns `true` if a
+ * value was removed, `false` otherwise.
  */
 export function clearFederationContainer(scope) {
     if (typeof window === 'undefined')
@@ -197,9 +187,6 @@ export function clearFederationContainer(scope) {
         return true;
     }
     catch {
-        // Some browsers refuse to delete non-configurable globals. Set
-        // to undefined as a fallback so the loader's `if (!window[scope])`
-        // check still triggers a re-inject.
         ;
         window[scope] = undefined;
         return true;

package/dist/types.d.ts

@@ -100,7 +100,7 @@ export interface FieldValidation {
     max?: number;
     custom?: string;
 }
-export type FieldWidget = 'text' | 'textarea' | 'richtext' | 'color' | 'number' | 'date' | 'select' | 'switch';
+export type FieldWidget = 'text' | 'textarea' | 'richtext' | 'color' | 'number' | 'date' | 'select' | 'dynamic_select' | 'switch';
 export interface ActionFieldDef {
     key: string;
     label: string;

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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "13.1.0",
+  "version": "13.3.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",
@@ -17,6 +17,7 @@
     }
   },
   "dependencies": {
+    "@module-federation/runtime": "^2.5.0",
     "zod": "^4.3.0"
   },
   "peerDependencies": {

package/src/addon-loader.tsx

@@ -1,22 +1,24 @@
-// Minimal federated-module addon loader. Injects a remoteEntry.js <script>,
-// waits for the `window[scope]` container to initialize, then calls the
-// addon's `register(api)` export with the AddonAPI injected by the host.
+// Federated-module addon loader, built on the official Module Federation
+// runtime (`@module-federation/runtime`). Per addon it registers the remote's
+// `remoteEntry.js` as an ESM container, loads the exposed `./register` module,
+// and calls `register(api)` with the AddonAPI injected by the host.
+//
+// Why @module-federation/runtime (not the old manual init/get machinery):
+// the host's Vite build uses `@module-federation/vite`'s `federation()` plugin,
+// which auto-initialises the shared scope at host boot. `registerRemotes` +
+// `loadRemote` then transparently wire the remote into that already-initialised
+// share scope — so the remote consumes the HOST's React/SDK singletons instead
+// of bundling its own. That's the whole point: it fixes the `useState`-null
+// crash WITHOUT this loader ever touching a share scope manually.
 import { useEffect, useRef, useState } from 'react'
+import { registerRemotes, loadRemote } from '@module-federation/runtime'
 import type { AddonAPI, AddonLayout } from '@asteby/metacore-sdk'
 import { useDeclareAddonLayout } from './addon-layout-context'
 
-declare global {
-    interface Window {
-        [key: string]: any
-        __webpack_init_sharing__?: (scope: string) => Promise<void>
-        __webpack_share_scopes__?: Record<string, unknown>
-    }
-}
-
 export interface AddonLoaderProps {
     /** Unique key of the addon — maps to the federation container name. */
     scope: string
-    /** URL of the addon's remoteEntry.js bundle. */
+    /** URL of the addon's remoteEntry.js bundle (may carry a `?v=` cache-bust). */
     url: string
     /** Exposed module to import from the remote (e.g. './register'). */
     module?: string
@@ -43,87 +45,47 @@ 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> {
-    const key = `${scope}::${url}`
-    const existing = loadedScripts.get(key)
-    if (existing) return existing
-    const promise = new Promise<void>((resolve, reject) => {
-        const el = document.createElement('script')
-        el.src = url
-        el.type = 'text/javascript'
-        el.async = true
-        el.onload = () => resolve()
-        el.onerror = () => reject(new Error(`Failed to load addon script: ${url}`))
-        document.head.appendChild(el)
-    })
-    loadedScripts.set(key, promise)
-    return promise
+/** Shape of the exposed `./register` module. */
+interface AddonRegisterModule {
+    register?: (api: AddonAPI) => void | Promise<void>
+    default?: (api: AddonAPI) => void | Promise<void>
 }
 
-const esmContainers = new Map<string, Promise<FederationContainer | undefined>>()
+// `registerRemotes` is additive + idempotent across re-mounts; we still track
+// which scopes we've registered to avoid redundant `force` churn (each `force`
+// re-register wipes that remote's module cache and logs a runtime warning).
+const registered = new Set<string>()
 
-// 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
+// Derive the `loadRemote` id from the scope + exposed module name. MF resolves
+// `"<remoteName>/<expose>"` — e.g. `metacore_tickets/register` for the
+// `"./register"` expose. We strip the leading `./` of the expose path.
+function remoteId(scope: string, module: string): string {
+    const expose = module.replace(/^\.\//, '')
+    return `${scope}/${expose}`
 }
 
-async function loadRemote(scope: string, url: string, module: string) {
-    if (typeof window.__webpack_init_sharing__ === 'function') {
-        await window.__webpack_init_sharing__('default')
+async function loadAddon(
+    scope: string,
+    url: string,
+    module: string,
+): Promise<AddonRegisterModule | null> {
+    // Register the remote container as an ES module. `type: 'module'` matches
+    // the `@module-federation/vite` remote (remoteEntry.js is an ESM bundle).
+    // The `url` already carries the `?v=` cache-bust the host computed, so the
+    // browser refetches a fresh remoteEntry when the addon version changes.
+    if (!registered.has(scope)) {
+        registerRemotes(
+            [{ name: scope, entry: url, type: 'module' }],
+            // `force: true` so a re-registration with a new `?v=` URL (addon
+            // hot-swap / version bump) overwrites the stale entry + cache.
+            { force: true },
+        )
+        registered.add(scope)
     }
-    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()
+    // loadRemote("<scope>/<expose>") returns the exposed module namespace (or
+    // null if it can't be resolved). No manual share-scope init — the host's
+    // federation runtime already initialised it.
+    return loadRemote<AddonRegisterModule>(remoteId(scope, module))
 }
 
 export function AddonLoader({
@@ -151,25 +113,35 @@ export function AddonLoader({
         let cancelled = false
         ;(async () => {
             try {
-                const mod = await loadRemote(scope, url, module)
+                const mod = await loadAddon(scope, url, module)
                 if (cancelled) return
-                if (!didRegister.current && typeof mod?.register === 'function') {
+                const register = mod?.register ?? mod?.default
+                if (typeof register !== 'function') {
+                    throw new Error(
+                        `Addon "${scope}" module "${module}" has no register() export`,
+                    )
+                }
+                if (!didRegister.current) {
                     didRegister.current = true
-                    await Promise.resolve(mod.register(api))
+                    await Promise.resolve(register(api))
                 }
                 setStatus('ready')
                 onReady?.()
-            } catch (e: any) {
+            } catch (e: unknown) {
                 if (cancelled) return
-                setError(e)
+                const err = e instanceof Error ? e : new Error(String(e))
+                setError(err)
                 setStatus('error')
-                onError?.(e)
+                onError?.(err)
             }
         })()
-        return () => { cancelled = true }
+        return () => {
+            cancelled = true
+        }
     }, [scope, url, module])
 
     if (status === 'loading') return <>{fallback}</>
-    if (status === 'error') return <div className="text-sm text-red-500">Addon load error: {error?.message}</div>
+    if (status === 'error')
+        return <div className="text-sm text-red-500">Addon load error: {error?.message}</div>
     return <>{children}</>
 }

package/src/dynamic-form-schema.ts

@@ -119,6 +119,9 @@ export function resolveWidget(field: ActionFieldDef): string {
     switch (field.type) {
         case 'textarea': return 'textarea'
         case 'select': return 'select'
+        // Async searchable single-select against /api/options/<ref>. The
+        // declarative replacement for typing a raw FK UUID.
+        case 'dynamic_select': return 'dynamic_select'
         case 'boolean': return 'switch'
         case 'number': return 'number'
         case 'date': return 'date'

package/src/dynamic-form.tsx

@@ -18,9 +18,11 @@ import type { ActionFieldDef } from './types'
 import { buildZodSchema, resolveWidget, isLineItemsField } from './dynamic-form-schema'
 import { useOptionsResolver, type ResolvedOption } from './use-options-resolver'
 import { DynamicLineItems } from './dynamic-line-items'
+import { DynamicSelectField } from './dynamic-select-field'
 
 export { buildZodSchema, resolveWidget }
 export { DynamicLineItems } from './dynamic-line-items'
+export { DynamicSelectField } from './dynamic-select-field'
 
 export interface DynamicFormProps {
     fields: ActionFieldDef[]
@@ -123,6 +125,12 @@ function FieldRenderer({ field, value, onChange }: FieldRendererProps) {
         return <DynamicLineItems field={field} value={value} onChange={onChange} />
     }
     const widget = resolveWidget(field)
+    // Async searchable picker (typeahead against /api/options/<ref>?q=…).
+    // Preferred for FK fields with large option sets — no UUID typing, no
+    // dumping every row into a plain <select>.
+    if (widget === 'dynamic_select') {
+        return <DynamicSelectField field={field} value={value} onChange={onChange} />
+    }
     // Ref-driven select: hook into useOptionsResolver so the canonical
     // /api/options/<ref>?field=id endpoint feeds the dropdown. This is
     // the path the kernel auto-derives for FK columns; legacy callers

package/src/dynamic-line-items.tsx

@@ -21,6 +21,7 @@ import {
 import { Plus, Trash2 } from 'lucide-react'
 import type { ActionFieldDef } from './types'
 import { resolveWidget, getItemFields } from './dynamic-form-schema'
+import { DynamicSelectField } from './dynamic-select-field'
 import { useOptionsResolver, type ResolvedOption } from './use-options-resolver'
 
 export interface DynamicLineItemsProps {
@@ -125,6 +126,11 @@ interface CellRendererProps {
 // a scalar widget).
 function CellRenderer({ field, value, onChange, disabled }: CellRendererProps) {
     const widget = resolveWidget(field)
+    // Async searchable picker per row cell — e.g. the account_id column of a
+    // journal entry's debit/credit lines. Same widget as the flat form.
+    if (widget === 'dynamic_select') {
+        return <DynamicSelectField field={field} value={value} onChange={onChange} />
+    }
     if (widget === 'select' && field.ref) {
         return <RefCell field={field} value={value} onChange={onChange} disabled={disabled} />
     }

package/src/dynamic-select-field.tsx

@@ -0,0 +1,164 @@
+// DynamicSelectField — async, searchable single-select for declarative forms.
+//
+// This is the declarative answer to "I don't want to type a raw FK UUID".
+// Instead of a plain <select> that dumps every option (RefSelect) or a free
+// text input, it renders a typeahead combobox that queries the canonical
+// options endpoint as the user types:
+//
+//   GET /api/options/<ref>?field=id&q=<text>&limit=<n>
+//
+// reusing `useOptionsResolver` (which already debounce-aborts in-flight
+// requests). It is the metacore equivalent of 7leguas' `search.go` / dynamic
+// `type: search` field, but driven entirely from the manifest — so an addon
+// declares `type: "dynamic_select"` + `ref` and gets a searchable picker with
+// zero custom React.
+//
+// Resolution path (highest priority first):
+//   1. field.ref          → /options/<ref>?field=id        (canonical, preferred)
+//   2. field.searchEndpoint→ used verbatim as the options endpoint (escape hatch)
+//
+// Edit-mode caveat: resolving an EXISTING value's label requires the id to be
+// in a fetched page (we match by id against loaded options, else show the raw
+// value). A dedicated `?ids=` lookup is a follow-up; create flows — the common
+// case — start empty and never hit this.
+import { useEffect, useState } from 'react'
+import {
+    Button,
+    Command,
+    CommandEmpty,
+    CommandGroup,
+    CommandInput,
+    CommandItem,
+    CommandList,
+    Popover,
+    PopoverContent,
+    PopoverTrigger,
+} from '@asteby/metacore-ui/primitives'
+import { Check, ChevronsUpDown, Loader2 } from 'lucide-react'
+import { useOptionsResolver, type ResolvedOption } from './use-options-resolver'
+import type { ActionFieldDef } from './types'
+
+function useDebounced<T>(value: T, ms: number): T {
+    const [debounced, setDebounced] = useState(value)
+    useEffect(() => {
+        const t = setTimeout(() => setDebounced(value), ms)
+        return () => clearTimeout(t)
+    }, [value, ms])
+    return debounced
+}
+
+export interface DynamicSelectFieldProps {
+    field: ActionFieldDef
+    value: any
+    onChange: (v: any) => void
+}
+
+export function DynamicSelectField({ field, value, onChange }: DynamicSelectFieldProps) {
+    const [open, setOpen] = useState(false)
+    const [search, setSearch] = useState('')
+    const debounced = useDebounced(search, 250)
+    // Remember the label of the option the user actually picked so the trigger
+    // shows a name (not a UUID) without a round-trip.
+    const [picked, setPicked] = useState<ResolvedOption | null>(null)
+
+    const { options, loading } = useOptionsResolver({
+        modelKey: '',
+        fieldKey: 'id',
+        ref: field.ref,
+        // searchEndpoint only drives the URL when there's no ref — ref is the
+        // canonical, kernel-derived path and wins.
+        endpoint: field.ref ? undefined : field.searchEndpoint,
+        query: debounced,
+        limit: 20,
+        // Don't fetch until the popover opens (and keep fetching as the query
+        // changes while open).
+        enabled: open,
+    })
+
+    const selectedLabel =
+        (picked && String(picked.id) === String(value) ? picked.label : null) ??
+        options.find((o) => String(o.id) === String(value))?.label ??
+        (value ? String(value) : '')
+
+    const handlePick = (opt: ResolvedOption) => {
+        setPicked(opt)
+        onChange(String(opt.id))
+        setOpen(false)
+        setSearch('')
+    }
+
+    return (
+        <Popover open={open} onOpenChange={setOpen}>
+            <PopoverTrigger asChild>
+                <Button
+                    type="button"
+                    variant="outline"
+                    role="combobox"
+                    aria-expanded={open}
+                    id={field.key}
+                    className="w-full justify-between font-normal"
+                    data-empty={!value}
+                >
+                    <span className={'truncate ' + (selectedLabel ? '' : 'text-muted-foreground')}>
+                        {selectedLabel || field.placeholder || 'Buscar…'}
+                    </span>
+                    <ChevronsUpDown className="ml-2 size-4 shrink-0 opacity-50" />
+                </Button>
+            </PopoverTrigger>
+            <PopoverContent
+                className="p-0"
+                align="start"
+                // Match the trigger width without an arbitrary Tailwind class
+                // (those don't always survive a consuming app's Tailwind scan).
+                style={{ width: 'var(--radix-popover-trigger-width)' }}
+            >
+                <Command shouldFilter={false}>
+                    <CommandInput
+                        placeholder={field.placeholder || 'Buscar…'}
+                        value={search}
+                        onValueChange={setSearch}
+                    />
+                    <CommandList>
+                        {loading && (
+                            <div className="text-muted-foreground flex items-center justify-center gap-2 py-6 text-sm">
+                                <Loader2 className="size-4 animate-spin" />
+                                Buscando…
+                            </div>
+                        )}
+                        {!loading && options.length === 0 && (
+                            <CommandEmpty>
+                                {debounced ? 'Sin resultados' : 'Escribí para buscar…'}
+                            </CommandEmpty>
+                        )}
+                        {!loading && options.length > 0 && (
+                            <CommandGroup className="max-h-64 overflow-auto">
+                                {options.map((opt) => {
+                                    const isSel = String(opt.id) === String(value)
+                                    return (
+                                        <CommandItem
+                                            key={String(opt.id)}
+                                            value={String(opt.id)}
+                                            onSelect={() => handlePick(opt)}
+                                        >
+                                            <Check className={'mr-2 size-4 ' + (isSel ? 'opacity-100' : 'opacity-0')} />
+                                            <div className="flex min-w-0 flex-col">
+                                                <span className="truncate">{opt.label}</span>
+                                                {opt.description && (
+                                                    <span className="text-muted-foreground truncate text-xs">
+                                                        {opt.description}
+                                                    </span>
+                                                )}
+                                            </div>
+                                        </CommandItem>
+                                    )
+                                })}
+                            </CommandGroup>
+                        )}
+                    </CommandList>
+                </Command>
+            </PopoverContent>
+        </Popover>
+    )
+}
+
+export default DynamicSelectField

package/src/hotswap-reload-policy.ts

@@ -44,21 +44,15 @@
 // ## Federation runtime caveat
 //
 // The `"rekey"` strategy re-fetches `remoteEntry.js` with a `?v=<hash8>` query
-// suffix (see {@link withVersionParam}). For the new container to replace the
-// old one, the federation loader **must** `delete window[Container]` before
-// loading the new script — otherwise the cached container object short-
-// circuits the loader and you get `Container already registered` style errors
-// or, worse, the old code silently keeps running. This module exports
-// {@link clearFederationContainer} for that purpose; the host's federation
-// loader should call it from its `onSwap` hook.
-//
-// We deliberately keep the `delete window[Container]` side-effect OUT of this
-// module's default behaviour. Some federation runtimes (vite-plugin-federation
-// in dev, webpack 5 with `runtime: false`) wrap the container in a `Proxy`
-// that mutates internal state on every access; blindly deleting it from
-// here would race against any unmounting consumer that still holds a
-// reference. Hosts that hit `Container already registered` should call
-// `clearFederationContainer(scope)` from `onSwap` as documented below.
+// suffix (see {@link withVersionParam}). With `@module-federation/runtime`, the
+// {@link AddonLoader} re-registers the remote on every rekey remount via
+// `registerRemotes([{ name, entry: <new ?v= url> }], { force: true })`. The
+// `force` flag overwrites the previously registered container AND wipes that
+// remote's loaded-module cache, so the new code takes effect without any manual
+// `window[scope]` deletion — the old `@originjs` requirement to `delete
+// window[Container]` no longer applies. {@link clearFederationContainer} is kept
+// for backward compatibility (legacy hosts may still call it from `onSwap`) but
+// is a no-op under the MF runtime.
 
 import { useMemo, useRef, useState } from 'react'
 import {
@@ -311,30 +305,23 @@ export function withVersionParam(url: string, hash: string | undefined): string
 }
 
 /**
- * Remove the federation container previously registered on `window[scope]`.
- * Hosts call this from `onSwap` before letting the addon route re-mount
- * so the next `remoteEntry.js` injection creates a fresh container instead
- * of short-circuiting on the cached one.
- *
- * Best-effort: if `window` is undefined (SSR) or the scope was never
- * registered, this is a no-op. Returns `true` if a container was actually
- * removed, `false` otherwise — useful for telemetry.
+ * @deprecated Legacy `@originjs/vite-plugin-federation` helper. Under the
+ * current `@module-federation/runtime` loader ({@link AddonLoader}), container
+ * replacement on hot-swap is handled by `registerRemotes(..., { force: true })`
+ * with the new `?v=` URL — there is no `window[scope]` container to delete.
  *
- * **Caveat:** some federation runtimes wrap the container in a Proxy
- * whose internal state survives `delete`. If you hit `Container already
- * registered` after calling this, the federation runtime is holding the
- * reference internally and the only reliable swap is `"page-reload"`.
+ * Kept for backward compatibility so existing host `onSwap` wiring keeps
+ * compiling. Best-effort: removes a stale `window[scope]` if a legacy
+ * `@originjs` remote left one behind, otherwise a no-op. Returns `true` if a
+ * value was removed, `false` otherwise.
  */
 export function clearFederationContainer(scope: string): boolean {
     if (typeof window === 'undefined') return false
-    if (!(scope in window)) return false
+    if (!(scope in (window as Record<string, unknown>))) return false
     try {
         delete (window as Record<string, unknown>)[scope]
         return true
     } catch {
-        // Some browsers refuse to delete non-configurable globals. Set
-        // to undefined as a fallback so the loader's `if (!window[scope])`
-        // check still triggers a re-inject.
         ;(window as Record<string, unknown>)[scope] = undefined
         return true
     }

package/src/types.ts

@@ -116,6 +116,7 @@ export type FieldWidget =
     | 'number'
     | 'date'
     | 'select'
+    | 'dynamic_select'
     | 'switch'
 
 export interface ActionFieldDef {