@modern-admin/react 0.1.0

package/dist/validation.js

@@ -0,0 +1,338 @@
+// Per-property Zod schema builder with localized error messages.
+//
+// Each PropertyJSON.type maps to a typed validator: numerics get coerced from
+// string inputs, dates parsed via Date, references checked for non-empty,
+// arrays validated as collections of FK-shaped values, and enums (anything
+// with `availableValues`) restricted to the declared set. Required vs
+// optional is honoured uniformly. All error messages route through the
+// passed translator so the active locale wins.
+//
+// The builder returns plain Zod schemas — RHF + zodResolver consume them
+// directly. Keep the builder pure (no React/i18n imports) so it stays
+// testable and reusable from non-React contexts.
+import { z } from 'zod';
+import { evaluateShowWhen } from './show-when.js';
+/** Email pattern: deliberately loose, matches Better Auth / common usage. */
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const URL_RE = /^https?:\/\/.+/i;
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const isBlank = (v) => v === undefined || v === null || (typeof v === 'string' && v.trim() === '');
+/** Build a string validator with optional/required + format checks. */
+function stringSchema(p, t, format) {
+    const label = p.label;
+    const checkFormat = (v) => {
+        if (format === 'email')
+            return EMAIL_RE.test(v);
+        if (format === 'url')
+            return URL_RE.test(v);
+        if (format === 'uuid')
+            return UUID_RE.test(v);
+        return true;
+    };
+    const formatKey = format === 'email'
+        ? 'validation:invalidEmail'
+        : format === 'url'
+            ? 'validation:invalidUrl'
+            : format === 'uuid'
+                ? 'validation:invalidUuid'
+                : null;
+    return z
+        .union([z.string(), z.null(), z.undefined()])
+        .transform((v) => (typeof v === 'string' ? v : v == null ? '' : String(v)))
+        .superRefine((value, ctx) => {
+        const blank = value.trim() === '';
+        if (blank) {
+            if (p.isRequired) {
+                ctx.addIssue({ code: 'custom', message: t('validation:required', { label }) });
+            }
+            return;
+        }
+        if (formatKey && !checkFormat(value)) {
+            ctx.addIssue({ code: 'custom', message: t(formatKey, { label }) });
+        }
+    })
+        .transform((v) => (v.trim() === '' ? null : v));
+}
+/** Number validator with coercion from string inputs (HTML inputs ship strings). */
+function numberSchema(p, t, integer = false) {
+    const label = p.label;
+    // Validate at the unknown layer because Zod 4's z.number() rejects NaN
+    // before our refinement can produce a localized message. We coerce here,
+    // then assert the type ourselves so all error paths flow through superRefine.
+    return z.unknown().superRefine((raw, ctx) => {
+        if (isBlank(raw)) {
+            if (p.isRequired) {
+                ctx.addIssue({ code: 'custom', message: t('validation:required', { label }) });
+            }
+            return;
+        }
+        const value = typeof raw === 'number' ? raw : Number(raw);
+        if (!Number.isFinite(value)) {
+            ctx.addIssue({ code: 'custom', message: t('validation:invalidNumber', { label }) });
+            return;
+        }
+        if (integer && !Number.isInteger(value)) {
+            ctx.addIssue({ code: 'custom', message: t('validation:invalidInteger', { label }) });
+        }
+    }).transform((raw) => {
+        if (isBlank(raw))
+            return null;
+        const n = typeof raw === 'number' ? raw : Number(raw);
+        return Number.isFinite(n) ? n : null;
+    });
+}
+/** Boolean validator; missing value → false (HTML default for unchecked). */
+function booleanSchema(_p, _t) {
+    return z.preprocess((v) => (typeof v === 'boolean' ? v : Boolean(v)), z.boolean());
+}
+/** Date validator: accepts ISO strings or `Date`; rejects unparseable input. */
+function dateSchema(p, t) {
+    const label = p.label;
+    return z
+        .union([z.string(), z.date(), z.null(), z.undefined()])
+        .superRefine((value, ctx) => {
+        if (isBlank(value)) {
+            if (p.isRequired) {
+                ctx.addIssue({ code: 'custom', message: t('validation:required', { label }) });
+            }
+            return;
+        }
+        const parsed = value instanceof Date ? value : new Date(String(value));
+        if (Number.isNaN(parsed.getTime())) {
+            ctx.addIssue({ code: 'custom', message: t('validation:invalidDate', { label }) });
+        }
+    })
+        .transform((v) => (isBlank(v) ? null : v));
+}
+/** Single reference validator: requires a non-empty FK when isRequired. */
+function referenceSchema(p, t) {
+    const label = p.label;
+    return z
+        .union([z.string(), z.number(), z.null(), z.undefined()])
+        .superRefine((value, ctx) => {
+        if (isBlank(value) && p.isRequired) {
+            ctx.addIssue({ code: 'custom', message: t('validation:required', { label }) });
+        }
+    })
+        .transform((v) => (isBlank(v) ? null : v));
+}
+/** Multi-reference validator: array of FKs, must be non-empty when required.
+ *
+ * Pre-processes the input to flatten any accidentally-nested arrays and drop
+ * blank items, so a stale form state like `[["3","4"]]` still validates as
+ * the expected `["3","4"]` rather than tripping the inner string check. */
+function multiReferenceSchema(p, t) {
+    const label = p.label;
+    const normalize = (raw) => {
+        if (raw == null)
+            return [];
+        const items = Array.isArray(raw) ? raw : [raw];
+        const out = [];
+        for (const item of items) {
+            if (Array.isArray(item)) {
+                for (const sub of item) {
+                    if (sub != null && sub !== '')
+                        out.push(sub);
+                }
+            }
+            else if (item != null && item !== '') {
+                out.push(item);
+            }
+        }
+        return out;
+    };
+    return z
+        .preprocess(normalize, z.array(z.union([z.string(), z.number()])))
+        .superRefine((value, ctx) => {
+        if (p.isRequired && value.length === 0) {
+            ctx.addIssue({ code: 'custom', message: t('validation:emptySelection', { label }) });
+        }
+    });
+}
+/** File validator: single-file values are storage keys (string/null), while
+ * multi-file values are arrays of storage keys. */
+function fileSchema(p, t) {
+    if (p.isArray) {
+        return multiReferenceSchema(p, t);
+    }
+    return stringSchema(p, t);
+}
+/** Enum validator from `availableValues`. Unmatched value → notInList. */
+function enumSchema(p, t) {
+    const label = p.label;
+    const allowed = new Set((p.availableValues ?? []).map((v) => v.value));
+    return z
+        .union([z.string(), z.null(), z.undefined()])
+        .transform((v) => (v == null ? '' : String(v)))
+        .superRefine((value, ctx) => {
+        if (value === '') {
+            if (p.isRequired) {
+                ctx.addIssue({ code: 'custom', message: t('validation:required', { label }) });
+            }
+            return;
+        }
+        if (!allowed.has(value)) {
+            ctx.addIssue({ code: 'custom', message: t('validation:notInList', { label }) });
+        }
+    })
+        .transform((v) => (v === '' ? null : v));
+}
+/** JSON validator: accepts any JSON-serializable value (object/array/null).
+ *
+ * Unlike string fields, json fields hold a parsed JavaScript value — the
+ * JsonEditor emits objects/arrays directly. The schema passes them through
+ * as-is; only the required check (null/undefined → error) is applied. */
+function jsonSchema(p, t) {
+    const label = p.label;
+    return z
+        .unknown()
+        .superRefine((v, ctx) => {
+        if ((v == null || v === '') && p.isRequired) {
+            ctx.addIssue({ code: 'custom', message: t('validation:required', { label }) });
+        }
+    })
+        .transform((v) => (v === '' ? null : v));
+}
+/** Many-to-many validator: array of `{ id, ...extras }` items.
+ *
+ * The M2M editor emits an array of objects (id of the referenced record plus
+ * arbitrary junction extra fields, e.g. `addedAt`, `position`). Bare ids are
+ * also accepted and normalized into `{ id }` objects so legacy form state
+ * doesn't trip the schema. Extra fields are passed through untouched —
+ * the backend's m2m feature persists whatever it recognises and ignores
+ * the rest. */
+function m2mSchema(p, t) {
+    const label = p.label;
+    const normalize = (raw) => {
+        if (raw == null)
+            return [];
+        const items = Array.isArray(raw) ? raw : [raw];
+        const out = [];
+        for (const item of items) {
+            if (item == null || item === '')
+                continue;
+            if (typeof item === 'string' || typeof item === 'number') {
+                out.push({ id: String(item) });
+                continue;
+            }
+            if (typeof item === 'object') {
+                const obj = item;
+                const id = obj.id ?? obj.value;
+                if (id == null || id === '')
+                    continue;
+                out.push({ ...obj, id: String(id) });
+            }
+        }
+        return out;
+    };
+    return z
+        .preprocess(normalize, z.array(z.record(z.string(), z.unknown())))
+        .superRefine((value, ctx) => {
+        if (p.isRequired && value.length === 0) {
+            ctx.addIssue({ code: 'custom', message: t('validation:emptySelection', { label }) });
+        }
+    });
+}
+/** Build the Zod schema for a property without considering `showWhen`. */
+function buildPropertySchemaInner(p, t) {
+    // M2M is structurally different from a multi-reference — its values are
+    // `{ id, ...extras }` objects, not bare FKs. Branch first so the
+    // `p.reference` check below doesn't capture it.
+    if (p.type === 'm2m') {
+        return m2mSchema(p, t);
+    }
+    // Enum-like properties always go through the availableValues path —
+    // overrides the raw type (e.g. a string with a fixed set of options).
+    if (p.availableValues && p.availableValues.length > 0) {
+        return enumSchema(p, t);
+    }
+    if (p.reference) {
+        return p.isArray ? multiReferenceSchema(p, t) : referenceSchema(p, t);
+    }
+    switch (p.type) {
+        case 'boolean':
+            return booleanSchema(p, t);
+        case 'number':
+        case 'float':
+        case 'currency':
+        case 'money':
+            return numberSchema(p, t, false);
+        case 'integer':
+            return numberSchema(p, t, true);
+        case 'date':
+        case 'datetime':
+        case 'datetime-local':
+            return dateSchema(p, t);
+        case 'email':
+            return stringSchema(p, t, 'email');
+        case 'url':
+            return stringSchema(p, t, 'url');
+        case 'uuid':
+            return stringSchema(p, t, 'uuid');
+        case 'json':
+            return jsonSchema(p, t);
+        case 'string':
+        case 'text':
+        case 'textarea':
+        case 'password':
+        case 'richtext':
+        case 'color':
+        case 'file':
+            return fileSchema(p, t);
+        default:
+            return stringSchema(p, t);
+    }
+}
+/**
+ * Map a PropertyJSON to its Zod schema. When the property has a `showWhen`
+ * rule and a `getValues` getter is supplied, the schema short-circuits to
+ * a no-op while the rule does not match — letting hidden branches pass
+ * validation without their required/format checks tripping submission.
+ */
+export function buildPropertySchema(p, t, getValues) {
+    const inner = buildPropertySchemaInner(p, t);
+    if (!p.showWhen || !getValues)
+        return inner;
+    // Wrap: only forward to `inner` when visible. Hidden → accept anything,
+    // pass it through unchanged. We re-emit issues from `inner` so error
+    // messages and paths stay identical to the non-conditional case.
+    return z
+        .any()
+        .superRefine((value, ctx) => {
+        if (!evaluateShowWhen(p.showWhen, getValues()))
+            return;
+        const result = inner.safeParse(value);
+        if (!result.success) {
+            // Zod 4's `RefinementCtx.addIssue` accepts a structurally looser
+            // shape than `$ZodIssue`; spread into a plain object to satisfy
+            // the inferred parameter type.
+            for (const issue of result.error.issues) {
+                ctx.addIssue({ ...issue });
+            }
+        }
+    })
+        .transform((value) => {
+        if (!evaluateShowWhen(p.showWhen, getValues()))
+            return value;
+        const result = inner.safeParse(value);
+        return result.success ? result.data : value;
+    });
+}
+/** Build a Zod object schema covering every editable property in a resource. */
+export function buildValidationSchema(properties, t, getValues) {
+    const shape = {};
+    for (const p of properties)
+        shape[p.path] = buildPropertySchema(p, t, getValues);
+    return z.object(shape);
+}
+/** Sensible empty default per type so RHF stays controlled from first render. */
+export function defaultValueFor(p) {
+    if (p.type === 'boolean')
+        return false;
+    if (p.type === 'json')
+        return null;
+    if (p.isArray)
+        return [];
+    return '';
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,8EAA8E;AAC9E,0EAA0E;AAC1E,2EAA2E;AAC3E,sEAAsE;AACtE,uEAAuE;AACvE,+CAA+C;AAC/C,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,iDAAiD;AAEjD,OAAO,EAAE,CAAC,EAAgB,MAAM,KAAK,CAAA;AAErC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAYjD,6EAA6E;AAC7E,MAAM,QAAQ,GAAG,4BAA4B,CAAA;AAC7C,MAAM,MAAM,GAAG,iBAAiB,CAAA;AAChC,MAAM,OAAO,GACX,iEAAiE,CAAA;AAEnE,MAAM,OAAO,GAAG,CAAC,CAAU,EAAW,EAAE,CACtC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;AAE7E,uEAAuE;AACvE,SAAS,YAAY,CAAC,CAAe,EAAE,CAAa,EAAE,MAAiC;IACrF,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACrB,MAAM,WAAW,GAAG,CAAC,CAAS,EAAW,EAAE;QACzC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC/C,IAAI,MAAM,KAAK,KAAK;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC3C,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC7C,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IACD,MAAM,SAAS,GACb,MAAM,KAAK,OAAO;QAChB,CAAC,CAAC,yBAAyB;QAC3B,CAAC,CAAC,MAAM,KAAK,KAAK;YAChB,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,MAAM,KAAK,MAAM;gBACjB,CAAC,CAAC,wBAAwB;gBAC1B,CAAC,CAAC,IAAI,CAAA;IAEd,OAAO,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;SAC5C,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;SAC1E,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;QACjC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjB,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;YAChF,CAAC;YACD,OAAM;QACR,CAAC;QACD,IAAI,SAAS,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACrC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QACpE,CAAC;IACH,CAAC,CAAC;SACD,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACnD,CAAC;AAED,oFAAoF;AACpF,SAAS,YAAY,CAAC,CAAe,EAAE,CAAa,EAAE,OAAO,GAAG,KAAK;IACnE,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACrB,uEAAuE;IACvE,yEAAyE;IACzE,8EAA8E;IAC9E,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjB,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;YAChF,CAAC;YACD,OAAM;QACR,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACzD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;YACnF,OAAM;QACR,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QACtF,CAAC;IACH,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,IAAI,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QAC7B,MAAM,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACrD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACtC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,6EAA6E;AAC7E,SAAS,aAAa,CAAC,EAAgB,EAAE,EAAc;IACrD,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;AACpF,CAAC;AAED,gFAAgF;AAChF,SAAS,UAAU,CAAC,CAAe,EAAE,CAAa;IAChD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACrB,OAAO,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;SACtD,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjB,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;YAChF,CAAC;YACD,OAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACtE,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QACnF,CAAC;IACH,CAAC,CAAC;SACD,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED,2EAA2E;AAC3E,SAAS,eAAe,CAAC,CAAe,EAAE,CAAa;IACrD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACrB,OAAO,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;SACxD,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YACnC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QAChF,CAAC;IACH,CAAC,CAAC;SACD,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED;;;;2EAI2E;AAC3E,SAAS,oBAAoB,CAAC,CAAe,EAAE,CAAa;IAC1D,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACrB,MAAM,SAAS,GAAG,CAAC,GAAY,EAA0B,EAAE;QACzD,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO,EAAE,CAAA;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAC9C,MAAM,GAAG,GAA2B,EAAE,CAAA;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE;wBAAE,GAAG,CAAC,IAAI,CAAC,GAAsB,CAAC,CAAA;gBACjE,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;gBACvC,GAAG,CAAC,IAAI,CAAC,IAAuB,CAAC,CAAA;YACnC,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IACD,OAAO,CAAC;SACL,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;SACjE,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,IAAI,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QACtF,CAAC;IACH,CAAC,CAAC,CAAA;AACN,CAAC;AAED;mDACmD;AACnD,SAAS,UAAU,CAAC,CAAe,EAAE,CAAa;IAChD,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC3B,CAAC;AAED,0EAA0E;AAC1E,SAAS,UAAU,CAAC,CAAe,EAAE,CAAa;IAChD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACrB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IACtE,OAAO,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;SAC5C,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;SAC9C,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACjB,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjB,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;YAChF,CAAC;YACD,OAAM;QACR,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QACjF,CAAC;IACH,CAAC,CAAC;SACD,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5C,CAAC;AAED;;;;yEAIyE;AACzE,SAAS,UAAU,CAAC,CAAe,EAAE,CAAa;IAChD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACrB,OAAO,CAAC;SACL,OAAO,EAAE;SACT,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACtB,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAC5C,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QAChF,CAAC;IACH,CAAC,CAAC;SACD,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC5C,CAAC;AAED;;;;;;;eAOe;AACf,SAAS,SAAS,CAAC,CAAe,EAAE,CAAa;IAC/C,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACrB,MAAM,SAAS,GAAG,CAAC,GAAY,EAAkC,EAAE;QACjE,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO,EAAE,CAAA;QAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAC9C,MAAM,GAAG,GAAmC,EAAE,CAAA;QAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,EAAE;gBAAE,SAAQ;YACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACzD,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBAC9B,SAAQ;YACV,CAAC;YACD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,IAA+B,CAAA;gBAC3C,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,KAAK,CAAA;gBAC9B,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,KAAK,EAAE;oBAAE,SAAQ;gBACrC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YACtC,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IACD,OAAO,CAAC;SACL,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;SACjE,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,IAAI,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,2BAA2B,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QACtF,CAAC;IACH,CAAC,CAAC,CAAA;AACN,CAAC;AAED,0EAA0E;AAC1E,SAAS,wBAAwB,CAAC,CAAe,EAAE,CAAa;IAC9D,wEAAwE;IACxE,iEAAiE;IACjE,gDAAgD;IAChD,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACxB,CAAC;IACD,oEAAoE;IACpE,sEAAsE;IACtE,IAAI,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACzB,CAAC;IACD,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAChB,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACvE,CAAC;IACD,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAC5B,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;QAClC,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;QACjC,KAAK,MAAM,CAAC;QACZ,KAAK,UAAU,CAAC;QAChB,KAAK,gBAAgB;YACnB,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACzB,KAAK,OAAO;YACV,OAAO,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;QACpC,KAAK,KAAK;YACR,OAAO,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAA;QAClC,KAAK,MAAM;YACT,OAAO,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;QACnC,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACzB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACzB;YACE,OAAO,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,CAAe,EACf,CAAa,EACb,SAA4B;IAE5B,MAAM,KAAK,GAAG,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC5C,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAA;IAE3C,wEAAwE;IACxE,qEAAqE;IACrE,iEAAiE;IACjE,OAAO,CAAC;SACL,GAAG,EAAE;SACL,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;YAAE,OAAM;QACtD,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,iEAAiE;YACjE,gEAAgE;YAChE,+BAA+B;YAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,KAAK,EAAwC,CAAC,CAAA;YAClE,CAAC;QACH,CAAC;IACH,CAAC,CAAC;SACD,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;QACnB,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;YAAE,OAAO,KAAK,CAAA;QAC5D,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACrC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;IAC7C,CAAC,CAAC,CAAA;AACN,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,qBAAqB,CACnC,UAA0B,EAC1B,CAAa,EACb,SAA4B;IAE5B,MAAM,KAAK,GAA4B,EAAE,CAAA;IACzC,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;IAChF,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACxB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,CAAe;IAC7C,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACtC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IAClC,IAAI,CAAC,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IACxB,OAAO,EAAE,CAAA;AACX,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@modern-admin/react",
+  "version": "0.1.0",
+  "description": "React 19 frontend layer for Modern Admin — translation boundary, routing, hooks.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/modern-admin/modern-admin.git",
+    "directory": "packages/react"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "dependencies": {
+    "@hookform/resolvers": "^5.2.2",
+    "@modern-admin/core": "0.1.0",
+    "@modern-admin/i18n": "0.1.0",
+    "@modern-admin/ui": "0.1.0",
+    "@tanstack/react-query": "^5.100.9",
+    "@tanstack/react-router": "^1.169.2",
+    "@tanstack/react-table": "^8.21.3",
+    "lucide-react": "^1.14.0",
+    "react-hook-form": "^7.75.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@modern-admin/tsconfig": "0.1.0",
+    "@types/bun": "^1.3.13",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6"
+  }
+}

package/src/action-guard.ts

@@ -0,0 +1,20 @@
+import type { ActionDescriptor } from './types.js'
+import type { ConfirmOptions, DialogsApi } from './dialogs.js'
+
+/**
+ * If `action.guard` is set, shows a confirm dialog with that text as the
+ * description before proceeding. Returns `true` if the action should run
+ * (no guard configured, or user clicked Confirm), `false` if cancelled.
+ *
+ * Usage at an invoke call-site:
+ *   if (!await confirmGuard(action, dialogs)) return
+ *   invoke.mutate(...)
+ */
+export async function confirmGuard(
+  action: Pick<ActionDescriptor, 'guard'>,
+  dialogs: Pick<DialogsApi, 'confirm'>,
+  extra?: Omit<ConfirmOptions, 'description'>,
+): Promise<boolean> {
+  if (!action.guard) return true
+  return dialogs.confirm({ description: action.guard, ...extra })
+}

package/src/action-menu.tsx

@@ -0,0 +1,161 @@
+import * as React from 'react'
+import {
+  Button,
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuLabel,
+  DropdownMenuPortal,
+  DropdownMenuSeparator,
+  DropdownMenuSub,
+  DropdownMenuSubContent,
+  DropdownMenuSubTrigger,
+  DropdownMenuTrigger,
+} from '@modern-admin/ui'
+import { MoreHorizontal, Zap } from 'lucide-react'
+import type { ActionDescriptor, ActionGroup } from './types.js'
+
+interface ActionMenuGroupNode {
+  key: string
+  group: ActionGroup
+  items: ActionMenuNode[]
+}
+
+type ActionMenuNode =
+  | { kind: 'action'; action: ActionDescriptor }
+  | { kind: 'group'; group: ActionMenuGroupNode }
+
+export interface ActionMenuProps {
+  actions: ActionDescriptor[]
+  onAction(action: ActionDescriptor): void
+  t: (key: string, params?: Record<string, string | number>) => string
+  trigger?: React.ReactElement
+  menuLabel?: string
+  align?: 'start' | 'center' | 'end'
+}
+
+const getActionLabel = (action: ActionDescriptor): string =>
+  typeof action.custom?.label === 'string' ? action.custom.label : action.name
+
+const buildActionMenuTree = (actions: ActionDescriptor[]): ActionMenuNode[] => {
+  const root: ActionMenuNode[] = []
+  const groups = new Map<string, ActionMenuGroupNode>()
+
+  const ensureGroup = (target: ActionMenuNode[], path: ActionGroup[], depth: number): ActionMenuNode[] => {
+    if (depth >= path.length) return target
+    const segment = path[depth]!
+    const key = path
+      .slice(0, depth + 1)
+      .map((item) => item.name)
+      .join('>')
+    let group = groups.get(key)
+    if (!group) {
+      group = { key, group: segment, items: [] }
+      groups.set(key, group)
+      target.push({ kind: 'group', group })
+    }
+    return ensureGroup(group.items, path, depth + 1)
+  }
+
+  for (const action of actions) {
+    const nesting = action.nesting ?? []
+    const target = nesting.length > 0 ? ensureGroup(root, nesting, 0) : root
+    target.push({ kind: 'action', action })
+  }
+
+  return root
+}
+
+const renderNodes = (
+  nodes: ActionMenuNode[],
+  onAction: (action: ActionDescriptor) => void,
+): React.ReactNode =>
+  nodes.map((node) => {
+    if (node.kind === 'action') {
+      return (
+        <DropdownMenuItem
+          key={node.action.name}
+          onSelect={() => onAction(node.action)}
+        >
+          <Zap className="size-4" /> {getActionLabel(node.action)}
+        </DropdownMenuItem>
+      )
+    }
+    return (
+      <DropdownMenuSub key={node.group.key}>
+        <DropdownMenuSubTrigger>
+          {node.group.group.name}
+        </DropdownMenuSubTrigger>
+        <DropdownMenuPortal>
+          <DropdownMenuSubContent>
+            {renderNodes(node.group.items, onAction)}
+          </DropdownMenuSubContent>
+        </DropdownMenuPortal>
+      </DropdownMenuSub>
+    )
+  })
+
+export function ActionMenuItems({
+  actions,
+  onAction,
+}: {
+  actions: ActionDescriptor[]
+  onAction(action: ActionDescriptor): void
+}): React.ReactElement | null {
+  const nodes = React.useMemo(() => buildActionMenuTree(actions), [actions])
+  if (nodes.length === 0) return null
+  return <>{renderNodes(nodes, onAction)}</>
+}
+
+export function ActionMenu({
+  actions,
+  onAction,
+  t,
+  trigger,
+  menuLabel,
+  align = 'end',
+}: ActionMenuProps): React.ReactElement | null {
+  const nodes = React.useMemo(() => buildActionMenuTree(actions), [actions])
+  if (nodes.length === 0) return null
+
+  return (
+    <DropdownMenu>
+      <DropdownMenuTrigger asChild>
+        {trigger ?? (
+          <Button variant="outline" size="sm">
+            <Zap className="size-4" />
+            {t('common:actions')}
+          </Button>
+        )}
+      </DropdownMenuTrigger>
+      <DropdownMenuContent align={align}>
+        <DropdownMenuLabel>{menuLabel ?? t('common:actions')}</DropdownMenuLabel>
+        <DropdownMenuSeparator />
+        <ActionMenuItems actions={actions} onAction={onAction} />
+      </DropdownMenuContent>
+    </DropdownMenu>
+  )
+}
+
+export function MoreActionsMenu({
+  actions,
+  onAction,
+  t,
+  menuLabel,
+}: Omit<ActionMenuProps, 'trigger' | 'align'>): React.ReactElement | null {
+  if (actions.length === 0) return null
+  return (
+    <ActionMenu
+      actions={actions}
+      onAction={onAction}
+      t={t}
+      menuLabel={menuLabel}
+      trigger={(
+        <Button variant="ghost" size="icon" className="h-8 w-8">
+          <MoreHorizontal className="size-4" />
+          <span className="sr-only">{t('common:openMenu')}</span>
+        </Button>
+      )}
+    />
+  )
+}