create-microact-app 1.0.1

package/index.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  let entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (let entry of entries) {
+    let srcPath = path.join(src, entry.name);
+    let destPath = path.join(dest, entry.name);
+
+    entry.isDirectory() ? copyDir(srcPath, destPath) : fs.copyFileSync(srcPath, destPath);
+  }
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  let projectName = 'my-microact-app';
+  let templateName = 'vanilla';
+
+  // Basic argument parsing for project name and --template flag
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i].startsWith('--template=')) {
+      templateName = argv[i].split('=')[1];
+    } else if (argv[i] === '--template' && argv[i + 1]) {
+      templateName = argv[i + 1];
+      i++; // Skip next arg
+    } else if (!argv[i].startsWith('-')) {
+      projectName = argv[i];
+    }
+  }
+
+  const root = path.join(process.cwd(), projectName);
+  const templateDir = path.join(__dirname, 'templates', templateName);
+
+  if (!fs.existsSync(templateDir)) {
+    console.error(`Error: Template "${templateName}" not found.`);
+    process.exit(1);
+  }
+
+  console.log(`Creating a new Microact app in ${root}...`);
+
+  copyDir(templateDir, root);
+
+  // Post-copy modifications: replace <repo-name> in vite.config.js and package.json
+  const viteConfigPath = path.join(root, 'vite.config.js');
+  if (fs.existsSync(viteConfigPath)) {
+    let content = fs.readFileSync(viteConfigPath, 'utf8');
+    // Simple placeholder for now, user will need to update this
+    content = content.replace('/<repo-name>/', `/${projectName}/`);
+    fs.writeFileSync(viteConfigPath, content);
+  }
+
+  const packageJsonPath = path.join(root, 'package.json');
+  if (fs.existsSync(packageJsonPath)) {
+    let content = fs.readFileSync(packageJsonPath, 'utf8');
+    content = content.replace('"name": "my-app"', `"name": "${projectName}"`);
+    fs.writeFileSync(packageJsonPath, content, 'utf8');
+  }
+
+  // --- Start of new logic ---
+  // Check if we're in the monorepo for local development
+  const isLocalDev = fs.existsSync(path.join(__dirname, '../microact'));
+
+  if (isLocalDev) {
+    console.log('Local development mode detected. Adjusting dependencies...');
+    const appPackageJsonPath = path.join(root, 'package.json');
+    if (fs.existsSync(appPackageJsonPath)) {
+      const appPkg = JSON.parse(fs.readFileSync(appPackageJsonPath, 'utf8'));
+
+      if (appPkg.dependencies['@monygroupcorp/microact']) {
+        appPkg.dependencies['@monygroupcorp/microact'] = 'file:../microact';
+      }
+      if (appPkg.dependencies['@monygroupcorp/micro-web3']) {
+        appPkg.dependencies['@monygroupcorp/micro-web3'] = 'file:../micro-web3';
+      }
+      
+      fs.writeFileSync(appPackageJsonPath, JSON.stringify(appPkg, null, 2));
+    }
+  }
+  // --- End of new logic ---
+
+  console.log('\nDone. Now run:');
+  console.log(`  cd ${projectName}`);
+  console.log('  npm install');
+  console.log('  npm run dev');
+}
+
+main();

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "create-microact-app",
+  "version": "1.0.1",
+  "type": "module",
+  "description": "A CLI tool to scaffold Microact and Micro-Web3 applications.",
+  "main": "index.js",
+  "bin": {
+    "create-microact-app": "./index.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "microact",
+    "micro-web3",
+    "scaffolding",
+    "vite"
+  ],
+  "author": "Monygroup Corp",
+  "license": "ISC"
+}

package/templates/vanilla/.github/workflows/deploy.yml

@@ -0,0 +1,38 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./dist
+          # This is important for single-page applications that use client-side routing
+          # This ensures that all requests are routed to index.html
+          # enabling proper routing after refresh or direct URL access
+          keep_files: false # Ensure existing files are overwritten
+          force_orphan: true # Create a fresh gh-pages branch each time
+          enable_jekyll: false # Disable Jekyll processing

package/templates/vanilla/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Vite + Microact</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.js"></script>
+  </body>
+</html>

package/templates/vanilla/node_modules/.package-lock.json

@@ -0,0 +1,207 @@
+{
+  "name": "my-app",
+  "version": "0.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.18.20.tgz",
+      "integrity": "sha512-pc5gxlMDxzm513qPGbCbDukOdsGtKhfxD1zJKXjCCcU7ju50O7MeAZ8c4krSJcOIJGFR+qx21yMMVYwiQvyTyQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@monygroupcorp/microact": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/@monygroupcorp/microact/-/microact-0.1.1.tgz",
+      "integrity": "sha512-DaA02WzBEMiznRPvf/j+Oakp64N3A1ZqyVUN6SYZgBl10M570AAcfHFgQOTg/23K8bwn6Hk4GHY9DTuGYbWo9g==",
+      "license": "MIT"
+    },
+    "node_modules/esbuild": {
+      "version": "0.18.20",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.18.20.tgz",
+      "integrity": "sha512-ceqxoedUrcayh7Y7ZX6NdbbDzGROiyVBgC4PriJThBKSVPWnnFHZAkfI1lJT8QFkOwH4qOS2SJkS4wvpGl8BpA==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "optionalDependencies": {
+        "@esbuild/android-arm": "0.18.20",
+        "@esbuild/android-arm64": "0.18.20",
+        "@esbuild/android-x64": "0.18.20",
+        "@esbuild/darwin-arm64": "0.18.20",
+        "@esbuild/darwin-x64": "0.18.20",
+        "@esbuild/freebsd-arm64": "0.18.20",
+        "@esbuild/freebsd-x64": "0.18.20",
+        "@esbuild/linux-arm": "0.18.20",
+        "@esbuild/linux-arm64": "0.18.20",
+        "@esbuild/linux-ia32": "0.18.20",
+        "@esbuild/linux-loong64": "0.18.20",
+        "@esbuild/linux-mips64el": "0.18.20",
+        "@esbuild/linux-ppc64": "0.18.20",
+        "@esbuild/linux-riscv64": "0.18.20",
+        "@esbuild/linux-s390x": "0.18.20",
+        "@esbuild/linux-x64": "0.18.20",
+        "@esbuild/netbsd-x64": "0.18.20",
+        "@esbuild/openbsd-x64": "0.18.20",
+        "@esbuild/sunos-x64": "0.18.20",
+        "@esbuild/win32-arm64": "0.18.20",
+        "@esbuild/win32-ia32": "0.18.20",
+        "@esbuild/win32-x64": "0.18.20"
+      }
+    },
+    "node_modules/nanoid": {
+      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "bin": {
+        "nanoid": "bin/nanoid.cjs"
+      },
+      "engines": {
+        "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
+      }
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/postcss": {
+      "version": "8.5.6",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz",
+      "integrity": "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/postcss/"
+        },
+        {
+          "type": "tidelift",
+          "url": "https://tidelift.com/funding/github/npm/postcss"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/ai"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "nanoid": "^3.3.11",
+        "picocolors": "^1.1.1",
+        "source-map-js": "^1.2.1"
+      },
+      "engines": {
+        "node": "^10 || ^12 || >=14"
+      }
+    },
+    "node_modules/rollup": {
+      "version": "3.29.5",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-3.29.5.tgz",
+      "integrity": "sha512-GVsDdsbJzzy4S/v3dqWPJ7EfvZJfCHiDqe80IyrF59LYuP+e6U1LJoUqeuqRbwAWoMNoXivMNeNAOf5E22VA1w==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "rollup": "dist/bin/rollup"
+      },
+      "engines": {
+        "node": ">=14.18.0",
+        "npm": ">=8.0.0"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/source-map-js": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/vite": {
+      "version": "4.5.14",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-4.5.14.tgz",
+      "integrity": "sha512-+v57oAaoYNnO3hIu5Z/tJRZjq5aHM2zDve9YZ8HngVHbhk66RStobhb1sqPMIPEleV6cNKYK4eGrAbE9Ulbl2g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "^0.18.10",
+        "postcss": "^8.4.27",
+        "rollup": "^3.27.1"
+      },
+      "bin": {
+        "vite": "bin/vite.js"
+      },
+      "engines": {
+        "node": "^14.18.0 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/vitejs/vite?sponsor=1"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.2"
+      },
+      "peerDependencies": {
+        "@types/node": ">= 14",
+        "less": "*",
+        "lightningcss": "^1.21.0",
+        "sass": "*",
+        "stylus": "*",
+        "sugarss": "*",
+        "terser": "^5.4.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/node": {
+          "optional": true
+        },
+        "less": {
+          "optional": true
+        },
+        "lightningcss": {
+          "optional": true
+        },
+        "sass": {
+          "optional": true
+        },
+        "stylus": {
+          "optional": true
+        },
+        "sugarss": {
+          "optional": true
+        },
+        "terser": {
+          "optional": true
+        }
+      }
+    }
+  }
+}

package/templates/vanilla/node_modules/@esbuild/darwin-x64/README.md

@@ -0,0 +1,3 @@
+# esbuild
+
+This is the macOS 64-bit binary for esbuild, a JavaScript bundler and minifier. See https://github.com/evanw/esbuild for details.

package/templates/vanilla/node_modules/@esbuild/darwin-x64/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@esbuild/darwin-x64",
+  "version": "0.18.20",
+  "description": "The macOS 64-bit binary for esbuild, a JavaScript bundler.",
+  "repository": "https://github.com/evanw/esbuild",
+  "license": "MIT",
+  "preferUnplugged": true,
+  "engines": {
+    "node": ">=12"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "x64"
+  ]
+}

package/templates/vanilla/node_modules/@monygroupcorp/microact/README.md

@@ -0,0 +1,154 @@
+# microact
+
+A lean, minimal React-like framework for building fast and efficient client-side web applications. `microact` focuses on providing core component functionality, state management, and a flexible rendering system without the heavy overhead of larger frameworks.
+
+## Features
+
+*   **Component-Based:** Build UIs using familiar class-based components with lifecycle methods.
+*   **Reactive State:** Simple `this.state` and `this.setState` for managing component-local state.
+*   **Granular DOM Updates:** Efficient DOM manipulation to minimize re-renders and optimize performance.
+*   **Event Handling:** Declarative event binding for clean and maintainable UI logic.
+*   **Context API:** Built-in context system for prop drilling avoidance and global state propagation.
+*   **Pluggable Stores:** Designed to integrate seamlessly with external state management solutions.
+*   **Small Footprint:** Optimized for client-side execution in statically hosted environments.
+
+## Installation
+
+Install `microact` using npm:
+
+```bash
+npm install microact
+```
+
+## Usage
+
+### 1. Create a Component
+
+Create a class that extends `Component` and implements a `render()` method:
+
+```javascript
+// myComponent.js
+import { Component } from 'microact';
+
+class MyComponent extends Component {
+  constructor(element) {
+    super(element);
+    this.state = {
+      count: 0,
+      message: 'Hello, microact!'
+    };
+  }
+
+  // Lifecycle method: Called after component is mounted to the DOM
+  onMount() {
+    console.log('MyComponent mounted!');
+  }
+
+  // Define DOM events
+  events() {
+    return {
+      'click button': 'incrementCount',
+    };
+  }
+
+  incrementCount() {
+    this.setState({ count: this.state.count + 1 });
+  }
+
+  // Render method returns an HTML string
+  render() {
+    return `
+      <div>
+        <h1>${this.state.message}</h1>
+        <p>Count: ${this.state.count}</p>
+        <button>Click me!</button>
+      </div>
+    `;
+  }
+}
+
+export default MyComponent;
+```
+
+### 2. Mount Your Component
+
+In your main application file, import and mount your component to a DOM element:
+
+```javascript
+// index.js
+import MyComponent from './myComponent.js';
+
+const appRoot = document.getElementById('app-root');
+const myComponent = new MyComponent(appRoot);
+myComponent.mount(appRoot);
+```
+
+### 3. Basic HTML Structure
+
+Your HTML file should have a root element for your application:
+
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Microact App</title>
+</head>
+<body>
+    <div id="app-root"></div>
+    <script type="module" src="index.js"></script>
+</body>
+</html>
+```
+
+## API Reference
+
+### `Component` Class
+
+*   `constructor(rootElement)`: Initializes the component.
+*   `setState(newState)`: Updates component state and triggers a re-render if `shouldUpdate` returns `true`.
+*   `mount(element)`: Mounts the component to the given DOM element.
+*   `unmount()`: Removes the component from the DOM and cleans up resources.
+*   `render()`: **(Must be implemented by subclasses)** Returns the HTML string representation of the component.
+*   `template()`: Optional. If `render()` is not overridden, it defaults to calling `this.template()`.
+*   `onMount()`: Lifecycle hook called after mounting.
+*   `onUnmount()`: Lifecycle hook called before unmounting.
+*   `onStateUpdate(oldState, newState)`: Lifecycle hook called after state update and before rendering.
+*   `events()`: Returns an object mapping event selectors to handler methods (e.g., `{ 'click button': 'handleClick' }`).
+*   `registerCleanup(cleanupFn)`: Registers a function to be called on `unmount`.
+*   `setTimeout(callback, delay)`: Wrapper for `setTimeout` with automatic cleanup.
+*   `setInterval(callback, delay)`: Wrapper for `setInterval` with automatic cleanup.
+*   `subscribe(eventName, callback)`: Subscribes to an `EventBus` event with automatic cleanup.
+*   `subscribeOnce(eventName, callback)`: Subscribes to an `EventBus` event once with automatic cleanup.
+*   `useStore(store, selector, onUpdate)`: Hook to subscribe to external store state changes.
+*   `provideContext(key, value)`: Provides a context value to child components.
+*   `getContext(key)`: Retrieves a context value from the component tree.
+
+### `EventBus`
+
+A simple global event bus for inter-component communication. Access via `import { eventBus } from 'microact';`
+
+*   `eventBus.on(eventName, callback)`: Subscribe to an event.
+*   `eventBus.off(eventName, callback)`: Unsubscribe from an event.
+*   `eventBus.emit(eventName, data)`: Emit an event.
+*   `eventBus.once(eventName, callback)`: Subscribe to an event once.
+
+## Development
+
+To build the project:
+
+```bash
+npm install
+npm run build
+```
+
+The build output will be in the `dist/` directory.
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## License
+
+This project is licensed under the MIT License.