@mapomodule/form 2.0.0-beta.1 → 2.0.0-beta.11

package/README.md

@@ -1,43 +1,28 @@
 # @mapomodule/form
 
-Form engine for Mapo v2 — descriptor-driven, typesafe, headless-ready admin forms for Nuxt 4 + Django/DRF.
-
-## Features
-
-- **Descriptor-driven**: define fields as `FieldDescriptor[]` — layout, validation, i18n in one object
-- **All field types built-in**: text, select, date/time, FK/M2M autocomplete, WYSIWYG editor, SEO preview, map, repeater
-- **Headless composable**: `useMapoForm()` for fully custom layouts; `<MapoForm>` for the default shell
-- **Registry auto-injection**: `<MapoForm>` and `<MapoDetail>` resolve `$mapoFormRegistry` automatically — no boilerplate
-- **Typed extension API**: `defineFormField(type, entry, opts)` to register custom fields with collision detection
-- **JSON Schema bridge**: `useFormFromSchema()` generates descriptors from Pydantic v2 / DRF-spectacular schemas
-- **Multilingual fields**: `translatable: true` writes to `model.translations[lang].field` automatically
-- **Client validation**: `validate(value, ctx)` per descriptor + `required` shorthand
-- **Tab/group layout**: declare `tab` and `group` per field — tabs render automatically (incl. nested tabs), groups are collapsible. Tab panels expose `tab.<name>.before/after`, full override, `.label` and `tab-bar-end` slots
-- **Consistent repeater items**: `MapoRepeater` drives each item through `useMapoForm`, so nested-path keys, `translatable`, accessors, `descriptor.is` overrides and **client validation** behave identically inside a repeater
-- **Draft persistence**: `draftKey` option on `useMapoForm()` auto-saves to localStorage every 2 s; `checkDraft()` / `draftBanner` offer restore/discard; clears on successful `submit()`
-- **Fail-soft**: unknown field types render a non-destructive placeholder, never crash the form
-
-## Install
-
-`@mapomodule/form` is included automatically when you install `mapomodule` (recommended). No additional module entry is needed.
-
-```ts
-// nuxt.config.ts
-export default defineNuxtConfig({
-  modules: ["@nuxt/ui", "mapomodule"],
-  mapo: {
-    form: {
-      // optional — global field registry defaults
-    },
-  },
-});
+The form engine of Mapo. A form is an array of `FieldDescriptor` objects; the engine resolves each descriptor's `type` through a field registry to a lazily loaded component, and renders the result in `MapoDetail` (from `@mapomodule/uikit`), in `MapoForm`, or headless through `useMapoForm()`.
+
+## Installation
+
+Installed by the meta-package [`mapomodule`](https://www.npmjs.com/package/mapomodule), which configures it under `mapo.form`. On its own it reads the `mapoForm` key:
+
+```bash
+pnpm add @mapomodule/form@next
 ```
 
+| Option            | Default | Description                                                                              |
+| ----------------- | ------- | ---------------------------------------------------------------------------------------- |
+| `fields.attrs`    | `{}`    | Default `attrs` per field type, merged into the registry defaults                        |
+| `groups.expanded` | `true`  | Whether collapsible field groups start open                                              |
+| `debounce`        | `300`   | Milliseconds before a field change reaches the model; `descriptor.debounce` overrides it |
+
+Mapo v2 is published on the `next` dist-tag while it is in beta.
+
 ## Quick start
 
 ```vue
 <script setup lang="ts">
-import type { FieldDescriptor } from "@mapomodule/form";
+import type { FieldDescriptor } from "mapomodule/types";
 
 interface Article {
   title: string;
@@ -60,96 +45,30 @@ const fields: FieldDescriptor<Article>[] = [
 </template>
 ```
 
-The `registry` prop is optional — `<MapoForm>` falls back to the global `$mapoFormRegistry` provided by this module's plugin. Pass it explicitly only when you want to swap the registry for a single form.
-
-## Field types
-
-| Type                         | Component             | Notes                                                       |
-| ---------------------------- | --------------------- | ----------------------------------------------------------- |
-| `text`                       | `UInput`              |                                                             |
-| `textarea`                   | `UTextarea`           |                                                             |
-| `number`                     | `UInput[type=number]` |                                                             |
-| `boolean`                    | `UCheckbox`           |                                                             |
-| `switch`                     | `USwitch`             |                                                             |
-| `color`                      | `UInput[type=color]`  |                                                             |
-| `slider`                     | `USlider`             |                                                             |
-| `file`                       | `MapoFileField`       | Current-file preview, image thumbnail, remove button        |
-| `select`                     | `USelectMenu`         | requires `attrs.options`                                    |
-| `date` / `datetime` / `time` | `MapoDateField` etc.  | ISO string in model; `tz: 'naive' \| 'utc'` for `datetime`  |
-| `fks`                        | `MapoFksField`        | FK autocomplete; `attrs.endpoint` required                  |
-| `m2m`                        | `MapoFksField`        | Multi-select autocomplete, removable chips                  |
-| `editor`                     | `MapoWygEditor`       | Tiptap v2; sanitized output, safe `Link` validator          |
-| `seo`                        | `MapoSeoPreview`      | Title / description with live SERP preview                  |
-| `map`                        | `MapoMapField`        | Leaflet, `{ lat, lng }` in model, SSR-safe via `ClientOnly` |
-| `repeater`                   | `MapoRepeater`        | Nested fields, drag-and-drop, undo stack, templates         |
-
-## JSON Schema → Form
-
-```ts
-const schema = await $fetch("/api/schema/");
-const fields = useFormFromSchema(schema, {
-  exclude: ["id", "created_at"],
-  overrides: {
-    body: { type: "editor", translatable: true },
-  },
-});
-```
+The built-in types cover text and numbers, choices, dates and times, files, relations (`fks`, `m2m`), rich text, SEO preview, maps, repeaters and media pickers. The media pickers drive the Media Manager of `@mapomodule/uikit` and show a notice when it is not installed. A `type` the registry does not know renders `MapoUnknownField` instead of breaking the form.
 
-## Headless
+## What you get
 
-```ts
-const form = useMapoForm({ model, fields, registry: $mapoFormRegistry });
+Components and composables are auto-imported.
 
-// form.isDirty, form.isLoading, form.getPatch(), form.submit(handler)
-```
-
-The headless composable still requires the registry explicitly — `useNuxtApp()` is not available in every context where you might want to drive a form (tests, storybook, server-side preview).
-
-## Draft persistence (headless)
+| API                                                        | Purpose                                                                                                                                                                                     |
+| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `MapoForm`                                                 | Renders a `FieldDescriptor[]` on your model, with tabs, collapsible groups, a responsive grid and slots                                                                                     |
+| `useMapoForm(options)`                                     | The same engine headless: dirty state, client validation, `getPatch()`, `submit()`, drafts. Pass `registry` explicitly                                                                      |
+| `defineFormField(type, component, opts?)`                  | Registers a custom field type from a plugin: a component or a lazy `import()`, with optional default `attrs` and accessor. Re-registering a type warns unless you pass `{ override: true }` |
+| `useFormFromSchema(schema, opts?)`                         | Builds descriptors from a JSON Schema, such as a DRF-spectacular or Pydantic schema                                                                                                         |
+| `when`, `whenAny`, `whenNot`, `matchesField`, `isOneOf`, … | Build `visible` conditions declaratively                                                                                                                                                    |
+| `useFormDraft`, `useFocusMode`, `useCurrentLang`           | Draft autosave, focus mode, the language being edited                                                                                                                                       |
+| `$mapoFormRegistry`                                        | The global registry: type → component, default `attrs`, accessor                                                                                                                            |
 
-```ts
-const form = useMapoForm({
-  model,
-  fields,
-  registry: $mapoFormRegistry,
-  draftKey: `article:${route.params.id}`,
-});
-
-// After fetch:
-form.checkDraft(); // populates form.draftBanner if a draft is found
-```
-
-`form.draftBanner.value` exposes `{ savedAt, restore(), discard() }`. On `submit()` success the draft is cleared automatically. When using `<MapoDetail :draft="true">`, all of this is handled for you.
-
-## Custom fields
-
-The recommended way to register a custom field is the typed `defineFormField()` helper, called from a Nuxt plugin:
-
-```ts
-// app/plugins/my-fields.ts
-export default defineNuxtPlugin(() => {
-  defineFormField("rich-text", () => import("~/components/RichText.vue"), {
-    attrs: { rows: 6 },
-  });
-});
-```
-
-Plugins in `app/plugins/` run after module plugins, so `$mapoFormRegistry` is always available. Re-registering an existing type prints a development warning unless you pass `{ override: true }` explicitly.
-
-Any component with `modelValue` + `descriptor` + `errors` + `readonly` props works as a field.
+A custom field is any component that accepts the `modelValue`, `descriptor`, `errors`, `readonly` and `disabled` props and emits `update:modelValue`.
 
 ## Documentation
 
-Full docs: [Form Engine — Quickstart](../../../docs/uikit/form/index.md)
-
-- [All field types](../../../docs/uikit/form/add-fields.md)
-- [Validation](../../../docs/uikit/form/validation.md)
-- [i18n / multilingual fields](../../../docs/uikit/form/i18n.md)
-- [`useMapoForm()` headless](../../../docs/uikit/form/composable.md)
-- [Custom fields & registry](../../../docs/uikit/form/custom-fields.md)
-- [Slot system](../../../docs/uikit/form/slots.md)
-- [JSON Schema bridge](../../../docs/uikit/form/schema-to-form.md)
-
-## License
-
-MIT
+- [Form Engine](https://lotrekagency.github.io/mapo-new/uikit/form/): your first form, tabs and groups, how the engine works
+- [All field types](https://lotrekagency.github.io/mapo-new/uikit/form/add-fields)
+- [Field registry](https://lotrekagency.github.io/mapo-new/uikit/form/registry) and [Custom fields](https://lotrekagency.github.io/mapo-new/uikit/form/custom-fields)
+- [Validation](https://lotrekagency.github.io/mapo-new/uikit/form/validation), [Multilingual fields](https://lotrekagency.github.io/mapo-new/uikit/form/i18n), [Draft autosave](https://lotrekagency.github.io/mapo-new/uikit/form/draft), [Progressive Disclosure](https://lotrekagency.github.io/mapo-new/uikit/form/progressive-disclosure)
+- [`useMapoForm()` reference](https://lotrekagency.github.io/mapo-new/uikit/form/composable)
+- [From JSON Schema to form](https://lotrekagency.github.io/mapo-new/uikit/form/schema-to-form)
+- [Form Engine — Component API Reference](https://lotrekagency.github.io/mapo-new/uikit/form/api)

package/dist/__tests__/__mocks__/nuxt-imports.d.ts

@@ -0,0 +1,4 @@
+export declare const useSnackStore: import("vitest").Mock<() => {
+    show: import("vitest").Mock<(...args: any[]) => any>;
+}>;
+//# sourceMappingURL=nuxt-imports.d.ts.map

package/dist/__tests__/__mocks__/nuxt-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nuxt-imports.d.ts","sourceRoot":"","sources":["../../../src/__tests__/__mocks__/nuxt-imports.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa;;EAEvB,CAAC"}

package/dist/__tests__/camomillaRoundTrip.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=camomillaRoundTrip.test.d.ts.map

package/dist/__tests__/camomillaRoundTrip.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camomillaRoundTrip.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/camomillaRoundTrip.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/__tests__/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/registry.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tabVisibility.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tabVisibility.test.d.ts.map

package/dist/__tests__/tabVisibility.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabVisibility.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tabVisibility.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/useFormFromSchema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useFormFromSchema.test.d.ts.map

package/dist/__tests__/useFormFromSchema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormFromSchema.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/useFormFromSchema.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/useMapoForm.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useMapoForm.test.d.ts.map

package/dist/__tests__/useMapoForm.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMapoForm.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/useMapoForm.test.ts"],"names":[],"mappings":""}

package/dist/index.d.mts

@@ -1 +1,9 @@
-export * from "/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form/src/index.js";
+export { MapoFormOptions } from './module.mjs';
+export { UseFormFromSchemaOptions, useFormFromSchema } from '../dist/runtime/composables/useFormFromSchema.js';
+export { UseFormDraftOptions, useFormDraft } from '../dist/runtime/composables/useFormDraft.js';
+export { FocusTarget, useFocusMode } from '../dist/runtime/composables/useFocusMode.js';
+export { UnsavedChangesGuardOptions, useUnsavedChangesGuard } from '../dist/runtime/composables/useUnsavedChangesGuard.js';
+export { greaterThan, isEmpty, isNoneOf, isNotEmpty, isOneOf, lessThan, matches, matchesField, when, whenAny, whenNot } from '../dist/runtime/composables/useProgressiveDisclosure.js';
+export { FieldGroupDescriptor, flattenFieldGroups } from '../dist/runtime/utils/flattenFieldGroups.js';
+export { AnyFieldDescriptor, BooleanDescriptor, ColorDescriptor, CustomDescriptor, DateDescriptor, EditorDescriptor, EnhancedMediaDescriptor, EnhancedMediaValue, FieldAccessor, FieldComponentEntry, FieldDescriptor, FieldRegistry, FieldType, FileDescriptor, FksDescriptor, KnownFieldType, MapDescriptor, MediaDescriptor, MediaItem, MediaLink, MediaM2mDescriptor, NumberDescriptor, PartialFieldRegistry, RepeaterDescriptor, SelectDescriptor, SeoDescriptor, TextDescriptor } from '../dist/runtime/types/index.js';
+import '@nuxt/schema';

package/dist/index.d.ts

@@ -1 +1,15 @@
-export * from "/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form/src/index.js";
+export type { MapoFormOptions } from "./module.js";
+export { useFormFromSchema } from "./runtime/composables/useFormFromSchema.js";
+export type { UseFormFromSchemaOptions } from "./runtime/composables/useFormFromSchema.js";
+export { useFormDraft } from "./runtime/composables/useFormDraft.js";
+export type { UseFormDraftOptions } from "./runtime/composables/useFormDraft.js";
+export { useFocusMode } from "./runtime/composables/useFocusMode.js";
+export type { FocusTarget } from "./runtime/composables/useFocusMode.js";
+export { useUnsavedChangesGuard } from "./runtime/composables/useUnsavedChangesGuard.js";
+export type { UnsavedChangesGuardOptions } from "./runtime/composables/useUnsavedChangesGuard.js";
+export { when, whenAny, whenNot, matchesField, isOneOf, isNoneOf, isNotEmpty, isEmpty, greaterThan, lessThan, matches, } from "./runtime/composables/useProgressiveDisclosure.js";
+export { flattenFieldGroups } from "./runtime/utils/flattenFieldGroups.js";
+export type { FieldGroupDescriptor } from "./runtime/utils/flattenFieldGroups.js";
+export { KnownFieldType } from "./runtime/types/index.js";
+export type { FieldType, FieldAccessor, FieldDescriptor, AnyFieldDescriptor, TextDescriptor, NumberDescriptor, BooleanDescriptor, SelectDescriptor, FksDescriptor, DateDescriptor, ColorDescriptor, FileDescriptor, EditorDescriptor, SeoDescriptor, MapDescriptor, RepeaterDescriptor, MediaDescriptor, MediaM2mDescriptor, EnhancedMediaDescriptor, CustomDescriptor, MediaLink, MediaItem, EnhancedMediaValue, FieldComponentEntry, FieldRegistry, PartialFieldRegistry, } from "./runtime/types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,YAAY,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AACzF,YAAY,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAElG,OAAO,EACL,IAAI,EACJ,OAAO,EACP,OAAO,EACP,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,UAAU,EACV,OAAO,EACP,WAAW,EACX,QAAQ,EACR,OAAO,GACR,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,YAAY,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,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,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,GACrB,MAAM,0BAA0B,CAAC"}

package/dist/index.mjs

@@ -1,34 +1,7 @@
-import { createJiti } from "file:///home/runner/work/mapo-new/mapo-new/node_modules/.pnpm/jiti@2.6.1/node_modules/jiti/lib/jiti.mjs";
-
-const jiti = createJiti(import.meta.url, {
-  "interopDefault": true,
-  "alias": {
-    "@mapomodule/form": "/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form"
-  },
-  "transformOptions": {
-    "babel": {
-      "plugins": []
-    }
-  }
-})
-
-/** @type {import("/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form/src/index.js")} */
-const _module = await jiti.import("/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form/src/index.ts");
-
-export const useFormFromSchema = _module.useFormFromSchema;
-export const useFormDraft = _module.useFormDraft;
-export const useFocusMode = _module.useFocusMode;
-export const useUnsavedChangesGuard = _module.useUnsavedChangesGuard;
-export const when = _module.when;
-export const whenAny = _module.whenAny;
-export const whenNot = _module.whenNot;
-export const matchesField = _module.matchesField;
-export const isOneOf = _module.isOneOf;
-export const isNoneOf = _module.isNoneOf;
-export const isNotEmpty = _module.isNotEmpty;
-export const isEmpty = _module.isEmpty;
-export const greaterThan = _module.greaterThan;
-export const lessThan = _module.lessThan;
-export const matches = _module.matches;
-export const flattenFieldGroups = _module.flattenFieldGroups;
-export const KnownFieldType = _module.KnownFieldType;
+export { useFormFromSchema } from '../dist/runtime/composables/useFormFromSchema.js';
+export { useFormDraft } from '../dist/runtime/composables/useFormDraft.js';
+export { useFocusMode } from '../dist/runtime/composables/useFocusMode.js';
+export { useUnsavedChangesGuard } from '../dist/runtime/composables/useUnsavedChangesGuard.js';
+export { greaterThan, isEmpty, isNoneOf, isNotEmpty, isOneOf, lessThan, matches, matchesField, when, whenAny, whenNot } from '../dist/runtime/composables/useProgressiveDisclosure.js';
+export { flattenFieldGroups } from '../dist/runtime/utils/flattenFieldGroups.js';
+export { KnownFieldType } from '../dist/runtime/types/index.js';

package/dist/module.d.mts

@@ -1,2 +1,20 @@
-export * from "/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form/src/module.js";
-export { default } from "/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form/src/module.js";
+import { NuxtModule } from '@nuxt/schema';
+import { PartialFieldRegistry } from '../dist/runtime/types/index.js';
+import '../dist/runtime/composables/useFormFromSchema.js';
+import '../dist/runtime/composables/useFormDraft.js';
+import '../dist/runtime/composables/useFocusMode.js';
+import '../dist/runtime/composables/useUnsavedChangesGuard.js';
+import '../dist/runtime/composables/useProgressiveDisclosure.js';
+import '../dist/runtime/utils/flattenFieldGroups.js';
+
+interface MapoFormOptions {
+    fields?: PartialFieldRegistry;
+    groups?: {
+        expanded?: boolean;
+    };
+    debounce?: number;
+}
+declare const _default: NuxtModule<MapoFormOptions, MapoFormOptions, false>;
+
+export { _default as default };
+export type { MapoFormOptions };

package/dist/module.d.ts

@@ -1,2 +1,12 @@
-export * from "/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form/src/module.js";
-export { default } from "/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form/src/module.js";
+import type { NuxtModule } from "@nuxt/schema";
+import type { PartialFieldRegistry } from "./runtime/types/index.js";
+export interface MapoFormOptions {
+    fields?: PartialFieldRegistry;
+    groups?: {
+        expanded?: boolean;
+    };
+    debounce?: number;
+}
+declare const _default: NuxtModule<MapoFormOptions, MapoFormOptions, false>;
+export default _default;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;AAED,wBAkOyC"}

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@mapomodule/form",
   "configKey": "mapoForm",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.0-beta.11",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "unknown"

package/dist/module.mjs

@@ -1,18 +1,192 @@
-import { createJiti } from "file:///home/runner/work/mapo-new/mapo-new/node_modules/.pnpm/jiti@2.6.1/node_modules/jiti/lib/jiti.mjs";
+import { defineNuxtModule, createResolver, hasNuxtModule, installModule, addPlugin, addTypeTemplate, extendPages, addComponent, addImports } from '@nuxt/kit';
 
-const jiti = createJiti(import.meta.url, {
-  "interopDefault": true,
-  "alias": {
-    "@mapomodule/form": "/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form"
+const module$1 = defineNuxtModule({
+  meta: {
+    name: "@mapomodule/form",
+    configKey: "mapoForm"
   },
-  "transformOptions": {
-    "babel": {
-      "plugins": []
+  defaults: {
+    debounce: 300,
+    groups: { expanded: true }
+  },
+  async setup(options, nuxt) {
+    const resolver = createResolver(import.meta.url);
+    nuxt.options.build.transpile.push(resolver.resolve("./runtime"));
+    nuxt.options.imports.transform ??= {};
+    (nuxt.options.imports.transform.include ??= []).push(
+      /@mapomodule[\\/]form[\\/]/
+    );
+    if (!hasNuxtModule("@mapomodule/i18n")) {
+      await installModule(await resolver.resolvePath("@mapomodule/i18n"));
     }
+    nuxt.options.runtimeConfig.public.mapoForm = {
+      groups: { expanded: options.groups?.expanded ?? true },
+      debounce: options.debounce ?? 300,
+      // attrs is JSON-serialisable (plain objects) — merged in the plugin
+      fields: { attrs: options.fields?.attrs ?? {} }
+    };
+    addPlugin(resolver.resolve("./runtime/plugins/form-registry"));
+    addTypeTemplate({
+      filename: "types/mapo-form-registry.d.ts",
+      getContents: () => `
+import type { FieldRegistry } from '@mapomodule/form/types';
+declare module '#app' {
+  interface NuxtApp {
+    $mapoFormRegistry: FieldRegistry;
   }
-})
-
-/** @type {import("/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form/src/module.js")} */
-const _module = await jiti.import("/home/runner/work/mapo-new/mapo-new/packages/@mapomodule/form/src/module.ts");
+}
+declare module 'vue' {
+  interface ComponentCustomProperties {
+    $mapoFormRegistry: FieldRegistry;
+  }
+}
+export {};
+`
+    });
+    if (nuxt.options.dev) {
+      extendPages((pages) => {
+        pages.push({
+          name: "mapo-devtools-forms",
+          path: "/_mapo/devtools/forms",
+          file: resolver.resolve("./runtime/devtools/DevtoolsFormsPage.vue")
+        });
+      });
+      nuxt.hook(
+        "devtools:customTabs",
+        (tabs) => {
+          tabs.push({
+            name: "mapo-forms",
+            title: "Mapo Forms",
+            icon: "i-lucide-layout-list",
+            view: { type: "iframe", src: "/_mapo/devtools/forms" }
+          });
+        }
+      );
+    }
+    const shellComponents = [
+      "MapoForm",
+      "MapoFormField",
+      "MapoFormGroup",
+      "MapoFormTabs",
+      "MapoUnknownField",
+      "MapoFocusPortal"
+    ];
+    for (const name of shellComponents) {
+      addComponent({
+        name,
+        filePath: resolver.resolve(`./runtime/components/${name}.vue`)
+      });
+    }
+    const mediaFieldComponents = [
+      "MapoMediaField",
+      "MapoMediaM2mField",
+      "MapoEnhancedMediaField",
+      "MapoMediaUnavailable"
+    ];
+    for (const name of mediaFieldComponents) {
+      addComponent({
+        name,
+        filePath: resolver.resolve(`./runtime/components/fields/${name}.vue`)
+      });
+    }
+    addImports([
+      {
+        name: "useMapoForm",
+        from: resolver.resolve("./runtime/composables/useMapoForm")
+      },
+      {
+        name: "useCurrentLang",
+        from: resolver.resolve("./runtime/composables/useCurrentLang")
+      },
+      {
+        name: "provideCurrentLang",
+        from: resolver.resolve("./runtime/composables/useCurrentLang")
+      },
+      {
+        name: "useFormFromSchema",
+        from: resolver.resolve("./runtime/composables/useFormFromSchema")
+      },
+      {
+        name: "useFormDraft",
+        from: resolver.resolve("./runtime/composables/useFormDraft")
+      },
+      {
+        name: "useFocusMode",
+        from: resolver.resolve("./runtime/composables/useFocusMode")
+      },
+      {
+        name: "defineFormField",
+        from: resolver.resolve("./runtime/composables/defineFormField")
+      },
+      // Progressive disclosure DSL
+      {
+        name: "when",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      },
+      {
+        name: "whenAny",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      },
+      {
+        name: "whenNot",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      },
+      {
+        name: "matchesField",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      },
+      {
+        name: "isOneOf",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      },
+      {
+        name: "isNoneOf",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      },
+      {
+        name: "isNotEmpty",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      },
+      {
+        name: "isEmpty",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      },
+      {
+        name: "greaterThan",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      },
+      {
+        name: "lessThan",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      },
+      {
+        name: "matches",
+        from: resolver.resolve(
+          "./runtime/composables/useProgressiveDisclosure"
+        )
+      }
+    ]);
+  }
+});
 
-export default _module?.default ?? _module;
+export { module$1 as default };