refactor(forms): Break logic.ts into separate files

This would make it easier to navigate

Author: kirjs

packages/forms/signals/compat/src/api/compat_validation_error.ts

@@ -8,7 +8,7 @@
 
 import {AbstractControl} from '@angular/forms';
 import {FieldTree} from '../../../src/api/types';
-import {ValidationError} from '../../../src/api/validation_errors';
+import {ValidationError} from '../../../src/api/rules/validation/validation_errors';
 
 /**
  * An error used for compat errors.

packages/forms/signals/compat/src/compat_validation_state.ts

@@ -8,7 +8,7 @@
 
 import {computed, Signal} from '@angular/core';
 import {AbstractControl} from '@angular/forms';
-import {ValidationError} from '../../src/api/validation_errors';
+import {ValidationError} from '../../src/api/rules/validation/validation_errors';
 import {calculateValidationSelfStatus, ValidationState} from '../../src/field/validation';
 import type {CompatValidationError} from './api/compat_validation_error';
 import {getControlStatusSignal} from './compat_field_node';

packages/forms/signals/public_api.ts

@@ -11,14 +11,12 @@
  * @description
  * Entry point for all public APIs of this package.
  */
-export * from './src/api/async';
 export * from './src/api/control';
-export * from './src/api/debounce';
+export * from './src/api/rules/debounce';
 export * from './src/api/di';
 export * from './src/api/field_directive';
-export * from './src/api/logic';
-export * from './src/api/metadata';
+export * from './src/api/rules';
+export * from './src/api/rules/metadata';
 export * from './src/api/structure';
 export * from './src/api/types';
-export * from './src/api/validation_errors';
-export * from './src/api/validators';
+export * from './src/api/rules/validation/validation_errors';

packages/forms/signals/src/api/control.ts

@@ -8,7 +8,7 @@
 
 import {InputSignal, InputSignalWithTransform, ModelSignal, OutputRef} from '@angular/core';
 import type {DisabledReason} from './types';
-import {ValidationError, type WithOptionalField} from './validation_errors';
+import {ValidationError, type WithOptionalField} from './rules/validation/validation_errors';
 
 /**
  * The base set of properties shared by all form control contracts.

packages/forms/signals/src/api/logic.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+
+import {FieldPathNode} from '../../schema/path_node';
+import {assertPathIsCurrent} from '../../schema/schema';
+import {AggregateMetadataKey} from './metadata';
+import type {SchemaPath, LogicFn, PathKind, SchemaPathRules} from '../types';
+
+/**
+ * Adds a value to an {@link AggregateMetadataKey} of a field.
+ *
+ * @param path The target path to set the aggregate metadata on.
+ * @param key The aggregate metadata key
+ * @param logic A function that receives the `FieldContext` and returns a value to add to the aggregate metadata.
+ * @template TValue The type of value stored in the field the logic is bound to.
+ * @template TMetadataItem The type of value the metadata aggregates over.
+ * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
+ *
+ * @category logic
+ * @experimental 21.0.0
+ */
+export function aggregateMetadata<
+  TValue,
+  TMetadataItem,
+  TPathKind extends PathKind = PathKind.Root,
+>(
+  path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>,
+  key: AggregateMetadataKey<any, TMetadataItem>,
+  logic: NoInfer<LogicFn<TValue, TMetadataItem, TPathKind>>,
+): void {
+  assertPathIsCurrent(path);
+
+  const pathNode = FieldPathNode.unwrapFieldPath(path);
+  pathNode.builder.addAggregateMetadataRule(key, logic);
+}

packages/forms/signals/src/api/rules/aggregate_metadata.ts

@@ -6,10 +6,10 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
-import {DEBOUNCER} from '../field/debounce';
-import {FieldPathNode} from '../schema/path_node';
-import {assertPathIsCurrent} from '../schema/schema';
-import type {Debouncer, PathKind, SchemaPath, SchemaPathRules} from './types';
+import {DEBOUNCER} from '../../field/debounce';
+import {FieldPathNode} from '../../schema/path_node';
+import {assertPathIsCurrent} from '../../schema/schema';
+import type {Debouncer, PathKind, SchemaPath, SchemaPathRules} from '../types';
 
 /**
  * Configures the frequency at which a form field is updated by UI events.

…ckages/forms/signals/src/api/debounce.ts …/forms/signals/src/api/rules/debounce.tspackages/forms/signals/src/api/debounce.ts renamed to packages/forms/signals/src/api/rules/debounce.ts packages/forms/signals/src/api/debounce.ts renamed to packages/forms/signals/src/api/rules/debounce.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+
+import {FieldPathNode} from '../../schema/path_node';
+import {assertPathIsCurrent} from '../../schema/schema';
+import type {FieldContext, SchemaPath, LogicFn, PathKind, SchemaPathRules} from '../types';
+
+/**
+ * Adds logic to a field to conditionally disable it. A disabled field does not contribute to the
+ * validation, touched/dirty, or other state of its parent field.
+ *
+ * @param path The target path to add the disabled logic to.
+ * @param logic A reactive function that returns `true` (or a string reason) when the field is disabled,
+ *   and `false` when it is not disabled.
+ * @template TValue The type of value stored in the field the logic is bound to.
+ * @template TPathKind The kind of path the logic is bound to (a root path, child path, or item of an array)
+ *
+ * @category logic
+ * @experimental 21.0.0
+ */
+export function disabled<TValue, TPathKind extends PathKind = PathKind.Root>(
+  path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>,
+  logic?: string | NoInfer<LogicFn<TValue, boolean | string, TPathKind>>,
+): void {
+  assertPathIsCurrent(path);
+
+  const pathNode = FieldPathNode.unwrapFieldPath(path);
+  pathNode.builder.addDisabledReasonRule((ctx) => {
+    let result: boolean | string = true;
+    if (typeof logic === 'string') {
+      result = logic;
+    } else if (logic) {
+      result = logic(ctx as FieldContext<TValue, TPathKind>);
+    }
+    if (typeof result === 'string') {
+      return {field: ctx.field, message: result};
+    }
+    return result ? {field: ctx.field} : undefined;
+  });
+}