@byline/admin 2.5.1 → 2.6.0

package/dist/modules/admin-users/components/set-password.js

@@ -1,28 +1,33 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useState } from "react";
+import { useMemo, useState } from "react";
 import { revalidateLogic, useForm } from "@tanstack/react-form-start";
 import { passwordSchema } from "@byline/core/validation";
+import { useTranslation } from "@byline/i18n/react";
 import { Alert, Button, InputPassword, LoaderEllipsis } from "@byline/ui/react";
 import classnames from "classnames";
 import { z } from "zod";
+import { translateValidationError } from "../../../lib/translate-validation-error.js";
 import { useBylineAdminServices } from "../../../services/admin-services-context.js";
 import set_password_module from "./set-password.module.js";
-const setPasswordFormSchema = z.object({
-    password: passwordSchema,
-    confirm: z.string({
-        message: 'Please confirm the password'
-    })
-}).refine((v)=>v.password === v.confirm, {
-    message: 'Passwords do not match',
-    path: [
-        'confirm'
-    ]
-});
 function SetPassword({ user, onClose, onSuccess }) {
     const { setAdminUserPassword } = useBylineAdminServices();
+    const { t } = useTranslation('byline-admin');
     const [formError, setFormError] = useState(null);
     const [successMessage, setSuccessMessage] = useState(null);
+    const setPasswordFormSchema = useMemo(()=>z.object({
+            password: passwordSchema,
+            confirm: z.string({
+                message: t('account.changePassword.errors.confirmRequired')
+            })
+        }).refine((v)=>v.password === v.confirm, {
+            message: t('account.changePassword.errors.mismatch'),
+            path: [
+                'confirm'
+            ]
+        }), [
+        t
+    ]);
     const form = useForm({
         defaultValues: {
             password: '',
@@ -46,7 +51,7 @@ function SetPassword({ user, onClose, onSuccess }) {
                         password: value.password
                     }
                 });
-                setSuccessMessage('Password updated.');
+                setSuccessMessage(t('account.changePassword.feedback.updated'));
                 form.reset({
                     password: '',
                     confirm: ''
@@ -54,9 +59,9 @@ function SetPassword({ user, onClose, onSuccess }) {
                 onSuccess?.(updated);
             } catch (err) {
                 const code = getErrorCode(err);
-                if ('admin.users.versionConflict' === code) return void setFormError('This user has been modified elsewhere since you opened this form. Reload to refresh and try again.');
-                if ('admin.users.notFound' === code) return void setFormError('This user no longer exists.');
-                setFormError('Could not set the password. Please try again.');
+                if ('admin.users.versionConflict' === code) return void setFormError(t('adminUsers.update.errors.versionConflict'));
+                if ('admin.users.notFound' === code) return void setFormError(t('adminUsers.update.errors.notFound'));
+                setFormError(t('adminUsers.setPassword.errors.fallback'));
             }
         }
     });
@@ -79,29 +84,23 @@ function SetPassword({ user, onClose, onSuccess }) {
                     intent: "success",
                     children: successMessage
                 }) : null,
-                /*#__PURE__*/ jsxs("p", {
+                /*#__PURE__*/ jsx("p", {
                     className: "muted",
-                    children: [
-                        "Sets a new password for",
-                        ' ',
-                        /*#__PURE__*/ jsx("span", {
-                            className: classnames('byline-user-set-password-target', set_password_module.target),
-                            children: user.email
-                        }),
-                        ". The user will need to sign in again with the new password."
-                    ]
+                    children: t('adminUsers.setPassword.intro', {
+                        email: user.email
+                    })
                 }),
                 /*#__PURE__*/ jsx(form.Field, {
                     name: "password",
                     children: (field)=>/*#__PURE__*/ jsx(InputPassword, {
-                            label: "New password",
+                            label: t('account.changePassword.fields.new'),
                             id: "password",
                             name: field.name,
                             value: field.state.value,
                             onBlur: field.handleBlur,
                             onChange: (e)=>field.handleChange(e.currentTarget.value),
                             error: field.state.meta.errors.length > 0,
-                            errorText: firstError(field.state.meta.errors),
+                            errorText: translateValidationError(t, firstError(field.state.meta.errors)),
                             autoComplete: "new-password",
                             required: true
                         })
@@ -109,7 +108,7 @@ function SetPassword({ user, onClose, onSuccess }) {
                 /*#__PURE__*/ jsx(form.Field, {
                     name: "confirm",
                     children: (field)=>/*#__PURE__*/ jsx(InputPassword, {
-                            label: "Confirm new password",
+                            label: t('account.changePassword.fields.confirm'),
                             id: "confirm",
                             name: field.name,
                             value: field.state.value,
@@ -130,7 +129,7 @@ function SetPassword({ user, onClose, onSuccess }) {
                             size: "sm",
                             onClick: onClose,
                             className: classnames('byline-user-set-password-action', set_password_module.action),
-                            children: successMessage ? 'Close' : 'Cancel'
+                            children: successMessage ? t('common.actions.close') : t('common.actions.cancel')
                         }),
                         /*#__PURE__*/ jsx(form.Subscribe, {
                             selector: (state)=>({
@@ -146,7 +145,7 @@ function SetPassword({ user, onClose, onSuccess }) {
                                     className: classnames('byline-user-set-password-action', set_password_module.action),
                                     children: true === isSubmitting ? /*#__PURE__*/ jsx(LoaderEllipsis, {
                                         size: 42
-                                    }) : 'Save'
+                                    }) : t('common.actions.save')
                                 })
                         })
                     ]

package/dist/modules/admin-users/components/update.js

@@ -1,23 +1,16 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useState } from "react";
+import { useMemo, useState } from "react";
 import { revalidateLogic, useForm } from "@tanstack/react-form-start";
+import { useTranslation } from "@byline/i18n/react";
 import { Alert, Button, Checkbox, Input, LoaderEllipsis } from "@byline/ui/react";
 import classnames from "classnames";
 import { z } from "zod";
 import { useBylineAdminServices } from "../../../services/admin-services-context.js";
 import update_module from "./update.module.js";
-const updateUserSchema = z.object({
-    given_name: z.string().max(100, 'Given name must not exceed 100 characters'),
-    family_name: z.string().max(100, 'Family name must not exceed 100 characters'),
-    username: z.string().max(100, 'Username must not exceed 100 characters'),
-    email: z.email({
-        message: 'Enter a valid email address'
-    }).min(3).max(254, 'Email must not exceed 254 characters'),
-    is_super_admin: z.boolean(),
-    is_enabled: z.boolean(),
-    is_email_verified: z.boolean()
-});
+const MAX_NAME = 100;
+const MAX_USERNAME = 100;
+const MAX_EMAIL = 254;
 function defaultsFrom(user) {
     return {
         given_name: user.given_name ?? '',
@@ -46,8 +39,30 @@ function buildPatch(values, user) {
 }
 function UpdateUser({ user, onClose, onSuccess }) {
     const { updateAdminUser } = useBylineAdminServices();
+    const { t } = useTranslation('byline-admin');
     const [formError, setFormError] = useState(null);
     const [successMessage, setSuccessMessage] = useState(null);
+    const updateUserSchema = useMemo(()=>z.object({
+            given_name: z.string().max(MAX_NAME, t('account.update.errors.givenNameTooLong', {
+                max: MAX_NAME
+            })),
+            family_name: z.string().max(MAX_NAME, t('account.update.errors.familyNameTooLong', {
+                max: MAX_NAME
+            })),
+            username: z.string().max(MAX_USERNAME, t('account.update.errors.usernameTooLong', {
+                max: MAX_USERNAME
+            })),
+            email: z.email({
+                message: t('account.update.errors.invalidEmail')
+            }).min(3).max(MAX_EMAIL, t('account.update.errors.emailTooLong', {
+                max: MAX_EMAIL
+            })),
+            is_super_admin: z.boolean(),
+            is_enabled: z.boolean(),
+            is_email_verified: z.boolean()
+        }), [
+        t
+    ]);
     const form = useForm({
         defaultValues: defaultsFrom(user),
         validationLogic: revalidateLogic({
@@ -61,7 +76,7 @@ function UpdateUser({ user, onClose, onSuccess }) {
             setFormError(null);
             setSuccessMessage(null);
             const patch = buildPatch(value, user);
-            if (0 === Object.keys(patch).length) return void setSuccessMessage('No changes to save.');
+            if (0 === Object.keys(patch).length) return void setSuccessMessage(t('common.feedback.noChanges'));
             try {
                 const updated = await updateAdminUser({
                     data: {
@@ -70,23 +85,27 @@ function UpdateUser({ user, onClose, onSuccess }) {
                         patch
                     }
                 });
-                setSuccessMessage('Saved.');
+                setSuccessMessage(t('common.feedback.saved'));
                 onSuccess?.(updated);
             } catch (err) {
                 const code = getErrorCode(err);
-                if ('admin.users.emailInUse' === code) return void form.setFieldMeta('email', (meta)=>({
-                        ...meta,
-                        errorMap: {
-                            ...meta.errorMap,
-                            onServer: 'This email is already in use.'
-                        },
-                        errors: [
-                            'This email is already in use.'
-                        ]
-                    }));
-                if ('admin.users.versionConflict' === code) return void setFormError('This user has been modified elsewhere since you opened this form. Reload to get the latest values and try again.');
-                if ('admin.users.notFound' === code) return void setFormError('This user no longer exists.');
-                setFormError('Could not save changes. Please try again.');
+                if ('admin.users.emailInUse' === code) {
+                    const message = t('account.update.errors.emailInUse');
+                    form.setFieldMeta('email', (meta)=>({
+                            ...meta,
+                            errorMap: {
+                                ...meta.errorMap,
+                                onServer: message
+                            },
+                            errors: [
+                                message
+                            ]
+                        }));
+                    return;
+                }
+                if ('admin.users.versionConflict' === code) return void setFormError(t('adminUsers.update.errors.versionConflict'));
+                if ('admin.users.notFound' === code) return void setFormError(t('adminUsers.update.errors.notFound'));
+                setFormError(t('common.errors.couldNotSave'));
             }
         }
     });
@@ -112,7 +131,7 @@ function UpdateUser({ user, onClose, onSuccess }) {
                 /*#__PURE__*/ jsx(form.Field, {
                     name: "given_name",
                     children: (field)=>/*#__PURE__*/ jsx(Input, {
-                            label: "Given name",
+                            label: t('account.update.fields.givenName'),
                             id: "given_name",
                             name: field.name,
                             value: field.state.value,
@@ -126,7 +145,7 @@ function UpdateUser({ user, onClose, onSuccess }) {
                 /*#__PURE__*/ jsx(form.Field, {
                     name: "family_name",
                     children: (field)=>/*#__PURE__*/ jsx(Input, {
-                            label: "Family name",
+                            label: t('account.update.fields.familyName'),
                             id: "family_name",
                             name: field.name,
                             value: field.state.value,
@@ -140,7 +159,7 @@ function UpdateUser({ user, onClose, onSuccess }) {
                 /*#__PURE__*/ jsx(form.Field, {
                     name: "username",
                     children: (field)=>/*#__PURE__*/ jsx(Input, {
-                            label: "Username",
+                            label: t('account.update.fields.username'),
                             id: "username",
                             name: field.name,
                             value: field.state.value,
@@ -148,14 +167,14 @@ function UpdateUser({ user, onClose, onSuccess }) {
                             onChange: (e)=>field.handleChange(e.currentTarget.value),
                             error: field.state.meta.errors.length > 0,
                             errorText: firstError(field.state.meta.errors),
-                            helpText: "Optional. Leave blank to clear.",
+                            helpText: t('account.update.fields.usernameHelp'),
                             autoComplete: "username"
                         })
                 }),
                 /*#__PURE__*/ jsx(form.Field, {
                     name: "email",
                     children: (field)=>/*#__PURE__*/ jsx(Input, {
-                            label: "Email",
+                            label: t('common.fields.email'),
                             id: "email",
                             name: field.name,
                             type: "email",
@@ -176,10 +195,10 @@ function UpdateUser({ user, onClose, onSuccess }) {
                             children: (field)=>/*#__PURE__*/ jsx(Checkbox, {
                                     id: "is_enabled",
                                     name: field.name,
-                                    label: "Enabled",
+                                    label: t('adminUsers.create.flags.enabledLabel'),
                                     checked: field.state.value,
                                     onCheckedChange: (checked)=>field.handleChange(true === checked),
-                                    helpText: "Disabled accounts cannot sign in."
+                                    helpText: t('adminUsers.create.flags.enabledHelp')
                                 })
                         }),
                         /*#__PURE__*/ jsx(form.Field, {
@@ -187,7 +206,7 @@ function UpdateUser({ user, onClose, onSuccess }) {
                             children: (field)=>/*#__PURE__*/ jsx(Checkbox, {
                                     id: "is_email_verified",
                                     name: field.name,
-                                    label: "Email verified",
+                                    label: t('adminUsers.create.flags.emailVerifiedLabel'),
                                     checked: field.state.value,
                                     onCheckedChange: (checked)=>field.handleChange(true === checked)
                                 })
@@ -197,10 +216,10 @@ function UpdateUser({ user, onClose, onSuccess }) {
                             children: (field)=>/*#__PURE__*/ jsx(Checkbox, {
                                     id: "is_super_admin",
                                     name: field.name,
-                                    label: "Super admin",
+                                    label: t('adminUsers.create.flags.superAdminLabel'),
                                     checked: field.state.value,
                                     onCheckedChange: (checked)=>field.handleChange(true === checked),
-                                    helpText: "Super admins bypass every ability check — grant with care."
+                                    helpText: t('adminUsers.create.flags.superAdminHelp')
                                 })
                         })
                     ]
@@ -214,7 +233,7 @@ function UpdateUser({ user, onClose, onSuccess }) {
                             size: "sm",
                             onClick: onClose,
                             className: classnames('byline-user-update-action', update_module.action),
-                            children: successMessage ? 'Close' : 'Cancel'
+                            children: successMessage ? t('common.actions.close') : t('common.actions.cancel')
                         }),
                         /*#__PURE__*/ jsx(form.Subscribe, {
                             selector: (state)=>({
@@ -230,7 +249,7 @@ function UpdateUser({ user, onClose, onSuccess }) {
                                     className: classnames('byline-user-update-action', update_module.action),
                                     children: true === isSubmitting ? /*#__PURE__*/ jsx(LoaderEllipsis, {
                                         size: 42
-                                    }) : 'Save'
+                                    }) : t('common.actions.save')
                                 })
                         })
                     ]

package/dist/modules/admin-users/dto.js

@@ -13,6 +13,7 @@ function toAdminUser(row) {
         is_super_admin: row.is_super_admin,
         is_enabled: row.is_enabled,
         is_email_verified: row.is_email_verified,
+        preferred_locale: row.preferred_locale,
         created_at: row.created_at,
         updated_at: row.updated_at
     };

package/dist/modules/admin-users/repository.d.ts

@@ -48,6 +48,13 @@ export interface AdminUserRow {
     is_super_admin: boolean;
     is_enabled: boolean;
     is_email_verified: boolean;
+    /**
+     * Admin interface locale preference. `null` means "use the detection
+     * cascade" (cookie → Accept-Language → defaultLocale). Stored as a
+     * BCP 47 code; validated at the command layer against the host's
+     * `i18n.interface.locales`.
+     */
+    preferred_locale: string | null;
     created_at: Date;
     updated_at: Date;
 }
@@ -69,6 +76,8 @@ export interface CreateAdminUserInput {
     is_super_admin?: boolean;
     is_enabled?: boolean;
     is_email_verified?: boolean;
+    /** Initial locale preference. `null` defers to the detection cascade. */
+    preferred_locale?: string | null;
 }
 export interface UpdateAdminUserInput {
     given_name?: string | null;
@@ -79,6 +88,8 @@ export interface UpdateAdminUserInput {
     is_enabled?: boolean;
     is_email_verified?: boolean;
     remember_me?: boolean;
+    /** Pass `null` to clear and fall back to the detection cascade. */
+    preferred_locale?: string | null;
 }
 export type AdminUserListOrder = 'given_name' | 'family_name' | 'email' | 'username' | 'created_at' | 'updated_at';
 export interface ListAdminUsersOptions {
@@ -136,6 +147,12 @@ export interface AdminUsersRepository {
     setPasswordHash(id: string, expectedVid: number, passwordHash: string): Promise<AdminUserRow>;
     /** Toggle enabled state. Vid-less — admin intent is independent of other edits. */
     setEnabled(id: string, enabled: boolean): Promise<void>;
+    /**
+     * Set the admin interface locale preference. Vid-less — user preference
+     * is independent of content state. Pass `null` to clear and fall back
+     * to the detection cascade (cookie → Accept-Language → defaultLocale).
+     */
+    setPreferredLocale(id: string, locale: string | null): Promise<void>;
     recordLoginSuccess(id: string, ip: string | null): Promise<void>;
     recordLoginFailure(id: string): Promise<void>;
     /**

package/dist/modules/admin-users/schemas.d.ts

@@ -34,6 +34,7 @@ export declare const createAdminUserRequestSchema: z.ZodObject<{
     is_super_admin: z.ZodOptional<z.ZodBoolean>;
     is_enabled: z.ZodOptional<z.ZodBoolean>;
     is_email_verified: z.ZodOptional<z.ZodBoolean>;
+    preferred_locale: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type CreateAdminUserRequest = z.infer<typeof createAdminUserRequestSchema>;
 export declare const updateAdminUserRequestSchema: z.ZodObject<{
@@ -47,6 +48,7 @@ export declare const updateAdminUserRequestSchema: z.ZodObject<{
         is_super_admin: z.ZodOptional<z.ZodBoolean>;
         is_enabled: z.ZodOptional<z.ZodBoolean>;
         is_email_verified: z.ZodOptional<z.ZodBoolean>;
+        preferred_locale: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type UpdateAdminUserRequest = z.infer<typeof updateAdminUserRequestSchema>;
@@ -88,6 +90,7 @@ export declare const adminUserResponseSchema: z.ZodObject<{
     is_super_admin: z.ZodBoolean;
     is_enabled: z.ZodBoolean;
     is_email_verified: z.ZodBoolean;
+    preferred_locale: z.ZodNullable<z.ZodString>;
     created_at: z.ZodDate;
     updated_at: z.ZodDate;
 }, z.core.$strip>;
@@ -107,6 +110,7 @@ export declare const adminUserListResponseSchema: z.ZodObject<{
         is_super_admin: z.ZodBoolean;
         is_enabled: z.ZodBoolean;
         is_email_verified: z.ZodBoolean;
+        preferred_locale: z.ZodNullable<z.ZodString>;
         created_at: z.ZodDate;
         updated_at: z.ZodDate;
     }, z.core.$strip>>;

package/dist/modules/admin-users/schemas.js

@@ -12,6 +12,7 @@ const emailSchema = z.email({
     message: 'email must be a valid address'
 }).min(3).max(254).transform((v)=>v.toLowerCase());
 const nameSchema = z.string().min(1).max(100);
+const preferredLocaleSchema = z.string().min(2).max(16).regex(/^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$/, 'must be a BCP 47 locale tag');
 const orderSchema = z["enum"]([
     'given_name',
     'family_name',
@@ -38,7 +39,8 @@ const createAdminUserRequestSchema = z.object({
     username: z.string().min(1).max(100).nullish(),
     is_super_admin: z.boolean().optional(),
     is_enabled: z.boolean().optional(),
-    is_email_verified: z.boolean().optional()
+    is_email_verified: z.boolean().optional(),
+    preferred_locale: preferredLocaleSchema.nullish()
 });
 const updateAdminUserRequestSchema = z.object({
     id: idSchema,
@@ -50,7 +52,8 @@ const updateAdminUserRequestSchema = z.object({
         username: z.string().min(1).max(100).nullish(),
         is_super_admin: z.boolean().optional(),
         is_enabled: z.boolean().optional(),
-        is_email_verified: z.boolean().optional()
+        is_email_verified: z.boolean().optional(),
+        preferred_locale: preferredLocaleSchema.nullish()
     }).refine((p)=>Object.keys(p).length > 0, {
         message: 'patch cannot be empty'
     })
@@ -84,6 +87,7 @@ const adminUserResponseSchema = z.object({
     is_super_admin: z.boolean(),
     is_enabled: z.boolean(),
     is_email_verified: z.boolean(),
+    preferred_locale: z.string().nullable(),
     created_at: z.date(),
     updated_at: z.date()
 });

package/dist/modules/auth/components/sign-in-form.js

@@ -1,12 +1,14 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useState } from "react";
+import { useTranslation } from "@byline/i18n/react";
 import { Alert, Button, Card, Input, LoaderEllipsis } from "@byline/ui/react";
 import classnames from "classnames";
 import { useBylineAdminServices } from "../../../services/admin-services-context.js";
 import sign_in_form_module from "./sign-in-form.module.js";
 function SignInForm({ callbackUrl, homeUrl }) {
     const { adminSignIn } = useBylineAdminServices();
+    const { t } = useTranslation('byline-admin');
     const [email, setEmail] = useState('');
     const [password, setPassword] = useState('');
     const [pending, setPending] = useState(false);
@@ -14,7 +16,7 @@ function SignInForm({ callbackUrl, homeUrl }) {
     async function handleSubmit(event) {
         event.preventDefault();
         if (pending) return;
-        if (0 === email.trim().length || 0 === password.length) return void setError('Enter your email and password.');
+        if (0 === email.trim().length || 0 === password.length) return void setError(t('auth.signIn.errors.empty'));
         setPending(true);
         setError(null);
         try {
@@ -28,7 +30,7 @@ function SignInForm({ callbackUrl, homeUrl }) {
             window.location.assign(target);
         } catch (err) {
             console.warn('sign-in failed', err);
-            setError('Invalid credentials.');
+            setError(t('auth.signIn.errors.invalidCredentials'));
             setPending(false);
         }
     }
@@ -39,11 +41,11 @@ function SignInForm({ callbackUrl, homeUrl }) {
                 children: [
                     /*#__PURE__*/ jsx(Card.Title, {
                         children: /*#__PURE__*/ jsx("h2", {
-                            children: "Sign in"
+                            children: t('auth.signIn.title')
                         })
                     }),
                     /*#__PURE__*/ jsx(Card.Description, {
-                        children: "Sign in to the Byline admin."
+                        children: t("auth.signIn.description")
                     }),
                     error && /*#__PURE__*/ jsx(Alert, {
                         intent: "danger",
@@ -62,7 +64,7 @@ function SignInForm({ callbackUrl, homeUrl }) {
                             className: classnames('byline-sign-in-fields', sign_in_form_module.fields),
                             children: [
                                 /*#__PURE__*/ jsx(Input, {
-                                    label: "Email",
+                                    label: t('common.fields.email'),
                                     id: "email",
                                     name: "email",
                                     type: "email",
@@ -73,7 +75,7 @@ function SignInForm({ callbackUrl, homeUrl }) {
                                     disabled: pending
                                 }),
                                 /*#__PURE__*/ jsx(Input, {
-                                    label: "Password",
+                                    label: t('common.fields.password'),
                                     id: "password",
                                     name: "password",
                                     type: "password",
@@ -91,7 +93,7 @@ function SignInForm({ callbackUrl, homeUrl }) {
                                 homeUrl && /*#__PURE__*/ jsx("a", {
                                     href: homeUrl,
                                     className: classnames('byline-sign-in-home-link', sign_in_form_module["home-link"]),
-                                    children: "Home"
+                                    children: t('common.actions.home')
                                 }),
                                 /*#__PURE__*/ jsx(Button, {
                                     type: "submit",
@@ -101,7 +103,7 @@ function SignInForm({ callbackUrl, homeUrl }) {
                                         size: 30,
                                         color: "#aaaaaa"
                                     }) : /*#__PURE__*/ jsx("span", {
-                                        children: "Sign In"
+                                        children: t('common.actions.signIn')
                                     })
                                 })
                             ]

package/dist/presentation/group.d.ts

@@ -0,0 +1,27 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { ReactNode } from 'react';
+interface AdminGroupProps {
+    /** Optional heading rendered as a `<legend>` above the cluster. */
+    label?: string;
+    children: ReactNode;
+    className?: string;
+}
+/**
+ * Labelled fieldset clustering related fields together.
+ *
+ * Used by `FormRenderer` when a `CollectionAdminConfig` declares a `groups`
+ * primitive. Renders a bordered, padded `<fieldset>` with an optional
+ * `<legend>` for the label.
+ *
+ * Stable override handles: `.byline-admin-group` on the fieldset and
+ * `.byline-admin-group-legend` on the legend (alongside the hashed
+ * CSS-modules locals).
+ */
+export declare const AdminGroup: ({ label, children, className }: AdminGroupProps) => import("react").JSX.Element;
+export {};

package/dist/presentation/group.js

@@ -0,0 +1,14 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import classnames from "classnames";
+import group_module from "./group.module.js";
+const AdminGroup = ({ label, children, className })=>/*#__PURE__*/ jsxs("fieldset", {
+        className: classnames('byline-admin-group', group_module.group, className),
+        children: [
+            label && /*#__PURE__*/ jsx("legend", {
+                className: classnames('byline-admin-group-legend', group_module.legend),
+                children: label
+            }),
+            children
+        ]
+    });
+export { AdminGroup };

package/dist/presentation/group.module.js

@@ -0,0 +1,6 @@
+import "./group_module.css";
+const group_module = {
+    group: "group-VH6uAe",
+    legend: "legend-dpiU3e"
+};
+export default group_module;

package/dist/presentation/group_module.css

@@ -0,0 +1,19 @@
+:is(.group-VH6uAe, .byline-admin-group) {
+  gap: var(--spacing-16);
+  padding: var(--spacing-12);
+  border: var(--border-width-thin) var(--border-style-solid) var(--gray-200);
+  border-radius: var(--border-radius-md);
+  flex-direction: column;
+  display: flex;
+}
+
+:is(.legend-dpiU3e, .byline-admin-group-legend) {
+  padding-inline: var(--spacing-4);
+  font-size: var(--font-size-sm);
+  font-weight: var(--font-weight-medium);
+}
+
+:is(:is([data-theme="dark"], .dark) .group-VH6uAe, :is([data-theme="dark"], .dark) .byline-admin-group) {
+  border-color: var(--gray-700);
+}
+

package/dist/presentation/row.d.ts

@@ -0,0 +1,25 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { ReactNode } from 'react';
+interface AdminRowProps {
+    children: ReactNode;
+    className?: string;
+}
+/**
+ * Horizontal flex-row layout for admin form fields.
+ *
+ * Used by `FormRenderer` when a `CollectionAdminConfig` declares a `rows`
+ * primitive. Members are rendered side-by-side above the `sm` breakpoint
+ * and stack vertically below it. `flex-1` + `min-width: 0` lets two text
+ * inputs share the row evenly without overflowing.
+ *
+ * The element carries `.byline-admin-row` as a stable global class for
+ * host overrides (alongside the hashed CSS-modules local).
+ */
+export declare const AdminRow: ({ children, className }: AdminRowProps) => import("react").JSX.Element;
+export {};

package/dist/presentation/row.js

@@ -0,0 +1,8 @@
+import { jsx } from "react/jsx-runtime";
+import classnames from "classnames";
+import row_module from "./row.module.js";
+const AdminRow = ({ children, className })=>/*#__PURE__*/ jsx("div", {
+        className: classnames('byline-admin-row', row_module.row, className),
+        children: children
+    });
+export { AdminRow };

package/dist/presentation/row.module.js

@@ -0,0 +1,5 @@
+import "./row_module.css";
+const row_module = {
+    row: "row-WWZ32_"
+};
+export default row_module;