groq-builder: feature(compat): moved all exports to the main index, r…

…emoving the need for the `/validation` entrypoint

packages/groq-builder/docs/MIGRATION.md

@@ -26,7 +26,7 @@ const productsQuery = q("*")
 #### After, with `groq-builder`
 
 ```ts
-import { createGroqBuilderWithValidation } from "groq-builder/validation";
+import { createGroqBuilderWithValidation } from "groq-builder";
 const q = createGroqBuilderWithValidation<any>(); // Using 'any' makes the query schema-unaware 
 
 const productsQuery = q.star

packages/groq-builder/package.json

@@ -31,18 +31,10 @@
       },
       "./dist/index.js"
     ],
-    "./validation": [
-      {
-        "types": "./dist/validation/index.d.ts",
-        "default": "./dist/validation/index.js"
-      },
-      "./dist/validation/index.js"
-    ],
     "./package.json": "./package.json"
   },
   "files": [
-    "dist",
-    "validation"
+    "dist"
   ],
   "scripts": {
     "test:watch": "vitest",

packages/groq-builder/src/index.ts

@@ -1,16 +1,26 @@
-import type { RootConfig } from "./types/schema-types";
+// Be sure to keep these 2 imports in the correct order:
 import { GroqBuilder, GroqBuilderOptions } from "./groq-builder";
-import { ButFirst } from "./types/utils";
-
 import "./commands";
 
+import type { RootConfig } from "./types/schema-types";
+import type { ButFirst } from "./types/utils";
+
 // Export all our public types:
 export * from "./types/public-types";
 export * from "./types/schema-types";
 export { GroqBuilder, GroqBuilderOptions } from "./groq-builder";
+export { validate, createGroqBuilderWithValidation } from "./validation";
 
 type RootResult = never;
 
+/**
+ * Creates the root `q` query builder.
+ *
+ * The TRootConfig type argument is used to bind the query builder to the Sanity schema config.
+ * If you specify `any`, then your schema will be loosely-typed, but the output types will still be strongly typed.
+ *
+ * @param options - Allows you to specify if you want indentation added to the final query. Useful for debugging.  Defaults to none.
+ */
 export function createGroqBuilder<TRootConfig extends RootConfig>(
   options: GroqBuilderOptions = { indent: "" }
 ) {

packages/groq-builder/src/validation/index.ts

@@ -1,22 +1,14 @@
-import { primitives } from "./primitives";
-import {
-  createGroqBuilder as _createGroqBuilder,
-  RootConfig,
-  GroqBuilderOptions,
-} from "../index";
-import { sanityValidators } from "./content-block";
+import { primitiveValidators } from "./primitives";
+import { createGroqBuilder, RootConfig, GroqBuilderOptions } from "../index";
+import { sanityValidators } from "./sanity";
 
-export * from "../index";
-export { primitives } from "./primitives";
-export { sanityValidators } from "./content-block";
+export const validate = {
+  ...primitiveValidators,
+  ...sanityValidators,
+};
 
 export function createGroqBuilderWithValidation<TRootConfig extends RootConfig>(
   options?: GroqBuilderOptions
 ) {
-  return Object.assign(_createGroqBuilder<TRootConfig>(options), validate);
+  return Object.assign(createGroqBuilder<TRootConfig>(options), validate);
 }
-
-export const validate = {
-  ...primitives,
-  ...sanityValidators,
-};

packages/groq-builder/src/validation/primitives.test.ts

@@ -4,7 +4,7 @@ import { expectType } from "../tests/expectType";
 import { InferParserInput, InferParserOutput } from "../types/public-types";
 import { ValidationErrors } from "./validation-errors";
 
-describe("primitives", () => {
+describe("primitiveValidators", () => {
   it("string", () => {
     const str = validate.string();
 

packages/groq-builder/src/validation/primitives.ts

@@ -1,6 +1,6 @@
 import { ParserFunction } from "../types/public-types";
 
-export const primitives = {
+export const primitiveValidators = {
   string: memo(() => createTypeValidator("string")),
   boolean: memo(() => createTypeValidator("boolean")),
   number: memo(() => createTypeValidator("number")),

packages/groq-builder/src/validation/content-block.ts → packages/groq-builder/src/validation/sanity.ts

@@ -1,13 +1,13 @@
-import { memo, primitives } from "./primitives";
+import { memo, primitiveValidators } from "./primitives";
 
 export const sanityValidators = {
   contentBlock: memo(<
     TConfig extends ContentBlockConfig = ContentBlockConfig
-  >() => primitives.object<ContentBlock<TConfig>>()),
+  >() => primitiveValidators.object<ContentBlock<TConfig>>()),
 
   contentBlocks: memo(<
     TConfig extends ContentBlockConfig = ContentBlockConfig
-  >() => primitives.array<Array<ContentBlock<TConfig>>>()),
+  >() => primitiveValidators.array<Array<ContentBlock<TConfig>>>()),
 };
 
 export type ContentBlocks<