nuxt-ui-tools 1.3.0 → 1.4.0

package/dist/runtime/form/components/page/form-page-navigation.vue.d.ts

@@ -0,0 +1,34 @@
+import type { FormPageSectionState } from '../../types/index.js';
+/**
+ * Navigation of a form page: one entry per visible section, following the section in view.
+ * An entry shows whether its section is complete, invalid, or still to fill, marks optional
+ * sections, and, with `controls.dirtyCheck`, a dot on modified sections. The footer sums up
+ * the sections left to complete, or the modified ones with dirty checking.
+ *
+ * From 768px of page width it is a pinned column; below, a row of chips that scrolls sideways.
+ */
+type __VLS_Slots = {
+    /** Replaces the heading, which comes from the schema `navigation.title`. */
+    title?: () => unknown;
+    /** Replaces an entry. Call `select` to scroll to the section. */
+    item?: (props: {
+        section: FormPageSectionState;
+        active: boolean;
+        select: () => void;
+    }) => unknown;
+    /** Replaces the summary under the entries. */
+    footer?: (props: {
+        sections: readonly FormPageSectionState[];
+        remaining: number;
+        modified: number;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/form/components/page/form-page-section.d.vue.ts

@@ -0,0 +1,19 @@
+import type { FormPageSectionEntry, FormPageSectionState } from '../../types/index.js';
+type __VLS_Props = {
+    entry: FormPageSectionEntry;
+    section: FormPageSectionState;
+};
+type __VLS_Slots = {
+    actions?: (props: {
+        section: FormPageSectionState;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/form/components/page/form-page-section.vue

@@ -0,0 +1,114 @@
+<script setup>
+import UBadge from "@nuxt/ui/components/Badge.vue";
+import UButton from "@nuxt/ui/components/Button.vue";
+import { computed, onBeforeUnmount, onMounted, useId, useTemplateRef } from "vue";
+import { useUiToolsLocale } from "../../../i18n/use-locale";
+import { useFormGridLayout } from "../../composables/use-form-layout";
+import { useFormPageContext } from "../../composables/use-form-page";
+import { provideFormRuntime } from "../../composables/use-form-runtime";
+import { useFormUi } from "../../composables/use-form-ui";
+import { resolveFormLayoutConfig } from "../../utils/layout";
+import { mergeFormUiClass } from "../../utils/ui";
+import FormFieldRenderer from "../renderer/form-field-renderer.vue";
+const props = defineProps({
+  entry: { type: Object, required: true },
+  section: { type: Object, required: true }
+});
+defineSlots();
+const page = useFormPageContext();
+const formUi = useFormUi();
+const { t } = useUiToolsLocale();
+const { runtime } = page.root;
+const pageUi = computed(() => formUi.ui.value.page?.ui);
+const titleId = useId();
+const dirty = computed(() => page.dirtyCheck.value && props.section.dirty);
+const layout = computed(
+  () => resolveFormLayoutConfig(runtime.currentLayout.value, props.entry.section.layout)
+);
+provideFormRuntime({ ...runtime, currentLayout: layout });
+const grid = useFormGridLayout({ layout });
+const element = useTemplateRef("element");
+let unregister;
+onMounted(() => {
+  if (element.value) {
+    unregister = page.register(props.section.key, element.value);
+  }
+});
+onBeforeUnmount(() => unregister?.());
+</script>
+
+<template>
+  <section
+    :id="section.key"
+    ref="element"
+    :aria-labelledby="titleId"
+    :data-form-page-section="section.key"
+    :data-state="section.status"
+    :data-dirty="dirty || void 0"
+    :class="
+  mergeFormUiClass(
+    'flex min-w-0 scroll-mt-[calc(var(--nut-form-page-header,0px)+var(--nut-form-page-gap,24px))] flex-col gap-[18px] rounded-xl border border-default bg-default px-5 pt-5 pb-6 transition-[border-color,box-shadow] duration-200 @3xl/form-page:px-6 @3xl/form-page:pt-[22px] data-[dirty]:border-primary data-[dirty]:ring-4 data-[dirty]:ring-primary/20',
+    pageUi?.section
+  )
+"
+  >
+    <header
+      :class="
+  mergeFormUiClass('flex flex-wrap items-center gap-x-3 gap-y-1', pageUi?.sectionHeader)
+"
+    >
+      <h2
+        :id="titleId"
+        tabindex="-1"
+        :class="
+  mergeFormUiClass(
+    'm-0 text-lg font-semibold tracking-[-0.015em] text-highlighted focus:outline-none',
+    pageUi?.sectionTitle
+  )
+"
+        data-form-page-section-title
+      >
+        {{ section.label }}
+      </h2>
+      <p
+        v-if="section.description"
+        :class="mergeFormUiClass('m-0 text-[13px] text-muted', pageUi?.sectionDescription)"
+      >
+        {{ section.description }}
+      </p>
+      <UBadge
+        v-if="section.optional"
+        color="neutral"
+        variant="soft"
+        :label="t('form.page.optional')"
+        :class="mergeFormUiClass('capitalize', pageUi?.sectionOptional)"
+      />
+      <div
+        v-if="dirty || $slots.actions"
+        :class="mergeFormUiClass('ms-auto flex items-center gap-2', pageUi?.sectionActions)"
+      >
+        <slot name="actions" :section />
+        <UButton
+          v-if="dirty"
+          type="button"
+          color="neutral"
+          variant="ghost"
+          size="sm"
+          icon="i-lucide-rotate-ccw"
+          :label="t('form.page.resetSection')"
+          :class="pageUi?.sectionReset"
+          data-form-page-reset
+          @click="page.resetSection(section.key)"
+        />
+      </div>
+    </header>
+    <div :class="mergeFormUiClass('min-w-0', pageUi?.sectionBody)" :style="grid.style.value">
+      <FormFieldRenderer
+        v-for="field in entry.section.fields"
+        :key="field.key"
+        :field="field"
+        :parent-path="[]"
+      />
+    </div>
+  </section>
+</template>

package/dist/runtime/form/components/page/form-page-section.vue.d.ts

@@ -0,0 +1,19 @@
+import type { FormPageSectionEntry, FormPageSectionState } from '../../types/index.js';
+type __VLS_Props = {
+    entry: FormPageSectionEntry;
+    section: FormPageSectionState;
+};
+type __VLS_Slots = {
+    actions?: (props: {
+        section: FormPageSectionState;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/form/components/page/form-page-sections.d.vue.ts

@@ -0,0 +1,21 @@
+import type { FormPageSectionState } from '../../types/index.js';
+/**
+ * Cards of a form page, one per visible section, each with its title, description, fields, and,
+ * with `controls.dirtyCheck`, a ring and a reset button while it is modified. Skeleton cards
+ * stand in while the schema context loads.
+ */
+type __VLS_Slots = {
+    /** Extra buttons in a section header, before its reset button. */
+    actions?: (props: {
+        section: FormPageSectionState;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/form/components/page/form-page-sections.vue

@@ -0,0 +1,75 @@
+<script setup>
+import UAlert from "@nuxt/ui/components/Alert.vue";
+import UButton from "@nuxt/ui/components/Button.vue";
+import USkeleton from "@nuxt/ui/components/Skeleton.vue";
+import { computed } from "vue";
+import { useUiToolsLocale } from "../../../i18n/use-locale";
+import { useFormPageContext } from "../../composables/use-form-page";
+import { useFormUi } from "../../composables/use-form-ui";
+import { mergeFormUiClass } from "../../utils/ui";
+import FormPageSection from "./form-page-section.vue";
+defineSlots();
+const page = useFormPageContext();
+const formUi = useFormUi();
+const { t } = useUiToolsLocale();
+const pageUi = computed(() => formUi.ui.value.page?.ui);
+const { contextError, contextLoading, contextPending, refreshContext } = page.root;
+</script>
+
+<template>
+  <div
+    :class="mergeFormUiClass('flex min-w-0 flex-col gap-[18px]', pageUi?.sections)"
+    data-form-page-sections
+  >
+    <UAlert
+      v-if="contextError"
+      color="error"
+      variant="soft"
+      icon="i-lucide-circle-alert"
+      :title="t('form.states.contextError.title')"
+      :description="contextError"
+    >
+      <template #actions>
+        <UButton
+          type="button"
+          color="error"
+          variant="outline"
+          size="xs"
+          :loading="contextLoading"
+          @click="refreshContext"
+        >
+          {{ t("form.states.contextError.action") }}
+        </UButton>
+      </template>
+    </UAlert>
+    <template v-if="contextPending">
+      <div
+        v-for="section in page.sections.value"
+        :key="section.key"
+        :class="
+  mergeFormUiClass(
+    'grid gap-4 rounded-xl border border-default bg-default px-6 pt-[22px] pb-6',
+    pageUi?.sectionSkeleton
+  )
+"
+        data-form-skeleton
+      >
+        <USkeleton class="h-5 w-40" />
+        <USkeleton class="h-9 w-full" />
+        <USkeleton class="h-9 w-2/3" />
+      </div>
+    </template>
+    <template v-else>
+      <FormPageSection
+        v-for="item in page.items.value"
+        :key="item.section.key"
+        :entry="item.entry"
+        :section="item.section"
+      >
+        <template v-if="$slots.actions" #actions="slotProps">
+          <slot name="actions" v-bind="slotProps" />
+        </template>
+      </FormPageSection>
+    </template>
+  </div>
+</template>

package/dist/runtime/form/components/page/form-page-sections.vue.d.ts

@@ -0,0 +1,21 @@
+import type { FormPageSectionState } from '../../types/index.js';
+/**
+ * Cards of a form page, one per visible section, each with its title, description, fields, and,
+ * with `controls.dirtyCheck`, a ring and a reset button while it is modified. Skeleton cards
+ * stand in while the schema context loads.
+ */
+type __VLS_Slots = {
+    /** Extra buttons in a section header, before its reset button. */
+    actions?: (props: {
+        section: FormPageSectionState;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/form/components/page/form-page.d.vue.ts

@@ -0,0 +1,80 @@
+import type { FormPageSectionState, FormRendererController, FormUiConfig, FormValue } from '../../types/index.js';
+/**
+ * A form laid out as a page: a header with the title and the actions, a navigation that follows
+ * the section in view, and one card per section. Render a schema from `defineFormPageSchema`.
+ *
+ * The page scrolls on its own, so give it a height (`h-full` in a layout that sizes its main
+ * area). Put parts in the default slot to compose another layout: `FormPageHeader`,
+ * `FormPageNavigation`, `FormPageSections`, and `FormPageActions` read the page they render in.
+ *
+ * @example
+ * ```vue
+ * <!-- const form = useForm({ schema: accountFormSchema(), onSubmit: createAccount }) -->
+ * <UiFormPage :form />
+ *
+ * <UiFormPage :form>
+ *   <UiFormPageHeader />
+ *   <div class="grid grid-cols-[minmax(0,1fr)_240px] gap-6 p-6">
+ *     <UiFormPageSections />
+ *     <UiFormPageNavigation />
+ *   </div>
+ * </UiFormPage>
+ * ```
+ */
+type __VLS_Props = {
+    form: FormRendererController;
+    /**
+     * Records the section picked in the navigation in the URL hash (`#identity`), and opens the
+     * page on the section the hash names. Defaults to `true`.
+     */
+    hash?: boolean;
+    /** Presentation overrides, merged after the app config and the schema `ui`. */
+    ui?: FormUiConfig;
+};
+type __VLS_Slots = {
+    /** Replaces the whole layout with parts of the page. */
+    default?: () => unknown;
+    /** Slots of the default header: see `FormPageHeader`. */
+    'header-leading'?: () => unknown;
+    'header-eyebrow'?: () => unknown;
+    'header-title'?: () => unknown;
+    'header-description'?: () => unknown;
+    'header-actions'?: () => unknown;
+    /** Slots of the default navigation: see `FormPageNavigation`. */
+    'navigation-title'?: () => unknown;
+    'navigation-item'?: (props: {
+        section: FormPageSectionState;
+        active: boolean;
+        select: () => void;
+    }) => unknown;
+    'navigation-footer'?: (props: {
+        sections: readonly FormPageSectionState[];
+        remaining: number;
+        modified: number;
+    }) => unknown;
+    /** Extra buttons in a section header: see `FormPageSections`. */
+    'section-actions'?: (props: {
+        section: FormPageSectionState;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    submit: (value: import("../../../shared/index.js").GenericObject, result: {
+        success: boolean;
+        data?: FormValue;
+    }) => any;
+    cancel: (value: import("../../../shared/index.js").GenericObject) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSubmit?: ((value: import("../../../shared/index.js").GenericObject, result: {
+        success: boolean;
+        data?: FormValue;
+    }) => any) | undefined;
+    onCancel?: ((value: import("../../../shared/index.js").GenericObject) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/form/components/page/form-page.vue

@@ -0,0 +1,91 @@
+<script setup>
+import { computed, useTemplateRef } from "vue";
+import { provideFormPage, useFormPage } from "../../composables/use-form-page";
+import { useFormRoot } from "../../composables/use-form-root";
+import { mergeFormUiClass } from "../../utils/ui";
+import FormPageHeader from "./form-page-header.vue";
+import FormPageNavigation from "./form-page-navigation.vue";
+import FormPageSections from "./form-page-sections.vue";
+const {
+  form,
+  hash = true,
+  ui = void 0
+} = defineProps({
+  form: { type: Object, required: true },
+  hash: { type: Boolean, required: false },
+  ui: { type: Object, required: false }
+});
+const emit = defineEmits(["submit", "cancel"]);
+defineSlots();
+const element = useTemplateRef("element");
+const root = useFormRoot({
+  form: () => form,
+  input: () => void 0,
+  onCancelled: (value) => emit("cancel", value),
+  onSubmitted: (value, result) => emit("submit", value, result),
+  schema: () => void 0,
+  syncInput: () => void 0,
+  ui: () => ui,
+  validate: () => void 0
+});
+const page = provideFormPage(useFormPage({ element: () => element.value, hash: () => hash, root }));
+const pageUi = computed(() => root.formUi.ui.value.page?.ui);
+</script>
+
+<template>
+  <form
+    ref="element"
+    novalidate
+    :class="
+  mergeFormUiClass('@container/form-page h-full min-w-0 overflow-y-auto bg-muted', pageUi?.root)
+"
+    :style="{ '--nut-form-page-header': `${page.stickyOffset.value}px` }"
+    data-form-page
+    @submit.prevent="root.submit"
+  >
+    <slot>
+      <FormPageHeader>
+        <template v-if="$slots['header-leading']" #leading>
+          <slot name="header-leading" />
+        </template>
+        <template v-if="$slots['header-eyebrow']" #eyebrow>
+          <slot name="header-eyebrow" />
+        </template>
+        <template v-if="$slots['header-title']" #title>
+          <slot name="header-title" />
+        </template>
+        <template v-if="$slots['header-description']" #description>
+          <slot name="header-description" />
+        </template>
+        <template v-if="$slots['header-actions']" #actions>
+          <slot name="header-actions" />
+        </template>
+      </FormPageHeader>
+      <div
+        :class="
+  mergeFormUiClass(
+    'grid gap-4 px-4 pt-4 pb-16 @3xl/form-page:grid-cols-[200px_minmax(0,1fr)] @3xl/form-page:items-start @3xl/form-page:gap-7 @3xl/form-page:px-7 @3xl/form-page:pt-6 @3xl/form-page:pb-20 @5xl/form-page:grid-cols-[230px_minmax(0,760px)]',
+    pageUi?.body
+  )
+"
+      >
+        <FormPageNavigation>
+          <template v-if="$slots['navigation-title']" #title>
+            <slot name="navigation-title" />
+          </template>
+          <template v-if="$slots['navigation-item']" #item="slotProps">
+            <slot name="navigation-item" v-bind="slotProps" />
+          </template>
+          <template v-if="$slots['navigation-footer']" #footer="slotProps">
+            <slot name="navigation-footer" v-bind="slotProps" />
+          </template>
+        </FormPageNavigation>
+        <FormPageSections>
+          <template v-if="$slots['section-actions']" #actions="slotProps">
+            <slot name="section-actions" v-bind="slotProps" />
+          </template>
+        </FormPageSections>
+      </div>
+    </slot>
+  </form>
+</template>

package/dist/runtime/form/components/page/form-page.vue.d.ts

@@ -0,0 +1,80 @@
+import type { FormPageSectionState, FormRendererController, FormUiConfig, FormValue } from '../../types/index.js';
+/**
+ * A form laid out as a page: a header with the title and the actions, a navigation that follows
+ * the section in view, and one card per section. Render a schema from `defineFormPageSchema`.
+ *
+ * The page scrolls on its own, so give it a height (`h-full` in a layout that sizes its main
+ * area). Put parts in the default slot to compose another layout: `FormPageHeader`,
+ * `FormPageNavigation`, `FormPageSections`, and `FormPageActions` read the page they render in.
+ *
+ * @example
+ * ```vue
+ * <!-- const form = useForm({ schema: accountFormSchema(), onSubmit: createAccount }) -->
+ * <UiFormPage :form />
+ *
+ * <UiFormPage :form>
+ *   <UiFormPageHeader />
+ *   <div class="grid grid-cols-[minmax(0,1fr)_240px] gap-6 p-6">
+ *     <UiFormPageSections />
+ *     <UiFormPageNavigation />
+ *   </div>
+ * </UiFormPage>
+ * ```
+ */
+type __VLS_Props = {
+    form: FormRendererController;
+    /**
+     * Records the section picked in the navigation in the URL hash (`#identity`), and opens the
+     * page on the section the hash names. Defaults to `true`.
+     */
+    hash?: boolean;
+    /** Presentation overrides, merged after the app config and the schema `ui`. */
+    ui?: FormUiConfig;
+};
+type __VLS_Slots = {
+    /** Replaces the whole layout with parts of the page. */
+    default?: () => unknown;
+    /** Slots of the default header: see `FormPageHeader`. */
+    'header-leading'?: () => unknown;
+    'header-eyebrow'?: () => unknown;
+    'header-title'?: () => unknown;
+    'header-description'?: () => unknown;
+    'header-actions'?: () => unknown;
+    /** Slots of the default navigation: see `FormPageNavigation`. */
+    'navigation-title'?: () => unknown;
+    'navigation-item'?: (props: {
+        section: FormPageSectionState;
+        active: boolean;
+        select: () => void;
+    }) => unknown;
+    'navigation-footer'?: (props: {
+        sections: readonly FormPageSectionState[];
+        remaining: number;
+        modified: number;
+    }) => unknown;
+    /** Extra buttons in a section header: see `FormPageSections`. */
+    'section-actions'?: (props: {
+        section: FormPageSectionState;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    submit: (value: import("../../../shared/index.js").GenericObject, result: {
+        success: boolean;
+        data?: FormValue;
+    }) => any;
+    cancel: (value: import("../../../shared/index.js").GenericObject) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSubmit?: ((value: import("../../../shared/index.js").GenericObject, result: {
+        success: boolean;
+        data?: FormValue;
+    }) => any) | undefined;
+    onCancel?: ((value: import("../../../shared/index.js").GenericObject) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/form/components/renderer/form-field-shell.vue

@@ -10,8 +10,8 @@ import { useUiToolsLocale } from "../../../i18n/use-locale";
 import { useFormFieldBare } from "../../composables/use-form-field-chrome";
 import { useFormRuntimeContext } from "../../composables/use-form-runtime";
 import { useFormUi } from "../../composables/use-form-ui";
+import { getSchemaDirtyCheck } from "../../utils/controls";
 import { createFormFieldInstance } from "../../utils/field-instance";
-import { isRecord } from "../../utils/path";
 import { isFunction, isNumber, isString } from "../../utils/predicate";
 import { resolveRequired } from "../../utils/state";
 import { resolveFieldDescription, resolveFormText } from "../../utils/text";
@@ -85,21 +85,17 @@ const help = computed(
 );
 const shellHelp = computed(() => props.inlineLabel ? void 0 : help.value);
 const dirty = computed(
-  () => "dirtyCheck" in props.field && (props.field.dirtyCheck === true || schemaDirtyCheck()) && form.dirtyPaths.value.includes(props.path.join("."))
+  () => "dirtyCheck" in props.field && (props.field.dirtyCheck === true || getSchemaDirtyCheck(form.schema.value)) && form.dirtyPaths.value.includes(props.path.join("."))
 );
-function schemaDirtyCheck() {
-  const schema = form.schema.value;
-  if (!isRecord(schema) || !isRecord(schema.controls)) {
-    return false;
-  }
-  return schema.controls.dirtyCheck === true;
-}
 const open = ref(!("collapsed" in props.field && props.field.collapsed === true));
 const collapsible = computed(() => "collapsible" in props.field && props.field.collapsible === true);
 const fieldUi = computed(() => formUi.ui.value.field?.ui);
+const stacked = computed(
+  () => orientation.value === "vertical" && Boolean(shellLabel.value || shellDescription.value)
+);
 const nuxtFieldUi = computed(() => ({
   container: mergeFormUiClass(
-    orientation.value === "horizontal" ? "min-w-0 flex-1" : void 0,
+    orientation.value === "horizontal" ? "min-w-0 flex-1" : stacked.value ? "mt-0" : void 0,
     fieldUi.value?.container
   ),
   description: fieldUi.value?.description,
@@ -111,7 +107,7 @@ const nuxtFieldUi = computed(() => ({
     orientation.value === "horizontal" && labelWidth.value ? "w-(--nut-form-label-width) shrink-0" : void 0,
     fieldUi.value?.labelWrapper
   ),
-  root: fieldUi.value?.root,
+  root: mergeFormUiClass(stacked.value ? "flex flex-col gap-1.5" : void 0, fieldUi.value?.root),
   wrapper: fieldUi.value?.wrapper
 }));
 function resetField() {