@ic-reactor/candid 3.0.12-beta.0 → 3.0.14-beta.0

package/dist/visitor/arguments/types.d.ts

@@ -1,149 +1,173 @@
 import type { BaseActor, FunctionName, FunctionType } from "@ic-reactor/core";
 import * as z from "zod";
-export type ArgumentFieldType = "record" | "variant" | "tuple" | "optional" | "vector" | "blob" | "recursive" | "principal" | "number" | "text" | "boolean" | "null" | "unknown";
-export interface FieldUIHints {
-    /** Placeholder text for the input */
-    placeholder?: string;
-    /** Description or help text for the field */
+import type { VisitorDataType, TextFormat, NumberFormat } from "../types";
+export type { TextFormat, NumberFormat };
+export type ArgumentFieldType = VisitorDataType;
+/**
+ * Suggested component type for rendering the field.
+ * This eliminates the need for switch statements in the frontend.
+ */
+export type FieldComponentType = "record-container" | "tuple-container" | "variant-select" | "optional-toggle" | "vector-list" | "blob-upload" | "principal-input" | "text-input" | "number-input" | "boolean-checkbox" | "null-hidden" | "recursive-lazy" | "unknown-fallback";
+/**
+ * Input type hints for HTML input elements.
+ * Used by primitive fields to suggest the appropriate input type.
+ */
+export type InputType = "text" | "number" | "checkbox" | "select" | "file" | "textarea";
+/**
+ * Rendering hints for the UI.
+ * Eliminates the need for frontend to maintain COMPLEX_TYPES arrays.
+ */
+export interface RenderHint {
+    /** Whether this field has its own container/card styling (compound types) */
+    isCompound: boolean;
+    /** Whether this is a leaf input (primitive types) */
+    isPrimitive: boolean;
+    /** Suggested input type for HTML input elements */
+    inputType?: InputType;
+    /** Description or help text for the field (derived from Candid) */
     description?: string;
-    /** Whether the field is required */
-    required?: boolean;
-    /** Whether the field should be disabled */
-    disabled?: boolean;
-    /** Additional CSS class names */
-    className?: string;
 }
-export interface FieldBase<TValue = unknown> {
+/**
+ * Pre-computed HTML input props for primitive fields.
+ * Can be spread directly onto an input element.
+ */
+export interface PrimitiveInputProps {
+    /** HTML input type - includes format-specific types */
+    type?: "text" | "number" | "checkbox" | "email" | "url" | "tel";
+    /** Placeholder text */
+    placeholder?: string;
+    /** Minimum value for number inputs */
+    min?: string | number;
+    /** Maximum value for number inputs */
+    max?: string | number;
+    /** Step value for number inputs */
+    step?: string | number;
+    /** Pattern for text inputs (e.g., phone numbers) */
+    pattern?: string;
+    /** Input mode for virtual keyboards */
+    inputMode?: "text" | "numeric" | "decimal" | "email" | "tel" | "url";
+    /** Autocomplete hint */
+    autoComplete?: string;
+    /** Whether to check spelling */
+    spellCheck?: boolean;
+    /** Minimum length for text inputs */
+    minLength?: number;
+    /** Maximum length for text inputs */
+    maxLength?: number;
+}
+interface FieldBase<T extends VisitorDataType = VisitorDataType> {
     /** The field type */
-    type: ArgumentFieldType;
-    /** Human-readable label from Candid */
+    type: T;
+    /** Raw label from Candid: "__arg0", "_0_" */
     label: string;
-    /**
-     * Form field name path for binding.
-     * Uses bracket notation for array indices: `[0]`, `args[0].owner`, `tags[1]`
-     * Compatible with TanStack Form's `form.Field` name prop.
-     *
-     * @example
-     * ```tsx
-     * <form.Field name={field.name}>
-     *   {(fieldApi) => <input {...} />}
-     * </form.Field>
-     * ```
-     */
+    /** Pre-formatted display label for UI rendering */
+    displayLabel: string;
+    /** Form field name path for binding */
     name: string;
+    /** Suggested component type for rendering this field */
+    component: FieldComponentType;
+    /** Rendering hints for UI strategy */
+    renderHint: RenderHint;
     /** Zod schema for field validation */
     schema: z.ZodTypeAny;
-    /** Default value for the field */
-    defaultValue: TValue;
     /** Original Candid type name for reference */
-    candidType?: string;
-    /** UI rendering hints */
-    ui?: FieldUIHints;
+    candidType: string;
+}
+/**
+ * Blob field size limits.
+ */
+export interface BlobLimits {
+    /** Maximum bytes when entering as hex (e.g., 512 bytes) */
+    maxHexBytes: number;
+    /** Maximum file size in bytes (e.g., 2MB ICP limit) */
+    maxFileBytes: number;
+    /** Maximum hex display length before truncation */
+    maxHexDisplayLength: number;
+}
+/**
+ * Validation result for blob input.
+ */
+export interface BlobValidationResult {
+    /** Whether the input is valid */
+    valid: boolean;
+    /** Error message if invalid */
+    error?: string;
 }
-export interface RecordField extends FieldBase<Record<string, unknown>> {
-    type: "record";
+type FieldExtras<T extends VisitorDataType> = T extends "record" ? {
     /** Child fields in the record */
-    fields: Field[];
+    fields: FieldNode[];
     /** Map of field label to its metadata for quick lookup */
-    fieldMap: Map<string, Field>;
-}
-export interface VariantField extends FieldBase<Record<string, unknown>> {
-    type: "variant";
+    fieldMap: Map<string, FieldNode>;
+    defaultValue: Record<string, unknown>;
+} : T extends "variant" ? {
     /** All variant option fields */
-    fields: Field[];
+    fields: FieldNode[];
     /** List of variant option names */
     options: string[];
     /** Default selected option */
     defaultOption: string;
     /** Map of option name to its field metadata */
-    optionMap: Map<string, Field>;
-    /**
-     * Get default value for a specific option.
-     * Useful when switching between variant options.
-     *
-     * @example
-     * ```tsx
-     * const handleOptionChange = (newOption: string) => {
-     *   const newDefault = field.getOptionDefault(newOption)
-     *   fieldApi.handleChange(newDefault)
-     * }
-     * ```
-     */
+    optionMap: Map<string, FieldNode>;
+    defaultValue: Record<string, unknown>;
+    /** Get default value for a specific option */
     getOptionDefault: (option: string) => Record<string, unknown>;
-}
-export interface TupleField extends FieldBase<unknown[]> {
-    type: "tuple";
+    /** Get the field for a specific option */
+    getField: (option: string) => FieldNode;
+    /** Get the currently selected option from a value */
+    getSelectedOption: (value: Record<string, unknown>) => string;
+    /** Get the selected field from a value */
+    getSelectedField: (value: Record<string, unknown>) => FieldNode;
+} : T extends "tuple" ? {
     /** Tuple element fields in order */
-    fields: Field[];
-}
-export interface OptionalField extends FieldBase<null> {
-    type: "optional";
+    fields: FieldNode[];
+    defaultValue: unknown[];
+} : T extends "optional" ? {
     /** The inner field when value is present */
-    innerField: Field;
-    /**
-     * Get default value when enabling the optional.
-     * Returns the inner field's default value.
-     *
-     * @example
-     * ```tsx
-     * const handleToggle = (enabled: boolean) => {
-     *   if (enabled) {
-     *     fieldApi.handleChange(field.getInnerDefault())
-     *   } else {
-     *     fieldApi.handleChange(null)
-     *   }
-     * }
-     * ```
-     */
+    innerField: FieldNode;
+    defaultValue: null;
+    /** Get default value when enabling the optional */
     getInnerDefault: () => unknown;
-}
-export interface VectorField extends FieldBase<unknown[]> {
-    type: "vector";
+    /** Check if a value represents an enabled optional */
+    isEnabled: (value: unknown) => boolean;
+} : T extends "vector" ? {
     /** Template field for vector items */
-    itemField: Field;
-    /**
-     * Get a new item with default values.
-     * Used when adding items to the vector.
-     *
-     * @example
-     * ```tsx
-     * <button onClick={() => fieldApi.pushValue(field.getItemDefault())}>
-     *   Add Item
-     * </button>
-     * ```
-     */
+    itemField: FieldNode;
+    defaultValue: unknown[];
+    /** Get a new item with default values */
     getItemDefault: () => unknown;
-}
-export interface BlobField extends FieldBase<string> {
-    type: "blob";
+    /** Create a properly configured item field for a specific index */
+    createItemField: (index: number, overrides?: {
+        label?: string;
+    }) => FieldNode;
+} : T extends "blob" ? {
     /** Item field for individual bytes (nat8) */
-    itemField: Field;
+    itemField: FieldNode;
     /** Accepted input formats */
     acceptedFormats: ("hex" | "base64" | "file")[];
-}
-export interface RecursiveField extends FieldBase<undefined> {
-    type: "recursive";
+    /** Size limits for blob input */
+    limits: BlobLimits;
+    /** Normalize hex input */
+    normalizeHex: (input: string) => string;
+    /** Validate blob input value */
+    validateInput: (value: string | Uint8Array) => BlobValidationResult;
+    defaultValue: string;
+} : T extends "recursive" ? {
     /** Type name for the recursive type */
     typeName: string;
     /** Lazily extract the inner field to prevent infinite loops */
-    extract: () => Field;
-    /**
-     * Get default value for the recursive type.
-     * Evaluates the inner type on demand.
-     */
+    extract: () => FieldNode;
+    /** Get default value for the recursive type (evaluates lazily) */
     getInnerDefault: () => unknown;
-}
-export interface PrincipalField extends FieldBase<string> {
-    type: "principal";
+    defaultValue: undefined;
+} : T extends "principal" ? {
     maxLength: number;
     minLength: number;
-}
-export interface NumberField extends FieldBase<string> {
-    type: "number";
-    /**
-     * Original Candid type: nat, int, nat8, nat16, nat32, nat64, int8, int16, int32, int64, float32, float64
-     */
-    candidType: string;
+    /** Detected format based on label heuristics */
+    format: TextFormat;
+    /** Pre-computed HTML input props */
+    inputProps: PrimitiveInputProps;
+    defaultValue: string;
+} : T extends "number" ? {
     /** Whether this is an unsigned type */
     unsigned: boolean;
     /** Whether this is a floating point type */
@@ -154,54 +178,52 @@ export interface NumberField extends FieldBase<string> {
     min?: string;
     /** Maximum value constraint (for bounded types) */
     max?: string;
-}
-export interface TextField extends FieldBase<string> {
-    type: "text";
+    /** Detected format based on label heuristics */
+    format: NumberFormat;
+    /** Pre-computed HTML input props */
+    inputProps: PrimitiveInputProps;
+    defaultValue: string;
+} : T extends "text" ? {
     /** Minimum length constraint */
     minLength?: number;
     /** Maximum length constraint */
     maxLength?: number;
     /** Whether to render as multiline textarea */
     multiline?: boolean;
-}
-export interface BooleanField extends FieldBase<boolean> {
-    type: "boolean";
-}
-export interface NullField extends FieldBase<null> {
-    type: "null";
-}
-export interface UnknownField extends FieldBase<undefined> {
-    type: "unknown";
-}
-export type Field = RecordField | VariantField | TupleField | OptionalField | VectorField | BlobField | RecursiveField | PrincipalField | NumberField | TextField | BooleanField | NullField | UnknownField;
+    /** Detected format based on label heuristics */
+    format: TextFormat;
+    /** Pre-computed HTML input props */
+    inputProps: PrimitiveInputProps;
+    defaultValue: string;
+} : T extends "boolean" ? {
+    /** Pre-computed HTML input props */
+    inputProps: PrimitiveInputProps;
+    defaultValue: boolean;
+} : T extends "null" ? {
+    defaultValue: null;
+} : T extends "unknown" ? {
+    defaultValue: undefined;
+} : {};
+/**
+ * A unified field node that contains all metadata needed for rendering.
+ */
+export type FieldNode<T extends VisitorDataType = VisitorDataType> = FieldBase<T> & FieldExtras<T>;
+export type RecordField = FieldNode<"record">;
+export type VariantField = FieldNode<"variant">;
+export type TupleField = FieldNode<"tuple">;
+export type OptionalField = FieldNode<"optional">;
+export type VectorField = FieldNode<"vector">;
+export type BlobField = FieldNode<"blob">;
+export type RecursiveField = FieldNode<"recursive">;
+export type PrincipalField = FieldNode<"principal">;
+export type NumberField = FieldNode<"number">;
+export type TextField = FieldNode<"text">;
+export type BooleanField = FieldNode<"boolean">;
+export type NullField = FieldNode<"null">;
+export type UnknownField = FieldNode<"unknown">;
 /**
  * Form metadata for a Candid method.
  * Contains all information needed to create a TanStack Form instance.
- *
- * @example
- * ```tsx
- * import { useForm } from '@tanstack/react-form'
- *
- * function MethodForm({ meta }: { meta: FormMeta }) {
- *   const form = useForm({
- *     ...meta.formOptions,
- *     onSubmit: async ({ value }) => {
- *       await actor[meta.functionName](...value)
- *     }
- *   })
- *
- *   return (
- *     <form onSubmit={(e) => { e.preventDefault(); form.handleSubmit() }}>
- *       {meta.fields.map(field => (
- *         <form.Field key={field.name} name={field.name}>
- *           {(fieldApi) => <DynamicInput field={field} fieldApi={fieldApi} />}
- *         </form.Field>
- *       ))}
- *       <button type="submit">Submit</button>
- *     </form>
- *   )
- * }
- * ```
  */
 export interface ArgumentsMeta<A = BaseActor, Name extends FunctionName<A> = FunctionName<A>> {
     /** Whether this is a "query" or "update" function */
@@ -209,7 +231,7 @@ export interface ArgumentsMeta<A = BaseActor, Name extends FunctionName<A> = Fun
     /** The function name */
     functionName: Name;
     /** Argument field definitions for rendering */
-    fields: Field[];
+    fields: FieldNode[];
     /** Default values for all arguments (as a tuple) */
     defaultValues: unknown[];
     /** Combined Zod schema for all arguments */
@@ -240,36 +262,19 @@ export type ArgumentsServiceMeta<A = BaseActor> = {
     [K in FunctionName<A>]: ArgumentsMeta<A, K>;
 };
 /** Extract a specific field type */
-export type FieldByType<T extends ArgumentFieldType> = Extract<Field, {
+export type FieldByType<T extends ArgumentFieldType> = Extract<FieldNode, {
     type: T;
 }>;
+/**
+ * Props type helper for field components.
+ * Use this to type your field components for better DX.
+ */
+export type FieldProps<T extends ArgumentFieldType> = {
+    field: FieldByType<T>;
+    renderField?: (child: FieldNode) => React.ReactNode;
+};
 /** Compound field types that contain other fields */
 export type CompoundField = RecordField | VariantField | TupleField | OptionalField | VectorField | RecursiveField;
 /** Primitive field types */
 export type PrimitiveField = PrincipalField | NumberField | TextField | BooleanField | NullField;
-/**
- * Type guard for checking specific field types.
- *
- * @example
- * ```tsx
- * function FieldInput({ field }: { field: Field }) {
- *   if (isFieldType(field, 'record')) {
- *     // field is now typed as RecordField
- *     return <RecordInput field={field} />
- *   }
- *   if (isFieldType(field, 'text')) {
- *     // field is now typed as TextField
- *     return <TextInput field={field} />
- *   }
- *   // ...
- * }
- * ```
- */
-export declare function isFieldType<T extends ArgumentFieldType>(field: Field, type: T): field is FieldByType<T>;
-/** Check if a field is a compound type (contains other fields) */
-export declare function isCompoundField(field: Field): field is CompoundField;
-/** Check if a field is a primitive type */
-export declare function isPrimitiveField(field: Field): field is PrimitiveField;
-/** Check if a field has children (for iteration) */
-export declare function hasChildFields(field: Field): field is RecordField | VariantField | TupleField;
 //# sourceMappingURL=types.d.ts.map

package/dist/visitor/arguments/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/visitor/arguments/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/visitor/arguments/types.ts"],"names":[],"mappings":"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"}

package/dist/visitor/arguments/types.js

@@ -1,41 +1,2 @@
-/**
- * Type guard for checking specific field types.
- *
- * @example
- * ```tsx
- * function FieldInput({ field }: { field: Field }) {
- *   if (isFieldType(field, 'record')) {
- *     // field is now typed as RecordField
- *     return <RecordInput field={field} />
- *   }
- *   if (isFieldType(field, 'text')) {
- *     // field is now typed as TextField
- *     return <TextInput field={field} />
- *   }
- *   // ...
- * }
- * ```
- */
-export function isFieldType(field, type) {
-    return field.type === type;
-}
-/** Check if a field is a compound type (contains other fields) */
-export function isCompoundField(field) {
-    return [
-        "record",
-        "variant",
-        "tuple",
-        "optional",
-        "vector",
-        "recursive",
-    ].includes(field.type);
-}
-/** Check if a field is a primitive type */
-export function isPrimitiveField(field) {
-    return ["principal", "number", "text", "boolean", "null"].includes(field.type);
-}
-/** Check if a field has children (for iteration) */
-export function hasChildFields(field) {
-    return "fields" in field && Array.isArray(field.fields);
-}
+export {};
 //# sourceMappingURL=types.js.map

package/dist/visitor/arguments/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/visitor/arguments/types.ts"],"names":[],"mappings":"AA0VA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CACzB,KAAY,EACZ,IAAO;IAEP,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,CAAA;AAC5B,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,OAAO;QACL,QAAQ;QACR,SAAS;QACT,OAAO;QACP,UAAU;QACV,QAAQ;QACR,WAAW;KACZ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAChF,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,cAAc,CAC5B,KAAY;IAEZ,OAAO,QAAQ,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,CAAE,KAAqB,CAAC,MAAM,CAAC,CAAA;AAC1E,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/visitor/arguments/types.ts"],"names":[],"mappings":""}

package/dist/visitor/returns/types.d.ts

@@ -1,8 +1,8 @@
 import type { BaseActor, FunctionName, FunctionType, ActorMethodReturnType } from "@ic-reactor/core";
-export type NodeType = "record" | "variant" | "tuple" | "optional" | "vector" | "blob" | "recursive" | "principal" | "number" | "text" | "boolean" | "null" | "unknown";
+import type { VisitorDataType, TextFormat, NumberFormat } from "../types";
+export type { TextFormat, NumberFormat };
+export type NodeType = VisitorDataType;
 export type DisplayType = "string" | "number" | "boolean" | "null" | "object" | "array" | "variant" | "result" | "nullable" | "recursive" | "blob" | "unknown";
-export type NumberFormat = "timestamp" | "cycle" | "value" | "token" | "normal";
-export type TextFormat = "plain" | "timestamp" | "uuid" | "url" | "email" | "phone" | "btc" | "eth" | "account-id" | "principal";
 /**
  * Base properties shared by all result nodes.
  */
@@ -99,5 +99,4 @@ export interface ResolvedMethodResult<A = BaseActor> {
 export type ServiceMeta<A = BaseActor> = {
     [K in FunctionName<A>]: MethodMeta<A, K>;
 };
-export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/visitor/returns/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/visitor/returns/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/visitor/returns/types.ts"],"names":[],"mappings":"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"}

package/dist/visitor/types.d.ts

@@ -2,4 +2,18 @@ export type FieldType = "functionRecord" | "function" | "record" | "variant" | "
 export type { Principal } from "@icp-sdk/core/principal";
 import type { IDL } from "@icp-sdk/core/candid";
 export type AllNumberTypes = IDL.NatClass | IDL.IntClass | IDL.FixedNatClass | IDL.FixedIntClass | IDL.FloatClass;
+/**
+ * The core Candid type category used across visitors.
+ */
+export type VisitorDataType = "record" | "variant" | "tuple" | "optional" | "vector" | "blob" | "recursive" | "principal" | "number" | "text" | "boolean" | "null" | "unknown";
+/**
+ * Detected format for text fields based on label heuristics.
+ * Used to provide format-specific validation and display.
+ */
+export type TextFormat = "plain" | "timestamp" | "uuid" | "url" | "email" | "phone" | "btc" | "eth" | "account-id" | "principal" | "cycle";
+/**
+ * Detected format for number fields based on label heuristics.
+ * Used to provide format-specific validation and display.
+ */
+export type NumberFormat = "timestamp" | "cycle" | "value" | "token" | "normal";
 //# sourceMappingURL=types.d.ts.map

package/dist/visitor/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/visitor/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,UAAU,GACV,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,MAAM,GACN,YAAY,GACZ,WAAW,GACX,SAAS,GACT,MAAM,GACN,QAAQ,GACR,WAAW,GACX,SAAS,GACT,MAAM,CAAA;AAEV,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAC/C,MAAM,MAAM,cAAc,GACtB,GAAG,CAAC,QAAQ,GACZ,GAAG,CAAC,QAAQ,GACZ,GAAG,CAAC,aAAa,GACjB,GAAG,CAAC,aAAa,GACjB,GAAG,CAAC,UAAU,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/visitor/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,UAAU,GACV,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,MAAM,GACN,YAAY,GACZ,WAAW,GACX,SAAS,GACT,MAAM,GACN,QAAQ,GACR,WAAW,GACX,SAAS,GACT,MAAM,CAAA;AAEV,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAC/C,MAAM,MAAM,cAAc,GACtB,GAAG,CAAC,QAAQ,GACZ,GAAG,CAAC,QAAQ,GACZ,GAAG,CAAC,aAAa,GACjB,GAAG,CAAC,aAAa,GACjB,GAAG,CAAC,UAAU,CAAA;AAMlB;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,MAAM,GACN,WAAW,GACX,WAAW,GACX,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,SAAS,CAAA;AAEb;;;GAGG;AACH,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,WAAW,GACX,MAAM,GACN,KAAK,GACL,OAAO,GACP,OAAO,GACP,KAAK,GACL,KAAK,GACL,YAAY,GACZ,WAAW,GACX,OAAO,CAAA;AAEX;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ic-reactor/candid",
-  "version": "3.0.12-beta.0",
+  "version": "3.0.14-beta.0",
   "description": "IC Reactor Candid Adapter - Fetch and parse Candid definitions from Internet Computer canisters",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -44,7 +44,7 @@
   "dependencies": {
     "@noble/hashes": "^2.0.1",
     "zod": "^4.3.5",
-    "@ic-reactor/core": "^3.0.12-beta.0"
+    "@ic-reactor/core": "^3.0.14-beta.0"
   },
   "peerDependencies": {
     "zod": "^4.3.5",

package/src/metadata-display-reactor.ts

@@ -9,7 +9,7 @@ import type {
   DynamicMethodOptions,
 } from "./types"
 import {
-  ArgumentFieldVisitor,
+  FieldVisitor,
   ArgumentsMeta,
   ArgumentsServiceMeta,
 } from "./visitor/arguments"
@@ -54,7 +54,7 @@ export class MetadataDisplayReactor<A = BaseActor> extends CandidDisplayReactor<
   private resultMeta: ServiceMeta<A> | null = null
 
   // Visitors (stateless, can be reused)
-  private static argVisitor = new ArgumentFieldVisitor()
+  private static argVisitor = new FieldVisitor()
   private static resultVisitor = new ResultFieldVisitor()
 
   constructor(config: CandidDisplayReactorParameters<A>) {