@savvy-web/silk 2.1.1 → 2.1.2

package/changesets-markdownlint.d.cts

@@ -9246,20 +9246,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-markdownlint.d.ts

@@ -9246,20 +9246,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.
    *