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

package/dist/runtime/components/fields/MapoWygEditor.vue

@@ -0,0 +1,258 @@
+<script setup>
+import { ref, watch, onBeforeUnmount, resolveComponent } from "vue";
+import { useI18n } from "vue-i18n";
+import { useEditor, EditorContent } from "@tiptap/vue-3";
+import StarterKit from "@tiptap/starter-kit";
+import Link from "@tiptap/extension-link";
+import Underline from "@tiptap/extension-underline";
+import Image from "@tiptap/extension-image";
+const props = defineProps({
+  modelValue: { type: null, required: true },
+  descriptor: { type: Object, required: true },
+  errors: { type: Array, required: false },
+  readonly: { type: Boolean, required: false },
+  disabled: { type: Boolean, required: false }
+});
+const emit = defineEmits(["update:modelValue"]);
+const { t } = useI18n();
+const extraExtensions = props.descriptor.attrs?.extensions ?? [];
+const ALLOWED_LINK_PROTOCOLS = ["http", "https", "mailto", "tel"];
+function isSafeUrl(url) {
+  try {
+    if (!/^[a-z][a-z0-9+.-]*:/i.test(url)) return true;
+    const proto = new URL(url, "https://placeholder.local").protocol.replace(":", "").toLowerCase();
+    return ALLOWED_LINK_PROTOCOLS.includes(proto);
+  } catch {
+    return false;
+  }
+}
+function sanitizeHtml(html) {
+  if (typeof window === "undefined" || !html) return html;
+  const tpl = document.createElement("template");
+  tpl.innerHTML = html;
+  const walker = document.createTreeWalker(
+    tpl.content,
+    NodeFilter.SHOW_ELEMENT
+  );
+  const toRemove = [];
+  let node = walker.nextNode();
+  while (node) {
+    if (node.tagName === "SCRIPT" || node.tagName === "STYLE") {
+      toRemove.push(node);
+    } else {
+      for (const attr of Array.from(node.attributes)) {
+        const name = attr.name.toLowerCase();
+        if (name.startsWith("on")) node.removeAttribute(attr.name);
+        if ((name === "href" || name === "src" || name === "xlink:href") && !isSafeUrl(attr.value)) {
+          node.removeAttribute(attr.name);
+        }
+      }
+    }
+    node = walker.nextNode();
+  }
+  toRemove.forEach((el) => el.remove());
+  return tpl.innerHTML;
+}
+const editor = useEditor({
+  content: sanitizeHtml(props.modelValue ?? ""),
+  editable: !props.readonly && !props.disabled,
+  extensions: [
+    StarterKit,
+    Link.configure({
+      openOnClick: false,
+      protocols: ALLOWED_LINK_PROTOCOLS,
+      validate: (href) => isSafeUrl(href)
+    }),
+    Underline,
+    Image.configure({ inline: false, allowBase64: false }),
+    ...extraExtensions
+  ],
+  onUpdate: ({ editor: e }) => {
+    emit("update:modelValue", e.getHTML());
+  }
+});
+watch(
+  () => [props.readonly, props.disabled],
+  ([ro, dis]) => editor.value?.setEditable(!ro && !dis)
+);
+watch(
+  () => props.modelValue,
+  (val) => {
+    if (editor.value && val !== editor.value.getHTML()) {
+      editor.value.commands.setContent(
+        sanitizeHtml(val ?? ""),
+        false
+      );
+    }
+  }
+);
+onBeforeUnmount(() => editor.value?.destroy());
+const imagePickerOpen = ref(false);
+const MediaManagerDialog = resolveComponent("MapoMediaManagerDialog");
+const hasMediaManager = typeof MediaManagerDialog !== "string";
+function onImageConfirm(selection) {
+  const media = Array.isArray(selection) ? selection[0] : selection;
+  if (!media || !editor.value) return;
+  editor.value.chain().focus().setImage({ src: media.file, alt: media.alt_text ?? "" }).run();
+}
+</script>
+
+<template>
+  <!-- An input surface of its own, like the Nuxt UI inputs next to it
+       (`bg-default`, `accented` border): without it the text area takes the
+       page background and disappears on a tinted page. -->
+  <div
+    class="mapo-wyg-editor rounded-md border bg-default"
+    :class="[
+  errors?.length ? 'border-red-300' : 'border-accented',
+  readonly || disabled ? 'opacity-60' : ''
+]"
+  >
+    <!-- Toolbar -->
+    <div
+      v-if="editor"
+      class="flex flex-wrap gap-1 border-b border-gray-200 bg-gray-50 px-2 py-1.5"
+    >
+      <UButton
+        size="xs"
+        variant="ghost"
+        color="neutral"
+        :disabled="readonly || disabled"
+        :class="{ 'bg-gray-200': editor.isActive('bold') }"
+        @click="editor.chain().focus().toggleBold().run()"
+      >
+        <strong>B</strong>
+      </UButton>
+      <UButton
+        size="xs"
+        variant="ghost"
+        color="neutral"
+        :disabled="readonly || disabled"
+        :class="{ 'bg-gray-200': editor.isActive('italic') }"
+        @click="editor.chain().focus().toggleItalic().run()"
+      >
+        <em>I</em>
+      </UButton>
+      <UButton
+        size="xs"
+        variant="ghost"
+        color="neutral"
+        :disabled="readonly || disabled"
+        :class="{ 'bg-gray-200': editor.isActive('underline') }"
+        @click="editor.chain().focus().toggleUnderline().run()"
+      >
+        <span class="underline">U</span>
+      </UButton>
+
+      <USeparator orientation="vertical" class="mx-1 h-5" />
+
+      <UButton
+        size="xs"
+        variant="ghost"
+        color="neutral"
+        :disabled="readonly || disabled"
+        :class="{ 'bg-gray-200': editor.isActive('heading', { level: 2 }) }"
+        @click="editor.chain().focus().toggleHeading({ level: 2 }).run()"
+      >
+        H2
+      </UButton>
+      <UButton
+        size="xs"
+        variant="ghost"
+        color="neutral"
+        :disabled="readonly || disabled"
+        :class="{ 'bg-gray-200': editor.isActive('heading', { level: 3 }) }"
+        @click="editor.chain().focus().toggleHeading({ level: 3 }).run()"
+      >
+        H3
+      </UButton>
+
+      <USeparator orientation="vertical" class="mx-1 h-5" />
+
+      <UButton
+        size="xs"
+        variant="ghost"
+        color="neutral"
+        :disabled="readonly || disabled"
+        :class="{ 'bg-gray-200': editor.isActive('bulletList') }"
+        icon="i-lucide-list"
+        @click="editor.chain().focus().toggleBulletList().run()"
+      />
+      <UButton
+        size="xs"
+        variant="ghost"
+        color="neutral"
+        :disabled="readonly || disabled"
+        :class="{ 'bg-gray-200': editor.isActive('orderedList') }"
+        icon="i-lucide-list-ordered"
+        @click="editor.chain().focus().toggleOrderedList().run()"
+      />
+
+      <USeparator orientation="vertical" class="mx-1 h-5" />
+
+      <UButton
+        size="xs"
+        variant="ghost"
+        color="neutral"
+        :disabled="readonly || disabled"
+        icon="i-lucide-undo"
+        @click="editor.chain().focus().undo().run()"
+      />
+      <UButton
+        size="xs"
+        variant="ghost"
+        color="neutral"
+        :disabled="readonly || disabled"
+        icon="i-lucide-redo"
+        @click="editor.chain().focus().redo().run()"
+      />
+
+      <USeparator orientation="vertical" class="mx-1 h-5" />
+
+      <!-- Insert Image via Media Manager (available when @mapomodule/uikit is installed) -->
+      <UTooltip
+        :text="
+  hasMediaManager ? t('mapo.wygEditor.insertImage') : t('mapo.wygEditor.requiresUikit')
+"
+        :delay-open="300"
+      >
+        <UButton
+          size="xs"
+          variant="ghost"
+          color="neutral"
+          icon="i-lucide-image"
+          :disabled="readonly || disabled || !hasMediaManager"
+          @click="imagePickerOpen = true"
+        />
+      </UTooltip>
+    </div>
+
+    <!-- Editor content -->
+    <EditorContent
+      :editor="editor"
+      class="prose prose-sm max-w-none px-3 py-2 focus-within:outline-none"
+    />
+
+    <p
+      v-for="err in errors"
+      :key="err"
+      class="px-3 pb-2 text-sm text-red-500"
+      role="alert"
+    >
+      {{ err }}
+    </p>
+
+    <!-- Image picker dialog — only rendered when MapoMediaManagerDialog is
+         globally available. Inside the root on purpose: a second root would
+         drop what MapoFormField passes down (`flex-1`, `id`, `style`), and the
+         editor would shrink to its toolbar. As a modal it renders in <body>. -->
+    <component
+      :is="MediaManagerDialog"
+      v-if="hasMediaManager"
+      v-model="imagePickerOpen"
+      selection-mode="single"
+      mime="image/*"
+      @confirm="onImageConfirm"
+    />
+  </div>
+</template>

package/dist/runtime/components/fields/MapoWygEditor.vue.d.ts

@@ -0,0 +1,16 @@
+import type { EditorDescriptor } from "../../types/index.js";
+type __VLS_Props = {
+    modelValue: unknown;
+    descriptor: EditorDescriptor;
+    errors?: string[];
+    readonly?: boolean;
+    disabled?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=MapoWygEditor.vue.d.ts.map

package/dist/runtime/components/fields/MapoWygEditor.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapoWygEditor.vue.d.ts","sourceRoot":"","sources":["../../../../src/runtime/components/fields/MapoWygEditor.vue"],"names":[],"mappings":"AA2TA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,KAAK,WAAW,GAAG;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AA6pBF,QAAA,MAAM,YAAY;;;;kFAGhB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/runtime/components/fields/nui/NuiCheckbox.vue

@@ -0,0 +1,9 @@
+<script setup>
+import { useNuiFieldAttrs } from "./useNuiFieldAttrs";
+defineOptions({ inheritAttrs: false });
+const attrs = useNuiFieldAttrs();
+</script>
+
+<template>
+  <UCheckbox v-bind="attrs" />
+</template>

package/dist/runtime/components/fields/nui/NuiCheckbox.vue.d.ts

@@ -0,0 +1,4 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=NuiCheckbox.vue.d.ts.map

package/dist/runtime/components/fields/nui/NuiCheckbox.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NuiCheckbox.vue.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/components/fields/nui/NuiCheckbox.vue"],"names":[],"mappings":"AA6CA,QAAA,MAAM,YAAY,+QAChB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/runtime/components/fields/nui/NuiInput.vue

@@ -0,0 +1,9 @@
+<script setup>
+import { useNuiFieldAttrs } from "./useNuiFieldAttrs";
+defineOptions({ inheritAttrs: false });
+const attrs = useNuiFieldAttrs();
+</script>
+
+<template>
+  <UInput v-bind="attrs" />
+</template>

package/dist/runtime/components/fields/nui/NuiInput.vue.d.ts

@@ -0,0 +1,4 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=NuiInput.vue.d.ts.map

package/dist/runtime/components/fields/nui/NuiInput.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NuiInput.vue.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/components/fields/nui/NuiInput.vue"],"names":[],"mappings":"AA6CA,QAAA,MAAM,YAAY,+QAChB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/runtime/components/fields/nui/NuiSelectMenu.vue

@@ -0,0 +1,18 @@
+<script setup>
+import { computed } from "vue";
+import { useNuiFieldAttrs } from "./useNuiFieldAttrs";
+defineOptions({ inheritAttrs: false });
+const rawAttrs = useNuiFieldAttrs();
+const attrs = computed(() => {
+  const { options, items, ...rest } = rawAttrs.value;
+  const list = items ?? options;
+  const normalised = list?.map(
+    (it) => typeof it === "object" && it !== null ? { ...it, text: it.text ?? it.label ?? String(it.value) } : it
+  );
+  return { ...rest, items: normalised };
+});
+</script>
+
+<template>
+  <USelectMenu v-bind="attrs" />
+</template>

package/dist/runtime/components/fields/nui/NuiSelectMenu.vue.d.ts

@@ -0,0 +1,4 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=NuiSelectMenu.vue.d.ts.map

package/dist/runtime/components/fields/nui/NuiSelectMenu.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NuiSelectMenu.vue.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/components/fields/nui/NuiSelectMenu.vue"],"names":[],"mappings":"AAmFA,QAAA,MAAM,YAAY,+QAChB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/runtime/components/fields/nui/NuiSlider.vue

@@ -0,0 +1,9 @@
+<script setup>
+import { useNuiFieldAttrs } from "./useNuiFieldAttrs";
+defineOptions({ inheritAttrs: false });
+const attrs = useNuiFieldAttrs();
+</script>
+
+<template>
+  <USlider v-bind="attrs" />
+</template>

package/dist/runtime/components/fields/nui/NuiSlider.vue.d.ts

@@ -0,0 +1,4 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=NuiSlider.vue.d.ts.map

package/dist/runtime/components/fields/nui/NuiSlider.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NuiSlider.vue.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/components/fields/nui/NuiSlider.vue"],"names":[],"mappings":"AA6CA,QAAA,MAAM,YAAY,+QAChB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/runtime/components/fields/nui/NuiSwitch.vue

@@ -0,0 +1,9 @@
+<script setup>
+import { useNuiFieldAttrs } from "./useNuiFieldAttrs";
+defineOptions({ inheritAttrs: false });
+const attrs = useNuiFieldAttrs();
+</script>
+
+<template>
+  <USwitch v-bind="attrs" />
+</template>

package/dist/runtime/components/fields/nui/NuiSwitch.vue.d.ts

@@ -0,0 +1,4 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=NuiSwitch.vue.d.ts.map

package/dist/runtime/components/fields/nui/NuiSwitch.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NuiSwitch.vue.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/components/fields/nui/NuiSwitch.vue"],"names":[],"mappings":"AA6CA,QAAA,MAAM,YAAY,+QAChB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/runtime/components/fields/nui/NuiTextarea.vue

@@ -0,0 +1,9 @@
+<script setup>
+import { useNuiFieldAttrs } from "./useNuiFieldAttrs";
+defineOptions({ inheritAttrs: false });
+const attrs = useNuiFieldAttrs();
+</script>
+
+<template>
+  <UTextarea v-bind="attrs" />
+</template>

package/dist/runtime/components/fields/nui/NuiTextarea.vue.d.ts

@@ -0,0 +1,4 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+//# sourceMappingURL=NuiTextarea.vue.d.ts.map

package/dist/runtime/components/fields/nui/NuiTextarea.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NuiTextarea.vue.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/components/fields/nui/NuiTextarea.vue"],"names":[],"mappings":"AA6CA,QAAA,MAAM,YAAY,+QAChB,CAAC;wBACkB,OAAO,YAAY;AAAxC,wBAAyC"}

package/dist/runtime/components/fields/nui/useNuiFieldAttrs.d.ts

@@ -0,0 +1,13 @@
+import { type ComputedRef } from "vue";
+/**
+ * Shared logic for NUI wrappers: strips internal props (`descriptor`, `errors`)
+ * from the binding passed to the underlying NUI component and derives visual
+ * error flags (`color: 'error'` + `aria-invalid`).
+ *
+ * Note: NUI v3 form components accept `color="error"` for the red border.
+ * We apply it here as a fallback when the caller has not set it already,
+ * so consumers that do not go through `MapoFormField` still get the correct
+ * color when `errors` is non-empty.
+ */
+export declare function useNuiFieldAttrs(): ComputedRef<Record<string, unknown>>;
+//# sourceMappingURL=useNuiFieldAttrs.d.ts.map

package/dist/runtime/components/fields/nui/useNuiFieldAttrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNuiFieldAttrs.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/components/fields/nui/useNuiFieldAttrs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAE3D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiBvE"}

package/dist/runtime/components/fields/nui/useNuiFieldAttrs.js

@@ -0,0 +1,19 @@
+import { computed, useAttrs } from "vue";
+export function useNuiFieldAttrs() {
+  const rawAttrs = useAttrs();
+  return computed(() => {
+    const {
+      descriptor: _d,
+      errors,
+      color,
+      ...rest
+    } = rawAttrs;
+    const errs = errors ?? [];
+    const hasError = errs.length > 0;
+    return {
+      ...rest,
+      color: color ?? (hasError ? "error" : void 0),
+      "aria-invalid": hasError ? "true" : void 0
+    };
+  });
+}

package/dist/runtime/composables/defineFormField.d.ts

@@ -0,0 +1,25 @@
+import type { FieldComponentEntry, FieldAccessor } from "../types/index.js";
+/** Options for registering or overriding a custom field type. */
+export interface DefineFormFieldOptions {
+    /** Default attrs applied to all descriptors of this `type`. */
+    attrs?: Record<string, unknown>;
+    /** Default get/set accessor for this `type`. */
+    accessor?: FieldAccessor;
+    /** Replaces an existing registration without warning. */
+    override?: boolean;
+}
+/**
+ * Typed API for registering a custom field component.
+ * Must be called from a Nuxt plugin (the load order guarantees that `$mapoFormRegistry`
+ * is already present — the `@mapomodule/form` plugin is loaded first).
+ *
+ * @example
+ *   // app/plugins/my-fields.ts
+ *   export default defineNuxtPlugin(() => {
+ *     defineFormField('rich-text', () => import('~/components/RichText.vue'), {
+ *       attrs: { rows: 6 },
+ *     })
+ *   })
+ */
+export declare function defineFormField(type: string, entry: FieldComponentEntry, opts?: DefineFormFieldOptions): void;
+//# sourceMappingURL=defineFormField.d.ts.map

package/dist/runtime/composables/defineFormField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineFormField.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/defineFormField.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAE3B,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,mBAAmB,EAC1B,IAAI,GAAE,sBAA2B,GAChC,IAAI,CA2BN"}

package/dist/runtime/composables/defineFormField.js

@@ -0,0 +1,27 @@
+import { useNuxtApp } from "#app";
+export function defineFormField(type, entry, opts = {}) {
+  const nuxt = useNuxtApp();
+  const registry = nuxt.$mapoFormRegistry;
+  if (!registry) {
+    if (import.meta.dev) {
+      console.warn(
+        `[Mapo] defineFormField('${type}') called before $mapoFormRegistry is available. Make sure the plugin is loaded after @mapomodule/form.`
+      );
+    }
+    return;
+  }
+  if (registry.mapping[type] && !opts.override) {
+    if (import.meta.dev) {
+      console.warn(
+        `[Mapo] defineFormField: type "${type}" already registered. Pass { override: true } to replace it intentionally.`
+      );
+    }
+  }
+  registry.mapping[type] = entry;
+  if (opts.attrs) {
+    registry.attrs[type] = { ...registry.attrs[type] ?? {}, ...opts.attrs };
+  }
+  if (opts.accessor) {
+    registry.accessor[type] = opts.accessor;
+  }
+}

package/dist/runtime/composables/useCurrentLang.d.ts

@@ -0,0 +1,6 @@
+import { type Ref } from "vue";
+/** Provides the current form language to descendant components. */
+export declare function provideCurrentLang(lang: Ref<string>): void;
+/** Returns the current form language, falling back to the provided ref when needed. */
+export declare function useCurrentLang(fallback?: Ref<string>): Ref<string>;
+//# sourceMappingURL=useCurrentLang.d.ts.map

package/dist/runtime/composables/useCurrentLang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrentLang.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useCurrentLang.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAIzE,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,QAEnD;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAKlE"}

package/dist/runtime/composables/useCurrentLang.js

@@ -0,0 +1,9 @@
+import { getCurrentInstance, inject, provide, ref } from "vue";
+const LANG_KEY = Symbol("mapoCurrentLang");
+export function provideCurrentLang(lang) {
+  provide(LANG_KEY, lang);
+}
+export function useCurrentLang(fallback) {
+  if (!getCurrentInstance()) return fallback ?? ref("");
+  return inject(LANG_KEY, fallback ?? ref(""));
+}

package/dist/runtime/composables/useFocusMode.d.ts

@@ -0,0 +1,40 @@
+import { type Ref, type DeepReadonly, type ShallowRef } from "vue";
+import type { AnyFieldDescriptor, FieldRegistry } from "../types/index.js";
+/** Describes the currently focused repeater item in focus mode. */
+export interface FocusTarget {
+    /** Descriptor of the repeater field that contains the focused item. */
+    descriptor: AnyFieldDescriptor;
+    /** Fields for the focused item, resolved from the template when needed. */
+    fields: AnyFieldDescriptor[];
+    /**
+     * Initial snapshot of the item model at the time the portal was opened.
+     * Stored as a plain object (not a Ref) to avoid Vue's auto-unwrap behaviour
+     * when placed inside Nuxt's useState reactive container.
+     */
+    model: Record<string, unknown>;
+    /** Errors for this item (already filtered). */
+    errors: Ref<Record<string, string[]>>;
+    /** Callback invoked when the item model is updated. */
+    onUpdate: (val: Record<string, unknown>) => void;
+    /** Field component registry passed to the sub-form. */
+    registry: FieldRegistry;
+    /** Available language codes. */
+    languages: string[];
+    /** Currently active language code. */
+    currentLang: string;
+    /** Visual breadcrumb trail: ['Article', 'Blocks', 'Block 3'] */
+    breadcrumb: string[];
+}
+/** Shared focus-mode API used by nested repeater editors. */
+export interface FocusModeReturn {
+    focusTarget: DeepReadonly<ShallowRef<FocusTarget | null>>;
+    isActive: Ref<boolean>;
+    enter: (target: FocusTarget) => void;
+    exit: () => void;
+}
+/**
+ * Exposes a shared focus-mode state for nested repeater items.
+ * In Nuxt it uses `useState()` for SSR-safe request isolation.
+ */
+export declare function useFocusMode(): FocusModeReturn;
+//# sourceMappingURL=useFocusMode.d.ts.map

package/dist/runtime/composables/useFocusMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusMode.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useFocusMode.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,GAAG,EACR,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,KAAK,CAAC;AACb,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE3E,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,UAAU,EAAE,kBAAkB,CAAC;IAC/B,2EAA2E;IAC3E,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,+CAA+C;IAC/C,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACtC,uDAAuD;IACvD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjD,uDAAuD;IACvD,QAAQ,EAAE,aAAa,CAAC;IACxB,gCAAgC;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1D,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACrC,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAqBD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,eAAe,CAkB9C"}

package/dist/runtime/composables/useFocusMode.js

@@ -0,0 +1,31 @@
+import {
+  computed,
+  readonly,
+  shallowRef
+} from "vue";
+const _clientFallback = shallowRef(null);
+function getStateRef() {
+  const nuxtUseState = globalThis.useState;
+  if (typeof nuxtUseState === "function") {
+    return nuxtUseState(
+      "mapo:form:focusTarget",
+      () => null
+    );
+  }
+  return _clientFallback;
+}
+export function useFocusMode() {
+  const state = getStateRef();
+  function enter(target) {
+    state.value = target;
+  }
+  function exit() {
+    state.value = null;
+  }
+  return {
+    focusTarget: readonly(state),
+    isActive: computed(() => state.value !== null),
+    enter,
+    exit
+  };
+}