@savvy-web/silk 3.0.1 → 3.0.3

package/changesets-changelog.d.cts

@@ -4503,7 +4503,7 @@ declare class GlobPattern extends GlobPattern_base {
   static readonly FromString: Schema.Codec<GlobPattern, string>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.1.3_@effected+jsonc@0.2.0_effect@4.0.0-beta.98__@effected+npm@0.2_2bd071ae657036cda4f0e368b3590d06/node_modules/@effected/lockfiles/index.d.ts
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.1.4_@effected+jsonc@0.3.0_effect@4.0.0-beta.98__@effected+npm@0.2_7fc50d596abf9879356de67fd92b0252/node_modules/@effected/lockfiles/index.d.ts
 //#region src/BunExtension.d.ts
 declare const BunExtension_base: Schema.Class<BunExtension, Schema.Struct<{
   readonly _tag: Schema.tag<"bun">;
@@ -5330,7 +5330,7 @@ declare class Package extends Package_base {
   toJsonString(options?: PackageFormatOptions): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.3.1_@effected+jsonc@0.2.0_effect@4.0.0-beta.98__effect@4.0.0-beta.98/node_modules/@effected/workspaces/index.d.ts
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.4.0_@effected+jsonc@0.3.0_effect@4.0.0-beta.98__effect@4.0.0-beta.98/node_modules/@effected/workspaces/index.d.ts
 //#region src/WorkspacePackage.d.ts
 declare const PublishConfig_base: Schema.Class<PublishConfig, Schema.Struct<{
   /** Scoped-package visibility. Its presence overrides `private`. */
@@ -5758,6 +5758,72 @@ declare class WorkspaceDiscovery extends WorkspaceDiscovery_base {
    * rather than calling `layer(...)` at each composition site.
    */
   static readonly layer: (options?: WorkspaceDiscoveryOptions) => Layer.Layer<WorkspaceDiscovery, never, WorkspaceRoot | FileSystem.FileSystem | Path.Path>;
+  /**
+   * An in-memory test double of the service shape, with every method
+   * defaulted so a test stubs only what it exercises.
+   *
+   * @remarks
+   * The defaults model an **empty workspace**, and the derived methods run
+   * over the *effective* `listPackages` — the override when one is supplied —
+   * so stubbing only `listPackages` yields a consistent double:
+   *
+   * - `listPackages` — succeeds with `[]`.
+   * - `importerMap` — derived: the packages keyed by `relativePath`.
+   * - `getPackage` — derived: a name lookup that fails with the service's own
+   *   typed {@link PackageNotFoundError} on a miss, exactly as the live
+   *   implementation does.
+   * - `resolveFile` / `resolveFiles` — derived: longest-prefix ownership over
+   *   `pkg.path`, POSIX-terminated (`"/"`); supply a win32 double explicitly
+   *   if your fixture paths are win32.
+   * - `refresh` — a no-op (`Effect.void`); there is nothing memoized to drop.
+   * - `info` — **dies** with an explanatory defect. No honest default exists
+   *   (a fabricated root path would leak into consumer path logic), so an
+   *   unstubbed `info()` call is a test-wiring mistake and fails loudly as a
+   *   defect rather than succeeding with a lie or failing with a dishonest
+   *   typed error.
+   *
+   * @example
+   * ```ts
+   * import { WorkspaceDiscovery, WorkspacePackage } from "@effected/workspaces";
+   * import { Effect } from "effect";
+   *
+   * const double = WorkspaceDiscovery.makeTest({
+   *   listPackages: () =>
+   *     Effect.succeed([
+   *       WorkspacePackage.make({
+   *         name: "@my-org/utils",
+   *         version: "1.0.0",
+   *         path: "/repo/packages/utils",
+   *         packageJsonPath: "/repo/packages/utils/package.json",
+   *         relativePath: "packages/utils",
+   *       }),
+   *     ]),
+   * });
+   * // `getPackage`, `importerMap`, `resolveFile(s)` now answer consistently.
+   * ```
+   */
+  static readonly makeTest: (overrides?: Partial<WorkspaceDiscoveryShape>) => WorkspaceDiscoveryShape;
+  /**
+   * The test layer: {@link WorkspaceDiscovery.makeTest} behind
+   * `Layer.succeed`, so a suite provides only the methods it exercises.
+   *
+   * @remarks
+   * A parameterized layer factory mints a **fresh reference per call**, and
+   * layers memoize by reference — bind the result to a `const` and reuse it
+   * rather than calling `layerTest(...)` at each composition site.
+   *
+   * @example
+   * ```ts
+   * import { WorkspaceDiscovery } from "@effected/workspaces";
+   * import { Effect } from "effect";
+   *
+   * const TestDiscovery = WorkspaceDiscovery.layerTest({
+   *   listPackages: () => Effect.succeed([]),
+   * });
+   * // program.pipe(Effect.provide(TestDiscovery))
+   * ```
+   */
+  static readonly layerTest: (overrides?: Partial<WorkspaceDiscoveryShape>) => Layer.Layer<WorkspaceDiscovery>;
   /**
    * The real implementation of `@effected/npm`'s `WorkspaceResolver` contract
    * — the one `@effected/package-json` declares but cannot fill.

package/changesets-changelog.d.ts

@@ -4503,7 +4503,7 @@ declare class GlobPattern extends GlobPattern_base {
   static readonly FromString: Schema.Codec<GlobPattern, string>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+lockfiles@0.1.3_@effected+jsonc@0.2.0_effect@4.0.0-beta.98__@effected+npm@0.2_2bd071ae657036cda4f0e368b3590d06/node_modules/@effected/lockfiles/index.d.ts
+//#region ../../node_modules/.pnpm/@effected+lockfiles@0.1.4_@effected+jsonc@0.3.0_effect@4.0.0-beta.98__@effected+npm@0.2_7fc50d596abf9879356de67fd92b0252/node_modules/@effected/lockfiles/index.d.ts
 //#region src/BunExtension.d.ts
 declare const BunExtension_base: Schema.Class<BunExtension, Schema.Struct<{
   readonly _tag: Schema.tag<"bun">;
@@ -5330,7 +5330,7 @@ declare class Package extends Package_base {
   toJsonString(options?: PackageFormatOptions): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.3.1_@effected+jsonc@0.2.0_effect@4.0.0-beta.98__effect@4.0.0-beta.98/node_modules/@effected/workspaces/index.d.ts
+//#region ../../node_modules/.pnpm/@effected+workspaces@0.4.0_@effected+jsonc@0.3.0_effect@4.0.0-beta.98__effect@4.0.0-beta.98/node_modules/@effected/workspaces/index.d.ts
 //#region src/WorkspacePackage.d.ts
 declare const PublishConfig_base: Schema.Class<PublishConfig, Schema.Struct<{
   /** Scoped-package visibility. Its presence overrides `private`. */
@@ -5758,6 +5758,72 @@ declare class WorkspaceDiscovery extends WorkspaceDiscovery_base {
    * rather than calling `layer(...)` at each composition site.
    */
   static readonly layer: (options?: WorkspaceDiscoveryOptions) => Layer.Layer<WorkspaceDiscovery, never, WorkspaceRoot | FileSystem.FileSystem | Path.Path>;
+  /**
+   * An in-memory test double of the service shape, with every method
+   * defaulted so a test stubs only what it exercises.
+   *
+   * @remarks
+   * The defaults model an **empty workspace**, and the derived methods run
+   * over the *effective* `listPackages` — the override when one is supplied —
+   * so stubbing only `listPackages` yields a consistent double:
+   *
+   * - `listPackages` — succeeds with `[]`.
+   * - `importerMap` — derived: the packages keyed by `relativePath`.
+   * - `getPackage` — derived: a name lookup that fails with the service's own
+   *   typed {@link PackageNotFoundError} on a miss, exactly as the live
+   *   implementation does.
+   * - `resolveFile` / `resolveFiles` — derived: longest-prefix ownership over
+   *   `pkg.path`, POSIX-terminated (`"/"`); supply a win32 double explicitly
+   *   if your fixture paths are win32.
+   * - `refresh` — a no-op (`Effect.void`); there is nothing memoized to drop.
+   * - `info` — **dies** with an explanatory defect. No honest default exists
+   *   (a fabricated root path would leak into consumer path logic), so an
+   *   unstubbed `info()` call is a test-wiring mistake and fails loudly as a
+   *   defect rather than succeeding with a lie or failing with a dishonest
+   *   typed error.
+   *
+   * @example
+   * ```ts
+   * import { WorkspaceDiscovery, WorkspacePackage } from "@effected/workspaces";
+   * import { Effect } from "effect";
+   *
+   * const double = WorkspaceDiscovery.makeTest({
+   *   listPackages: () =>
+   *     Effect.succeed([
+   *       WorkspacePackage.make({
+   *         name: "@my-org/utils",
+   *         version: "1.0.0",
+   *         path: "/repo/packages/utils",
+   *         packageJsonPath: "/repo/packages/utils/package.json",
+   *         relativePath: "packages/utils",
+   *       }),
+   *     ]),
+   * });
+   * // `getPackage`, `importerMap`, `resolveFile(s)` now answer consistently.
+   * ```
+   */
+  static readonly makeTest: (overrides?: Partial<WorkspaceDiscoveryShape>) => WorkspaceDiscoveryShape;
+  /**
+   * The test layer: {@link WorkspaceDiscovery.makeTest} behind
+   * `Layer.succeed`, so a suite provides only the methods it exercises.
+   *
+   * @remarks
+   * A parameterized layer factory mints a **fresh reference per call**, and
+   * layers memoize by reference — bind the result to a `const` and reuse it
+   * rather than calling `layerTest(...)` at each composition site.
+   *
+   * @example
+   * ```ts
+   * import { WorkspaceDiscovery } from "@effected/workspaces";
+   * import { Effect } from "effect";
+   *
+   * const TestDiscovery = WorkspaceDiscovery.layerTest({
+   *   listPackages: () => Effect.succeed([]),
+   * });
+   * // program.pipe(Effect.provide(TestDiscovery))
+   * ```
+   */
+  static readonly layerTest: (overrides?: Partial<WorkspaceDiscoveryShape>) => Layer.Layer<WorkspaceDiscovery>;
   /**
    * The real implementation of `@effected/npm`'s `WorkspaceResolver` contract
    * — the one `@effected/package-json` declares but cannot fill.