@northguild/gmt-oxlint 1.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NorthGuild
+
+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/README.md

@@ -0,0 +1,142 @@
+# @northguild/gmt-oxlint
+
+Shared [Oxlint](https://oxc.rs/docs/guide/usage/linter) JS plugin for `@northguild/gmt` projects.
+
+It enforces the same Date bans used by `@northguild/gmt-eslint` and `@northguild/gmt-biome`.
+
+## Installation
+
+### npm
+
+```sh
+npm install --save-dev @northguild/gmt-oxlint oxlint
+```
+
+### yarn
+
+```sh
+yarn add --dev @northguild/gmt-oxlint oxlint
+```
+
+### pnpm
+
+```sh
+pnpm add --save-dev @northguild/gmt-oxlint oxlint
+```
+
+### bun
+
+```sh
+bun add --save-dev @northguild/gmt-oxlint oxlint
+```
+
+## Usage
+
+### Quick start (recommended for best DX)
+
+In `oxlint.config.ts`:
+
+```ts
+import { defineConfig } from "oxlint";
+import { recommendedConfig } from "@northguild/gmt-oxlint";
+
+export default defineConfig(recommendedConfig);
+```
+
+If you prefer a custom alias for shorter rule names:
+
+```ts
+import { defineConfig } from "oxlint";
+import { recommendedRules } from "@northguild/gmt-oxlint";
+
+export default defineConfig({
+  jsPlugins: [{ name: "gmt", specifier: "@northguild/gmt-oxlint" }],
+  rules: {
+    // Copy rules under your alias if you want "gmt/..." rule IDs.
+    "gmt/no-date-global": "error",
+    "gmt/no-new-date": "error",
+    "gmt/no-date-now": "error",
+    "gmt/no-date-parse": "error",
+    "gmt/no-date-utc": "error",
+    "gmt/no-date-getTimezoneOffset": "error",
+  },
+});
+```
+
+### JSON config quick start
+
+In your `.oxlintrc.json`:
+
+```json
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "jsPlugins": ["@northguild/gmt-oxlint"],
+  "extends": ["./node_modules/@northguild/gmt-oxlint/config/recommended.json"]
+}
+```
+
+Oxlint currently resolves `extends` as file paths. Named shared config specifiers
+such as `@northguild/gmt-oxlint/recommended` are not currently supported.
+
+### Manual configuration
+
+Or explicitly configure each rule. You can use either a string or an array form:
+
+```json
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "jsPlugins": ["@northguild/gmt-oxlint"],
+  "rules": {
+    "@northguild/gmt-oxlint/no-date-global": "error",
+    "@northguild/gmt-oxlint/no-new-date": "error",
+    "@northguild/gmt-oxlint/no-date-now": "error",
+    "@northguild/gmt-oxlint/no-date-parse": "error",
+    "@northguild/gmt-oxlint/no-date-utc": "error",
+    "@northguild/gmt-oxlint/no-date-getTimezoneOffset": "error"
+  }
+}
+```
+
+Array form also supported:
+
+```json
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "jsPlugins": ["@northguild/gmt-oxlint"],
+  "rules": {
+    "@northguild/gmt-oxlint/no-date-global": ["error"],
+    "@northguild/gmt-oxlint/no-new-date": ["error"],
+    "@northguild/gmt-oxlint/no-date-now": ["error"],
+    "@northguild/gmt-oxlint/no-date-parse": ["error"],
+    "@northguild/gmt-oxlint/no-date-utc": ["error"],
+    "@northguild/gmt-oxlint/no-date-getTimezoneOffset": ["error"]
+  }
+}
+```
+
+## Banned patterns
+
+| Pattern                    | Rule                        | Suggestion                                                                                                            |
+| -------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| `Date` global reference    | `no-date-global`            | Use `getNow()`, `getUnixNow('milliseconds' or 'seconds')`, `getUtcNow()`, or `getZonedNow(timezone)`                  |
+| `new Date(...)`            | `no-new-date`               | Use `getUtcNow()`, `getNow()`, or `getZonedNow(timezone)`                                                             |
+| `Date.now()`               | `no-date-now`               | Use `getUnixNow('milliseconds' or 'seconds')` or `getNow()`                                                           |
+| `Date.parse(...)`          | `no-date-parse`             | Use `convertZonedToUnix(value)`                                                                                       |
+| `Date.UTC(...)`            | `no-date-utc`               | Use `convertUtcDateTimeToUnix('YYYY-MM-DDTHH:mm:ss', 'milliseconds' or 'seconds')`                                    |
+| `date.getTimezoneOffset()` | `no-date-getTimezoneOffset` | Use `getZonedNow(timezone)`, other gmt zoned helpers such as `convertZonedToUnix(value)`, or `Temporal.ZonedDateTime` |
+
+## Why Temporal?
+
+[Temporal](https://tc39.es/proposal-temporal/) solves fundamental issues with JavaScript's `Date` object:
+
+- Immutability: no accidental mutations
+- Timezone awareness: explicit, unambiguous timezone handling
+- No DST bugs: proper daylight saving time logic
+- Precision: nanosecond precision where needed
+
+All banned Date APIs have Temporal equivalents that are safer, clearer, and more correct.
+
+## Notes
+
+- Oxlint JS plugins are currently in alpha.
+- This package is authored in TypeScript and bundled with `tsup` for publishing.

package/config/recommended.d.ts

@@ -0,0 +1,12 @@
+declare const recommended: {
+  readonly rules: {
+    readonly "@northguild/gmt-oxlint/no-date-global": "error";
+    readonly "@northguild/gmt-oxlint/no-new-date": "error";
+    readonly "@northguild/gmt-oxlint/no-date-now": "error";
+    readonly "@northguild/gmt-oxlint/no-date-parse": "error";
+    readonly "@northguild/gmt-oxlint/no-date-utc": "error";
+    readonly "@northguild/gmt-oxlint/no-date-getTimezoneOffset": "error";
+  };
+};
+
+export default recommended;

package/config/recommended.json

@@ -0,0 +1,10 @@
+{
+  "rules": {
+    "@northguild/gmt-oxlint/no-date-global": "error",
+    "@northguild/gmt-oxlint/no-new-date": "error",
+    "@northguild/gmt-oxlint/no-date-now": "error",
+    "@northguild/gmt-oxlint/no-date-parse": "error",
+    "@northguild/gmt-oxlint/no-date-utc": "error",
+    "@northguild/gmt-oxlint/no-date-getTimezoneOffset": "error"
+  }
+}

package/dist/index.d.ts

@@ -0,0 +1,85 @@
+type Node = {
+    type: string;
+    range?: [number, number];
+    [key: string]: unknown;
+};
+type IdentifierNode = Node & {
+    type: "Identifier";
+    name: string;
+};
+type CallExpressionNode = Node & {
+    type: "CallExpression";
+    callee: Node;
+};
+type NewExpressionNode = Node & {
+    type: "NewExpression";
+    callee: Node;
+};
+type ProgramNode = Node & {
+    type: "Program";
+};
+type ScopeReference = {
+    identifier: IdentifierNode;
+};
+type ScopeInfo = {
+    through?: ScopeReference[];
+};
+type SourceCodeLike = {
+    getScope(node: Node): ScopeInfo;
+};
+type RuleContext = {
+    sourceCode: SourceCodeLike;
+    report(input: {
+        node: Node;
+        message: string;
+    }): void;
+};
+type RuleListener = {
+    Program?: (node: ProgramNode) => void;
+    NewExpression?: (node: NewExpressionNode) => void;
+    CallExpression?: (node: CallExpressionNode) => void;
+};
+type RuleModule = {
+    meta: {
+        type: "problem" | "suggestion" | "layout";
+        docs: {
+            description: string;
+        };
+        schema: unknown[];
+    };
+    create(context: RuleContext): RuleListener;
+};
+type OxlintPluginRuleConfig = "error" | "warn" | "off" | readonly [string] | readonly [string, unknown];
+interface OxlintPluginConfig {
+    rules?: Record<string, OxlintPluginRuleConfig>;
+}
+type OxlintPlugin = {
+    meta: {
+        name: string;
+    };
+    rules: Record<string, RuleModule>;
+    configs?: Record<string, OxlintPluginConfig>;
+};
+
+declare const recommendedRules: {
+    readonly "@northguild/gmt-oxlint/no-date-global": "error";
+    readonly "@northguild/gmt-oxlint/no-new-date": "error";
+    readonly "@northguild/gmt-oxlint/no-date-now": "error";
+    readonly "@northguild/gmt-oxlint/no-date-parse": "error";
+    readonly "@northguild/gmt-oxlint/no-date-utc": "error";
+    readonly "@northguild/gmt-oxlint/no-date-getTimezoneOffset": "error";
+};
+declare const recommendedConfig: {
+    readonly jsPlugins: readonly ["@northguild/gmt-oxlint"];
+    readonly rules: {
+        readonly "@northguild/gmt-oxlint/no-date-global": "error";
+        readonly "@northguild/gmt-oxlint/no-new-date": "error";
+        readonly "@northguild/gmt-oxlint/no-date-now": "error";
+        readonly "@northguild/gmt-oxlint/no-date-parse": "error";
+        readonly "@northguild/gmt-oxlint/no-date-utc": "error";
+        readonly "@northguild/gmt-oxlint/no-date-getTimezoneOffset": "error";
+    };
+};
+declare const plugin: OxlintPlugin;
+
+export { plugin as default, recommendedConfig, recommendedRules };

package/dist/index.js

@@ -0,0 +1,213 @@
+// src/messages.ts
+var MSG_DATE_GLOBAL = "Avoid Date. Use @northguild/gmt getNow(), getUnixNow('milliseconds' | 'seconds'), getUtcNow(), or getZonedNow(timezone) instead.";
+var MSG_NEW_DATE = "Avoid new Date(). Use @northguild/gmt getUtcNow(), getNow(), or getZonedNow(timezone) instead.";
+var MSG_DATE_NOW = "Avoid Date.now(). Use @northguild/gmt getUnixNow('milliseconds' | 'seconds') or getNow() instead.";
+var MSG_DATE_UTC = "Avoid Date.UTC(). Use @northguild/gmt convertUtcDateTimeToUnix('YYYY-MM-DDTHH:mm:ss', 'milliseconds' | 'seconds') instead.";
+var MSG_DATE_PARSE = "Avoid Date.parse(). Use @northguild/gmt convertZonedToUnix(value) instead.";
+var MSG_GET_TIMEZONE_OFFSET = "Avoid date.getTimezoneOffset(). Timezone offsets change throughout the year, so use @northguild/gmt zoned methods instead.";
+
+// src/utils/isChainExpression.ts
+function isChainExpression(node) {
+  return Boolean(node && node.type === "ChainExpression");
+}
+
+// src/utils/isMemberExpression.ts
+function isMemberExpression(node) {
+  return Boolean(node && node.type === "MemberExpression");
+}
+
+// src/utils/getMemberExpressionFromCall.ts
+function getMemberExpressionFromCall(node) {
+  const { callee } = node;
+  if (isMemberExpression(callee)) {
+    return callee;
+  }
+  if (isChainExpression(callee) && isMemberExpression(callee.expression)) {
+    return callee.expression;
+  }
+  return null;
+}
+
+// src/utils/isIdentifier.ts
+function isIdentifier(node, name) {
+  return Boolean(
+    node && node.type === "Identifier" && node.name === name
+  );
+}
+
+// src/utils/hasDateStaticMemberCall.ts
+function hasDateStaticMemberCall(node, memberName) {
+  const callee = getMemberExpressionFromCall(node);
+  if (!callee || callee.computed) {
+    return false;
+  }
+  return isIdentifier(callee.object, "Date") && isIdentifier(callee.property, memberName);
+}
+
+// src/rules/no-date-getTimezoneOffset.ts
+var noDateGetTimezoneOffsetRule = {
+  meta: {
+    type: "problem",
+    docs: { description: "Disallow getTimezoneOffset()." },
+    schema: []
+  },
+  create(context) {
+    return {
+      CallExpression(node) {
+        const callee = getMemberExpressionFromCall(node);
+        if (!callee || callee.computed) {
+          return;
+        }
+        if (!isIdentifier(callee.property, "getTimezoneOffset")) {
+          return;
+        }
+        context.report({ node, message: MSG_GET_TIMEZONE_OFFSET });
+      }
+    };
+  }
+};
+
+// src/rules/no-date-global.ts
+var reportThroughDateReferences = (context, node, message) => {
+  const sourceScope = context.sourceCode.getScope(node);
+  const through = sourceScope?.through;
+  if (!through?.length) {
+    return;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const ref of through) {
+    const id = ref.identifier;
+    if (!isIdentifier(id, "Date")) {
+      continue;
+    }
+    const [start, end] = id.range ?? [-1, -1];
+    const key = `${start}:${end}`;
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    context.report({ node: id, message });
+  }
+};
+var noDateGlobalRule = {
+  meta: {
+    type: "problem",
+    docs: { description: "Disallow the global Date object." },
+    schema: []
+  },
+  create(context) {
+    return {
+      Program(node) {
+        reportThroughDateReferences(context, node, MSG_DATE_GLOBAL);
+      }
+    };
+  }
+};
+
+// src/rules/no-date-now.ts
+var noDateNowRule = {
+  meta: {
+    type: "problem",
+    docs: { description: "Disallow Date.now()." },
+    schema: []
+  },
+  create(context) {
+    return {
+      CallExpression(node) {
+        if (!hasDateStaticMemberCall(node, "now")) {
+          return;
+        }
+        context.report({ node, message: MSG_DATE_NOW });
+      }
+    };
+  }
+};
+
+// src/rules/no-date-parse.ts
+var noDateParseRule = {
+  meta: {
+    type: "problem",
+    docs: { description: "Disallow Date.parse()." },
+    schema: []
+  },
+  create(context) {
+    return {
+      CallExpression(node) {
+        if (!hasDateStaticMemberCall(node, "parse")) {
+          return;
+        }
+        context.report({ node, message: MSG_DATE_PARSE });
+      }
+    };
+  }
+};
+
+// src/rules/no-date-utc.ts
+var noDateUtcRule = {
+  meta: {
+    type: "problem",
+    docs: { description: "Disallow Date.UTC()." },
+    schema: []
+  },
+  create(context) {
+    return {
+      CallExpression(node) {
+        if (!hasDateStaticMemberCall(node, "UTC")) {
+          return;
+        }
+        context.report({ node, message: MSG_DATE_UTC });
+      }
+    };
+  }
+};
+
+// src/rules/no-new-date.ts
+var noNewDateRule = {
+  meta: {
+    type: "problem",
+    docs: { description: "Disallow new Date(...)." },
+    schema: []
+  },
+  create(context) {
+    return {
+      NewExpression(node) {
+        if (!isIdentifier(node.callee, "Date")) {
+          return;
+        }
+        context.report({ node, message: MSG_NEW_DATE });
+      }
+    };
+  }
+};
+
+// src/index.ts
+var recommendedRules = {
+  "@northguild/gmt-oxlint/no-date-global": "error",
+  "@northguild/gmt-oxlint/no-new-date": "error",
+  "@northguild/gmt-oxlint/no-date-now": "error",
+  "@northguild/gmt-oxlint/no-date-parse": "error",
+  "@northguild/gmt-oxlint/no-date-utc": "error",
+  "@northguild/gmt-oxlint/no-date-getTimezoneOffset": "error"
+};
+var recommendedConfig = {
+  jsPlugins: ["@northguild/gmt-oxlint"],
+  rules: recommendedRules
+};
+var plugin = {
+  meta: { name: "@northguild/gmt-oxlint" },
+  rules: {
+    "no-date-global": noDateGlobalRule,
+    "no-new-date": noNewDateRule,
+    "no-date-now": noDateNowRule,
+    "no-date-parse": noDateParseRule,
+    "no-date-utc": noDateUtcRule,
+    "no-date-getTimezoneOffset": noDateGetTimezoneOffsetRule
+  },
+  configs: { recommended: { rules: recommendedRules } }
+};
+var index_default = plugin;
+export {
+  index_default as default,
+  recommendedConfig,
+  recommendedRules
+};

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@northguild/gmt-oxlint",
+  "version": "1.1.5",
+  "description": "Oxlint JS plugin for banning Date APIs in Temporal-first projects",
+  "keywords": [
+    "date",
+    "eslint-plugin",
+    "lint",
+    "oxlint",
+    "tanstack-intent",
+    "temporal"
+  ],
+  "homepage": "https://github.com/northguild/gmt#readme",
+  "bugs": {
+    "url": "https://github.com/northguild/gmt/issues"
+  },
+  "license": "MIT",
+  "contributors": [
+    {
+      "name": "Baldur Páll Hólmgeirsson",
+      "url": "https://github.com/baldurpan"
+    },
+    {
+      "name": "Craig O. Curtis",
+      "url": "https://github.com/craig-o-curtis"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/northguild/gmt.git",
+    "directory": "packages/gmt-oxlint"
+  },
+  "files": [
+    "dist",
+    "config",
+    "README.md",
+    "LICENSE",
+    "skills"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./recommended": {
+      "types": "./config/recommended.d.ts",
+      "default": "./config/recommended.json"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@tanstack/intent": "^0.3.6",
+    "oxlint": "^1.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "oxlint": ">=1.0.0"
+  },
+  "oxlint": "./dist/index.js",
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --config vitest.config.ts",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "pack": "npm pack --dry-run",
+    "publish:dry-run": "npm publish --access public --dry-run",
+    "publish:public": "npm publish --access public"
+  }
+}

package/skills/ci-enforcement/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: ci-enforcement
+description: >
+  Enforce @northguild/gmt-oxlint Date-ban rules in CI with staged rollout, clear
+  gmt-oxlint/* diagnostics, and policy alignment with ESLint/Biome where
+  multiple linters are used.
+metadata:
+  library_version: 1.1.2
+---
+
+# CI Enforcement
+
+Use this skill when enabling Oxlint-based Date policy checks in CI.
+
+## CI rollout
+
+1. Add Oxlint lint step
+- Ensure pull requests run Oxlint with gmt-oxlint plugin rules enabled.
+
+2. Stage adoption for large repos
+- Start with changed files or specific paths if baseline debt is high.
+- Expand to full repository enforcement once baseline is controlled.
+
+3. Keep diagnostics actionable
+- Ensure CI output clearly reports `@northguild/gmt-oxlint/*` rule failures and paths.
+
+4. Align multi-linter policy
+- If ESLint/Biome are also enabled, keep Date-ban expectations consistent.
+
+## Recommended sequence
+
+1. Local baseline run.
+2. PR enforcement.
+3. Main branch full coverage.
+4. Ongoing remediation through gmt-guided refactor suggestions.
+
+## Guardrails
+
+- Do not rely on broad suppression as default.
+- Do not auto-apply risky time/date changes without tests.
+- Preserve developer velocity with phased rollout where needed.

package/skills/first-time-setup/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: first-time-setup
+description: >
+  Install and configure @northguild/gmt-oxlint with the simplest consumer DX,
+  prefer oxlint.config.ts + recommendedConfig import, and verify gmt-oxlint
+  diagnostics while preserving current repository lint behavior.
+metadata:
+  library_version: 1.1.2
+---
+
+# First-Time Setup
+
+Use this skill when a user wants to adopt `@northguild/gmt-oxlint`.
+
+## Setup flow
+
+1. Install dependencies
+- Install `@northguild/gmt-oxlint` and `oxlint` as dev dependencies.
+
+2. Configure Oxlint (prefer TypeScript config for best DX)
+- Prefer `oxlint.config.ts` with:
+  - `import { defineConfig } from "oxlint"`
+  - `import { recommendedConfig } from "@northguild/gmt-oxlint"`
+  - `export default defineConfig(recommendedConfig)`
+- If using `.oxlintrc.json`, add `@northguild/gmt-oxlint` to `jsPlugins` and use path-based extends:
+  - `extends: ["./node_modules/@northguild/gmt-oxlint/config/recommended.json"]`
+- Do not use named shared config specifiers in JSON `extends` (for example `@northguild/gmt-oxlint/recommended`); Oxlint currently resolves `extends` as file paths.
+- Keep unrelated existing rules unless the user requests consolidation.
+
+3. Verify enforcement
+- Run Oxlint and confirm Date API bans are reported.
+- Confirm rule IDs are emitted as `@northguild/gmt-oxlint/*`.
+
+4. Optional aliasing
+- If the user wants shorter rule IDs, use object-form `jsPlugins` with `name` alias and configure rules under that alias.
+- Keep the default package-name namespace unless a shorter alias is explicitly requested.
+
+5. Suggest companion packages
+- If `@northguild/gmt` is missing, suggest installing it for safe Date-to-Temporal refactors.
+- If ESLint or Biome are already used, optionally suggest matching gmt lint packages for policy consistency.
+
+## Guardrails
+
+- Keep setup additive and low-risk.
+- Avoid broad config rewrites.
+- Respect that developers may use one linter package or combine multiple.

package/skills/migration-refactor/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: migration-refactor
+description: >
+  Resolve @northguild/gmt-oxlint Date-rule violations by preferring existing gmt
+  helpers, preserving behavior, and guiding the Temporal custom-method path when
+  gmt does not yet provide a needed helper.
+metadata:
+  library_version: 1.1.2
+---
+
+# Migration Refactor
+
+Use this skill when Oxlint reports Date API violations and the user asks for fixes.
+
+## Refactor policy
+
+1. Prefer existing gmt helpers
+- Replace Date APIs with available `@northguild/gmt` methods first.
+
+2. Preserve behavior
+- Keep output format, timezone intent, and edge-case semantics stable.
+- Avoid risky broad rewrites if focused edits are sufficient.
+
+3. If helper is missing
+- Explain the behavior is possible through Temporal (shipped by gmt).
+- Clarify this requires a new custom gmt method.
+- Recommend opening a GitHub issue with examples and expected behavior.
+- If implemented now, include robust tests and suggest opening a PR.
+
+## Common replacement direction
+
+- `Date` global usage -> explicit gmt get/convert/parse flows.
+- `new Date(...)` -> gmt plain/zoned parsing + conversion where available.
+- `Date.now()` -> `getUnixNow(...)` or `getNow()` based on expected shape.
+- `Date.parse(...)` -> gmt conversion helper where available.
+- `Date.UTC(...)` -> gmt UTC conversion helper where available.
+- `getTimezoneOffset()` usage -> timezone-aware gmt zoned helpers.
+
+## Validation
+
+- Re-run Oxlint and related tests.
+- Verify invalid-input fallback behavior remains compliant.