@iris-ui-kit/vue 0.2.21 → 0.2.23

package/dist/form.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/form/context.ts","../src/form/Form.ts","../src/form/useForm.ts","../src/form/useField.ts","../src/form/useFieldArray.ts"],"names":["inject","defineComponent","provide","ref","h","createFormStore","onBeforeUnmount","computed","formatPath","getByPath"],"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 { computed, onBeforeUnmount, ref, 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'\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 a `ref` updated\n * on each store change, cleaned up on unmount. 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  const state = ref(form.getState()) as Ref<FormState<V>>\n  const unsubscribe = form.subscribe((next) => {\n    state.value = next\n  })\n  onBeforeUnmount(unsubscribe)\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, onBeforeUnmount, ref, type ComputedRef, type Ref } from 'vue'\nimport { formatPath, getByPath, type FormState, type FormValues } from '@iris-ui-kit/core'\nimport { useFormContext } from './context'\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  const state = ref(form.getState()) as Ref<FormState<FormValues>>\n  const unsubscribe = form.subscribe((next) => {\n    state.value = next\n  })\n  onBeforeUnmount(unsubscribe)\n\n  // Canonical key for per-field state lookups (a flat key maps to itself).\n  const key = formatPath(name)\n  const value = computed(() => getByPath(state.value.values, name) as T)\n  const error = computed(() => state.value.errors[key])\n\n  return {\n    name,\n    value,\n    error,\n    touched: computed(() => Boolean(state.value.touched[key])),\n    dirty: computed(() => Boolean(state.value.dirty[key])),\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, onBeforeUnmount, ref, type ComputedRef, type Ref } from 'vue'\nimport type { FormState, FormValues } from '@iris-ui-kit/core'\nimport { useFormContext } from './context'\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  const state = ref(form.getState()) as Ref<FormState<FormValues>>\n  const unsubscribe = form.subscribe((next) => {\n    state.value = next\n  })\n  onBeforeUnmount(unsubscribe)\n\n  return {\n    name,\n    fields: computed(\n      () => (Array.isArray(state.value.values[name]) ? state.value.values[name] : []) as T[],\n    ),\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.d.cts

@@ -54,8 +54,9 @@ interface UseFormReturn<V extends FormValues> {
 }
 /**
  * Vue binding for the framework-agnostic form engine. Creates the store in
- * `setup()` (runs once) and bridges it into Vue reactivity via a `ref` updated
- * on each store change, cleaned up on unmount. Because `setup` runs once,
+ * `setup()` (runs once) and bridges it into Vue reactivity via `useStore` (a
+ * shallow snapshot ref updated on each store change, detached on scope
+ * dispose). Because `setup` runs once,
  * `onSubmit` / `validate` closures stay live against reactive state — no
  * stale-callback handling is needed (unlike the React adapter).
  */

package/dist/form.d.ts

@@ -54,8 +54,9 @@ interface UseFormReturn<V extends FormValues> {
 }
 /**
  * Vue binding for the framework-agnostic form engine. Creates the store in
- * `setup()` (runs once) and bridges it into Vue reactivity via a `ref` updated
- * on each store change, cleaned up on unmount. Because `setup` runs once,
+ * `setup()` (runs once) and bridges it into Vue reactivity via `useStore` (a
+ * shallow snapshot ref updated on each store change, detached on scope
+ * dispose). Because `setup` runs once,
  * `onSubmit` / `validate` closures stay live against reactive state — no
  * stale-callback handling is needed (unlike the React adapter).
  */

package/dist/form.js

@@ -1,3 +1,4 @@
-export { FormInjectionKey, IrisForm, useField, useFieldArray, useForm, useFormContext } from './chunk-4FLIW67H.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/index.cjs

@@ -226,14 +226,21 @@ function useSkin() {
     errors: engine.errors
   };
 }
-function useMachine(machine) {
+function useMachine(machine, options = {}) {
   const state = vue.ref(machine.store.getState());
   const unsubscribe = machine.store.subscribe((next) => {
     state.value = next;
   });
-  vue.onBeforeUnmount(() => {
-    unsubscribe();
-  });
+  vue.onScopeDispose(
+    () => {
+      unsubscribe();
+      if (options.stopOnUnmount !== false) machine.stop();
+    },
+    // failSilently: outside any effect scope there is nothing to dispose —
+    // registering is a no-op and must not emit the "no active effect scope"
+    // dev warning. Within a component/effectScope this arg changes nothing.
+    true
+  );
   return { state, send: machine.send };
 }
 var FormInjectionKey = /* @__PURE__ */ Symbol("IrisForm");
@@ -293,11 +300,7 @@ var IrisForm = vue.defineComponent({
 });
 function useForm(config) {
   const form = core.createFormStore(config);
-  const state = vue.ref(form.getState());
-  const unsubscribe = form.subscribe((next) => {
-    state.value = next;
-  });
-  vue.onBeforeUnmount(unsubscribe);
+  const state = useStore(form.store);
   return {
     form,
     state,
@@ -322,22 +325,24 @@ function useForm(config) {
 }
 function useField(name) {
   const form = useFormContext();
-  const state = vue.ref(form.getState());
-  const unsubscribe = form.subscribe((next) => {
-    state.value = next;
-  });
-  vue.onBeforeUnmount(unsubscribe);
   const key = core.formatPath(name);
-  const value = vue.computed(() => core.getByPath(state.value.values, name));
-  const error = vue.computed(() => state.value.errors[key]);
+  const segments = core.parsePath(name);
+  const valueSlice = useStoreSelector(form.store, (s) => core.getByPath(s.values, segments));
+  const errorSlice = useStoreSelector(form.store, (s) => s.errors[key]);
+  const touchedSlice = useStoreSelector(form.store, (s) => Boolean(s.touched[key]));
+  const dirtySlice = useStoreSelector(form.store, (s) => Boolean(s.dirty[key]));
+  const value = vue.computed(() => valueSlice.value);
+  const error = vue.computed(() => errorSlice.value);
+  const touched = vue.computed(() => touchedSlice.value);
+  const dirty = vue.computed(() => dirtySlice.value);
   return {
     name,
     value,
     error,
-    touched: vue.computed(() => Boolean(state.value.touched[key])),
-    dirty: vue.computed(() => Boolean(state.value.dirty[key])),
+    touched,
+    dirty,
     setValue: (next) => form.setFieldValue(name, next),
-    setTouched: (touched = true) => form.setFieldTouched(name, touched),
+    setTouched: (touched2 = true) => form.setFieldTouched(name, touched2),
     fieldProps: vue.computed(() => ({
       modelValue: value.value,
       "onUpdate:modelValue": (next) => form.setFieldValue(name, next),
@@ -348,16 +353,11 @@ function useField(name) {
 }
 function useFieldArray(name) {
   const form = useFormContext();
-  const state = vue.ref(form.getState());
-  const unsubscribe = form.subscribe((next) => {
-    state.value = next;
-  });
-  vue.onBeforeUnmount(unsubscribe);
+  const raw = useStoreSelector(form.store, (s) => s.values[name]);
+  const fields = vue.computed(() => Array.isArray(raw.value) ? raw.value : []);
   return {
     name,
-    fields: vue.computed(
-      () => Array.isArray(state.value.values[name]) ? state.value.values[name] : []
-    ),
+    fields,
     push: (item) => form.arrayPush(name, item),
     remove: (index) => form.arrayRemove(name, index),
     insert: (index, item) => form.arrayInsert(name, index, item),
@@ -465,8 +465,31 @@ function useI18n() {
   };
 }
 function useAsyncResource(fetcher, options = {}) {
+  const holder = {
+    // isRef-only resolution. NEVER toValue() here: the element type is itself
+    // a function, so toValue(fetcher) would *invoke the fetcher at setup*
+    // (spurious request) and toValue(getter) would do the same. isRef narrows
+    // to the only unambiguous reactive form: ref(fetcher) / computed(() =>
+    // fetcher) / shallowRef(fetcher) — a ComputedRef IS a Ref.
+    // F3 elision point — the ONE explicit narrowing cast: after the isRef
+    // guard the else arm is `F | (() => F)`, and the bare-getter arm's return
+    // `F` (a function) is not assignable to `F` (TS2322). No runtime
+    // discriminant distinguishes a plain fetcher from a bare getter (both are
+    // functions), so the cast encodes exactly the documented F3 ambiguity and
+    // adds no unsafety beyond F3.
+    current: vue.isRef(fetcher) ? fetcher.value : fetcher
+  };
+  if (vue.isRef(fetcher)) {
+    vue.watch(
+      fetcher,
+      (next) => {
+        holder.current = next;
+      },
+      { flush: "sync" }
+    );
+  }
   const config = "initialData" in options ? { initialData: options.initialData } : {};
-  const resource = core.createAsyncResource(fetcher, config);
+  const resource = core.createAsyncResource((...params) => holder.current(...params), config);
   const state = vue.ref(resource.getState());
   const unsubscribe = resource.subscribe((next) => {
     state.value = next;
@@ -494,7 +517,30 @@ function useAsyncResource(fetcher, options = {}) {
   };
 }
 function usePaginatedResource(fetcher, options = {}) {
-  const resource = core.createPaginatedResource(fetcher, {
+  const holder = {
+    // isRef-only resolution. NEVER toValue() here: the element type is itself
+    // a function, so toValue(fetcher) would *invoke the fetcher at setup*
+    // (spurious request) and toValue(getter) would do the same. isRef narrows
+    // to the only unambiguous reactive form: ref(fetcher) / computed(() =>
+    // fetcher) / shallowRef(fetcher) — a ComputedRef IS a Ref.
+    // F3 elision point — the ONE explicit narrowing cast: after the isRef
+    // guard the else arm is `F | (() => F)`, and the bare-getter arm's return
+    // `F` (a function) is not assignable to `F` (TS2322). No runtime
+    // discriminant distinguishes a plain fetcher from a bare getter (both are
+    // functions), so the cast encodes exactly the documented F3 ambiguity and
+    // adds no unsafety beyond F3.
+    current: vue.isRef(fetcher) ? fetcher.value : fetcher
+  };
+  if (vue.isRef(fetcher)) {
+    vue.watch(
+      fetcher,
+      (next) => {
+        holder.current = next;
+      },
+      { flush: "sync" }
+    );
+  }
+  const resource = core.createPaginatedResource((query) => holder.current(query), {
     pageSize: options.pageSize,
     mode: options.mode
   });
@@ -530,10 +576,14 @@ function usePaginatedResource(fetcher, options = {}) {
   };
 }
 function useResourceController(config) {
-  const controller = core.createResourceController(config);
+  const controller = core.createResourceController({ ...config, immediate: false });
+  const immediate = config.immediate !== false;
+  if (immediate) {
+    vue.onMounted(() => void controller.load());
+  }
+  vue.onScopeDispose(() => controller.destroy());
   const state = vue.shallowRef(controller.getState());
-  vue.onBeforeUnmount(controller.subscribe((next) => state.value = next));
-  vue.onBeforeUnmount(() => controller.destroy());
+  vue.onScopeDispose(controller.subscribe((next) => state.value = next));
   return { ...controller, state };
 }
 function useDataSource(config) {
@@ -2484,7 +2534,9 @@ var IrisAdminTabs = vue.defineComponent({
           onClick: (e) => {
             e.stopPropagation();
             close(tab.key);
-            const root = e.currentTarget.closest('[role="tablist"]');
+            const root = e.currentTarget.closest(
+              '[role="tablist"]'
+            );
             void vue.nextTick(() => focusTab(root, props.nav.getState().activeKey));
           }
         },
@@ -3037,12 +3089,17 @@ function useUndoStack(options) {
     index: raw.index
   });
   const sync = () => {
-    state.value = {
+    const next = {
       canUndo: raw.canUndo(),
       canRedo: raw.canRedo(),
       depth: raw.depth,
       index: raw.index
     };
+    const cur = state.value;
+    if (next.canUndo === cur.canUndo && next.canRedo === cur.canRedo && next.depth === cur.depth && next.index === cur.index) {
+      return;
+    }
+    state.value = next;
   };
   const stack = trackUndoStack(raw, sync);
   const push = (snapshot) => stack.push(snapshot);
@@ -6293,7 +6350,10 @@ var IrisList = vue.defineComponent({
     const { state, isContent, stateKey, stateProps } = useDataState(() => ({
       loading: props.loading,
       error: props.error,
-      empty: props.items.length === 0
+      empty: props.items.length === 0,
+      // Already-loaded items stay mounted during a revalidate (SWR): a load
+      // in flight no longer replaces them with the loading/error state.
+      hasContent: props.items.length > 0
     }));
     const isEnabled = (i) => !props.items[i]?.disabled;
     const nav = core.createKeyboardNav({
@@ -6406,12 +6466,13 @@ var IrisList = vue.defineComponent({
           "data-iris-list-index": index,
           "data-iris-list-item": "",
           "data-state": selected ? "selected" : active ? "active" : "idle",
+          "data-hovered": hoveredIndex.value === index ? "true" : "false",
           onClick: item.disabled ? void 0 : onClick,
           onFocus,
-          onMouseEnter: () => {
+          onMouseenter: () => {
             hoveredIndex.value = index;
           },
-          onMouseLeave: () => {
+          onMouseleave: () => {
             if (hoveredIndex.value === index) hoveredIndex.value = -1;
           },
           style: baseStyle
@@ -6429,7 +6490,9 @@ var IrisList = vue.defineComponent({
         role: "listbox",
         "aria-label": props.ariaLabel,
         "aria-multiselectable": props.multi ? "true" : void 0,
-        "aria-busy": state.value === "loading" ? "true" : void 0,
+        // Decoupled from resolved state: signals both the initial load and
+        // an in-flight background revalidate (content stays mounted).
+        "aria-busy": props.loading ? "true" : void 0,
         "data-iris-list": "",
         onKeydown: onKeyDown,
         style: {
@@ -12006,7 +12069,10 @@ var IrisTree = vue.defineComponent({
     const { state, isContent, stateKey, stateProps } = useDataState(() => ({
       loading: props.loading,
       error: props.error,
-      empty: props.nodes.length === 0
+      empty: props.nodes.length === 0,
+      // Already-loaded nodes stay mounted during a revalidate (SWR): a load
+      // in flight no longer replaces them with the loading/error state.
+      hasContent: props.nodes.length > 0
     }));
     const lazyCache = vue.ref(/* @__PURE__ */ new Map());
     const loadingIds = vue.ref(/* @__PURE__ */ new Set());
@@ -12326,7 +12392,9 @@ var IrisTree = vue.defineComponent({
         role: "tree",
         "aria-label": props.ariaLabel ?? t("tree.label"),
         "aria-multiselectable": props.selectionMode === "multi" ? "true" : void 0,
-        "aria-busy": state.value === "loading" ? "true" : void 0,
+        // Decoupled from resolved state: signals both the initial load and
+        // an in-flight background revalidate (content stays mounted).
+        "aria-busy": props.loading ? "true" : void 0,
         "data-iris-tree": "",
         style: {
           display: "flex",
@@ -18386,14 +18454,32 @@ var IrisDashboardTemplate = vue.defineComponent({
     activeId: { type: String, default: "" },
     /** Cards to render in the main grid. Skip to use the `default` slot only. */
     cards: { type: Array, default: () => [] },
-    defaultCollapsed: { type: Boolean, default: false }
+    defaultCollapsed: { type: Boolean, default: false },
+    /**
+     * Controlled collapsed state. When unset (`undefined`), the component
+     * manages its own state seeded from `defaultCollapsed`; when set, this
+     * value takes precedence and changes are re-emitted via
+     * `update:collapsed` (`v-model:collapsed`).
+     */
+    collapsed: { type: Boolean, default: void 0 }
   },
   emits: {
     "update:activeId": (_id) => true,
     "update:collapsed": (_value) => true
   },
   setup(props, { attrs, slots, emit }) {
-    const collapsed = vue.ref(props.defaultCollapsed);
+    const isControlled = vue.computed(() => props.collapsed !== void 0);
+    const internalCollapsed = vue.ref(props.defaultCollapsed);
+    const collapsed = vue.computed(
+      () => isControlled.value ? Boolean(props.collapsed) : internalCollapsed.value
+    );
+    vue.watch(
+      () => props.collapsed,
+      (value) => {
+        if (value !== void 0) internalCollapsed.value = value;
+      },
+      { immediate: true }
+    );
     const onSelectNav = (id) => {
       emit("update:activeId", id);
     };
@@ -18415,7 +18501,7 @@ var IrisDashboardTemplate = vue.defineComponent({
         {
           collapsed: collapsed.value,
           "onUpdate:collapsed": (v) => {
-            collapsed.value = v;
+            if (!isControlled.value) internalCollapsed.value = v;
             emit("update:collapsed", v);
           },
           width: 240,
@@ -18602,6 +18688,72 @@ function handlePosition2(handle) {
   s.cursor = HANDLE_CURSORS2[handle];
   return s;
 }
+var ResizableHandle = vue.defineComponent({
+  name: "ResizableHandle",
+  props: {
+    handle: { type: String, required: true },
+    disabled: { type: Boolean, default: false },
+    keepAspect: { type: Boolean, default: false },
+    minWidth: { type: Number, default: 40 },
+    minHeight: { type: Number, default: 40 },
+    maxWidth: { type: Number, default: Infinity },
+    maxHeight: { type: Number, default: Infinity },
+    /** Stable computed ref from the parent; read only (never mutated). */
+    sizeRef: { type: Object, required: true },
+    /** Stable setup-level callbacks from the parent. */
+    onUpdate: { type: Function, required: true },
+    onResizeStart: {
+      type: Function,
+      default: void 0
+    },
+    onResizeEnd: { type: Function, default: void 0 }
+  },
+  setup(props) {
+    const handleRef = vue.ref(null);
+    let startSize = { width: 0, height: 0 };
+    let aspect = 1;
+    useDrag({
+      handle: handleRef,
+      disabled: vue.computed(() => props.disabled),
+      onStart: () => {
+        startSize = { ...props.sizeRef.value };
+        aspect = startSize.width / Math.max(1, startSize.height);
+        props.onResizeStart?.(startSize);
+      },
+      onDrag: ({ dx, dy }) => {
+        const t = props.handle.includes("top");
+        const b = props.handle.includes("bottom");
+        const l = props.handle.includes("left");
+        const r = props.handle.includes("right");
+        let nextW = startSize.width;
+        let nextH = startSize.height;
+        if (r) nextW = startSize.width + dx;
+        if (l) nextW = startSize.width - dx;
+        if (b) nextH = startSize.height + dy;
+        if (t) nextH = startSize.height - dy;
+        if (props.keepAspect && (t || b) && (l || r)) {
+          nextH = nextW / aspect;
+        }
+        nextW = Math.max(props.minWidth, Math.min(props.maxWidth, nextW));
+        nextH = Math.max(props.minHeight, Math.min(props.maxHeight, nextH));
+        props.onUpdate({ width: nextW, height: nextH });
+      },
+      onEnd: () => props.onResizeEnd?.()
+    });
+    return () => vue.h("div", {
+      ref: (el) => {
+        handleRef.value = el ?? null;
+      },
+      "data-iris-resizable-handle": props.handle,
+      style: {
+        ...handlePosition2(props.handle),
+        touchAction: "none",
+        background: "transparent",
+        zIndex: "1"
+      }
+    });
+  }
+});
 var IrisResizable = vue.defineComponent({
   name: "IrisResizable",
   inheritAttrs: false,
@@ -18634,53 +18786,8 @@ var IrisResizable = vue.defineComponent({
       if (!isControlled.value) internal.value = next;
       emit("update:size", next);
     };
-    const renderHandle = (handle) => {
-      const handleRef = vue.ref(null);
-      let startSize = { width: 0, height: 0 };
-      let aspect = 1;
-      useDrag({
-        handle: handleRef,
-        disabled: vue.computed(() => props.disabled),
-        onStart: () => {
-          startSize = { ...size.value };
-          aspect = startSize.width / Math.max(1, startSize.height);
-          emit("resizeStart", startSize);
-        },
-        onDrag: ({ dx, dy }) => {
-          const t = handle.includes("top");
-          const b = handle.includes("bottom");
-          const l = handle.includes("left");
-          const r = handle.includes("right");
-          let nextW = startSize.width;
-          let nextH = startSize.height;
-          if (r) nextW = startSize.width + dx;
-          if (l) nextW = startSize.width - dx;
-          if (b) nextH = startSize.height + dy;
-          if (t) nextH = startSize.height - dy;
-          if (props.keepAspect && (t || b) && (l || r)) {
-            nextH = nextW / aspect;
-          }
-          nextW = Math.max(props.minWidth, Math.min(props.maxWidth, nextW));
-          nextH = Math.max(props.minHeight, Math.min(props.maxHeight, nextH));
-          setSize({ width: nextW, height: nextH });
-        },
-        onEnd: () => {
-          emit("resizeEnd", size.value);
-        }
-      });
-      return vue.h("div", {
-        ref: (el) => {
-          handleRef.value = el ?? null;
-        },
-        "data-iris-resizable-handle": handle,
-        style: {
-          ...handlePosition2(handle),
-          touchAction: "none",
-          background: "transparent",
-          zIndex: "1"
-        }
-      });
-    };
+    const emitResizeStart = (s) => emit("resizeStart", s);
+    const emitResizeEnd = () => emit("resizeEnd", size.value);
     return () => vue.h(
       "div",
       {
@@ -18695,7 +18802,25 @@ var IrisResizable = vue.defineComponent({
           ...attrs.style ?? {}
         }
       },
-      [slots.default?.(), ...props.handles.map(renderHandle)]
+      [
+        slots.default?.(),
+        ...props.handles.map(
+          (handle) => vue.h(ResizableHandle, {
+            key: handle,
+            handle,
+            disabled: props.disabled,
+            keepAspect: props.keepAspect,
+            minWidth: props.minWidth,
+            minHeight: props.minHeight,
+            maxWidth: props.maxWidth,
+            maxHeight: props.maxHeight,
+            sizeRef: size,
+            onUpdate: setSize,
+            onResizeStart: emitResizeStart,
+            onResizeEnd: emitResizeEnd
+          })
+        )
+      ]
     );
   }
 });