@lacspace/market-clock 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lacspace
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,148 @@
+'use strict';
+
+// src/index.ts
+function toMinutes(hhmm) {
+  const [h, m] = hhmm.split(":").map(Number);
+  return (h || 0) * 60 + (m || 0);
+}
+function pad(n) {
+  return n < 10 ? "0" + n : String(n);
+}
+var MarketClock = class {
+  constructor(spec) {
+    this.spec = spec;
+    this.regOpen = toMinutes(spec.regular.open);
+    this.regClose = toMinutes(spec.regular.close);
+    this.preOpen = spec.preOpen ? toMinutes(spec.preOpen.open) : null;
+    this.preClose = spec.preOpen ? toMinutes(spec.preOpen.close) : null;
+  }
+  /** Exchange-local calendar parts for an instant. */
+  parts(date) {
+    const local = new Date(date.getTime() + this.spec.offsetMinutes * 6e4);
+    return {
+      y: local.getUTCFullYear(),
+      m: local.getUTCMonth() + 1,
+      d: local.getUTCDate(),
+      day: local.getUTCDay(),
+      minute: local.getUTCHours() * 60 + local.getUTCMinutes()
+    };
+  }
+  /** UTC epoch millis for an exchange-local calendar day + minute-of-day. */
+  utcFor(y, m, d, minute) {
+    return Date.UTC(y, m - 1, d) + minute * 6e4 - this.spec.offsetMinutes * 6e4;
+  }
+  isoDate(p) {
+    return `${p.y}-${pad(p.m)}-${pad(p.d)}`;
+  }
+  isWeekend(at = /* @__PURE__ */ new Date()) {
+    return this.spec.weekend.includes(this.parts(at).day);
+  }
+  isHoliday(at = /* @__PURE__ */ new Date()) {
+    return this.spec.holidays.includes(this.isoDate(this.parts(at)));
+  }
+  /** A day the exchange trades (not weekend, not a holiday). */
+  isTradingDay(at = /* @__PURE__ */ new Date()) {
+    return !this.isWeekend(at) && !this.isHoliday(at);
+  }
+  isOpen(at = /* @__PURE__ */ new Date()) {
+    if (!this.isTradingDay(at)) return false;
+    const { minute } = this.parts(at);
+    return minute >= this.regOpen && minute < this.regClose;
+  }
+  isPreOpen(at = /* @__PURE__ */ new Date()) {
+    if (this.preOpen === null || this.preClose === null) return false;
+    if (!this.isTradingDay(at)) return false;
+    const { minute } = this.parts(at);
+    return minute >= this.preOpen && minute < this.preClose;
+  }
+  status(at = /* @__PURE__ */ new Date()) {
+    if (this.isOpen(at)) return "open";
+    if (this.isPreOpen(at)) return "pre-open";
+    return "closed";
+  }
+  /** The next moment the regular session opens, at or after `from`. */
+  nextOpen(from = /* @__PURE__ */ new Date()) {
+    const start = this.parts(from);
+    for (let i = 0; i < 500; i++) {
+      const dayMs = Date.UTC(start.y, start.m - 1, start.d) + i * 864e5;
+      const dp = new Date(dayMs);
+      const p = { y: dp.getUTCFullYear(), m: dp.getUTCMonth() + 1, d: dp.getUTCDate() };
+      if (this.spec.weekend.includes(dp.getUTCDay())) continue;
+      if (this.spec.holidays.includes(this.isoDate(p))) continue;
+      const openUtc = this.utcFor(p.y, p.m, p.d, this.regOpen);
+      if (openUtc > from.getTime()) return new Date(openUtc);
+    }
+    throw new Error("no trading day found within 500 days");
+  }
+  /** The next moment the regular session closes, at or after `from`. */
+  nextClose(from = /* @__PURE__ */ new Date()) {
+    const start = this.parts(from);
+    for (let i = 0; i < 500; i++) {
+      const dayMs = Date.UTC(start.y, start.m - 1, start.d) + i * 864e5;
+      const dp = new Date(dayMs);
+      const p = { y: dp.getUTCFullYear(), m: dp.getUTCMonth() + 1, d: dp.getUTCDate() };
+      if (this.spec.weekend.includes(dp.getUTCDay())) continue;
+      if (this.spec.holidays.includes(this.isoDate(p))) continue;
+      const closeUtc = this.utcFor(p.y, p.m, p.d, this.regClose);
+      if (closeUtc > from.getTime()) return new Date(closeUtc);
+    }
+    throw new Error("no trading day found within 500 days");
+  }
+  /** Milliseconds until the session closes, or 0 if not currently open. */
+  msToClose(at = /* @__PURE__ */ new Date()) {
+    if (!this.isOpen(at)) return 0;
+    return this.nextClose(at).getTime() - at.getTime();
+  }
+  /** Milliseconds until the next open, or 0 if already open. */
+  msToOpen(at = /* @__PURE__ */ new Date()) {
+    if (this.isOpen(at)) return 0;
+    return this.nextOpen(at).getTime() - at.getTime();
+  }
+};
+function createClock(spec) {
+  return new MarketClock(spec);
+}
+var NSE_HOLIDAYS = [
+  // 2025
+  "2025-02-26",
+  "2025-03-14",
+  "2025-03-31",
+  "2025-04-10",
+  "2025-04-14",
+  "2025-04-18",
+  "2025-05-01",
+  "2025-08-15",
+  "2025-08-27",
+  "2025-10-02",
+  "2025-10-21",
+  "2025-10-22",
+  "2025-11-05",
+  "2025-12-25",
+  // 2026 (nationally-fixed observances; confirm exchange circular for the rest)
+  "2026-01-26",
+  "2026-03-04",
+  "2026-04-01",
+  "2026-05-01",
+  "2026-10-02",
+  "2026-11-09",
+  "2026-12-25"
+];
+var NSE = {
+  name: "NSE",
+  offsetMinutes: 330,
+  preOpen: { open: "09:00", close: "09:15" },
+  regular: { open: "09:15", close: "15:30" },
+  weekend: [0, 6],
+  holidays: NSE_HOLIDAYS
+};
+var BSE = {
+  ...NSE,
+  name: "BSE"
+};
+
+exports.BSE = BSE;
+exports.MarketClock = MarketClock;
+exports.NSE = NSE;
+exports.createClock = createClock;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @lacspace/market-clock\n * Is the market open right now? When does it next open / close?\n *\n * A holiday-aware, timezone-correct trading clock for stock exchanges. Ships\n * with NSE / BSE (India) presets — India has no DST, so a fixed IST offset is\n * exact. Bring your own exchange spec or override the holiday list any time.\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\nexport interface Session {\n  /** \"HH:MM\" 24-hour, in exchange-local time. */\n  open: string;\n  close: string;\n}\n\nexport interface ExchangeSpec {\n  name: string;\n  /** Minutes ahead of UTC (IST = +330). Exchanges without DST only. */\n  offsetMinutes: number;\n  regular: Session;\n  preOpen?: Session;\n  /** Weekday numbers that are always closed (0 = Sunday … 6 = Saturday). */\n  weekend: number[];\n  /** Full-day holidays as \"YYYY-MM-DD\" in exchange-local dates. */\n  holidays: string[];\n}\n\nexport type MarketStatus = \"pre-open\" | \"open\" | \"closed\";\n\nfunction toMinutes(hhmm: string): number {\n  const [h, m] = hhmm.split(\":\").map(Number);\n  return (h || 0) * 60 + (m || 0);\n}\n\nfunction pad(n: number): string {\n  return n < 10 ? \"0\" + n : String(n);\n}\n\ninterface LocalParts {\n  y: number;\n  m: number;\n  d: number;\n  day: number;\n  minute: number;\n}\n\nexport class MarketClock {\n  private readonly regOpen: number;\n  private readonly regClose: number;\n  private readonly preOpen: number | null;\n  private readonly preClose: number | null;\n\n  constructor(public readonly spec: ExchangeSpec) {\n    this.regOpen = toMinutes(spec.regular.open);\n    this.regClose = toMinutes(spec.regular.close);\n    this.preOpen = spec.preOpen ? toMinutes(spec.preOpen.open) : null;\n    this.preClose = spec.preOpen ? toMinutes(spec.preOpen.close) : null;\n  }\n\n  /** Exchange-local calendar parts for an instant. */\n  private parts(date: Date): LocalParts {\n    const local = new Date(date.getTime() + this.spec.offsetMinutes * 60000);\n    return {\n      y: local.getUTCFullYear(),\n      m: local.getUTCMonth() + 1,\n      d: local.getUTCDate(),\n      day: local.getUTCDay(),\n      minute: local.getUTCHours() * 60 + local.getUTCMinutes(),\n    };\n  }\n\n  /** UTC epoch millis for an exchange-local calendar day + minute-of-day. */\n  private utcFor(y: number, m: number, d: number, minute: number): number {\n    return Date.UTC(y, m - 1, d) + minute * 60000 - this.spec.offsetMinutes * 60000;\n  }\n\n  private isoDate(p: { y: number; m: number; d: number }): string {\n    return `${p.y}-${pad(p.m)}-${pad(p.d)}`;\n  }\n\n  isWeekend(at: Date = new Date()): boolean {\n    return this.spec.weekend.includes(this.parts(at).day);\n  }\n\n  isHoliday(at: Date = new Date()): boolean {\n    return this.spec.holidays.includes(this.isoDate(this.parts(at)));\n  }\n\n  /** A day the exchange trades (not weekend, not a holiday). */\n  isTradingDay(at: Date = new Date()): boolean {\n    return !this.isWeekend(at) && !this.isHoliday(at);\n  }\n\n  isOpen(at: Date = new Date()): boolean {\n    if (!this.isTradingDay(at)) return false;\n    const { minute } = this.parts(at);\n    return minute >= this.regOpen && minute < this.regClose;\n  }\n\n  isPreOpen(at: Date = new Date()): boolean {\n    if (this.preOpen === null || this.preClose === null) return false;\n    if (!this.isTradingDay(at)) return false;\n    const { minute } = this.parts(at);\n    return minute >= this.preOpen && minute < this.preClose;\n  }\n\n  status(at: Date = new Date()): MarketStatus {\n    if (this.isOpen(at)) return \"open\";\n    if (this.isPreOpen(at)) return \"pre-open\";\n    return \"closed\";\n  }\n\n  /** The next moment the regular session opens, at or after `from`. */\n  nextOpen(from: Date = new Date()): Date {\n    const start = this.parts(from);\n    for (let i = 0; i < 500; i++) {\n      const dayMs = Date.UTC(start.y, start.m - 1, start.d) + i * 86400000;\n      const dp = new Date(dayMs);\n      const p = { y: dp.getUTCFullYear(), m: dp.getUTCMonth() + 1, d: dp.getUTCDate() };\n      if (this.spec.weekend.includes(dp.getUTCDay())) continue;\n      if (this.spec.holidays.includes(this.isoDate(p))) continue;\n      const openUtc = this.utcFor(p.y, p.m, p.d, this.regOpen);\n      if (openUtc > from.getTime()) return new Date(openUtc);\n    }\n    throw new Error(\"no trading day found within 500 days\");\n  }\n\n  /** The next moment the regular session closes, at or after `from`. */\n  nextClose(from: Date = new Date()): Date {\n    const start = this.parts(from);\n    for (let i = 0; i < 500; i++) {\n      const dayMs = Date.UTC(start.y, start.m - 1, start.d) + i * 86400000;\n      const dp = new Date(dayMs);\n      const p = { y: dp.getUTCFullYear(), m: dp.getUTCMonth() + 1, d: dp.getUTCDate() };\n      if (this.spec.weekend.includes(dp.getUTCDay())) continue;\n      if (this.spec.holidays.includes(this.isoDate(p))) continue;\n      const closeUtc = this.utcFor(p.y, p.m, p.d, this.regClose);\n      if (closeUtc > from.getTime()) return new Date(closeUtc);\n    }\n    throw new Error(\"no trading day found within 500 days\");\n  }\n\n  /** Milliseconds until the session closes, or 0 if not currently open. */\n  msToClose(at: Date = new Date()): number {\n    if (!this.isOpen(at)) return 0;\n    return this.nextClose(at).getTime() - at.getTime();\n  }\n\n  /** Milliseconds until the next open, or 0 if already open. */\n  msToOpen(at: Date = new Date()): number {\n    if (this.isOpen(at)) return 0;\n    return this.nextOpen(at).getTime() - at.getTime();\n  }\n}\n\nexport function createClock(spec: ExchangeSpec): MarketClock {\n  return new MarketClock(spec);\n}\n\n/**\n * NSE trading holidays. Nationally-fixed days are reliable; the rest follow the\n * annual NSE circular and may shift year to year — verify and extend as needed\n * (spread via `new MarketClock({ ...NSE, holidays: [...NSE.holidays, ...] })`).\n */\nconst NSE_HOLIDAYS: string[] = [\n  // 2025\n  \"2025-02-26\", \"2025-03-14\", \"2025-03-31\", \"2025-04-10\", \"2025-04-14\",\n  \"2025-04-18\", \"2025-05-01\", \"2025-08-15\", \"2025-08-27\", \"2025-10-02\",\n  \"2025-10-21\", \"2025-10-22\", \"2025-11-05\", \"2025-12-25\",\n  // 2026 (nationally-fixed observances; confirm exchange circular for the rest)\n  \"2026-01-26\", \"2026-03-04\", \"2026-04-01\", \"2026-05-01\", \"2026-10-02\",\n  \"2026-11-09\", \"2026-12-25\",\n];\n\n/** National Stock Exchange of India. Pre-open 09:00–09:15, regular 09:15–15:30 IST. */\nexport const NSE: ExchangeSpec = {\n  name: \"NSE\",\n  offsetMinutes: 330,\n  preOpen: { open: \"09:00\", close: \"09:15\" },\n  regular: { open: \"09:15\", close: \"15:30\" },\n  weekend: [0, 6],\n  holidays: NSE_HOLIDAYS,\n};\n\n/** Bombay Stock Exchange — same session timings and holiday calendar as NSE. */\nexport const BSE: ExchangeSpec = {\n  ...NSE,\n  name: \"BSE\",\n};\n"]}

package/dist/index.d.cts

@@ -0,0 +1,62 @@
+/**
+ * @lacspace/market-clock
+ * Is the market open right now? When does it next open / close?
+ *
+ * A holiday-aware, timezone-correct trading clock for stock exchanges. Ships
+ * with NSE / BSE (India) presets — India has no DST, so a fixed IST offset is
+ * exact. Bring your own exchange spec or override the holiday list any time.
+ *
+ * Zero dependencies · isomorphic · fully typed.
+ */
+interface Session {
+    /** "HH:MM" 24-hour, in exchange-local time. */
+    open: string;
+    close: string;
+}
+interface ExchangeSpec {
+    name: string;
+    /** Minutes ahead of UTC (IST = +330). Exchanges without DST only. */
+    offsetMinutes: number;
+    regular: Session;
+    preOpen?: Session;
+    /** Weekday numbers that are always closed (0 = Sunday … 6 = Saturday). */
+    weekend: number[];
+    /** Full-day holidays as "YYYY-MM-DD" in exchange-local dates. */
+    holidays: string[];
+}
+type MarketStatus = "pre-open" | "open" | "closed";
+declare class MarketClock {
+    readonly spec: ExchangeSpec;
+    private readonly regOpen;
+    private readonly regClose;
+    private readonly preOpen;
+    private readonly preClose;
+    constructor(spec: ExchangeSpec);
+    /** Exchange-local calendar parts for an instant. */
+    private parts;
+    /** UTC epoch millis for an exchange-local calendar day + minute-of-day. */
+    private utcFor;
+    private isoDate;
+    isWeekend(at?: Date): boolean;
+    isHoliday(at?: Date): boolean;
+    /** A day the exchange trades (not weekend, not a holiday). */
+    isTradingDay(at?: Date): boolean;
+    isOpen(at?: Date): boolean;
+    isPreOpen(at?: Date): boolean;
+    status(at?: Date): MarketStatus;
+    /** The next moment the regular session opens, at or after `from`. */
+    nextOpen(from?: Date): Date;
+    /** The next moment the regular session closes, at or after `from`. */
+    nextClose(from?: Date): Date;
+    /** Milliseconds until the session closes, or 0 if not currently open. */
+    msToClose(at?: Date): number;
+    /** Milliseconds until the next open, or 0 if already open. */
+    msToOpen(at?: Date): number;
+}
+declare function createClock(spec: ExchangeSpec): MarketClock;
+/** National Stock Exchange of India. Pre-open 09:00–09:15, regular 09:15–15:30 IST. */
+declare const NSE: ExchangeSpec;
+/** Bombay Stock Exchange — same session timings and holiday calendar as NSE. */
+declare const BSE: ExchangeSpec;
+
+export { BSE, type ExchangeSpec, MarketClock, type MarketStatus, NSE, type Session, createClock };

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @lacspace/market-clock
+ * Is the market open right now? When does it next open / close?
+ *
+ * A holiday-aware, timezone-correct trading clock for stock exchanges. Ships
+ * with NSE / BSE (India) presets — India has no DST, so a fixed IST offset is
+ * exact. Bring your own exchange spec or override the holiday list any time.
+ *
+ * Zero dependencies · isomorphic · fully typed.
+ */
+interface Session {
+    /** "HH:MM" 24-hour, in exchange-local time. */
+    open: string;
+    close: string;
+}
+interface ExchangeSpec {
+    name: string;
+    /** Minutes ahead of UTC (IST = +330). Exchanges without DST only. */
+    offsetMinutes: number;
+    regular: Session;
+    preOpen?: Session;
+    /** Weekday numbers that are always closed (0 = Sunday … 6 = Saturday). */
+    weekend: number[];
+    /** Full-day holidays as "YYYY-MM-DD" in exchange-local dates. */
+    holidays: string[];
+}
+type MarketStatus = "pre-open" | "open" | "closed";
+declare class MarketClock {
+    readonly spec: ExchangeSpec;
+    private readonly regOpen;
+    private readonly regClose;
+    private readonly preOpen;
+    private readonly preClose;
+    constructor(spec: ExchangeSpec);
+    /** Exchange-local calendar parts for an instant. */
+    private parts;
+    /** UTC epoch millis for an exchange-local calendar day + minute-of-day. */
+    private utcFor;
+    private isoDate;
+    isWeekend(at?: Date): boolean;
+    isHoliday(at?: Date): boolean;
+    /** A day the exchange trades (not weekend, not a holiday). */
+    isTradingDay(at?: Date): boolean;
+    isOpen(at?: Date): boolean;
+    isPreOpen(at?: Date): boolean;
+    status(at?: Date): MarketStatus;
+    /** The next moment the regular session opens, at or after `from`. */
+    nextOpen(from?: Date): Date;
+    /** The next moment the regular session closes, at or after `from`. */
+    nextClose(from?: Date): Date;
+    /** Milliseconds until the session closes, or 0 if not currently open. */
+    msToClose(at?: Date): number;
+    /** Milliseconds until the next open, or 0 if already open. */
+    msToOpen(at?: Date): number;
+}
+declare function createClock(spec: ExchangeSpec): MarketClock;
+/** National Stock Exchange of India. Pre-open 09:00–09:15, regular 09:15–15:30 IST. */
+declare const NSE: ExchangeSpec;
+/** Bombay Stock Exchange — same session timings and holiday calendar as NSE. */
+declare const BSE: ExchangeSpec;
+
+export { BSE, type ExchangeSpec, MarketClock, type MarketStatus, NSE, type Session, createClock };

package/dist/index.js

@@ -0,0 +1,143 @@
+// src/index.ts
+function toMinutes(hhmm) {
+  const [h, m] = hhmm.split(":").map(Number);
+  return (h || 0) * 60 + (m || 0);
+}
+function pad(n) {
+  return n < 10 ? "0" + n : String(n);
+}
+var MarketClock = class {
+  constructor(spec) {
+    this.spec = spec;
+    this.regOpen = toMinutes(spec.regular.open);
+    this.regClose = toMinutes(spec.regular.close);
+    this.preOpen = spec.preOpen ? toMinutes(spec.preOpen.open) : null;
+    this.preClose = spec.preOpen ? toMinutes(spec.preOpen.close) : null;
+  }
+  /** Exchange-local calendar parts for an instant. */
+  parts(date) {
+    const local = new Date(date.getTime() + this.spec.offsetMinutes * 6e4);
+    return {
+      y: local.getUTCFullYear(),
+      m: local.getUTCMonth() + 1,
+      d: local.getUTCDate(),
+      day: local.getUTCDay(),
+      minute: local.getUTCHours() * 60 + local.getUTCMinutes()
+    };
+  }
+  /** UTC epoch millis for an exchange-local calendar day + minute-of-day. */
+  utcFor(y, m, d, minute) {
+    return Date.UTC(y, m - 1, d) + minute * 6e4 - this.spec.offsetMinutes * 6e4;
+  }
+  isoDate(p) {
+    return `${p.y}-${pad(p.m)}-${pad(p.d)}`;
+  }
+  isWeekend(at = /* @__PURE__ */ new Date()) {
+    return this.spec.weekend.includes(this.parts(at).day);
+  }
+  isHoliday(at = /* @__PURE__ */ new Date()) {
+    return this.spec.holidays.includes(this.isoDate(this.parts(at)));
+  }
+  /** A day the exchange trades (not weekend, not a holiday). */
+  isTradingDay(at = /* @__PURE__ */ new Date()) {
+    return !this.isWeekend(at) && !this.isHoliday(at);
+  }
+  isOpen(at = /* @__PURE__ */ new Date()) {
+    if (!this.isTradingDay(at)) return false;
+    const { minute } = this.parts(at);
+    return minute >= this.regOpen && minute < this.regClose;
+  }
+  isPreOpen(at = /* @__PURE__ */ new Date()) {
+    if (this.preOpen === null || this.preClose === null) return false;
+    if (!this.isTradingDay(at)) return false;
+    const { minute } = this.parts(at);
+    return minute >= this.preOpen && minute < this.preClose;
+  }
+  status(at = /* @__PURE__ */ new Date()) {
+    if (this.isOpen(at)) return "open";
+    if (this.isPreOpen(at)) return "pre-open";
+    return "closed";
+  }
+  /** The next moment the regular session opens, at or after `from`. */
+  nextOpen(from = /* @__PURE__ */ new Date()) {
+    const start = this.parts(from);
+    for (let i = 0; i < 500; i++) {
+      const dayMs = Date.UTC(start.y, start.m - 1, start.d) + i * 864e5;
+      const dp = new Date(dayMs);
+      const p = { y: dp.getUTCFullYear(), m: dp.getUTCMonth() + 1, d: dp.getUTCDate() };
+      if (this.spec.weekend.includes(dp.getUTCDay())) continue;
+      if (this.spec.holidays.includes(this.isoDate(p))) continue;
+      const openUtc = this.utcFor(p.y, p.m, p.d, this.regOpen);
+      if (openUtc > from.getTime()) return new Date(openUtc);
+    }
+    throw new Error("no trading day found within 500 days");
+  }
+  /** The next moment the regular session closes, at or after `from`. */
+  nextClose(from = /* @__PURE__ */ new Date()) {
+    const start = this.parts(from);
+    for (let i = 0; i < 500; i++) {
+      const dayMs = Date.UTC(start.y, start.m - 1, start.d) + i * 864e5;
+      const dp = new Date(dayMs);
+      const p = { y: dp.getUTCFullYear(), m: dp.getUTCMonth() + 1, d: dp.getUTCDate() };
+      if (this.spec.weekend.includes(dp.getUTCDay())) continue;
+      if (this.spec.holidays.includes(this.isoDate(p))) continue;
+      const closeUtc = this.utcFor(p.y, p.m, p.d, this.regClose);
+      if (closeUtc > from.getTime()) return new Date(closeUtc);
+    }
+    throw new Error("no trading day found within 500 days");
+  }
+  /** Milliseconds until the session closes, or 0 if not currently open. */
+  msToClose(at = /* @__PURE__ */ new Date()) {
+    if (!this.isOpen(at)) return 0;
+    return this.nextClose(at).getTime() - at.getTime();
+  }
+  /** Milliseconds until the next open, or 0 if already open. */
+  msToOpen(at = /* @__PURE__ */ new Date()) {
+    if (this.isOpen(at)) return 0;
+    return this.nextOpen(at).getTime() - at.getTime();
+  }
+};
+function createClock(spec) {
+  return new MarketClock(spec);
+}
+var NSE_HOLIDAYS = [
+  // 2025
+  "2025-02-26",
+  "2025-03-14",
+  "2025-03-31",
+  "2025-04-10",
+  "2025-04-14",
+  "2025-04-18",
+  "2025-05-01",
+  "2025-08-15",
+  "2025-08-27",
+  "2025-10-02",
+  "2025-10-21",
+  "2025-10-22",
+  "2025-11-05",
+  "2025-12-25",
+  // 2026 (nationally-fixed observances; confirm exchange circular for the rest)
+  "2026-01-26",
+  "2026-03-04",
+  "2026-04-01",
+  "2026-05-01",
+  "2026-10-02",
+  "2026-11-09",
+  "2026-12-25"
+];
+var NSE = {
+  name: "NSE",
+  offsetMinutes: 330,
+  preOpen: { open: "09:00", close: "09:15" },
+  regular: { open: "09:15", close: "15:30" },
+  weekend: [0, 6],
+  holidays: NSE_HOLIDAYS
+};
+var BSE = {
+  ...NSE,
+  name: "BSE"
+};
+
+export { BSE, MarketClock, NSE, createClock };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @lacspace/market-clock\n * Is the market open right now? When does it next open / close?\n *\n * A holiday-aware, timezone-correct trading clock for stock exchanges. Ships\n * with NSE / BSE (India) presets — India has no DST, so a fixed IST offset is\n * exact. Bring your own exchange spec or override the holiday list any time.\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\nexport interface Session {\n  /** \"HH:MM\" 24-hour, in exchange-local time. */\n  open: string;\n  close: string;\n}\n\nexport interface ExchangeSpec {\n  name: string;\n  /** Minutes ahead of UTC (IST = +330). Exchanges without DST only. */\n  offsetMinutes: number;\n  regular: Session;\n  preOpen?: Session;\n  /** Weekday numbers that are always closed (0 = Sunday … 6 = Saturday). */\n  weekend: number[];\n  /** Full-day holidays as \"YYYY-MM-DD\" in exchange-local dates. */\n  holidays: string[];\n}\n\nexport type MarketStatus = \"pre-open\" | \"open\" | \"closed\";\n\nfunction toMinutes(hhmm: string): number {\n  const [h, m] = hhmm.split(\":\").map(Number);\n  return (h || 0) * 60 + (m || 0);\n}\n\nfunction pad(n: number): string {\n  return n < 10 ? \"0\" + n : String(n);\n}\n\ninterface LocalParts {\n  y: number;\n  m: number;\n  d: number;\n  day: number;\n  minute: number;\n}\n\nexport class MarketClock {\n  private readonly regOpen: number;\n  private readonly regClose: number;\n  private readonly preOpen: number | null;\n  private readonly preClose: number | null;\n\n  constructor(public readonly spec: ExchangeSpec) {\n    this.regOpen = toMinutes(spec.regular.open);\n    this.regClose = toMinutes(spec.regular.close);\n    this.preOpen = spec.preOpen ? toMinutes(spec.preOpen.open) : null;\n    this.preClose = spec.preOpen ? toMinutes(spec.preOpen.close) : null;\n  }\n\n  /** Exchange-local calendar parts for an instant. */\n  private parts(date: Date): LocalParts {\n    const local = new Date(date.getTime() + this.spec.offsetMinutes * 60000);\n    return {\n      y: local.getUTCFullYear(),\n      m: local.getUTCMonth() + 1,\n      d: local.getUTCDate(),\n      day: local.getUTCDay(),\n      minute: local.getUTCHours() * 60 + local.getUTCMinutes(),\n    };\n  }\n\n  /** UTC epoch millis for an exchange-local calendar day + minute-of-day. */\n  private utcFor(y: number, m: number, d: number, minute: number): number {\n    return Date.UTC(y, m - 1, d) + minute * 60000 - this.spec.offsetMinutes * 60000;\n  }\n\n  private isoDate(p: { y: number; m: number; d: number }): string {\n    return `${p.y}-${pad(p.m)}-${pad(p.d)}`;\n  }\n\n  isWeekend(at: Date = new Date()): boolean {\n    return this.spec.weekend.includes(this.parts(at).day);\n  }\n\n  isHoliday(at: Date = new Date()): boolean {\n    return this.spec.holidays.includes(this.isoDate(this.parts(at)));\n  }\n\n  /** A day the exchange trades (not weekend, not a holiday). */\n  isTradingDay(at: Date = new Date()): boolean {\n    return !this.isWeekend(at) && !this.isHoliday(at);\n  }\n\n  isOpen(at: Date = new Date()): boolean {\n    if (!this.isTradingDay(at)) return false;\n    const { minute } = this.parts(at);\n    return minute >= this.regOpen && minute < this.regClose;\n  }\n\n  isPreOpen(at: Date = new Date()): boolean {\n    if (this.preOpen === null || this.preClose === null) return false;\n    if (!this.isTradingDay(at)) return false;\n    const { minute } = this.parts(at);\n    return minute >= this.preOpen && minute < this.preClose;\n  }\n\n  status(at: Date = new Date()): MarketStatus {\n    if (this.isOpen(at)) return \"open\";\n    if (this.isPreOpen(at)) return \"pre-open\";\n    return \"closed\";\n  }\n\n  /** The next moment the regular session opens, at or after `from`. */\n  nextOpen(from: Date = new Date()): Date {\n    const start = this.parts(from);\n    for (let i = 0; i < 500; i++) {\n      const dayMs = Date.UTC(start.y, start.m - 1, start.d) + i * 86400000;\n      const dp = new Date(dayMs);\n      const p = { y: dp.getUTCFullYear(), m: dp.getUTCMonth() + 1, d: dp.getUTCDate() };\n      if (this.spec.weekend.includes(dp.getUTCDay())) continue;\n      if (this.spec.holidays.includes(this.isoDate(p))) continue;\n      const openUtc = this.utcFor(p.y, p.m, p.d, this.regOpen);\n      if (openUtc > from.getTime()) return new Date(openUtc);\n    }\n    throw new Error(\"no trading day found within 500 days\");\n  }\n\n  /** The next moment the regular session closes, at or after `from`. */\n  nextClose(from: Date = new Date()): Date {\n    const start = this.parts(from);\n    for (let i = 0; i < 500; i++) {\n      const dayMs = Date.UTC(start.y, start.m - 1, start.d) + i * 86400000;\n      const dp = new Date(dayMs);\n      const p = { y: dp.getUTCFullYear(), m: dp.getUTCMonth() + 1, d: dp.getUTCDate() };\n      if (this.spec.weekend.includes(dp.getUTCDay())) continue;\n      if (this.spec.holidays.includes(this.isoDate(p))) continue;\n      const closeUtc = this.utcFor(p.y, p.m, p.d, this.regClose);\n      if (closeUtc > from.getTime()) return new Date(closeUtc);\n    }\n    throw new Error(\"no trading day found within 500 days\");\n  }\n\n  /** Milliseconds until the session closes, or 0 if not currently open. */\n  msToClose(at: Date = new Date()): number {\n    if (!this.isOpen(at)) return 0;\n    return this.nextClose(at).getTime() - at.getTime();\n  }\n\n  /** Milliseconds until the next open, or 0 if already open. */\n  msToOpen(at: Date = new Date()): number {\n    if (this.isOpen(at)) return 0;\n    return this.nextOpen(at).getTime() - at.getTime();\n  }\n}\n\nexport function createClock(spec: ExchangeSpec): MarketClock {\n  return new MarketClock(spec);\n}\n\n/**\n * NSE trading holidays. Nationally-fixed days are reliable; the rest follow the\n * annual NSE circular and may shift year to year — verify and extend as needed\n * (spread via `new MarketClock({ ...NSE, holidays: [...NSE.holidays, ...] })`).\n */\nconst NSE_HOLIDAYS: string[] = [\n  // 2025\n  \"2025-02-26\", \"2025-03-14\", \"2025-03-31\", \"2025-04-10\", \"2025-04-14\",\n  \"2025-04-18\", \"2025-05-01\", \"2025-08-15\", \"2025-08-27\", \"2025-10-02\",\n  \"2025-10-21\", \"2025-10-22\", \"2025-11-05\", \"2025-12-25\",\n  // 2026 (nationally-fixed observances; confirm exchange circular for the rest)\n  \"2026-01-26\", \"2026-03-04\", \"2026-04-01\", \"2026-05-01\", \"2026-10-02\",\n  \"2026-11-09\", \"2026-12-25\",\n];\n\n/** National Stock Exchange of India. Pre-open 09:00–09:15, regular 09:15–15:30 IST. */\nexport const NSE: ExchangeSpec = {\n  name: \"NSE\",\n  offsetMinutes: 330,\n  preOpen: { open: \"09:00\", close: \"09:15\" },\n  regular: { open: \"09:15\", close: \"15:30\" },\n  weekend: [0, 6],\n  holidays: NSE_HOLIDAYS,\n};\n\n/** Bombay Stock Exchange — same session timings and holiday calendar as NSE. */\nexport const BSE: ExchangeSpec = {\n  ...NSE,\n  name: \"BSE\",\n};\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@lacspace/market-clock",
+  "version": "1.0.0",
+  "description": "Holiday-aware, timezone-correct trading clock — is NSE/BSE open now, next open/close, pre-open, holidays. Bring your own exchange spec. Zero-dependency.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "market-hours",
+    "trading-hours",
+    "stock-market",
+    "nse",
+    "bse",
+    "market-open",
+    "holidays",
+    "exchange-calendar",
+    "timezone",
+    "typescript"
+  ],
+  "author": "Lacspace <contact@lacspace.com>",
+  "license": "MIT",
+  "homepage": "https://lacspace.com/packages",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lacspace/npm-packages.git",
+    "directory": "market-clock"
+  },
+  "bugs": {
+    "url": "https://github.com/lacspace/npm-packages/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}