@effect-vfs/core 0.3.0 → 0.3.1

package/dist/internal/virtualFileSystem/path.js

@@ -2,33 +2,41 @@
 import * as ByteSize from "effect/ByteSize";
 import * as Effect from "effect/Effect";
 import * as Encoding from "effect/Encoding";
+import * as Predicate from "effect/Predicate";
 import * as Result from "effect/Result";
-import * as Schema from "effect/Schema";
-import * as SchemaIssue from "effect/SchemaIssue";
-import {} from "../../BytePath.js";
 import { getBytes as getBytePathBytes, make as makeBytePath } from "../bytePath.js";
-import { ConfigurationError, FsError } from "./errors.js";
+import { FsError } from "./errors.js";
+// Components are hex-encoded bytes so names compare as bytes, not text: 2f is "/", 2e is ".", 2e2e is "..".
 /** @internal */
-export const failure = (code, operation, path) => new FsError({ code, operation, ...(path === undefined ? {} : { path }) });
+export const SLASH_HEX = "2f";
 /** @internal */
-export const ownedPath = (bytes) => {
-    return makeBytePath(bytes);
-};
+export const DOT_HEX = "2e";
+/** @internal */
+export const DOT_DOT_HEX = "2e2e";
+/** @internal */
+export const SLASH_BYTE = 47;
+// POSIX NAME_MAX: the longest single path component.
+/** @internal */
+export const MAX_NAME_BYTES = 255;
+// A missing final component is rejected wherever "." and ".." are, so it counts as a dot component.
+// Callers pass the code POSIX gives their operation, so the codes differ on purpose: EEXIST for
+// create (link, symlink, mkdir), EISDIR for open and unlink, EINVAL for rename and rmdir.
+/** @internal */
+export const isDotComponent = (name) => name === undefined || name === DOT_HEX || name === DOT_DOT_HEX;
+/** @internal */
+export const ownedPath = (bytes) => makeBytePath(bytes);
 /** @internal */
 export const strictString = (bytes, operation) => Effect.try({
     try: () => new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes),
-    catch: () => failure("UnrepresentableName", operation)
+    catch: () => new FsError({ code: "UnrepresentableName", operation })
 });
 /** @internal */
-export const nameBytes = (name) => {
-    return Result.getOrThrow(Encoding.decodeHex(name));
-};
+export const nameBytes = (name) => Result.getOrThrow(Encoding.decodeHex(name));
 // A zero-length view distinguishes a detached buffer from a valid empty buffer.
-/** @internal */
-export const attachedBuffer = (bytes) => {
+const attachedBuffer = (bytes) => {
     try {
-        new Uint8Array(bytes.buffer, bytes.byteOffset, 0);
-        return true;
+        const probe = new Uint8Array(bytes.buffer, bytes.byteOffset, 0);
+        return probe.byteLength === 0;
     }
     catch (error) {
         if (error instanceof TypeError)
@@ -36,27 +44,29 @@ export const attachedBuffer = (bytes) => {
         throw error;
     }
 };
+// Accepts any Uint8Array, subclasses such as Node's Buffer included; rejects views over a
+// SharedArrayBuffer or a detached buffer before the bytes are copied or trusted.
+/** @internal */
+export const isAttachedBytes = (bytes) => Predicate.isUint8Array(bytes) && bytes.buffer instanceof ArrayBuffer && attachedBuffer(bytes);
 /** @internal */
 export const pathFromBytes = Effect.fn("VirtualFileSystem.pathFromBytes")(function* (bytes) {
-    if (!(bytes instanceof Uint8Array) || !(bytes.buffer instanceof ArrayBuffer)) {
-        return yield* failure("InvalidArgument", "pathFromBytes");
-    }
-    if (!attachedBuffer(bytes))
-        return yield* failure("InvalidArgument", "pathFromBytes");
+    if (!isAttachedBytes(bytes))
+        return yield* new FsError({ code: "InvalidArgument", operation: "pathFromBytes" });
     const owned = new Uint8Array(bytes);
-    if (owned.length === 0 || owned.includes(0))
-        return yield* failure("InvalidArgument", "pathFromBytes");
+    if (owned.length === 0 || owned.includes(0)) {
+        return yield* new FsError({ code: "InvalidArgument", operation: "pathFromBytes" });
+    }
     return makeBytePath(owned);
 });
 /** @internal */
 export const pathToBytes = Effect.fn("VirtualFileSystem.pathToBytes")(function* (path) {
     const bytes = getBytePathBytes(path);
     if (bytes === undefined)
-        return yield* failure("InvalidArgument", "pathToBytes");
+        return yield* new FsError({ code: "InvalidArgument", operation: "pathToBytes" });
     return new Uint8Array(bytes);
 });
-/** @internal */
-export const wellFormed = (value) => {
+// Hand-rolled because String.prototype.isWellFormed is ES2024 and the package targets ES2023.
+const wellFormed = (value) => {
     for (let index = 0; index < value.length; index++) {
         const code = value.charCodeAt(index);
         if (code >= 0xd800 && code <= 0xdbff) {
@@ -69,36 +79,38 @@ export const wellFormed = (value) => {
     }
     return true;
 };
+const UTF8_ENCODER = new TextEncoder();
+// Strings must be well-formed UTF-16 before encoding; BytePaths must belong to this package.
+/** @internal */
+export const inputBytes = (input) => Predicate.isString(input)
+    ? wellFormed(input) ? Result.succeed(UTF8_ENCODER.encode(input)) : Result.fail("InvalidPathEncoding")
+    : Result.fromNullishOr(getBytePathBytes(input), () => "InvalidArgument");
 /** @internal */
 export const preparePath = (input, operation, maxPathBytes) => {
-    let bytes;
-    if (typeof input === "string") {
-        if (!wellFormed(input))
-            return Result.fail(failure("InvalidPathEncoding", operation, input));
-        bytes = new TextEncoder().encode(input);
+    const encoded = inputBytes(input);
+    if (Result.isFailure(encoded)) {
+        return Result.fail(encoded.failure === "InvalidPathEncoding"
+            ? new FsError({ code: "InvalidPathEncoding", operation, path: input })
+            : new FsError({ code: "InvalidArgument", operation }));
     }
-    else if (typeof input === "object" && input !== null) {
-        bytes = getBytePathBytes(input);
-    }
-    if (bytes === undefined)
-        return Result.fail(failure("InvalidArgument", operation));
+    const bytes = encoded.success;
     if (bytes.length === 0)
-        return Result.fail(failure("NotFound", operation, input));
+        return Result.fail(new FsError({ code: "NotFound", operation, path: input }));
     if (bytes.includes(0))
-        return Result.fail(failure("InvalidArgument", operation, input));
+        return Result.fail(new FsError({ code: "InvalidArgument", operation, path: input }));
     if (maxPathBytes !== undefined && ByteSize.isGreaterThan(ByteSize.bytes(bytes.length), maxPathBytes)) {
-        return Result.fail(failure("PathTooLong", operation, input));
+        return Result.fail(new FsError({ code: "PathTooLong", operation, path: input }));
     }
     const components = [];
     const suffixes = [];
     let start = 0;
     for (let index = 0; index <= bytes.length; index++) {
-        if (index !== bytes.length && bytes[index] !== 47)
+        if (index !== bytes.length && bytes[index] !== SLASH_BYTE)
             continue;
         if (index > start) {
-            // Provisional component bound from decision 0019; names are compared as bytes.
-            if (index - start > 255)
-                return Result.fail(failure("PathTooLong", operation, input));
+            if (index - start > MAX_NAME_BYTES) {
+                return Result.fail(new FsError({ code: "PathTooLong", operation, path: input }));
+            }
             components.push(Encoding.encodeHex(bytes.subarray(start, index)));
             suffixes.push(bytes.subarray(index));
         }
@@ -106,19 +118,10 @@ export const preparePath = (input, operation, maxPathBytes) => {
     }
     return Result.succeed({
         input,
-        absolute: bytes[0] === 47,
-        trailingSlash: bytes.at(-1) === 47,
+        absolute: bytes[0] === SLASH_BYTE,
+        trailingSlash: bytes.at(-1) === SLASH_BYTE,
         bytes,
         suffixes,
         components
     });
 };
-const configurationField = (issue) => {
-    if (issue._tag === "Pointer")
-        return issue.path.map(String).join(".");
-    if (issue._tag === "Composite")
-        return configurationField(issue.issues[0]);
-    return "options";
-};
-/** @internal */
-export const decodeConfiguration = (schema, value) => Schema.decodeUnknownResult(schema, { onExcessProperty: "error" })(value).pipe(Result.mapError((error) => new ConfigurationError({ field: configurationField(error.issue) })));

package/dist/internal/virtualFileSystem/testHooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testHooks.d.ts","sourceRoot":"","sources":["../../../src/internal/virtualFileSystem/testHooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAExD,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CACxD;AAID,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,aAAc,QAAQ,KAAG,eAAe,GAAG,SAA2C,CAAA;AAErH,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,aAAc,QAAQ,QAAQ,eAAe,KAAG,MAAM,IAKpF,CAAA;AAED,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAC7C;AAID,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,WAAY,MAAM,KAAG,gBAAgB,GAAG,SAA0C,CAAA;AAElH,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,WAAY,MAAM,QAAQ,gBAAgB,KAAG,MAAM,IAKlF,CAAA"}
+{"version":3,"file":"testHooks.d.ts","sourceRoot":"","sources":["../../../src/internal/virtualFileSystem/testHooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AAExD,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CACxD;AAID,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,aAAc,QAAQ,KAAG,eAAe,GAAG,SAA2C,CAAA;AAErH,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,aAAc,QAAQ,QAAQ,eAAe,KAAG,MAAM,IAMpF,CAAA;AAED,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;CAC7C;AAID,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,WAAY,MAAM,KAAG,gBAAgB,GAAG,SAA0C,CAAA;AAElH,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,WAAY,MAAM,QAAQ,gBAAgB,KAAG,MAAM,IAMlF,CAAA"}

package/dist/internal/virtualFileSystem/watchHub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watchHub.d.ts","sourceRoot":"","sources":["../../../src/internal/virtualFileSystem/watchHub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAClE;AAED,gBAAgB;AAChB,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAA;IAChD,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IAC/D,QAAQ,CAAC,SAAS,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;CAClH;AAED,gBAAgB;AAChB,eAAO,MAAM,IAAI,GAA+B,CAAC,sEA+B/C,CAAA"}
+{"version":3,"file":"watchHub.d.ts","sourceRoot":"","sources":["../../../src/internal/virtualFileSystem/watchHub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;CAClE;AAGD,gBAAgB;AAChB,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAA;IAChD,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IAC/D,QAAQ,CAAC,SAAS,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;CAClH;AAED,gBAAgB;AAChB,eAAO,MAAM,IAAI,GAA+B,CAAC,sEAmC/C,CAAA"}

package/dist/internal/virtualFileSystem/watchHub.js

@@ -1,9 +1,11 @@
+// Change broadcasting for Volume.watch: one PubSub per volume, published to only while someone listens.
 import * as Effect from "effect/Effect";
 import * as PubSub from "effect/PubSub";
 import * as Stream from "effect/Stream";
 /** @internal */
 export const make = Effect.fnUntraced(function* (coordinate) {
     const pubsub = yield* PubSub.unbounded();
+    // Guarded by `coordinate`: publishers run inside coordinated mutations and both writes below hold the gate.
     let activeSubscribers = 0;
     const publishUnsafe = (event) => {
         if (activeSubscribers === 0)
@@ -16,18 +18,16 @@ export const make = Effect.fnUntraced(function* (coordinate) {
         for (const event of events())
             PubSub.publishUnsafe(pubsub, event);
     };
-    const subscribe = (afterSubscribe) => Effect.uninterruptible(Effect.gen(function* () {
-        const subscription = yield* coordinate(Effect.gen(function* () {
-            const subscription = yield* PubSub.subscribe(pubsub);
-            if (afterSubscribe !== undefined)
-                yield* afterSubscribe;
-            activeSubscribers += 1;
-            return subscription;
-        }));
-        yield* Effect.addFinalizer(() => coordinate(Effect.sync(() => {
-            activeSubscribers -= 1;
-        })));
-        return Stream.fromSubscription(subscription);
-    }));
+    // Registration is uninterruptible end to end, including the permit wait, so a watcher is never
+    // half-registered. This deliberately tightens the engine's "permit waits stay interruptible" rule.
+    const subscribe = (afterSubscribe) => Effect.acquireRelease(coordinate(Effect.gen(function* () {
+        const subscription = yield* PubSub.subscribe(pubsub);
+        if (afterSubscribe !== undefined)
+            yield* afterSubscribe;
+        activeSubscribers += 1;
+        return subscription;
+    })), () => coordinate(Effect.sync(() => {
+        activeSubscribers -= 1;
+    }))).pipe(Effect.map(Stream.fromSubscription));
     return { publishUnsafe, publishManyUnsafe, subscribe };
 });

package/dist/internal/virtualFileSystem.d.ts

@@ -1,5 +1,6 @@
 import * as ByteSize from "effect/ByteSize";
 import * as Context from "effect/Context";
+import * as Data from "effect/Data";
 import * as Effect from "effect/Effect";
 import * as Schema from "effect/Schema";
 import { BytePath } from "../BytePath.js";
@@ -20,8 +21,6 @@ export declare const ObjectReferenceId: unique symbol;
 /** @internal */
 export { ConfigurationError, FsCodeSchema as FsCode, FsError };
 /** @internal */
-export declare const Mode: Schema.Natural;
-/** @internal */
 export declare const Identity: Schema.Struct<{
     readonly uid: Schema.Natural;
     readonly gid: Schema.Natural;
@@ -52,8 +51,6 @@ export declare const VolumeOptions: Schema.Struct<{
 /** @internal */
 export type VolumeOptions = typeof VolumeOptions.Type;
 /** @internal */
-export declare const Timestamp: Schema.BigInt;
-/** @internal */
 export declare const Metadata: Schema.Struct<{
     readonly kind: Schema.Literals<readonly ["directory", "file", "symlink"]>;
     readonly ino: Schema.BigInt;
@@ -121,8 +118,7 @@ export declare const OpenSettings: Schema.Struct<{
 }>;
 /** @internal */
 export type OpenOptions = typeof OpenSettings.Type & RelativeOptions;
-/** @internal */
-export declare const WriteFileSettings: Schema.Struct<{
+declare const WriteFileSettings: Schema.Struct<{
     readonly access: Schema.Literals<readonly ["read", "write", "readWrite"]>;
     readonly create: Schema.optionalKey<Schema.Literals<readonly ["never", "ifMissing", "exclusive"]>>;
     readonly mode: Schema.optionalKey<Schema.Natural>;
@@ -187,6 +183,50 @@ export declare const FixtureMetadata: Schema.Struct<{
     readonly birthtimeNs: Schema.optionalKey<Schema.BigInt>;
 }>;
 /** @internal */
+export declare const FixtureEntry: Schema.toTaggedUnion<"kind", readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"directory">;
+    readonly path: Schema.Union<readonly [Schema.String, Schema.declare<BytePath, BytePath>]>;
+    readonly metadata: Schema.optionalKey<Schema.Struct<{
+        readonly uid: Schema.optionalKey<Schema.Natural>;
+        readonly gid: Schema.optionalKey<Schema.Natural>;
+        readonly mode: Schema.optionalKey<Schema.Natural>;
+        readonly atimeNs: Schema.optionalKey<Schema.BigInt>;
+        readonly mtimeNs: Schema.optionalKey<Schema.BigInt>;
+        readonly ctimeNs: Schema.optionalKey<Schema.BigInt>;
+        readonly birthtimeNs: Schema.optionalKey<Schema.BigInt>;
+    }>>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"file">;
+    readonly path: Schema.Union<readonly [Schema.String, Schema.declare<BytePath, BytePath>]>;
+    readonly bytes: Schema.Uint8Array;
+    readonly metadata: Schema.optionalKey<Schema.Struct<{
+        readonly uid: Schema.optionalKey<Schema.Natural>;
+        readonly gid: Schema.optionalKey<Schema.Natural>;
+        readonly mode: Schema.optionalKey<Schema.Natural>;
+        readonly atimeNs: Schema.optionalKey<Schema.BigInt>;
+        readonly mtimeNs: Schema.optionalKey<Schema.BigInt>;
+        readonly ctimeNs: Schema.optionalKey<Schema.BigInt>;
+        readonly birthtimeNs: Schema.optionalKey<Schema.BigInt>;
+    }>>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"symlink">;
+    readonly path: Schema.Union<readonly [Schema.String, Schema.declare<BytePath, BytePath>]>;
+    readonly target: Schema.Union<readonly [Schema.String, Schema.declare<BytePath, BytePath>]>;
+    readonly metadata: Schema.optionalKey<Schema.Struct<{
+        readonly uid: Schema.optionalKey<Schema.Natural>;
+        readonly gid: Schema.optionalKey<Schema.Natural>;
+        readonly mode: Schema.optionalKey<Schema.Natural>;
+        readonly atimeNs: Schema.optionalKey<Schema.BigInt>;
+        readonly mtimeNs: Schema.optionalKey<Schema.BigInt>;
+        readonly ctimeNs: Schema.optionalKey<Schema.BigInt>;
+        readonly birthtimeNs: Schema.optionalKey<Schema.BigInt>;
+    }>>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"hardLink">;
+    readonly path: Schema.Union<readonly [Schema.String, Schema.declare<BytePath, BytePath>]>;
+    readonly target: Schema.Union<readonly [Schema.String, Schema.declare<BytePath, BytePath>]>;
+}>]>;
+/** @internal */
 export declare const Fixture: Schema.Struct<{
     readonly rootMetadata: Schema.optionalKey<Schema.Struct<{
         readonly uid: Schema.optionalKey<Schema.Natural>;
@@ -197,7 +237,7 @@ export declare const Fixture: Schema.Struct<{
         readonly ctimeNs: Schema.optionalKey<Schema.BigInt>;
         readonly birthtimeNs: Schema.optionalKey<Schema.BigInt>;
     }>>;
-    readonly entries: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+    readonly entries: Schema.$Array<Schema.toTaggedUnion<"kind", readonly [Schema.Struct<{
         readonly kind: Schema.Literal<"directory">;
         readonly path: Schema.Union<readonly [Schema.String, Schema.declare<BytePath, BytePath>]>;
         readonly metadata: Schema.optionalKey<Schema.Struct<{
@@ -254,18 +294,54 @@ type VolumeSource = {
     readonly image: Image.Document;
 };
 /** @internal */
-export declare const makeVolume: (source: VolumeSource, options?: {
+export declare const VolumeSource: {
+    readonly $is: <Tag extends "Empty" | "Overlay" | "Snapshot">(tag: Tag) => (u: unknown) => u is Extract<{
+        readonly _tag: "Empty";
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Snapshot";
+        readonly image: Image.Document;
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Overlay";
+        readonly base: Snapshot;
+        readonly image: Image.Document;
+    }, {
+        readonly _tag: Tag;
+    }>;
+    readonly $match: {
+        <Cases extends { readonly [Tag in "Empty" | "Overlay" | "Snapshot"]: (args: Extract<VolumeSource, {
+            readonly _tag: Tag;
+        }>) => any; }>(cases: Cases): (value: VolumeSource) => import("effect/Unify").Unify<ReturnType<Cases["Empty" | "Overlay" | "Snapshot"]>>;
+        <Cases extends { readonly [Tag in "Empty" | "Overlay" | "Snapshot"]: (args: Extract<VolumeSource, {
+            readonly _tag: Tag;
+        }>) => any; }>(value: VolumeSource, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Empty" | "Overlay" | "Snapshot"]>>;
+    };
+    readonly Empty: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Empty";
+    }, "_tag">;
+    readonly Overlay: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Overlay";
+        readonly base: Snapshot;
+        readonly image: Image.Document;
+    }, "_tag">;
+    readonly Snapshot: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Snapshot";
+        readonly image: Image.Document;
+    }, "_tag">;
+};
+type VolumeFor<S extends VolumeSource> = S extends {
+    readonly _tag: "Overlay";
+} ? OverlayVolume : Volume;
+/** @internal */
+export declare const makeVolume: <S extends VolumeSource>(source: S, options?: {
     readonly maxEntries?: number;
     readonly maxBytes?: ByteSize.ByteSize;
     readonly maxFileBytes?: ByteSize.ByteSize;
     readonly maxPathBytes?: ByteSize.ByteSize;
-} | undefined) => Effect.Effect<{
-    _tag: "Volume";
-    volume: Volume;
-} | {
-    _tag: "Overlay";
-    volume: OverlayVolume;
-}, ConfigurationError | ImageError, never>;
+} | undefined) => Effect.Effect<VolumeFor<S>, ConfigurationError | ImageError, never>;
 /** @internal */
 export declare const make: (options?: {
     readonly maxEntries?: number;

package/dist/internal/virtualFileSystem.d.ts.map

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