Component: Standard Library

[StachuDotNet]

Darklang's "standard library" is the suite of things (like many List functions) that the Dark team volunteers to steer and maintain, as opposed to functionality non-core, best designed and implemented by users. Much of these stdlib functionality is supported by Builtins for lower-level operations.

This issue is to organize work related to Darklang's "standard library."

Most of the tasks here are accessible to contributors, especially with a bit of discussion.

Numerics and Math

• division options are confusing (see Lack of integer division is confusing #4627)

Strings

• add String.trimStart and String.trimEnd
  • for RTL, it should work fine, as the RTL is just rendering, and "start" and "end" refer to the same place in both.
  • see discussion in Add String::takeLeft and String::takeRight #3159
• Support "full" case mapping in Strings: toLower/toUpper (see Support "full" case mapping in Strings: toLower/toUpper #3437)

Date and Time

• Date should be clear what granularity is available
  • Are two Dates with the same second the same? Let's make sure they are, or expose enough detail so users can see why (eg, ticks or milliseconds or whatever).
• module should document timezone info / UTC (see Date module should document timezone info / UTC #3574)
• higher-precision DateTimes
• add TimeSpans to Dark
  • along with this, create a new version of Date::subtract which returns a timespan
• more date functions
• Date formatting

Collections

• List.shuffle
• List.remove (some ergonomic way of removing an item)
• List.dropFirst if we don't have it already
• List.indexOf

Bytes

• add Bytes.contains
• add Bytes.toList
• add Bytes.map
• startsWith, endsWith (single)
• get byte at location
• set byte at location
• add Base64.urlEncode
• add Bytes.slice builtin
• add Bytes.drop (using Bytes.slice)
• add Bytes.take (using Bytes.slice)
• add Bytes.append / Bytes.concat
• add Bytes.reverse
• add Bytes.containsSegment
• add Bytes.encode and Bytes.decode, adopting patterns from Elm
  • https://package.elm-lang.org/packages/elm/bytes/1.0.8/Bytes-Decode
  • hex encode
  • move Base64.encode & .decode from builtin to package
• add Bytes.startsWith, Bytes.endsWith (segment)
• add Bytes.find
• add Bytes.indexOf
• add Bytes.lastIndexOf
• add Bytes.trim
• add Bytes.replace (either single byte or a segment of bytes)

URLs

• URL decoding function
• URL builder

Misc

• Add HTML parsing functionality to standard library (see Add HTML parsing functionality to standard library #2811)