From dc8cc5947baa48fb7200742680beb3b51b56e033 Mon Sep 17 00:00:00 2001 From: itsprade Date: Tue, 10 Nov 2026 19:39:23 +0530 Subject: [PATCH 1/6] feat(form-layout): responsive form layout, dialog sizes and form templates Add FormLayout, a grid for form fields that reflows by the width of its container, so one form definition fits a Dialog, a Sheet or a page. FormLayout.Section groups fields as cards or plain fieldsets, and FormLayout.Actions is a sticky action bar for long page forms. Supporting changes: - span on Field.Root and Fieldset.Root; a field holding a Textarea takes the full row unless it sets its own span - Field.Label required (visual marker) and Field.Value (a read-only value at an input's height) - Dialog.Content size (sm-xl, matching Sheet) and Dialog.Body, which scrolls long content while the header and footer stay in view - Dialog.Footer and Sheet.Footer right-align buttons at their natural width - Layout maxWidth to centre and cap a page The example app gets a form templates page (modal, side sheet, page form with an optional section nav, document form, and a wizard built on Stepper, in a dialog or on a page) and five larger examples. The form/wizard pattern now uses Stepper for its step indicator. Docs, form patterns and the consumer skill are updated. Refs tailor-inc/platform-planning#1742 Co-Authored-By: Claude Opus 5.5 # Conflicts: # docs-manifest.json # docs-src/patterns/form-wizard.docs.examples.tsx # docs-src/patterns/form-wizard.docs.outline.md # docs/patterns/form-wizard.md --- .changeset/roomy-forms-reflow.md | 37 + docs-manifest.json | 88 ++- docs-src/components/dialog.docs.outline.md | 46 +- .../components/form-layout.docs.examples.tsx | 72 ++ .../components/form-layout.docs.outline.md | 144 ++++ docs-src/components/form.docs.outline.md | 35 +- docs-src/components/layout.docs.outline.md | 104 ++- .../patterns/form-modal.docs.examples.tsx | 63 +- docs-src/patterns/form-modal.docs.outline.md | 5 +- .../patterns/form-sectioned.docs.examples.tsx | 152 +++-- .../patterns/form-sectioned.docs.outline.md | 10 +- .../form-single-page.docs.examples.tsx | 87 +-- .../patterns/form-single-page.docs.outline.md | 4 +- .../patterns/form-wizard.docs.examples.tsx | 70 +- docs-src/patterns/form-wizard.docs.outline.md | 16 +- docs-src/skill/SKILL.template.md | 1 + docs/components/dialog.md | 46 +- docs/components/form-layout.md | 206 ++++++ docs/components/form.md | 35 +- docs/components/layout.md | 104 ++- docs/patterns/form-modal.md | 66 +- docs/patterns/form-sectioned.md | 164 ++--- docs/patterns/form-single-page.md | 81 +-- docs/patterns/form-wizard.md | 83 ++- examples/vite-app/src/App.tsx | 1 + .../form-templates/complex-examples.tsx | 636 ++++++++++++++++++ .../showcase/form-templates/document/page.tsx | 12 + .../showcase/form-templates/field-types.tsx | 214 ++++++ .../pages/showcase/form-templates/fields.tsx | 151 +++++ .../form-templates/overlay-templates.tsx | 89 +++ .../showcase/form-templates/overview.tsx | 233 +++++++ .../form-templates/page-templates.tsx | 251 +++++++ .../pages/showcase/form-templates/page.tsx | 12 + .../showcase/form-templates/page/page.tsx | 18 + .../form-templates/wizard-template.tsx | 286 ++++++++ .../showcase/form-templates/wizard/page.tsx | 12 + examples/vite-app/src/routes.generated.ts | 4 + ...__components__dialog__dialog.test.tsx.snap | 4 +- ...ts__form-layout__form-layout.test.tsx.snap | 7 + ...rc__components__sheet__sheet.test.tsx.snap | 2 +- ...ts__tree-picker__tree-picker.test.tsx.snap | 8 +- .../src/components/dialog/dialog.test.tsx | 91 +++ .../core/src/components/dialog/dialog.tsx | 71 +- .../core/src/components/field/field.test.tsx | 79 +++ packages/core/src/components/field/field.tsx | 78 ++- .../core/src/components/fieldset/fieldset.tsx | 16 +- .../form-layout/form-layout.test.tsx | 292 ++++++++ .../components/form-layout/form-layout.tsx | 330 +++++++++ .../core/src/components/form-layout/index.ts | 8 + .../core/src/components/form-layout/types.ts | 100 +++ .../src/components/layout/layout.test.tsx | 23 + .../core/src/components/layout/layout.tsx | 16 +- packages/core/src/components/layout/types.ts | 16 + .../core/src/components/sheet/sheet.test.tsx | 15 + packages/core/src/components/sheet/sheet.tsx | 3 +- packages/core/src/index.ts | 7 + packages/core/src/lib/form-span.ts | 9 + 57 files changed, 4289 insertions(+), 524 deletions(-) create mode 100644 .changeset/roomy-forms-reflow.md create mode 100644 docs-src/components/form-layout.docs.examples.tsx create mode 100644 docs-src/components/form-layout.docs.outline.md create mode 100644 docs/components/form-layout.md create mode 100644 examples/vite-app/src/pages/showcase/form-templates/complex-examples.tsx create mode 100644 examples/vite-app/src/pages/showcase/form-templates/document/page.tsx create mode 100644 examples/vite-app/src/pages/showcase/form-templates/field-types.tsx create mode 100644 examples/vite-app/src/pages/showcase/form-templates/fields.tsx create mode 100644 examples/vite-app/src/pages/showcase/form-templates/overlay-templates.tsx create mode 100644 examples/vite-app/src/pages/showcase/form-templates/overview.tsx create mode 100644 examples/vite-app/src/pages/showcase/form-templates/page-templates.tsx create mode 100644 examples/vite-app/src/pages/showcase/form-templates/page.tsx create mode 100644 examples/vite-app/src/pages/showcase/form-templates/page/page.tsx create mode 100644 examples/vite-app/src/pages/showcase/form-templates/wizard-template.tsx create mode 100644 examples/vite-app/src/pages/showcase/form-templates/wizard/page.tsx create mode 100644 packages/core/__snapshots__/src__components__form-layout__form-layout.test.tsx.snap create mode 100644 packages/core/src/components/form-layout/form-layout.test.tsx create mode 100644 packages/core/src/components/form-layout/form-layout.tsx create mode 100644 packages/core/src/components/form-layout/index.ts create mode 100644 packages/core/src/components/form-layout/types.ts create mode 100644 packages/core/src/lib/form-span.ts diff --git a/.changeset/roomy-forms-reflow.md b/.changeset/roomy-forms-reflow.md new file mode 100644 index 000000000..20ae8bd3b --- /dev/null +++ b/.changeset/roomy-forms-reflow.md @@ -0,0 +1,37 @@ +--- +"@tailor-platform/app-shell": minor +--- + +Add `FormLayout` for laying out form fields in a responsive grid that reflows by its container's width, so one form definition fits a Dialog, a Sheet or a page. It comes with `FormLayout.Section` (card or plain fieldset groups), `FormLayout.Item` and a sticky-capable `FormLayout.Actions`. + +```tsx +
+ + + + Supplier + + + + Notes +