# Generated by SnakeBridge v0.16.0 - DO NOT EDIT MANUALLY
# Regenerate with: mix compile
# Helper library: graceful_serialization

defmodule GracefulSerialization.Helpers do
  @moduledoc "Helper wrappers for `graceful_serialization`."

  @doc "Return a dict containing a generator and a regular value."
  @spec dict_with_generator(keyword()) :: {:ok, term()} | {:error, term()}
  def dict_with_generator(opts \\ []) do
    SnakeBridge.Runtime.call_helper("graceful_serialization.dict_with_generator", [], opts)
  end

  @doc "Return a dict containing a compiled regex pattern."
  @spec dict_with_pattern(keyword()) :: {:ok, term()} | {:error, term()}
  def dict_with_pattern(opts \\ []) do
    SnakeBridge.Runtime.call_helper("graceful_serialization.dict_with_pattern", [], opts)
  end

  @doc "Return a list containing a compiled regex pattern."
  @spec list_with_pattern(keyword()) :: {:ok, term()} | {:error, term()}
  def list_with_pattern(opts \\ []) do
    SnakeBridge.Runtime.call_helper("graceful_serialization.list_with_pattern", [], opts)
  end

  @doc "Return a list with multiple compiled patterns at different positions."
  @spec multiple_patterns(keyword()) :: {:ok, term()} | {:error, term()}
  def multiple_patterns(opts \\ []) do
    SnakeBridge.Runtime.call_helper("graceful_serialization.multiple_patterns", [], opts)
  end

  @doc "Return a deeply nested structure with a compiled pattern."
  @spec nested_structure(keyword()) :: {:ok, term()} | {:error, term()}
  def nested_structure(opts \\ []) do
    SnakeBridge.Runtime.call_helper("graceful_serialization.nested_structure", [], opts)
  end

  @doc "Return a pattern compiled with flags to show flag preservation."
  @spec pattern_with_flags(keyword()) :: {:ok, term()} | {:error, term()}
  def pattern_with_flags(opts \\ []) do
    SnakeBridge.Runtime.call_helper("graceful_serialization.pattern_with_flags", [], opts)
  end

  @doc "Return a tuple containing a compiled pattern."
  @spec tuple_with_pattern(keyword()) :: {:ok, term()} | {:error, term()}
  def tuple_with_pattern(opts \\ []) do
    SnakeBridge.Runtime.call_helper("graceful_serialization.tuple_with_pattern", [], opts)
  end

  @doc "Return a list of validation configurations with compiled regex patterns.\n\nThis is a real-world pattern: storing compiled patterns alongside metadata\nfor form validation, input parsing, API request validation, etc.\n\nExpected behavior: The outer list and inner dicts should be preserved,\nwith only the 'pattern' field becoming a ref (re.Pattern is non-serializable)."
  @spec validation_configs(keyword()) :: {:ok, term()} | {:error, term()}
  def validation_configs(opts \\ []) do
    SnakeBridge.Runtime.call_helper("graceful_serialization.validation_configs", [], opts)
  end
end