From 1766c75af83fa0119d7d88ebc1bdc37141cc8a9c Mon Sep 17 00:00:00 2001
From: Jack Zhuang <277994282+os-zhuang@users.noreply.github.com>
Date: Tue, 30 Jun 2026 18:13:41 +0800
Subject: [PATCH] fix(plugin-detail): declare designer inputs for record:*
 blocks (spec conformance)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The record:details/related_list/highlights/path blocks registered ZERO inputs —
the designer couldn't configure them and the spec↔frontend conformance check
flagged 17 spec-only divergences. Add inputs mirroring @objectstack/spec
RecordDetailsProps / RecordRelatedListProps / RecordHighlightsProps /
RecordPathProps. Verified via a live manifest dump: record:* now 17 matched / 0
spec-only.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .changeset/record-block-inputs.md    | 11 +++++++++++
 packages/plugin-detail/src/index.tsx | 29 ++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+)
 create mode 100644 .changeset/record-block-inputs.md

diff --git a/.changeset/record-block-inputs.md b/.changeset/record-block-inputs.md
new file mode 100644
index 0000000000..3510e2fbb0
--- /dev/null
+++ b/.changeset/record-block-inputs.md
@@ -0,0 +1,11 @@
+---
+"@object-ui/plugin-detail": minor
+---
+
+Declare designer inputs for the `record:*` blocks (details, related_list,
+highlights, path) so they conform to the spec protocol (RecordDetailsProps /
+RecordRelatedListProps / RecordHighlightsProps / RecordPathProps in
+@objectstack/spec component.zod). They previously registered ZERO inputs — the
+visual designer could not configure them, and the spec↔frontend conformance
+check flagged 17 spec-only divergences. Now each block's inputs mirror its spec
+schema (columns/layout/sections/fields, etc.).
diff --git a/packages/plugin-detail/src/index.tsx b/packages/plugin-detail/src/index.tsx
index 3c3da60b6c..679b893fe2 100644
--- a/packages/plugin-detail/src/index.tsx
+++ b/packages/plugin-detail/src/index.tsx
@@ -218,6 +218,13 @@ ComponentRegistry.register('record:details', RecordDetailsRenderer, {
   category: 'record',
   label: 'Record Details',
   icon: 'FileText',
+  // Designer inputs mirror @objectstack/spec RecordDetailsProps (component.zod).
+  inputs: [
+    { name: 'columns', type: 'enum', label: 'Columns', enum: ['1', '2', '3', '4'], defaultValue: '2', description: 'Number of columns for field layout (1-4)' },
+    { name: 'layout', type: 'enum', label: 'Layout', enum: ['auto', 'custom'], defaultValue: 'auto', description: 'auto uses the object compactLayout; custom uses explicit sections' },
+    { name: 'sections', type: 'array', label: 'Sections', description: 'Section IDs to show (required when layout is "custom")' },
+    { name: 'fields', type: 'array', label: 'Fields', description: 'Explicit field list (overrides compactLayout)' },
+  ],
 });
 
 ComponentRegistry.register('record:related_list', RecordRelatedListRenderer, {
@@ -225,6 +232,18 @@ ComponentRegistry.register('record:related_list', RecordRelatedListRenderer, {
   category: 'record',
   label: 'Related List',
   icon: 'List',
+  // Mirrors @objectstack/spec RecordRelatedListProps.
+  inputs: [
+    { name: 'objectName', type: 'string', label: 'Related Object', required: true, description: 'Related object name (e.g. "task")' },
+    { name: 'relationshipField', type: 'string', label: 'Relationship Field', required: true, description: 'Field on the related object pointing back to this record' },
+    { name: 'columns', type: 'array', label: 'Columns', required: true, description: 'Fields to display in the related list' },
+    { name: 'sort', type: 'array', label: 'Sort' },
+    { name: 'limit', type: 'number', label: 'Limit', defaultValue: 5, description: 'Records to display initially' },
+    { name: 'filter', type: 'array', label: 'Filter', description: 'Additional filter criteria' },
+    { name: 'title', type: 'string', label: 'Title' },
+    { name: 'showViewAll', type: 'boolean', label: 'Show "View All"', defaultValue: true },
+    { name: 'actions', type: 'array', label: 'Actions', description: 'Action IDs available for related records' },
+  ],
 });
 
 ComponentRegistry.register('record:highlights', RecordHighlightsRenderer, {
@@ -232,6 +251,11 @@ ComponentRegistry.register('record:highlights', RecordHighlightsRenderer, {
   category: 'record',
   label: 'Highlights Panel',
   icon: 'Star',
+  // Mirrors @objectstack/spec RecordHighlightsProps.
+  inputs: [
+    { name: 'fields', type: 'array', label: 'Fields', required: true, description: 'Key fields to highlight (1-7), bare names or {name,label?,icon?,type?}' },
+    { name: 'layout', type: 'enum', label: 'Layout', enum: ['horizontal', 'vertical'], defaultValue: 'horizontal', description: 'Layout orientation for highlight fields' },
+  ],
 });
 
 ComponentRegistry.register('record:activity', RecordActivityRenderer, {
@@ -265,6 +289,11 @@ ComponentRegistry.register('record:path', RecordPathRenderer, {
   category: 'record',
   label: 'Path / Stepper',
   icon: 'GitBranch',
+  // Mirrors @objectstack/spec RecordPathProps.
+  inputs: [
+    { name: 'statusField', type: 'string', label: 'Status Field', required: true, description: 'Field representing the current status/stage' },
+    { name: 'stages', type: 'array', label: 'Stages', description: 'Explicit stage definitions [{ value, label }] (else derived from field metadata)' },
+  ],
 });
 
 ComponentRegistry.register('record:quick_actions', RecordQuickActionsRenderer, {