@object-ui/plugin-form 11.4.0 → 13.1.0

package/CHANGELOG.md

@@ -1,5 +1,132 @@
 # @object-ui/plugin-form
 
+## 13.1.0
+
+### Patch Changes
+
+- @object-ui/types@13.1.0
+- @object-ui/core@13.1.0
+- @object-ui/i18n@13.1.0
+- @object-ui/react@13.1.0
+- @object-ui/components@13.1.0
+- @object-ui/fields@13.1.0
+- @object-ui/permissions@13.1.0
+
+## 13.0.0
+
+### Patch Changes
+
+- Updated dependencies [9e38270]
+- Updated dependencies [ac04b76]
+- Updated dependencies [619097e]
+  - @object-ui/i18n@13.0.0
+  - @object-ui/components@13.0.0
+  - @object-ui/types@13.0.0
+  - @object-ui/fields@13.0.0
+  - @object-ui/react@13.0.0
+  - @object-ui/core@13.0.0
+  - @object-ui/permissions@13.0.0
+
+## 12.1.0
+
+### Patch Changes
+
+- 195121a: Studio form designer + preview now match the runtime form's column density.
+
+  The Data pillar's **Form → Layout** designer laid every section out in a fixed 2-column grid capped at `max-w-3xl`, and **Form → Preview** capped the real `ObjectForm` at `max-w-2xl`. So on a wide screen the studio showed at most 2 columns while the record the end user actually edits spreads to up to 4 — the design surface misrepresented the real layout.
+
+  `ObjectFormDesigner` now derives its column count the same way the runtime form does (`inferColumns` over the object's editable field count, objectui#2578) and lays each section out with the shared container-query grid classes (`containerGridColsFor`) inside a per-section `@container`, so a field-heavy object reaches 4 fields per row on wide screens and collapses to one column when the panel is narrow. Wide widgets (textarea/markdown/html/…) span the full row, mirroring the form. Both the layout and preview canvases were widened to `max-w-6xl` so the container queries can actually reach 4 columns. `containerGridColsFor` is now exported from `@object-ui/plugin-form` as the single source of truth for these grid classes.
+
+- Updated dependencies [6cbccf3]
+- Updated dependencies [e1840bf]
+- Updated dependencies [c31874d]
+  - @object-ui/components@12.1.0
+  - @object-ui/fields@12.1.0
+  - @object-ui/i18n@12.1.0
+  - @object-ui/types@12.1.0
+  - @object-ui/react@12.1.0
+  - @object-ui/core@12.1.0
+  - @object-ui/permissions@12.1.0
+
+## 12.0.0
+
+### Minor Changes
+
+- e4de456: Fix form section grouping inconsistencies found in a UX review of grouped forms:
+
+  - **Unified section visual language.** `FormSection`'s Card-wrapped path (used by Modal/Split/Tabbed/Wizard forms) previously rendered as a nearly-invisible white-on-white card (same `bg-card` as the page background, distinguished only by a barely-visible shadow) with a duplicated, inconsistent header (different title size, and a collapse chevron positioned differently) versus the flat `SectionDivider` path used by simple/drawer forms. Both now share the same header treatment (`text-sm font-semibold`, inline-left chevron, bottom border), and the Card path gets a soft `bg-muted/40` tint so grouped sections are visually distinguishable without relying on shadow alone.
+  - **`readonly` no longer renders as `disabled`.** A field marked `readonly` (statically or via `readonlyWhen`) was being folded into the `disabled` prop before reaching field widgets, so widgets with a dedicated readonly display (e.g. `EmailField`'s mailto link, `TextField`'s plain-text view) never received it — every readonly field just looked permanently disabled. `readonly` is now forwarded as its own prop; generic `input`/`textarea` fields get a distinct readonly style (`bg-muted/40`, no `cursor-not-allowed`) instead of the disabled look.
+  - **Section `className`/`gridClassName` now flow through JSON schemas.** `ObjectFormSection` and the per-form-variant section configs (`ModalFormSectionConfig`, `SplitFormSectionConfig`, `FormSectionConfig`, `DrawerFormSectionConfig`) accept `className` (and `gridClassName` where applicable), wired through `ObjectForm`'s form-type dispatch into `FormSection`/`SectionDivider` — closing a gap where section wrappers couldn't be customized from schema despite `FormSection` itself already supporting it.
+
+### Patch Changes
+
+- Updated dependencies [226fde9]
+- Updated dependencies [e36a9c7]
+- Updated dependencies [e4de456]
+- Updated dependencies [68e2d1c]
+  - @object-ui/types@12.0.0
+  - @object-ui/core@12.0.0
+  - @object-ui/components@12.0.0
+  - @object-ui/fields@12.0.0
+  - @object-ui/permissions@12.0.0
+  - @object-ui/react@12.0.0
+  - @object-ui/i18n@12.0.0
+
+## 11.5.0
+
+### Patch Changes
+
+- fae75e2: Fix two bugs verified still-present after #2254 claimed to resolve them (framework#2620 / framework#2616 Showcase UX pass, tracked in #2268):
+
+  - **Wizard/form `submitBehavior: 'thank-you'` allowed duplicate resubmission.** #2254 fixed the spec-bridge dropping `submitBehavior` before it reached the renderer, so the configured toast message started appearing — but `WizardForm`'s last step and `ObjectForm`'s submit handler only ever called `toast.success(...)` for `thank-you`/`next-record`; the form stayed mounted and fully filled with its submit button re-enabled once the request settled, so a second click created a second record. Both components now track a terminal `submitted` state and, when set, replace the form with a confirmation panel (using the behavior's `title`/`message`, which were also never read before) — mirroring the pattern `apps/console/src/components/FormPage.tsx` already used for its own standalone forms.
+
+  - **Command Center-style 3-up chart bands stayed collapsed to ~100-130px, and a dataset-bound chart's measure leaked its raw field name.**
+    - `responsiveStyles` (and `style`) were declared on the page-spec `PageComponent` bridge input type but never copied onto the `SchemaNode` in `spec-bridge/bridges/page.ts::mapComponent()` — so a page author's ADR-0065 layout override (e.g. forcing `display: 'grid'` on a `type: 'flex'` band) never reached `SchemaRenderer`, and the node silently fell back to its default flex layout. Both fields are now mapped through.
+    - `ObjectChart`'s dataset-bound fetch path (`schema.dataset` + `ds.queryDataset(...)`) discarded the response's `fields` array (which carries each measure's `label`, e.g. `{ name: 'task_count', label: 'Tasks' }`) before it ever reached `buildChartSeries()` — whose `fields` param already resolves this correctly (see `chart-series.test.ts`) — so the legend/tooltip always fell back to the raw field name. The fetched `fields` are now captured and threaded through.
+
+- ec9c8ee: Fix master-detail record create: stop double success toast + localize the Cancel button.
+
+  Objects with inline subforms (master-detail, e.g. a Lead with product line items)
+  render `MasterDetailForm` inside `ModalForm`/`DrawerForm` instead of the plain
+  footer, which exposed two mismatches with the host contract:
+
+  - **Double success toast.** Flat `ObjectForm` delegates confirmation to the host
+    when an `onSuccess` is supplied (skips its own default toast), but
+    `MasterDetailForm.handleSaved` ALWAYS toasted `Created`/`Saved` AND ran
+    `onSuccess`. In the console the host's `onSuccess` chains into the `crud_success`
+    handler, which toasts a localized message — so create fired both `Created` and
+    e.g. `线索创建成功`. `handleSaved` now only toasts as a fallback when no host
+    `onSuccess` is provided, matching the `ObjectForm` contract; saves without a host
+    handler stay non-silent.
+
+  - **Hardcoded English `Cancel`.** The master-detail action bar wrote `Cancel` as a
+    literal and accepted no `cancelText`, so the button stayed English while the
+    submit button was localized (`submitText` was already forwarded).
+    `MasterDetailForm` now takes `cancelText`, and `ModalForm`/`DrawerForm`/`ObjectForm`
+    forward the host's localized label down the subforms branch.
+
+  Adds regression tests: create with a host `onSuccess` fires no built-in toast (no
+  double-confirm), and the Cancel button renders the host-supplied `cancelText`.
+
+- 6c1ad9e: Record task flows open as derived overlays with lossless return (framework#2604, extends framework#2578).
+
+  - **Create/Edit never route** — the global record form is URL-driven (`?form=new` / `?form=<id>`): browser Back closes the overlay with the origin (list scroll/filters, detail state) intact; field-heavy objects derive a full-screen modal (`modalSize:'full'`) via the new `deriveRecordFlowSurface` mirror in plugin-view, light ones keep the auto-sized modal. `editMode:'page'` opt-in unchanged.
+  - **Save invariant** — _edit never moves you_ (origin refetches in place); _create lands on the new record's detail_ on its derived surface (drawer over the still-intact list for light objects, detail route for heavy), with `replace:true` so Back skips the transient form entry.
+  - **Subtable child create/edit = overlay over the parent detail, never a route** — related-list New/Edit push `?form=…&formObject=<child>&formLink=<fk>:<parentId>`; the one global overlay pre-links the parent (refresh-safe), sizes to the CHILD object, and on save stays on the parent while only the child's related lists refetch. ModalForm now forwards `initialValues` into its master-detail (subforms) branch so pre-links survive for children with inline line items.
+
+- Updated dependencies [544d8eb]
+- Updated dependencies [6fffd3d]
+- Updated dependencies [9255686]
+- Updated dependencies [fae75e2]
+- Updated dependencies [1072701]
+  - @object-ui/i18n@11.5.0
+  - @object-ui/react@11.5.0
+  - @object-ui/components@11.5.0
+  - @object-ui/types@11.5.0
+  - @object-ui/fields@11.5.0
+  - @object-ui/core@11.5.0
+  - @object-ui/permissions@11.5.0
+
 ## 11.4.0
 
 ### Minor Changes

package/dist/DrawerForm.d.ts

@@ -8,6 +8,8 @@ export interface DrawerFormSectionConfig {
     fields: (string | FormField)[];
     collapsible?: boolean;
     collapsed?: boolean;
+    /** Custom CSS class for the section's divider header. */
+    className?: string;
 }
 export interface DrawerFormSchema {
     type: 'object-form';

package/dist/MasterDetailForm.d.ts

@@ -48,6 +48,9 @@ export interface MasterDetailFormSchema {
     formType?: 'simple' | 'tabbed';
     title?: string;
     submitText?: string;
+    /** Label for the Cancel button in the action bar. i18n is the host's job
+     *  (this plugin is locale-agnostic); defaults to English 'Cancel'. */
+    cancelText?: string;
     /** Hide the bottom Save/Cancel action bar — e.g. a non-persisting design
      *  preview. Defaults to shown (the form owns the only Save in this layout). */
     showSubmit?: boolean;

package/dist/ModalForm.d.ts

@@ -6,6 +6,10 @@ export interface ModalFormSectionConfig {
     description?: string;
     columns?: 1 | 2 | 3 | 4;
     fields: (string | FormField)[];
+    /** Custom CSS class for the section's Card wrapper. */
+    className?: string;
+    /** Custom CSS class for the section's field grid. */
+    gridClassName?: string;
 }
 export interface ModalFormSchema {
     type: 'object-form';

package/dist/SplitForm.d.ts

@@ -6,6 +6,10 @@ export interface SplitFormSectionConfig {
     description?: string;
     columns?: 1 | 2 | 3 | 4;
     fields: (string | FormField)[];
+    /** Custom CSS class for the section's Card wrapper. */
+    className?: string;
+    /** Custom CSS class for the section's field grid. */
+    gridClassName?: string;
 }
 export interface SplitFormSchema {
     type: 'object-form';

package/dist/TabbedForm.d.ts

@@ -22,6 +22,14 @@ export interface FormSectionConfig {
      * Field names or configurations in this section
      */
     fields: (string | FormField)[];
+    /**
+     * Custom CSS class for the section's Card wrapper.
+     */
+    className?: string;
+    /**
+     * Custom CSS class for the section's field grid.
+     */
+    gridClassName?: string;
 }
 export interface TabbedFormSchema {
     type: 'object-form';

package/dist/WizardForm.d.ts

@@ -1,5 +1,6 @@
 import { default as React } from 'react';
 import { DataSource } from '@object-ui/types';
+import { SubmitBehavior } from './successBehavior';
 import { FormSectionConfig } from './TabbedForm';
 export interface WizardFormSchema {
     type: 'object-form';
@@ -47,15 +48,24 @@ export interface WizardFormSchema {
     /**
      * Declarative success toast text shown when no `onSuccess` handler is given
      * (metadata pages cannot pass a function). Falls back to 'Created'/'Saved'.
+     * Ignored when `submitBehavior` is set.
      */
     successMessage?: string;
     /** Navigate here after a successful create/update (declarative; metadata
      * pages can't pass onSuccess). Supports `{id}`/`{recordId}` interpolation
-     * from the saved record. Same-origin-guarded. Takes precedence over the toast. */
+     * from the saved record. Same-origin-guarded. Takes precedence over the toast.
+     * Ignored when `submitBehavior` is set. */
     navigateOnSuccess?: string;
     /** Reset the wizard (back to step 1, cleared) after a successful create so the
-     * user can enter another. Ignored when `navigateOnSuccess` is set. */
+     * user can enter another. Ignored when `navigateOnSuccess` or `submitBehavior`
+     * is set. */
     resetOnSuccess?: boolean;
+    /**
+     * Declarative post-submit behavior aligned with `@objectstack/spec`'s
+     * `FormView.submitBehavior`. When present, takes precedence over
+     * `successMessage` / `navigateOnSuccess` / `resetOnSuccess`.
+     */
+    submitBehavior?: SubmitBehavior;
     /**
      * Show cancel button
      * @default true

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { ObjectForm };
 export type { ObjectFormProps } from './ObjectForm';
 export { FormSection } from './FormSection';
 export type { FormSectionProps } from './FormSection';
-export { applyAutoLayout, inferColumns, inferModalSize, isWideFieldType, isAutoGeneratedFieldType, applyAutoColSpan, filterCreateModeFields, filterSystemFields, filterAutoGeneratedFields, } from './autoLayout';
+export { applyAutoLayout, inferColumns, inferModalSize, isWideFieldType, isAutoGeneratedFieldType, applyAutoColSpan, containerGridColsFor, filterCreateModeFields, filterSystemFields, filterAutoGeneratedFields, } from './autoLayout';
 export { TabbedForm } from './TabbedForm';
 export type { TabbedFormProps, TabbedFormSchema, FormSectionConfig } from './TabbedForm';
 export { WizardForm } from './WizardForm';