@object-ui/react 15.0.0 → 16.0.0

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @object-ui/react
 
+## 16.0.0
+
+### Minor Changes
+
+- d3e19ed: Adapt to framework 15.1: (1) ADR-0067 D2 all-or-nothing publishes — `formatPublishFailures` renders a rolled-back batch as ONE banner anchored on the causal item (`batch_aborted` entries are summarized, not listed as parallel errors); PackagesPage says "rolled back because X" instead of "{n} failed"; the AI chat publish toast surfaces the real reason instead of a bare count. Pre-15.1 partial-publish responses keep their per-item rendering. (2) ADR-0076 D12 honest discovery — `DiscoveryServiceStatus` gains `handlerReady` + `degraded`/`stub` statuses, new backward-tolerant `isServiceUsable()` helper (absent fields keep the pre-15.1 default; `stub`/`handlerReady:false` gate off; `degraded` stays usable), consumed by `isAuthEnabled`/`isAiEnabled` and `ConditionalAuthWrapper`.
+
+### Patch Changes
+
+- 59d4fa9: fix(detail): show the "Locked for approval" band on request-tracked backends (objectui#2618)
+
+  The DetailView approval-lock band keyed only off the record's own
+  `approval_status` field, so it never rendered on backends that track the lock
+  via an open approval request and never materialize that field — even though
+  the lock was real (writes rejected with `RECORD_LOCKED`). The record-level
+  `InlineEditContext` now carries the host's `locked`/`lockedReason` signal
+  (the same dual-source `approvalLocked` that already gates `canEdit` in
+  `RecordDetailView`), and the band renders from it while keeping `DetailView`
+  DataSource-agnostic. Also backfills the approval-lock strings into the detail
+  translation defaults so a bare DetailView shows the label, not the raw i18n key.
+
+- 195a651: refactor(spec-bridge): retire the hand-written `ListViewSpec`/`ListColumn` mirrors in the list-view bridge (#2231 follow-up)
+
+  The SpecBridge's list-view bridge kept a third hand-written copy of the ListView shape
+  (after the zod schema and the TS interface unified in the previous #2231 PR). It now
+  derives its input type from `@objectstack/spec/ui` (`Partial<ListView>`, spec `ListColumn`),
+  so the bridge can no longer drift from the protocol.
+
+  Behavior fix surfaced by the real types: spec `columns` is `string[] | ListColumn[]`, but
+  the old local interface only admitted `ListColumn[]` — a bare field-name column would have
+  produced a broken `{ accessorKey: undefined }` mapping. String columns now map to a default
+  column (`{ accessorKey: field, header: field }`).
+
+- Updated dependencies [210806a]
+- Updated dependencies [b4ef588]
+- Updated dependencies [ca0f5f0]
+- Updated dependencies [5534535]
+- Updated dependencies [9b8f978]
+  - @object-ui/types@16.0.0
+  - @object-ui/i18n@16.0.0
+  - @object-ui/core@16.0.0
+  - @object-ui/data-objectstack@16.0.0
+
 ## 15.0.0
 
 ### Patch Changes

package/dist/context/InlineEditContext.d.ts

@@ -31,6 +31,24 @@ export interface InlineEditContextValue {
      * is a no-op and consumers must not surface the edit affordance.
      */
     canEdit: boolean;
+    /**
+     * Whether this record is *approval-locked* — a pending approval request has
+     * the record locked for writes (the backend rejects updates with
+     * `RECORD_LOCKED`). This is a DISTINCT signal from `!canEdit`: a record can
+     * be non-editable for many reasons (no permission, wrong lifecycle stage),
+     * but only an approval lock warrants the "Locked for approval" band + recall
+     * affordance. The host computes it (objectui#2618) — typically from the
+     * record's `approval_status` field OR an open request in the approvals API —
+     * so the band renders from the same signal that gated `canEdit`, keeping the
+     * renderer DataSource-agnostic. Defaults to `false`.
+     */
+    locked: boolean;
+    /**
+     * Human-readable reason for the approval lock, surfaced as the band's
+     * tooltip. Optional — consumers fall back to their own localized default
+     * when omitted.
+     */
+    lockedReason?: string;
     /**
      * Draft of user-edited values. Holds ONLY the keys the user actually
      * changed, so the save path never writes computed / read-only / untouched
@@ -63,6 +81,15 @@ export interface InlineEditProviderProps {
      * a single source. Defaults to `true`.
      */
     canEdit?: boolean;
+    /**
+     * Whether the record is approval-locked (objectui#2618). Surfaced verbatim
+     * on the context so lock-aware consumers (the DetailView "Locked for
+     * approval" band) render from the host's signal instead of re-deriving it
+     * from a record field the backend may not materialize. Defaults to `false`.
+     */
+    locked?: boolean;
+    /** Optional human-readable lock reason, surfaced as the band tooltip. */
+    lockedReason?: string;
     children: React.ReactNode;
 }
 export declare const InlineEditProvider: React.FC<InlineEditProviderProps>;

package/dist/context/InlineEditContext.js

@@ -24,7 +24,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  */
 import React from 'react';
 const InlineEditContext = React.createContext(null);
-export const InlineEditProvider = ({ canEdit = true, children, }) => {
+export const InlineEditProvider = ({ canEdit = true, locked = false, lockedReason, children, }) => {
     const [editing, setEditing] = React.useState(false);
     const [draft, setDraft] = React.useState({});
     const [autoFocusField, setAutoFocusField] = React.useState(null);
@@ -56,6 +56,8 @@ export const InlineEditProvider = ({ canEdit = true, children, }) => {
     const value = React.useMemo(() => ({
         editing,
         canEdit,
+        locked,
+        lockedReason,
         draft,
         autoFocusField,
         saving,
@@ -66,7 +68,7 @@ export const InlineEditProvider = ({ canEdit = true, children, }) => {
         reset: teardown,
         setSaving,
         setError,
-    }), [editing, canEdit, draft, autoFocusField, saving, error, enter, setField, teardown]);
+    }), [editing, canEdit, locked, lockedReason, draft, autoFocusField, saving, error, enter, setField, teardown]);
     return _jsx(InlineEditContext.Provider, { value: value, children: children });
 };
 /**

package/dist/hooks/useDiscovery.d.ts

@@ -9,6 +9,33 @@
  * Discovery service information structure.
  * Represents server capabilities and service status.
  */
+/**
+ * Per-service availability entry (framework 15.1+, ADR-0076 D12 "honest
+ * capabilities"): discovery no longer hardcodes every registered service as
+ * `available` — a dev fake reports `stub`, a serving fallback reports
+ * `degraded`, and `handlerReady` says whether a real handler backs the route.
+ * Older servers omit `handlerReady` and only ever report
+ * `available`/`unavailable`, so consumers must treat the new fields as
+ * OPT-IN signals (see {@link isServiceUsable}), never require them.
+ */
+export interface DiscoveryServiceStatus {
+    enabled: boolean;
+    status?: 'available' | 'degraded' | 'stub' | 'unavailable';
+    handlerReady?: boolean;
+}
+/**
+ * The backward-compatible "can I actually use this service?" check
+ * (ADR-0076 D12 console slice):
+ *
+ * - absent entry / absent fields → usable (pre-15.1 servers say nothing —
+ *   keep their historical default);
+ * - `enabled: false` or `handlerReady: false` → not usable;
+ * - `status: 'stub'` → not usable (a dev fake must not be treated as the
+ *   real service — the exact dishonesty D12 removed);
+ * - `status: 'degraded'` → USABLE (a fallback that keeps serving; callers
+ *   may surface a warning but must not turn the feature off).
+ */
+export declare function isServiceUsable(svc: DiscoveryServiceStatus | undefined | null): boolean;
 export interface DiscoveryInfo {
     /** Server name and version */
     name?: string;
@@ -27,25 +54,15 @@ export interface DiscoveryInfo {
     /** Service availability status */
     services?: {
         /** Authentication service status */
-        auth?: {
-            enabled: boolean;
-            status?: 'available' | 'unavailable';
+        auth?: DiscoveryServiceStatus & {
             message?: string;
         };
         /** Data access service status */
-        data?: {
-            enabled: boolean;
-            status?: 'available' | 'unavailable';
-        };
+        data?: DiscoveryServiceStatus;
         /** Metadata service status */
-        metadata?: {
-            enabled: boolean;
-            status?: 'available' | 'unavailable';
-        };
+        metadata?: DiscoveryServiceStatus;
         /** AI service configuration */
-        ai?: {
-            enabled: boolean;
-            status?: 'available' | 'unavailable';
+        ai?: DiscoveryServiceStatus & {
             /** AI service endpoint route (e.g. '/api/v1/ai') */
             route?: string;
         };
@@ -89,13 +106,16 @@ export declare function useDiscovery(): {
     isLoading: boolean;
     error: Error | null;
     /**
-     * Check if authentication is enabled on the server.
-     * Defaults to true if discovery data is not available.
+     * Check if authentication is enabled AND actually backed by a real
+     * handler (ADR-0076 D12 — a `stub`/`handlerReady:false` auth service is
+     * not treated as real auth). Defaults to true when discovery data is not
+     * available (pre-15.1 servers report nothing).
      */
     isAuthEnabled: boolean;
     /**
      * Check if AI service is enabled and available on the server.
-     * Defaults to false if discovery data is not available.
+     * Defaults to false if discovery data is not available; `degraded`
+     * still counts as available (it serves), `stub` never does.
      */
     isAiEnabled: boolean;
 };

package/dist/hooks/useDiscovery.js

@@ -7,6 +7,29 @@
  */
 import { useState, useEffect, useContext } from 'react';
 import { SchemaRendererContext } from '../context/SchemaRendererContext';
+/**
+ * The backward-compatible "can I actually use this service?" check
+ * (ADR-0076 D12 console slice):
+ *
+ * - absent entry / absent fields → usable (pre-15.1 servers say nothing —
+ *   keep their historical default);
+ * - `enabled: false` or `handlerReady: false` → not usable;
+ * - `status: 'stub'` → not usable (a dev fake must not be treated as the
+ *   real service — the exact dishonesty D12 removed);
+ * - `status: 'degraded'` → USABLE (a fallback that keeps serving; callers
+ *   may surface a warning but must not turn the feature off).
+ */
+export function isServiceUsable(svc) {
+    if (!svc)
+        return true;
+    if (svc.enabled === false)
+        return false;
+    if (svc.handlerReady === false)
+        return false;
+    if (svc.status === 'stub' || svc.status === 'unavailable')
+        return false;
+    return true;
+}
 /**
  * Hook to access discovery information from the ObjectStack server.
  *
@@ -88,15 +111,19 @@ export function useDiscovery() {
         isLoading,
         error,
         /**
-         * Check if authentication is enabled on the server.
-         * Defaults to true if discovery data is not available.
+         * Check if authentication is enabled AND actually backed by a real
+         * handler (ADR-0076 D12 — a `stub`/`handlerReady:false` auth service is
+         * not treated as real auth). Defaults to true when discovery data is not
+         * available (pre-15.1 servers report nothing).
          */
-        isAuthEnabled: discovery?.services?.auth?.enabled ?? true,
+        isAuthEnabled: isServiceUsable(discovery?.services?.auth),
         /**
          * Check if AI service is enabled and available on the server.
-         * Defaults to false if discovery data is not available.
+         * Defaults to false if discovery data is not available; `degraded`
+         * still counts as available (it serves), `stub` never does.
          */
         isAiEnabled: discovery?.services?.ai?.enabled === true &&
-            discovery?.services?.ai?.status === 'available',
+            (discovery?.services?.ai?.status === 'available' || discovery?.services?.ai?.status === 'degraded') &&
+            discovery?.services?.ai?.handlerReady !== false,
     };
 }

package/dist/spec-bridge/bridges/list-view.d.ts

@@ -6,79 +6,15 @@
  * LICENSE file in the root directory of this source tree.
  */
 import type { BridgeFn } from '../types';
-import type { ListViewGalleryConfig, ListViewTimelineConfig } from '@object-ui/types';
-interface ListColumn {
-    field: string;
-    label?: string;
-    width?: number;
-    align?: string;
-    hidden?: boolean;
-    sortable?: boolean;
-    resizable?: boolean;
-    wrap?: boolean;
-    type?: string;
-    pinned?: string;
-    summary?: any;
-    link?: any;
-    action?: any;
-}
-interface ListViewSpec {
-    name?: string;
-    label?: string;
-    type?: string;
-    data?: any;
-    columns?: ListColumn[];
-    filter?: any;
-    sort?: any;
-    searchableFields?: string[];
-    filterableFields?: string[];
-    selection?: any;
-    pagination?: any;
-    rowHeight?: string;
-    resizable?: boolean;
-    striped?: boolean;
-    bordered?: boolean;
-    grouping?: any;
-    rowColor?: any;
-    navigation?: any;
-    kanban?: any;
-    calendar?: any;
-    gantt?: any;
-    gallery?: ListViewGalleryConfig;
-    timeline?: ListViewTimelineConfig;
-    rowActions?: string[];
-    bulkActions?: string[];
-    bulkActionDefs?: any[];
-    virtualScroll?: boolean;
-    conditionalFormatting?: Array<{
-        condition: string;
-        style: Record<string, string>;
-    }>;
-    inlineEdit?: boolean;
-    exportOptions?: any;
-    emptyState?: {
-        title?: string;
-        message?: string;
-        icon?: string;
-    };
-    userActions?: any;
-    appearance?: any;
-    /** UX-only hint: collapse appearance/grouping cluster into a single popover. */
-    compactToolbar?: boolean;
-    tabs?: any[];
-    addRecord?: any;
-    showRecordCount?: boolean;
-    allowPrinting?: boolean;
-    aria?: {
-        ariaLabel?: string;
-        ariaDescribedBy?: string;
-        role?: string;
-    };
-    sharing?: any;
-    hiddenFields?: string[];
-    fieldOrder?: string[];
-    description?: string;
-}
+import type { ListView } from '@objectstack/spec/ui';
+/**
+ * Bridge input: the spec-canonical ListView (#2231 — the former hand-written
+ * `ListViewSpec`/`ListColumn` mirrors are retired; the shape now derives from
+ * `@objectstack/spec/ui` and can no longer drift). Relaxed to `Partial` because
+ * hosts routinely hand the bridge fragmentary view-configs (every field was
+ * optional in the old mirror too, including spec-required `columns`).
+ */
+type ListViewSpec = Partial<ListView>;
 /** Transforms a ListView spec into a DataTable SchemaNode */
 export declare const bridgeListView: BridgeFn<ListViewSpec>;
 export {};

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

@@ -6,6 +6,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 function mapColumn(col) {
+    // Spec-legacy shorthand: a bare field name stands for a default column.
+    if (typeof col === 'string') {
+        return { accessorKey: col, header: col };
+    }
     const mapped = {
         accessorKey: col.field,
         header: col.label ?? col.field,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/react",
-  "version": "15.0.0",
+  "version": "16.0.0",
   "type": "module",
   "license": "MIT",
   "description": "React bindings and SchemaRenderer component for Object UI",
@@ -24,12 +24,12 @@
     }
   },
   "dependencies": {
-    "@objectstack/spec": "^14.6.0",
+    "@objectstack/spec": "^15.1.1",
     "react-hook-form": "^7.81.0",
-    "@object-ui/core": "15.0.0",
-    "@object-ui/data-objectstack": "15.0.0",
-    "@object-ui/i18n": "15.0.0",
-    "@object-ui/types": "15.0.0"
+    "@object-ui/core": "16.0.0",
+    "@object-ui/data-objectstack": "16.0.0",
+    "@object-ui/i18n": "16.0.0",
+    "@object-ui/types": "16.0.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",