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

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

@@ -0,0 +1,227 @@
+<script setup>
+import { watch, onBeforeUnmount } from "vue";
+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";
+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 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,
+    ...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());
+</script>
+
+<template>
+  <div
+    class="mapo-wyg-editor rounded border"
+    :class="[
+  errors?.length ? 'border-red-300' : 'border-gray-200',
+  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 — enabled in Phase 6 when Media Manager is available -->
+      <UTooltip
+        text="Insert image (requires Media Manager — Phase 6)"
+        :delay-open="300"
+      >
+        <UButton
+          size="xs"
+          variant="ghost"
+          color="neutral"
+          icon="i-lucide-image"
+          disabled
+        />
+      </UTooltip>
+    </div>
+
+    <!-- Contenuto editor -->
+    <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>
+  </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":"AAyQA,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;AAilBF,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
+  };
+}

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

@@ -0,0 +1,60 @@
+import { type Ref } from "vue";
+interface DraftEntry<T> {
+    model: T;
+    savedAt: number;
+}
+/** Options for draft persistence and restoration. */
+export interface UseFormDraftOptions<T> {
+    model: Ref<T>;
+    isDirty: Ref<boolean>;
+    /**
+     * Unique draft key. It is prefixed with `mapo:draft:{userId}:` when `userId` is provided,
+     * otherwise `mapo:draft:`. Example: `article:42` → `mapo:draft:1:article:42`.
+     */
+    key: string;
+    /**
+     * User identifier used to scope the draft so it is never shared across accounts.
+     * Without this, a draft survives logout and may be seen by the next user on the same browser.
+     * Pass `useAuthStore().user?.id` (or equivalent) from the calling composable.
+     */
+    userId?: string | number;
+    /** Milliseconds between debounced writes to localStorage. Default: `2000`. */
+    debounce?: number;
+    /** TTL in milliseconds before the draft is discarded. Default: `86_400_000` (24h). */
+    ttl?: number;
+    /**
+     * Called on mount when a valid, non-expired draft exists.
+     * Show a notification here and decide whether to restore it.
+     */
+    onRestore?: (draft: T, savedAt: Date) => void;
+    /** Called after each successful write to localStorage. */
+    onSave?: (savedAt: Date) => void;
+}
+/**
+ * Persists form drafts to `localStorage` and restores them on mount when available.
+ *
+ * The draft is written debounced while `isDirty` is `true`. On mount, if a valid
+ * non-expired draft is found, `onRestore` is called so the caller can decide
+ * whether to apply it (e.g. show a snack notification first).
+ *
+ * @param options - Configuration for key, TTL, debounce interval and lifecycle callbacks.
+ * @returns An object with `{ clearDraft, getDraft, hasDraft }` for manual control.
+ *
+ * @example
+ * useFormDraft({
+ *   model,
+ *   isDirty,
+ *   key: `article:${route.params.id}`,
+ *   onRestore: (draft, savedAt) => {
+ *     snack.show(`Draft from ${savedAt.toLocaleString()} restored`)
+ *     Object.assign(model.value, draft)
+ *   },
+ * })
+ */
+export declare function useFormDraft<T>(options: UseFormDraftOptions<T>): {
+    clearDraft: () => void;
+    getDraft: () => DraftEntry<T> | null;
+    hasDraft: () => boolean;
+};
+export {};
+//# sourceMappingURL=useFormDraft.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormDraft.d.ts","sourceRoot":"","sources":["../../../src/runtime/composables/useFormDraft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAG9D,UAAU,UAAU,CAAC,CAAC;IACpB,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACd,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,KAAK,IAAI,CAAC;IAC9C,0DAA0D;IAC1D,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;;oBAmCxC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI;oBAqBpB,OAAO;EAK7B"}