fat-json 0.0.5 → 0.0.7

package/index.d.mts

@@ -0,0 +1,32 @@
+declare global {
+  namespace FatJsonTypes {
+    export type ArrayLiteralType = unknown[] | never[]
+    export type ObjectLiteralType = Record<PropertyKey, unknown> | Record<PropertyKey, never>
+    export type ValueType = string | number | boolean | null | bigint | ArrayLiteralType | ObjectLiteralType | Buffer | undefined | object
+
+    export namespace PathTypes {
+      export interface ArrayPathDescriptor {
+        key: PropertyKey
+        value: ValueType
+        path: string
+        context: ArrayLiteralType
+      }
+
+      export interface ObjectPathDescriptor {
+        key: PropertyKey
+        value: ValueType
+        path: string
+        context: ObjectLiteralType
+      }
+
+      export interface PathDescriptor {
+        key: PropertyKey
+        value: ValueType
+        path: string
+        context: ArrayLiteralType | ObjectLiteralType
+      }
+    }
+  }
+}
+
+export {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fat-json",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "keywords": [
     "JSON",
     "stringify",
@@ -12,7 +12,7 @@
   ],
   "main": "./src/index.mjs",
   "type": "module",
-  "types": "./src/index.d.mts",
+  "types": "./index.d.mts",
   "author": {
     "name": "Jonathan Perry for Sequence Media Limited",
     "email": "sequencemedia@sequencemedia.net",
@@ -30,14 +30,14 @@
     "test": "mocha test --recursive"
   },
   "devDependencies": {
-    "@sequencemedia/eslint-config-standard": "^0.2.83",
-    "@sequencemedia/eslint-config-typescript": "^0.1.142",
+    "@sequencemedia/eslint-config-standard": "^0.2.84",
+    "@sequencemedia/eslint-config-typescript": "^0.1.143",
     "@types/chai": "^5.2.2",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^24.5.1",
+    "@types/node": "^24.5.2",
     "@types/sinon": "^17.0.4",
     "chai": "^6.0.1",
-    "eslint": "^9.35.0",
+    "eslint": "^9.36.0",
     "globals": "^16.4.0",
     "husky": "^9.1.7",
     "mocha": "^11.7.2",
@@ -47,7 +47,8 @@
   "imports": {
     "#common": "./src/common/index.mjs",
     "#fat-json": "./src/index.mjs",
-    "#transformers": "./src/transformers/index.mjs"
+    "#transformers": "./src/transformers/index.mjs",
+    "#types": "./types/index.d.mts"
   },
   "exports": {
     "./transformers": "./src/transformers/index.mjs"

package/src/common/index.d.mts

@@ -1,4 +1,4 @@
-type ValueType = FatJsonTypes.ValueType
+export type ValueType = FatJsonTypes.ValueType
 
 declare const BIG_INT: RegExp
 

package/src/common/index.mjs

@@ -1,5 +1,5 @@
 /**
- *  @typedef {FatJsonTypes.ValueType} ValueType
+ *  @typedef {import('#types').ValueType} ValueType
  */
 
 export const BIG_INT = /^(\d+)n$/

package/src/index.d.mts

@@ -1,9 +1,11 @@
-declare global {
-  namespace FatJsonTypes {
-    export type ArrayLiteralType = unknown[] | never[]
-    export type ObjectLiteralType = Record<PropertyKey, unknown> | Record<PropertyKey, never>
-    export type ValueType = string | number | boolean | null | bigint | ArrayLiteralType | ObjectLiteralType | Buffer | undefined | object
-  }
-}
-
-export {}
+export type ArrayLiteralType = FatJsonTypes.ArrayLiteralType
+export type ObjectLiteralType = FatJsonTypes.ObjectLiteralType
+export type ValueType = FatJsonTypes.ValueType
+
+export function useReplacerWithType (replacer: (key: PropertyKey, value: ValueType, type?: string) => ValueType): (key: PropertyKey, value: ValueType) => ValueType
+
+export function useReviverWithType (reviver: (key: PropertyKey, value: ValueType, type?: string) => ValueType): (key: PropertyKey, value: ValueType) => ValueType
+
+export function useReplacerWithPath (replacer: (key: PropertyKey, value: ValueType, path?: string) => ValueType) : (key: PropertyKey, value: ValueType) => ValueType
+
+export function useReviverWithPath (reviver: (key: PropertyKey, value: ValueType, path?: string) => ValueType): (key: PropertyKey, value: ValueType) => ValueType

package/src/index.mjs

@@ -1,6 +1,7 @@
 /**
- *  @typedef {FatJsonTypes.ValueType} ValueType
+ *  @typedef {import('#types').ValueType} ValueType
  */
+
 import getPath from './replacer/index.mjs'
 import genPath from './reviver/index.mjs'
 

package/src/replacer/index.d.mts

@@ -1,5 +1,5 @@
-type ArrayLiteralType = FatJsonTypes.ArrayLiteralType
-type ObjectLiteralType = FatJsonTypes.ObjectLiteralType
-type ValueType = FatJsonTypes.ValueType
+export type ArrayLiteralType = FatJsonTypes.ArrayLiteralType
+export type ObjectLiteralType = FatJsonTypes.ObjectLiteralType
+export type ValueType = FatJsonTypes.ValueType
 
 export default function getPath (key: PropertyKey, value: ValueType, context: ArrayLiteralType | ObjectLiteralType): string

package/src/replacer/index.mjs

@@ -1,3 +1,9 @@
+/**
+ *  @typedef {import('#types').ArrayLiteralType} ArrayLiteralType
+ *  @typedef {import('#types').ObjectLiteralType} ObjectLiteralType
+ *  @typedef {import('#types').ValueType} ValueType
+ */
+
 import {
   formatNumber,
   formatString,
@@ -5,12 +11,15 @@ import {
   isObject
 } from '#common'
 
+/**
+ *  @type {WeakMap<WeakKey, ArrayLiteralType | ObjectLiteralType>}
+ */
 const MAP = new WeakMap()
 
 /**
  *  @param {PropertyKey} key
- *  @param {unknown} value
- *  @param {any} context
+ *  @param {ValueType} value
+ *  @param {ArrayLiteralType | ObjectLiteralType} context
  *  @returns {string}
  */
 export default function getPath (key, value, context) {

package/src/reviver/index.d.mts

@@ -1,5 +1,11 @@
-type ArrayLiteralType = FatJsonTypes.ArrayLiteralType
-type ObjectLiteralType = FatJsonTypes.ObjectLiteralType
-type ValueType = FatJsonTypes.ValueType
+export type ArrayLiteralType = FatJsonTypes.ArrayLiteralType
+export type ObjectLiteralType = FatJsonTypes.ObjectLiteralType
+export type ValueType = FatJsonTypes.ValueType
 
-export default function genPath (key: PropertyKey, value: ValueType, context: ArrayLiteralType | ObjectLiteralType): IterableIterator<{ key: PropertyKey; value: ValueType; path: string; context: ArrayLiteralType | ObjectLiteralType }>
+export namespace PathTypes {
+  export type ArrayPathDescriptor = FatJsonTypes.PathTypes.ArrayPathDescriptor
+  export type ObjectPathDescriptor = FatJsonTypes.PathTypes.ObjectPathDescriptor
+  export type PathDescriptor = FatJsonTypes.PathTypes.PathDescriptor
+}
+
+export default function genPath (key: PropertyKey, value: ValueType, context: ArrayLiteralType | ObjectLiteralType): IterableIterator<PathTypes.PathDescriptor>

package/src/reviver/index.mjs

@@ -1,8 +1,10 @@
 /**
- *  @typedef {FatJsonTypes.ArrayLiteralType} ArrayLiteralType
- *  @typedef {FatJsonTypes.ObjectLiteralType} ObjectLiteralType
- *  @typedef {FatJsonTypes.ValueType} ValueType
- *  @typedef {FatJsonTypes.WeakMapType} WeakMapType
+ *  @typedef {import('#types').ArrayLiteralType} ArrayLiteralType
+ *  @typedef {import('#types').ObjectLiteralType} ObjectLiteralType
+ *  @typedef {import('#types').ValueType} ValueType
+ *  @typedef {import('#types').PathTypes.ArrayPathDescriptor} PathTypes.ArrayPathDescriptor
+ *  @typedef {import('#types').PathTypes.ObjectPathDescriptor} PathTypes.ObjectPathDescriptor
+ *  @typedef {import('#types').PathTypes.PathDescriptor} PathTypes.PathDescriptor
  */
 
 import {
@@ -13,9 +15,9 @@ import {
 } from '#common'
 
 /**
- *  @param {any[]} context
+ *  @param {ArrayLiteralType} context
  *  @param {string} contextPath
- *  @returns {IterableIterator<{ key: PropertyKey; value: unknown; path: string; context: any }>}
+ *  @returns {IterableIterator<PathTypes.ArrayPathDescriptor>}
  */
 function * genPathForArray (context, contextPath) {
   for (const [key, value] of context.entries()) {
@@ -37,9 +39,9 @@ function * genPathForArray (context, contextPath) {
 }
 
 /**
- *  @param {any} context
+ *  @param {ObjectLiteralType} context
  *  @param {string} contextPath
- *  @returns {IterableIterator<{ key: PropertyKey; value: unknown; path: string; context: any }>}
+ *  @returns {IterableIterator<PathTypes.ObjectPathDescriptor>}
  */
 function * genPathForObject (context, contextPath) {
   for (const [key, value] of Object.entries(context)) {
@@ -62,9 +64,9 @@ function * genPathForObject (context, contextPath) {
 
 /**
  *  @param {PropertyKey} key
- *  @param {unknown} value
- *  @param {any | any[]} context
- *  @returns {IterableIterator<{ key: PropertyKey; value: unknown; path: string; context: any }>}
+ *  @param {ValueType} value
+ *  @param {ArrayLiteralType | ObjectLiteralType} context
+ *  @returns {IterableIterator<PathTypes.PathDescriptor>}
  */
 export default function * genPath (key, value, context) {
   const valuePath = key

package/types/index.d.mts

@@ -0,0 +1,9 @@
+export type ArrayLiteralType = FatJsonTypes.ArrayLiteralType
+export type ObjectLiteralType = FatJsonTypes.ObjectLiteralType
+export type ValueType = FatJsonTypes.ValueType
+
+export namespace PathTypes {
+  export type ArrayPathDescriptor = FatJsonTypes.PathTypes.ArrayPathDescriptor
+  export type ObjectPathDescriptor = FatJsonTypes.PathTypes.ObjectPathDescriptor
+  export type PathDescriptor = FatJsonTypes.PathTypes.PathDescriptor
+}