@object-ui/core 3.1.5 → 3.3.1

package/dist/evaluator/index.d.ts

@@ -9,3 +9,4 @@ export * from './ExpressionContext.js';
 export * from './ExpressionEvaluator.js';
 export * from './ExpressionCache.js';
 export * from './FormulaFunctions.js';
+export * from './SafeExpressionParser.js';

package/dist/evaluator/index.js

@@ -9,3 +9,4 @@ export * from './ExpressionContext.js';
 export * from './ExpressionEvaluator.js';
 export * from './ExpressionCache.js';
 export * from './FormulaFunctions.js';
+export * from './SafeExpressionParser.js';

package/dist/protocols/DndProtocol.js

@@ -35,16 +35,10 @@ export function resolveDndConfig(config) {
  * @returns Component props object for a draggable element
  */
 export function createDragItemProps(item) {
-    const ariaLabel = typeof item.ariaLabel === 'string'
-        ? item.ariaLabel
-        : item.ariaLabel?.defaultValue;
-    const label = typeof item.label === 'string'
-        ? item.label
-        : item.label?.defaultValue;
     return {
         draggable: !(item.disabled ?? false),
         'aria-roledescription': 'draggable',
-        'aria-label': ariaLabel ?? label,
+        'aria-label': item.ariaLabel ?? item.label,
         'aria-describedby': item.ariaDescribedBy,
         role: item.role ?? 'listitem',
         'data-drag-type': item.type,
@@ -63,15 +57,9 @@ export function createDragItemProps(item) {
  * @returns Component props object for a droppable area
  */
 export function createDropZoneProps(zone) {
-    const ariaLabel = typeof zone.ariaLabel === 'string'
-        ? zone.ariaLabel
-        : zone.ariaLabel?.defaultValue;
-    const label = typeof zone.label === 'string'
-        ? zone.label
-        : zone.label?.defaultValue;
     return {
         'aria-dropeffect': zone.dropEffect ?? 'move',
-        'aria-label': ariaLabel ?? label,
+        'aria-label': zone.ariaLabel ?? zone.label,
         'aria-describedby': zone.ariaDescribedBy,
         role: zone.role ?? 'list',
         'data-drop-accept': zone.accept.join(','),

package/dist/protocols/KeyboardProtocol.js

@@ -15,14 +15,11 @@
  * @returns Fully resolved keyboard navigation configuration
  */
 export function resolveKeyboardConfig(config) {
-    const ariaLabel = typeof config.ariaLabel === 'string'
-        ? config.ariaLabel
-        : config.ariaLabel?.defaultValue;
     return {
         shortcuts: config.shortcuts ?? [],
         focusManagement: resolveFocusManagement(config.focusManagement),
         rovingTabindex: config.rovingTabindex ?? false,
-        ariaLabel,
+        ariaLabel: config.ariaLabel,
         ariaDescribedBy: config.ariaDescribedBy,
         role: config.role,
     };

package/dist/protocols/NotificationProtocol.js

@@ -65,16 +65,6 @@ export function resolveNotificationConfig(config) {
 // ============================================================================
 // Spec Notification → Toast
 // ============================================================================
-/**
- * Extract the display string from a translatable value (string or Translation object).
- */
-function resolveTranslatableString(value) {
-    if (value === undefined)
-        return undefined;
-    if (typeof value === 'string')
-        return value;
-    return value.defaultValue;
-}
 /**
  * Convert a spec Notification to a toast-compatible object.
  *
@@ -83,13 +73,13 @@ function resolveTranslatableString(value) {
  */
 export function specNotificationToToast(notification) {
     const actions = (notification.actions ?? []).map((a) => ({
-        label: typeof a.label === 'string' ? a.label : a.label?.defaultValue ?? '',
+        label: a.label,
         action: a.action,
         variant: a.variant ?? 'primary',
     }));
     return {
-        title: resolveTranslatableString(notification.title),
-        description: resolveTranslatableString(notification.message) ?? '',
+        title: notification.title,
+        description: notification.message ?? '',
         variant: mapSeverityToVariant(notification.severity ?? 'info'),
         position: mapPosition(notification.position ?? 'top_right'),
         duration: notification.duration ?? 5000,

package/dist/utils/debug.js

@@ -66,7 +66,8 @@ export function isDebugEnabled() {
         if (g === true || g === 'true')
             return true;
         // 3. process.env
-        if (typeof process !== 'undefined' && process.env?.OBJECTUI_DEBUG === 'true')
+        const proc = globalThis.process;
+        if (proc?.env?.OBJECTUI_DEBUG === 'true')
             return true;
         return false;
     }

package/dist/utils/filter-converter.js

@@ -12,6 +12,9 @@
  * @returns ObjectStack operator or null if not recognized
  */
 export function convertOperatorToAST(operator) {
+    // Spec reference: framework/packages/spec/src/data/filter.zod.ts
+    // Canonical MongoDB-style keys are camelCase ($startsWith, $endsWith, $notContains).
+    // Lowercase aliases are accepted for tolerance.
     const operatorMap = {
         '$eq': '=',
         '$ne': '!=',
@@ -20,11 +23,16 @@ export function convertOperatorToAST(operator) {
         '$lt': '<',
         '$lte': '<=',
         '$in': 'in',
-        '$nin': 'notin',
-        '$notin': 'notin',
+        '$nin': 'nin',
+        '$notin': 'nin',
+        '$between': 'between',
         '$contains': 'contains',
+        '$notContains': 'notcontains',
+        '$notcontains': 'notcontains',
+        '$startsWith': 'startswith',
         '$startswith': 'startswith',
-        '$between': 'between',
+        '$endsWith': 'endswith',
+        '$endswith': 'endswith',
     };
     return operatorMap[operator] || null;
 }
@@ -66,10 +74,21 @@ export function convertFiltersToAST(filter) {
                     console.warn(`[ObjectUI] Warning: $regex operator is not fully supported. ` +
                         `Converting to 'contains' which only supports substring matching, not regex patterns. ` +
                         `Field: '${field}', Value: ${JSON.stringify(operatorValue)}. ` +
-                        `Consider using $contains or $startswith instead.`);
+                        `Consider using $contains or $startsWith instead.`);
                     conditions.push([field, 'contains', operatorValue]);
                     continue;
                 }
+                // $null / $exists translate based on their boolean value (per spec semantics).
+                // $null: true  → IS NULL    | $null: false  → IS NOT NULL
+                // $exists: true → IS NOT NULL | $exists: false → IS NULL
+                if (operator === '$null') {
+                    conditions.push([field, operatorValue ? 'is_null' : 'is_not_null', true]);
+                    continue;
+                }
+                if (operator === '$exists') {
+                    conditions.push([field, operatorValue ? 'is_not_null' : 'is_null', true]);
+                    continue;
+                }
                 const astOperator = convertOperatorToAST(operator);
                 if (astOperator) {
                     conditions.push([field, astOperator, operatorValue]);
@@ -77,7 +96,8 @@ export function convertFiltersToAST(filter) {
                 else {
                     // Unknown operator - throw error to avoid silent failure
                     throw new Error(`[ObjectUI] Unknown filter operator '${operator}' for field '${field}'. ` +
-                        `Supported operators: $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $contains, $startswith, $between. ` +
+                        `Supported operators: $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $between, ` +
+                        `$contains, $notContains, $startsWith, $endsWith, $null, $exists. ` +
                         `If you need exact object matching, use the value directly without an operator.`);
                 }
             }

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@object-ui/core",
-  "version": "3.1.5",
+  "version": "3.3.1",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
   "description": "Core logic, types, and validation for Object UI. Zero React dependencies.",
-  "homepage": "https://www.objectui.org",
+  "homepage": "https://www.objectui.org/docs/core",
   "repository": {
     "type": "git",
-    "url": "https://github.com/objectstack-ai/objectui.git",
+    "url": "git+https://github.com/objectstack-ai/objectui.git",
     "directory": "packages/core"
   },
   "bugs": {
@@ -25,15 +25,39 @@
     }
   },
   "dependencies": {
-    "@objectstack/spec": "^3.3.0",
-    "lodash": "^4.17.23",
-    "zod": "^4.3.6",
-    "@object-ui/types": "3.1.5"
+    "@objectstack/spec": "^4.0.4",
+    "lodash": "^4.18.1",
+    "zod": "^4.4.3",
+    "@object-ui/types": "3.3.1"
   },
   "devDependencies": {
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   },
+  "keywords": [
+    "objectui",
+    "sdui",
+    "schema-driven-ui",
+    "react",
+    "tailwind",
+    "shadcn",
+    "objectstack",
+    "core",
+    "engine",
+    "expression-engine",
+    "action-engine",
+    "registry"
+  ],
+  "author": "ObjectStack Team <team@objectstack.ai>",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsc",
     "test": "vitest run",

package/.turbo/turbo-build.log

@@ -1,4 +0,0 @@
-
-> @object-ui/core@3.1.5 build /home/runner/work/objectui/objectui/packages/core
-> tsc
-

package/src/__benchmarks__/core.bench.ts

@@ -1,64 +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.
- */
-
-/**
- * Performance benchmark suite for @object-ui/core.
- *
- * Part of Q1 2026 roadmap §1.4 Test Coverage Improvement.
- *
- * Run with: npx vitest bench packages/core/src/__benchmarks__/
- */
-
-import { bench, describe } from 'vitest';
-import { ExpressionEvaluator } from '@object-ui/core';
-import { ComponentRegistry } from '@object-ui/core';
-import { contrastRatio, meetsContrastLevel, hexToHSL } from '@object-ui/core';
-
-describe('ExpressionEvaluator performance', () => {
-  const evaluator = new ExpressionEvaluator({ data: { name: 'Alice', age: 30, active: true } });
-
-  bench('evaluate simple string', () => {
-    evaluator.evaluate('Hello ${data.name}');
-  });
-
-  bench('evaluate 100 expressions', () => {
-    for (let i = 0; i < 100; i++) {
-      evaluator.evaluate('Hello ${data.name}');
-    }
-  });
-});
-
-describe('ComponentRegistry performance', () => {
-  bench('get registered component', () => {
-    ComponentRegistry.get('button');
-  });
-
-  bench('has check', () => {
-    ComponentRegistry.has('button');
-  });
-});
-
-describe('Theme utilities performance', () => {
-  bench('hexToHSL conversion', () => {
-    hexToHSL('#336699');
-  });
-
-  bench('contrastRatio calculation', () => {
-    contrastRatio('#000000', '#ffffff');
-  });
-
-  bench('meetsContrastLevel check', () => {
-    meetsContrastLevel('#000000', '#ffffff', 'AA');
-  });
-
-  bench('100 contrast checks', () => {
-    for (let i = 0; i < 100; i++) {
-      meetsContrastLevel('#336699', '#ffffff', 'AA');
-    }
-  });
-});

package/src/__tests__/protocols/DndProtocol.test.ts

@@ -1,186 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import type { DndConfig, DragItem, DropZone, DragConstraint } from '@object-ui/types';
-import {
-  resolveDndConfig,
-  createDragItemProps,
-  createDropZoneProps,
-  resolveDragConstraints,
-} from '../../protocols/DndProtocol';
-
-describe('DndProtocol', () => {
-  // ==========================================================================
-  // resolveDndConfig
-  // ==========================================================================
-  describe('resolveDndConfig', () => {
-    it('should apply all defaults for minimal config', () => {
-      const config = {} as DndConfig;
-      const resolved = resolveDndConfig(config);
-
-      expect(resolved.enabled).toBe(false);
-      expect(resolved.sortable).toBe(false);
-      expect(resolved.autoScroll).toBe(true);
-      expect(resolved.touchDelay).toBe(200);
-      expect(resolved.dragItem).toBeUndefined();
-      expect(resolved.dropZone).toBeUndefined();
-    });
-
-    it('should preserve explicit values', () => {
-      const config = {
-        enabled: true,
-        sortable: true,
-        autoScroll: false,
-        touchDelay: 500,
-      } as DndConfig;
-      const resolved = resolveDndConfig(config);
-
-      expect(resolved.enabled).toBe(true);
-      expect(resolved.sortable).toBe(true);
-      expect(resolved.autoScroll).toBe(false);
-      expect(resolved.touchDelay).toBe(500);
-    });
-
-    it('should pass through dragItem and dropZone', () => {
-      const dragItem = { type: 'card' } as DragItem;
-      const dropZone = { accept: ['card'] } as DropZone;
-      const config = { dragItem, dropZone } as DndConfig;
-      const resolved = resolveDndConfig(config);
-
-      expect(resolved.dragItem).toBe(dragItem);
-      expect(resolved.dropZone).toBe(dropZone);
-    });
-  });
-
-  // ==========================================================================
-  // createDragItemProps
-  // ==========================================================================
-  describe('createDragItemProps', () => {
-    it('should return correct props for a basic drag item', () => {
-      const item = { type: 'card', label: 'Task card' } as DragItem;
-      const props = createDragItemProps(item);
-
-      expect(props.draggable).toBe(true);
-      expect(props['aria-roledescription']).toBe('draggable');
-      expect(props['aria-label']).toBe('Task card');
-      expect(props.role).toBe('listitem');
-      expect(props['data-drag-type']).toBe('card');
-      expect(props['data-drag-handle']).toBe('element');
-      expect(props['data-drag-disabled']).toBe('false');
-    });
-
-    it('should set draggable false when disabled', () => {
-      const item = { type: 'card', disabled: true } as DragItem;
-      const props = createDragItemProps(item);
-
-      expect(props.draggable).toBe(false);
-      expect(props['data-drag-disabled']).toBe('true');
-    });
-
-    it('should use ariaLabel over label when both provided', () => {
-      const item = { type: 'card', label: 'Label', ariaLabel: 'Aria Label' } as DragItem;
-      const props = createDragItemProps(item);
-
-      expect(props['aria-label']).toBe('Aria Label');
-    });
-
-    it('should handle translation object for ariaLabel', () => {
-      const item = {
-        type: 'card',
-        ariaLabel: { key: 'drag.label', defaultValue: 'Translated label' },
-      } as unknown as DragItem;
-      const props = createDragItemProps(item);
-
-      expect(props['aria-label']).toBe('Translated label');
-    });
-
-    it('should use custom role and handle when provided', () => {
-      const item = { type: 'row', role: 'option', handle: 'grip' } as DragItem;
-      const props = createDragItemProps(item);
-
-      expect(props.role).toBe('option');
-      expect(props['data-drag-handle']).toBe('grip');
-    });
-  });
-
-  // ==========================================================================
-  // createDropZoneProps
-  // ==========================================================================
-  describe('createDropZoneProps', () => {
-    it('should return correct props for a basic drop zone', () => {
-      const zone = { accept: ['card', 'task'], label: 'Column' } as unknown as DropZone;
-      const props = createDropZoneProps(zone);
-
-      expect(props['aria-dropeffect']).toBe('move');
-      expect(props['aria-label']).toBe('Column');
-      expect(props.role).toBe('list');
-      expect(props['data-drop-accept']).toBe('card,task');
-      expect(props['data-drop-highlight']).toBe('true');
-    });
-
-    it('should use explicit dropEffect and role', () => {
-      const zone = { accept: ['item'], dropEffect: 'copy', role: 'region' } as unknown as DropZone;
-      const props = createDropZoneProps(zone);
-
-      expect(props['aria-dropeffect']).toBe('copy');
-      expect(props.role).toBe('region');
-    });
-
-    it('should set maxItems when provided', () => {
-      const zone = { accept: ['card'], maxItems: 10 } as unknown as DropZone;
-      const props = createDropZoneProps(zone);
-
-      expect(props['data-drop-max-items']).toBe(10);
-    });
-
-    it('should handle ariaLabel as translation object', () => {
-      const zone = {
-        accept: ['card'],
-        ariaLabel: { key: 'drop.label', defaultValue: 'Drop here' },
-      } as unknown as DropZone;
-      const props = createDropZoneProps(zone);
-
-      expect(props['aria-label']).toBe('Drop here');
-    });
-  });
-
-  // ==========================================================================
-  // resolveDragConstraints
-  // ==========================================================================
-  describe('resolveDragConstraints', () => {
-    it('should return base styles for default axis (both)', () => {
-      const constraint = {} as DragConstraint;
-      const styles = resolveDragConstraints(constraint);
-
-      expect(styles.position).toBe('relative');
-      expect(styles.touchAction).toBe('none');
-    });
-
-    it('should set touchAction to pan-y for x axis', () => {
-      const constraint = { axis: 'x' } as DragConstraint;
-      const styles = resolveDragConstraints(constraint);
-
-      expect(styles.touchAction).toBe('pan-y');
-    });
-
-    it('should set touchAction to pan-x for y axis', () => {
-      const constraint = { axis: 'y' } as DragConstraint;
-      const styles = resolveDragConstraints(constraint);
-
-      expect(styles.touchAction).toBe('pan-x');
-    });
-
-    it('should set overflow hidden for parent bounds', () => {
-      const constraint = { bounds: 'parent' } as DragConstraint;
-      const styles = resolveDragConstraints(constraint);
-
-      expect(styles.overflow).toBe('hidden');
-    });
-
-    it('should set grid CSS custom properties', () => {
-      const constraint = { grid: [20, 30] } as unknown as DragConstraint;
-      const styles = resolveDragConstraints(constraint);
-
-      expect(styles['--drag-grid-x']).toBe('20px');
-      expect(styles['--drag-grid-y']).toBe('30px');
-    });
-  });
-});

package/src/__tests__/protocols/KeyboardProtocol.test.ts

@@ -1,177 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import type { KeyboardNavigationConfig, FocusTrapConfig } from '@object-ui/types';
-import {
-  resolveKeyboardConfig,
-  parseShortcutKey,
-  matchesShortcut,
-  createFocusTrapConfig,
-} from '../../protocols/KeyboardProtocol';
-
-describe('KeyboardProtocol', () => {
-  // ==========================================================================
-  // resolveKeyboardConfig
-  // ==========================================================================
-  describe('resolveKeyboardConfig', () => {
-    it('should apply defaults for empty config', () => {
-      const config = {} as KeyboardNavigationConfig;
-      const resolved = resolveKeyboardConfig(config);
-
-      expect(resolved.shortcuts).toEqual([]);
-      expect(resolved.rovingTabindex).toBe(false);
-      expect(resolved.focusManagement.tabOrder).toBe('auto');
-      expect(resolved.focusManagement.skipLinks).toBe(false);
-      expect(resolved.focusManagement.focusVisible).toBe(true);
-      expect(resolved.focusManagement.arrowNavigation).toBe(false);
-      expect(resolved.focusManagement.focusTrap).toBeUndefined();
-    });
-
-    it('should resolve ariaLabel from string', () => {
-      const config = { ariaLabel: 'Navigation' } as KeyboardNavigationConfig;
-      const resolved = resolveKeyboardConfig(config);
-
-      expect(resolved.ariaLabel).toBe('Navigation');
-    });
-
-    it('should resolve ariaLabel from translation object', () => {
-      const config = {
-        ariaLabel: { key: 'nav.label', defaultValue: 'Nav panel' },
-      } as unknown as KeyboardNavigationConfig;
-      const resolved = resolveKeyboardConfig(config);
-
-      expect(resolved.ariaLabel).toBe('Nav panel');
-    });
-
-    it('should preserve explicit values', () => {
-      const config = {
-        rovingTabindex: true,
-        role: 'toolbar',
-        ariaDescribedBy: 'desc-id',
-      } as KeyboardNavigationConfig;
-      const resolved = resolveKeyboardConfig(config);
-
-      expect(resolved.rovingTabindex).toBe(true);
-      expect(resolved.role).toBe('toolbar');
-      expect(resolved.ariaDescribedBy).toBe('desc-id');
-    });
-  });
-
-  // ==========================================================================
-  // parseShortcutKey
-  // ==========================================================================
-  describe('parseShortcutKey', () => {
-    it('should parse Ctrl+S', () => {
-      const parsed = parseShortcutKey('Ctrl+S');
-
-      expect(parsed.key).toBe('s');
-      expect(parsed.ctrlOrMeta).toBe(true);
-      expect(parsed.shift).toBe(false);
-      expect(parsed.alt).toBe(false);
-    });
-
-    it('should parse Alt+Shift+N', () => {
-      const parsed = parseShortcutKey('Alt+Shift+N');
-
-      expect(parsed.key).toBe('n');
-      expect(parsed.ctrlOrMeta).toBe(false);
-      expect(parsed.shift).toBe(true);
-      expect(parsed.alt).toBe(true);
-    });
-
-    it('should parse single key Escape', () => {
-      const parsed = parseShortcutKey('Escape');
-
-      expect(parsed.key).toBe('escape');
-      expect(parsed.ctrlOrMeta).toBe(false);
-      expect(parsed.shift).toBe(false);
-      expect(parsed.alt).toBe(false);
-    });
-
-    it('should be case insensitive', () => {
-      const parsed = parseShortcutKey('ctrl+s');
-
-      expect(parsed.key).toBe('s');
-      expect(parsed.ctrlOrMeta).toBe(true);
-    });
-
-    it('should parse single key F1', () => {
-      const parsed = parseShortcutKey('F1');
-
-      expect(parsed.key).toBe('f1');
-      expect(parsed.ctrlOrMeta).toBe(false);
-      expect(parsed.shift).toBe(false);
-      expect(parsed.alt).toBe(false);
-    });
-
-    it('should recognise Meta as ctrlOrMeta', () => {
-      const parsed = parseShortcutKey('Meta+K');
-
-      expect(parsed.ctrlOrMeta).toBe(true);
-      expect(parsed.key).toBe('k');
-    });
-  });
-
-  // ==========================================================================
-  // matchesShortcut
-  // ==========================================================================
-  describe('matchesShortcut', () => {
-    it('should match Ctrl+S event', () => {
-      const event = { key: 's', ctrlKey: true };
-      expect(matchesShortcut(event, 'Ctrl+S')).toBe(true);
-    });
-
-    it('should match Meta+S event (Cmd on Mac)', () => {
-      const event = { key: 's', metaKey: true };
-      expect(matchesShortcut(event, 'Ctrl+S')).toBe(true);
-    });
-
-    it('should not match when key differs', () => {
-      const event = { key: 'a', ctrlKey: true };
-      expect(matchesShortcut(event, 'Ctrl+S')).toBe(false);
-    });
-
-    it('should not match when modifier is missing', () => {
-      const event = { key: 's' };
-      expect(matchesShortcut(event, 'Ctrl+S')).toBe(false);
-    });
-
-    it('should not match when extra modifier is present', () => {
-      const event = { key: 's', ctrlKey: true, shiftKey: true };
-      expect(matchesShortcut(event, 'Ctrl+S')).toBe(false);
-    });
-
-    it('should match Escape without modifiers', () => {
-      const event = { key: 'Escape' };
-      expect(matchesShortcut(event, 'Escape')).toBe(true);
-    });
-  });
-
-  // ==========================================================================
-  // createFocusTrapConfig
-  // ==========================================================================
-  describe('createFocusTrapConfig', () => {
-    it('should apply defaults for minimal config', () => {
-      const config = {} as FocusTrapConfig;
-      const resolved = createFocusTrapConfig(config);
-
-      expect(resolved.enabled).toBe(false);
-      expect(resolved.returnFocus).toBe(true);
-      expect(resolved.escapeDeactivates).toBe(true);
-      expect(resolved.initialFocus).toBeUndefined();
-    });
-
-    it('should preserve explicit values', () => {
-      const config = {
-        enabled: true,
-        initialFocus: '#first-input',
-        returnFocus: false,
-        escapeDeactivates: false,
-      } as FocusTrapConfig;
-      const resolved = createFocusTrapConfig(config);
-
-      expect(resolved.enabled).toBe(true);
-      expect(resolved.initialFocus).toBe('#first-input');
-      expect(resolved.returnFocus).toBe(false);
-      expect(resolved.escapeDeactivates).toBe(false);
-    });
-  });
-});