@savvy-web/silk 3.2.1 → 3.2.2

package/changesets-markdownlint.d.cts

@@ -5659,7 +5659,7 @@ declare class Package extends Package_base {
   toJsonString(options?: PackageFormatOptions): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.6.2_@effected+jsonc@0.5.1_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/index.d.ts
+//#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
 //#region src/WorkspacePackage.d.ts
 declare const PublishConfig_base: Schema.Class<PublishConfig, Schema.Struct<{
   /** Scoped-package visibility. Its presence overrides `private`. */
@@ -6747,6 +6747,26 @@ declare class PublishabilityDetector extends PublishabilityDetector_base {
 }
 //#endregion
 //#region src/WorkspaceCatalogs.d.ts
+/**
+ * Each importer's dependency-name → resolved-version map, keyed by importer path
+ * (`"."` for the root package — the same keys `WorkspaceDiscovery.importerMap()`
+ * uses, and the same value `PackageStateSnapshot.relativePath` carries).
+ *
+ * @remarks
+ * What a manager's lockfile records as actually installed, as opposed to what a
+ * manifest declares. It answers a `catalog:` specifier no committed catalog
+ * source declares — the shape a pnpm config-dependency pnpmfile hook produces —
+ * which would otherwise resolve to nothing on both sides of a diff and hide a
+ * real version movement.
+ *
+ * Versions are normalized: pnpm's peer-disambiguation suffix
+ * (`1.2.3(effect@4.0.0)`) is stripped, and `link:` / `file:` entries are omitted
+ * because a filesystem edge is not a version. Only pnpm records importer
+ * versions; bun and npm yield an empty index.
+ *
+ * @public
+ */
+type ImporterVersions = Readonly<Record<string, Readonly<Record<string, string>>>>;
 declare const CatalogSet_base: Schema.Class<CatalogSet, Schema.Struct<{
   /** Catalog name → dependency name → version range. */
   readonly entries: Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.String>>;
@@ -6879,6 +6899,19 @@ interface WorkspaceCatalogsShape {
    * workspace) has no release-age keys, so the gate is the inert zero gate.
    */
   readonly releaseAgeGate: () => Effect.Effect<ReleaseAgeGate, CatalogAssemblyFailure>;
+  /**
+   * Each importer's dependency-name → resolved-version map, as the manager's
+   * lockfile records it. Read from the same single lockfile read as `set`, and
+   * memoized with it.
+   *
+   * @remarks
+   * Feeds `WorkspaceStateSnapshot`'s fallback for a `catalog:` specifier no
+   * committed catalog source declares — the shape a config-dependency pnpmfile
+   * hook produces. Only pnpm records importer versions; a bun or npm workspace
+   * yields an empty index, and an absent or unreadable lockfile contributes
+   * nothing rather than failing.
+   */
+  readonly importerVersions: () => Effect.Effect<ImporterVersions, CatalogAssemblyFailure>;
 }
 /**
  * Options for the {@link WorkspaceCatalogs} layer.
@@ -7007,6 +7040,18 @@ declare const WorkspaceStateSnapshot_base: Schema.Class<WorkspaceStateSnapshot,
   readonly packages: Schema.$Array<typeof PackageStateSnapshot>;
   /** The catalog set assembled at this moment. */
   readonly catalogs: typeof CatalogSet;
+  /**
+   * Each importer's dependency-name → resolved-version map, as the manager's
+   * lockfile recorded it at this moment.
+   *
+   * @remarks
+   * Defaults to `{}`, so a `WorkspaceStateSnapshot` serialized before this field
+   * existed still decodes — and an empty index simply makes the `catalog:`
+   * fallback in {@link WorkspaceStateSnapshot.resolve} inert, which is exactly
+   * the behavior those older values were captured under. Only pnpm records
+   * importer versions; bun and npm yield an empty index.
+   */
+  readonly importerVersions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.String>>>;
 }>, {}>;
 /**
  * The state of a whole workspace at one moment — its packages and its assembled
@@ -7056,11 +7101,43 @@ declare class WorkspaceStateSnapshot extends WorkspaceStateSnapshot_base {
    * unparseable string — is `Option.none()`, because there is no indirection to
    * resolve. Total.
    *
+   * A `catalog:` specifier the catalog set cannot resolve falls back to this
+   * snapshot's `importerVersions` — but only to a version
+   * **every** importer recording that dependency agrees on. A catalog injected
+   * by a config-dependency pnpmfile hook appears in no committed catalog source,
+   * so without this fallback both sides of a before/after diff resolve it to the
+   * same raw string and a real version movement produces no row. When importers
+   * disagree there is no single correct answer, so this stays `Option.none()`
+   * rather than inventing one; {@link WorkspaceStateSnapshot.resolveIn} answers
+   * precisely for callers that know which importer is asking.
+   *
    * @param dependency - The dependency's package name (what `workspace:` /
    *   `catalog:` resolve for).
    * @param specifier - The raw specifier string.
    */
   resolve(dependency: string, specifier: string): Option.Option<string>;
+  /**
+   * The concrete range or version a specifier resolved to AS OF this snapshot,
+   * scoped to the importer that declared it.
+   *
+   * @remarks
+   * Identical to {@link WorkspaceStateSnapshot.resolve} except in how an
+   * unresolvable `catalog:` specifier falls back: this consults **only**
+   * `importerPath`'s own recorded versions, so a monorepo whose packages hold
+   * different versions of one dependency still gets an exact answer where
+   * `resolve` must abstain. Prefer this whenever the caller knows the importer —
+   * a consumer iterating `packages` has `relativePath` in hand, which is the
+   * importer key (`"."` for the root package).
+   *
+   * An unknown `importerPath`, or one recording nothing for `dependency`, is
+   * `Option.none()`. Total.
+   *
+   * @param importerPath - The importer's path relative to the workspace root,
+   *   `"."` for the root package — `PackageStateSnapshot.relativePath`.
+   * @param dependency - The dependency's package name.
+   * @param specifier - The raw specifier string.
+   */
+  resolveIn(importerPath: string, dependency: string, specifier: string): Option.Option<string>;
   /**
    * A `CatalogResolver` layer implementing `@effected/npm`'s contract against
    * THIS snapshot's catalog set — so code written to the contract resolves

package/changesets-markdownlint.d.ts

@@ -5659,7 +5659,7 @@ declare class Package extends Package_base {
   toJsonString(options?: PackageFormatOptions): string;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@effected+workspaces@0.6.2_@effected+jsonc@0.5.1_effect@4.0.0-beta.101__effect@4.0.0-beta.101/node_modules/@effected/workspaces/index.d.ts
+//#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
 //#region src/WorkspacePackage.d.ts
 declare const PublishConfig_base: Schema.Class<PublishConfig, Schema.Struct<{
   /** Scoped-package visibility. Its presence overrides `private`. */
@@ -6747,6 +6747,26 @@ declare class PublishabilityDetector extends PublishabilityDetector_base {
 }
 //#endregion
 //#region src/WorkspaceCatalogs.d.ts
+/**
+ * Each importer's dependency-name → resolved-version map, keyed by importer path
+ * (`"."` for the root package — the same keys `WorkspaceDiscovery.importerMap()`
+ * uses, and the same value `PackageStateSnapshot.relativePath` carries).
+ *
+ * @remarks
+ * What a manager's lockfile records as actually installed, as opposed to what a
+ * manifest declares. It answers a `catalog:` specifier no committed catalog
+ * source declares — the shape a pnpm config-dependency pnpmfile hook produces —
+ * which would otherwise resolve to nothing on both sides of a diff and hide a
+ * real version movement.
+ *
+ * Versions are normalized: pnpm's peer-disambiguation suffix
+ * (`1.2.3(effect@4.0.0)`) is stripped, and `link:` / `file:` entries are omitted
+ * because a filesystem edge is not a version. Only pnpm records importer
+ * versions; bun and npm yield an empty index.
+ *
+ * @public
+ */
+type ImporterVersions = Readonly<Record<string, Readonly<Record<string, string>>>>;
 declare const CatalogSet_base: Schema.Class<CatalogSet, Schema.Struct<{
   /** Catalog name → dependency name → version range. */
   readonly entries: Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.String>>;
@@ -6879,6 +6899,19 @@ interface WorkspaceCatalogsShape {
    * workspace) has no release-age keys, so the gate is the inert zero gate.
    */
   readonly releaseAgeGate: () => Effect.Effect<ReleaseAgeGate, CatalogAssemblyFailure>;
+  /**
+   * Each importer's dependency-name → resolved-version map, as the manager's
+   * lockfile records it. Read from the same single lockfile read as `set`, and
+   * memoized with it.
+   *
+   * @remarks
+   * Feeds `WorkspaceStateSnapshot`'s fallback for a `catalog:` specifier no
+   * committed catalog source declares — the shape a config-dependency pnpmfile
+   * hook produces. Only pnpm records importer versions; a bun or npm workspace
+   * yields an empty index, and an absent or unreadable lockfile contributes
+   * nothing rather than failing.
+   */
+  readonly importerVersions: () => Effect.Effect<ImporterVersions, CatalogAssemblyFailure>;
 }
 /**
  * Options for the {@link WorkspaceCatalogs} layer.
@@ -7007,6 +7040,18 @@ declare const WorkspaceStateSnapshot_base: Schema.Class<WorkspaceStateSnapshot,
   readonly packages: Schema.$Array<typeof PackageStateSnapshot>;
   /** The catalog set assembled at this moment. */
   readonly catalogs: typeof CatalogSet;
+  /**
+   * Each importer's dependency-name → resolved-version map, as the manager's
+   * lockfile recorded it at this moment.
+   *
+   * @remarks
+   * Defaults to `{}`, so a `WorkspaceStateSnapshot` serialized before this field
+   * existed still decodes — and an empty index simply makes the `catalog:`
+   * fallback in {@link WorkspaceStateSnapshot.resolve} inert, which is exactly
+   * the behavior those older values were captured under. Only pnpm records
+   * importer versions; bun and npm yield an empty index.
+   */
+  readonly importerVersions: Schema.optionalKey<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.String>>>;
 }>, {}>;
 /**
  * The state of a whole workspace at one moment — its packages and its assembled
@@ -7056,11 +7101,43 @@ declare class WorkspaceStateSnapshot extends WorkspaceStateSnapshot_base {
    * unparseable string — is `Option.none()`, because there is no indirection to
    * resolve. Total.
    *
+   * A `catalog:` specifier the catalog set cannot resolve falls back to this
+   * snapshot's `importerVersions` — but only to a version
+   * **every** importer recording that dependency agrees on. A catalog injected
+   * by a config-dependency pnpmfile hook appears in no committed catalog source,
+   * so without this fallback both sides of a before/after diff resolve it to the
+   * same raw string and a real version movement produces no row. When importers
+   * disagree there is no single correct answer, so this stays `Option.none()`
+   * rather than inventing one; {@link WorkspaceStateSnapshot.resolveIn} answers
+   * precisely for callers that know which importer is asking.
+   *
    * @param dependency - The dependency's package name (what `workspace:` /
    *   `catalog:` resolve for).
    * @param specifier - The raw specifier string.
    */
   resolve(dependency: string, specifier: string): Option.Option<string>;
+  /**
+   * The concrete range or version a specifier resolved to AS OF this snapshot,
+   * scoped to the importer that declared it.
+   *
+   * @remarks
+   * Identical to {@link WorkspaceStateSnapshot.resolve} except in how an
+   * unresolvable `catalog:` specifier falls back: this consults **only**
+   * `importerPath`'s own recorded versions, so a monorepo whose packages hold
+   * different versions of one dependency still gets an exact answer where
+   * `resolve` must abstain. Prefer this whenever the caller knows the importer —
+   * a consumer iterating `packages` has `relativePath` in hand, which is the
+   * importer key (`"."` for the root package).
+   *
+   * An unknown `importerPath`, or one recording nothing for `dependency`, is
+   * `Option.none()`. Total.
+   *
+   * @param importerPath - The importer's path relative to the workspace root,
+   *   `"."` for the root package — `PackageStateSnapshot.relativePath`.
+   * @param dependency - The dependency's package name.
+   * @param specifier - The raw specifier string.
+   */
+  resolveIn(importerPath: string, dependency: string, specifier: string): Option.Option<string>;
   /**
    * A `CatalogResolver` layer implementing `@effected/npm`'s contract against
    * THIS snapshot's catalog set — so code written to the contract resolves