@object-ui/app-shell 6.2.3 → 7.1.0

package/dist/views/metadata-admin/SchemaForm.d.ts

@@ -1,3 +1,32 @@
+/**
+ * SchemaForm — minimal JSONSchema-driven form (Phase 3c).
+ *
+ * The framework's `/meta/types` endpoint returns a `schema` field per
+ * type, generated from Zod via `zod-to-json-schema`. We render that
+ * schema as a form so admins can edit *any* metadata type without
+ * the platform having to write a bespoke editor for each.
+ *
+ * Scope (MVP):
+ *   • string  → Input (or Textarea if `format: 'multiline'`)
+ *   • number  → Input type="number"
+ *   • boolean → Switch
+ *   • enum    → Select
+ *   • array of strings → tag editor (comma-separated for MVP)
+ *   • object  → recursive collapsed section
+ *   • anyOf / oneOf / unknown → JSON textarea fallback
+ *
+ * NOT covered (yet) — those types use bespoke editors registered via
+ * `registerMetadataResource()`:
+ *   • Permission matrix (rows × columns × actions)
+ *   • Object/Field designers
+ *   • View / dashboard / page canvas designers
+ *
+ * Error display:
+ *   • Pass `issues` in the shape `[{ path: 'a.b', message: '...' }, ...]`
+ *     to render inline error chips next to the offending fields.
+ *   • Matches the framework's `error.issues` envelope from `sendError`.
+ */
+import * as React from 'react';
 import { type WidgetContext } from './widgets';
 type JsonSchema = Record<string, any>;
 /**
@@ -51,6 +80,10 @@ export interface FormFieldSpec {
     hidden?: boolean;
     colSpan?: 1 | 2 | 3 | 4;
     widget?: string;
+    /** Composite rendering: 'inline' (default, bordered box) or 'popover'
+     * (summary line + gear that opens the sub-fields in a popover — Airtable
+     * progressive disclosure, keeps the panel lean). */
+    disclosure?: 'inline' | 'popover';
     /** For `type: 'code'` — syntax highlighting language (e.g. 'javascript', 'sql', 'json'). */
     language?: string;
     visibleOn?: string | {
@@ -95,5 +128,5 @@ export interface SchemaFormProps {
     /** Out-of-band data widgets need (object list, etc). */
     widgetContext?: WidgetContext;
 }
-export declare function SchemaForm({ schema, form, value, onChange, issues, hiddenFields, fieldOrder, readOnly, createMode, widgetContext, }: SchemaFormProps): import("react/jsx-runtime").JSX.Element;
+export declare function SchemaForm({ schema, form, value, onChange, issues, hiddenFields, fieldOrder, readOnly, createMode, widgetContext, }: SchemaFormProps): React.JSX.Element;
 export {};