You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Replace momentjs with date-fns but maintain backwards compatibility.
Load the time zone list using Intl.DateTimeFormat instead of the large dependency.
Land the UI of displayTimeZone option on datetime.
Add timeZoneScope as a concept to the codebase so that many different time zone scopes can be held.
Add allowTimeZoneSwitch to let devs decide whether the timezone is fixed or user decided.
Move useTimeZone out of the scheduledPublishing folder.
Fix Calendar.tsx to ensure month and year are respecting the time zone.
Fix the dropdown list of timezones to be more user friendly.
Description
Adding the ability to add a `displayTimezone` option to the `datetime` input. This allows you to specify the timezone in which the stored UTC string from content lake will be displayed. When enabled, a tooltip is shown at the bottom left of the input field which indicates the timezone the field is representing. When you start editing this disappears.
A common use case here could be anything local that you would be working on in another timezone, for example concert times, apartment viewing times etc. etc. which are hard to work with today as the studio (just like the Date API) respects only the browsers relative display of the UTC string.
We have lots of signal on this one in this thread, as well as directly from users.
In addition to this, I decided to give it a go of removing moment from the @sanity/util package as a testbed how we should go about removing it across the entire codebase.
I am using the new date-fns/tz and date-fns/utc packages from date-fns. The reason for these is that they are very lightweight, TZDateMini which I am using here is only 916 B, which is a whopper difference from the locale bloat from moment-timezone dep we would need to make this work with moment.
As we have the ability to add custom date formats via the options on the datetime input and this is documented as support moment.js formats, I decided to write a formatter that would use the Intl.DateTimeFormat.format functionality instead by mapping the moment formatting to that format object.
What to review
* The naming of `displayTimezone` is worth a discussion.
* The UI that I have chosen, with the text below should also be taken into consideration as to whether that is the best approach.
* Browser support, not baking locales and timezones into the package and instead relying on the `Intl.DateTimeFormat` browser API means that browser versions [outside the widely supported](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat#browser_compatibility) will not work.
efps — editor "frames per second". The number of updates assumed to be possible within a second.
Derived from input latency. efps = 1000 / input_latency
Detailed information
🏠 Reference result
The performance result of sanity@latest
Benchmark
latency
p75
p90
p99
blocking time
test duration
synthetic (title)
54ms
57ms
59ms
267ms
1033ms
12.9s
synthetic (string inside object)
54ms
56ms
67ms
528ms
1313ms
8.6s
🧪 Experiment result
The performance result of this branch
Benchmark
latency
p75
p90
p99
blocking time
test duration
synthetic (title)
52ms
55ms
65ms
289ms
902ms
13.3s
synthetic (string inside object)
53ms
55ms
64ms
476ms
1229ms
8.5s
📚 Glossary
column definitions
benchmark — the name of the test, e.g. "article", followed by the label of the field being measured, e.g. "(title)".
latency — the time between when a key was pressed and when it was rendered. derived from a set of samples. the median (p50) is shown to show the most common latency.
p75 — the 75th percentile of the input latency in the test run. 75% of the sampled inputs in this benchmark were processed faster than this value. this provides insight into the upper range of typical performance.
p90 — the 90th percentile of the input latency in the test run. 90% of the sampled inputs were faster than this. this metric helps identify slower interactions that occurred less frequently during the benchmark.
p99 — the 99th percentile of the input latency in the test run. only 1% of sampled inputs were slower than this. this represents the worst-case scenarios encountered during the benchmark, useful for identifying potential performance outliers.
blocking time — the total time during which the main thread was blocked, preventing user input and UI updates. this metric helps identify performance bottlenecks that may cause the interface to feel unresponsive.
test duration — how long the test run took to complete.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Remaining work
date-fns
but maintain backwards compatibility.Intl.DateTimeFormat
instead of the large dependency.displayTimeZone
option ondatetime
.timeZoneScope
as a concept to the codebase so that many different time zone scopes can be held.allowTimeZoneSwitch
to let devs decide whether the timezone is fixed or user decided.useTimeZone
out of thescheduledPublishing
folder.Calendar.tsx
to ensure month and year are respecting the time zone.Description
Adding the ability to add a `displayTimezone` option to the `datetime` input. This allows you to specify the timezone in which the stored UTC string from content lake will be displayed. When enabled, a tooltip is shown at the bottom left of the input field which indicates the timezone the field is representing. When you start editing this disappears.
A common use case here could be anything local that you would be working on in another timezone, for example concert times, apartment viewing times etc. etc. which are hard to work with today as the studio (just like the Date API) respects only the browsers relative display of the UTC string.
We have lots of signal on this one in this thread, as well as directly from users.
In addition to this, I decided to give it a go of removing moment from the
@sanity/util
package as a testbed how we should go about removing it across the entire codebase.I am using the new date-fns/tz and date-fns/utc packages from date-fns. The reason for these is that they are very lightweight,
TZDateMini
which I am using here is only 916 B, which is a whopper difference from the locale bloat frommoment-timezone
dep we would need to make this work withmoment
.As we have the ability to add custom date formats via the options on the
datetime
input and this is documented as support moment.js formats, I decided to write a formatter that would use the Intl.DateTimeFormat.format functionality instead by mapping the moment formatting to that format object.What to review
* The naming of `displayTimezone` is worth a discussion. * The UI that I have chosen, with the text below should also be taken into consideration as to whether that is the best approach. * Browser support, not baking locales and timezones into the package and instead relying on the `Intl.DateTimeFormat` browser API means that browser versions [outside the widely supported](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat#browser_compatibility) will not work.Testing
Notes for release