@mapomodule/form 2.0.0-beta.0 → 2.0.0-beta.2

package/dist/runtime/types/descriptor.d.ts

@@ -0,0 +1,359 @@
+import type { Component } from "vue";
+/** Lookup table for decrementing depth at compile time. */
+type Prev = [never, 0, 1, 2, 3, 4];
+/**
+ * Recursively builds all valid dotted-path keys of T up to depth D.
+ * Arrays are not expanded — repeater items declare their own nested `fields`.
+ * When T is the default `Record<string, unknown>`, this resolves to `string`
+ * so untyped field arrays remain unconstrained.
+ */
+export type DeepKeyOf<T, D extends number = 4> = [D] extends [never] ? never : T extends object ? {
+    [K in keyof T & string]: K | (NonNullable<T[K]> extends unknown[] ? never : NonNullable<T[K]> extends object ? `${K}.${DeepKeyOf<NonNullable<T[K]>, Prev[D]>}` : never);
+}[keyof T & string] : never;
+/**
+ * All field types recognised by the default Mapo form registry.
+ * Use {@link FieldType} when you need to accept custom (string) types too.
+ */
+export declare enum KnownFieldType {
+    Text = "text",
+    Textarea = "textarea",
+    Email = "email",
+    Url = "url",
+    Number = "number",
+    Boolean = "boolean",
+    Switch = "switch",
+    Slider = "slider",
+    Color = "color",
+    File = "file",
+    Select = "select",
+    Fks = "fks",
+    M2m = "m2m",
+    Date = "date",
+    Time = "time",
+    Datetime = "datetime",
+    Editor = "editor",
+    Seo = "seo",
+    Map = "map",
+    Repeater = "repeater",
+    Media = "media",
+    MediaM2m = "media-m2m",
+    EnhancedMedia = "enhanced-media"
+}
+/**
+ * Accepts any {@link KnownFieldType} value **or** an arbitrary string for custom types
+ * registered by the consumer via `defineFormField()` or `nuxt.config`.
+ */
+export type FieldType = `${KnownFieldType}` | (string & {});
+/**
+ * Custom get/set accessor pair for a field.
+ * Use this to redirect reads/writes to a different model path or to apply
+ * a transformation (e.g. serialise a Date object to an ISO string).
+ */
+export interface FieldAccessor<TValue = unknown, TModel = unknown> {
+    get?: (ctx: {
+        model: TModel;
+        val: TValue;
+        lang?: string;
+    }) => TValue;
+    set?: (ctx: {
+        model: TModel;
+        val: TValue;
+        lang?: string;
+    }) => TValue;
+}
+/**
+ * Common properties shared by every field descriptor.
+ * All concrete descriptor types extend this interface.
+ */
+interface FieldBase<T> {
+    /** Model key. Accepts a direct `keyof T` or a dotted path up to 4 levels deep (e.g. `"data.hero.title"`). */
+    key: DeepKeyOf<T>;
+    /** Human-readable label displayed above the field. */
+    label?: string;
+    /** Adds a required validation rule and marks the field visually. */
+    required?: boolean;
+    /** Renders the field in read-only mode (no user input allowed). */
+    readonly?: boolean;
+    /** `v-if` predicate — removes the field from the DOM entirely when `false`. */
+    visible?: (ctx: {
+        model: T;
+    }) => boolean;
+    /** `v-show` predicate — hides the field while keeping it in the DOM. */
+    show?: (ctx: {
+        model: T;
+    }) => boolean;
+    /** Callback fired after the field value changes. */
+    onChange?: (ctx: {
+        model: T;
+        val: unknown;
+    }) => void;
+    /**
+     * Synchronous client-side validation.
+     * Return `null` if the value is valid, or an error message string otherwise.
+     * The first argument is the current field value, typed as the union of all
+     * model values (plus `null` / `undefined`) so TypeScript can contextually type
+     * the callback parameter without falling back to implicit `any`.
+     */
+    validate?: (val: T[keyof T & string] | null | undefined, ctx: {
+        model: T;
+    }) => string | null;
+    /**
+     * Asynchronous validation (e.g. uniqueness check, server-side rule).
+     * Runs debounced after every value change.
+     * Return `null` if valid, or an error message string otherwise.
+     */
+    validateAsync?: (val: T[keyof T & string] | null | undefined, ctx: {
+        model: T;
+    }) => Promise<string | null>;
+    /** Debounce delay in milliseconds for `validateAsync`. Default: `600`. */
+    validateAsyncDebounce?: number;
+    /** Custom get/set accessor. Overrides the registry-level accessor for this field. */
+    accessor?: FieldAccessor;
+    /** When `true`, reads/writes `model.translations[currentLang][key]` instead of `model[key]`. */
+    translatable?: boolean;
+    /** When `true`, propagates the value to all available language translations simultaneously. */
+    synci18n?: boolean;
+    /** Group name. Fields sharing the same group are rendered inside a collapsible group card. */
+    group?: string;
+    /**
+     * Sub-tab name inside the group card. When set, the field is placed in a
+     * tab bar rendered within its parent group card. Requires `group` to be set.
+     *
+     * @example
+     * { group: 'seo', subtab: 'basic',    key: 'meta_title' }
+     * { group: 'seo', subtab: 'advanced', key: 'og_image'   }
+     * // → "seo" group card shows a "basic" / "advanced" tab bar inside
+     */
+    subtab?: string;
+    /**
+     * Tab name. Fields sharing the same tab are rendered under the same tab panel.
+     *
+     * Supports nested tabs via an array path or a `/`-separated string:
+     * - `tab: 'settings'` — top-level tab (backward-compatible)
+     * - `tab: ['settings', 'seo']` — nested: "seo" sub-tab inside "settings"
+     * - `tab: 'settings/seo'` — equivalent slash-separated form
+     */
+    tab?: string | string[];
+    /**
+     * Column span (out of 12) for the field wrapper.
+     * Accepts a plain number or a responsive breakpoint map `{ sm, md, lg }`.
+     * Default: `12` (full width).
+     */
+    cols?: number | {
+        sm?: number;
+        md?: number;
+        lg?: number;
+    };
+    /** CSS class applied to the outer field wrapper element. */
+    class?: string | string[] | Record<string, boolean>;
+    /**
+     * When `true`, the field renders an expand button that fills the group container.
+     * The group becomes a full-screen overlay and all other fields are hidden.
+     * Useful for large textarea, rich-text editors, maps, etc.
+     */
+    expandable?: boolean;
+    /** Debounce delay in milliseconds for the `update:modelValue` emit. Default: `300`. Use `0` for immediate. */
+    debounce?: number;
+    /**
+     * Extra props forwarded verbatim to the underlying input component via `v-bind`
+     * (e.g. Nuxt UI props: `icon`, `variant`, `color`, `size`…).
+     *
+     * Use `attrs` for the field's own typed configuration; `passthrough` is the
+     * escape hatch for anything the wrapped component accepts.
+     */
+    passthrough?: Record<string, unknown>;
+    /** Direct component override. Takes priority over `registry.mapping[type]`. */
+    is?: Component;
+    /**
+     * When `true`, this field's value is excluded from draft snapshots saved to localStorage.
+     * Use for sensitive fields (passwords, API keys, tokens) that should never be persisted client-side.
+     */
+    noDraft?: boolean;
+}
+/**
+ * Descriptor for plain text input (`type: 'text'`), multi-line textarea
+ * (`type: 'textarea'`), and native email / url inputs.
+ */
+export interface TextDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Text}` | `${KnownFieldType.Textarea}` | `${KnownFieldType.Email}` | `${KnownFieldType.Url}`;
+    attrs?: {
+        placeholder?: string;
+        maxLength?: number;
+        minLength?: number;
+        /** Visible rows for `type: 'textarea'`. */
+        rows?: number;
+    };
+}
+/** Descriptor for numeric input (`type: 'number'`) and range slider (`type: 'slider'`). */
+export interface NumberDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Number}` | `${KnownFieldType.Slider}`;
+    attrs?: {
+        min?: number;
+        max?: number;
+        step?: number;
+        placeholder?: string;
+    };
+}
+/** Descriptor for checkbox (`type: 'boolean'`) and toggle switch (`type: 'switch'`). */
+export interface BooleanDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Boolean}` | `${KnownFieldType.Switch}`;
+}
+/**
+ * Descriptor for a single-value or multi-value select menu.
+ * Provide the choices via `attrs.items` (Nuxt UI shape) or the legacy
+ * `attrs.options` (Mapo v1 shape).
+ */
+export interface SelectDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Select}`;
+    attrs: {
+        /** Choices in Nuxt UI shape (or plain strings) — forwarded to `USelectMenu`. */
+        items?: ReadonlyArray<string | {
+            label: string;
+            value: unknown;
+        }>;
+        /** Choices in Mapo v1 shape (`text`/`value`). Used when `items` is absent. */
+        options?: ReadonlyArray<{
+            text: string;
+            value: unknown;
+        }>;
+        multiple?: boolean;
+        placeholder?: string;
+    };
+}
+/**
+ * Descriptor for FK autocomplete (`type: 'fks'`) and many-to-many autocomplete (`type: 'm2m'`).
+ * Requires `attrs.endpoint`.
+ */
+export interface FksDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Fks}` | `${KnownFieldType.M2m}`;
+    attrs: {
+        endpoint: string;
+        itemText?: string;
+        itemValue?: string;
+        returnObject?: boolean;
+        multiple?: boolean;
+    };
+}
+/** Descriptor for date (`type: 'date'`), time (`type: 'time'`), and datetime (`type: 'datetime'`) pickers. */
+export interface DateDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Date}` | `${KnownFieldType.Time}` | `${KnownFieldType.Datetime}`;
+    attrs?: {
+        min?: string;
+        max?: string;
+        granularity?: string;
+        /** Timezone strategy for datetime parsing/serialisation. Default: `"naive"`. */
+        tz?: "naive" | "utc";
+    };
+}
+/** Descriptor for a colour picker field. */
+export interface ColorDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Color}`;
+}
+/** Descriptor for a file upload field. */
+export interface FileDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.File}`;
+    attrs?: {
+        accept?: string;
+        maxSize?: number;
+    };
+}
+/** Descriptor for a Tiptap rich-text editor. */
+export interface EditorDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Editor}`;
+    attrs?: {
+        extensions?: unknown[];
+    };
+}
+/** Descriptor for the SEO preview field (title + description + live SERP preview). */
+export interface SeoDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Seo}`;
+}
+/** Descriptor for a Leaflet map field. Model value is `{ lat: number; lng: number }`. */
+export interface MapDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Map}`;
+    attrs?: {
+        defaultLat?: number;
+        defaultLng?: number;
+        zoom?: number;
+    };
+}
+/** Descriptor for a drag-and-drop repeater with nested field descriptors. */
+export interface RepeaterDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Repeater}`;
+    /**
+     * Field descriptors for each item inside the repeater.
+     * Optional when `attrs.templates` provides per-template fields.
+     */
+    fields?: AnyFieldDescriptor[];
+    attrs?: {
+        /** Multiple templates for heterogeneous items (`oneOf` discriminated union). */
+        templates?: Record<string, AnyFieldDescriptor[]>;
+        /** Label shown when an item is collapsed. Receives the item and its index. */
+        previewLabel?: (item: unknown, index: number) => string;
+        confirmDelete?: boolean;
+        allowDuplicate?: boolean;
+        /** Show a numeric position input alongside the reorder buttons. */
+        showPositionField?: boolean;
+        defaultExpanded?: boolean;
+        maxItems?: number;
+        minItems?: number;
+        /**
+         * Renders a compact preview card for inactive items.
+         * Activated when the number of items exceeds `compressThreshold`.
+         */
+        miniCard?: (item: unknown, index: number) => {
+            title: string;
+            subtitle?: string;
+            /** URL or base64 string for a thumbnail image. */
+            thumbnail?: string;
+            statusColor?: "success" | "info" | "warning" | "error" | "neutral";
+        };
+        /** Minimum item count above which contextual scaling activates. Default: `3`. */
+        compressThreshold?: number;
+    };
+}
+/** Descriptor for media/file manager fields. */
+export interface MediaDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: `${KnownFieldType.Media}` | `${KnownFieldType.MediaM2m}` | `${KnownFieldType.EnhancedMedia}`;
+    attrs?: {
+        mime?: string;
+        multiple?: boolean;
+    };
+}
+/**
+ * Escape-hatch descriptor for custom field types registered by the consumer.
+ * `attrs` stays fully open here: the wrapped component is user-defined, so its
+ * props cannot be known in advance.
+ */
+export interface CustomDescriptor<T = Record<string, unknown>> extends FieldBase<T> {
+    type: string & {};
+    attrs?: Record<string, unknown>;
+}
+/**
+ * Union of the built-in (known) field descriptor types.
+ * Use this as the type for a `fields` array passed to `<MapoForm>` or `useMapoForm()`.
+ *
+ * This union is **strict**: object literals get full excess-property checking
+ * on `attrs` (typos and wrong-type keys are compile errors). If the form mixes
+ * in custom field types registered via `defineFormField()` / the registry,
+ * annotate the array with {@link AnyFieldDescriptor} instead.
+ *
+ * @example
+ * const fields: FieldDescriptor<Article>[] = [
+ *   { key: 'title', type: KnownFieldType.Text, label: 'Title', required: true },
+ *   { key: 'body',  type: KnownFieldType.Editor, label: 'Body', translatable: true },
+ * ]
+ */
+export type FieldDescriptor<T = Record<string, unknown>> = TextDescriptor<T> | NumberDescriptor<T> | BooleanDescriptor<T> | SelectDescriptor<T> | FksDescriptor<T> | DateDescriptor<T> | ColorDescriptor<T> | FileDescriptor<T> | EditorDescriptor<T> | SeoDescriptor<T> | MapDescriptor<T> | RepeaterDescriptor<T> | MediaDescriptor<T>;
+/**
+ * {@link FieldDescriptor} plus the {@link CustomDescriptor} escape hatch.
+ *
+ * This is what the form engine accepts everywhere (MapoForm, useMapoForm,
+ * MapoDetail / MapoList editFields…). Annotate your `fields` array with this
+ * type when it contains custom field types — note that the open
+ * `CustomDescriptor.attrs` disables excess-property checking on the union, so
+ * prefer the strict {@link FieldDescriptor} when no custom types are used.
+ */
+export type AnyFieldDescriptor<T = Record<string, unknown>> = FieldDescriptor<T> | CustomDescriptor<T>;
+export {};
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/runtime/types/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/descriptor.ts"],"names":[],"mappings":"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"}

package/dist/runtime/types/descriptor.js

@@ -0,0 +1,26 @@
+export var KnownFieldType = /* @__PURE__ */ ((KnownFieldType2) => {
+  KnownFieldType2["Text"] = "text";
+  KnownFieldType2["Textarea"] = "textarea";
+  KnownFieldType2["Email"] = "email";
+  KnownFieldType2["Url"] = "url";
+  KnownFieldType2["Number"] = "number";
+  KnownFieldType2["Boolean"] = "boolean";
+  KnownFieldType2["Switch"] = "switch";
+  KnownFieldType2["Slider"] = "slider";
+  KnownFieldType2["Color"] = "color";
+  KnownFieldType2["File"] = "file";
+  KnownFieldType2["Select"] = "select";
+  KnownFieldType2["Fks"] = "fks";
+  KnownFieldType2["M2m"] = "m2m";
+  KnownFieldType2["Date"] = "date";
+  KnownFieldType2["Time"] = "time";
+  KnownFieldType2["Datetime"] = "datetime";
+  KnownFieldType2["Editor"] = "editor";
+  KnownFieldType2["Seo"] = "seo";
+  KnownFieldType2["Map"] = "map";
+  KnownFieldType2["Repeater"] = "repeater";
+  KnownFieldType2["Media"] = "media";
+  KnownFieldType2["MediaM2m"] = "media-m2m";
+  KnownFieldType2["EnhancedMedia"] = "enhanced-media";
+  return KnownFieldType2;
+})(KnownFieldType || {});

package/dist/runtime/types/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Form engine type barrel.
+ * Re-exports all descriptor types, the {@link KnownFieldType} enum,
+ * and registry helpers.
+ */
+export { KnownFieldType } from "./descriptor.js";
+export type { FieldType, FieldAccessor, FieldDescriptor, AnyFieldDescriptor, TextDescriptor, NumberDescriptor, BooleanDescriptor, SelectDescriptor, FksDescriptor, DateDescriptor, ColorDescriptor, FileDescriptor, EditorDescriptor, SeoDescriptor, MapDescriptor, RepeaterDescriptor, MediaDescriptor, CustomDescriptor, } from "./descriptor.js";
+export type { FieldComponentEntry, FieldRegistry, PartialFieldRegistry, } from "./registry.js";
+export { resolveFieldComponent, resolveFieldAttrs, resolveFieldAccessor, } from "./registry.js";
+export type { MapoFormRuntimeConfig } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/runtime/types/index.js

@@ -0,0 +1,6 @@
+export { KnownFieldType } from "./descriptor.js";
+export {
+  resolveFieldComponent,
+  resolveFieldAttrs,
+  resolveFieldAccessor
+} from "./registry.js";

package/dist/runtime/types/layout.d.ts

@@ -0,0 +1,21 @@
+import type { AnyFieldDescriptor } from "./index.js";
+/**
+ * A group of fields rendered inside a single group card.
+ * `subtabs` holds fields assigned to a sub-tab bar within the group.
+ *
+ * Shared by `MapoForm` and `MapoFormTabs` so the grouped tree is a single
+ * structural type (avoids "two unrelated types with the same name").
+ */
+export interface GroupEntry {
+    label?: string;
+    fields: AnyFieldDescriptor[];
+    subtabs: Map<string, AnyFieldDescriptor[]>;
+}
+/** A tab panel; may nest further tabs through `children`. */
+export interface TabEntry {
+    name: string;
+    label?: string;
+    groups: Map<string, GroupEntry>;
+    children: Map<string, TabEntry>;
+}
+//# sourceMappingURL=layout.d.ts.map

package/dist/runtime/types/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;CAC5C;AAED,6DAA6D;AAC7D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACjC"}

package/dist/runtime/types/registry.d.ts

@@ -0,0 +1,62 @@
+import type { Component } from "vue";
+import type { AnyFieldDescriptor, FieldAccessor } from "./descriptor.js";
+/**
+ * Accepted values for a registry entry:
+ * - `string` — Nuxt UI component name, resolved at runtime via `resolveComponent()`
+ * - `Component` — synchronous Vue component object
+ * - `() => Promise<{ default: Component }>` — async lazy import
+ */
+export type FieldComponentEntry = string | Component | (() => Promise<{
+    default: Component;
+}>);
+/** The global form field registry injected as `$mapoFormRegistry`. */
+export interface FieldRegistry {
+    /** Maps a field `type` string to its component entry. */
+    mapping: Record<string, FieldComponentEntry>;
+    /**
+     * Default `attrs` merged into every field of the given type.
+     * The special key `'All'` is applied to all field types.
+     */
+    attrs: Record<string, Record<string, unknown>>;
+    /** Default `get`/`set` accessor applied per field type. */
+    accessor: Record<string, FieldAccessor>;
+}
+/**
+ * Partial version of {@link FieldRegistry} for consumer overrides
+ * (e.g. `mapoForm.fields` in `nuxt.config`).
+ */
+export type PartialFieldRegistry = {
+    mapping?: Partial<FieldRegistry["mapping"]>;
+    attrs?: Partial<FieldRegistry["attrs"]>;
+    accessor?: Partial<FieldRegistry["accessor"]>;
+};
+/**
+ * Resolves the component entry for a given field descriptor.
+ * Returns the `descriptor.is` override if set, otherwise looks up `registry.mapping`.
+ */
+export declare function resolveFieldComponent(descriptor: AnyFieldDescriptor<any>, registry: FieldRegistry): FieldComponentEntry | null;
+/**
+ * Merges the registry-level default attrs for a field type with the descriptor's
+ * own typed `attrs` and its open `passthrough` props.
+ * Order: `registry.attrs['All']` → `registry.attrs[type]` → `descriptor.attrs`
+ * → `descriptor.passthrough` (most specific wins).
+ */
+export declare function resolveFieldAttrs(descriptor: AnyFieldDescriptor<any>, registry: FieldRegistry): Record<string, unknown>;
+/**
+ * Merges the registry-level default accessor for a field type with the descriptor's own `accessor`.
+ */
+export declare function resolveFieldAccessor(descriptor: AnyFieldDescriptor<any>, registry: FieldRegistry): FieldAccessor;
+/**
+ * Shape of `runtimeConfig.public.mapoForm` as written by the module setup.
+ * `groups` and `debounce` are guaranteed by the module `defaults`.
+ */
+export interface MapoFormRuntimeConfig {
+    groups: {
+        expanded: boolean;
+    };
+    debounce: number;
+    fields: {
+        attrs: Record<string, Record<string, unknown>>;
+    };
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/runtime/types/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/types/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,SAAS,GACT,CAAC,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC,CAAC;AAE5C,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC7C;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;CAC/C,CAAC;AAEF;;;GAGG;AAIH,wBAAgB,qBAAqB,CAEnC,UAAU,EAAE,kBAAkB,CAAC,GAAG,CAAC,EACnC,QAAQ,EAAE,aAAa,GACtB,mBAAmB,GAAG,IAAI,CAG5B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAE/B,UAAU,EAAE,kBAAkB,CAAC,GAAG,CAAC,EACnC,QAAQ,EAAE,aAAa,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAElC,UAAU,EAAE,kBAAkB,CAAC,GAAG,CAAC,EACnC,QAAQ,EAAE,aAAa,GACtB,aAAa,CAGf;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC;CAC5D"}

package/dist/runtime/types/registry.js

@@ -0,0 +1,19 @@
+export function resolveFieldComponent(descriptor, registry) {
+  if (descriptor.is) return descriptor.is;
+  return registry.mapping[descriptor.type] ?? null;
+}
+export function resolveFieldAttrs(descriptor, registry) {
+  const allAttrs = registry.attrs["All"] ?? {};
+  const typeAttrs = registry.attrs[descriptor.type] ?? {};
+  const ownAttrs = descriptor.attrs ?? {};
+  return {
+    ...allAttrs,
+    ...typeAttrs,
+    ...ownAttrs,
+    ...descriptor.passthrough ?? {}
+  };
+}
+export function resolveFieldAccessor(descriptor, registry) {
+  const typeAccessor = registry.accessor[descriptor.type] ?? {};
+  return { ...typeAccessor, ...descriptor.accessor ?? {} };
+}

package/dist/runtime/utils/flattenFieldGroups.d.ts

@@ -0,0 +1,50 @@
+import type { AnyFieldDescriptor } from "../types/index.js";
+/**
+ * Hierarchical authoring structure. Lets you group field descriptors under a
+ * named group without repeating `group` on every field.
+ *
+ * Pass an array of these to {@link flattenFieldGroups} to get the flat
+ * `AnyFieldDescriptor<T>[]` expected by `<MapoForm>` / `<MapoDetail>`.
+ */
+export interface FieldGroupDescriptor<T = Record<string, unknown>> {
+    /** Group name — propagated to every field in `fields`. */
+    group: string;
+    /** Optional tab — propagated to every field unless the field already has a `tab`. */
+    tab?: string | string[];
+    /** Fields belonging to this group. May contain nested `FieldGroupDescriptor` objects. */
+    fields: Array<AnyFieldDescriptor<T> | FieldGroupDescriptor<T>>;
+}
+/**
+ * Flattens a mixed array of `AnyFieldDescriptor` and `FieldGroupDescriptor` objects
+ * into a plain `AnyFieldDescriptor<T>[]` ready to be passed to `<MapoForm>` or `<MapoDetail>`.
+ *
+ * Each `FieldGroupDescriptor` propagates its `group` (and optionally `tab`) to
+ * every leaf field it contains. Fields that already declare a `group` or `tab`
+ * are left unchanged.
+ *
+ * Groups can be arbitrarily nested — the function recurses until every item is
+ * a leaf `AnyFieldDescriptor`.
+ *
+ * @example
+ * ```ts
+ * const fields = flattenFieldGroups<Article>([
+ *   { key: 'title', type: 'text', label: 'Title', tab: 'content' },
+ *   {
+ *     group: 'seo',
+ *     tab: 'seo',
+ *     fields: [
+ *       { key: 'seo_title',       type: 'text',     label: 'SEO Title' },
+ *       { key: 'seo_description', type: 'textarea', label: 'SEO Description' },
+ *     ],
+ *   },
+ * ])
+ * // Result:
+ * // [
+ * //   { key: 'title', type: 'text', label: 'Title', tab: 'content' },
+ * //   { key: 'seo_title', type: 'text', label: 'SEO Title', group: 'seo', tab: 'seo' },
+ * //   { key: 'seo_description', type: 'textarea', label: 'SEO Description', group: 'seo', tab: 'seo' },
+ * // ]
+ * ```
+ */
+export declare function flattenFieldGroups<T = Record<string, unknown>>(items: Array<AnyFieldDescriptor<T> | FieldGroupDescriptor<T>>, _inheritedGroup?: string, _inheritedTab?: string | string[]): AnyFieldDescriptor<T>[];
+//# sourceMappingURL=flattenFieldGroups.d.ts.map

package/dist/runtime/utils/flattenFieldGroups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flattenFieldGroups.d.ts","sourceRoot":"","sources":["../../../src/runtime/utils/flattenFieldGroups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,yFAAyF;IACzF,MAAM,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;CAChE;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,KAAK,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAC7D,eAAe,CAAC,EAAE,MAAM,EACxB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAChC,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAsBzB"}

package/dist/runtime/utils/flattenFieldGroups.js

@@ -0,0 +1,24 @@
+function isGroupDescriptor(item) {
+  return "fields" in item && Array.isArray(item.fields);
+}
+export function flattenFieldGroups(items, _inheritedGroup, _inheritedTab) {
+  const result = [];
+  for (const item of items) {
+    if (isGroupDescriptor(item)) {
+      const group = item.group ?? _inheritedGroup;
+      const tab = item.tab ?? _inheritedTab;
+      result.push(...flattenFieldGroups(item.fields, group, tab));
+    } else {
+      const field = item;
+      const merged = { ...field };
+      if (_inheritedGroup && !merged.group) {
+        Object.assign(merged, { group: _inheritedGroup });
+      }
+      if (_inheritedTab && !merged.tab) {
+        Object.assign(merged, { tab: _inheritedTab });
+      }
+      result.push(merged);
+    }
+  }
+  return result;
+}

package/dist/types.d.mts

@@ -1,13 +1,9 @@
-import type { ModuleHooks, ModuleRuntimeHooks, ModuleRuntimeConfig, ModulePublicRuntimeConfig } from './module.mjs'
+import type { NuxtModule } from '@nuxt/schema'
 
-declare module '#app' {
-  interface RuntimeNuxtHooks extends ModuleRuntimeHooks {}
-}
+import type { default as Module } from './module.mjs'
 
-declare module '@nuxt/schema' {
-  interface NuxtHooks extends ModuleHooks {}
-  interface RuntimeConfig extends ModuleRuntimeConfig {}
-  interface PublicRuntimeConfig extends ModulePublicRuntimeConfig {}
-}
+export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
 
-export * from "./module.mjs"
+export { default } from './module.mjs'
+
+export { type MapoFormOptions } from './module.mjs'