@eldrex/papyr-charts 3.0.1

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.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Eldrex Delos Reyes Bula
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,111 @@
1
+ # πŸ“„ Papyr.js β€” Simple Inside, Beautiful Outside
2
+
3
+ > **Write modern, secure, and reactive web applications with zero dependencies and zero compile steps.**
4
+
5
+ ---
6
+
7
+ ## ⏱️ Start in 60 Seconds
8
+
9
+ Create an HTML file and run this minimal working code:
10
+
11
+ ```html
12
+ <!DOCTYPE html>
13
+ <html lang="en">
14
+ <head>
15
+ <meta charset="UTF-8">
16
+ <title>Hello Papyr.js</title>
17
+ <!-- Include CDN -->
18
+ <script src="https://papyrus-js.vercel.app/papyr-complete.js"></script>
19
+ </head>
20
+ <body>
21
+ <div id="app"></div>
22
+ <script>
23
+ // Create reactive state
24
+ let count = papyr.state(0);
25
+
26
+ // Render UI
27
+ let app = papyr.div({ style: { padding: '40px', fontFamily: 'sans-serif' } },
28
+ papyr.h1("Greetings from Papyr.js! πŸš€"),
29
+ papyr.button(
30
+ () => `Clicked ${count.value} times`,
31
+ {
32
+ onclick: () => count.value++,
33
+ style: { padding: '10px 20px', borderRadius: '6px', cursor: 'pointer' }
34
+ }
35
+ )
36
+ );
37
+
38
+ papyr.mount("#app", app);
39
+ </script>
40
+ </body>
41
+ </html>
42
+ ```
43
+
44
+ ---
45
+
46
+ ## πŸ’‘ What is Papyr?
47
+ * **Direct DOM Rendering:** Updates only the targeted DOM nodes when state changesβ€”bypassing Virtual DOM diff overhead.
48
+ * **Reactive State Engine:** Precise, dependency-tracking subscription-based reactivity (inspired by SolidJS and Vue).
49
+ * **Zero Dependencies:** A single unified file that packages layout grids, animations, local storage databases, and AI helpers.
50
+
51
+ ---
52
+
53
+ ## πŸ› οΈ What You Can Build
54
+ * **Aesthetic Portals & Dashboards:** Built-in HSL theme engines, collapsible persistent sidebars, and responsive viewport folding structures.
55
+ * **Offline-First CRUD Apps:** Synchronized SQLite, IndexedDB, and LocalStorage drivers.
56
+ * **Cinematic Micro-Interactions:** Touch gesture trackers, particle backgrounds, and hardware-accelerated Verlet physics integrations.
57
+
58
+ ---
59
+
60
+ ## 🎯 Core Idea
61
+
62
+ $$ \text{State} \rightarrow \text{UI updates automatically} $$
63
+
64
+ When a state's `.value` mutations occur, the Papyr Runtime Engine executes targeted updates specifically on the elements that referenced that state.
65
+
66
+ ---
67
+
68
+ ## πŸ“š Learn Next
69
+
70
+ Explore the official documentation:
71
+
72
+ * πŸš€ [Getting Started](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/docs/getting-started.md) β€” Turn from a beginner into a user in 10 minutes.
73
+ * 🧠 [The Papyr Way](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/docs/papyr-way.md) β€” Master the architectural mental models.
74
+ * πŸ“¦ [Core Concepts](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/docs/core-concepts.md) β€” Understand reactivity flow, state, and rendering.
75
+ * πŸ“– [Master API Reference](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/docs/api/) β€” Read the individual subsystem reference modules.
76
+ * πŸ” [Practical Recipes](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/docs/recipes/) β€” Copy-paste common UI/data patterns.
77
+ * πŸ›‘οΈ [Security & WATT](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/docs/guides/security.md) β€” Learn about Web Access Transparency Toolkit.
78
+
79
+ ---
80
+
81
+ ## πŸ§ͺ Interactive Demos
82
+
83
+ Run and inspect the interactive test suites inside the browser:
84
+ * πŸ“ [Interactive Todo Checklist](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/tests/todo.html)
85
+ * πŸ’Ύ [Multi-Engine CRUD Database Sandbox](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/tests/crud.html)
86
+ * 🎬 [Touch Gestures & Spring Physics Sandbox](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/tests/animation.html)
87
+ * πŸ“ˆ [Canvas Formula Graphing Plotter](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/tests/charts.html)
88
+
89
+ ---
90
+
91
+ ## βš™οΈ Installation
92
+
93
+ ### CDN (Zero Build Setup)
94
+ Include the compiled single runtime module inside your HTML:
95
+ ```html
96
+ <script src="https://papyrus-js.vercel.app/papyr-complete.js"></script>
97
+ ```
98
+
99
+ ### Package Manager
100
+ ```bash
101
+ npm install @eldrex/papyr
102
+ ```
103
+
104
+ ```javascript
105
+ import { papyr } from '@eldrex/papyr';
106
+ ```
107
+
108
+ ---
109
+
110
+ ## πŸ“„ License
111
+ Papyr.js is distributed under the [MIT License](file:///c:/Users/Eldrex/Downloads/Papyr.js-main/Papyr.js-main/LICENSE).