refactor: move out Commander and friends from experimental

patroza · patroza · commit 0c42d6721de3 · 2026-03-30T15:23:46.000+02:00
diff --git a/.changeset/metal-mammals-smell.md b/.changeset/metal-mammals-smell.md
@@ -0,0 +1,6 @@
+---
+"@effect-app/vue-components": patch
+"@effect-app/vue": patch
+---
+
+move out Commander and friends from experimental
diff --git a/packages/vue-components/stories/Commands/helpers.ts b/packages/vue-components/stories/Commands/helpers.ts
@@ -1,9 +1,9 @@
 import { LegacyMutation, makeClient, makeIntl } from "@effect-app/vue"
-import { Commander, DefaultIntl } from "@effect-app/vue/experimental/commander"
-import { Confirm } from "@effect-app/vue/experimental/confirm"
-import { I18n } from "@effect-app/vue/experimental/intl"
-import * as Toast_ from "@effect-app/vue/experimental/toast"
-import { WithToast } from "@effect-app/vue/experimental/withToast"
+import { Commander, DefaultIntl } from "@effect-app/vue/commander"
+import { Confirm } from "@effect-app/vue/confirm"
+import { I18n } from "@effect-app/vue/intl"
+import * as Toast_ from "@effect-app/vue/toast"
+import { WithToast } from "@effect-app/vue/withToast"
 import { Effect, Layer, ManagedRuntime, Option } from "effect"
 import { ApiClientFactory } from "effect-app/client"
 import * as FetchHttpClient from "effect/unstable/http/FetchHttpClient"
diff --git a/packages/vue/package.json b/packages/vue/package.json
@@ -48,29 +48,29 @@
       "types": "./dist/errorReporter.d.ts",
       "default": "./dist/errorReporter.js"
     },
-    "./experimental/commander": {
-      "types": "./dist/experimental/commander.d.ts",
-      "default": "./dist/experimental/commander.js"
+    "./commander": {
+      "types": "./dist/commander.d.ts",
+      "default": "./dist/commander.js"
     },
-    "./experimental/confirm": {
-      "types": "./dist/experimental/confirm.d.ts",
-      "default": "./dist/experimental/confirm.js"
+    "./confirm": {
+      "types": "./dist/confirm.d.ts",
+      "default": "./dist/confirm.js"
     },
-    "./experimental/intl": {
-      "types": "./dist/experimental/intl.d.ts",
-      "default": "./dist/experimental/intl.js"
+    "./intl": {
+      "types": "./dist/intl.d.ts",
+      "default": "./dist/intl.js"
     },
-    "./experimental/makeUseCommand": {
-      "types": "./dist/experimental/makeUseCommand.d.ts",
-      "default": "./dist/experimental/makeUseCommand.js"
+    "./makeUseCommand": {
+      "types": "./dist/makeUseCommand.d.ts",
+      "default": "./dist/makeUseCommand.js"
     },
-    "./experimental/toast": {
-      "types": "./dist/experimental/toast.d.ts",
-      "default": "./dist/experimental/toast.js"
+    "./toast": {
+      "types": "./dist/toast.d.ts",
+      "default": "./dist/toast.js"
     },
-    "./experimental/withToast": {
-      "types": "./dist/experimental/withToast.d.ts",
-      "default": "./dist/experimental/withToast.js"
+    "./withToast": {
+      "types": "./dist/withToast.d.ts",
+      "default": "./dist/withToast.js"
     },
     "./form": {
       "types": "./dist/form.d.ts",
diff --git a/packages/vue/src/commander.ts b/packages/vue/src/commander.ts
@@ -1685,7 +1685,7 @@ export class CommanderImpl<RT, RTHooks> {
       }
     )
 
-  /** @experimental @deprecated */
+  /** @deprecated */
   alt2: <
     const Id extends string,
     MutArg,
@@ -1737,7 +1737,6 @@ export class CommanderImpl<RT, RTHooks> {
         )), baseInfo) as any
     }
 
-  /** @experimental */
   alt = this.makeCommand as unknown as <
     const Id extends string,
     const I18nKey extends string = Id,
diff --git a/packages/vue/src/confirm.ts b/packages/vue/src/confirm.ts
diff --git a/packages/vue/src/intl.ts b/packages/vue/src/intl.ts
@@ -1,6 +1,6 @@
 import { ServiceMap } from "effect-app"
 import { proxify } from "effect-app/ServiceMap"
-import { type MakeIntlReturn } from "../makeIntl.js"
+import { type MakeIntlReturn } from "./makeIntl.js"
 
 export class I18n extends proxify(ServiceMap.Opaque<I18n, ReturnType<MakeIntlReturn<string>["useIntl"]>>()("I18n"))<
   I18n,
diff --git a/packages/vue/src/makeClient.ts b/packages/vue/src/makeClient.ts
@@ -11,16 +11,16 @@ import { dropUndefinedT, extendM } from "effect-app/utils"
 import { type Fiber } from "effect/Fiber"
 import * as AsyncResult from "effect/unstable/reactivity/AsyncResult"
 import { computed, type ComputedRef, onBeforeUnmount, type Ref, ref, watch, type WatchSource } from "vue"
+import { type Commander, CommanderStatic } from "./commander.js"
 import { reportMessage } from "./errorReporter.js"
-import { type Commander, CommanderStatic } from "./experimental/commander.js"
-import { I18n } from "./experimental/intl.js"
-import { type CommanderResolved, makeUseCommand } from "./experimental/makeUseCommand.js"
-import { Toast } from "./experimental/toast.js"
 import { buildFieldInfoFromFieldsRoot } from "./form.js"
+import { I18n } from "./intl.js"
 import { reportRuntimeError } from "./lib.js"
+import { type CommanderResolved, makeUseCommand } from "./makeUseCommand.js"
 import { asResult, makeMutation, type MutationOptions, type MutationOptionsBase, mutationResultToVue, type Res, useMakeMutation } from "./mutate.js"
 import { type CustomUndefinedInitialQueryOptions, makeQuery } from "./query.js"
 import { makeRunPromise } from "./runtime.js"
+import { Toast } from "./toast.js"
 
 const mapHandler = <A, E, R, I = void, A2 = A, E2 = E, R2 = R>(
   handler: Effect.Effect<A, E, R> | ((i: I) => Effect.Effect<A, E, R>),
diff --git a/packages/vue/src/makeUseCommand.ts b/packages/vue/src/makeUseCommand.ts
diff --git a/packages/vue/src/toast.ts b/packages/vue/src/toast.ts
diff --git a/packages/vue/src/withToast.ts b/packages/vue/src/withToast.ts
diff --git a/packages/vue/test/Mutation.test.ts b/packages/vue/test/Mutation.test.ts
@@ -1,7 +1,7 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import { it } from "@effect/vitest"
 import { Cause, Effect, Exit, Fiber, Option } from "effect-app"
-import { CommandContext, DefaultIntl } from "../src/experimental/commander.js"
+import { CommandContext, DefaultIntl } from "../src/commander.js"
 import { AsyncResult } from "../src/lib.js"
 import { useExperimental } from "./stubs.js"
 
diff --git a/packages/vue/test/stubs.ts b/packages/vue/test/stubs.ts
@@ -6,11 +6,11 @@ import { ApiClientFactory, makeRpcClient } from "effect-app/client"
 import { RpcContextMap } from "effect-app/rpc"
 import * as FetchHttpClient from "effect/unstable/http/FetchHttpClient"
 import { ref } from "vue"
-import { Commander } from "../src/experimental/commander.js"
-import { I18n } from "../src/experimental/intl.js"
-import { makeUseCommand } from "../src/experimental/makeUseCommand.js"
-import * as Toast from "../src/experimental/toast.js"
-import { WithToast } from "../src/experimental/withToast.js"
+import { Commander } from "../src/commander.js"
+import { I18n } from "../src/intl.js"
+import { makeUseCommand } from "../src/makeUseCommand.js"
+import * as Toast from "../src/toast.js"
+import { WithToast } from "../src/withToast.js"
 import { LegacyMutation, makeClient } from "../src/makeClient.js"
 import { type MakeIntlReturn } from "../src/makeIntl.js"
 
diff --git a/wiki/ResourceClients.md b/wiki/ResourceClients.md
@@ -35,4 +35,4 @@ Each Command has a reactive `action` property, which is a formatted message base
 The `action` property can be used as button labels or titles, and will be used by the `Command.withDefaultToast()` implementation unless overriden.
 Each Toast stage can be further customised by adding messages with namespaced i18n keys for: `waiting`, `failure` and `success`
 e.g: `action.HelloWorld.SetState.waiting`.
-Various default copy lives in [DefaultIntl](../../../packages/vue/src/experimental/commander.ts)
+Various default copy lives in [DefaultIntl](../../../packages/vue/src/commander.ts)

Original file line number	Diff line number	Diff line change
`@@ -1685,7 +1685,7 @@ export class CommanderImpl<RT, RTHooks> {`
`1685`	`1685`	`}`
`1686`	`1686`	`)`
`1687`	`1687`
`1688`		`- /** @experimental @deprecated */`
	`1688`	`+ /** @deprecated */`
`1689`	`1689`	`alt2: <`
`1690`	`1690`	`const Id extends string,`
`1691`	`1691`	`MutArg,`
`@@ -1737,7 +1737,6 @@ export class CommanderImpl<RT, RTHooks> {`
`1737`	`1737`	`)), baseInfo) as any`
`1738`	`1738`	`}`
`1739`	`1739`
`1740`		`- /** @experimental */`
`1741`	`1740`	`alt = this.makeCommand as unknown as <`
`1742`	`1741`	`const Id extends string,`
`1743`	`1742`	`const I18nKey extends string = Id,`