@northguild/gmt-oxlint 1.2.1 → 1.2.2

package/dist/index.js

@@ -4,8 +4,22 @@ var MSG_NEW_DATE = "Avoid new Date(). Use @northguild/gmt getUtcNow(), getNow(),
 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.1",
-  "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"
   ],

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

@@ -31,7 +31,7 @@ Use this skill when a user wants to adopt `@northguild/gmt-oxlint`.
 - 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` and `spacetime` imports.
+  `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.
 

package/skills/migration-refactor/SKILL.md

@@ -36,10 +36,10 @@ Use this skill when Oxlint reports Date API violations and the user asks for fix
 - `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`, `spacetime`, including subpaths, `require()` and dynamic `import()`) ->
-  replace the call sites with gmt equivalents, 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.
+  `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.