grokking simplicity and refactoring

packages/lab-tool/utils/json-new.scm

@@ -0,0 +1,48 @@
+;; utils/json.scm - JSON utilities facade
+
+(define-module (utils json)
+  #:use-module (utils json parse)
+  #:use-module (utils json serialize)
+  #:use-module (utils json file-io)
+  #:use-module (utils json validation)
+  #:use-module (utils json manipulation)
+  #:use-module (utils json pretty-print)
+  #:re-export (;; Parsing
+               parse-json-pure
+               json-string->scm-safe
+               
+               ;; Serialization
+               scm->json-string-pure
+               scm->json-string
+               
+               ;; File I/O (both pure and impure versions)
+               read-json-file-pure
+               write-json-file-pure
+               read-json-file
+               write-json-file
+               
+               ;; Validation (pure functions)
+               validate-required-keys
+               validate-types
+               validate-json-schema
+               
+               ;; Manipulation (pure functions)
+               merge-json-objects
+               flatten-json-paths
+               json-path-ref
+               json-path-set
+               
+               ;; Pretty printing
+               json-pretty-print))
+
+;; This module acts as a facade for JSON functionality,
+;; aggregating specialized modules that follow single responsibility:
+;; - parse: Pure JSON string parsing
+;; - serialize: Pure scheme-to-JSON conversion
+;; - file-io: File reading/writing with pure and impure versions
+;; - validation: Pure schema validation functions
+;; - manipulation: Pure object manipulation functions
+;; - pretty-print: Output formatting
+;;
+;; All functions are designed to be composable and testable,
+;; with pure versions available for functional programming patterns.