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

package/src/util/properties.test.ts

@@ -2,22 +2,27 @@
 // Copyright 2026 DXOS.org
 //
 
+import * as Effect from 'effect/Effect';
 import * as Schema from 'effect/Schema';
 import * as SchemaAST from 'effect/SchemaAST';
 import { describe, test } from 'vitest';
 
-import { DXN, Annotation, JsonSchema, Type } from '@dxos/echo';
+import { Annotation, DXN, JsonSchema, Type } from '@dxos/echo';
 import { Format } from '@dxos/echo/Format';
 import { SchemaEx } from '@dxos/effect';
 
+import { AutofillAnnotation, OptionsLookupAnnotation, autofill, optionsLookup } from '../annotations';
+import { omitId } from './omit';
 import { getFormProperties, getRootFormProperties } from './properties';
 
 describe('getFormProperties', () => {
   test('filters out keyword fields annotated FormInputAnnotation.set(false)', ({ expect }) => {
-    const TestSchema = Schema.Struct({
-      name: Schema.optional(Schema.String),
-      hidden: Schema.String.pipe(Annotation.FormInputAnnotation.set(false)),
-    }).pipe(Type.makeObject(DXN.make('org.dxos.test.keywordHidden', '0.1.0')));
+    const TestSchema = Type.makeObject(DXN.make('org.dxos.test.keywordHidden', '0.1.0'))(
+      Schema.Struct({
+        name: Schema.optional(Schema.String),
+        hidden: Schema.String.pipe(Annotation.FormInputAnnotation.set(false)),
+      }),
+    );
 
     const names = getFormProperties(Type.getSchema(TestSchema).ast).map((prop) => prop.name);
     expect(names).toContain('name');
@@ -28,10 +33,12 @@ describe('getFormProperties', () => {
     // Regression: JsonSchema fields are a Schema.Struct; encodedBoundAST strips
     // annotations from non-keyword inner types, which previously bypassed the
     // form-input filter (e.g., Routine.input).
-    const TestSchema = Schema.Struct({
-      name: Schema.optional(Schema.String),
-      schema: JsonSchema.JsonSchema.pipe(Annotation.FormInputAnnotation.set(false)),
-    }).pipe(Type.makeObject(DXN.make('org.dxos.test.structHidden', '0.1.0')));
+    const TestSchema = Type.makeObject(DXN.make('org.dxos.test.structHidden', '0.1.0'))(
+      Schema.Struct({
+        name: Schema.optional(Schema.String),
+        schema: JsonSchema.JsonSchema.pipe(Annotation.FormInputAnnotation.set(false)),
+      }),
+    );
 
     const names = getFormProperties(Type.getSchema(TestSchema).ast).map((prop) => prop.name);
     expect(names).toContain('name');
@@ -39,10 +46,12 @@ describe('getFormProperties', () => {
   });
 
   test('filters out array fields annotated FormInputAnnotation.set(false)', ({ expect }) => {
-    const TestSchema = Schema.Struct({
-      name: Schema.optional(Schema.String),
-      context: Schema.Array(Schema.Any).pipe(Annotation.FormInputAnnotation.set(false)),
-    }).pipe(Type.makeObject(DXN.make('org.dxos.test.arrayHidden', '0.1.0')));
+    const TestSchema = Type.makeObject(DXN.make('org.dxos.test.arrayHidden', '0.1.0'))(
+      Schema.Struct({
+        name: Schema.optional(Schema.String),
+        context: Schema.Array(Schema.Any).pipe(Annotation.FormInputAnnotation.set(false)),
+      }),
+    );
 
     const names = getFormProperties(Type.getSchema(TestSchema).ast).map((prop) => prop.name);
     expect(names).toContain('name');
@@ -54,10 +63,12 @@ describe('getFormProperties', () => {
     // annotation lives on the inner `T`. Without unwrapping, the filter would
     // miss the annotation and the hidden field would render. Covers the
     // conventional pattern `Schema.X.pipe(FormInputAnnotation.set(false), Schema.optional)`.
-    const TestSchema = Schema.Struct({
-      name: Schema.optional(Schema.String),
-      userId: Schema.String.pipe(Annotation.FormInputAnnotation.set(false), Schema.optional),
-    }).pipe(Type.makeObject(DXN.make('org.dxos.test.optionalHidden', '0.1.0')));
+    const TestSchema = Type.makeObject(DXN.make('org.dxos.test.optionalHidden', '0.1.0'))(
+      Schema.Struct({
+        name: Schema.optional(Schema.String),
+        userId: Schema.String.pipe(Annotation.FormInputAnnotation.set(false), Schema.optional),
+      }),
+    );
 
     const names = getFormProperties(Type.getSchema(TestSchema).ast).map((prop) => prop.name);
     expect(names).toContain('name');
@@ -75,12 +86,14 @@ describe('getFormProperties', () => {
       geometry: Schema.Array(Format.GeoPoint).pipe(Annotation.FormInputAnnotation.set(false)),
     });
     const Route = Schema.Struct({ legs: Schema.Array(Leg) });
-    const TestSchema = Schema.Struct({
-      details: Schema.Union(
-        Schema.TaggedStruct('road', { routes: Schema.optional(Schema.Array(Route)) }),
-        Schema.TaggedStruct('other', { note: Schema.optional(Schema.String) }),
-      ),
-    }).pipe(Type.makeObject(DXN.make('org.dxos.test.nestedHidden', '0.1.0')));
+    const TestSchema = Type.makeObject(DXN.make('org.dxos.test.nestedHidden', '0.1.0'))(
+      Schema.Struct({
+        details: Schema.Union(
+          Schema.TaggedStruct('road', { routes: Schema.optional(Schema.Array(Route)) }),
+          Schema.TaggedStruct('other', { note: Schema.optional(Schema.String) }),
+        ),
+      }),
+    );
 
     // Drill as the form does: getFormProperties at each level, descending via the property type
     // (array element / type literal) returned by the previous level.
@@ -110,12 +123,14 @@ describe('getFormProperties', () => {
   test('preserves annotation when chained with .annotations()', ({ expect }) => {
     // Regression: `.pipe(FormInputAnnotation.set(false)).annotations({...})` must
     // not lose the form-input annotation.
-    const TestSchema = Schema.Struct({
-      name: Schema.optional(Schema.String),
-      hidden: JsonSchema.JsonSchema.pipe(Annotation.FormInputAnnotation.set(false)).annotations({
-        description: 'Hidden field',
+    const TestSchema = Type.makeObject(DXN.make('org.dxos.test.chainedHidden', '0.1.0'))(
+      Schema.Struct({
+        name: Schema.optional(Schema.String),
+        hidden: JsonSchema.JsonSchema.pipe(Annotation.FormInputAnnotation.set(false)).annotations({
+          description: 'Hidden field',
+        }),
       }),
-    }).pipe(Type.makeObject(DXN.make('org.dxos.test.chainedHidden', '0.1.0')));
+    );
 
     const names = getFormProperties(Type.getSchema(TestSchema).ast).map((prop) => prop.name);
     expect(names).toContain('name');
@@ -150,4 +165,71 @@ describe('getRootFormProperties', () => {
   test('falls back to the discriminator alone when no value selects a member', ({ expect }) => {
     expect(getRootFormProperties(Union.ast, {}).map((prop) => prop.name)).toEqual(['kind']);
   });
+
+  describe('magazine-shaped union (base struct + spread + piped dynamic annotations + Format.URL)', () => {
+    const StandardSiteBase = Schema.Struct({
+      type: Schema.Literal('standard-site'),
+      handle: Schema.String,
+      publication: Schema.String,
+      name: Schema.optional(Schema.String),
+    });
+    type StandardSiteValues = Schema.Schema.Type<typeof StandardSiteBase>;
+    const StandardSite = Schema.Struct({
+      ...StandardSiteBase.fields,
+      handle: StandardSiteBase.fields.handle.pipe(
+        OptionsLookupAnnotation.set(
+          optionsLookup<StandardSiteValues>()(['handle'], () => Effect.succeed([]), { combobox: true }),
+        ),
+      ),
+      publication: StandardSiteBase.fields.publication.pipe(
+        OptionsLookupAnnotation.set(optionsLookup<StandardSiteValues>()(['handle'], () => Effect.succeed([]))),
+      ),
+    });
+
+    const RssBase = Schema.Struct({
+      type: Schema.Literal('rss'),
+      url: Format.URL,
+      name: Schema.optional(Schema.String),
+    });
+    type RssValues = Schema.Schema.Type<typeof RssBase>;
+    const Rss = Schema.Struct({
+      ...RssBase.fields,
+      name: Schema.optional(
+        Schema.String.pipe(AutofillAnnotation.set(autofill<RssValues>()(['url'], () => Effect.succeed(undefined)))),
+      ),
+    });
+
+    const CreateUnion = Schema.Union(StandardSite, Rss);
+
+    test('expands to the standard-site member fields', ({ expect }) => {
+      expect(getRootFormProperties(CreateUnion.ast, { type: 'standard-site' }).map((prop) => prop.name)).toEqual([
+        'type',
+        'handle',
+        'publication',
+        'name',
+      ]);
+    });
+
+    test('expands to the rss member fields', ({ expect }) => {
+      expect(getRootFormProperties(CreateUnion.ast, { type: 'rss' }).map((prop) => prop.name)).toEqual([
+        'type',
+        'url',
+        'name',
+      ]);
+    });
+
+    test('shows only the discriminator before a type is selected', ({ expect }) => {
+      expect(getRootFormProperties(CreateUnion.ast, {}).map((prop) => prop.name)).toEqual(['type']);
+    });
+
+    test('survives omitId (applied by CreateObjectPanel) — union discriminant must be preserved', ({ expect }) => {
+      const omitted = omitId(CreateUnion);
+      expect(getRootFormProperties(omitted.ast, { type: 'standard-site' }).map((prop) => prop.name)).toEqual([
+        'type',
+        'handle',
+        'publication',
+        'name',
+      ]);
+    });
+  });
 });

package/src/util/refs.ts

@@ -5,7 +5,7 @@
 import type * as SchemaAST from 'effect/SchemaAST';
 
 import { Ref } from '@dxos/echo';
-import { type ReferenceAnnotationValue, ReferenceAnnotationId } from '@dxos/echo/Annotation';
+import { ReferenceAnnotationId, type ReferenceAnnotationValue } from '@dxos/echo/Annotation';
 import { SchemaEx } from '@dxos/effect';
 
 type RefProps = {

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

@@ -1,19 +0,0 @@
-import React from 'react';
-export type FieldHeaderProps = {
-    label: string;
-    /** JSON path forwarded to the label as field metadata. */
-    path?: string;
-    readonly?: boolean;
-    /** Trailing inline add affordance; omit to hide it. */
-    add?: {
-        icon?: string;
-        label: string;
-        disabled?: boolean;
-        onClick: () => void;
-    };
-};
-/**
- * Header row for an array/list field: a label with an optional inline add button.
- */
-export declare const FieldHeader: ({ label, path, readonly, add }: FieldHeaderProps) => React.JSX.Element;
-//# sourceMappingURL=FieldHeader.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"FieldHeader.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/FormField/FieldHeader.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,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;CACjF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,mCAAoC,gBAAgB,sBAc3E,CAAC"}

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

@@ -1,47 +0,0 @@
-import React, { Component, type PropsWithChildren, type ReactNode } from 'react';
-import { ThemedClassName } from '@dxos/react-ui';
-import { type FormFieldRendererProps } from '#types';
-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;
-    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'>>;
-export declare function FormFieldLabel({ classNames, label, error, readonly, standalone, button, onClick }: FormFieldLabelProps): React.JSX.Element;
-export declare namespace FormFieldLabel {
-    var displayName: string;
-}
-export type FormFieldWrapperProps<T = any> = Pick<FormFieldRendererProps, 'readonly' | 'label' | 'layout' | 'getStatus' | 'getValue' | 'jsonPath' | 'format'> & {
-    children?: (props: {
-        value: T;
-    }) => ReactNode;
-};
-export declare const FormFieldWrapper: <T>(props: FormFieldWrapperProps<T>) => React.JSX.Element | null;
-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=FormFieldWrapper.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"FormFieldWrapper.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/FormField/FormFieldWrapper.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGjF,OAAO,EAA+B,eAAe,EAAW,MAAM,gBAAgB,CAAC;AAGvF,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAMrD,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAC/C;IACE,kJAAkJ;IAClJ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,GAAG,IAAI,CAAC,sBAAsB,EAAE,OAAO,GAAG,UAAU,CAAC,CACvD,CAAC;uCAE6B,EAC7B,UAAU,EACV,KAAK,EACL,KAAK,EACL,QAAQ,EACR,UAAU,EACV,MAAM,EACN,OAAO,EACR,EAAE,mBAAmB;;;;AAsDtB,MAAM,MAAM,qBAAqB,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,CAC/C,sBAAsB,EACtB,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CACnF,GAAG;IACF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,KAAK,SAAS,CAAC;CAC/C,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAU,qBAAqB,CAAC,CAAC,CAAC,6BA8BnE,CAAC;AAMF,KAAK,mBAAmB,GAAG;IACzB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,KAAK,2BAA2B,GAAG,iBAAiB,CAAC;IACnD,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC5B,CAAC,CAAC;AAEH,qBAAa,sBAAuB,SAAQ,SAAS,CAAC,2BAA2B,EAAE,mBAAmB,CAAC;IACrG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAE9D;IAEQ,KAAK;QAAK,KAAK;MAAc;IAE7B,kBAAkB,CAAC,SAAS,EAAE,2BAA2B,QAIjE;IAEQ,MAAM,wRAWd;IAED,OAAO,CAAC,UAAU;CAGnB"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"FormFieldWrapper.stories.d.ts","sourceRoot":"","sources":["../../../../../../src/components/Form/FormField/FormFieldWrapper.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAwC,MAAM,OAAO,CAAC;AAK7D,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAKrD,QAAA,MAAM,YAAY,qEAOf,sBAAsB,CAAC,MAAM,CAAC,sBA0BhC,CAAC;AAEF,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,YAAY,CAOnC,CAAC;eAEa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAQrB,CAAC"}

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

@@ -1,51 +0,0 @@
-import React, { type PropsWithChildren } from 'react';
-import { type Label, type ThemedClassName } from '@dxos/react-ui';
-type SettingsRootProps = ThemedClassName<PropsWithChildren>;
-declare function SettingsRoot({ children, classNames }: SettingsRootProps): React.JSX.Element;
-declare namespace SettingsRoot {
-    var displayName: string;
-}
-type SettingsSectionProps = PropsWithChildren<{
-    title: Label;
-    description?: Label;
-}>;
-declare function SettingsSection({ title, description, children }: SettingsSectionProps): React.JSX.Element;
-declare namespace SettingsSection {
-    var displayName: string;
-}
-export declare const Settings: {
-    Root: {
-        ({ children, classNames }: SettingsRootProps): React.JSX.Element;
-        displayName: string;
-    };
-    Viewport: React.ForwardRefExoticComponent<Omit<{}, "className"> & {
-        classNames?: import("@dxos/ui-types").ClassNameValue;
-    } & Pick<React.HTMLAttributes<Element>, "children" | "className" | "role" | "style"> & React.RefAttributes<HTMLDivElement>>;
-    Section: {
-        ({ title, description, children }: SettingsSectionProps): React.JSX.Element;
-        displayName: string;
-    };
-    Panel: {
-        ({ classNames, children }: Omit<{
-            children?: React.ReactNode | undefined;
-        }, "className"> & {
-            classNames?: import("@dxos/ui-types").ClassNameValue;
-        }): React.JSX.Element;
-        displayName: string;
-    };
-    Item: {
-        ({ title, description, children }: {
-            title: Label;
-            description?: Label;
-        } & {
-            children?: React.ReactNode | undefined;
-        }): React.JSX.Element;
-        displayName: string;
-    };
-    FieldSet: {
-        <T extends Record<string, any>>({ schema, values, onValuesChanged, readonly, fieldMap, visible, sort, pathPrefix, }: import("./SettingsFieldSet").SettingsFieldSetProps<T>): React.JSX.Element;
-        displayName: string;
-    };
-};
-export {};
-//# sourceMappingURL=Settings.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Settings.d.ts","sourceRoot":"","sources":["../../../../../src/components/Settings/Settings.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAE,KAAK,KAAK,EAAc,KAAK,eAAe,EAAqC,MAAM,gBAAgB,CAAC;AAiBjH,KAAK,iBAAiB,GAAG,eAAe,CAAC,iBAAiB,CAAC,CAAC;8BAEtC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,iBAAiB;;;;AA0BjE,KAAK,oBAAoB,GAAG,iBAAiB,CAAC;IAC5C,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,CAAC,CAAC;iCAEsB,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,oBAAoB;;;;AAiB/E,eAAO,MAAM,QAAQ;IACnB,IAAI;mCAjD0C,iBAAiB;;;IAkD/D,QAAQ;;;IACR,OAAO;2CApBkD,oBAAoB;;;IAqB7E,KAAK;;;;;;;;IACL,IAAI;;;;;;;;;IACJ,QAAQ;;;;CACT,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"Settings.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/Settings/Settings.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAoC1B,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQM,CAAC;eAEF,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAAU,CAAC;AA6CjC,eAAO,MAAM,QAAQ,EAAE,KAEtB,CAAC"}

package/dist/types/src/components/Settings/SettingsFieldSet.d.ts

@@ -1,43 +0,0 @@
-import * as SchemaAST from 'effect/SchemaAST';
-import React from 'react';
-/**
- * Props for a custom field renderer.
- * The renderer provides the control only; SettingsItem wrapper is handled by FieldSet.
- */
-export type SettingsFieldProps<T = any> = {
-    value: T;
-    onChange: (value: T) => void;
-    readonly?: boolean;
-};
-/**
- * Map of property names to either a custom field renderer or a nested field map for struct fields.
- * When a value type `T` is provided, the map shape is checked against the schema's value type.
- */
-export type SettingsFieldMap<T extends Record<string, any> = Record<string, any>> = {
-    [K in keyof T]?: NonNullable<T[K]> extends Record<string, any> ? SettingsFieldMap<NonNullable<T[K]>> : React.FC<SettingsFieldProps<T[K]>>;
-};
-export type SettingsFieldSetProps<T extends Record<string, any> = Record<string, any>> = {
-    /** Effect Schema for the settings object. */
-    schema: {
-        ast: SchemaAST.AST;
-    };
-    /** Current settings values. */
-    values: T;
-    /** Callback when any value changes. Receives a new complete object. */
-    onValuesChanged?: (values: T) => void;
-    /** When true, all controls are disabled. */
-    readonly?: boolean;
-    /** Map of property names to custom field renderers. Nested objects map to struct sub-fields. */
-    fieldMap?: SettingsFieldMap<T>;
-    /** Control field visibility. Receives the dotted path (e.g. `'modelDefaults.edge'`) at every level. */
-    visible?: (path: string, values: T) => boolean;
-    /** Override the order of fields. Fields not listed are appended in schema order. Applied per scope. */
-    sort?: string[];
-    /** Internal: dot-path prefix used by recursive struct rendering. */
-    pathPrefix?: string;
-};
-export declare function SettingsFieldSet<T extends Record<string, any>>({ schema, values, onValuesChanged, readonly, fieldMap, visible, sort, pathPrefix }: SettingsFieldSetProps<T>): React.JSX.Element;
-export declare namespace SettingsFieldSet {
-    var displayName: string;
-}
-//# sourceMappingURL=SettingsFieldSet.d.ts.map

package/dist/types/src/components/Settings/SettingsFieldSet.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SettingsFieldSet.d.ts","sourceRoot":"","sources":["../../../../../src/components/Settings/SettingsFieldSet.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAA+B,MAAM,OAAO,CAAC;AAYpD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,GAAG,IAAI;IACxC,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI;KACjF,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1D,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACnC,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI;IACvF,6CAA6C;IAC7C,MAAM,EAAE;QAAE,GAAG,EAAE,SAAS,CAAC,GAAG,CAAA;KAAE,CAAC;IAE/B,+BAA+B;IAC/B,MAAM,EAAE,CAAC,CAAC;IAEV,uEAAuE;IACvE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAEtC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAE/B,uGAAuG;IACvG,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IAE/C,uGAAuG;IACvG,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;yCAM+B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAC9D,MAAM,EACN,MAAM,EACN,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,UAAe,EAChB,EAAE,qBAAqB,CAAC,CAAC,CAAC"}

package/dist/types/src/components/Settings/SettingsItem.d.ts

@@ -1,16 +0,0 @@
-import React, { type PropsWithChildren } from 'react';
-import { type Label, type ThemedClassName } from '@dxos/react-ui';
-type SettingsPanelProps = ThemedClassName<PropsWithChildren>;
-export declare function SettingsPanel({ classNames, children }: SettingsPanelProps): React.JSX.Element;
-export declare namespace SettingsPanel {
-    var displayName: string;
-}
-type SettingsItemProps = PropsWithChildren<{
-    title: Label;
-    description?: Label;
-}>;
-export declare function SettingsItem({ title, description, children }: SettingsItemProps): React.JSX.Element;
-export declare namespace SettingsItem {
-    var displayName: string;
-}
-//# sourceMappingURL=SettingsItem.d.ts.map

package/dist/types/src/components/Settings/SettingsItem.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SettingsItem.d.ts","sourceRoot":"","sources":["../../../../../src/components/Settings/SettingsItem.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAS,KAAK,KAAK,EAAE,KAAK,eAAe,EAAqC,MAAM,gBAAgB,CAAC;AAY5G,KAAK,kBAAkB,GAAG,eAAe,CAAC,iBAAiB,CAAC,CAAC;sCAE/B,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,kBAAkB;;;;AAY1E,KAAK,iBAAiB,GAAG,iBAAiB,CAAC;IACzC,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB,CAAC,CAAC;qCAE0B,EAAE,KAAK,EAAE,WAAgB,EAAE,QAAQ,EAAE,EAAE,iBAAiB"}

package/dist/types/src/components/Settings/SettingsSelectField.d.ts

@@ -1,18 +0,0 @@
-import React from 'react';
-import { type SettingsFieldProps } from './SettingsFieldSet';
-export type SelectFieldOption = {
-    value: string;
-    label?: string;
-};
-export type CreateSelectFieldOptions = {
-    /** Options to display. Strings are used as both value and label. */
-    options: ReadonlyArray<string | SelectFieldOption>;
-    /** Label for the sentinel option that maps to `undefined`. Defaults to `'Default'`. Pass `null` to omit. */
-    defaultLabel?: string | null;
-};
-/**
- * Factory for a `SettingsFieldSet` `fieldMap` entry that renders a Select control
- * over a fixed list of options, with an optional sentinel for `undefined`.
- */
-export declare const createSelectField: ({ options, defaultLabel, }: CreateSelectFieldOptions) => React.FC<SettingsFieldProps<string | undefined>>;
-//# sourceMappingURL=SettingsSelectField.d.ts.map

package/dist/types/src/components/Settings/SettingsSelectField.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SettingsSelectField.d.ts","sourceRoot":"","sources":["../../../../../src/components/Settings/SettingsSelectField.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,oEAAoE;IACpE,OAAO,EAAE,aAAa,CAAC,MAAM,GAAG,iBAAiB,CAAC,CAAC;IACnD,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,+BAG3B,wBAAwB,KAAG,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,MAAM,GAAG,SAAS,CAAC,CA6B5E,CAAC"}

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

@@ -1,4 +0,0 @@
-export * from './Settings';
-export { type SettingsFieldMap, type SettingsFieldProps, type SettingsFieldSetProps } from './SettingsFieldSet';
-export { createSelectField, type CreateSelectFieldOptions, type SelectFieldOption } from './SettingsSelectField';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/Settings/index.ts"],"names":[],"mappings":"AAIA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChH,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/types/src/util/field-type.d.ts

@@ -1,19 +0,0 @@
-import * as SchemaAST from 'effect/SchemaAST';
-/**
- * Detected field type for a schema property.
- */
-export type SettingsFieldType = 'boolean' | 'string' | 'number' | 'select' | 'struct';
-export type SelectOption = {
-    value: string | number;
-    label?: string;
-};
-/**
- * Detect the field type from an Effect Schema AST node.
- */
-export declare const detectFieldType: (ast: SchemaAST.AST) => SettingsFieldType | undefined;
-/**
- * Extract select options from a literal union AST node.
- * Reads title annotations from individual literals for labels.
- */
-export declare const getSelectOptionsFromAst: (ast: SchemaAST.AST) => SelectOption[] | undefined;
-//# sourceMappingURL=field-type.d.ts.map

package/dist/types/src/util/field-type.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"field-type.d.ts","sourceRoot":"","sources":["../../../../src/util/field-type.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAI9C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,QAAS,SAAS,CAAC,GAAG,KAAG,iBAAiB,GAAG,SAkBxE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAAS,SAAS,CAAC,GAAG,KAAG,YAAY,EAAE,GAAG,SAc7E,CAAC"}

package/src/components/Form/FormField/FieldHeader.tsx

@@ -1,36 +0,0 @@
-//
-// Copyright 2026 DXOS.org
-//
-
-import React from 'react';
-
-import { CompactIconButton } from './FormField';
-import { FormFieldLabel } from './FormFieldWrapper';
-
-export type FieldHeaderProps = {
-  label: string;
-  /** JSON path forwarded to the label as field metadata. */
-  path?: string;
-  readonly?: boolean;
-  /** Trailing inline add affordance; omit to hide it. */
-  add?: { icon?: string; label: string; disabled?: boolean; onClick: () => void };
-};
-
-/**
- * Header row for an array/list field: a label with an optional inline add button.
- */
-export const FieldHeader = ({ label, path, readonly, add }: FieldHeaderProps) => (
-  <div className='flex items-center gap-2'>
-    <div className='flex-1 min-w-0'>
-      <FormFieldLabel readonly={readonly} label={label} path={path} standalone />
-    </div>
-    {!readonly && add && (
-      <CompactIconButton
-        disabled={add.disabled}
-        icon={add.icon ?? 'ph--plus--regular'}
-        label={add.label}
-        onClick={add.onClick}
-      />
-    )}
-  </div>
-);