Save current BZZZ config-ui state before CHORUS branding update

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

install/config-ui/node_modules/@hookform/resolvers/superstruct/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@hookform/resolvers/superstruct",
+  "amdName": "hookformResolversSuperstruct",
+  "version": "1.0.0",
+  "private": true,
+  "description": "React Hook Form validation resolver: superstruct",
+  "main": "dist/superstruct.js",
+  "module": "dist/superstruct.module.js",
+  "umd:main": "dist/superstruct.umd.js",
+  "source": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "license": "MIT",
+  "peerDependencies": {
+    "react-hook-form": "^7.0.0",
+    "@hookform/resolvers": "^2.0.0",
+    "superstruct": ">=0.12.0"
+  }
+}

install/config-ui/node_modules/@hookform/resolvers/superstruct/src/__tests__/Form-native-validation.tsx

@@ -0,0 +1,82 @@
+import { render, screen } from '@testing-library/react';
+import user from '@testing-library/user-event';
+import React from 'react';
+import { useForm } from 'react-hook-form';
+import { Infer, object, size, string } from 'superstruct';
+import { superstructResolver } from '..';
+
+const schema = object({
+  username: size(string(), 2),
+  password: size(string(), 6),
+});
+
+type FormData = Infer<typeof schema>;
+
+interface Props {
+  onSubmit: (data: FormData) => void;
+}
+
+function TestComponent({ onSubmit }: Props) {
+  const { register, handleSubmit } = useForm<FormData>({
+    resolver: superstructResolver(schema),
+    shouldUseNativeValidation: true,
+  });
+
+  return (
+    <form onSubmit={handleSubmit(onSubmit)}>
+      <input {...register('username')} placeholder="username" />
+
+      <input {...register('password')} placeholder="password" />
+
+      <button type="submit">submit</button>
+    </form>
+  );
+}
+
+test("form's native validation with Superstruct", async () => {
+  const handleSubmit = vi.fn();
+  render(<TestComponent onSubmit={handleSubmit} />);
+
+  // username
+  let usernameField = screen.getByPlaceholderText(
+    /username/i,
+  ) as HTMLInputElement;
+  expect(usernameField.validity.valid).toBe(true);
+  expect(usernameField.validationMessage).toBe('');
+
+  // password
+  let passwordField = screen.getByPlaceholderText(
+    /password/i,
+  ) as HTMLInputElement;
+  expect(passwordField.validity.valid).toBe(true);
+  expect(passwordField.validationMessage).toBe('');
+
+  await user.click(screen.getByText(/submit/i));
+
+  // username
+  usernameField = screen.getByPlaceholderText(/username/i) as HTMLInputElement;
+  expect(usernameField.validity.valid).toBe(false);
+  expect(usernameField.validationMessage).toBe(
+    'Expected a string with a length of `2` but received one with a length of `0`',
+  );
+
+  // password
+  passwordField = screen.getByPlaceholderText(/password/i) as HTMLInputElement;
+  expect(passwordField.validity.valid).toBe(false);
+  expect(passwordField.validationMessage).toBe(
+    'Expected a string with a length of `6` but received one with a length of `0`',
+  );
+
+  await user.type(screen.getByPlaceholderText(/username/i), 'jo');
+  await user.type(screen.getByPlaceholderText(/password/i), 'passwo');
+
+  // username
+  usernameField = screen.getByPlaceholderText(/username/i) as HTMLInputElement;
+  expect(usernameField.validity.valid).toBe(true);
+  expect(usernameField.validationMessage).toBe('');
+
+  // password
+  passwordField = screen.getByPlaceholderText(/password/i) as HTMLInputElement;
+  expect(passwordField.validity.valid).toBe(true);
+  expect(passwordField.validationMessage).toBe('');
+});

install/config-ui/node_modules/@hookform/resolvers/superstruct/src/__tests__/Form.tsx

@@ -0,0 +1,60 @@
+import { render, screen } from '@testing-library/react';
+import user from '@testing-library/user-event';
+import React from 'react';
+import { useForm } from 'react-hook-form';
+import { Infer, object, size, string } from 'superstruct';
+import { superstructResolver } from '..';
+
+const schema = object({
+  username: size(string(), 2),
+  password: size(string(), 6),
+});
+
+type FormData = Infer<typeof schema>;
+
+interface Props {
+  onSubmit: (data: FormData) => void;
+}
+
+function TestComponent({ onSubmit }: Props) {
+  const {
+    register,
+    formState: { errors },
+    handleSubmit,
+  } = useForm<FormData>({
+    resolver: superstructResolver(schema), // Useful to check TypeScript regressions
+  });
+
+  return (
+    <form onSubmit={handleSubmit(onSubmit)}>
+      <input {...register('username')} />
+      {errors.username && <span role="alert">{errors.username.message}</span>}
+
+      <input {...register('password')} />
+      {errors.password && <span role="alert">{errors.password.message}</span>}
+
+      <button type="submit">submit</button>
+    </form>
+  );
+}
+
+test("form's validation with Superstruct and TypeScript's integration", async () => {
+  const handleSubmit = vi.fn();
+  render(<TestComponent onSubmit={handleSubmit} />);
+
+  expect(screen.queryAllByRole('alert')).toHaveLength(0);
+
+  await user.click(screen.getByText(/submit/i));
+
+  expect(
+    screen.getByText(
+      /Expected a string with a length of `2` but received one with a length of `0`/i,
+    ),
+  ).toBeInTheDocument();
+  expect(
+    screen.getByText(
+      /Expected a string with a length of `6` but received one with a length of `0`/i,
+    ),
+  ).toBeInTheDocument();
+  expect(handleSubmit).not.toHaveBeenCalled();
+});

install/config-ui/node_modules/@hookform/resolvers/superstruct/src/__tests__/__fixtures__/data.ts

@@ -0,0 +1,75 @@
+import { Field, InternalFieldName } from 'react-hook-form';
+import {
+  Infer,
+  array,
+  boolean,
+  define,
+  max,
+  min,
+  number,
+  object,
+  optional,
+  pattern,
+  size,
+  string,
+  union,
+} from 'superstruct';
+
+const Password = define(
+  'Password',
+  (value, ctx) => value === ctx.branch[0].password,
+);
+
+export const schema = object({
+  username: size(pattern(string(), /^\w+$/), 3, 30),
+  password: pattern(string(), /^[a-zA-Z0-9]{3,30}/),
+  repeatPassword: Password,
+  accessToken: optional(union([string(), number()])),
+  birthYear: optional(max(min(number(), 1900), 2013)),
+  email: optional(pattern(string(), /^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$/)),
+  tags: array(string()),
+  enabled: boolean(),
+  like: optional(array(object({ id: number(), name: size(string(), 4) }))),
+});
+
+export const validData: Infer<typeof schema> = {
+  username: 'Doe',
+  password: 'Password123',
+  repeatPassword: 'Password123',
+  birthYear: 2000,
+  email: 'john@doe.com',
+  tags: ['tag1', 'tag2'],
+  enabled: true,
+  like: [
+    {
+      id: 1,
+      name: 'name',
+    },
+  ],
+};
+
+export const invalidData = {
+  password: '___',
+  email: '',
+  birthYear: 'birthYear',
+  like: [{ id: 'z' }],
+};
+
+export const fields: Record<InternalFieldName, Field['_f']> = {
+  username: {
+    ref: { name: 'username' },
+    name: 'username',
+  },
+  password: {
+    ref: { name: 'password' },
+    name: 'password',
+  },
+  email: {
+    ref: { name: 'email' },
+    name: 'email',
+  },
+  birthday: {
+    ref: { name: 'birthday' },
+    name: 'birthday',
+  },
+};

install/config-ui/node_modules/@hookform/resolvers/superstruct/src/__tests__/__snapshots__/superstruct.ts.snap

@@ -0,0 +1,64 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`superstructResolver > should return a single error from superstructResolver when validation fails 1`] = `
+{
+  "errors": {
+    "birthYear": {
+      "message": "Expected a number, but received: "birthYear"",
+      "ref": undefined,
+      "type": "number",
+    },
+    "email": {
+      "message": "Expected a string matching \`/^[\\w-\\.]+@([\\w-]+\\.)+[\\w-]{2,4}$/\` but received """,
+      "ref": {
+        "name": "email",
+      },
+      "type": "string",
+    },
+    "enabled": {
+      "message": "Expected a value of type \`boolean\`, but received: \`undefined\`",
+      "ref": undefined,
+      "type": "boolean",
+    },
+    "like": [
+      {
+        "id": {
+          "message": "Expected a number, but received: "z"",
+          "ref": undefined,
+          "type": "number",
+        },
+        "name": {
+          "message": "Expected a string, but received: undefined",
+          "ref": undefined,
+          "type": "string",
+        },
+      },
+    ],
+    "password": {
+      "message": "Expected a string matching \`/^[a-zA-Z0-9]{3,30}/\` but received "___"",
+      "ref": {
+        "name": "password",
+      },
+      "type": "string",
+    },
+    "repeatPassword": {
+      "message": "Expected a value of type \`Password\`, but received: \`undefined\`",
+      "ref": undefined,
+      "type": "Password",
+    },
+    "tags": {
+      "message": "Expected an array value, but received: undefined",
+      "ref": undefined,
+      "type": "array",
+    },
+    "username": {
+      "message": "Expected a string, but received: undefined",
+      "ref": {
+        "name": "username",
+      },
+      "type": "string",
+    },
+  },
+  "values": {},
+}
+`;

install/config-ui/node_modules/@hookform/resolvers/superstruct/src/__tests__/superstruct.ts

@@ -0,0 +1,37 @@
+import { superstructResolver } from '..';
+import { fields, invalidData, schema, validData } from './__fixtures__/data';
+
+const shouldUseNativeValidation = false;
+
+describe('superstructResolver', () => {
+  it('should return values from superstructResolver when validation pass', async () => {
+    const result = await superstructResolver(schema)(validData, undefined, {
+      fields,
+      shouldUseNativeValidation,
+    });
+
+    expect(result).toEqual({ errors: {}, values: validData });
+  });
+
+  it('should return a single error from superstructResolver when validation fails', async () => {
+    const result = await superstructResolver(schema)(invalidData, undefined, {
+      fields,
+      shouldUseNativeValidation,
+    });
+
+    expect(result).toMatchSnapshot();
+  });
+
+  it('should return values from superstructResolver when validation pass & raw=true', async () => {
+    const result = await superstructResolver(schema, undefined, { raw: true })(
+      validData,
+      undefined,
+      {
+        fields,
+        shouldUseNativeValidation,
+      },
+    );
+
+    expect(result).toEqual({ errors: {}, values: validData });
+  });
+});

install/config-ui/node_modules/@hookform/resolvers/superstruct/src/index.ts

@@ -0,0 +1,2 @@
+export * from './superstruct';
+export * from './types';

install/config-ui/node_modules/@hookform/resolvers/superstruct/src/superstruct.ts

@@ -0,0 +1,35 @@
+import { toNestErrors, validateFieldsNatively } from '@hookform/resolvers';
+import { FieldError } from 'react-hook-form';
+
+import { StructError, validate } from 'superstruct';
+import { Resolver } from './types';
+
+const parseErrorSchema = (error: StructError) =>
+  error.failures().reduce<Record<string, FieldError>>(
+    (previous, error) =>
+      (previous[error.path.join('.')] = {
+        message: error.message,
+        type: error.type,
+      }) && previous,
+    {},
+  );
+
+export const superstructResolver: Resolver =
+  (schema, schemaOptions, resolverOptions = {}) =>
+  (values, _, options) => {
+    const result = validate(values, schema, schemaOptions);
+
+    if (result[0]) {
+      return {
+        values: {},
+        errors: toNestErrors(parseErrorSchema(result[0]), options),
+      };
+    }
+
+    options.shouldUseNativeValidation && validateFieldsNatively({}, options);
+
+    return {
+      values: resolverOptions.raw ? values : result[1],
+      errors: {},
+    };
+  };

install/config-ui/node_modules/@hookform/resolvers/superstruct/src/types.ts

@@ -0,0 +1,20 @@
+import { FieldValues, ResolverOptions, ResolverResult } from 'react-hook-form';
+import { Struct, validate } from 'superstruct';
+
+type Options = Parameters<typeof validate>[2];
+
+export type Resolver = <T extends Struct<any, any>>(
+  schema: T,
+  options?: Options,
+  factoryOptions?: {
+    /**
+     * Return the raw input values rather than the parsed values.
+     * @default false
+     */
+    raw?: boolean;
+  },
+) => <TFieldValues extends FieldValues, TContext>(
+  values: TFieldValues,
+  context: TContext | undefined,
+  options: ResolverOptions<TFieldValues>,
+) => ResolverResult<TFieldValues>;