@omnimod/plugin-moment-to-dayjs 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 salnika
+
+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,26 @@
+# @omnimod/plugin-moment-to-dayjs
+
+[![npm](https://img.shields.io/npm/v/%40omnimod%2Fplugin-moment-to-dayjs?label=npm)](https://www.npmjs.com/package/@omnimod/plugin-moment-to-dayjs)
+[![CI](https://img.shields.io/github/actions/workflow/status/Salnika/omnimod/ci.yml?branch=master&label=ci)](https://github.com/Salnika/omnimod/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/Salnika/omnimod)](../../LICENSE)
+
+omnimod plugin that migrates Moment.js imports and call sites to Day.js.
+
+## Use With The CLI
+
+```bash
+omnimod run moment-to-dayjs "src/**/*.{ts,tsx,js,jsx}"
+omnimod run moment-to-dayjs "src/**/*.{ts,tsx,js,jsx}" --write
+```
+
+## Use As A Library
+
+```ts
+import { momentToDayjs } from "@omnimod/plugin-moment-to-dayjs";
+```
+
+## Notes
+
+The plugin rewrites the default Moment binding and compatible call sites. APIs
+that require Day.js plugins, such as duration or relative-time helpers, are
+reported for follow-up.

package/dist/index.d.mts

@@ -0,0 +1,13 @@
+//#region src/plugin.d.ts
+type MomentToDayjsOptions = Record<string, unknown>;
+/**
+ * Migrate Moment.js to Day.js. Rewrites the `moment` import to `dayjs`, renames
+ * the default binding (and all its call sites) to `dayjs`, and rewrites type-only
+ * `{ Moment }` imports to `{ Dayjs }`. Chained methods are API-mirrored by Day.js,
+ * so once the base identifier is renamed they carry over unchanged. APIs that
+ * Day.js only exposes through a plugin (`utc`, `duration`, `.fromNow()`, …) are
+ * flagged with a diagnostic and a `// TODO(omnimod)` comment naming the plugin.
+ */
+declare const momentToDayjs: import("@omnimod/core").Plugin<MomentToDayjsOptions, unknown>;
+//#endregion
+export { type MomentToDayjsOptions, momentToDayjs as default, momentToDayjs };

package/dist/index.mjs

@@ -0,0 +1,139 @@
+import { definePlugin, walk } from "@omnimod/core";
+import { cast } from "@omnimod/plugin-utils";
+//#region src/plugin.ts
+/** Static `moment.<name>()` helpers that Day.js only exposes via a plugin. */
+const STATIC_PLUGIN_APIS = {
+	utc: "the `utc` plugin (`import utc from \"dayjs/plugin/utc\"; dayjs.extend(utc)`)",
+	duration: "the `duration` plugin (`import duration from \"dayjs/plugin/duration\"; dayjs.extend(duration)`)",
+	locale: "explicit locale loading (`import \"dayjs/locale/<name>\"; dayjs.locale(\"<name>\")`)",
+	tz: "the `timezone` plugin (`import timezone from \"dayjs/plugin/timezone\"; dayjs.extend(timezone)`)"
+};
+/** Instance methods (`moment().<name>()`) that Day.js only exposes via a plugin. */
+const INSTANCE_PLUGIN_APIS = {
+	fromNow: "the `relativeTime` plugin (`import relativeTime from \"dayjs/plugin/relativeTime\"; dayjs.extend(relativeTime)`)",
+	from: "the `relativeTime` plugin (`import relativeTime from \"dayjs/plugin/relativeTime\"; dayjs.extend(relativeTime)`)",
+	to: "the `relativeTime` plugin (`import relativeTime from \"dayjs/plugin/relativeTime\"; dayjs.extend(relativeTime)`)",
+	calendar: "the `calendar` plugin (`import calendar from \"dayjs/plugin/calendar\"; dayjs.extend(calendar)`)",
+	isBetween: "the `isBetween` plugin (`import isBetween from \"dayjs/plugin/isBetween\"; dayjs.extend(isBetween)`)"
+};
+/**
+* Migrate Moment.js to Day.js. Rewrites the `moment` import to `dayjs`, renames
+* the default binding (and all its call sites) to `dayjs`, and rewrites type-only
+* `{ Moment }` imports to `{ Dayjs }`. Chained methods are API-mirrored by Day.js,
+* so once the base identifier is renamed they carry over unchanged. APIs that
+* Day.js only exposes through a plugin (`utc`, `duration`, `.fromNow()`, …) are
+* flagged with a diagnostic and a `// TODO(omnimod)` comment naming the plugin.
+*/
+const momentToDayjs = definePlugin({
+	name: "moment-to-dayjs",
+	description: "Migrate Moment.js to Day.js.",
+	include: ["**/*.{ts,tsx,js,jsx,mts,cts}"],
+	transform(file) {
+		const momentImport = findMomentImport(file.program);
+		if (!momentImport) return;
+		const { node, defaultLocal } = momentImport;
+		file.magic.update(momentImport.source.start, momentImport.source.end, "\"dayjs\"");
+		for (const spec of node.specifiers) {
+			if (spec.type !== "ImportSpecifier") continue;
+			const named = cast(spec);
+			const imported = named.imported;
+			if (imported.type !== "Identifier") continue;
+			if (cast(imported).name === "Moment") {
+				file.magic.update(imported.start, imported.end, "Dayjs");
+				if (named.local.name === "Moment" && named.local.start === imported.start) renameTypeReferences(file, node, "Moment", "Dayjs");
+			}
+		}
+		if (defaultLocal === "moment") {
+			for (const spec of node.specifiers) {
+				if (spec.type !== "ImportDefaultSpecifier") continue;
+				const local = cast(spec).local;
+				file.magic.update(local.start, local.end, "dayjs");
+			}
+			renameValueReferences(file, node, "moment", "dayjs");
+		}
+		if (defaultLocal) reportPluginApis(file, defaultLocal, defaultLocal === "moment" ? "dayjs" : defaultLocal, momentImport);
+	}
+});
+/** Find the `import … from "moment"` declaration, capturing its default local. */
+function findMomentImport(program) {
+	const body = program.body ?? [];
+	for (const stmt of body) {
+		if (stmt.type !== "ImportDeclaration") continue;
+		const imp = cast(stmt);
+		if (imp.source.value !== "moment") continue;
+		let defaultLocal = null;
+		for (const spec of imp.specifiers) if (spec.type === "ImportDefaultSpecifier") defaultLocal = cast(spec).local.name;
+		return {
+			node: imp,
+			defaultLocal,
+			source: {
+				start: imp.source.start,
+				end: imp.source.end
+			}
+		};
+	}
+	return null;
+}
+/** True when `node`'s span lies inside the import declaration (skip those). */
+function insideImport(importNode, node) {
+	return node.start >= importNode.start && node.end <= importNode.end;
+}
+/** Rewrite value-position `Identifier`/`JSXIdentifier` references from → to. */
+function renameValueReferences(file, importNode, from, to) {
+	walk(file.program, (node) => {
+		if (node.type !== "Identifier" && node.type !== "JSXIdentifier") return;
+		if (insideImport(importNode, node)) return;
+		if (cast(node).name !== from) return;
+		file.magic.update(node.start, node.end, to);
+	});
+}
+/** Rewrite type-position `Identifier` references (e.g. `Moment` annotations). */
+function renameTypeReferences(file, importNode, from, to) {
+	walk(file.program, (node) => {
+		if (node.type !== "Identifier") return;
+		if (insideImport(importNode, node)) return;
+		if (cast(node).name !== from) return;
+		file.magic.update(node.start, node.end, to);
+	});
+}
+/**
+* Report (once each) any plugin-only Moment API used on the local binding.
+* `origLocal` matches the untouched AST; `renamedBase` is what the code now reads.
+*/
+function reportPluginApis(file, origLocal, renamedBase, momentImport) {
+	const seenStatic = /* @__PURE__ */ new Set();
+	const seenInstance = /* @__PURE__ */ new Set();
+	walk(file.program, (node) => {
+		if (node.type !== "MemberExpression") return;
+		const member = cast(node);
+		if (member.computed || member.property.type !== "Identifier") return;
+		const prop = cast(member.property).name;
+		if (member.object.type === "Identifier" && cast(member.object).name === origLocal && prop in STATIC_PLUGIN_APIS && !insideImport(momentImport.node, node)) {
+			if (!seenStatic.has(prop)) {
+				seenStatic.add(prop);
+				emitTodo(file, node, `\`${renamedBase}.${prop}()\``, STATIC_PLUGIN_APIS[prop]);
+			}
+			return;
+		}
+		if (prop in INSTANCE_PLUGIN_APIS && !seenInstance.has(prop)) {
+			seenInstance.add(prop);
+			emitTodo(file, node, `\`.${prop}()\``, INSTANCE_PLUGIN_APIS[prop]);
+		}
+	});
+}
+/** Report a diagnostic and prepend a `// TODO(omnimod)` line above the statement. */
+function emitTodo(file, node, label, requirement) {
+	const message = `${label} needs ${requirement} in Day.js.`;
+	file.report({
+		message,
+		severity: "warn"
+	});
+	const lineStart = statementLineStart(file.source, node.start);
+	file.magic.appendLeft(lineStart, `// TODO(omnimod): ${label} — add ${requirement}\n`);
+}
+/** Offset of the start of the source line containing `offset`. */
+function statementLineStart(source, offset) {
+	return source.lastIndexOf("\n", offset - 1) + 1;
+}
+//#endregion
+export { momentToDayjs as default, momentToDayjs };

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@omnimod/plugin-moment-to-dayjs",
+  "version": "0.1.0",
+  "description": "omnimod plugin: migrate Moment.js to Day.js.",
+  "keywords": [
+    "codemod",
+    "dayjs",
+    "migration",
+    "moment",
+    "omnimod-plugin"
+  ],
+  "homepage": "https://salnika.github.io/omnimod/",
+  "bugs": "https://github.com/salnika/omnimod/issues",
+  "license": "MIT",
+  "author": "salnika",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/salnika/omnimod.git",
+    "directory": "packages/plugin-moment-to-dayjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@omnimod/core": "0.1.0",
+    "@omnimod/plugin-utils": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "@typescript/native-preview": "7.0.0-dev.20260509.2",
+    "typescript": "^6.0.3",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.2",
+    "vite-plus": "0.2.2"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
+  }
+}