@northguild/gmt-oxlint 1.2.0 → 1.2.2

package/README.md

@@ -121,11 +121,11 @@ Array form also supported:
 
 | Pattern                    | Rule                        | Suggestion                                                                                                            |
 | -------------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------- |
-| `Date` global reference    | `no-date-global`            | Use `getNow()`, `getUnixNow('milliseconds' or 'seconds')`, `getUtcNow()`, or `getZonedNow(timezone)`                  |
+| `Date` global reference    | `no-date-global`            | Use `getNow()`, `getUnixNow({ epochUnit: '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.now()`               | `no-date-now`               | Use `getUnixNow({ epochUnit: '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.UTC(...)`            | `no-date-utc`               | Use `convertUtcToUnix('YYYY-MM-DDTHH:mm:ssZ', { epochUnit: 'milliseconds' or 'seconds' })`                            |
 | `date.getTimezoneOffset()` | `no-date-getTimezoneOffset` | Use `getZonedNow(timezone)`, other gmt zoned helpers such as `convertZonedToUnix(value)`, or `Temporal.ZonedDateTime` |
 
 > **`@js-joda/core` is deliberately allowed.** It has its own value types and touches

package/dist/index.js

@@ -1,11 +1,25 @@
 // src/messages.ts
-var MSG_DATE_GLOBAL = "Avoid Date. Use @northguild/gmt getNow(), getUnixNow('milliseconds' | 'seconds'), getUtcNow(), or getZonedNow(timezone) instead.";
+var MSG_DATE_GLOBAL = "Avoid Date. Use @northguild/gmt getNow(), getUnixNow({ epochUnit: '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_NOW = "Avoid Date.now(). Use @northguild/gmt getUnixNow({ epochUnit: 'milliseconds' | 'seconds' }) or getNow() instead.";
+var MSG_DATE_UTC = "Avoid Date.UTC(). Use @northguild/gmt convertUtcToUnix('YYYY-MM-DDTHH:mm:ssZ', { epochUnit: '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.";
-var MSG_DATE_LIBRARY_IMPORT = "Avoid date libraries that wrap native Date (moment, dayjs, luxon, date-fns, spacetime). Use @northguild/gmt instead.";
+var MSG_GET_TIMEZONE_OFFSET = "Avoid date.getTimezoneOffset(). Timezone offsets change throughout the year, so use @northguild/gmt getTimeZoneOffset(timeZone, instant) instead.";
+var MIGRATE_URL = "https://northguild.dev/gmt/migrate/";
+var guideFor = (name, slug) => `${MIGRATE_URL}${slug}/ maps ${name} calls to their gmt replacements.`;
+var MOMENT_GUIDE = guideFor("Moment.js", "moment");
+var DATE_FNS_GUIDE = guideFor("date-fns", "date-fns");
+var DATE_LIBRARY_GUIDES = {
+  moment: MOMENT_GUIDE,
+  "moment-timezone": MOMENT_GUIDE,
+  dayjs: guideFor("Day.js", "dayjs"),
+  luxon: guideFor("Luxon", "luxon"),
+  "date-fns": DATE_FNS_GUIDE,
+  "date-fns-tz": DATE_FNS_GUIDE,
+  "@date-fns/tz": DATE_FNS_GUIDE,
+  spacetime: `${MIGRATE_URL} lists the migration guides.`
+};
+var dateLibraryImportMessage = (lib) => `Avoid ${lib}: it wraps native Date. Use @northguild/gmt instead; ${DATE_LIBRARY_GUIDES[lib]}`;
 
 // src/utils/isChainExpression.ts
 function isChainExpression(node) {
@@ -45,7 +59,7 @@ function hasDateStaticMemberCall(node, memberName) {
   return isIdentifier(callee.object, "Date") && isIdentifier(callee.property, memberName);
 }
 
-// src/utils/isBannedDateLibrary.ts
+// src/utils/bannedDateLibrary.ts
 var BANNED_DATE_LIBRARIES = [
   "moment",
   "moment-timezone",
@@ -53,13 +67,14 @@ var BANNED_DATE_LIBRARIES = [
   "luxon",
   "date-fns",
   "date-fns-tz",
+  "@date-fns/tz",
   "spacetime"
 ];
-var isBannedDateLibrary = (specifier) => {
+var bannedDateLibraryOf = (specifier) => {
   if (typeof specifier !== "string") {
-    return false;
+    return void 0;
   }
-  return BANNED_DATE_LIBRARIES.some(
+  return BANNED_DATE_LIBRARIES.find(
     (lib) => specifier === lib || specifier.startsWith(`${lib}/`)
   );
 };
@@ -126,10 +141,11 @@ var noDateGlobalRule = {
 
 // src/rules/no-date-library-imports.ts
 var reportIfBanned = (context, source) => {
-  if (!source || !isBannedDateLibrary(source.value)) {
+  const lib = bannedDateLibraryOf(source?.value);
+  if (!source || lib === void 0) {
     return;
   }
-  context.report({ node: source, message: MSG_DATE_LIBRARY_IMPORT });
+  context.report({ node: source, message: dateLibraryImportMessage(lib) });
 };
 var noDateLibraryImportsRule = {
   meta: {

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@northguild/gmt-oxlint",
-  "version": "1.2.0",
-  "description": "Oxlint JS plugin for banning Date APIs in Temporal-first projects",
+  "version": "1.2.2",
+  "description": "Oxlint plugin that bans the JavaScript Date object and Date-based libraries, and names the Temporal-based @northguild/gmt function to use instead.",
   "keywords": [
     "date",
     "eslint-plugin",
+    "eslintplugin",
     "lint",
+    "no-date",
     "oxlint",
+    "oxlint-plugin",
     "tanstack-intent",
     "temporal"
   ],
@@ -55,7 +58,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@tanstack/intent": "^0.3.8",
+    "@tanstack/intent": "^0.4.0",
     "oxlint": "^1.0.0",
     "tsup": "^8.5.0",
     "typescript": "^5.0.0"

package/skills/ci-enforcement/SKILL.md

@@ -5,7 +5,7 @@ description: >
   gmt-oxlint/* diagnostics, and policy alignment with ESLint/Biome where
   multiple linters are used.
 metadata:
-  library_version: 1.1.2
+  library_version: 1.2.0
 ---
 
 # CI Enforcement
@@ -19,6 +19,9 @@ Use this skill when enabling Oxlint-based Date policy checks in CI.
 
 2. Stage adoption for large repos
 - Start with changed files or specific paths if baseline debt is high.
+- `no-date-library-imports` usually carries the largest baseline (every `moment` / `dayjs` /
+  `luxon` / `date-fns` / `spacetime` import). It is safe to run it as `"warn"` for existing
+  paths while keeping it `"error"` for new ones, then tighten as imports are migrated.
 - Expand to full repository enforcement once baseline is controlled.
 
 3. Keep diagnostics actionable

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

@@ -5,7 +5,7 @@ description: >
   prefer oxlint.config.ts + recommendedConfig import, and verify gmt-oxlint
   diagnostics while preserving current repository lint behavior.
 metadata:
-  library_version: 1.1.2
+  library_version: 1.2.0
 ---
 
 # First-Time Setup
@@ -30,6 +30,10 @@ Use this skill when a user wants to adopt `@northguild/gmt-oxlint`.
 3. Verify enforcement
 - Run Oxlint and confirm Date API bans are reported.
 - Confirm rule IDs are emitted as `@northguild/gmt-oxlint/*`.
+- The recommended config also enables `no-date-library-imports`, which errors on `moment`,
+  `moment-timezone`, `dayjs`, `luxon`, `date-fns`, `date-fns-tz`, `@date-fns/tz` and `spacetime` imports.
+  In a codebase that still uses them, warn the user before enabling it, or stage it (see
+  the CI enforcement skill) instead of disabling it.
 
 4. Optional aliasing
 - If the user wants shorter rule IDs, use object-form `jsPlugins` with `name` alias and configure rules under that alias.

package/skills/migration-refactor/SKILL.md

@@ -5,7 +5,7 @@ description: >
   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
+  library_version: 1.2.0
 ---
 
 # Migration Refactor
@@ -35,6 +35,14 @@ Use this skill when Oxlint reports Date API violations and the user asks for fix
 - `Date.parse(...)` -> gmt conversion helper where available.
 - `Date.UTC(...)` -> gmt UTC conversion helper where available.
 - `getTimezoneOffset()` usage -> timezone-aware gmt zoned helpers.
+- `no-date-library-imports` (`moment`, `moment-timezone`, `dayjs`, `luxon`, `date-fns`,
+  `date-fns-tz`, `@date-fns/tz`, `spacetime`, including subpaths, `require()` and dynamic
+  `import()`) -> replace the call sites with gmt equivalents (the message links the migration guide
+  that maps the library's calls), then remove the import. Do not silence it by re-exporting through
+  a local module — `export … from` is flagged too. `@js-joda/core` is intentionally allowed.
+- When porting library arithmetic, keep Temporal's semantics: a non-existent day clamps
+  (`2024-02-29` + 1 year → `2025-02-28`); date-fns `setYear` rolls to 1 March instead, so
+  flag that behaviour change to the user rather than copying it.
 
 ## Validation