@graphql-codegen/flutter-freezed 2.11.1

package/typings/config.d.ts

@@ -0,0 +1,453 @@
+/**
+ * @name
+ * @description Values that are passed to the `DecoratorToFreezed.applyOn` field that specifies where the custom decorator should be applied
+ */
+export declare type ApplyDecoratorOn = 'enum' | 'class' | 'class_factory' | 'union_factory' | 'class_factory_parameter' | 'union_factory_parameter';
+export declare type DecoratorToFreezed = {
+    /**
+     * @name arguments
+     * @description arrange the arguments of the directive in order of how the should be outputted
+     * @default undefined
+     * @exampleMarkdown
+     * ```yml
+     * arguments: [$0] # $0 is the first argument, $1 is the 2nd ...
+     * ```
+     */
+    arguments?: string[];
+    /**
+     * @name applyOn
+     * @description Specify where the decorator should be applied
+     * @exampleMarkdown
+     * ```yml
+     * applyOn: ['class_factory','union_factory'], # applies this decorator on both class and union factory blocks
+     * ```
+     */
+    applyOn: ApplyDecoratorOn[];
+    /**
+     * @name mapsToFreezedAs
+     * @description maps to a Freezed decorator or use `custom` to use a custom decorator */
+    mapsToFreezedAs: '@Default' | '@deprecated' | 'final' | 'directive' | 'custom';
+};
+export declare type CustomDecorator = Record<string, DecoratorToFreezed>;
+export interface FreezedConfig {
+    /**
+     * @name alwaysUseJsonKeyName
+     * @description Use @JsonKey(name: 'name') even if the name is already camelCased
+     * @default false
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       alwaysUseJsonKeyName: true
+     *
+     * ```
+     */
+    alwaysUseJsonKeyName?: boolean;
+    /**
+     * @name copyWith
+     * @description set to false to disable Freezed copyWith method helper
+     * @default undefined
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       copyWith: false
+     * ```
+     */
+    copyWith?: boolean;
+    /**
+     * @name customDecorators
+     * @description maps GraphQL directives to freezed decorators. Arguments of the directive are passed using template strings: $1 is the first argument, $2 is the second... All `mapsToFreezedAs` values except `custom` are parsed so use the name of the directive without the `@` symbol as the key of the customDecorators. With the `custom` value, whatever you use as the key of the custom directive is used just as it is, and the arguments spread into a parenthesis ()
+     * @default {}
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       customDecorators: {
+     *          'default' : {
+     *             mapsToFreezedAs: '@Default',
+     *             arguments: ['$0'],
+     *            },
+     *           'deprecated' : {
+     *              mapsToFreezedAs: '@deprecated',
+     *           },
+     *          'readonly' : {
+     *              mapsToFreezedAs: 'final',
+     *           },
+     *          '@Assert' : {
+     *              mapsToFreezedAs: 'custom',
+     *              applyOn: ['class_factory','union_factory'], # @Assert should ONLY be used on factories
+     *              arguments: [
+     *                  '(email != null && email != "") || (phoneNumber != null && phoneNumber != "")',
+     *                  'provide either an email or a phoneNumber',
+     *              ],
+     *           }, # custom are used just as it given
+     *       }
+     *
+     * ```
+     */
+    customDecorators?: CustomDecorator;
+    /**
+     * @name defaultUnionConstructor
+     * @description generate empty constructors for Union Types
+     * @default true
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       defaultUnionConstructor: true
+     * ```
+     */
+    defaultUnionConstructor?: boolean;
+    /**
+     * @name equal
+     * @description set to false to disable Freezed equal method helper
+     * @default undefined
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       equal: false
+     * ```
+     */
+    equal?: boolean;
+    /**
+     * @name fromJsonToJson
+     * @description generate fromJson toJson methods on the classes with json_serialization. Requires the [json_serializable](https://pub.dev/packages/json_serializable) to be installed in your Flutter app
+     * @default true
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       fromJsonToJson: true
+     *
+     * ```
+     */
+    fromJsonToJson?: boolean;
+    /**
+     * @name immutable
+     * @description  set to true to use the `@freezed` decorator or false to use the `@unfreezed` decorator
+     * @default true
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       immutable: true
+     *
+     * ```
+     */
+    immutable?: boolean;
+    /**
+     * @name makeCollectionsUnmodifiable
+     * @description allows collections(lists/maps) to be modified even if class is immutable
+     * @default undefined
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       makeCollectionsUnmodifiable: true
+     *
+     * ```
+     */
+    makeCollectionsUnmodifiable?: boolean;
+    /**
+     * @name mergeInputs
+     * @description merge InputTypes as a union of an ObjectType where ObjectType is denoted by a $ in the pattern.
+     * @default []
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *      mergeInputs: ["Create$Input", "Update$Input", "Delete$Input"]
+     * ```
+     */
+    mergeInputs?: string[];
+    /**
+     * @name mutableInputs
+     * @description  since inputs will be used to collect data, it makes sense to make them mutable with Freezed's `@unfreezed` decorator. This overrides(in order words: has a higher precedence than) the `immutable` config value `ONLY` for GraphQL `input types`.
+     * @default true
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       mutableInputs: true
+     *
+     * ```
+     */
+    mutableInputs?: boolean;
+    /**
+     * @name privateEmptyConstructor
+     * @description if true, defines a private empty constructor to allow getter and methods to work on the class
+     * @default true
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       privateEmptyConstructor: true
+     *
+     * ```
+     */
+    privateEmptyConstructor?: boolean;
+    /**
+     * @name unionKey
+     * @description specify the key to be used for Freezed union/sealed classes
+     * @default undefined
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       unionKey: 'type'
+     *
+     * ```
+     */
+    unionKey?: string;
+    /**
+     * @name unionValueCase
+     * @description specify the casing style to be used for Freezed union/sealed classes
+     * @default undefined
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       unionValueCase: 'FreezedUnionCase.pascal'
+     *
+     * ```
+     */
+    unionValueCase?: 'FreezedUnionCase.camel' | 'FreezedUnionCase.pascal';
+}
+export interface FieldConfig {
+    /**
+     * @name final
+     * @description marks a field as final
+     * @default undefined
+     */
+    final?: boolean;
+    /**
+     * @name deprecated
+     * @description marks a field as deprecated
+     * @default undefined
+     */
+    deprecated?: boolean;
+    /**
+     * @name defaultValue
+     * @description annotate a field with a @Default(value: defaultValue) decorator
+     * @default undefined
+     */
+    defaultValue?: any;
+    /**
+     * @name customDecorators
+     * @description specific directives to apply to the field. All `mapsToFreezedAs` values except `custom` are parsed so use the name of the directive without the `@` symbol as the key of the customDecorators. With the `custom` value, whatever you use as the key of the custom directive is used just as it is, and the arguments spread into a parenthesis ()
+     * @default undefined
+     * @exampleMarkdown
+     * ```yml
+     * customDecorators: {
+     *    'default' : {
+     *        mapsToFreezedAs: '@Default',
+     *          applyOn: ['class_factory_parameter],
+     *        arguments: ['$0'],
+     *      },
+     *      'deprecated' : {
+     *          mapsToFreezedAs: '@deprecated',
+     *          applyOn: ['union_factory_parameter],
+     *       },
+     *      'readonly' : {
+     *          mapsToFreezedAs: 'final',
+     *          applyOn: ['class_factory_parameter','union_factory_parameter'],
+     *       },
+     *      '@HiveField' : {
+     *          mapsToFreezedAs: 'custom',
+     *          applyOn: ['class_factory_parameter'],
+     *          arguments: ['1'],
+     *       }, # custom are used just as it given
+     * }
+     * ```
+     */
+    customDecorators?: CustomDecorator;
+}
+export interface TypeSpecificFreezedConfig {
+    /** marks a type as deprecated */
+    deprecated?: boolean;
+    /** overrides the `globalFreezedConfig` for this type */
+    config?: FreezedConfig;
+    /** configure fields for this type */
+    fields?: Record<string, FieldConfig>;
+}
+export interface FlutterFreezedPluginConfig {
+    /**
+     * @name customScalars
+     * @description map custom Scalars to Dart built-in types
+     * @default {}
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       customScalars:
+     *         {
+     *           "jsonb": "Map<String, dynamic>",
+     *           "timestamptz": "DateTime",
+     *           "UUID": "String",
+     *         }
+     * ```
+     */
+    customScalars?: {
+        [name: string]: string;
+    };
+    /**
+     * @name fileName
+     * @description if `modular` is set to false, this fileName will be used for the generated output file
+     * @default "app_models"
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       fileName: app_models
+     *
+     * ```
+     */
+    fileName?: string;
+    /**
+     * @name globalFreezedConfig
+     * @description use the same Freezed configuration for every generated output
+     * @default undefined
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       globalFreezedConfig:
+     *          {
+     *              immutable: false,
+     *              unionValueCase: FreezedUnionCase.pascal,
+     *          }
+     *
+     * ```
+     */
+    globalFreezedConfig?: FreezedConfig;
+    /**
+     * @name typeSpecificFreezedConfig
+     * @description override the `globalFreezedConfig` for specific types
+     * @default undefined
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       typeSpecificFreezedConfig:
+     *          {
+     *             'Starship':{
+     *                config: {
+     *                  immutable: false,
+     *                  unionValueCase: FreezedUnionCase.pascal,
+     *                },
+     *                fields: {
+     *                  'id': {
+     *                     final: true,
+     *                     defaultValue: NanoId.id(),
+     *                  },
+     *                },
+     *             },
+     *          },
+     *
+     * ```
+     */
+    typeSpecificFreezedConfig?: Record<string, TypeSpecificFreezedConfig>;
+    /**
+     * @name ignoreTypes
+     * @description names of GraphQL types to ignore when generating Freezed classes
+     * @default []
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       ignoreTypes: ["PaginatorInfo"]
+     *
+     * ```
+     */
+    ignoreTypes?: string[];
+    /**
+     * @name lowercaseEnums
+     * @description make enum fields lowercase
+     * @default true
+     *
+     * @exampleMarkdown
+     * ```yml
+     * generates:
+     *   flutter_app/lib/data/models/app_models.dart
+     *     plugins:
+     *       - flutter-freezed
+     *     config:
+     *       lowercaseEnums: true
+     * ```
+     */
+    lowercaseEnums?: boolean;
+}

package/typings/freezed-declaration-blocks/class-block.d.cts

@@ -0,0 +1,36 @@
+import { FlutterFreezedPluginConfig } from '../config.cjs';
+import { FreezedFactoryBlockRepository, NodeType } from '../utils.cjs';
+import { FreezedFactoryBlock } from './factory-block.cjs';
+export declare class FreezedDeclarationBlock {
+    private _config;
+    private _freezedFactoryBlockRepository;
+    private _node;
+    /** document the class  */
+    _comment: string;
+    /** a list of decorators to copy paste to the generator */
+    _decorators: string[];
+    /** the name of the class */
+    _name: string | undefined;
+    /** a list of default constructor and named Constructors used create a Freezed union/sealed class */
+    _factoryBlocks: FreezedFactoryBlock[];
+    /** the shape is the content of the block */
+    _shape: string | undefined;
+    /** the block is the final structure that is generated */
+    _block: string | undefined;
+    private _freezedConfigValue;
+    constructor(_config: FlutterFreezedPluginConfig, _freezedFactoryBlockRepository: FreezedFactoryBlockRepository, _node: NodeType);
+    init(): FreezedDeclarationBlock;
+    private setComment;
+    private getEnumComment;
+    private setDecorators;
+    private getFreezedDecorator;
+    private setName;
+    private setFactoryBlocks;
+    private setShape;
+    /**
+     * returns the string output of the block
+     */
+    private setBlock;
+    /** returns the block */
+    toString(): string;
+}

package/typings/freezed-declaration-blocks/class-block.d.ts

@@ -0,0 +1,36 @@
+import { FlutterFreezedPluginConfig } from '../config.js';
+import { FreezedFactoryBlockRepository, NodeType } from '../utils.js';
+import { FreezedFactoryBlock } from './factory-block.js';
+export declare class FreezedDeclarationBlock {
+    private _config;
+    private _freezedFactoryBlockRepository;
+    private _node;
+    /** document the class  */
+    _comment: string;
+    /** a list of decorators to copy paste to the generator */
+    _decorators: string[];
+    /** the name of the class */
+    _name: string | undefined;
+    /** a list of default constructor and named Constructors used create a Freezed union/sealed class */
+    _factoryBlocks: FreezedFactoryBlock[];
+    /** the shape is the content of the block */
+    _shape: string | undefined;
+    /** the block is the final structure that is generated */
+    _block: string | undefined;
+    private _freezedConfigValue;
+    constructor(_config: FlutterFreezedPluginConfig, _freezedFactoryBlockRepository: FreezedFactoryBlockRepository, _node: NodeType);
+    init(): FreezedDeclarationBlock;
+    private setComment;
+    private getEnumComment;
+    private setDecorators;
+    private getFreezedDecorator;
+    private setName;
+    private setFactoryBlocks;
+    private setShape;
+    /**
+     * returns the string output of the block
+     */
+    private setBlock;
+    /** returns the block */
+    toString(): string;
+}

package/typings/freezed-declaration-blocks/factory-block.d.cts

@@ -0,0 +1,38 @@
+import { FreezedParameterBlock } from './parameter-block.cjs';
+import { FlutterFreezedPluginConfig } from '../config.cjs';
+import { NodeType } from '../utils.cjs';
+export declare class FreezedFactoryBlock {
+    private _config;
+    private _node;
+    /** document the constructor */
+    _comment: string;
+    /** a list of decorators to copy paste to the generator */
+    _decorators: string[];
+    /** the key of the original type name */
+    _key: string | undefined;
+    /** the name of the class */
+    _name: string | undefined;
+    /** the namedConstructor is used for GraphQL Union types or if mergeInput is true */
+    _namedConstructor: string | undefined;
+    /** a list of interfaces to implements */
+    /** a list of class to mixin with */
+    /** the parameters of this factory constructor */
+    _parameters: FreezedParameterBlock[];
+    /** the shape is the content of the block */
+    _shape: string | undefined;
+    /** the block is the final structure that is generated */
+    _block: string | undefined;
+    private _freezedConfigValue;
+    constructor(_config: FlutterFreezedPluginConfig, _node: NodeType);
+    init(): FreezedFactoryBlock;
+    private setComment;
+    setDecorators(appliesOn: string, nodeName: string): FreezedFactoryBlock;
+    setKey(key: string): FreezedFactoryBlock;
+    setName(name: string): FreezedFactoryBlock;
+    setNamedConstructor(namedConstructor: string | undefined): FreezedFactoryBlock;
+    private setParameters;
+    private setShape;
+    private setBlock;
+    /** returns the block */
+    toString(): string;
+}

package/typings/freezed-declaration-blocks/factory-block.d.ts

@@ -0,0 +1,38 @@
+import { FreezedParameterBlock } from './parameter-block.js';
+import { FlutterFreezedPluginConfig } from '../config.js';
+import { NodeType } from '../utils.js';
+export declare class FreezedFactoryBlock {
+    private _config;
+    private _node;
+    /** document the constructor */
+    _comment: string;
+    /** a list of decorators to copy paste to the generator */
+    _decorators: string[];
+    /** the key of the original type name */
+    _key: string | undefined;
+    /** the name of the class */
+    _name: string | undefined;
+    /** the namedConstructor is used for GraphQL Union types or if mergeInput is true */
+    _namedConstructor: string | undefined;
+    /** a list of interfaces to implements */
+    /** a list of class to mixin with */
+    /** the parameters of this factory constructor */
+    _parameters: FreezedParameterBlock[];
+    /** the shape is the content of the block */
+    _shape: string | undefined;
+    /** the block is the final structure that is generated */
+    _block: string | undefined;
+    private _freezedConfigValue;
+    constructor(_config: FlutterFreezedPluginConfig, _node: NodeType);
+    init(): FreezedFactoryBlock;
+    private setComment;
+    setDecorators(appliesOn: string, nodeName: string): FreezedFactoryBlock;
+    setKey(key: string): FreezedFactoryBlock;
+    setName(name: string): FreezedFactoryBlock;
+    setNamedConstructor(namedConstructor: string | undefined): FreezedFactoryBlock;
+    private setParameters;
+    private setShape;
+    private setBlock;
+    /** returns the block */
+    toString(): string;
+}

package/typings/freezed-declaration-blocks/index.d.cts

@@ -0,0 +1,3 @@
+export * from './parameter-block.cjs';
+export * from './factory-block.cjs';
+export * from './class-block.cjs';

package/typings/freezed-declaration-blocks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './parameter-block.js';
+export * from './factory-block.js';
+export * from './class-block.js';

package/typings/freezed-declaration-blocks/parameter-block.d.cts

@@ -0,0 +1,45 @@
+import { ApplyDecoratorOn, FlutterFreezedPluginConfig } from '../config.cjs';
+import { FieldType, NodeType } from '../utils.cjs';
+/**
+ * maps GraphQL scalar types to Dart's scalar types
+ */
+export declare const DART_SCALARS: Record<string, string>;
+export declare class FreezedParameterBlock {
+    private _config;
+    private _appliesOn;
+    private _node;
+    private _field;
+    /** document the property */
+    _comment: string;
+    /** a list of decorators to copy paste to the generator */
+    _decorators: string[];
+    /** mark the property as required */
+    _required: boolean | undefined;
+    /** mark the property as required */
+    _type: string | undefined;
+    /** the name of the property */
+    _name: string | undefined;
+    /** the shape is the content of the block */
+    _shape: string | undefined;
+    /** the block is the final structure that is generated */
+    _block: string | undefined;
+    private _freezedConfigValue;
+    constructor(_config: FlutterFreezedPluginConfig, _appliesOn: ApplyDecoratorOn[], _node: NodeType, _field: FieldType);
+    init(): FreezedParameterBlock;
+    private setComment;
+    private setDecorators;
+    private setRequired;
+    private setType;
+    private setName;
+    /** compose the freezed constructor property */
+    private setShape;
+    /** composes the full block */
+    private setBlock;
+    private propertyType;
+    private isListType;
+    private isNonNullType;
+    private isNamedType;
+    private scalar;
+    /** returns the block */
+    toString(): string;
+}