@object-ui/react 16.1.0 → 17.2.0

package/dist/spec-bridge/SpecBridge.js

@@ -7,8 +7,6 @@
  */
 import { bridgeListView } from './bridges/list-view';
 import { bridgeFormView } from './bridges/form-view';
-import { bridgePage } from './bridges/page';
-import { bridgeDashboard } from './bridges/dashboard';
 export class SpecBridge {
     constructor(context = {}) {
         Object.defineProperty(this, "bridges", {
@@ -26,8 +24,6 @@ export class SpecBridge {
         this.context = context;
         this.register('list', bridgeListView);
         this.register('form', bridgeFormView);
-        this.register('page', bridgePage);
-        this.register('dashboard', bridgeDashboard);
     }
     register(specType, bridge) {
         this.bridges.set(specType, bridge);
@@ -48,14 +44,6 @@ export class SpecBridge {
     transformFormView(spec) {
         return this.transform('form', spec);
     }
-    /** Transform a Page spec */
-    transformPage(spec) {
-        return this.transform('page', spec);
-    }
-    /** Transform a Dashboard spec */
-    transformDashboard(spec) {
-        return this.transform('dashboard', spec);
-    }
     updateContext(ctx) {
         this.context = { ...this.context, ...ctx };
     }

package/dist/spec-bridge/bridges/list-view.js

@@ -134,17 +134,11 @@ export const bridgeListView = (spec, _context) => {
     // P1.6 — i18n & ARIA
     if (spec.aria)
         node.aria = spec.aria;
-    if (spec.sharing) {
-        // Normalize spec sharing format: map type → visibility, set enabled = true
-        const sharing = { ...spec.sharing };
-        if (sharing.type && !sharing.visibility) {
-            sharing.visibility = sharing.type === 'collaborative' ? 'team' : 'private';
-        }
-        if (sharing.type && sharing.enabled == null) {
-            sharing.enabled = true;
-        }
-        node.sharing = sharing;
-    }
+    // `sharing` is already the spec's `ViewSharing` shape on both sides (#2890) —
+    // this used to DOWNGRADE it here, inventing a legacy `visibility` audience and
+    // an `enabled` flag that the renderer then had to fold back.
+    if (spec.sharing)
+        node.sharing = spec.sharing;
     if (spec.hiddenFields)
         node.hiddenFields = spec.hiddenFields;
     if (spec.fieldOrder)

package/dist/spec-bridge/index.d.ts

@@ -9,5 +9,3 @@ export { SpecBridge } from './SpecBridge';
 export type { BridgeContext, BridgeFn, ObjectDefLite } from './types';
 export { bridgeListView } from './bridges/list-view';
 export { bridgeFormView } from './bridges/form-view';
-export { bridgePage } from './bridges/page';
-export { bridgeDashboard } from './bridges/dashboard';

package/dist/spec-bridge/index.js

@@ -8,5 +8,3 @@
 export { SpecBridge } from './SpecBridge';
 export { bridgeListView } from './bridges/list-view';
 export { bridgeFormView } from './bridges/form-view';
-export { bridgePage } from './bridges/page';
-export { bridgeDashboard } from './bridges/dashboard';

package/dist/spec-input.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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 AUTHORING ("input") type of a `@objectstack/spec` zod schema.
+ *
+ * ## Why not `z.infer`
+ *
+ * `z.infer` is the OUTPUT type — what `.parse()` returns, with every
+ * `.default()` already applied and therefore REQUIRED. The hooks in this
+ * package are handed configuration an app author wrote by hand, so the input
+ * side is the one that describes what they may legally omit. Deriving a config
+ * type from `z.infer` turns every defaulted key into a required one and makes
+ * the schema's own defaults unusable — the `_input`/`_output` trap the spec
+ * symbol guard's header warns about, and the one that already bit
+ * `ObjectFieldGroup` in objectui#3169.
+ *
+ * Rule of thumb: is this module WRITING the metadata, or READING what has
+ * already been parsed? Writing → input. Reading → `z.infer`.
+ *
+ * ## Why it reads `_zod`, not `z.input`
+ *
+ * `z.input<typeof S>` needs a `zod` import, and `@object-ui/react` deliberately
+ * does not depend on zod — it renders plain objects and never parses. The
+ * schema's own type already carries both sides in `_zod`, so the input type is
+ * reachable through the spec's binding alone, with no new dependency and no
+ * copy of the shape.
+ */
+export type SpecAuthoredInput<S extends {
+    _zod: {
+        input: unknown;
+    };
+}> = S['_zod']['input'];

package/dist/spec-input.js

@@ -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/utils/error-message.d.ts

@@ -12,6 +12,37 @@
  * usable can be extracted, so callers fall back to a generic localized string.
  */
 export declare function extractWriteErrorMessage(err: unknown): string | null;
+/** One field the server rejected, normalised for `form.setError`. */
+export interface WriteFieldError {
+    /** Field name, matching the form control's `name`. */
+    field: string;
+    /** Human-readable reason, already localized by the server when it can be. */
+    message: string;
+}
+/**
+ * Per-field errors from a rejected write, or `null` when the failure was not
+ * field-scoped.
+ *
+ * The server has always sent these. `@objectstack/objectql`'s validators throw
+ * `{ code: 'VALIDATION_FAILED', fields: [{ field, code, message }] }`, and both
+ * the REST layer and the runtime dispatcher serve that as a 400 with `fields[]`
+ * intact. What was missing was the last hop: every form caught the rejection,
+ * showed one generic toast, and dropped `fields[]` on the floor — so a user told
+ * "Validation failed" had to guess WHICH input was wrong, on a surface that
+ * already knows how to mark it.
+ *
+ * Reads three shapes, because the error can arrive from either side of the
+ * adapter boundary:
+ *   - `validationErrors` — a `ValidationError` from `@object-ui/data-objectstack`;
+ *   - `details.fields` — the raw `@objectstack/client` error, whose `details`
+ *     falls back to the whole response body;
+ *   - `fields` — a hand-rolled error of the same shape (the server duck-types
+ *     these identically, so we do too).
+ *
+ * Entries without a usable `field` are dropped rather than guessed at: a wrong
+ * mark on an innocent input is worse than the generic toast we already show.
+ */
+export declare function extractFieldErrors(err: unknown): WriteFieldError[] | null;
 /**
  * True when a failed write was rejected for authorization reasons (HTTP 403 /
  * `PERMISSION_DENIED` / `FORBIDDEN` / a row-level-security denial). Lets a

package/dist/utils/error-message.js

@@ -68,6 +68,55 @@ export function extractWriteErrorMessage(err) {
         .trim();
     return clean || null;
 }
+/**
+ * Per-field errors from a rejected write, or `null` when the failure was not
+ * field-scoped.
+ *
+ * The server has always sent these. `@objectstack/objectql`'s validators throw
+ * `{ code: 'VALIDATION_FAILED', fields: [{ field, code, message }] }`, and both
+ * the REST layer and the runtime dispatcher serve that as a 400 with `fields[]`
+ * intact. What was missing was the last hop: every form caught the rejection,
+ * showed one generic toast, and dropped `fields[]` on the floor — so a user told
+ * "Validation failed" had to guess WHICH input was wrong, on a surface that
+ * already knows how to mark it.
+ *
+ * Reads three shapes, because the error can arrive from either side of the
+ * adapter boundary:
+ *   - `validationErrors` — a `ValidationError` from `@object-ui/data-objectstack`;
+ *   - `details.fields` — the raw `@objectstack/client` error, whose `details`
+ *     falls back to the whole response body;
+ *   - `fields` — a hand-rolled error of the same shape (the server duck-types
+ *     these identically, so we do too).
+ *
+ * Entries without a usable `field` are dropped rather than guessed at: a wrong
+ * mark on an innocent input is worse than the generic toast we already show.
+ */
+export function extractFieldErrors(err) {
+    const e = err;
+    if (!e || typeof e !== 'object')
+        return null;
+    const raw = (Array.isArray(e.validationErrors) && e.validationErrors) ||
+        (Array.isArray(e.details?.fields) && e.details.fields) ||
+        (Array.isArray(e.fields) && e.fields) ||
+        null;
+    if (!raw || !Array.isArray(raw))
+        return null;
+    const out = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const rec = entry;
+        const field = firstString(rec.field, rec.name, rec.path);
+        if (!field)
+            continue;
+        // `code` is the machine enum (`required`, `invalid_option`, …). It is a
+        // last resort only: the server builds `message` to be shown verbatim, and
+        // an untranslated enum in the UI reads as a bug.
+        const message = firstString(rec.message, rec.error, rec.code) ?? '';
+        out.push({ field, message });
+    }
+    return out.length > 0 ? out : null;
+}
 /**
  * True when a failed write was rejected for authorization reasons (HTTP 403 /
  * `PERMISSION_DENIED` / `FORBIDDEN` / a row-level-security denial). Lets a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/react",
-  "version": "16.1.0",
+  "version": "17.2.0",
   "type": "module",
   "license": "MIT",
   "description": "React bindings and SchemaRenderer component for Object UI",
@@ -24,12 +24,12 @@
     }
   },
   "dependencies": {
-    "@objectstack/spec": "^16.0.0-rc.0",
-    "react-hook-form": "^7.82.0",
-    "@object-ui/core": "16.1.0",
-    "@object-ui/data-objectstack": "16.1.0",
-    "@object-ui/i18n": "16.1.0",
-    "@object-ui/types": "16.1.0"
+    "@objectstack/spec": "^17.0.0-rc.1",
+    "react-hook-form": "^7.83.0",
+    "@object-ui/core": "17.2.0",
+    "@object-ui/data-objectstack": "17.2.0",
+    "@object-ui/i18n": "17.2.0",
+    "@object-ui/types": "17.2.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -65,7 +65,7 @@
   "scripts": {
     "build": "tsc",
     "test": "vitest run",
-    "type-check": "tsc --noEmit",
+    "type-check": "tsc --noEmit && tsc -p tsconfig.typetests.json",
     "lint": "eslint ."
   }
 }

package/dist/hooks/useColumnSummary.d.ts

@@ -1,38 +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.
- */
-/** Summary function types aligned with ColumnSummarySchema */
-export type SummaryFunction = 'sum' | 'avg' | 'count' | 'min' | 'max' | 'distinct';
-export interface ColumnSummaryConfig {
-    /** The field/column to aggregate */
-    field: string;
-    /** The aggregation function */
-    function: SummaryFunction;
-    /** Optional label for the summary */
-    label?: string;
-    /** Number format options */
-    format?: Intl.NumberFormatOptions;
-}
-export interface ColumnSummaryResult {
-    /** The computed value */
-    value: number;
-    /** Formatted display string */
-    formatted: string;
-    /** The label */
-    label: string;
-}
-/**
- * Hook for computing column-level summaries (SUM, AVG, COUNT, MIN, MAX, DISTINCT).
- * Implements ColumnSummarySchema from @objectstack/spec v2.0.7.
- *
- * @example
- * ```tsx
- * const summary = useColumnSummary(data, { field: 'amount', function: 'sum', label: 'Total' });
- * // summary.formatted => "$12,345.67"
- * ```
- */
-export declare function useColumnSummary(data: Record<string, unknown>[], config: ColumnSummaryConfig, locale?: string): ColumnSummaryResult;

package/dist/hooks/useColumnSummary.js

@@ -1,54 +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.
- */
-import { useMemo } from 'react';
-/**
- * Hook for computing column-level summaries (SUM, AVG, COUNT, MIN, MAX, DISTINCT).
- * Implements ColumnSummarySchema from @objectstack/spec v2.0.7.
- *
- * @example
- * ```tsx
- * const summary = useColumnSummary(data, { field: 'amount', function: 'sum', label: 'Total' });
- * // summary.formatted => "$12,345.67"
- * ```
- */
-export function useColumnSummary(data, config, locale) {
-    return useMemo(() => {
-        const values = data
-            .map((row) => {
-            const val = row[config.field];
-            return typeof val === 'number' ? val : Number(val);
-        })
-            .filter((v) => !isNaN(v));
-        let value;
-        switch (config.function) {
-            case 'sum':
-                value = values.reduce((acc, v) => acc + v, 0);
-                break;
-            case 'avg':
-                value = values.length > 0 ? values.reduce((acc, v) => acc + v, 0) / values.length : 0;
-                break;
-            case 'count':
-                value = data.length;
-                break;
-            case 'min':
-                value = values.length > 0 ? Math.min(...values) : 0;
-                break;
-            case 'max':
-                value = values.length > 0 ? Math.max(...values) : 0;
-                break;
-            case 'distinct':
-                value = new Set(data.map((row) => row[config.field])).size;
-                break;
-            default:
-                value = 0;
-        }
-        const formatted = new Intl.NumberFormat(locale, config.format).format(value);
-        const label = config.label ?? config.function.toUpperCase();
-        return { value, formatted, label };
-    }, [data, config.field, config.function, config.label, config.format, locale]);
-}

package/dist/spec-bridge/bridges/dashboard.d.ts

@@ -1,81 +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.
- */
-import type { BridgeFn } from '../types';
-interface DashboardWidget {
-    title?: string;
-    description?: string;
-    type?: string;
-    chartConfig?: any;
-    colorVariant?: string;
-    actionUrl?: string;
-    actionType?: string;
-    actionIcon?: string;
-    object?: string;
-    filter?: any;
-    categoryField?: string;
-    valueField?: string;
-    aggregate?: string;
-    measures?: any[];
-    layout?: any;
-    options?: any;
-    responsive?: any;
-    aria?: {
-        ariaLabel?: string;
-        ariaDescribedBy?: string;
-        role?: string;
-    };
-}
-interface DashboardHeader {
-    showTitle?: boolean;
-    showDescription?: boolean;
-    actions?: Array<{
-        label: string;
-        actionUrl?: string;
-        actionType?: string;
-        icon?: string;
-    }>;
-    [key: string]: any;
-}
-interface GlobalFilter {
-    field: string;
-    label?: string;
-    type?: string;
-    options?: string[];
-    optionsFrom?: {
-        object: string;
-        valueField: string;
-        labelField?: string;
-        filter?: any;
-    };
-    defaultValue?: any;
-    scope?: string;
-    targetWidgets?: string[];
-}
-interface DashboardSpec {
-    name?: string;
-    label?: string;
-    description?: string;
-    widgets?: DashboardWidget[];
-    globalFilters?: GlobalFilter[];
-    header?: DashboardHeader;
-    refreshInterval?: number;
-    dateRange?: {
-        field?: string;
-        defaultRange?: string;
-        allowCustomRange?: boolean;
-    };
-    aria?: {
-        ariaLabel?: string;
-        ariaDescribedBy?: string;
-        role?: string;
-    };
-    performance?: any;
-}
-/** Transforms a Dashboard spec into a dashboard layout SchemaNode */
-export declare const bridgeDashboard: BridgeFn<DashboardSpec>;
-export {};

package/dist/spec-bridge/bridges/dashboard.js

@@ -1,121 +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.
- */
-function mapWidget(widget, index) {
-    const node = {
-        type: widget.type ?? 'chart',
-        id: `widget-${index}`,
-    };
-    if (widget.title)
-        node.title = widget.title;
-    if (widget.description)
-        node.description = widget.description;
-    if (widget.chartConfig)
-        node.chartConfig = widget.chartConfig;
-    if (widget.colorVariant)
-        node.colorVariant = widget.colorVariant;
-    if (widget.actionUrl)
-        node.actionUrl = widget.actionUrl;
-    if (widget.actionType)
-        node.actionType = widget.actionType;
-    if (widget.actionIcon)
-        node.actionIcon = widget.actionIcon;
-    if (widget.object)
-        node.object = widget.object;
-    if (widget.filter)
-        node.filter = widget.filter;
-    if (widget.categoryField)
-        node.categoryField = widget.categoryField;
-    if (widget.valueField)
-        node.valueField = widget.valueField;
-    if (widget.aggregate)
-        node.aggregate = widget.aggregate;
-    if (widget.measures)
-        node.measures = widget.measures;
-    if (widget.layout)
-        node.layout = widget.layout;
-    if (widget.options)
-        node.options = widget.options;
-    if (widget.responsive)
-        node.responsive = widget.responsive;
-    if (widget.aria)
-        node.aria = widget.aria;
-    return node;
-}
-function mapGlobalFilters(filters) {
-    return {
-        type: 'filter-bar',
-        id: 'dashboard-filters',
-        filters: filters.map((f) => {
-            const mapped = { field: f.field };
-            if (f.label)
-                mapped.label = f.label;
-            if (f.type)
-                mapped.type = f.type;
-            if (f.options)
-                mapped.options = f.options;
-            if (f.optionsFrom)
-                mapped.optionsFrom = f.optionsFrom;
-            if (f.defaultValue != null)
-                mapped.defaultValue = f.defaultValue;
-            if (f.scope)
-                mapped.scope = f.scope;
-            if (f.targetWidgets)
-                mapped.targetWidgets = f.targetWidgets;
-            return mapped;
-        }),
-    };
-}
-function mapHeader(header) {
-    const node = {
-        type: 'dashboard-header',
-        id: 'dashboard-header',
-        ...header,
-    };
-    return node;
-}
-/** Transforms a Dashboard spec into a dashboard layout SchemaNode */
-export const bridgeDashboard = (spec, _context) => {
-    const widgetNodes = (spec.widgets ?? []).map(mapWidget);
-    const bodyChildren = [];
-    if (spec.header) {
-        bodyChildren.push(mapHeader(spec.header));
-    }
-    if (spec.globalFilters && spec.globalFilters.length > 0) {
-        bodyChildren.push(mapGlobalFilters(spec.globalFilters));
-    }
-    // P1.3 — Date range filter
-    if (spec.dateRange) {
-        bodyChildren.push({
-            type: 'date-range-filter',
-            id: 'dashboard-date-range',
-            ...spec.dateRange,
-        });
-    }
-    bodyChildren.push({
-        type: 'widget-grid',
-        id: 'dashboard-widgets',
-        body: widgetNodes,
-    });
-    const node = {
-        type: 'dashboard',
-        id: spec.name,
-        body: bodyChildren,
-    };
-    if (spec.label)
-        node.label = spec.label;
-    if (spec.description)
-        node.description = spec.description;
-    if (spec.refreshInterval != null)
-        node.refreshInterval = spec.refreshInterval;
-    // P1.6 — i18n & ARIA
-    if (spec.aria)
-        node.aria = spec.aria;
-    if (spec.performance)
-        node.performance = spec.performance;
-    return node;
-};

package/dist/spec-bridge/bridges/page.d.ts

@@ -1,58 +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.
- */
-import type { BridgeFn } from '../types';
-interface PageComponent {
-    type: string;
-    id?: string;
-    label?: string;
-    properties?: Record<string, any>;
-    events?: Record<string, any>;
-    style?: Record<string, any>;
-    responsiveStyles?: Record<string, any>;
-    className?: string;
-    /** Canonical conditional-visibility predicate (ADR-0089). */
-    visibleWhen?: string;
-    /** @deprecated ADR-0089 → `visibleWhen`. */
-    visibility?: string;
-    dataSource?: any;
-    responsive?: any;
-    aria?: Record<string, string>;
-}
-interface PageRegion {
-    name?: string;
-    width?: string;
-    components?: PageComponent[];
-}
-interface PageVariable {
-    name: string;
-    type?: string;
-    defaultValue?: any;
-    source?: string;
-}
-interface PageSpec {
-    name?: string;
-    label?: string;
-    description?: string;
-    icon?: string;
-    type?: string;
-    variables?: PageVariable[];
-    regions?: PageRegion[];
-    template?: string;
-    object?: string;
-    isDefault?: boolean;
-    assignedProfiles?: string[];
-    interfaceConfig?: any;
-    aria?: {
-        ariaLabel?: string;
-        ariaDescribedBy?: string;
-        role?: string;
-    };
-}
-/** Transforms a Page spec into a page layout SchemaNode */
-export declare const bridgePage: BridgeFn<PageSpec>;
-export {};