@scalar/json-magic 0.12.20 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @scalar/json-magic
 
+## 0.13.0
+
+### Minor Changes
+
+- [#9897](https://github.com/scalar/scalar/pull/9897): Export the `get-value-by-path`, `set-value-at-path`, `is-yaml`, and `is-json-object` helpers, and expose `isLocalRef`, `prefixInternalRef`, and `prefixInternalRefRecursive` from the bundle entry point.
+
+### Patch Changes
+
+- [#9898](https://github.com/scalar/scalar/pull/9898): Treat array/object container mismatches as a single update in diff instead of descending into per-index adds. Before, `diff({ tags: {} }, { tags: ['x', 'y'] })` walked the array's indices as object keys and emitted per-index `add` differences, so `apply` wrote numeric string properties onto the existing object and produced the corrupted hybrid `{ tags: { '0': 'x', '1': 'y' } }`. A container type change (either direction) is now one `update` difference carrying the full new value, and applying it replaces the container correctly.
+
 ## 0.12.20
 
 ## 0.12.19

package/dist/bundle/index.d.ts

@@ -1,3 +1,3 @@
 export type { LifecyclePlugin, LoaderPlugin, Plugin, ResolveResult } from './bundle.js';
-export { bundle, resolveAndCopyReferences } from './bundle.js';
+export { bundle, isLocalRef, prefixInternalRef, prefixInternalRefRecursive, resolveAndCopyReferences } from './bundle.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/bundle/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bundle/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACpF,OAAO,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bundle/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACpF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA"}

package/dist/bundle/index.js

@@ -1 +1 @@
-export { bundle, resolveAndCopyReferences } from './bundle.js';
+export { bundle, isLocalRef, prefixInternalRef, prefixInternalRefRecursive, resolveAndCopyReferences } from './bundle.js';

package/dist/diff/diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/diff/diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,KAAK,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,EAAE,IAAI;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAA;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,oBAyC7F,CAAA"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/diff/diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,KAAK,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,EAAE,IAAI;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAA;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,oBAiD7F,CAAA"}

package/dist/diff/diff.js

@@ -52,6 +52,13 @@ export const diff = (doc1, doc2) => {
         // We now can assume that el1 and el2 are of the same type
         // For nested objects, we need to recursively check the properties
         if (typeof el1 === 'object' && typeof el2 === 'object' && el1 !== null && el2 !== null) {
+            // A container type change (array to plain object or vice versa) is a single update.
+            // Recursing would treat array indices as object keys and produce per-key
+            // differences that corrupt the container when applied.
+            if (Array.isArray(el1) !== Array.isArray(el2)) {
+                diff.push({ path: prefix, changes: el2, type: 'update' });
+                return;
+            }
             const keys = new Set([...Object.keys(el1), ...Object.keys(el2)]);
             for (const key of keys) {
                 bfs(el1[key], el2[key], [...prefix, key]);

package/package.json

@@ -10,7 +10,7 @@
     "url": "git+https://github.com/scalar/scalar.git",
     "directory": "packages/json-magic"
   },
-  "version": "0.12.20",
+  "version": "0.13.0",
   "engines": {
     "node": ">=22"
   },
@@ -56,6 +56,11 @@
       "types": "./dist/helpers/get-segments-from-path.d.ts",
       "default": "./dist/helpers/get-segments-from-path.js"
     },
+    "./helpers/get-value-by-path": {
+      "import": "./dist/helpers/get-value-by-path.js",
+      "types": "./dist/helpers/get-value-by-path.d.ts",
+      "default": "./dist/helpers/get-value-by-path.js"
+    },
     "./helpers/is-file-path": {
       "import": "./dist/helpers/is-file-path.js",
       "types": "./dist/helpers/is-file-path.d.ts",
@@ -66,11 +71,26 @@
       "types": "./dist/helpers/is-http-url.d.ts",
       "default": "./dist/helpers/is-http-url.js"
     },
+    "./helpers/is-json-object": {
+      "import": "./dist/helpers/is-json-object.js",
+      "types": "./dist/helpers/is-json-object.d.ts",
+      "default": "./dist/helpers/is-json-object.js"
+    },
+    "./helpers/is-yaml": {
+      "import": "./dist/helpers/is-yaml.js",
+      "types": "./dist/helpers/is-yaml.d.ts",
+      "default": "./dist/helpers/is-yaml.js"
+    },
     "./helpers/normalize": {
       "import": "./dist/helpers/normalize.js",
       "types": "./dist/helpers/normalize.d.ts",
       "default": "./dist/helpers/normalize.js"
     },
+    "./helpers/set-value-at-path": {
+      "import": "./dist/helpers/set-value-at-path.js",
+      "types": "./dist/helpers/set-value-at-path.d.ts",
+      "default": "./dist/helpers/set-value-at-path.js"
+    },
     "./helpers/unescape-json-pointer": {
       "import": "./dist/helpers/unescape-json-pointer.js",
       "types": "./dist/helpers/unescape-json-pointer.d.ts",