@object-ui/core 17.6.0 → 17.7.0

package/dist/data-scope/DataScopeManager.d.ts

@@ -1,127 +0,0 @@
-/**
- * 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.
- */
-/**
- * @object-ui/core - DataScope Manager
- *
- * Runtime implementation of the DataContext interface for managing
- * named data scopes. Provides row-level data access control and
- * reactive data state management within the UI component tree.
- *
- * @module data-scope
- * @packageDocumentation
- */
-import type { DataScope, DataContext, DataSource } from '@object-ui/types';
-/**
- * Row-level filter for restricting data access within a scope
- */
-export interface RowLevelFilter {
-    /** Field to filter on */
-    field: string;
-    /** Filter operator */
-    operator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'in' | 'nin' | 'contains';
-    /** Filter value */
-    value: any;
-}
-/**
- * Configuration for creating a data scope
- */
-export interface DataScopeConfig {
-    /** Data source instance */
-    dataSource?: DataSource;
-    /** Initial data */
-    data?: any;
-    /** Row-level filters to apply */
-    filters?: RowLevelFilter[];
-    /** Whether this scope is read-only */
-    readOnly?: boolean;
-}
-/**
- * DataScopeManager — Runtime implementation of DataContext.
- *
- * Manages named data scopes for the component tree, providing:
- * - Scope registration and lookup
- * - Row-level security via filters
- * - Data state management (data, loading, error)
- *
- * @example
- * ```ts
- * const manager = new DataScopeManager();
- * manager.registerScope('contacts', {
- *   dataSource: myDataSource,
- *   data: [],
- * });
- * const scope = manager.getScope('contacts');
- * ```
- */
-export declare class DataScopeManager implements DataContext {
-    scopes: Record<string, DataScope>;
-    private filters;
-    private readOnlyScopes;
-    private listeners;
-    /**
-     * Register a data scope
-     */
-    registerScope(name: string, scope: DataScope): void;
-    /**
-     * Register a data scope with configuration
-     */
-    registerScopeWithConfig(name: string, config: DataScopeConfig): void;
-    /**
-     * Get a data scope by name
-     */
-    getScope(name: string): DataScope | undefined;
-    /**
-     * Remove a data scope
-     */
-    removeScope(name: string): void;
-    /**
-     * Check if a scope is read-only
-     */
-    isReadOnly(name: string): boolean;
-    /**
-     * Get row-level filters for a scope
-     */
-    getFilters(name: string): RowLevelFilter[];
-    /**
-     * Set row-level filters for a scope
-     */
-    setFilters(name: string, filters: RowLevelFilter[]): void;
-    /**
-     * Apply row-level filters to a dataset
-     */
-    applyFilters(name: string, data: any[]): any[];
-    /**
-     * Update data in a scope
-     */
-    updateScopeData(name: string, data: any): void;
-    /**
-     * Update loading state for a scope
-     */
-    updateScopeLoading(name: string, loading: boolean): void;
-    /**
-     * Update error state for a scope
-     */
-    updateScopeError(name: string, error: Error | string | null): void;
-    /**
-     * Subscribe to scope changes
-     */
-    onScopeChange(name: string, listener: (scope: DataScope) => void): () => void;
-    /**
-     * Get all registered scope names
-     */
-    getScopeNames(): string[];
-    /**
-     * Clear all scopes
-     */
-    clear(): void;
-    private notifyListeners;
-}
-/**
- * Default DataScopeManager instance
- */
-export declare const defaultDataScopeManager: DataScopeManager;

package/dist/data-scope/DataScopeManager.js

@@ -1,229 +0,0 @@
-/**
- * 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.
- */
-/**
- * DataScopeManager — Runtime implementation of DataContext.
- *
- * Manages named data scopes for the component tree, providing:
- * - Scope registration and lookup
- * - Row-level security via filters
- * - Data state management (data, loading, error)
- *
- * @example
- * ```ts
- * const manager = new DataScopeManager();
- * manager.registerScope('contacts', {
- *   dataSource: myDataSource,
- *   data: [],
- * });
- * const scope = manager.getScope('contacts');
- * ```
- */
-export class DataScopeManager {
-    constructor() {
-        Object.defineProperty(this, "scopes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "filters", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: {}
-        });
-        Object.defineProperty(this, "readOnlyScopes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Set()
-        });
-        Object.defineProperty(this, "listeners", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Map()
-        });
-    }
-    /**
-     * Register a data scope
-     */
-    registerScope(name, scope) {
-        this.scopes[name] = scope;
-        this.notifyListeners(name, scope);
-    }
-    /**
-     * Register a data scope with configuration
-     */
-    registerScopeWithConfig(name, config) {
-        const scope = {
-            dataSource: config.dataSource,
-            data: config.data,
-            loading: false,
-            error: null,
-        };
-        if (config.filters) {
-            this.filters[name] = config.filters;
-        }
-        if (config.readOnly) {
-            this.readOnlyScopes.add(name);
-        }
-        this.scopes[name] = scope;
-        this.notifyListeners(name, scope);
-    }
-    /**
-     * Get a data scope by name
-     */
-    getScope(name) {
-        return this.scopes[name];
-    }
-    /**
-     * Remove a data scope
-     */
-    removeScope(name) {
-        delete this.scopes[name];
-        delete this.filters[name];
-        this.readOnlyScopes.delete(name);
-        this.listeners.delete(name);
-    }
-    /**
-     * Check if a scope is read-only
-     */
-    isReadOnly(name) {
-        return this.readOnlyScopes.has(name);
-    }
-    /**
-     * Get row-level filters for a scope
-     */
-    getFilters(name) {
-        return this.filters[name] || [];
-    }
-    /**
-     * Set row-level filters for a scope
-     */
-    setFilters(name, filters) {
-        this.filters[name] = filters;
-    }
-    /**
-     * Apply row-level filters to a dataset
-     */
-    applyFilters(name, data) {
-        const scopeFilters = this.filters[name];
-        if (!scopeFilters || scopeFilters.length === 0) {
-            return data;
-        }
-        return data.filter(row => {
-            return scopeFilters.every(filter => {
-                const fieldValue = row[filter.field];
-                return evaluateFilter(fieldValue, filter.operator, filter.value);
-            });
-        });
-    }
-    /**
-     * Update data in a scope
-     */
-    updateScopeData(name, data) {
-        const scope = this.scopes[name];
-        if (!scope)
-            return;
-        if (this.readOnlyScopes.has(name)) {
-            throw new Error(`Cannot update read-only scope: ${name}`);
-        }
-        scope.data = data;
-        this.notifyListeners(name, scope);
-    }
-    /**
-     * Update loading state for a scope
-     */
-    updateScopeLoading(name, loading) {
-        const scope = this.scopes[name];
-        if (!scope)
-            return;
-        scope.loading = loading;
-        this.notifyListeners(name, scope);
-    }
-    /**
-     * Update error state for a scope
-     */
-    updateScopeError(name, error) {
-        const scope = this.scopes[name];
-        if (!scope)
-            return;
-        scope.error = error;
-        this.notifyListeners(name, scope);
-    }
-    /**
-     * Subscribe to scope changes
-     */
-    onScopeChange(name, listener) {
-        if (!this.listeners.has(name)) {
-            this.listeners.set(name, []);
-        }
-        this.listeners.get(name).push(listener);
-        return () => {
-            const arr = this.listeners.get(name);
-            if (arr) {
-                const idx = arr.indexOf(listener);
-                if (idx >= 0)
-                    arr.splice(idx, 1);
-            }
-        };
-    }
-    /**
-     * Get all registered scope names
-     */
-    getScopeNames() {
-        return Object.keys(this.scopes);
-    }
-    /**
-     * Clear all scopes
-     */
-    clear() {
-        this.scopes = {};
-        this.filters = {};
-        this.readOnlyScopes.clear();
-        this.listeners.clear();
-    }
-    notifyListeners(name, scope) {
-        const arr = this.listeners.get(name);
-        if (arr) {
-            arr.forEach(listener => listener(scope));
-        }
-    }
-}
-/**
- * Evaluate a single filter condition against a field value
- */
-function evaluateFilter(fieldValue, operator, filterValue) {
-    switch (operator) {
-        case 'eq':
-            return fieldValue === filterValue;
-        case 'ne':
-            return fieldValue !== filterValue;
-        case 'gt':
-            return fieldValue > filterValue;
-        case 'lt':
-            return fieldValue < filterValue;
-        case 'gte':
-            return fieldValue >= filterValue;
-        case 'lte':
-            return fieldValue <= filterValue;
-        case 'in':
-            return Array.isArray(filterValue) && filterValue.includes(fieldValue);
-        case 'nin':
-            return Array.isArray(filterValue) && !filterValue.includes(fieldValue);
-        case 'contains':
-            return typeof fieldValue === 'string' && fieldValue.includes(String(filterValue));
-        default:
-            return true;
-    }
-}
-/**
- * Default DataScopeManager instance
- */
-export const defaultDataScopeManager = new DataScopeManager();

package/dist/protocols/ResponsiveProtocol.d.ts

@@ -1,73 +0,0 @@
-/**
- * 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.
- */
-/**
- * @object-ui/core - Responsive Protocol Bridge
- *
- * Converts spec-aligned ResponsiveConfig schemas into Tailwind CSS
- * utility classes for visibility, grid columns, and ordering across
- * breakpoints. Also provides runtime width-based visibility checks.
- *
- * @module protocols/ResponsiveProtocol
- * @packageDocumentation
- */
-import type { SpecResponsiveConfig } from '@object-ui/types';
-/** Breakpoint name type matching Tailwind defaults. */
-export type BreakpointKey = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
-/** Breakpoint minimum pixel widths aligned with Tailwind CSS defaults. */
-export declare const BREAKPOINT_VALUES: Record<BreakpointKey, number>;
-/** Fully resolved responsive configuration. */
-export interface ResolvedResponsiveConfig {
-    breakpoint?: BreakpointKey;
-    hiddenOn: BreakpointKey[];
-    columns: Partial<Record<BreakpointKey, number>>;
-    order: Partial<Record<BreakpointKey, number>>;
-}
-/**
- * Resolve a responsive configuration by applying defaults.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Fully resolved responsive configuration
- */
-export declare function resolveResponsiveConfig(config: SpecResponsiveConfig): ResolvedResponsiveConfig;
-/**
- * Generate Tailwind CSS classes for responsive visibility.
- *
- * If `breakpoint` is set, the element is hidden below that breakpoint
- * (e.g. breakpoint "md" → `['hidden', 'md:block']`).
- *
- * If `hiddenOn` contains breakpoints, the element is hidden at those
- * specific sizes (e.g. hiddenOn: ["sm", "lg"] → `['sm:hidden', 'md:block', 'lg:hidden', 'xl:block']`).
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Array of Tailwind CSS class strings
- */
-export declare function getVisibilityClasses(config: SpecResponsiveConfig): string[];
-/**
- * Generate Tailwind grid-cols classes for responsive column layouts.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Array of Tailwind CSS grid column class strings
- */
-export declare function getColumnClasses(config: SpecResponsiveConfig): string[];
-/**
- * Generate Tailwind order utility classes for responsive ordering.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Array of Tailwind CSS order class strings
- */
-export declare function getOrderClasses(config: SpecResponsiveConfig): string[];
-/**
- * Determine whether a component should be hidden at a given viewport width.
- *
- * Checks both the minimum `breakpoint` threshold and the `hiddenOn` list.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @param width - Current viewport width in pixels
- * @returns `true` if the component should be hidden at the given width
- */
-export declare function shouldHideAtBreakpoint(config: SpecResponsiveConfig, width: number): boolean;

package/dist/protocols/ResponsiveProtocol.js

@@ -1,158 +0,0 @@
-/**
- * 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.
- */
-/** Breakpoint minimum pixel widths aligned with Tailwind CSS defaults. */
-export const BREAKPOINT_VALUES = {
-    xs: 0,
-    sm: 640,
-    md: 768,
-    lg: 1024,
-    xl: 1280,
-    '2xl': 1536,
-};
-/** Ordered breakpoint keys from smallest to largest. */
-const BREAKPOINT_ORDER = ['xs', 'sm', 'md', 'lg', 'xl', '2xl'];
-// ============================================================================
-// Config Resolution
-// ============================================================================
-/**
- * Resolve a responsive configuration by applying defaults.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Fully resolved responsive configuration
- */
-export function resolveResponsiveConfig(config) {
-    return {
-        breakpoint: config.breakpoint,
-        hiddenOn: (config.hiddenOn ?? []),
-        columns: (config.columns ?? {}),
-        order: (config.order ?? {}),
-    };
-}
-// ============================================================================
-// Visibility Classes
-// ============================================================================
-/**
- * Generate Tailwind CSS classes for responsive visibility.
- *
- * If `breakpoint` is set, the element is hidden below that breakpoint
- * (e.g. breakpoint "md" → `['hidden', 'md:block']`).
- *
- * If `hiddenOn` contains breakpoints, the element is hidden at those
- * specific sizes (e.g. hiddenOn: ["sm", "lg"] → `['sm:hidden', 'md:block', 'lg:hidden', 'xl:block']`).
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Array of Tailwind CSS class strings
- */
-export function getVisibilityClasses(config) {
-    const classes = [];
-    // Minimum breakpoint visibility
-    if (config.breakpoint) {
-        const bp = config.breakpoint;
-        if (bp !== 'xs') {
-            classes.push('hidden');
-            classes.push(`${bp}:block`);
-        }
-    }
-    // Per-breakpoint hidden overrides
-    const hiddenOn = (config.hiddenOn ?? []);
-    if (hiddenOn.length > 0) {
-        for (let i = 0; i < BREAKPOINT_ORDER.length; i++) {
-            const bp = BREAKPOINT_ORDER[i];
-            const isHidden = hiddenOn.includes(bp);
-            const prevHidden = i > 0 ? hiddenOn.includes(BREAKPOINT_ORDER[i - 1]) : false;
-            if (isHidden && !prevHidden) {
-                classes.push(bp === 'xs' ? 'hidden' : `${bp}:hidden`);
-            }
-            else if (!isHidden && prevHidden) {
-                classes.push(bp === 'xs' ? 'block' : `${bp}:block`);
-            }
-        }
-    }
-    return classes;
-}
-// ============================================================================
-// Column Classes
-// ============================================================================
-/**
- * Generate Tailwind grid-cols classes for responsive column layouts.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Array of Tailwind CSS grid column class strings
- */
-export function getColumnClasses(config) {
-    const classes = [];
-    const columns = (config.columns ?? {});
-    for (const bp of BREAKPOINT_ORDER) {
-        const cols = columns[bp];
-        if (cols == null)
-            continue;
-        const prefix = bp === 'xs' ? '' : `${bp}:`;
-        classes.push(`${prefix}grid-cols-${cols}`);
-    }
-    return classes;
-}
-// ============================================================================
-// Order Classes
-// ============================================================================
-/**
- * Generate Tailwind order utility classes for responsive ordering.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @returns Array of Tailwind CSS order class strings
- */
-export function getOrderClasses(config) {
-    const classes = [];
-    const order = (config.order ?? {});
-    for (const bp of BREAKPOINT_ORDER) {
-        const ord = order[bp];
-        if (ord == null)
-            continue;
-        const prefix = bp === 'xs' ? '' : `${bp}:`;
-        classes.push(`${prefix}order-${ord}`);
-    }
-    return classes;
-}
-// ============================================================================
-// Runtime Width Check
-// ============================================================================
-/**
- * Determine whether a component should be hidden at a given viewport width.
- *
- * Checks both the minimum `breakpoint` threshold and the `hiddenOn` list.
- *
- * @param config - SpecResponsiveConfig from the spec
- * @param width - Current viewport width in pixels
- * @returns `true` if the component should be hidden at the given width
- */
-export function shouldHideAtBreakpoint(config, width) {
-    // Check minimum breakpoint
-    if (config.breakpoint) {
-        const minWidth = BREAKPOINT_VALUES[config.breakpoint];
-        if (minWidth !== undefined && width < minWidth) {
-            return true;
-        }
-    }
-    // Check hiddenOn list
-    const hiddenOn = (config.hiddenOn ?? []);
-    if (hiddenOn.length > 0) {
-        const currentBp = getCurrentBreakpoint(width);
-        return hiddenOn.includes(currentBp);
-    }
-    return false;
-}
-/**
- * Determine the current breakpoint name for a given width.
- */
-function getCurrentBreakpoint(width) {
-    for (let i = BREAKPOINT_ORDER.length - 1; i >= 0; i--) {
-        if (width >= BREAKPOINT_VALUES[BREAKPOINT_ORDER[i]]) {
-            return BREAKPOINT_ORDER[i];
-        }
-    }
-    return 'xs';
-}

package/dist/validation/validation-engine.d.ts

@@ -1,88 +0,0 @@
-/**
- * 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.
- */
-/**
- * @object-ui/core - Validation Engine
- *
- * Phase 3.5: Complete validation engine implementation with support for:
- * - Sync and async validation
- * - Cross-field validation
- * - Custom validation functions
- * - Improved error messages
- *
- * @module validation-engine
- * @packageDocumentation
- */
-import type { AdvancedValidationSchema, ValidationFunction, AsyncValidationFunction, ValidationContext, AdvancedValidationResult, AdvancedValidationError } from '@object-ui/types';
-/**
- * Validation Engine - Executes validation rules
- */
-export declare class ValidationEngine {
-    private customValidators;
-    private customAsyncValidators;
-    /**
-     * Register a custom synchronous validator by name
-     */
-    registerValidator(name: string, fn: ValidationFunction): void;
-    /**
-     * Register a custom asynchronous validator by name
-     */
-    registerAsyncValidator(name: string, fn: AsyncValidationFunction): void;
-    /**
-     * Check if a custom validator is registered
-     */
-    hasValidator(name: string): boolean;
-    /**
-     * Get all registered custom validator names
-     */
-    getValidatorNames(): string[];
-    /**
-     * Validate a value against validation schema
-     */
-    validate(value: any, schema: AdvancedValidationSchema, context?: ValidationContext): Promise<AdvancedValidationResult>;
-    /**
-     * Validate a single rule
-     */
-    private validateRule;
-    /**
-     * Validate built-in rules
-     */
-    private validateBuiltInRule;
-    /**
-     * Evaluate a condition
-     * Note: Conditions must be declarative objects, not functions, for security.
-     */
-    private evaluateCondition;
-    /**
-     * Validate multiple fields
-     */
-    validateFields(values: Record<string, any>, schemas: Record<string, AdvancedValidationSchema>): Promise<Record<string, AdvancedValidationResult>>;
-    /**
-     * Check if all fields are valid
-     */
-    isValid(results: Record<string, AdvancedValidationResult>): boolean;
-    /**
-     * Get all errors from validation results
-     */
-    getAllErrors(results: Record<string, AdvancedValidationResult>): AdvancedValidationError[];
-    /**
-     * Get all warnings from validation results
-     */
-    getAllWarnings(results: Record<string, AdvancedValidationResult>): AdvancedValidationError[];
-}
-/**
- * Default validation engine instance
- */
-export declare const defaultValidationEngine: ValidationEngine;
-/**
- * Convenience function to validate a value
- */
-export declare function validate(value: any, schema: AdvancedValidationSchema, context?: ValidationContext): Promise<AdvancedValidationResult>;
-/**
- * Convenience function to validate multiple fields
- */
-export declare function validateFields(values: Record<string, any>, schemas: Record<string, AdvancedValidationSchema>): Promise<Record<string, AdvancedValidationResult>>;