skill-universe 1.1.0

package/build/dev/javascript/gleam_stdlib/gleam@dict.erl

@@ -0,0 +1,521 @@
+-module(gleam@dict).
+-compile([no_auto_import, nowarn_unused_vars, nowarn_unused_function, nowarn_nomatch, inline]).
+-define(FILEPATH, "src/gleam/dict.gleam").
+-export([size/1, is_empty/1, has_key/2, new/0, get/2, insert/3, from_list/1, map_values/2, take/2, delete/2, drop/2, upsert/3, fold/3, to_list/1, keys/1, values/1, filter/2, each/2, combine/3, merge/2, group/2]).
+-export_type([dict/2, transient_dict/2]).
+
+-if(?OTP_RELEASE >= 27).
+-define(MODULEDOC(Str), -moduledoc(Str)).
+-define(DOC(Str), -doc(Str)).
+-else.
+-define(MODULEDOC(Str), -compile([])).
+-define(DOC(Str), -compile([])).
+-endif.
+
+-type dict(JL, JM) :: any() | {gleam_phantom, JL, JM}.
+
+-type transient_dict(JN, JO) :: any() | {gleam_phantom, JN, JO}.
+
+-file("src/gleam/dict.gleam", 55).
+?DOC(
+    " Determines the number of key-value pairs in the dict.\n"
+    " This function runs in constant time and does not need to iterate the dict.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> size\n"
+    " // -> 0\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> insert(\"key\", \"value\") |> size\n"
+    " // -> 1\n"
+    " ```\n"
+).
+-spec size(dict(any(), any())) -> integer().
+size(Dict) ->
+    maps:size(Dict).
+
+-file("src/gleam/dict.gleam", 71).
+?DOC(
+    " Determines whether or not the dict is empty.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> is_empty\n"
+    " // -> True\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> insert(\"b\", 1) |> is_empty\n"
+    " // -> False\n"
+    " ```\n"
+).
+-spec is_empty(dict(any(), any())) -> boolean().
+is_empty(Dict) ->
+    maps:size(Dict) =:= 0.
+
+-file("src/gleam/dict.gleam", 138).
+?DOC(
+    " Determines whether or not a value is present in the dict for a given key.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> insert(\"a\", 0) |> has_key(\"a\")\n"
+    " // -> True\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> insert(\"a\", 0) |> has_key(\"b\")\n"
+    " // -> False\n"
+    " ```\n"
+).
+-spec has_key(dict(LA, any()), LA) -> boolean().
+has_key(Dict, Key) ->
+    maps:is_key(Key, Dict).
+
+-file("src/gleam/dict.gleam", 149).
+?DOC(" Creates a fresh dict that contains no values.\n").
+-spec new() -> dict(any(), any()).
+new() ->
+    maps:new().
+
+-file("src/gleam/dict.gleam", 170).
+?DOC(
+    " Fetches a value from a dict for a given key.\n"
+    "\n"
+    " The dict may not have a value for the key, so the value is wrapped in a\n"
+    " `Result`.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> insert(\"a\", 0) |> get(\"a\")\n"
+    " // -> Ok(0)\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> insert(\"a\", 0) |> get(\"b\")\n"
+    " // -> Error(Nil)\n"
+    " ```\n"
+).
+-spec get(dict(LM, LN), LM) -> {ok, LN} | {error, nil}.
+get(From, Get) ->
+    gleam_stdlib:map_get(From, Get).
+
+-file("src/gleam/dict.gleam", 190).
+?DOC(
+    " Inserts a value into the dict with the given key.\n"
+    "\n"
+    " If the dict already has a value for the given key then the value is\n"
+    " replaced with the new value.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> insert(\"a\", 0)\n"
+    " // -> from_list([#(\"a\", 0)])\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> insert(\"a\", 0) |> insert(\"a\", 5)\n"
+    " // -> from_list([#(\"a\", 5)])\n"
+    " ```\n"
+).
+-spec insert(dict(LS, LT), LS, LT) -> dict(LS, LT).
+insert(Dict, Key, Value) ->
+    maps:put(Key, Value, Dict).
+
+-file("src/gleam/dict.gleam", 112).
+-spec from_list_loop(transient_dict(KT, KU), list({KT, KU})) -> dict(KT, KU).
+from_list_loop(Transient, List) ->
+    case List of
+        [] ->
+            gleam_stdlib:identity(Transient);
+
+        [{Key, Value} | Rest] ->
+            from_list_loop(maps:put(Key, Value, Transient), Rest)
+    end.
+
+-file("src/gleam/dict.gleam", 108).
+?DOC(
+    " Converts a list of 2-element tuples `#(key, value)` to a dict.\n"
+    "\n"
+    " If two tuples have the same key the last one in the list will be the one\n"
+    " that is present in the dict.\n"
+).
+-spec from_list(list({KO, KP})) -> dict(KO, KP).
+from_list(List) ->
+    maps:from_list(List).
+
+-file("src/gleam/dict.gleam", 217).
+?DOC(
+    " Updates all values in a given dict by calling a given function on each key\n"
+    " and value.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(3, 3), #(2, 4)])\n"
+    " |> map_values(fn(key, value) { key * value })\n"
+    " // -> from_list([#(3, 9), #(2, 8)])\n"
+    " ```\n"
+).
+-spec map_values(dict(MK, ML), fun((MK, ML) -> MO)) -> dict(MK, MO).
+map_values(Dict, Fun) ->
+    maps:map(Fun, Dict).
+
+-file("src/gleam/dict.gleam", 322).
+-spec do_take_loop(dict(OI, OJ), list(OI), transient_dict(OI, OJ)) -> dict(OI, OJ).
+do_take_loop(Dict, Desired_keys, Acc) ->
+    case Desired_keys of
+        [] ->
+            gleam_stdlib:identity(Acc);
+
+        [Key | Rest] ->
+            case gleam_stdlib:map_get(Dict, Key) of
+                {ok, Value} ->
+                    do_take_loop(Dict, Rest, maps:put(Key, Value, Acc));
+
+                {error, _} ->
+                    do_take_loop(Dict, Rest, Acc)
+            end
+    end.
+
+-file("src/gleam/dict.gleam", 313).
+?DOC(
+    " Creates a new dict from a given dict, only including any entries for which the\n"
+    " keys are in a given list.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)])\n"
+    " |> take([\"b\"])\n"
+    " // -> from_list([#(\"b\", 1)])\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)])\n"
+    " |> take([\"a\", \"b\", \"c\"])\n"
+    " // -> from_list([#(\"a\", 0), #(\"b\", 1)])\n"
+    " ```\n"
+).
+-spec take(dict(NU, NV), list(NU)) -> dict(NU, NV).
+take(Dict, Desired_keys) ->
+    maps:with(Desired_keys, Dict).
+
+-file("src/gleam/dict.gleam", 371).
+?DOC(
+    " Creates a new dict from a given dict with all the same entries except for the\n"
+    " one with a given key, if it exists.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)]) |> delete(\"a\")\n"
+    " // -> from_list([#(\"b\", 1)])\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)]) |> delete(\"c\")\n"
+    " // -> from_list([#(\"a\", 0), #(\"b\", 1)])\n"
+    " ```\n"
+).
+-spec delete(dict(OZ, PA), OZ) -> dict(OZ, PA).
+delete(Dict, Key) ->
+    _pipe = gleam_stdlib:identity(Dict),
+    _pipe@1 = maps:remove(Key, _pipe),
+    gleam_stdlib:identity(_pipe@1).
+
+-file("src/gleam/dict.gleam", 408).
+-spec drop_loop(transient_dict(PZ, QA), list(PZ)) -> dict(PZ, QA).
+drop_loop(Transient, Disallowed_keys) ->
+    case Disallowed_keys of
+        [] ->
+            gleam_stdlib:identity(Transient);
+
+        [Key | Rest] ->
+            drop_loop(maps:remove(Key, Transient), Rest)
+    end.
+
+-file("src/gleam/dict.gleam", 399).
+?DOC(
+    " Creates a new dict from a given dict with all the same entries except any with\n"
+    " keys found in a given list.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)]) |> drop([\"a\"])\n"
+    " // -> from_list([#(\"b\", 1)])\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)]) |> drop([\"c\"])\n"
+    " // -> from_list([#(\"a\", 0), #(\"b\", 1)])\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)]) |> drop([\"a\", \"b\", \"c\"])\n"
+    " // -> from_list([])\n"
+    " ```\n"
+).
+-spec drop(dict(PL, PM), list(PL)) -> dict(PL, PM).
+drop(Dict, Disallowed_keys) ->
+    maps:without(Disallowed_keys, Dict).
+
+-file("src/gleam/dict.gleam", 441).
+?DOC(
+    " Creates a new dict with one entry inserted or updated using a given function.\n"
+    "\n"
+    " If there was not an entry in the dict for the given key then the function\n"
+    " gets `None` as its argument, otherwise it gets `Some(value)`.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " let dict = from_list([#(\"a\", 0)])\n"
+    " let increment = fn(x) {\n"
+    "   case x {\n"
+    "     Some(i) -> i + 1\n"
+    "     None -> 0\n"
+    "   }\n"
+    " }\n"
+    "\n"
+    " upsert(dict, \"a\", increment)\n"
+    " // -> from_list([#(\"a\", 1)])\n"
+    "\n"
+    " upsert(dict, \"b\", increment)\n"
+    " // -> from_list([#(\"a\", 0), #(\"b\", 0)])\n"
+    " ```\n"
+).
+-spec upsert(dict(QG, QH), QG, fun((gleam@option:option(QH)) -> QH)) -> dict(QG, QH).
+upsert(Dict, Key, Fun) ->
+    case gleam_stdlib:map_get(Dict, Key) of
+        {ok, Value} ->
+            insert(Dict, Key, Fun({some, Value}));
+
+        {error, _} ->
+            insert(Dict, Key, Fun(none))
+    end.
+
+-file("src/gleam/dict.gleam", 478).
+?DOC(
+    " Combines all entries into a single value by calling a given function on each\n"
+    " one.\n"
+    "\n"
+    " Dicts are not ordered so the values are not returned in any specific order. Do\n"
+    " not write code that relies on the order entries are used by this function\n"
+    " as it may change in later versions of Gleam or Erlang.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " let dict = from_list([#(\"a\", 1), #(\"b\", 3), #(\"c\", 9)])\n"
+    " fold(dict, 0, fn(accumulator, key, value) { accumulator + value })\n"
+    " // -> 13\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " import gleam/string\n"
+    "\n"
+    " let dict = from_list([#(\"a\", 1), #(\"b\", 3), #(\"c\", 9)])\n"
+    " fold(dict, \"\", fn(accumulator, key, value) {\n"
+    "   string.append(accumulator, key)\n"
+    " })\n"
+    " // -> \"abc\"\n"
+    " ```\n"
+).
+-spec fold(dict(QN, QO), QR, fun((QR, QN, QO) -> QR)) -> QR.
+fold(Dict, Initial, Fun) ->
+    Fun@1 = fun(Key, Value, Acc) -> Fun(Acc, Key, Value) end,
+    maps:fold(Fun@1, Initial, Dict).
+
+-file("src/gleam/dict.gleam", 98).
+?DOC(
+    " Converts the dict to a list of 2-element tuples `#(key, value)`, one for\n"
+    " each key-value pair in the dict.\n"
+    "\n"
+    " The tuples in the list have no specific order.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " Calling `to_list` on an empty `dict` returns an empty list.\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> to_list\n"
+    " // -> []\n"
+    " ```\n"
+    "\n"
+    " The ordering of elements in the resulting list is an implementation detail\n"
+    " that should not be relied upon.\n"
+    "\n"
+    " ```gleam\n"
+    " new() |> insert(\"b\", 1) |> insert(\"a\", 0) |> insert(\"c\", 2) |> to_list\n"
+    " // -> [#(\"a\", 0), #(\"b\", 1), #(\"c\", 2)]\n"
+    " ```\n"
+).
+-spec to_list(dict(KJ, KK)) -> list({KJ, KK}).
+to_list(Dict) ->
+    maps:to_list(Dict).
+
+-file("src/gleam/dict.gleam", 238).
+?DOC(
+    " Gets a list of all keys in a given dict.\n"
+    "\n"
+    " Dicts are not ordered so the keys are not returned in any specific order. Do\n"
+    " not write code that relies on the order keys are returned by this function\n"
+    " as it may change in later versions of Gleam or Erlang.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)]) |> keys\n"
+    " // -> [\"a\", \"b\"]\n"
+    " ```\n"
+).
+-spec keys(dict(MY, any())) -> list(MY).
+keys(Dict) ->
+    maps:keys(Dict).
+
+-file("src/gleam/dict.gleam", 256).
+?DOC(
+    " Gets a list of all values in a given dict.\n"
+    "\n"
+    " Dicts are not ordered so the values are not returned in any specific order. Do\n"
+    " not write code that relies on the order values are returned by this function\n"
+    " as it may change in later versions of Gleam or Erlang.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)]) |> values\n"
+    " // -> [0, 1]\n"
+    " ```\n"
+).
+-spec values(dict(any(), NE)) -> list(NE).
+values(Dict) ->
+    maps:values(Dict).
+
+-file("src/gleam/dict.gleam", 277).
+?DOC(
+    " Creates a new dict from a given dict, minus any entries that a given function\n"
+    " returns `False` for.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)])\n"
+    " |> filter(fn(key, value) { value != 0 })\n"
+    " // -> from_list([#(\"b\", 1)])\n"
+    " ```\n"
+    "\n"
+    " ```gleam\n"
+    " from_list([#(\"a\", 0), #(\"b\", 1)])\n"
+    " |> filter(fn(key, value) { True })\n"
+    " // -> from_list([#(\"a\", 0), #(\"b\", 1)])\n"
+    " ```\n"
+).
+-spec filter(dict(NI, NJ), fun((NI, NJ) -> boolean())) -> dict(NI, NJ).
+filter(Dict, Predicate) ->
+    maps:filter(Predicate, Dict).
+
+-file("src/gleam/dict.gleam", 512).
+?DOC(
+    " Calls a function for each key and value in a dict, discarding the return\n"
+    " value.\n"
+    "\n"
+    " Useful for producing a side effect for every item of a dict.\n"
+    "\n"
+    " ```gleam\n"
+    " import gleam/io\n"
+    "\n"
+    " let dict = from_list([#(\"a\", \"apple\"), #(\"b\", \"banana\"), #(\"c\", \"cherry\")])\n"
+    "\n"
+    " each(dict, fn(k, v) {\n"
+    "   io.println(key <> \" => \" <> value)\n"
+    " })\n"
+    " // -> Nil\n"
+    " // a => apple\n"
+    " // b => banana\n"
+    " // c => cherry\n"
+    " ```\n"
+    "\n"
+    " The order of elements in the iteration is an implementation detail that\n"
+    " should not be relied upon.\n"
+).
+-spec each(dict(QX, QY), fun((QX, QY) -> any())) -> nil.
+each(Dict, Fun) ->
+    fold(
+        Dict,
+        nil,
+        fun(Nil, K, V) ->
+            Fun(K, V),
+            Nil
+        end
+    ).
+
+-file("src/gleam/dict.gleam", 533).
+?DOC(
+    " Creates a new dict from a pair of given dicts by combining their entries.\n"
+    "\n"
+    " If there are entries with the same keys in both dicts the given function is\n"
+    " used to determine the new value to use in the resulting dict.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " let a = from_list([#(\"a\", 0), #(\"b\", 1)])\n"
+    " let b = from_list([#(\"a\", 2), #(\"c\", 3)])\n"
+    " combine(a, b, fn(one, other) { one + other })\n"
+    " // -> from_list([#(\"a\", 2), #(\"b\", 1), #(\"c\", 3)])\n"
+    " ```\n"
+).
+-spec combine(dict(RC, RD), dict(RC, RD), fun((RD, RD) -> RD)) -> dict(RC, RD).
+combine(Dict, Other, Fun) ->
+    maps:merge_with(fun(_, L, R) -> Fun(L, R) end, Dict, Other).
+
+-file("src/gleam/dict.gleam", 352).
+?DOC(
+    " Creates a new dict from a pair of given dicts by combining their entries.\n"
+    "\n"
+    " If there are entries with the same keys in both dicts the entry from the\n"
+    " second dict takes precedence.\n"
+    "\n"
+    " ## Examples\n"
+    "\n"
+    " ```gleam\n"
+    " let a = from_list([#(\"a\", 0), #(\"b\", 1)])\n"
+    " let b = from_list([#(\"b\", 2), #(\"c\", 3)])\n"
+    " merge(a, b)\n"
+    " // -> from_list([#(\"a\", 0), #(\"b\", 2), #(\"c\", 3)])\n"
+    " ```\n"
+).
+-spec merge(dict(OR, OS), dict(OR, OS)) -> dict(OR, OS).
+merge(Dict, New_entries) ->
+    maps:merge(Dict, New_entries).
+
+-file("src/gleam/dict.gleam", 574).
+-spec group_loop(transient_dict(SE, list(SF)), fun((SF) -> SE), list(SF)) -> dict(SE, list(SF)).
+group_loop(Transient, To_key, List) ->
+    case List of
+        [] ->
+            gleam_stdlib:identity(Transient);
+
+        [Value | Rest] ->
+            Key = To_key(Value),
+            Update = fun(Existing) -> [Value | Existing] end,
+            _pipe = Transient,
+            _pipe@1 = maps:update_with(Key, Update, [Value], _pipe),
+            group_loop(_pipe@1, To_key, Rest)
+    end.
+
+-file("src/gleam/dict.gleam", 570).
+?DOC(false).
+-spec group(fun((RY) -> RZ), list(RY)) -> dict(RZ, list(RY)).
+group(Key, List) ->
+    group_loop(gleam_stdlib:identity(maps:new()), Key, List).

package/build/dev/javascript/gleam_stdlib/gleam@dynamic.erl

@@ -0,0 +1,106 @@
+-module(gleam@dynamic).
+-compile([no_auto_import, nowarn_unused_vars, nowarn_unused_function, nowarn_nomatch, inline]).
+-define(FILEPATH, "src/gleam/dynamic.gleam").
+-export([classify/1, bool/1, string/1, float/1, int/1, bit_array/1, list/1, array/1, properties/1, nil/0]).
+-export_type([dynamic_/0]).
+
+-if(?OTP_RELEASE >= 27).
+-define(MODULEDOC(Str), -moduledoc(Str)).
+-define(DOC(Str), -doc(Str)).
+-else.
+-define(MODULEDOC(Str), -compile([])).
+-define(DOC(Str), -compile([])).
+-endif.
+
+-type dynamic_() :: any().
+
+-file("src/gleam/dynamic.gleam", 30).
+?DOC(
+    " Return a string indicating the type of the dynamic value.\n"
+    "\n"
+    " This function may be useful for constructing error messages or logs. If you\n"
+    " want to turn dynamic data into well typed data then you want the\n"
+    " `gleam/dynamic/decode` module.\n"
+    "\n"
+    " ```gleam\n"
+    " classify(string(\"Hello\"))\n"
+    " // -> \"String\"\n"
+    " ```\n"
+).
+-spec classify(dynamic_()) -> binary().
+classify(Data) ->
+    gleam_stdlib:classify_dynamic(Data).
+
+-file("src/gleam/dynamic.gleam", 36).
+?DOC(" Create a dynamic value from a bool.\n").
+-spec bool(boolean()) -> dynamic_().
+bool(A) ->
+    gleam_stdlib:identity(A).
+
+-file("src/gleam/dynamic.gleam", 44).
+?DOC(
+    " Create a dynamic value from a string.\n"
+    "\n"
+    " On Erlang this will be a binary string rather than a character list.\n"
+).
+-spec string(binary()) -> dynamic_().
+string(A) ->
+    gleam_stdlib:identity(A).
+
+-file("src/gleam/dynamic.gleam", 50).
+?DOC(" Create a dynamic value from a float.\n").
+-spec float(float()) -> dynamic_().
+float(A) ->
+    gleam_stdlib:identity(A).
+
+-file("src/gleam/dynamic.gleam", 56).
+?DOC(" Create a dynamic value from an int.\n").
+-spec int(integer()) -> dynamic_().
+int(A) ->
+    gleam_stdlib:identity(A).
+
+-file("src/gleam/dynamic.gleam", 62).
+?DOC(" Create a dynamic value from a bit array.\n").
+-spec bit_array(bitstring()) -> dynamic_().
+bit_array(A) ->
+    gleam_stdlib:identity(A).
+
+-file("src/gleam/dynamic.gleam", 68).
+?DOC(" Create a dynamic value from a list.\n").
+-spec list(list(dynamic_())) -> dynamic_().
+list(A) ->
+    gleam_stdlib:identity(A).
+
+-file("src/gleam/dynamic.gleam", 77).
+?DOC(
+    " Create a dynamic value from a list, converting it to a sequential runtime\n"
+    " format rather than the regular list format.\n"
+    "\n"
+    " On Erlang this will be a tuple, on JavaScript this will be an array.\n"
+).
+-spec array(list(dynamic_())) -> dynamic_().
+array(A) ->
+    erlang:list_to_tuple(A).
+
+-file("src/gleam/dynamic.gleam", 85).
+?DOC(
+    " Create a dynamic value made of an unordered series of keys and values, where\n"
+    " the keys are unique.\n"
+    "\n"
+    " On Erlang this will be a map, on JavaScript this will be a Gleam dict\n"
+    " object.\n"
+).
+-spec properties(list({dynamic_(), dynamic_()})) -> dynamic_().
+properties(Entries) ->
+    gleam_stdlib:identity(maps:from_list(Entries)).
+
+-file("src/gleam/dynamic.gleam", 94).
+?DOC(
+    " A dynamic value representing nothing.\n"
+    "\n"
+    " On Erlang this will be the atom `nil`, on JavaScript this will be\n"
+    " `undefined`.\n"
+).
+-spec nil() -> dynamic_().
+nil() ->
+    gleam_stdlib:identity(nil).