feat: add schematic to migrate @ngneat to @openng

package.json

@@ -11,22 +11,24 @@
     "yarn": ">= 1.22.0"
   },
   "scripts": {
+    "init": "yarn install",
     "prepare": "husky install",
     "ng": "ng",
-    "build": "ng build --configuration production && yarn build:schematics && yarn copy:schematics && yarn copy:docs",
-    "build:schematics": "tsc -p projects/spectator/schematics/tsconfig.json",
+    "build": "ng build --configuration production && yarn build:schematics && yarn copy:docs",
+    "build:schematics": "node projects/spectator/build-schematics.js",
+    "pack": "cd dist/spectator && npm pack && bash -c 'mv openng-spectator-*.tgz ../../'",
     "test": "ng test",
     "test:jest": "ng run spectator:test-jest",
     "test:vitest": "ng run spectator:test-vitest",
     "test:types": "tsc -p type-tests/jasmine && tsc -p type-tests/jest && tsc -p type-tests/vitest",
-    "test:ci": "cross-env NODE_ENV=build yarn test && yarn test:jest --silent && yarn test:vitest",
+    "test:schematics": "jest --config projects/spectator/schematics/jest.config.js",
+    "test:ci": "cross-env NODE_ENV=build yarn test && yarn test:jest --silent && yarn test:vitest && yarn test:schematics",
     "lint": "ng lint",
     "format": "prettier --write \"{projects,src}/**/*.ts\"",
     "commit": "git-cz",
     "contributors:add": "all-contributors add",
     "contributors:generate": "all-contributors generate",
     "copy:docs": "cp *.md dist/spectator",
-    "copy:schematics": "cp -r projects/spectator/schematics/src/ dist/spectator/schematics",
     "postbump": "yarn build",
     "release": "cd projects/spectator && standard-version --infile ../../CHANGELOG.md",
     "release:dry": "cd projects/spectator && standard-version --infile ../../CHANGELOG.md --dry-run"
@@ -52,10 +54,10 @@
     "@angular/platform-browser-dynamic": "^22.0.5",
     "@angular/router": "22.0.5",
     "@commitlint/cli": "17.3.0",
-    "@emnapi/core": "^1.7.1",
-    "@emnapi/runtime": "^1.7.1",
     "@commitlint/config-angular": "17.3.0",
     "@commitlint/config-conventional": "17.3.0",
+    "@emnapi/core": "^1.7.1",
+    "@emnapi/runtime": "^1.7.1",
     "@types/jasmine": "5.1.4",
     "@types/jest": "30.0.0",
     "@types/node": "^26.1.0",
@@ -66,6 +68,8 @@
     "core-js": "^3.9.1",
     "cross-env": "^5.1.4",
     "cz-conventional-changelog": "^3.3.0",
+    "esbuild": "^0.28.1",
+    "esbuild-plugin-tsc": "^0.6.0",
     "eslint": "^9.28.0",
     "git-cz": "^4.7.6",
     "helpful-decorators": "^2.1.0",

projects/spectator/build-schematics.js

@@ -0,0 +1,61 @@
+import { build } from 'esbuild';
+import esbuildPluginTsc from 'esbuild-plugin-tsc';
+import { glob } from 'fs/promises';
+import { rmSync } from 'fs';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const distPath = '../../dist/spectator/schematics';
+
+const schematics = build({
+  absWorkingDir: __dirname,
+  bundle: false,
+  entryPoints: ['schematics/src/**'],
+  format: 'esm',
+  loader: {
+    '.json': 'copy',
+    '.template': 'copy',
+    '.md': 'empty',
+  },
+  minify: false,
+  outdir: resolve(__dirname, distPath),
+  packages: 'external',
+  platform: 'node',
+  plugins: [
+    esbuildPluginTsc({
+      force: true,
+      tsconfigPath: resolve(__dirname, './schematics/tsconfig.json'),
+    }),
+  ],
+  target: 'node22',
+  treeShaking: false,
+});
+
+/**
+ * Remove files/directories from dist/schematics using glob patterns.
+ *
+ * @param patterns - Glob pattern(s) relative to dist/schematics
+ */
+async function removeFromDistSchematics(patterns) {
+  const targetDir = resolve(__dirname, distPath);
+  const list = Array.isArray(patterns) ? patterns : [patterns];
+
+  for (const pattern of list) {
+    const globResults = await Array.fromAsync(glob(pattern, { cwd: targetDir }));
+    for (const match of globResults) {
+      const fullPath = resolve(targetDir, match);
+      rmSync(fullPath, { recursive: true, force: true });
+    }
+  }
+}
+
+schematics
+  .then(async () => {
+    // Remove unwanted artifact form the build
+    await removeFromDistSchematics(['*.config.js', '**/*.spec.js', '__mocks__', "**/*.md"]);
+  })
+  .catch((e) => {
+    console.error(e);
+    process.exit(1);
+  });

projects/spectator/schematics/__mocks__/ora.js

@@ -0,0 +1,18 @@
+// Mock for ora (ESM-only) package
+// ora returns an object with start/stop/succeed/fail methods
+const createMockSpinner = () => ({
+  start: (text) => createMockSpinner(),
+  stop: () => createMockSpinner(),
+  succeed: (text) => createMockSpinner(),
+  fail: (text) => createMockSpinner(),
+  warn: (text) => createMockSpinner(),
+  info: (text) => createMockSpinner(),
+  clear: () => createMockSpinner(),
+  render: () => createMockSpinner(),
+  color: 'cyan',
+  prefixText: '',
+  text: '',
+});
+
+module.exports = createMockSpinner;
+module.exports.default = createMockSpinner;

projects/spectator/schematics/jest.config.js

@@ -0,0 +1,19 @@
+module.exports = {
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src'],
+  testMatch: ['**/*.spec.ts'],
+  testPathIgnorePatterns: ['/files/'],
+  transform: {
+    '^.+\\.ts$': [
+      'ts-jest',
+      {
+        tsconfig: '<rootDir>/tsconfig.spec.json',
+      },
+    ],
+  },
+  moduleNameMapper: {
+    '^ora$': '<rootDir>/__mocks__/ora.js',
+  },
+  moduleFileExtensions: ['ts', 'js'],
+  collectCoverageFrom: ['src/**/*.ts', '!src/**/*.spec.ts', '!src/**/files/**/*'],
+};

projects/spectator/schematics/src/collection.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "./node_modules/@angular-devkit/schematics/collection-schema.json",
+  "$schema": "../../../../node_modules/@angular-devkit/schematics/collection-schema.json",
   "extends": ["@schematics/angular"],
   "schematics": {
     "spectator-component": {
@@ -25,6 +25,12 @@
       "factory": "./spectator/index#spectatorPipeSchematic",
       "schema": "./spectator/pipe-schema.json",
       "aliases": ["ps"]
+    },
+    "ngneat-to-openng": {
+      "description": "Convert @ngneat/spectator to @openng/spectator",
+      "factory": "./ngneat-to-openng/index#migrate",
+      "schema": "./ngneat-to-openng/schema.json",
+      "aliases": ["nto"]
     }
   }
 }

projects/spectator/schematics/src/ngneat-to-openng/README.md

@@ -0,0 +1,25 @@
+# ngneat to openng migration
+
+Converts all imports of `@ngneat/spectator` to `@openng/spectator` across your project.
+
+This migration scans every TypeScript file in your project (excluding `node_modules` and `dist` directories) and updates any import or export declarations that reference `@ngneat/spectator` to instead reference `@openng/spectator`. Named imports remain intact — only the module specifier path changes.
+
+## What does this migration do?
+
+- Finds all TypeScript files (`.ts`) in your project
+- Skips files inside `node_modules` and `dist` directories
+- Replaces `from '@ngneat/spectator/<testRunner>'` with `from '@openng/spectator/<testRunner>'` in import and export declarations
+- Preserves all named imports (e.g., `createComponentFactory`, `Spectator`, etc.)
+- Remove `@ngneat/spectator` for the `package.json`
+
+## How to run this migration?
+
+```bash
+ng generate @openng/spectator:ngneat-to-openng
+```
+
+Or using the alias:
+
+```bash
+ng g @openng/spectator:nto
+```