feat: ast node text serialization for pretty printing

.prettierignore

@@ -1,3 +1,4 @@
 .nyc_output
 dist
-tap-snapshots
+tap-snapshots
+test/fixtures

package.json

@@ -28,6 +28,12 @@
       "require": "./dist/1.js",
       "default": "./dist/1.js"
     },
+    "./experimental": {
+      "source": "./src/experimental.ts",
+      "import": "./dist/experimental.mjs",
+      "require": "./dist/experimental.js",
+      "default": "./dist/experimental.js"
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.js",
@@ -37,6 +43,9 @@
     "*": {
       "1": [
         "./dist/1.d.ts"
+      ],
+      "experimental": [
+        "./dist/experimental.d.ts"
       ]
     }
   },

src/experimental.ts

@@ -0,0 +1,40 @@
+// Experimental features - API subject to change
+
+// Re-export all the same exports as the main module for self-contained usage
+export {evaluate} from './evaluator'
+export type {GroqFunction, GroqFunctionArg, GroqPipeFunction} from './evaluator/functions'
+export type {Scope} from './evaluator/scope'
+export type {
+  Context,
+  DereferenceFunction,
+  Document,
+  EvaluateOptions,
+  Executor,
+} from './evaluator/types'
+export * from './nodeTypes'
+export {parse} from './parser'
+export type {ParseOptions} from './types'
+export type {
+  AnyStaticValue,
+  ArrayValue,
+  BooleanValue,
+  DateTimeValue,
+  GroqType,
+  NullValue,
+  NumberValue,
+  ObjectValue,
+  PathValue,
+  StaticValue,
+  StreamValue,
+  StringValue,
+  Value,
+} from './values'
+export {DateTime, Path} from './values'
+
+// Type evaluation
+export type * from './typeEvaluator'
+export {createReferenceTypeNode, typeEvaluate} from './typeEvaluator'
+
+// Experimental serializer exports
+export {serializeString} from './serializer'
+export type {SerializeOptions} from './serializer'

src/serializer/index.ts

@@ -0,0 +1,15 @@
+import type {ExprNode} from '../nodeTypes'
+import {NodeSerializer} from './nodeSerializers'
+
+export interface SerializeOptions {
+  /** Indentation string (default: "  ") */
+  indentString?: string
+}
+
+/**
+ * Serialize a GROQ AST node into formatted string
+ */
+export function serializeString(node: ExprNode, options: SerializeOptions = {}): string {
+  const serializer = new NodeSerializer({indentString: options.indentString})
+  return serializer.serialize(node)
+}