effect-start 0.20.1 → 0.22.0

package/package.json

@@ -1,114 +1,113 @@
 {
   "name": "effect-start",
-  "version": "0.20.1",
-  "type": "module",
+  "version": "0.22.0",
   "license": "MIT",
+  "files": [
+    "src/",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "dist/",
+    "README.md",
+    "package.json"
+  ],
+  "type": "module",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
       "default": "./dist/index.js"
     },
     "./bun": {
-      "bun": "./src/bun/index.ts",
       "types": "./dist/bun/index.d.ts",
+      "bun": "./src/bun/index.ts",
       "default": "./dist/bun/index.js"
     },
     "./client": {
-      "bun": "./src/client/index.ts",
       "types": "./dist/client/index.d.ts",
+      "bun": "./src/client/index.ts",
       "default": "./dist/client/index.js"
     },
     "./testing": {
-      "bun": "./src/testing/index.ts",
       "types": "./dist/testing/index.d.ts",
+      "bun": "./src/testing/index.ts",
       "default": "./dist/testing/index.js"
     },
     "./x/*": {
-      "bun": "./src/x/*/index.ts",
       "types": "./dist/x/*/index.d.ts",
+      "bun": "./src/x/*/index.ts",
       "default": "./dist/x/*/index.js"
     },
     "./x/tailwind/plugin": {
-      "bun": "./src/x/tailwind/plugin.ts",
       "types": "./dist/x/tailwind/plugin.d.ts",
+      "bun": "./src/x/tailwind/plugin.ts",
       "default": "./dist/x/tailwind/plugin.js"
     },
-    "./middlewares": {
-      "bun": "./src/middlewares/index.ts",
-      "types": "./dist/middlewares/index.d.ts",
-      "default": "./dist/middlewares/index.js"
-    },
     "./Unique": {
-      "bun": "./src/Unique.ts",
       "types": "./dist/Unique.d.ts",
+      "bun": "./src/Unique.ts",
       "default": "./dist/Unique.js"
     },
     "./FileRouter": {
-      "bun": "./src/FileRouter.ts",
       "types": "./dist/FileRouter.d.ts",
+      "bun": "./src/FileRouter.ts",
       "default": "./dist/FileRouter.js"
     },
+    "./FileSystem": {
+      "types": "./dist/FileSystem.d.ts",
+      "bun": "./src/FileSystem.ts",
+      "default": "./dist/FileSystem.js"
+    },
     "./experimental": {
-      "bun": "./src/experimental/index.ts",
       "types": "./dist/experimental/index.d.ts",
+      "bun": "./src/experimental/index.ts",
       "default": "./dist/experimental/index.js"
     },
     "./client/assets.d.ts": "./src/assets.d.ts",
     "./hyper": {
-      "bun": "./src/hyper/index.ts",
       "types": "./dist/hyper/index.d.ts",
+      "bun": "./src/hyper/index.ts",
       "default": "./dist/hyper/index.js"
     },
     "./jsx-runtime": {
-      "bun": "./src/hyper/jsx-runtime.ts",
       "types": "./dist/hyper/jsx-runtime.d.ts",
+      "bun": "./src/hyper/jsx-runtime.ts",
       "default": "./dist/hyper/jsx-runtime.js"
     },
     "./jsx-dev-runtime": {
-      "bun": "./src/hyper/jsx-runtime.ts",
       "types": "./dist/hyper/jsx-runtime.d.ts",
+      "bun": "./src/hyper/jsx-runtime.ts",
       "default": "./dist/hyper/jsx-runtime.js"
     },
     "./datastar": {
-      "bun": "./src/datastar/index.ts",
       "types": "./dist/datastar/index.d.ts",
+      "bun": "./src/datastar/index.ts",
       "default": "./dist/datastar/index.js"
     },
+    "./lint/plugin": "./src/lint/plugin.js",
     "./package.json": "./package.json"
   },
   "scripts": {
     "build": "bunx --bun tsc -p tsconfig.build.json",
-    "format": "bunx dprint fmt",
+    "format": "bunx oxfmt",
+    "lint": "oxlint --import-plugin --tsconfig tsconfig.json src/",
     "test": "bun test ./src/",
     "deploy": "bunx --bun npm publish --access public"
   },
-  "peerDependencies": {
-    "effect": ">=3.19.0",
-    "@effect/platform": ">=0.93.0"
-  },
   "devDependencies": {
-    "typescript": "^5.9.3",
-    "@dprint/json": "^0.21.0",
-    "@dprint/markdown": "^0.20.0",
-    "@dprint/typescript": "^0.95.13",
     "@effect/language-service": "^0.62.3",
     "@types/bun": "^1.3.4",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
-    "dprint-cli": "^0.4.1",
-    "dprint-markup": "nounder/dprint-markup",
     "effect-memfs": "^0.8.0",
     "expect-type": "^1.3.0",
+    "oxfmt": "latest",
+    "oxlint": "^1.43.0",
     "tailwindcss": "^4.1.18",
-    "ts-namespace-import": "nounder/ts-namespace-import#140c405"
+    "ts-namespace-import": "nounder/ts-namespace-import#140c405",
+    "typescript": "^5.9.3"
   },
-  "files": [
-    "src/",
-    "!src/**/*.test.ts",
-    "!src/**/*.test.tsx",
-    "dist/",
-    "README.md",
-    "package.json"
-  ]
+  "peerDependencies": {
+    "@effect/platform": ">=0.93.0",
+    "effect": ">=3.19.0"
+  }
 }

package/src/Commander.ts

@@ -15,9 +15,11 @@ type KebabToCamel<S extends string> = S extends `${infer First}-${infer Rest}`
   ? `${First}${KebabToCamel<Capitalize<Rest>>}`
   : S
 
-type StripPrefix<S extends string> = S extends `--${infer Name}` ? Name
-  : S extends `-${infer Name}` ? Name
-  : S
+type StripPrefix<S extends string> = S extends `--${infer Name}`
+  ? Name
+  : S extends `-${infer Name}`
+    ? Name
+    : S
 
 type OptionNameToCamelCase<S extends string> = KebabToCamel<StripPrefix<S>>
 
@@ -31,15 +33,13 @@ export interface OptionBuilder<A = any, Name extends string = string> {
   readonly defaultValue?: A
 }
 
-type OptionBuilderWithSchema<A, Name extends string> =
-  & Omit<
-    OptionBuilder<A, Name>,
-    "schema" | "defaultValue"
-  >
-  & {
-    readonly schema: Schema.Schema<A, any>
-    readonly defaultValue?: A
-  }
+type OptionBuilderWithSchema<A, Name extends string> = Omit<
+  OptionBuilder<A, Name>,
+  "schema" | "defaultValue"
+> & {
+  readonly schema: Schema.Schema<A, any>
+  readonly defaultValue?: A
+}
 
 export const option = <
   const Long extends `--${string}`,
@@ -54,32 +54,24 @@ export const option = <
     schema: Schema.Schema<A, I>,
   ): OptionBuilderWithSchema<A, Long>
 
-  description(
-    desc: string,
-  ): {
+  description(desc: string): {
     schema<A, I extends string = string>(
       schema: Schema.Schema<A, I>,
     ): OptionBuilderWithSchema<A, Long>
 
-    default<A>(
-      value: A,
-    ): {
+    default<A>(value: A): {
       schema<A2 extends A, I extends string = string>(
         schema: Schema.Schema<A2, I>,
       ): OptionBuilderWithSchema<A2, Long>
     }
   }
 
-  default<A>(
-    value: A,
-  ): {
+  default<A>(value: A): {
     schema<A2 extends A, I extends string = string>(
       schema: Schema.Schema<A2, I>,
     ): OptionBuilderWithSchema<A2, Long>
 
-    description(
-      desc: string,
-    ): {
+    description(desc: string): {
       schema<A2 extends A, I extends string = string>(
         schema: Schema.Schema<A2, I>,
       ): OptionBuilderWithSchema<A2, Long>
@@ -110,9 +102,7 @@ export const option = <
       }),
 
       default: <A>(value: A) => ({
-        schema: <A2 extends A, I extends string = string>(
-          schema: Schema.Schema<A2, I>,
-        ) => ({
+        schema: <A2 extends A, I extends string = string>(schema: Schema.Schema<A2, I>) => ({
           _tag: "OptionBuilder" as const,
           name: longName,
           long: longName,
@@ -125,9 +115,7 @@ export const option = <
     }),
 
     default: <A>(value: A) => ({
-      schema: <A2 extends A, I extends string = string>(
-        schema: Schema.Schema<A2, I>,
-      ) => ({
+      schema: <A2 extends A, I extends string = string>(schema: Schema.Schema<A2, I>) => ({
         _tag: "OptionBuilder" as const,
         name: longName,
         long: longName,
@@ -138,9 +126,7 @@ export const option = <
       }),
 
       description: (desc) => ({
-        schema: <A2 extends A, I extends string = string>(
-          schema: Schema.Schema<A2, I>,
-        ) => ({
+        schema: <A2 extends A, I extends string = string>(schema: Schema.Schema<A2, I>) => ({
           _tag: "OptionBuilder" as const,
           name: longName,
           long: longName,
@@ -157,15 +143,12 @@ export const option = <
 export type OptionsMap = Record<string, OptionBuilder<any, any>>
 
 type ExtractOptionsFromBuilders<Opts extends OptionsMap> = {
-  [
-    K in keyof Opts as Opts[K] extends OptionBuilder<any, infer Name>
-      ? OptionNameToCamelCase<Name>
-      : never
-  ]: Opts[K] extends OptionBuilder<infer A, any> ? A : never
+  [K in keyof Opts as Opts[K] extends OptionBuilder<any, infer Name>
+    ? OptionNameToCamelCase<Name>
+    : never]: Opts[K] extends OptionBuilder<infer A, any> ? A : never
 }
 
-export type ExtractOptionValues<Opts extends OptionsMap> =
-  ExtractOptionsFromBuilders<Opts>
+export type ExtractOptionValues<Opts extends OptionsMap> = ExtractOptionsFromBuilders<Opts>
 
 export interface SubcommandDef<Handled extends boolean = boolean> {
   readonly _tag: "SubcommandDef"
@@ -177,13 +160,10 @@ type Extend<
   NewOpts extends OptionsMap,
   NewSubs extends ReadonlyArray<SubcommandDef> = [],
   Handled extends boolean = false,
-> = S extends CommanderSet<infer Opts, infer Subs, infer _H> ? CommanderSet<
-    & Opts
-    & NewOpts,
-    [...Subs, ...NewSubs],
-    Handled
-  >
-  : CommanderSet<NewOpts, NewSubs, Handled>
+> =
+  S extends CommanderSet<infer Opts, infer Subs, infer _H>
+    ? CommanderSet<Opts & NewOpts, [...Subs, ...NewSubs], Handled>
+    : CommanderSet<NewOpts, NewSubs, Handled>
 
 type CommanderBuilder = {
   option: typeof optionMethod
@@ -197,13 +177,10 @@ export type CommanderSet<
   Opts extends OptionsMap = {},
   Subcommands extends ReadonlyArray<SubcommandDef> = [],
   Handled extends boolean = false,
-> =
-  & Pipeable.Pipeable
-  & CommanderSet.Instance<Opts, Subcommands, Handled>
-  & {
+> = Pipeable.Pipeable &
+  CommanderSet.Instance<Opts, Subcommands, Handled> & {
     [TypeId]: typeof TypeId
-  }
-  & CommanderBuilder
+  } & CommanderBuilder
 
 export namespace CommanderSet {
   export type Instance<
@@ -229,16 +206,11 @@ export namespace CommanderSet {
   } & CommanderBuilder
 }
 
-const optionMethod = function<
-  S,
-  Opt extends OptionBuilder<any, any>,
->(
+const optionMethod = function <S, Opt extends OptionBuilder<any, any>>(
   this: S,
   opt: Opt,
 ): Extend<S, { [K in Opt["name"] as OptionNameToCamelCase<K>]: Opt }> {
-  const base = (this && typeof this === "object" ? this : {}) as Partial<
-    CommanderSet.Instance
-  >
+  const base = (this && typeof this === "object" ? this : {}) as Partial<CommanderSet.Instance>
   const baseName = base.name ?? ""
   const baseOptions: OptionsMap = base.options ?? {}
   const baseSubcommands = base.subcommands ?? []
@@ -256,12 +228,10 @@ const optionMethod = function<
   }) as Extend<S, { [K in Opt["name"] as OptionNameToCamelCase<K>]: Opt }>
 }
 
-export const optionHelp = function<S>(
+export const optionHelp = function <S>(
   this: S,
-): Extend<S, { "help": OptionBuilder<boolean, "--help"> }> {
-  const base = (this && typeof this === "object" ? this : {}) as Partial<
-    CommanderSet.Instance
-  >
+): Extend<S, { help: OptionBuilder<boolean, "--help"> }> {
+  const base = (this && typeof this === "object" ? this : {}) as Partial<CommanderSet.Instance>
   const baseName = base.name ?? ""
   const baseOptions: OptionsMap = base.options ?? {}
   const baseSubcommands = base.subcommands ?? []
@@ -283,15 +253,13 @@ export const optionHelp = function<S>(
     version: baseVersion,
     options: { ...baseOptions, help: helpOption },
     subcommands: baseSubcommands,
-  }) as Extend<S, { "help": OptionBuilder<boolean, "--help"> }>
+  }) as Extend<S, { help: OptionBuilder<boolean, "--help"> }>
 }
 
-export const optionVersion = function<S>(
+export const optionVersion = function <S>(
   this: S,
-): Extend<S, { "version": OptionBuilder<boolean, "--version"> }> {
-  const base = (this && typeof this === "object" ? this : {}) as Partial<
-    CommanderSet.Instance
-  >
+): Extend<S, { version: OptionBuilder<boolean, "--version"> }> {
+  const base = (this && typeof this === "object" ? this : {}) as Partial<CommanderSet.Instance>
   const baseName = base.name ?? ""
   const baseOptions: OptionsMap = base.options ?? {}
   const baseSubcommands = base.subcommands ?? []
@@ -313,10 +281,10 @@ export const optionVersion = function<S>(
     version: baseVersion,
     options: { ...baseOptions, version: versionOption },
     subcommands: baseSubcommands,
-  }) as Extend<S, { "version": OptionBuilder<boolean, "--version"> }>
+  }) as Extend<S, { version: OptionBuilder<boolean, "--version"> }>
 }
 
-export const subcommand = function<
+export const subcommand = function <
   S,
   SubOpts extends OptionsMap,
   SubSubs extends ReadonlyArray<SubcommandDef>,
@@ -325,9 +293,7 @@ export const subcommand = function<
   this: S,
   cmd: CommanderSet<SubOpts, SubSubs, SubHandled>,
 ): Extend<S, {}, [SubcommandDef<SubHandled>]> {
-  const base = (this && typeof this === "object" ? this : {}) as Partial<
-    CommanderSet.Instance
-  >
+  const base = (this && typeof this === "object" ? this : {}) as Partial<CommanderSet.Instance>
   const baseName = base.name ?? ""
   const baseOptions = base.options ?? {}
   const baseSubcommands = base.subcommands ?? []
@@ -348,10 +314,7 @@ export const subcommand = function<
   }) as Extend<S, {}, [SubcommandDef<SubHandled>]>
 }
 
-export const handle = function<
-  Opts extends OptionsMap,
-  Subs extends ReadonlyArray<SubcommandDef>,
->(
+export const handle = function <Opts extends OptionsMap, Subs extends ReadonlyArray<SubcommandDef>>(
   this: CommanderSet<Opts, Subs, false>,
   handler: (args: ExtractOptionValues<Opts>) => Effect.Effect<void>,
 ): CommanderSet<Opts, Subs, true> {
@@ -406,15 +369,10 @@ function makeSet<
   readonly subcommands: Subs
   readonly handler?: (args: ExtractOptionValues<Opts>) => Effect.Effect<void>
 }): CommanderSet<Opts, Subs, Handled> {
-  return Object.assign(
-    Object.create(CommanderProto),
-    config,
-  ) as CommanderSet<Opts, Subs, Handled>
+  return Object.assign(Object.create(CommanderProto), config) as CommanderSet<Opts, Subs, Handled>
 }
 
-export function isCommanderSet(
-  input: unknown,
-): input is CommanderSet<any, any, any> {
+export function isCommanderSet(input: unknown): input is CommanderSet<any, any, any> {
   return Predicate.hasProperty(input, TypeId)
 }
 
@@ -434,10 +392,8 @@ interface ParsedArgs {
   readonly positional: ReadonlyArray<string>
 }
 
-const parseRawArgs = (
-  args: ReadonlyArray<string>,
-): Effect.Effect<ParsedArgs, CommanderError> =>
-  Effect.gen(function*() {
+const parseRawArgs = (args: ReadonlyArray<string>): Effect.Effect<ParsedArgs, CommanderError> =>
+  Effect.gen(function* () {
     const flags: Record<string, boolean> = {}
     const options: Record<string, string> = {}
     const positional: Array<string> = []
@@ -470,10 +426,7 @@ const parseRawArgs = (
         const chars = arg.slice(1)
         for (let j = 0; j < chars.length; j++) {
           const char = chars[j]!
-          if (
-            j === chars.length - 1 && i + 1 < args.length && !args[i + 1]!
-              .startsWith("-")
-          ) {
+          if (j === chars.length - 1 && i + 1 < args.length && !args[i + 1]!.startsWith("-")) {
             options[char] = args[i + 1]!
             i++
           } else {
@@ -498,7 +451,7 @@ export const parse = <
   cmd: CommanderSet<Opts, Subs, Handled>,
   args: ReadonlyArray<string>,
 ): Effect.Effect<ExtractOptionValues<Opts>, CommanderError> =>
-  Effect.gen(function*() {
+  Effect.gen(function* () {
     const parsed = yield* parseRawArgs(args)
 
     const result: Record<string, any> = {}
@@ -509,7 +462,7 @@ export const parse = <
 
       const longMatch = parsed.options[longName] || parsed.flags[longName]
       const shortMatch = shortName
-        ? (parsed.options[shortName] || parsed.flags[shortName])
+        ? parsed.options[shortName] || parsed.flags[shortName]
         : undefined
 
       const rawValue = longMatch ?? shortMatch
@@ -520,18 +473,15 @@ export const parse = <
         if (typeof rawValue === "boolean") {
           result[camelKey] = rawValue
         } else if (optBuilder.schema) {
-          const decoded = yield* Schema
-            .decode(optBuilder.schema)(rawValue)
-            .pipe(
-              Effect.mapError(
-                (error) =>
-                  new CommanderError({
-                    message:
-                      `Invalid value for option ${optBuilder.long}: ${error.message}`,
-                    cause: error,
-                  }),
-              ),
-            )
+          const decoded = yield* Schema.decode(optBuilder.schema)(rawValue).pipe(
+            Effect.mapError(
+              (error) =>
+                new CommanderError({
+                  message: `Invalid value for option ${optBuilder.long}: ${error.message}`,
+                  cause: error,
+                }),
+            ),
+          )
           result[camelKey] = decoded
         } else {
           result[camelKey] = rawValue
@@ -544,13 +494,10 @@ export const parse = <
     return result as ExtractOptionValues<Opts>
   })
 
-export const runMain = <
-  Opts extends OptionsMap,
-  Subs extends ReadonlyArray<SubcommandDef>,
->(
+export const runMain = <Opts extends OptionsMap, Subs extends ReadonlyArray<SubcommandDef>>(
   cmd: CommanderSet<Opts, Subs, true>,
 ): Effect.Effect<void, CommanderError> =>
-  Effect.gen(function*() {
+  Effect.gen(function* () {
     const args = typeof process !== "undefined" ? process.argv.slice(2) : []
 
     const parsedOptions = yield* parse(cmd, args)
@@ -560,11 +507,7 @@ export const runMain = <
       return
     }
 
-    if (
-      Predicate.hasProperty(parsedOptions, "version")
-      && parsedOptions.version
-      && cmd.version
-    ) {
+    if (Predicate.hasProperty(parsedOptions, "version") && parsedOptions.version && cmd.version) {
       console.log(`${cmd.name} v${cmd.version}`)
       return
     }
@@ -578,7 +521,9 @@ const generateHelp = <
   Opts extends OptionsMap,
   Subs extends ReadonlyArray<SubcommandDef>,
   Handled extends boolean,
->(cmd: CommanderSet<Opts, Subs, Handled>): string => {
+>(
+  cmd: CommanderSet<Opts, Subs, Handled>,
+): string => {
   const lines: Array<string> = []
 
   if (cmd.description) {
@@ -620,7 +565,9 @@ export const help = <
   Opts extends OptionsMap,
   Subs extends ReadonlyArray<SubcommandDef>,
   Handled extends boolean,
->(cmd: CommanderSet<Opts, Subs, Handled>): string => generateHelp(cmd)
+>(
+  cmd: CommanderSet<Opts, Subs, Handled>,
+): string => generateHelp(cmd)
 
 export const NumberFromString = Schema.NumberFromString
 
@@ -631,12 +578,8 @@ export const choice = <const Choices extends ReadonlyArray<string>>(
 export const repeatable = <A>(
   schema: Schema.Schema<A, string>,
 ): Schema.Schema<ReadonlyArray<A>, string> =>
-  Schema
-    .transform(Schema.String, Schema.Array(Schema.String), {
-      strict: true,
-      decode: (s) => s.split(",").map((part) => part.trim()),
-      encode: (arr) => arr.join(","),
-    })
-    .pipe(
-      Schema.compose(Schema.Array(schema)),
-    )
+  Schema.transform(Schema.String, Schema.Array(Schema.String), {
+    strict: true,
+    decode: (s) => s.split(",").map((part) => part.trim()),
+    encode: (arr) => arr.join(","),
+  }).pipe(Schema.compose(Schema.Array(schema)))