feat: initial work to provide schematics

This work is heavily based off of NgRx's schematics. Thank you to their contributors for their amazing work.

Author: crutchcorn

package.json

@@ -8,6 +8,11 @@
     "watch": "ng build --watch --configuration development",
     "test": "ng test"
   },
+  "workspaces": {
+    "packages": [
+      "projects/*"
+    ]
+  },
   "private": true,
   "dependencies": {
     "@angular/animations": "^18.2.0",
@@ -34,6 +39,7 @@
     "@testing-library/user-event": "^14.5.2",
     "@types/jasmine": "~5.1.0",
     "@types/jest": "^29.5.12",
+    "@types/node": "^22.5.4",
     "jasmine-core": "~5.2.0",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",

projects/angular-redux/package.json

@@ -13,13 +13,18 @@
   "peerDependencies": {
     "@angular/common": ">=17.3.0",
     "@angular/core": ">=17.3.0",
-    "redux": "^5.0.0"
+    "redux": "^5.0.0",
+    "@reduxjs/toolkit": "^2.2.7"
   },
   "peerDependenciesMeta": {
     "redux": {
       "optional": true
+    },
+    "@reduxjs/toolkit": {
+      "optional": true
     }
   },
+  "schematics": "./schematics/collection.json",
   "dependencies": {
     "tslib": "^2.3.0"
   },

projects/angular-redux/schematics-core/README.md

@@ -0,0 +1,4 @@
+This code is originally from NgRx:
+
+https://github.com/ngrx/platform/tree/main/modules/schematics-core
+https://github.com/ngrx/platform/tree/main/modules/store/schematics-core

projects/angular-redux/schematics-core/index.ts

@@ -0,0 +1,86 @@
+import {
+  dasherize,
+  decamelize,
+  camelize,
+  classify,
+  underscore,
+  group,
+  capitalize,
+  featurePath,
+  pluralize,
+} from './utility/strings';
+
+export {
+  findNodes,
+  getSourceNodes,
+  getDecoratorMetadata,
+  getContentOfKeyLiteral,
+  insertAfterLastOccurrence,
+  insertImport,
+  addBootstrapToModule,
+  addDeclarationToModule,
+  addExportToModule,
+  addImportToModule,
+  addProviderToComponent,
+  addProviderToModule,
+  replaceImport,
+  containsProperty,
+} from './utility/ast-utils';
+
+export {
+  NoopChange,
+  InsertChange,
+  RemoveChange,
+  ReplaceChange,
+  createReplaceChange,
+  createChangeRecorder,
+  commitChanges
+} from './utility/change';
+export type {
+    Host,
+    Change
+} from './utility/change';
+
+export {getWorkspace, getWorkspacePath} from './utility/config';
+export type { AppConfig } from './utility/config';
+
+export { findComponentFromOptions } from './utility/find-component';
+
+export {
+  findModule,
+  findModuleFromOptions,
+  buildRelativePath
+} from './utility/find-module';
+export type { ModuleOptions } from './utility/find-module';
+
+export { findPropertyInAstObject } from './utility/json-utilts';
+
+export { getProjectPath, getProject, isLib } from './utility/project';
+
+export const stringUtils = {
+  dasherize,
+  decamelize,
+  camelize,
+  classify,
+  underscore,
+  group,
+  capitalize,
+  featurePath,
+  pluralize,
+};
+
+export { updatePackage } from './utility/update';
+
+export { parseName } from './utility/parse-name';
+
+export { addPackageToPackageJson } from './utility/package';
+
+export {
+  visitTSSourceFiles,
+  visitNgModuleImports,
+  visitNgModuleExports,
+  visitComponents,
+  visitDecorator,
+  visitNgModules,
+  visitTemplates,
+} from './utility/visitors';

projects/angular-redux/schematics-core/testing/create-app-module.ts

@@ -0,0 +1,60 @@
+import { UnitTestTree } from '@angular-devkit/schematics/testing';
+
+export function createAppModule(
+  tree: UnitTestTree,
+  path?: string
+): UnitTestTree {
+  tree.create(
+    path || '/src/app/app.module.ts',
+    `
+    import { BrowserModule } from '@angular/platform-browser';
+    import { NgModule } from '@angular/core';
+    import { AppComponent } from './app.component';
+
+    @NgModule({
+    declarations: [
+      AppComponent
+    ],
+    imports: [
+      BrowserModule
+    ],
+    providers: [],
+    bootstrap: [AppComponent]
+    })
+    export class AppModule { }
+  `
+  );
+
+  return tree;
+}
+
+export function createAppModuleWithEffects(
+  tree: UnitTestTree,
+  path: string,
+  effects?: string
+): UnitTestTree {
+  tree.create(
+    path || '/src/app/app.module.ts',
+    `
+    import { BrowserModule } from '@angular/platform-browser';
+    import { NgModule } from '@angular/core';
+    import { AppComponent } from './app.component';
+    import { EffectsModule } from '@ngrx/effects';
+
+    @NgModule({
+      declarations: [
+        AppComponent
+      ],
+      imports: [
+        BrowserModule,
+        ${effects}
+      ],
+      providers: [],
+      bootstrap: [AppComponent]
+    })
+    export class AppModule { }
+  `
+  );
+
+  return tree;
+}

projects/angular-redux/schematics-core/testing/create-package.ts

@@ -0,0 +1,26 @@
+import { Tree } from '@angular-devkit/schematics';
+import {
+  UnitTestTree,
+  SchematicTestRunner,
+} from '@angular-devkit/schematics/testing';
+
+export const packagePath = '/package.json';
+
+export function createPackageJson(
+  prefix: string,
+  pkg: string,
+  tree: UnitTestTree,
+  version = '5.2.0',
+  packagePath = '/package.json'
+) {
+  tree.create(
+    packagePath,
+    `{
+      "dependencies": {
+        "@ngrx/${pkg}": "${prefix}${version}"
+      }
+    }`
+  );
+
+  return tree;
+}

projects/angular-redux/schematics-core/testing/create-reducers.ts

@@ -0,0 +1,34 @@
+import { UnitTestTree } from '@angular-devkit/schematics/testing';
+
+export function createReducers(
+  tree: UnitTestTree,
+  path?: string,
+  project = 'bar'
+) {
+  tree.create(
+    path || `/projects/${project}/src/app/reducers/index.ts`,
+    `
+    import { isDevMode } from '@angular/core';
+    import {
+      ActionReducer,
+      ActionReducerMap,
+      createFeatureSelector,
+      createSelector,
+      MetaReducer
+    } from '@ngrx/${'store'}';
+
+    export interface State {
+
+    }
+
+    export const reducers: ActionReducerMap<State> = {
+
+    };
+
+
+    export const metaReducers: MetaReducer<State>[] = isDevMode() ? [] : [];
+  `
+  );
+
+  return tree;
+}

projects/angular-redux/schematics-core/testing/create-workspace.ts

@@ -0,0 +1,69 @@
+import {
+  SchematicTestRunner,
+  UnitTestTree,
+} from '@angular-devkit/schematics/testing';
+
+export const defaultWorkspaceOptions = {
+  name: 'workspace',
+  newProjectRoot: 'projects',
+  version: '6.0.0',
+};
+
+export const defaultAppOptions = {
+  name: 'bar',
+  inlineStyle: false,
+  inlineTemplate: false,
+  viewEncapsulation: 'Emulated',
+  routing: false,
+  style: 'css',
+  skipTests: false,
+  standalone: false,
+};
+
+const defaultLibOptions = {
+  name: 'baz',
+};
+
+export function getTestProjectPath(
+  workspaceOptions: any = defaultWorkspaceOptions,
+  appOptions: any = defaultAppOptions
+) {
+  return `/${workspaceOptions.newProjectRoot}/${appOptions.name}`;
+}
+
+export async function createWorkspace(
+  schematicRunner: SchematicTestRunner,
+  appTree: UnitTestTree,
+  workspaceOptions = defaultWorkspaceOptions,
+  appOptions = defaultAppOptions,
+  libOptions = defaultLibOptions
+) {
+  appTree = await schematicRunner.runExternalSchematic(
+    '@schematics/angular',
+    'workspace',
+    workspaceOptions
+  );
+
+  appTree = await schematicRunner.runExternalSchematic(
+    '@schematics/angular',
+    'application',
+    appOptions,
+    appTree
+  );
+
+  appTree = await schematicRunner.runExternalSchematic(
+    '@schematics/angular',
+    'application',
+    { ...appOptions, name: 'bar-standalone', standalone: true },
+    appTree
+  );
+
+  appTree = await schematicRunner.runExternalSchematic(
+    '@schematics/angular',
+    'library',
+    libOptions,
+    appTree
+  );
+
+  return appTree;
+}

projects/angular-redux/schematics-core/testing/index.ts

@@ -0,0 +1,3 @@
+export * from './create-app-module';
+export * from './create-reducers';
+export * from './create-workspace';

projects/angular-redux/schematics-core/testing/update.ts

@@ -0,0 +1,2 @@
+export const upgradeVersion = '6.0.0';
+export const versionPrefixes = ['~', '^', ''];