it begins

docs/recipes.md

@@ -4,7 +4,7 @@
 
 Say you have a `todos` state that is an array of `todo` sub-states, with some
 actions that should percolate to all todos, and some that should only
-percolate to one. One way to model this is via updux's splat subduxes 
+percolate to one. One way to model this is via updux's splat subduxes
 (backed by `updeep`'s own '*'-key behavior).
 
 ```
@@ -55,7 +55,7 @@ const updux = new Updux({
         add: (inc=1) => state => ({ counter: state.counter + inc })
     }
 });
-    
+
 ```
 
 Converting it to Immer would look like:
@@ -68,10 +68,10 @@ import { produce } from 'immer';
 const updux = new Updux({
     initial: { counter: 0 },
     mutations: {
-        add: (inc=1) => produce( draft => draft.counter += inc ) } 
+        add: (inc=1) => produce( draft => draft.counter += inc ) }
     }
 });
-    
+
 ```
 
 But since typing `produce` over and over is no fun, `groomMutations`
@@ -86,11 +86,8 @@ const updux = new Updux({
     initial: { counter: 0 },
     groomMutations: mutation => (...args) => produce( mutation(...args) ),
     mutations: {
-        add: (inc=1) => draft => draft.counter += inc 
+        add: (inc=1) => draft => draft.counter += inc
     }
 });
-    
+
 ```
-
-
-

docs/recipes.test.js

@@ -51,4 +51,3 @@ test( "tutorial", async () => {
     ]);
 
 });
-

docs/tutorial-reactions.test.js

@@ -37,4 +37,3 @@ test( "basic tests", async () => {
 
     expect(store.getState().nbrTodos).toEqual(2);
 });
-

docs/tutorial.md

@@ -15,7 +15,7 @@ plain JavaScript.
 To begin with, let's define that has nothing but an initial state.
 
 ```js
-import { Updux } from 'updux';
+import Updux from 'updux';
 
 const todosDux = new Updux({
     initial: {
@@ -158,9 +158,9 @@ todosDux.setSelector('getTodoById', getTodoById);
 
 ### Accessing selectors
 
-The `getState` method of a dux store is augmented 
+The `getState` method of a dux store is augmented
 with its selectors, with the first call for the state already
-called in for you. 
+called in for you.
 
 ```js
 const store = todosDux.createStore();
@@ -204,7 +204,7 @@ const todosDux = new Updux({
         addTodoWithId: todo =>
             u.updateIn( 'todos', todos => [ ...todos, todo] ),
         incrementNextId: () => u({ nextId: fp.add(1) }),
-        todoDone: (id) => u.updateIn('todos', 
+        todoDone: (id) => u.updateIn('todos',
             u.map( u.if( fp.matches({id}), todo => u({done: true}, todo) ) )
         ),
     },
@@ -404,4 +404,3 @@ const myDux = new Updux({
 [immer]: https://www.npmjs.com/package/immer
 [lodash]: https://www.npmjs.com/package/lodash
 [ts-action]: https://www.npmjs.com/package/ts-action
-

foo.ts

@@ -0,0 +1,6 @@
+const foo = <A, B>(x: Partial<{ a: A; b: B }>) => x as B;
+
+const y = foo({
+    a: 'potato',
+    b: 2,
+});

out/Updux.html

@@ -19,7 +19,7 @@
 
     <h1 class="page-title">Class: Updux</h1>
 
-    
+
 
 
 
@@ -27,24 +27,24 @@
 <section>
 
 <header>
-    
+
         <h2><span class="attribs"><span class="type-signature"></span></span>Updux<span class="signature">()</span><span class="type-signature"></span></h2>
-        
+
-    
+
 </header>
 
 <article>
     <div class="container-overview">
-    
-        
 
-    
 
-    
+
+
+
+
     <h4 class="name" id="Updux"><span class="type-signature"></span>new Updux<span class="signature">()</span><span class="type-signature"></span></h4>
-    
 
-    
+
+
 
 
 
@@ -62,42 +62,42 @@
 
 <dl class="details">
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
+
+
+
+
+
+
+
+
+
+
+
+
+
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
         <a href="Updux.js.html">Updux.js</a>, <a href="Updux.js.html#line24">line 24</a>
     </li></ul></dd>
-    
 
-    
 
-    
 
-    
+
+
+
+
 </dl>
 
 
@@ -119,33 +119,33 @@
 
 
 
-    
+
     </div>
 
-    
 
-    
 
-    
+
+
+
         <h3 class="subsection-title">Classes</h3>
 
         <dl>
             <dt><a href="Updux.html">Updux</a></dt>
             <dd></dd>
         </dl>
-    
 
-    
 
-    
 
-    
 
-    
+
+
+
+
+
         <h3 class="subsection-title">Members</h3>
 
-        
+
-            
+
 <h4 class="name" id="actions"><span class="type-signature"></span>actions<span class="type-signature"></span></h4>
 
 
@@ -159,42 +159,42 @@
 
 <dl class="details">
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
+
+
+
+
+
+
+
+
+
+
+
+
+
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
         <a href="Updux.js.html">Updux.js</a>, <a href="Updux.js.html#line111">line 111</a>
     </li></ul></dd>
-    
 
-    
 
-    
 
-    
+
+
+
+
 </dl>
 
 
@@ -202,8 +202,8 @@
 
 
 
-        
+
-            
+
 <h4 class="name" id="initial"><span class="type-signature"></span>initial<span class="type-signature"></span></h4>
 
 
@@ -217,42 +217,42 @@
 
 <dl class="details">
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
 
-    
+
+
+
+
+
+
+
+
+
+
+
+
+
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
         <a href="Updux.js.html">Updux.js</a>, <a href="Updux.js.html#line104">line 104</a>
     </li></ul></dd>
-    
 
-    
 
-    
 
-    
+
+
+
+
 </dl>
 
 
@@ -260,14 +260,14 @@
 
 
 
-        
-    
 
-    
 
-    
 
-    
+
+
+
+
+
 </article>
 
 </section>
@@ -290,4 +290,4 @@
 <script> prettyPrint(); </script>
 <script src="scripts/linenumber.js"> </script>
 </body>
-</html>
+</html>

out/Updux.js.html

@@ -19,11 +19,11 @@
 
     <h1 class="page-title">Source: Updux.js</h1>
 
-    
 
 
 
-    
+
+
     <section>
         <article>
             <pre class="prettyprint source linenums"><code>/* TODO change * for leftovers to +, change subscriptions to reactions */

out/fonts/OpenSans-Bold-webfont.svg

@@ -1827,4 +1827,4 @@
 <hkern u1="&#x201e;" u2="G" k="102" />
 <hkern u1="&#x201e;" u2="C" k="102" />
 </font>
-</defs></svg> 
+</defs></svg>

out/fonts/OpenSans-BoldItalic-webfont.svg

@@ -1827,4 +1827,4 @@
 <hkern u1="&#x201e;" u2="G" k="102" />
 <hkern u1="&#x201e;" u2="C" k="102" />
 </font>
-</defs></svg> 
+</defs></svg>

out/fonts/OpenSans-Italic-webfont.svg

@@ -1827,4 +1827,4 @@
 <hkern u1="&#x201e;" u2="G" k="102" />
 <hkern u1="&#x201e;" u2="C" k="102" />
 </font>
-</defs></svg> 
+</defs></svg>

out/fonts/OpenSans-Light-webfont.svg

@@ -1828,4 +1828,4 @@
 <hkern u1="&#x201e;" u2="G" k="102" />
 <hkern u1="&#x201e;" u2="C" k="102" />
 </font>
-</defs></svg> 
+</defs></svg>

out/fonts/OpenSans-LightItalic-webfont.svg

@@ -1832,4 +1832,4 @@
 <hkern g1="uniFB00" u2="&#x27;" k="-123" />
 <hkern g1="uniFB00" u2="&#x22;" k="-123" />
 </font>
-</defs></svg> 
+</defs></svg>

out/fonts/OpenSans-Regular-webfont.svg

@@ -1828,4 +1828,4 @@
 <hkern u1="&#x201e;" u2="G" k="102" />
 <hkern u1="&#x201e;" u2="C" k="102" />
 </font>
-</defs></svg> 
+</defs></svg>

out/index.html

@@ -19,11 +19,11 @@
 
     <h1 class="page-title">Home</h1>
 
-    
 
 
 
-    
+
+
 
 
     <h3> </h3>
@@ -37,7 +37,7 @@
 
 
 
-    
+
 
 
 
@@ -62,4 +62,4 @@
 <script> prettyPrint(); </script>
 <script src="scripts/linenumber.js"> </script>
 </body>
-</html>
+</html>

package.json

@@ -36,6 +36,7 @@
         "eslint-plugin-todo-plz": "^1.2.1",
         "jsdoc-to-markdown": "^7.1.1",
         "prettier": "^2.7.1",
+        "typescript": "^4.9.5",
         "vitest": "0.23.1"
     }
 }

pnpm-lock.yaml

@@ -12,6 +12,7 @@ specifiers:
   prettier: ^2.7.1
   redux: ^4.2.0
   remeda: ^1.0.1
+  typescript: ^4.9.5
   updeep: ^1.2.1
   vitest: 0.23.1
 
@@ -30,6 +31,7 @@ devDependencies:
   eslint-plugin-todo-plz: 1.2.1_eslint@8.22.0
   jsdoc-to-markdown: 7.1.1
   prettier: 2.7.1
+  typescript: 4.9.5
   vitest: 0.23.1_kkczkm7y7wgspdnr2rpymavxge
 
 packages:
@@ -2028,6 +2030,12 @@ packages:
     engines: {node: '>=10'}
     dev: true
 
+  /typescript/4.9.5:
+    resolution: {integrity: sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g==}
+    engines: {node: '>=4.2.0'}
+    hasBin: true
+    dev: true
+
   /typical/2.6.1:
     resolution: {integrity: sha512-ofhi8kjIje6npGozTip9Fr8iecmYfEbS06i0JnIg+rh51KakryWF4+jX8lLKZVhy6N+ID45WYSFCxPOdTWCzNg==}
     dev: true

src/Updux.ts

@@ -0,0 +1 @@
+export default class Updux { }

src/buildMiddleware/index.ts

@@ -26,14 +26,14 @@ export function augmentMiddlewareApi(api, actions, selectors) {
 
                 return result;
             };
-        })
+        }),
     );
 
     Object.assign(
         dispatch,
         mapValues(actions, (action) => {
             return (...args) => api.dispatch(action(...args));
-        })
+        }),
     );
 
     return {
@@ -70,16 +70,16 @@ export function buildMiddleware(
     dux = undefined,
 ) {
     let inner = map(sub, ({ middleware }, slice) =>
-        slice !== '*' && middleware ? sliceMw(slice, middleware) : undefined
+        slice !== '*' && middleware ? sliceMw(slice, middleware) : undefined,
     ).filter((x) => x);
 
     const local = effects.map((effect) =>
-        effectToMiddleware(effect, actions, selectors)
+        effectToMiddleware(effect, actions, selectors),
     );
 
     let mws = [...local, ...inner];
 
-    if( wrapper ) mws = wrapper(mws,dux);
+    if (wrapper) mws = wrapper(mws, dux);
 
     return composeMw(mws);
 }

src/buildSelectors/index.ts

@@ -3,7 +3,7 @@ import { map, mapValues, merge } from 'lodash-es';
 export function buildSelectors(
     localSelectors,
     splatSelector = {},
-    subduxes = {}
+    subduxes = {},
 ) {
     const subSelectors = map(subduxes, ({ selectors }, slice) => {
         if (!selectors) return {};
@@ -11,7 +11,7 @@ export function buildSelectors(
 
         return mapValues(
             selectors,
-            (func: Function) => (state) => func(state[slice])
+            (func: Function) => (state) => func(state[slice]),
         );
     });
 
@@ -28,8 +28,8 @@ export function buildSelectors(
                     res,
                     mapValues(
                         subduxes['*'].selectors,
-                        (selector) => () => selector(value)
+                        (selector) => () => selector(value),
-                    )
+                    ),
                 );
             };
     }

src/index.ts

@@ -0,0 +1,3 @@
+import Updux from './Updux';
+
+export default Updux;

src/tutorial.test.ts

@@ -0,0 +1,22 @@
+import Updux from './index.js';
+
+const expectType = <T>(value: T) => value;
+
+test('initial state', () => {
+    const { initial } = new Updux({
+        initial: {
+            next_id: 1,
+            todos: [],
+        },
+    });
+
+    expectType<{
+        next_id: number;
+        todos: unknown[];
+    }>(initial);
+
+    expect(initial).toEqual({
+        next_id: 1,
+        todos: [],
+    });
+});

tsconfig.json

@@ -0,0 +1,105 @@
+{
+    "compilerOptions": {
+        /* Visit https://aka.ms/tsconfig to read more about this file */
+
+        /* Projects */
+        // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
+        // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
+        // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
+        // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
+        // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
+        // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
+
+        /* Language and Environment */
+        "target": "es2016" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
+        // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
+        // "jsx": "preserve",                                /* Specify what JSX code is generated. */
+        // "experimentalDecorators": true,                   /* Enable experimental support for TC39 stage 2 draft decorators. */
+        // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
+        // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
+        // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
+        // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
+        // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
+        // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
+        // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
+        // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
+
+        /* Modules */
+        "module": "ES2020" /* Specify what module code is generated. */,
+        // "rootDir": "./",                                  /* Specify the root folder within your source files. */
+        // "moduleResolution": "node",                       /* Specify how TypeScript looks up a file from a given module specifier. */
+        // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
+        // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
+        // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
+        // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
+        "types": [
+            "vitest/globals"
+        ] /* Specify type package names to be included without being referenced in a source file. */,
+        // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
+        // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
+        // "resolveJsonModule": true,                        /* Enable importing .json files. */
+        // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
+
+        /* JavaScript Support */
+        // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
+        // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
+        // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
+
+        /* Emit */
+        // "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
+        // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
+        // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
+        // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
+        // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
+        // "outDir": "./",                                   /* Specify an output folder for all emitted files. */
+        // "removeComments": true,                           /* Disable emitting comments. */
+        // "noEmit": true,                                   /* Disable emitting files from a compilation. */
+        // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
+        // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types. */
+        // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
+        // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
+        // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
+        // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
+        // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
+        // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
+        // "newLine": "crlf",                                /* Set the newline character for emitting files. */
+        // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
+        // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
+        // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
+        // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
+        // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
+        // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
+
+        /* Interop Constraints */
+        // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
+        // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
+        "esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
+        // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
+        "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
+
+        /* Type Checking */
+        "strict": true /* Enable all strict type-checking options. */,
+        // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
+        // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
+        // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
+        // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
+        // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
+        // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
+        // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
+        // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
+        // "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
+        // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
+        // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
+        // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
+        // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
+        // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
+        // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
+        // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
+        // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
+        // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
+
+        /* Completeness */
+        // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
+        "skipLibCheck": true /* Skip type checking all .d.ts files. */
+    }
+}

vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+    test: {
+        globals: true,
+        isolate: false,
+    },
+});