@baukit/localization-core 0.4.0 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +40 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/zoned-time-vectors.d.ts +38 -0
- package/dist/zoned-time-vectors.d.ts.map +1 -0
- package/dist/zoned-time-vectors.js +26 -0
- package/dist/zoned-time-vectors.js.map +1 -0
- package/dist/zoned-time.d.ts +25 -0
- package/dist/zoned-time.d.ts.map +1 -0
- package/dist/zoned-time.js +115 -0
- package/dist/zoned-time.js.map +1 -0
- package/package.json +17 -9
package/README.md
CHANGED
|
@@ -58,6 +58,46 @@ addCivilDays('2026-03-07', 1); // '2026-03-08', DST does not shift a calendar da
|
|
|
58
58
|
- `assertTimeZone(zone)` validates an IANA zone. `resolvedTimeZone()` reads the host zone; every
|
|
59
59
|
other function takes the zone explicitly, so nothing silently depends on where the process runs.
|
|
60
60
|
|
|
61
|
+
## Zoned local times
|
|
62
|
+
|
|
63
|
+
`resolveZonedLocalTime` turns a civil date, a local time, and an IANA zone into an instant. A local
|
|
64
|
+
time can fall in a gap (spring forward, so it never happens) or a fold (fall back, so it happens
|
|
65
|
+
twice). The caller picks both policies; neither has a default.
|
|
66
|
+
|
|
67
|
+
```ts
|
|
68
|
+
import { resolveZonedLocalTime } from '@baukit/localization-core';
|
|
69
|
+
|
|
70
|
+
resolveZonedLocalTime({
|
|
71
|
+
civilDate: '2026-03-29',
|
|
72
|
+
civilTime: '02:30',
|
|
73
|
+
timeZone: 'Europe/Berlin',
|
|
74
|
+
gap: 'shiftForward',
|
|
75
|
+
fold: 'earlier',
|
|
76
|
+
});
|
|
77
|
+
// { ok: true, epochMilliseconds: Date.parse('2026-03-29T01:30:00Z'), transition: 'gap' }
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
- `gap: 'reject'` returns `{ ok: false, code: 'nonexistent_local_time' }`. `gap: 'shiftForward'`
|
|
81
|
+
reads the time with the offset from before the gap, so 02:30 becomes 03:30 when an hour is
|
|
82
|
+
skipped. That is how RFC 5545 reads a `TZID` time.
|
|
83
|
+
- `fold: 'earlier'` and `fold: 'later'` pick the first or second of the two instants.
|
|
84
|
+
- `transition` is `'none'`, `'gap'`, or `'fold'` and says what the local time hit.
|
|
85
|
+
- Invalid input returns `invalid_civil_date`, `invalid_civil_time` (anything but `HH:MM` or
|
|
86
|
+
`HH:MM:SS` from `00:00` to `23:59:59`), or `invalid_time_zone`. Offset strings such as `+01:00`
|
|
87
|
+
are not zones and are rejected. An unknown policy value is a programming error and throws
|
|
88
|
+
`RangeError`.
|
|
89
|
+
|
|
90
|
+
The function reads zone rules through `Intl.DateTimeFormat` and nothing else, so the answer depends
|
|
91
|
+
on the time-zone database of the runtime it runs in. The shared vectors in
|
|
92
|
+
`fixtures/zoned-time/vectors-v1.json` cover gaps, folds, half-hour and 45-minute offsets, a skipped
|
|
93
|
+
day, rule changes, and invalid input. Rust code that resolves local times should test against the
|
|
94
|
+
same file.
|
|
95
|
+
|
|
96
|
+
`@baukit/localization-core/vectors` exports `zonedTimeVectorChecks(fixture)`, which turns that file
|
|
97
|
+
into labelled checks with an `expected` value and an `actual()` call. The package's Vitest suite
|
|
98
|
+
runs them on Node, and `examples/expo-notifications-conformance` runs the same checks inside Hermes
|
|
99
|
+
on an Android emulator. A product can run them in its own runtime the same way.
|
|
100
|
+
|
|
61
101
|
## Boundaries
|
|
62
102
|
|
|
63
103
|
The package does not include translations, product catalog IDs, persistence, React providers, Expo
|
package/dist/index.d.ts
CHANGED
|
@@ -4,4 +4,5 @@ export { addCivilDays, assertCivilDate, assertCivilTime, assertTimeZone, civilDa
|
|
|
4
4
|
export { createLocalizedCodeResolver, type CodeResolverOptions, type LocalizedCodeEntry, } from './codes.js';
|
|
5
5
|
export { createDateTimeFormatter, createNumberFormatter } from './formatters.js';
|
|
6
6
|
export { normalizeLocalePreference, resolveLocale, type LocalePreference } from './locale.js';
|
|
7
|
+
export { INVALID_CIVIL_TIME_CODE, INVALID_TIME_ZONE_CODE, NONEXISTENT_LOCAL_TIME_CODE, resolveZonedLocalTime, type FoldPolicy, type GapPolicy, type LocalTimeTransition, type ZonedLocalTime, type ZonedLocalTimeCode, type ZonedLocalTimeResult, } from './zoned-time.js';
|
|
7
8
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -4,4 +4,5 @@ export { addCivilDays, assertCivilDate, assertCivilTime, assertTimeZone, civilDa
|
|
|
4
4
|
export { createLocalizedCodeResolver, } from './codes.js';
|
|
5
5
|
export { createDateTimeFormatter, createNumberFormatter } from './formatters.js';
|
|
6
6
|
export { normalizeLocalePreference, resolveLocale } from './locale.js';
|
|
7
|
+
export { INVALID_CIVIL_TIME_CODE, INVALID_TIME_ZONE_CODE, NONEXISTENT_LOCAL_TIME_CODE, resolveZonedLocalTime, } from './zoned-time.js';
|
|
7
8
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAA0B,MAAM,cAAc,CAAC;AACzF,OAAO,EACL,oBAAoB,GAMrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GAGjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,GAG5B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAA0B,MAAM,cAAc,CAAC;AACzF,OAAO,EACL,oBAAoB,GAMrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,gBAAgB,GAGjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,2BAA2B,GAG5B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAyB,MAAM,aAAa,CAAC;AAC9F,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,GAOtB,MAAM,iBAAiB,CAAC"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { type FoldPolicy, type GapPolicy, type LocalTimeTransition, type ZonedLocalTimeCode, type ZonedLocalTimeResult } from './zoned-time.js';
|
|
2
|
+
export interface ZonedTimeVectorOutcome {
|
|
3
|
+
readonly gap: GapPolicy;
|
|
4
|
+
readonly fold: FoldPolicy;
|
|
5
|
+
readonly instant?: string;
|
|
6
|
+
readonly error?: ZonedLocalTimeCode;
|
|
7
|
+
}
|
|
8
|
+
export interface ZonedTimeVectorCase {
|
|
9
|
+
readonly name: string;
|
|
10
|
+
readonly civilDate: string;
|
|
11
|
+
readonly civilTime: string;
|
|
12
|
+
readonly timeZone: string;
|
|
13
|
+
readonly transition: LocalTimeTransition | null;
|
|
14
|
+
readonly outcomes: readonly ZonedTimeVectorOutcome[];
|
|
15
|
+
}
|
|
16
|
+
export interface ZonedTimeVectorFixture {
|
|
17
|
+
readonly version: number;
|
|
18
|
+
readonly gapPolicies: readonly GapPolicy[];
|
|
19
|
+
readonly foldPolicies: readonly FoldPolicy[];
|
|
20
|
+
readonly cases: readonly ZonedTimeVectorCase[];
|
|
21
|
+
}
|
|
22
|
+
export type ZonedTimeVectorExpectation = {
|
|
23
|
+
readonly ok: false;
|
|
24
|
+
readonly code: ZonedLocalTimeCode;
|
|
25
|
+
} | {
|
|
26
|
+
readonly ok: true;
|
|
27
|
+
readonly epochMilliseconds: number;
|
|
28
|
+
readonly transition: LocalTimeTransition | null;
|
|
29
|
+
};
|
|
30
|
+
/** One vector: `actual()` must deep-equal `expected` (`undefined` fields count as absent). */
|
|
31
|
+
export interface ZonedTimeVectorCheck {
|
|
32
|
+
readonly label: string;
|
|
33
|
+
readonly expected: ZonedTimeVectorExpectation;
|
|
34
|
+
readonly actual: () => ZonedLocalTimeResult;
|
|
35
|
+
}
|
|
36
|
+
/** Expands `fixtures/zoned-time/vectors-v1.json` into one check per case and policy pair. */
|
|
37
|
+
export declare function zonedTimeVectorChecks(fixture: ZonedTimeVectorFixture): ZonedTimeVectorCheck[];
|
|
38
|
+
//# sourceMappingURL=zoned-time-vectors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"zoned-time-vectors.d.ts","sourceRoot":"","sources":["../src/zoned-time-vectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GACzD;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACjD,CAAC;AAEN,8FAA8F;AAC9F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,oBAAoB,CAAC;CAC7C;AAED,6FAA6F;AAC7F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,oBAAoB,EAAE,CAe7F"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { resolveZonedLocalTime, } from './zoned-time.js';
|
|
2
|
+
/** Expands `fixtures/zoned-time/vectors-v1.json` into one check per case and policy pair. */
|
|
3
|
+
export function zonedTimeVectorChecks(fixture) {
|
|
4
|
+
return fixture.cases.flatMap((entry) => entry.outcomes.map((outcome) => ({
|
|
5
|
+
label: `${entry.name} gap=${outcome.gap} fold=${outcome.fold}`,
|
|
6
|
+
expected: expectedResult(entry, outcome),
|
|
7
|
+
actual: () => resolveZonedLocalTime({
|
|
8
|
+
civilDate: entry.civilDate,
|
|
9
|
+
civilTime: entry.civilTime,
|
|
10
|
+
timeZone: entry.timeZone,
|
|
11
|
+
gap: outcome.gap,
|
|
12
|
+
fold: outcome.fold,
|
|
13
|
+
}),
|
|
14
|
+
})));
|
|
15
|
+
}
|
|
16
|
+
function expectedResult(entry, outcome) {
|
|
17
|
+
if (outcome.error !== undefined) {
|
|
18
|
+
return { ok: false, code: outcome.error };
|
|
19
|
+
}
|
|
20
|
+
return {
|
|
21
|
+
ok: true,
|
|
22
|
+
epochMilliseconds: Date.parse(outcome.instant ?? ''),
|
|
23
|
+
transition: entry.transition,
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
//# sourceMappingURL=zoned-time-vectors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"zoned-time-vectors.js","sourceRoot":"","sources":["../src/zoned-time-vectors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAMtB,MAAM,iBAAiB,CAAC;AAwCzB,6FAA6F;AAC7F,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACrC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/B,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,QAAQ,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,IAAI,EAAE;QAC9D,QAAQ,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC;QACxC,MAAM,EAAE,GAAG,EAAE,CACX,qBAAqB,CAAC;YACpB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC;KACL,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,KAA0B,EAC1B,OAA+B;IAE/B,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACpD,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { INVALID_CIVIL_DATE_CODE } from './civil-date.js';
|
|
2
|
+
export type GapPolicy = 'reject' | 'shiftForward';
|
|
3
|
+
export type FoldPolicy = 'earlier' | 'later';
|
|
4
|
+
export type LocalTimeTransition = 'none' | 'gap' | 'fold';
|
|
5
|
+
export declare const INVALID_CIVIL_TIME_CODE = "invalid_civil_time";
|
|
6
|
+
export declare const INVALID_TIME_ZONE_CODE = "invalid_time_zone";
|
|
7
|
+
export declare const NONEXISTENT_LOCAL_TIME_CODE = "nonexistent_local_time";
|
|
8
|
+
export type ZonedLocalTimeCode = typeof INVALID_CIVIL_DATE_CODE | typeof INVALID_CIVIL_TIME_CODE | typeof INVALID_TIME_ZONE_CODE | typeof NONEXISTENT_LOCAL_TIME_CODE;
|
|
9
|
+
export interface ZonedLocalTime {
|
|
10
|
+
readonly civilDate: string;
|
|
11
|
+
readonly civilTime: string;
|
|
12
|
+
readonly timeZone: string;
|
|
13
|
+
readonly gap: GapPolicy;
|
|
14
|
+
readonly fold: FoldPolicy;
|
|
15
|
+
}
|
|
16
|
+
export type ZonedLocalTimeResult = {
|
|
17
|
+
readonly ok: true;
|
|
18
|
+
readonly epochMilliseconds: number;
|
|
19
|
+
readonly transition: LocalTimeTransition;
|
|
20
|
+
} | {
|
|
21
|
+
readonly ok: false;
|
|
22
|
+
readonly code: ZonedLocalTimeCode;
|
|
23
|
+
};
|
|
24
|
+
export declare function resolveZonedLocalTime(input: ZonedLocalTime): ZonedLocalTimeResult;
|
|
25
|
+
//# sourceMappingURL=zoned-time.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"zoned-time.d.ts","sourceRoot":"","sources":["../src/zoned-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAkB,MAAM,iBAAiB,CAAC;AAE1E,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAC;AAClD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAC7C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1D,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAC5D,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAC1B,OAAO,uBAAuB,GAC9B,OAAO,uBAAuB,GAC9B,OAAO,sBAAsB,GAC7B,OAAO,2BAA2B,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAmB9D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,oBAAoB,CAyBjF"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { INVALID_CIVIL_DATE_CODE, parseCivilDate } from './civil-date.js';
|
|
2
|
+
export const INVALID_CIVIL_TIME_CODE = 'invalid_civil_time';
|
|
3
|
+
export const INVALID_TIME_ZONE_CODE = 'invalid_time_zone';
|
|
4
|
+
export const NONEXISTENT_LOCAL_TIME_CODE = 'nonexistent_local_time';
|
|
5
|
+
const CIVIL_TIME_PATTERN = /^([01]\d|2[0-3]):([0-5]\d)(?::([0-5]\d))?$/;
|
|
6
|
+
const OFFSET_TIME_ZONE_PATTERN = /^[+-]/;
|
|
7
|
+
const GAP_POLICIES = ['reject', 'shiftForward'];
|
|
8
|
+
const FOLD_POLICIES = ['earlier', 'later'];
|
|
9
|
+
const HOURS_PER_DAY = 24;
|
|
10
|
+
const MILLISECONDS_PER_DAY = 86_400_000;
|
|
11
|
+
const OFFSET_SAMPLE_DISTANCES = [-MILLISECONDS_PER_DAY, 0, MILLISECONDS_PER_DAY];
|
|
12
|
+
export function resolveZonedLocalTime(input) {
|
|
13
|
+
assertPolicies(input.gap, input.fold);
|
|
14
|
+
const date = parseCivilDate(input.civilDate);
|
|
15
|
+
if (!date.ok) {
|
|
16
|
+
return { ok: false, code: INVALID_CIVIL_DATE_CODE };
|
|
17
|
+
}
|
|
18
|
+
const time = CIVIL_TIME_PATTERN.exec(input.civilTime);
|
|
19
|
+
if (time === null) {
|
|
20
|
+
return { ok: false, code: INVALID_CIVIL_TIME_CODE };
|
|
21
|
+
}
|
|
22
|
+
const formatter = zoneFormatter(input.timeZone);
|
|
23
|
+
if (formatter === null) {
|
|
24
|
+
return { ok: false, code: INVALID_TIME_ZONE_CODE };
|
|
25
|
+
}
|
|
26
|
+
const [year, month, day] = input.civilDate.split('-').map(Number);
|
|
27
|
+
const wall = utcMilliseconds({
|
|
28
|
+
year,
|
|
29
|
+
month,
|
|
30
|
+
day,
|
|
31
|
+
hour: Number(time[1]),
|
|
32
|
+
minute: Number(time[2]),
|
|
33
|
+
second: Number(time[3] ?? 0),
|
|
34
|
+
});
|
|
35
|
+
return resolveWall(formatter, wall, input);
|
|
36
|
+
}
|
|
37
|
+
function assertPolicies(gap, fold) {
|
|
38
|
+
if (typeof gap !== 'string' || !GAP_POLICIES.includes(gap)) {
|
|
39
|
+
throw new RangeError(`Unknown gap policy: ${String(gap)}`);
|
|
40
|
+
}
|
|
41
|
+
if (typeof fold !== 'string' || !FOLD_POLICIES.includes(fold)) {
|
|
42
|
+
throw new RangeError(`Unknown fold policy: ${String(fold)}`);
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
function resolveWall(formatter, wall, policy) {
|
|
46
|
+
const candidates = candidateInstants(formatter, wall);
|
|
47
|
+
const earliest = candidates[0];
|
|
48
|
+
const latest = candidates[candidates.length - 1];
|
|
49
|
+
if (earliest === undefined || latest === undefined) {
|
|
50
|
+
return resolveGap(formatter, wall, policy.gap);
|
|
51
|
+
}
|
|
52
|
+
if (earliest === latest) {
|
|
53
|
+
return { ok: true, epochMilliseconds: earliest, transition: 'none' };
|
|
54
|
+
}
|
|
55
|
+
const epochMilliseconds = policy.fold === 'earlier' ? earliest : latest;
|
|
56
|
+
return { ok: true, epochMilliseconds, transition: 'fold' };
|
|
57
|
+
}
|
|
58
|
+
function resolveGap(formatter, wall, gap) {
|
|
59
|
+
if (gap === 'reject') {
|
|
60
|
+
return { ok: false, code: NONEXISTENT_LOCAL_TIME_CODE };
|
|
61
|
+
}
|
|
62
|
+
const offsetBeforeGap = offsetAt(formatter, wall - MILLISECONDS_PER_DAY);
|
|
63
|
+
return { ok: true, epochMilliseconds: wall - offsetBeforeGap, transition: 'gap' };
|
|
64
|
+
}
|
|
65
|
+
function candidateInstants(formatter, wall) {
|
|
66
|
+
const offsets = new Set(OFFSET_SAMPLE_DISTANCES.map((distance) => offsetAt(formatter, wall + distance)));
|
|
67
|
+
return [...offsets]
|
|
68
|
+
.map((offset) => wall - offset)
|
|
69
|
+
.filter((instant) => localWallAt(formatter, instant) === wall)
|
|
70
|
+
.sort((left, right) => left - right);
|
|
71
|
+
}
|
|
72
|
+
function offsetAt(formatter, instant) {
|
|
73
|
+
return localWallAt(formatter, instant) - instant;
|
|
74
|
+
}
|
|
75
|
+
function localWallAt(formatter, instant) {
|
|
76
|
+
const parts = formatter.formatToParts(new Date(instant));
|
|
77
|
+
const part = (type) => Number(parts.find((candidate) => candidate.type === type)?.value);
|
|
78
|
+
return utcMilliseconds({
|
|
79
|
+
year: part('year'),
|
|
80
|
+
month: part('month'),
|
|
81
|
+
day: part('day'),
|
|
82
|
+
hour: part('hour') % HOURS_PER_DAY,
|
|
83
|
+
minute: part('minute'),
|
|
84
|
+
second: part('second'),
|
|
85
|
+
});
|
|
86
|
+
}
|
|
87
|
+
function utcMilliseconds(wall) {
|
|
88
|
+
const date = new Date(0);
|
|
89
|
+
date.setUTCFullYear(wall.year, wall.month - 1, wall.day);
|
|
90
|
+
date.setUTCHours(wall.hour, wall.minute, wall.second, 0);
|
|
91
|
+
return date.getTime();
|
|
92
|
+
}
|
|
93
|
+
function zoneFormatter(timeZone) {
|
|
94
|
+
if (OFFSET_TIME_ZONE_PATTERN.test(timeZone)) {
|
|
95
|
+
return null;
|
|
96
|
+
}
|
|
97
|
+
try {
|
|
98
|
+
return new Intl.DateTimeFormat('en-US', {
|
|
99
|
+
timeZone,
|
|
100
|
+
calendar: 'gregory',
|
|
101
|
+
numberingSystem: 'latn',
|
|
102
|
+
hourCycle: 'h23',
|
|
103
|
+
year: 'numeric',
|
|
104
|
+
month: '2-digit',
|
|
105
|
+
day: '2-digit',
|
|
106
|
+
hour: '2-digit',
|
|
107
|
+
minute: '2-digit',
|
|
108
|
+
second: '2-digit',
|
|
109
|
+
});
|
|
110
|
+
}
|
|
111
|
+
catch {
|
|
112
|
+
return null;
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=zoned-time.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"zoned-time.js","sourceRoot":"","sources":["../src/zoned-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAM1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAiCpE,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AACxE,MAAM,wBAAwB,GAAG,OAAO,CAAC;AACzC,MAAM,YAAY,GAAsB,CAAC,QAAQ,EAAE,cAAc,CAAuB,CAAC;AACzF,MAAM,aAAa,GAAsB,CAAC,SAAS,EAAE,OAAO,CAAwB,CAAC;AACrF,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,oBAAoB,GAAG,UAAU,CAAC;AACxC,MAAM,uBAAuB,GAAG,CAAC,CAAC,oBAAoB,EAAE,CAAC,EAAE,oBAAoB,CAAC,CAAC;AAEjF,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACzD,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;IACtD,CAAC;IACD,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAA6B,CAAC;IAC9F,MAAM,IAAI,GAAG,eAAe,CAAC;QAC3B,IAAI;QACJ,KAAK;QACL,GAAG;QACH,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;KAC7B,CAAC,CAAC;IACH,OAAO,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,cAAc,CAAC,GAAY,EAAE,IAAa;IACjD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,UAAU,CAAC,uBAAuB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,UAAU,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAClB,SAA8B,EAC9B,IAAY,EACZ,MAA4C;IAE5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACnD,OAAO,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IACvE,CAAC;IACD,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IACxE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,UAAU,CACjB,SAA8B,EAC9B,IAAY,EACZ,GAAc;IAEd,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,eAAe,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,oBAAoB,CAAC,CAAC;IACzE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,GAAG,eAAe,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACpF,CAAC;AAED,SAAS,iBAAiB,CAAC,SAA8B,EAAE,IAAY;IACrE,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,uBAAuB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC,CAChF,CAAC;IACF,OAAO,CAAC,GAAG,OAAO,CAAC;SAChB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,MAAM,CAAC;SAC9B,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;SAC7D,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,SAA8B,EAAE,OAAe;IAC/D,OAAO,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;AACnD,CAAC;AAED,SAAS,WAAW,CAAC,SAA8B,EAAE,OAAe;IAClE,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,CAAC,IAAkC,EAAU,EAAE,CAC1D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IACpE,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC;QAChB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,aAAa;QAClC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;QACtB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;KACvB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,IAAe;IACtC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YACtC,QAAQ;YACR,QAAQ,EAAE,SAAS;YACnB,eAAe,EAAE,MAAM;YACvB,SAAS,EAAE,KAAK;YAChB,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@baukit/localization-core",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.1",
|
|
4
4
|
"description": "Dependency-free locale resolution, catalog key comparison, stable-code localization, and explicit-locale Intl formatter factories.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Patrick Koss",
|
|
@@ -24,7 +24,13 @@
|
|
|
24
24
|
"exports": {
|
|
25
25
|
".": {
|
|
26
26
|
"types": "./dist/index.d.ts",
|
|
27
|
-
"import": "./dist/index.js"
|
|
27
|
+
"import": "./dist/index.js",
|
|
28
|
+
"default": "./dist/index.js"
|
|
29
|
+
},
|
|
30
|
+
"./vectors": {
|
|
31
|
+
"types": "./dist/zoned-time-vectors.d.ts",
|
|
32
|
+
"import": "./dist/zoned-time-vectors.js",
|
|
33
|
+
"default": "./dist/zoned-time-vectors.js"
|
|
28
34
|
}
|
|
29
35
|
},
|
|
30
36
|
"files": [
|
|
@@ -32,14 +38,16 @@
|
|
|
32
38
|
"README.md",
|
|
33
39
|
"LICENSE"
|
|
34
40
|
],
|
|
35
|
-
"devDependencies": {
|
|
36
|
-
"typescript": "6.0.3",
|
|
37
|
-
"vitest": "4.1.10"
|
|
38
|
-
},
|
|
39
41
|
"scripts": {
|
|
40
42
|
"build": "tsc -p tsconfig.json",
|
|
41
|
-
"
|
|
43
|
+
"prepare": "pnpm run build",
|
|
44
|
+
"test": "tsc -p tsconfig.test.json && vitest run --config ../../vitest.config.ts && node ../../scripts/test-packed-exports.mjs",
|
|
42
45
|
"lint": "eslint src --max-warnings=0",
|
|
43
|
-
"format:check": "prettier --check src package.json tsconfig.json"
|
|
46
|
+
"format:check": "prettier --check src package.json tsconfig.json tsconfig.test.json"
|
|
47
|
+
},
|
|
48
|
+
"devDependencies": {
|
|
49
|
+
"@types/node": "24.10.1",
|
|
50
|
+
"typescript": "6.0.3",
|
|
51
|
+
"vitest": "4.1.10"
|
|
44
52
|
}
|
|
45
|
-
}
|
|
53
|
+
}
|