@savvy-web/silk 2.1.1 → 2.1.3

package/changesets-changelog.d.cts

@@ -8176,8 +8176,20 @@ interface DepsRegenOptions {
   readonly cwd: string;
   /** Override the base branch used to compute the merge-base when `from` is omitted. */
   readonly base?: string;
-  /** Restrict regeneration to a single workspace package. */
+  /** Restrict regeneration to a single workspace package. Unioned with {@link DepsRegenOptions.packages}. */
   readonly package?: string;
+  /**
+   * Restrict regeneration to these workspace packages. Like `package`, an
+   * explicit target bypasses the versionable gate but NOT the changeset
+   * ignore list. Unioned with `package` when both are set.
+   */
+  readonly packages?: ReadonlyArray<string>;
+  /**
+   * Drop these packages from scope entirely — no changesets are written for
+   * them and none of their stale pure-dependency changesets are deleted.
+   * Applies to both repo-wide and explicitly-targeted runs (exclude wins).
+   */
+  readonly exclude?: ReadonlyArray<string>;
   /**
    * When `true`, retain `devDependency` rows (the `deps detect` path);
    * when falsy (the `deps regen` default), drop them unconditionally.
@@ -9246,20 +9258,74 @@ declare class VersionFiles {
    */
   static detectIndent(content: string): string;
   /**
-   * Update JSON file at specified JSONPath locations.
+   * Update a JSON (or JSONC) file at specified JSONPath locations,
+   * preserving the original formatting byte-for-byte.
    *
    * @remarks
-   * Reads the file, detects its indentation style and trailing newline
-   * preference, applies all JSONPath updates via {@link jsonPathSet},
-   * and writes the result back preserving the original formatting.
-   * Returns `undefined` if no JSONPath locations matched (no write occurs).
+   * The write is performed with `jsonc-effect`'s format-preserving
+   * `modify`/`applyEdits` rather than a `JSON.parse`/`JSON.stringify`
+   * round-trip (which always explodes inline arrays one-element-per-line and
+   * drops comments). Each JSONPath expression is resolved to concrete
+   * `(string | number)[]` paths against the parsed document, and each
+   * concrete path becomes a minimal text edit that touches only the target
+   * value's span — so inline arrays, comments,
+   * indentation, and the trailing-newline preference all survive; a one-line
+   * version bump produces a one-line diff.
+   *
+   * Insertion semantics: a concrete, wildcard-free JSONPath whose leaf
+   * property does not exist yet is inserted after the last sibling using the
+   * document's detected indent (the one case where indent detection still
+   * matters). Wildcard expressions only ever update existing matches. Returns
+   * `undefined` (no write) when nothing was updated or inserted.
    *
    * @param filePath - Absolute path to the JSON file
    * @param jsonPaths - JSONPath expressions to update
    * @param version - New version string
    * @returns Update result, or `undefined` if no changes were made
+   *
+   * @see {@link jsonPathResolve} for concrete-path enumeration
+   * @see {@link VersionFiles.applyVersionEdit} for the per-path edit
    */
   static updateFile(filePath: string, jsonPaths: readonly string[], version: string): VersionFileUpdate | undefined;
+  /**
+   * Compute the full update for a document without touching the filesystem:
+   * the edited content, the previous values at every matched path, and how
+   * many locations actually changed.
+   *
+   * @remarks
+   * This is the single decision path shared by {@link VersionFiles.updateFile}
+   * and the dry-run branches of the two process methods, so a preview reports
+   * exactly the files a real run would write — including pending inserts of a
+   * not-yet-existing wildcard-free leaf, and excluding same-value no-ops.
+   *
+   * @param original - Document text as read from disk
+   * @param jsonPaths - JSONPath expressions to update
+   * @param version - New version string
+   * @returns The updated content, previous values, and changed-location count
+   */
+  private static computeUpdate;
+  /**
+   * Compute the format-preserving edit for a single concrete path, returning
+   * the updated document, or `undefined` when nothing changed.
+   *
+   * @remarks
+   * Delegates to `jsonc-effect`'s {@link modify} + {@link applyEdits}
+   * (requires `jsonc-effect >= 0.3.1`, whose edit spans touch only the target
+   * value), so every other byte of the document is preserved. When the leaf
+   * of a wildcard-free path does not exist, `modify` inserts the property
+   * after the last sibling using the supplied formatting options — the only
+   * case where the detected indent matters. A path whose parent is missing or
+   * not an object cannot be navigated; the resulting modification error is
+   * caught and reported as "no change" so the file is left alone.
+   *
+   * @param content - Current document text
+   * @param concretePath - A wildcard-free `(string | number)[]` path
+   * @param version - New version string
+   * @param indentUnit - One indentation level, for inserted text
+   * @param eol - End-of-line sequence, for inserted text
+   * @returns The updated document, or `undefined` if the path was unchanged
+   */
+  private static applyVersionEdit;
   /**
    * Orchestrate the full version file update flow.
    *

package/changesets-changelog.d.ts

@@ -8176,8 +8176,20 @@ interface DepsRegenOptions {
   readonly cwd: string;
   /** Override the base branch used to compute the merge-base when `from` is omitted. */
   readonly base?: string;
-  /** Restrict regeneration to a single workspace package. */
+  /** Restrict regeneration to a single workspace package. Unioned with {@link DepsRegenOptions.packages}. */
   readonly package?: string;
+  /**
+   * Restrict regeneration to these workspace packages. Like `package`, an
+   * explicit target bypasses the versionable gate but NOT the changeset
+   * ignore list. Unioned with `package` when both are set.
+   */
+  readonly packages?: ReadonlyArray<string>;
+  /**
+   * Drop these packages from scope entirely — no changesets are written for
+   * them and none of their stale pure-dependency changesets are deleted.
+   * Applies to both repo-wide and explicitly-targeted runs (exclude wins).
+   */
+  readonly exclude?: ReadonlyArray<string>;
   /**
    * When `true`, retain `devDependency` rows (the `deps detect` path);
    * when falsy (the `deps regen` default), drop them unconditionally.
@@ -9246,20 +9258,74 @@ declare class VersionFiles {
    */
   static detectIndent(content: string): string;
   /**
-   * Update JSON file at specified JSONPath locations.
+   * Update a JSON (or JSONC) file at specified JSONPath locations,
+   * preserving the original formatting byte-for-byte.
    *
    * @remarks
-   * Reads the file, detects its indentation style and trailing newline
-   * preference, applies all JSONPath updates via {@link jsonPathSet},
-   * and writes the result back preserving the original formatting.
-   * Returns `undefined` if no JSONPath locations matched (no write occurs).
+   * The write is performed with `jsonc-effect`'s format-preserving
+   * `modify`/`applyEdits` rather than a `JSON.parse`/`JSON.stringify`
+   * round-trip (which always explodes inline arrays one-element-per-line and
+   * drops comments). Each JSONPath expression is resolved to concrete
+   * `(string | number)[]` paths against the parsed document, and each
+   * concrete path becomes a minimal text edit that touches only the target
+   * value's span — so inline arrays, comments,
+   * indentation, and the trailing-newline preference all survive; a one-line
+   * version bump produces a one-line diff.
+   *
+   * Insertion semantics: a concrete, wildcard-free JSONPath whose leaf
+   * property does not exist yet is inserted after the last sibling using the
+   * document's detected indent (the one case where indent detection still
+   * matters). Wildcard expressions only ever update existing matches. Returns
+   * `undefined` (no write) when nothing was updated or inserted.
    *
    * @param filePath - Absolute path to the JSON file
    * @param jsonPaths - JSONPath expressions to update
    * @param version - New version string
    * @returns Update result, or `undefined` if no changes were made
+   *
+   * @see {@link jsonPathResolve} for concrete-path enumeration
+   * @see {@link VersionFiles.applyVersionEdit} for the per-path edit
    */
   static updateFile(filePath: string, jsonPaths: readonly string[], version: string): VersionFileUpdate | undefined;
+  /**
+   * Compute the full update for a document without touching the filesystem:
+   * the edited content, the previous values at every matched path, and how
+   * many locations actually changed.
+   *
+   * @remarks
+   * This is the single decision path shared by {@link VersionFiles.updateFile}
+   * and the dry-run branches of the two process methods, so a preview reports
+   * exactly the files a real run would write — including pending inserts of a
+   * not-yet-existing wildcard-free leaf, and excluding same-value no-ops.
+   *
+   * @param original - Document text as read from disk
+   * @param jsonPaths - JSONPath expressions to update
+   * @param version - New version string
+   * @returns The updated content, previous values, and changed-location count
+   */
+  private static computeUpdate;
+  /**
+   * Compute the format-preserving edit for a single concrete path, returning
+   * the updated document, or `undefined` when nothing changed.
+   *
+   * @remarks
+   * Delegates to `jsonc-effect`'s {@link modify} + {@link applyEdits}
+   * (requires `jsonc-effect >= 0.3.1`, whose edit spans touch only the target
+   * value), so every other byte of the document is preserved. When the leaf
+   * of a wildcard-free path does not exist, `modify` inserts the property
+   * after the last sibling using the supplied formatting options — the only
+   * case where the detected indent matters. A path whose parent is missing or
+   * not an object cannot be navigated; the resulting modification error is
+   * caught and reported as "no change" so the file is left alone.
+   *
+   * @param content - Current document text
+   * @param concretePath - A wildcard-free `(string | number)[]` path
+   * @param version - New version string
+   * @param indentUnit - One indentation level, for inserted text
+   * @param eol - End-of-line sequence, for inserted text
+   * @returns The updated document, or `undefined` if the path was unchanged
+   */
+  private static applyVersionEdit;
   /**
    * Orchestrate the full version file update flow.
    *