@dxos/react-ui-form 0.8.4-main.fffef41 → 0.9.0

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

@@ -0,0 +1,132 @@
+import { type StoryObj } from '@storybook/react-vite';
+import { Obj } from '@dxos/echo';
+import { useClientStory } from '@dxos/react-client/testing';
+export type ObjectPropertiesDebug = {
+    /** Live database the story is rendering against. */
+    db: ReturnType<typeof useClientStory>['space'] extends infer S ? (S extends {
+        db: infer D;
+    } ? D : never) : never;
+    /** Object whose properties are being edited. */
+    object: Obj.Unknown;
+};
+declare const meta: {
+    title: string;
+    component: any;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+        translations: [{
+            readonly 'en-US': {
+                readonly "@dxos/react-ui-form": {
+                    readonly 'ref-editor.placeholder': "Type '@' to add a reference, or enter a value";
+                    readonly 'ref-editor-auto.placeholder': 'Search by name, or enter a value';
+                    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 'expand-fields.label': 'Expand';
+                    readonly 'collapse-fields.label': 'Collapse';
+                    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<typeof meta>;
+/**
+ * Default Pipeline form — manual exploration. Includes the Tags picker (which
+ * is the only ref-array path that currently works end-to-end, by virtue of
+ * `Tag.Tag` being special-cased in `ObjectProperties.handleCreate`).
+ */
+export declare const Default: Story;
+/**
+ * Tag-creation play. Walks the inline create flow against the Tags picker and
+ * leaves the magazine in the post-Save state for assertions to inspect via
+ * `OBJECT_PROPERTIES_DEBUG_SYMBOL`.
+ *
+ * Expected end-state (currently passes):
+ *   - new Tag.Tag exists in the DB with `label === "PinnedTag"`
+ *   - `Obj.getMeta(object).tags` includes its DXN.
+ */
+export declare const CreateTagPlay: Story;
+/**
+ * Ref-array creation play. Walks Add → Open → Create → Save against
+ * `Article.authors`. After the fix, the new Author should be persisted AND
+ * wired into `article.authors[0]`. Today it persists to the DB but the array
+ * slot stays empty.
+ */
+export declare const CreateRefArrayPlay: Story;
+/**
+ * Ref-array creation against a schema with a hidden required field. `Note`
+ * mirrors the shape of `Subscription.Feed`: the form omits `backing` (a
+ * required `Ref` annotated `FormInputAnnotation.set(false)`) but the schema
+ * requires it. Without `omitHiddenFormFields` + `FactoryAnnotation`, the
+ * form's validator would reject Save and the popover would never close.
+ *
+ * Expected end-state after the fix:
+ *   - new Note exists in DB with a synthesised `backing` ref
+ *   - `notebook.notes[0]` references the new Note
+ *   - the create form is gone
+ */
+export declare const CreateHiddenFieldPlay: Story;
+//# sourceMappingURL=ObjectProperties.stories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectProperties.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/ObjectProperties/ObjectProperties.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKjE,OAAO,EAA2B,GAAG,EAAkB,MAAM,YAAY,CAAC;AAG1E,OAAO,EAAE,cAAc,EAAsB,MAAM,4BAA4B,CAAC;AA0EhF,MAAM,MAAM,qBAAqB,GAAG;IAClC,oDAAoD;IACpD,EAAE,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,OAAO,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;IACjH,gDAAgD;IAChD,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC;CACrB,CAAC;AA8CF,QAAA,MAAM,IAAI;;eAEuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAME,CAAC;eAExB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AA4DnC;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,KAGrB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,KAmC3B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAkChC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,KA8BnC,CAAC"}

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,9 @@
+import * as Schema from 'effect/Schema';
+import { type ReactElement, type RefAttributes } from 'react';
+import { type ComposableProps } from '@dxos/ui-types';
+export type ObjectTreeProps<T> = {
+    schema: Schema.Schema<T, any, never>;
+    value: T;
+};
+export declare const ObjectTree: <T>(props: ComposableProps<ObjectTreeProps<T>> & RefAttributes<HTMLDivElement>) => ReactElement | null;
+//# sourceMappingURL=ObjectTree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectTree.d.ts","sourceRoot":"","sources":["../../../../../src/components/ObjectTree/ObjectTree.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAc,EAAE,KAAK,YAAY,EAAkB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAIrF,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC;CACV,CAAC;AAuBF,eAAO,MAAM,UAAU,EAAgC,CAAC,CAAC,EACvD,KAAK,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,cAAc,CAAC,KACvE,YAAY,GAAG,IAAI,CAAC"}

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

@@ -0,0 +1,91 @@
+import { type StoryObj } from '@storybook/react-vite';
+import React from 'react';
+declare const meta: {
+    title: string;
+    component: <T>(props: import("@dxos/ui-types").ComposableProps<import("./ObjectTree").ObjectTreeProps<T>> & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        layout: string;
+        translations: [{
+            readonly 'en-US': {
+                readonly "@dxos/react-ui-form": {
+                    readonly 'ref-editor.placeholder': "Type '@' to add a reference, or enter a value";
+                    readonly 'ref-editor-auto.placeholder': 'Search by name, or enter a value';
+                    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 'expand-fields.label': 'Expand';
+                    readonly 'collapse-fields.label': 'Collapse';
+                    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<typeof meta>;
+export declare const Default: Story;
+export declare const JSON: () => React.JSX.Element;
+export declare const WithForm: () => React.JSX.Element;
+export declare const WithReadOnlyForm: () => React.JSX.Element;
+//# sourceMappingURL=ObjectTree.stories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectTree.stories.d.ts","sourceRoot":"","sources":["../../../../../src/components/ObjectTree/ObjectTree.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,MAAM,OAAO,CAAC;AAmE1B,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQyB,CAAC;eAErB,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAEnC,eAAO,MAAM,OAAO,EAAE,KAKrB,CAAC;AAEF,eAAO,MAAM,IAAI,yBAShB,CAAC;AAMF,eAAO,MAAM,QAAQ,yBAcpB,CAAC;AAEF,eAAO,MAAM,gBAAgB,yBAS5B,CAAC"}

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

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

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

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

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

@@ -0,0 +1,73 @@
+import React from 'react';
+import { type Database, Obj, type Type } from '@dxos/echo';
+import { type ThemedClassName } from '@dxos/react-ui';
+import { type EditorController, type EditorMenuProviderProps, type EditorViewProps } from '@dxos/react-ui-editor';
+import { type RefEditorMode } from './ref-editor-extension';
+export type RefEditorProps = ThemedClassName<{
+    /** Database queried for objects of {@link RefEditorProps.type}. */
+    db?: Database.Database;
+    /** ECHO object type whose instances are offered in the typeahead and referenced as `@<id>`. */
+    type: Type.AnyObj;
+    value?: string;
+    readonly?: boolean;
+    /**
+     * Content model:
+     * - `'ref'` (default): the picker only matches existing objects; selection inserts an
+     *   `@<id>` reference (raw tokens accepted by `match` are also allowed).
+     * - `'email'`: the picker shows one item per (object, value) pair and selection captures the
+     *   value; the content is an RFC 5322 mailbox list (`Name <email>, ...`) with the comma
+     *   separators hidden inside the tags.
+     */
+    mode?: RefEditorMode;
+    /** Pluggable raw-token matcher (e.g. {@link EMAIL_REGEX}); matching tokens are accepted as values. */
+    match?: RegExp;
+    /** Display label for an object; defaults to `Obj.getLabel` falling back to the id. */
+    getLabel?: (object: Obj.Unknown) => string;
+    /** Values an object can be captured as in `'email'` mode (e.g. a person's email addresses). */
+    getValues?: (object: Obj.Unknown) => readonly string[];
+    /** Menu item icon. */
+    icon?: string;
+    /** Already-translated placeholder; defaults to a generic hint. */
+    placeholder?: string;
+    /** Open the typeahead while typing (the `@` trigger remains available but is not required). */
+    activateOnTyping?: boolean;
+} & Omit<EditorViewProps, 'initialValue'> & Pick<EditorMenuProviderProps, 'numItems'>>;
+/**
+ * Single-line input for a list of object references. Typing `@` (or any text, with
+ * `activateOnTyping`) opens a typeahead menu matching objects of the given type by label (and
+ * by their `getValues` values). The content model depends on {@link RefEditorProps.mode}.
+ * Resolved entries render as atomic tags with the object's label; raw tokens accepted by the
+ * pluggable `match` regexp render as neutral tags.
+ */
+export declare const RefEditor: React.ForwardRefExoticComponent<Omit<{
+    /** Database queried for objects of {@link RefEditorProps.type}. */
+    db?: Database.Database;
+    /** ECHO object type whose instances are offered in the typeahead and referenced as `@<id>`. */
+    type: Type.AnyObj;
+    value?: string;
+    readonly?: boolean;
+    /**
+     * Content model:
+     * - `'ref'` (default): the picker only matches existing objects; selection inserts an
+     *   `@<id>` reference (raw tokens accepted by `match` are also allowed).
+     * - `'email'`: the picker shows one item per (object, value) pair and selection captures the
+     *   value; the content is an RFC 5322 mailbox list (`Name <email>, ...`) with the comma
+     *   separators hidden inside the tags.
+     */
+    mode?: RefEditorMode;
+    /** Pluggable raw-token matcher (e.g. {@link EMAIL_REGEX}); matching tokens are accepted as values. */
+    match?: RegExp;
+    /** Display label for an object; defaults to `Obj.getLabel` falling back to the id. */
+    getLabel?: (object: Obj.Unknown) => string;
+    /** Values an object can be captured as in `'email'` mode (e.g. a person's email addresses). */
+    getValues?: (object: Obj.Unknown) => readonly string[];
+    /** Menu item icon. */
+    icon?: string;
+    /** Already-translated placeholder; defaults to a generic hint. */
+    placeholder?: string;
+    /** Open the typeahead while typing (the `@` trigger remains available but is not required). */
+    activateOnTyping?: boolean;
+} & Omit<EditorViewProps, "initialValue"> & Pick<EditorMenuProviderProps, "numItems">, "className"> & {
+    classNames?: import("@dxos/ui-types").ClassNameValue;
+} & React.RefAttributes<EditorController>>;
+//# sourceMappingURL=RefEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RefEditor.d.ts","sourceRoot":"","sources":["../../../../../src/components/RefEditor/RefEditor.tsx"],"names":[],"mappings":"AAMA,OAAO,KAA8D,MAAM,OAAO,CAAC;AAEnF,OAAO,EAAE,KAAK,QAAQ,EAAU,GAAG,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,KAAK,eAAe,EAAmC,MAAM,gBAAgB,CAAC;AACvF,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAGL,KAAK,aAAa,EAKnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,cAAc,GAAG,eAAe,CAC1C;IACE,mEAAmE;IACnE,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACvB,+FAA+F;IAC/F,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,sGAAsG;IACtG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC;IAC3C,+FAA+F;IAC/F,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,MAAM,EAAE,CAAC;IACvD,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,GACvC,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAC5C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;IAtClB,mEAAmE;SAC9D,QAAQ,CAAC,QAAQ;IACtB,+FAA+F;UACzF,IAAI,CAAC,MAAM;YACT,MAAM;eACH,OAAO;IAClB;;;;;;;OAOG;WACI,aAAa;IACpB,sGAAsG;YAC9F,MAAM;IACd,sFAAsF;eAC3E,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,KAAK,MAAM;IAC1C,+FAA+F;gBACnF,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,MAAM,EAAE;IACtD,sBAAsB;WACf,MAAM;IACb,kEAAkE;kBACpD,MAAM;IACpB,+FAA+F;uBAC5E,OAAO;;;0CAmM7B,CAAC"}

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

@@ -0,0 +1,92 @@
+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'>>;
+declare const meta: {
+    title: string;
+    render: ({ value: initialValue, ...args }: StoryProps) => React.JSX.Element;
+    decorators: import("@storybook/react").Decorator[];
+    parameters: {
+        translations: [{
+            readonly 'en-US': {
+                readonly "@dxos/react-ui-form": {
+                    readonly 'ref-editor.placeholder': "Type '@' to add a reference, or enter a value";
+                    readonly 'ref-editor-auto.placeholder': 'Search by name, or enter a value';
+                    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 'expand-fields.label': 'Expand';
+                    readonly 'collapse-fields.label': 'Collapse';
+                    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<typeof meta>;
+export declare const Default: Story;
+export declare const ActivateOnTyping: Story;
+export declare const EmailMode: Story;
+export declare const WithEmail: Story;
+//# sourceMappingURL=RefEditor.stories.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+export * from './RefEditor';
+export * from './ref-editor-extension';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/RefEditor/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC"}

package/dist/types/src/components/RefEditor/ref-editor-extension.d.ts

@@ -0,0 +1,47 @@
+import { type Extension } from '@codemirror/state';
+/**
+ * Display info for a resolved object reference.
+ */
+export type RefInfo = {
+    label: string;
+    hue?: string;
+};
+/**
+ * Content model:
+ * - `'ref'`: whitespace-separated tokens; `@<id>` references to existing objects (and raw tokens
+ *   accepted by the pluggable {@link RefEditorExtensionOptions.match} regexp).
+ * - `'email'`: comma-separated RFC 5322 mailboxes (`Name <email>` or bare `email`); the comma
+ *   separators are consumed into the atomic tags so they are not visible.
+ */
+export type RefEditorMode = 'ref' | 'email';
+export type RefEditorExtensionOptions = {
+    mode?: RefEditorMode;
+    /** Resolve an object id referenced as `@<id>` to display info. */
+    getRef?: (id: string) => RefInfo | undefined;
+    /** Pluggable raw-token matcher (e.g. {@link EMAIL_REGEX}); matching tokens render as neutral tags. */
+    match?: RegExp;
+};
+/** Matches an object reference token (`@<object id>`). */
+export declare const REF_REGEX: RegExp;
+/** Matches a well-formed email address token. */
+export declare const EMAIL_REGEX: RegExp;
+/** Matches an RFC 5322 name-addr (`Name <email>`); group 1 = display name, group 2 = addr-spec. */
+export declare const NAME_ADDR_REGEX: RegExp;
+/** Formats an RFC 5322 mailbox (`Name <email>`). */
+export declare const formatMailbox: (name: string | undefined, email: string) => string;
+/**
+ * Effect dispatched when reference data changes out-of-band (e.g. objects finish loading) so that
+ * already-rendered reference decorations re-resolve without a document change.
+ */
+export declare const refEditorRedecorate: import("@codemirror/state").StateEffectType<null>;
+/**
+ * CodeMirror extension rendering reference-editor tokens as tags. Tags are atomic: the cursor
+ * cannot enter them and deletion removes the whole token.
+ * - `'ref'` mode: `@<id>` references resolve to the object's label (via
+ *   {@link RefEditorExtensionOptions.getRef}); tokens accepted by the pluggable `match` regexp
+ *   render as neutral tags.
+ * - `'email'` mode: RFC 5322 mailboxes render as tags labelled with the display name (falling
+ *   back to the address); the trailing comma separator is hidden inside the tag's atomic range.
+ */
+export declare const refEditor: ({ mode, getRef, match }?: RefEditorExtensionOptions) => Extension;
+//# sourceMappingURL=ref-editor-extension.d.ts.map

package/dist/types/src/components/RefEditor/ref-editor-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-editor-extension.d.ts","sourceRoot":"","sources":["../../../../../src/components/RefEditor/ref-editor-extension.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,SAAS,EAA4C,MAAM,mBAAmB,CAAC;AAM/G;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,OAAO,CAAC;AAE5C,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,kEAAkE;IAClE,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IAC7C,sGAAsG;IACtG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,SAAS,QAAsB,CAAC;AAE7C,iDAAiD;AACjD,eAAO,MAAM,WAAW,QAAqD,CAAC;AAE9E,mGAAmG;AACnG,eAAO,MAAM,eAAe,QAAiE,CAAC;AAE9F,oDAAoD;AACpD,eAAO,MAAM,aAAa,SAAU,MAAM,GAAG,SAAS,SAAS,MAAM,KAAG,MAA+C,CAAC;AAExH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,mDAA6B,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,6BAAqC,yBAAyB,KAAQ,SAoH3F,CAAC"}

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

@@ -0,0 +1,51 @@
+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

@@ -0,0 +1 @@
+{"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"}