@form-eng/core 1.2.1 → 1.4.0

package/dist/testing.d.mts

@@ -0,0 +1,30 @@
+import React from 'react';
+import { D as Dictionary } from './index-BrfbmVFA.mjs';
+
+/** Tier 1 field types that every adapter should implement */
+declare const TIER_1_FIELDS: readonly ["Textbox", "Number", "Toggle", "Dropdown", "SimpleDropdown", "Multiselect", "DateControl", "Slider", "RadioGroup", "CheckboxGroup", "Textarea", "ReadOnly", "DynamicFragment"];
+/** All standard field types (Tier 1 + 2 + 3) */
+declare const ALL_FIELD_TYPES: ("Textbox" | "Dropdown" | "Toggle" | "Number" | "Multiselect" | "DateControl" | "Slider" | "DynamicFragment" | "SimpleDropdown" | "MultiSelectSearch" | "PopOutEditor" | "RichText" | "Textarea" | "DocumentLinks" | "StatusDropdown" | "ReadOnly" | "ReadOnlyArray" | "ReadOnlyDateTime" | "ReadOnlyCumulativeNumber" | "ReadOnlyRichText" | "ReadOnlyWithButton" | "ChoiceSet" | "FieldArray" | "RadioGroup" | "CheckboxGroup" | "Rating" | "ColorPicker" | "Autocomplete" | "FileUpload" | "DateRange" | "DateTime" | "PhoneInput")[];
+/** Default test values by field type */
+declare const VALUE_BY_TYPE: Record<string, unknown>;
+interface IContractTestOptions {
+    /** Field types to exclude from registry presence check */
+    excludeTypes?: string[];
+    /** If set, only test these types instead of ALL_FIELD_TYPES */
+    onlyTypes?: string[];
+    /** Description prefix for the test suite */
+    suiteName: string;
+    /** Optional wrapper component for providers (e.g., StyletronProvider for base-web) */
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+}
+/**
+ * Runs the adapter contract test suite against a field registry.
+ *
+ * @param registryFactory - Function that creates the field registry
+ * @param options - Test configuration
+ */
+declare function runAdapterContractTests(registryFactory: () => Dictionary<React.JSX.Element>, options: IContractTestOptions): void;
+
+export { ALL_FIELD_TYPES, type IContractTestOptions, TIER_1_FIELDS, VALUE_BY_TYPE, runAdapterContractTests };

package/dist/testing.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import { D as Dictionary } from './index-BrfbmVFA.js';
+
+/** Tier 1 field types that every adapter should implement */
+declare const TIER_1_FIELDS: readonly ["Textbox", "Number", "Toggle", "Dropdown", "SimpleDropdown", "Multiselect", "DateControl", "Slider", "RadioGroup", "CheckboxGroup", "Textarea", "ReadOnly", "DynamicFragment"];
+/** All standard field types (Tier 1 + 2 + 3) */
+declare const ALL_FIELD_TYPES: ("Textbox" | "Dropdown" | "Toggle" | "Number" | "Multiselect" | "DateControl" | "Slider" | "DynamicFragment" | "SimpleDropdown" | "MultiSelectSearch" | "PopOutEditor" | "RichText" | "Textarea" | "DocumentLinks" | "StatusDropdown" | "ReadOnly" | "ReadOnlyArray" | "ReadOnlyDateTime" | "ReadOnlyCumulativeNumber" | "ReadOnlyRichText" | "ReadOnlyWithButton" | "ChoiceSet" | "FieldArray" | "RadioGroup" | "CheckboxGroup" | "Rating" | "ColorPicker" | "Autocomplete" | "FileUpload" | "DateRange" | "DateTime" | "PhoneInput")[];
+/** Default test values by field type */
+declare const VALUE_BY_TYPE: Record<string, unknown>;
+interface IContractTestOptions {
+    /** Field types to exclude from registry presence check */
+    excludeTypes?: string[];
+    /** If set, only test these types instead of ALL_FIELD_TYPES */
+    onlyTypes?: string[];
+    /** Description prefix for the test suite */
+    suiteName: string;
+    /** Optional wrapper component for providers (e.g., StyletronProvider for base-web) */
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+    }>;
+}
+/**
+ * Runs the adapter contract test suite against a field registry.
+ *
+ * @param registryFactory - Function that creates the field registry
+ * @param options - Test configuration
+ */
+declare function runAdapterContractTests(registryFactory: () => Dictionary<React.JSX.Element>, options: IContractTestOptions): void;
+
+export { ALL_FIELD_TYPES, type IContractTestOptions, TIER_1_FIELDS, VALUE_BY_TYPE, runAdapterContractTests };

package/dist/testing.js

@@ -0,0 +1,231 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/testing.ts
+var testing_exports = {};
+__export(testing_exports, {
+  ALL_FIELD_TYPES: () => ALL_FIELD_TYPES,
+  TIER_1_FIELDS: () => TIER_1_FIELDS,
+  VALUE_BY_TYPE: () => VALUE_BY_TYPE,
+  runAdapterContractTests: () => runAdapterContractTests
+});
+module.exports = __toCommonJS(testing_exports);
+
+// src/testing/fieldContractTests.tsx
+var import_vitest = require("vitest");
+var import_react = require("@testing-library/react");
+var import_react2 = __toESM(require("react"));
+
+// src/constants.ts
+var ComponentTypes = {
+  Textbox: "Textbox",
+  Dropdown: "Dropdown",
+  Toggle: "Toggle",
+  Number: "Number",
+  MultiSelect: "Multiselect",
+  DateControl: "DateControl",
+  Slider: "Slider",
+  Fragment: "DynamicFragment",
+  SimpleDropdown: "SimpleDropdown",
+  MultiSelectSearch: "MultiSelectSearch",
+  PopOutEditor: "PopOutEditor",
+  RichText: "RichText",
+  Textarea: "Textarea",
+  DocumentLinks: "DocumentLinks",
+  StatusDropdown: "StatusDropdown",
+  ReadOnly: "ReadOnly",
+  ReadOnlyArray: "ReadOnlyArray",
+  ReadOnlyDateTime: "ReadOnlyDateTime",
+  ReadOnlyCumulativeNumber: "ReadOnlyCumulativeNumber",
+  ReadOnlyRichText: "ReadOnlyRichText",
+  ReadOnlyWithButton: "ReadOnlyWithButton",
+  ChoiceSet: "ChoiceSet",
+  FieldArray: "FieldArray",
+  RadioGroup: "RadioGroup",
+  CheckboxGroup: "CheckboxGroup",
+  Rating: "Rating",
+  ColorPicker: "ColorPicker",
+  Autocomplete: "Autocomplete",
+  FileUpload: "FileUpload",
+  DateRange: "DateRange",
+  DateTime: "DateTime",
+  PhoneInput: "PhoneInput"
+};
+
+// src/testing/fieldContractTests.tsx
+var TIER_1_FIELDS = [
+  ComponentTypes.Textbox,
+  ComponentTypes.Number,
+  ComponentTypes.Toggle,
+  ComponentTypes.Dropdown,
+  ComponentTypes.SimpleDropdown,
+  ComponentTypes.MultiSelect,
+  ComponentTypes.DateControl,
+  ComponentTypes.Slider,
+  ComponentTypes.RadioGroup,
+  ComponentTypes.CheckboxGroup,
+  ComponentTypes.Textarea,
+  ComponentTypes.ReadOnly,
+  ComponentTypes.Fragment
+];
+var ALL_FIELD_TYPES = Object.values(ComponentTypes);
+var VALUE_BY_TYPE = {
+  [ComponentTypes.Textbox]: "hello",
+  [ComponentTypes.Number]: 42,
+  [ComponentTypes.Toggle]: true,
+  [ComponentTypes.Dropdown]: "opt1",
+  [ComponentTypes.SimpleDropdown]: "opt1",
+  [ComponentTypes.MultiSelect]: ["opt1"],
+  [ComponentTypes.DateControl]: "2024-01-15",
+  [ComponentTypes.Slider]: 50,
+  [ComponentTypes.RadioGroup]: "opt1",
+  [ComponentTypes.CheckboxGroup]: ["opt1"],
+  [ComponentTypes.Textarea]: "some text",
+  [ComponentTypes.ReadOnly]: "read only text",
+  [ComponentTypes.Fragment]: "hidden",
+  // Tier 2+ types
+  [ComponentTypes.MultiSelectSearch]: ["opt1"],
+  [ComponentTypes.ReadOnlyArray]: ["item1", "item2"],
+  [ComponentTypes.ReadOnlyDateTime]: "2024-01-15T10:30:00Z",
+  [ComponentTypes.ReadOnlyRichText]: "<p>rich text</p>",
+  [ComponentTypes.ReadOnlyWithButton]: "value",
+  [ComponentTypes.Rating]: 3,
+  [ComponentTypes.ColorPicker]: "#ff0000",
+  [ComponentTypes.Autocomplete]: "opt1",
+  [ComponentTypes.FileUpload]: null,
+  [ComponentTypes.DateRange]: { start: "2024-01-01", end: "2024-01-31" },
+  [ComponentTypes.DateTime]: "2024-01-15T10:30:00Z",
+  [ComponentTypes.PhoneInput]: "5551234567"
+};
+var TEST_OPTIONS = [
+  { value: "opt1", label: "Option 1" },
+  { value: "opt2", label: "Option 2" }
+];
+var OPTION_FIELDS = /* @__PURE__ */ new Set([
+  ComponentTypes.Dropdown,
+  ComponentTypes.SimpleDropdown,
+  ComponentTypes.MultiSelect,
+  ComponentTypes.MultiSelectSearch,
+  ComponentTypes.RadioGroup,
+  ComponentTypes.CheckboxGroup,
+  ComponentTypes.Autocomplete
+]);
+function runAdapterContractTests(registryFactory, options) {
+  const { excludeTypes = [], suiteName, onlyTypes, wrapper } = options;
+  (0, import_vitest.describe)(`${suiteName} adapter contract`, () => {
+    let registry;
+    (0, import_vitest.beforeEach)(() => {
+      registry = registryFactory();
+    });
+    const typesToTest = onlyTypes ?? ALL_FIELD_TYPES.filter((t) => !excludeTypes.includes(t));
+    const renderWithWrapper = (element) => {
+      return (0, import_react.render)(element, wrapper ? { wrapper } : void 0);
+    };
+    (0, import_vitest.describe)("registry coverage", () => {
+      (0, import_vitest.it)("registry is a non-empty object", () => {
+        (0, import_vitest.expect)(typeof registry).toBe("object");
+        (0, import_vitest.expect)(Object.keys(registry).length).toBeGreaterThan(0);
+      });
+      for (const type of typesToTest) {
+        (0, import_vitest.it)(`has entry for "${type}"`, () => {
+          (0, import_vitest.expect)(registry[type]).toBeDefined();
+          (0, import_vitest.expect)(import_react2.default.isValidElement(registry[type])).toBe(true);
+        });
+      }
+    });
+    (0, import_vitest.describe)("field rendering", () => {
+      const minimalProps = {
+        fieldName: "testField",
+        programName: "testProg",
+        entityType: "testEntity",
+        entityId: "123",
+        value: void 0,
+        readOnly: false,
+        required: false,
+        setFieldValue: import_vitest.vi.fn()
+      };
+      for (const type of typesToTest) {
+        (0, import_vitest.it)(`"${type}" renders without error with minimal props`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, options: TEST_OPTIONS } : minimalProps;
+          const { container } = renderWithWrapper(import_react2.default.cloneElement(element, props));
+          (0, import_vitest.expect)(container).toBeTruthy();
+        });
+        (0, import_vitest.it)(`"${type}" renders in readOnly mode`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const readOnlyValue = VALUE_BY_TYPE[type] ?? "Test";
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, readOnly: true, value: readOnlyValue, options: TEST_OPTIONS } : { ...minimalProps, readOnly: true, value: readOnlyValue };
+          const { container } = renderWithWrapper(
+            import_react2.default.cloneElement(element, props)
+          );
+          (0, import_vitest.expect)(container).toBeTruthy();
+        });
+        (0, import_vitest.it)(`"${type}" renders in disabled state`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, disabled: true, options: TEST_OPTIONS } : { ...minimalProps, disabled: true };
+          const { container } = renderWithWrapper(import_react2.default.cloneElement(element, props));
+          (0, import_vitest.expect)(container).toBeTruthy();
+        });
+        (0, import_vitest.it)(`"${type}" renders in required state`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, required: true, options: TEST_OPTIONS } : { ...minimalProps, required: true };
+          const { container } = renderWithWrapper(import_react2.default.cloneElement(element, props));
+          (0, import_vitest.expect)(container).toBeTruthy();
+        });
+        (0, import_vitest.it)(`"${type}" renders with a value`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const testValue = VALUE_BY_TYPE[type];
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, value: testValue, options: TEST_OPTIONS } : { ...minimalProps, value: testValue };
+          const { container } = renderWithWrapper(import_react2.default.cloneElement(element, props));
+          (0, import_vitest.expect)(container).toBeTruthy();
+        });
+        (0, import_vitest.it)(`"${type}" renders safely with undefined value`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, value: void 0, options: TEST_OPTIONS } : { ...minimalProps, value: void 0 };
+          const { container } = renderWithWrapper(import_react2.default.cloneElement(element, props));
+          (0, import_vitest.expect)(container).toBeTruthy();
+        });
+      }
+    });
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ALL_FIELD_TYPES,
+  TIER_1_FIELDS,
+  VALUE_BY_TYPE,
+  runAdapterContractTests
+});
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts","../src/testing/fieldContractTests.tsx","../src/constants.ts"],"sourcesContent":["/**\n * Testing utilities subpath export.\n *\n * Import as: import { ... } from \"@form-eng/core/testing\"\n *\n * Provides contract test infrastructure for adapter packages to validate\n * their field registries conform to the adapter contract.\n *\n * NOTE: This module imports from vitest and @testing-library/react.\n * It should only be imported in test files where these dependencies are available.\n */\n\n/// <reference types=\"vitest\" />\n\nexport {\n  runAdapterContractTests,\n  TIER_1_FIELDS,\n  ALL_FIELD_TYPES,\n  VALUE_BY_TYPE,\n} from \"./testing/index\";\nexport type { IContractTestOptions } from \"./testing/index\";\n","/**\n * Shared adapter contract test suite.\n *\n * Generates a set of vitest tests that validate a field registry\n * conforms to the adapter contract. Each adapter package should\n * import this function and call it with their registry factory.\n */\nimport { describe, it, expect, vi, beforeEach } from \"vitest\";\nimport { render } from \"@testing-library/react\";\nimport React from \"react\";\nimport { ComponentTypes } from \"../constants\";\nimport type { Dictionary } from \"../utils\";\nimport type { IOption } from \"../types/IOption\";\n\n/** Tier 1 field types that every adapter should implement */\nexport const TIER_1_FIELDS = [\n  ComponentTypes.Textbox,\n  ComponentTypes.Number,\n  ComponentTypes.Toggle,\n  ComponentTypes.Dropdown,\n  ComponentTypes.SimpleDropdown,\n  ComponentTypes.MultiSelect,\n  ComponentTypes.DateControl,\n  ComponentTypes.Slider,\n  ComponentTypes.RadioGroup,\n  ComponentTypes.CheckboxGroup,\n  ComponentTypes.Textarea,\n  ComponentTypes.ReadOnly,\n  ComponentTypes.Fragment,\n] as const;\n\n/** All standard field types (Tier 1 + 2 + 3) */\nexport const ALL_FIELD_TYPES = Object.values(ComponentTypes);\n\n/** Default test values by field type */\nexport const VALUE_BY_TYPE: Record<string, unknown> = {\n  [ComponentTypes.Textbox]: \"hello\",\n  [ComponentTypes.Number]: 42,\n  [ComponentTypes.Toggle]: true,\n  [ComponentTypes.Dropdown]: \"opt1\",\n  [ComponentTypes.SimpleDropdown]: \"opt1\",\n  [ComponentTypes.MultiSelect]: [\"opt1\"],\n  [ComponentTypes.DateControl]: \"2024-01-15\",\n  [ComponentTypes.Slider]: 50,\n  [ComponentTypes.RadioGroup]: \"opt1\",\n  [ComponentTypes.CheckboxGroup]: [\"opt1\"],\n  [ComponentTypes.Textarea]: \"some text\",\n  [ComponentTypes.ReadOnly]: \"read only text\",\n  [ComponentTypes.Fragment]: \"hidden\",\n  // Tier 2+ types\n  [ComponentTypes.MultiSelectSearch]: [\"opt1\"],\n  [ComponentTypes.ReadOnlyArray]: [\"item1\", \"item2\"],\n  [ComponentTypes.ReadOnlyDateTime]: \"2024-01-15T10:30:00Z\",\n  [ComponentTypes.ReadOnlyRichText]: \"<p>rich text</p>\",\n  [ComponentTypes.ReadOnlyWithButton]: \"value\",\n  [ComponentTypes.Rating]: 3,\n  [ComponentTypes.ColorPicker]: \"#ff0000\",\n  [ComponentTypes.Autocomplete]: \"opt1\",\n  [ComponentTypes.FileUpload]: null,\n  [ComponentTypes.DateRange]: { start: \"2024-01-01\", end: \"2024-01-31\" },\n  [ComponentTypes.DateTime]: \"2024-01-15T10:30:00Z\",\n  [ComponentTypes.PhoneInput]: \"5551234567\",\n};\n\n/** Default test options for select-like fields */\nconst TEST_OPTIONS: IOption[] = [\n  { value: \"opt1\", label: \"Option 1\" },\n  { value: \"opt2\", label: \"Option 2\" },\n];\n\n/** Fields that use options */\nconst OPTION_FIELDS: Set<string> = new Set([\n  ComponentTypes.Dropdown,\n  ComponentTypes.SimpleDropdown,\n  ComponentTypes.MultiSelect,\n  ComponentTypes.MultiSelectSearch,\n  ComponentTypes.RadioGroup,\n  ComponentTypes.CheckboxGroup,\n  ComponentTypes.Autocomplete,\n]);\n\nexport interface IContractTestOptions {\n  /** Field types to exclude from registry presence check */\n  excludeTypes?: string[];\n  /** If set, only test these types instead of ALL_FIELD_TYPES */\n  onlyTypes?: string[];\n  /** Description prefix for the test suite */\n  suiteName: string;\n  /** Optional wrapper component for providers (e.g., StyletronProvider for base-web) */\n  wrapper?: React.ComponentType<{ children: React.ReactNode }>;\n}\n\n/**\n * Runs the adapter contract test suite against a field registry.\n *\n * @param registryFactory - Function that creates the field registry\n * @param options - Test configuration\n */\nexport function runAdapterContractTests(\n  registryFactory: () => Dictionary<React.JSX.Element>,\n  options: IContractTestOptions\n) {\n  const { excludeTypes = [], suiteName, onlyTypes, wrapper } = options;\n\n  describe(`${suiteName} adapter contract`, () => {\n    let registry: Dictionary<React.JSX.Element>;\n\n    beforeEach(() => {\n      registry = registryFactory();\n    });\n\n    const typesToTest = onlyTypes ?? ALL_FIELD_TYPES.filter(t => !excludeTypes.includes(t));\n\n    const renderWithWrapper = (element: React.ReactElement) => {\n      return render(element, wrapper ? { wrapper } : undefined);\n    };\n\n    describe(\"registry coverage\", () => {\n      it(\"registry is a non-empty object\", () => {\n        expect(typeof registry).toBe(\"object\");\n        expect(Object.keys(registry).length).toBeGreaterThan(0);\n      });\n\n      for (const type of typesToTest) {\n        it(`has entry for \"${type}\"`, () => {\n          expect(registry[type]).toBeDefined();\n          expect(React.isValidElement(registry[type])).toBe(true);\n        });\n      }\n    });\n\n    describe(\"field rendering\", () => {\n      const minimalProps = {\n        fieldName: \"testField\",\n        programName: \"testProg\",\n        entityType: \"testEntity\",\n        entityId: \"123\",\n        value: undefined,\n        readOnly: false,\n        required: false,\n        setFieldValue: vi.fn(),\n      };\n\n      for (const type of typesToTest) {\n        it(`\"${type}\" renders without error with minimal props`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, options: TEST_OPTIONS }\n            : minimalProps;\n          const { container } = renderWithWrapper(React.cloneElement(element, props));\n          expect(container).toBeTruthy();\n        });\n\n        it(`\"${type}\" renders in readOnly mode`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const readOnlyValue = VALUE_BY_TYPE[type] ?? \"Test\";\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, readOnly: true, value: readOnlyValue, options: TEST_OPTIONS }\n            : { ...minimalProps, readOnly: true, value: readOnlyValue };\n          const { container } = renderWithWrapper(\n            React.cloneElement(element, props)\n          );\n          expect(container).toBeTruthy();\n        });\n\n        it(`\"${type}\" renders in disabled state`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, disabled: true, options: TEST_OPTIONS }\n            : { ...minimalProps, disabled: true };\n          const { container } = renderWithWrapper(React.cloneElement(element, props));\n          expect(container).toBeTruthy();\n        });\n\n        it(`\"${type}\" renders in required state`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, required: true, options: TEST_OPTIONS }\n            : { ...minimalProps, required: true };\n          const { container } = renderWithWrapper(React.cloneElement(element, props));\n          expect(container).toBeTruthy();\n        });\n\n        it(`\"${type}\" renders with a value`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const testValue = VALUE_BY_TYPE[type];\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, value: testValue, options: TEST_OPTIONS }\n            : { ...minimalProps, value: testValue };\n          const { container } = renderWithWrapper(React.cloneElement(element, props));\n          expect(container).toBeTruthy();\n        });\n\n        it(`\"${type}\" renders safely with undefined value`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, value: undefined, options: TEST_OPTIONS }\n            : { ...minimalProps, value: undefined };\n          const { container } = renderWithWrapper(React.cloneElement(element, props));\n          expect(container).toBeTruthy();\n        });\n      }\n    });\n  });\n}\n","export const FIELD_PARENT_PREFIX = \"Parent.\";\n\n/** Component type constants */\nexport const ComponentTypes = {\n  Textbox: \"Textbox\",\n  Dropdown: \"Dropdown\",\n  Toggle: \"Toggle\",\n  Number: \"Number\",\n  MultiSelect: \"Multiselect\",\n  DateControl: \"DateControl\",\n  Slider: \"Slider\",\n  Fragment: \"DynamicFragment\",\n  SimpleDropdown: \"SimpleDropdown\",\n  MultiSelectSearch: \"MultiSelectSearch\",\n  PopOutEditor: \"PopOutEditor\",\n  RichText: \"RichText\",\n  Textarea: \"Textarea\",\n  DocumentLinks: \"DocumentLinks\",\n  StatusDropdown: \"StatusDropdown\",\n  ReadOnly: \"ReadOnly\",\n  ReadOnlyArray: \"ReadOnlyArray\",\n  ReadOnlyDateTime: \"ReadOnlyDateTime\",\n  ReadOnlyCumulativeNumber: \"ReadOnlyCumulativeNumber\",\n  ReadOnlyRichText: \"ReadOnlyRichText\",\n  ReadOnlyWithButton: \"ReadOnlyWithButton\",\n  ChoiceSet: \"ChoiceSet\",\n  FieldArray: \"FieldArray\",\n  RadioGroup: \"RadioGroup\",\n  CheckboxGroup: \"CheckboxGroup\",\n  Rating: \"Rating\",\n  ColorPicker: \"ColorPicker\",\n  Autocomplete: \"Autocomplete\",\n  FileUpload: \"FileUpload\",\n  DateRange: \"DateRange\",\n  DateTime: \"DateTime\",\n  PhoneInput: \"PhoneInput\",\n} as const;\n\n/** Form-level constants */\nexport const FormConstants = {\n  defaultExpandCutoffCount: 12,\n  loadingShimmerCount: 12,\n  loadingFieldShimmerHeight: 32,\n  na: \"n/a\",\n  panelActionKeys: {\n    cancel: \"Cancel\",\n    close: \"Close\",\n    create: \"Create\",\n    update: \"Update\",\n  },\n  urlRegex: /(http(s?)):\\/\\//i,\n  errorColor: \"#a4262c\",\n} as const;\n\n"],"mappings":"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","names":["import_react","React"]}

package/dist/testing.mjs

@@ -0,0 +1,157 @@
+import {
+  ComponentTypes
+} from "./chunk-YMUYHDWI.mjs";
+
+// src/testing/fieldContractTests.tsx
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { render } from "@testing-library/react";
+import React from "react";
+var TIER_1_FIELDS = [
+  ComponentTypes.Textbox,
+  ComponentTypes.Number,
+  ComponentTypes.Toggle,
+  ComponentTypes.Dropdown,
+  ComponentTypes.SimpleDropdown,
+  ComponentTypes.MultiSelect,
+  ComponentTypes.DateControl,
+  ComponentTypes.Slider,
+  ComponentTypes.RadioGroup,
+  ComponentTypes.CheckboxGroup,
+  ComponentTypes.Textarea,
+  ComponentTypes.ReadOnly,
+  ComponentTypes.Fragment
+];
+var ALL_FIELD_TYPES = Object.values(ComponentTypes);
+var VALUE_BY_TYPE = {
+  [ComponentTypes.Textbox]: "hello",
+  [ComponentTypes.Number]: 42,
+  [ComponentTypes.Toggle]: true,
+  [ComponentTypes.Dropdown]: "opt1",
+  [ComponentTypes.SimpleDropdown]: "opt1",
+  [ComponentTypes.MultiSelect]: ["opt1"],
+  [ComponentTypes.DateControl]: "2024-01-15",
+  [ComponentTypes.Slider]: 50,
+  [ComponentTypes.RadioGroup]: "opt1",
+  [ComponentTypes.CheckboxGroup]: ["opt1"],
+  [ComponentTypes.Textarea]: "some text",
+  [ComponentTypes.ReadOnly]: "read only text",
+  [ComponentTypes.Fragment]: "hidden",
+  // Tier 2+ types
+  [ComponentTypes.MultiSelectSearch]: ["opt1"],
+  [ComponentTypes.ReadOnlyArray]: ["item1", "item2"],
+  [ComponentTypes.ReadOnlyDateTime]: "2024-01-15T10:30:00Z",
+  [ComponentTypes.ReadOnlyRichText]: "<p>rich text</p>",
+  [ComponentTypes.ReadOnlyWithButton]: "value",
+  [ComponentTypes.Rating]: 3,
+  [ComponentTypes.ColorPicker]: "#ff0000",
+  [ComponentTypes.Autocomplete]: "opt1",
+  [ComponentTypes.FileUpload]: null,
+  [ComponentTypes.DateRange]: { start: "2024-01-01", end: "2024-01-31" },
+  [ComponentTypes.DateTime]: "2024-01-15T10:30:00Z",
+  [ComponentTypes.PhoneInput]: "5551234567"
+};
+var TEST_OPTIONS = [
+  { value: "opt1", label: "Option 1" },
+  { value: "opt2", label: "Option 2" }
+];
+var OPTION_FIELDS = /* @__PURE__ */ new Set([
+  ComponentTypes.Dropdown,
+  ComponentTypes.SimpleDropdown,
+  ComponentTypes.MultiSelect,
+  ComponentTypes.MultiSelectSearch,
+  ComponentTypes.RadioGroup,
+  ComponentTypes.CheckboxGroup,
+  ComponentTypes.Autocomplete
+]);
+function runAdapterContractTests(registryFactory, options) {
+  const { excludeTypes = [], suiteName, onlyTypes, wrapper } = options;
+  describe(`${suiteName} adapter contract`, () => {
+    let registry;
+    beforeEach(() => {
+      registry = registryFactory();
+    });
+    const typesToTest = onlyTypes ?? ALL_FIELD_TYPES.filter((t) => !excludeTypes.includes(t));
+    const renderWithWrapper = (element) => {
+      return render(element, wrapper ? { wrapper } : void 0);
+    };
+    describe("registry coverage", () => {
+      it("registry is a non-empty object", () => {
+        expect(typeof registry).toBe("object");
+        expect(Object.keys(registry).length).toBeGreaterThan(0);
+      });
+      for (const type of typesToTest) {
+        it(`has entry for "${type}"`, () => {
+          expect(registry[type]).toBeDefined();
+          expect(React.isValidElement(registry[type])).toBe(true);
+        });
+      }
+    });
+    describe("field rendering", () => {
+      const minimalProps = {
+        fieldName: "testField",
+        programName: "testProg",
+        entityType: "testEntity",
+        entityId: "123",
+        value: void 0,
+        readOnly: false,
+        required: false,
+        setFieldValue: vi.fn()
+      };
+      for (const type of typesToTest) {
+        it(`"${type}" renders without error with minimal props`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, options: TEST_OPTIONS } : minimalProps;
+          const { container } = renderWithWrapper(React.cloneElement(element, props));
+          expect(container).toBeTruthy();
+        });
+        it(`"${type}" renders in readOnly mode`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const readOnlyValue = VALUE_BY_TYPE[type] ?? "Test";
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, readOnly: true, value: readOnlyValue, options: TEST_OPTIONS } : { ...minimalProps, readOnly: true, value: readOnlyValue };
+          const { container } = renderWithWrapper(
+            React.cloneElement(element, props)
+          );
+          expect(container).toBeTruthy();
+        });
+        it(`"${type}" renders in disabled state`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, disabled: true, options: TEST_OPTIONS } : { ...minimalProps, disabled: true };
+          const { container } = renderWithWrapper(React.cloneElement(element, props));
+          expect(container).toBeTruthy();
+        });
+        it(`"${type}" renders in required state`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, required: true, options: TEST_OPTIONS } : { ...minimalProps, required: true };
+          const { container } = renderWithWrapper(React.cloneElement(element, props));
+          expect(container).toBeTruthy();
+        });
+        it(`"${type}" renders with a value`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const testValue = VALUE_BY_TYPE[type];
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, value: testValue, options: TEST_OPTIONS } : { ...minimalProps, value: testValue };
+          const { container } = renderWithWrapper(React.cloneElement(element, props));
+          expect(container).toBeTruthy();
+        });
+        it(`"${type}" renders safely with undefined value`, () => {
+          const element = registry[type];
+          if (!element) return;
+          const props = OPTION_FIELDS.has(type) ? { ...minimalProps, value: void 0, options: TEST_OPTIONS } : { ...minimalProps, value: void 0 };
+          const { container } = renderWithWrapper(React.cloneElement(element, props));
+          expect(container).toBeTruthy();
+        });
+      }
+    });
+  });
+}
+export {
+  ALL_FIELD_TYPES,
+  TIER_1_FIELDS,
+  VALUE_BY_TYPE,
+  runAdapterContractTests
+};
+//# sourceMappingURL=testing.mjs.map

package/dist/testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/fieldContractTests.tsx"],"sourcesContent":["/**\n * Shared adapter contract test suite.\n *\n * Generates a set of vitest tests that validate a field registry\n * conforms to the adapter contract. Each adapter package should\n * import this function and call it with their registry factory.\n */\nimport { describe, it, expect, vi, beforeEach } from \"vitest\";\nimport { render } from \"@testing-library/react\";\nimport React from \"react\";\nimport { ComponentTypes } from \"../constants\";\nimport type { Dictionary } from \"../utils\";\nimport type { IOption } from \"../types/IOption\";\n\n/** Tier 1 field types that every adapter should implement */\nexport const TIER_1_FIELDS = [\n  ComponentTypes.Textbox,\n  ComponentTypes.Number,\n  ComponentTypes.Toggle,\n  ComponentTypes.Dropdown,\n  ComponentTypes.SimpleDropdown,\n  ComponentTypes.MultiSelect,\n  ComponentTypes.DateControl,\n  ComponentTypes.Slider,\n  ComponentTypes.RadioGroup,\n  ComponentTypes.CheckboxGroup,\n  ComponentTypes.Textarea,\n  ComponentTypes.ReadOnly,\n  ComponentTypes.Fragment,\n] as const;\n\n/** All standard field types (Tier 1 + 2 + 3) */\nexport const ALL_FIELD_TYPES = Object.values(ComponentTypes);\n\n/** Default test values by field type */\nexport const VALUE_BY_TYPE: Record<string, unknown> = {\n  [ComponentTypes.Textbox]: \"hello\",\n  [ComponentTypes.Number]: 42,\n  [ComponentTypes.Toggle]: true,\n  [ComponentTypes.Dropdown]: \"opt1\",\n  [ComponentTypes.SimpleDropdown]: \"opt1\",\n  [ComponentTypes.MultiSelect]: [\"opt1\"],\n  [ComponentTypes.DateControl]: \"2024-01-15\",\n  [ComponentTypes.Slider]: 50,\n  [ComponentTypes.RadioGroup]: \"opt1\",\n  [ComponentTypes.CheckboxGroup]: [\"opt1\"],\n  [ComponentTypes.Textarea]: \"some text\",\n  [ComponentTypes.ReadOnly]: \"read only text\",\n  [ComponentTypes.Fragment]: \"hidden\",\n  // Tier 2+ types\n  [ComponentTypes.MultiSelectSearch]: [\"opt1\"],\n  [ComponentTypes.ReadOnlyArray]: [\"item1\", \"item2\"],\n  [ComponentTypes.ReadOnlyDateTime]: \"2024-01-15T10:30:00Z\",\n  [ComponentTypes.ReadOnlyRichText]: \"<p>rich text</p>\",\n  [ComponentTypes.ReadOnlyWithButton]: \"value\",\n  [ComponentTypes.Rating]: 3,\n  [ComponentTypes.ColorPicker]: \"#ff0000\",\n  [ComponentTypes.Autocomplete]: \"opt1\",\n  [ComponentTypes.FileUpload]: null,\n  [ComponentTypes.DateRange]: { start: \"2024-01-01\", end: \"2024-01-31\" },\n  [ComponentTypes.DateTime]: \"2024-01-15T10:30:00Z\",\n  [ComponentTypes.PhoneInput]: \"5551234567\",\n};\n\n/** Default test options for select-like fields */\nconst TEST_OPTIONS: IOption[] = [\n  { value: \"opt1\", label: \"Option 1\" },\n  { value: \"opt2\", label: \"Option 2\" },\n];\n\n/** Fields that use options */\nconst OPTION_FIELDS: Set<string> = new Set([\n  ComponentTypes.Dropdown,\n  ComponentTypes.SimpleDropdown,\n  ComponentTypes.MultiSelect,\n  ComponentTypes.MultiSelectSearch,\n  ComponentTypes.RadioGroup,\n  ComponentTypes.CheckboxGroup,\n  ComponentTypes.Autocomplete,\n]);\n\nexport interface IContractTestOptions {\n  /** Field types to exclude from registry presence check */\n  excludeTypes?: string[];\n  /** If set, only test these types instead of ALL_FIELD_TYPES */\n  onlyTypes?: string[];\n  /** Description prefix for the test suite */\n  suiteName: string;\n  /** Optional wrapper component for providers (e.g., StyletronProvider for base-web) */\n  wrapper?: React.ComponentType<{ children: React.ReactNode }>;\n}\n\n/**\n * Runs the adapter contract test suite against a field registry.\n *\n * @param registryFactory - Function that creates the field registry\n * @param options - Test configuration\n */\nexport function runAdapterContractTests(\n  registryFactory: () => Dictionary<React.JSX.Element>,\n  options: IContractTestOptions\n) {\n  const { excludeTypes = [], suiteName, onlyTypes, wrapper } = options;\n\n  describe(`${suiteName} adapter contract`, () => {\n    let registry: Dictionary<React.JSX.Element>;\n\n    beforeEach(() => {\n      registry = registryFactory();\n    });\n\n    const typesToTest = onlyTypes ?? ALL_FIELD_TYPES.filter(t => !excludeTypes.includes(t));\n\n    const renderWithWrapper = (element: React.ReactElement) => {\n      return render(element, wrapper ? { wrapper } : undefined);\n    };\n\n    describe(\"registry coverage\", () => {\n      it(\"registry is a non-empty object\", () => {\n        expect(typeof registry).toBe(\"object\");\n        expect(Object.keys(registry).length).toBeGreaterThan(0);\n      });\n\n      for (const type of typesToTest) {\n        it(`has entry for \"${type}\"`, () => {\n          expect(registry[type]).toBeDefined();\n          expect(React.isValidElement(registry[type])).toBe(true);\n        });\n      }\n    });\n\n    describe(\"field rendering\", () => {\n      const minimalProps = {\n        fieldName: \"testField\",\n        programName: \"testProg\",\n        entityType: \"testEntity\",\n        entityId: \"123\",\n        value: undefined,\n        readOnly: false,\n        required: false,\n        setFieldValue: vi.fn(),\n      };\n\n      for (const type of typesToTest) {\n        it(`\"${type}\" renders without error with minimal props`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, options: TEST_OPTIONS }\n            : minimalProps;\n          const { container } = renderWithWrapper(React.cloneElement(element, props));\n          expect(container).toBeTruthy();\n        });\n\n        it(`\"${type}\" renders in readOnly mode`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const readOnlyValue = VALUE_BY_TYPE[type] ?? \"Test\";\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, readOnly: true, value: readOnlyValue, options: TEST_OPTIONS }\n            : { ...minimalProps, readOnly: true, value: readOnlyValue };\n          const { container } = renderWithWrapper(\n            React.cloneElement(element, props)\n          );\n          expect(container).toBeTruthy();\n        });\n\n        it(`\"${type}\" renders in disabled state`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, disabled: true, options: TEST_OPTIONS }\n            : { ...minimalProps, disabled: true };\n          const { container } = renderWithWrapper(React.cloneElement(element, props));\n          expect(container).toBeTruthy();\n        });\n\n        it(`\"${type}\" renders in required state`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, required: true, options: TEST_OPTIONS }\n            : { ...minimalProps, required: true };\n          const { container } = renderWithWrapper(React.cloneElement(element, props));\n          expect(container).toBeTruthy();\n        });\n\n        it(`\"${type}\" renders with a value`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const testValue = VALUE_BY_TYPE[type];\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, value: testValue, options: TEST_OPTIONS }\n            : { ...minimalProps, value: testValue };\n          const { container } = renderWithWrapper(React.cloneElement(element, props));\n          expect(container).toBeTruthy();\n        });\n\n        it(`\"${type}\" renders safely with undefined value`, () => {\n          const element = registry[type];\n          if (!element) return;\n          const props = OPTION_FIELDS.has(type)\n            ? { ...minimalProps, value: undefined, options: TEST_OPTIONS }\n            : { ...minimalProps, value: undefined };\n          const { container } = renderWithWrapper(React.cloneElement(element, props));\n          expect(container).toBeTruthy();\n        });\n      }\n    });\n  });\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-eng/core",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "Core business rules engine and form orchestration for dynamic React forms",
   "repository": {
     "type": "git",
@@ -42,6 +42,16 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
+    },
+    "./adapter-utils": {
+      "types": "./dist/adapter-utils.d.ts",
+      "import": "./dist/adapter-utils.mjs",
+      "require": "./dist/adapter-utils.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.mjs",
+      "require": "./dist/testing.js"
     }
   },
   "files": [
@@ -61,12 +71,24 @@
     "react-hook-form": "^7.0.0"
   },
   "devDependencies": {
+    "@form-eng/antd": "*",
+    "@form-eng/atlaskit": "*",
+    "@form-eng/base-web": "*",
+    "@form-eng/chakra": "*",
+    "@form-eng/fluent": "*",
+    "@form-eng/headless": "*",
+    "@form-eng/heroui": "*",
+    "@form-eng/mantine": "*",
+    "@form-eng/mui": "*",
+    "@testing-library/react": "^16.3.2",
     "@types/expr-eval": "^1.0.2",
     "@types/react": "^19.2.14",
     "react": "^19.2.4",
+    "react-dom": "^19.2.4",
     "react-hook-form": "^7.71.2",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "expr-eval": "^2.0.2"