New Release 🎉

.changeset/brave-kiwis-film.md

@@ -0,0 +1,37 @@
+---
+'@agile-ts/core': minor
+'@agile-ts/react': minor
+'@agile-ts/vue': minor
+'@agile-ts/api': patch
+'cra-template-agile': patch
+'cra-template-agile-typescript': patch
+'@agile-ts/event': patch
+'@agile-ts/logger': patch
+'@agile-ts/multieditor': patch
+'@agile-ts/proxytree': patch
+'@agile-ts/utils': patch
+---
+
+#### :rocket: New Feature
+* `core`, `multieditor`, `react`, `vue`
+    * [#161](https://github.com/agile-ts/agile/pull/161) Subscribe to Group value or output ([@bennodev19](https://github.com/bennodev19))
+* `core`
+    * [#160](https://github.com/agile-ts/agile/pull/160) added null option to Selector ([@bennodev19](https://github.com/bennodev19))
+    * [#159](https://github.com/agile-ts/agile/pull/159) make compute method async compatible ([@bennodev19](https://github.com/bennodev19))
+
+#### :bug: Bug Fix
+* `core`
+    * [#152](https://github.com/agile-ts/agile/pull/152) Fix remove selected Item loop ([@bennodev19](https://github.com/bennodev19))
+
+#### :nail_care: Polish
+* `core`, `multieditor`, `react`, `vue`
+    * [#161](https://github.com/agile-ts/agile/pull/161) Subscribe to Group value or output ([@bennodev19](https://github.com/bennodev19))
+* `core`, `cra-template-agile-typescript`, `cra-template-agile`, `event`, `logger`, `multieditor`, `proxytree`, `react`, `utils`, `vue`
+    * [#153](https://github.com/agile-ts/agile/pull/153) refactor core descriptions ([@bennodev19](https://github.com/bennodev19))
+* `core`, `event`, `react`, `vue`
+    * [#154](https://github.com/agile-ts/agile/pull/154) Optimise Runtime ([@bennodev19](https://github.com/bennodev19))
+* `core`, `proxytree`
+    * [#150](https://github.com/agile-ts/agile/pull/150) Outsource log messages ([@bennodev19](https://github.com/bennodev19))
+
+#### Committers: 1
+- BennoDev ([@bennodev19](https://github.com/bennodev19))

.github/workflows/release.yaml

@@ -31,4 +31,4 @@ jobs:
           title: Next Release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}

README.md

@@ -49,7 +49,7 @@ const App = new Agile();
 const MY_FIRST_STATE = App.createState("Hello Friend!");
 
 
-// -- myComponent.whatever ------------------------------------------
+// -- MyComponent.whatever ------------------------------------------
 
 // 3️⃣ Bind initialized State to desired UI-Component
 // And wolla, it's reactive. Everytime the State mutates the Component rerenders
@@ -82,8 +82,10 @@ Besides States, AgileTs offers some other powerful APIs that make your life easi
 The philosophy behind AgileTs is simple:
 
 ### 🚅 Straightforward
+
 Write minimalistic, boilerplate-free code that captures your intent.
 ```ts
+const MY_STATE = App.createState('frank'); // Create State
 MY_STATE.set('jeff'); // Update State value
 MY_STATE.undo(); // Undo latest State value change
 MY_STATE.is({hello: "jeff"}); // Check if State has the value '{hello: "jeff"}'
@@ -101,6 +103,7 @@ MY_STATE.watch((value) => {console.log(value);}); // Watch on State changes
   const MY_COLLECTION = App.createCollection();
   MY_COLLECTION.collect({id: 1, name: "Frank"});
   MY_COLLECTION.collect({id: 2, name: "Dieter"});
+  MY_COLLECTION.update(1, {name: "Jeff"});
   ```
 - Compute State depending on other States
   ```ts

examples/react/develop/functional-component-ts/.env

@@ -1,2 +1 @@
 SKIP_PREFLIGHT_CHECK=true
-BROWSER=chrome

examples/react/develop/functional-component-ts/package.json

@@ -30,7 +30,7 @@
     "build": "react-scripts build",
     "test": "react-scripts test",
     "eject": "react-scripts eject",
-    "install:agile": "yalc add @agile-ts/core @agile-ts/react @agile-ts/api @agile-ts/multieditor @agile-ts/event & yarn install"
+    "install:agile": "yalc add @agile-ts/core @agile-ts/react @agile-ts/api @agile-ts/multieditor @agile-ts/event @agile-ts/proxytree & yarn install"
   },
   "eslintConfig": {
     "extends": "react-app"

examples/react/develop/functional-component-ts/src/App.tsx

@@ -1,9 +1,10 @@
 import React, { useEffect } from 'react';
 import './App.css';
-import { useAgile, useWatcher, useProxy } from '@agile-ts/react';
+import { useAgile, useWatcher, useProxy, useSelector } from '@agile-ts/react';
 import { useEvent } from '@agile-ts/event';
 import {
   COUNTUP,
+  externalCreatedItem,
   MY_COLLECTION,
   MY_COMPUTED,
   MY_EVENT,
@@ -12,7 +13,7 @@ import {
   MY_STATE_3,
   STATE_OBJECT,
 } from './core';
-import { generateId, globalBind } from '@agile-ts/core';
+import { generateId, globalBind, Item } from '@agile-ts/core';
 
 let rerenderCount = 0;
 let rerenderCountInCountupView = 0;
@@ -42,11 +43,14 @@ const App = (props: any) => {
   ]);
   const [myGroup] = useAgile([MY_COLLECTION.getGroupWithReference('myGroup')]);
 
-  const [stateObject, item2, collection2] = useProxy([
-    STATE_OBJECT,
-    MY_COLLECTION.getItem('id2'),
-    MY_COLLECTION,
-  ]);
+  const selectedObjectItem = useSelector(STATE_OBJECT, (value) => {
+    return value.age;
+  });
+
+  const [stateObject, item2, collection2] = useProxy(
+    [STATE_OBJECT, MY_COLLECTION.getItem('id2'), MY_COLLECTION],
+    { key: 'useProxy' }
+  );
 
   console.log('Item1: ', item2?.name);
   console.log('Collection: ', collection2.slice(0, 2));
@@ -106,7 +110,8 @@ const App = (props: any) => {
         <div className={'Container'}>
           <h3 className={'Title'}>My State Object</h3>
           <p>
-            Deep Name: {stateObject.friends.hans.name} {stateObject.location}
+            Deep Name: {stateObject?.friends?.hans?.name}{' '}
+            {stateObject?.location}
           </p>
           <button
             onClick={() => {
@@ -132,21 +137,29 @@ const App = (props: any) => {
         <div className={'Container'}>
           <h3 className={'Title'}>My Collection</h3>
           <div>
-            {myGroup.map((item) => (
-              <p key={item.id}>{item.name}</p>
+            {myGroup?.map((item) => (
+              <p key={item.key}>{item.name}</p>
             ))}
           </div>
           <button
-            onClick={() => MY_COLLECTION.collect({ id: 'id3', name: 'Test3' })}>
+            onClick={() =>
+              MY_COLLECTION.collect({ key: 'id3', name: 'Test3' })
+            }>
             Collect
           </button>
+          <button
+            onClick={() =>
+              MY_COLLECTION.collect(externalCreatedItem, ['myGroup'])
+            }>
+            Collect external Item
+          </button>
           <button onClick={() => MY_COLLECTION.getGroup('myGroup')?.add('id3')}>
             Add to myGroup
           </button>
           <button
             onClick={() =>
               MY_COLLECTION.update('id3', {
-                id: 'newId3',
+                key: 'newId3',
                 name: 'Test3_Changed',
               })
             }>

examples/react/develop/functional-component-ts/src/core/index.ts

@@ -1,4 +1,4 @@
-import { Agile, clone, Logger } from '@agile-ts/core';
+import { Agile, clone, Item, Logger } from '@agile-ts/core';
 import Event from '@agile-ts/event';
 
 export const myStorage: any = {};
@@ -64,32 +64,41 @@ export const MY_COMPUTED = App.createComputed<string>(() => {
 }, []).setKey('myComputed');
 
 interface collectionValueInterface {
-  id: string;
+  key: string;
   name: string;
 }
 
 export const MY_COLLECTION = App.createCollection<collectionValueInterface>(
   (collection) => ({
     key: 'my-collection',
+    primaryKey: 'key',
     groups: {
       myGroup: collection.Group(['id4']),
     },
     selectors: {
       mySelector: collection.Selector('id3'),
     },
-    initialData: [{ id: 'id4', name: 'hans' }],
+    initialData: [
+      { key: 'id4', name: 'hans' } as any,
+      { key: 'frank', name: 'frank' },
+    ],
   })
 ).persist();
-MY_COLLECTION.collect({ id: 'id1', name: 'test' });
-MY_COLLECTION.collect({ id: 'id2', name: 'test2' }, 'myGroup');
-MY_COLLECTION.update('id1', { id: 'id1Updated', name: 'testUpdated' });
+MY_COLLECTION.collect({ key: 'id1', name: 'test' });
+MY_COLLECTION.collect({ key: 'id2', name: 'test2' }, 'myGroup');
+MY_COLLECTION.update('id1', { key: 'id1Updated', name: 'testUpdated' });
 MY_COLLECTION.getGroup('myGroup')?.persist({
   followCollectionPersistKeyPattern: true,
 });
 MY_COLLECTION.onLoad(() => {
   console.log('On Load MY_COLLECTION');
 });
 
+export const externalCreatedItem = new Item(MY_COLLECTION, {
+  key: 'id10',
+  name: 'test',
+}).persist({ followCollectionPersistKeyPattern: true });
+
 console.log('Initial: myCollection ', clone(MY_COLLECTION));
 
 export const MY_EVENT = new Event<{ name: string }>(App, {

examples/react/develop/functional-component-ts/yarn.lock

@@ -3,46 +3,46 @@
 
 
 "@agile-ts/api@file:.yalc/@agile-ts/api":
-  version "0.0.16"
+  version "0.0.18"
   dependencies:
-    "@agile-ts/utils" "^0.0.2"
+    "@agile-ts/utils" "^0.0.4"
 
 "@agile-ts/core@file:.yalc/@agile-ts/core":
-  version "0.0.15"
+  version "0.0.17"
   dependencies:
-    "@agile-ts/logger" "^0.0.2"
-    "@agile-ts/utils" "^0.0.2"
+    "@agile-ts/logger" "^0.0.4"
+    "@agile-ts/utils" "^0.0.4"
 
 "@agile-ts/event@file:.yalc/@agile-ts/event":
-  version "0.0.5"
+  version "0.0.7"
 
-"@agile-ts/logger@^0.0.2":
-  version "0.0.2"
-  resolved "https://registry.yarnpkg.com/@agile-ts/logger/-/logger-0.0.2.tgz#80a726531dd63ca7d1c9a123383e57b5501efbb0"
-  integrity sha512-rJJ5pqXtOriYxjuZPhHs2J9N1FnIaAZqItCw0MXW9/5od/uhJ28aiG7w9RUBZts9SjDcICYEfjFMcTJ/kYJsMg==
+"@agile-ts/logger@^0.0.4":
+  version "0.0.4"
+  resolved "https://registry.yarnpkg.com/@agile-ts/logger/-/logger-0.0.4.tgz#7f4d82ef8f03b13089af0878c360575c43f0962d"
+  integrity sha512-qm0obAKqJMaPKM+c76gktRXyw3OL1v39AnhMZ0FBGwJqHWU+fLRkCzlQwjaROCr3F1XP01Lc/Ls3efF0WzyEPw==
   dependencies:
-    "@agile-ts/utils" "^0.0.2"
+    "@agile-ts/utils" "^0.0.4"
 
 "@agile-ts/multieditor@file:.yalc/@agile-ts/multieditor":
-  version "0.0.15"
+  version "0.0.17"
 
-"@agile-ts/proxytree@^0.0.2":
-  version "0.0.2"
-  resolved "https://registry.yarnpkg.com/@agile-ts/proxytree/-/proxytree-0.0.2.tgz#516ed19ee8d58aeecb291788a1e47be3dc23df8c"
-  integrity sha512-PbSiChF0GcUoWnrbnHauzBxZ5r/+4pZSZWpYjkBcIFa48DgTtFzg5DfQzsW3Rc1Y0QSFGYqcZOvCK1xAjLIQ2g==
+"@agile-ts/proxytree@^0.0.3":
+  version "0.0.3"
+  resolved "https://registry.yarnpkg.com/@agile-ts/proxytree/-/proxytree-0.0.3.tgz#e3dacab123a311f2f0d4a0369793fe90fdab7569"
+  integrity sha512-auO6trCo7ivLJYuLjxrnK4xuUTangVPTq8UuOMTlGbJFjmb8PLEkaXuRoVGSzv9jsT2FeS7KsP7Fs+yvv0WPdg==
 
 "@agile-ts/proxytree@file:.yalc/@agile-ts/proxytree":
-  version "0.0.1"
+  version "0.0.3"
 
 "@agile-ts/react@file:.yalc/@agile-ts/react":
-  version "0.0.16"
+  version "0.0.18"
   dependencies:
-    "@agile-ts/proxytree" "^0.0.2"
+    "@agile-ts/proxytree" "^0.0.3"
 
-"@agile-ts/utils@^0.0.2":
-  version "0.0.2"
-  resolved "https://registry.yarnpkg.com/@agile-ts/utils/-/utils-0.0.2.tgz#5f03761ace569b6c9ddd28c22f7b0fbec8b006b1"
-  integrity sha512-LqgQyMdK+zDuTCmOX6FOxTH4JNXhEvGFqIyNqRDoP99BK6MHGrK+n7nOW+1b4x6ZCYe0+VmwtG5CeOPOm3Siow==
+"@agile-ts/utils@^0.0.4":
+  version "0.0.4"
+  resolved "https://registry.yarnpkg.com/@agile-ts/utils/-/utils-0.0.4.tgz#66e9536e561796489a37155da6b74ce2dc482697"
+  integrity sha512-GiZyTYmCm4j2N57oDjeMuPpfQdgn9clb0Cxpfuwi2Bq5T/KPXlaROLsVGwHLjwwT+NX7xxr5qNJH8pZTnHnYRQ==
 
 "@babel/code-frame@7.8.3":
   version "7.8.3"

examples/react/develop/simple-counter/.env

@@ -0,0 +1 @@
+SKIP_PREFLIGHT_CHECK=true

examples/react/develop/simple-counter/.gitignore

@@ -0,0 +1,2 @@
+build
+node_modules

examples/react/develop/simple-counter/README.md

@@ -0,0 +1,9 @@
+## Simple Counter
+
+This app was created to compare different bundle sizes of projects using a third party State-Manager.
+https://twitter.com/dai_shi/status/1396976791940595713?s=20
+
+- context: https://codesandbox.io/s/react-context-counters-eky4f
+- jotai: https://codesandbox.io/s/jotai-counters-zn16r
+- valtio: https://codesandbox.io/s/valtio-counters-y3632
+- zustand: https://codesandbox.io/s/zustand-counters-9k48i

examples/react/develop/simple-counter/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "counter",
+  "version": "0.1.0",
+  "private": true,
+  "dependencies": {
+    "@agile-ts/core": "^0.0.17",
+    "@agile-ts/react": "^0.0.18",
+    "react": "17.0.2",
+    "react-dom": "17.0.2",
+    "react-scripts": "4.0.0"
+  },
+  "devDependencies": {
+    "source-map-explorer": "^2.5.2"
+  },
+  "scripts": {
+    "start": "react-scripts start",
+    "build": "react-scripts build",
+    "test": "react-scripts test",
+    "eject": "react-scripts eject",
+    "analyze": "source-map-explorer 'build/static/js/*.js'"
+  },
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 1 chrome version",
+      "last 1 firefox version",
+      "last 1 safari version"
+    ]
+  }
+}

examples/react/develop/simple-counter/public/index.html

@@ -0,0 +1,43 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <link rel="icon" href="%PUBLIC_URL%/favicon.ico" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="theme-color" content="#000000" />
+    <meta
+      name="description"
+      content="Web site created using create-react-app"
+    />
+    <link rel="apple-touch-icon" href="%PUBLIC_URL%/logo192.png" />
+    <!--
+      manifest.json provides metadata used when your web app is installed on a
+      user's mobile device or desktop. See https://developers.google.com/web/fundamentals/web-app-manifest/
+    -->
+    <link rel="manifest" href="%PUBLIC_URL%/manifest.json" />
+    <!--
+      Notice the use of %PUBLIC_URL% in the tags above.
+      It will be replaced with the URL of the `public` folder during the build.
+      Only files inside the `public` folder can be referenced from the HTML.
+
+      Unlike "/favicon.ico" or "favicon.ico", "%PUBLIC_URL%/favicon.ico" will
+      work correctly both with client-side routing and a non-root public URL.
+      Learn how to configure a non-root public URL by running `npm run build`.
+    -->
+    <title>React App</title>
+  </head>
+  <body>
+    <noscript>You need to enable JavaScript to run this app.</noscript>
+    <div id="root"></div>
+    <!--
+      This HTML file is a template.
+      If you open it directly in the browser, you will see an empty page.
+
+      You can add webfonts, meta tags, or analytics to this file.
+      The build step will place the bundled scripts into the <body> tag.
+
+      To begin the development, run `npm start` or `yarn start`.
+      To create a production bundle, use `npm run build` or `yarn build`.
+    -->
+  </body>
+</html>