README.md

THIS IS EXPERIMENTAL. NOT FOR USE

fluxton

Flux Singleton Values

###Concept

Fluxton forces a store to only have a single immutatble value, and a single action. The user generates a 'change', based on creating a new Immutable object, and passes this to 'setValue' which automatically generates an action, passes it to the flux dispatcher, and applies the change to the related store. Since all changes pass through the Dispatcher, other stores can for the action and 'waitFor' the change to be applied, as is expected in flux.

Since values are treated as immutable (or use immutable.js) then having the change represent the whole value is not an issue.

###TodoMVC Example

Fluxton-todoMVC

###Example

Facebook's flux documentation give an example of calculating a flight cost which has dependent values. Lets explore this below, by creating 5 independent stores, 3 of which are dependent.

import Fluxton from './Fluxton';
import FluxtonStore from './FluxtonStore';

var fluxton = window.fluxton = new Fluxton();

var summary = fluxton.create('summary');
var countries = fluxton.create('countries');
var selectedCountry = fluxton.create('selectedCountry');
var selectedState = fluxton.create('selectedState');
var flightCost = fluxton.create('flightCost');

selectedState.depend(['selectedCountry'], function(){
  this.value = (`Idahoe(in ${selectedCountry.getValue()})`);
  this.emitChange();
});

flightCost.depend(['selectedCountry', 'selectedState'], function(){
  this.value = (fluxton.get('selectedCountry').getValue() + ' to '  +   fluxton.get('selectedState').getValue()) + ' value here';
  this.emitChange();
});

summary.depend(['selectedCountry', 'selectedState', 'flightCost'], function(){
  this.value = (`summary here: ` + fluxton.get('flightCost').getValue());
  this.emitChange();
});

flightCost.on('change', function(value) {
  console.debug('flight cost change: ', value)
});

summary.on('change', function(value) {
  console.debug('summary change: ', value)
});

console.debug('---- set country', countries);
countries.setValue(['USA', 'australia', 'nz']);
console.debug('---- set selectedCountry');
selectedCountry.setValue(fluxton.get('countries').getValue()[0]);
console.debug('---- set selectedState');
selectedState.setValue('California');
console.debug('----');

Running the code

npm install

npm install -g webpack

webpack

ideas for future api - grouped stores

storeGroup = storeGroup({ countries: store(['australia', 'usa', 'nz'], selectedCountry: store('usa'), selectedCity: store('sf') summary: store('sf'), test: { one:store('test'), two:store('test2'), } });

storeGroup.selectedCity.depends([storeGroup.selectedCountry], state => { return getDefault(coutnry); }

storeGroup.summary.depends([storeGroup.selectedCountry, storeGroup.selectedCity], state => { return storeGroup.selectedCountry + ' ' storeGroup.selectedCity; }

storeGroup.on('change', value=> { // })

storeGroup.selectedCountry.update('australia');