@invinite-org/chartlang-core 1.0.1

package/dist/time/sessionBoundaries.js

@@ -0,0 +1,102 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Ported from invinite/src/components/trading-chart/indicators/lib/session-boundaries.ts
+//   (commit fb882a97e018ea0cc9a451fb7d839dc8d894c08b, © Invinite).
+// Re-licensed MIT for chartlang. See PLAN.md §3.1 for the
+// provenance contract; the math is the reference, the code style is not.
+import { getFormatter } from "./_lib/dateTimeFormatCache.js";
+import { localDateParts } from "./nyDayKey.js";
+import { weekday } from "./weekday.js";
+const MINUTE_MS = 60_000;
+const OFFSET_FIELDS = Object.freeze({
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hourCycle: "h23",
+});
+function offsetMs(tz, instantMs) {
+    const parts = getFormatter(tz, OFFSET_FIELDS).formatToParts(instantMs);
+    const fields = {};
+    for (const part of parts) {
+        fields[part.type] = part.value;
+    }
+    const asUtc = Date.UTC(Number(fields.year), Number(fields.month) - 1, Number(fields.day), Number(fields.hour), Number(fields.minute), Number(fields.second));
+    return asUtc - instantMs;
+}
+function zonedTimeToUtcMs(tz, year, month, day, hour, minute) {
+    const guess = Date.UTC(year, month - 1, day, hour, minute);
+    const first = guess - offsetMs(tz, guess);
+    const second = guess - offsetMs(tz, first);
+    return second;
+}
+function sessionFor(tz, t, startMinutes, endMinutes) {
+    const dow = weekday(tz, t);
+    if (dow === 0 || dow === 6)
+        return null;
+    const parts = localDateParts(tz, t);
+    const year = Number(parts.year);
+    const month = Number(parts.month);
+    const day = Number(parts.day);
+    const startMs = zonedTimeToUtcMs(tz, year, month, day, 0, startMinutes);
+    const endMs = zonedTimeToUtcMs(tz, year, month, day, 0, endMinutes);
+    return Object.freeze({ startMs, endMs });
+}
+/**
+ * Return the regular 09:30-16:00 session bounds for the New York day
+ * containing `t`.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     nySessionBounds(1_709_251_200_000);
+ */
+export function nySessionBounds(t) {
+    const bounds = sessionFor("America/New_York", t, 9 * 60 + 30, 16 * 60);
+    if (bounds !== null)
+        return bounds;
+    const parts = localDateParts("America/New_York", t);
+    const noon = zonedTimeToUtcMs("America/New_York", Number(parts.year), Number(parts.month), Number(parts.day), 12, 0);
+    return {
+        startMs: noon - 150 * MINUTE_MS,
+        endMs: noon + 240 * MINUTE_MS,
+    };
+}
+/**
+ * Return regular 09:30-16:00 session bounds in `tz`, or `null` on weekends.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     regularSession("America/New_York", 1_709_251_200_000);
+ */
+export function regularSession(tz, t) {
+    return sessionFor(tz, t, 9 * 60 + 30, 16 * 60);
+}
+/**
+ * Return extended 04:00-20:00 session bounds in `tz`, or `null` on weekends.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     extendedSession("America/New_York", 1_709_251_200_000);
+ */
+export function extendedSession(tz, t) {
+    return sessionFor(tz, t, 4 * 60, 20 * 60);
+}
+/**
+ * Test whether `t` falls inside the selected half-open session in `tz`.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     isOpen("America/New_York", 1_709_251_200_000, "regular");
+ */
+export function isOpen(tz, t, type) {
+    const bounds = type === "regular" ? regularSession(tz, t) : extendedSession(tz, t);
+    return bounds !== null && bounds.startMs <= t && t < bounds.endMs;
+}
+//# sourceMappingURL=sessionBoundaries.js.map

package/dist/time/sessionBoundaries.js.map

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

package/dist/time/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Supported market-session boundary families.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     const type: SessionType = "regular";
+ *     void type;
+ */
+export type SessionType = "regular" | "extended";
+/**
+ * Day-of-week index where Sunday is 0 and Saturday is 6.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     const day: Weekday = 1;
+ *     void day;
+ */
+export type Weekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * Half-open UTC millisecond session bounds.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     const bounds: SessionBounds = { startMs: 0, endMs: 1 };
+ *     void bounds;
+ */
+export type SessionBounds = {
+    readonly startMs: number;
+    readonly endMs: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/time/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/time/types.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B,CAAC"}

package/dist/time/types.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/time/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/time/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D"}

package/dist/time/weekKey.d.ts

@@ -0,0 +1,11 @@
+import type { Time } from "../types.js";
+/**
+ * Return the ISO week key (`GGGG-Www`) for `t` in `tz`.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     weekKey("UTC", 1_704_067_200_000);
+ */
+export declare function weekKey(tz: string, t: Time): string;
+//# sourceMappingURL=weekKey.d.ts.map

package/dist/time/weekKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekKey.d.ts","sourceRoot":"","sources":["../../src/time/weekKey.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAYxC;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAInD"}

package/dist/time/weekKey.js

@@ -0,0 +1,25 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { localDateParts } from "./nyDayKey.js";
+function isoWeek(year, month, day) {
+    const date = new Date(Date.UTC(year, month - 1, day));
+    date.setUTCDate(date.getUTCDate() + 4 - (date.getUTCDay() || 7));
+    const weekYear = date.getUTCFullYear();
+    const yearStart = new Date(Date.UTC(weekYear, 0, 1));
+    const week = Math.ceil(((date.getTime() - yearStart.getTime()) / 86_400_000 + 1) / 7);
+    return { year: weekYear, week };
+}
+/**
+ * Return the ISO week key (`GGGG-Www`) for `t` in `tz`.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     weekKey("UTC", 1_704_067_200_000);
+ */
+export function weekKey(tz, t) {
+    const parts = localDateParts(tz, t);
+    const { year, week } = isoWeek(Number(parts.year), Number(parts.month), Number(parts.day));
+    return `${year}-W${String(week).padStart(2, "0")}`;
+}
+//# sourceMappingURL=weekKey.js.map

package/dist/time/weekKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekKey.js","sourceRoot":"","sources":["../../src/time/weekKey.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,SAAS,OAAO,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW;IACrD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,EAAU,EAAE,CAAO;IACvC,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACpC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3F,OAAO,GAAG,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/time/weekday.d.ts

@@ -0,0 +1,12 @@
+import type { Time } from "../types.js";
+import type { Weekday } from "./types.js";
+/**
+ * Return the local weekday in `tz`, where Sunday is 0.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     weekday("UTC", 1_704_067_200_000);
+ */
+export declare function weekday(tz: string, t: Time): Weekday;
+//# sourceMappingURL=weekday.d.ts.map

package/dist/time/weekday.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekday.d.ts","sourceRoot":"","sources":["../../src/time/weekday.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,GAAG,OAAO,CAOpD"}

package/dist/time/weekday.js

@@ -0,0 +1,22 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { getFormatter } from "./_lib/dateTimeFormatCache.js";
+const WEEKDAYS = Object.freeze(["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"]);
+/**
+ * Return the local weekday in `tz`, where Sunday is 0.
+ *
+ * @since 0.6
+ * @stable
+ * @example
+ *     weekday("UTC", 1_704_067_200_000);
+ */
+export function weekday(tz, t) {
+    const part = getFormatter(tz, { weekday: "short" })
+        .formatToParts(t)
+        .find((p) => p.type === "weekday");
+    const index = WEEKDAYS.indexOf(part?.value ?? "");
+    if (index < 0)
+        throw new Error(`weekday: unsupported Intl weekday ${part?.value ?? "<none>"}`);
+    return index;
+}
+//# sourceMappingURL=weekday.js.map

package/dist/time/weekday.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekday.js","sourceRoot":"","sources":["../../src/time/weekday.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAG/D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAElF;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CAAC,EAAU,EAAE,CAAO;IACvC,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;SAC9C,aAAa,CAAC,CAAC,CAAC;SAChB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,EAAE,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC/F,OAAO,KAAgB,CAAC;AAC5B,CAAC"}