@object-ui/core 17.6.0 → 17.7.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/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

@@ -84,7 +84,7 @@ export interface DataFetcher {
      *
      * 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

package/dist/data-scope/ViewDataProvider.js

@@ -18,7 +18,7 @@
  * @module data-scope
  * @packageDocumentation
  */
-import { collectSavedViews, composeElementDataSource, elementDataSourceViewNotFoundMessage, resolveSavedView, } from './element-data-source.js';
+import { collectSavedViews, composeElementDataSource, elementDataSourceRefusedLimitMessage, elementDataSourceViewNotFoundMessage, resolveSavedView, } from './element-data-source.js';
 /** Extract records array from various common API response shapes */
 function extractRecords(data) {
     if (Array.isArray(data))
@@ -211,6 +211,26 @@ export class ViewDataProvider {
             }
         }
         const composed = composeElementDataSource(config, view);
+        // The loud half of the row-cap refusal. This method is the consumer that
+        // has NO guard of its own — it forwards `limit` straight to
+        // `DataFetcher.fetchRecords` — so before the guard a view's `0` / `-10` /
+        // `25.5` reached the fetcher verbatim, and nothing anywhere said so. A
+        // renderer that receives the same key reports it through its own channel;
+        // this path has no renderer, so it reports here, on the same `console.warn`
+        // channel those sites use. ⛔ Not an `error`: the refusal is FAIL-SOFT and
+        // the records still load, so blanking the result would be a worse outcome
+        // than the defect.
+        //
+        // Both operands of the chain are asked (objectui#10016): a refused binding
+        // `limit` is not authored and yields to the view's cap, so it is reported
+        // in its own words. The builder is also handed the binding for the VIEW's
+        // sentence, because that sentence says the fetch falls back to a default,
+        // which is false when the binding's own usable cap is what gets used.
+        for (const operand of ['binding', 'view']) {
+            const refusedLimit = elementDataSourceRefusedLimitMessage(view, config.view, config.object, config, operand);
+            if (refusedLimit)
+                console.warn(refusedLimit);
+        }
         const fields = Array.isArray(composed.columns)
             ? composed.columns.filter((c) => typeof c === 'string' && !!c)
             : undefined;