@invinite-org/chartlang-runtime 1.1.1 → 1.3.0

package/dist/time-accessors/civil.js

@@ -0,0 +1,105 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// Civil-date arithmetic follows Howard Hinnant's public-domain
+// `civil_from_days` / `days_from_civil` algorithm
+// (http://howardhinnant.github.io/date_algorithms.html). Algorithm only —
+// the integer routines are reimplemented in chartlang style, not transcribed.
+const DAY_MS = 86_400_000;
+/**
+ * Integer floor-division rounding toward −∞ (unlike JS `/ | 0`, which
+ * truncates toward `0`). Required so pre-1970 epochs split correctly.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { floorDiv } from "@invinite-org/chartlang-runtime";
+ *     // floorDiv(-1, 86_400_000); // -1, not 0
+ */
+export function floorDiv(a, b) {
+    return Math.floor(a / b);
+}
+/**
+ * Non-negative modulo (Euclidean) — `mod(-1, 7) === 6`, unlike JS `%`
+ * which would yield `-1`. Pairs with {@link floorDiv} for correct
+ * pre-epoch date math.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { mod } from "@invinite-org/chartlang-runtime";
+ *     // mod(-1, 7); // 6
+ */
+export function mod(a, b) {
+    return a - floorDiv(a, b) * b;
+}
+/**
+ * The civil date for a count of days since the Unix epoch
+ * (1970-01-01). `m` is `1..12`, `d` is `1..31`. Pure integer
+ * arithmetic — correct for negative (pre-epoch) `z`.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { civilFromDays } from "@invinite-org/chartlang-runtime";
+ *     // civilFromDays(0); // { y: 1970, m: 1, d: 1 }
+ */
+export function civilFromDays(z) {
+    const shifted = z + 719_468;
+    const era = floorDiv(shifted >= 0 ? shifted : shifted - 146_096, 146_097);
+    const doe = shifted - era * 146_097; // [0, 146096]
+    const yoe = floorDiv(doe - floorDiv(doe, 1460) + floorDiv(doe, 36_524) - floorDiv(doe, 146_096), 365); // [0, 399]
+    const y = yoe + era * 400;
+    const doy = doe - (365 * yoe + floorDiv(yoe, 4) - floorDiv(yoe, 100)); // [0, 365]
+    const mp = floorDiv(5 * doy + 2, 153); // [0, 11]
+    const d = doy - floorDiv(153 * mp + 2, 5) + 1; // [1, 31]
+    const m = mp < 10 ? mp + 3 : mp - 9; // [1, 12]
+    return { y: m <= 2 ? y + 1 : y, m, d };
+}
+/**
+ * Days since the Unix epoch (1970-01-01) for a civil `y` / `m` (`1..12`)
+ * / `d` (`1..31`). Inverse of {@link civilFromDays}. Pure integer
+ * arithmetic — correct for pre-epoch dates.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { daysFromCivil } from "@invinite-org/chartlang-runtime";
+ *     // daysFromCivil(1970, 1, 1); // 0
+ */
+export function daysFromCivil(y, m, d) {
+    const yy = m <= 2 ? y - 1 : y;
+    const era = floorDiv(yy >= 0 ? yy : yy - 399, 400);
+    const yoe = yy - era * 400; // [0, 399]
+    const doy = floorDiv(153 * (m > 2 ? m - 3 : m + 9) + 2, 5) + d - 1; // [0, 365]
+    const doe = yoe * 365 + floorDiv(yoe, 4) - floorDiv(yoe, 100) + doy; // [0, 146096]
+    return era * 146_097 + doe - 719_468;
+}
+/**
+ * Split a UTC ms epoch (after pre-shifting by `offsetMin` minutes) into
+ * civil fields. `dow` is `0=Sun .. 6=Sat`, derived from the day count
+ * (`mod(z + 4, 7)` — 1970-01-01 was a Thursday, index 4). All integer
+ * arithmetic on the floored ms — no `Date`.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { splitEpoch } from "@invinite-org/chartlang-runtime";
+ *     // splitEpoch(0, 0); // { y: 1970, m: 1, d: 1, hh: 0, mm: 0, ss: 0, dow: 4 }
+ */
+export function splitEpoch(ms, offsetMin) {
+    const local = Math.floor(ms) + offsetMin * 60_000;
+    const z = floorDiv(local, DAY_MS);
+    const secondsOfDay = floorDiv(mod(local, DAY_MS), 1000);
+    const { y, m, d } = civilFromDays(z);
+    return {
+        y,
+        m,
+        d,
+        hh: floorDiv(secondsOfDay, 3600),
+        mm: floorDiv(mod(secondsOfDay, 3600), 60),
+        ss: mod(secondsOfDay, 60),
+        dow: mod(z + 4, 7),
+    };
+}
+//# sourceMappingURL=civil.js.map

package/dist/time-accessors/civil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"civil.js","sourceRoot":"","sources":["../../src/time-accessors/civil.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n//\n// Civil-date arithmetic follows Howard Hinnant's public-domain\n// `civil_from_days` / `days_from_civil` algorithm\n// (http://howardhinnant.github.io/date_algorithms.html). Algorithm only —\n// the integer routines are reimplemented in chartlang style, not transcribed.\n\nconst DAY_MS = 86_400_000;\n\n/**\n * Integer floor-division rounding toward −∞ (unlike JS `/ | 0`, which\n * truncates toward `0`). Required so pre-1970 epochs split correctly.\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { floorDiv } from \"@invinite-org/chartlang-runtime\";\n *     // floorDiv(-1, 86_400_000); // -1, not 0\n */\nexport function floorDiv(a: number, b: number): number {\n    return Math.floor(a / b);\n}\n\n/**\n * Non-negative modulo (Euclidean) — `mod(-1, 7) === 6`, unlike JS `%`\n * which would yield `-1`. Pairs with {@link floorDiv} for correct\n * pre-epoch date math.\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { mod } from \"@invinite-org/chartlang-runtime\";\n *     // mod(-1, 7); // 6\n */\nexport function mod(a: number, b: number): number {\n    return a - floorDiv(a, b) * b;\n}\n\n/**\n * The civil date for a count of days since the Unix epoch\n * (1970-01-01). `m` is `1..12`, `d` is `1..31`. Pure integer\n * arithmetic — correct for negative (pre-epoch) `z`.\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { civilFromDays } from \"@invinite-org/chartlang-runtime\";\n *     // civilFromDays(0); // { y: 1970, m: 1, d: 1 }\n */\nexport function civilFromDays(z: number): { y: number; m: number; d: number } {\n    const shifted = z + 719_468;\n    const era = floorDiv(shifted >= 0 ? shifted : shifted - 146_096, 146_097);\n    const doe = shifted - era * 146_097; // [0, 146096]\n    const yoe = floorDiv(\n        doe - floorDiv(doe, 1460) + floorDiv(doe, 36_524) - floorDiv(doe, 146_096),\n        365,\n    ); // [0, 399]\n    const y = yoe + era * 400;\n    const doy = doe - (365 * yoe + floorDiv(yoe, 4) - floorDiv(yoe, 100)); // [0, 365]\n    const mp = floorDiv(5 * doy + 2, 153); // [0, 11]\n    const d = doy - floorDiv(153 * mp + 2, 5) + 1; // [1, 31]\n    const m = mp < 10 ? mp + 3 : mp - 9; // [1, 12]\n    return { y: m <= 2 ? y + 1 : y, m, d };\n}\n\n/**\n * Days since the Unix epoch (1970-01-01) for a civil `y` / `m` (`1..12`)\n * / `d` (`1..31`). Inverse of {@link civilFromDays}. Pure integer\n * arithmetic — correct for pre-epoch dates.\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { daysFromCivil } from \"@invinite-org/chartlang-runtime\";\n *     // daysFromCivil(1970, 1, 1); // 0\n */\nexport function daysFromCivil(y: number, m: number, d: number): number {\n    const yy = m <= 2 ? y - 1 : y;\n    const era = floorDiv(yy >= 0 ? yy : yy - 399, 400);\n    const yoe = yy - era * 400; // [0, 399]\n    const doy = floorDiv(153 * (m > 2 ? m - 3 : m + 9) + 2, 5) + d - 1; // [0, 365]\n    const doe = yoe * 365 + floorDiv(yoe, 4) - floorDiv(yoe, 100) + doy; // [0, 146096]\n    return era * 146_097 + doe - 719_468;\n}\n\n/**\n * Split a UTC ms epoch (after pre-shifting by `offsetMin` minutes) into\n * civil fields. `dow` is `0=Sun .. 6=Sat`, derived from the day count\n * (`mod(z + 4, 7)` — 1970-01-01 was a Thursday, index 4). All integer\n * arithmetic on the floored ms — no `Date`.\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { splitEpoch } from \"@invinite-org/chartlang-runtime\";\n *     // splitEpoch(0, 0); // { y: 1970, m: 1, d: 1, hh: 0, mm: 0, ss: 0, dow: 4 }\n */\nexport function splitEpoch(\n    ms: number,\n    offsetMin: number,\n): { y: number; m: number; d: number; hh: number; mm: number; ss: number; dow: number } {\n    const local = Math.floor(ms) + offsetMin * 60_000;\n    const z = floorDiv(local, DAY_MS);\n    const secondsOfDay = floorDiv(mod(local, DAY_MS), 1000);\n    const { y, m, d } = civilFromDays(z);\n    return {\n        y,\n        m,\n        d,\n        hh: floorDiv(secondsOfDay, 3600),\n        mm: floorDiv(mod(secondsOfDay, 3600), 60),\n        ss: mod(secondsOfDay, 60),\n        dow: mod(z + 4, 7),\n    };\n}\n"]}

package/dist/time-accessors/index.d.ts

@@ -0,0 +1,8 @@
+export { civilFromDays, daysFromCivil, floorDiv, mod, splitEpoch } from "./civil.js";
+export { buildSessionNamespace, createSessionNamespace } from "./sessionAccessors.js";
+export { parseSessionWindowMinutes } from "./sessionWindow.js";
+export { buildTimeNamespace, createTimeNamespace, resolveTz } from "./timeAccessors.js";
+export { buildTzDstReporter } from "./tzDiagnostic.js";
+export { resolveOffsetMinutes } from "./tzOffset.js";
+export type { ResolvedOffset } from "./tzOffset.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/time-accessors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/time-accessors/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/time-accessors/index.js

@@ -0,0 +1,9 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export { civilFromDays, daysFromCivil, floorDiv, mod, splitEpoch } from "./civil.js";
+export { buildSessionNamespace, createSessionNamespace } from "./sessionAccessors.js";
+export { parseSessionWindowMinutes } from "./sessionWindow.js";
+export { buildTimeNamespace, createTimeNamespace, resolveTz } from "./timeAccessors.js";
+export { buildTzDstReporter } from "./tzDiagnostic.js";
+export { resolveOffsetMinutes } from "./tzOffset.js";
+//# sourceMappingURL=index.js.map

package/dist/time-accessors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/time-accessors/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nexport { civilFromDays, daysFromCivil, floorDiv, mod, splitEpoch } from \"./civil.js\";\nexport { buildSessionNamespace, createSessionNamespace } from \"./sessionAccessors.js\";\nexport { parseSessionWindowMinutes } from \"./sessionWindow.js\";\nexport { buildTimeNamespace, createTimeNamespace, resolveTz } from \"./timeAccessors.js\";\nexport { buildTzDstReporter } from \"./tzDiagnostic.js\";\nexport { resolveOffsetMinutes } from \"./tzOffset.js\";\nexport type { ResolvedOffset } from \"./tzOffset.js\";\n"]}

package/dist/time-accessors/sessionAccessors.d.ts

@@ -0,0 +1,50 @@
+import type { SessionNamespace } from "@invinite-org/chartlang-core";
+import type { RuntimeContext } from "../runtimeContext.js";
+/**
+ * Build a frozen `session` namespace whose `isOpen` tests half-open membership
+ * of an epoch's local minute-of-day against a parsed `"HH:MM-HH:MM"` window —
+ * pure integer epoch math (Howard Hinnant `civil_from_days` via
+ * {@link splitEpoch}), **no `Date`, no `Intl`** — so the result is
+ * byte-reproducible across hosts. The factory closes over the mount's default
+ * timezone and a `tz-dst-unsupported` reporter; the `isOpen` body is stateless.
+ *
+ * Membership is half-open `[start, end)` (the `end` minute is OUT, matching
+ * `ta.sessionVolumeProfile` and Pine `time()`); a window with `end <= start`
+ * (e.g. `"2200-0400"`) is treated as a midnight wrap `[start, 1440) ∪ [0, end)`.
+ * A non-finite `t` or a malformed `spec` yields `false`; the accessor never
+ * throws. A DST-bearing IANA zone resolves to UTC and invokes
+ * `onDstUnsupported(tz)` (once-per-tz dedup lives in the caller) — fired only
+ * once the call is otherwise well-formed (finite `t`, parseable `spec`).
+ *
+ * Unlike `ta.sessionVolumeProfile`, which defaults its window to
+ * `syminfo.session`, `isOpen` takes the `spec` as an explicit argument (often
+ * from `input.session`) and never reads `syminfo.session` itself.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { createSessionNamespace } from "@invinite-org/chartlang-runtime";
+ *     // const session = createSessionNamespace(() => "UTC", () => {});
+ *     // session.isOpen(0, "0000-1200"); // true (00:00 UTC is in [00:00, 12:00))
+ */
+export declare function createSessionNamespace(getDefaultTz: () => string, onDstUnsupported: (tz: string) => void): SessionNamespace;
+/**
+ * Install-time builder: bind {@link createSessionNamespace} to a mount's
+ * {@link RuntimeContext}. The default timezone resolves from the live
+ * `syminfo.timezone` view; the `tz-dst-unsupported` diagnostic dedupes on the
+ * SAME `ctx.diagnosedTzKeys` set the `time.*` accessors use, so a script using
+ * both `time.*` and `session.isOpen` on one DST zone warns once total.
+ * `buildComputeContext` calls this per bar (like the `state` / `request` /
+ * `runtime` namespaces, NOT a module constant like `ta`): the returned namespace
+ * is a pure view bound to the mount's `RuntimeContext`, so it is cheap to rebuild
+ * and is not relied upon to be identity-stable across bars.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { buildSessionNamespace } from "@invinite-org/chartlang-runtime";
+ *     // const session = buildSessionNamespace(state.runtimeContext);
+ *     // void session.isOpen;
+ */
+export declare function buildSessionNamespace(ctx: RuntimeContext): SessionNamespace;
+//# sourceMappingURL=sessionAccessors.d.ts.map

package/dist/time-accessors/sessionAccessors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionAccessors.d.ts","sourceRoot":"","sources":["../../src/time-accessors/sessionAccessors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAQ,MAAM,8BAA8B,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CAClC,YAAY,EAAE,MAAM,MAAM,EAC1B,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GACvC,gBAAgB,CAqBlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,gBAAgB,CAE3E"}

package/dist/time-accessors/sessionAccessors.js

@@ -0,0 +1,79 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { splitEpoch } from "./civil.js";
+import { parseSessionWindowMinutes } from "./sessionWindow.js";
+import { resolveTz } from "./timeAccessors.js";
+import { buildTzDstReporter } from "./tzDiagnostic.js";
+import { resolveOffsetMinutes } from "./tzOffset.js";
+/**
+ * Build a frozen `session` namespace whose `isOpen` tests half-open membership
+ * of an epoch's local minute-of-day against a parsed `"HH:MM-HH:MM"` window —
+ * pure integer epoch math (Howard Hinnant `civil_from_days` via
+ * {@link splitEpoch}), **no `Date`, no `Intl`** — so the result is
+ * byte-reproducible across hosts. The factory closes over the mount's default
+ * timezone and a `tz-dst-unsupported` reporter; the `isOpen` body is stateless.
+ *
+ * Membership is half-open `[start, end)` (the `end` minute is OUT, matching
+ * `ta.sessionVolumeProfile` and Pine `time()`); a window with `end <= start`
+ * (e.g. `"2200-0400"`) is treated as a midnight wrap `[start, 1440) ∪ [0, end)`.
+ * A non-finite `t` or a malformed `spec` yields `false`; the accessor never
+ * throws. A DST-bearing IANA zone resolves to UTC and invokes
+ * `onDstUnsupported(tz)` (once-per-tz dedup lives in the caller) — fired only
+ * once the call is otherwise well-formed (finite `t`, parseable `spec`).
+ *
+ * Unlike `ta.sessionVolumeProfile`, which defaults its window to
+ * `syminfo.session`, `isOpen` takes the `spec` as an explicit argument (often
+ * from `input.session`) and never reads `syminfo.session` itself.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { createSessionNamespace } from "@invinite-org/chartlang-runtime";
+ *     // const session = createSessionNamespace(() => "UTC", () => {});
+ *     // session.isOpen(0, "0000-1200"); // true (00:00 UTC is in [00:00, 12:00))
+ */
+export function createSessionNamespace(getDefaultTz, onDstUnsupported) {
+    return Object.freeze({
+        isOpen(t, spec, tz) {
+            if (!Number.isFinite(t))
+                return false;
+            const parsed = parseSessionWindowMinutes(spec);
+            if (parsed === null)
+                return false;
+            const resolved = resolveTz(tz, getDefaultTz);
+            const { offsetMin, dstUnsupported } = resolveOffsetMinutes(resolved);
+            if (dstUnsupported)
+                onDstUnsupported(resolved);
+            const { hh, mm } = splitEpoch(t, offsetMin);
+            const minuteOfDay = hh * 60 + mm;
+            const { startMinutes, endMinutes } = parsed;
+            if (endMinutes <= startMinutes) {
+                // Midnight-wrap window: [start, 1440) ∪ [0, end).
+                return minuteOfDay >= startMinutes || minuteOfDay < endMinutes;
+            }
+            return minuteOfDay >= startMinutes && minuteOfDay < endMinutes;
+        },
+    });
+}
+/**
+ * Install-time builder: bind {@link createSessionNamespace} to a mount's
+ * {@link RuntimeContext}. The default timezone resolves from the live
+ * `syminfo.timezone` view; the `tz-dst-unsupported` diagnostic dedupes on the
+ * SAME `ctx.diagnosedTzKeys` set the `time.*` accessors use, so a script using
+ * both `time.*` and `session.isOpen` on one DST zone warns once total.
+ * `buildComputeContext` calls this per bar (like the `state` / `request` /
+ * `runtime` namespaces, NOT a module constant like `ta`): the returned namespace
+ * is a pure view bound to the mount's `RuntimeContext`, so it is cheap to rebuild
+ * and is not relied upon to be identity-stable across bars.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { buildSessionNamespace } from "@invinite-org/chartlang-runtime";
+ *     // const session = buildSessionNamespace(state.runtimeContext);
+ *     // void session.isOpen;
+ */
+export function buildSessionNamespace(ctx) {
+    return createSessionNamespace(() => ctx.views.syminfo.timezone, buildTzDstReporter(ctx));
+}
+//# sourceMappingURL=sessionAccessors.js.map

package/dist/time-accessors/sessionAccessors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionAccessors.js","sourceRoot":"","sources":["../../src/time-accessors/sessionAccessors.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAK/D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,sBAAsB,CAClC,YAA0B,EAC1B,gBAAsC;IAEtC,OAAO,MAAM,CAAC,MAAM,CAAmB;QACnC,MAAM,CAAC,CAAO,EAAE,IAAY,EAAE,EAAW;YACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtC,MAAM,MAAM,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YAElC,MAAM,QAAQ,GAAG,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;YAC7C,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YACrE,IAAI,cAAc;gBAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE/C,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YAC5C,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;YACjC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;YAC5C,IAAI,UAAU,IAAI,YAAY,EAAE,CAAC;gBAC7B,kDAAkD;gBAClD,OAAO,WAAW,IAAI,YAAY,IAAI,WAAW,GAAG,UAAU,CAAC;YACnE,CAAC;YACD,OAAO,WAAW,IAAI,YAAY,IAAI,WAAW,GAAG,UAAU,CAAC;QACnE,CAAC;KACJ,CAAC,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAmB;IACrD,OAAO,sBAAsB,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7F,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { SessionNamespace, Time } from \"@invinite-org/chartlang-core\";\n\nimport type { RuntimeContext } from \"../runtimeContext.js\";\nimport { splitEpoch } from \"./civil.js\";\nimport { parseSessionWindowMinutes } from \"./sessionWindow.js\";\nimport { resolveTz } from \"./timeAccessors.js\";\nimport { buildTzDstReporter } from \"./tzDiagnostic.js\";\nimport { resolveOffsetMinutes } from \"./tzOffset.js\";\n\n/**\n * Build a frozen `session` namespace whose `isOpen` tests half-open membership\n * of an epoch's local minute-of-day against a parsed `\"HH:MM-HH:MM\"` window —\n * pure integer epoch math (Howard Hinnant `civil_from_days` via\n * {@link splitEpoch}), **no `Date`, no `Intl`** — so the result is\n * byte-reproducible across hosts. The factory closes over the mount's default\n * timezone and a `tz-dst-unsupported` reporter; the `isOpen` body is stateless.\n *\n * Membership is half-open `[start, end)` (the `end` minute is OUT, matching\n * `ta.sessionVolumeProfile` and Pine `time()`); a window with `end <= start`\n * (e.g. `\"2200-0400\"`) is treated as a midnight wrap `[start, 1440) ∪ [0, end)`.\n * A non-finite `t` or a malformed `spec` yields `false`; the accessor never\n * throws. A DST-bearing IANA zone resolves to UTC and invokes\n * `onDstUnsupported(tz)` (once-per-tz dedup lives in the caller) — fired only\n * once the call is otherwise well-formed (finite `t`, parseable `spec`).\n *\n * Unlike `ta.sessionVolumeProfile`, which defaults its window to\n * `syminfo.session`, `isOpen` takes the `spec` as an explicit argument (often\n * from `input.session`) and never reads `syminfo.session` itself.\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { createSessionNamespace } from \"@invinite-org/chartlang-runtime\";\n *     // const session = createSessionNamespace(() => \"UTC\", () => {});\n *     // session.isOpen(0, \"0000-1200\"); // true (00:00 UTC is in [00:00, 12:00))\n */\nexport function createSessionNamespace(\n    getDefaultTz: () => string,\n    onDstUnsupported: (tz: string) => void,\n): SessionNamespace {\n    return Object.freeze<SessionNamespace>({\n        isOpen(t: Time, spec: string, tz?: string): boolean {\n            if (!Number.isFinite(t)) return false;\n            const parsed = parseSessionWindowMinutes(spec);\n            if (parsed === null) return false;\n\n            const resolved = resolveTz(tz, getDefaultTz);\n            const { offsetMin, dstUnsupported } = resolveOffsetMinutes(resolved);\n            if (dstUnsupported) onDstUnsupported(resolved);\n\n            const { hh, mm } = splitEpoch(t, offsetMin);\n            const minuteOfDay = hh * 60 + mm;\n            const { startMinutes, endMinutes } = parsed;\n            if (endMinutes <= startMinutes) {\n                // Midnight-wrap window: [start, 1440) ∪ [0, end).\n                return minuteOfDay >= startMinutes || minuteOfDay < endMinutes;\n            }\n            return minuteOfDay >= startMinutes && minuteOfDay < endMinutes;\n        },\n    });\n}\n\n/**\n * Install-time builder: bind {@link createSessionNamespace} to a mount's\n * {@link RuntimeContext}. The default timezone resolves from the live\n * `syminfo.timezone` view; the `tz-dst-unsupported` diagnostic dedupes on the\n * SAME `ctx.diagnosedTzKeys` set the `time.*` accessors use, so a script using\n * both `time.*` and `session.isOpen` on one DST zone warns once total.\n * `buildComputeContext` calls this per bar (like the `state` / `request` /\n * `runtime` namespaces, NOT a module constant like `ta`): the returned namespace\n * is a pure view bound to the mount's `RuntimeContext`, so it is cheap to rebuild\n * and is not relied upon to be identity-stable across bars.\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { buildSessionNamespace } from \"@invinite-org/chartlang-runtime\";\n *     // const session = buildSessionNamespace(state.runtimeContext);\n *     // void session.isOpen;\n */\nexport function buildSessionNamespace(ctx: RuntimeContext): SessionNamespace {\n    return createSessionNamespace(() => ctx.views.syminfo.timezone, buildTzDstReporter(ctx));\n}\n"]}

package/dist/time-accessors/sessionWindow.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Parse a daily session window `"HH:MM-HH:MM"` / `"HHMM-HHMM"` into start/end
+ * minute-of-day (`0..1439`). Returns `null` for any malformed spec or an
+ * out-of-range hour (`>23`) / minute (`>59`). A window whose `end <= start`
+ * is left as-is — the caller decides whether to treat it as a midnight wrap.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { parseSessionWindowMinutes } from "@invinite-org/chartlang-runtime";
+ *     // parseSessionWindowMinutes("0930-1600"); // { startMinutes: 570, endMinutes: 960 }
+ */
+export declare function parseSessionWindowMinutes(spec: string): {
+    startMinutes: number;
+    endMinutes: number;
+} | null;
+//# sourceMappingURL=sessionWindow.d.ts.map

package/dist/time-accessors/sessionWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionWindow.d.ts","sourceRoot":"","sources":["../../src/time-accessors/sessionWindow.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACrC,IAAI,EAAE,MAAM,GACb;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAarD"}

package/dist/time-accessors/sessionWindow.js

@@ -0,0 +1,41 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+//
+// The single source of the chartlang session-window grammar. Lifted out of
+// `ta/sessionVolumeProfile.ts` so `ta.sessionVolumeProfile` and
+// `session.isOpen` parse `"HH:MM-HH:MM"` windows through ONE regex — never a
+// forked copy.
+// Two `HH[:MM]` clock fields separated by `-` (optional surrounding whitespace).
+// The minutes are optional (`"0930"` / `"930"` parse), and a `:` separator is
+// also optional (`"09:30"` and `"0930"` are equivalent).
+const SESSION_WINDOW = /^(\d{1,2})(?::?(\d{2}))?\s*-\s*(\d{1,2})(?::?(\d{2}))?$/;
+/**
+ * Parse a daily session window `"HH:MM-HH:MM"` / `"HHMM-HHMM"` into start/end
+ * minute-of-day (`0..1439`). Returns `null` for any malformed spec or an
+ * out-of-range hour (`>23`) / minute (`>59`). A window whose `end <= start`
+ * is left as-is — the caller decides whether to treat it as a midnight wrap.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { parseSessionWindowMinutes } from "@invinite-org/chartlang-runtime";
+ *     // parseSessionWindowMinutes("0930-1600"); // { startMinutes: 570, endMinutes: 960 }
+ */
+export function parseSessionWindowMinutes(spec) {
+    const match = SESSION_WINDOW.exec(spec.trim());
+    if (match === null)
+        return null;
+    const startHour = Number(match[1]);
+    const startMinute = match[2] === undefined ? 0 : Number(match[2]);
+    const endHour = Number(match[3]);
+    const endMinute = match[4] === undefined ? 0 : Number(match[4]);
+    if (startHour < 0 || startHour > 23 || startMinute < 0 || startMinute > 59)
+        return null;
+    if (endHour < 0 || endHour > 23 || endMinute < 0 || endMinute > 59)
+        return null;
+    return {
+        startMinutes: startHour * 60 + startMinute,
+        endMinutes: endHour * 60 + endMinute,
+    };
+}
+//# sourceMappingURL=sessionWindow.js.map

package/dist/time-accessors/sessionWindow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionWindow.js","sourceRoot":"","sources":["../../src/time-accessors/sessionWindow.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAC/D,EAAE;AACF,2EAA2E;AAC3E,gEAAgE;AAChE,6EAA6E;AAC7E,eAAe;AAEf,iFAAiF;AACjF,8EAA8E;AAC9E,yDAAyD;AACzD,MAAM,cAAc,GAAG,yDAAyD,CAAC;AAEjF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CACrC,IAAY;IAEZ,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,EAAE,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IACxF,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,EAAE,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IAChF,OAAO;QACH,YAAY,EAAE,SAAS,GAAG,EAAE,GAAG,WAAW;QAC1C,UAAU,EAAE,OAAO,GAAG,EAAE,GAAG,SAAS;KACvC,CAAC;AACN,CAAC","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n//\n// The single source of the chartlang session-window grammar. Lifted out of\n// `ta/sessionVolumeProfile.ts` so `ta.sessionVolumeProfile` and\n// `session.isOpen` parse `\"HH:MM-HH:MM\"` windows through ONE regex — never a\n// forked copy.\n\n// Two `HH[:MM]` clock fields separated by `-` (optional surrounding whitespace).\n// The minutes are optional (`\"0930\"` / `\"930\"` parse), and a `:` separator is\n// also optional (`\"09:30\"` and `\"0930\"` are equivalent).\nconst SESSION_WINDOW = /^(\\d{1,2})(?::?(\\d{2}))?\\s*-\\s*(\\d{1,2})(?::?(\\d{2}))?$/;\n\n/**\n * Parse a daily session window `\"HH:MM-HH:MM\"` / `\"HHMM-HHMM\"` into start/end\n * minute-of-day (`0..1439`). Returns `null` for any malformed spec or an\n * out-of-range hour (`>23`) / minute (`>59`). A window whose `end <= start`\n * is left as-is — the caller decides whether to treat it as a midnight wrap.\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { parseSessionWindowMinutes } from \"@invinite-org/chartlang-runtime\";\n *     // parseSessionWindowMinutes(\"0930-1600\"); // { startMinutes: 570, endMinutes: 960 }\n */\nexport function parseSessionWindowMinutes(\n    spec: string,\n): { startMinutes: number; endMinutes: number } | null {\n    const match = SESSION_WINDOW.exec(spec.trim());\n    if (match === null) return null;\n    const startHour = Number(match[1]);\n    const startMinute = match[2] === undefined ? 0 : Number(match[2]);\n    const endHour = Number(match[3]);\n    const endMinute = match[4] === undefined ? 0 : Number(match[4]);\n    if (startHour < 0 || startHour > 23 || startMinute < 0 || startMinute > 59) return null;\n    if (endHour < 0 || endHour > 23 || endMinute < 0 || endMinute > 59) return null;\n    return {\n        startMinutes: startHour * 60 + startMinute,\n        endMinutes: endHour * 60 + endMinute,\n    };\n}\n"]}

package/dist/time-accessors/timeAccessors.d.ts

@@ -0,0 +1,54 @@
+import type { TimeNamespace } from "@invinite-org/chartlang-core";
+import type { RuntimeContext } from "../runtimeContext.js";
+/**
+ * Resolve a tz argument, falling back to the mount default then `"UTC"`.
+ * Shared by the `time.*` and `session.*` accessor factories so both honour the
+ * identical explicit → `syminfo.timezone` → `"UTC"` precedence.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { resolveTz } from "@invinite-org/chartlang-runtime";
+ *     // resolveTz(undefined, () => ""); // "UTC"
+ */
+export declare function resolveTz(tz: string | undefined, getDefaultTz: () => string): string;
+/**
+ * Build a frozen `time` namespace whose accessors do pure integer epoch math
+ * (Howard Hinnant `civil_from_days`) — **no `Date`, no `Intl`** — so output is
+ * byte-reproducible across hosts. The factory closes over the mount's default
+ * timezone, the live bar interval (for {@link TimeNamespace.timeClose}), and a
+ * `tz-dst-unsupported` reporter; the accessor bodies themselves are stateless.
+ *
+ * v1 honours UTC + fixed-offset zones only. A DST-bearing IANA zone resolves to
+ * UTC and invokes `onDstUnsupported(tz)` (once-per-tz dedup lives in the
+ * caller). Non-finite / out-of-range inputs yield `NaN`; the accessors never
+ * throw.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { createTimeNamespace } from "@invinite-org/chartlang-runtime";
+ *     // const time = createTimeNamespace(() => "UTC", () => 60_000, () => {});
+ *     // time.year(0); // 1970
+ */
+export declare function createTimeNamespace(getDefaultTz: () => string, getIntervalMs: () => number, onDstUnsupported: (tz: string) => void): TimeNamespace;
+/**
+ * Install-time builder: bind {@link createTimeNamespace} to a mount's
+ * {@link RuntimeContext}. The default timezone resolves from the live
+ * `syminfo.timezone` view, the bar interval from `timeframe.inSeconds`, and the
+ * `tz-dst-unsupported` diagnostic dedupes once per distinct tz on
+ * `ctx.diagnosedTzKeys`. `buildComputeContext` calls this per bar (like the
+ * `state` / `request` / `runtime` namespaces, NOT a module constant like `ta`):
+ * the returned namespace is a pure view bound to the mount's `RuntimeContext`,
+ * so it is cheap to rebuild and is not relied upon to be identity-stable across
+ * bars (the script receives a fresh `ctx` each bar).
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { buildTimeNamespace } from "@invinite-org/chartlang-runtime";
+ *     // const time = buildTimeNamespace(state.runtimeContext);
+ *     // void time.year;
+ */
+export declare function buildTimeNamespace(ctx: RuntimeContext): TimeNamespace;
+//# sourceMappingURL=timeAccessors.d.ts.map

package/dist/time-accessors/timeAccessors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeAccessors.d.ts","sourceRoot":"","sources":["../../src/time-accessors/timeAccessors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAQ,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,MAAM,GAAG,MAAM,CAIpF;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAC/B,YAAY,EAAE,MAAM,MAAM,EAC1B,aAAa,EAAE,MAAM,MAAM,EAC3B,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GACvC,aAAa,CAuEf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,aAAa,CAMrE"}

package/dist/time-accessors/timeAccessors.js

@@ -0,0 +1,132 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { daysFromCivil, splitEpoch } from "./civil.js";
+import { buildTzDstReporter } from "./tzDiagnostic.js";
+import { resolveOffsetMinutes } from "./tzOffset.js";
+/**
+ * Resolve a tz argument, falling back to the mount default then `"UTC"`.
+ * Shared by the `time.*` and `session.*` accessor factories so both honour the
+ * identical explicit → `syminfo.timezone` → `"UTC"` precedence.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { resolveTz } from "@invinite-org/chartlang-runtime";
+ *     // resolveTz(undefined, () => ""); // "UTC"
+ */
+export function resolveTz(tz, getDefaultTz) {
+    if (tz !== undefined && tz !== "")
+        return tz;
+    const fallback = getDefaultTz();
+    return fallback === "" ? "UTC" : fallback;
+}
+function isInt(value) {
+    return Number.isInteger(value);
+}
+/**
+ * Build a frozen `time` namespace whose accessors do pure integer epoch math
+ * (Howard Hinnant `civil_from_days`) — **no `Date`, no `Intl`** — so output is
+ * byte-reproducible across hosts. The factory closes over the mount's default
+ * timezone, the live bar interval (for {@link TimeNamespace.timeClose}), and a
+ * `tz-dst-unsupported` reporter; the accessor bodies themselves are stateless.
+ *
+ * v1 honours UTC + fixed-offset zones only. A DST-bearing IANA zone resolves to
+ * UTC and invokes `onDstUnsupported(tz)` (once-per-tz dedup lives in the
+ * caller). Non-finite / out-of-range inputs yield `NaN`; the accessors never
+ * throw.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { createTimeNamespace } from "@invinite-org/chartlang-runtime";
+ *     // const time = createTimeNamespace(() => "UTC", () => 60_000, () => {});
+ *     // time.year(0); // 1970
+ */
+export function createTimeNamespace(getDefaultTz, getIntervalMs, onDstUnsupported) {
+    function offsetFor(tz) {
+        const resolved = resolveTz(tz, getDefaultTz);
+        const { offsetMin, dstUnsupported } = resolveOffsetMinutes(resolved);
+        if (dstUnsupported)
+            onDstUnsupported(resolved);
+        return offsetMin;
+    }
+    function field(t, tz, key) {
+        const offsetMin = offsetFor(tz);
+        if (!Number.isFinite(t))
+            return Number.NaN;
+        return splitEpoch(t, offsetMin)[key];
+    }
+    return Object.freeze({
+        year: (t, tz) => field(t, tz, "y"),
+        month: (t, tz) => field(t, tz, "m"),
+        dayofmonth: (t, tz) => field(t, tz, "d"),
+        hour: (t, tz) => field(t, tz, "hh"),
+        minute: (t, tz) => field(t, tz, "mm"),
+        second: (t, tz) => field(t, tz, "ss"),
+        dayofweek: (t, tz) => {
+            const offsetMin = offsetFor(tz);
+            if (!Number.isFinite(t))
+                return Number.NaN;
+            // Pine convention: 1=Sunday .. 7=Saturday (splitEpoch dow is 0=Sun).
+            return splitEpoch(t, offsetMin).dow + 1;
+        },
+        timestamp: (year, month, day, hour, minute, second, tz) => {
+            const offsetMin = offsetFor(tz);
+            const hh = hour ?? 0;
+            const mm = minute ?? 0;
+            const ss = second ?? 0;
+            if (!isInt(year) ||
+                !isInt(month) ||
+                !isInt(day) ||
+                !isInt(hh) ||
+                !isInt(mm) ||
+                !isInt(ss) ||
+                month < 1 ||
+                month > 12 ||
+                day < 1 ||
+                day > 31 ||
+                hh < 0 ||
+                hh > 23 ||
+                mm < 0 ||
+                mm > 59 ||
+                ss < 0 ||
+                ss > 59) {
+                return Number.NaN;
+            }
+            return (daysFromCivil(year, month, day) * 86_400_000 +
+                (hh * 3600 + mm * 60 + ss) * 1000 -
+                offsetMin * 60_000);
+        },
+        timeClose: (t, tz) => {
+            // `tz` is accepted for surface symmetry; the close instant is
+            // tz-invariant (start + interval). A DST tz still flags for
+            // consistency with the other accessors.
+            offsetFor(tz);
+            if (!Number.isFinite(t))
+                return Number.NaN;
+            return t + getIntervalMs();
+        },
+    });
+}
+/**
+ * Install-time builder: bind {@link createTimeNamespace} to a mount's
+ * {@link RuntimeContext}. The default timezone resolves from the live
+ * `syminfo.timezone` view, the bar interval from `timeframe.inSeconds`, and the
+ * `tz-dst-unsupported` diagnostic dedupes once per distinct tz on
+ * `ctx.diagnosedTzKeys`. `buildComputeContext` calls this per bar (like the
+ * `state` / `request` / `runtime` namespaces, NOT a module constant like `ta`):
+ * the returned namespace is a pure view bound to the mount's `RuntimeContext`,
+ * so it is cheap to rebuild and is not relied upon to be identity-stable across
+ * bars (the script receives a fresh `ctx` each bar).
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { buildTimeNamespace } from "@invinite-org/chartlang-runtime";
+ *     // const time = buildTimeNamespace(state.runtimeContext);
+ *     // void time.year;
+ */
+export function buildTimeNamespace(ctx) {
+    return createTimeNamespace(() => ctx.views.syminfo.timezone, () => ctx.views.timeframe.inSeconds * 1000, buildTzDstReporter(ctx));
+}
+//# sourceMappingURL=timeAccessors.js.map

package/dist/time-accessors/timeAccessors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeAccessors.js","sourceRoot":"","sources":["../../src/time-accessors/timeAccessors.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) 2026 Invinite. Licensed under the MIT License.\n// See the LICENSE file in the repo root for full license text.\n\nimport type { Time, TimeNamespace } from \"@invinite-org/chartlang-core\";\n\nimport type { RuntimeContext } from \"../runtimeContext.js\";\nimport { daysFromCivil, splitEpoch } from \"./civil.js\";\nimport { buildTzDstReporter } from \"./tzDiagnostic.js\";\nimport { resolveOffsetMinutes } from \"./tzOffset.js\";\n\n/**\n * Resolve a tz argument, falling back to the mount default then `\"UTC\"`.\n * Shared by the `time.*` and `session.*` accessor factories so both honour the\n * identical explicit → `syminfo.timezone` → `\"UTC\"` precedence.\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { resolveTz } from \"@invinite-org/chartlang-runtime\";\n *     // resolveTz(undefined, () => \"\"); // \"UTC\"\n */\nexport function resolveTz(tz: string | undefined, getDefaultTz: () => string): string {\n    if (tz !== undefined && tz !== \"\") return tz;\n    const fallback = getDefaultTz();\n    return fallback === \"\" ? \"UTC\" : fallback;\n}\n\nfunction isInt(value: number): boolean {\n    return Number.isInteger(value);\n}\n\n/**\n * Build a frozen `time` namespace whose accessors do pure integer epoch math\n * (Howard Hinnant `civil_from_days`) — **no `Date`, no `Intl`** — so output is\n * byte-reproducible across hosts. The factory closes over the mount's default\n * timezone, the live bar interval (for {@link TimeNamespace.timeClose}), and a\n * `tz-dst-unsupported` reporter; the accessor bodies themselves are stateless.\n *\n * v1 honours UTC + fixed-offset zones only. A DST-bearing IANA zone resolves to\n * UTC and invokes `onDstUnsupported(tz)` (once-per-tz dedup lives in the\n * caller). Non-finite / out-of-range inputs yield `NaN`; the accessors never\n * throw.\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { createTimeNamespace } from \"@invinite-org/chartlang-runtime\";\n *     // const time = createTimeNamespace(() => \"UTC\", () => 60_000, () => {});\n *     // time.year(0); // 1970\n */\nexport function createTimeNamespace(\n    getDefaultTz: () => string,\n    getIntervalMs: () => number,\n    onDstUnsupported: (tz: string) => void,\n): TimeNamespace {\n    function offsetFor(tz: string | undefined): number {\n        const resolved = resolveTz(tz, getDefaultTz);\n        const { offsetMin, dstUnsupported } = resolveOffsetMinutes(resolved);\n        if (dstUnsupported) onDstUnsupported(resolved);\n        return offsetMin;\n    }\n\n    function field<K extends \"y\" | \"m\" | \"d\" | \"hh\" | \"mm\" | \"ss\">(\n        t: Time,\n        tz: string | undefined,\n        key: K,\n    ): number {\n        const offsetMin = offsetFor(tz);\n        if (!Number.isFinite(t)) return Number.NaN;\n        return splitEpoch(t, offsetMin)[key];\n    }\n\n    return Object.freeze<TimeNamespace>({\n        year: (t, tz) => field(t, tz, \"y\"),\n        month: (t, tz) => field(t, tz, \"m\"),\n        dayofmonth: (t, tz) => field(t, tz, \"d\"),\n        hour: (t, tz) => field(t, tz, \"hh\"),\n        minute: (t, tz) => field(t, tz, \"mm\"),\n        second: (t, tz) => field(t, tz, \"ss\"),\n        dayofweek: (t, tz) => {\n            const offsetMin = offsetFor(tz);\n            if (!Number.isFinite(t)) return Number.NaN;\n            // Pine convention: 1=Sunday .. 7=Saturday (splitEpoch dow is 0=Sun).\n            return splitEpoch(t, offsetMin).dow + 1;\n        },\n        timestamp: (year, month, day, hour, minute, second, tz) => {\n            const offsetMin = offsetFor(tz);\n            const hh = hour ?? 0;\n            const mm = minute ?? 0;\n            const ss = second ?? 0;\n            if (\n                !isInt(year) ||\n                !isInt(month) ||\n                !isInt(day) ||\n                !isInt(hh) ||\n                !isInt(mm) ||\n                !isInt(ss) ||\n                month < 1 ||\n                month > 12 ||\n                day < 1 ||\n                day > 31 ||\n                hh < 0 ||\n                hh > 23 ||\n                mm < 0 ||\n                mm > 59 ||\n                ss < 0 ||\n                ss > 59\n            ) {\n                return Number.NaN;\n            }\n            return (\n                daysFromCivil(year, month, day) * 86_400_000 +\n                (hh * 3600 + mm * 60 + ss) * 1000 -\n                offsetMin * 60_000\n            );\n        },\n        timeClose: (t, tz) => {\n            // `tz` is accepted for surface symmetry; the close instant is\n            // tz-invariant (start + interval). A DST tz still flags for\n            // consistency with the other accessors.\n            offsetFor(tz);\n            if (!Number.isFinite(t)) return Number.NaN;\n            return t + getIntervalMs();\n        },\n    });\n}\n\n/**\n * Install-time builder: bind {@link createTimeNamespace} to a mount's\n * {@link RuntimeContext}. The default timezone resolves from the live\n * `syminfo.timezone` view, the bar interval from `timeframe.inSeconds`, and the\n * `tz-dst-unsupported` diagnostic dedupes once per distinct tz on\n * `ctx.diagnosedTzKeys`. `buildComputeContext` calls this per bar (like the\n * `state` / `request` / `runtime` namespaces, NOT a module constant like `ta`):\n * the returned namespace is a pure view bound to the mount's `RuntimeContext`,\n * so it is cheap to rebuild and is not relied upon to be identity-stable across\n * bars (the script receives a fresh `ctx` each bar).\n *\n * @since 1.5\n * @stable\n * @example\n *     // import { buildTimeNamespace } from \"@invinite-org/chartlang-runtime\";\n *     // const time = buildTimeNamespace(state.runtimeContext);\n *     // void time.year;\n */\nexport function buildTimeNamespace(ctx: RuntimeContext): TimeNamespace {\n    return createTimeNamespace(\n        () => ctx.views.syminfo.timezone,\n        () => ctx.views.timeframe.inSeconds * 1000,\n        buildTzDstReporter(ctx),\n    );\n}\n"]}

package/dist/time-accessors/tzDiagnostic.d.ts

@@ -0,0 +1,17 @@
+import type { RuntimeContext } from "../runtimeContext.js";
+/**
+ * Build the `onDstUnsupported(tz)` reporter the `time.*` and `session.*`
+ * accessor factories share. A DST-bearing IANA zone the UTC-first runtime
+ * cannot honour warns at most once per distinct tz per mount, deduped on
+ * `ctx.diagnosedTzKeys` — so a script using BOTH `time.*` and `session.isOpen`
+ * on one DST zone fires `tz-dst-unsupported` once total.
+ *
+ * @since 1.5
+ * @stable
+ * @example
+ *     // import { buildTzDstReporter } from "@invinite-org/chartlang-runtime";
+ *     // const report = buildTzDstReporter(ctx);
+ *     // report("America/New_York");
+ */
+export declare function buildTzDstReporter(ctx: RuntimeContext): (tz: string) => void;
+//# sourceMappingURL=tzDiagnostic.d.ts.map

package/dist/time-accessors/tzDiagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tzDiagnostic.d.ts","sourceRoot":"","sources":["../../src/time-accessors/tzDiagnostic.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAc5E"}