neo.mjs 10.0.0-alpha.2 → 10.0.0-alpha.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/.github/CODING_GUIDELINES.md +1 -1
  2. package/README.md +52 -11
  3. package/ServiceWorker.mjs +2 -2
  4. package/apps/portal/index.html +1 -1
  5. package/apps/portal/view/home/FooterContainer.mjs +1 -1
  6. package/apps/portal/view/learn/ContentComponent.mjs +2 -1
  7. package/apps/portal/view/learn/MainContainerStateProvider.mjs +3 -6
  8. package/apps/realworld/view/HomeComponent.mjs +1 -1
  9. package/apps/realworld/view/user/ProfileComponent.mjs +1 -1
  10. package/apps/sharedcovid/view/MainContainerController.mjs +1 -1
  11. package/apps/shareddialog/view/MainContainerController.mjs +2 -2
  12. package/examples/component/gallery/ImageStore.mjs +2 -2
  13. package/examples/component/helix/ImageStore.mjs +2 -2
  14. package/learn/README.md +83 -0
  15. package/learn/guides/ApplicationBootstrap.md +354 -0
  16. package/learn/guides/DeclarativeComponentTreesVsImperativeVdom.md +500 -0
  17. package/learn/guides/WorkingWithVDom.md +748 -0
  18. package/learn/tree.json +53 -0
  19. package/package.json +2 -2
  20. package/src/DefaultConfig.mjs +27 -14
  21. package/src/Main.mjs +1 -7
  22. package/src/Neo.mjs +16 -0
  23. package/src/button/Base.mjs +2 -2
  24. package/src/calendar/view/MainContainerStateProvider.mjs +1 -1
  25. package/src/grid/header/Button.mjs +1 -1
  26. package/src/layout/Cube.mjs +2 -2
  27. package/src/main/DeltaUpdates.mjs +20 -12
  28. package/src/main/addon/Navigator.mjs +1 -1
  29. package/src/main/addon/WindowPosition.mjs +1 -1
  30. package/src/main/render/StringBasedRenderer.mjs +1 -1
  31. package/src/tab/header/Toolbar.mjs +1 -1
  32. package/src/table/header/Button.mjs +1 -1
  33. package/src/toolbar/Base.mjs +1 -1
  34. package/src/util/VDom.mjs +1 -1
  35. package/src/util/VNode.mjs +1 -1
  36. package/src/vdom/Helper.mjs +96 -49
  37. package/src/vdom/VNode.mjs +38 -2
  38. package/src/worker/App.mjs +2 -1
  39. package/src/worker/Base.mjs +87 -5
  40. package/src/worker/Manager.mjs +86 -28
  41. package/resources/data/deck/learnneo/tree.json +0 -50
  42. package/resources/data/deck/whyneo.md +0 -80
  43. /package/{resources/data/deck/learnneo/pages → learn}/Glossary.md +0 -0
  44. /package/{resources/data/deck/learnneo/pages → learn}/UsingTheseTopics.md +0 -0
  45. /package/{resources/data/deck/learnneo/pages → learn}/benefits/ConfigSystem.md +0 -0
  46. /package/{resources/data/deck/learnneo/pages → learn}/benefits/Effort.md +0 -0
  47. /package/{resources/data/deck/learnneo/pages → learn}/benefits/Features.md +0 -0
  48. /package/{resources/data/deck/learnneo/pages → learn}/benefits/FormsEngine.md +0 -0
  49. /package/{resources/data/deck/learnneo/pages → learn}/benefits/FourEnvironments.md +0 -0
  50. /package/{resources/data/deck/learnneo/pages → learn}/benefits/Introduction.md +0 -0
  51. /package/{resources/data/deck/learnneo/pages → learn}/benefits/MultiWindow.md +0 -0
  52. /package/{resources/data/deck/learnneo/pages → learn}/benefits/OffTheMainThread.md +0 -0
  53. /package/{resources/data/deck/learnneo/pages → learn}/benefits/Quick.md +0 -0
  54. /package/{resources/data/deck/learnneo/pages → learn}/benefits/Speed.md +0 -0
  55. /package/{resources/data/deck/learnneo/pages → learn}/gettingstarted/ComponentModels.md +0 -0
  56. /package/{resources/data/deck/learnneo/pages → learn}/gettingstarted/Config.md +0 -0
  57. /package/{resources/data/deck/learnneo/pages → learn}/gettingstarted/DescribingTheUI.md +0 -0
  58. /package/{resources/data/deck/learnneo/pages → learn}/gettingstarted/Events.md +0 -0
  59. /package/{resources/data/deck/learnneo/pages → learn}/gettingstarted/Extending.md +0 -0
  60. /package/{resources/data/deck/learnneo/pages → learn}/gettingstarted/References.md +0 -0
  61. /package/{resources/data/deck/learnneo/pages → learn}/gettingstarted/Setup.md +0 -0
  62. /package/{resources/data/deck/learnneo/pages → learn}/gettingstarted/Workspaces.md +0 -0
  63. /package/{resources/data/deck/learnneo/pages → learn}/guides/ComponentsAndContainers.md +0 -0
  64. /package/{resources/data/deck/learnneo/pages → learn}/guides/CustomComponents.md +0 -0
  65. /package/{resources/data/deck/learnneo/pages → learn}/guides/Forms.md +0 -0
  66. /package/{resources/data/deck/learnneo/pages → learn}/guides/InstanceLifecycle.md +0 -0
  67. /package/{resources/data/deck/learnneo/pages → learn}/guides/Layouts.md +0 -0
  68. /package/{resources/data/deck/learnneo/pages → learn}/guides/MainThreadAddonExample.md +0 -0
  69. /package/{resources/data/deck/learnneo/pages → learn}/guides/MainThreadAddonIntro.md +0 -0
  70. /package/{resources/data/deck/learnneo/pages → learn}/guides/Mixins.md +0 -0
  71. /package/{resources/data/deck/learnneo/pages → learn}/guides/MultiWindow.md +0 -0
  72. /package/{resources/data/deck/learnneo/pages → learn}/guides/PortalApp.md +0 -0
  73. /package/{resources/data/deck/learnneo/pages → learn}/guides/StateProviders.md +0 -0
  74. /package/{resources/data/deck/learnneo/pages → learn}/guides/Tables.md +0 -0
  75. /package/{resources/data/deck/learnneo/pages → learn}/guides/events/CustomEvents.md +0 -0
  76. /package/{resources/data/deck/learnneo/pages → learn}/guides/events/DomEvents.md +0 -0
  77. /package/{resources/data/deck/learnneo/pages → learn}/javascript/ClassFeatures.md +0 -0
  78. /package/{resources/data/deck/learnneo/pages → learn}/javascript/Classes.md +0 -0
  79. /package/{resources/data/deck/learnneo/pages → learn}/javascript/NewNode.md +0 -0
  80. /package/{resources/data/deck/learnneo/pages → learn}/javascript/Overrides.md +0 -0
  81. /package/{resources/data/deck/learnneo/pages → learn}/javascript/Super.md +0 -0
  82. /package/{resources/data/deck/learnneo/pages → learn}/tutorials/Earthquakes.md +0 -0
  83. /package/{resources/data/deck/learnneo/pages → learn}/tutorials/RSP.md +0 -0
  84. /package/{resources/data/deck/learnneo/pages → learn}/tutorials/TodoList.md +0 -0
  85. /package/resources/data/{deck/learnneo/data/theBeatles.json → theBeatles.json} +0 -0
@@ -1,50 +0,0 @@
1
- {"data": [
2
- {"name": "Using These Topics", "parentId": null, "id": "UsingTheseTopics" },
3
- {"name": "Benefits", "parentId": null, "isLeaf": false, "id": "Benefits"},
4
- {"name": "Introduction ", "parentId": "Benefits", "id": "benefits.Introduction"},
5
- {"name": "Off the Main Thread", "parentId": "Benefits", "id": "benefits.OffTheMainThread"},
6
- {"name": "4 Environments", "parentId": "Benefits", "id": "benefits.FourEnvironments"},
7
- {"name": "Unified Config System", "parentId": "Benefits", "id": "benefits.ConfigSystem"},
8
- {"name": "Extreme Speed", "parentId": "Benefits", "id": "benefits.Speed"},
9
- {"name": "Multi-Window Applications", "parentId": "Benefits", "id": "benefits.MultiWindow"},
10
- {"name": "Quick Application Development", "parentId": "Benefits", "id": "benefits.Quick"},
11
- {"name": "Complexity and Effort", "parentId": "Benefits", "id": "benefits.Effort"},
12
- {"name": "Forms Engine", "parentId": "Benefits", "id": "benefits.FormsEngine"},
13
- {"name": "Features and Benefits Summary", "parentId": "Benefits", "id": "benefits.Features"},
14
- {"name": "Getting Started", "parentId": null, "isLeaf": false, "id": "GettingStarted", "collapsed": true},
15
- {"name": "Setup", "parentId": "GettingStarted", "id": "gettingstarted.Setup"},
16
- {"name": "Workspaces and Applications", "parentId": "GettingStarted", "id": "gettingstarted.Workspaces"},
17
- {"name": "Describing a View", "parentId": "GettingStarted", "id": "gettingstarted.DescribingTheUI"},
18
- {"name": "Events", "parentId": "GettingStarted", "id": "gettingstarted.Events"},
19
- {"name": "Component References", "parentId": "GettingStarted", "id": "gettingstarted.References"},
20
- {"name": "Extending Classes", "parentId": "GettingStarted", "id": "gettingstarted.Extending"},
21
- {"name": "Config", "parentId": "GettingStarted", "id": "gettingstarted.Config"},
22
- {"name": "Shared Bindable Data", "parentId": "GettingStarted", "id": "gettingstarted.ComponentModels"},
23
- {"name": "Tutorials", "parentId": null, "isLeaf": false, "id": "Tutorials", "collapsed": true},
24
- {"name": "Rock Scissors Paper", "parentId": "Tutorials", "id": "tutorials.RSP", "hidden": true},
25
- {"name": "Earthquakes", "parentId": "Tutorials", "id": "tutorials.Earthquakes"},
26
- {"name": "Todo List", "parentId": "Tutorials", "id": "tutorials.TodoList"},
27
- {"name": "Guides", "parentId": null, "isLeaf": false, "id": "InDepth", "collapsed": true},
28
- {"name": "Instance Lifecycle", "parentId": "InDepth", "id": "guides.InstanceLifecycle", "hidden": true},
29
- {"name": "User Input (Forms)", "parentId": "InDepth", "id": "guides.Forms", "hidden": true},
30
- {"name": "Component and Container Basics", "parentId": "InDepth", "id": "guides.ComponentsAndContainers"},
31
- {"name": "Layouts", "parentId": "InDepth", "isLeaf": false, "id": "guides.Layouts", "hidden": true},
32
- {"name": "Shared Bindable Data (State Providers)", "parentId": "InDepth", "id": "guides.StateProviders"},
33
- {"name": "Custom Components", "parentId": "InDepth", "id": "guides.CustomComponents", "hidden": true},
34
- {"name": "Events", "parentId": "InDepth", "isLeaf": false, "id": "GuideEvents"},
35
- {"name": "Custom Events", "parentId": "GuideEvents", "id": "guides.events.CustomEvents"},
36
- {"name": "DOM Events", "parentId": "GuideEvents", "id": "guides.events.DomEvents"},
37
- {"name": "Portal App", "parentId": "InDepth", "id": "guides.PortalApp"},
38
- {"name": "Tables (Stores)", "parentId": "InDepth", "id": "guides.Tables", "hidden": true},
39
- {"name": "Multi-Window Applications", "parentId": "InDepth", "id": "guides.MultiWindow", "hidden": true},
40
- {"name": "Main Thread Addons", "parentId": "InDepth", "isLeaf": false, "id": "MainThreadAddons", "hidden": true},
41
- {"name": "Introduction", "parentId": "MainThreadAddons", "id": "guides.MainThreadAddonIntro"},
42
- {"name": "Example", "parentId": "MainThreadAddons", "id": "guides.MainThreadAddonExample"},
43
- {"name": "Mixins", "parentId": "InDepth", "id": "guides.Mixins", "hidden": true},
44
- {"name": "JavaScript Classes", "parentId": null, "isLeaf": false, "id": "JavaScript", "hidden": true},
45
- {"name": "Classes, Properties, and Methods", "parentId": "JavaScript", "id": "javascript.Classes"},
46
- {"name": "Overriding Methods", "parentId": "JavaScript", "id": "javascript.Overrides"},
47
- {"name": "Other JavaScript Class Features", "parentId": "JavaScript", "id": "javascript.ClassFeatures"},
48
- {"name": "Super", "parentId": "JavaScript", "id": "javascript.Super"},
49
- {"name": "New Node", "parentId": "JavaScript", "id": "javascript.NewNode"}
50
- ]}
@@ -1,80 +0,0 @@
1
-
2
- #hi
3
-
4
-
5
- Neo.mjs is a framework used to create browser-based applications.
6
-
7
- Some key features and benefits of Neo.mjs are:
8
-
9
- <div type="expander" caption="Multi-Threaded">
10
- <p>
11
- When a Neo.mjs application starts, the framework spawns three web-workers.
12
- Web-workers are each run in their own thread. As a result, a typical Neo.mjs application
13
- has four threads:
14
- <ol>
15
- <li>The _main_ thread, where DOM updates are applied
16
- <li>An _application_ web-worker where normal application locic is run
17
- <li>A _data_ web-worker were HTTP and socket calls are run
18
- <li>A _view_ web-worker that manages delta updates
19
- </ol>
20
- </div>
21
-
22
- <div type="expander" caption="Extreme Speed">
23
- <p>
24
- The Neo.mjs web-worker proccesses are automatically run in parallel, on separate CPU cores.
25
- </p>
26
- <p>
27
- By contrast, other JavaScript frameworks run in a single thread. That means
28
- in a typical framework all business logic, data handling, and DOM rendering compete for
29
- CPU reasources.
30
- </p>
31
- <p>
32
- This means Neo.mjs applications run and render faster. This is
33
- particularly beneficial for processor- and data-intensive applications,
34
- and applications that need to rapidly update what's viewed. In testing, Neo.mjs applications
35
- easily apply over 20,000 DOM updates per second.
36
- </p>
37
- <p>
38
- If the default four threads aren't enough, you're free to launch additional web-worker threads
39
- to run other specialized logic.
40
- </p>
41
- </div>
42
-
43
- <div type="expander" caption="Quick Application Development">
44
- <p>
45
- Neo.js classes let you specify properties in a way that allows code to detect "before" and "after"
46
- changes. This makes it easy to handle value validation and transformation, and react to changes.
47
- </p>
48
- <p>
49
- Neo.mjs also has elegant yet powerful state management features that make it easy to create shared,
50
- bindable data. For example, if two components are bound to the same propery, a change to the
51
- property will automatically be applied to both components.
52
- </p>
53
- </div>
54
-
55
- <div type="expander" caption="Multi-Window Applications">
56
- <p>
57
- Neo.mjs applications can also launch as _shared web workers_, which allows you to have a single
58
- application run in multiple browser windows; those windows could be moved to multiple monitors.
59
- </p>
60
- <p>
61
- For example, you can have a data analysis application with a control panel on one monitor,
62
- tabular data in another, and charts on another &mdash; all sharing the same data, handling events
63
- across windows, running seamlessly as a single application.
64
- </p>
65
- </div>
66
-
67
- <div type="expander" caption="Open-Source and Standards-Based">
68
- <p>
69
- Neo.mjs is an open-source library. Features needed for the community can be added to the
70
- library via pull-requests. And since Neo.mjs uses the standard JavaScript class system,
71
- all Neo.mjs classes can be extended.
72
- </p>
73
- <p>
74
- Neo.mjs uses standard modular JavaScript, so developers don't need to learn non-standard language
75
- syntax, and there's no need for special pre-compilers or WebPack modules.
76
- That means fewer dependencies and easier configuration. Furthermore, the use of
77
- standard JavaScript makes debugging easier: any statement you write while developing your
78
- applcation can also be run in the debugging console.
79
- </p>
80
- </div>