@bygghammar/cms-platform 0.52.0 → 0.54.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.54.0
+
+- `forms/FormRenderer`: the whole public managed-form runtime (validation,
+  conditional fields, honeypot, partial drafts, thank-you/redirect) now lives in
+  the package, together with `ManagedForm` which resolves a form by key.
+- `blocks/components/FormBlock`: the form section block is package-owned and is
+  registered in `SHARED_BLOCK_DEFS` as `form`, so a fresh site gets it for free.
+- `host`: new site-adapter contract (`registerSiteAdapters`,
+  `usePublicFormFns`, `useTripSource`) so a site hands its own server functions
+  and central trip source to package-owned public components.
+- `blocks/types`: added `FormProps`.
+
+## 0.53.0
+
+- `admin/describe-log`: one place that turns action codes and JSON meta into
+  ordinary English sentences for the Audit, Activity and Email log views.
+- `server/audit-core`: `auditAs` lets any staff-guarded core log through the
+  caller's own client, and every entry now stores its sentence in
+  `meta.summary` at write time.
+- `server/email-log-core`: `logEmail` records every send attempt — form
+  notifications, auto-replies, provider tests and account emails — with a
+  purpose and a sentence. Form delivery and the backoffice test send both go
+  through it.
+- Content records, language domains, redirects, site settings, image focus
+  points, image text and submission/delivery actions are now audited.
+- `AuditView`/`EmailLogsView`: rows lead with the sentence; codes stay in the
+  expanded detail only.
+
 ## 0.52.0
 
 - `IndexingStatusCard`: read-only search-engine indexing status (from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bygghammar/cms-platform",
-  "version": "0.52.0",
+  "version": "0.54.0",
   "description": "Shared CMS platform: blocks, block types, i18n core, UI primitives and design-token contract used by every Bygghammar/Voyara site.",
   "type": "module",
   "sideEffects": [
@@ -48,6 +48,7 @@
     "./trips": "./src/trips/index.ts",
     "./trips/TripSectionEditor": "./src/trips/TripSectionEditor.tsx",
     "./navigation": "./src/navigation/index.ts",
+    "./forms/FormRenderer": "./src/forms/FormRenderer.tsx",
     "./forms/conditions": "./src/forms/conditions.ts",
     "./forms/field-sets": "./src/forms/field-sets.ts",
     "./forms/form-audit": "./src/forms/form-audit.ts",
@@ -141,7 +142,9 @@
     "./backoffice/BlocksLibraryView": "./src/backoffice/BlocksLibraryView.tsx",
     "./backoffice/SharedContentListView": "./src/backoffice/SharedContentListView.tsx",
     "./backoffice/seo/SeoListView": "./src/backoffice/seo/SeoListView.tsx",
+    "./admin/describe-log": "./src/admin/describe-log.ts",
     "./server/audit-core": "./src/server/audit-core.ts",
+    "./server/email-log-core": "./src/server/email-log-core.ts",
     "./server/review-image-validate": "./src/server/review-image-validate.ts",
     "./server/media-library-core": "./src/server/media-library-core.ts",
     "./server/admin-core": "./src/server/admin-core.ts",

package/src/admin/describe-log.ts

@@ -0,0 +1,229 @@
+/**
+ * Plain-English descriptions for audit and email log rows.
+ *
+ * Everything an editor sees in the Activity, Audit and Email log views is
+ * written here in ordinary sentences — never raw action codes, table names or
+ * JSON. The same module runs on the server, where each log row gets its sentence
+ * stored in `meta.summary` at write time, so the wording survives even if the
+ * label tables later change.
+ */
+
+export const ACTION_LABELS: Record<string, string> = {
+  "user.create": "Created user",
+  "user.delete": "Deleted user",
+  "user.password_reset": "Set a new password",
+  "user.send_reset": "Sent a password reset email",
+  "user.set_roles": "Changed user roles",
+  "user.invite": "Invited user",
+  "role.grant": "Granted role",
+  "role.revoke": "Revoked role",
+  "role.update": "Updated role",
+  "email.settings.update": "Updated email settings",
+  "email_settings.update": "Updated email settings",
+  "email.settings.test": "Sent test email",
+  "email_provider.create": "Added email provider",
+  "email_provider.update": "Updated email provider",
+  "email_provider.delete": "Deleted email provider",
+  "email_provider.test_send": "Sent a test email",
+  "content.section.save": "Saved content",
+  "content.section.delete": "Deleted content",
+  "site_settings.update": "Updated site settings",
+  "site_settings.clear": "Reset a site setting to the code default",
+  "page.create": "Created page",
+  "page.update": "Updated page",
+  "page.delete": "Deleted page",
+  "page.publish": "Published page",
+  "page.unpublish": "Unpublished page",
+  "page.version.create": "Saved page version",
+  "page.version.restore": "Restored page version",
+  "template.create": "Created block template",
+  "template.update": "Updated block template",
+  "template.delete": "Deleted block template",
+  "global.section.save": "Saved global block",
+  "global.section.delete": "Deleted global block",
+  "domain.create": "Added language domain",
+  "domain.update": "Updated language domain",
+  "domain.save": "Saved language domain",
+  "domain.delete": "Removed language domain",
+  "seo.update": "Updated SEO settings",
+  "seo.delete": "Removed SEO settings",
+  "redirect.save": "Saved redirect",
+  "redirect.delete": "Deleted redirect",
+  "media.upload": "Uploaded media",
+  "media.delete": "Deleted media",
+  "media.import": "Imported external media",
+  "media.replace": "Replaced an image",
+  "media.focus.set": "Set an image focus point",
+  "media.focus.clear": "Cleared an image focus point",
+  "media.meta.set": "Updated image text",
+  "media.meta.clear": "Cleared image text",
+  "submission.partial.delete": "Deleted saved partial submissions",
+  "delivery.resolve": "Marked delivery attempts as resolved",
+  "translate.run": "Ran auto-translation",
+  "form.create": "Created form",
+  "form.update": "Updated form",
+  "form.duplicate": "Duplicated form",
+  "form.soft_delete": "Moved form to bin",
+  "form.restore": "Restored form",
+  "form.purge": "Permanently deleted form",
+  "form.defaults.update": "Updated shared form defaults",
+  "submission.status": "Changed a submission status",
+  "submission.purge": "Removed old submissions",
+  "submission.sheet_push": "Sent submissions to the spreadsheet",
+  "submission.delivery_retry": "Retried a failed delivery",
+  "submission.delivery_resolve": "Marked a delivery problem as resolved",
+  "submission.partials_delete": "Deleted saved drafts",
+  "backup.export": "Exported a backup",
+  "backup.import": "Restored from a backup",
+  "auth.login": "Signed in",
+  "auth.logout": "Signed out",
+};
+
+export const ENTITY_LABELS: Record<string, string> = {
+  user: "user",
+  "auth.users": "user",
+  user_role: "role",
+  user_roles: "roles",
+  content_section: "content record",
+  content_sections: "content record",
+  site_settings: "site settings",
+  page: "page",
+  page_version: "page version",
+  page_publication: "publication",
+  block_template: "template",
+  global_section: "global block",
+  locale_domain: "language domain",
+  locale_domains: "language domain",
+  page_seo: "SEO settings",
+  email_settings: "email settings",
+  email_providers: "email provider",
+  media: "media file",
+  media_focus: "image focus point",
+  media_meta: "image text",
+  redirect: "redirect",
+  redirects: "redirect",
+  forms: "form",
+  form_submissions: "submission",
+  form_partials: "saved draft",
+  form_delivery_attempts: "delivery attempt",
+  translations: "translations",
+  backup: "backup",
+};
+
+export function humanizeAction(action: string | null | undefined): string {
+  if (!action) return "—";
+  const label = ACTION_LABELS[action];
+  if (label) return label;
+  return action
+    .replace(/[._-]+/g, " ")
+    .replace(/\s+/g, " ")
+    .trim()
+    .replace(/^./, (c) => c.toUpperCase());
+}
+
+export function humanizeEntity(entity: string | null | undefined): string {
+  if (!entity) return "—";
+  const label = ENTITY_LABELS[entity];
+  if (label) return label.replace(/^./, (c) => c.toUpperCase());
+  return entity.replace(/[._-]+/g, " ").replace(/^./, (c) => c.toUpperCase());
+}
+
+/** Lower-case noun for use inside a sentence, e.g. "the page". */
+export function entityNoun(entity: string | null | undefined): string {
+  if (!entity) return "record";
+  return ENTITY_LABELS[entity] ?? entity.replace(/[._-]+/g, " ").toLowerCase();
+}
+
+const isUuid = (v: string) => /^[0-9a-f]{8}-[0-9a-f]{4}-/i.test(v);
+
+function metaString(meta: Record<string, unknown>, keys: string[]): string | null {
+  for (const key of keys) {
+    const value = meta[key];
+    if (typeof value === "string" && value.trim()) return value.trim();
+    if (typeof value === "number") return String(value);
+  }
+  return null;
+}
+
+/**
+ * One sentence describing what happened, in ordinary English.
+ *
+ * Uses whatever human-friendly handle the meta payload carries (name, key,
+ * email, path) and only falls back to an identifier when nothing better exists.
+ */
+export function describeAudit(input: {
+  action: string;
+  entity?: string | null;
+  entityId?: string | null;
+  meta?: Record<string, unknown> | null;
+}): string {
+  const meta = (input.meta ?? {}) as Record<string, unknown>;
+  const existing = metaString(meta, ["summary"]);
+  if (existing) return existing;
+
+  const verb = humanizeAction(input.action);
+  const noun = entityNoun(input.entity);
+  const handle =
+    metaString(meta, ["name", "title", "email", "key", "path", "from_path", "domain", "locale"]) ??
+    (input.entityId && !isUuid(input.entityId) ? input.entityId : null);
+
+  const firstWord = noun.split(" ")[0] ?? "";
+  const alreadyNamesEntity = firstWord ? verb.toLowerCase().includes(firstWord) : false;
+  const subject = alreadyNamesEntity ? "" : ` the ${noun}`;
+  const named = handle ? ` “${handle}”` : "";
+
+  let sentence = `${verb}${subject}${named}`.replace(/\s+/g, " ").trim();
+
+  const extras: string[] = [];
+  const roles = meta["roles"];
+  if (Array.isArray(roles) && roles.length) extras.push(`roles: ${roles.join(", ")}`);
+  const to = metaString(meta, ["to_path"]);
+  if (to && input.action.startsWith("redirect")) extras.push(`now points to ${to}`);
+  const count = meta["count"] ?? meta["deleted"] ?? meta["updated"];
+  if (typeof count === "number") extras.push(`${count} item${count === 1 ? "" : "s"}`);
+  const status = metaString(meta, ["status"]);
+  if (status && input.action.startsWith("submission.status")) extras.push(`set to ${status}`);
+  const reason = metaString(meta, ["reason", "note"]);
+  if (reason) extras.push(reason);
+
+  if (extras.length) sentence += ` — ${extras.join("; ")}`;
+  if (!/[.!?]$/.test(sentence)) sentence += ".";
+  return sentence;
+}
+
+/** One sentence describing an email attempt. */
+export function describeEmail(input: {
+  status: string;
+  to: string;
+  subject?: string | null;
+  provider?: string | null;
+  purpose?: string | null;
+  error?: string | null;
+}): string {
+  const purposeLabel = humanizeEmailPurpose(input.purpose);
+  const lead = purposeLabel ? `${purposeLabel} email` : "Email";
+  const subject = input.subject ? ` “${input.subject}”` : "";
+  const via = input.provider ? ` via ${input.provider}` : "";
+  const ok = input.status === "sent" || input.status === "delivered";
+  const verb = ok ? "sent to" : "could not be sent to";
+  const tail = !ok && input.error ? ` — ${input.error}` : "";
+  return `${lead}${subject} ${verb} ${input.to}${via}${tail}.`;
+}
+
+/** Friendly names for the purposes app emails are sent for. */
+export const EMAIL_PURPOSE_LABELS: Record<string, string> = {
+  form_notification: "Form notification",
+  form_autoreply: "Form auto-reply",
+  form_test: "Form test",
+  provider_test: "Provider test",
+  password_reset: "Password reset",
+  user_invite: "New account",
+};
+
+export function humanizeEmailPurpose(purpose: string | null | undefined): string | null {
+  if (!purpose) return null;
+  return (
+    EMAIL_PURPOSE_LABELS[purpose] ??
+    purpose.replace(/[._-]+/g, " ").replace(/^./, (c) => c.toUpperCase())
+  );
+}

package/src/admin/format-log.ts

@@ -1,83 +1,18 @@
 // Turn machine action codes and JSON meta into human-readable strings for the
-// backoffice Audit and Email log views.
+// backoffice Audit and Email log views. All wording lives in `describe-log`.
 
-const ACTION_LABELS: Record<string, string> = {
-  "user.create": "Created user",
-  "user.delete": "Deleted user",
-  "user.password_reset": "Reset password",
-  "user.invite": "Invited user",
-  "role.grant": "Granted role",
-  "role.revoke": "Revoked role",
-  "role.update": "Updated role",
-  "email.settings.update": "Updated email settings",
-  "email.settings.test": "Sent test email",
-  "content.section.save": "Saved section",
-  "content.section.delete": "Deleted section",
-  "page.create": "Created page",
-  "page.update": "Updated page",
-  "page.delete": "Deleted page",
-  "page.publish": "Published page",
-  "page.unpublish": "Unpublished page",
-  "page.version.create": "Saved page version",
-  "page.version.restore": "Restored page version",
-  "template.create": "Created block template",
-  "template.update": "Updated block template",
-  "template.delete": "Deleted block template",
-  "global.section.save": "Saved global block",
-  "global.section.delete": "Deleted global block",
-  "domain.create": "Added locale domain",
-  "domain.update": "Updated locale domain",
-  "domain.delete": "Removed locale domain",
-  "seo.update": "Updated SEO",
-  "media.upload": "Uploaded media",
-  "media.delete": "Deleted media",
-  "media.import": "Imported external media",
-  "translate.run": "Ran auto-translation",
-  "form.create": "Created form",
-  "form.update": "Updated form",
-  "form.duplicate": "Duplicated form",
-  "form.soft_delete": "Moved form to bin",
-  "form.restore": "Restored form",
-  "form.purge": "Permanently deleted form",
-  "form.defaults.update": "Updated shared form defaults",
-  "auth.login": "Signed in",
-  "auth.logout": "Signed out",
-};
+export {
+  ACTION_LABELS,
+  ENTITY_LABELS,
+  describeAudit,
+  describeEmail,
+  entityNoun,
+  humanizeAction,
+  humanizeEmailPurpose,
+  humanizeEntity,
+} from "./describe-log";
 
-const ENTITY_LABELS: Record<string, string> = {
-  user: "User",
-  user_role: "Role",
-  content_section: "Section",
-  page: "Page",
-  page_version: "Page version",
-  page_publication: "Publication",
-  block_template: "Template",
-  global_section: "Global block",
-  locale_domain: "Domain",
-  page_seo: "SEO",
-  email_settings: "Email settings",
-  media: "Media",
-  redirect: "Redirect",
-  forms: "Form",
-};
-
-export function humanizeAction(action: string | null | undefined): string {
-  if (!action) return "—";
-  if (ACTION_LABELS[action]) return ACTION_LABELS[action];
-  // Fallback: turn "some.snake_case.action" into "Some snake case action".
-  return action
-    .replace(/[._-]+/g, " ")
-    .replace(/\s+/g, " ")
-    .trim()
-    .replace(/^./, (c) => c.toUpperCase());
-}
-
-export function humanizeEntity(entity: string | null | undefined): string {
-  if (!entity) return "—";
-  return (
-    ENTITY_LABELS[entity] ?? entity.replace(/[._-]+/g, " ").replace(/^./, (c) => c.toUpperCase())
-  );
-}
+import { describeAudit, humanizeEntity } from "./describe-log";
 
 function shortId(id: string): string {
   if (id.length <= 12) return id;
@@ -105,6 +40,7 @@ export function summarizeMeta(meta: unknown): string {
   if (!Object.keys(m).length) return "";
 
   const parts: string[] = [];
+  // `summary` is rendered on its own as the row's sentence — never repeat it here.
   const push = (label: string, value: unknown) => {
     if (value == null || value === "") return;
     if (typeof value === "object") {
@@ -120,7 +56,6 @@ export function summarizeMeta(meta: unknown): string {
 
   // Common well-known fields, in a nice order
   const known = [
-    ["summary", "Summary"],
     ["email", "Email"],
     ["role", "Role"],
     ["name", "Name"],
@@ -146,7 +81,7 @@ export function summarizeMeta(meta: unknown): string {
   }
   // Any remaining keys, up to 4 total extra fields
   const extras = Object.keys(m)
-    .filter((k) => !used.has(k))
+    .filter((k) => !used.has(k) && k !== "summary")
     .slice(0, 4);
   for (const k of extras) {
     push(
@@ -215,3 +150,28 @@ export function emailStatusTone(status: string | null | undefined): {
     }
   );
 }
+
+
+/**
+ * The plain-English sentence for one audit row: the stored `meta.summary`
+ * written at the time of the action, or a sentence derived from the row.
+ */
+export function auditSentence(row: {
+  action: string;
+  entity?: string | null;
+  entity_id?: string | null;
+  meta?: Record<string, unknown> | null;
+}): string {
+  return describeAudit({
+    action: row.action,
+    entity: row.entity ?? null,
+    entityId: row.entity_id ?? null,
+    meta: row.meta ?? null,
+  });
+}
+
+/** The plain-English sentence stored with an email log row, when present. */
+export function emailSentence(row: { meta?: Record<string, unknown> | null }): string {
+  const summary = row.meta?.["summary"];
+  return typeof summary === "string" ? summary : "";
+}

package/src/backoffice/AuditView.tsx

@@ -1,6 +1,7 @@
 import { Fragment, useMemo, useState } from "react";
 
 import {
+  auditSentence,
   formatAbsoluteTime,
   formatEntityRef,
   formatRelativeTime,
@@ -35,6 +36,7 @@ export function AuditView({ rows }: { rows: AuditLogRow[] }) {
         r.actor_email,
         r.action,
         humanizeAction(r.action),
+        auditSentence(r),
         r.entity,
         r.entity_id,
         JSON.stringify(r.meta ?? {}),
@@ -77,6 +79,7 @@ export function AuditView({ rows }: { rows: AuditLogRow[] }) {
           </thead>
           <tbody>
             {filtered.map((r) => {
+              const sentence = auditSentence(r);
               const summary = summarizeMeta(r.meta as never);
               const isOpen = expanded === r.id;
               return (
@@ -100,7 +103,7 @@ export function AuditView({ rows }: { rows: AuditLogRow[] }) {
                       )}
                     </td>
                     <td className="p-3">
-                      <div className="text-ink">{humanizeAction(r.action)}</div>
+                      <div className="text-ink">{sentence}</div>
                       {summary && (
                         <div className="text-[0.7rem] text-ink/60 mt-1 line-clamp-2">{summary}</div>
                       )}

package/src/backoffice/EmailLogsView.tsx

@@ -1,6 +1,12 @@
 import { Fragment, useMemo, useState } from "react";
 
-import { emailStatusTone, formatAbsoluteTime, formatRelativeTime } from "../admin/format-log";
+import {
+  emailSentence,
+  emailStatusTone,
+  formatAbsoluteTime,
+  formatRelativeTime,
+  humanizeEmailPurpose,
+} from "../admin/format-log";
 
 /** One outgoing email attempt. */
 export type EmailLogRow = {
@@ -33,7 +39,17 @@ export function EmailLogsView({ rows }: { rows: EmailLogRow[] }) {
     return rows.filter((r) => {
       if (status !== "all" && r.status !== status) return false;
       if (!s) return true;
-      const hay = [r.to_address, r.from_address, r.subject, r.provider, r.error]
+      const hay = [
+        r.to_address,
+        r.from_address,
+        r.subject,
+        r.provider,
+        r.error,
+        emailSentence(r),
+        humanizeEmailPurpose(
+          typeof r.meta?.["purpose"] === "string" ? (r.meta["purpose"] as string) : null,
+        ),
+      ]
         .filter(Boolean)
         .join(" ")
         .toLowerCase();
@@ -88,6 +104,10 @@ export function EmailLogsView({ rows }: { rows: EmailLogRow[] }) {
           <tbody>
             {filtered.map((r) => {
               const tone = emailStatusTone(r.status);
+              const purpose = humanizeEmailPurpose(
+                typeof r.meta?.["purpose"] === "string" ? (r.meta["purpose"] as string) : null,
+              );
+              const sentence = emailSentence(r);
               const isOpen = expanded === r.id;
               return (
                 <Fragment key={r.id}>
@@ -109,6 +129,11 @@ export function EmailLogsView({ rows }: { rows: EmailLogRow[] }) {
                     </td>
                     <td className="p-3">
                       <div className="text-ink">{r.subject ?? "(no subject)"}</div>
+                      {purpose && (
+                        <div className="text-[0.65rem] uppercase tracking-[0.15em] text-ink/50 mt-1">
+                          {purpose}
+                        </div>
+                      )}
                       {r.body_preview && (
                         <div className="text-[0.7rem] text-ink/50 mt-1 line-clamp-1">
                           {r.body_preview}
@@ -133,6 +158,7 @@ export function EmailLogsView({ rows }: { rows: EmailLogRow[] }) {
                   {isOpen && (
                     <tr className="bg-ink/[0.02] border-t border-ink/10">
                       <td colSpan={6} className="p-4 space-y-3 text-xs">
+                        {sentence && <p className="text-ink/80">{sentence}</p>}
                         <dl className="grid grid-cols-1 md:grid-cols-2 gap-x-8 gap-y-2">
                           <DetailRow label="To" value={r.to_address} />
                           <DetailRow label="From" value={r.from_address ?? "—"} />

package/src/blocks/components/FormBlock.tsx

@@ -0,0 +1,51 @@
+import { useT } from "../../i18n";
+import type { LocalizedString } from "../../i18n";
+import { ManagedForm } from "../../forms/FormRenderer";
+import type { FormProps } from "../types";
+
+const TONES: Record<string, string> = {
+  white: "bg-white text-ink",
+  paper: "bg-paper text-ink",
+  ink: "bg-ink text-paper",
+};
+
+/**
+ * Section wrapper around a managed form: optional eyebrow/title/lead plus the
+ * form itself, resolved by key from the Forms module.
+ */
+export function FormBlock({ props }: { props: FormProps }) {
+  const { t } = useT();
+  const tone = props.tone ?? "paper";
+  const dark = tone === "ink";
+  const formKey = props.formKey?.trim();
+
+  return (
+    <section id={props.anchor || undefined} className={`${TONES[tone]} py-20 md:py-28`}>
+      <div className="mx-auto w-full max-w-3xl px-6">
+        {props.eyebrow ? (
+          <div className="text-[0.7rem] uppercase tracking-[0.28em] opacity-60">
+            {t(props.eyebrow as LocalizedString)}
+          </div>
+        ) : null}
+        {props.title ? (
+          <h2 className="mt-4 font-serif text-3xl md:text-4xl whitespace-pre-line">
+            {t(props.title as LocalizedString)}
+          </h2>
+        ) : null}
+        {props.lead ? (
+          <p className="mt-4 opacity-75 whitespace-pre-line">{t(props.lead as LocalizedString)}</p>
+        ) : null}
+        <div className="mt-10">
+          {formKey ? (
+            <ManagedForm formKey={formKey} dark={dark} />
+          ) : (
+            <p className="text-sm opacity-60 whitespace-pre-line">No form selected.</p>
+          )}
+        </div>
+      </div>
+    </section>
+  );
+}
+
+export type { FormProps };
+export { FormRenderer, ManagedForm } from "../../forms/FormRenderer";

package/src/blocks/registry.tsx

@@ -12,6 +12,7 @@ import { ImageMarqueeBlock } from "./components/ImageMarqueeBlock";
 import { LinkTilesBlock } from "./components/LinkTilesBlock";
 import { CabinTabsBlock } from "./components/CabinTabsBlock";
 import { PriceTableBlock } from "./components/PriceTableBlock";
+import { FormBlock } from "./components/FormBlock";
 import type {
   BlockProps,
   FaqProps,
@@ -27,6 +28,7 @@ import type {
   LinkTilesProps,
   CabinTabsProps,
   PriceTableProps,
+  FormProps,
 } from "./types";
 import { BlockPropsProvider } from "./block-props-context";
 
@@ -309,6 +311,19 @@ export const SHARED_BLOCK_DEFS: Record<string, BlockDef> = {
     } satisfies PriceTableProps as unknown as BlockProps,
     hasInlineContent: true,
   },
+  form: {
+    type: "form",
+    label: "Form",
+    description:
+      "Renders a managed form from Backoffice \u2192 Forms. All forms share the same settings, notifications and submissions inbox.",
+    category: "content",
+    component: ({ props }) => <FormBlock props={props as FormProps} />,
+    defaultProps: {
+      formKey: "",
+      tone: "paper",
+    } satisfies FormProps as unknown as BlockProps,
+    hasInlineContent: true,
+  },
 };
 
 /**

package/src/blocks/types.ts

@@ -423,3 +423,13 @@ export type PriceTableProps = {
 
   groups?: PriceGroup[];
 };
+
+/** Props for the shared managed-form section block. */
+export type FormProps = {
+  formKey?: string;
+  eyebrow?: Partial<LocalizedString>;
+  title?: Partial<LocalizedString>;
+  lead?: Partial<LocalizedString>;
+  tone?: "white" | "paper" | "ink";
+  anchor?: string;
+};