@asteby/metacore-runtime-react 31.1.1 → 32.1.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @asteby/metacore-runtime-react
 
+## 32.1.0
+
+### Minor Changes
+
+- fa25f99: Laravel-style field validator: localize 422 `{errors:{field:[{code,params}]}}`
+  into the operator's language (es/en catalogs, overridable via `validation.*`),
+  map keys to translated labels, and pre-flight the same regex/min/max/custom
+  rules the kernel enforces — no more generic "validation failed" / `[object Object]`.
+
+## 32.0.0
+
+### Minor Changes
+
+- 5a932ed: Addon fiber hot-swap without a page reload: Registry.scope/unbind, Plugin.register
+  may return a Disposable, AddonLoader re-registers federation remotes when `?v=`
+  changes, and purgeAddonFrontendCache drops only that addon's SW cache (L1).
+  Hosts call acknowledgeRunningVersion after a successful swap instead of
+  location.reload / unregistering the service worker.
+
+### Patch Changes
+
+- 5a932ed: Export PrefillSpec helpers (`isPrefillSpec`, `buildPrefillRows`, `applyPrefillLock`)
+  so addons can unit-test `$prefillFromRecord` without reaching into private
+  dispatcher internals. Kernel now types the same shape in the v3 schema.
+- Updated dependencies [5a932ed]
+  - @asteby/metacore-sdk@3.5.0
+
 ## 31.1.1
 
 ### Patch Changes

package/dist/action-modal-dispatcher.d.ts

@@ -1,4 +1,24 @@
+import type { ActionFieldDef } from './types';
 import { type ActionMetadata, type ActionModalProps } from '@asteby/metacore-sdk';
 export type { ActionMetadata, ActionModalProps };
+export interface PrefillSpec {
+    $prefillFromRecord: string;
+    map?: Record<string, string>;
+    remaining?: {
+        target: string;
+        of: string;
+        minus?: string;
+    };
+    /**
+     * Item-field keys to lock (render read-only) in the prefilled rows — e.g. the
+     * product of a receive-goods line is dictated by the source document, so it
+     * is shown as a resolved name but cannot be changed. Editable in the create
+     * flow (which carries no prefill spec); only the prefilled action locks them.
+     */
+    lock?: string[];
+}
+export declare function isPrefillSpec(v: unknown): v is PrefillSpec;
+export declare function applyPrefillLock(field: ActionFieldDef): ActionFieldDef;
+export declare function buildPrefillRows(spec: PrefillSpec, record: any): Array<Record<string, any>>;
 export declare function ActionModalDispatcher({ open, onOpenChange, action, model, record, endpoint, onSuccess, }: ActionModalProps): import("react").JSX.Element | null;
 //# sourceMappingURL=action-modal-dispatcher.d.ts.map

package/dist/action-modal-dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-modal-dispatcher.d.ts","sourceRoot":"","sources":["../src/action-modal-dispatcher.tsx"],"names":[],"mappings":"AA4DA,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAExB,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AA0FhD,wBAAgB,qBAAqB,CAAC,EAClC,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,GACZ,EAAE,gBAAgB,sCAoElB"}
+{"version":3,"file":"action-modal-dispatcher.d.ts","sourceRoot":"","sources":["../src/action-modal-dispatcher.tsx"],"names":[],"mappings":"AA4DA,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,SAAS,CAAA;AAE9E,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAExB,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAA;AAiBhD,MAAM,WAAW,WAAW;IACxB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,SAAS,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC1D;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,WAAW,CAM1D;AAsBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAStE;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAkB3F;AAED,wBAAgB,qBAAqB,CAAC,EAClC,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,SAAS,GACZ,EAAE,gBAAgB,sCAoElB"}

package/dist/action-modal-dispatcher.js

@@ -14,7 +14,9 @@ import { useTranslation } from 'react-i18next';
 import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, Button, Input, Textarea, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Switch, } from '@asteby/metacore-ui/primitives';
 import { Loader2 } from 'lucide-react';
 import { toast } from 'sonner';
-import { toastServerError, toastServerSuccess, extractFieldErrors, localizeFieldIssue } from './server-error';
+import { toastServerError, toastServerSuccess, extractFieldErrors, localizeFieldErrorMap } from './server-error';
+import { validateValues, bagHasErrors } from './validator';
+import { validationCatalog } from './validation-catalog';
 import { useApi } from './api-context';
 import { DynamicIcon } from './dynamic-icon';
 import { DynamicLineItems } from './dynamic-line-items';
@@ -28,7 +30,7 @@ import { useMetadataCache } from './metadata-cache';
 import { ViewValue, objectLabel, relationSiblingValue, isLineItemsField as isRecordLineItemsField, } from './dialogs/dynamic-record';
 // Canonical registry lives in @asteby/metacore-sdk
 import { getActionComponent, } from '@asteby/metacore-sdk';
-function isPrefillSpec(v) {
+export function isPrefillSpec(v) {
     return (typeof v === 'object' &&
         v !== null &&
         typeof v.$prefillFromRecord === 'string');
@@ -51,7 +53,7 @@ function toNum(v) {
 // untouched when there is no prefill spec or no lock list (the create flow,
 // which carries no prefill, stays fully editable). The readonly flag is set on
 // BOTH itemFields aliases the renderers tolerate.
-function applyPrefillLock(field) {
+export function applyPrefillLock(field) {
     const spec = lineItemsDefault(field);
     if (!isPrefillSpec(spec) || !spec.lock || spec.lock.length === 0)
         return field;
@@ -64,7 +66,7 @@ function applyPrefillLock(field) {
     return { ...field, itemFields: patched, item_fields: patched };
 }
 // buildPrefillRows projects record[spec.$prefillFromRecord] into modal rows.
-function buildPrefillRows(spec, record) {
+export function buildPrefillRows(spec, record) {
     const src = record?.[spec.$prefillFromRecord];
     if (!Array.isArray(src))
         return [];
@@ -264,34 +266,31 @@ function humanizeKey(k) {
 /** Localize a failed action submit's per-field `errors` (422 map or `{errors}`
  *  body) into `{ [fieldKey]: localizedMessage }`, using each field's label.
  *  Returns undefined when there is no usable per-field map. */
-function localizeActionFieldErrors(err, fields, t) {
+function localizeActionFieldErrors(err, fields, t, language) {
     const map = extractFieldErrors(err);
     if (!map)
         return undefined;
-    const labelFor = (k) => {
-        const f = (fields ?? []).find(x => x.key === k);
-        return f?.label ? t(f.label, { defaultValue: f.label }) : humanizeKey(k);
-    };
-    const out = {};
-    for (const [k, issues] of Object.entries(map))
-        out[k] = localizeFieldIssue(issues[0], labelFor(k), t);
-    return out;
+    const labels = {};
+    for (const f of fields ?? []) {
+        labels[f.key] = f.label ? t(f.label, { defaultValue: f.label }) : humanizeKey(f.key);
+    }
+    return localizeFieldErrorMap(map, t, { labels, language });
 }
 /** Toast a failed action: a summary + localized per-field lines when the server
  *  returned a per-field `errors` map, else the standard cause-carrying toast.
  *  Used where inline rendering isn't wired (confirm / multi-step wizard). */
-function toastActionError(err, fields, t) {
-    const localized = localizeActionFieldErrors(err, fields, t);
+function toastActionError(err, fields, t, language) {
+    const localized = localizeActionFieldErrors(err, fields, t, language);
     if (localized) {
-        toast.error(t('dynamic.validation_failed', { defaultValue: 'Revisa los campos marcados' }), {
+        toast.error(t('validation.failed', { defaultValue: validationCatalog(language).failed }), {
             description: Object.values(localized).join('\n'),
         });
         return;
     }
-    toastServerError(err, { t });
+    toastServerError(err, { t, language });
 }
 function ConfirmActionDialog({ open, onOpenChange, action, model, record, endpoint, onSuccess }) {
-    const { t } = useTranslation();
+    const { t, i18n } = useTranslation();
     const api = useApi();
     const [executing, setExecuting] = useState(false);
     // `action.label` is an addon-contributed i18n key; its locale bundle loads
@@ -309,11 +308,11 @@ function ConfirmActionDialog({ open, onOpenChange, action, model, record, endpoi
                 onSuccess();
             }
             else {
-                toastActionError({ response: { data: res.data } }, action.fields, t);
+                toastActionError({ response: { data: res.data } }, action.fields, t, i18n.language);
             }
         }
         catch (err) {
-            toastActionError(err, action.fields, t);
+            toastActionError(err, action.fields, t, i18n.language);
         }
         finally {
             setExecuting(false);
@@ -322,7 +321,7 @@ function ConfirmActionDialog({ open, onOpenChange, action, model, record, endpoi
     return (_jsx(AlertDialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsxs(AlertDialogTitle, { className: "flex items-center gap-2", children: [_jsx(DynamicIcon, { name: action.icon, className: "h-5 w-5" }), label] }), _jsx(AlertDialogDescription, { children: action.confirmMessage || `${label}?` })] }), record ? _jsx(RecordPreview, { model: model, record: record }) : null, _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { disabled: executing, children: t('common.cancel') }), _jsxs(AlertDialogAction, { onClick: (e) => { e.preventDefault(); execute(); }, disabled: executing, style: action.color ? { backgroundColor: action.color } : undefined, children: [executing ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : _jsx(DynamicIcon, { name: action.icon, className: "mr-2 h-4 w-4" }), label] })] })] }) }));
 }
 function GenericActionModal({ open, onOpenChange, action, model, record, endpoint, onSuccess }) {
-    const { t } = useTranslation();
+    const { t, i18n } = useTranslation();
     // Addon-contributed labels (action + fields) are i18n keys whose locale
     // bundle loads asynchronously; translate at render so they don't render raw.
     // defaultValue keeps an already-localized string unchanged.
@@ -389,39 +388,25 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
             return next;
         });
     };
+    const lang = i18n.language;
     const handleActionError = (err) => {
-        const localized = localizeActionFieldErrors(err, action.fields, t);
+        const localized = localizeActionFieldErrors(err, action.fields, t, lang);
         if (localized) {
             setFieldErrors(localized);
-            toast.error(t('dynamic.validation_failed', { defaultValue: 'Revisa los campos marcados' }));
+            toast.error(t('validation.failed', { defaultValue: validationCatalog(lang).failed }));
             return;
         }
-        toastServerError(err, { t });
+        toastServerError(err, { t, language: lang });
     };
     const execute = async () => {
         if (action.fields) {
-            // Client-side required check → mark ALL missing fields inline.
-            const missing = {};
-            for (const field of action.fields) {
-                if (!field.required)
-                    continue;
-                if (isLineItemsField(field)) {
-                    const rows = formData[field.key];
-                    if (!Array.isArray(rows) || rows.length === 0) {
-                        missing[field.key] = t('validation.line_items_required', {
-                            defaultValue: '{{label}} requiere al menos un renglón',
-                            label: tl(field.label),
-                        });
-                    }
-                    continue;
-                }
-                if (!formData[field.key] && formData[field.key] !== false) {
-                    missing[field.key] = localizeFieldIssue({ code: 'required' }, tl(field.label), t);
-                }
-            }
-            if (Object.keys(missing).length) {
-                setFieldErrors(missing);
-                toast.error(t('dynamic.validation_failed', { defaultValue: 'Revisa los campos marcados' }));
+            const bag = validateValues(action.fields, formData);
+            if (bagHasErrors(bag)) {
+                const labels = {};
+                for (const f of action.fields)
+                    labels[f.key] = tl(f.label);
+                setFieldErrors(localizeFieldErrorMap(bag, t, { labels, language: lang }));
+                toast.error(t('validation.failed', { defaultValue: validationCatalog(lang).failed }));
                 return;
             }
         }
@@ -486,25 +471,14 @@ function buildFieldDefaults(fields, record) {
     }
     return defaults;
 }
-// validateFields returns the first validation error for a set of required
-// fields, or null when they all pass. Shared by the wizard (per-step gate) and
-// mirrors GenericActionModal's inline checks. `tl` localizes the field label.
-function validateFields(fields, formData, tl) {
-    for (const field of fields) {
-        if (!field.required)
-            continue;
-        if (isLineItemsField(field)) {
-            const rows = formData[field.key];
-            if (!Array.isArray(rows) || rows.length === 0) {
-                return `${tl(field.label)} requiere al menos un renglón`;
-            }
-            continue;
-        }
-        if (!formData[field.key] && formData[field.key] !== false) {
-            return `${tl(field.label)} es requerido`;
-        }
-    }
-    return null;
+function wizardStepErrors(fields, formData, t, language) {
+    const bag = validateValues(fields, formData);
+    if (!bagHasErrors(bag))
+        return undefined;
+    const labels = {};
+    for (const f of fields)
+        labels[f.key] = t(f.label, { defaultValue: f.label });
+    return localizeFieldErrorMap(bag, t, { labels, language });
 }
 // WizardActionModal — the third render-path: a multi-step form. It accumulates
 // every step's fields into ONE formData object and, on the final step, POSTs all
@@ -514,7 +488,7 @@ function validateFields(fields, formData, tl) {
 // so line-items, dynamic_select, uploads and dates behave identically to a
 // single-page action form — no widget is duplicated.
 function WizardActionModal({ open, onOpenChange, action, model, record, endpoint, onSuccess }) {
-    const { t } = useTranslation();
+    const { t, i18n } = useTranslation();
     const tl = (s) => t(s, { defaultValue: s });
     const api = useApi();
     const steps = action.steps ?? [];
@@ -537,9 +511,11 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
     const hasLineItems = useMemo(() => stepFields.some(isLineItemsField), [stepFields]);
     const widthPx = hasLineItems ? '820px' : undefined;
     const goNext = () => {
-        const err = validateFields(stepFields, formData, tl);
-        if (err) {
-            toast.error(err);
+        const localized = wizardStepErrors(stepFields, formData, t, i18n.language);
+        if (localized) {
+            toast.error(t('validation.failed', { defaultValue: validationCatalog(i18n.language).failed }), {
+                description: Object.values(localized).join('\n'),
+            });
             return;
         }
         setStepIndex((i) => Math.min(i + 1, steps.length - 1));
@@ -549,9 +525,11 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
         // Guard every step's required fields on final submit (a user could reach
         // the last step with an untouched earlier line-items grid otherwise).
         for (const s of steps) {
-            const err = validateFields(s.fields ?? [], formData, tl);
-            if (err) {
-                toast.error(err);
+            const localized = wizardStepErrors(s.fields ?? [], formData, t, i18n.language);
+            if (localized) {
+                toast.error(t('validation.failed', { defaultValue: validationCatalog(i18n.language).failed }), {
+                    description: Object.values(localized).join('\n'),
+                });
                 return;
             }
         }
@@ -565,11 +543,11 @@ function WizardActionModal({ open, onOpenChange, action, model, record, endpoint
                 onSuccess();
             }
             else {
-                toastActionError({ response: { data: res.data } }, steps.flatMap(s => s.fields ?? []), t);
+                toastActionError({ response: { data: res.data } }, steps.flatMap(s => s.fields ?? []), t, i18n.language);
             }
         }
         catch (err) {
-            toastActionError(err, steps.flatMap(s => s.fields ?? []), t);
+            toastActionError(err, steps.flatMap(s => s.fields ?? []), t, i18n.language);
         }
         finally {
             setExecuting(false);

package/dist/addon-fiber.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Addon fiber primitives — Cordis-style dispose/reload for federated modules
+ * running inside a PWA host. Pure helpers so they unit-test without React
+ * or the Module Federation runtime.
+ */
+import type { AddonAPI, Disposable, Plugin } from '@asteby/metacore-sdk';
+export declare const PURGE_ADDON_MESSAGE: "PURGE_ADDON";
+export interface PurgeAddonMessage {
+    type: typeof PURGE_ADDON_MESSAGE;
+    key: string;
+}
+/** Shape of the exposed `./register` (or `./plugin`) module. */
+export interface AddonRegisterModule {
+    register?: Plugin['register'];
+    dispose?: Plugin['dispose'];
+    default?: Plugin['register'] | Plugin;
+}
+export interface ResolvedPlugin {
+    register?: Plugin['register'];
+    dispose?: Plugin['dispose'];
+}
+/**
+ * Accept every historical export shape:
+ *   - `{ register, dispose? }`
+ *   - `{ default: { register, dispose? } }`  (definePlugin)
+ *   - `{ default: (api) => ... }`            (function module)
+ */
+export declare function resolvePluginExports(mod: AddonRegisterModule | null | undefined): ResolvedPlugin;
+export declare function runDispose(dispose?: Disposable | null): Promise<void>;
+export declare function composeDisposables(...fns: Array<Disposable | undefined | null>): Disposable;
+/**
+ * True when a Cache API / SW request is a federated frontend asset of `addonKey`.
+ * Matches both `/api/addons/<key>/frontend` and `/api/metacore/addons/<key>/frontend`.
+ */
+export declare function isAddonFrontendCacheUrl(url: string, addonKey: string): boolean;
+/**
+ * Drop cached federation assets for one addon. Primary path is the page-side
+ * Cache API (works even before the SW learns `PURGE_ADDON`). Also posts the
+ * message so a current SW can drop its own entries.
+ *
+ * Never unregisters the SW and never deletes other caches — L1, not L2.
+ */
+export declare function purgeAddonFrontendCache(addonKey: string): Promise<void>;
+/** Test seam: which remote URL is currently registered per federation scope. */
+export declare const remoteEntryByScope: Map<string, string>;
+export declare function shouldReregisterRemote(scope: string, url: string): boolean;
+export declare function markRemoteRegistered(scope: string, url: string): void;
+/** @internal tests */
+export declare function resetRemoteRegistry(): void;
+/**
+ * Safe no-op when `register()` returns void. Used by AddonLoader to treat
+ * both historical and fiber-style plugins uniformly.
+ */
+export declare function disposableFromRegisterResult(result: void | Disposable): Disposable | undefined;
+/** Type-only re-export so AddonLoader does not import Plugin internals twice. */
+export type { AddonAPI, Disposable };
+//# sourceMappingURL=addon-fiber.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"addon-fiber.d.ts","sourceRoot":"","sources":["../src/addon-fiber.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAExE,eAAO,MAAM,mBAAmB,EAAG,aAAsB,CAAA;AAEzD,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,OAAO,mBAAmB,CAAA;IAChC,GAAG,EAAE,MAAM,CAAA;CACd;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAA;CACxC;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAqBhG;AAED,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E;AAED,wBAAgB,kBAAkB,CAAC,GAAG,GAAG,EAAE,KAAK,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,UAAU,CAO3F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAS9E;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B7E;AAED,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,qBAA4B,CAAA;AAE3D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,sBAAsB;AACtB,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CACxC,MAAM,EAAE,IAAI,GAAG,UAAU,GAC1B,UAAU,GAAG,SAAS,CAExB;AAED,iFAAiF;AACjF,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAA"}

package/dist/addon-fiber.js

@@ -0,0 +1,122 @@
+/**
+ * Addon fiber primitives — Cordis-style dispose/reload for federated modules
+ * running inside a PWA host. Pure helpers so they unit-test without React
+ * or the Module Federation runtime.
+ */
+export const PURGE_ADDON_MESSAGE = 'PURGE_ADDON';
+/**
+ * Accept every historical export shape:
+ *   - `{ register, dispose? }`
+ *   - `{ default: { register, dispose? } }`  (definePlugin)
+ *   - `{ default: (api) => ... }`            (function module)
+ */
+export function resolvePluginExports(mod) {
+    if (!mod)
+        return {};
+    const fromDefault = mod.default && typeof mod.default === 'object'
+        ? mod.default
+        : undefined;
+    const registerFn = typeof mod.register === 'function'
+        ? mod.register
+        : typeof fromDefault?.register === 'function'
+            ? fromDefault.register.bind(fromDefault)
+            : typeof mod.default === 'function'
+                ? mod.default
+                : undefined;
+    const disposeFn = typeof mod.dispose === 'function'
+        ? mod.dispose
+        : typeof fromDefault?.dispose === 'function'
+            ? fromDefault.dispose.bind(fromDefault)
+            : undefined;
+    return { register: registerFn, dispose: disposeFn };
+}
+export async function runDispose(dispose) {
+    if (typeof dispose !== 'function')
+        return;
+    try {
+        await Promise.resolve(dispose());
+    }
+    catch {
+        /* a failing disposer must not block the next fiber mount */
+    }
+}
+export function composeDisposables(...fns) {
+    const list = fns.filter((f) => typeof f === 'function');
+    return async () => {
+        for (let i = list.length - 1; i >= 0; i--) {
+            await runDispose(list[i]);
+        }
+    };
+}
+/**
+ * True when a Cache API / SW request is a federated frontend asset of `addonKey`.
+ * Matches both `/api/addons/<key>/frontend` and `/api/metacore/addons/<key>/frontend`.
+ */
+export function isAddonFrontendCacheUrl(url, addonKey) {
+    if (!addonKey || !url)
+        return false;
+    try {
+        const path = new URL(url, 'http://local.invalid').pathname;
+        const escaped = addonKey.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return new RegExp(`/api/(metacore/)?addons/${escaped}/frontend(/|\\.js)`).test(path);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Drop cached federation assets for one addon. Primary path is the page-side
+ * Cache API (works even before the SW learns `PURGE_ADDON`). Also posts the
+ * message so a current SW can drop its own entries.
+ *
+ * Never unregisters the SW and never deletes other caches — L1, not L2.
+ */
+export async function purgeAddonFrontendCache(addonKey) {
+    if (!addonKey)
+        return;
+    try {
+        if (typeof caches !== 'undefined') {
+            const names = await caches.keys();
+            await Promise.all(names.map(async (name) => {
+                if (!name.includes('addon-federation'))
+                    return;
+                const cache = await caches.open(name);
+                const requests = await cache.keys();
+                await Promise.all(requests
+                    .filter((req) => isAddonFrontendCacheUrl(req.url, addonKey))
+                    .map((req) => cache.delete(req)));
+            }));
+        }
+    }
+    catch {
+        /* private mode / no Cache API */
+    }
+    try {
+        if (typeof navigator !== 'undefined' && 'serviceWorker' in navigator) {
+            const controller = navigator.serviceWorker.controller;
+            controller?.postMessage({ type: PURGE_ADDON_MESSAGE, key: addonKey });
+        }
+    }
+    catch {
+        /* no SW */
+    }
+}
+/** Test seam: which remote URL is currently registered per federation scope. */
+export const remoteEntryByScope = new Map();
+export function shouldReregisterRemote(scope, url) {
+    return remoteEntryByScope.get(scope) !== url;
+}
+export function markRemoteRegistered(scope, url) {
+    remoteEntryByScope.set(scope, url);
+}
+/** @internal tests */
+export function resetRemoteRegistry() {
+    remoteEntryByScope.clear();
+}
+/**
+ * Safe no-op when `register()` returns void. Used by AddonLoader to treat
+ * both historical and fiber-style plugins uniformly.
+ */
+export function disposableFromRegisterResult(result) {
+    return typeof result === 'function' ? result : undefined;
+}

package/dist/addon-loader.d.ts

@@ -1,4 +1,4 @@
-import type { AddonAPI, AddonLayout } from '@asteby/metacore-sdk';
+import type { AddonAPI, AddonLayout, Registry } from '@asteby/metacore-sdk';
 export interface AddonLoaderProps {
     /** Unique key of the addon — maps to the federation container name. */
     scope: string;
@@ -8,9 +8,25 @@ export interface AddonLoaderProps {
     module?: string;
     /** Host-provided API passed to the addon's register() call. */
     api: AddonAPI;
+    /**
+     * Host registry used to {@link Registry.unbind} this addon's contributions
+     * on dispose. Optional so legacy hosts keep compiling; without it, fiber
+     * remounts leak routes/actions.
+     */
+    hostRegistry?: Registry;
+    /**
+     * Addon key for SW cache purge. Defaults to `api.manifest.key`.
+     */
+    addonKey?: string;
+    /**
+     * Registry owner passed to {@link Registry.unbind}. Defaults to `addonKey`.
+     * Immersive `./plugin` fibers use `${key}::view` so they don't wipe the
+     * shell `./register` contributions of the same addon.
+     */
+    unbindKey?: string;
     /** Optional rendering while loading. */
     fallback?: React.ReactNode;
-    /** Called once the addon has successfully registered. */
+    /** Called once the addon has successfully registered (including re-register). */
     onReady?: () => void;
     /** Called if loading fails. */
     onError?: (err: Error) => void;
@@ -28,5 +44,5 @@ export interface AddonLoaderProps {
     layout?: AddonLayout;
     children?: React.ReactNode;
 }
-export declare function AddonLoader({ scope, url, module, api, fallback, onReady, onError, layout, children, }: AddonLoaderProps): import("react").JSX.Element;
+export declare function AddonLoader({ scope, url, module, api, hostRegistry, addonKey, unbindKey, fallback, onReady, onError, layout, children, }: AddonLoaderProps): import("react").JSX.Element;
 //# sourceMappingURL=addon-loader.d.ts.map

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

@@ -1 +1 @@
-{"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;AAoFD,wBAAgB,WAAW,CAAC,EACxB,KAAK,EACL,GAAG,EACH,MAAqB,EACrB,GAAG,EACH,QAAe,EACf,OAAO,EACP,OAAO,EACP,MAAM,EACN,QAAQ,GACX,EAAE,gBAAgB,+BA8ClB"}
+{"version":3,"file":"addon-loader.d.ts","sourceRoot":"","sources":["../src/addon-loader.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAc3E,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;;;;OAIG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAA;IACvB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,iFAAiF;IACjF,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;AA4DD,wBAAgB,WAAW,CAAC,EACxB,KAAK,EACL,GAAG,EACH,MAAqB,EACrB,GAAG,EACH,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,QAAe,EACf,OAAO,EACP,OAAO,EACP,MAAM,EACN,QAAQ,GACX,EAAE,gBAAgB,+BA6DlB"}