openalgo-script 0.1.0-alpha.1 → 0.2.0

package/dist/core/stdlib/calendar/civil.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Calendar arithmetic on civil dates: no zone, no instant, no clock.
+ *
+ * A civil date is a year, a month and a day as a person writes them. Turning
+ * one into an instant needs a zone and lives in `zone.ts`; everything here is
+ * counting days, and it is separated for that reason: the day number of the
+ * fifteenth of March is the same fact in every zone on earth, and mixing the
+ * two questions is how a calendar ends up right in one half of the year.
+ *
+ * The day number is days since 1970-01-01, positive after it and negative
+ * before. The conversion both ways is the standard proleptic Gregorian one,
+ * shifted so the leap day falls at the end of an internal year that starts in
+ * March: that is what removes the special case for February and makes the
+ * inverse exact rather than iterative.
+ */
+/** A date and a time of day as a person writes them, with no zone attached. */
+export interface Civil {
+    readonly year: number;
+    /** 1 to 12. */
+    readonly month: number;
+    /** 1 to 31. */
+    readonly day: number;
+    readonly hour: number;
+    readonly minute: number;
+    readonly second: number;
+}
+/** Days from 1970-01-01 to this civil date. */
+export declare function dayNumber(year: number, month: number, day: number): number;
+/** The civil date a day number names, the exact inverse of `dayNumber`. */
+export declare function dateOfDay(days: number): {
+    year: number;
+    month: number;
+    day: number;
+};
+/**
+ * The day of the week, 1 for Monday through 7 for Sunday.
+ *
+ * Monday is 1 so that a weekday test reads `date.dayOfWeek(time) <= 5` and a
+ * trading week is a contiguous range, which `stdlib.md` section 12.2 states and
+ * gives the reason for.
+ */
+export declare function weekdayOfDay(days: number): number;
+/** The day of the year, 1 to 366. */
+export declare function dayOfYearOf(year: number, month: number, day: number): number;
+/**
+ * The week number, weeks starting Monday.
+ *
+ * Read as the ISO 8601 week: week 1 is the week holding the year's first
+ * Thursday, so a week that straddles the new year belongs to the year holding
+ * most of it and no year ever has a week 0. `stdlib.md` section 12.2 fixes the
+ * Monday start and this settles the rest of it, because the alternatives differ
+ * by a whole week at the turn of every year and a reader has no way to tell
+ * which one a chart drew.
+ */
+export declare function weekOfYearOf(year: number, month: number, day: number): number;
+//# sourceMappingURL=civil.d.ts.map

package/dist/core/stdlib/calendar/civil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"civil.d.ts","sourceRoot":"","sources":["../../../../src/core/stdlib/calendar/civil.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,eAAe;IACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO1E;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAcpF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7E"}

package/dist/core/stdlib/calendar/civil.js

@@ -0,0 +1,70 @@
+/**
+ * Calendar arithmetic on civil dates: no zone, no instant, no clock.
+ *
+ * A civil date is a year, a month and a day as a person writes them. Turning
+ * one into an instant needs a zone and lives in `zone.ts`; everything here is
+ * counting days, and it is separated for that reason: the day number of the
+ * fifteenth of March is the same fact in every zone on earth, and mixing the
+ * two questions is how a calendar ends up right in one half of the year.
+ *
+ * The day number is days since 1970-01-01, positive after it and negative
+ * before. The conversion both ways is the standard proleptic Gregorian one,
+ * shifted so the leap day falls at the end of an internal year that starts in
+ * March: that is what removes the special case for February and makes the
+ * inverse exact rather than iterative.
+ */
+/** Days from 1970-01-01 to this civil date. */
+export function dayNumber(year, month, day) {
+    const shifted = month <= 2 ? year - 1 : year;
+    const era = Math.floor((shifted >= 0 ? shifted : shifted - 399) / 400);
+    const yearOfEra = shifted - era * 400;
+    const dayOfYear = Math.floor((153 * (month + (month > 2 ? -3 : 9)) + 2) / 5) + day - 1;
+    const dayOfEra = yearOfEra * 365 + Math.floor(yearOfEra / 4) - Math.floor(yearOfEra / 100) + dayOfYear;
+    return era * 146097 + dayOfEra - 719468;
+}
+/** The civil date a day number names, the exact inverse of `dayNumber`. */
+export function dateOfDay(days) {
+    const shifted = days + 719468;
+    const era = Math.floor((shifted >= 0 ? shifted : shifted - 146096) / 146097);
+    const dayOfEra = shifted - era * 146097;
+    const yearOfEra = Math.floor((dayOfEra - Math.floor(dayOfEra / 1460) + Math.floor(dayOfEra / 36524) - Math.floor(dayOfEra / 146096)) / 365);
+    const year = yearOfEra + era * 400;
+    const dayOfYear = dayOfEra - (365 * yearOfEra + Math.floor(yearOfEra / 4) - Math.floor(yearOfEra / 100));
+    const monthPart = Math.floor((5 * dayOfYear + 2) / 153);
+    const day = dayOfYear - Math.floor((153 * monthPart + 2) / 5) + 1;
+    const month = monthPart + (monthPart < 10 ? 3 : -9);
+    return { year: month <= 2 ? year + 1 : year, month, day };
+}
+/**
+ * The day of the week, 1 for Monday through 7 for Sunday.
+ *
+ * Monday is 1 so that a weekday test reads `date.dayOfWeek(time) <= 5` and a
+ * trading week is a contiguous range, which `stdlib.md` section 12.2 states and
+ * gives the reason for.
+ */
+export function weekdayOfDay(days) {
+    // 1970-01-01 was a Thursday, which is 4 on this numbering.
+    const shifted = (days + 3) % 7;
+    return (shifted < 0 ? shifted + 7 : shifted) + 1;
+}
+/** The day of the year, 1 to 366. */
+export function dayOfYearOf(year, month, day) {
+    return dayNumber(year, month, day) - dayNumber(year, 1, 1) + 1;
+}
+/**
+ * The week number, weeks starting Monday.
+ *
+ * Read as the ISO 8601 week: week 1 is the week holding the year's first
+ * Thursday, so a week that straddles the new year belongs to the year holding
+ * most of it and no year ever has a week 0. `stdlib.md` section 12.2 fixes the
+ * Monday start and this settles the rest of it, because the alternatives differ
+ * by a whole week at the turn of every year and a reader has no way to tell
+ * which one a chart drew.
+ */
+export function weekOfYearOf(year, month, day) {
+    const days = dayNumber(year, month, day);
+    const thursday = days + (4 - weekdayOfDay(days));
+    const owner = dateOfDay(thursday).year;
+    return Math.floor((thursday - dayNumber(owner, 1, 1)) / 7) + 1;
+}
+//# sourceMappingURL=civil.js.map

package/dist/core/stdlib/calendar/civil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"civil.js","sourceRoot":"","sources":["../../../../src/core/stdlib/calendar/civil.ts"],"names":[],"mappings":"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"}

package/dist/core/stdlib/calendar/fields.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The calendar reads of `stdlib.md` section 12.2, each one an instant and a
+ * zone in and a number out.
+ *
+ * Every one of them is absent rather than a guess when the zone is not one the
+ * runtime holds or the instant is not a number. An unknown zone is OS6005, and
+ * raising it is the engine's to do at the call site, where there is a span to
+ * point at; this tier raises nothing, for the reason the library's own index
+ * gives.
+ */
+import type { Value } from '../values/index.js';
+import type { Civil } from './civil.js';
+/** Which field of a civil date a read wants. */
+export type DateField = 'year' | 'month' | 'day' | 'dayOfWeek' | 'dayOfYear' | 'hour' | 'minute' | 'second' | 'weekOfYear';
+/** One calendar field of an instant, read in a zone. */
+export declare function dateField(instant: Value, zone: string | null, field: DateField): Value;
+/** Which boundary `startOfDay`, `startOfWeek` and `startOfMonth` round back to. */
+export type Boundary = 'day' | 'week' | 'month';
+/**
+ * Midnight at the start of the day, the Monday or the first of the month that
+ * holds an instant, in a zone.
+ *
+ * The answer is built as a wall clock reading and then turned back into an
+ * instant, rather than by subtracting a count of milliseconds. Subtracting is
+ * wrong across a clock change, where a local day is twenty three or twenty five
+ * hours long, and it is wrong in a way that shows up twice a year on one chart
+ * and never on another.
+ */
+export declare function startOf(instant: Value, zone: string | null, boundary: Boundary): Value;
+/** Whether two instants fall on one calendar day in a zone. */
+export declare function sameDay(a: Value, b: Value, zone: string | null): boolean | null;
+/** An instant built from calendar fields in a zone, `date.from`. */
+export declare function instantFrom(year: Value, month: Value, day: Value, hour: Value, minute: Value, second: Value, zone: string | null): Value;
+/** The civil fields of an instant, or nothing when either side is unusable. */
+export declare function civilAt(instant: Value, zone: string | null): Civil | null;
+//# sourceMappingURL=fields.d.ts.map

package/dist/core/stdlib/calendar/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../../src/core/stdlib/calendar/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC,gDAAgD;AAChD,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,OAAO,GACP,KAAK,GACL,WAAW,GACX,WAAW,GACX,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,YAAY,CAAC;AAEjB,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,KAAK,CAuBtF;AAED,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAgBtF;AAED,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,CAK/E;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CACzB,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,KAAK,EACV,IAAI,EAAE,KAAK,EACX,MAAM,EAAE,KAAK,EACb,MAAM,EAAE,KAAK,EACb,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,KAAK,CAcP;AAED,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAGzE"}

package/dist/core/stdlib/calendar/fields.js

@@ -0,0 +1,93 @@
+import { NONE, result } from '../values/index.js';
+import { dateOfDay, dayNumber, dayOfYearOf, weekOfYearOf, weekdayOfDay } from './civil.js';
+import { fieldsIn, instantOf } from './zone.js';
+/** One calendar field of an instant, read in a zone. */
+export function dateField(instant, zone, field) {
+    const fields = civilAt(instant, zone);
+    if (fields === null)
+        return NONE;
+    switch (field) {
+        case 'year':
+            return result(fields.year);
+        case 'month':
+            return result(fields.month);
+        case 'day':
+            return result(fields.day);
+        case 'hour':
+            return result(fields.hour);
+        case 'minute':
+            return result(fields.minute);
+        case 'second':
+            return result(fields.second);
+        case 'dayOfWeek':
+            return result(weekdayOfDay(dayNumber(fields.year, fields.month, fields.day)));
+        case 'dayOfYear':
+            return result(dayOfYearOf(fields.year, fields.month, fields.day));
+        default:
+            return result(weekOfYearOf(fields.year, fields.month, fields.day));
+    }
+}
+/**
+ * Midnight at the start of the day, the Monday or the first of the month that
+ * holds an instant, in a zone.
+ *
+ * The answer is built as a wall clock reading and then turned back into an
+ * instant, rather than by subtracting a count of milliseconds. Subtracting is
+ * wrong across a clock change, where a local day is twenty three or twenty five
+ * hours long, and it is wrong in a way that shows up twice a year on one chart
+ * and never on another.
+ */
+export function startOf(instant, zone, boundary) {
+    const fields = civilAt(instant, zone);
+    if (fields === null || zone === null)
+        return NONE;
+    const midnight = { hour: 0, minute: 0, second: 0 };
+    let civil;
+    if (boundary === 'month') {
+        civil = { year: fields.year, month: fields.month, day: 1, ...midnight };
+    }
+    else if (boundary === 'day') {
+        civil = { year: fields.year, month: fields.month, day: fields.day, ...midnight };
+    }
+    else {
+        const days = dayNumber(fields.year, fields.month, fields.day);
+        const monday = days - (weekdayOfDay(days) - 1);
+        civil = { ...dateOfDay(monday), ...midnight };
+    }
+    const at = instantOf(civil, zone);
+    return at === null ? NONE : result(at);
+}
+/** Whether two instants fall on one calendar day in a zone. */
+export function sameDay(a, b, zone) {
+    const left = civilAt(a, zone);
+    const right = civilAt(b, zone);
+    if (left === null || right === null)
+        return null;
+    return left.year === right.year && left.month === right.month && left.day === right.day;
+}
+/** An instant built from calendar fields in a zone, `date.from`. */
+export function instantFrom(year, month, day, hour, minute, second, zone) {
+    if (zone === null)
+        return NONE;
+    if (year === null || month === null || day === null)
+        return NONE;
+    const fields = {
+        year,
+        month,
+        day,
+        hour: hour ?? 0,
+        minute: minute ?? 0,
+        second: second ?? 0,
+    };
+    if (!Object.values(fields).every((one) => Number.isInteger(one)))
+        return NONE;
+    const at = instantOf(fields, zone);
+    return at === null ? NONE : result(at);
+}
+/** The civil fields of an instant, or nothing when either side is unusable. */
+export function civilAt(instant, zone) {
+    if (instant === null || zone === null)
+        return null;
+    return fieldsIn(instant, zone);
+}
+//# sourceMappingURL=fields.js.map

package/dist/core/stdlib/calendar/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../../src/core/stdlib/calendar/fields.ts"],"names":[],"mappings":"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"}

package/dist/core/stdlib/calendar/format.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `date.format(t, pattern, zone)`: the closed placeholder set of `stdlib.md`
+ * section 12.3 and nothing else.
+ *
+ * The set is small and closed on purpose, so that two engines cannot differ
+ * about what a pattern means. Every character that is not one of the eight
+ * placeholders is copied through exactly as written, including a letter that
+ * looks like part of one: the scan below takes the longest placeholder that
+ * starts at each position and moves past it, so `MMM` is the month name and the
+ * `MM` inside it is never read a second time.
+ *
+ * Month and weekday abbreviations are English and invariant, for the same
+ * determinism reason `str.upper` is: a name that followed the reader's locale
+ * would make one chart's label depend on who opened it.
+ */
+import type { Civil } from './civil.js';
+/** A pattern rendered against one civil reading, or nothing when there is none. */
+export declare function renderPattern(pattern: string | null, fields: Civil | null): string | null;
+//# sourceMappingURL=format.d.ts.map

package/dist/core/stdlib/calendar/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/core/stdlib/calendar/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAuCxC,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAezF"}

package/dist/core/stdlib/calendar/format.js

@@ -0,0 +1,51 @@
+import { dayNumber, weekdayOfDay } from './civil.js';
+const MONTHS = [
+    'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec',
+];
+const WEEKDAYS = ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'];
+/** The placeholders, longest first, which is the order the scan tries them in. */
+const PLACEHOLDERS = ['yyyy', 'MMM', 'EEE', 'MM', 'dd', 'HH', 'mm', 'ss'];
+function pad(value, width) {
+    const digits = Math.abs(Math.trunc(value)).toString();
+    const padded = digits.length >= width ? digits : '0'.repeat(width - digits.length) + digits;
+    return value < 0 ? `-${padded}` : padded;
+}
+function substitution(token, fields) {
+    switch (token) {
+        case 'yyyy':
+            return pad(fields.year, 4);
+        case 'MMM':
+            return MONTHS[fields.month - 1] ?? '';
+        case 'EEE':
+            return WEEKDAYS[weekdayOfDay(dayNumber(fields.year, fields.month, fields.day)) - 1] ?? '';
+        case 'MM':
+            return pad(fields.month, 2);
+        case 'dd':
+            return pad(fields.day, 2);
+        case 'HH':
+            return pad(fields.hour, 2);
+        case 'mm':
+            return pad(fields.minute, 2);
+        default:
+            return pad(fields.second, 2);
+    }
+}
+/** A pattern rendered against one civil reading, or nothing when there is none. */
+export function renderPattern(pattern, fields) {
+    if (pattern === null || fields === null)
+        return null;
+    let out = '';
+    let at = 0;
+    while (at < pattern.length) {
+        const token = PLACEHOLDERS.find((one) => pattern.startsWith(one, at));
+        if (token === undefined) {
+            out += pattern[at];
+            at += 1;
+            continue;
+        }
+        out += substitution(token, fields);
+        at += token.length;
+    }
+    return out;
+}
+//# sourceMappingURL=format.js.map

package/dist/core/stdlib/calendar/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../../src/core/stdlib/calendar/format.ts"],"names":[],"mappings":"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"}

package/dist/core/stdlib/calendar/index.d.ts

@@ -0,0 +1,7 @@
+export type { Civil } from './civil.js';
+export { dateOfDay, dayNumber, dayOfYearOf, weekOfYearOf, weekdayOfDay, } from './civil.js';
+export { fieldsIn, instantOf, isKnownZone, offsetAt, utcInstantOf } from './zone.js';
+export type { Boundary, DateField } from './fields.js';
+export { civilAt, dateField, instantFrom, sameDay, startOf } from './fields.js';
+export { renderPattern } from './format.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/stdlib/calendar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/stdlib/calendar/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAErF,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/stdlib/calendar/index.js

@@ -0,0 +1,5 @@
+export { dateOfDay, dayNumber, dayOfYearOf, weekOfYearOf, weekdayOfDay, } from './civil.js';
+export { fieldsIn, instantOf, isKnownZone, offsetAt, utcInstantOf } from './zone.js';
+export { civilAt, dateField, instantFrom, sameDay, startOf } from './fields.js';
+export { renderPattern } from './format.js';
+//# sourceMappingURL=index.js.map

package/dist/core/stdlib/calendar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/stdlib/calendar/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGrF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/stdlib/calendar/zone.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Reading an instant in a named zone, and building an instant from one.
+ *
+ * **A zone is an area and location name and never a fixed offset**, which
+ * `stdlib.md` section 12.1 requires and gives the reason for: an offset held
+ * constant is silently wrong for half the year anywhere that observes a
+ * seasonal clock change, and nothing about the wrong half looks wrong.
+ *
+ * **The zone table is the runtime's own and is not carried here.** A table
+ * copied into this repository would be a second copy of a fact that changes
+ * several times a year by government decision, and a stale copy is wrong in the
+ * same invisible way a fixed offset is. The language's own standard date
+ * facilities carry that table, so they are what is asked. Nothing below reads a
+ * clock: the only instants that enter are the ones a script passed in, which is
+ * what `compiled-program.md` section 8.4 requires of everything except
+ * `chart.now()`.
+ *
+ * **Two engines agree only as far as their zone tables do**, and that is stated
+ * rather than hidden. Two engines holding the same table compute the same
+ * instants; two holding tables from different years can differ across a rule
+ * change a government made between them. That is true of every zone-aware
+ * calendar in existence, and the alternative, a table frozen in this package,
+ * is worse: it would be wrong for everyone rather than only across a change.
+ */
+import type { Civil } from './civil.js';
+/** Whether the runtime's zone table holds this name. */
+export declare function isKnownZone(zone: string): boolean;
+/** The civil fields an instant has in a zone, or nothing for an unknown zone. */
+export declare function fieldsIn(instant: number, zone: string): Civil | null;
+/** The instant a civil date and time names in UTC, with no zone applied. */
+export declare function utcInstantOf(fields: Civil): number;
+/** How far ahead of UTC a zone was at an instant, in milliseconds. */
+export declare function offsetAt(instant: number, zone: string): number | null;
+/**
+ * The instant a wall clock reading names in a zone.
+ *
+ * A reading is not an instant until a zone is applied, and the offset to apply
+ * is the offset at the answer rather than at the reading, so this works the
+ * other way round: it takes the two offsets the zone had a day either side,
+ * builds the instant each one implies, and keeps the ones that read back as the
+ * reading it was given.
+ *
+ * Two readings have no single answer and both are settled here rather than left
+ * to an engine. **A reading the clock repeated**, the hour an autumn change
+ * gives back, has two instants that read back correctly, and the answer is the
+ * earlier of them: that is when a session opening at that clock time opens.
+ * **A reading the clock skipped**, the hour a spring change removes, has none,
+ * and the answer is the reading moved forward by the size of the gap, which is
+ * where that hour would have been; absence there would put a hole in a study
+ * one morning a year.
+ */
+export declare function instantOf(fields: Civil, zone: string): number | null;
+//# sourceMappingURL=zone.d.ts.map

package/dist/core/stdlib/calendar/zone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../../../../src/core/stdlib/calendar/zone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAyDxC,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAmBpE;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAOlD;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIrE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBpE"}

package/dist/core/stdlib/calendar/zone.js

@@ -0,0 +1,138 @@
+/**
+ * The formatters, kept because building one is expensive and a study asks for
+ * the same zone on every bar.
+ *
+ * This is memoisation and not state: the answer for a zone is the same answer
+ * every time, nothing here is ever read back by a script, and clearing the map
+ * between two bars would change how long a chart took and nothing else. No
+ * state region holds any of it, so `compiled-program.md` section 2.11 has
+ * nothing to copy.
+ */
+const FORMATTERS = new Map();
+/**
+ * An area and a location, or the one name that is neither.
+ *
+ * `stdlib.md` section 12.1 requires an area and location name and OS6005 says
+ * in as many words that an abbreviation is not one, because several
+ * abbreviations mean two different offsets in different parts of the world.
+ * Runtimes disagree about which abbreviations they will quietly accept, so the
+ * rule is applied here rather than left to whichever database is installed: a
+ * script refused on one engine has to be refused on every engine. `UTC` is the
+ * one name with no area, and it names one offset everywhere.
+ */
+const AREA_AND_LOCATION = /^[A-Za-z][A-Za-z0-9+_-]*\/[A-Za-z][A-Za-z0-9+_/-]*$/;
+function formatterFor(zone) {
+    const held = FORMATTERS.get(zone);
+    if (held !== undefined)
+        return held;
+    if (zone !== 'UTC' && !AREA_AND_LOCATION.test(zone)) {
+        FORMATTERS.set(zone, null);
+        return null;
+    }
+    let made;
+    try {
+        made = new Intl.DateTimeFormat('en-US', {
+            timeZone: zone,
+            hourCycle: 'h23',
+            era: 'short',
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+        });
+    }
+    catch {
+        // An unknown zone name, which is OS6005 at the call rather than a guess
+        // here. A name this runtime does not hold is not a name this engine can
+        // invent an offset for.
+        made = null;
+    }
+    FORMATTERS.set(zone, made);
+    return made;
+}
+/** Whether the runtime's zone table holds this name. */
+export function isKnownZone(zone) {
+    return formatterFor(zone) !== null;
+}
+/** The civil fields an instant has in a zone, or nothing for an unknown zone. */
+export function fieldsIn(instant, zone) {
+    const formatter = formatterFor(zone);
+    if (formatter === null || !Number.isFinite(instant))
+        return null;
+    const parts = formatter.formatToParts(new Date(instant));
+    const found = {};
+    for (const part of parts)
+        found[part.type] = part.value;
+    const year = Number(found['year']);
+    const month = Number(found['month']);
+    const day = Number(found['day']);
+    const hour = Number(found['hour']);
+    const minute = Number(found['minute']);
+    const second = Number(found['second']);
+    if (!Number.isFinite(year) || !Number.isFinite(month) || !Number.isFinite(day))
+        return null;
+    if (!Number.isFinite(hour) || !Number.isFinite(minute) || !Number.isFinite(second))
+        return null;
+    // Before the common era the year is counted backwards and 1 BC is year 0 on
+    // the proleptic numbering the rest of this module uses.
+    const era = found['era'];
+    const signed = era === 'BC' || era === 'B' || era === 'BCE' ? 1 - year : year;
+    return { year: signed, month, day, hour, minute, second };
+}
+/** The instant a civil date and time names in UTC, with no zone applied. */
+export function utcInstantOf(fields) {
+    const at = new Date(0);
+    // `setUTCFullYear` rather than `Date.UTC`, which reads a two digit year as
+    // nineteen hundred and something.
+    at.setUTCFullYear(fields.year, fields.month - 1, fields.day);
+    at.setUTCHours(fields.hour, fields.minute, fields.second, 0);
+    return at.getTime();
+}
+/** How far ahead of UTC a zone was at an instant, in milliseconds. */
+export function offsetAt(instant, zone) {
+    const fields = fieldsIn(instant, zone);
+    if (fields === null)
+        return null;
+    return utcInstantOf(fields) - instant;
+}
+/**
+ * The instant a wall clock reading names in a zone.
+ *
+ * A reading is not an instant until a zone is applied, and the offset to apply
+ * is the offset at the answer rather than at the reading, so this works the
+ * other way round: it takes the two offsets the zone had a day either side,
+ * builds the instant each one implies, and keeps the ones that read back as the
+ * reading it was given.
+ *
+ * Two readings have no single answer and both are settled here rather than left
+ * to an engine. **A reading the clock repeated**, the hour an autumn change
+ * gives back, has two instants that read back correctly, and the answer is the
+ * earlier of them: that is when a session opening at that clock time opens.
+ * **A reading the clock skipped**, the hour a spring change removes, has none,
+ * and the answer is the reading moved forward by the size of the gap, which is
+ * where that hour would have been; absence there would put a hole in a study
+ * one morning a year.
+ */
+export function instantOf(fields, zone) {
+    const naive = utcInstantOf(fields);
+    const day = 86_400_000;
+    const before = offsetAt(naive - day, zone);
+    const after = offsetAt(naive + day, zone);
+    if (before === null || after === null)
+        return null;
+    let answer = null;
+    for (const offset of before === after ? [before] : [before, after]) {
+        const candidate = naive - offset;
+        const actual = offsetAt(candidate, zone);
+        if (actual === null || naive - actual !== candidate)
+            continue;
+        if (answer === null || candidate < answer)
+            answer = candidate;
+    }
+    // No candidate reads back: the reading is inside a gap the clock skipped, and
+    // the offset in force before it is the one that moves it past the gap.
+    return answer ?? naive - before;
+}
+//# sourceMappingURL=zone.js.map

package/dist/core/stdlib/calendar/zone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone.js","sourceRoot":"","sources":["../../../../src/core/stdlib/calendar/zone.ts"],"names":[],"mappings":"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"}