feat: translation

[tomasciccola]

should close #165

[tomasciccola]

wondering how to validate languageCode. I know js has Intl.Locale but it seems you can pass some arbitrary stuff and it won't throw. I found this this library last updated 9 years ago that doesn't seem to do what it claims (return null on a valid bcp47 string)

[tomasciccola]

another nice to have would be to validate recordType (check if the schema exists) and fieldRef, by traversing the array and checking if the provided field exists for that recordType.
validating recordId I don't think its easy since it may point to a record we don't know it exists yet?

[tomasciccola]

Another thing to address is how to solve a field ref for a field that is in an Array. i.e.
The options field in the Field record type is an array of {label:string, value: tagValue}
A fieldRef pointing to that would be smth like ['options','0', 'label'] ? meaning, 'this points to the 'label' field in the first option of a field?? This of course wouldn't work because fieldRef is string[]

[tomasciccola]

wondering how to validate languageCode. I know js has Intl.Locale but it seems you can pass some arbitrary stuff and it won't throw. I found this this library last updated 9 years ago that doesn't seem to do what it claims (return null on a valid bcp47 string)

I went ahead and installed is-language-code which seems supported and up to date, but it uses smth called iana for language codes, which I don't know if we want to...

[gmaclennan]

I don't think we should validate when encoding / decoding. I think we should do that when writing. Invalid data will just be ignored, because lookups will just not work. If possible, we can add a type to recordType (Exclude<MapeoDoc['schemaName'], 'translation'>).

I wrote up thoughts on language codes in the issue.

For the fieldRef, I think we should just use a string, using dot-prop notation. This solves the question about field options (the example would be options[0].label). I don't think the encoding or decoding here should do anything with that prop though.

[gmaclennan]

Just missing the region code, plus some suggested copy edits. Otherwise good to merge I think.