@dxos/react-ui-form 0.8.4-main.d05539e30a → 0.8.4-main.d9fc60f731

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

@@ -1,14 +1,13 @@
 import { type StoryObj } from '@storybook/react-vite';
 import * as Schema from 'effect/Schema';
 import React from 'react';
-import { Type } from '@dxos/echo';
+import { Obj, Type } from '@dxos/echo';
 import { type AnyProperties } from '@dxos/echo/internal';
 import { type ExcludeId, type FormRootProps } from './Form';
 declare const Organization: Type.Obj<{
     readonly name: string;
 }, Schema.Struct.Fields>;
-export interface Organization extends Schema.Schema.Type<typeof Organization> {
-}
+export type Organization = Type.InstanceType<typeof Organization>;
 declare const Person: Type.Obj<{
     readonly name: string;
     readonly ignore?: string | undefined;
@@ -19,16 +18,19 @@ declare const Person: Type.Obj<{
         readonly state: string;
         readonly zip: number;
     } | undefined;
-    readonly employer?: import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    readonly employer?: import("@dxos/echo/internal").Ref<{
         readonly name: string;
-    }> | undefined;
-    readonly tags?: readonly import("@dxos/echo/internal").Ref<import("@dxos/echo/Entity").OfKind<import("@dxos/echo/internal").EntityKind.Object> & {
+    } & 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;
-    }>[] | 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 {
@@ -36,11 +38,9 @@ declare const Person: Type.Obj<{
         readonly value: string;
     }[] | undefined;
 }, Schema.Struct.Fields>;
-export interface Person extends Schema.Schema.Type<typeof Person> {
-}
+export type Person = Type.InstanceType<typeof Person>;
 type DefaultStoryProps<T extends AnyProperties> = {
     schema?: Schema.Schema<T>;
-    debug?: boolean;
 } & FormRootProps<T>;
 declare const meta: {
     title: string;
@@ -48,7 +48,7 @@ declare const meta: {
         <T extends AnyProperties = AnyProperties>({ children, schema, values, onSave, onCancel, ...props }: FormRootProps<T>): React.JSX.Element;
         displayName: string;
     };
-    render: <T extends AnyProperties = AnyProperties>({ debug, schema, values: valuesProp, ...props }: DefaultStoryProps<T>) => React.JSX.Element;
+    render: <T extends AnyProperties = AnyProperties>({ schema, values: valuesProp, ...props }: DefaultStoryProps<T>) => React.JSX.Element;
     decorators: import("@storybook/react").Decorator[];
     parameters: {
         layout: string;
@@ -62,6 +62,7 @@ declare const meta: {
                     readonly 'field-property.placeholder': 'Property name';
                     readonly 'field-format.label': 'Type';
                     readonly 'field-path.label': 'Field path';
+                    readonly 'remove-item.button': 'Delete item';
                     readonly 'add-item.button': 'Add item';
                     readonly 'add-property-button.label': 'Add property';
                     readonly 'boolean-input-true.value': 'Yes';
@@ -117,7 +118,7 @@ declare const meta: {
                     readonly 'select-option-add.button': 'Add option';
                     readonly 'system-schema.title': 'System type';
                     readonly 'system-schema.description': 'System type: cannot add or remove fields.';
-                    readonly 'remove.button': 'Remove';
+                    readonly 'remove.button': 'Delete';
                 };
             };
         }];
@@ -125,8 +126,67 @@ declare const meta: {
 };
 export default meta;
 type Story<T extends AnyProperties> = StoryObj<DefaultStoryProps<T>>;
-export declare const Default: Story<ExcludeId<typeof Person>>;
-export declare const Readonly: Story<ExcludeId<typeof Person>>;
-export declare const Static: Story<ExcludeId<typeof Person>>;
-export declare const Empty: Story<ExcludeId<typeof Person>>;
+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>;
+export declare const Default: Story<ExcludeId<typeof PersonSchema>>;
+export declare const Readonly: Story<ExcludeId<typeof PersonSchema>>;
+export declare const Static: Story<ExcludeId<typeof PersonSchema>>;
+export declare const Empty: Story<ExcludeId<typeof PersonSchema>>;
 //# 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,EAAqC,IAAI,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUzD,OAAO,EAAE,KAAK,SAAS,EAAQ,KAAK,aAAa,EAAU,MAAM,QAAQ,CAAC;AAE1E,QAAA,MAAM,YAAY;;wBAOjB,CAAC;AAEF,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC;CAAG;AAEhF,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;wBAsCX,CAAC;AAEF,MAAM,WAAW,MAAO,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC;CAAG;AAEpE,KAAK,iBAAiB,CAAC,CAAC,SAAS,aAAa,IAAI;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAmDrB,QAAA,MAAM,IAAI;;;;;;aAjDY,CAAC,SAAS,aAAa,mEAK1C,iBAAiB,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEiB,CAAC;eAE1B,IAAI;AAEnB,KAAK,KAAK,CAAC,CAAC,SAAS,aAAa,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAQrE,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,MAAM,CAAC,CAMnD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,MAAM,CAAC,CAMpD,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,MAAM,CAAC,CAMlD,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,MAAM,CAAC,CAEjD,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;AACjE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAgC,MAAM,OAAO,CAAC;AAErD,OAAO,EAA2B,GAAG,EAAY,IAAI,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAUzD,OAAO,EAAE,KAAK,SAAS,EAAQ,KAAK,aAAa,EAAU,MAAM,QAAQ,CAAC;AAE1E,QAAA,MAAM,YAAY;;wBAE0D,CAAC;AAE7E,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;AAElE,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoCuD,CAAC;AAEpE,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,MAAM,CAAC,CAAC;AAEtD,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,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"}

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

@@ -1,5 +1,6 @@
 import * as SchemaAST from 'effect/SchemaAST';
-import React from 'react';
+import React, { PropsWithChildren } from 'react';
+import { IconButtonProps } from '@dxos/react-ui';
 import { type ProjectionModel } from '@dxos/schema';
 import { type RefFieldProps } from './fields';
 import { type FormFieldComponentProps, type FormFieldMap, type FormFieldProvider } from './FormFieldComponent';
@@ -9,9 +10,14 @@ export type FormFieldProps = {
      */
     type: SchemaAST.AST;
     /**
-     * Name of the property.
+     * Name of the property. Used to derive a default label
+     * (`title ?? capitalize(name)`) and as the projection lookup key. Pass
+     * `null` to suppress the header label entirely -- the form still renders
+     * the field/struct, but `FormFieldSet`'s top-level `<FormFieldLabel>` is
+     * skipped. Used by `ArrayField` for object-array items, where every item
+     * would otherwise repeat the array's parent name.
      */
-    name: string;
+    name: string | null;
     /**
      * Path to the current object from the root. Used with nested forms.
      */
@@ -35,9 +41,13 @@ export type FormFieldProps = {
      * are only passed to ref fields whose typename matches.
      */
     createTypename?: string;
-} & Pick<FormFieldComponentProps, 'autoFocus' | 'readonly' | 'layout'> & Pick<RefFieldProps, 'createOptionLabel' | 'createOptionIcon' | 'createInitialValuePath' | 'createFieldMap' | 'db' | 'useSchema' | 'getOptions' | 'onCreate'>;
+} & Pick<FormFieldComponentProps, 'autoFocus' | 'readonly' | 'layout'> & Pick<RefFieldProps, 'createOptionLabel' | 'createOptionIcon' | 'createInitialValuePath' | 'createFieldMap' | 'db' | 'useType' | 'getOptions' | 'onCreate'>;
 export declare function FormField(props: FormFieldProps): React.JSX.Element | null;
 export declare namespace FormField {
     var displayName: string;
 }
+export declare const Nesting: ({ children }: PropsWithChildren) => React.JSX.Element;
+export declare const IconBlock: ({ inline, ...props }: IconButtonProps & {
+    inline?: boolean;
+}) => React.JSX.Element;
 //# sourceMappingURL=FormField.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/FormField.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAkB,MAAM,OAAO,CAAC;AAcvC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpD,OAAO,EAOL,KAAK,aAAa,EAInB,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAE3B;;OAEG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,IAAI,CAAC,uBAAuB,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC,GACpE,IAAI,CACF,aAAa,EACX,mBAAmB,GACnB,kBAAkB,GAClB,wBAAwB,GACxB,gBAAgB,GAChB,IAAI,GACJ,WAAW,GACX,YAAY,GACZ,UAAU,CACb,CAAC;kCAEsB,KAAK,EAAE,cAAc"}
+{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/FormField.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,EAAE,iBAAiB,EAAW,MAAM,OAAO,CAAC;AAa1D,OAAO,EAAc,eAAe,EAAkB,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpD,OAAO,EASL,KAAK,aAAa,EAInB,MAAM,UAAU,CAAC;AAElB,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAG9B,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;IAE3B;;OAEG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,IAAI,CAAC,uBAAuB,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC,GACpE,IAAI,CACF,aAAa,EACX,mBAAmB,GACnB,kBAAkB,GAClB,wBAAwB,GACxB,gBAAgB,GAChB,IAAI,GACJ,SAAS,GACT,YAAY,GACZ,UAAU,CACb,CAAC;kCAEsB,KAAK,EAAE,cAAc;;;;AAoM/C,eAAO,MAAM,OAAO,iBAAkB,iBAAiB,sBAItD,CAAC;AAEF,eAAO,MAAM,SAAS,yBAA0B,eAAe,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,sBAMrF,CAAC"}

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

@@ -1,8 +1,7 @@
 import type * as Schema from 'effect/Schema';
 import type * as SchemaAST from 'effect/SchemaAST';
 import React, { Component, type FC, type FocusEvent, type PropsWithChildren, type ReactElement, type ReactNode } from 'react';
-import { type Database } from '@dxos/echo';
-import { type Format } from '@dxos/echo/internal';
+import { type Database, Format } from '@dxos/echo';
 import { type FormFieldStatus } from '../../hooks';
 /**
  * Dynamic props passed to input components.
@@ -25,35 +24,48 @@ export type Presentation = 'full' | 'compact' | 'inline' | 'static';
  * Props passed to input components.
  */
 export type FormFieldComponentProps<T = any> = {
+    /** Database the form is editing against; populated for fields whose value is an ECHO object/Ref. */
+    db?: Database.Database;
     type: SchemaAST.AST;
     format?: Format.TypeFormat;
     readonly?: boolean;
     label: string;
+    /**
+     * Dotted JSON path of this field within the form values (e.g.
+     * `runtime.client.storage.persistent`). Forwarded to `FormFieldLabel` so
+     * that it can render the path as a debug hint when the enclosing
+     * `Form.Root` has `debug` enabled.
+     */
+    jsonPath?: string;
     placeholder?: string;
     autoFocus?: boolean;
     layout?: Presentation;
-    /** Database the form is editing against; populated for fields whose value is an ECHO object/Ref. */
-    db?: Database.Database;
 } & FormFieldStateProps<T>;
-/**
- * Form field component.
- */
 export type FormFieldComponent = FC<FormFieldComponentProps>;
 export type FormFieldMap = Record<string, FormFieldComponent>;
 export type FormFieldProvider = (props: {
     prop: string;
     schema: Schema.Schema<any>;
     fieldProps: FormFieldComponentProps;
-}) => ReactElement | undefined;
+}) => ReactElement | null | undefined;
 export type FormFieldLabelProps = {
     asChild?: boolean;
     error?: string;
+    /**
+     * JSON path of the field this label describes (e.g. `runtime.client.storage.persistent`).
+     * Surfaced as a hover tooltip on the label when the enclosing `Form.Root`
+     * has `tooltips` enabled (the default) -- useful for spotting which field
+     * maps to which path when authoring schemas or filing bugs against a form.
+     * Callers can supply the path unconditionally; the label suppresses the
+     * tooltip when `Form.Root tooltips={false}`.
+     */
+    path?: string;
 } & Pick<FormFieldComponentProps, 'label' | 'readonly'>;
-export declare function FormFieldLabel({ label, error, readonly, asChild }: FormFieldLabelProps): React.JSX.Element;
+export declare function FormFieldLabel({ label, error, readonly, asChild, path }: FormFieldLabelProps): React.JSX.Element;
 export declare namespace FormFieldLabel {
     var displayName: string;
 }
-export type FormFieldWrapperProps<T = any> = Pick<FormFieldComponentProps, 'readonly' | 'label' | 'layout' | 'getStatus' | 'getValue'> & {
+export type FormFieldWrapperProps<T = any> = Pick<FormFieldComponentProps, 'readonly' | 'label' | 'layout' | 'getStatus' | 'getValue' | 'jsonPath' | 'format'> & {
     children?: (props: {
         value: T;
     }) => ReactNode;

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

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

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

@@ -7,8 +7,14 @@ export type FormFieldSetProps<T extends AnyProperties> = {
     label?: string;
     sort?: string[];
     exclude?: (props: SchemaProperty[]) => SchemaProperty[];
-} & Pick<FormHandlerProps<T>, 'schema'> & Pick<FormFieldProps, 'path' | 'autoFocus' | 'readonly' | 'layout' | 'projection' | 'fieldMap' | 'fieldProvider' | 'createTypename' | 'createOptionLabel' | 'createOptionIcon' | 'createInitialValuePath' | 'createFieldMap' | 'db' | 'useSchema' | 'getOptions' | 'onCreate'>;
-export declare function FormFieldSet({ label, schema, readonly, path, sort, exclude, projection, layout, ...props }: FormFieldSetProps<any>): React.JSX.Element | null;
+    /**
+     * Picks a named layout out of `FormLayoutAnnotation` when present.
+     * Falls back to `'default'`. Ignored when the schema has no annotation
+     * (linear rendering then takes over).
+     */
+    layoutName?: string;
+} & Pick<FormHandlerProps<T>, 'schema'> & Pick<FormFieldProps, 'path' | 'autoFocus' | 'readonly' | 'layout' | 'projection' | 'fieldMap' | 'fieldProvider' | 'createTypename' | 'createOptionLabel' | 'createOptionIcon' | 'createInitialValuePath' | 'createFieldMap' | 'db' | 'useType' | 'getOptions' | 'onCreate'>;
+export declare function FormFieldSet({ label, schema, readonly, path, sort, exclude, projection, layout, layoutName, ...props }: FormFieldSetProps<any>): React.JSX.Element | null;
 export declare namespace FormFieldSet {
     var displayName: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"FormFieldSet.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/FormFieldSet.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7D,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,aAAa,IAAI;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,CAAC;CACzD,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GACrC,IAAI,CACF,cAAc,EACZ,MAAM,GACN,WAAW,GACX,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,wBAAwB,GACxB,gBAAgB,GAChB,IAAI,GACJ,WAAW,GACX,YAAY,GACZ,UAAU,CACb,CAAC;qCAKyB,EAC3B,KAAK,EACL,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,UAAU,EACV,MAAM,EACN,GAAG,KAAK,EACT,EAAE,iBAAiB,CAAC,GAAG,CAAC"}
+{"version":3,"file":"FormFieldSet.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/FormFieldSet.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAM7D,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,aAAa,IAAI;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,CAAC;IACxD;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,GACrC,IAAI,CACF,cAAc,EACZ,MAAM,GACN,WAAW,GACX,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAClB,wBAAwB,GACxB,gBAAgB,GAChB,IAAI,GACJ,SAAS,GACT,YAAY,GACZ,UAAU,CACb,CAAC;qCAKyB,EAC3B,KAAK,EACL,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,UAAU,EACV,MAAM,EACN,UAAgC,EAChC,GAAG,KAAK,EACT,EAAE,iBAAiB,CAAC,GAAG,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * A standalone context for the `tooltips` flag (Form.Root's only label
+ * decoration today: a JSON-path hover tooltip rendered by
+ * `FormFieldLabel`).
+ *
+ * Lives in its own module so that `FormFieldComponent.tsx` -- imported at
+ * the top of `Form.tsx` -- can read the flag without re-importing from
+ * `Form.tsx`. That round-trip used to create a circular module-eval
+ * dependency that intermittently hit a TDZ ("Cannot access 'FormFieldLabel'
+ * before initialization") in browser-mode storybook tests.
+ *
+ * Defaults to `true` both when `Form.Root` doesn't pass an explicit value
+ * AND when there is no enclosing `Form.Root` (e.g. `FormFieldWrapper`
+ * stories that render an input without a Form provider).
+ */
+export declare const FormTooltipsContext: import("react").Context<boolean>;
+/** Returns whether the enclosing `Form.Root` has field tooltips enabled. */
+export declare const useFormTooltips: () => boolean;
+//# sourceMappingURL=FormTooltipsContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormTooltipsContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/Form/FormTooltipsContext.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,kCAA+B,CAAC;AAEhE,4EAA4E;AAC5E,eAAO,MAAM,eAAe,QAAO,OAA0C,CAAC"}

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

@@ -0,0 +1,50 @@
+import * as Schema from 'effect/Schema';
+import * as SchemaAST from 'effect/SchemaAST';
+import React from 'react';
+import { type AnyProperties } from '@dxos/echo/internal';
+import { type FormFieldProps } from '../FormField';
+export type FormLayoutProps = {
+    /**
+     * Template string in the FormLayout DSL (`<grid cols=…><field name=…/></grid>`).
+     * If omitted, the layout is read from the schema's `FormLayoutAnnotation` —
+     * the entry named by `name` (default: `'default'`).
+     */
+    template?: string;
+    /**
+     * Picks a named layout out of `FormLayoutAnnotation`'s map when no
+     * explicit `template` is supplied. Defaults to `'default'`.
+     */
+    name?: string;
+} & Pick<FormFieldSetSubset, 'schema' | 'path' | 'readonly' | 'layout' | 'projection' | 'fieldMap' | 'fieldProvider'>;
+type FormFieldSetSubset = Pick<FormFieldProps, 'path' | 'readonly' | 'layout' | 'projection' | 'fieldMap' | 'fieldProvider'> & {
+    schema: Schema.Schema<AnyProperties>;
+};
+export declare function FormLayout({ schema, template, name, path, readonly, layout, projection, ...props }: FormLayoutProps): React.JSX.Element;
+export declare namespace FormLayout {
+    var displayName: string;
+}
+export type ResolvedLayoutField = {
+    /** Resolved leaf AST node for the field. */
+    type: SchemaAST.AST;
+    /** Path segments (dotted names split on `.`). */
+    segments: string[];
+    /** Last path segment; used to derive the field label when there is no `title` annotation. */
+    leafName: string;
+    /** Resolved `title` annotation for the field, if any. */
+    title?: string;
+    /**
+     * Set when the field resolves to a nested struct carrying a `LabelAnnotation` —
+     * the type literal whose computed label should render in place of the struct's
+     * sub-fields. Undefined for ordinary (non-auto-labelled) fields.
+     */
+    labelType?: SchemaAST.AST;
+};
+/**
+ * Resolves a (possibly dotted) layout field name against a schema.
+ * - `origin.code` drills through nested structs to the leaf field.
+ * - A name resolving to a nested struct with a `LabelAnnotation` is flagged via
+ *   `labelType` so the layout can auto-convert it to a single read-only label.
+ * Returns `undefined` when the name does not resolve to a property.
+ */
+export declare const resolveLayoutField: (schema: Schema.Schema<any>, name: string) => ResolvedLayoutField | undefined;
+//# sourceMappingURL=FormLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormLayout.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/Layout/FormLayout.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAA4B,MAAM,OAAO,CAAC;AAGjD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAO9D,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,CAAC,CAAC;AAEtH,KAAK,kBAAkB,GAAG,IAAI,CAC5B,cAAc,EACd,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,CAC7E,GAAG;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;CACtC,CAAC;mCAcyB,EACzB,MAAM,EACN,QAAQ,EACR,IAA0B,EAC1B,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,UAAU,EACV,GAAG,KAAK,EACT,EAAE,eAAe;;;;AAyElB,MAAM,MAAM,mBAAmB,GAAG;IAChC,4CAA4C;IAC5C,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC;IACpB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC;CAC3B,CAAC;AA4BF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,WAAY,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,MAAM,KAAG,mBAAmB,GAAG,SA8BnG,CAAC"}

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

@@ -0,0 +1,119 @@
+import { type StoryObj } from '@storybook/react-vite';
+import * as Schema from 'effect/Schema';
+import React from 'react';
+import { Type } from '@dxos/echo';
+/**
+ * Sample schema: a Flight booking carries airline, flight number, route, dates,
+ * cabin class. Without an annotation `<Form.FieldSet/>` renders one field per
+ * 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<{
+    readonly airline?: string | undefined;
+    readonly flightNumber?: string | undefined;
+    readonly origin?: string | undefined;
+    readonly destination?: string | undefined;
+    readonly departAt?: string | undefined;
+    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 = {
+    schema: Schema.Schema<any>;
+    template?: string;
+};
+declare const meta: {
+    title: string;
+    render: ({ schema, template }: StoryProps) => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+        translations: [{
+            readonly 'en-US': {
+                readonly "@dxos/react-ui-form": {
+                    readonly 'fields.label': 'Fields';
+                    readonly 'hidden-fields.label': 'Hidden Fields';
+                    readonly 'empty-readonly-ref-field.label': '(none)';
+                    readonly 'field-property.label': 'Property';
+                    readonly 'field-property.placeholder': 'Property name';
+                    readonly 'field-format.label': 'Type';
+                    readonly 'field-path.label': 'Field path';
+                    readonly 'remove-item.button': 'Delete item';
+                    readonly 'add-item.button': 'Add item';
+                    readonly 'add-property-button.label': 'Add property';
+                    readonly 'boolean-input-true.value': 'Yes';
+                    readonly 'boolean-input-false.value': 'No';
+                    readonly 'show-field.label': 'Show field';
+                    readonly 'hide-field.label': 'Hide field';
+                    readonly 'delete-field.label': 'Delete field';
+                    readonly 'create-option.label': 'Create';
+                    readonly 'add-tag.label': 'Add tag';
+                    readonly 'ref-field-combobox-input.placeholder': 'Search\u2026';
+                    readonly 'ref-field.placeholder': 'Select\u2026';
+                    readonly 'ref-field.placeholder_one': 'Select\u2026';
+                    readonly 'ref-field.placeholder_other': 'Select items\u2026';
+                    readonly 'example.placeholder': 'Example';
+                    readonly 'latitude.placeholder': 'Latitude (e.g., 40.7128)';
+                    readonly 'longitude.placeholder': 'Longitude (e.g., -74.0060)';
+                    readonly 'cancel-button.label': 'Cancel';
+                    readonly 'save-button.label': 'Save';
+                    readonly 'create-text.label': 'Create text';
+                    readonly 'format.boolean.label': 'Boolean';
+                    readonly 'format.currency.label': 'Currency';
+                    readonly 'format.date.label': 'Date';
+                    readonly 'format.date-time.label': 'DateTime';
+                    readonly 'format.did.label': 'DID';
+                    readonly 'format.duration.label': 'Duration';
+                    readonly 'format.dxn.label': 'DXN';
+                    readonly 'format.email.label': 'Email';
+                    readonly 'format.formula.label': 'Formula';
+                    readonly 'format.hostname.label': 'Hostname';
+                    readonly 'format.integer.label': 'Integer';
+                    readonly 'format.json.label': 'JSON';
+                    readonly 'format.lnglat.label': 'Geopoint';
+                    readonly 'format.markdown.label': 'Markdown';
+                    readonly 'format.percent.label': 'Percent';
+                    readonly 'format.ref.label': 'Reference';
+                    readonly 'format.regex.label': 'RegExp';
+                    readonly 'format.string.label': 'String';
+                    readonly 'format.single-select.label': 'Select';
+                    readonly 'format.multi-select.label': 'Multi-select';
+                    readonly 'format.text.label': 'Long text';
+                    readonly 'format.time.label': 'Time';
+                    readonly 'format.timestamp.label': 'Timestamp';
+                    readonly 'format.user.label': 'User';
+                    readonly 'format.number.label': 'Number';
+                    readonly 'format.uri.label': 'URI';
+                    readonly 'format.url.label': 'URL';
+                    readonly 'format.uuid.label': 'UUID';
+                    readonly 'latitude.label': 'Latitude';
+                    readonly 'longitude.label': 'Longitude';
+                    readonly 'select-option.label': 'Label';
+                    readonly 'select-option-label.placeholder': 'Option label';
+                    readonly 'select-option-delete.button': 'Delete';
+                    readonly 'select-option-add.button': 'Add option';
+                    readonly 'system-schema.title': 'System type';
+                    readonly 'system-schema.description': 'System type: cannot add or remove fields.';
+                    readonly 'remove.button': 'Delete';
+                };
+            };
+        }];
+    };
+};
+export default meta;
+type Story = StoryObj<StoryProps>;
+/** 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. */
+export declare const TemplateProp: Story;
+/** Schema carries `FormLayoutAnnotation`; `Form.FieldSet` auto-detects and delegates. */
+export declare const SchemaAnnotation: Story;
+export declare const NamedAnnotation: Story;
+export declare const NestedLabel: Story;
+/** Read-only static presentation: dates render human-readable; nested structs as labels. */
+export declare const NestedLabelStatic: Story;
+export declare const FormPlayground: Story;
+/** Same playground, but the form is rendered inside a `Card.Root` / `Card.Body`. */
+export declare const CardPlayground: Story;
+//# sourceMappingURL=FormLayout.stories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormLayout.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/Layout/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;;;;;;;;;wBAS0D,CAAC;AAEvE,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,MAAM,CAAC,CAAC;AAoFtD,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAwBF,QAAA,MAAM,IAAI;;mCAtBkC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC1B,CAAC;eAEd,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;AAElC,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;AAwIF,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,cAAc,EAAE,KAE5B,CAAC"}

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

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

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

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

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

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

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

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

package/dist/types/src/components/Form/Layout/annotation.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Annotation carrying one or more named `FormLayout` DSL templates that
+ * control how `Form.FieldSet` / `Form.Layout` arrange a schema's fields.
+ * Callers select a variant via the `name` prop; the implicit name is
+ * `DEFAULT_LAYOUT_NAME` (`'default'`).
+ *
+ * Templates use a minimal XML grammar — see `parser.ts`. Example:
+ *
+ *   FormLayoutAnnotation.set({
+ *     default: `
+ *       <grid cols="2">
+ *         <field name="origin"/>
+ *         <field name="destination"/>
+ *         <field name="provider" span="2"/>
+ *       </grid>
+ *     `,
+ *     card: `
+ *       <grid cols="1">
+ *         <field name="provider"/>
+ *         <field name="number"/>
+ *       </grid>
+ *     `,
+ *   })
+ */
+export declare const FormLayoutAnnotationId: unique symbol;
+export type FormLayoutMap = Record<string, string>;
+export declare const FormLayoutAnnotation: import("@dxos/echo/internal").AnnotationHelper<FormLayoutMap>;
+/** Name used when no explicit variant is requested. */
+export declare const DEFAULT_LAYOUT_NAME = "default";
+//# sourceMappingURL=annotation.d.ts.map

package/dist/types/src/components/Form/Layout/annotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/Layout/annotation.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,sBAAsB,eAAsD,CAAC;AAE1F,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,oBAAoB,+DAAgE,CAAC;AAElG,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,YAAY,CAAC"}

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

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

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

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

package/dist/types/src/components/Form/Layout/parser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Minimal XML-style DSL for laying out schema fields in a grid.
+ *
+ * Grammar:
+ *   <grid cols="N">  ...children...  </grid>
+ *   <field name="x" span="N"/>
+ *
+ * - Attributes accept `"…"`, `'…'`, or unquoted integers.
+ * - Whitespace between tags is ignored. Text content (between tags) is forbidden.
+ * - Self-closing form (`<field … />`) is required for `field`; `grid` must use a closing tag.
+ *
+ * The parser is hand-rolled (no HTML parser) because the grammar is tiny.
+ */
+/** Node type for the parsed layout tree. */
+export type LayoutNode = {
+    readonly kind: 'grid';
+    readonly cols: number;
+    readonly children: readonly LayoutNode[];
+} | {
+    readonly kind: 'field';
+    readonly name: string;
+    readonly span?: number;
+};
+export declare class LayoutParseError extends Error {
+    readonly position?: number | undefined;
+    readonly _tag = "LayoutParseError";
+    constructor(message: string, position?: number | undefined);
+}
+/** Parses a layout template string into a single root node. The root must be `<grid>`. */
+export declare const parseLayout: (template: string) => LayoutNode;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/Layout/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/Layout/parser.test.d.ts

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