@effect-app/vue-components 4.0.0-beta.32 → 4.0.0-beta.321

package/package.json

@@ -1,45 +1,50 @@
 {
   "name": "@effect-app/vue-components",
-  "version": "4.0.0-beta.32",
+  "version": "4.0.0-beta.321",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/effect-app/libs.git",
+    "directory": "packages/vue-components"
+  },
   "peerDependencies": {
     "@mdi/js": "^7.4.47",
-    "effect": "^4.0.0-beta.37",
-    "intl-messageformat": "^11.1.2",
+    "effect": "^4.0.0-rc.114",
+    "intl-messageformat": "^11.2.7",
     "mdi-js": "^1.0.1",
     "primeflex": "^4.0.0",
     "primeicons": "^7.0.0",
-    "primevue": "^4.5.4",
-    "vue": "^3.5.29",
-    "vuetify": "^4.0.1"
+    "primevue": "^4.5.5",
+    "vue": "^3.5.35",
+    "vue-router": "^5.1.0",
+    "vuetify": "^4.0.8"
   },
   "devDependencies": {
-    "@storybook/vue3": "^10.2.15",
-    "@storybook/vue3-vite": "^10.2.15",
-    "@types/node": "^25.3.3",
-    "@vitejs/plugin-vue": "^6.0.4",
-    "@vue/test-utils": "^2.4.6",
-    "@vueuse/core": "^14.2.1",
-    "dprint": "^0.52.0",
-    "jsdom": "^28.1.0",
+    "@storybook/vue3": "^10.4.1",
+    "@storybook/vue3-vite": "^10.4.1",
+    "@types/node": "^25.9.1",
+    "@vitejs/plugin-vue": "^6.0.7",
+    "@vue/test-utils": "^2.4.10",
+    "@vueuse/core": "^14.3.0",
+    "jsdom": "^29.1.1",
     "rimraf": "^6.1.3",
-    "sass": "^1.97.3",
-    "storybook": "^10.2.15",
-    "typescript": "~5.9.3",
-    "vite": "^7.3.1",
-    "vite-plugin-css-injected-by-js": "^4.0.1",
+    "sass": "^1.100.0",
+    "storybook": "^10.4.1",
+    "storybook-vue3-router": "^7.0.0",
+    "typescript": "~6.0.3",
+    "vite": "^8.0.15",
+    "vite-plugin-css-injected-by-js": "^5.0.1",
     "vitepress": "^1.6.4",
-    "vitest": "^4.0.18",
-    "vue-router": "^5.0.3",
+    "vitest": "^4.1.7",
+    "vue-router": "^5.1.0",
     "vue-toastification": "^2.0.0-rc.5",
-    "vue-tsc": "^3.2.5",
-    "vuetify": "^4.0.1",
-    "@effect-app/eslint-shared-config": "0.5.7-beta.2"
+    "vue-tsc": "^3.3.3",
+    "vuetify": "^4.0.8",
+    "@effect-app/eslint-shared-config": "0.6.0-beta.36"
   },
   "files": [
     "src",
     "dist"
   ],
-  "module": "./dist/vue-components.es.js",
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
@@ -52,29 +57,30 @@
     }
   },
   "dependencies": {
-    "@opentelemetry/api": "^1.9.0",
-    "@tanstack/vue-form": "^1.23.5",
+    "@opentelemetry/api": "^1.9.1",
+    "@tanstack/vue-form": "^1.32.0",
     "highlight.js": "^11.11.1",
     "mitt": "^3.0.1",
     "vue3-highlightjs": "^1.0.5",
-    "effect-app": "4.0.0-beta.32",
-    "@effect-app/vue": "4.0.0-beta.32"
+    "@effect-app/vue": "4.0.0-beta.321",
+    "effect-app": "4.0.0-beta.321"
   },
   "scripts": {
     "check": "vue-tsc",
     "build": "pnpm build:run",
-    "build:run": "rimraf dist && vue-tsc && vite build && cp src/reset.css dist/reset.css",
+    "build:run": "rimraf dist && vue-tsc -p tsconfig.build.json && vite build && cp src/reset.css dist/reset.css",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
     "docs:serve": "vitepress serve docs",
-    "lint": "NODE_OPTIONS=--max-old-space-size=8192 eslint src stories .storybook",
+    "lint": "oxlint --quiet --type-aware src stories && NODE_OPTIONS=--max-old-space-size=8192 ESLINT_TS=1 eslint --quiet src stories .storybook && pnpm exec dprint check --config ../../dprint.jsonc .",
     "ncu": "ncu",
     "clean": "rm -rf dist",
-    "lint-fix": "pnpm lint --fix",
+    "lint-fix": "oxlint --quiet --type-aware --fix src stories && NODE_OPTIONS=--max-old-space-size=8192 ESLINT_TS=1 eslint --quiet --fix src stories .storybook && pnpm exec dprint fmt --config ../../dprint.jsonc .",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build",
     "test": "vitest",
     "test:run": "vitest run",
     "test:watch": "vitest watch"
-  }
+  },
+  "module": "./dist/vue-components.es.js"
 }

package/src/components/CommandButton.vue

@@ -1,9 +1,11 @@
 <script
   setup
   lang="ts"
-  generic="I = never"
+  generic="I = never, RA = unknown, RE = unknown"
 >
-import type { CommandBase } from "@effect-app/vue"
+import type { CommandBase, Progress } from "@effect-app/vue/makeClient"
+import * as Option from "effect-app/Option"
+import type * as AsyncResult from "effect/unstable/reactivity/AsyncResult"
 import { computed } from "vue"
 import type { VBtn } from "vuetify/components"
 
@@ -14,38 +16,89 @@ const props = defineProps<
   & (
     | {
       input: NoInfer<I>
-      command: CommandBase<I>
+      optionalInput?: undefined
+      command: CommandBase<I, any, RA, RE>
       empty?: boolean
     }
     | {
-      command: CommandBase
+      optionalInput: Option.Option<NoInfer<I>>
       input?: undefined
+      command: CommandBase<I, any, RA, RE>
+      empty?: boolean
+    }
+    | {
+      command: CommandBase<any, any, RA, RE>
+      input?: undefined
+      optionalInput?: undefined
       empty?: boolean
     }
   )
   & {
     disabled?: ButtonProps["disabled"]
     title?: string // why isn't it part of VBtnProps??
+    mapProgress?: (result: AsyncResult.AsyncResult<RA, RE>) => Progress | undefined
   }
   & ButtonProps
 >()
 
-const isDisabled = computed(() => props.command.blocked || props.disabled)
+const resolvedInput = computed<{ _tag: "ready"; value: I } | { _tag: "missing" } | { _tag: "void" }>(() => {
+  if ("optionalInput" in props && props.optionalInput !== undefined) {
+    return Option.isSome(props.optionalInput)
+      ? { _tag: "ready", value: props.optionalInput.value }
+      : { _tag: "missing" }
+  }
+  if ("input" in props && props.input !== undefined) {
+    return { _tag: "ready", value: props.input as I }
+  }
+  return { _tag: "void" }
+})
 
-const handleClick = () => {
-  // Block execution if button is disabled
-  if (isDisabled.value) {
-    return
+const isDisabled = computed(() =>
+  props.command.blocked
+  || props.disabled
+  || resolvedInput.value._tag === "missing"
+)
+
+const resolvedProgress = computed(() => {
+  if (props.mapProgress) {
+    const result = props.command.result
+    return result !== undefined ? props.mapProgress(result) : undefined
   }
+  return props.command.progress
+})
 
-  const input = ("input" in props && props.input
-    ? props.input
-    : undefined) as unknown as I
-  ;(props.command.handle as any)(input)
+const progressText = computed(() => {
+  const p = resolvedProgress.value
+  if (p === undefined) return undefined
+  return typeof p === "string" ? p : p.text
+})
+
+const progressPercentage = computed(() => {
+  const p = resolvedProgress.value
+  return typeof p === "object" && p !== null ? p.percentage : undefined
+})
+
+const handleClick = () => {
+  if (isDisabled.value) return
+  const ri = resolvedInput.value
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const handle = props.command.handle as any
+  if (ri._tag === "ready") handle(ri.value)
+  else if (ri._tag === "void") handle(undefined)
+  // _tag === "missing" can't reach here — guarded by isDisabled
 }
 </script>
 <script lang="ts">
-/** Command Button is an easy way to connect commands and have it execute on click, while keeping track of disabled/loading states automatically */
+/**
+ * CommandButton connects a command to a button and tracks disabled / loading state.
+ *
+ * Input variants:
+ * - `input`: pass a validated value; button enabled when command + disabled allow it.
+ * - `optionalInput`: pass an `Option<I>`. `Some` → enabled, click fires with the value.
+ *   `None` → disabled. Use this when the input is gated by a `computed` instead of
+ *   a `v-if` on the button itself.
+ * - neither: command takes no input.
+ */
 export default {
   name: "CommandButton"
 }
@@ -55,27 +108,54 @@ export default {
     v-if="command.allowed && !empty"
     v-bind="$attrs"
     :loading="command.waiting"
+    :disabled="isDisabled"
     :aria-disabled="isDisabled"
     :title="title ?? command.action"
     :class="{ 'v-btn--disabled': isDisabled }"
     @click="handleClick"
   >
+    <template
+      v-if="progressText !== undefined"
+      #loader
+    >
+      <v-progress-circular
+        :indeterminate="progressPercentage === undefined"
+        :model-value="progressPercentage"
+        size="20"
+        width="2"
+      />
+      <span class="ml-2">{{ progressText }}</span>
+    </template>
     <slot
       :loading="command.waiting"
       :disabled="isDisabled"
       :label="command.label"
       :title="title ?? command.action"
     >
-      <span>{{ command.label }}</span>
+      {{ command.label }}
     </slot>
   </v-btn>
   <v-btn
     v-else-if="command.allowed"
     v-bind="$attrs"
     :loading="command.waiting"
+    :disabled="isDisabled"
     :aria-disabled="isDisabled"
     :title="title ?? command.action"
     :class="{ 'v-btn--disabled': isDisabled }"
     @click="handleClick"
-  />
+  >
+    <template
+      v-if="progressText !== undefined"
+      #loader
+    >
+      <v-progress-circular
+        :indeterminate="progressPercentage === undefined"
+        :model-value="progressPercentage"
+        size="20"
+        width="2"
+      />
+      <span class="ml-2">{{ progressText }}</span>
+    </template>
+  </v-btn>
 </template>

package/src/components/Dialog.vue

@@ -12,7 +12,6 @@
       />
     </template>
     <!-- pass down slots -->
-    <!-- @vue-skip -->
     <template
       v-for="(_, name) in otherSlots"
       #[name]="slotData"

package/src/components/FixedNuxtErrorBoundary.vue

@@ -0,0 +1,112 @@
+<script setup lang="ts">
+import { CauseException } from "effect-app/client"
+import * as Cause from "effect/Cause"
+import { onErrorCaptured, shallowRef } from "vue"
+import { useRouter } from "vue-router"
+
+// withDefaults, NOT `props.enabled ?? true`: Vue's boolean casting resolves an
+// ABSENT boolean prop to `false`, so the `??` fallback would never fire and an
+// omitted `enabled` (the frontend case) would silently disable the boundary.
+const props = withDefaults(
+  defineProps<{
+    captureException: (err: Error, hint?: { extra?: Record<string, unknown> }) => void
+    toastError: (message: string) => void
+    debug: boolean
+    /** register the boundary only when true (backend passes import.meta.client; frontend omits → true) */
+    enabled?: boolean
+    /** defer handling until app ready (backend: onNuxtReady while hydrating; frontend: omit → run now) */
+    scheduleAfterReady?: (fn: () => void) => void
+    /** extra side-effect after emit, before error.value is set (backend: nuxtApp vue:error hook) */
+    onHandled?: (err: Error, instance: unknown, info: string) => void
+  }>(),
+  { enabled: true }
+)
+
+defineOptions({ name: "NuxtErrorBoundary", inheritAttrs: false })
+
+const emit = defineEmits<{ error: [error: Error] }>()
+
+defineSlots<{
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  error(props: { error: Error; clearError: () => void }): any
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  default(): any
+}>()
+
+const error = shallowRef<Error | null>(null)
+function clearError() {
+  error.value = null
+}
+
+// lol in production these are different...
+const supportedErrors = ["https://vuejs.org/error-reference/#runtime-0", 0, "0", "setup function"]
+
+function handleError(...args: Parameters<Parameters<typeof onErrorCaptured<Error>>[0]>) {
+  const [err, instance, info] = args
+  const fiberFailure = err instanceof CauseException ? err : null
+  // PRO: log that we hit the error boundary
+  console.warn(
+    "NuxtErrorBoundary caught error in " + info + ": " + (fiberFailure ? "CauseException" : "classic error"),
+    fiberFailure ? Cause.pretty(fiberFailure.originalCause) : err,
+    instance
+  )
+
+  // PRO: we don't handle native event handlers the same way we handle setup errors,
+  // because these errors should only get reported, not take over the page.
+  if (!supportedErrors.includes(info)) {
+    props.captureException(err, { extra: { info, instance } })
+    if (props.debug) {
+      props.toastError("An unexpected error has occurred: " + err.toString())
+    }
+    return
+  }
+
+  // PRO: don't render interruptions..
+  // e.g when we run useSuspenseQuery, and we navigate away before a query is finished, we get a CancelledError
+  // if we however render it here instead of the default slot, we will show the cancellation error of the previous page, instead of rendering the new page
+  //
+  // NOTE the engine-side contract that makes this blanket silence safe: `useSuspenseQuery(New)`
+  // converts an interrupt that settles while the component is STILL MOUNTED (a query-side interrupt,
+  // e.g. a server RPC interrupt Exit — the thing that used to blank the page) into a typed
+  // `SuspenseInterruptedError` (@effect-app/vue makeClient), whose cause is NOT interrupt-only and
+  // therefore falls through to the error slot below. What remains interrupt-only here is genuinely
+  // "navigated away / unmounted" — silencing it is correct and avoids rendering the previous page's
+  // cancellation over the new page.
+  if (fiberFailure && Cause.hasInterruptsOnly(fiberFailure.originalCause)) {
+    return
+  }
+
+  emit("error", err)
+  props.onHandled?.(err, instance, info)
+  error.value = err
+}
+
+if (props.enabled) {
+  onErrorCaptured((err, instance, info) => {
+    if (props.scheduleAfterReady) props.scheduleAfterReady(() => handleError(err, instance, info))
+    else handleError(err, instance, info)
+    return false
+  })
+}
+
+// PRO: fix error not clearing after route change: https://github.com/nuxt/nuxt/issues/15781#issuecomment-2320928163
+const router = useRouter()
+router.afterEach(() => {
+  clearError()
+})
+
+defineExpose({ error, clearError })
+</script>
+
+<template>
+  <slot
+    v-if="error"
+    v-bind="{ error, clearError }"
+    name="error"
+  />
+
+  <slot
+    v-else
+    name="default"
+  />
+</template>

package/src/components/OmegaForm/InputProps.ts

@@ -36,6 +36,7 @@ export type InputProps<From extends Record<PropertyKey, any>, TName extends Deep
     maxLength?: number | false
     max?: number | false
     min?: number | false
+    refinement?: "int"
     errorMessages: string[]
     error: boolean
     label: string
@@ -43,7 +44,7 @@ export type InputProps<From extends Record<PropertyKey, any>, TName extends Deep
     inputClass: string | undefined | null
   }
   field: OmegaFieldInternalApi<From, TName>
-  /** be sure to use this state and not `field.state` as it is not reactive */
+  /** reactive field state, sourced from `field.state` (the Field slot's own `state` prop is a stale snapshot since @tanstack/vue-form 1.32) */
   state: OmegaFieldInternalApi<From, TName>["state"]
 }
 

package/src/components/OmegaForm/OmegaArray.vue

@@ -3,24 +3,23 @@
     :is="form.Field"
     :name="name"
   >
-    <template #default="{ field, state }">
+    <!-- `field.state` is reactive; the Field slot's `state` prop is a stale snapshot since @tanstack/vue-form 1.32 -->
+    <template #default="{ field }">
       <slot
         name="pre-array"
-        v-bind="{ field, state }"
+        v-bind="{ field, state: field.state }"
       />
       <component
         :is="form.Field"
         v-for="(_, i) of items"
         :key="`${name}[${Number(i)}]`"
-        :name="// eslint-disable-next-line
-          `${name}[${Number(i)}]` as DeepKeys<From>
-        "
+        :name="`${name}[${Number(i)}]` as DeepKeys<From>"
       >
-        <template #default="{ field: subField, state: subState }">
+        <template #default="{ field: subField }">
           <slot
             v-bind="{
               subField,
-              subState,
+              subState: subField.state,
               index: Number(i),
               field
             }"
@@ -29,7 +28,7 @@
       </component>
       <slot
         name="post-array"
-        v-bind="{ field, state }"
+        v-bind="{ field, state: field.state }"
       />
       <!-- TODO: legacy slot, remove this slot -->
       <slot
@@ -45,8 +44,8 @@
   generic="From extends Record<PropertyKey, any>, To extends Record<PropertyKey, any>, Name extends DeepKeys<From>"
 >
 import { type DeepKeys } from "@tanstack/vue-form"
-import { computed, onMounted, provide } from "vue"
-import { type OmegaArrayProps } from "./OmegaFormStuff"
+import { computed, onMounted } from "vue"
+import { type OmegaArrayProps } from "./types"
 
 const props = defineProps<OmegaArrayProps<From, To, Name>>()
 
@@ -74,17 +73,4 @@ onMounted(async () => {
     props.form.setFieldValue(props.name, props.defaultItems)
   }
 })
-
-const getMetaFromArray = computed(() => {
-  const getMeta = (path: string) => {
-    // Transform path like 'a[0].b[11].c' into 'a.b.c'
-    const simplifiedPath = path.replace(/\[\d+\]/g, "")
-
-    return props.form.meta[simplifiedPath as keyof typeof props.form.meta]
-  }
-
-  return getMeta
-})
-
-provide("getMetaFromArray", getMetaFromArray)
 </script>

package/src/components/OmegaForm/OmegaAutoGen.vue

@@ -20,9 +20,10 @@
   Name extends DeepKeys<From>"
 >
 import { type DeepKeys } from "@tanstack/vue-form"
-import { Order } from "effect-app"
+import * as Order from "effect/Order"
 import { computed } from "vue"
-import { type FieldMeta, type FieldPath, type OmegaAutoGenMeta, type OmegaInputProps } from "./OmegaFormStuff"
+import { type FieldMeta } from "./meta/types"
+import { type FieldPath, type OmegaAutoGenMeta, type OmegaInputProps } from "./types"
 
 type NewMeta = OmegaAutoGenMeta<From, To, Name>
 

package/src/components/OmegaForm/OmegaErrorsInternal.vue

@@ -99,17 +99,16 @@
 </template>
 
 <script setup lang="ts">
-import type { StandardSchemaV1Issue } from "@tanstack/vue-form"
 import { computed, getCurrentInstance } from "vue"
 import { useIntl } from "../../utils"
-import { type OmegaError } from "./OmegaFormStuff"
+import { type OmegaError } from "./types"
 
 const instance = getCurrentInstance()
 const vuetified = instance?.appContext.components["VAlert"]
 
 const props = defineProps<
   {
-    generalErrors: (Record<string, StandardSchemaV1Issue[]> | undefined)[]
+    generalErrors: unknown[]
     errors: OmegaError[]
     hideErrorDetails?: boolean
   }
@@ -120,21 +119,25 @@ const { trans } = useIntl()
 const showedGeneralErrors = computed(() => {
   if (!props.generalErrors) return []
 
-  return props
-    .generalErrors
-    .filter((record): record is Record<string, StandardSchemaV1Issue[]> => Boolean(record))
-    .flatMap((errorRecord) =>
-      Object
-        .values(errorRecord)
-        .filter((issues): issues is StandardSchemaV1Issue[] => Boolean(issues))
-        .flatMap((issues) =>
-          issues
-            .filter(
-              (issue): issue is StandardSchemaV1Issue & { message: string } => Boolean(issue?.message)
-            )
-            .map((issue) => issue.message)
+  return props.generalErrors.flatMap((record) => {
+    if (typeof record === "string") return record ? [record] : []
+    if (typeof record !== "object" || record === null) return []
+
+    return Object
+      .values(record)
+      .filter((issues): issues is unknown[] => Array.isArray(issues))
+      .flatMap((issues) =>
+        issues.flatMap((issue) =>
+          typeof issue === "object"
+            && issue !== null
+            && "message" in issue
+            && typeof issue.message === "string"
+            && issue.message
+            ? [issue.message]
+            : []
         )
-    )
+      )
+  })
 })
 </script>
 

package/src/components/OmegaForm/OmegaFormInput.vue

@@ -17,8 +17,8 @@
 import { type DeepKeys } from "@tanstack/vue-form"
 import { inject } from "vue"
 import type { MergedInputProps } from "./InputProps"
-import type { BaseProps, DefaultTypeProps, OmegaInputProps } from "./OmegaFormStuff"
 import OmegaInput from "./OmegaInput.vue"
+import type { BaseProps, DefaultTypeProps, OmegaInputProps } from "./types"
 import { OmegaFormKey } from "./useOmegaForm"
 
 const form = inject(OmegaFormKey) as unknown as OmegaInputProps<