@dxos/react-ui-form 0.9.1-main.c7dcc2e112 → 0.10.0

package/dist/types/src/components/Form/Form.stories.d.ts

@@ -1,20 +1,20 @@
 import { type StoryObj } from '@storybook/react-vite';
 import * as Schema from 'effect/Schema';
 import React from 'react';
-import { Obj } from '@dxos/echo';
 import { type AnyProperties } from '@dxos/echo/internal';
+import { Person } from '../../testing';
 import { type ExcludeId } from '../../util';
 import { type FormRootProps } from './Form';
-type DefaultStoryProps<T extends AnyProperties> = {
-    schema?: Schema.Schema<T>;
-} & FormRootProps<T>;
+type StoryArgs<T extends AnyProperties> = FormRootProps<T> & {
+    json?: boolean;
+};
 declare const meta: {
     title: string;
     component: {
         <T extends AnyProperties = AnyProperties>({ children, schema, values, onSave, onCancel, ...props }: FormRootProps<T>): React.JSX.Element;
         displayName: string;
     };
-    render: <T extends AnyProperties = AnyProperties>({ schema, values: valuesProp, ...props }: DefaultStoryProps<T>) => React.JSX.Element;
+    render: <T extends AnyProperties = AnyProperties>({ schema, values: valuesProp, json, ...props }: StoryArgs<T>) => React.JSX.Element;
     decorators: import("@storybook/react").Decorator[];
     parameters: {
         layout: string;
@@ -95,66 +95,8 @@ declare const meta: {
     };
 };
 export default meta;
-type Story<T extends AnyProperties> = StoryObj<DefaultStoryProps<T>>;
-declare const PersonSchema: Schema.Schema<{
-    readonly name: string;
-    readonly ignore?: string | undefined;
-    readonly active?: boolean | undefined;
-    readonly address?: {
-        readonly street: string;
-        readonly city: string;
-        readonly state: string;
-        readonly zip: number;
-    } | undefined;
-    readonly employer?: import("@dxos/echo/internal").Ref<{
-        readonly name: string;
-    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
-    readonly tags?: readonly import("@dxos/echo/internal").Ref<{
-        readonly label: string;
-        readonly hue?: string | undefined;
-    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>[] | undefined;
-    readonly status?: "active" | "inactive" | undefined;
-    readonly notes?: string | undefined;
-    readonly location?: readonly [number, number, (number | undefined)?] | undefined;
-    readonly birthday?: string | undefined;
-    readonly meetingAt?: string | undefined;
-    readonly reminderAt?: string | undefined;
-    readonly tasks?: readonly string[] | undefined;
-    readonly locations?: readonly (readonly [number, number, (number | undefined)?])[] | undefined;
-    readonly identities?: readonly {
-        readonly type: string;
-        readonly value: string;
-    }[] | undefined;
-} & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>, {
-    readonly name: string;
-    readonly ignore?: string | undefined;
-    readonly active?: boolean | undefined;
-    readonly address?: {
-        readonly street: string;
-        readonly city: string;
-        readonly state: string;
-        readonly zip: number;
-    } | undefined;
-    readonly employer?: import("@dxos/echo/internal").Ref<{
-        readonly name: string;
-    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown> | undefined;
-    readonly tags?: readonly import("@dxos/echo/internal").Ref<{
-        readonly label: string;
-        readonly hue?: string | undefined;
-    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & Obj.Unknown>[] | undefined;
-    readonly status?: "active" | "inactive" | undefined;
-    readonly notes?: string | undefined;
-    readonly location?: readonly [number, number, (number | undefined)?] | undefined;
-    readonly birthday?: string | undefined;
-    readonly meetingAt?: string | undefined;
-    readonly reminderAt?: string | undefined;
-    readonly tasks?: readonly string[] | undefined;
-    readonly locations?: readonly (readonly [number, number, (number | undefined)?])[] | undefined;
-    readonly identities?: readonly {
-        readonly type: string;
-        readonly value: string;
-    }[] | undefined;
-} & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>, never>;
+declare const PersonSchema: Schema.Schema<Person & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>, Person & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object>, never>;
+type Story<T extends AnyProperties> = StoryObj<StoryArgs<T>>;
 /**
  * Build a data-entry surface by handing an Effect schema to `Form.Root` — the form derives its fields,
  * types, validation, and selects from the schema, so you don't hand-wire one control per property.
@@ -171,5 +113,44 @@ declare const PersonSchema: Schema.Schema<{
 export declare const Default: Story<ExcludeId<typeof PersonSchema>>;
 export declare const Readonly: Story<ExcludeId<typeof PersonSchema>>;
 export declare const Static: Story<ExcludeId<typeof PersonSchema>>;
+declare const SettingsSchema: Schema.mutable<Schema.Struct<{
+    viewMode: Schema.Literal<["preview", "readonly", "source"]>;
+    toolbar: Schema.optional<Schema.SchemaClass<boolean, boolean, never>>;
+    fontSize: Schema.optional<Schema.SchemaClass<number, number, never>>;
+}>>;
+export declare const Variants: Story<Schema.Schema.Type<typeof SettingsSchema>>;
+/**
+ * Exercises a `Ref<Text>` field carrying both `Format.TypeFormat.Markdown` and
+ * `FormInlineAnnotation` — the markdown editor should render inline rather than
+ * opening a ref picker or nested struct form.
+ */
+export declare const InlineMarkdownText: Story<any>;
 export declare const Empty: Story<ExcludeId<typeof PersonSchema>>;
+declare const DynamicFieldsSchema: Schema.mutable<Schema.Struct<{
+    query: Schema.SchemaClass<string, string, never>;
+    url: Schema.refine<string, typeof Schema.String>;
+    choice: Schema.optional<Schema.SchemaClass<string, string, never>>;
+    tag: Schema.optional<Schema.SchemaClass<string, string, never>>;
+    name: Schema.optional<Schema.SchemaClass<string, string, never>>;
+}>>;
+/**
+ * Exercises the dynamic-field annotations: `OptionsLookupAnnotation` (select options loaded from a
+ * sibling) and `AutofillAnnotation` (value derived from a sibling, gated on validity and delayed). Each
+ * runs a self-contained Effect from the current form values.
+ */
+export declare const DynamicFields: Story<Schema.Schema.Type<typeof DynamicFieldsSchema>>;
+declare const CreateFeedSchema: Schema.Union<[Schema.Struct<{
+    type: Schema.Literal<["standard-site"]>;
+    handle: Schema.SchemaClass<string, string, never>;
+    publication: Schema.SchemaClass<string, string, never>;
+}>, Schema.Struct<{
+    type: Schema.Literal<["rss"]>;
+    url: Schema.refine<string, typeof Schema.String>;
+    name: Schema.optional<Schema.SchemaClass<string, string, never>>;
+}>]>;
+/**
+ * A discriminated-union create form: selecting `type` reveals that member's fields (combobox + select for
+ * `standard-site`, URL + autofill for `rss`). Mirrors the magazine create-feed schema.
+ */
+export declare const DiscriminatedUnion: Story<Schema.Schema.Type<typeof CreateFeedSchema>>;
 //# sourceMappingURL=Form.stories.d.ts.map

package/dist/types/src/components/Form/Form.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Form.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/Form.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAgC,MAAM,OAAO,CAAC;AAErD,OAAO,EAAE,GAAG,EAAa,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUzD,OAAO,EAAE,KAAK,SAAS,EAAU,MAAM,YAAY,CAAC;AACpD,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAElD,KAAK,iBAAiB,CAAC,CAAC,SAAS,aAAa,IAAI;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAC3B,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAgDrB,QAAA,MAAM,IAAI;;;;;;aA9CY,CAAC,SAAS,aAAa,4DAI1C,iBAAiB,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiEiB,CAAC;eAE1B,IAAI;AAEnB,KAAK,KAAK,CAAC,CAAC,SAAS,aAAa,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAErE,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+FAAyB,CAAC;AAW5C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,YAAY,CAAC,CAMzD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,YAAY,CAAC,CAM1D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,YAAY,CAAC,CAMxD,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,YAAY,CAAC,CAEvD,CAAC"}
+{"version":3,"file":"Form.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/Form.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAyC,MAAM,OAAO,CAAC;AAG9D,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWzD,OAAO,EAAgB,MAAM,EAAc,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,KAAK,SAAS,EAAU,MAAM,YAAY,CAAC;AACpD,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAElD,KAAK,SAAS,CAAC,CAAC,SAAS,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAkDhF,QAAA,MAAM,IAAI;;;;;;aAhDY,CAAC,SAAS,aAAa,kEAK1C,SAAS,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEiB,CAAC;eAElB,IAAI;AAEnB,QAAA,MAAM,YAAY,kNAAyB,CAAC;AAW5C,KAAK,KAAK,CAAC,CAAC,SAAS,aAAa,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,YAAY,CAAC,CAMzD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,YAAY,CAAC,CAM1D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,YAAY,CAAC,CAMxD,CAAC;AAEF,QAAA,MAAM,cAAc;;;;GAgBnB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,cAAc,CAAC,CAgBrE,CAAC;AAoCF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,GAAG,CAKzC,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,YAAY,CAAC,CAEvD,CAAC;AAqBF,QAAA,MAAM,mBAAmB;;;;;;GAgDxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,mBAAmB,CAAC,CAK/E,CAAC;AAkEF,QAAA,MAAM,gBAAgB;;;;;;;;IAA8C,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAKjF,CAAC"}

package/dist/types/src/components/Form/Form.theme.d.ts

@@ -0,0 +1,252 @@
+import { type VariantProps } from '@dxos/ui-theme';
+/** Visual variants for {@link Form}. `settings` is the bordered two-column settings-panel look. */
+export type FormVariant = NonNullable<VariantProps<typeof formStyles>['variant']>;
+/** Non-className behavior flags, keyed by {@link FormVariant}. */
+export type FormBehavior = {
+    showDescription: boolean;
+};
+declare const formStyles: import("tailwind-variants").TVReturnType<{
+    variant: {
+        default: {};
+        settings: {
+            content: string;
+            section: string;
+            sectionHeader: string;
+            sectionTitle: string;
+            sectionDescription: string;
+            fieldSet: string;
+            field: string;
+            fieldLabel: string;
+            fieldLabelText: string;
+            fieldDescription: string;
+            fieldControl: string;
+            fieldValidation: string;
+        };
+    };
+}, {
+    viewport: string;
+    content: string;
+    section: string;
+    group: string;
+    sectionHeader: string;
+    sectionTitle: string;
+    sectionDescription: string;
+    fieldSet: string;
+    field: string;
+    fieldLabel: string;
+    fieldLabelText: string;
+    fieldDescription: string;
+    fieldControl: string;
+    fieldValidation: string;
+    actions: string;
+    submit: string;
+    fieldSetBody: string;
+    fieldSetBox: string;
+    fieldSetBoxOuter: string;
+}, undefined, {
+    variant: {
+        default: {};
+        settings: {
+            content: string;
+            section: string;
+            sectionHeader: string;
+            sectionTitle: string;
+            sectionDescription: string;
+            fieldSet: string;
+            field: string;
+            fieldLabel: string;
+            fieldLabelText: string;
+            fieldDescription: string;
+            fieldControl: string;
+            fieldValidation: string;
+        };
+    };
+}, {
+    viewport: string;
+    content: string;
+    section: string;
+    group: string;
+    sectionHeader: string;
+    sectionTitle: string;
+    sectionDescription: string;
+    fieldSet: string;
+    field: string;
+    fieldLabel: string;
+    fieldLabelText: string;
+    fieldDescription: string;
+    fieldControl: string;
+    fieldValidation: string;
+    actions: string;
+    submit: string;
+    fieldSetBody: string;
+    fieldSetBox: string;
+    fieldSetBoxOuter: string;
+}, import("tailwind-variants").TVReturnType<{
+    variant: {
+        default: {};
+        settings: {
+            content: string;
+            section: string;
+            sectionHeader: string;
+            sectionTitle: string;
+            sectionDescription: string;
+            fieldSet: string;
+            field: string;
+            fieldLabel: string;
+            fieldLabelText: string;
+            fieldDescription: string;
+            fieldControl: string;
+            fieldValidation: string;
+        };
+    };
+}, {
+    viewport: string;
+    content: string;
+    section: string;
+    group: string;
+    sectionHeader: string;
+    sectionTitle: string;
+    sectionDescription: string;
+    fieldSet: string;
+    field: string;
+    fieldLabel: string;
+    fieldLabelText: string;
+    fieldDescription: string;
+    fieldControl: string;
+    fieldValidation: string;
+    actions: string;
+    submit: string;
+    fieldSetBody: string;
+    fieldSetBox: string;
+    fieldSetBoxOuter: string;
+}, undefined, unknown, unknown, undefined>>;
+/** {@link Form} theme template: a tailwind-variants recipe (`styles`) plus non-class `behavior`. */
+export declare const formTheme: {
+    styles: import("tailwind-variants").TVReturnType<{
+        variant: {
+            default: {};
+            settings: {
+                content: string;
+                section: string;
+                sectionHeader: string;
+                sectionTitle: string;
+                sectionDescription: string;
+                fieldSet: string;
+                field: string;
+                fieldLabel: string;
+                fieldLabelText: string;
+                fieldDescription: string;
+                fieldControl: string;
+                fieldValidation: string;
+            };
+        };
+    }, {
+        viewport: string;
+        content: string;
+        section: string;
+        group: string;
+        sectionHeader: string;
+        sectionTitle: string;
+        sectionDescription: string;
+        fieldSet: string;
+        field: string;
+        fieldLabel: string;
+        fieldLabelText: string;
+        fieldDescription: string;
+        fieldControl: string;
+        fieldValidation: string;
+        actions: string;
+        submit: string;
+        fieldSetBody: string;
+        fieldSetBox: string;
+        fieldSetBoxOuter: string;
+    }, undefined, {
+        variant: {
+            default: {};
+            settings: {
+                content: string;
+                section: string;
+                sectionHeader: string;
+                sectionTitle: string;
+                sectionDescription: string;
+                fieldSet: string;
+                field: string;
+                fieldLabel: string;
+                fieldLabelText: string;
+                fieldDescription: string;
+                fieldControl: string;
+                fieldValidation: string;
+            };
+        };
+    }, {
+        viewport: string;
+        content: string;
+        section: string;
+        group: string;
+        sectionHeader: string;
+        sectionTitle: string;
+        sectionDescription: string;
+        fieldSet: string;
+        field: string;
+        fieldLabel: string;
+        fieldLabelText: string;
+        fieldDescription: string;
+        fieldControl: string;
+        fieldValidation: string;
+        actions: string;
+        submit: string;
+        fieldSetBody: string;
+        fieldSetBox: string;
+        fieldSetBoxOuter: string;
+    }, import("tailwind-variants").TVReturnType<{
+        variant: {
+            default: {};
+            settings: {
+                content: string;
+                section: string;
+                sectionHeader: string;
+                sectionTitle: string;
+                sectionDescription: string;
+                fieldSet: string;
+                field: string;
+                fieldLabel: string;
+                fieldLabelText: string;
+                fieldDescription: string;
+                fieldControl: string;
+                fieldValidation: string;
+            };
+        };
+    }, {
+        viewport: string;
+        content: string;
+        section: string;
+        group: string;
+        sectionHeader: string;
+        sectionTitle: string;
+        sectionDescription: string;
+        fieldSet: string;
+        field: string;
+        fieldLabel: string;
+        fieldLabelText: string;
+        fieldDescription: string;
+        fieldControl: string;
+        fieldValidation: string;
+        actions: string;
+        submit: string;
+        fieldSetBody: string;
+        fieldSetBox: string;
+        fieldSetBoxOuter: string;
+    }, undefined, unknown, unknown, undefined>>;
+    behavior: {
+        default: {
+            showDescription: false;
+        };
+        settings: {
+            showDescription: true;
+        };
+    };
+};
+/** Slot names of {@link formTheme.styles}, for `bridgeTv` registration. */
+export declare const formSlots: Array<keyof ReturnType<typeof formTheme.styles>>;
+export {};
+//# sourceMappingURL=Form.theme.d.ts.map

package/dist/types/src/components/Form/Form.theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.theme.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/Form.theme.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAU,MAAM,gBAAgB,CAAC;AAE3D,mGAAmG;AACnG,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAElF,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG;IAAE,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC;AAExD,QAAA,MAAM,UAAU;;QA4BV,OAAO;QACP,QAAQ;YACN,OAAO;YAGP,OAAO;YACP,aAAa;YACb,YAAY;YACZ,kBAAkB;YAElB,QAAQ;YACR,KAAK;YAML,UAAU;YACV,cAAc;YACd,gBAAgB;YAChB,YAAY;YACZ,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAOrB,CAAC;AAEH,oGAAoG;AACpG,eAAO,MAAM,SAAS;;;YA/BhB,OAAO;YACP,QAAQ;gBACN,OAAO;gBAGP,OAAO;gBACP,aAAa;gBACb,YAAY;gBACZ,kBAAkB;gBAElB,QAAQ;gBACR,KAAK;gBAML,UAAU;gBACV,cAAc;gBACd,gBAAgB;gBAChB,YAAY;gBACZ,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBtB,CAAC;AAEF,2EAA2E;AAE3E,eAAO,MAAM,SAAS,EAAsC,KAAK,CAAC,MAAM,UAAU,CAAC,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/types/src/components/Form/Form.theme.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Form.theme.test.d.ts.map

package/dist/types/src/components/Form/Form.theme.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Form.theme.test.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/Form.theme.test.ts"],"names":[],"mappings":""}

package/dist/types/src/components/Form/FormControls.d.ts

@@ -1,10 +1,11 @@
 import React, { type PropsWithChildren } from 'react';
 import { type AnyProperties } from '@dxos/echo/internal';
 import { type ColumnRootProps, type IconButtonProps, type ThemedClassName } from '@dxos/react-ui';
+import { type Merge } from '@dxos/util';
 import { type FormContextValue, type FormHandlerProps, type FormUpdateMeta } from '../../hooks';
 import { type FormFieldSetProps as NaturalFormFieldSetProps } from './FormFieldSet';
 import { type FormLayoutProps as NaturalFormLayoutProps } from './FormLayout';
-export type FormRootProps<T extends AnyProperties = AnyProperties> = PropsWithChildren<{
+export type FormRootProps<T extends AnyProperties = AnyProperties> = Merge<PropsWithChildren<{
     /**
      * Called when the form is submitted and passes validation.
      */
@@ -13,7 +14,7 @@ export type FormRootProps<T extends AnyProperties = AnyProperties> = PropsWithCh
      * Called when the form is canceled to abandon/undo any pending changes.
      */
     onCancel?: () => void;
-} & Omit<FormContextValue<T>, 'form'> & Pick<FormHandlerProps<T>, 'schema' | 'autoSave' | 'values' | 'defaultValues' | 'onValidate' | 'onValuesChanged'> & Omit<NaturalFormFieldSetProps<T>, 'schema' | 'path'>>;
+}>, Omit<FormContextValue<T>, 'form'>, Pick<FormHandlerProps<T>, 'schema' | 'autoSave' | 'values' | 'defaultValues' | 'onValidate' | 'onValuesChanged'>, Omit<NaturalFormFieldSetProps<T>, 'schema' | 'path'>>;
 export declare function FormRoot<T extends AnyProperties = AnyProperties>({ children, schema, values, onSave, onCancel, ...props }: FormRootProps<T>): React.JSX.Element;
 export declare namespace FormRoot {
     var displayName: string;
@@ -29,16 +30,16 @@ export type FormContentProps = ThemedClassName<PropsWithChildren<{}>>;
 export declare const FormContent: React.ForwardRefExoticComponent<Omit<FormContentProps, "className"> & {
     classNames?: import("@dxos/ui-types").ClassNameValue;
 } & Pick<React.HTMLAttributes<Element>, "children" | "className" | "role" | "style"> & React.RefAttributes<HTMLDivElement>>;
-export type FormFieldSetProps = ThemedClassName<NaturalFormFieldSetProps<any>>;
-export declare function FormFieldSet(props: FormFieldSetProps): React.JSX.Element;
-export declare namespace FormFieldSet {
+export type FormFieldSetControllerProps = ThemedClassName<NaturalFormFieldSetProps<any>>;
+export declare function FormFieldSetController({ classNames, ...props }: FormFieldSetControllerProps): React.JSX.Element;
+export declare namespace FormFieldSetController {
     var displayName: string;
 }
 export type FormLayoutProps = Omit<NaturalFormLayoutProps, 'schema'> & {
     schema?: NaturalFormLayoutProps['schema'];
 };
-export declare function FormLayout({ schema, ...props }: FormLayoutProps): React.JSX.Element | null;
-export declare namespace FormLayout {
+export declare function FormLayoutController({ schema, ...props }: FormLayoutProps): React.JSX.Element | null;
+export declare namespace FormLayoutController {
     var displayName: string;
 }
 export type FormActionsProps = ThemedClassName<{}>;
@@ -47,12 +48,20 @@ export declare namespace FormActions {
     var displayName: string;
 }
 export type FormSectionProps = ThemedClassName<{
-    label?: string;
+    title?: string;
     description?: string;
 }>;
 export declare const FormSection: React.ForwardRefExoticComponent<Omit<FormSectionProps, "className"> & {
     classNames?: import("@dxos/ui-types").ClassNameValue;
 } & Pick<React.HTMLAttributes<Element>, "children" | "className" | "role" | "style"> & React.RefAttributes<HTMLDivElement>>;
+export type FormGroupProps = ThemedClassName<PropsWithChildren>;
+/**
+ * A bordered card grouping related rows/controls (e.g. an entity card in a list).
+ * Layout-only and context-free — unlike `Form.FieldSet` it is not schema-driven.
+ */
+export declare const FormGroup: React.ForwardRefExoticComponent<Omit<FormGroupProps, "className"> & {
+    classNames?: import("@dxos/ui-types").ClassNameValue;
+} & Pick<React.HTMLAttributes<Element>, "children" | "className" | "role" | "style"> & React.RefAttributes<HTMLDivElement>>;
 export type FormSubmitProps = ThemedClassName<Partial<Pick<IconButtonProps, 'icon' | 'label' | 'disabled'>>>;
 export declare function FormSubmit({ classNames, label, icon, disabled }: FormSubmitProps): React.JSX.Element | null;
 export declare namespace FormSubmit {

package/dist/types/src/components/Form/FormControls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormControls.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/FormControls.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"FormControls.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/FormControls.tsx"],"names":[],"mappings":"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"}

package/dist/types/src/components/Form/FormField/FormField.d.ts

@@ -1,7 +1,7 @@
 import * as SchemaAST from 'effect/SchemaAST';
 import React from 'react';
 import { IconButtonProps } from '@dxos/react-ui';
-import { type CreateOptions, type FormFieldOptions, type RefFieldDataProps } from '#types';
+import { type FieldContext } from '#types';
 export type FormFieldProps = {
     /**
      * AST of the property to render.
@@ -16,12 +16,26 @@ export type FormFieldProps = {
      * would otherwise repeat the array's parent name.
      */
     name: string | null;
+    /**
+     * Explicit label, overriding the `title ?? capitalize(name)` derivation. Used by `ArrayField` to
+     * give scalar/ref items the array's resolved title (e.g. `Tags`) rather than re-capitalizing the
+     * raw array property name (e.g. `_tags`), since the element type carries no title of its own.
+     */
+    label?: string;
     /**
      * Path to the current object from the root. Used with nested forms.
      */
     path?: (string | number)[];
     autoFocus?: boolean;
-} & FormFieldOptions & Pick<RefFieldDataProps, 'getOptions' | 'onCreate' | 'useType'> & CreateOptions;
+    /** Whether the field is required (non-optional in the schema). Drives the label asterisk. */
+    required?: boolean;
+    /**
+     * Force a `Ref` field to render its target inline (a nested form) instead of the picker.
+     * Set by `ArrayField` for owned-ref arrays (`FormCreateAnnotation`); equivalent to
+     * `FormInlineAnnotation` but driven by the parent array rather than the element's own AST.
+     */
+    refInline?: boolean;
+} & FieldContext;
 export declare function FormField(props: FormFieldProps): React.JSX.Element | null;
 export declare namespace FormField {
     var displayName: string;

package/dist/types/src/components/Form/FormField/FormField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/FormField/FormField.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAkB,MAAM,OAAO,CAAC;AAIvC,OAAO,EAAyB,eAAe,EAAkB,MAAM,gBAAgB,CAAC;AAGxF,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAGrB,KAAK,iBAAiB,EACvB,MAAM,QAAQ,CAAC;AAmBhB,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC;IAEpB;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,gBAAgB,GAClB,IAAI,CAAC,iBAAiB,EAAE,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC,GAC9D,aAAa,CAAC;kCAEU,KAAK,EAAE,cAAc;;;;AAiM/C,eAAO,MAAM,iBAAiB,UAAW,eAAe,sBAOvD,CAAC"}
+{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/FormField/FormField.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAkB,MAAM,OAAO,CAAC;AAIvC,OAAO,EAAc,eAAe,EAAkB,MAAM,gBAAgB,CAAC;AAG7E,OAAO,EAAE,KAAK,YAAY,EAAuD,MAAM,QAAQ,CAAC;AAwBhG,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC;IAEpB;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,YAAY,CAAC;kCAES,KAAK,EAAE,cAAc;;;;AA0O/C,eAAO,MAAM,iBAAiB,UAAW,eAAe,sBAEvD,CAAC"}

package/dist/types/src/components/Form/FormField/FormFieldHeader.d.ts

@@ -0,0 +1,27 @@
+import React, { type ReactNode } from 'react';
+export type FormFieldHeaderProps = {
+    label: string;
+    /** JSON path forwarded to the label as field metadata. */
+    path?: string;
+    required?: boolean;
+    readonly?: boolean;
+    classNames?: string;
+    /** Trailing inline add affordance; omit to hide it. */
+    add?: {
+        icon?: string;
+        label: string;
+        disabled?: boolean;
+        onClick: () => void;
+    };
+    /** Extra trailing controls placed after the add affordance (e.g. a collapse toggle). */
+    actions?: ReactNode;
+    /** Header row click (e.g. toggle collapse). The add affordance stops propagation so it doesn't trigger this. */
+    onClick?: () => void;
+};
+/**
+ * Header row for a labelled group or list: a label with optional trailing controls (an inline add
+ * affordance and/or arbitrary `actions`). Shared by array/list fields ({@link ArrayField}, the view
+ * editor) and {@link FormFieldSetContainer}'s collapse header, so all group/list headers render identically.
+ */
+export declare const FormFieldHeader: ({ label, path, required, readonly, classNames, add, actions, onClick, }: FormFieldHeaderProps) => React.JSX.Element;
+//# sourceMappingURL=FormFieldHeader.d.ts.map

package/dist/types/src/components/Form/FormField/FormFieldHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFieldHeader.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/FormField/FormFieldHeader.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAK9C,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,GAAG,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAChF,wFAAwF;IACxF,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,gHAAgH;IAChH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,4EASzB,oBAAoB,sBA6BtB,CAAC"}

package/dist/types/src/components/Form/FormField/FormRow.d.ts

@@ -0,0 +1,85 @@
+import React, { Component, type PropsWithChildren, type ReactNode, type Ref } from 'react';
+import { type ThemedClassName } from '@dxos/react-ui';
+import { type FormFieldRendererProps } from '#types';
+import { type FormVariant } from '../Form.theme';
+import { type FormFieldPresentation } from './presentation';
+export type FormFieldLabelProps = ThemedClassName<{
+    /** Render a plain `<span>` instead of an input-associated `Input.Label`, for labels used outside an `Input.Root` (e.g. section/group headers). */
+    standalone?: boolean;
+    /** Class applied to the inner label text node, overriding the default size/color (e.g. `text-lg`). */
+    labelClassName?: string;
+    /** Form variant; selects the label's chrome (e.g. `settings` enlarges the text and places it in the field grid). */
+    variant?: FormVariant;
+    error?: string;
+    /**
+     * JSON path of the field this label describes (e.g. `runtime.client.storage.persistent`).
+     * Field metadata; accepted by callers but not currently rendered.
+     */
+    path?: string;
+    /**
+     * Trailing button rendered at the end of the label row (third grid column).
+     * Used by nested-object field sets to surface a collapse toggle.
+     */
+    button?: ReactNode;
+    onClick?: () => void;
+} & Pick<FormFieldRendererProps, 'label' | 'readonly' | 'required'>>;
+export declare function FormFieldLabel({ classNames, labelClassName, variant, label, error, readonly, required, standalone, button, onClick }: FormFieldLabelProps): React.JSX.Element;
+export declare namespace FormFieldLabel {
+    var displayName: string;
+}
+export type FormRowProps<T = any> = ThemedClassName<Pick<FormFieldRendererProps<T>, 'readonly' | 'label' | 'description' | 'presentation' | 'required'> & Partial<Pick<FormFieldRendererProps<T>, 'getStatus' | 'getValue' | 'jsonPath' | 'format'>> & {
+    /**
+     * Ref to the row's outer element. Enables measurement/positioning (e.g. a future virtualized
+     * field set) without forwarding through the generic component.
+     */
+    rootRef?: Ref<HTMLDivElement>;
+    /**
+     * Render the label as a standalone `<span>` (group/multi-input fields with no single associated control).
+     */
+    standalone?: boolean;
+    /**
+     * Override the read-only/`static` rendering of the value. Fields whose value is not plain text
+     * (refs, selects, markdown) supply this; the default formats scalars/dates via `formatStaticValue`.
+     * Return `null` to render nothing (e.g. an empty/unresolved value).
+     */
+    renderStatic?: (value: T | undefined) => ReactNode;
+    /**
+     * Validation/error content rendered in the validation slot. Supplied directly in action mode; in
+     * field mode it is derived from `getStatus`.
+     */
+    validation?: ReactNode;
+    /**
+     * The control. A render-prop binds to the form value (field mode: `Input.Root` validation, static
+     * rendering, value via `getValue`). Plain nodes render an arbitrary control with no value wiring
+     * (action mode, e.g. a button) — the labeled-card escape hatch for an arbitrary control.
+     *
+     * `value` is `T | undefined` because `getValue()` returns no value when the field is unset (optional
+     * schema properties, freshly-added array items); renderers default it (e.g. `{ value = '' }`).
+     */
+    children?: ReactNode | ((props: {
+        value: T | undefined;
+        presentation: FormFieldPresentation;
+    }) => ReactNode);
+}>;
+export declare function FormRow<T>({ classNames, children, readonly, presentation, label, description, jsonPath, format, required, standalone, renderStatic, validation, getStatus, getValue, rootRef }: FormRowProps<T>): React.JSX.Element | null;
+export declare namespace FormRow {
+    var displayName: string;
+}
+type FormFieldErrorState = {
+    error: Error | undefined;
+};
+type FormFieldErrorBoundaryProps = PropsWithChildren<{
+    path?: (string | number)[];
+}>;
+export declare class FormFieldErrorBoundary extends Component<FormFieldErrorBoundaryProps, FormFieldErrorState> {
+    static getDerivedStateFromError(error: Error): {
+        error: Error;
+    };
+    state: {
+        error: undefined;
+    };
+    componentDidUpdate(prevProps: FormFieldErrorBoundaryProps): void;
+    render(): string | number | bigint | boolean | React.JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | React.ReactPortal | null | undefined> | null | undefined;
+    private resetError;
+}
+//# sourceMappingURL=FormRow.d.ts.map