@objectstack/spec 0.1.1 → 0.2.0

package/dist/ui/theme.zod.d.ts.map

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

package/dist/ui/theme.zod.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemeSchema = exports.ThemeMode = exports.ZIndexSchema = exports.AnimationSchema = exports.BreakpointsSchema = exports.ShadowSchema = exports.BorderRadiusSchema = exports.SpacingSchema = exports.TypographySchema = exports.ColorPaletteSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * Color Palette Schema
+ * Defines brand colors and their variants.
+ */
+exports.ColorPaletteSchema = zod_1.z.object({
+    primary: zod_1.z.string().describe('Primary brand color (hex, rgb, or hsl)'),
+    secondary: zod_1.z.string().optional().describe('Secondary brand color'),
+    accent: zod_1.z.string().optional().describe('Accent color for highlights'),
+    success: zod_1.z.string().optional().describe('Success state color (default: green)'),
+    warning: zod_1.z.string().optional().describe('Warning state color (default: yellow)'),
+    error: zod_1.z.string().optional().describe('Error state color (default: red)'),
+    info: zod_1.z.string().optional().describe('Info state color (default: blue)'),
+    // Neutral colors
+    background: zod_1.z.string().optional().describe('Background color'),
+    surface: zod_1.z.string().optional().describe('Surface/card background color'),
+    text: zod_1.z.string().optional().describe('Primary text color'),
+    textSecondary: zod_1.z.string().optional().describe('Secondary text color'),
+    border: zod_1.z.string().optional().describe('Border color'),
+    disabled: zod_1.z.string().optional().describe('Disabled state color'),
+    // Color variants (shades)
+    primaryLight: zod_1.z.string().optional().describe('Lighter shade of primary'),
+    primaryDark: zod_1.z.string().optional().describe('Darker shade of primary'),
+    secondaryLight: zod_1.z.string().optional().describe('Lighter shade of secondary'),
+    secondaryDark: zod_1.z.string().optional().describe('Darker shade of secondary'),
+});
+/**
+ * Typography Settings Schema
+ * Font families, sizes, weights, and line heights.
+ */
+exports.TypographySchema = zod_1.z.object({
+    fontFamily: zod_1.z.object({
+        base: zod_1.z.string().optional().describe('Base font family (default: system fonts)'),
+        heading: zod_1.z.string().optional().describe('Heading font family'),
+        mono: zod_1.z.string().optional().describe('Monospace font family for code'),
+    }).optional(),
+    fontSize: zod_1.z.object({
+        xs: zod_1.z.string().optional().describe('Extra small font size (e.g., 0.75rem)'),
+        sm: zod_1.z.string().optional().describe('Small font size (e.g., 0.875rem)'),
+        base: zod_1.z.string().optional().describe('Base font size (e.g., 1rem)'),
+        lg: zod_1.z.string().optional().describe('Large font size (e.g., 1.125rem)'),
+        xl: zod_1.z.string().optional().describe('Extra large font size (e.g., 1.25rem)'),
+        '2xl': zod_1.z.string().optional().describe('2X large font size (e.g., 1.5rem)'),
+        '3xl': zod_1.z.string().optional().describe('3X large font size (e.g., 1.875rem)'),
+        '4xl': zod_1.z.string().optional().describe('4X large font size (e.g., 2.25rem)'),
+    }).optional(),
+    fontWeight: zod_1.z.object({
+        light: zod_1.z.number().optional().describe('Light weight (default: 300)'),
+        normal: zod_1.z.number().optional().describe('Normal weight (default: 400)'),
+        medium: zod_1.z.number().optional().describe('Medium weight (default: 500)'),
+        semibold: zod_1.z.number().optional().describe('Semibold weight (default: 600)'),
+        bold: zod_1.z.number().optional().describe('Bold weight (default: 700)'),
+    }).optional(),
+    lineHeight: zod_1.z.object({
+        tight: zod_1.z.string().optional().describe('Tight line height (e.g., 1.25)'),
+        normal: zod_1.z.string().optional().describe('Normal line height (e.g., 1.5)'),
+        relaxed: zod_1.z.string().optional().describe('Relaxed line height (e.g., 1.75)'),
+        loose: zod_1.z.string().optional().describe('Loose line height (e.g., 2)'),
+    }).optional(),
+    letterSpacing: zod_1.z.object({
+        tighter: zod_1.z.string().optional().describe('Tighter letter spacing (e.g., -0.05em)'),
+        tight: zod_1.z.string().optional().describe('Tight letter spacing (e.g., -0.025em)'),
+        normal: zod_1.z.string().optional().describe('Normal letter spacing (e.g., 0)'),
+        wide: zod_1.z.string().optional().describe('Wide letter spacing (e.g., 0.025em)'),
+        wider: zod_1.z.string().optional().describe('Wider letter spacing (e.g., 0.05em)'),
+    }).optional(),
+});
+/**
+ * Spacing Units Schema
+ * Defines spacing scale for margins, padding, gaps.
+ */
+exports.SpacingSchema = zod_1.z.object({
+    '0': zod_1.z.string().optional().describe('0 spacing (0)'),
+    '1': zod_1.z.string().optional().describe('Spacing unit 1 (e.g., 0.25rem)'),
+    '2': zod_1.z.string().optional().describe('Spacing unit 2 (e.g., 0.5rem)'),
+    '3': zod_1.z.string().optional().describe('Spacing unit 3 (e.g., 0.75rem)'),
+    '4': zod_1.z.string().optional().describe('Spacing unit 4 (e.g., 1rem)'),
+    '5': zod_1.z.string().optional().describe('Spacing unit 5 (e.g., 1.25rem)'),
+    '6': zod_1.z.string().optional().describe('Spacing unit 6 (e.g., 1.5rem)'),
+    '8': zod_1.z.string().optional().describe('Spacing unit 8 (e.g., 2rem)'),
+    '10': zod_1.z.string().optional().describe('Spacing unit 10 (e.g., 2.5rem)'),
+    '12': zod_1.z.string().optional().describe('Spacing unit 12 (e.g., 3rem)'),
+    '16': zod_1.z.string().optional().describe('Spacing unit 16 (e.g., 4rem)'),
+    '20': zod_1.z.string().optional().describe('Spacing unit 20 (e.g., 5rem)'),
+    '24': zod_1.z.string().optional().describe('Spacing unit 24 (e.g., 6rem)'),
+});
+/**
+ * Border Radius Schema
+ * Rounded corners configuration.
+ */
+exports.BorderRadiusSchema = zod_1.z.object({
+    none: zod_1.z.string().optional().describe('No border radius (0)'),
+    sm: zod_1.z.string().optional().describe('Small border radius (e.g., 0.125rem)'),
+    base: zod_1.z.string().optional().describe('Base border radius (e.g., 0.25rem)'),
+    md: zod_1.z.string().optional().describe('Medium border radius (e.g., 0.375rem)'),
+    lg: zod_1.z.string().optional().describe('Large border radius (e.g., 0.5rem)'),
+    xl: zod_1.z.string().optional().describe('Extra large border radius (e.g., 0.75rem)'),
+    '2xl': zod_1.z.string().optional().describe('2X large border radius (e.g., 1rem)'),
+    full: zod_1.z.string().optional().describe('Full border radius (50%)'),
+});
+/**
+ * Shadow Schema
+ * Box shadow effects.
+ */
+exports.ShadowSchema = zod_1.z.object({
+    none: zod_1.z.string().optional().describe('No shadow'),
+    sm: zod_1.z.string().optional().describe('Small shadow'),
+    base: zod_1.z.string().optional().describe('Base shadow'),
+    md: zod_1.z.string().optional().describe('Medium shadow'),
+    lg: zod_1.z.string().optional().describe('Large shadow'),
+    xl: zod_1.z.string().optional().describe('Extra large shadow'),
+    '2xl': zod_1.z.string().optional().describe('2X large shadow'),
+    inner: zod_1.z.string().optional().describe('Inner shadow (inset)'),
+});
+/**
+ * Breakpoints Schema
+ * Responsive design breakpoints.
+ */
+exports.BreakpointsSchema = zod_1.z.object({
+    xs: zod_1.z.string().optional().describe('Extra small breakpoint (e.g., 480px)'),
+    sm: zod_1.z.string().optional().describe('Small breakpoint (e.g., 640px)'),
+    md: zod_1.z.string().optional().describe('Medium breakpoint (e.g., 768px)'),
+    lg: zod_1.z.string().optional().describe('Large breakpoint (e.g., 1024px)'),
+    xl: zod_1.z.string().optional().describe('Extra large breakpoint (e.g., 1280px)'),
+    '2xl': zod_1.z.string().optional().describe('2X large breakpoint (e.g., 1536px)'),
+});
+/**
+ * Animation Schema
+ * Animation timing and duration settings.
+ */
+exports.AnimationSchema = zod_1.z.object({
+    duration: zod_1.z.object({
+        fast: zod_1.z.string().optional().describe('Fast animation (e.g., 150ms)'),
+        base: zod_1.z.string().optional().describe('Base animation (e.g., 300ms)'),
+        slow: zod_1.z.string().optional().describe('Slow animation (e.g., 500ms)'),
+    }).optional(),
+    timing: zod_1.z.object({
+        linear: zod_1.z.string().optional().describe('Linear timing function'),
+        ease: zod_1.z.string().optional().describe('Ease timing function'),
+        easeIn: zod_1.z.string().optional().describe('Ease-in timing function'),
+        easeOut: zod_1.z.string().optional().describe('Ease-out timing function'),
+        easeInOut: zod_1.z.string().optional().describe('Ease-in-out timing function'),
+    }).optional(),
+});
+/**
+ * Z-Index Scale Schema
+ * Layering and stacking order.
+ */
+exports.ZIndexSchema = zod_1.z.object({
+    base: zod_1.z.number().optional().describe('Base z-index (e.g., 0)'),
+    dropdown: zod_1.z.number().optional().describe('Dropdown z-index (e.g., 1000)'),
+    sticky: zod_1.z.number().optional().describe('Sticky z-index (e.g., 1020)'),
+    fixed: zod_1.z.number().optional().describe('Fixed z-index (e.g., 1030)'),
+    modalBackdrop: zod_1.z.number().optional().describe('Modal backdrop z-index (e.g., 1040)'),
+    modal: zod_1.z.number().optional().describe('Modal z-index (e.g., 1050)'),
+    popover: zod_1.z.number().optional().describe('Popover z-index (e.g., 1060)'),
+    tooltip: zod_1.z.number().optional().describe('Tooltip z-index (e.g., 1070)'),
+});
+/**
+ * Theme Mode Enum
+ */
+exports.ThemeMode = zod_1.z.enum(['light', 'dark', 'auto']);
+/**
+ * Theme Configuration Schema
+ * Complete theme definition for brand customization.
+ */
+exports.ThemeSchema = zod_1.z.object({
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Unique theme identifier (snake_case)'),
+    label: zod_1.z.string().describe('Human-readable theme name'),
+    description: zod_1.z.string().optional().describe('Theme description'),
+    /** Theme mode */
+    mode: exports.ThemeMode.default('light').describe('Theme mode (light, dark, or auto)'),
+    /** Color system */
+    colors: exports.ColorPaletteSchema.describe('Color palette configuration'),
+    /** Typography */
+    typography: exports.TypographySchema.optional().describe('Typography settings'),
+    /** Spacing */
+    spacing: exports.SpacingSchema.optional().describe('Spacing scale'),
+    /** Border radius */
+    borderRadius: exports.BorderRadiusSchema.optional().describe('Border radius scale'),
+    /** Shadows */
+    shadows: exports.ShadowSchema.optional().describe('Box shadow effects'),
+    /** Breakpoints */
+    breakpoints: exports.BreakpointsSchema.optional().describe('Responsive breakpoints'),
+    /** Animation */
+    animation: exports.AnimationSchema.optional().describe('Animation settings'),
+    /** Z-Index */
+    zIndex: exports.ZIndexSchema.optional().describe('Z-index scale for layering'),
+    /** Custom CSS variables */
+    customVars: zod_1.z.record(zod_1.z.string()).optional().describe('Custom CSS variables (key-value pairs)'),
+    /** Logo */
+    logo: zod_1.z.object({
+        light: zod_1.z.string().optional().describe('Logo URL for light mode'),
+        dark: zod_1.z.string().optional().describe('Logo URL for dark mode'),
+        favicon: zod_1.z.string().optional().describe('Favicon URL'),
+    }).optional().describe('Logo assets'),
+    /** Extends another theme */
+    extends: zod_1.z.string().optional().describe('Base theme to extend from'),
+});

package/dist/ui/widget.zod.d.ts

@@ -0,0 +1,350 @@
+import { z } from 'zod';
+/**
+ * Field Widget Props Schema
+ *
+ * This defines the contract for custom field components and plugin UI extensions.
+ * Third-party developers use this interface to build custom field widgets that integrate
+ * seamlessly with the ObjectStack UI system.
+ *
+ * @example
+ * // Custom widget implementation
+ * function CustomDatePicker(props: FieldWidgetProps) {
+ *   const { value, onChange, readonly, required, error, field, record, options } = props;
+ *   // Widget implementation...
+ * }
+ */
+export declare const FieldWidgetPropsSchema: z.ZodObject<{
+    /**
+     * Current field value.
+     * Type depends on the field type (string, number, boolean, array, object, etc.)
+     */
+    value: z.ZodAny;
+    /**
+     * Callback function to update the field value.
+     * Should be called when user interaction changes the value.
+     *
+     * @param newValue - The new value to set
+     */
+    onChange: z.ZodFunction<z.ZodTuple<[z.ZodAny], z.ZodUnknown>, z.ZodVoid>;
+    /**
+     * Whether the field is in read-only mode.
+     * When true, the widget should display the value but not allow editing.
+     */
+    readonly: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Whether the field is required.
+     * Widget should indicate required state visually and validate accordingly.
+     */
+    required: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Validation error message to display.
+     * When present, widget should display the error in its UI.
+     */
+    error: z.ZodOptional<z.ZodString>;
+    /**
+     * Complete field definition from the schema.
+     * Contains metadata like type, constraints, options, etc.
+     */
+    field: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<["text", "textarea", "email", "url", "phone", "password", "markdown", "html", "richtext", "number", "currency", "percent", "date", "datetime", "time", "boolean", "select", "lookup", "master_detail", "image", "file", "avatar", "formula", "summary", "autonumber", "location", "address", "code", "color", "rating", "signature"]>;
+        description: z.ZodOptional<z.ZodString>;
+        format: z.ZodOptional<z.ZodString>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        searchable: z.ZodDefault<z.ZodBoolean>;
+        multiple: z.ZodDefault<z.ZodBoolean>;
+        unique: z.ZodDefault<z.ZodBoolean>;
+        defaultValue: z.ZodOptional<z.ZodAny>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        precision: z.ZodOptional<z.ZodNumber>;
+        scale: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+            color: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            label: string;
+            color?: string | undefined;
+            default?: boolean | undefined;
+        }, {
+            value: string;
+            label: string;
+            color?: string | undefined;
+            default?: boolean | undefined;
+        }>, "many">>;
+        reference: z.ZodOptional<z.ZodString>;
+        referenceFilters: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        writeRequiresMasterRead: z.ZodOptional<z.ZodBoolean>;
+        deleteBehavior: z.ZodDefault<z.ZodOptional<z.ZodEnum<["set_null", "cascade", "restrict"]>>>;
+        expression: z.ZodOptional<z.ZodString>;
+        formula: z.ZodOptional<z.ZodString>;
+        summaryOperations: z.ZodOptional<z.ZodObject<{
+            object: z.ZodString;
+            field: z.ZodString;
+            function: z.ZodEnum<["count", "sum", "min", "max", "avg"]>;
+        }, "strip", z.ZodTypeAny, {
+            object: string;
+            function: "min" | "max" | "count" | "sum" | "avg";
+            field: string;
+        }, {
+            object: string;
+            function: "min" | "max" | "count" | "sum" | "avg";
+            field: string;
+        }>>;
+        language: z.ZodOptional<z.ZodString>;
+        theme: z.ZodOptional<z.ZodString>;
+        lineNumbers: z.ZodOptional<z.ZodBoolean>;
+        maxRating: z.ZodOptional<z.ZodNumber>;
+        allowHalf: z.ZodOptional<z.ZodBoolean>;
+        displayMap: z.ZodOptional<z.ZodBoolean>;
+        allowGeocoding: z.ZodOptional<z.ZodBoolean>;
+        addressFormat: z.ZodOptional<z.ZodEnum<["us", "uk", "international"]>>;
+        colorFormat: z.ZodOptional<z.ZodEnum<["hex", "rgb", "rgba", "hsl"]>>;
+        allowAlpha: z.ZodOptional<z.ZodBoolean>;
+        presetColors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        hidden: z.ZodDefault<z.ZodBoolean>;
+        readonly: z.ZodDefault<z.ZodBoolean>;
+        encryption: z.ZodDefault<z.ZodBoolean>;
+        index: z.ZodDefault<z.ZodBoolean>;
+        externalId: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "signature";
+        required: boolean;
+        searchable: boolean;
+        multiple: boolean;
+        unique: boolean;
+        deleteBehavior: "set_null" | "cascade" | "restrict";
+        hidden: boolean;
+        readonly: boolean;
+        encryption: boolean;
+        index: boolean;
+        externalId: boolean;
+        formula?: string | undefined;
+        options?: {
+            value: string;
+            label: string;
+            color?: string | undefined;
+            default?: boolean | undefined;
+        }[] | undefined;
+        label?: string | undefined;
+        name?: string | undefined;
+        description?: string | undefined;
+        format?: string | undefined;
+        defaultValue?: any;
+        maxLength?: number | undefined;
+        minLength?: number | undefined;
+        precision?: number | undefined;
+        scale?: number | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        reference?: string | undefined;
+        referenceFilters?: string[] | undefined;
+        writeRequiresMasterRead?: boolean | undefined;
+        expression?: string | undefined;
+        summaryOperations?: {
+            object: string;
+            function: "min" | "max" | "count" | "sum" | "avg";
+            field: string;
+        } | undefined;
+        language?: string | undefined;
+        theme?: string | undefined;
+        lineNumbers?: boolean | undefined;
+        maxRating?: number | undefined;
+        allowHalf?: boolean | undefined;
+        displayMap?: boolean | undefined;
+        allowGeocoding?: boolean | undefined;
+        addressFormat?: "us" | "uk" | "international" | undefined;
+        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+        allowAlpha?: boolean | undefined;
+        presetColors?: string[] | undefined;
+    }, {
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "signature";
+        formula?: string | undefined;
+        options?: {
+            value: string;
+            label: string;
+            color?: string | undefined;
+            default?: boolean | undefined;
+        }[] | undefined;
+        label?: string | undefined;
+        name?: string | undefined;
+        description?: string | undefined;
+        format?: string | undefined;
+        required?: boolean | undefined;
+        searchable?: boolean | undefined;
+        multiple?: boolean | undefined;
+        unique?: boolean | undefined;
+        defaultValue?: any;
+        maxLength?: number | undefined;
+        minLength?: number | undefined;
+        precision?: number | undefined;
+        scale?: number | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        reference?: string | undefined;
+        referenceFilters?: string[] | undefined;
+        writeRequiresMasterRead?: boolean | undefined;
+        deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+        expression?: string | undefined;
+        summaryOperations?: {
+            object: string;
+            function: "min" | "max" | "count" | "sum" | "avg";
+            field: string;
+        } | undefined;
+        language?: string | undefined;
+        theme?: string | undefined;
+        lineNumbers?: boolean | undefined;
+        maxRating?: number | undefined;
+        allowHalf?: boolean | undefined;
+        displayMap?: boolean | undefined;
+        allowGeocoding?: boolean | undefined;
+        addressFormat?: "us" | "uk" | "international" | undefined;
+        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+        allowAlpha?: boolean | undefined;
+        presetColors?: string[] | undefined;
+        hidden?: boolean | undefined;
+        readonly?: boolean | undefined;
+        encryption?: boolean | undefined;
+        index?: boolean | undefined;
+        externalId?: boolean | undefined;
+    }>;
+    /**
+     * The complete record/document being edited.
+     * Useful for conditional logic and cross-field dependencies.
+     */
+    record: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /**
+     * Custom options passed to the widget.
+     * Can contain widget-specific configuration like themes, behaviors, etc.
+     */
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    required: boolean;
+    field: {
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "signature";
+        required: boolean;
+        searchable: boolean;
+        multiple: boolean;
+        unique: boolean;
+        deleteBehavior: "set_null" | "cascade" | "restrict";
+        hidden: boolean;
+        readonly: boolean;
+        encryption: boolean;
+        index: boolean;
+        externalId: boolean;
+        formula?: string | undefined;
+        options?: {
+            value: string;
+            label: string;
+            color?: string | undefined;
+            default?: boolean | undefined;
+        }[] | undefined;
+        label?: string | undefined;
+        name?: string | undefined;
+        description?: string | undefined;
+        format?: string | undefined;
+        defaultValue?: any;
+        maxLength?: number | undefined;
+        minLength?: number | undefined;
+        precision?: number | undefined;
+        scale?: number | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        reference?: string | undefined;
+        referenceFilters?: string[] | undefined;
+        writeRequiresMasterRead?: boolean | undefined;
+        expression?: string | undefined;
+        summaryOperations?: {
+            object: string;
+            function: "min" | "max" | "count" | "sum" | "avg";
+            field: string;
+        } | undefined;
+        language?: string | undefined;
+        theme?: string | undefined;
+        lineNumbers?: boolean | undefined;
+        maxRating?: number | undefined;
+        allowHalf?: boolean | undefined;
+        displayMap?: boolean | undefined;
+        allowGeocoding?: boolean | undefined;
+        addressFormat?: "us" | "uk" | "international" | undefined;
+        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+        allowAlpha?: boolean | undefined;
+        presetColors?: string[] | undefined;
+    };
+    readonly: boolean;
+    onChange: (args_0: any, ...args: unknown[]) => void;
+    value?: any;
+    options?: Record<string, any> | undefined;
+    error?: string | undefined;
+    record?: Record<string, any> | undefined;
+}, {
+    field: {
+        type: "number" | "boolean" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "date" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "address" | "code" | "color" | "rating" | "signature";
+        formula?: string | undefined;
+        options?: {
+            value: string;
+            label: string;
+            color?: string | undefined;
+            default?: boolean | undefined;
+        }[] | undefined;
+        label?: string | undefined;
+        name?: string | undefined;
+        description?: string | undefined;
+        format?: string | undefined;
+        required?: boolean | undefined;
+        searchable?: boolean | undefined;
+        multiple?: boolean | undefined;
+        unique?: boolean | undefined;
+        defaultValue?: any;
+        maxLength?: number | undefined;
+        minLength?: number | undefined;
+        precision?: number | undefined;
+        scale?: number | undefined;
+        min?: number | undefined;
+        max?: number | undefined;
+        reference?: string | undefined;
+        referenceFilters?: string[] | undefined;
+        writeRequiresMasterRead?: boolean | undefined;
+        deleteBehavior?: "set_null" | "cascade" | "restrict" | undefined;
+        expression?: string | undefined;
+        summaryOperations?: {
+            object: string;
+            function: "min" | "max" | "count" | "sum" | "avg";
+            field: string;
+        } | undefined;
+        language?: string | undefined;
+        theme?: string | undefined;
+        lineNumbers?: boolean | undefined;
+        maxRating?: number | undefined;
+        allowHalf?: boolean | undefined;
+        displayMap?: boolean | undefined;
+        allowGeocoding?: boolean | undefined;
+        addressFormat?: "us" | "uk" | "international" | undefined;
+        colorFormat?: "hex" | "rgb" | "rgba" | "hsl" | undefined;
+        allowAlpha?: boolean | undefined;
+        presetColors?: string[] | undefined;
+        hidden?: boolean | undefined;
+        readonly?: boolean | undefined;
+        encryption?: boolean | undefined;
+        index?: boolean | undefined;
+        externalId?: boolean | undefined;
+    };
+    onChange: (args_0: any, ...args: unknown[]) => void;
+    value?: any;
+    options?: Record<string, any> | undefined;
+    required?: boolean | undefined;
+    readonly?: boolean | undefined;
+    error?: string | undefined;
+    record?: Record<string, any> | undefined;
+}>;
+/**
+ * TypeScript type for Field Widget Props
+ */
+export type FieldWidgetProps = z.infer<typeof FieldWidgetPropsSchema>;
+//# sourceMappingURL=widget.zod.d.ts.map

package/dist/ui/widget.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.zod.d.ts","sourceRoot":"","sources":["../../src/ui/widget.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;OAGG;;IAGH;;;;;OAKG;;IAMH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/ui/widget.zod.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FieldWidgetPropsSchema = void 0;
+const zod_1 = require("zod");
+const field_zod_1 = require("../data/field.zod");
+/**
+ * Field Widget Props Schema
+ *
+ * This defines the contract for custom field components and plugin UI extensions.
+ * Third-party developers use this interface to build custom field widgets that integrate
+ * seamlessly with the ObjectStack UI system.
+ *
+ * @example
+ * // Custom widget implementation
+ * function CustomDatePicker(props: FieldWidgetProps) {
+ *   const { value, onChange, readonly, required, error, field, record, options } = props;
+ *   // Widget implementation...
+ * }
+ */
+exports.FieldWidgetPropsSchema = zod_1.z.object({
+    /**
+     * Current field value.
+     * Type depends on the field type (string, number, boolean, array, object, etc.)
+     */
+    value: zod_1.z.any().describe('Current field value'),
+    /**
+     * Callback function to update the field value.
+     * Should be called when user interaction changes the value.
+     *
+     * @param newValue - The new value to set
+     */
+    onChange: zod_1.z.function()
+        .args(zod_1.z.any())
+        .returns(zod_1.z.void())
+        .describe('Callback to update field value'),
+    /**
+     * Whether the field is in read-only mode.
+     * When true, the widget should display the value but not allow editing.
+     */
+    readonly: zod_1.z.boolean().default(false).describe('Read-only mode flag'),
+    /**
+     * Whether the field is required.
+     * Widget should indicate required state visually and validate accordingly.
+     */
+    required: zod_1.z.boolean().default(false).describe('Required field flag'),
+    /**
+     * Validation error message to display.
+     * When present, widget should display the error in its UI.
+     */
+    error: zod_1.z.string().optional().describe('Validation error message'),
+    /**
+     * Complete field definition from the schema.
+     * Contains metadata like type, constraints, options, etc.
+     */
+    field: field_zod_1.FieldSchema.describe('Field schema definition'),
+    /**
+     * The complete record/document being edited.
+     * Useful for conditional logic and cross-field dependencies.
+     */
+    record: zod_1.z.record(zod_1.z.any()).optional().describe('Complete record data'),
+    /**
+     * Custom options passed to the widget.
+     * Can contain widget-specific configuration like themes, behaviors, etc.
+     */
+    options: zod_1.z.record(zod_1.z.any()).optional().describe('Custom widget options'),
+});

package/json-schema/AccountLinkingConfig.json

@@ -0,0 +1,27 @@
+{
+  "$ref": "#/definitions/AccountLinkingConfig",
+  "definitions": {
+    "AccountLinkingConfig": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Allow account linking"
+        },
+        "autoLink": {
+          "type": "boolean",
+          "default": false,
+          "description": "Automatically link accounts with same email"
+        },
+        "requireVerification": {
+          "type": "boolean",
+          "default": true,
+          "description": "Require email verification before linking"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}