feat: Add common name generators

Author: nlemoine

packages/utils/src/index.ts

@@ -70,6 +70,9 @@ import unwrapErrorHandler from './unwrapErrorHandler';
 import utcToLocal from './utcToLocal';
 import validationDataMerge from './validationDataMerge';
 import withIdRefPrefix from './withIdRefPrefix';
+import getOptionMatchingSimpleDiscriminator from './getOptionMatchingSimpleDiscriminator';
+import getChangedFields from './getChangedFields';
+import { bracketNameGenerator, dotNotationNameGenerator } from './nameGenerators';
 
 export * from './types';
 export * from './enums';
@@ -153,6 +156,8 @@ export {
   utcToLocal,
   validationDataMerge,
   withIdRefPrefix,
+  bracketNameGenerator,
+  dotNotationNameGenerator,
 };
 
 export type { ComponentUpdateStrategy } from './shouldRender';

packages/utils/src/nameGenerators.ts

@@ -0,0 +1,30 @@
+import { NameGeneratorFunction, FieldPathList } from './types';
+
+/**
+ * Generates bracketed names
+ * Example: root[tasks][0][title]
+ */
+export const bracketNameGenerator: NameGeneratorFunction = (path: FieldPathList, idPrefix: string): string => {
+  if (!path || path.length === 0) {
+    return idPrefix;
+  }
+
+  return path.reduce<string>((acc, pathUnit, index) => {
+    if (index === 0) {
+      return `${idPrefix}[${String(pathUnit)}]`;
+    }
+    return `${acc}[${String(pathUnit)}]`;
+  }, '');
+};
+
+/**
+ * Generates dot-notation names
+ * Example: root.tasks.0.title
+ */
+export const dotNotationNameGenerator: NameGeneratorFunction = (path: FieldPathList, idPrefix: string): string => {
+  if (!path || path.length === 0) {
+    return idPrefix;
+  }
+
+  return `${idPrefix}.${path.map(String).join('.')}`;
+};

packages/utils/test/nameGenerators.test.ts

@@ -0,0 +1,65 @@
+import { bracketNameGenerator, dotNotationNameGenerator } from '../src';
+
+describe('bracketNameGenerator()', () => {
+  test('returns "root" for empty path', () => {
+    expect(bracketNameGenerator([], 'root')).toBe('root');
+  });
+
+  test('generates name for single string segment', () => {
+    expect(bracketNameGenerator(['firstName'], 'root')).toBe('root[firstName]');
+  });
+
+  test('generates name for single number segment (array index)', () => {
+    expect(bracketNameGenerator([0], 'root')).toBe('root[0]');
+  });
+
+  test('generates name for nested object path', () => {
+    expect(bracketNameGenerator(['user', 'address', 'city'], 'root')).toBe('root[user][address][city]');
+  });
+
+  test('generates name for array with object properties', () => {
+    expect(bracketNameGenerator(['tasks', 0, 'title'], 'root')).toBe('root[tasks][0][title]');
+  });
+
+  test('generates name for nested arrays', () => {
+    expect(bracketNameGenerator(['matrix', 0, 1], 'root')).toBe('root[matrix][0][1]');
+  });
+
+  test('generates name for complex nested structure', () => {
+    expect(bracketNameGenerator(['users', 0, 'addresses', 1, 'street'], 'root')).toBe(
+      'root[users][0][addresses][1][street]',
+    );
+  });
+});
+
+describe('dotNotationNameGenerator()', () => {
+  test('returns "root" for empty path', () => {
+    expect(dotNotationNameGenerator([], 'root')).toBe('root');
+  });
+
+  test('generates name for single string segment', () => {
+    expect(dotNotationNameGenerator(['firstName'], 'root')).toBe('root.firstName');
+  });
+
+  test('generates name for single number segment (array index)', () => {
+    expect(dotNotationNameGenerator([0], 'root')).toBe('root.0');
+  });
+
+  test('generates name for nested object path', () => {
+    expect(dotNotationNameGenerator(['user', 'address', 'city'], 'root')).toBe('root.user.address.city');
+  });
+
+  test('generates name for array with object properties', () => {
+    expect(dotNotationNameGenerator(['tasks', 0, 'title'], 'root')).toBe('root.tasks.0.title');
+  });
+
+  test('generates name for nested arrays', () => {
+    expect(dotNotationNameGenerator(['matrix', 0, 1], 'root')).toBe('root.matrix.0.1');
+  });
+
+  test('generates name for complex nested structure', () => {
+    expect(dotNotationNameGenerator(['users', 0, 'addresses', 1, 'street'], 'root')).toBe(
+      'root.users.0.addresses.1.street',
+    );
+  });
+});