@object-ui/core 17.6.0 → 18.0.0

package/dist/adapters/batchTransaction.d.ts

@@ -8,7 +8,7 @@
  * Client-side emulation of {@link DataSource.batchTransaction} for adapters
  * that lack a server-side transactional batch endpoint. This is the single,
  * tested home for the non-atomic fallback (ObjectStack objectui #2679 /
- * framework #1604 / ADR-0034 item 4): components call `runBatchTransaction`
+ * objectstack-ai/objectstack#1604 / ADR-0034 item 4): components call `runBatchTransaction`
  * unconditionally and never orchestrate cross-object writes themselves.
  *
  * The emulation runs operations sequentially — NOT the old `bulk('create')`

package/dist/adapters/batchTransaction.js

@@ -8,7 +8,7 @@
  * Client-side emulation of {@link DataSource.batchTransaction} for adapters
  * that lack a server-side transactional batch endpoint. This is the single,
  * tested home for the non-atomic fallback (ObjectStack objectui #2679 /
- * framework #1604 / ADR-0034 item 4): components call `runBatchTransaction`
+ * objectstack-ai/objectstack#1604 / ADR-0034 item 4): components call `runBatchTransaction`
  * unconditionally and never orchestrate cross-object writes themselves.
  *
  * The emulation runs operations sequentially — NOT the old `bulk('create')`

package/dist/adapters/resolveDataSource.d.ts

@@ -9,10 +9,6 @@
  */
 import type { DataSource, ViewData } from '@object-ui/types';
 export interface ResolveDataSourceOptions {
-    /** Custom fetch implementation passed to ApiDataSource */
-    fetch?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
-    /** Default headers for API requests */
-    defaultHeaders?: Record<string, string>;
     /** Custom ID field for ValueDataSource */
     idField?: string;
 }
@@ -20,9 +16,16 @@ export interface ResolveDataSourceOptions {
  * Resolve a ViewData configuration into a concrete DataSource instance.
  *
  * - `provider: 'object'` → returns `fallback` (the context DataSource — typically ObjectStackAdapter)
- * - `provider: 'api'`    → returns a new `ApiDataSource`
  * - `provider: 'value'`  → returns a new `ValueDataSource`
  *
+ * There is no `provider: 'api'` arm. The view-level `api` data source is
+ * retired in `@objectstack/spec` (objectstack#23082, ADR-0049): a view binds
+ * its object or static rows, and a metadata-declared API call is the page
+ * element's `dataSource` binding. A view block that still says `api` is an
+ * unknown provider here and gets the same answer as one, so no request is
+ * ever built from its `read` / `write` (objectui#12325). Code that needs raw
+ * HTTP constructs `ApiDataSource` itself, from an `ApiDataSourceConfig`.
+ *
  * @param viewData - The ViewData configuration from the schema
  * @param fallback - The default DataSource from context (for `provider: 'object'`)
  * @param options  - Additional options for adapter construction
@@ -31,7 +34,7 @@ export interface ResolveDataSourceOptions {
  * @example
  * ```ts
  * const ds = resolveDataSource(
- *   { provider: 'api', read: { url: '/api/users' } },
+ *   { provider: 'value', items: [{ id: '1', name: 'Ada' }] },
  *   contextDataSource,
  * );
  * const result = await ds.find('users');

package/dist/adapters/resolveDataSource.js

@@ -7,15 +7,21 @@
  *
  * Factory function to create the right DataSource from a ViewData config.
  */
-import { ApiDataSource } from './ApiDataSource.js';
 import { ValueDataSource } from './ValueDataSource.js';
 /**
  * Resolve a ViewData configuration into a concrete DataSource instance.
  *
  * - `provider: 'object'` → returns `fallback` (the context DataSource — typically ObjectStackAdapter)
- * - `provider: 'api'`    → returns a new `ApiDataSource`
  * - `provider: 'value'`  → returns a new `ValueDataSource`
  *
+ * There is no `provider: 'api'` arm. The view-level `api` data source is
+ * retired in `@objectstack/spec` (objectstack#23082, ADR-0049): a view binds
+ * its object or static rows, and a metadata-declared API call is the page
+ * element's `dataSource` binding. A view block that still says `api` is an
+ * unknown provider here and gets the same answer as one, so no request is
+ * ever built from its `read` / `write` (objectui#12325). Code that needs raw
+ * HTTP constructs `ApiDataSource` itself, from an `ApiDataSourceConfig`.
+ *
  * @param viewData - The ViewData configuration from the schema
  * @param fallback - The default DataSource from context (for `provider: 'object'`)
  * @param options  - Additional options for adapter construction
@@ -24,7 +30,7 @@ import { ValueDataSource } from './ValueDataSource.js';
  * @example
  * ```ts
  * const ds = resolveDataSource(
- *   { provider: 'api', read: { url: '/api/users' } },
+ *   { provider: 'value', items: [{ id: '1', name: 'Ada' }] },
  *   contextDataSource,
  * );
  * const result = await ds.find('users');
@@ -38,15 +44,6 @@ export function resolveDataSource(viewData, fallback, options) {
         case 'object':
             // Delegate to the context DataSource (ObjectStackAdapter, etc.)
             return fallback ?? null;
-        case 'api': {
-            const config = {
-                read: viewData.read,
-                write: viewData.write,
-                fetch: options?.fetch,
-                defaultHeaders: options?.defaultHeaders,
-            };
-            return new ApiDataSource(config);
-        }
         case 'value':
             return new ValueDataSource({
                 items: (viewData.items ?? []),

package/dist/builder/schema-builder.d.ts

@@ -14,7 +14,7 @@
  * @module builder
  * @packageDocumentation
  */
-import type { BaseSchema, FormSchema, FormField, CRUDSchema, TableColumn, ActionSchema, ButtonSchema, InputSchema, CardSchema, GridSchema, FlexSchema } from '@object-ui/types';
+import type { BaseSchema, DeclaredNode, FormSchema, FormField, ButtonSchema, InputSchema, CardSchema, GridSchema, FlexLayoutProps } from '@object-ui/types';
 /**
  * Base builder class
  */
@@ -84,68 +84,6 @@ export declare class FormBuilder extends SchemaBuilder<FormSchema> {
      */
     onSubmit(handler: (data: Record<string, any>) => void | Promise<void>): this;
 }
-/**
- * CRUD builder
- */
-export declare class CRUDBuilder extends SchemaBuilder<CRUDSchema> {
-    constructor();
-    /**
-     * Set resource name
-     */
-    resource(resource: string): this;
-    /**
-     * Set API endpoint
-     */
-    api(api: string): this;
-    /**
-     * Set title
-     */
-    title(title: string): this;
-    /**
-     * Set description
-     */
-    description(description: string): this;
-    /**
-     * Add a column
-     */
-    column(column: TableColumn): this;
-    /**
-     * Set all columns
-     */
-    columns(columns: TableColumn[]): this;
-    /**
-     * Set form fields
-     */
-    fields(fields: FormField[]): this;
-    /**
-     * Enable create operation
-     */
-    enableCreate(label?: string): this;
-    /**
-     * Enable update operation
-     */
-    enableUpdate(label?: string): this;
-    /**
-     * Enable delete operation
-     */
-    enableDelete(label?: string, confirmText?: string): this;
-    /**
-     * Set pagination
-     */
-    pagination(pageSize?: number): this;
-    /**
-     * Enable row selection
-     */
-    selectable(mode?: 'single' | 'multiple'): this;
-    /**
-     * Add a batch action
-     */
-    batchAction(action: ActionSchema): this;
-    /**
-     * Add a row action
-     */
-    rowAction(action: ActionSchema): this;
-}
 /**
  * Button builder
  */
@@ -220,9 +158,10 @@ export declare class CardBuilder extends SchemaBuilder<CardSchema> {
      */
     description(description: string): this;
     /**
-     * Set card content
+     * Set card content: a node of a declared type, or a list of them
+     * (objectui#11466). Each node is checked against its own type's keys.
      */
-    content(content: BaseSchema | BaseSchema[]): this;
+    content(content: DeclaredNode | DeclaredNode[]): this;
     /**
      * Set card variant
      */
@@ -238,26 +177,43 @@ export declare class CardBuilder extends SchemaBuilder<CardSchema> {
 export declare class GridBuilder extends SchemaBuilder<GridSchema> {
     constructor();
     /**
-     * Set number of columns
+     * Set number of columns — one of the counts the `grid` renderer maps
+     * (objectui#11491); the parameter is the declaration's own bare-count arm,
+     * so `tsc` refuses any other number.
      */
-    columns(columns: number): this;
+    columns(columns: Extract<NonNullable<GridSchema['columns']>, number>): this;
     /**
-     * Set gap
+     * Set gap — one of the steps the `grid` renderer maps (objectui#11474); the
+     * parameter is the declaration's own set, so `tsc` refuses any other number.
      */
-    gap(gap: number): this;
+    gap(gap: NonNullable<GridSchema['gap']>): this;
     /**
-     * Add a child
+     * Add a child: a node of a declared type (`DeclaredNode`, objectui#11466),
+     * checked against its own type's keys like a child written inline.
      */
-    child(child: BaseSchema): this;
+    child(child: DeclaredNode): this;
     /**
-     * Set all children
+     * Set all children: nodes of declared types (objectui#11466).
      */
-    children(children: BaseSchema[]): this;
+    children(children: DeclaredNode[]): this;
 }
 /**
  * Flex builder
+ *
+ * Builds an AUTHORED `flex` node: its props in the `properties` bag
+ * (objectui#11276, the maintainer's ruling A on objectui#11300) —
+ * `{ type: 'flex', properties: { direction, justify, align, gap, children } }`,
+ * the spelling `@objectstack/spec`'s page component declares and
+ * `@object-ui/types`' authoring faces accept. A `flex` prop written flat on the
+ * node is refused there by name, so the builder never writes one. The base
+ * setters (`id`, `className`, `visible`, …) stay on the node. The bag's members
+ * are `FlexLayoutProps`; `SchemaRenderer` hoists them onto the node before the
+ * `flex` renderer reads them.
  */
-export declare class FlexBuilder extends SchemaBuilder<FlexSchema> {
+export declare class FlexBuilder extends SchemaBuilder<BaseSchema & {
+    type: 'flex';
+    properties: FlexLayoutProps;
+}> {
     constructor();
     /**
      * Set flex direction
@@ -272,20 +228,21 @@ export declare class FlexBuilder extends SchemaBuilder<FlexSchema> {
      */
     align(align: 'start' | 'end' | 'center' | 'baseline' | 'stretch'): this;
     /**
-     * Set gap
+     * Set gap — one of the steps the `flex` renderer maps (objectui#11474); the
+     * parameter is the declaration's own set, so `tsc` refuses any other number.
      */
-    gap(gap: number): this;
+    gap(gap: NonNullable<FlexLayoutProps['gap']>): this;
     /**
-     * Add a child
+     * Add a child: a node of a declared type (`DeclaredNode`, objectui#11466),
+     * checked against its own type's keys like a child written inline.
      */
-    child(child: BaseSchema): this;
+    child(child: DeclaredNode): this;
     /**
-     * Set all children
+     * Set all children: nodes of declared types (objectui#11466).
      */
-    children(children: BaseSchema[]): this;
+    children(children: DeclaredNode[]): this;
 }
 export declare const form: () => FormBuilder;
-export declare const crud: () => CRUDBuilder;
 export declare const button: () => ButtonBuilder;
 export declare const input: () => InputBuilder;
 export declare const card: () => CardBuilder;

package/dist/builder/schema-builder.js

@@ -125,141 +125,6 @@ export class FormBuilder extends SchemaBuilder {
         return this;
     }
 }
-/**
- * CRUD builder
- */
-export class CRUDBuilder extends SchemaBuilder {
-    constructor() {
-        super('crud');
-        this.schema.columns = [];
-    }
-    /**
-     * Set resource name
-     */
-    resource(resource) {
-        this.schema.resource = resource;
-        return this;
-    }
-    /**
-     * Set API endpoint
-     */
-    api(api) {
-        this.schema.api = api;
-        return this;
-    }
-    /**
-     * Set title
-     */
-    title(title) {
-        this.schema.title = title;
-        return this;
-    }
-    /**
-     * Set description
-     */
-    description(description) {
-        this.schema.description = description;
-        return this;
-    }
-    /**
-     * Add a column
-     */
-    column(column) {
-        this.schema.columns = [...(this.schema.columns || []), column];
-        return this;
-    }
-    /**
-     * Set all columns
-     */
-    columns(columns) {
-        this.schema.columns = columns;
-        return this;
-    }
-    /**
-     * Set form fields
-     */
-    fields(fields) {
-        this.schema.fields = fields;
-        return this;
-    }
-    /**
-     * Enable create operation
-     */
-    enableCreate(label) {
-        if (!this.schema.operations)
-            this.schema.operations = {};
-        this.schema.operations.create = {
-            enabled: true,
-            label: label || 'Create',
-            api: this.schema.api,
-            method: 'POST'
-        };
-        return this;
-    }
-    /**
-     * Enable update operation
-     */
-    enableUpdate(label) {
-        if (!this.schema.operations)
-            this.schema.operations = {};
-        this.schema.operations.update = {
-            enabled: true,
-            label: label || 'Update',
-            api: `${this.schema.api}/\${id}`,
-            method: 'PUT'
-        };
-        return this;
-    }
-    /**
-     * Enable delete operation
-     */
-    enableDelete(label, confirmText) {
-        if (!this.schema.operations)
-            this.schema.operations = {};
-        this.schema.operations.delete = {
-            enabled: true,
-            label: label || 'Delete',
-            api: `${this.schema.api}/\${id}`,
-            method: 'DELETE',
-            confirmText: confirmText || 'Are you sure?'
-        };
-        return this;
-    }
-    /**
-     * Set pagination
-     */
-    pagination(pageSize = 20) {
-        this.schema.pagination = {
-            enabled: true,
-            pageSize,
-            pageSizeOptions: [10, 20, 50, 100],
-            showTotal: true,
-            showSizeChanger: true
-        };
-        return this;
-    }
-    /**
-     * Enable row selection
-     */
-    selectable(mode = 'multiple') {
-        this.schema.selectable = mode;
-        return this;
-    }
-    /**
-     * Add a batch action
-     */
-    batchAction(action) {
-        this.schema.batchActions = [...(this.schema.batchActions || []), action];
-        return this;
-    }
-    /**
-     * Add a row action
-     */
-    rowAction(action) {
-        this.schema.rowActions = [...(this.schema.rowActions || []), action];
-        return this;
-    }
-}
 /**
  * Button builder
  */
@@ -382,7 +247,8 @@ export class CardBuilder extends SchemaBuilder {
         return this;
     }
     /**
-     * Set card content
+     * Set card content: a node of a declared type, or a list of them
+     * (objectui#11466). Each node is checked against its own type's keys.
      */
     content(content) {
         this.schema.content = content;
@@ -412,21 +278,25 @@ export class GridBuilder extends SchemaBuilder {
         this.schema.children = [];
     }
     /**
-     * Set number of columns
+     * Set number of columns — one of the counts the `grid` renderer maps
+     * (objectui#11491); the parameter is the declaration's own bare-count arm,
+     * so `tsc` refuses any other number.
      */
     columns(columns) {
         this.schema.columns = columns;
         return this;
     }
     /**
-     * Set gap
+     * Set gap — one of the steps the `grid` renderer maps (objectui#11474); the
+     * parameter is the declaration's own set, so `tsc` refuses any other number.
      */
     gap(gap) {
         this.schema.gap = gap;
         return this;
     }
     /**
-     * Add a child
+     * Add a child: a node of a declared type (`DeclaredNode`, objectui#11466),
+     * checked against its own type's keys like a child written inline.
      */
     child(child) {
         const children = Array.isArray(this.schema.children) ? this.schema.children : [];
@@ -434,7 +304,7 @@ export class GridBuilder extends SchemaBuilder {
         return this;
     }
     /**
-     * Set all children
+     * Set all children: nodes of declared types (objectui#11466).
      */
     children(children) {
         this.schema.children = children;
@@ -443,59 +313,70 @@ export class GridBuilder extends SchemaBuilder {
 }
 /**
  * Flex builder
+ *
+ * Builds an AUTHORED `flex` node: its props in the `properties` bag
+ * (objectui#11276, the maintainer's ruling A on objectui#11300) —
+ * `{ type: 'flex', properties: { direction, justify, align, gap, children } }`,
+ * the spelling `@objectstack/spec`'s page component declares and
+ * `@object-ui/types`' authoring faces accept. A `flex` prop written flat on the
+ * node is refused there by name, so the builder never writes one. The base
+ * setters (`id`, `className`, `visible`, …) stay on the node. The bag's members
+ * are `FlexLayoutProps`; `SchemaRenderer` hoists them onto the node before the
+ * `flex` renderer reads them.
  */
 export class FlexBuilder extends SchemaBuilder {
     constructor() {
         super('flex');
-        this.schema.children = [];
+        this.schema.properties = { children: [] };
     }
     /**
      * Set flex direction
      */
     direction(direction) {
-        this.schema.direction = direction;
+        this.schema.properties.direction = direction;
         return this;
     }
     /**
      * Set justify content
      */
     justify(justify) {
-        this.schema.justify = justify;
+        this.schema.properties.justify = justify;
         return this;
     }
     /**
      * Set align items
      */
     align(align) {
-        this.schema.align = align;
+        this.schema.properties.align = align;
         return this;
     }
     /**
-     * Set gap
+     * Set gap — one of the steps the `flex` renderer maps (objectui#11474); the
+     * parameter is the declaration's own set, so `tsc` refuses any other number.
      */
     gap(gap) {
-        this.schema.gap = gap;
+        this.schema.properties.gap = gap;
         return this;
     }
     /**
-     * Add a child
+     * Add a child: a node of a declared type (`DeclaredNode`, objectui#11466),
+     * checked against its own type's keys like a child written inline.
      */
     child(child) {
-        const children = Array.isArray(this.schema.children) ? this.schema.children : [];
-        this.schema.children = [...children, child];
+        const children = Array.isArray(this.schema.properties.children) ? this.schema.properties.children : [];
+        this.schema.properties.children = [...children, child];
         return this;
     }
     /**
-     * Set all children
+     * Set all children: nodes of declared types (objectui#11466).
      */
     children(children) {
-        this.schema.children = children;
+        this.schema.properties.children = children;
         return this;
     }
 }
 // Export factory functions
 export const form = () => new FormBuilder();
-export const crud = () => new CRUDBuilder();
 export const button = () => new ButtonBuilder();
 export const input = () => new InputBuilder();
 export const card = () => new CardBuilder();

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

@@ -9,11 +9,14 @@
  * @object-ui/core - View Data Provider
  *
  * Resolves @objectstack/spec ViewData discriminated union into
- * a unified data access interface. Supports three data modes:
+ * a unified data access interface. Supports two data modes:
  *
  * 1. 'object' — Metadata-driven via ObjectStack API (object name → fields/records)
- * 2. 'api' — Custom REST API endpoints (read/write URLs)
- * 3. 'value' — Static data (pre-loaded items array)
+ * 2. 'value' — Static data (pre-loaded items array)
+ *
+ * The view-level `'api'` mode is retired in `@objectstack/spec`
+ * (objectstack#23082, ADR-0049) and has no arm here (objectui#12325): a
+ * config that still names it resolves as an unknown provider, with an error.
  *
  * @module data-scope
  * @packageDocumentation
@@ -23,18 +26,6 @@ import { type ElementDataSourceConfig, type ElementSavedView } from './element-d
 export type ViewDataConfig = {
     provider: 'object';
     object: string;
-} | {
-    provider: 'api';
-    read: {
-        url: string;
-        method?: string;
-        headers?: Record<string, string>;
-    };
-    write?: {
-        url: string;
-        method?: string;
-        headers?: Record<string, string>;
-    };
 } | {
     provider: 'value';
     items: any[];
@@ -72,19 +63,13 @@ export interface DataFetcher {
             required?: boolean;
         }>;
     }>;
-    /** Fetch from a custom API URL */
-    fetchUrl?(url: string, options?: {
-        method?: string;
-        headers?: Record<string, string>;
-        body?: any;
-    }): Promise<any>;
     /**
      * Fetch the object's saved views, so an `ElementDataSource.view` name can be
      * resolved to real columns / filter / sort (objectstack#5576).
      *
      * Optional because most fetchers only read records. A fetcher WITHOUT it
      * cannot honour a named view, and {@link ViewDataProvider.resolveElementDataSource}
-     * says so in `error` rather than dropping the key — the whole point of #5576
+     * says so in `error` rather than dropping the key — the whole point of objectstack-ai/objectstack#5576
      * is that a `view` the runtime cannot apply must never look applied.
      *
      * Either shape stored views come in is accepted: a map keyed by view id, or
@@ -110,7 +95,7 @@ export interface ResolvedData {
         }>;
     };
     /** Provider type */
-    provider: 'object' | 'api' | 'value';
+    provider: 'object' | 'value';
     /** Loading state */
     loading: boolean;
     /** Error */
@@ -143,8 +128,6 @@ export declare class ViewDataProvider {
     }): Promise<ResolvedData>;
     /** Resolve static value data */
     private resolveValue;
-    /** Resolve API-based data */
-    private resolveApi;
     /** Resolve object-based data (metadata-driven) */
     private resolveObject;
     /**