@object-ui/fields 0.3.0 → 0.5.0

package/dist/fields/src/complex-widgets.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/fields/src/datetime-widgets.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/fields/src/fields.stories.d.ts

@@ -0,0 +1,56 @@
+import { StoryObj } from '@storybook/react';
+/**
+ * **Field Widgets** from `@object-ui/fields`.
+ *
+ * These components handle data formatting, validation, and display logic for specific data types.
+ * They are typically used within `ObjectForm` or `ObjectGrid` but can be used standalone.
+ *
+ * Note: These widgets implement the `FieldWidgetProps` interface.
+ */
+declare const meta: {
+    title: string;
+    parameters: {
+        layout: string;
+    };
+    tags: string[];
+};
+export default meta;
+type Story = StoryObj<any>;
+export declare const Text: Story;
+export declare const TextArea: Story;
+export declare const Email: Story;
+export declare const Phone: Story;
+export declare const Url: Story;
+export declare const Password: Story;
+export declare const AutoNumber: Story;
+export declare const Number: Story;
+export declare const Currency: Story;
+export declare const Percent: Story;
+export declare const Date: Story;
+export declare const DateTime: Story;
+export declare const Time: Story;
+export declare const Boolean: Story;
+export declare const Select: Story;
+export declare const Lookup: Story;
+export declare const MultiSelectLookup: Story;
+export declare const User: Story;
+export declare const File: Story;
+export declare const Location: Story;
+export declare const Formula: Story;
+export declare const Summary: Story;
+export declare const ReadOnly: Story;
+export declare const RichText: Story;
+export declare const Image: Story;
+export declare const Color: Story;
+export declare const Slider: Story;
+export declare const Rating: Story;
+export declare const Code: Story;
+export declare const Avatar: Story;
+export declare const Signature: Story;
+export declare const QRCode: Story;
+export declare const Address: Story;
+export declare const Geolocation: Story;
+export declare const Object: Story;
+export declare const Grid: Story;
+export declare const MasterDetail: Story;
+export declare const Vector: Story;

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

@@ -127,6 +127,30 @@ export declare function buildValidationRules(field: any): any;
  * @returns Whether the condition is met
  */
 export declare function evaluateCondition(condition: any, formData: any): boolean;
+/**
+ * Register a specific field type lazily
+ * @param fieldType - The field type to register (e.g., 'text', 'number')
+ *
+ * @example
+ * // Register only the text field
+ * registerField('text');
+ */
+export declare function registerField(fieldType: string): void;
+/**
+ * Register all field types (for backward compatibility)
+ * This function auto-registers all field widgets on import.
+ *
+ * For better tree-shaking, use registerField() to register only needed fields.
+ *
+ * @example
+ * // Register all fields at once
+ * registerAllFields();
+ */
+export declare function registerAllFields(): void;
+/**
+ * Legacy function - kept for backward compatibility
+ * @deprecated Use registerAllFields() instead
+ */
 export declare function registerFields(): void;
 export * from './widgets/types';
 export * from './widgets/TextField';
@@ -134,10 +158,34 @@ export * from './widgets/NumberField';
 export * from './widgets/BooleanField';
 export * from './widgets/SelectField';
 export * from './widgets/DateField';
+export * from './widgets/DateTimeField';
+export * from './widgets/TimeField';
 export * from './widgets/EmailField';
 export * from './widgets/PhoneField';
 export * from './widgets/UrlField';
 export * from './widgets/CurrencyField';
+export * from './widgets/PercentField';
+export * from './widgets/PasswordField';
 export * from './widgets/TextAreaField';
 export * from './widgets/RichTextField';
 export * from './widgets/LookupField';
+export * from './widgets/FileField';
+export * from './widgets/ImageField';
+export * from './widgets/LocationField';
+export * from './widgets/FormulaField';
+export * from './widgets/SummaryField';
+export * from './widgets/AutoNumberField';
+export * from './widgets/UserField';
+export * from './widgets/ObjectField';
+export * from './widgets/VectorField';
+export * from './widgets/GridField';
+export * from './widgets/ColorField';
+export * from './widgets/SliderField';
+export * from './widgets/RatingField';
+export * from './widgets/CodeField';
+export * from './widgets/AvatarField';
+export * from './widgets/AddressField';
+export * from './widgets/GeolocationField';
+export * from './widgets/SignatureField';
+export * from './widgets/QRCodeField';
+export * from './widgets/MasterDetailField';

package/dist/fields/src/new-widgets.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export {};

package/dist/fields/src/remaining-widgets.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/fields/src/text-rich-widgets.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/fields/src/visual-widgets.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/fields/src/widgets/AddressField.d.ts

@@ -0,0 +1,16 @@
+import { FieldWidgetProps } from './types';
+/**
+ * Address data structure
+ */
+export interface AddressValue {
+    street?: string;
+    city?: string;
+    state?: string;
+    zipCode?: string;
+    country?: string;
+}
+/**
+ * Address field widget - provides a structured address input
+ * Supports street, city, state, zip code, and country
+ */
+export declare function AddressField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<AddressValue>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/AutoNumberField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * AutoNumberField - Read-only auto-generated field
+ * Values are automatically generated by the system and cannot be edited
+ */
+export declare function AutoNumberField({ value, field, ...props }: FieldWidgetProps<string | number>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/AvatarField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * Avatar field widget - provides an avatar/profile picture uploader
+ * Supports image URLs or file uploads
+ */
+export declare function AvatarField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<string>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/CodeField.d.ts

@@ -0,0 +1,7 @@
+import { FieldWidgetProps } from './types';
+/**
+ * Code field widget - provides a code editor with syntax highlighting
+ * Uses a simple textarea with monospace font
+ * For advanced code editing, use the @object-ui/plugin-editor component
+ */
+export declare function CodeField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<string>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/ColorField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * Color field widget - provides a color picker input
+ * Supports hex color values (e.g., #ff0000)
+ */
+export declare function ColorField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<string>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/CurrencyField.d.ts

@@ -1,2 +1,2 @@
 import { FieldWidgetProps } from './types';
-export declare function CurrencyField({ value, onChange, field, readonly, errorMessage, ...props }: FieldWidgetProps<number>): import("react/jsx-runtime").JSX.Element;
+export declare function CurrencyField({ value, onChange, field, readonly, errorMessage, className, ...props }: FieldWidgetProps<number>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/DateTimeField.d.ts

@@ -0,0 +1,2 @@
+import { FieldWidgetProps } from './types';
+export declare function DateTimeField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<string>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/FileField.d.ts

@@ -0,0 +1,2 @@
+import { FieldWidgetProps } from './types';
+export declare function FileField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<any>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/FormulaField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * FormulaField - Read-only computed field
+ * Values are computed on the backend and cannot be edited
+ */
+export declare function FormulaField({ value, field, ...props }: FieldWidgetProps<any>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/GeolocationField.d.ts

@@ -0,0 +1,14 @@
+import { FieldWidgetProps } from './types';
+/**
+ * Geolocation data structure
+ */
+export interface GeolocationValue {
+    latitude?: number;
+    longitude?: number;
+    accuracy?: number;
+}
+/**
+ * Geolocation field widget - provides a location picker with coordinates
+ * Supports manual entry and browser geolocation API
+ */
+export declare function GeolocationField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<GeolocationValue>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/GridField.d.ts

@@ -0,0 +1,7 @@
+import { FieldWidgetProps } from './types';
+/**
+ * GridField - Sub-table/grid data display
+ * Shows tabular data in a simplified format
+ * For full editing capabilities, use the grid plugin
+ */
+export declare function GridField({ value, field, readonly, ...props }: FieldWidgetProps<any[]>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/ImageField.d.ts

@@ -0,0 +1,2 @@
+import { FieldWidgetProps } from './types';
+export declare function ImageField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<any>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/LocationField.d.ts

@@ -0,0 +1,2 @@
+import { FieldWidgetProps } from './types';
+export declare function LocationField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<any>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/LookupField.d.ts

@@ -3,4 +3,4 @@ import { FieldWidgetProps } from './types';
  * Lookup field for selecting related records
  * Supports single and multi-select with search
  */
-export declare function LookupField({ value, onChange, field, readonly }: FieldWidgetProps<any>): import("react/jsx-runtime").JSX.Element;
+export declare function LookupField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<any>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/MasterDetailField.d.ts

@@ -0,0 +1,14 @@
+import { FieldWidgetProps } from './types';
+/**
+ * Master-Detail relationship data structure
+ */
+export interface MasterDetailValue {
+    id: string;
+    label: string;
+    [key: string]: any;
+}
+/**
+ * Master-Detail field widget - manages one-to-many relationships
+ * Displays related records with add/remove capabilities
+ */
+export declare function MasterDetailField({ value, onChange, field, readonly, className, ...props }: FieldWidgetProps<MasterDetailValue[]>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/ObjectField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * ObjectField - JSON object editor
+ * Allows editing structured JSON data
+ */
+export declare function ObjectField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<any>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/PasswordField.d.ts

@@ -0,0 +1,2 @@
+import { FieldWidgetProps } from './types';
+export declare function PasswordField({ value, onChange, field, readonly, className, ...props }: FieldWidgetProps<string>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/PercentField.d.ts

@@ -0,0 +1,2 @@
+import { FieldWidgetProps } from './types';
+export declare function PercentField({ value, onChange, field, readonly, errorMessage, className, ...props }: FieldWidgetProps<number>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/QRCodeField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * QR Code field widget - generates QR codes from text
+ * Uses a simple SVG-based QR code generator
+ */
+export declare function QRCodeField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<string>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/RatingField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * Rating field widget - provides a star rating input
+ * Supports numeric values from 0 to max (default 5)
+ */
+export declare function RatingField({ value, onChange, field, readonly, className, ...props }: FieldWidgetProps<number>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/SignatureField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * Signature field widget - provides a signature pad for capturing signatures
+ * Outputs signature as a base64 PNG image
+ */
+export declare function SignatureField({ value, onChange, readonly }: FieldWidgetProps<string>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/SliderField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * Slider field widget - provides a range slider input
+ * Supports numeric values with configurable min, max, and step
+ */
+export declare function SliderField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<number>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/SummaryField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * SummaryField - Read-only aggregation field
+ * Values are aggregated from related records and cannot be edited
+ */
+export declare function SummaryField({ value, field, ...props }: FieldWidgetProps<any>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/TimeField.d.ts

@@ -0,0 +1,2 @@
+import { FieldWidgetProps } from './types';
+export declare function TimeField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<string>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/UserField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * UserField - User/Owner selector field
+ * Allows selecting one or multiple users
+ */
+export declare function UserField({ value, onChange, field, readonly, ...props }: FieldWidgetProps<any>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/VectorField.d.ts

@@ -0,0 +1,6 @@
+import { FieldWidgetProps } from './types';
+/**
+ * VectorField - Vector/embedding data display
+ * Shows vector embeddings in a read-only format
+ */
+export declare function VectorField({ value, field, ...props }: FieldWidgetProps<number[]>): import("react/jsx-runtime").JSX.Element;

package/dist/fields/src/widgets/types.d.ts

@@ -4,6 +4,8 @@ export type FieldWidgetProps<T = any> = {
     onChange: (val: T) => void;
     field: FieldMetadata;
     readonly?: boolean;
+    disabled?: boolean;
     className?: string;
     errorMessage?: string;
+    [key: string]: any;
 };