@effect-vfs/core 0.8.0 → 0.10.0

package/dist/LiveVolume.js

@@ -8,12 +8,14 @@
  *
  * @since 0.4.0
  */
-import { Context, Effect } from "effect";
+import { Context, Deferred, Duration, Effect, Layer, MutableHashMap, Option, RcMap, Schema } from "effect";
 import * as ByteSize from "effect/ByteSize";
-import { argumentFailure, retargetFailure } from "./internal/errors.js";
+import { Errors } from "./internal/engine.js";
+import { retargetFailure } from "./internal/errors.js";
 import * as Model from "./internal/virtualFileSystem.js";
 import * as Limits from "./internal/volumeLimits.js";
 import { VfsError } from "./VfsError.js";
+const { argumentFailure, decodeConfiguration } = Errors;
 /**
  * One exclusively owned store. Its Layer holds the storage resource until the
  * volume has shut down. Providers must atomically replace each image and
@@ -32,10 +34,12 @@ export class LiveImageStore extends Context.Service()("@effect-vfs/core/LiveImag
  * @category constructors
  * @since 0.4.0
  */
-export const open = Effect.fn("LiveVolume.open")(function* (options) {
+export const open = Effect.fnUntraced(function* (options) {
     const store = yield* LiveImageStore;
     const { decoded, initial } = yield* Effect.gen(function* () {
         const decoded = yield* Effect.fromResult(Limits.configuration(options.volume, "LiveVolume.open"));
+        if (decoded.options.execution === "sync")
+            return yield* argumentFailure("LiveVolume.open", "execution");
         const initial = yield* prepareEmptyImage(decoded.options);
         return { decoded, initial };
     }).pipe(
@@ -57,6 +61,86 @@ export const open = Effect.fn("LiveVolume.open")(function* (options) {
     }
     return volume;
 });
+const RegistryCapacity = Schema.Int.check(Schema.isGreaterThanOrEqualTo(1));
+/**
+ * Lazily share one live volume and its store per key through `RcMap`. Concurrent
+ * borrowers share acquisition. Reusing an idle entry avoids rebuilding its store
+ * and decoding its image, while retaining its memory and storage locks.
+ *
+ * The registry's owning scope must outlive all borrowers. Closing it shuts down
+ * every volume, including borrowed ones, before releasing their store Layers.
+ * Capacity exhaustion fails with `Cause.ExceededCapacityError`; it does not evict
+ * idle entries. Acquisition failures remain shared until the entry is released.
+ *
+ * Invalidation is intentionally unavailable: acquiring a replacement while an
+ * existing borrower remains would violate exclusive store ownership. Canonicalize
+ * keys before borrowing and use one registry for each set of backing stores.
+ *
+ * @example
+ * ```ts
+ * import { LiveVolume } from "@effect-vfs/core"
+ * import { ByteSize, Effect, Layer } from "effect"
+ *
+ * declare const storeFor: (key: string) => Layer.Layer<LiveVolume.LiveImageStore>
+ *
+ * const program = Effect.gen(function*() {
+ *   const registry = yield* LiveVolume.makeRegistry({
+ *     store: storeFor,
+ *     volume: { maxImageBytes: ByteSize.megabytes(1), volume: {} },
+ *     capacity: 8,
+ *     idleTimeToLive: "5 seconds"
+ *   })
+ *   return yield* Effect.scoped(Effect.gen(function*() {
+ *     const volume = yield* registry.get("workspace")
+ *     return yield* (yield* volume.caller()).readFile("/plan.md")
+ *   }))
+ * })
+ * ```
+ *
+ * @category constructors
+ * @since 0.9.0
+ */
+export const makeRegistry = Effect.fnUntraced(function* (options) {
+    const capacity = options.capacity === undefined
+        ? Infinity
+        : yield* Effect.fromResult(decodeConfiguration(RegistryCapacity, options.capacity, "LiveVolume.makeRegistry")).pipe(Effect.mapError((cause) => argumentFailure("LiveVolume.makeRegistry", "capacity", cause)));
+    const idleTimeToLive = Duration.fromInput(options.idleTimeToLive ?? 0);
+    if (Option.isNone(idleTimeToLive))
+        return yield* argumentFailure("LiveVolume.makeRegistry", "idleTimeToLive");
+    if (options.volume.volume.execution === "sync") {
+        return yield* argumentFailure("LiveVolume.makeRegistry", "volume.volume.execution");
+    }
+    const store = options.store;
+    const volume = { maxImageBytes: options.volume.maxImageBytes, volume: { ...options.volume.volume } };
+    const retiring = MutableHashMap.empty();
+    const volumes = yield* RcMap.make({
+        lookup: Effect.fnUntraced(function* (key) {
+            // RcMap removes an entry before its asynchronous finalizers finish. Keep
+            // equal keys waiting until both the volume and its store have shut down.
+            yield* Effect.uninterruptibleMask((restore) => Effect.gen(function* () {
+                let previous = MutableHashMap.get(retiring, key);
+                while (Option.isSome(previous)) {
+                    yield* restore(Deferred.await(previous.value));
+                    previous = MutableHashMap.get(retiring, key);
+                }
+                const released = yield* Deferred.make();
+                MutableHashMap.set(retiring, key, released);
+                // Registered first, this runs after the store and volume finalizers.
+                yield* Effect.addFinalizer(() => Effect.gen(function* () {
+                    MutableHashMap.remove(retiring, key);
+                    yield* Deferred.succeed(released, undefined);
+                }));
+            }));
+            // A parent Layer memo must not keep a retired store alive or share its
+            // mutable ownership state with a different volume entry.
+            const services = yield* Layer.build(Layer.fresh(store(key)));
+            return yield* open(volume).pipe(Effect.provideService(LiveImageStore, Context.get(services, LiveImageStore)));
+        }),
+        capacity,
+        idleTimeToLive: idleTimeToLive.value
+    });
+    return { get: (key) => RcMap.get(volumes, key) };
+});
 /**
  * Construct a versioned image for a new, empty volume.
  * Store this image before opening it for mutation.

package/dist/Search.d.ts

@@ -602,7 +602,10 @@ export type ScanContentFailure = ContentFailure | BudgetExceeded;
  * @category operations
  * @since 0.8.0
  */
-export declare const scanGlob: (snapshot: Snapshot, query: GlobQuery) => Stream.Stream<string, ScanGlobFailure>;
+export declare const scanGlob: {
+    (query: GlobQuery): (snapshot: Snapshot) => Stream.Stream<string, ScanGlobFailure>;
+    (snapshot: Snapshot, query: GlobQuery): Stream.Stream<string, ScanGlobFailure>;
+};
 /**
  * Collect bounded matches and preserve preceding rows when a work or output
  * budget stops the query. Invalid queries, malformed patterns and snapshot
@@ -636,7 +639,10 @@ export declare const scanGlob: (snapshot: Snapshot, query: GlobQuery) => Stream.
  * @category operations
  * @since 0.8.0
  */
-export declare const glob: (snapshot: Snapshot, query: GlobQuery) => Effect.Effect<GlobReport, GlobFailure>;
+export declare const glob: {
+    (query: GlobQuery): (snapshot: Snapshot) => Effect.Effect<GlobReport, GlobFailure>;
+    (snapshot: Snapshot, query: GlobQuery): Effect.Effect<GlobReport, GlobFailure>;
+};
 /**
  * Stream one result per matching line after classifying the complete file for
  * strict UTF-8 and NUL. Each row contains the first whole-match byte range and
@@ -670,7 +676,10 @@ export declare const glob: (snapshot: Snapshot, query: GlobQuery) => Effect.Effe
  * @category operations
  * @since 0.8.0
  */
-export declare const scanLines: (snapshot: Snapshot, query: ContentQuery) => Stream.Stream<LineResult, ScanContentFailure>;
+export declare const scanLines: {
+    (query: ContentQuery): (snapshot: Snapshot) => Stream.Stream<LineResult, ScanContentFailure>;
+    (snapshot: Snapshot, query: ContentQuery): Stream.Stream<LineResult, ScanContentFailure>;
+};
 /**
  * Collect matching lines, preceding rows, skips, work and completion. Catch only
  * budget exhaustion; query, pattern and snapshot failures remain typed failures,
@@ -685,7 +694,10 @@ export declare const scanLines: (snapshot: Snapshot, query: ContentQuery) => Str
  * @category operations
  * @since 0.8.0
  */
-export declare const lines: (snapshot: Snapshot, query: ContentQuery) => Effect.Effect<LinesReport, ContentFailure>;
+export declare const lines: {
+    (query: ContentQuery): (snapshot: Snapshot) => Effect.Effect<LinesReport, ContentFailure>;
+    (snapshot: Snapshot, query: ContentQuery): Effect.Effect<LinesReport, ContentFailure>;
+};
 /**
  * Stream one root-relative filename per matching regular-file path. Classify
  * the complete file before testing lines and stop matching after the first hit.
@@ -695,7 +707,10 @@ export declare const lines: (snapshot: Snapshot, query: ContentQuery) => Effect.
  * @category operations
  * @since 0.8.0
  */
-export declare const scanFiles: (snapshot: Snapshot, query: ContentQuery) => Stream.Stream<string, ScanContentFailure>;
+export declare const scanFiles: {
+    (query: ContentQuery): (snapshot: Snapshot) => Stream.Stream<string, ScanContentFailure>;
+    (snapshot: Snapshot, query: ContentQuery): Stream.Stream<string, ScanContentFailure>;
+};
 /**
  * Collect matching filenames with preceding rows, work, skips and completion.
  * Shares text classification and matching with `lines`, but evaluates only as
@@ -705,7 +720,10 @@ export declare const scanFiles: (snapshot: Snapshot, query: ContentQuery) => Str
  * @category operations
  * @since 0.8.0
  */
-export declare const files: (snapshot: Snapshot, query: ContentQuery) => Effect.Effect<FilesReport, ContentFailure>;
+export declare const files: {
+    (query: ContentQuery): (snapshot: Snapshot) => Effect.Effect<FilesReport, ContentFailure>;
+    (snapshot: Snapshot, query: ContentQuery): Effect.Effect<FilesReport, ContentFailure>;
+};
 /**
  * Stream exact matching-line counts for completely scanned matching files.
  * Multiple occurrences on one line count once. A stopped file emits no partial
@@ -715,7 +733,10 @@ export declare const files: (snapshot: Snapshot, query: ContentQuery) => Effect.
  * @category operations
  * @since 0.8.0
  */
-export declare const scanCountLines: (snapshot: Snapshot, query: ContentQuery) => Stream.Stream<CountResult, ScanContentFailure>;
+export declare const scanCountLines: {
+    (query: ContentQuery): (snapshot: Snapshot) => Stream.Stream<CountResult, ScanContentFailure>;
+    (snapshot: Snapshot, query: ContentQuery): Stream.Stream<CountResult, ScanContentFailure>;
+};
 /**
  * Collect exact per-file matching-line counts with work, skips and completion.
  * A stopped or skipped query's summed counts are lower bounds for its original
@@ -725,6 +746,9 @@ export declare const scanCountLines: (snapshot: Snapshot, query: ContentQuery) =
  * @category operations
  * @since 0.8.0
  */
-export declare const countLines: (snapshot: Snapshot, query: ContentQuery) => Effect.Effect<CountLinesReport, ContentFailure>;
+export declare const countLines: {
+    (query: ContentQuery): (snapshot: Snapshot) => Effect.Effect<CountLinesReport, ContentFailure>;
+    (snapshot: Snapshot, query: ContentQuery): Effect.Effect<CountLinesReport, ContentFailure>;
+};
 export {};
 //# sourceMappingURL=Search.d.ts.map

package/dist/Search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Search.d.ts","sourceRoot":"","sources":["../src/Search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Search.d.ts","sourceRoot":"","sources":["../src/Search.ts"],"names":[],"mappings":"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"}

package/dist/Search.js

@@ -10,6 +10,7 @@
  */
 import * as ByteSize from "effect/ByteSize";
 import * as Effect from "effect/Effect";
+import { dual } from "effect/Function";
 import * as Schema from "effect/Schema";
 import * as Stream from "effect/Stream";
 import { BytePath } from "./BytePath.js";
@@ -400,10 +401,10 @@ const evaluate = Effect.fnUntraced(function* (snapshot, input) {
  * @category operations
  * @since 0.8.0
  */
-export const scanGlob = (snapshot, query) => Stream.unwrap(Effect.map(evaluate(snapshot, query), ({ next }) => Stream.unfold(undefined, Effect.fnUntraced(function* () {
+export const scanGlob = dual(2, (snapshot, query) => Stream.unwrap(Effect.map(evaluate(snapshot, query), ({ next }) => Stream.unfold(undefined, Effect.fnUntraced(function* () {
     const row = yield* next();
     return row === undefined ? undefined : [row, undefined];
-}))));
+})))));
 /**
  * Collect bounded matches and preserve preceding rows when a work or output
  * budget stops the query. Invalid queries, malformed patterns and snapshot
@@ -437,7 +438,7 @@ export const scanGlob = (snapshot, query) => Stream.unwrap(Effect.map(evaluate(s
  * @category operations
  * @since 0.8.0
  */
-export const glob = Effect.fn("Search.glob")(function* (snapshot, query) {
+export const glob = dual(2, Effect.fnUntraced(function* (snapshot, query) {
     const evaluation = yield* evaluate(snapshot, query);
     const results = [];
     const completion = yield* Effect.gen(function* () {
@@ -454,7 +455,7 @@ export const glob = Effect.fn("Search.glob")(function* (snapshot, query) {
         skips: { ...evaluation.meter.skips },
         completion
     };
-});
+}));
 const scanContent = (snapshot, query, mode) => Stream.unwrap(Effect.map(Content.evaluate(snapshot, query, mode), ({ next }) => Stream.unfold(undefined, Effect.fnUntraced(function* () {
     const row = yield* next();
     return row === undefined ? undefined : [row, undefined];
@@ -510,7 +511,7 @@ const collectContent = Effect.fnUntraced(function* (snapshot, query, mode) {
  * @category operations
  * @since 0.8.0
  */
-export const scanLines = (snapshot, query) => scanContent(snapshot, query, "lines");
+export const scanLines = dual(2, (snapshot, query) => scanContent(snapshot, query, "lines"));
 /**
  * Collect matching lines, preceding rows, skips, work and completion. Catch only
  * budget exhaustion; query, pattern and snapshot failures remain typed failures,
@@ -525,7 +526,10 @@ export const scanLines = (snapshot, query) => scanContent(snapshot, query, "line
  * @category operations
  * @since 0.8.0
  */
-export const lines = Effect.fn("Search.lines")((snapshot, query) => collectContent(snapshot, query, "lines"));
+export const lines = dual(2, Effect
+    .fnUntraced(function* (snapshot, query) {
+    return yield* collectContent(snapshot, query, "lines");
+}));
 /**
  * Stream one root-relative filename per matching regular-file path. Classify
  * the complete file before testing lines and stop matching after the first hit.
@@ -535,7 +539,7 @@ export const lines = Effect.fn("Search.lines")((snapshot, query) => collectConte
  * @category operations
  * @since 0.8.0
  */
-export const scanFiles = (snapshot, query) => scanContent(snapshot, query, "files");
+export const scanFiles = dual(2, (snapshot, query) => scanContent(snapshot, query, "files"));
 /**
  * Collect matching filenames with preceding rows, work, skips and completion.
  * Shares text classification and matching with `lines`, but evaluates only as
@@ -545,7 +549,10 @@ export const scanFiles = (snapshot, query) => scanContent(snapshot, query, "file
  * @category operations
  * @since 0.8.0
  */
-export const files = Effect.fn("Search.files")((snapshot, query) => collectContent(snapshot, query, "files"));
+export const files = dual(2, Effect
+    .fnUntraced(function* (snapshot, query) {
+    return yield* collectContent(snapshot, query, "files");
+}));
 /**
  * Stream exact matching-line counts for completely scanned matching files.
  * Multiple occurrences on one line count once. A stopped file emits no partial
@@ -555,7 +562,7 @@ export const files = Effect.fn("Search.files")((snapshot, query) => collectConte
  * @category operations
  * @since 0.8.0
  */
-export const scanCountLines = (snapshot, query) => scanContent(snapshot, query, "countLines");
+export const scanCountLines = dual(2, (snapshot, query) => scanContent(snapshot, query, "countLines"));
 /**
  * Collect exact per-file matching-line counts with work, skips and completion.
  * A stopped or skipped query's summed counts are lower bounds for its original
@@ -565,4 +572,6 @@ export const scanCountLines = (snapshot, query) => scanContent(snapshot, query,
  * @category operations
  * @since 0.8.0
  */
-export const countLines = Effect.fn("Search.countLines")((snapshot, query) => collectContent(snapshot, query, "countLines"));
+export const countLines = dual(2, Effect.fnUntraced(function* (snapshot, query) {
+    return yield* collectContent(snapshot, query, "countLines");
+}));

package/dist/SynchronousAdapter.d.ts

@@ -0,0 +1,58 @@
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import type { MkdirOptions, OpenOptions } from "./Caller.js";
+import type { Metadata, OwnerUpdate, Times } from "./Metadata.js";
+import type { Caller, FsFailure, TargetInput, Volume } from "./VirtualFileSystem.js";
+/**
+ * A private-scope handle. Explicit close checks reentry before touching its scope.
+ * @since 0.10.0
+ */
+export interface Handle {
+    readonly closed: boolean;
+    readonly directory: boolean;
+    readonly stat: () => Metadata;
+    readonly read: (length: number, position: bigint) => Uint8Array;
+    readonly write: (bytes: Uint8Array, position: bigint, append: boolean) => number;
+    readonly truncate: (length: bigint) => void;
+    readonly chmod: (mode: number) => void;
+    readonly chown: (owner: OwnerUpdate) => void;
+    readonly utimes: (times: Times) => void;
+    readonly sync: () => void;
+    readonly close: () => void;
+}
+/**
+ * Synchronous filesystem operations. Failures throw the core FsFailure value.
+ * @since 0.10.0
+ */
+export interface Binding {
+    readonly stat: (target: TargetInput) => Metadata;
+    readonly readDirectory: (path: string) => Effect.Success<ReturnType<Caller["readDirectory"]>>;
+    readonly readLink: (path: string) => Uint8Array;
+    readonly realPath: (path: string) => Uint8Array;
+    readonly access: (path: string, bits: number) => number;
+    readonly mkdir: (path: string, options?: MkdirOptions) => void;
+    readonly rmdir: (path: string) => void;
+    readonly unlink: (path: string) => void;
+    readonly rename: (from: string, to: string) => void;
+    readonly link: (from: TargetInput, to: string) => void;
+    readonly symlink: (target: string, path: string) => void;
+    readonly chmod: (target: TargetInput, mode: number) => void;
+    readonly chown: (target: TargetInput, owner: OwnerUpdate) => void;
+    readonly utimes: (target: TargetInput, times: Times) => void;
+    readonly open: (path: string, options: OpenOptions, noFollow: boolean, directory: boolean) => Handle;
+}
+/**
+ * Binds only constructor-qualified synchronous memory volumes. The scope owns all opened handles.
+ * No arbitrary Effect can be submitted to this binding.
+ * @since 0.10.0
+ */
+export declare const bind: (volume: Volume, options?: {
+    readonly identity?: {
+        readonly uid: number;
+        readonly gid: number;
+        readonly groups: readonly number[];
+        readonly privileged: boolean;
+    };
+    readonly umask?: number;
+} | undefined) => Effect.Effect<Binding, FsFailure, Scope.Scope>;
+//# sourceMappingURL=SynchronousAdapter.d.ts.map

package/dist/SynchronousAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SynchronousAdapter.d.ts","sourceRoot":"","sources":["../src/SynchronousAdapter.ts"],"names":[],"mappings":"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"}

package/dist/SynchronousAdapter.js

@@ -0,0 +1,116 @@
+// These callbacks implement a checked native boundary with fresh synchronous fibers.
+/* eslint-disable effecttsgo/run-effect-inside-effect */
+/**
+ * Checked synchronous operations for native adapters over an existing memory volume.
+ * This adapter contract is versioned with core. Volumes from another package copy are rejected.
+ * @since 0.10.0
+ */
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Result from "effect/Result";
+import * as Scheduler from "effect/Scheduler";
+import * as Scope from "effect/Scope";
+import { engineOf } from "./internal/adapterBinding.js";
+import { Errors, Paths } from "./internal/engine.js";
+/**
+ * Binds only constructor-qualified synchronous memory volumes. The scope owns all opened handles.
+ * No arbitrary Effect can be submitted to this binding.
+ * @since 0.10.0
+ */
+export const bind = Effect.fnUntraced(function* (volume, options) {
+    const engine = engineOf(volume);
+    const checked = engine?.syncBinding;
+    if (engine === undefined || checked === undefined)
+        return yield* Errors.argumentFailure("bind", "volume");
+    yield* Effect.fromResult(checked.check("bind"));
+    const context = yield* engine.context(options);
+    const operations = context.operations;
+    const parent = yield* Effect.scope;
+    let closed = false;
+    yield* Scope.addFinalizer(parent, Effect.sync(() => {
+        closed = true;
+    }));
+    const run = (operation, effect) => {
+        if (closed)
+            throw Errors.fsFailure("ClosedCaller", operation);
+        const available = checked.check(operation);
+        if (Result.isFailure(available))
+            throw available.failure;
+        const exit = Effect.runSyncExit(Effect.provideService(effect, Scheduler.PreventSchedulerYield, true));
+        if (Exit.isFailure(exit))
+            throw Cause.squash(exit.cause);
+        return exit.value;
+    };
+    const open = (path, options, noFollow, directory) => {
+        // Preflight must precede even scope allocation. A rejected reentrant close/open owns no resources.
+        run("open", Effect.void);
+        const scope = Scope.forkUnsafe(parent);
+        const target = { _tag: "Path", path, followFinalSymlink: !noFollow };
+        const acquire = directory
+            ? operations.openDirectory(target)
+            : operations.open(target, options);
+        const acquired = Effect.runSyncExit(Effect.provideService(Effect.provideService(acquire, Scope.Scope, scope), Scheduler.PreventSchedulerYield, true));
+        if (Exit.isFailure(acquired)) {
+            Effect.runSync(Scope.close(scope, Exit.void));
+            throw Cause.squash(acquired.cause);
+        }
+        const handle = acquired.value;
+        let released = false;
+        Effect.runSync(Scope.addFinalizer(scope, Effect.sync(() => {
+            released = true;
+        })));
+        const file = () => {
+            if (!("pread" in handle))
+                throw Errors.fsFailure("IsDirectory", "read");
+            return handle;
+        };
+        return Object.freeze({
+            get closed() {
+                return released;
+            },
+            directory,
+            stat: () => run("fstat", handle.stat),
+            read: (length, position) => run("read", Effect.map(file().pread(length, position), (value) => value.bytes)),
+            write: (bytes, position, append) => run("write", append ? file().write(bytes) : file().pwrite(bytes, position)),
+            truncate: (length) => run("ftruncate", file().truncate(length)),
+            chmod: (mode) => run("fchmod", operations.chmod(handle, mode)),
+            chown: (owner) => run("fchown", operations.chown(handle, owner)),
+            utimes: (times) => run("futimes", operations.utimes(handle, times)),
+            sync: () => run("fsync", directory ? Effect.asVoid(handle.stat) : file().sync),
+            close: () => {
+                run("close", handle.close);
+                Effect.runSync(Scope.close(scope, Exit.void));
+            }
+        });
+    };
+    return Object.freeze({
+        stat: (target) => run("stat", operations.stat(target)),
+        readDirectory: (path) => run("readdir", operations.readDirectory(path)),
+        readLink: (path) => run("readlink", operations.readLink(path)),
+        realPath: (path) => run("realpath", Effect.flatMap(operations.realPath(path), Paths.pathToBytes)),
+        access: (path, bits) => run("access", operations.access(path, bits)),
+        mkdir: (path, options) => {
+            run("mkdir", operations.mkdir(path, options));
+        },
+        rmdir: (path) => {
+            run("rmdir", operations.rmdir(path));
+        },
+        unlink: (path) => {
+            run("unlink", operations.unlink(path));
+        },
+        rename: (from, to) => {
+            run("rename", operations.rename(from, to));
+        },
+        link: (from, to) => {
+            run("link", operations.link(from, to));
+        },
+        symlink: (target, path) => {
+            run("symlink", operations.symlink(target, path));
+        },
+        chmod: (target, mode) => run("chmod", operations.chmod(target, mode)),
+        chown: (target, owner) => run("chown", operations.chown(target, owner)),
+        utimes: (target, times) => run("utimes", operations.utimes(target, times)),
+        open
+    });
+});

package/dist/Target.d.ts

@@ -6,8 +6,8 @@
  *
  * @since 0.6.0
  */
-import * as Data from "effect/Data";
-import * as Schema from "effect/Schema";
+import type * as Data from "effect/Data";
+import type * as Schema from "effect/Schema";
 import type { DirectoryHandle, FileHandle, ObjectReference, PathInput } from "./VirtualFileSystem.js";
 /**
  * A target: a path resolved from the caller's working directory or a base
@@ -31,92 +31,6 @@ export type Target = Data.TaggedEnum<{
         readonly handle: FileHandle | DirectoryHandle;
     };
 }>;
-declare const enumeration: {
-    readonly $is: <Tag extends "Handle" | "Path" | "Reference">(tag: Tag) => (u: unknown) => u is Extract<{
-        readonly _tag: "Handle";
-        readonly handle: FileHandle | DirectoryHandle;
-    }, {
-        readonly _tag: Tag;
-    }> | Extract<{
-        readonly _tag: "Path";
-        readonly path: PathInput;
-        readonly relativeTo?: DirectoryHandle;
-        readonly followFinalSymlink?: boolean;
-    }, {
-        readonly _tag: Tag;
-    }> | Extract<{
-        readonly _tag: "Reference";
-        readonly reference: ObjectReference;
-    }, {
-        readonly _tag: Tag;
-    }>;
-    readonly $match: {
-        <Cases extends { readonly [Tag in "Handle" | "Path" | "Reference"]: (args: Extract<{
-            readonly _tag: "Handle";
-            readonly handle: FileHandle | DirectoryHandle;
-        } | {
-            readonly _tag: "Path";
-            readonly path: PathInput;
-            readonly relativeTo?: DirectoryHandle;
-            readonly followFinalSymlink?: boolean;
-        } | {
-            readonly _tag: "Reference";
-            readonly reference: ObjectReference;
-        }, {
-            readonly _tag: Tag;
-        }>) => any; }>(cases: Cases): (value: {
-            readonly _tag: "Handle";
-            readonly handle: FileHandle | DirectoryHandle;
-        } | {
-            readonly _tag: "Path";
-            readonly path: PathInput;
-            readonly relativeTo?: DirectoryHandle;
-            readonly followFinalSymlink?: boolean;
-        } | {
-            readonly _tag: "Reference";
-            readonly reference: ObjectReference;
-        }) => import("effect/Unify").Unify<ReturnType<Cases["Handle" | "Path" | "Reference"]>>;
-        <Cases extends { readonly [Tag in "Handle" | "Path" | "Reference"]: (args: Extract<{
-            readonly _tag: "Handle";
-            readonly handle: FileHandle | DirectoryHandle;
-        } | {
-            readonly _tag: "Path";
-            readonly path: PathInput;
-            readonly relativeTo?: DirectoryHandle;
-            readonly followFinalSymlink?: boolean;
-        } | {
-            readonly _tag: "Reference";
-            readonly reference: ObjectReference;
-        }, {
-            readonly _tag: Tag;
-        }>) => any; }>(value: {
-            readonly _tag: "Handle";
-            readonly handle: FileHandle | DirectoryHandle;
-        } | {
-            readonly _tag: "Path";
-            readonly path: PathInput;
-            readonly relativeTo?: DirectoryHandle;
-            readonly followFinalSymlink?: boolean;
-        } | {
-            readonly _tag: "Reference";
-            readonly reference: ObjectReference;
-        }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Handle" | "Path" | "Reference"]>>;
-    };
-    readonly Handle: Data.TaggedEnum.ConstructorFrom<{
-        readonly _tag: "Handle";
-        readonly handle: FileHandle | DirectoryHandle;
-    }, "_tag">;
-    readonly Path: Data.TaggedEnum.ConstructorFrom<{
-        readonly _tag: "Path";
-        readonly path: PathInput;
-        readonly relativeTo?: DirectoryHandle;
-        readonly followFinalSymlink?: boolean;
-    }, "_tag">;
-    readonly Reference: Data.TaggedEnum.ConstructorFrom<{
-        readonly _tag: "Reference";
-        readonly reference: ObjectReference;
-    }, "_tag">;
-};
 /**
  * Whether a value is a `Target`.
  *
@@ -139,7 +53,7 @@ export type TargetInput = Target | PathInput | ObjectReference | FileHandle | Di
  * @category constructors
  * @since 0.6.0
  */
-export declare const Target: typeof enumeration & {
+export declare const Target: Data.TaggedEnum.Constructor<Target> & {
     readonly of: (input: TargetInput) => Target;
 };
 /**
@@ -213,7 +127,10 @@ export declare const isEntry: (value: unknown) => value is Entry;
  * @category constructors
  * @since 0.6.0
  */
-export declare const Entry: (directory: TargetInput, name: NameInput) => Entry;
+export declare const Entry: {
+    (name: NameInput): (directory: TargetInput) => Entry;
+    (directory: TargetInput, name: NameInput): Entry;
+};
 /**
  * Whether a path input is a byte path rather than a string.
  *
@@ -221,5 +138,4 @@ export declare const Entry: (directory: TargetInput, name: NameInput) => Entry;
  * @since 0.6.0
  */
 export declare const isBytePathInput: (input: PathInput) => boolean;
-export {};
 //# sourceMappingURL=Target.d.ts.map

package/dist/Target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Target.d.ts","sourceRoot":"","sources":["../src/Target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AAEnC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAErG;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;QACxB,qFAAqF;QACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAA;QACrC,qEAAqE;QACrE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;KACtC,CAAA;IACD,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;KAAE,CAAA;IAC3D,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAAA;KAAE,CAAA;CACnE,CAAC,CAAA;AAQF,QAAA,MAAM,WAAW;;;yBATqB,UAAU,GAAG,eAAe;;;;;uBAP/C,SAAS;8BAEF,eAAe;sCAEP,OAAO;;;;;4BAEG,eAAe;;;;;;;6BACrB,UAAU,GAAG,eAAe;;;2BAP/C,SAAS;kCAEF,eAAe;0CAEP,OAAO;;;gCAEG,eAAe;;;;;;;;;;;;;;;;;6BACrB,UAAU,GAAG,eAAe;;;2BAP/C,SAAS;kCAEF,eAAe;0CAEP,OAAO;;;gCAEG,eAAe;;;;;;;;;;;;;;;;;;yBACrB,UAAU,GAAG,eAAe;;;;uBAP/C,SAAS;8BAEF,eAAe;sCAEP,OAAO;;;;4BAEG,eAAe;;CAUd,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,KAAK,IAAI,MACiE,CAAA;AAEpH;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,UAAU,GAAG,eAAe,CAAA;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAAE,OAAO,WAAW,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,CAAA;CAiBtF,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAA;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,IAAI,mBAYhB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,CAAA;AAEnC;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,OAAO,UAAW,OAAO,KAAG,KAAK,IAAI,KAC8D,CAAA;AAEhH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK,cAAe,WAAW,QAAQ,SAAS,KAAG,KAAoD,CAAA;AAEpH;;;;;GAKG;AACH,eAAO,MAAM,eAAe,UAAW,SAAS,KAAG,OAAqC,CAAA"}
+{"version":3,"file":"Target.d.ts","sourceRoot":"","sources":["../src/Target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,IAAI,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAErG;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;QACxB,qFAAqF;QACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAA;QACrC,qEAAqE;QACrE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;KACtC,CAAA;IACD,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;KAAE,CAAA;IAC3D,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,eAAe,CAAA;KAAE,CAAA;CACnE,CAAC,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,MAAyB,CAAA;AAE7E;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,UAAU,GAAG,eAAe,CAAA;AAE7F;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,MAAM,CAAA;CACxF,CAAA;AAEhB;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAA;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,UAAyB,CAAA;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,CAAA;AAEnC;;;;;GAKG;AACH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,KAAuB,CAAA;AAE1E;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,KAAK,EAAE;IAClB,CAAC,IAAI,EAAE,SAAS,GAAG,CAAC,SAAS,EAAE,WAAW,KAAK,KAAK,CAAA;IACpD,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,GAAG,KAAK,CAAA;CACjC,CAAA;AAEjB;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAiC,CAAA"}