yanick/updux
1
0
Fork 0
Code Issues 6 Pull Requests Projects Releases 10 Wiki Activity

WIP

Browse Source
This commit is contained in:
Yanick Champoux 2021-09-27 17:34:46 -04:00
parent 99ba091a51
commit 74c29ce2d0
33 changed files with 0 additions and 3020 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
.eslintrc.js
View File

@ -1,32 +0,0 @@
// @format
// https://dev.to/robertcoopercode/using-eslint-and-prettier-in-a-typescript-project-53jb
const _ = require('lodash');
const ts_nope = [
'no-explicit-any',
'explicit-function-return-type',
'no-object-literal-type-assertion',
'camelcase',
'member-delimiter-style',
'prefer-interface',
'indent',
].map(r => '@typescript-eslint/' + r);
module.exports = {
parser: '@typescript-eslint/parser', // Specifies the ESLint parser
extends: [
'plugin:@typescript-eslint/recommended', // Uses the recommended rules from the @typescript-eslint/eslint-plugin
],
plugins: ['import'],
parserOptions: {
ecmaVersion: 2018, // Allows for the parsing of modern ECMAScript features
sourceType: 'module', // Allows for the use of imports
},
rules: {
..._.fromPairs(ts_nope.map(r => [r, 'off'])),
// Place to specify ESLint rules. Can be used to overwrite rules specified from the extended configs
// e.g. "@typescript-eslint/explicit-function-return-type": "off",
},
};

32
Promake
View File

@ -1,32 +0,0 @@
#!/usr/bin/env node
const Promake = require('promake');
const glob = require('glob').sync;
const {
task, cli, rule, exec
} = new Promake();
const compile = task( 'compile', rule( 'tsconfig.tsbuildinfo', glob('src/**.ts'),
async () => {
return exec( 'tsc' );
}) );
const docs = task( 'docs', [ rule(
glob('docs/4-API/*.md'),
[ ...glob('./src/**.ts'), compile ], async() => {
await exec( "typedoc src" );
}
)]);
const sidebar = task(
'sidebar',
rule('./docs/_sidebar.md', [...glob('./docs/4-API/**.md'), docs], async () => {
return exec('docsify-auto-sidebar -d docs');
})
);
cli();

369
api-extractor.json
View File

@ -1,369 +0,0 @@
/**
* Config file for API Extractor. For more info, please visit: https://api-extractor.com
*/
{
"$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
/**
* Optionally specifies another JSON config file that this file extends from. This provides a way for
* standard settings to be shared across multiple projects.
*
* If the path starts with "./" or "../", the path is resolved relative to the folder of the file that contains
* the "extends" field. Otherwise, the first path segment is interpreted as an NPM package name, and will be
* resolved using NodeJS require().
*
* SUPPORTED TOKENS: none
* DEFAULT VALUE: ""
*/
// "extends": "./shared/api-extractor-base.json"
// "extends": "my-package/include/api-extractor-base.json"
/**
* Determines the "<projectFolder>" token that can be used with other config file settings. The project folder
* typically contains the tsconfig.json and package.json config files, but the path is user-defined.
*
* The path is resolved relative to the folder of the config file that contains the setting.
*
* The default value for "projectFolder" is the token "<lookup>", which means the folder is determined by traversing
* parent folders, starting from the folder containing api-extractor.json, and stopping at the first folder
* that contains a tsconfig.json file. If a tsconfig.json file cannot be found in this way, then an error
* will be reported.
*
* SUPPORTED TOKENS: <lookup>
* DEFAULT VALUE: "<lookup>"
*/
// "projectFolder": "..",
/**
* (REQUIRED) Specifies the .d.ts file to be used as the starting point for analysis. API Extractor
* analyzes the symbols exported by this module.
*
* The file extension must be ".d.ts" and not ".ts".
*
* The path is resolved relative to the folder of the config file that contains the setting; to change this,
* prepend a folder token such as "<projectFolder>".
*
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
*/
"mainEntryPointFilePath": "./dist/index.d.ts",
/**
* A list of NPM package names whose exports should be treated as part of this package.
*
* For example, suppose that Webpack is used to generate a distributed bundle for the project "library1",
* and another NPM package "library2" is embedded in this bundle. Some types from library2 may become part
* of the exported API for library1, but by default API Extractor would generate a .d.ts rollup that explicitly
* imports library2. To avoid this, we can specify:
*
* "bundledPackages": [ "library2" ],
*
* This would direct API Extractor to embed those types directly in the .d.ts rollup, as if they had been
* local files for library1.
*/
"bundledPackages": [ ],
/**
* Determines how the TypeScript compiler engine will be invoked by API Extractor.
*/
"compiler": {
/**
* Specifies the path to the tsconfig.json file to be used by API Extractor when analyzing the project.
*
* The path is resolved relative to the folder of the config file that contains the setting; to change this,
* prepend a folder token such as "<projectFolder>".
*
* Note: This setting will be ignored if "overrideTsconfig" is used.
*
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
* DEFAULT VALUE: "<projectFolder>/tsconfig.json"
*/
// "tsconfigFilePath": "<projectFolder>/tsconfig.json",
/**
* Provides a compiler configuration that will be used instead of reading the tsconfig.json file from disk.
* The object must conform to the TypeScript tsconfig schema:
*
* http://json.schemastore.org/tsconfig
*
* If omitted, then the tsconfig.json file will be read from the "projectFolder".
*
* DEFAULT VALUE: no overrideTsconfig section
*/
// "overrideTsconfig": {
// . . .
// }
/**
* This option causes the compiler to be invoked with the --skipLibCheck option. This option is not recommended
* and may cause API Extractor to produce incomplete or incorrect declarations, but it may be required when
* dependencies contain declarations that are incompatible with the TypeScript engine that API Extractor uses
* for its analysis. Where possible, the underlying issue should be fixed rather than relying on skipLibCheck.
*
* DEFAULT VALUE: false
*/
// "skipLibCheck": true,
},
/**
* Configures how the API report file (*.api.md) will be generated.
*/
"apiReport": {
/**
* (REQUIRED) Whether to generate an API report.
*/
"enabled": true,
/**
* The filename for the API report files. It will be combined with "reportFolder" or "reportTempFolder" to produce
* a full file path.
*
* The file extension should be ".api.md", and the string should not contain a path separator such as "\" or "/".
*
* SUPPORTED TOKENS: <packageName>, <unscopedPackageName>
* DEFAULT VALUE: "<unscopedPackageName>.api.md"
*/
// "reportFileName": "<unscopedPackageName>.api.md",
/**
* Specifies the folder where the API report file is written. The file name portion is determined by
* the "reportFileName" setting.
*
* The API report file is normally tracked by Git. Changes to it can be used to trigger a branch policy,
* e.g. for an API review.
*
* The path is resolved relative to the folder of the config file that contains the setting; to change this,
* prepend a folder token such as "<projectFolder>".
*
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
* DEFAULT VALUE: "<projectFolder>/etc/"
*/
"reportFolder": "<projectFolder>/temp/",
/**
* Specifies the folder where the temporary report file is written. The file name portion is determined by
* the "reportFileName" setting.
*
* After the temporary file is written to disk, it is compared with the file in the "reportFolder".
* If they are different, a production build will fail.
*
* The path is resolved relative to the folder of the config file that contains the setting; to change this,
* prepend a folder token such as "<projectFolder>".
*
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
* DEFAULT VALUE: "<projectFolder>/temp/"
*/
"reportTempFolder": "<projectFolder>/temp/"
},
/**
* Configures how the doc model file (*.api.json) will be generated.
*/
"docModel": {
/**
* (REQUIRED) Whether to generate a doc model file.
*/
"enabled": true,
/**
* The output path for the doc model file. The file extension should be ".api.json".
*
* The path is resolved relative to the folder of the config file that contains the setting; to change this,
* prepend a folder token such as "<projectFolder>".
*
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
* DEFAULT VALUE: "<projectFolder>/temp/<unscopedPackageName>.api.json"
*/
// "apiJsonFilePath": "<projectFolder>/temp/<unscopedPackageName>.api.json"
},
/**
* Configures how the .d.ts rollup file will be generated.
*/
"dtsRollup": {
/**
* (REQUIRED) Whether to generate the .d.ts rollup file.
*/
"enabled": true,
/**
* Specifies the output path for a .d.ts rollup file to be generated without any trimming.
* This file will include all declarations that are exported by the main entry point.
*
* If the path is an empty string, then this file will not be written.
*
* The path is resolved relative to the folder of the config file that contains the setting; to change this,
* prepend a folder token such as "<projectFolder>".
*
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
* DEFAULT VALUE: "<projectFolder>/dist/<unscopedPackageName>.d.ts"
*/
// "untrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>.d.ts",
/**
* Specifies the output path for a .d.ts rollup file to be generated with trimming for a "beta" release.
* This file will include only declarations that are marked as "@public" or "@beta".
*
* The path is resolved relative to the folder of the config file that contains the setting; to change this,
* prepend a folder token such as "<projectFolder>".
*
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
* DEFAULT VALUE: ""
*/
// "betaTrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>-beta.d.ts",
/**
* Specifies the output path for a .d.ts rollup file to be generated with trimming for a "public" release.
* This file will include only declarations that are marked as "@public".
*
* If the path is an empty string, then this file will not be written.
*
* The path is resolved relative to the folder of the config file that contains the setting; to change this,
* prepend a folder token such as "<projectFolder>".
*
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
* DEFAULT VALUE: ""
*/
// "publicTrimmedFilePath": "<projectFolder>/dist/<unscopedPackageName>-public.d.ts",
/**
* When a declaration is trimmed, by default it will be replaced by a code comment such as
* "Excluded from this release type: exampleMember". Set "omitTrimmingComments" to true to remove the
* declaration completely.
*
* DEFAULT VALUE: false
*/
// "omitTrimmingComments": true
},
/**
* Configures how the tsdoc-metadata.json file will be generated.
*/
"tsdocMetadata": {
/**
* Whether to generate the tsdoc-metadata.json file.
*
* DEFAULT VALUE: true
*/
// "enabled": true,
/**
* Specifies where the TSDoc metadata file should be written.
*
* The path is resolved relative to the folder of the config file that contains the setting; to change this,
* prepend a folder token such as "<projectFolder>".
*
* The default value is "<lookup>", which causes the path to be automatically inferred from the "tsdocMetadata",
* "typings" or "main" fields of the project's package.json. If none of these fields are set, the lookup
* falls back to "tsdoc-metadata.json" in the package folder.
*
* SUPPORTED TOKENS: <projectFolder>, <packageName>, <unscopedPackageName>
* DEFAULT VALUE: "<lookup>"
*/
// "tsdocMetadataFilePath": "<projectFolder>/dist/tsdoc-metadata.json"
},
/**
* Specifies what type of newlines API Extractor should use when writing output files. By default, the output files
* will be written with Windows-style newlines. To use POSIX-style newlines, specify "lf" instead.
* To use the OS's default newline kind, specify "os".
*
* DEFAULT VALUE: "crlf"
*/
// "newlineKind": "crlf",
/**
* Configures how API Extractor reports error and warning messages produced during analysis.
*
* There are three sources of messages: compiler messages, API Extractor messages, and TSDoc messages.
*/
"messages": {
/**
* Configures handling of diagnostic messages reported by the TypeScript compiler engine while analyzing
* the input .d.ts files.
*
* TypeScript message identifiers start with "TS" followed by an integer. For example: "TS2551"
*
* DEFAULT VALUE: A single "default" entry with logLevel=warning.
*/
"compilerMessageReporting": {
/**
* Configures the default routing for messages that don't match an explicit rule in this table.
*/
"default": {
/**
* Specifies whether the message should be written to the the tool's output log. Note that
* the "addToApiReportFile" property may supersede this option.
*
* Possible values: "error", "warning", "none"
*
* Errors cause the build to fail and return a nonzero exit code. Warnings cause a production build fail
* and return a nonzero exit code. For a non-production build (e.g. when "api-extractor run" includes
* the "--local" option), the warning is displayed but the build will not fail.
*
* DEFAULT VALUE: "warning"
*/
"logLevel": "warning",
/**
* When addToApiReportFile is true: If API Extractor is configured to write an API report file (.api.md),
* then the message will be written inside that file; otherwise, the message is instead logged according to
* the "logLevel" option.
*
* DEFAULT VALUE: false
*/
// "addToApiReportFile": false
},
// "TS2551": {
// "logLevel": "warning",
// "addToApiReportFile": true
// },
//
// . . .
},
/**
* Configures handling of messages reported by API Extractor during its analysis.
*
* API Extractor message identifiers start with "ae-". For example: "ae-extra-release-tag"
*
* DEFAULT VALUE: See api-extractor-defaults.json for the complete table of extractorMessageReporting mappings
*/
"extractorMessageReporting": {
"default": {
"logLevel": "warning",
// "addToApiReportFile": false
},
// "ae-extra-release-tag": {
// "logLevel": "warning",
// "addToApiReportFile": true
// },
//
// . . .
},
/**
* Configures handling of messages reported by the TSDoc parser when analyzing code comments.
*
* TSDoc message identifiers start with "tsdoc-". For example: "tsdoc-link-tag-unescaped-text"
*
* DEFAULT VALUE: A single "default" entry with logLevel=warning.
*/
"tsdocMessageReporting": {
"default": {
"logLevel": "warning",
// "addToApiReportFile": false
}
// "tsdoc-link-tag-unescaped-text": {
// "logLevel": "warning",
// "addToApiReportFile": true
// },
//
// . . .
}
}
}

1
index.d.ts vendored
View File

@ -1 +0,0 @@

17
index.test-d.ts
View File

@ -1,17 +0,0 @@
import { expectType, expectError } from 'tsd';
import buildInitial from './src/buildInitial';
expectType<{}>(buildInitial());
type MyState = {
foo: {
bar: number
},
baz: string,
}
expectType<MyState>(buildInitial<MyState>());
expectError( buildInitial<MyState>({ foo: { bar: "potato" } }) );

121
src/actions-params.test.ts
View File

@ -1,121 +0,0 @@
import Updux, { dux, coduxes } from '.';
import { action, payload } from 'ts-action';
import { test } from 'tap';
import { expectAssignable } from 'tsd';
import { DuxActionsCoduxes } from './types';
const foo_actions = {
aaa: action('aaa', payload<number>()),
};
const fooDux = dux({
actions: foo_actions,
});
const bar_actions = {
bbb: action('bbb', (x: string) => ({ payload: '1' + x })),
};
test('actions are present', t => {
const barDux = dux({
subduxes: { foo: fooDux },
actions: bar_actions,
});
const result = Object.keys(barDux.actions);
result.sort();
t.same(result, ['aaa', 'bbb']);
t.end();
});
const a = action('a');
const b = action('b');
test('typing', t => {
t.test('nothing at all', t => {
const foo = new Updux();
t.same(foo.actions, {});
t.end();
});
t.test('with two coduxes', t => {
const myDux = new Updux({
...coduxes(dux({ actions: { a } }), dux({ actions: { b } })),
});
t.ok(myDux.actions.a);
t.end();
});
t.test('empty dux', t => {
const empty = dux({});
expectAssignable<object>(empty.actions);
t.same(empty.actions, {}, 'no actions there');
t.end();
});
t.test('coduxes actions', t => {
const typeOf = <C>(x: C) => (x as any) as DuxActionsCoduxes<C>;
expectAssignable<{ a: any }>(typeOf([dux({ actions: { a } })]));
expectAssignable<{}>(typeOf([dux({})]));
expectAssignable<{ a: any; b: any }>(
typeOf([dux({ actions: { a } }), dux({ actions: { b } })])
);
const co = coduxes(dux({ actions: { a } }), dux({})).coduxes;
expectAssignable<{ a: any }>(typeOf(co));
t.end();
});
t.test('with empty coduxes', t => {
const emptyDux = dux({});
const myDux = dux({
...coduxes(dux({ actions: { a } }), emptyDux),
});
t.ok(myDux.actions.a);
t.end();
});
t.test('with three coduxes', t => {
const emptyDux = new Updux();
emptyDux.actions;
const dux = new Updux({
coduxes: [
emptyDux,
new Updux({ actions: { a } }),
new Updux({ actions: { b } }),
],
});
t.ok(dux.actions.b);
t.end();
});
t.test('with grandchild', t => {
const dux = new Updux({
subduxes: {
bar: new Updux({
subduxes: {
baz: new Updux({
actions: { a },
}),
},
}),
},
});
t.ok(dux.actions.a);
t.end();
});
t.end();
});

78
src/actions.test.ts
View File

@ -1,78 +0,0 @@
import { action, payload } from 'ts-action';
import Updux, { dux } from '.';
import { test } from 'tap';
import { expectAssignable } from 'tsd';
const noopEffect = () => () => () => null;
test(
'actions defined in effects and mutations, multi-level',
{ autoend: true },
t => {
const bar = action('bar', (payload, meta) => ({ payload, meta }));
const foo = action('foo', (limit: number) => ({
payload: { limit },
}));
const { actions }: any = dux({
effects: [[foo, noopEffect] as any],
mutations: [[bar, () => () => null]],
subduxes: {
mysub: dux({
effects: { baz: noopEffect },
mutations: { quux: () => () => null },
actions: {
foo,
},
}),
myothersub: dux({
effects: [[foo, noopEffect]],
}),
},
});
const types = Object.keys(actions);
types.sort();
t.match(types, ['bar', 'baz', 'foo', 'quux']);
t.match(actions.bar(), { type: 'bar' });
t.match(actions.bar('xxx'), { type: 'bar', payload: 'xxx' });
t.match(actions.bar(undefined, 'yyy'), {
type: 'bar',
payload: undefined,
meta: 'yyy',
});
t.same(actions.foo(12), { type: 'foo', payload: { limit: 12 } });
}
);
test('different calls to addAction', t => {
const updux = new Updux<any,any>();
updux.addAction(action('foo', payload()));
t.match(updux.actions.foo('yo'), {
type: 'foo',
payload: 'yo',
});
updux.addAction('baz', x => ({ x }));
t.match(updux.actions.baz(3), {
type: 'baz',
payload: { x: 3 },
});
t.end();
});
test('types', t => {
const {actions} = dux({ actions: {
foo: action('foo')
}});
expectAssignable<object>( actions );
t.end();
});

25
src/addMutations.test.ts
View File

@ -1,25 +0,0 @@
import { action } from 'ts-action';
import tap from 'tap';
import Updux from "./updux";
type MyState = {
sum: number;
};
tap.test("added mutation is present", t => {
const updux = new Updux<MyState>({
initial: { sum: 0 }
});
const add = action("add", (n: number) => ({ payload: { n } }));
updux.addMutation(add, ({ n }) => ({ sum }) => ({ sum: sum + n }));
const store = updux.createStore();
store.dispatch(add(3));
t.same(store.getState(), {sum: 3});
t.end();
});

22
src/buildActions/index.ts
View File

@ -1,22 +0,0 @@
import fp from 'lodash/fp';
import {
ActionCreator
} from 'ts-action';
import {
Dictionary,
} from '../types';
type ActionPair = [string, ActionCreator];
function buildActions(actions: ActionPair[] = []): Dictionary<ActionCreator<string,(...args: any) => {type: string} >>{
// priority => generics => generic subs => craft subs => creators
const [crafted, generic] = fp.partition(([type, f]) => !f._genericAction)(
fp.compact(actions)
);
return fp.fromPairs([...generic, ...crafted]);
}
export default buildActions;

31
src/buildCreateStore/index.ts
View File

@ -1,31 +0,0 @@
import {
createStore as reduxCreateStore,
applyMiddleware,
Middleware,
Reducer,
PreloadedState,
Store,
} from 'redux';
function buildCreateStore<S,A = {}>(
reducer: Reducer<S>,
middleware: Middleware,
actions: A = {} as A,
): (initial?: S, injectEnhancer?: Function) => Store<S> & { actions: A } {
return function createStore(initial?: S, injectEnhancer?: Function ): Store<S> & { actions: A } {
let enhancer = injectEnhancer ? injectEnhancer(middleware) : applyMiddleware(middleware);
const store = reduxCreateStore(
reducer,
initial as PreloadedState<S>,
enhancer
);
(store as any).actions = actions;
return store as any;
};
}
export default buildCreateStore;

28
src/buildCreateStore/test.ts
View File

@ -1,28 +0,0 @@
import tap from 'tap';
import { expectType } from 'tsd';
import buildCreateStore from '.';
import { action, ActionCreator } from 'ts-action';
import {Reducer} from 'redux';
const foo = action('foo');
const bar = action('bar');
type State = {
x: number,
y: string
}
const store = buildCreateStore(
((state: State|undefined) => state ?? {x: 1} ) as Reducer<State>,
() => () => () => {return},
{ foo, bar }
)();
expectType<State>( store.getState() );
expectType<number>( store.getState().x );
expectType<{ foo: ActionCreator }>( store.actions );
tap.pass();

89
src/buildMiddleware/index.ts
View File

@ -1,89 +0,0 @@
import fp from 'lodash/fp';
import { ActionCreator } from 'ts-action';
import { Middleware, MiddlewareAPI, Dispatch } from 'redux';
import {
Dictionary,
Action,
UpduxMiddleware,
UpduxMiddlewareAPI,
Selector,
} from '../types';
import Updux from '..';
const MiddlewareFor = (
type: any,
mw: Middleware
): Middleware => api => next => action => {
if (!type.includes('*') && action.type !== type) return next(action);
return mw(api)(next)(action);
};
type Next = (action: Action) => any;
function sliceMw(slice: string, mw: UpduxMiddleware): UpduxMiddleware {
return api => {
const getSliceState = () => fp.get(slice, api.getState());
return mw({ ...api, getState: getSliceState } as any);
};
}
type Submws = Dictionary<UpduxMiddleware>;
type MwGen = () => UpduxMiddleware;
export type Effect = [string, UpduxMiddleware|MwGen, boolean? ];
export const subMiddleware = () => next => action => next(action);
export const subEffects : Effect = [ '*', subMiddleware ] as any;
export const effectToMw = (
effect: Effect,
actions: Dictionary<ActionCreator>,
selectors: Dictionary<Selector>,
) => {
let [type, mw, gen]: any = effect;
if ( mw === subMiddleware ) return subMiddleware;
if (gen) mw = mw();
const augmented = api => mw({ ...api, actions, selectors });
if (type === '*') return augmented;
return api => next => action => {
if (action.type !== type) return next(action);
return augmented(api)(next)(action);
};
};
const composeMw = (mws: UpduxMiddleware[]) => (
api: UpduxMiddlewareAPI<any>
) => (original_next: Next) =>
mws.reduceRight((next, mw) => mw(api)(next), original_next);
export function buildMiddleware<S = unknown>(
local: UpduxMiddleware[] = [],
co: UpduxMiddleware[] = [],
sub: Submws = {}
): UpduxMiddleware<S> {
let inner = [
...co,
...Object.entries(sub).map(([slice, mw]) => sliceMw(slice, mw)),
];
let found = false;
let mws = local.flatMap(e => {
if (e !== subMiddleware) return e;
found = true;
return inner;
});
if (!found) mws = [...mws, ...inner];
return composeMw(mws) as UpduxMiddleware<S>;
}
export default buildMiddleware;

67
src/buildMiddleware/test.ts
View File

@ -1,67 +0,0 @@
import { buildMiddleware, subMiddleware } from '.';
import tap from 'tap';
import sinon from 'sinon';
const myMiddleware = (tag: string) => api => next => action => {
next({
...action,
payload: [...action.payload, tag],
});
};
const local1 = myMiddleware('local1');
const local2 = myMiddleware('local2');
const co = myMiddleware('co');
const sub = myMiddleware('sub');
tap.test('basic', t => {
const next = sinon.fake();
const mw = buildMiddleware([local1, local2], [co], { sub });
mw({} as any)(next)({ type: 'foo', payload: [] });
t.match(next.firstCall.args, [
{
type: 'foo',
payload: ['local1', 'local2', 'co', 'sub'],
},
]);
t.end();
});
tap.test('inner in the middle', t => {
const next = sinon.fake();
const mw = buildMiddleware([local1, subMiddleware, local2], [co], {
sub,
});
mw({} as any)(next)({ type: 'foo', payload: [] });
t.match(next.firstCall.lastArg, {
type: 'foo',
payload: ['local1', 'co', 'sub', 'local2'],
});
t.end();
});
tap.test('sub-mw get their store sliced', t => {
const next = sinon.fake();
const sub = ({ getState }) => next => action => next(getState());
const mw = buildMiddleware([], [], { sub });
mw({
getState() {
return { foo: 1, sub: 2 };
},
} as any)(next)({ type: 'noop' });
t.same( next.firstCall.lastArg, 2 );
t.end();
});

57
src/buildMutations/index.ts
View File

@ -1,57 +0,0 @@
import fp from 'lodash/fp';
import u from '@yanick/updeep';
import {
Mutation,
Action,
Dictionary,
MutationEntry,
Upreducer,
} from '../types';
import Updux from '..';
const composeMutations = (mutations: Mutation[]) => {
if (mutations.length == 0) return () => state => state;
return mutations.reduce(
(m1, m2) => (payload: any = null, action: Action) => state =>
m2(payload, action)(m1(payload, action)(state))
);
};
type SubMutations = {
[slice: string]: Dictionary<Mutation>;
};
function buildMutations(
mutations: Dictionary<Mutation | [Mutation, boolean | undefined]> = {},
subduxes = {},
coduxes: Upreducer[] = []
) {
const submuts = Object.entries(subduxes).map(
([slice, upreducer]: [string, any]) =>
<Mutation>(
((payload, action: Action) =>
(u.updateIn as any)(slice, upreducer(action)))
)
);
const comuts = coduxes.map(c => (payload, action: Action) => c(action));
const subreducer = composeMutations([...submuts, ...comuts]);
let merged = {};
Object.entries(mutations).forEach(([type, mutation]) => {
const [m, sink] = Array.isArray(mutation)
? mutation
: [mutation, false];
merged[type] = sink ? m : composeMutations([subreducer, m]);
});
if (!merged['*']) merged['*'] = subreducer;
return merged;
}
export default buildMutations;

19
src/buildUpreducer/index.ts
View File

@ -1,19 +0,0 @@
import fp from 'lodash/fp';
import { Dictionary, Mutation, Action, Upreducer } from '../types';
function buildUpreducer<S>(initial: S, mutations: Dictionary<Mutation<S>> ): Upreducer<S> {
return (action :Action) => (state: S) => {
if (state === undefined) state = initial;
const a =
mutations[action.type] ||
mutations['*'];
if(!a) return state;
return a(action.payload, action)(state);
};
}
export default buildUpreducer;

36
src/coduxes.test.ts
View File

@ -1,36 +0,0 @@
import Updux from '.';
import { action } from 'ts-action';
import { Effect } from './buildMiddleware';
import tap from 'tap';
import sinon from 'sinon';
const myEffect: Effect = [
'*',
() => next => action => next({ ...action, hello: true }),
];
const codux = new Updux({
actions: {
foo: action('foo'),
},
effects: [myEffect],
});
const dux = new Updux({
coduxes: [codux],
});
tap.test('actions', t => {
t.ok(dux.actions.foo);
t.end();
});
tap.test('effects', t => {
const next = sinon.fake();
dux.middleware({} as any)(next)({ type: 'foo' });
t.same(next.lastCall.lastArg, { type: 'foo', hello: true });
t.end();
});

14
src/duxstate.test.ts
View File

@ -1,14 +0,0 @@
import tap from 'tap';
import { expectType } from 'tsd';
import { dux, DuxState } from '.';
const myDux = dux({
initial: { a: 1, b: "potato" }
});
type State = DuxState<typeof myDux>;
expectType<State>({ a: 12, b: "something" });
tap.pass();

14
src/effects-action.test.ts
View File

@ -1,14 +0,0 @@
import tap from 'tap';
import Updux from '.';
import { action, payload } from 'ts-action';
import { expectType } from 'tsd';
const dux = new Updux({ });
const myAction = action('mine',payload<string>() );
dux.addEffect( myAction, () => () => action => {
expectType<{payload: string; type: "mine"}>(action);
});
tap.pass("pure type checking");

22
src/index.ts
View File

@ -1,22 +0,0 @@
import Updux from "./updux";
import { UpduxConfig, Dux, Dictionary, Selector, Mutation, AggDuxState, Action,
Upreducer, UpduxMiddleware, DuxActions, DuxSelectors } from "./types";
import {Creator} from 'ts-action';
import { AnyAction, Store } from 'redux';
export { default as Updux } from "./updux";
export { UpduxConfig, DuxState } from "./types";
export { subEffects } from './buildMiddleware';
export * from './types';
export default Updux;
export const coduxes = <C extends Dux, U extends [C,...C[]]>(...coduxes: U): { coduxes: U } => ({
coduxes });
export const dux = <S=unknown,A=unknown,X=unknown,C extends UpduxConfig= {}>(config: C ) => {
/// : Dux<S,A,X,C> => {
return ( new Updux<S,A,X,C>(config) ).asDux;
}

32
src/mappedUpdux.test.ts
View File

@ -1,32 +0,0 @@
import Updux from './updux';
import u from '@yanick/updeep';
import tap from 'tap';
const todo: any = new Updux<any>({
mutations: {
review: () => u({ reviewed: true }),
done: () => u({ done: true }),
},
});
const todos: any = new Updux({
subduxes: { '*': todo },
});
todos.addMutation(
todo.actions.done,
(id, action) => u.map(u.if(u.is('id', id), todo.upreducer(action))),
true
);
tap.test('* for mapping works', async t => {
const reducer = todos.reducer;
let state = [{ id: 0 }, { id: 1 }];
state = reducer(state, todos.actions.review());
state = reducer(state, todos.actions.done(1));
t.same(state, [
{ id: 0, reviewed: true },
{ id: 1, reviewed: true, done: true },
]);
});

278
src/middleware.test.ts
View File

@ -1,278 +0,0 @@
import u from '@yanick/updeep';
import { action } from 'ts-action';
import tap from 'tap';
import sinon from 'sinon';
import Updux, { dux, subEffects } from '.';
import mwUpdux from './middleware_aux';
tap.test('simple effect', async t => {
const tracer = sinon.fake();
const store = new Updux({
effects: {
foo: () => (next: any) => (action: any) => {
tracer();
next(action);
},
},
}).createStore();
t.ok(!tracer.called);
store.dispatch({ type: 'bar' });
t.ok(!tracer.called);
store.dispatch( (store as any).actions.foo() );
t.ok(tracer.called);
});
tap.test('effect and sub-effect', async t => {
const tracer = sinon.fake();
const tracerEffect = (signature: string) => () => (next: any) => (
action: any
) => {
tracer(signature);
next(action);
};
const store = new Updux({
effects: {
foo: tracerEffect('root'),
},
subduxes: {
zzz: dux({
effects: {
foo: tracerEffect('child'),
},
}),
},
}).createStore();
t.ok(!tracer.called);
store.dispatch({ type: 'bar' });
t.ok(!tracer.called);
store.dispatch( (store.actions as any).foo() );
t.is( tracer.firstCall.lastArg, 'root' );
t.is( tracer.secondCall.lastArg, 'child' );
});
tap.test('"*" effect', async t => {
t.test('from the constructor', async t => {
const tracer = sinon.fake();
const store = new Updux({
effects: {
'*': () => next => action => {
tracer();
next(action);
},
},
}).createStore();
t.ok(!tracer.called);
store.dispatch({ type: 'bar' });
t.ok(tracer.called);
});
t.test('from addEffect', async t => {
const tracer = sinon.fake();
const updux = new Updux({});
updux.addEffect('*', () => next => action => {
tracer();
next(action);
});
t.ok(!tracer.called);
updux.createStore().dispatch({ type: 'bar' });
t.ok(tracer.called);
});
t.test('action can be modified', async t => {
const mw = mwUpdux.middleware;
const next = sinon.fake();
mw({dispatch:{}} as any)(next as any)({type: 'bar'});
t.ok(next.called);
t.match( next.firstCall.args[0], {meta: 'gotcha' } );
});
});
tap.test('async effect', async t => {
function timeout(ms: number) {
return new Promise(resolve => setTimeout(resolve, ms));
}
const tracer = sinon.fake();
const store = new Updux({
effects: {
foo: () => next => async action => {
next(action);
await timeout(1000);
tracer();
},
},
}).createStore();
t.ok(!tracer.called);
store.dispatch( (store.actions as any).foo() );
t.ok(!tracer.called);
await timeout(1000);
t.ok(tracer.called);
});
tap.test('getState is local', async t => {
let childState;
let rootState;
const child = new Updux({
initial: { alpha: 12 },
effects: {
doIt: ({ getState }) => next => action => {
childState = getState();
next(action);
},
},
});
const root = new Updux({
initial: { beta: 24 },
subduxes: { child: child.asDux },
effects: {
doIt: ({ getState }) => next => action => {
rootState = getState();
next(action);
},
},
});
const store = root.createStore();
store.dispatch( (store.actions as any).doIt() );
t.match(rootState,{ beta: 24, child: { alpha: 12 } });
t.match(childState,{ alpha: 12 });
});
tap.test('middleware as map', async t => {
const doIt = action('doIt', () => ({payload: ''}));
const child = new Updux({
initial: '',
effects: [
[
doIt,
() => next => action => {
next(
u(
{ payload: (p: string) => p + 'Child' },
action
) as any
);
},
],
],
});
const root = new Updux({
initial: { message: '' },
subduxes: { child: child.asDux },
effects: [
[
'*',
() => next => action => {
next(
u({ payload: (p: string) => p + 'Pre' }, action) as any
);
},
],
[
doIt,
() => next => action => {
next(
u({ payload: (p: string) => p + 'Root' }, action) as any
);
},
],
[
'*',
() => next => action => {
next(
u(
{ payload: (p: string) => p + 'After' },
action
) as any
);
},
],
subEffects,
[
'*',
() => next => action => {
next(
u({ payload: (p: string) => p + 'End' }, action) as any
);
},
],
],
mutations: [[doIt, (message: any) => () => ({ message })]],
});
const store = root.createStore();
const actions: any = store.actions;
store.dispatch( actions.doIt('') );
t.same(store.getState(),{ message: 'PreRootAfterChildEnd' });
});
tap.test('generator', async t => {
const updux = new Updux({
initial: 0,
mutations: [['doIt', payload => () => payload]],
effects: [
[
'doIt',
() => {
let i = 0;
return () => (next: any) => (action: any) =>
next({ ...action, payload: ++i });
},
true,
],
],
});
const store1 = updux.createStore();
store1.dispatch( (store1 as any).actions.doIt() );
t.is(store1.getState(),1);
store1.dispatch( (store1 as any).actions.doIt() );
t.is(store1.getState(),2);
const store2 = updux.createStore();
store2.dispatch( (store2 as any).actions.doIt() );
t.is(store2.getState(),1);
});

13
src/middleware_aux.ts
View File

@ -1,13 +0,0 @@
import Updux, {dux} from '.';
const updux = new Updux({
subduxes: {
foo: dux({ initial: "banana" })
}
});
updux.addEffect('*', () => next => action => {
next({...action, meta: "gotcha" });
});
export default updux;

88
src/mutations.test.ts
View File

@ -1,88 +0,0 @@
import { action, empty } from 'ts-action';
import Updux, { dux } from '.';
import tap from 'tap';
import u from '@yanick/updeep';
tap.test('as array of arrays', async t => {
const doIt = action('doIt');
const updux = new Updux({
initial: '',
actions: { doIt },
mutations: [
[doIt, () => () => 'bingo'],
['thisToo', () => () => 'straight type'],
],
});
const store = updux.createStore();
t.test('doIt', async t => {
store.dispatch( store.actions.doIt() );
t.is(store.getState(),'bingo');
});
t.test('straight type', async t => {
store.dispatch( (store.actions as any).thisToo() );
t.is(store.getState(),'straight type');
});
});
tap.test('override', async t => {
const d = new Updux<any>({
initial: { alpha: [] },
mutations: {
'*': (payload, action) => state => ({
...state,
alpha: [...state.alpha, action.type],
}),
},
subduxes: {
subbie: dux({
initial: 0,
mutations: {
foo: () => state => state + 1,
},
}),
},
});
const store = d.createStore();
store.dispatch({ type: 'foo' });
store.dispatch({ type: 'bar' });
t.pass();
});
tap.test('coduxes and subduxes', async t => {
const foo = action('foo',empty());
const d = new Updux({
initial: {
x: '',
},
actions: {
foo
},
mutations: [[foo, () => (u.updateIn as any)('x', x => x + 'm')]],
subduxes: {
x: dux({
mutations: [[foo, () => x => x + 's']],
}),
},
coduxes: [
dux({
mutations: [[foo, () => (u.updateIn as any)('x', x => x + 'c')]],
}),
],
});
const store = d.createStore();
store.dispatch(d.actions.foo());
t.same(store.getState(),{
x: 'scm',
});
});

57
src/sink.test.ts
View File

@ -1,57 +0,0 @@
import Updux, { dux } from '.';
import tap from 'tap';
import { action } from 'ts-action';
const foo = dux({
initial: 0,
actions: {
doIt: action('doIt'),
doTheThing: action('doTheThing'),
},
mutations: {
doIt: () => (state: number) => {
return state + 1;
},
doTheThing: () => (state: number) => {
return state + 3;
},
},
});
const bar: any = new Updux<{ foo: number }>({
subduxes: { foo },
});
bar.addMutation(
foo.actions.doTheThing,
(_, action) => state => {
return {
...state,
baz: foo.upreducer(action)(state.foo),
};
},
true
);
bar.addMutation(
foo.actions.doIt,
() => (state: any) => ({ ...state, bar: 'yay' }),
true
);
tap.same(bar.initial, { foo: 0 });
tap.test('foo alone', t => {
t.is(foo.reducer(undefined, foo.actions.doIt()), 1);
t.end();
});
tap.test('sink mutations', t => {
t.same(
bar.reducer(undefined, bar.actions.doIt()), {
foo: 0,
bar: 'yay',
});
t.end();
});

113
src/splat.test.ts
View File

@ -1,113 +0,0 @@
import tap from 'tap';
import Updux, {dux} from '.';
import u from '@yanick/updeep';
import { expectType } from 'tsd';
const tracer = (chr: string) => u({ tracer: (s = '') => s + chr });
tap.test('mutations, simple', t => {
const dux : any = new Updux({
mutations: {
foo: () => tracer('a'),
'*': () => tracer('b'),
},
});
const store = dux.createStore();
t.same(store.getState(),{ tracer: 'b' });
store.dispatch( store.actions.foo() );
t.same(store.getState(),{ tracer: 'ba' });
store.dispatch({ type: 'bar' });
t.same(store.getState(),{ tracer: 'bab' });
t.end();
});
tap.test('with subduxes', t => {
const d = dux({
mutations: {
foo: () => tracer('a'),
'*': () => tracer('b'),
bar: () => ({ bar }: any) => ({ bar, tracer: bar.tracer }),
},
subduxes: {
bar: dux({
mutations: {
foo: () => tracer('d'),
'*': () => tracer('e'),
},
}),
},
});
const store = d.createStore();
t.same(store.getState(),{
tracer: 'b',
bar: { tracer: 'e' },
});
store.dispatch( (store.actions as any).foo() );
t.same(store.getState(),{
tracer: 'ba',
bar: { tracer: 'ed' },
});
store.dispatch({ type: 'bar' });
t.same(store.getState(),{
tracer: 'ede',
bar: { tracer: 'ede' },
});
t.end();
});
tap.test( 'splat and state', async t => {
const inner = dux({ initial: 3 });
inner.initial;
const arrayDux = dux({
initial: [],
subduxes: {
'*': inner
}
});
expectType<number[]>(arrayDux.initial)
t.same(arrayDux.initial,[]);
const objDux = dux({
initial: {},
subduxes: {
'*': dux({initial: 3})
}
});
expectType<{
[key: string]: number
}>(objDux.initial);
t.same(objDux.initial,{});
});
tap.test( 'multi-splat', async t => {
dux({
subduxes: {
foo: dux({ mutations: { '*': () => s => s }}),
bar: dux({ mutations: { '*': () => s => s }}),
}
});
t.pass();
});

205
src/test.ts
View File

@ -1,205 +0,0 @@
import Updux, {dux} from '.';
import u from '@yanick/updeep';
import { action, payload } from 'ts-action';
import tap from 'tap';
tap.test('actions from mutations', async t => {
const {
actions: {foo, bar},
} : any = new Updux({
mutations: {
foo: () => (x:any) => x,
},
});
t.match( foo(), { type: 'foo' } );
t.same( foo(true), {type: 'foo', payload: true});
});
tap.test('reducer', async t => {
const inc = action('inc');
const {actions, reducer} = dux({
initial: {counter: 1},
actions: { inc },
mutations: {
inc: () => ({counter}:{counter:number}) => ({counter: counter + 1}),
},
});
let state = reducer(undefined, {type:'noop'});
t.same(state,{counter: 1});
state = reducer(state, actions.inc());
t.same(state,{counter: 2});
});
tap.test( 'sub reducers', async t => {
const doAll = action('doAll', payload<number>() );
const foo = dux({
initial: 1,
actions: { doAll },
mutations: {
doFoo: () => (x:number) => x + 1,
doAll: () => (x:number) => x + 10,
},
});
const bar = dux({
initial: 'a',
actions: { doAll },
mutations: {
doBar: () => (x:string) => x + 'a',
doAll: () => (x:string) => x + 'b',
}
});
const { initial, actions, reducer } = new Updux({
subduxes: {
foo, bar
}
});
t.same(initial,{ foo: 1, bar: 'a' });
t.is(Object.keys(actions).length,3);
let state = reducer(undefined,{type:'noop'});
t.same(state,{ foo: 1, bar: 'a' });
state = reducer(state, (actions as any).doFoo() );
t.same(state,{ foo: 2, bar: 'a' });
state = reducer(state, (actions as any).doBar() );
t.same(state,{ foo: 2, bar: 'aa' });
state = reducer(state, (actions as any).doAll() );
t.same(state,{ foo: 12, bar: 'aab' });
});
tap.test('precedence between root and sub-reducers', async t => {
const {
initial,
reducer,
actions,
} = dux({
initial: {
foo: { bar: 4 },
},
mutations: {
inc: () => (state:any) => {
return {
...state,
surprise: state.foo.bar
}
}
},
subduxes: {
foo: dux({
initial: {
bar: 2,
quux: 3,
},
mutations: {
inc: () => (state:any) => ({...state, bar: state.bar + 1 })
},
}),
}
});
// quick fix until https://github.com/facebook/jest/issues/9531
t.same(initial,{
foo: { bar: 4, quux: 3 }
});
t.same( reducer(undefined,(actions as any).inc() ) ,{
foo: { bar: 5, quux: 3 }, surprise: 5
});
});
function timeout(ms:number) {
return new Promise(resolve => setTimeout(resolve, ms));
}
tap.test( 'middleware', async t => {
const {
middleware,
createStore,
actions,
} = dux({
initial: { result: [] },
mutations: {
inc: (addition:number) => u({ result: r => [ ...r, addition ]}),
doEeet: () => u({ result: r => [ ...r, 'Z' ]}),
},
effects: {
doEeet: api => next => async action => {
api.dispatch( api.actions.inc('a') );
next(action);
await timeout(1000);
api.dispatch( api.actions.inc('c') );
}
},
subduxes: {
foo: dux({
effects: {
doEeet: (api:any) => ( next:any ) => ( action: any ) => {
api.dispatch({ type: 'inc', payload: 'b'});
next(action);
}
}
}),
}
});
const store :any = createStore();
store.dispatch( (actions as any).doEeet() );
t.is(store.getState().result.join(''),'abZ' );
await timeout(1000);
t.is(store.getState().result.join(''), 'abZc' );
});
tap.test( "subduxes and mutations", async t => {
const quux = action('quux');
const foo = dux({
actions: { quux },
mutations: {
quux: () => () => 'x',
blart: () => () => 'a',
}});
const bar = dux({
actions: { quux },
mutations: {
quux: () => () => 'y'
}});
const baz = dux({
actions: { quux },
mutations: {
quux: () => (state:any) => ({...state, "baz": "z" })
}, subduxes: { foo, bar } });
let state = baz.reducer(undefined, (baz.actions as any).quux() );
t.same(state,{
foo: "x",
bar: "y",
baz: "z",
});
});

34
src/tutorial/todos.test.ts
View File

@ -1,34 +0,0 @@
import tap from 'tap';
import Updux from '..';
import {action, payload} from 'ts-action';
type Todo = {
id: number;
description: string;
done: boolean;
};
type TodoStore = {
next_id: number;
todos: Todo[];
};
const todosUpdux = new Updux({
initial: {
next_id: 1,
todos: [],
} as TodoStore
});
tap.test('initial state', async t => {
const store = todosUpdux.createStore();
t.like(store.getState(), {
next_id: 1,
todos: [],
}, 'initial state'
);
});

377
src/types.ts
View File

@ -1,377 +0,0 @@
import { ActionCreator } from 'ts-action';
type MaybePayload<P> = P extends object | string | boolean | number
? {
payload: P;
}
: { payload?: P };
export type Action<T extends string = string, P = any> = {
type: T;
} & MaybePayload<P>;
export type Dictionary<T> = { [key: string]: T };
export type Mutation<S = any, A extends Action = Action> = (
payload: A['payload'],
action: A
) => (state: S) => S;
export type ActionPayloadGenerator = (...args: any[]) => any;
export type MutationEntry = [
ActionCreator | string,
Mutation<any, Action<string, any>>,
boolean?
];
export type GenericActions = Dictionary<
ActionCreator<string, (...args: any) => { type: string }>
>;
export type UnionToIntersection<U> = (U extends any
? (k: U) => void
: never) extends (k: infer I) => void
? I
: never;
export type StateOf<D> = D extends { initial: infer I } ? I : unknown;
export type DuxStateCoduxes<C> = C extends Array<infer U>
? UnionToIntersection<StateOf<U>>
: unknown;
export type DuxStateSubduxes<C> = C extends { '*': infer I }
? {
[key: string]: StateOf<I>;
[index: number]: StateOf<I>;
}
: C extends object
? { [K in keyof C]: StateOf<C[K]> }
: unknown;
type DuxStateGlobSub<S> = S extends { '*': infer I } ? StateOf<I> : unknown;
type LocalDuxState<S> = S extends never[] ? unknown[] : S;
/** @ignore */
type AggDuxState2<L, S, C> = (L extends never[]
? Array<DuxStateGlobSub<S>>
: L & DuxStateSubduxes<S>) &
DuxStateCoduxes<C>;
/** @ignore */
export type AggDuxState<O, S extends UpduxConfig> = unknown extends O
? AggDuxState2<S['initial'], S['subduxes'], S['coduxes']>
: O;
type SelectorsOf<C> = C extends { selectors: infer S } ? S : unknown;
/** @ignore */
export type DuxSelectorsSubduxes<C> = C extends object
? UnionToIntersection<SelectorsOf<C[keyof C]>>
: unknown;
/** @ignore */
export type DuxSelectorsCoduxes<C> = C extends Array<infer U>
? UnionToIntersection<SelectorsOf<U>>
: unknown;
type MaybeReturnType<X> = X extends (...args: any) => any
? ReturnType<X>
: unknown;
type RebaseSelector<S, X> = {
[K in keyof X]: (state: S) => MaybeReturnType<X[K]>;
};
type ActionsOf<C> = C extends { actions: infer A } ? A : {};
type DuxActionsSubduxes<C> = C extends object ? ActionsOf<C[keyof C]> : unknown;
export type DuxActionsCoduxes<C> = C extends Array<infer I>
? UnionToIntersection<ActionsOf<I>>
: {};
type ItemsOf<C> = C extends object ? C[keyof C] : unknown;
export type DuxActions<A, C extends UpduxConfig> = A extends object
? A
: UnionToIntersection<
ActionsOf<C | ItemsOf<C['subduxes']> | ItemsOf<C['coduxes']>>
>;
export type DuxSelectors<S, X, C extends UpduxConfig> = unknown extends X
? RebaseSelector<
S,
C['selectors'] &
DuxSelectorsCoduxes<C['coduxes']> &
DuxSelectorsSubduxes<C['subduxes']>
>
: X;
export type Dux<S = unknown, A = unknown, X = unknown, C = unknown> = {
subduxes: Dictionary<Dux>;
coduxes: Dux[];
initial: AggDuxState<S, C>;
actions: A;
subscriptions: Function[];
};
/**
* Configuration object given to Updux's constructor.
*
* #### arguments
*
* ##### initial
*
* Default initial state of the reducer. If applicable, is merged with
* the subduxes initial states, with the parent having precedence.
*
* If not provided, defaults to an empty object.
*
* ##### actions
*
* [Actions](/concepts/Actions) used by the updux.
*
* ```js
* import { dux } from 'updux';
* import { action, payload } from 'ts-action';
*
* const bar = action('BAR', payload<int>());
* const foo = action('FOO');
*
* const myDux = dux({
* actions: {
* bar
* },
* mutations: [
* [ foo, () => state => state ]
* ]
* });
*
* myDux.actions.foo({ x: 1, y: 2 }); // => { type: foo, x:1, y:2 }
* myDux.actions.bar(2); // => { type: bar, payload: 2 }
* ```
*
* New actions used directly in mutations and effects will be added to the
* dux actions -- that is, they will be accessible via `dux.actions` -- but will
* not appear as part of its Typescript type.
*
* ##### selectors
*
* Dictionary of selectors for the current updux. The updux also
* inherit its subduxes' selectors.
*
* The selectors are available via the class' getter.
*
* ##### mutations
*
* mutations: [
* [ action, mutation, isSink ],
* ...
* ]
*
* or
*
* mutations: {
* action: mutation,
* ...
* }
*
* List of mutations for assign to the dux. If you want Typescript goodness, you
* probably want to use `addMutation()` instead.
*
* In its generic array-of-array form,
* each mutation tuple contains: the action, the mutation,
* and boolean indicating if this is a sink mutation.
*
* The action can be an action creator function or a string. If it's a string, it's considered to be the
* action type and a generic `action( actionName, payload() )` creator will be
* generated for it. If an action is not already defined in the `actions`
* parameter, it'll be automatically added.
*
* The pseudo-action type `*` can be used to match any action not explicitly matched by other mutations.
*
* ```js
* const todosUpdux = updux({
* mutations: {
* add: todo => state => [ ...state, todo ],
* done: done_id => u.map( u.if( ({id} => id === done_id), {done: true} ) ),
* '*' (payload,action) => state => {
* console.warn( "unexpected action ", action.type );
* return state;
* },
* }
* });
* ```
*
* The signature of the mutations is `(payload,action) => state => newState`.
* It is designed to play well with `Updeep` (and [Immer](https://immerjs.github.io/immer/docs/introduction)). This way, instead of doing
*
* ```js
* mutation: {
* renameTodo: newName => state => { ...state, name: newName }
* }
* ```
*
* we can do
*
* ```js
* mutation: {
* renameTodo: newName => u({ name: newName })
* }
* ```
*
* The final argument is the optional boolean `isSink`. If it is true, it'll
* prevent subduxes' mutations on the same action. It defaults to `false`.
*
* The object version of the argument can be used as a shortcut when all actions
* are strings. In that case, `isSink` is `false` for all mutations.
*
* ##### groomMutations
*
* Function that can be provided to alter all local mutations of the updux
* (the mutations of subduxes are left untouched).
*
* Can be used, for example, for Immer integration:
*
* ```js
* import Updux from 'updux';
* import { produce } from 'Immer';
*
* const updux = new Updux({
* initial: { counter: 0 },
* groomMutations: mutation => (...args) => produce( mutation(...args) ),
* mutations: {
* add: (inc=1) => draft => draft.counter += inc
* }
* });
* ```
*
* Or perhaps for debugging:
*
* ```js
* import Updux from 'updux';
*
* const updux = new Updux({
* initial: { counter: 0 },
* groomMutations: mutation => (...args) => state => {
* console.log( "got action ", args[1] );
* return mutation(...args)(state);
* }
* });
* ```
* ##### subduxes
*
* Object mapping slices of the state to sub-upduxes. In addition to creating
* sub-reducers for those slices, it'll make the parend updux inherit all the
* actions and middleware from its subduxes.
*
* For example, if in plain Redux you would do
*
* ```js
* import { combineReducers } from 'redux';
* import todosReducer from './todos';
* import statisticsReducer from './statistics';
*
* const rootReducer = combineReducers({
* todos: todosReducer,
* stats: statisticsReducer,
* });
* ```
*
* then with Updux you'd do
*
* ```js
* import { updux } from 'updux';
* import todos from './todos';
* import statistics from './statistics';
*
* const rootUpdux = updux({
* subduxes: {
* todos,
* statistics
* }
* });
* ```
*
* ##### effects
*
* Array of arrays or plain object defining asynchronous actions and side-effects triggered by actions.
* The effects themselves are Redux middleware, with the `dispatch`
* property of the first argument augmented with all the available actions.
*
* ```
* updux({
* effects: {
* fetch: ({dispatch}) => next => async (action) => {
* next(action);
*
* let result = await fetch(action.payload.url).then( result => result.json() );
* dispatch.fetchSuccess(result);
* }
* }
* });
* ```
*
* @example
*
* ```
* import Updux from 'updux';
* import { actions, payload } from 'ts-action';
* import u from '@yanick/updeep';
*
* const todoUpdux = new Updux({
* initial: {
* done: false,
* note: "",
* },
* actions: {
* finish: action('FINISH', payload()),
* edit: action('EDIT', payload()),
* },
* mutations: [
* [ edit, note => u({note}) ]
* ],
* selectors: {
* getNote: state => state.note
* },
* groomMutations: mutation => transform(mutation),
* subduxes: {
* foo
* },
* effects: {
* finish: () => next => action => {
* console.log( "Woo! one more bites the dust" );
* }
* }
* })
* ```
*/
export type UpduxConfig = Partial<{
initial: unknown /** foo */;
subduxes: Dictionary<Dux>;
coduxes: Dux[];
actions: Dictionary<ActionCreator>;
selectors: Dictionary<Selector>;
mutations: any;
groomMutations: (m: Mutation) => Mutation;
effects: any;
subscriptions: Function[];
}>;
export type Upreducer<S = any> = (action: Action) => (state: S) => S;
/** @ignore */
export interface UpduxMiddlewareAPI<S = any, X = Dictionary<Selector>> {
dispatch: Function;
getState(): S;
selectors: X;
actions: Dictionary<ActionCreator>;
}
export type UpduxMiddleware<S = any, X = Dictionary<Selector>, A = Action> = (
api: UpduxMiddlewareAPI<S, X>
) => (next: Function) => (action: A) => any;
export type Selector<S = any> = (state: S) => unknown;
export type DuxState<D> = D extends { initial: infer S } ? S : unknown;

576
src/updux.ts
View File

@ -1,576 +0,0 @@
import fp from 'lodash/fp';
import { action, payload, ActionCreator, ActionType } from 'ts-action';
import { AnyAction } from 'redux';
import buildInitial from './buildInitial';
import buildMutations from './buildMutations';
import buildCreateStore from './buildCreateStore';
import buildMiddleware, { effectToMw, Effect } from './buildMiddleware';
import buildUpreducer from './buildUpreducer';
import {
UpduxConfig,
Dictionary,
Action,
Mutation,
Upreducer,
UpduxMiddleware,
Selector,
Dux,
UnionToIntersection,
AggDuxState,
DuxSelectors,
DuxActions,
} from './types';
import { Store, PreloadedState } from 'redux';
import buildSelectors from './buildSelectors';
type Merge<T> = UnionToIntersection<T[keyof T]>;
type ActionsOf<U> = U extends Updux ? U['actions'] : {};
//| ActionsOf<SubduxesOf<U>[keyof SubduxesOf<U>]>
export type UpduxActions<U> = U extends Updux
? UnionToIntersection<
UpduxLocalActions<U> | ActionsOf<CoduxesOf<U>[keyof CoduxesOf<U>]>
>
: {};
export type UpduxLocalActions<S> = S extends Updux<any, null>
? {}
: S extends Updux<any, infer A>
? A
: {};
export type CoduxesOf<U> = U extends Updux<any, any, any, infer S> ? S : [];
type StoreWithDispatchActions<
S = any,
Actions = { [action: string]: (...args: any) => Action }
> = Store<S> & {
dispatch: { [type in keyof Actions]: (...args: any) => void };
};
function wrap_subscription(sub) {
return store => {
const sub_curried = sub(store);
let previous: unknown;
return (state, unsubscribe) => {
if (state === previous) return;
previous = state;
return sub_curried(state, unsubscribe);
};
};
}
function _subscribeToStore(store: any, subscriptions: Function[] = []) {
subscriptions.forEach(sub => {
const subscriber = sub(store);
let unsub = store.subscribe(() => {
const state = store.getState();
return subscriber(state, unsub);
});
});
}
function sliced_subscription(slice, sub) {
return store => {
const sub_curried = sub(store);
return (state, unsubscribe) =>
sub_curried(fp.get(slice, state), unsubscribe);
};
}
/**
* @public
* `Updux` is a way to minimize and simplify the boilerplate associated with the
* creation of a `Redux` store. It takes a shorthand configuration
* object, and generates the appropriate reducer, actions, middleware, etc.
* In true `Redux`-like fashion, upduxes can be made of sub-upduxes (`subduxes` for short) for different slices of the root state.
*/
export class Updux<
S = unknown,
A = null,
X = unknown,
C extends UpduxConfig = {}
> {
subduxes: Dictionary<Dux>;
coduxes: Dux[];
private localSelectors: Dictionary<Selector> = {};
private localInitial: unknown;
groomMutations: (mutation: Mutation<S>) => Mutation<S>;
private localEffects: Effect[] = [];
private localActions: Dictionary<ActionCreator> = {};
private localMutations: Dictionary<
Mutation<S> | [Mutation<S>, boolean | undefined]
> = {};
private localSubscriptions: Function[] = [];
get initial(): AggDuxState<S, C> {
return buildInitial(
this.localInitial,
this.coduxes.map(({ initial }) => initial),
fp.mapValues('initial', this.subduxes)
) as any;
}
/**
* @param config an [[UpduxConfig]] plain object
*
*/
constructor(config: C = {} as C) {
this.localInitial = config.initial ?? {};
this.localSelectors = config.selectors ?? {};
this.coduxes = config.coduxes ?? [];
this.subduxes = config.subduxes ?? {};
Object.entries(config.actions ?? {}).forEach(args =>
(this.addAction as any)(...args)
);
this.coduxes.forEach((c: any) =>
Object.entries(c.actions).forEach(args =>
(this.addAction as any)(...args)
)
);
Object.values(this.subduxes).forEach((c: any) => {
Object.entries(c.actions).forEach(args => {
(this.addAction as any)(...args);
});
});
if (config.subscriptions) {
config.subscriptions.forEach(sub => this.addSubscription(sub));
}
this.groomMutations = config.groomMutations ?? ((x: Mutation<S>) => x);
let effects = config.effects ?? [];
if (!Array.isArray(effects)) {
effects = (Object.entries(effects) as unknown) as Effect[];
}
effects.forEach(effect => (this.addEffect as any)(...effect));
let mutations = config.mutations ?? [];
if (!Array.isArray(mutations)) {
mutations = fp.toPairs(mutations);
}
mutations.forEach(args => (this.addMutation as any)(...args));
/*
Object.entries(selectors).forEach(([name, sel]: [string, Function]) =>
this.addSelector(name, sel as Selector)
);
Object.entries(
fp.mapValues((value: UpduxConfig | Updux) =>
fp.isPlainObject(value) ? new Updux(value as any) : value
)(fp.getOr({}, 'subduxes', config))
).forEach(([slice, sub]) => (this.subduxes[slice] = sub as any));
const actions = fp.getOr({}, 'actions', config);
Object.entries(actions as any).forEach(([type, p]: [string, any]): any =>
this.addAction((p as any).type ? p : action(type, p))
);
*/
}
/**
* Array of middlewares aggregating all the effects defined in the
* updux and its subduxes. Effects of the updux itself are
* done before the subduxes effects.
* Note that `getState` will always return the state of the
* local updux.
*
* @example
*
* ```
* const middleware = updux.middleware;
* ```
*/
get middleware(): UpduxMiddleware<
AggDuxState<S, C>,
DuxSelectors<AggDuxState<S, C>, X, C>
> {
const selectors = this.selectors;
const actions = this.actions;
return buildMiddleware(
this.localEffects.map(effect =>
effectToMw(effect, actions as any, selectors as any)
),
(this.coduxes as any).map(fp.get('middleware')) as any,
fp.mapValues('middleware', this.subduxes)
) as any;
}
/**
* Action creators for all actions defined or used in the actions, mutations, effects and subduxes
* of the updux config.
*
* Non-custom action creators defined in `actions` have the signature `(payload={},meta={}) => ({type,
* payload,meta})` (with the extra sugar that if `meta` or `payload` are not
* specified, that key won't be present in the produced action).
*
* The same action creator can be included
* in multiple subduxes. However, if two different creators
* are included for the same action, an error will be thrown.
*
* @example
*
* ```
* const actions = updux.actions;
* ```
*/
get actions(): DuxActions<A, C> {
// UpduxActions<Updux<S,A,SUB,CO>> {
return this.localActions as any;
}
get upreducer(): Upreducer<S> {
return buildUpreducer(this.initial, this.mutations as any) as any;
}
/**
* A Redux reducer generated using the computed initial state and
* mutations.
*/
get reducer(): (state: S | undefined, action: Action) => S {
return (state, action) => this.upreducer(action)(state as S);
}
/**
* Merge of the updux and subduxes mutations. If an action triggers
* mutations in both the main updux and its subduxes, the subduxes
* mutations will be performed first.
*/
get mutations(): Dictionary<Mutation<S>> {
return buildMutations(
this.localMutations,
fp.mapValues('upreducer', this.subduxes as any),
fp.map('upreducer', this.coduxes as any)
);
}
/**
* Returns the upreducer made of the merge of all sudbuxes reducers, without
* the local mutations. Useful, for example, for sink mutations.
*
* @example
*
* ```
* import todo from './todo'; // updux for a single todo
* import Updux from 'updux';
* import u from '@yanick/updeep';
*
* const todos = new Updux({ initial: [], subduxes: { '*': todo } });
* todos.addMutation(
* todo.actions.done,
* ({todo_id},action) => u.map( u.if( u.is('id',todo_id) ), todos.subduxUpreducer(action) )
* true
* );
* ```
*
*
*
*/
get subduxUpreducer() {
return buildUpreducer(this.initial, buildMutations({}, this.subduxes));
}
/**
* Returns a `createStore` function that takes two argument:
* `initial` and `injectEnhancer`. `initial` is a custom
* initial state for the store, and `injectEnhancer` is a function
* taking in the middleware built by the updux object and allowing
* you to wrap it in any enhancer you want.
*
* @example
*
* ```
* const createStore = updux.createStore;
*
* const store = createStore(initial);
* ```
*
*
*
*/
createStore(...args: any) {
const store = buildCreateStore<AggDuxState<S, C>, DuxActions<A, C>>(
this.reducer as any,
this.middleware as any,
this.actions
)(...args);
_subscribeToStore(store, this.subscriptions);
return store;
}
/**
* Returns an array of all subscription functions registered for the dux.
* Subdux subscriptions are wrapped such that they are getting their
* local state. Also all subscriptions are further wrapped such that
* they are only called when the local state changed
*/
get subscriptions() {
let subscriptions = ([
this.localSubscriptions,
Object.entries(this.subduxes).map(([slice, subdux]) => {
return subdux.subscriptions.map(sub =>
sliced_subscription(slice, sub)
);
}),
] as any).flat(Infinity);
return subscriptions.map(sub => wrap_subscription(sub));
}
/**
* Returns a <a href="https://github.com/erikras/ducks-modular-redux">ducks</a>-like
* plain object holding the reducer from the Updux object and all
* its trimmings.
*
* @example
*
* ```
* const {
* createStore,
* upreducer,
* subduxes,
* coduxes,
* middleware,
* actions,
* reducer,
* mutations,
* initial,
* selectors,
* subscriptions,
* } = myUpdux.asDux;
* ```
*
*
*
*
*/
get asDux() {
return {
createStore: this.createStore.bind(this),
upreducer: this.upreducer,
subduxes: this.subduxes,
coduxes: this.coduxes,
middleware: this.middleware,
actions: this.actions,
reducer: this.reducer,
mutations: this.mutations,
initial: this.initial,
selectors: this.selectors,
subscriptions: this.subscriptions,
};
}
/**
* Adds a mutation and its associated action to the updux.
*
* @param isSink - If `true`, disables the subduxes mutations for this action. To
* conditionally run the subduxes mutations, check out [[subduxUpreducer]]. Defaults to `false`.
*
* @remarks
*
* If a local mutation was already associated to the action,
* it will be replaced by the new one.
*
*
* @example
*
* ```js
* updux.addMutation(
* action('ADD', payload<int>() ),
* inc => state => state + in
* );
* ```
*/
addMutation<A extends ActionCreator>(
creator: A,
mutation: Mutation<S, ActionType<A>>,
isSink?: boolean
);
addMutation<A extends ActionCreator = any>(
creator: string,
mutation: Mutation<S, any>,
isSink?: boolean
);
addMutation<A extends ActionCreator = any>(creator, mutation, isSink) {
const c = this.addAction(creator);
this.localMutations[c.type] = [
this.groomMutations(mutation as any) as Mutation<S>,
isSink,
];
}
addEffect<AC extends ActionCreator>(
creator: AC,
middleware: UpduxMiddleware<
AggDuxState<S, C>,
DuxSelectors<AggDuxState<S, C>, X, C>,
ReturnType<AC>
>,
isGenerator?: boolean
);
addEffect(
creator: string,
middleware: UpduxMiddleware<
AggDuxState<S, C>,
DuxSelectors<AggDuxState<S, C>, X, C>
>,
isGenerator?: boolean
);
addEffect(creator, middleware, isGenerator = false) {
const c = this.addAction(creator);
this.localEffects.push([c.type, middleware, isGenerator] as any);
}
// can be
//addAction( actionCreator )
// addAction( 'foo', transform )
/**
* Adds an action to the updux. It can take an already defined action
* creator, or any arguments that can be passed to `actionCreator`.
* @example
* ```
* const action = updux.addAction( name, ...creatorArgs );
* const action = updux.addAction( otherActionCreator );
* ```
* @example
* ```
* import {actionCreator, Updux} from 'updux';
*
* const updux = new Updux();
*
* const foo = updux.addAction('foo');
* const bar = updux.addAction( 'bar', (x) => ({stuff: x+1}) );
*
* const baz = actionCreator( 'baz' );
*
* foo({ a: 1}); // => { type: 'foo', payload: { a: 1 } }
* bar(2); // => { type: 'bar', payload: { stuff: 3 } }
* baz(); // => { type: 'baz', payload: undefined }
* ```
*/
addAction(theaction: string, transform?: any): ActionCreator<string, any>;
addAction(
theaction: string | ActionCreator<any>,
transform?: never
): ActionCreator<string, any>;
addAction(actionIn: any, transform: any) {
let name: string;
let creator: ActionCreator;
if (typeof actionIn === 'string') {
name = actionIn;
if (transform) {
creator = transform.type
? transform
: action(name, (...args: any) => ({
payload: transform(...args),
}));
} else {
creator = this.localActions[name] ?? action(name, payload());
}
} else {
name = actionIn.type;
creator = actionIn;
}
const already = this.localActions[name];
if (!already)
return ((this.localActions as any)[name] = creator) as any;
if (already !== creator && already.type !== '*') {
throw new Error(`action ${name} already exists`);
}
return already;
}
get _middlewareEntries() {
const groupByOrder = (mws: any) =>
fp.groupBy(
([, , actionType]: any) =>
['^', '$'].includes(actionType) ? actionType : 'middle',
mws
);
const subs = fp.flow([
fp.toPairs,
fp.map(([slice, updux]) =>
updux._middlewareEntries.map(([u, ps, ...args]: any) => [
u,
[slice, ...ps],
...args,
])
),
fp.flatten,
groupByOrder,
])(this.subduxes);
const local = groupByOrder(
this.localEffects.map(x => [this, [], ...x])
);
return fp.flatten(
[
local['^'],
subs['^'],
local.middle,
subs.middle,
subs['$'],
local['$'],
].filter(x => x)
);
}
addSelector(name: string, selector: Selector) {
this.localSelectors[name] = selector;
}
/**
A dictionary of the updux's selectors. Subduxes'
selectors are included as well (with the mapping to the
sub-state already taken care of you).
*/
get selectors(): DuxSelectors<AggDuxState<S, C>, X, C> {
return buildSelectors(
this.localSelectors,
fp.map('selectors', this.coduxes),
fp.mapValues('selectors', this.subduxes)
) as any;
}
/**
* Add a subscription to the dux.
*/
addSubscription(subscription: Function) {
this.localSubscriptions = [...this.localSubscriptions, subscription];
}
}
export default Updux;

22
src/updux/createStore.test.ts
View File

@ -1,22 +0,0 @@
import tap from 'tap';
import { expectType } from 'tsd';
import { dux } from '..';
import { action } from 'ts-action';
const d = dux({
initial: 123,
actions: {
foo: action('foo'),
},
});
expectType<number>( d.createStore().getState() );
tap.equal(d.createStore().getState(), 123, 'default initial state');
tap.equal(d.createStore(456).getState(), 456, 'given initial state');
expectType<{ foo: Function }>( d.createStore().actions );
tap.pass('we have actions');

75
tools/gen_sidebar.pl
View File

@ -1,75 +0,0 @@
#!/usr/bin/env perl
use 5.30.0;
use warnings;
use experimental qw/
signatures
postderef
/;
use Path::Tiny;
use Path::Tiny::Glob pathglob => { all => 1};
use File::Serialize;
use List::AllUtils qw/ before_incl /;
use List::UtilsBy qw/ partition_by /;
my $api = deserialize_file './temp/updux.api.json';
my @lines = generate_index([$api]);
my $sidebar = path('docs/_sidebar.md');
$sidebar->spew(
( before_incl { /!-- API/ } $sidebar->lines ),
map { "$_\n" } @lines
);
sub generate_index($entries,$indent = 2) {
my @lines;
my %sections = partition_by {
$_->{kind}
} @$entries;
for my $type ( sort keys %sections ) {
my $entries = $sections{$type};
if ( $type eq 'Constructor' ) {
push @lines, sprintf "%s- [%s](%s)",
" " x $indent, 'Constructor', ref2link(@$entries);
next;
}
push @lines, join '', " " x $indent, '- ', $type unless $type eq 'EntryPoint';
for my $entry ( @$entries ) {
my $i = $indent;
if( $entry->{name} ){
my $link = ref2link($entry);
push @lines, sprintf "%s- [%s](%s)",
" " x (++$i), $entry->{name}, $link;
}
my $members = $entry->{members} or next;
push @lines, generate_index($members, $i+1);
}
}
return @lines;
}
sub ref2link($entry) {
return "/4-API/".
lc( $entry->{canonicalReference} =~ s/!|#/./gr
=~ s/:constructor/._constructor_/r
=~ s/:\w+//r
=~ s/\)//r
=~ s/\((\d+)/'_' . ($1-1)/er
=~ s/_0//r ). '.md'
;
}

66
tsconfig.json
View File

@ -1,66 +0,0 @@
{
"include": [
"./src/**/*"
],
"compilerOptions": {
/* Basic Options */
"incremental": true, /* Enable incremental compilation */
"target": "ES2019", /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019' or 'ESNEXT'. */
"module": "commonjs", /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */
"lib": [ "dom", "es2019" ], /* Specify library files to be included in the compilation. */
"allowJs": false, /* Allow javascript files to be compiled. */
// "checkJs": true, /* Report errors in .js files. */
// "jsx": "preserve", /* Specify JSX code generation: 'preserve', 'react-native', or 'react'. */
"declaration": true, /* Generates corresponding '.d.ts' file. */
"declarationMap": true, /* Generates a sourcemap for each corresponding '.d.ts' file. */
"sourceMap": true, /* Generates corresponding '.map' file. */
// "outFile": "./", /* Concatenate and emit output to single file. */
"outDir": "./dist", /* Redirect output structure to the directory. */
"rootDir": "./src", /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */
//"composite": true, /* Enable project compilation */
// "tsBuildInfoFile": "./", /* Specify file to store incremental compilation information */
"removeComments": false, /* Do not emit comments to output. */
// "noEmit": true, /* Do not emit outputs. */
// "importHelpers": true, /* Import emit helpers from 'tslib'. */
// "downlevelIteration": true, /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */
// "isolatedModules": true, /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */
/* Strict Type-Checking Options */
"strict": true, /* Enable all strict type-checking options. */
"noImplicitAny": false, /* Raise error on expressions and declarations with an implied 'any' type. */
// "strictNullChecks": true, /* Enable strict null checks. */
// "strictFunctionTypes": true, /* Enable strict checking of function types. */
// "strictBindCallApply": true, /* Enable strict 'bind', 'call', and 'apply' methods on functions. */
// "strictPropertyInitialization": true, /* Enable strict checking of property initialization in classes. */
// "noImplicitThis": true, /* Raise error on 'this' expressions with an implied 'any' type. */
// "alwaysStrict": true, /* Parse in strict mode and emit "use strict" for each source file. */
/* Additional Checks */
// "noUnusedLocals": true, /* Report errors on unused locals. */
// "noUnusedParameters": true, /* Report errors on unused parameters. */
// "noImplicitReturns": true, /* Report error when not all code paths in function return a value. */
// "noFallthroughCasesInSwitch": true, /* Report errors for fallthrough cases in switch statement. */
/* Module Resolution Options */
// "moduleResolution": "node", /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */
// "baseUrl": "./", /* Base directory to resolve non-absolute module names. */
// "paths": {}, /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */
// "rootDirs": [], /* List of root folders whose combined content represents the structure of the project at runtime. */
// "typeRoots": [], /* List of folders to include type definitions from. */
// "types": [], /* Type declaration files to be included in compilation. */
// "allowSyntheticDefaultImports": true, /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */
"esModuleInterop": true, /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */
// "preserveSymlinks": true, /* Do not resolve the real path of symlinks. */
// "allowUmdGlobalAccess": true, /* Allow accessing UMD globals from modules. */
/* Source Map Options */
// "sourceRoot": "", /* Specify the location where debugger should locate TypeScript files instead of source locations. */
// "mapRoot": "", /* Specify the location where debugger should locate map files instead of generated locations. */
// "inlineSourceMap": true, /* Emit a single file with source maps instead of having a separate file. */
// "inlineSources": true, /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */
/* Experimental Options */
"experimentalDecorators": true /* Enables experimental support for ES7 decorators. */
// "emitDecoratorMetadata": true, /* Enables experimental support for emitting type metadata for decorators. */
}
}

10
typedoc.json
View File

@ -1,10 +0,0 @@
{
"theme": "markdown",
"out": "docs/API",
"mode": "modules",
"excludePrivate": true,
"excludeNotExported": true,
"hideSources": true,
"includeVersion": true,
"exclude": [ "src/**/*test.ts" ]
}