@dxos/react-ui-form 0.9.0 → 0.9.1-staging.ee54ba693a

package/dist/types/src/components/Form/{Layout → FormLayout}/FormLayout.stories.d.ts

@@ -8,7 +8,7 @@ import { Type } from '@dxos/echo';
  * row (see the `Linear` story). The `FormLayoutAnnotation` on this schema
  * arranges the same fields in a 2-column grid with selective spans.
  */
-declare const Flight: Type.Obj<{
+declare const Flight: Type.ObjClass<unknown, {
     readonly airline?: string | undefined;
     readonly flightNumber?: string | undefined;
     readonly origin?: string | undefined;
@@ -17,15 +17,15 @@ declare const Flight: Type.Obj<{
     readonly arriveAt?: string | undefined;
     readonly cabin?: "business" | "economy" | "first" | "premium" | undefined;
     readonly notes?: string | undefined;
-}, Schema.Struct.Fields>;
+}, {}>;
 export type Flight = Type.InstanceType<typeof Flight>;
-type StoryProps = {
+type StoryArgs = {
     schema: Schema.Schema<any>;
     template?: string;
 };
 declare const meta: {
     title: string;
-    render: ({ schema, template }: StoryProps) => React.JSX.Element;
+    render: ({ schema, template }: StoryArgs) => React.JSX.Element;
     decorators: import("@storybook/react").Decorator[];
     parameters: {
         layout: string;
@@ -106,7 +106,7 @@ declare const meta: {
     };
 };
 export default meta;
-type Story = StoryObj<StoryProps>;
+type Story = StoryObj<StoryArgs>;
 /** Baseline: no annotation, no override — `Form.FieldSet` renders linearly (one field per row). */
 export declare const Linear: Story;
 /** `Form.Layout` invoked directly with a `template` prop, bypassing any annotation. */

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormLayout.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/FormLayout/FormLayout.stories.tsx"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAoD,MAAM,OAAO,CAAC;AAEzE,OAAO,EAA2B,IAAI,EAAE,MAAM,YAAY,CAAC;AAiB3D;;;;;GAKG;AACH,QAAA,MAAM,MAAM;;;;;;;;;MAS0D,CAAC;AAEvE,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,MAAM,CAAC,CAAC;AAoFtD,KAAK,SAAS,GAAG;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAwBF,QAAA,MAAM,IAAI;;mCAtBkC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC1B,CAAC;eAEb,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;AAEjC,mGAAmG;AACnG,eAAO,MAAM,MAAM,EAAE,KAIpB,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,YAAY,EAAE,KAK1B,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,gBAAgB,EAAE,KAI9B,CAAC;AAwCF,eAAO,MAAM,eAAe,EAAE,KAE7B,CAAC;AAqCF,eAAO,MAAM,WAAW,EAAE,KAEzB,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,iBAAiB,EAAE,KAE/B,CAAC;AA0IF,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAC"}

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

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

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

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

package/dist/types/src/components/Form/FormLayout/index.d.ts

@@ -0,0 +1,3 @@
+export { FormLayout, type FormLayoutProps } from './FormLayout';
+export { type LayoutNode, LayoutParseError, parseLayout } from './parser';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/components/Form/FormLayout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/FormLayout/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,KAAK,UAAU,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/src/components/Form/FormLayout/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/FormLayout/parser.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,4CAA4C;AAC5C,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,GAC1F;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E,qBAAa,gBAAiB,SAAQ,KAAK;IAIvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM;IAH5B,QAAQ,CAAC,IAAI,sBAAsB;IACnC,YACE,OAAO,EAAE,MAAM,EACN,QAAQ,CAAC,EAAE,MAAM,YAAA,EAG3B;CACF;AAuED,0FAA0F;AAC1F,eAAO,MAAM,WAAW,aAAc,MAAM,KAAG,UA+D9C,CAAC"}

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

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

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

@@ -1,7 +1,5 @@
-export * from './fields';
-export * from './Form';
-export * from './FormFieldComponent';
-export * from './FormTooltipsContext';
 export * from './meta-tags';
-export * from './Layout';
+export * from './Form';
+export * from './FormField';
+export * from './FormFieldSet';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AAEzB,cAAc,QAAQ,CAAC;AACvB,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAE5B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/types/src/components/Form/meta-tags.d.ts

@@ -1,5 +1,4 @@
 import * as Schema from 'effect/Schema';
-import { Ref } from '@dxos/echo';
 /**
  * Form-field key for the synthetic meta-tags array spliced into property/create forms.
  *
@@ -16,15 +15,5 @@ export declare const META_TAGS_KEY = "_tags";
  * a schema for editing and drops `id`. Keyed by {@link META_TAGS_KEY} so it never collides with a
  * `tags` field the schema declares itself.
  */
-export declare const withMetaTags: (schema: Schema.Schema.AnyNoContext) => Schema.Schema<import("./Form").ExcludeId<Schema.extend<Schema.Struct<{
-    _tags: Schema.optional<Schema.Array$<Ref.RefSchema<{
-        readonly label: string;
-        readonly hue?: string | undefined;
-    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown>>>;
-}>, Schema.Schema.AnyNoContext>>, import("./Form").ExcludeId<Schema.extend<Schema.Struct<{
-    _tags: Schema.optional<Schema.Array$<Ref.RefSchema<{
-        readonly label: string;
-        readonly hue?: string | undefined;
-    } & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown>>>;
-}>, Schema.Schema.AnyNoContext>>, never>;
+export declare const withMetaTags: (schema: Schema.Schema.AnyNoContext) => Schema.Schema<Omit<any, "id">, Omit<any, "id">, never>;
 //# sourceMappingURL=meta-tags.d.ts.map

package/dist/types/src/components/Form/meta-tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta-tags.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/meta-tags.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,GAAG,EAAO,MAAM,YAAY,CAAC;AAItC;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,YAAY,WAAY,MAAM,CAAC,MAAM,CAAC,YAAY;;;;;;;;;;wCAK5D,CAAC"}
+{"version":3,"file":"meta-tags.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/meta-tags.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC;;;;GAIG;AACH,eAAO,MAAM,YAAY,WAAY,MAAM,CAAC,MAAM,CAAC,YAAY,2DAK5D,CAAC"}

package/dist/types/src/components/ObjectForm/ObjectForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectForm.d.ts","sourceRoot":"","sources":["../../../../../src/components/ObjectForm/ObjectForm.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,GAAG,EAAY,IAAI,EAAE,MAAM,YAAY,CAAC;AASjD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;IACrB,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC;CACrB,CAAC;AAeF,eAAO,MAAM,UAAU,qBAAsB,eAAe,sBA6E3D,CAAC"}
+{"version":3,"file":"ObjectForm.d.ts","sourceRoot":"","sources":["../../../../../src/components/ObjectForm/ObjectForm.tsx"],"names":[],"mappings":"AAIA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,GAAG,EAAY,IAAI,EAAE,MAAM,YAAY,CAAC;AAUjD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;IACrB,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,UAAU,qBAAsB,eAAe,sBA6E3D,CAAC"}

package/dist/types/src/components/ObjectPicker/ObjectPicker.d.ts

@@ -1,22 +1,11 @@
 import type * as Schema from 'effect/Schema';
 import React from 'react';
-import { type Palette, type ThemedClassName } from '@dxos/react-ui';
-import { type FormFieldMap } from '../Form/FormFieldComponent';
-export type RefOption = {
-    id: string;
-    label: string;
-    hue?: Palette;
-};
-export type ObjectPickerContentProps = ThemedClassName<{
+import { type ThemedClassName } from '@dxos/react-ui';
+import { type CreateOptions, type RefOption } from '#types';
+export type ObjectPickerContentProps = ThemedClassName<CreateOptions & {
     options: RefOption[];
     selectedIds?: string[];
-    createOptionLabel?: [string, {
-        ns: string | readonly string[];
-    }];
-    createOptionIcon?: string;
     createSchema?: Schema.Schema.AnyNoContext;
-    createInitialValuePath?: string;
-    createFieldMap?: FormFieldMap;
     /**
      * Persist a newly-created object given the form values. May be async (e.g.
      * to write to a database). The Promise is awaited before the inline create
@@ -25,7 +14,7 @@ export type ObjectPickerContentProps = ThemedClassName<{
      * before the picker UI re-renders.
      */
     onCreate?: (values: any) => unknown | Promise<unknown>;
-    onSelect: (id: string) => void;
+    onSelect?: (id: string) => void;
 }>;
 export declare const ObjectPicker: {
     Root: ({ children, modal, modalId: modalIdProp, open: openProp, defaultOpen, onOpenChange: propsOnOpenChange, value: valueProp, defaultValue, onValueChange: propsOnValueChange, placeholder, }: import("@dxos/react-ui-list").ComboboxRootProps) => React.JSX.Element;
@@ -42,16 +31,10 @@ export declare const ObjectPicker: {
         }): React.JSX.Element;
         displayName: string;
     };
-    Content: React.ForwardRefExoticComponent<Omit<{
+    Content: React.ForwardRefExoticComponent<Omit<CreateOptions & {
         options: RefOption[];
         selectedIds?: string[];
-        createOptionLabel?: [string, {
-            ns: string | readonly string[];
-        }];
-        createOptionIcon?: string;
         createSchema?: Schema.Schema.AnyNoContext;
-        createInitialValuePath?: string;
-        createFieldMap?: FormFieldMap;
         /**
          * Persist a newly-created object given the form values. May be async (e.g.
          * to write to a database). The Promise is awaited before the inline create
@@ -60,7 +43,7 @@ export declare const ObjectPicker: {
          * before the picker UI re-renders.
          */
         onCreate?: (values: any) => unknown | Promise<unknown>;
-        onSelect: (id: string) => void;
+        onSelect?: (id: string) => void;
     }, "className"> & {
         classNames?: import("@dxos/ui-types").ClassNameValue;
     } & React.RefAttributes<HTMLDivElement>>;

package/dist/types/src/components/ObjectPicker/ObjectPicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectPicker.d.ts","sourceRoot":"","sources":["../../../../../src/components/ObjectPicker/ObjectPicker.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAgE,MAAM,OAAO,CAAC;AAErF,OAAO,EAAE,KAAK,OAAO,EAAW,KAAK,eAAe,EAAkB,MAAM,gBAAgB,CAAC;AAO7F,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,eAAe,CAAC;IACrD,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IAC1C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,CAAC,CAAC;AA4JH,eAAO,MAAM,YAAY;IACvB,IAAI;IACJ,MAAM;;;;;;IACN,OAAO;IACP,cAAc;;;;;;IACd,OAAO;iBAjLE,SAAS,EAAE;sBACN,MAAM,EAAE;4BACF,CAAC,MAAM,EAAE;YAAE,EAAE,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;SAAE,CAAC;2BAC7C,MAAM;uBACV,MAAM,CAAC,MAAM,CAAC,YAAY;iCAChB,MAAM;yBACd,YAAY;QAC7B;;;;;;WAMG;mBACQ,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;kBAC5C,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI;;;;CAmK/B,CAAC"}
+{"version":3,"file":"ObjectPicker.d.ts","sourceRoot":"","sources":["../../../../../src/components/ObjectPicker/ObjectPicker.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAgE,MAAM,OAAO,CAAC;AAErF,OAAO,EAAW,KAAK,eAAe,EAAkB,MAAM,gBAAgB,CAAC;AAK/E,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAI5D,MAAM,MAAM,wBAAwB,GAAG,eAAe,CACpD,aAAa,GAAG;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,CACF,CAAC;AA6JF,eAAO,MAAM,YAAY;IACvB,IAAI;IACJ,MAAM;;;;;;IACN,OAAO;IACP,cAAc;;;;;;IACd,OAAO;iBA/KI,SAAS,EAAE;sBACN,MAAM,EAAE;uBACP,MAAM,CAAC,MAAM,CAAC,YAAY;QACzC;;;;;;WAMG;mBACQ,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;mBAC3C,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI;;;;CAqKlC,CAAC"}

package/dist/types/src/components/ObjectProperties/ObjectProperties.d.ts

@@ -1,8 +1,9 @@
 import React, { type PropsWithChildren } from 'react';
 import { Obj } from '@dxos/echo';
+import { type RefFieldDataProps } from '#types';
 export type ObjectPropertiesProps = PropsWithChildren<{
     object: Obj.Unknown;
-}>;
+} & Pick<RefFieldDataProps, 'getCreateDefaults' | 'resolveCreateEntry'>>;
 export declare const ObjectProperties: React.ForwardRefExoticComponent<Omit<ObjectPropertiesProps, "className"> & {
     classNames?: import("@dxos/ui-types").ClassNameValue;
 } & Pick<React.HTMLAttributes<Element>, "children" | "className" | "role" | "style"> & React.RefAttributes<HTMLDivElement>>;

package/dist/types/src/components/ObjectProperties/ObjectProperties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObjectProperties.d.ts","sourceRoot":"","sources":["../../../../../src/components/ObjectProperties/ObjectProperties.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAwB,MAAM,OAAO,CAAC;AAE5E,OAAO,EAAE,GAAG,EAAkB,MAAM,YAAY,CAAC;AAYjD,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;IAAE,MAAM,EAAE,GAAG,CAAC,OAAO,CAAA;CAAE,CAAC,CAAC;AAG/E,eAAO,MAAM,gBAAgB;;2HA6G5B,CAAC"}
+{"version":3,"file":"ObjectProperties.d.ts","sourceRoot":"","sources":["../../../../../src/components/ObjectProperties/ObjectProperties.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAwB,MAAM,OAAO,CAAC;AAE5E,OAAO,EAAE,GAAG,EAAkB,MAAM,YAAY,CAAC;AASjD,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAInE,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CACnD;IAAE,MAAM,EAAE,GAAG,CAAC,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,iBAAiB,EAAE,mBAAmB,GAAG,oBAAoB,CAAC,CAC9F,CAAC;AAGF,eAAO,MAAM,gBAAgB;;2HA+G5B,CAAC"}

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

@@ -1,10 +1,10 @@
 import { type StoryObj } from '@storybook/react-vite';
 import React from 'react';
 import { type RefEditorProps } from './RefEditor';
-type StoryProps = Partial<Pick<RefEditorProps, 'value' | 'mode' | 'activateOnTyping' | 'autoFocus'>>;
+type StoryArgs = Partial<Pick<RefEditorProps, 'value' | 'mode' | 'activateOnTyping' | 'autoFocus'>>;
 declare const meta: {
     title: string;
-    render: ({ value: initialValue, ...args }: StoryProps) => React.JSX.Element;
+    render: ({ value: initialValue, ...args }: StoryArgs) => React.JSX.Element;
     decorators: import("@storybook/react").Decorator[];
     parameters: {
         translations: [{

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

@@ -1 +1 @@
-{"version":3,"file":"RefEditor.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/RefEditor/RefEditor.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA6B,MAAM,OAAO,CAAC;AAclD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAoD7D,KAAK,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,kBAAkB,GAAG,WAAW,CAAC,CAAC,CAAC;AA2BrG,QAAA,MAAM,IAAI;;+CAvB8C,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC7B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAK9B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAMvB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAIvB,CAAC"}
+{"version":3,"file":"RefEditor.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/RefEditor/RefEditor.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAA6B,MAAM,OAAO,CAAC;AAclD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAoD7D,KAAK,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,kBAAkB,GAAG,WAAW,CAAC,CAAC,CAAC;AA0BpG,QAAA,MAAM,IAAI;;+CAtB8C,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC5B,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAK9B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAMvB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,KAIvB,CAAC"}

package/dist/types/src/components/ViewEditor/ViewEditor.d.ts

@@ -14,7 +14,7 @@ export type ViewEditorProps = ThemedClassName<{
     onDelete?: (fieldId: string) => void;
 } & Pick<QueryFormProps, 'types' | 'tags'> & Pick<FormRootProps<any>, 'readonly' | 'db'>>;
 /**
- * Schema-based object form.
+ * View editor form.
  */
 export declare const ViewEditor: React.ForwardRefExoticComponent<Omit<{
     type?: Type.AnyEntity;

package/dist/types/src/components/ViewEditor/ViewEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ViewEditor.d.ts","sourceRoot":"","sources":["../../../../../src/components/ViewEditor/ViewEditor.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAsF,MAAM,OAAO,CAAC;AAE3G,OAAO,EAEL,GAAG,EAOH,QAAQ,EAER,KAAK,QAAQ,EACb,IAAI,EACJ,IAAI,EACL,MAAM,YAAY,CAAC;AAIpB,OAAO,EAA8B,KAAK,eAAe,EAAkB,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,EAEL,eAAe,EAIhB,MAAM,cAAc,CAAC;AAMtB,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,eAAe,GAAG,eAAe,CAC3C;IACE,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;IACtB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC;IACnE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,CAAC,GACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,CAC9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU;WAdZ,IAAI,CAAC,SAAS;UACf,IAAI,CAAC,IAAI;WACR,QAAQ,GAAG,KAAK;eACZ,QAAQ,CAAC,QAAQ;kBACd,OAAO;qBACJ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,IAAI;eACvD,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;;;gDA0LvC,CAAC"}
+{"version":3,"file":"ViewEditor.d.ts","sourceRoot":"","sources":["../../../../../src/components/ViewEditor/ViewEditor.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAsF,MAAM,OAAO,CAAC;AAE3G,OAAO,EAEL,GAAG,EAOH,QAAQ,EAER,KAAK,QAAQ,EACb,IAAI,EACJ,IAAI,EACL,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAkB,KAAK,eAAe,EAAoC,MAAM,gBAAgB,CAAC;AACxG,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,EAEL,eAAe,EAIhB,MAAM,cAAc,CAAC;AAOtB,OAAO,EAA4D,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAEvG,MAAM,MAAM,eAAe,GAAG,eAAe,CAC3C;IACE,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;IACtB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC;IACnE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,CAAC,GACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,CAC9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU;WAdZ,IAAI,CAAC,SAAS;UACf,IAAI,CAAC,IAAI;WACR,QAAQ,GAAG,KAAK;eACZ,QAAQ,CAAC,QAAQ;kBACd,OAAO;qBACJ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,IAAI;eACvD,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;;;gDA2LvC,CAAC"}

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

@@ -8,10 +8,10 @@ export type ViewEditorDebugObjects = {
     view: View.View;
     projection: ProjectionModel;
 };
-type DefaultStoryProps = Pick<ViewEditorProps, 'readonly' | 'mode'>;
+type StoryArgs = Pick<ViewEditorProps, 'readonly' | 'mode'>;
 declare const meta: {
     title: string;
-    render: (props: DefaultStoryProps) => React.JSX.Element;
+    render: (props: StoryArgs) => React.JSX.Element;
     decorators: import("@storybook/react").Decorator[];
     parameters: {
         layout: string;

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

@@ -1 +1 @@
-{"version":3,"file":"ViewEditor.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/ViewEditor/ViewEditor.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,OAAO,EAAuE,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAOlH,OAAO,EAAE,KAAK,eAAe,EAAkC,MAAM,cAAc,CAAC;AAMpF,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAWhE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;IACrB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;CAC7B,CAAC;AAEF,KAAK,iBAAiB,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC;AAsHpE,QAAA,MAAM,IAAI;;oBApHmB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwIT,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,QAAQ,EAAE,KAItB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAI1B,CAAC"}
+{"version":3,"file":"ViewEditor.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/ViewEditor/ViewEditor.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,OAAO,EAAuE,IAAI,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAOlH,OAAO,EAAE,KAAK,eAAe,EAAkC,MAAM,cAAc,CAAC;AAMpF,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAUhE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;IACrB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;CAC7B,CAAC;AAEF,KAAK,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC;AAsH5D,QAAA,MAAM,IAAI;;oBApHmB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwID,CAAC;eAEvB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AAEjC,eAAO,MAAM,QAAQ,EAAE,KAItB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAI1B,CAAC"}

package/dist/types/src/components/index.d.ts

@@ -5,6 +5,5 @@ export * from './ObjectPicker';
 export * from './ObjectProperties';
 export * from './ObjectTree';
 export * from './RefEditor';
-export * from './Settings';
 export * from './ViewEditor';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":"AAIA,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/index.ts"],"names":[],"mappings":"AAIA,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/types/src/hooks/index.d.ts

@@ -1,3 +1,5 @@
+export * from './useAsyncFieldEffect';
+export * from './useFormContext';
 export * from './useFormHandler';
 export * from './useKeyHandler';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/types/src/hooks/useAsyncFieldEffect.d.ts

@@ -0,0 +1,24 @@
+import * as Effect from 'effect/Effect';
+import { type AnyProperties } from '@dxos/echo/internal';
+/** Picks the declared dependency fields from the form values — the subset a dynamic field subscribes to. */
+export declare const pickValues: (values: AnyProperties | undefined, deps: readonly string[]) => Record<string, unknown>;
+export type AsyncFieldEffectState<A> = {
+    loading: boolean;
+    error: unknown;
+    data: A | undefined;
+};
+export type UseAsyncFieldEffectOptions = {
+    /** Debounce applied before running, so per-keystroke value changes coalesce into one run. */
+    debounceMs?: number;
+    /** When false, the effect is not run and prior data/error is cleared. */
+    enabled?: boolean;
+};
+/**
+ * Runs a self-contained Effect (`R = never`) whenever `key` changes, debounced and abortable. Used by
+ * dynamic form fields to load select options, derive values, or validate against an external source from
+ * the current form values. The latest `factory` is always used, but a run is only (re)triggered when
+ * `key` changes — derive `key` from the inputs the factory actually reads. Re-running interrupts the
+ * prior run (cancelling any in-flight request).
+ */
+export declare const useAsyncFieldEffect: <A>(factory: () => Effect.Effect<A, unknown>, key: string, { debounceMs, enabled }?: UseAsyncFieldEffectOptions) => AsyncFieldEffectState<A>;
+//# sourceMappingURL=useAsyncFieldEffect.d.ts.map

package/dist/types/src/hooks/useAsyncFieldEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncFieldEffect.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useAsyncFieldEffect.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,4GAA4G;AAC5G,eAAO,MAAM,UAAU,WAAY,aAAa,GAAG,SAAS,QAAQ,SAAS,MAAM,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAM7G,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,6FAA6F;IAC7F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,WAC1B,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,OACnC,MAAM,4BAC2B,0BAA0B,KAC/D,qBAAqB,CAAC,CAAC,CAoCzB,CAAC"}

package/dist/types/src/hooks/useFormContext.d.ts

@@ -0,0 +1,42 @@
+import { type AnyProperties } from '@dxos/echo/internal';
+import { type FieldContext, type FormFieldStateProps } from '#types';
+import { type FormVariant } from '../components/Form/Form.theme';
+import { type FormHandler } from './useFormHandler';
+export type FormContextValue<T extends AnyProperties = any> = {
+    /**
+     * Form handler.
+     */
+    form: FormHandler<T>;
+    /**
+     * Testing.
+     */
+    testId?: string;
+    /** Visual variant applied across the form's parts (see Form.theme). */
+    variant?: FormVariant;
+} & FieldContext;
+export declare const FormContextProvider: import("react").FC<{
+    /**
+     * Form handler.
+     */
+    form: FormHandler<any>;
+    /**
+     * Testing.
+     */
+    testId?: string;
+    /** Visual variant applied across the form's parts (see Form.theme). */
+    variant?: FormVariant;
+} & import("#types").FormFieldOptions & import("#types").CreateOptions & import("#types").RefThreadedProps & {
+    children: React.ReactNode;
+}>, useFormContext: (consumerName: string) => FormContextValue<any>;
+/**
+ * Get the current form values.
+ */
+export declare const useFormValues: {
+    <T extends AnyProperties>(componentName: string, path?: (string | number)[]): T;
+    <T extends AnyProperties>(componentName: string, path: (string | number)[] | undefined, defaultValue: () => T): T | undefined;
+};
+/**
+ * Get the state props for the given field.
+ */
+export declare const useFormFieldState: (componentName: string, path?: (string | number)[]) => FormFieldStateProps;
+//# sourceMappingURL=useFormContext.d.ts.map

package/dist/types/src/hooks/useFormContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormContext.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useFormContext.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,aAAa,GAAG,GAAG,IAAI;IAC5D;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uEAAuE;IACvE,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,GAAG,YAAY,CAAC;AAEjB,eAAO,MAAO,mBAAmB;IAd/B;;OAEG;;IAGH;;OAEG;aACM,MAAM;IAEf,uEAAuE;cAC7D,WAAW;;;IAGY,cAAc,iDAA2C,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE;IAC1B,CAAC,CAAC,SAAS,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IAChF,CAAC,CAAC,SAAS,aAAa,EACtB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,EACrC,YAAY,EAAE,MAAM,CAAC,GACpB,CAAC,GAAG,SAAS,CAAC;CAsBlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,kBAAmB,MAAM,SAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAQ,mBAezF,CAAC"}

package/dist/types/src/hooks/useFormHandler.d.ts

@@ -4,10 +4,7 @@ import { type AnyProperties } from '@dxos/echo/internal';
 import { SchemaEx } from '@dxos/effect';
 import { type ValidationError } from '@dxos/schema';
 import { type MaybePromise } from '@dxos/util';
-export type FormFieldStatus = {
-    status?: 'error';
-    error?: string;
-};
+import { type FormFieldStatus } from '#types';
 /**
  * Form properties.
  */
@@ -59,13 +56,19 @@ export type FormUpdateMeta<T extends AnyProperties> = {
 export type FormHandler<T extends AnyProperties> = Pick<FormHandlerProps<T>, 'schema' | 'autoSave'> & {
     /** Initial values (which may not pass validation). */
     values: Partial<T>;
-    /** Map of changed fields. */
+    /** Fields whose value has been edited (set by `onValueChange`). Gates autosave-on-blur. */
     changed: Record<SchemaEx.JsonPath, boolean>;
+    /** Fields the user has interacted with (set by `onBlur`). Gates error *visibility* — errors only surface once touched. */
     touched: Record<SchemaEx.JsonPath, boolean>;
     /** Map of error strings. */
     errors: Record<SchemaEx.JsonPath, string>;
-    /** Whether the form can be saved (i.e., data is valid). */
+    /** Whether the values pass validation (no errors at all). */
     isValid: boolean;
+    /**
+     * Whether the submit affordance should be enabled. Stricter than `isValid`: it also requires no save
+     * in flight (`saving`) and only blocks on errors for *touched* fields, so a pristine form with
+     * not-yet-touched required fields can still show an enabled control.
+     */
     canSave: boolean;
     onSave: () => void;
     onCancel: () => void;

package/dist/types/src/hooks/useFormHandler.d.ts.map

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

package/dist/types/src/index.d.ts

@@ -1,4 +1,6 @@
+export * from './annotations';
 export * from './components';
 export * from './hooks';
+export * from './types';
 export * from './util';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC"}

package/dist/types/src/{components/testing.d.ts → testing/TestLayout.d.ts}

@@ -1,6 +1,6 @@
 import React, { type PropsWithChildren } from 'react';
 type TestLayoutProps = PropsWithChildren<{
-    json?: any;
+    json?: unknown;
 }>;
 export declare const TestLayout: ({ children, json }: TestLayoutProps) => React.JSX.Element;
 export declare const TestPanel: React.ForwardRefExoticComponent<Omit<Omit<{
@@ -16,4 +16,4 @@ export declare const VIEW_EDITOR_DEBUG_SYMBOL: unique symbol;
 export declare const FIELD_EDITOR_DEBUG_SYMBOL: unique symbol;
 export declare const OBJECT_PROPERTIES_DEBUG_SYMBOL: unique symbol;
 export {};
-//# sourceMappingURL=testing.d.ts.map
+//# sourceMappingURL=TestLayout.d.ts.map

package/dist/types/src/testing/TestLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestLayout.d.ts","sourceRoot":"","sources":["../../../../src/testing/TestLayout.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAOtD,KAAK,eAAe,GAAG,iBAAiB,CAAC;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE7D,eAAO,MAAM,UAAU,uBAAwB,eAAe,sBAkB7D,CAAC;AAIF,eAAO,MAAM,SAAS;;;;;;;;2HAMpB,CAAC;AAGH,eAAO,MAAM,wBAAwB,eAA4B,CAAC;AAClE,eAAO,MAAM,yBAAyB,eAA6B,CAAC;AACpE,eAAO,MAAM,8BAA8B,eAAkC,CAAC"}

package/dist/types/src/testing/index.d.ts

@@ -0,0 +1,3 @@
+export * from './schema';
+export * from './TestLayout';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAIA,cAAc,UAAU,CAAC;AAEzB,cAAc,cAAc,CAAC"}

package/dist/types/src/testing/schema.d.ts

@@ -0,0 +1,40 @@
+import { Tag, Type } from '@dxos/echo';
+declare const Organization_base: Type.ObjClass<Organization, {
+    readonly name: string;
+}, {}>;
+/**
+ * Shared test schemas for form stories. Intentionally small, hand-written types
+ * (not `@dxos/types`) exercising the range of field renderers: scalars, nested
+ * structs, refs, ref arrays, enums, and the various formats.
+ */
+export declare class Organization extends Organization_base {
+}
+declare const Person_base: Type.ObjClass<Person, {
+    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<Organization & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/Obj").Unknown> | undefined;
+    readonly tags?: readonly import("@dxos/echo/internal").Ref<Tag.Tag & import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & import("@dxos/echo/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;
+}, {}>;
+export declare class Person extends Person_base {
+}
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/types/src/testing/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/testing/schema.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgC,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;;;;AAErE;;;;GAIG;AAEH,qBAAa,YAAa,SAAQ,iBAIjC;CAAG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEJ,qBAAa,MAAO,SAAQ,WAsC3B;CAAG"}