defmodule DatoCMS.StructuredText do defmodule CustomRenderersError do defexception [:message] end @mark_nodes %{ "code" => "code", "emphasis" => "em", "highlight" => "mark", "strikethrough" => "del", "strong" => "strong", "underline" => "u" } def to_html( %{value: %{schema: "dast", document: document}} = dast, options \\ %{} ) do render(document, dast, options) |> Enum.join("") end def render(%{type: "root"} = node, dast, options) do Enum.flat_map(node.children, &(render(&1, dast, options))) end def render(%{type: "blockquote"} = node, dast, options) do case renderer(options, :render_blockquote) do {:ok, renderer} -> renderer.(node, dast, options) |> list() _ -> caption = if Map.has_key?(node, :attribution) do ["
— #{node.attribution}
"] else [] end ["
"] ++ ["
"] ++ Enum.flat_map(node.children, &(render(&1, dast, options))) ++ ["
"] ++ caption ++ ["
"] end end def render(%{type: "code", code: code} = node, dast, options) do case renderer(options, :render_code) do {:ok, renderer} -> renderer.(node, dast, options) |> list() _ -> ["", code, ""] end end def render(%{type: "list", style: "bulleted"} = node, dast, options) do case renderer(options, :render_bulleted_list) do {:ok, renderer} -> renderer.(node, dast, options) |> list() _ -> [""] end end def render(%{type: "list", style: "numbered"} = node, dast, options) do case renderer(options, :render_numbered_list) do {:ok, renderer} -> renderer.(node, dast, options) |> list() _ -> ["
    "] ++ Enum.flat_map( node.children, fn list_item -> ["
  1. "] ++ Enum.flat_map(list_item.children, &(render(&1, dast, options))) ++ ["
  2. "] end ) ++ ["
"] end end def render(%{type: "paragraph"} = node, dast, options) do case renderer(options, :render_paragraph) do {:ok, renderer} -> renderer.(node, dast, options) |> list() _ -> inner = Enum.flat_map(node.children, &(render(&1, dast, options))) ["

"] ++ inner ++ ["

"] end end def render(%{type: "heading"} = node, dast, options) do case renderer(options, :render_heading) do {:ok, renderer} -> renderer.(node, dast, options) |> list() _ -> tag = "h#{node.level}" inner = Enum.flat_map(node.children, &(render(&1, dast, options))) ["<#{tag}>"] ++ inner ++ [""] end end def render(%{type: "link"} = node, dast, options) do case renderer(options, :render_link) do {:ok, renderer} -> renderer.(node, dast, options) |> list() _ -> inner = Enum.flat_map(node.children, &(render(&1, dast, options))) [~s()] ++ inner ++ [""] end end def render(%{type: "span", marks: [mark | marks]} = node, dast, options) do renderer_key = :"render_#{mark}" case renderer(options, renderer_key) do {:ok, renderer} -> renderer.(node, dast, options) |> list() _ -> simplified = Map.put(node, :marks, marks) inner = render(simplified, dast, options) node = @mark_nodes[mark] ["<#{node}>"] ++ inner ++ [""] end end def render(%{type: "span"} = node, _dast, _options) do [node.value] end def render(%{type: "inlineItem"} = node, dast, options) do with {:ok, renderer} <- renderer(options, :render_inline_record), {:ok, item} <- linked_item(node, dast) do if arity(renderer) == 1 do deprecation_warning(:render_inline_record, 1, 3) renderer.(item) |> list() else renderer.(item, dast, options) |> list() end else {:error, message} -> raise CustomRenderersError, message: message end end def render(%{type: "itemLink"} = node, dast, options) do with {:ok, renderer} <- renderer(options, :render_link_to_record), {:ok, item} <- linked_item(node, dast) do if arity(renderer) == 2 do deprecation_warning(:render_link_to_record, 2, 4) renderer.(item, node) |> list() else renderer.(item, node, dast, options) |> list() end else {:error, message} -> raise CustomRenderersError, message: message end end def render(%{type: "block"} = node, dast, options) do with {:ok, renderer} <- renderer(options, :render_block), {:ok, item} <- block(node, dast) do if arity(renderer) == 1 do deprecation_warning(:render_block, 1, 3) renderer.(item) |> list() else renderer.(item, dast, options) |> list() end else {:error, message} -> raise CustomRenderersError, message: message end end defp renderer(%{renderers: renderers}, name) do renderer = renderers[name] if renderer do {:ok, renderer} else { :error, """ No `#{name}` function supplied in options.renders Supplied renderers: #{inspect(Map.keys(renderers))} """ } end end defp renderer(options, _name) do { :error, """ No `:renderers` supplied in options: options: #{inspect(Map.keys(options))} """ } end defp block(%{item: item_id} = node, %{blocks: blocks}) do item = Enum.find(blocks, &(&1.id == item_id)) if item do {:ok, item} else { :error, """ Linked item `#{item_id}` not found in `dast.blocks`. A "block" node requires item #{node.item} to be present in `dast.blocks`. `node` contents: #{inspect(node)} `links` contents: #{inspect(blocks)} """ } end end defp block(node, dast) do { :error, """ No `:blocks` supplied in dast. A "block" node requires `:blocks` to be present in `dast`. `node` contents: #{inspect(node)} `dast` contents: #{inspect(dast)} """ } end defp linked_item(%{item: item_id} = node, %{links: links}) do item = Enum.find(links, &(&1.id == item_id)) if item do {:ok, item} else { :error, """ Linked item `#{item_id}` not found in `dast.links`. A node of type `#{node.type}` requires item #{node.item} to be present in the `dast`. `node` contents: #{inspect(node)} `links` contents: #{inspect(links)} """ } end end defp linked_item(node, dast) do { :error, """ No `:links` supplied in dast. A node of type `#{node.type}` requires `:links` to be present in the `dast`. `node` contents: #{inspect(node)} `dast` contents: #{inspect(dast)} """ } end defp list(item) when is_list(item), do: item defp list(item), do: [item] defp arity(fun), do: :erlang.fun_info(fun)[:arity] defp deprecation_warning(renderer, old, new) do IO.warn """ The custom renderer `#{renderer}/#{old}` parameters to DatoCMS.StructuredText.to_html/2 is deprecated. Custom renderers for `#{renderer}` now take #{new} parameters. """ end end