math-notation 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Eric Dai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,158 @@
+# Formulize
+
+An API for interactive mathematical formula built with React, TypeScript, and Vite that provides real-time formula visualization and computation capabilities.
+
+## Features
+
+- **Formulize API** - Declarative API for programmatic "executable" formula configuration
+- **Multi-Engine Computation** - Support for manual step-through, symbolic algebra
+- **Real-time Visualization** - 2D/3D plotting with D3.js and Plotly.js integration
+- **Variable Management** - Dependency tracking and automatic recomputation
+
+## Installation
+
+### Quick Start (Recommended)
+
+Install with all peer dependencies automatically:
+
+```bash
+npx install-peerdeps formulize-math
+```
+
+```bash
+npm install formulize-math
+```
+
+### Manual Peer Dependencies Installation
+
+Formulize requires several peer dependencies. Install them based on your needs:
+
+**Core (Required):**
+
+```bash
+npm install react react-dom mobx mobx-react-lite mobx-state-tree
+```
+
+**Math Rendering (Required):**
+
+```bash
+npm install mathjax-full better-react-mathjax katex mathjs
+```
+
+**Formula Canvas (Required for FormulaComponent):**
+
+```bash
+npm install @xyflow/react lucide-react lodash
+```
+
+**3D Plotting (Optional - for Plot3D):**
+
+```bash
+npm install plotly.js-dist d3
+```
+
+**Code Editor (Optional - for step-through debugging):**
+
+```bash
+npm install codemirror @codemirror/autocomplete @codemirror/lang-javascript @codemirror/language @codemirror/legacy-modes @codemirror/state @codemirror/view @uiw/react-codemirror
+```
+
+**All-in-one installation:**
+
+```bash
+npm install formulize-math react react-dom mobx mobx-react-lite mobx-state-tree mathjax-full better-react-mathjax katex mathjs @xyflow/react lucide-react lodash plotly.js-dist d3 codemirror @codemirror/autocomplete @codemirror/lang-javascript @codemirror/language @codemirror/legacy-modes @codemirror/state @codemirror/view @uiw/react-codemirror
+```
+
+Don't forget to import the CSS:
+
+```tsx
+import "formulize-math/style.css";
+```
+
+## Technology Stack
+
+- **Frontend**: React 18 + TypeScript + Vite
+- **State Management**: MobX with decorators
+- **Math Rendering**: KaTeX, MathJax
+- **Code Editor**: CodeMirror 6
+- **Visualization**: D3.js, Plotly.js
+
+---
+
+## Development
+
+### Prerequisites
+
+- Node.js (version 16 or higher)
+- npm or yarn
+
+### Setup
+
+```bash
+npm install
+```
+
+### Development
+
+Start the development server:
+
+```bash
+npm run dev
+```
+
+The application will be available at `http://localhost:3005`
+
+### Building
+
+Build for production:
+
+```bash
+npm run build
+```
+
+Preview the production build:
+
+```bash
+npm run preview
+```
+
+### Code Quality
+
+Run linting:
+
+```bash
+npm run lint
+```
+
+Run TypeScript type checking:
+
+```bash
+tsc
+```
+
+### Deployment
+
+Deploy to docs/forge/ directory:
+
+```bash
+npm run deploy
+```
+
+## Project Structure
+
+- `src/api/` - Formulize API and computation engines
+- `src/renderer/` - Core interactive formula components
+- `src/visualizations/` - 2D/3D plotting engines
+- `src/types/` - TypeScript type definitions
+- `src/examples/` - Example formula API configurations
+
+## Architecture
+
+The application uses a multi-store MobX architecture with:
+
+- **computationStore** - Variable computation and evaluation
+
+Three computation engines are available:
+
+- **manual** - Manual step-through with JS interpreter
+- **symbolic-algebra** - Mathematical computation engine

package/dist/CurlyBraceListOption.svg

@@ -0,0 +1,3 @@
+<svg width="32" height="64" viewBox="0 0 32 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M8 12V20C8 22.2 6.2 24 4 24H0V40H4C6.2 40 8 41.8 8 44V52C8 58.6 13.4 64 20 64H32V56H20C17.8 56 16 54.2 16 52V44C16 38.8 12.64 34.32 8 32.68V31.32C12.64 29.68 16 25.2 16 20V12C16 9.8 17.8 8 20 8H32V0H20C13.4 0 8 5.4 8 12Z" fill="black"/>
+</svg>