@openzeppelin/ui-renderer 1.0.2 → 1.0.4

package/package.json

@@ -1,22 +1,25 @@
 {
   "name": "@openzeppelin/ui-renderer",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "private": false,
   "description": "A specialized library for rendering customizable transaction forms for blockchain applications.",
   "type": "module",
   "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
+      "types": {
+        "import": "./dist/index.d.mts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
     "./index.css": "./dist/index.css",
     "./types/*": {
-      "types": "./dist/types/*.d.ts",
-      "import": "./dist/types/*.js",
+      "types": "./dist/types/*.d.mts",
+      "import": "./dist/types/*.mjs",
       "require": "./dist/types/*.cjs"
     },
     "./package.json": "./package.json"
@@ -58,20 +61,19 @@
     "lucide-react": "^0.503.0",
     "react": "^19.2.1",
     "react-dom": "^19.2.1",
-    "react-hook-form": "^7.62.0",
+    "react-hook-form": "^7.71.1",
     "tailwind-merge": "^3.3.1",
-    "@openzeppelin/ui-types": "^1.0.0",
-    "@openzeppelin/ui-components": "^1.0.1",
-    "@openzeppelin/ui-utils": "^1.0.0",
-    "@openzeppelin/ui-react": "^1.0.0"
+    "@openzeppelin/ui-types": "^1.10.0",
+    "@openzeppelin/ui-components": "^1.3.0",
+    "@openzeppelin/ui-utils": "^1.3.0",
+    "@openzeppelin/ui-react": "^1.1.0"
   },
   "devDependencies": {
-    "tsdown": "^0.12.5",
     "@testing-library/jest-dom": "^6.6.4",
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",
-    "@types/node": "^22.15.32",
-    "@types/react": "^19.1.9",
+    "@types/node": "^22.19.7",
+    "@types/react": "^19.2.8",
     "@types/react-dom": "^19.1.7",
     "@vitejs/plugin-react": "^4.7.0",
     "jsdom": "^26.1.0",
@@ -79,8 +81,7 @@
     "vitest": "^3.2.4"
   },
   "scripts": {
-    "build": "tsdown && pnpm build:dts-fix",
-    "build:dts-fix": "cd dist && for f in index-*.d.ts; do [ -f \"$f\" ] && cp \"$f\" index.d.ts; done && for f in index-*.d.cts; do [ -f \"$f\" ] && cp \"$f\" index.d.cts; done || true",
+    "build": "tsdown",
     "clean": "rm -rf dist tsconfig.tsbuildinfo",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",

package/dist/index-f9GrUqL8.d.cts

@@ -1,353 +0,0 @@
-import { ContractAdapter, ContractFunction, ContractSchema, ExecutionConfig, FieldTransforms, FieldType, FormFieldType, FormValues, FullContractAdapter, NetworkConfig, TransactionFormProps } from "@openzeppelin/ui-types";
-import React$1, { JSX } from "react";
-import { Control } from "react-hook-form";
-import { ButtonProps } from "@openzeppelin/ui-components";
-
-//#region src/types/RendererConfig.d.ts
-
-/**
- * Types related to renderer configuration
- */
-/**
- * Configuration for the renderer package
- * This interface defines dependencies and settings for the renderer
- * that will be used when exporting form projects.
- */
-interface RendererConfig {
-  /**
-   * Core dependencies required for all renderer projects
-   */
-  coreDependencies: Record<string, string>;
-  /**
-   * Field-specific dependencies required for different field types
-   */
-  fieldDependencies: Record<string, {
-    /**
-     * Runtime dependencies needed for the field type
-     */
-    runtimeDependencies: Record<string, string>;
-    /**
-     * Development dependencies needed for the field type
-     */
-    devDependencies?: Record<string, string>;
-  }>;
-}
-/**
- * Dependencies for a specific field type
- */
-//#endregion
-//#region src/config.d.ts
-/**
- * Configuration for the renderer package
- * Used by the export system to determine dependencies for exported forms
- */
-declare const rendererConfig: RendererConfig;
-//# sourceMappingURL=config.d.ts.map
-
-//#endregion
-//#region src/components/TransactionForm.d.ts
-/**
- * Transaction Form Component
- *
- * This is the main entry point for the app rendering system. It represents the top level of
- * the app rendering architecture:
- *
- * 1. TransactionForm receives a schema and adapter from the transaction builder app
- * 2. It sets up React Hook Form for state management and validation
- * 3. It renders fields dynamically using the DynamicFormField component
- * 4. Provides wallet connection UI (demo implementation)
- * 5. On submission, it processes data through the adapter before passing to handlers
- *
- * Note: The previewMode prop is currently used only for demo purposes and does not affect
- * the visibility of wallet connection or transaction execution UI. In the future, it will be used
- * to enable/disable actual blockchain interactions without changing the UI structure.
- *
- * @returns The rendered form component
- */
-declare function TransactionForm({
-  schema,
-  contractSchema,
-  adapter,
-  isWalletConnected,
-  executionConfig
-}: TransactionFormProps): React.ReactElement;
-//# sourceMappingURL=TransactionForm.d.ts.map
-//#endregion
-//#region src/utils/formUtils.d.ts
-/**
- * Parameter constraints for validation and default value generation
- */
-interface ParameterConstraints {
-  required?: boolean;
-  min?: number;
-  max?: number;
-  minLength?: number;
-  maxLength?: number;
-  pattern?: string;
-}
-/**
- * Validate a field value against validation rules
- */
-declare function validateField(value: unknown, validation?: {
-  required?: boolean;
-  min?: number;
-  max?: number;
-  pattern?: string;
-}): string | null;
-/**
- * Creates a transform for address fields
- *
- * @param adapter The blockchain adapter to use for validation
- * @returns Transform functions for address fields
- */
-declare function createAddressTransform(adapter: ContractAdapter): FieldTransforms<string>;
-/**
- * Creates a transform for number fields
- *
- * @returns Transform functions for number fields
- */
-declare function createNumberTransform(): FieldTransforms<number>;
-/**
- * Creates a transform for bigint fields (large integers beyond JS Number precision)
- *
- * @returns Transform functions for bigint fields
- */
-declare function createBigIntTransform(): FieldTransforms<string>;
-/**
- * Creates a transform for boolean fields
- *
- * @returns Transform functions for boolean fields
- */
-declare function createBooleanTransform(): FieldTransforms<boolean>;
-/**
- * Creates a transform for complex type fields (arrays, objects, etc.)
- *
- * @returns Transform functions for complex fields
- */
-declare function createComplexTypeTransform(): FieldTransforms<unknown>;
-/**
- * Creates a transform for text fields
- *
- * @returns Transform functions for text-based fields
- */
-declare function createTextTransform(): FieldTransforms<string>;
-/**
- * Creates a transform function based on field type
- *
- * @param fieldType The type of field to create transforms for
- * @param adapter Optional adapter for address validation
- * @returns Transform functions for the field type
- */
-declare function createTransformForFieldType(fieldType: FieldType, adapter?: ContractAdapter): FieldTransforms<unknown>;
-/**
- * Generate a default value for a given field type based on parameter constraints
- */
-declare function generateDefaultValue(parameterType: string, constraints?: Partial<ParameterConstraints>): unknown;
-/**
- * Returns the appropriate default value based on field type
- */
-declare function getDefaultValueByFieldType(fieldType: FieldType): string | boolean | number;
-/**
- * Creates a complete default values object for form initialization
- * Ensures all fields have appropriate default values to avoid React controlled/uncontrolled input warnings
- *
- * @param fields The form field definitions
- * @param existingDefaults Any existing default values to preserve
- * @returns A complete form values object with no undefined values
- */
-declare function createDefaultFormValues(fields: FormFieldType[] | undefined, existingDefaults?: Record<string, unknown>): FormValues;
-/**
- * Creates a transform for array fields
- *
- * @returns Transform functions for array fields
- */
-declare function createArrayTransform(): FieldTransforms<unknown[]>;
-/**
- * Creates a transform for object fields
- *
- * @returns Transform functions for object fields
- */
-declare function createObjectTransform(): FieldTransforms<Record<string, unknown>>;
-/**
- * Creates a transform for array-object fields
- *
- * @returns Transform functions for array-object fields
- */
-declare function createArrayObjectTransform(): FieldTransforms<Record<string, unknown>[]>;
-//# sourceMappingURL=formUtils.d.ts.map
-//#endregion
-//#region src/components/DynamicFormField.d.ts
-/**
- * Props for the DynamicFormField component
- */
-interface DynamicFormFieldProps {
-  /**
-   * The field configuration to render
-   */
-  field: FormFieldType;
-  /**
-   * The React Hook Form control
-   */
-  control: Control<FormValues>;
-  /**
-   * The adapter for chain-specific validation and formatting
-   */
-  adapter: ContractAdapter;
-  /**
-   * Optional contract schema for nested metadata lookups
-   */
-  contractSchema?: ContractSchema;
-  /**
-   * The field error message, if any (Kept for potential direct use, though RHF handles it)
-   */
-  error?: string;
-}
-/**
- * Dynamic Form Field Component
- *
- * Renders the appropriate field component based on the field type defined in the form schema.
- * This component is part of the app rendering system architecture where:
- * 1. Form schemas are generated from contract functions using adapters
- * 2. The schemas are rendered using the TransactionForm component
- * 3. TransactionForm uses DynamicFormField to render appropriate field components based on the schema
- *
- * The field components (TextField, NumberField, AddressField, etc.) are specifically designed
- * for React Hook Form integration and should not be used as standalone components.
- *
- * @returns The rendered form field component or null if the field should not be visible
- */
-declare function DynamicFormField({
-  field,
-  control,
-  adapter,
-  contractSchema
-}: DynamicFormFieldProps): React$1.ReactElement | null;
-//#endregion
-//#region src/components/transaction/TransactionExecuteButton.d.ts
-interface TransactionExecuteButtonProps {
-  /**
-   * Whether the wallet is connected
-   */
-  isWalletConnected: boolean;
-  /**
-   * Whether a transaction is currently being submitted
-   */
-  isSubmitting: boolean;
-  /**
-   * Whether the form is valid
-   */
-  isFormValid: boolean;
-  /**
-   * Button variant
-   */
-  variant?: ButtonProps['variant'];
-  /**
-   * Optional function details to determine if local execution is possible
-   * Functions with stateMutability === 'pure' can execute locally without wallet
-   */
-  functionDetails?: ContractFunction;
-  /**
-   * Whether this function can execute locally without wallet connection
-   * If true, the wallet connection check is bypassed
-   */
-  canExecuteLocally?: boolean;
-}
-/**
- * TransactionExecuteButton Component
- *
- * Displays a button for executing a transaction, which is disabled if the wallet is not connected,
- * the form is invalid, or a transaction is currently being submitted.
- *
- * @param props The component props
- * @returns A React component
- */
-declare function TransactionExecuteButton({
-  isWalletConnected,
-  isSubmitting,
-  isFormValid,
-  variant,
-  functionDetails,
-  canExecuteLocally
-}: TransactionExecuteButtonProps): React.ReactElement;
-//# sourceMappingURL=TransactionExecuteButton.d.ts.map
-//#endregion
-//#region src/components/ContractStateWidget/ContractStateWidget.d.ts
-interface ContractStateWidgetProps {
-  contractSchema: ContractSchema | null;
-  contractAddress: string | null;
-  adapter: FullContractAdapter;
-  isVisible?: boolean;
-  onToggle?: () => void;
-  className?: string;
-  error?: Error | null;
-}
-/**
- * ContractStateWidget - Compact widget for displaying contract state
- * Shows contract state by allowing users to query simple view functions (no parameters)
- */
-declare function ContractStateWidget({
-  contractSchema,
-  contractAddress,
-  adapter,
-  isVisible,
-  onToggle,
-  className,
-  error
-}: ContractStateWidgetProps): JSX.Element | null;
-//#endregion
-//#region src/components/ContractActionBar/ContractActionBar.d.ts
-interface ContractActionBarProps {
-  networkConfig: NetworkConfig | null;
-  contractAddress?: string | null;
-  onToggleContractState?: () => void;
-  isWidgetExpanded?: boolean;
-  children?: React$1.ReactNode;
-  className?: string;
-}
-/**
- * ContractActionBar - A composable action bar for contract forms
- * Displays network information and contract state toggle button
- * Can be extended with additional actions via children
- */
-declare function ContractActionBar({
-  networkConfig,
-  contractAddress,
-  onToggleContractState,
-  isWidgetExpanded,
-  children,
-  className
-}: ContractActionBarProps): React$1.ReactElement | null;
-//#endregion
-//#region src/components/ExecutionConfigDisplay/ExecutionConfigDisplay.d.ts
-interface ExecutionConfigDisplayProps {
-  executionConfig: ExecutionConfig;
-  adapter?: ContractAdapter;
-  error?: string | null;
-  connectedWalletAddress?: string;
-  onRuntimeApiKeyChange?: (apiKey: string) => void;
-}
-declare const ExecutionConfigDisplay: React$1.FC<ExecutionConfigDisplayProps>;
-//#endregion
-//#region src/components/network/NetworkSettingsDialog.d.ts
-interface Props {
-  isOpen: boolean;
-  onOpenChange: (open: boolean) => void;
-  networkConfig: {
-    id: string;
-    name: string;
-  } | null;
-  adapter: ContractAdapter | null;
-}
-declare const NetworkSettingsDialog: React$1.FC<Props>;
-//#endregion
-//#region src/components/WalletConnectionWithSettings.d.ts
-/**
- * Enhanced wallet connection header with network settings menu.
- * Used in exported apps to provide access to RPC and Explorer configuration.
- */
-declare const WalletConnectionWithSettings: React$1.FC;
-//# sourceMappingURL=WalletConnectionWithSettings.d.ts.map
-
-//#endregion
-export { ContractActionBar, ContractStateWidget, DynamicFormField, ExecutionConfigDisplay, NetworkSettingsDialog, ParameterConstraints, type RendererConfig, TransactionExecuteButton, TransactionForm, WalletConnectionWithSettings, createAddressTransform, createArrayObjectTransform, createArrayTransform, createBigIntTransform, createBooleanTransform, createComplexTypeTransform, createDefaultFormValues, createNumberTransform, createObjectTransform, createTextTransform, createTransformForFieldType, generateDefaultValue, getDefaultValueByFieldType, rendererConfig, validateField };
-//# sourceMappingURL=index-f9GrUqL8.d.cts.map

package/dist/index-f9GrUqL8.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-f9GrUqL8.d.cts","names":[],"sources":["../src/types/RendererConfig.ts","../src/config.ts","../src/components/TransactionForm.tsx","../src/utils/formUtils.ts","../src/components/DynamicFormField.tsx","../src/components/transaction/TransactionExecuteButton.tsx","../src/components/ContractStateWidget/ContractStateWidget.tsx","../src/components/ContractActionBar/ContractActionBar.tsx","../src/components/ExecutionConfigDisplay/ExecutionConfigDisplay.tsx","../src/components/network/NetworkSettingsDialog.tsx","../src/components/WalletConnectionWithSettings.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;AASA;;AAIoB,UAJH,cAAA,CAIG;;;;EAKO,gBAAA,EALP,MAKO,CAAA,MAAA,EAAA,MAAA,CAAA;;;;ECJd,iBA4EZ,EDxEoB,MCwEpB,CAAA,MA5E4B,EAAA;;;;IC6Bb,mBAAe,EFnBJ,MEmBI,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA;;;IAG7B,eAAA,CAAA,EFjBsB,MEiBtB,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;cDhCW,gBAAgB;;;;;;;;;;ADL7B;;;;;;;;;;ACKA;;;iBC6BgB,eAAA;;;;;;GAMb,uBAAuB,KAAA,CAAM;AANhC;;;;;;AFzBqB,UGLJ,oBAAA,CHKI;EAAM,QAAA,CAAA,EAAA,OAAA;;;;ECJd,SAAA,CAAA,EAAA,MA4EZ;;;;AC/CD;;AACE,iBCnBc,aAAA,CDmBd,KAAA,EAAA,OAAA,EAAA,WAAA,EAAA;UACA,CAAA,EAAA,OAAA;KACA,CAAA,EAAA,MAAA;KACA,CAAA,EAAA,MAAA;SACA,CAAA,EAAA,MAAA;UACC,GAAA,IAAA;;;;;;ACpCH;AAYgB,iBAiCA,sBAAA,CAjCa,OAAA,EAiCmB,eAjCnB,CAAA,EAiCqC,eAjCrC,CAAA,MAAA,CAAA;AAiC7B;;;;;AAqBgB,iBAAA,qBAAA,CAAA,CAAyB,EAAA,eAAe,CAAA,MAAA,CAAA;AAkBxD;AAuBA;AAuBA;AA6BA;AAuBA;AAA2C,iBAlG3B,qBAAA,CAAA,CAkG2B,EAlGF,eAkGE,CAAA,MAAA,CAAA;;;;;AA+C3C;AAAoC,iBA1HpB,sBAAA,CAAA,CA0HoB,EA1HM,eA0HN,CAAA,OAAA,CAAA;;;;AAuBpC;AAmBA;AAAuC,iBA7IvB,0BAAA,CAAA,CA6IuB,EA7IO,eA6IP,CAAA,OAAA,CAAA;;;;;AAyBvC;AAwCgB,iBAjLA,mBAAA,CAAA,CAiLqB,EAjLE,eAiLF,CAAA,MAAA,CAAA;;;;;AAiDrC;;;AAA8C,iBA3M9B,2BAAA,CA2M8B,SAAA,EA1MjC,SA0MiC,EAAA,OAAA,CAAA,EAzMlC,eAyMkC,CAAA,EAxM3C,eAwM2C,CAAA,OAAA,CAAA;;;;iBA5J9B,oBAAA,sCAED,QAAQ;AChP4D;;;AAmBhE,iBDkPH,0BAAA,CClPG,SAAA,EDkPmC,SClPnC,CAAA,EAAA,MAAA,GAAA,OAAA,GAAA,MAAA;;;;;AAkFnB;;;;AAGE,iBDgLc,uBAAA,CChLd,MAAA,EDiLQ,aCjLR,EAAA,GAAA,SAAA,EAAA,gBAAA,CAAA,EDkLkB,MClLlB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,EDmLC,UCnLD;;;;;;iBDyMc,oBAAA,CAAA,GAAwB;;AElTxC;;;;AAyBoC,iBFiUpB,qBAAA,CAAA,CEjUoB,EFiUK,eEjUL,CFiUqB,MEjUrB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;AAkBpC;;;;;AAIE,iBF4Vc,0BAAA,CAAA,CE5Vd,EF4V4C,eE5V5C,CF4V4D,ME5V5D,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,CAAA;;;;;;ALzCF;UIKU,qBAAA,CJLqB;;;;OASV,EIAZ,aJAY;EAAM;;;WIKhB,QAAQ;EHTN;;;WGcF;EFeK;;;gBAEd,CAAA,EEZiB,cFYjB;;;;OAIC,CAAA,EAAA,MAAA;;;;;;ACpCH;AAYA;AAiCA;;;;;AAqBA;AAkBA;AAuBA;AAuBgB,iBCtCA,gBAAA,CDsC0B;EAAA,KAAI;EAAA,OAAA;EAAA,OAAe;EAAA;AAAA,CAAA,ECjC1D,qBDiC0D,CAAA,ECjClC,OAAA,CAAM,YDiC4B,GAAA,IAAA;;;UE5I5C,6BAAA;;;;ELMA,iBAAc,EAAA,OAAA;EAAA;;;cAoBP,EAAA,OAAA;;;;;;ACfxB;;YIQY;;AHqBZ;;;iBAEE,CAAA,EGjBkB,gBHiBlB;;;;;mBAI8B,CAAA,EAAA,OAAA;;;;;ACpChC;AAYA;AAiCA;;;;AAAiF,iBEZjE,wBAAA,CFYiE;EAAA,iBAAA;EAAA,YAAA;EAAA,WAAA;EAAA,OAAA;EAAA,eAAA;EAAA;AAAA,CAAA,EEL9E,6BFK8E,CAAA,EEL9C,KAAA,CAAM,YFKwC;AAqBjF;;;UGtEU,wBAAA;kBACQ;;WAEP;ENHM,SAAA,CAAA,EAAA,OAAc;EAAA,QAAA,CAAA,EAAA,GAAA,GAAA,IAAA;WAIX,CAAA,EAAA,MAAA;OAWO,CAAA,EMRjB,KNQiB,GAAA,IAAA;;;;;;iBMDX,mBAAA;;;;;;;;GAQb,2BAA2B,GAAA,CAAI;;;UC1BxB,sBAAA;iBACO;;;EPGA,gBAAA,CAAc,EAAA,OAAA;EAAA,QAAA,CAAA,EOClB,OAAA,CAAM,SPDY;WAIX,CAAA,EAAA,MAAA;;;;;;;iBOMJ,iBAAA;;;;;;;GAOb,yBAAyB,OAAA,CAAM;;;UCGxB,2BAAA;mBACS;YACP;;ERtBK,sBAAc,CAAA,EAAA,MAAA;EAAA,qBAAA,CAAA,EAAA,CAAA,MAAA,EAAA,MAAA,EAAA,GAAA,IAAA;;AAeJ,cQiBd,sBRjBc,EQiBU,OAAA,CAAM,ERjBhB,CQiBmB,2BRjBnB,CAAA;;;USNjB,KAAA;;;;ITTO,EAAA,EAAA,MAAA;IAAc,IAAA,EAAA,MAAA;MAIX,IAAA;SAWO,ESFhB,eTEgB,GAAA,IAAA;;AANN,cSOR,qBTPQ,ESOe,OAAA,CAAM,ETPrB,CSOwB,KTPxB,CAAA;;;;;;;cUNR,8BAA8B,OAAA,CAAM;AVHjD"}