Skip to content

Latest commit

 

History

History
564 lines (405 loc) · 12.6 KB

CHANGELOG.md

File metadata and controls

564 lines (405 loc) · 12.6 KB
Raw

6.0.1

Documentation updates; no code change. Added a 'getting started' tutorial.

6.0.0 - The big-rename.

Due to the impending release of Angular4, the name 'ng2-redux' no longer makes a ton of sense. The Angular folks have moved to a model where all versions are just called 'Angular', and we should match that.

After discussion with the other maintainers, we decided that since we have to rename things anyway, this is a good opportunity to collect ng2-redux and its related libraries into a set of scoped packages. This will allow us to grow the feature set in a coherent but decoupled way.

As of v6, the following packages are deprecated:

  • ng2-redux
  • ng2-redux-router
  • ng2-redux-form

Those packages will still be available on npm for as long as they are being used.

However we have published the same code under a new package naming scheme:

  • @angular-redux/store (formerly ng2-redux)
  • @angular-redux/router (formerly ng2-redux-router)
  • @angular-redux/form (formerly ng2-redux-form).

We have also decided that it's easier to reason about things if these packages align at least on major versions. So everything has at this point been bumped to 6.0.0.

Breaking changes

Apart from the rename, the following API changes are noted:

  • @angular-redux/store: none.
  • @angular-redux/router: none.
  • @angular-redux/form: NgReduxForms renamed to NgReduxFormModule for consistency.

5.1.1

4.2.4

3.3.10

Fixes

Applied fix addressing #309 - select function called even if state does not change.

5.1.0

Features

You can now get an observable to the root state by passing no arguments to ngRedux.select:

private this.rootState$: Observable<IAppState>;

constructor(ngRedux: NgRedux) {
  this.rootState$ = ngRedux.select();
}

Changes

ngRedux.dispatch() has been tweaked to always run in the Angular zone. This should prevent unexpected weirdness when dispatching from callbacks to 3rd-party libraries. See #259 for further discussion.

Misc.

  • Refactored the example app a bit to split out the different selector demos instead of lumping most of them into the counter component.
  • Miscellaneous documentation updates.

5.0.0

  • Fix for the ERROR in NgReduxModule is not an NgModule error thrown by Angular CLI.
  • Remove deprecations.
  • Breaking changes associated with Angular 2.4+.

Breaking Changes

  • Minimum Angular peer dependency is now 2.4.0
  • Removed support for the connect pattern: it's simply not a good fit for Angular. You should be using the select pattern now.
  • Remove deprecated constructor arg for NgRedux.
  • Minimum Angular peer dependency is now 2.4.0
  • NgReduxModule.forRoot is no more. Now just import NgReduxModule directly.

Old Way:

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { NgReduxModule } from 'ng2-redux';

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    NgReduxModule.forRoot(),
    BrowserModule,
  ],
  providers: [],
  bootstrap: [AppComponent]
})
class AppModule {
  // etc.
}

New Way:

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { NgReduxModule } from 'ng2-redux';

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    NgReduxModule,
    BrowserModule,
  ],
  providers: [],
  bootstrap: [AppComponent]
})
class AppModule {
  // etc.
}

4.2.4

Recovery release that restores the functionality of 4.2.2. Use this release if you're on Angular < 2.2. If your on Angular >= 2.3, you'll need to use [email protected] (see v5.x branch for the changelog) to consume the fix for #282 (due to a breaking change in Angular).

4.2.1, 4.2.3

Botched releases - don't use. Apologies; I've added a prepublish script to npm to prevent this from happening again.

4.2.1

Fixes:

  • #281 (DevToolsExtension missing from providers list)

4.2.0

Fixes:

  • #221 (type error with redux-thunk)

4.1.0

Fixes:

  • #228 ('generic' error with AoT)
  • #251 (No provider for DevToolsExtension)

4.0.0

Features

  • Better support for Angular CLI
  • NgModule interface changes to better support Angular 2's ahead-of-time compiler (AoT)

Fixes

  • Update build to use ngc - metadata.json is now produced
  • Introduced NgReduxModule
  • Fix AoT related bugs #247, #235, #228

Breaking Change: Using NgReduxModule

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';
import { NgReduxModule, NgRedux } from 'ng2-redux';
import { IAppState } from './appstate';
import { rootReducer } from './store';

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    NgReduxModule,
    BrowserModule,
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule {
  constructor(ngRedux: NgRedux<IAppState>) {

    ngRedux.configureStore(rootReducer,{});
  }
}

before

import { select } from 'ng2-redux';
export class MyComponent {
  @select() thing$:Observable<string>;
}

after

import { NgRedux } from 'ng2-redux';
export class MyComponent {
  thing$: Observable<string>;
  constructor(private ngRedux:NgRedux<MyAppState>) {

  }
  ngOnInit() {
    this.thing$ = this.ngRedux.select (n => n.thing);
  }
}

3.3.9

Fixes

  • Temp update to npm build to uninstall typings for chai/sinon-chai so /// <reference types="chai" /> doesn't get added to files.

3.3.8

Fixes

  • Manual fix of build to remove chai type reference

3.3.7

Features

  • Improved error if trying to dispatch before store is configured - #118, #198

Fixes

  • Relax Zone JS version - #189, #187
  • Fix DevTools being out of sync for actions dispatched from tool, #192

Chores/Misc

  • Upgrade to TypeScript 2 - #189, #190
  • Add Code Coverage - #193, #206, #207

3.3.5

Fixes

  • Update redux peer dependency to 3.5.0
    • observable shim which we depend on was introduced in 3.5.0, not 3.4.0

3.3.4

Chore

  • Update to RC5 (#184, fixes #183)
  • Include src in npm package (#182, fixes #180)

Fixes

  • Fix window in Universal (#185, fixes #172)

3.3.3

Fixes

  • Fix window is undefined in Universal (#178, fixes #172)

3.3.2

Fixes

  • Change seamless immutable integration to not need conditional require (#169)

3.3.1

Fixes

  • Argument to DevTools enhancer is now optional (#164)
  • Decorator deletes key on target, not this. (#168, fixes #166)

3.3.0

Features

Fixes

  • Able to use @select in services
  • Behavior of select with chained dispatches, (fixes #149, #153)

3.2.0

Features

  • Added a provideStore() function which lets you pass in a already created store. It can be used as this:

Create your store:

// store.ts

import {
  applyMiddleware,
  Store,
  combineReducers,
  compose,
  createStore
} from 'redux';
import thunk from 'redux-thunk';
import reduxLogger from 'redux-logger';

import { myReducer } from './reducers/my-reducer';

const rootReducer = combineReducers({
  myReducer,
});

export const store = createStore(
  rootReducer,
  compose(
    applyMiddleware(
      thunk,
      reduxLogger
    )
  )
) as Store

Create your App and call provideStore with your newly created store:

// app.ts

import { NgRedux } from 'ng2-redux';
import { store } from './store.ts';

interface IAppState {
  // ...
};
@Component({
  // ... etc.
})
class App {
  constructor(private ngRedux: NgRedux) {
    this.ngRedux.provideStore(store);
  }

  // ...
}

3.1.0

Features

  • Added a 'path' option to ngRedux.select() and @select(). Now you can do stuff like @select(['foo', 'bar']) to select state.foo.bar into an observable.

  • Add ability to provide custom comparer to @select decorator to keep consistent with ngRedux.select

import { is } from 'immutablejs'

export class SomeComponent {
  @select(n=n.some.selector, is) someSelector$: Observable<any>
}

Features

3.0.8

Fix

  • AppliicationRef is optional dependency, fixes#127

3.0.0

Features

Select Decorator

This release introduces the new decorator interface. You can now use @select to create an observable from a slice of store state.

See 'the select pattern' in README.md for a complete description of how to use this new decorator.

Simpler Redux DevTools Integration

You no longer need to manually subscribe and ApplicationRef.tick() for Redux DevTools to work; we do this automatically for you.

Breaking Changes

Bootstrapping

We've changed how bootstrapping ng2-redux works. The provider function has gone away in favour of making NgRedux a first-class @Injectable.

You now configure your store in the constructor of your top-level app component instead of prior to bootstrapping. This allows the store to be configured with middleware and enhancers that rely on Angular 2 services, which previously was unnecessarily difficult.

Old way:

bootstrap.ts:

import { bootstrap } from '@angular/platform-browser-dynamic';
import { createStore, applyMiddleware, compose } from 'redux';
import { NgRedux } from 'ng2-redux';
const createLogger = require('redux-logger');
const persistState = require('redux-localstorage');
import { rootReducer } from './reducers';
import { App } from './app';

// Confusing and hard to use with dependency injection.
const middleware = [ createLogger() ];
const enhancers = [ persistState('counter', { key: 'example-app' }) ];
const store = compose(
  applyMiddleware(middleware),
  ...enhancers)
    (createStore)(rootReducer);

bootstrap(App, [ provide(store) ])

app.ts

import { Component } from '@angular/core';
import { NgRedux } from 'ng2-redux';

@Component({
  // ...
})
export class App {
  constructor(private ngRedux: NgRedux) {}
}
New way:

bootstrap.ts:

import { bootstrap } from '@angular/platform-browser-dynamic';
import { NgRedux } from 'ng2-redux';
import { App } from './app';

bootstrap(App, [ Ng2Redux ]);

app.ts

import { Component } from '@angular/core';
import { NgRedux } from 'ng2-redux';
import { reduxLogger } from 'redux-logger';
import { initialState, rootReducer } from './reducers';

@Component({
  // ...
})
export class App {
  constructor(private ngRedux: NgRedux) {
    const middleware = [ reduxLogger ];
    const enhancers = [ persistState('counter', { key: 'example-app' }) ];

    // Easier to understand, and can use middleware or enhancers from DI.
    ngRedux.configureStore(rootReducer, initialState, middleware, enhancers);
  }
}

Example App Updates

The example app has been updated to use @select and a DI-aware action creator service (counter-actions.ts). It now also shows examples of using middleware and enhancers from the Redux community: redux-logger and redux-localstorage.

2.2.2

Features

  • Type definitions:
    • Ported to typescript
    • Supports typed stores / reducers
    • Uses offical Redux type definitions
  • Type Injectable:
    • Able to inject NgRedux into your component by type, and not need @Inject('ngRedux')
    • @Inject('ngRedux') still works
import { NgRedux } from 'ng2-redux';
// ...
export class MyComponent {
  constructor(private ngRedux: NgRedux) {}
}
  • State as Observable: Ability to expose parts of your state as an observable.
select<S>(selector: string | number | symbol | ((state: RootState) => S), comparer?: (x: any, y: any) => boolean): Observable<S>;
    wrapActionCreators: (actions: any) => (dispatch: Redux.Dispatch<any>) => Redux.ActionCreator<{}> | Redux.ActionCreatorsMapObject;

Example use:

import { NgRedux } from 'ng2-redux';
// ...
export class MyComponent implements OnInit {
  countByKey$: Observable<number>;
  countByFunc$: Observable<number>;

  constructor(private ngRedux: NgRedux) {
    this.countByKey$ = this.ngRedux.select('count');
    this.countByFunc$ = this.ngRedux.select(state=>state.count);
  }
}

Also have the ability to provide a custom compare function.

import { is, Map } from 'immutable';
import { NgRedux } from 'ng2-redux';

// ...
export class MyComponent implements OnInit {
  person$: Observable<Map<string,any>>;

  constructor(private ngRedux: ngRedux) {
    // even if the reference of the object has changed,
    // if the data is the same - it wont be treated as a change
    this.person$ = this.ngRedux.select(state=>state.people.get(0),is);
  }
}