@object-ui/core 17.3.0 → 17.6.0

package/dist/validation/server-owned-value.js

@@ -0,0 +1,99 @@
+/**
+ * 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.
+ */
+/**
+ * The ONE client-side answer to "is this field's value the PRODUCER's to
+ * supply?" — the other half of {@link isMissingForRequired}.
+ *
+ * A `required` verdict is a question about two facts: is the value absent
+ * (`required-presence.ts`), and was the client ever supposed to provide it.
+ * This module owns the second one. Both live here in `@object-ui/core` because
+ * every layer that decides required-ness reads them: the form renderer
+ * (`resolveFieldRuleState`), the wizard's cross-step gate, and the
+ * create-form field builders in `@object-ui/plugin-form`.
+ *
+ * ## What makes a value server-owned
+ *
+ * A `defaultValue` may be a literal, or an *instruction* the server resolves
+ * per insert:
+ *
+ *   - a runtime token — `'NOW()'` / `'current_user'`, the whole
+ *     `DEFAULT_VALUE_TOKENS` family from `@objectstack/spec/data`
+ *   - a CEL Expression envelope — `{ dialect: 'cel', source: 'today()' }`
+ *
+ * A CREATE form deliberately leaves such a control EMPTY and omits the key
+ * from the payload, because `ObjectQL.applyFieldDefaults` resolves a declared
+ * default only for a field that arrives absent or null (#4047 / #4068). The
+ * field is therefore not "missing" on that submit — it is server-owned, and
+ * nothing the client evaluates may declare it required (#4069 / #4085).
+ *
+ * ## Create only
+ *
+ * On an EDIT form the token was already resolved at insert. The control shows
+ * a persisted value, so blanking it is a real removal and `required` (static
+ * or conditional) enforces normally.
+ */
+import { isRuntimeDefaultToken } from '@objectstack/spec/data';
+/**
+ * Is `v` a CEL/template Expression envelope rather than a literal value?
+ *
+ * Same shape test the engine applies before handing a default to
+ * `ExpressionEngine` (`{ dialect, source }`), kept structural on purpose: the
+ * point is "the server evaluates this", which is true for every dialect.
+ */
+function isExpressionEnvelope(v) {
+    return (typeof v === 'object' &&
+        v !== null &&
+        typeof v.dialect === 'string' &&
+        typeof v.source === 'string');
+}
+/**
+ * Is this declared `defaultValue` a RUNTIME INSTRUCTION the server resolves per
+ * insert, rather than a literal value?
+ *
+ * True for the `DEFAULT_VALUE_TOKENS` family (`'NOW()'` / `'current_user'`) and
+ * for CEL/template Expression envelopes. This is THE classifier for "the
+ * producer owns this field's create value", and every consumer reads THIS one
+ * — a second copy would be free to disagree about, say, a CEL envelope, and
+ * then a form would seed a field it also refuses to submit. Today's consumers:
+ *
+ *   1. seeding (#4047 / #4068) — such a default is not seeded, because putting
+ *      the literal text `NOW()` into a datetime input and submitting it
+ *      suppresses the very resolution the declaration asked for;
+ *   2. the create-mode static `required` rule (#4069) —
+ *      `isRequiredInForm` in `@object-ui/plugin-form`;
+ *   3. the create-mode `requiredWhen` rule (#4085) —
+ *      {@link isServerOwnedValue}, read by `resolveFieldRuleState`.
+ */
+export function isRuntimeDefault(v) {
+    return isRuntimeDefaultToken(v) || isExpressionEnvelope(v);
+}
+/**
+ * Does the PRODUCER supply this field's value for the submit this form is
+ * about to make? (#4085)
+ *
+ * The single derivation of that fact, so the three call sites that feed
+ * `resolveFieldRuleState` cannot each answer "where does the declared default
+ * live" differently. It reads the runtime FormField's `field` slot — the
+ * resolved object-field metadata the object-bound builders stash there
+ * (`ObjectForm`, `sectionFields`, and the containers' no-sections paths), and
+ * the only spelling of a declared `defaultValue` that reaches the renderer.
+ * A hand-authored FormField carries no object metadata, so it is never
+ * server-owned and its rules are untouched.
+ *
+ * `isCreateForm` is the CALLER's fact, never inferred here: the form renderer
+ * reads it off `FormSchema.previousValues` (whose absence *is* the declared
+ * "this is an insert" signal, objectui#3484), while the wizard's step gate
+ * reads its own `mode`. An evaluator guessing from a `previous` argument would
+ * call an edit-mode caller that simply passes no `previous` a create form, and
+ * silently drop a `requiredWhen` the author meant to enforce.
+ */
+export function isServerOwnedValue(field, isCreateForm) {
+    if (!isCreateForm)
+        return false;
+    return isRuntimeDefault(field?.field?.defaultValue);
+}

package/dist/validation/validators/object-validation-engine.js

@@ -129,13 +129,11 @@ class SimpleExpressionEvaluator {
                     return leftVal === rightVal;
                 case '==':
                     // Use loose equality for backward compatibility with existing expressions
-                    // eslint-disable-next-line eqeqeq
                     return leftVal == rightVal;
                 case '!==':
                     return leftVal !== rightVal;
                 case '!=':
                     // Use loose inequality for backward compatibility with existing expressions
-                    // eslint-disable-next-line eqeqeq
                     return leftVal != rightVal;
                 case '>': return leftVal > rightVal;
                 case '<': return leftVal < rightVal;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/core",
-  "version": "17.3.0",
+  "version": "17.6.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
@@ -25,11 +25,11 @@
     }
   },
   "dependencies": {
-    "@objectstack/formula": "^17.0.0-rc.2",
-    "@objectstack/spec": "^17.0.0-rc.2",
+    "@objectstack/formula": "^17.0.0",
+    "@objectstack/spec": "^17.0.0",
     "lodash": "^4.18.1",
     "zod": "^4.4.3",
-    "@object-ui/types": "17.3.0"
+    "@object-ui/types": "17.6.0"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
@@ -62,7 +62,7 @@
   "scripts": {
     "build": "tsc",
     "test": "vitest run",
-    "type-check": "tsc --noEmit",
+    "type-check": "tsc --noEmit && tsc -p tsconfig.test.json",
     "lint": "eslint ."
   }
 }

package/dist/__benchmarks__/core.bench.d.ts

@@ -1,8 +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.
- */
-export {};

package/dist/__benchmarks__/core.bench.js

@@ -1,53 +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/dist/utils/merge-views-into-objects.d.ts

@@ -1,19 +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.
- */
-/**
- * Adapter: merge stack-level views into object definitions.
- *
- * Views are defined at the stack level (views[].listViews) but the runtime
- * expects listViews on each object definition. This bridges the gap until
- * the runtime/provider layer handles it natively.
- *
- * @param objects - Object definitions from composed stack
- * @param views   - View definitions containing listViews keyed by object name
- * @returns Objects with listViews merged in from matching views
- */
-export declare function mergeViewsIntoObjects(objects: any[], views: any[]): any[];

package/dist/utils/merge-views-into-objects.js

@@ -1,39 +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.
- */
-/**
- * Adapter: merge stack-level views into object definitions.
- *
- * Views are defined at the stack level (views[].listViews) but the runtime
- * expects listViews on each object definition. This bridges the gap until
- * the runtime/provider layer handles it natively.
- *
- * @param objects - Object definitions from composed stack
- * @param views   - View definitions containing listViews keyed by object name
- * @returns Objects with listViews merged in from matching views
- */
-export function mergeViewsIntoObjects(objects, views) {
-    const viewsByObject = {};
-    for (const view of views) {
-        if (!view.listViews)
-            continue;
-        for (const [viewName, listView] of Object.entries(view.listViews)) {
-            const objectName = listView?.data?.object;
-            if (!objectName)
-                continue;
-            if (!viewsByObject[objectName])
-                viewsByObject[objectName] = {};
-            viewsByObject[objectName][viewName] = listView;
-        }
-    }
-    return objects.map((obj) => {
-        const v = viewsByObject[obj.name];
-        if (!v)
-            return obj;
-        return { ...obj, listViews: { ...(obj.listViews || {}), ...v } };
-    });
-}