@baseplate-dev/react-generators 0.4.3 → 0.5.0

package/dist/writers/graphql/gql-tada.d.ts

@@ -0,0 +1,69 @@
+/**
+ * gql.tada rendering functions for generating TypeScript code with graphql() calls.
+ *
+ * This module provides functions to render GraphQL fragments and operations
+ * as TsCodeFragment objects that include the graphql() template literal call
+ * with proper imports and dependency arrays.
+ */
+import type { TsCodeFragment } from '@baseplate-dev/core-generators';
+import type { GraphQLFragment, GraphQLOperation } from './graphql.js';
+interface RenderOptions {
+    /** Whether to export the fragment/operation (default: true) */
+    exported?: boolean;
+    /** The path of the file being rendered (to determine if fragments need imports) */
+    currentPath: string;
+}
+/**
+ * Renders a GraphQL fragment as a TsCodeFragment for gql.tada.
+ *
+ * This function:
+ * 1. Renders the GraphQL fragment string
+ * 2. Collects fragment dependencies from spread fields
+ * 3. Generates imports for fragments from different files
+ * 4. Builds the graphql() call with dependency array
+ *
+ * @example
+ * ```typescript
+ * const fragment = renderTadaFragment(userRowFragment, {
+ *   currentPath: './user-table.tsx',
+ *   exported: true,
+ * });
+ * // Output:
+ * // export const userRowFragment = graphql(`
+ * //   fragment UserTable_items on User {
+ * //     id
+ * //     email
+ * //     ...RoleManagerDialog_user
+ * //   }
+ * // `, [roleManagerDialogUserFragment]);
+ * ```
+ */
+export declare function renderTadaFragment(fragment: GraphQLFragment, options: RenderOptions): TsCodeFragment;
+/**
+ * Renders a GraphQL operation (query/mutation/subscription) as a TsCodeFragment for gql.tada.
+ *
+ * This function:
+ * 1. Renders the GraphQL operation string
+ * 2. Collects fragment dependencies from spread fields
+ * 3. Generates imports for fragments from different files
+ * 4. Builds the graphql() call with dependency array
+ *
+ * @example
+ * ```typescript
+ * const query = renderTadaOperation(usersQuery, {
+ *   currentPath: './queries.ts',
+ *   exported: true,
+ * });
+ * // Output:
+ * // export const usersQuery = graphql(`
+ * //   query Users {
+ * //     users {
+ * //       ...UserTable_items
+ * //     }
+ * //   }
+ * // `, [userRowFragment]);
+ * ```
+ */
+export declare function renderTadaOperation(operation: GraphQLOperation, options: RenderOptions): TsCodeFragment;
+export {};
+//# sourceMappingURL=gql-tada.d.ts.map

package/dist/writers/graphql/gql-tada.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gql-tada.d.ts","sourceRoot":"","sources":["../../../src/writers/graphql/gql-tada.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,gCAAgC,CAAC;AAIxC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAYtE,UAAU,aAAa;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,aAAa,GACrB,cAAc,CAkChB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,aAAa,GACrB,cAAc,CAkChB"}

package/dist/writers/graphql/gql-tada.js

@@ -0,0 +1,118 @@
+/**
+ * gql.tada rendering functions for generating TypeScript code with graphql() calls.
+ *
+ * This module provides functions to render GraphQL fragments and operations
+ * as TsCodeFragment objects that include the graphql() template literal call
+ * with proper imports and dependency arrays.
+ */
+import { TsCodeUtils, tsImportBuilder } from '@baseplate-dev/core-generators';
+import { collectFragmentDependencies, renderFragment, renderOperation, } from './graphql.js';
+// ============================================================================
+// Fragment Rendering
+// ============================================================================
+/**
+ * Renders a GraphQL fragment as a TsCodeFragment for gql.tada.
+ *
+ * This function:
+ * 1. Renders the GraphQL fragment string
+ * 2. Collects fragment dependencies from spread fields
+ * 3. Generates imports for fragments from different files
+ * 4. Builds the graphql() call with dependency array
+ *
+ * @example
+ * ```typescript
+ * const fragment = renderTadaFragment(userRowFragment, {
+ *   currentPath: './user-table.tsx',
+ *   exported: true,
+ * });
+ * // Output:
+ * // export const userRowFragment = graphql(`
+ * //   fragment UserTable_items on User {
+ * //     id
+ * //     email
+ * //     ...RoleManagerDialog_user
+ * //   }
+ * // `, [roleManagerDialogUserFragment]);
+ * ```
+ */
+export function renderTadaFragment(fragment, options) {
+    const { exported = true, currentPath } = options;
+    // Collect all fragment dependencies from fields
+    const dependencies = collectFragmentDependencies(fragment.fields);
+    // Build the GraphQL string
+    const graphqlString = renderFragment(fragment);
+    // Build imports for fragments from different files
+    const imports = [
+        tsImportBuilder(['graphql']).from('@src/graphql'),
+    ];
+    const depVariableNames = [];
+    for (const dep of dependencies) {
+        depVariableNames.push(dep.variableName);
+        // Only import if from a different file
+        if (dep.path !== currentPath) {
+            imports.push(tsImportBuilder([dep.variableName]).from(dep.path));
+        }
+    }
+    // Build the graphql() call
+    const exportKeyword = exported ? 'export ' : '';
+    const depsArray = depVariableNames.length > 0 ? `, [${depVariableNames.join(', ')}]` : '';
+    const code = `${exportKeyword}const ${fragment.variableName} = graphql(\`
+${graphqlString}
+\`${depsArray});`;
+    return TsCodeUtils.templateWithImports(imports) `${code}`;
+}
+// ============================================================================
+// Operation Rendering
+// ============================================================================
+/**
+ * Renders a GraphQL operation (query/mutation/subscription) as a TsCodeFragment for gql.tada.
+ *
+ * This function:
+ * 1. Renders the GraphQL operation string
+ * 2. Collects fragment dependencies from spread fields
+ * 3. Generates imports for fragments from different files
+ * 4. Builds the graphql() call with dependency array
+ *
+ * @example
+ * ```typescript
+ * const query = renderTadaOperation(usersQuery, {
+ *   currentPath: './queries.ts',
+ *   exported: true,
+ * });
+ * // Output:
+ * // export const usersQuery = graphql(`
+ * //   query Users {
+ * //     users {
+ * //       ...UserTable_items
+ * //     }
+ * //   }
+ * // `, [userRowFragment]);
+ * ```
+ */
+export function renderTadaOperation(operation, options) {
+    const { exported, currentPath } = options;
+    // Collect all fragment dependencies from fields
+    const dependencies = collectFragmentDependencies(operation.fields);
+    // Build the GraphQL string
+    const graphqlString = renderOperation(operation);
+    // Build imports for fragments from different files
+    const imports = [
+        tsImportBuilder(['graphql']).from('@src/graphql'),
+    ];
+    const depVariableNames = [];
+    for (const dep of dependencies) {
+        depVariableNames.push(dep.variableName);
+        // Only import if from a different file
+        if (dep.path !== currentPath) {
+            imports.push(tsImportBuilder([dep.variableName]).from(dep.path));
+        }
+    }
+    // Build the graphql() call
+    const exportKeyword = exported ? 'export ' : '';
+    const depsArray = depVariableNames.length > 0 ? `, [${depVariableNames.join(', ')}]` : '';
+    const code = `${exportKeyword}const ${operation.variableName} = graphql(\`
+${graphqlString}
+\`${depsArray});`;
+    return TsCodeUtils.templateWithImports(imports) `${code}`;
+}
+//# sourceMappingURL=gql-tada.js.map

package/dist/writers/graphql/gql-tada.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gql-tada.js","sourceRoot":"","sources":["../../../src/writers/graphql/gql-tada.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAI9E,OAAO,EACL,2BAA2B,EAC3B,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AAatB,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAyB,EACzB,OAAsB;IAEtB,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEjD,gDAAgD;IAChD,MAAM,YAAY,GAAG,2BAA2B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAElE,2BAA2B;IAC3B,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE/C,mDAAmD;IACnD,MAAM,OAAO,GAA0B;QACrC,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;KAClD,CAAC;IACF,MAAM,gBAAgB,GAAa,EAAE,CAAC;IAEtC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAExC,uCAAuC;QACvC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,MAAM,SAAS,GACb,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1E,MAAM,IAAI,GAAG,GAAG,aAAa,SAAS,QAAQ,CAAC,YAAY;EAC3D,aAAa;IACX,SAAS,IAAI,CAAC;IAEhB,OAAO,WAAW,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAA,GAAG,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAA2B,EAC3B,OAAsB;IAEtB,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE1C,gDAAgD;IAChD,MAAM,YAAY,GAAG,2BAA2B,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEnE,2BAA2B;IAC3B,MAAM,aAAa,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAEjD,mDAAmD;IACnD,MAAM,OAAO,GAA0B;QACrC,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;KAClD,CAAC;IACF,MAAM,gBAAgB,GAAa,EAAE,CAAC;IAEtC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAExC,uCAAuC;QACvC,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,MAAM,SAAS,GACb,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1E,MAAM,IAAI,GAAG,GAAG,aAAa,SAAS,SAAS,CAAC,YAAY;EAC5D,aAAa;IACX,SAAS,IAAI,CAAC;IAEhB,OAAO,WAAW,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAA,GAAG,IAAI,EAAE,CAAC;AAC3D,CAAC"}

package/dist/writers/graphql/graphql.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Core GraphQL types and rendering utilities.
+ * These types are library-agnostic and can be used with any GraphQL code generation approach.
+ */
+interface GraphQLScalarValue {
+    type: 'scalar';
+    value: string | number | boolean;
+}
+interface GraphQLVariableValue {
+    type: 'variable';
+    variable: string;
+}
+type GraphQLArgumentValue = GraphQLScalarValue | GraphQLVariableValue;
+interface GraphQLArgument {
+    name: string;
+    value: GraphQLArgumentValue;
+}
+interface GraphQLVariable {
+    name: string;
+    type: string;
+}
+/**
+ * Represents a GraphQL fragment definition.
+ *
+ * @example
+ * ```typescript
+ * const userRowFragment: GraphQLFragment = {
+ *   variableName: 'userRowFragment',
+ *   fragmentName: 'UserTable_items',
+ *   onType: 'User',
+ *   fields: [{ name: 'id' }, { name: 'email' }],
+ *   path: './user-table.tsx',
+ * };
+ * ```
+ */
+export interface GraphQLFragment {
+    /** Variable name in generated code (e.g., "userRowFragment") */
+    variableName: string;
+    /** Fragment name in GraphQL (e.g., "UserTable_items") */
+    fragmentName: string;
+    /** GraphQL type the fragment applies to (e.g., "User") */
+    onType: string;
+    /** Fields to include in the fragment */
+    fields: GraphQLField[];
+    /** Path where this fragment is defined (for imports) */
+    path: string;
+}
+/**
+ * A simple field with a name, optional arguments, and optional nested fields.
+ */
+interface GraphQLSimpleField {
+    type?: 'simple' | undefined;
+    name: string;
+    args?: GraphQLArgument[];
+    fields?: GraphQLField[];
+    /** Used for sorting fields in output */
+    order?: number;
+}
+/**
+ * A fragment spread that references a GraphQLFragment.
+ * This enables automatic dependency tracking and import generation.
+ *
+ * @example
+ * ```typescript
+ * const field: GraphQLSpreadField = {
+ *   type: 'spread',
+ *   fragment: userRowFragment,
+ * };
+ * // Renders as: ...UserTable_items
+ * ```
+ */
+interface GraphQLSpreadField {
+    type: 'spread';
+    fragment: GraphQLFragment;
+}
+export type GraphQLField = GraphQLSimpleField | GraphQLSpreadField;
+/**
+ * Represents a GraphQL operation (query, mutation, or subscription).
+ *
+ * @example
+ * ```typescript
+ * const usersQuery: GraphQLOperation = {
+ *   type: 'query',
+ *   variableName: 'usersQuery',
+ *   operationName: 'Users',
+ *   fields: [{
+ *     name: 'users',
+ *     fields: [{ type: 'spread', fragment: userRowFragment }],
+ *   }],
+ * };
+ * ```
+ */
+export interface GraphQLOperation {
+    type: 'query' | 'mutation' | 'subscription';
+    /** Variable name in generated code (e.g., "usersQuery") */
+    variableName: string;
+    /** Operation name in GraphQL (e.g., "Users") */
+    operationName: string;
+    /** GraphQL variables for the operation */
+    variables?: GraphQLVariable[];
+    /** Fields to include in the operation */
+    fields: GraphQLField[];
+}
+export declare function isSimpleField(field: GraphQLField): field is GraphQLSimpleField;
+export declare function isSpreadField(field: GraphQLField): field is GraphQLSpreadField;
+/**
+ * Renders an array of GraphQL fields to a string.
+ * Fields are sorted by: simple fields first, then spread fields, then nested fields.
+ */
+export declare function renderFields(fields: GraphQLField[]): string;
+/**
+ * Renders a GraphQL fragment definition to a string.
+ */
+export declare function renderFragment(fragment: GraphQLFragment): string;
+/**
+ * Renders a GraphQL operation (query/mutation/subscription) to a string.
+ */
+export declare function renderOperation(operation: GraphQLOperation): string;
+/**
+ * Merges an array of GraphQL fields, combining fields with the same name.
+ */
+export declare function mergeGraphqlFields(fields: GraphQLField[]): GraphQLField[];
+/**
+ * Checks if two arrays of GraphQL fields are identical.
+ */
+export declare function areFieldsIdentical(fieldsOne: GraphQLField[], fieldsTwo: GraphQLField[]): boolean;
+/**
+ * Collects all GraphQLFragment dependencies from a list of fields.
+ * Walks the field tree recursively to find all spread fields.
+ */
+export declare function collectFragmentDependencies(fields: GraphQLField[]): GraphQLFragment[];
+export {};
+//# sourceMappingURL=graphql.d.ts.map

package/dist/writers/graphql/graphql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../../../src/writers/graphql/graphql.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,UAAU,kBAAkB;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,oBAAoB,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;AAEtE,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAMD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;CACd;AAMD;;GAEG;AACH,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,UAAU,kBAAkB;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAMnE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IAC5C,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,yCAAyC;IACzC,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAMD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,GAClB,KAAK,IAAI,kBAAkB,CAE7B;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,GAClB,KAAK,IAAI,kBAAkB,CAE7B;AAuED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAc3D;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAIhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAcnE;AAgCD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAmBzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,YAAY,EAAE,EACzB,SAAS,EAAE,YAAY,EAAE,GACxB,OAAO,CAET;AAMD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,YAAY,EAAE,GACrB,eAAe,EAAE,CAmBnB"}

package/dist/writers/graphql/graphql.js

@@ -0,0 +1,188 @@
+/**
+ * Core GraphQL types and rendering utilities.
+ * These types are library-agnostic and can be used with any GraphQL code generation approach.
+ */
+import { isEqual, sortBy } from 'es-toolkit';
+// ============================================================================
+// Type Guards
+// ============================================================================
+export function isSimpleField(field) {
+    return field.type === 'simple' || field.type === undefined;
+}
+export function isSpreadField(field) {
+    return field.type === 'spread';
+}
+// ============================================================================
+// Rendering Utilities
+// ============================================================================
+function indent(text) {
+    return text
+        .split('\n')
+        .map((line) => line && `  ${line}`)
+        .join('\n');
+}
+function renderArgumentValue(value) {
+    switch (value.type) {
+        case 'scalar': {
+            switch (typeof value.value) {
+                case 'string': {
+                    return `"${value.value}"`;
+                }
+                case 'number':
+                case 'boolean': {
+                    return value.value.toString();
+                }
+                default: {
+                    throw new Error(`Unsupported GraphQL scalar value type: ${typeof value.value}`);
+                }
+            }
+        }
+        case 'variable': {
+            return `$${value.variable}`;
+        }
+        default: {
+            throw new Error(`Unknown GraphQL value type: ${value.type}`);
+        }
+    }
+}
+function renderArgument({ name, value }) {
+    return `${name}: ${renderArgumentValue(value)}`;
+}
+function renderSimpleField({ name, args, fields }) {
+    let fieldDefinition = name;
+    if (args?.length) {
+        fieldDefinition += `(${args.map((arg) => renderArgument(arg)).join(', ')})`;
+    }
+    if (fields?.length) {
+        fieldDefinition += ` {\n${indent(renderFields(fields))}\n}`;
+    }
+    return fieldDefinition;
+}
+function renderSpreadField(field) {
+    return `...${field.fragment.fragmentName}`;
+}
+function renderField(field) {
+    if (isSpreadField(field)) {
+        return renderSpreadField(field);
+    }
+    return renderSimpleField(field);
+}
+/**
+ * Renders an array of GraphQL fields to a string.
+ * Fields are sorted by: simple fields first, then spread fields, then nested fields.
+ */
+export function renderFields(fields) {
+    const sortedFields = sortBy(fields, [
+        // Sort by: simple fields, spread fields, then nested fields
+        (f) => {
+            if (isSpreadField(f))
+                return 1;
+            if (isSimpleField(f) && f.fields?.length)
+                return 2;
+            return 0;
+        },
+        // Sort by order if provided
+        (f) => (isSimpleField(f) ? (f.order ?? 0) : 0),
+        // Sort by name/fragment name
+        (f) => (isSpreadField(f) ? f.fragment.fragmentName : f.name),
+    ]);
+    return sortedFields.map((field) => renderField(field)).join('\n');
+}
+function renderVariable({ name, type }) {
+    return `$${name}: ${type}`;
+}
+/**
+ * Renders a GraphQL fragment definition to a string.
+ */
+export function renderFragment(fragment) {
+    return `fragment ${fragment.fragmentName} on ${fragment.onType} {
+${indent(renderFields(fragment.fields))}
+}`;
+}
+/**
+ * Renders a GraphQL operation (query/mutation/subscription) to a string.
+ */
+export function renderOperation(operation) {
+    let opString = operation.type;
+    if (operation.operationName) {
+        opString += ` ${operation.operationName}`;
+    }
+    if (operation.variables?.length) {
+        opString += `(${operation.variables.map((v) => renderVariable(v)).join(', ')})`;
+    }
+    opString += ` {\n${indent(renderFields(operation.fields))}\n}`;
+    return opString;
+}
+// ============================================================================
+// Field Merging Utilities
+// ============================================================================
+/**
+ * Checks if two fields are mergeable (same name/fragment with compatible args).
+ */
+function areFieldsMergeable(fieldOne, fieldTwo) {
+    if (isSimpleField(fieldOne) && isSimpleField(fieldTwo)) {
+        if (fieldOne.name !== fieldTwo.name) {
+            return false;
+        }
+        if (!isEqual(fieldOne.args, fieldTwo.args)) {
+            throw new Error(`Unable to merge fields with different args: ${fieldOne.name}`);
+        }
+        return true;
+    }
+    if (isSpreadField(fieldOne) && isSpreadField(fieldTwo)) {
+        return fieldOne.fragment.fragmentName === fieldTwo.fragment.fragmentName;
+    }
+    return false;
+}
+/**
+ * Merges an array of GraphQL fields, combining fields with the same name.
+ */
+export function mergeGraphqlFields(fields) {
+    const mergedFields = [];
+    for (const field of fields) {
+        const existingField = mergedFields.find((f) => areFieldsMergeable(f, field));
+        if (existingField && isSimpleField(existingField) && isSimpleField(field)) {
+            existingField.fields = mergeGraphqlFields([
+                ...(existingField.fields ?? []),
+                ...(field.fields ?? []),
+            ]);
+        }
+        else if (!existingField) {
+            mergedFields.push(field);
+        }
+    }
+    return mergedFields;
+}
+/**
+ * Checks if two arrays of GraphQL fields are identical.
+ */
+export function areFieldsIdentical(fieldsOne, fieldsTwo) {
+    return isEqual(fieldsOne, fieldsTwo);
+}
+// ============================================================================
+// Dependency Collection
+// ============================================================================
+/**
+ * Collects all GraphQLFragment dependencies from a list of fields.
+ * Walks the field tree recursively to find all spread fields.
+ */
+export function collectFragmentDependencies(fields) {
+    const fragments = [];
+    const seen = new Set();
+    function walk(fieldList) {
+        for (const field of fieldList) {
+            if (isSpreadField(field)) {
+                if (!seen.has(field.fragment.variableName)) {
+                    seen.add(field.fragment.variableName);
+                    fragments.push(field.fragment);
+                }
+            }
+            else if (field.fields) {
+                walk(field.fields);
+            }
+        }
+    }
+    walk(fields);
+    return fragments;
+}
+//# sourceMappingURL=graphql.js.map

package/dist/writers/graphql/graphql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../../../src/writers/graphql/graphql.ts"],"names":[],"mappings":"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"}

package/dist/writers/graphql/index.d.ts

@@ -1,66 +1,3 @@
-interface GraphQLArgumentScalarValue {
-    type: 'scalar';
-    value: string | number | boolean;
-}
-interface GraphQLArgumentVariableValue {
-    type: 'variable';
-    variable: string;
-}
-type GraphQLArgumentValue = GraphQLArgumentScalarValue | GraphQLArgumentVariableValue;
-interface GraphQLArgument {
-    name: string;
-    value: GraphQLArgumentValue;
-}
-interface GraphQLSimpleField {
-    type?: 'simple' | undefined;
-    name: string;
-    args?: GraphQLArgument[];
-    fields?: GraphQLField[];
-    order?: number;
-}
-interface GraphQLSpreadField {
-    type: 'spread';
-    on: string;
-}
-export type GraphQLField = GraphQLSimpleField | GraphQLSpreadField;
-interface GraphQLVariable {
-    name: string;
-    type: string;
-}
-export interface GraphQLRoot {
-    type: 'query' | 'mutation' | 'subscription';
-    name?: string;
-    variables?: GraphQLVariable[];
-    fields: GraphQLField[];
-}
-export interface GraphQLFragment {
-    name: string;
-    type: string;
-    fields: GraphQLField[];
-}
-export declare function renderGraphQLFragment({ name, type, fields, }: GraphQLFragment): string;
-export declare function renderGraphQLRoot({ type, name, variables, fields, }: GraphQLRoot): string;
-/**
- * Merges an array of `GraphQLField` objects, combining any mergeable fields.
- *
- * This function iterates through the input fields, merging entries that are determined to be mergeable
- * based on `areFieldsMergeable`. Non-mergeable fields are added directly to the result.
- *
- * @param fields - An array of `GraphQLField` objects to merge.
- * @returns An array of merged `GraphQLField` objects.
- */
-export declare function mergeGraphQLFields(fields: GraphQLField[]): GraphQLField[];
-/**
- * Merges an array of `GraphQLFragment` objects, combining any mergeable fragments.
- *
- * This function iterates through the input fragments and merges entries that are determined to be
- * mergeable based on `areFragmentsMergeable`. If fragments are mergeable, their `fields` are merged
- * using `mergeGraphQLFields`. Non-mergeable fragments are added directly to the result.
- *
- * @param frags - An array of `GraphQLFragment` objects to merge.
- * @returns An array of merged `GraphQLFragment` objects.
- */
-export declare function mergeGraphQLFragments(frags: GraphQLFragment[]): GraphQLFragment[];
-export declare function areFieldsIdentical(fieldsOne: GraphQLField[], fieldsTwo: GraphQLField[]): boolean;
-export {};
+export * from './gql-tada.js';
+export * from './graphql.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/writers/graphql/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/writers/graphql/index.ts"],"names":[],"mappings":"AAEA,UAAU,0BAA0B;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,UAAU,4BAA4B;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,KAAK,oBAAoB,GACrB,0BAA0B,GAC1B,4BAA4B,CAAC;AAEjC,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAED,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAEnE,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAqGD,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,IAAI,EACJ,MAAM,GACP,EAAE,eAAe,GAAG,MAAM,CAI1B;AAMD,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,MAAM,GACP,EAAE,WAAW,GAAG,MAAM,CAatB;AA2CD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAsBzE;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EAAE,GACvB,eAAe,EAAE,CAsBnB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,YAAY,EAAE,EACzB,SAAS,EAAE,YAAY,EAAE,GACxB,OAAO,CAET"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/writers/graphql/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}