@savvy-web/silk 3.2.0 → 3.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3296,7 +3296,7 @@ type Label = Label$1;
3296
3296
  type Severity = Severity$1;
3297
3297
  type Plugin<Tree extends Node$3 = Node$3, Option extends unknown = unknown> = (config?: [level: Label | Severity | boolean, option?: Option] | Label | Option | Severity) => ((tree: Tree, file: VFile, next: TransformCallback<Tree>) => undefined) | undefined;
3298
3298
  //#endregion
3299
- //#region ../../node_modules/.pnpm/@effected+git@0.4.1_effect@4.0.0-beta.99/node_modules/@effected/git/index.d.ts
3299
+ //#region ../../node_modules/.pnpm/@effected+git@0.4.2_effect@4.0.0-beta.101/node_modules/@effected/git/index.d.ts
3300
3300
  //#region src/Git.d.ts
3301
3301
  declare const GitCommandError_base: Schema.Class<GitCommandError, Schema.TaggedStruct<"GitCommandError", {
3302
3302
  /**
@@ -3650,7 +3650,7 @@ declare class Git extends Git_base {
3650
3650
  static readonly layer: Layer.Layer<Git, never, ChildProcessSpawner.ChildProcessSpawner>;
3651
3651
  }
3652
3652
  //#endregion
3653
- //#region ../../node_modules/.pnpm/@effected+semver@0.2.0_effect@4.0.0-beta.99/node_modules/@effected/semver/index.d.ts
3653
+ //#region ../../node_modules/.pnpm/@effected+semver@0.2.1_effect@4.0.0-beta.101/node_modules/@effected/semver/index.d.ts
3654
3654
  //#region src/SemVer.d.ts
3655
3655
  declare const InvalidVersionError_base: Schema.Class<InvalidVersionError, Schema.TaggedStruct<"InvalidVersionError", {
3656
3656
  /** The raw input string that failed to parse. */
@@ -4225,7 +4225,7 @@ declare class UnsatisfiableConstraintError extends UnsatisfiableConstraintError_
4225
4225
  get message(): string;
4226
4226
  }
4227
4227
  //#endregion
4228
- //#region ../../node_modules/.pnpm/@effected+npm@0.3.0_@effected+semver@0.2.0_effect@4.0.0-beta.99__effect@4.0.0-beta.99/node_modules/@effected/npm/index.d.ts
4228
+ //#region ../../node_modules/.pnpm/@effected+npm@0.3.1_@effected+semver@0.2.1_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/index.d.ts
4229
4229
  //#region src/CatalogAssemblyError.d.ts
4230
4230
  declare const CatalogAssemblyError_base: Schema.Class<CatalogAssemblyError, Schema.TaggedStruct<"CatalogAssemblyError", {
4231
4231
  /**
@@ -4626,7 +4626,7 @@ declare class ReleaseAgeGate extends ReleaseAgeGate_base {
4626
4626
  filterVersions(versions: readonly string[], times: Readonly<Record<string, string>>, name: string, now: number): readonly string[];
4627
4627
  }
4628
4628
  //#endregion
4629
- //#region ../../node_modules/.pnpm/@effected+glob@0.2.0_effect@4.0.0-beta.99/node_modules/@effected/glob/index.d.ts
4629
+ //#region ../../node_modules/.pnpm/@effected+glob@0.2.1_effect@4.0.0-beta.101/node_modules/@effected/glob/index.d.ts
4630
4630
  //#region src/GlobPattern.d.ts
4631
4631
  declare const GlobPatternError_base: Schema.Class<GlobPatternError, Schema.TaggedStruct<"GlobPatternError", {
4632
4632
  readonly pattern: Schema.String;
@@ -4791,7 +4791,7 @@ declare class GlobPattern extends GlobPattern_base {
4791
4791
  static readonly FromString: Schema.Codec<GlobPattern, string>;
4792
4792
  }
4793
4793
  //#endregion
4794
- //#region ../../node_modules/.pnpm/@effected+lockfiles@0.1.9_@effected+jsonc@0.5.0_effect@4.0.0-beta.99__@effected+npm@0.3_d470055e7ca4b6a23d413cae592e2835/node_modules/@effected/lockfiles/index.d.ts
4794
+ //#region ../../node_modules/.pnpm/@effected+lockfiles@0.1.10_@effected+jsonc@0.5.1_effect@4.0.0-beta.101__@effected+npm@0_baf93f2c33d0504f713f685ac5710e50/node_modules/@effected/lockfiles/index.d.ts
4795
4795
  //#region src/BunExtension.d.ts
4796
4796
  declare const BunExtension_base: Schema.Class<BunExtension, Schema.Struct<{
4797
4797
  readonly _tag: Schema.tag<"bun">;
@@ -5211,7 +5211,7 @@ declare class LockfileIntegrity extends LockfileIntegrity_base {
5211
5211
  static compare(lockfile: Lockfile, manifests: ReadonlyArray<WorkspaceManifest>): LockfileIntegrity;
5212
5212
  }
5213
5213
  //#endregion
5214
- //#region ../../node_modules/.pnpm/@effected+package-json@0.5.0_effect@4.0.0-beta.99/node_modules/@effected/package-json/index.d.ts
5214
+ //#region ../../node_modules/.pnpm/@effected+package-json@0.5.1_effect@4.0.0-beta.101/node_modules/@effected/package-json/index.d.ts
5215
5215
  //#region src/Dependency.d.ts
5216
5216
  declare const Dependency_base: Schema.Class<Dependency, Schema.Struct<{
5217
5217
  /** The package name. */
@@ -5659,7 +5659,7 @@ declare class Package extends Package_base {
5659
5659
  toJsonString(options?: PackageFormatOptions): string;
5660
5660
  }
5661
5661
  //#endregion
5662
- //#region ../../node_modules/.pnpm/@effected+workspaces@0.6.1_@effected+jsonc@0.5.0_effect@4.0.0-beta.99__effect@4.0.0-beta.99/node_modules/@effected/workspaces/index.d.ts
5662
+ //#region ../../node_modules/.pnpm/@effected+workspaces@0.7.0_@effected+jsonc@0.5.1_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/index.d.ts
5663
5663
  //#region src/WorkspacePackage.d.ts
5664
5664
  declare const PublishConfig_base: Schema.Class<PublishConfig, Schema.Struct<{
5665
5665
  /** Scoped-package visibility. Its presence overrides `private`. */
@@ -6747,6 +6747,26 @@ declare class PublishabilityDetector extends PublishabilityDetector_base {
6747
6747
  }
6748
6748
  //#endregion
6749
6749
  //#region src/WorkspaceCatalogs.d.ts
6750
+ /**
6751
+ * Each importer's dependency-name → resolved-version map, keyed by importer path
6752
+ * (`"."` for the root package — the same keys `WorkspaceDiscovery.importerMap()`
6753
+ * uses, and the same value `PackageStateSnapshot.relativePath` carries).
6754
+ *
6755
+ * @remarks
6756
+ * What a manager's lockfile records as actually installed, as opposed to what a
6757
+ * manifest declares. It answers a `catalog:` specifier no committed catalog
6758
+ * source declares — the shape a pnpm config-dependency pnpmfile hook produces —
6759
+ * which would otherwise resolve to nothing on both sides of a diff and hide a
6760
+ * real version movement.
6761
+ *
6762
+ * Versions are normalized: pnpm's peer-disambiguation suffix
6763
+ * (`1.2.3(effect@4.0.0)`) is stripped, and `link:` / `file:` entries are omitted
6764
+ * because a filesystem edge is not a version. Only pnpm records importer
6765
+ * versions; bun and npm yield an empty index.
6766
+ *
6767
+ * @public
6768
+ */
6769
+ type ImporterVersions = Readonly<Record<string, Readonly<Record<string, string>>>>;
6750
6770
  declare const CatalogSet_base: Schema.Class<CatalogSet, Schema.Struct<{
6751
6771
  /** Catalog name → dependency name → version range. */
6752
6772
  readonly entries: Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.String>>;
@@ -6879,6 +6899,19 @@ interface WorkspaceCatalogsShape {
6879
6899
  * workspace) has no release-age keys, so the gate is the inert zero gate.
6880
6900
  */
6881
6901
  readonly releaseAgeGate: () => Effect.Effect<ReleaseAgeGate, CatalogAssemblyFailure>;
6902
+ /**
6903
+ * Each importer's dependency-name → resolved-version map, as the manager's
6904
+ * lockfile records it. Read from the same single lockfile read as `set`, and
6905
+ * memoized with it.
6906
+ *
6907
+ * @remarks
6908
+ * Feeds `WorkspaceStateSnapshot`'s fallback for a `catalog:` specifier no
6909
+ * committed catalog source declares — the shape a config-dependency pnpmfile
6910
+ * hook produces. Only pnpm records importer versions; a bun or npm workspace
6911
+ * yields an empty index, and an absent or unreadable lockfile contributes
6912
+ * nothing rather than failing.
6913
+ */
6914
+ readonly importerVersions: () => Effect.Effect<ImporterVersions, CatalogAssemblyFailure>;
6882
6915
  }
6883
6916
  /**
6884
6917
  * Options for the {@link WorkspaceCatalogs} layer.
@@ -7007,6 +7040,18 @@ declare const WorkspaceStateSnapshot_base: Schema.Class<WorkspaceStateSnapshot,
7007
7040
  readonly packages: Schema.$Array<typeof PackageStateSnapshot>;
7008
7041
  /** The catalog set assembled at this moment. */
7009
7042
  readonly catalogs: typeof CatalogSet;
7043
+ /**
7044
+ * Each importer's dependency-name → resolved-version map, as the manager's
7045
+ * lockfile recorded it at this moment.
7046
+ *
7047
+ * @remarks
7048
+ * Defaults to `{}`, so a `WorkspaceStateSnapshot` serialized before this field
7049
+ * existed still decodes — and an empty index simply makes the `catalog:`
7050
+ * fallback in {@link WorkspaceStateSnapshot.resolve} inert, which is exactly
7051
+ * the behavior those older values were captured under. Only pnpm records
7052
+ * importer versions; bun and npm yield an empty index.
7053
+ */
7054
+ readonly importerVersions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.String>>>;
7010
7055
  }>, {}>;
7011
7056
  /**
7012
7057
  * The state of a whole workspace at one moment — its packages and its assembled
@@ -7056,11 +7101,43 @@ declare class WorkspaceStateSnapshot extends WorkspaceStateSnapshot_base {
7056
7101
  * unparseable string — is `Option.none()`, because there is no indirection to
7057
7102
  * resolve. Total.
7058
7103
  *
7104
+ * A `catalog:` specifier the catalog set cannot resolve falls back to this
7105
+ * snapshot's `importerVersions` — but only to a version
7106
+ * **every** importer recording that dependency agrees on. A catalog injected
7107
+ * by a config-dependency pnpmfile hook appears in no committed catalog source,
7108
+ * so without this fallback both sides of a before/after diff resolve it to the
7109
+ * same raw string and a real version movement produces no row. When importers
7110
+ * disagree there is no single correct answer, so this stays `Option.none()`
7111
+ * rather than inventing one; {@link WorkspaceStateSnapshot.resolveIn} answers
7112
+ * precisely for callers that know which importer is asking.
7113
+ *
7059
7114
  * @param dependency - The dependency's package name (what `workspace:` /
7060
7115
  * `catalog:` resolve for).
7061
7116
  * @param specifier - The raw specifier string.
7062
7117
  */
7063
7118
  resolve(dependency: string, specifier: string): Option.Option<string>;
7119
+ /**
7120
+ * The concrete range or version a specifier resolved to AS OF this snapshot,
7121
+ * scoped to the importer that declared it.
7122
+ *
7123
+ * @remarks
7124
+ * Identical to {@link WorkspaceStateSnapshot.resolve} except in how an
7125
+ * unresolvable `catalog:` specifier falls back: this consults **only**
7126
+ * `importerPath`'s own recorded versions, so a monorepo whose packages hold
7127
+ * different versions of one dependency still gets an exact answer where
7128
+ * `resolve` must abstain. Prefer this whenever the caller knows the importer —
7129
+ * a consumer iterating `packages` has `relativePath` in hand, which is the
7130
+ * importer key (`"."` for the root package).
7131
+ *
7132
+ * An unknown `importerPath`, or one recording nothing for `dependency`, is
7133
+ * `Option.none()`. Total.
7134
+ *
7135
+ * @param importerPath - The importer's path relative to the workspace root,
7136
+ * `"."` for the root package — `PackageStateSnapshot.relativePath`.
7137
+ * @param dependency - The dependency's package name.
7138
+ * @param specifier - The raw specifier string.
7139
+ */
7140
+ resolveIn(importerPath: string, dependency: string, specifier: string): Option.Option<string>;
7064
7141
  /**
7065
7142
  * A `CatalogResolver` layer implementing `@effected/npm`'s contract against
7066
7143
  * THIS snapshot's catalog set — so code written to the contract resolves
@@ -7195,7 +7272,7 @@ interface WorkspacesOptions {
7195
7272
  readonly maxDepth?: number;
7196
7273
  }
7197
7274
  //#endregion
7198
- //#region ../../node_modules/.pnpm/@effected+walker@0.3.1_@effected+glob@0.2.0_effect@4.0.0-beta.99__effect@4.0.0-beta.99/node_modules/@effected/walker/index.d.ts
7275
+ //#region ../../node_modules/.pnpm/@effected+walker@0.3.2_@effected+glob@0.2.1_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/walker/index.d.ts
7199
7276
  declare const DescendError_base: Schema.Class<DescendError, Schema.TaggedStruct<"DescendError", {
7200
7277
  /** The glob pattern's source text. */
7201
7278
  readonly pattern: Schema.String;
@@ -3296,7 +3296,7 @@ type Label = Label$1;
3296
3296
  type Severity = Severity$1;
3297
3297
  type Plugin<Tree extends Node$3 = Node$3, Option extends unknown = unknown> = (config?: [level: Label | Severity | boolean, option?: Option] | Label | Option | Severity) => ((tree: Tree, file: VFile, next: TransformCallback<Tree>) => undefined) | undefined;
3298
3298
  //#endregion
3299
- //#region ../../node_modules/.pnpm/@effected+git@0.4.1_effect@4.0.0-beta.99/node_modules/@effected/git/index.d.ts
3299
+ //#region ../../node_modules/.pnpm/@effected+git@0.4.2_effect@4.0.0-beta.101/node_modules/@effected/git/index.d.ts
3300
3300
  //#region src/Git.d.ts
3301
3301
  declare const GitCommandError_base: Schema.Class<GitCommandError, Schema.TaggedStruct<"GitCommandError", {
3302
3302
  /**
@@ -3650,7 +3650,7 @@ declare class Git extends Git_base {
3650
3650
  static readonly layer: Layer.Layer<Git, never, ChildProcessSpawner.ChildProcessSpawner>;
3651
3651
  }
3652
3652
  //#endregion
3653
- //#region ../../node_modules/.pnpm/@effected+semver@0.2.0_effect@4.0.0-beta.99/node_modules/@effected/semver/index.d.ts
3653
+ //#region ../../node_modules/.pnpm/@effected+semver@0.2.1_effect@4.0.0-beta.101/node_modules/@effected/semver/index.d.ts
3654
3654
  //#region src/SemVer.d.ts
3655
3655
  declare const InvalidVersionError_base: Schema.Class<InvalidVersionError, Schema.TaggedStruct<"InvalidVersionError", {
3656
3656
  /** The raw input string that failed to parse. */
@@ -4225,7 +4225,7 @@ declare class UnsatisfiableConstraintError extends UnsatisfiableConstraintError_
4225
4225
  get message(): string;
4226
4226
  }
4227
4227
  //#endregion
4228
- //#region ../../node_modules/.pnpm/@effected+npm@0.3.0_@effected+semver@0.2.0_effect@4.0.0-beta.99__effect@4.0.0-beta.99/node_modules/@effected/npm/index.d.ts
4228
+ //#region ../../node_modules/.pnpm/@effected+npm@0.3.1_@effected+semver@0.2.1_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/npm/index.d.ts
4229
4229
  //#region src/CatalogAssemblyError.d.ts
4230
4230
  declare const CatalogAssemblyError_base: Schema.Class<CatalogAssemblyError, Schema.TaggedStruct<"CatalogAssemblyError", {
4231
4231
  /**
@@ -4626,7 +4626,7 @@ declare class ReleaseAgeGate extends ReleaseAgeGate_base {
4626
4626
  filterVersions(versions: readonly string[], times: Readonly<Record<string, string>>, name: string, now: number): readonly string[];
4627
4627
  }
4628
4628
  //#endregion
4629
- //#region ../../node_modules/.pnpm/@effected+glob@0.2.0_effect@4.0.0-beta.99/node_modules/@effected/glob/index.d.ts
4629
+ //#region ../../node_modules/.pnpm/@effected+glob@0.2.1_effect@4.0.0-beta.101/node_modules/@effected/glob/index.d.ts
4630
4630
  //#region src/GlobPattern.d.ts
4631
4631
  declare const GlobPatternError_base: Schema.Class<GlobPatternError, Schema.TaggedStruct<"GlobPatternError", {
4632
4632
  readonly pattern: Schema.String;
@@ -4791,7 +4791,7 @@ declare class GlobPattern extends GlobPattern_base {
4791
4791
  static readonly FromString: Schema.Codec<GlobPattern, string>;
4792
4792
  }
4793
4793
  //#endregion
4794
- //#region ../../node_modules/.pnpm/@effected+lockfiles@0.1.9_@effected+jsonc@0.5.0_effect@4.0.0-beta.99__@effected+npm@0.3_d470055e7ca4b6a23d413cae592e2835/node_modules/@effected/lockfiles/index.d.ts
4794
+ //#region ../../node_modules/.pnpm/@effected+lockfiles@0.1.10_@effected+jsonc@0.5.1_effect@4.0.0-beta.101__@effected+npm@0_baf93f2c33d0504f713f685ac5710e50/node_modules/@effected/lockfiles/index.d.ts
4795
4795
  //#region src/BunExtension.d.ts
4796
4796
  declare const BunExtension_base: Schema.Class<BunExtension, Schema.Struct<{
4797
4797
  readonly _tag: Schema.tag<"bun">;
@@ -5211,7 +5211,7 @@ declare class LockfileIntegrity extends LockfileIntegrity_base {
5211
5211
  static compare(lockfile: Lockfile, manifests: ReadonlyArray<WorkspaceManifest>): LockfileIntegrity;
5212
5212
  }
5213
5213
  //#endregion
5214
- //#region ../../node_modules/.pnpm/@effected+package-json@0.5.0_effect@4.0.0-beta.99/node_modules/@effected/package-json/index.d.ts
5214
+ //#region ../../node_modules/.pnpm/@effected+package-json@0.5.1_effect@4.0.0-beta.101/node_modules/@effected/package-json/index.d.ts
5215
5215
  //#region src/Dependency.d.ts
5216
5216
  declare const Dependency_base: Schema.Class<Dependency, Schema.Struct<{
5217
5217
  /** The package name. */
@@ -5659,7 +5659,7 @@ declare class Package extends Package_base {
5659
5659
  toJsonString(options?: PackageFormatOptions): string;
5660
5660
  }
5661
5661
  //#endregion
5662
- //#region ../../node_modules/.pnpm/@effected+workspaces@0.6.1_@effected+jsonc@0.5.0_effect@4.0.0-beta.99__effect@4.0.0-beta.99/node_modules/@effected/workspaces/index.d.ts
5662
+ //#region ../../node_modules/.pnpm/@effected+workspaces@0.7.0_@effected+jsonc@0.5.1_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/index.d.ts
5663
5663
  //#region src/WorkspacePackage.d.ts
5664
5664
  declare const PublishConfig_base: Schema.Class<PublishConfig, Schema.Struct<{
5665
5665
  /** Scoped-package visibility. Its presence overrides `private`. */
@@ -6747,6 +6747,26 @@ declare class PublishabilityDetector extends PublishabilityDetector_base {
6747
6747
  }
6748
6748
  //#endregion
6749
6749
  //#region src/WorkspaceCatalogs.d.ts
6750
+ /**
6751
+ * Each importer's dependency-name → resolved-version map, keyed by importer path
6752
+ * (`"."` for the root package — the same keys `WorkspaceDiscovery.importerMap()`
6753
+ * uses, and the same value `PackageStateSnapshot.relativePath` carries).
6754
+ *
6755
+ * @remarks
6756
+ * What a manager's lockfile records as actually installed, as opposed to what a
6757
+ * manifest declares. It answers a `catalog:` specifier no committed catalog
6758
+ * source declares — the shape a pnpm config-dependency pnpmfile hook produces —
6759
+ * which would otherwise resolve to nothing on both sides of a diff and hide a
6760
+ * real version movement.
6761
+ *
6762
+ * Versions are normalized: pnpm's peer-disambiguation suffix
6763
+ * (`1.2.3(effect@4.0.0)`) is stripped, and `link:` / `file:` entries are omitted
6764
+ * because a filesystem edge is not a version. Only pnpm records importer
6765
+ * versions; bun and npm yield an empty index.
6766
+ *
6767
+ * @public
6768
+ */
6769
+ type ImporterVersions = Readonly<Record<string, Readonly<Record<string, string>>>>;
6750
6770
  declare const CatalogSet_base: Schema.Class<CatalogSet, Schema.Struct<{
6751
6771
  /** Catalog name → dependency name → version range. */
6752
6772
  readonly entries: Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.String>>;
@@ -6879,6 +6899,19 @@ interface WorkspaceCatalogsShape {
6879
6899
  * workspace) has no release-age keys, so the gate is the inert zero gate.
6880
6900
  */
6881
6901
  readonly releaseAgeGate: () => Effect.Effect<ReleaseAgeGate, CatalogAssemblyFailure>;
6902
+ /**
6903
+ * Each importer's dependency-name → resolved-version map, as the manager's
6904
+ * lockfile records it. Read from the same single lockfile read as `set`, and
6905
+ * memoized with it.
6906
+ *
6907
+ * @remarks
6908
+ * Feeds `WorkspaceStateSnapshot`'s fallback for a `catalog:` specifier no
6909
+ * committed catalog source declares — the shape a config-dependency pnpmfile
6910
+ * hook produces. Only pnpm records importer versions; a bun or npm workspace
6911
+ * yields an empty index, and an absent or unreadable lockfile contributes
6912
+ * nothing rather than failing.
6913
+ */
6914
+ readonly importerVersions: () => Effect.Effect<ImporterVersions, CatalogAssemblyFailure>;
6882
6915
  }
6883
6916
  /**
6884
6917
  * Options for the {@link WorkspaceCatalogs} layer.
@@ -7007,6 +7040,18 @@ declare const WorkspaceStateSnapshot_base: Schema.Class<WorkspaceStateSnapshot,
7007
7040
  readonly packages: Schema.$Array<typeof PackageStateSnapshot>;
7008
7041
  /** The catalog set assembled at this moment. */
7009
7042
  readonly catalogs: typeof CatalogSet;
7043
+ /**
7044
+ * Each importer's dependency-name → resolved-version map, as the manager's
7045
+ * lockfile recorded it at this moment.
7046
+ *
7047
+ * @remarks
7048
+ * Defaults to `{}`, so a `WorkspaceStateSnapshot` serialized before this field
7049
+ * existed still decodes — and an empty index simply makes the `catalog:`
7050
+ * fallback in {@link WorkspaceStateSnapshot.resolve} inert, which is exactly
7051
+ * the behavior those older values were captured under. Only pnpm records
7052
+ * importer versions; bun and npm yield an empty index.
7053
+ */
7054
+ readonly importerVersions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.String>>>;
7010
7055
  }>, {}>;
7011
7056
  /**
7012
7057
  * The state of a whole workspace at one moment — its packages and its assembled
@@ -7056,11 +7101,43 @@ declare class WorkspaceStateSnapshot extends WorkspaceStateSnapshot_base {
7056
7101
  * unparseable string — is `Option.none()`, because there is no indirection to
7057
7102
  * resolve. Total.
7058
7103
  *
7104
+ * A `catalog:` specifier the catalog set cannot resolve falls back to this
7105
+ * snapshot's `importerVersions` — but only to a version
7106
+ * **every** importer recording that dependency agrees on. A catalog injected
7107
+ * by a config-dependency pnpmfile hook appears in no committed catalog source,
7108
+ * so without this fallback both sides of a before/after diff resolve it to the
7109
+ * same raw string and a real version movement produces no row. When importers
7110
+ * disagree there is no single correct answer, so this stays `Option.none()`
7111
+ * rather than inventing one; {@link WorkspaceStateSnapshot.resolveIn} answers
7112
+ * precisely for callers that know which importer is asking.
7113
+ *
7059
7114
  * @param dependency - The dependency's package name (what `workspace:` /
7060
7115
  * `catalog:` resolve for).
7061
7116
  * @param specifier - The raw specifier string.
7062
7117
  */
7063
7118
  resolve(dependency: string, specifier: string): Option.Option<string>;
7119
+ /**
7120
+ * The concrete range or version a specifier resolved to AS OF this snapshot,
7121
+ * scoped to the importer that declared it.
7122
+ *
7123
+ * @remarks
7124
+ * Identical to {@link WorkspaceStateSnapshot.resolve} except in how an
7125
+ * unresolvable `catalog:` specifier falls back: this consults **only**
7126
+ * `importerPath`'s own recorded versions, so a monorepo whose packages hold
7127
+ * different versions of one dependency still gets an exact answer where
7128
+ * `resolve` must abstain. Prefer this whenever the caller knows the importer —
7129
+ * a consumer iterating `packages` has `relativePath` in hand, which is the
7130
+ * importer key (`"."` for the root package).
7131
+ *
7132
+ * An unknown `importerPath`, or one recording nothing for `dependency`, is
7133
+ * `Option.none()`. Total.
7134
+ *
7135
+ * @param importerPath - The importer's path relative to the workspace root,
7136
+ * `"."` for the root package — `PackageStateSnapshot.relativePath`.
7137
+ * @param dependency - The dependency's package name.
7138
+ * @param specifier - The raw specifier string.
7139
+ */
7140
+ resolveIn(importerPath: string, dependency: string, specifier: string): Option.Option<string>;
7064
7141
  /**
7065
7142
  * A `CatalogResolver` layer implementing `@effected/npm`'s contract against
7066
7143
  * THIS snapshot's catalog set — so code written to the contract resolves
@@ -7195,7 +7272,7 @@ interface WorkspacesOptions {
7195
7272
  readonly maxDepth?: number;
7196
7273
  }
7197
7274
  //#endregion
7198
- //#region ../../node_modules/.pnpm/@effected+walker@0.3.1_@effected+glob@0.2.0_effect@4.0.0-beta.99__effect@4.0.0-beta.99/node_modules/@effected/walker/index.d.ts
7275
+ //#region ../../node_modules/.pnpm/@effected+walker@0.3.2_@effected+glob@0.2.1_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/walker/index.d.ts
7199
7276
  declare const DescendError_base: Schema.Class<DescendError, Schema.TaggedStruct<"DescendError", {
7200
7277
  /** The glob pattern's source text. */
7201
7278
  readonly pattern: Schema.String;