@iris-ui-kit/vue 0.2.29 → 0.2.30

package/dist/form.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/form/context.ts","../src/form/Form.ts","../src/useStore.ts","../src/form/useForm.ts","../src/form/useField.ts","../src/form/useFieldArray.ts"],"names":["inject","defineComponent","provide","ref","h","shallowRef","onScopeDispose","createFormStore","computed","formatPath","parsePath","getByPath","touched"],"mappings":"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","file":"form.cjs","sourcesContent":["import { inject, type InjectionKey } from 'vue'\nimport type { FormStore, FormValues } from '@iris-ui-kit/core'\n\n/**\n * Provides the active form's {@link FormStore} to descendant fields so\n * `useField` can bind without prop drilling. The generic is erased at the\n * injection boundary; `useField<T>` re-applies the value type at the call site.\n */\nexport const FormInjectionKey: InjectionKey<FormStore<FormValues>> = Symbol('IrisForm')\n\nexport function useFormContext(): FormStore<FormValues> {\n  const form = inject(FormInjectionKey, null)\n  if (!form) {\n    throw new Error('useField / useFormContext must be used within an <IrisForm>')\n  }\n  return form\n}\n","import { defineComponent, h, provide, ref, type PropType } from 'vue'\nimport type { FormStore, FormValues } from '@iris-ui-kit/core'\nimport { FormInjectionKey } from './context'\n\n/** Focus (and best-effort scroll to) the first errored named control in DOM order. */\nfunction focusFirstError(\n  formEl: HTMLElement | null,\n  errors: Record<string, string | undefined>,\n): void {\n  if (!formEl) return\n  const keys = Object.keys(errors)\n  if (keys.length === 0) return\n  const controls = formEl.querySelectorAll<HTMLElement>(\n    'input[name], select[name], textarea[name], [data-iris-field]',\n  )\n  for (const el of Array.from(controls)) {\n    const name = el.getAttribute('name') ?? el.getAttribute('data-iris-field')\n    if (name && keys.includes(name)) {\n      el.focus()\n      try {\n        el.scrollIntoView({ block: 'center' })\n      } catch {\n        /* scrollIntoView is unavailable in jsdom — focus is the contract */\n      }\n      return\n    }\n  }\n}\n\n/**\n * Provides the form store to descendant `useField` calls and wires the native\n * `<form>` submit to `handleSubmit` (with `preventDefault`). Composition:\n *\n * ```html\n * <IrisForm :form=\"f.form\">\n *   <IrisFormField label=\"Email\"><IrisInput v-bind=\"email.fieldProps.value\" /></IrisFormField>\n *   <IrisButton type=\"submit\" :disabled=\"f.isSubmitting.value\">Save</IrisButton>\n * </IrisForm>\n * ```\n */\nexport const IrisForm = defineComponent({\n  name: 'IrisForm',\n  props: {\n    /** The store from `useForm(...).form`. */\n    form: {\n      type: Object as PropType<FormStore<FormValues>>,\n      required: true,\n    },\n  },\n  setup(props, { slots }) {\n    provide(FormInjectionKey, props.form)\n    const formRef = ref<HTMLElement | null>(null)\n    return () =>\n      h(\n        'form',\n        {\n          ref: formRef,\n          'data-iris-form': '',\n          onSubmit: (event: Event) => {\n            event.preventDefault()\n            // On a failed submit, move focus to the first errored field (a11y).\n            void props.form\n              .handleSubmit()\n              .then(() => focusFirstError(formRef.value, props.form.getState().errors))\n          },\n        },\n        slots.default?.(),\n      )\n  },\n})\n","import { shallowRef, onScopeDispose, type ShallowRef } from 'vue'\nimport type { ReadonlyStore, Store } from '@iris-ui-kit/core'\n\n/**\n * Bridge a framework-agnostic `@iris-ui-kit/core` store into a Vue ref — updates on\n * every store emission. The mirror of React's `useSyncExternalStore`, Solid's\n * `createSignal`, and Svelte's `readable`. Seeds synchronously from\n * `store.getState()` (SSR-safe); detaches on scope dispose.\n */\nexport function useStore<T>(store: ReadonlyStore<T>): Readonly<ShallowRef<T>> {\n  const state = shallowRef(store.getState()) as ShallowRef<T>\n  onScopeDispose(store.subscribe((next) => (state.value = next)))\n  return state\n}\n\n/**\n * Subscribe to a DERIVED slice of a core store — the ref updates only when\n * `selector(state)` changes per `equals` (default `Object.is`), not on every\n * store emission. Built on {@link Store.subscribeWith}.\n */\nexport function useStoreSelector<T, U>(\n  store: Store<T>,\n  selector: (state: T) => U,\n  equals?: (a: U, b: U) => boolean,\n): Readonly<ShallowRef<U>> {\n  const slice = shallowRef(selector(store.getState())) as ShallowRef<U>\n  onScopeDispose(store.subscribeWith(selector, (v) => (slice.value = v), equals))\n  return slice\n}\n","import { computed, type ComputedRef, type Ref } from 'vue'\nimport {\n  createFormStore,\n  type FieldErrors,\n  type FieldFlags,\n  type FormConfig,\n  type FormState,\n  type FormStore,\n  type FormValues,\n} from '@iris-ui-kit/core'\nimport { useStore } from '../useStore'\n\nexport interface UseFormReturn<V extends FormValues> {\n  /** The form store — pass to `<IrisForm :form=\"...\">`. */\n  form: FormStore<V>\n  /** The full reactive state snapshot. */\n  state: Ref<FormState<V>>\n  values: ComputedRef<V>\n  errors: ComputedRef<FieldErrors<V>>\n  touched: ComputedRef<FieldFlags<V>>\n  dirty: ComputedRef<FieldFlags<V>>\n  isSubmitting: ComputedRef<boolean>\n  isValidating: ComputedRef<boolean>\n  submitCount: ComputedRef<number>\n  isValid: ComputedRef<boolean>\n  setFieldValue: FormStore<V>['setFieldValue']\n  setValues: FormStore<V>['setValues']\n  setFieldTouched: FormStore<V>['setFieldTouched']\n  setFieldError: FormStore<V>['setFieldError']\n  setErrors: FormStore<V>['setErrors']\n  validateField: FormStore<V>['validateField']\n  validateForm: FormStore<V>['validateForm']\n  handleSubmit: FormStore<V>['handleSubmit']\n  reset: FormStore<V>['reset']\n}\n\n/**\n * Vue binding for the framework-agnostic form engine. Creates the store in\n * `setup()` (runs once) and bridges it into Vue reactivity via `useStore` (a\n * shallow snapshot ref updated on each store change, detached on scope\n * dispose). Because `setup` runs once,\n * `onSubmit` / `validate` closures stay live against reactive state — no\n * stale-callback handling is needed (unlike the React adapter).\n */\nexport function useForm<V extends FormValues>(config: FormConfig<V>): UseFormReturn<V> {\n  const form = createFormStore(config)\n\n  // Whole-state bridge via the shared `useStore` (shallow, detached on scope\n  // dispose — identical to the old `onBeforeUnmount` for setup-scope consumers,\n  // and correct for nested scopes too). The published `state: Ref<FormState<V>>`\n  // type is unchanged (R5); the runtime is a shallow snapshot — the store is the\n  // only write path (it always was), so this localized cast is type-only. The\n  // per-field narrowing payoff comes from `useField` / `useFieldArray`; the\n  // form-level computeds below are whole-form aggregates by design.\n  const state = useStore(form.store) as unknown as Ref<FormState<V>>\n\n  return {\n    form,\n    state,\n    values: computed(() => state.value.values),\n    errors: computed(() => state.value.errors),\n    touched: computed(() => state.value.touched),\n    dirty: computed(() => state.value.dirty),\n    isSubmitting: computed(() => state.value.isSubmitting),\n    isValidating: computed(() => state.value.isValidating),\n    submitCount: computed(() => state.value.submitCount),\n    isValid: computed(() => Object.keys(state.value.errors).length === 0),\n    setFieldValue: form.setFieldValue,\n    setValues: form.setValues,\n    setFieldTouched: form.setFieldTouched,\n    setFieldError: form.setFieldError,\n    setErrors: form.setErrors,\n    validateField: form.validateField,\n    validateForm: form.validateForm,\n    handleSubmit: form.handleSubmit,\n    reset: form.reset,\n  }\n}\n","import { computed, type ComputedRef } from 'vue'\nimport { formatPath, getByPath, parsePath } from '@iris-ui-kit/core'\nimport { useFormContext } from './context'\nimport { useStoreSelector } from '../useStore'\n\nexport interface FieldBindProps {\n  modelValue: unknown\n  'onUpdate:modelValue': (value: unknown) => void\n  invalid: boolean\n  onBlur: () => void\n}\n\nexport interface UseFieldReturn<T> {\n  name: string\n  value: ComputedRef<T>\n  error: ComputedRef<string | undefined>\n  touched: ComputedRef<boolean>\n  dirty: ComputedRef<boolean>\n  setValue: (value: T) => void\n  setTouched: (touched?: boolean) => void\n  /**\n   * Bundle for `v-bind` onto a v-model'd Iris control (`IrisInput`,\n   * `IrisSelect`, …): wires `modelValue` / `update:modelValue` / `invalid` /\n   * `blur`. Use `value` + `setValue` directly for bespoke bindings.\n   */\n  fieldProps: ComputedRef<FieldBindProps>\n}\n\n/**\n * Binds a single field to the surrounding `<IrisForm>`. `T` is the value type\n * at the call site (the injection erases the form's generic).\n *\n * `name` may be a flat top-level key OR a nested PATH (`'address.city'`,\n * `'items[2].sku'`); a flat key is a 1-segment path and stays back-compatible\n * (v3 R19).\n */\nexport function useField<T = unknown>(name: string): UseFieldReturn<T> {\n  const form = useFormContext()\n\n  // Canonical key for per-field state lookups (a flat key maps to itself).\n  const key = formatPath(name)\n  // Hoisted once — selectors run on every store emission (core `subscribeWith`).\n  const segments = parsePath(name)\n\n  // Four narrow per-field slices, each Object.is-gated by core `subscribeWith`.\n  // Core writes use structural sharing (`setByPath`, per-key flag spread-copies),\n  // so an unrelated keystroke does NOT move these refs and this field's computeds\n  // do not invalidate (previously a whole-form deep `ref` re-ran every field's\n  // computeds on every emission). Selectors are allocation-free by construction.\n  const valueSlice = useStoreSelector(form.store, (s) => getByPath(s.values, segments) as T)\n  const errorSlice = useStoreSelector(form.store, (s) => s.errors[key])\n  const touchedSlice = useStoreSelector(form.store, (s) => Boolean(s.touched[key]))\n  const dirtySlice = useStoreSelector(form.store, (s) => Boolean(s.dirty[key]))\n\n  // computed wrappers keep the published ComputedRef<T> member types exactly as\n  // declared (a bare shallow ref is not assignable to ComputedRef in Vue 3.4+),\n  // and each computed invalidates only when its own slice actually moves.\n  const value = computed(() => valueSlice.value)\n  const error = computed(() => errorSlice.value)\n  const touched = computed(() => touchedSlice.value)\n  const dirty = computed(() => dirtySlice.value)\n\n  return {\n    name,\n    value,\n    error,\n    touched,\n    dirty,\n    setValue: (next) => form.setFieldValue(name, next as never),\n    setTouched: (touched = true) => form.setFieldTouched(name, touched),\n    fieldProps: computed(() => ({\n      modelValue: value.value,\n      'onUpdate:modelValue': (next: unknown) => form.setFieldValue(name, next as never),\n      invalid: Boolean(error.value),\n      onBlur: () => form.setFieldTouched(name, true),\n    })),\n  }\n}\n","import { computed, type ComputedRef } from 'vue'\nimport { useFormContext } from './context'\nimport { useStoreSelector } from '../useStore'\n\nexport interface UseFieldArrayReturn<T> {\n  name: string\n  /** Current array value (reactive). */\n  fields: ComputedRef<T[]>\n  /** Append an item. */\n  push: (item: T) => void\n  /** Remove the item at `index`. */\n  remove: (index: number) => void\n  /** Insert `item` at `index` (shifting the rest right). */\n  insert: (index: number, item: T) => void\n  /** Move the item from `from` to `to`. */\n  move: (from: number, to: number) => void\n  /** Replace the whole array. */\n  replace: (items: T[]) => void\n}\n\n/**\n * Manage a dynamic array field (repeatable rows) inside an `<IrisForm>`. Mutators\n * delegate to the core {@link FormStore} array helpers (`arrayPush`/`arrayInsert`/\n * `arrayRemove`/`arrayMove`), which RE-KEY each element's error/touched/dirty/\n * validating state across the mutation — so a row's per-element validation state\n * FOLLOWS the row when rows are removed or reordered (removing `items[0]` shifts\n * `items[2]`'s error down to `items[1]`). `replace` swaps the whole array.\n */\nexport function useFieldArray<T = unknown>(name: string): UseFieldArrayReturn<T> {\n  const form = useFormContext()\n\n  // One narrow slice for the whole array, Object.is-gated by core `subscribeWith`.\n  // CRITICAL: the selector must not allocate — `(s) => s.values[name] ?? []` would\n  // mint a fresh [] per emission and defeat the Object.is gate — so the `[]`\n  // fallback lives in the computed wrapper (re-evaluated only when the raw slice\n  // moves). Array mutations produce a fresh array (correct re-render); untouched\n  // rows are unaffected.\n  const raw = useStoreSelector(form.store, (s) => s.values[name])\n  const fields = computed(() => (Array.isArray(raw.value) ? raw.value : []) as T[])\n\n  return {\n    name,\n    fields,\n    push: (item) => form.arrayPush(name as never, item as never),\n    remove: (index) => form.arrayRemove(name as never, index),\n    insert: (index, item) => form.arrayInsert(name as never, index, item as never),\n    move: (from, to) => form.arrayMove(name as never, from, to),\n    replace: (items) => form.setFieldValue(name, items as never),\n  }\n}\n"]}
+{"version":3,"sources":["../src/form/context.ts","../src/form/Form.ts","../src/useStore.ts","../src/form/useForm.ts","../src/form/useField.ts","../src/form/useFieldArray.ts"],"names":["inject","defineComponent","provide","ref","h","shallowRef","onScopeDispose","createFormStore","computed","formatPath","parsePath","getByPath","touched"],"mappings":"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","file":"form.cjs","sourcesContent":["import { inject, type InjectionKey } from 'vue'\nimport type { FormStore, FormValues } from '@iris-ui-kit/core'\n\n/**\n * Provides the active form's {@link FormStore} to descendant fields so\n * `useField` can bind without prop drilling. The generic is erased at the\n * injection boundary; `useField<T>` re-applies the value type at the call site.\n */\nexport const FormInjectionKey: InjectionKey<FormStore<FormValues>> = Symbol('IrisForm')\n\nexport function useFormContext(): FormStore<FormValues> {\n  const form = inject(FormInjectionKey, null)\n  if (!form) {\n    throw new Error('useField / useFormContext must be used within an <IrisForm>')\n  }\n  return form\n}\n","import { defineComponent, h, provide, ref, type PropType } from 'vue'\nimport type { FormStore, FormValues } from '@iris-ui-kit/core'\nimport { FormInjectionKey } from './context'\n\n/** Focus (and best-effort scroll to) the first errored named control in DOM order. */\nfunction focusFirstError(\n  formEl: HTMLElement | null,\n  errors: Record<string, string | undefined>,\n): void {\n  if (!formEl) return\n  const keys = Object.keys(errors)\n  if (keys.length === 0) return\n  const controls = formEl.querySelectorAll<HTMLElement>(\n    'input[name], select[name], textarea[name], [data-iris-field]',\n  )\n  for (const el of Array.from(controls)) {\n    const name = el.getAttribute('name') ?? el.getAttribute('data-iris-field')\n    if (name && keys.includes(name)) {\n      el.focus()\n      try {\n        el.scrollIntoView({ block: 'center' })\n      } catch {\n        /* scrollIntoView is unavailable in jsdom — focus is the contract */\n      }\n      return\n    }\n  }\n}\n\n/**\n * Provides the form store to descendant `useField` calls and wires the native\n * `<form>` submit to `handleSubmit` (with `preventDefault`). Composition:\n *\n * ```html\n * <IrisForm :form=\"f.form\">\n *   <IrisFormField label=\"Email\"><IrisInput v-bind=\"email.fieldProps.value\" /></IrisFormField>\n *   <IrisButton type=\"submit\" :disabled=\"f.isSubmitting.value\">Save</IrisButton>\n * </IrisForm>\n * ```\n */\nexport const IrisForm = defineComponent({\n  name: 'IrisForm',\n  props: {\n    /** The store from `useForm(...).form`. */\n    form: {\n      type: Object as PropType<FormStore<FormValues>>,\n      required: true,\n    },\n  },\n  setup(props, { slots }) {\n    provide(FormInjectionKey, props.form)\n    const formRef = ref<HTMLElement | null>(null)\n    return () =>\n      h(\n        'form',\n        {\n          ref: formRef,\n          'data-iris-form': '',\n          onSubmit: (event: Event) => {\n            event.preventDefault()\n            // On a failed submit, move focus to the first errored field (a11y).\n            void props.form\n              .handleSubmit()\n              .then(() => focusFirstError(formRef.value, props.form.getState().errors))\n          },\n        },\n        slots.default?.(),\n      )\n  },\n})\n","import { shallowRef, onScopeDispose, type ShallowRef } from 'vue'\nimport type { ReadonlyStore, Store } from '@iris-ui-kit/core'\n\n/**\n * Bridge a framework-agnostic `@iris-ui-kit/core` store into a Vue ref — updates on\n * every store emission. The mirror of React's `useSyncExternalStore`, Solid's\n * `createSignal`, and Svelte's `readable`. Seeds synchronously from\n * `store.getState()` (SSR-safe); detaches on scope dispose.\n */\nexport function useStore<T>(store: ReadonlyStore<T>): Readonly<ShallowRef<T>> {\n  const state = shallowRef(store.getState()) as ShallowRef<T>\n  onScopeDispose(store.subscribe((next) => (state.value = next)))\n  return state\n}\n\n/**\n * Subscribe to a DERIVED slice of a core store — the ref updates only when\n * `selector(state)` changes per `equals` (default `Object.is`), not on every\n * store emission. Built on {@link Store.subscribeWith}.\n */\nexport function useStoreSelector<T, U>(\n  store: Store<T>,\n  selector: (state: T) => U,\n  equals?: (a: U, b: U) => boolean,\n): Readonly<ShallowRef<U>> {\n  const slice = shallowRef(selector(store.getState())) as ShallowRef<U>\n  onScopeDispose(store.subscribeWith(selector, (v) => (slice.value = v), equals))\n  return slice\n}\n","import { computed, type ComputedRef, type Ref } from 'vue'\nimport {\n  createFormStore,\n  type FieldErrors,\n  type FieldFlags,\n  type FormConfig,\n  type FormState,\n  type FormStore,\n  type FormValues,\n} from '@iris-ui-kit/core'\nimport { useStore } from '../useStore'\n\nexport interface UseFormReturn<V extends FormValues> {\n  /** The form store — pass to `<IrisForm :form=\"...\">`. */\n  form: FormStore<V>\n  /** The full reactive state snapshot. */\n  state: Ref<FormState<V>>\n  values: ComputedRef<V>\n  errors: ComputedRef<FieldErrors<V>>\n  touched: ComputedRef<FieldFlags<V>>\n  dirty: ComputedRef<FieldFlags<V>>\n  isSubmitting: ComputedRef<boolean>\n  isValidating: ComputedRef<boolean>\n  submitCount: ComputedRef<number>\n  isValid: ComputedRef<boolean>\n  setFieldValue: FormStore<V>['setFieldValue']\n  setValues: FormStore<V>['setValues']\n  setFieldTouched: FormStore<V>['setFieldTouched']\n  setFieldError: FormStore<V>['setFieldError']\n  setErrors: FormStore<V>['setErrors']\n  validateField: FormStore<V>['validateField']\n  validateForm: FormStore<V>['validateForm']\n  handleSubmit: FormStore<V>['handleSubmit']\n  reset: FormStore<V>['reset']\n}\n\n/**\n * Vue binding for the framework-agnostic form engine. Creates the store in\n * `setup()` (runs once) and bridges it into Vue reactivity via `useStore` (a\n * shallow snapshot ref updated on each store change, detached on scope\n * dispose). Because `setup` runs once,\n * `onSubmit` / `validate` closures stay live against reactive state — no\n * stale-callback handling is needed (unlike the React adapter).\n */\nexport function useForm<V extends FormValues>(config: FormConfig<V>): UseFormReturn<V> {\n  const form = createFormStore(config)\n\n  // Whole-state bridge via the shared `useStore` (shallow, detached on scope\n  // dispose — identical to the old `onBeforeUnmount` for setup-scope consumers,\n  // and correct for nested scopes too). The published `state: Ref<FormState<V>>`\n  // type is unchanged (R5); the runtime is a shallow snapshot — the store is the\n  // only write path (it always was), so this localized cast is type-only. The\n  // per-field narrowing payoff comes from `useField` / `useFieldArray`; the\n  // form-level computeds below are whole-form aggregates by design.\n  const state = useStore(form.store) as unknown as Ref<FormState<V>>\n\n  return {\n    form,\n    state,\n    values: computed(() => state.value.values),\n    errors: computed(() => state.value.errors),\n    touched: computed(() => state.value.touched),\n    dirty: computed(() => state.value.dirty),\n    isSubmitting: computed(() => state.value.isSubmitting),\n    isValidating: computed(() => state.value.isValidating),\n    submitCount: computed(() => state.value.submitCount),\n    isValid: computed(() => Object.keys(state.value.errors).length === 0),\n    setFieldValue: form.setFieldValue,\n    setValues: form.setValues,\n    setFieldTouched: form.setFieldTouched,\n    setFieldError: form.setFieldError,\n    setErrors: form.setErrors,\n    validateField: form.validateField,\n    validateForm: form.validateForm,\n    handleSubmit: form.handleSubmit,\n    reset: form.reset,\n  }\n}\n","import { computed, type ComputedRef } from 'vue'\nimport { formatPath, getByPath, parsePath } from '@iris-ui-kit/core'\nimport { useFormContext } from './context'\nimport { useStoreSelector } from '../useStore'\n\nexport interface FieldBindProps {\n  modelValue: unknown\n  'onUpdate:modelValue': (value: unknown) => void\n  invalid: boolean\n  onBlur: () => void\n}\n\nexport interface UseFieldReturn<T> {\n  name: string\n  value: ComputedRef<T>\n  error: ComputedRef<string | undefined>\n  touched: ComputedRef<boolean>\n  dirty: ComputedRef<boolean>\n  setValue: (value: T) => void\n  setTouched: (touched?: boolean) => void\n  /**\n   * Bundle for `v-bind` onto a v-model'd Iris control (`IrisInput`,\n   * `IrisSelect`, …): wires `modelValue` / `update:modelValue` / `invalid` /\n   * `blur`. Use `value` + `setValue` directly for bespoke bindings.\n   */\n  fieldProps: ComputedRef<FieldBindProps>\n}\n\n/**\n * Binds a single field to the surrounding `<IrisForm>`. `T` is the value type\n * at the call site (the injection erases the form's generic).\n *\n * `name` may be a flat top-level key OR a nested PATH (`'address.city'`,\n * `'items[2].sku'`); a flat key is a 1-segment path and stays back-compatible\n * (v3 R19).\n */\nexport function useField<T = unknown>(name: string): UseFieldReturn<T> {\n  const form = useFormContext()\n\n  // Canonical key for per-field state lookups (a flat key maps to itself).\n  const key = formatPath(name)\n  // Hoisted once — selectors run on every store emission (core `subscribeWith`).\n  const segments = parsePath(name)\n\n  // Four narrow per-field slices, each Object.is-gated by core `subscribeWith`.\n  // Core writes use structural sharing (`setByPath`, per-key flag spread-copies),\n  // so an unrelated keystroke does NOT move these refs and this field's computeds\n  // do not invalidate (previously a whole-form deep `ref` re-ran every field's\n  // computeds on every emission). Selectors are allocation-free by construction.\n  const valueSlice = useStoreSelector(form.store, (s) => getByPath(s.values, segments) as T)\n  const errorSlice = useStoreSelector(form.store, (s) => s.errors[key])\n  const touchedSlice = useStoreSelector(form.store, (s) => Boolean(s.touched[key]))\n  const dirtySlice = useStoreSelector(form.store, (s) => Boolean(s.dirty[key]))\n\n  // computed wrappers keep the published ComputedRef<T> member types exactly as\n  // declared (a bare shallow ref is not assignable to ComputedRef in Vue 3.4+),\n  // and each computed invalidates only when its own slice actually moves.\n  const value = computed(() => valueSlice.value)\n  const error = computed(() => errorSlice.value)\n  const touched = computed(() => touchedSlice.value)\n  const dirty = computed(() => dirtySlice.value)\n\n  return {\n    name,\n    value,\n    error,\n    touched,\n    dirty,\n    setValue: (next) => form.setFieldValue(name, next as never),\n    setTouched: (touched = true) => form.setFieldTouched(name, touched),\n    fieldProps: computed(() => ({\n      modelValue: value.value,\n      'onUpdate:modelValue': (next: unknown) => form.setFieldValue(name, next as never),\n      invalid: Boolean(error.value),\n      onBlur: () => form.setFieldTouched(name, true),\n    })),\n  }\n}\n","import { computed, type ComputedRef } from 'vue'\nimport { useFormContext } from './context'\nimport { useStoreSelector } from '../useStore'\n\nexport interface UseFieldArrayReturn<T> {\n  name: string\n  /** Current array value (reactive). */\n  fields: ComputedRef<T[]>\n  /** Append an item. */\n  push: (item: T) => void\n  /** Remove the item at `index`. */\n  remove: (index: number) => void\n  /** Insert `item` at `index` (shifting the rest right). */\n  insert: (index: number, item: T) => void\n  /** Move the item from `from` to `to`. */\n  move: (from: number, to: number) => void\n  /** Replace the whole array. */\n  replace: (items: T[]) => void\n}\n\n/**\n * Manage a dynamic array field (repeatable rows) inside an `<IrisForm>`. Mutators\n * delegate to the core {@link FormStore} array helpers (`arrayPush`/`arrayInsert`/\n * `arrayRemove`/`arrayMove`), which RE-KEY each element's error/touched/dirty/\n * validating state across the mutation — so a row's per-element validation state\n * FOLLOWS the row when rows are removed or reordered (removing `items[0]` shifts\n * `items[2]`'s error down to `items[1]`). `replace` swaps the whole array.\n */\nexport function useFieldArray<T = unknown>(name: string): UseFieldArrayReturn<T> {\n  const form = useFormContext()\n\n  // One narrow slice for the whole array, Object.is-gated by core `subscribeWith`.\n  // CRITICAL: the selector must not allocate — `(s) => s.values[name] ?? []` would\n  // mint a fresh [] per emission and defeat the Object.is gate — so the `[]`\n  // fallback lives in the computed wrapper (re-evaluated only when the raw slice\n  // moves). Array mutations produce a fresh array (correct re-render); untouched\n  // rows are unaffected.\n  const raw = useStoreSelector(form.store, (s) => s.values[name])\n  const fields = computed(() => (Array.isArray(raw.value) ? raw.value : []) as T[])\n\n  return {\n    name,\n    fields,\n    push: (item) => form.arrayPush(name as never, item as never),\n    remove: (index) => form.arrayRemove(name as never, index),\n    insert: (index, item) => form.arrayInsert(name as never, index, item as never),\n    move: (from, to) => form.arrayMove(name as never, from, to),\n    replace: (items) => form.setFieldValue(name, items as never),\n  }\n}\n"]}

package/dist/form.js

@@ -1,4 +1,4 @@
-export { FormInjectionKey, IrisForm, useField, useFieldArray, useForm, useFormContext } from './chunk-BVKOOTXG.js';
+export { FormInjectionKey, IrisForm, useField, useFieldArray, useForm, useFormContext } from './chunk-IAG64CHL.js';
 import './chunk-75GSYEJS.js';
 //# sourceMappingURL=form.js.map
 //# sourceMappingURL=form.js.map

package/dist/i18n.cjs

@@ -7,7 +7,7 @@ var theme = require('@iris-ui-kit/theme');
 // src/i18n/I18nProvider.ts
 
 // src/i18n/context.ts
-var I18nInjectionKey = Symbol("IrisI18n");
+var I18nInjectionKey = /* @__PURE__ */ Symbol("IrisI18n");
 
 // src/i18n/I18nProvider.ts
 var IrisI18nProvider = vue.defineComponent({

package/dist/i18n.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/i18n/context.ts","../src/i18n/I18nProvider.ts","../src/i18n/useI18n.ts"],"names":["defineComponent","createI18n","provide","watch","applyDirection","localeDirection","onScopeDispose","inject","ref","onBeforeUnmount","computed"],"mappings":"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","file":"i18n.cjs","sourcesContent":["import { type InjectionKey } from 'vue'\nimport type { I18n } from '@iris-ui-kit/core'\n\n/** Injection key carrying the active {@link I18n} instance to `useI18n`. */\nexport const I18nInjectionKey: InjectionKey<I18n> = Symbol('IrisI18n')\n","import { defineComponent, onScopeDispose, provide, watch, type PropType } from 'vue'\nimport { createI18n, localeDirection, type I18n, type I18nMessages } from '@iris-ui-kit/core'\nimport { applyDirection } from '@iris-ui-kit/theme'\nimport { I18nInjectionKey } from './context'\n\n/**\n * Makes a locale + message dictionary available to descendant components via\n * `useI18n`. Pass `locale` / `messages` (an instance is created and kept in\n * sync) or a pre-built `i18n` instance you control externally. Renderless:\n * renders its default slot.\n */\nexport const IrisI18nProvider = defineComponent({\n  name: 'IrisI18nProvider',\n  props: {\n    locale: { type: String, default: undefined },\n    messages: { type: Object as PropType<I18nMessages>, default: undefined },\n    i18n: { type: Object as PropType<I18n>, default: undefined },\n    /**\n     * When set, the locale's writing direction ({@link localeDirection}) is\n     * applied to `directionTarget` (`dir` + `data-iris-dir`) and `<html lang>`\n     * is set whenever `locale` changes — so \"set locale → flip direction +\n     * announce language\" needs no manual wiring. Off by default so it never\n     * fights an explicit `<ThemeProvider dir>`. Reverts on unmount.\n     */\n    autoDirection: { type: Boolean, default: false },\n    /** Element to receive dir/lang when `autoDirection` is set. Defaults to `document.documentElement`. */\n    directionTarget: { type: Object as PropType<HTMLElement | null>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const instance = props.i18n ?? createI18n({ locale: props.locale, messages: props.messages })\n    provide(I18nInjectionKey, instance)\n\n    if (!props.i18n) {\n      watch(\n        () => props.locale,\n        (locale) => {\n          if (locale) instance.setLocale(locale)\n        },\n      )\n      watch(\n        () => props.messages,\n        (messages) => {\n          if (messages) instance.setMessages(messages)\n        },\n      )\n    }\n\n    // Auto-apply writing direction + `lang` from the active locale (opt-in).\n    let revertDirection: (() => void) | null = null\n    watch(\n      () => [props.autoDirection, props.locale, props.directionTarget] as const,\n      ([autoDirection, locale]) => {\n        revertDirection?.()\n        revertDirection = null\n        if (!autoDirection || !locale || typeof document === 'undefined') return\n        const el = props.directionTarget ?? document.documentElement\n        const applied = applyDirection(localeDirection(locale), el)\n        const prevLang = el.getAttribute('lang')\n        el.setAttribute('lang', locale)\n        revertDirection = () => {\n          applied.revert()\n          if (prevLang === null) el.removeAttribute('lang')\n          else el.setAttribute('lang', prevLang)\n        }\n      },\n      { immediate: true },\n    )\n    onScopeDispose(() => {\n      revertDirection?.()\n      revertDirection = null\n    })\n\n    return () => slots.default?.()\n  },\n})\n","import { computed, inject, onBeforeUnmount, ref, type ComputedRef, type Ref } from 'vue'\nimport { createI18n, type I18n, type I18nState } from '@iris-ui-kit/core'\nimport { I18nInjectionKey } from './context'\n\nexport interface UseI18nReturn {\n  locale: ComputedRef<string>\n  t: I18n['t']\n  formatDate: I18n['formatDate']\n  formatNumber: I18n['formatNumber']\n  formatRelativeTime: I18n['formatRelativeTime']\n  setLocale: I18n['setLocale']\n  setMessages: I18n['setMessages']\n}\n\n// Shared fallback so components can call `useI18n()` without an enclosing\n// provider — they get English defaults rather than throwing.\nlet fallbackI18n: I18n | null = null\nfunction getFallback(): I18n {\n  if (fallbackI18n === null) fallbackI18n = createI18n()\n  return fallbackI18n\n}\n\n/**\n * Reactive access to the active locale + translation/formatting helpers.\n * Works with or without an `<IrisI18nProvider>` (falls back to English\n * defaults). `t` / formatters read the live locale at call time, and `locale`\n * is a reactive ref so templates re-render on change.\n */\nexport function useI18n(): UseI18nReturn {\n  const i18n = inject(I18nInjectionKey, null) ?? getFallback()\n  const state = ref(i18n.getState()) as Ref<I18nState>\n  const unsubscribe = i18n.subscribe((next) => {\n    state.value = next\n  })\n  onBeforeUnmount(unsubscribe)\n\n  return {\n    locale: computed(() => state.value.locale),\n    t: (key, params) => {\n      void state.value.locale\n      return i18n.t(key, params)\n    },\n    formatDate: (value, options) => {\n      void state.value.locale\n      return i18n.formatDate(value, options)\n    },\n    formatNumber: (value, options) => {\n      void state.value.locale\n      return i18n.formatNumber(value, options)\n    },\n    formatRelativeTime: (value, unit, options) => {\n      void state.value.locale\n      return i18n.formatRelativeTime(value, unit, options)\n    },\n    setLocale: i18n.setLocale,\n    setMessages: i18n.setMessages,\n  }\n}\n"]}
+{"version":3,"sources":["../src/i18n/context.ts","../src/i18n/I18nProvider.ts","../src/i18n/useI18n.ts"],"names":["defineComponent","createI18n","provide","watch","applyDirection","localeDirection","onScopeDispose","inject","ref","onBeforeUnmount","computed"],"mappings":"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","file":"i18n.cjs","sourcesContent":["import { type InjectionKey } from 'vue'\nimport type { I18n } from '@iris-ui-kit/core'\n\n/** Injection key carrying the active {@link I18n} instance to `useI18n`. */\nexport const I18nInjectionKey: InjectionKey<I18n> = Symbol('IrisI18n')\n","import { defineComponent, onScopeDispose, provide, watch, type PropType } from 'vue'\nimport { createI18n, localeDirection, type I18n, type I18nMessages } from '@iris-ui-kit/core'\nimport { applyDirection } from '@iris-ui-kit/theme'\nimport { I18nInjectionKey } from './context'\n\n/**\n * Makes a locale + message dictionary available to descendant components via\n * `useI18n`. Pass `locale` / `messages` (an instance is created and kept in\n * sync) or a pre-built `i18n` instance you control externally. Renderless:\n * renders its default slot.\n */\nexport const IrisI18nProvider = defineComponent({\n  name: 'IrisI18nProvider',\n  props: {\n    locale: { type: String, default: undefined },\n    messages: { type: Object as PropType<I18nMessages>, default: undefined },\n    i18n: { type: Object as PropType<I18n>, default: undefined },\n    /**\n     * When set, the locale's writing direction ({@link localeDirection}) is\n     * applied to `directionTarget` (`dir` + `data-iris-dir`) and `<html lang>`\n     * is set whenever `locale` changes — so \"set locale → flip direction +\n     * announce language\" needs no manual wiring. Off by default so it never\n     * fights an explicit `<ThemeProvider dir>`. Reverts on unmount.\n     */\n    autoDirection: { type: Boolean, default: false },\n    /** Element to receive dir/lang when `autoDirection` is set. Defaults to `document.documentElement`. */\n    directionTarget: { type: Object as PropType<HTMLElement | null>, default: undefined },\n  },\n  setup(props, { slots }) {\n    const instance = props.i18n ?? createI18n({ locale: props.locale, messages: props.messages })\n    provide(I18nInjectionKey, instance)\n\n    if (!props.i18n) {\n      watch(\n        () => props.locale,\n        (locale) => {\n          if (locale) instance.setLocale(locale)\n        },\n      )\n      watch(\n        () => props.messages,\n        (messages) => {\n          if (messages) instance.setMessages(messages)\n        },\n      )\n    }\n\n    // Auto-apply writing direction + `lang` from the active locale (opt-in).\n    let revertDirection: (() => void) | null = null\n    watch(\n      () => [props.autoDirection, props.locale, props.directionTarget] as const,\n      ([autoDirection, locale]) => {\n        revertDirection?.()\n        revertDirection = null\n        if (!autoDirection || !locale || typeof document === 'undefined') return\n        const el = props.directionTarget ?? document.documentElement\n        const applied = applyDirection(localeDirection(locale), el)\n        const prevLang = el.getAttribute('lang')\n        el.setAttribute('lang', locale)\n        revertDirection = () => {\n          applied.revert()\n          if (prevLang === null) el.removeAttribute('lang')\n          else el.setAttribute('lang', prevLang)\n        }\n      },\n      { immediate: true },\n    )\n    onScopeDispose(() => {\n      revertDirection?.()\n      revertDirection = null\n    })\n\n    return () => slots.default?.()\n  },\n})\n","import { computed, inject, onBeforeUnmount, ref, type ComputedRef, type Ref } from 'vue'\nimport { createI18n, type I18n, type I18nState } from '@iris-ui-kit/core'\nimport { I18nInjectionKey } from './context'\n\nexport interface UseI18nReturn {\n  locale: ComputedRef<string>\n  t: I18n['t']\n  formatDate: I18n['formatDate']\n  formatNumber: I18n['formatNumber']\n  formatRelativeTime: I18n['formatRelativeTime']\n  setLocale: I18n['setLocale']\n  setMessages: I18n['setMessages']\n}\n\n// Shared fallback so components can call `useI18n()` without an enclosing\n// provider — they get English defaults rather than throwing.\nlet fallbackI18n: I18n | null = null\nfunction getFallback(): I18n {\n  if (fallbackI18n === null) fallbackI18n = createI18n()\n  return fallbackI18n\n}\n\n/**\n * Reactive access to the active locale + translation/formatting helpers.\n * Works with or without an `<IrisI18nProvider>` (falls back to English\n * defaults). `t` / formatters read the live locale at call time, and `locale`\n * is a reactive ref so templates re-render on change.\n */\nexport function useI18n(): UseI18nReturn {\n  const i18n = inject(I18nInjectionKey, null) ?? getFallback()\n  const state = ref(i18n.getState()) as Ref<I18nState>\n  const unsubscribe = i18n.subscribe((next) => {\n    state.value = next\n  })\n  onBeforeUnmount(unsubscribe)\n\n  return {\n    locale: computed(() => state.value.locale),\n    t: (key, params) => {\n      void state.value.locale\n      return i18n.t(key, params)\n    },\n    formatDate: (value, options) => {\n      void state.value.locale\n      return i18n.formatDate(value, options)\n    },\n    formatNumber: (value, options) => {\n      void state.value.locale\n      return i18n.formatNumber(value, options)\n    },\n    formatRelativeTime: (value, unit, options) => {\n      void state.value.locale\n      return i18n.formatRelativeTime(value, unit, options)\n    },\n    setLocale: i18n.setLocale,\n    setMessages: i18n.setMessages,\n  }\n}\n"]}

package/dist/i18n.js

@@ -1,3 +1,3 @@
-export { I18nInjectionKey, IrisI18nProvider, useI18n } from './chunk-W3JMJVEK.js';
+export { I18nInjectionKey, IrisI18nProvider, useI18n } from './chunk-TCAXRWT6.js';
 //# sourceMappingURL=i18n.js.map
 //# sourceMappingURL=i18n.js.map