@dxos/plugin-preview 0.8.4-main.422d1c7879 → 0.8.4-main.43cb759274

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-preview",
-  "version": "0.8.4-main.422d1c7879",
+  "version": "0.8.4-main.43cb759274",
   "description": "Preview plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -8,19 +8,58 @@
     "type": "git",
     "url": "https://github.com/dxos/dxos"
   },
-  "license": "MIT",
+  "license": "FSL-1.1-Apache-2.0",
   "author": "DXOS.org",
   "sideEffects": true,
   "type": "module",
   "imports": {
-    "#capabilities": "./src/capabilities/index.ts",
-    "#meta": "./src/meta.ts"
+    "#capabilities": {
+      "source": "./src/capabilities/index.ts",
+      "types": "./dist/types/src/capabilities/index.d.ts",
+      "default": "./dist/lib/neutral/capabilities/index.mjs"
+    },
+    "#meta": {
+      "source": "./src/meta.ts",
+      "types": "./dist/types/src/meta.d.ts",
+      "default": "./dist/lib/neutral/meta.mjs"
+    },
+    "#plugin": {
+      "source": {
+        "workerd": "./src/PreviewPlugin.workerd.ts",
+        "node": "./src/PreviewPlugin.node.ts",
+        "default": "./src/PreviewPlugin.tsx"
+      },
+      "types": "./dist/types/src/PreviewPlugin.d.ts",
+      "workerd": "./dist/lib/neutral/PreviewPlugin.workerd.mjs",
+      "node": "./dist/lib/neutral/PreviewPlugin.node.mjs",
+      "default": "./dist/lib/neutral/PreviewPlugin.mjs"
+    },
+    "#translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
+    }
   },
   "exports": {
     ".": {
       "source": "./src/index.ts",
       "types": "./dist/types/src/index.d.ts",
-      "browser": "./dist/lib/browser/index.mjs"
+      "default": "./dist/lib/neutral/index.mjs"
+    },
+    "./plugin": {
+      "source": "./src/plugin.ts",
+      "types": "./dist/types/src/plugin.d.ts",
+      "default": "./dist/lib/neutral/plugin.mjs"
+    },
+    "./testing": {
+      "source": "./src/testing.ts",
+      "types": "./dist/types/src/testing.d.ts",
+      "default": "./dist/lib/neutral/testing.mjs"
+    },
+    "./translations": {
+      "source": "./src/translations.ts",
+      "types": "./dist/types/src/translations.d.ts",
+      "default": "./dist/lib/neutral/translations.mjs"
     }
   },
   "types": "dist/types/src/index.d.ts",
@@ -29,48 +68,38 @@
     "src"
   ],
   "dependencies": {
-    "@effect-atom/atom-react": "^0.5.0",
-    "@dxos/app-framework": "0.8.4-main.422d1c7879",
-    "@dxos/async": "0.8.4-main.422d1c7879",
-    "@dxos/app-toolkit": "0.8.4-main.422d1c7879",
-    "@dxos/client": "0.8.4-main.422d1c7879",
-    "@dxos/echo": "0.8.4-main.422d1c7879",
-    "@dxos/lit-ui": "0.8.4-main.422d1c7879",
-    "@dxos/log": "0.8.4-main.422d1c7879",
-    "@dxos/effect": "0.8.4-main.422d1c7879",
-    "@dxos/keys": "0.8.4-main.422d1c7879",
-    "@dxos/operation": "0.8.4-main.422d1c7879",
-    "@dxos/plugin-attention": "0.8.4-main.422d1c7879",
-    "@dxos/plugin-client": "0.8.4-main.422d1c7879",
-    "@dxos/react-client": "0.8.4-main.422d1c7879",
-    "@dxos/react-ui": "0.8.4-main.422d1c7879",
-    "@dxos/react-ui-editor": "0.8.4-main.422d1c7879",
-    "@dxos/react-ui-form": "0.8.4-main.422d1c7879",
-    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.422d1c7879",
-    "@dxos/react-ui-table": "0.8.4-main.422d1c7879",
-    "@dxos/react-ui-mosaic": "0.8.4-main.422d1c7879",
-    "@dxos/schema": "0.8.4-main.422d1c7879",
-    "@dxos/types": "0.8.4-main.422d1c7879",
-    "@dxos/react-ui-menu": "0.8.4-main.422d1c7879",
-    "@dxos/ui-editor": "0.8.4-main.422d1c7879",
-    "@dxos/ui-theme": "0.8.4-main.422d1c7879",
-    "@dxos/util": "0.8.4-main.422d1c7879",
-    "@dxos/plugin-deck": "0.8.4-main.422d1c7879",
-    "@dxos/app-graph": "0.8.4-main.422d1c7879"
+    "@dxos/app-toolkit": "0.8.4-main.43cb759274",
+    "@dxos/app-framework": "0.8.4-main.43cb759274",
+    "@dxos/async": "0.8.4-main.43cb759274",
+    "@dxos/echo": "0.8.4-main.43cb759274",
+    "@dxos/client": "0.8.4-main.43cb759274",
+    "@dxos/echo-react": "0.8.4-main.43cb759274",
+    "@dxos/log": "0.8.4-main.43cb759274",
+    "@dxos/effect": "0.8.4-main.43cb759274",
+    "@dxos/plugin-client": "0.8.4-main.43cb759274",
+    "@dxos/keys": "0.8.4-main.43cb759274",
+    "@dxos/react-ui": "0.8.4-main.43cb759274",
+    "@dxos/react-ui-form": "0.8.4-main.43cb759274",
+    "@dxos/react-ui-syntax-highlighter": "0.8.4-main.43cb759274",
+    "@dxos/types": "0.8.4-main.43cb759274",
+    "@dxos/react-ui-mosaic": "0.8.4-main.43cb759274",
+    "@dxos/schema": "0.8.4-main.43cb759274",
+    "@dxos/ui-editor": "0.8.4-main.43cb759274",
+    "@dxos/util": "0.8.4-main.43cb759274"
   },
   "devDependencies": {
-    "effect": "3.20.0",
+    "effect": "3.21.2",
     "react": "~19.2.3",
     "react-dom": "~19.2.3",
-    "vite": "^7.1.11",
-    "@dxos/echo-db": "0.8.4-main.422d1c7879",
-    "@dxos/plugin-testing": "0.8.4-main.422d1c7879",
-    "@dxos/random": "0.8.4-main.422d1c7879",
-    "@dxos/react-ui-components": "0.8.4-main.422d1c7879",
-    "@dxos/storybook-utils": "0.8.4-main.422d1c7879"
+    "vite": "^8.0.14",
+    "@dxos/plugin-testing": "0.8.4-main.43cb759274",
+    "@dxos/random": "0.8.4-main.43cb759274",
+    "@dxos/echo-react": "0.8.4-main.43cb759274",
+    "@dxos/react-ui-components": "0.8.4-main.43cb759274",
+    "@dxos/storybook-utils": "0.8.4-main.43cb759274"
   },
   "peerDependencies": {
-    "effect": "3.20.0",
+    "effect": "3.21.2",
     "react": "~19.2.3",
     "react-dom": "~19.2.3"
   },

package/src/PreviewPlugin.node.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { Organization, Person } from '@dxos/types';
+
+import { meta } from '#meta';
+
+export const PreviewPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addSchemaModule({ schema: [Person.Person, Organization.Organization] }),
+  Plugin.make,
+);
+
+export default PreviewPlugin;

package/src/PreviewPlugin.test.ts

@@ -0,0 +1,25 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { describe, test } from 'vitest';
+
+import { ClientPlugin } from '@dxos/plugin-client/plugin';
+import { createComposerTestApp } from '@dxos/plugin-testing/harness';
+
+import { PreviewPlugin } from '#plugin';
+
+import { meta } from './meta';
+
+const moduleId = (name: string) => `${meta.id}.module.${name}`;
+
+describe('PreviewPlugin', () => {
+  test('modules activate on the expected events', { timeout: 10_000 }, async ({ expect }) => {
+    await using harness = await createComposerTestApp({
+      plugins: [ClientPlugin({}), PreviewPlugin()],
+    });
+
+    // After autoStart: schema auto-cascades from ClientPlugin.
+    expect(harness.manager.getActive()).toContain(moduleId('schema'));
+  });
+});

package/src/PreviewPlugin.tsx

@@ -8,11 +8,10 @@ import { Organization, Person } from '@dxos/types';
 
 import { PreviewPopover, ReactSurface } from '#capabilities';
 import { meta } from '#meta';
-
-import { translations } from './translations';
+import { translations } from '#translations';
 
 export const PreviewPlugin = Plugin.define(meta).pipe(
-  AppPlugin.addSchemaModule({ schema: [Person.Person, Organization.Organization], id: 'schema' }),
+  AppPlugin.addSchemaModule({ schema: [Person.Person, Organization.Organization] }),
   AppPlugin.addSurfaceModule({ activate: ReactSurface }),
   AppPlugin.addTranslationsModule({ translations }),
   Plugin.addModule({
@@ -22,3 +21,5 @@ export const PreviewPlugin = Plugin.define(meta).pipe(
   }),
   Plugin.make,
 );
+
+export default PreviewPlugin;

package/src/PreviewPlugin.workerd.ts

@@ -0,0 +1,16 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Plugin } from '@dxos/app-framework';
+import { AppPlugin } from '@dxos/app-toolkit';
+import { Organization, Person } from '@dxos/types';
+
+import { meta } from '#meta';
+
+export const PreviewPlugin = Plugin.define(meta).pipe(
+  AppPlugin.addSchemaModule({ schema: [Person.Person, Organization.Organization] }),
+  Plugin.make,
+);
+
+export default PreviewPlugin;

package/src/capabilities/preview-popover.ts

@@ -10,9 +10,9 @@ import { addEventListener } from '@dxos/async';
 import { type Client } from '@dxos/client';
 import { type Space } from '@dxos/client/echo';
 import { Obj } from '@dxos/echo';
-import { DXN } from '@dxos/keys';
+import { EID } from '@dxos/keys';
 import { log } from '@dxos/log';
-import { ClientCapabilities } from '@dxos/plugin-client/types';
+import { ClientCapabilities } from '@dxos/plugin-client';
 import { DX_ANCHOR_ACTIVATE, type DxAnchorActivate } from '@dxos/react-ui';
 import { type PreviewLinkRef, type PreviewLinkTarget } from '@dxos/ui-editor';
 
@@ -24,7 +24,7 @@ const handlePreviewLookup = async (
   { dxn, label }: PreviewLinkRef,
 ): Promise<PreviewLinkTarget | null> => {
   try {
-    const object = await defaultSpace.db.makeRef(DXN.parse(dxn)).load();
+    const object = await defaultSpace.db.makeRef(EID.parse(dxn)).load();
     return { label, object };
   } catch {
     return null;
@@ -37,6 +37,10 @@ export default Capability.makeModule(
     const capabilities = yield* Capability.Service;
 
     // TODO(wittjosiah): Factor out lookup handlers to other plugins to make not ECHO-specific.
+    // Monotonic activation token: each invocation captures its own sequence; only the
+    // most recent activation is allowed to commit popover state. Prevents a slow
+    // open (async lookup) from clobbering a later close that fires while it's in flight.
+    let activationSequence = 0;
     const handleAnchorActivate = async ({
       dxn,
       label,
@@ -45,8 +49,24 @@ export default Capability.makeModule(
       title: titleProp,
       side,
       props,
+      state,
     }: DxAnchorActivate) => {
+      const sequence = ++activationSequence;
       const { invokePromise } = capabilities.get(Capabilities.OperationInvoker);
+
+      // Explicit close: callers pass `state: false` on pointer-leave to dismiss
+      // the popover. Operation schema requires anchor + kind, so use placeholders;
+      // they're overwritten in ephemeral state but only `state` is read by the UI.
+      if (state === false) {
+        await invokePromise(LayoutOperation.UpdatePopover, {
+          variant: 'virtual',
+          anchor: trigger,
+          kind: 'base',
+          state: false,
+        });
+        return;
+      }
+
       const client = capabilities.get(ClientCapabilities.Client);
       const registry = capabilities.get(Capabilities.AtomRegistry);
       // Layout is optional: in standalone harnesses (Storybook, tests) no plugin contributes
@@ -63,8 +83,13 @@ export default Capability.makeModule(
       if (!result) {
         return;
       }
+      // A newer activation (open or close) arrived while the lookup was in flight; bail
+      // out so we don't clobber the latest state.
+      if (sequence !== activationSequence) {
+        return;
+      }
 
-      const title = titleProp ?? Obj.getLabel(result.object);
+      const title = titleProp ?? Obj.getLabel(result.object, { fallback: 'typename' });
 
       await invokePromise(LayoutOperation.UpdatePopover, {
         subjectRef: dxn,

package/src/capabilities/react-surface.tsx

@@ -8,12 +8,12 @@ import React from 'react';
 import { Capabilities, Capability } from '@dxos/app-framework';
 import { Surface } from '@dxos/app-framework/ui';
 import { AppSurface } from '@dxos/app-toolkit/ui';
-import { Obj } from '@dxos/echo';
+import { Obj, Type } from '@dxos/echo';
 import { Card } from '@dxos/react-ui';
-import { type ProjectionModel } from '@dxos/schema';
+import { Expando, type ProjectionModel } from '@dxos/schema';
 import { Organization, Person, Pipeline, Task } from '@dxos/types';
 
-import { FormCard, JsonCard, OrganizationCard, PersonCard, ProjectCard, TaskCard } from '../cards';
+import { ExpandoCard, FormCard, JsonCard, OrganizationCard, PersonCard, ProjectCard, TaskCard } from '../cards';
 
 export default Capability.makeModule(() =>
   Effect.succeed(
@@ -24,8 +24,8 @@ export default Capability.makeModule(() =>
       //
 
       Surface.create<{ subject: Person.Person }>({
-        id: 'schema-popover--contact',
-        position: 'hoist',
+        id: 'schemaPopoverContact',
+        position: 'first',
         filter: AppSurface.object(AppSurface.Card, Person.Person),
         component: ({ data, role }) => {
           return (
@@ -37,8 +37,8 @@ export default Capability.makeModule(() =>
         },
       }),
       Surface.create({
-        id: 'schema-popover--organization',
-        position: 'hoist',
+        id: 'schemaPopoverOrganization',
+        position: 'first',
         filter: AppSurface.object(AppSurface.Card, Organization.Organization),
         component: ({ data, role }) => {
           return (
@@ -50,30 +50,71 @@ export default Capability.makeModule(() =>
         },
       }),
       Surface.create({
-        id: 'schema-popover--project',
-        position: 'hoist',
+        id: 'schemaPopoverProject',
+        position: 'first',
         filter: AppSurface.object(AppSurface.Card, Pipeline.Pipeline),
         component: ({ data, role }) => {
           return <ProjectCard role={role} subject={data.subject} />;
         },
       }),
       Surface.create({
-        id: 'schema-popover--task',
-        position: 'hoist',
+        id: 'schemaPopoverTask',
+        position: 'first',
         filter: AppSurface.object(AppSurface.Card, Task.Task),
         component: ({ data, role }) => {
           return <TaskCard role={role} subject={data.subject} />;
         },
       }),
+      Surface.create<AppSurface.ObjectCardData<Expando.Expando>>({
+        id: 'schemaPopoverExpando',
+        filter: AppSurface.object(AppSurface.Card, Expando.Expando),
+        component: ({ data, role }) => {
+          return <ExpandoCard role={role} subject={data.subject} ignorePaths={data.ignorePaths} />;
+        },
+      }),
+
+      Surface.create({
+        id: 'schemaPopoverDynamicType',
+        role: 'card--content',
+        filter: (data): data is { subject: Obj.Unknown } => {
+          if (!Obj.isObject(data.subject)) {
+            return false;
+          }
+          const type = Obj.getType(data.subject);
+          if (type) {
+            return Type.getDatabase(type) != null;
+          }
+          // Obj.getType fails for database-registered schemas (DXN mismatch); fall back to typename query.
+          try {
+            const db = Obj.getDatabase(data.subject);
+            const typename = Obj.getTypename(data.subject);
+            return (
+              !!db &&
+              !!typename &&
+              db.graph.registry
+                .list()
+                .filter(Type.isType)
+                .some((t) => Type.getTypename(t) === typename)
+            );
+          } catch {
+            return false;
+          }
+        },
+        component: ({ data, role }) => {
+          // Dynamic/mutable schemas render an editable, full-layout form;
+          // FormCard handles both static and runtime schema resolution internally.
+          return <FormCard role={role} subject={data.subject} readonly={false} layout='full' />;
+        },
+      }),
 
       //
       // Fallback for any object.
       //
 
       Surface.create({
-        id: 'fallback-popover',
+        id: 'fallbackPopover',
         role: 'card--content',
-        position: 'fallback',
+        position: 'last',
         filter: (data): data is { subject: Obj.Unknown; projection?: ProjectionModel } => Obj.isObject(data.subject),
         component: ({ data, role }) => {
           return <FormCard role={role} subject={data.subject} projection={data.projection} />;
@@ -81,9 +122,9 @@ export default Capability.makeModule(() =>
       }),
 
       Surface.create({
-        id: 'fallback-json',
+        id: 'fallbackJson',
         role: 'card--content',
-        position: 'fallback',
+        position: 'last',
         filter: (data): data is Record<string, unknown> => true,
         component: ({ data }) => {
           return <JsonCard data={data} />;
@@ -92,12 +133,12 @@ export default Capability.makeModule(() =>
 
       Surface.create({
         id: 'section',
-        position: 'fallback',
+        position: 'last',
         filter: AppSurface.subject(AppSurface.Section, Obj.isObject),
         component: ({ data }) => {
           return (
-            <div role='none' className='flex w-full justify-center'>
-              <div role='none' className='pt-2 pb-2 dx-card-min-width dx-card-max-width'>
+            <div className='flex w-full justify-center'>
+              <div className='py-2 dx-card-min-width dx-card-max-width'>
                 <Card.Root>
                   <Surface.Surface type={AppSurface.Card} data={data} limit={1} />
                 </Card.Root>

package/src/cards/ExpandoCard.tsx

@@ -0,0 +1,76 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import * as Schema from 'effect/Schema';
+import React, { useCallback, useMemo } from 'react';
+
+import { type AppSurface } from '@dxos/app-toolkit/ui';
+import { Obj } from '@dxos/echo';
+import { type JsonPath, splitJsonPath } from '@dxos/effect';
+import { Card } from '@dxos/react-ui';
+import { Form } from '@dxos/react-ui-form';
+
+const schemaForValue = (value: unknown): Schema.Schema.AnyNoContext | undefined => {
+  switch (typeof value) {
+    case 'string':
+      return Schema.String;
+    case 'number':
+      return Schema.Number;
+    case 'boolean':
+      return Schema.Boolean;
+    default:
+      return undefined;
+  }
+};
+
+/**
+ * Reserved keys: `id`, plus any `~`-prefixed key (ECHO uses `~`-prefixed
+ * string keys to brand entity instances and schemas — KindId,
+ * SchemaKindId, SnapshotKindId, etc. — and the `~` namespace is reserved
+ * for that purpose). They show up in `Object.keys` but aren't user data.
+ */
+const isInternalKey = (key: string) => key === 'id' || key.startsWith('~');
+
+export const ExpandoCard = ({ subject, ignorePaths }: AppSurface.ObjectCardProps) => {
+  const schema = useMemo(() => {
+    const ignored = new Set(ignorePaths ?? []);
+    const fields: Record<string, Schema.Schema.AnyNoContext> = {};
+    for (const key of Object.keys(subject)) {
+      if (isInternalKey(key) || ignored.has(key)) {
+        continue;
+      }
+      const fieldSchema = schemaForValue((subject as any)[key]);
+      if (fieldSchema) {
+        fields[key] = fieldSchema;
+      }
+    }
+    return Schema.Struct(fields);
+  }, [subject, ignorePaths]);
+
+  const handleSave = useCallback(
+    (values: any, { changed }: { changed: Record<string, boolean> }) => {
+      const paths = Object.keys(changed).filter((path) => changed[path]);
+      Obj.update(subject, () => {
+        for (const path of paths) {
+          const value = values[path];
+          const parts = splitJsonPath(path as JsonPath);
+          Obj.setValue(subject, parts, value);
+        }
+      });
+    },
+    [subject],
+  );
+
+  return (
+    <Card.Body>
+      <Form.Root schema={schema} values={subject} autoSave onSave={handleSave}>
+        <Form.Viewport>
+          <Form.Content>
+            <Form.FieldSet />
+          </Form.Content>
+        </Form.Viewport>
+      </Form.Root>
+    </Card.Body>
+  );
+};

package/src/cards/FormCard.tsx

@@ -2,47 +2,114 @@
 // Copyright 2025 DXOS.org
 //
 
+import * as Schema from 'effect/Schema';
 import React, { useCallback, useMemo } from 'react';
 
 import { type AppSurface } from '@dxos/app-toolkit/ui';
-import { Obj } from '@dxos/echo';
+import { Obj, Type } from '@dxos/echo';
+import { useType } from '@dxos/echo-react';
+import { type AnyProperties } from '@dxos/echo/internal';
 import { type JsonPath, splitJsonPath } from '@dxos/effect';
 import { Card, useTranslation } from '@dxos/react-ui';
-import { Form, omitId } from '@dxos/react-ui-form';
+import { Form, type FormUpdateMeta, type Presentation, getFormProperties, omitId } from '@dxos/react-ui-form';
 import { type ProjectionModel } from '@dxos/schema';
-import { descriptionMessage, mx } from '@dxos/ui-theme';
 
 import { meta } from '#meta';
 
-export const FormCard = ({ subject, projection }: AppSurface.ObjectCardProps & { projection?: ProjectionModel }) => {
+export type FormCardProps = AppSurface.ObjectCardProps & {
+  projection?: ProjectionModel;
+  readonly?: boolean;
+  layout?: Presentation;
+};
+
+/**
+ * Default/fallback card for any ECHO object.
+ * Renders a `Form` against the object's schema — either the static schema
+ * from `Obj.getSchema` or, for runtime/mutable schemas, the reactive
+ * schema looked up via `useType`.
+ */
+export const FormCard = ({ subject, projection, readonly = true, layout }: FormCardProps) => {
   const { t } = useTranslation(meta.id);
-  const echoSchema = Obj.getSchema(subject);
-  const schema = useMemo(() => echoSchema && omitId(echoSchema), [echoSchema]);
-
-  const handleSave = useCallback((values: any, { changed }: { changed: Record<string, boolean> }) => {
-    const paths = Object.keys(changed).filter((path) => changed[path]);
-    Obj.change(subject, () => {
-      for (const path of paths) {
-        const value = values[path];
-        const parts = splitJsonPath(path as JsonPath);
-        Obj.setValue(subject, parts, value);
-      }
-    });
-  }, []);
-
-  if (!schema) {
-    return <p className={mx(descriptionMessage)}>{t('unable-to-create-preview.message')}</p>;
+  // Readonly cards default to the `static` presentation — plain DOM, undefined values
+  // omitted — which reads as a preview rather than a form. Editable cards keep the
+  // `compact` form layout. Callers can override either via the explicit `layout` prop.
+  const resolvedLayout: Presentation = layout ?? (readonly ? 'static' : 'compact');
+
+  // Try the static schema first; fall back to the runtime/database schema for
+  // dynamic types whose schema isn't reachable via `Obj.getSchema` (DXN mismatch).
+  const staticType = Obj.getType(subject);
+  const db = Obj.getDatabase(subject);
+  const typename = Obj.getTypename(subject);
+  const runtimeType = useType(db, staticType ? undefined : typename);
+  const schema = useMemo((): Schema.Schema.AnyNoContext | undefined => {
+    const resolvedType = runtimeType ?? staticType;
+    return resolvedType ? omitId(Type.getSchema(resolvedType)) : undefined;
+  }, [runtimeType, staticType]);
+
+  // Predict whether the form would render anything visible. Without this guard,
+  // readonly + compact mode produces an empty scrollarea when every form-renderable
+  // field is unset (e.g., a Table object whose `view`/`sizes` are FormInput-hidden
+  // and whose `name` is undefined).
+  //
+  // - In editable mode (`!readonly`), the form renders empty fields, so we only
+  //   bail when there are no form-renderable properties at all.
+  // - In readonly mode, the form hides fields with null/undefined values, so we
+  //   bail when no form-renderable property has a non-null value.
+  const hasRenderableContent = useMemo(() => {
+    if (!schema) {
+      return false;
+    }
+    const properties = getFormProperties(schema.ast);
+    if (properties.length === 0) {
+      return false;
+    }
+    if (!readonly) {
+      return true;
+    }
+    return properties.some((prop) => (subject as any)?.[prop.name] != null);
+  }, [schema, subject, readonly]);
+
+  const handleSave = useCallback(
+    (values: AnyProperties, { changed }: FormUpdateMeta<AnyProperties>) => {
+      const paths = (Object.keys(changed) as JsonPath[]).filter((path) => changed[path]);
+      Obj.update(subject, () => {
+        for (const path of paths) {
+          const parts = splitJsonPath(path);
+          const value = Obj.getValue(values as any, parts);
+          Obj.setValue(subject, parts, value);
+        }
+      });
+    },
+    [subject],
+  );
+
+  if (!schema || !hasRenderableContent) {
+    return (
+      <Card.Body>
+        <Card.Row>
+          <Card.Text variant='description'>{t('unable-to-create-preview.message')}</Card.Text>
+        </Card.Row>
+      </Card.Body>
+    );
   }
 
   return (
-    <Card.Content>
-      <Form.Root schema={schema} projection={projection} values={subject} autoSave onSave={handleSave}>
+    <Card.Body>
+      <Form.Root
+        schema={schema}
+        projection={projection}
+        values={subject}
+        readonly={readonly}
+        layout={resolvedLayout}
+        autoSave
+        onSave={handleSave}
+      >
         <Form.Viewport>
           <Form.Content>
             <Form.FieldSet />
           </Form.Content>
         </Form.Viewport>
       </Form.Root>
-    </Card.Content>
+    </Card.Body>
   );
 };