bromium 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bromscandium
+
+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,76 @@
+# BromiumJS
+
+A modern JavaScript/TypeScript UI framework combining the best of Vue, React, and Next.js.
+
+## Features
+
+- **Proxy-based Reactivity** - Vue 3-inspired reactive system with `ref`, `reactive`, `computed`, and `watch`
+- **JSX Support** - React-like JSX with virtual DOM and efficient diffing
+- **Dual Hook Systems** - Both React-style hooks (`useState`, `useRef`) and Vue-style lifecycle hooks (`onMounted`, `onUnmounted`)
+- **File-based Routing** - Next.js-style automatic route generation
+- **Vite Integration** - First-class Vite plugin with HMR support
+
+## Installation
+
+```bash
+npm install bromium
+```
+
+## Quick Start
+
+```tsx
+import { createApp, ref } from 'bromium';
+
+function Counter() {
+  const count = ref(0);
+
+  return (
+    <div>
+      <p>Count: {count.value}</p>
+      <button onClick={() => count.value++}>Increment</button>
+    </div>
+  );
+}
+
+createApp(Counter).mount('#app');
+```
+
+## Vite Configuration
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import bromium from 'bromium/vite-plugin';
+
+export default defineConfig({
+  plugins: [bromium()],
+  esbuild: {
+    jsx: 'automatic',
+    jsxImportSource: 'bromium'
+  }
+});
+```
+
+## Documentation
+
+See the [full documentation](https://github.com/bromscandium/bromiumjs#readme) for:
+
+- Reactivity system (`ref`, `reactive`, `computed`, `watch`)
+- Components and JSX
+- Hooks (React-style and Vue-style)
+- Router and file-based routing
+- Vite plugin configuration
+
+## Packages
+
+| Package | Description |
+|---------|-------------|
+| `bromium` | Main package (this) |
+| `@bromium/core` | Reactivity system |
+| `@bromium/runtime` | JSX runtime and renderer |
+| `@bromium/router` | Client-side router |
+| `@bromium/vite-plugin` | Vite integration |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { ref, reactive, computed, effect, watch, watchEffect, isRef, isReactive, unref, toRef, toRefs, toRaw, shallowRef, triggerRef, markRaw, queueJob, type Ref, type ComputedRef, type ShallowRef, type EffectFn, type EffectOptions, } from '@bromium/core';
+export { jsx, jsxs, jsxDEV, createElement, h, Fragment, render, createApp, onMounted, onUnmounted, onUpdated, getCurrentInstance, useState, useRef, useMemo, useCallback, createVNode, createTextVNode, isVNode, Text, type VNode, type VNodeChild, type VNodeChildren, type VNodeType, type ComponentFunction, type ComponentInstance, type JSXElement, type AppConfig, } from '@bromium/runtime';
+export { createRouter, useRouter, useRoute, useParams, useQuery, useRouteMeta, useNavigate, useRouteMatch, Link, RouterView, Redirect, Navigate, type Router, type Route, type RouteLocation, type MatchedRoute, type NavigationTarget, type NavigationGuard, type NavigationHook, } from '@bromium/router';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,GAAG,EACH,QAAQ,EACR,QAAQ,EAGR,MAAM,EACN,KAAK,EACL,WAAW,EAGX,KAAK,EACL,UAAU,EACV,KAAK,EACL,KAAK,EACL,MAAM,EACN,KAAK,EACL,UAAU,EACV,UAAU,EACV,OAAO,EAGP,QAAQ,EAGR,KAAK,GAAG,EACR,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAEL,GAAG,EACH,IAAI,EACJ,MAAM,EACN,aAAa,EACb,CAAC,EACD,QAAQ,EAGR,MAAM,EACN,SAAS,EAGT,SAAS,EACT,WAAW,EACX,SAAS,EACT,kBAAkB,EAGlB,QAAQ,EACR,MAAM,EACN,OAAO,EACP,WAAW,EAGX,WAAW,EACX,eAAe,EACf,OAAO,EACP,IAAI,EAGJ,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,SAAS,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAEL,YAAY,EAGZ,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EAGb,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,QAAQ,EAGR,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,33 @@
+// BromiumJS - Main Package
+// Re-exports all subpackages for convenience
+// Core reactivity
+export { 
+// Reactive primitives
+ref, reactive, computed, 
+// Effects
+effect, watch, watchEffect, 
+// Utilities
+isRef, isReactive, unref, toRef, toRefs, toRaw, shallowRef, triggerRef, markRaw, 
+// Batching
+queueJob, } from '@bromium/core';
+// Runtime - JSX and rendering
+export { 
+// JSX
+jsx, jsxs, jsxDEV, createElement, h, Fragment, 
+// Rendering
+render, createApp, 
+// Lifecycle
+onMounted, onUnmounted, onUpdated, getCurrentInstance, 
+// Hooks (React-style state persistence)
+useState, useRef, useMemo, useCallback, 
+// VNode utilities
+createVNode, createTextVNode, isVNode, Text, } from '@bromium/runtime';
+// Router
+export { 
+// Router creation
+createRouter, 
+// Hooks
+useRouter, useRoute, useParams, useQuery, useRouteMeta, useNavigate, useRouteMatch, 
+// Components
+Link, RouterView, Redirect, Navigate, } from '@bromium/router';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,6CAA6C;AAE7C,kBAAkB;AAClB,OAAO;AACL,sBAAsB;AACtB,GAAG,EACH,QAAQ,EACR,QAAQ;AAER,UAAU;AACV,MAAM,EACN,KAAK,EACL,WAAW;AAEX,YAAY;AACZ,KAAK,EACL,UAAU,EACV,KAAK,EACL,KAAK,EACL,MAAM,EACN,KAAK,EACL,UAAU,EACV,UAAU,EACV,OAAO;AAEP,WAAW;AACX,QAAQ,GAQT,MAAM,eAAe,CAAC;AAEvB,8BAA8B;AAC9B,OAAO;AACL,MAAM;AACN,GAAG,EACH,IAAI,EACJ,MAAM,EACN,aAAa,EACb,CAAC,EACD,QAAQ;AAER,YAAY;AACZ,MAAM,EACN,SAAS;AAET,YAAY;AACZ,SAAS,EACT,WAAW,EACX,SAAS,EACT,kBAAkB;AAElB,wCAAwC;AACxC,QAAQ,EACR,MAAM,EACN,OAAO,EACP,WAAW;AAEX,kBAAkB;AAClB,WAAW,EACX,eAAe,EACf,OAAO,EACP,IAAI,GAWL,MAAM,kBAAkB,CAAC;AAE1B,SAAS;AACT,OAAO;AACL,kBAAkB;AAClB,YAAY;AAEZ,QAAQ;AACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa;AAEb,aAAa;AACb,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,QAAQ,GAUT,MAAM,iBAAiB,CAAC"}

package/dist/jsx-runtime.d.ts

@@ -0,0 +1,2 @@
+export { jsx, jsxs, jsxDEV, Fragment } from '@bromium/runtime';
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/jsx-runtime.js

@@ -0,0 +1,3 @@
+// Re-export JSX runtime for jsxImportSource
+export { jsx, jsxs, jsxDEV, Fragment } from '@bromium/runtime';
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.js","sourceRoot":"","sources":["../src/jsx-runtime.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/vite-plugin.d.ts

@@ -0,0 +1,4 @@
+import { bromiumPlugin } from '@bromium/vite-plugin';
+export { bromiumPlugin, type BromiumPluginOptions } from '@bromium/vite-plugin';
+export default bromiumPlugin;
+//# sourceMappingURL=vite-plugin.d.ts.map

package/dist/vite-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,eAAe,aAAa,CAAC"}

package/dist/vite-plugin.js

@@ -0,0 +1,5 @@
+// Re-export Vite plugin
+import { bromiumPlugin } from '@bromium/vite-plugin';
+export { bromiumPlugin } from '@bromium/vite-plugin';
+export default bromiumPlugin;
+//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAA6B,MAAM,sBAAsB,CAAC;AAChF,eAAe,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "bromium",
+  "version": "1.0.0",
+  "description": "BromiumJS - A modern JavaScript framework with proxy-based reactivity, JSX, and file-based routing",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./jsx-runtime": {
+      "import": "./dist/jsx-runtime.js",
+      "types": "./dist/jsx-runtime.d.ts"
+    },
+    "./jsx-dev-runtime": {
+      "import": "./dist/jsx-runtime.js",
+      "types": "./dist/jsx-runtime.d.ts"
+    },
+    "./vite-plugin": {
+      "import": "./dist/vite-plugin.js",
+      "types": "./dist/vite-plugin.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@bromium/core": "^1.0.0",
+    "@bromium/runtime": "^1.0.0",
+    "@bromium/router": "^1.0.0"
+  },
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@bromium/vite-plugin": "^1.0.0",
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "bromium",
+    "bromiumjs",
+    "framework",
+    "reactive",
+    "jsx",
+    "frontend"
+  ],
+  "author": "bromscandium",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bromscandium/bromiumjs.git",
+    "directory": "bromium"
+  },
+  "homepage": "https://github.com/bromscandium/bromiumjs#readme",
+  "bugs": {
+    "url": "https://github.com/bromscandium/bromiumjs/issues"
+  }
+}

package/src/index.ts

@@ -0,0 +1,109 @@
+// BromiumJS - Main Package
+// Re-exports all subpackages for convenience
+
+// Core reactivity
+export {
+  // Reactive primitives
+  ref,
+  reactive,
+  computed,
+
+  // Effects
+  effect,
+  watch,
+  watchEffect,
+
+  // Utilities
+  isRef,
+  isReactive,
+  unref,
+  toRef,
+  toRefs,
+  toRaw,
+  shallowRef,
+  triggerRef,
+  markRaw,
+
+  // Batching
+  queueJob,
+
+  // Types
+  type Ref,
+  type ComputedRef,
+  type ShallowRef,
+  type EffectFn,
+  type EffectOptions,
+} from '@bromium/core';
+
+// Runtime - JSX and rendering
+export {
+  // JSX
+  jsx,
+  jsxs,
+  jsxDEV,
+  createElement,
+  h,
+  Fragment,
+
+  // Rendering
+  render,
+  createApp,
+
+  // Lifecycle
+  onMounted,
+  onUnmounted,
+  onUpdated,
+  getCurrentInstance,
+
+  // Hooks (React-style state persistence)
+  useState,
+  useRef,
+  useMemo,
+  useCallback,
+
+  // VNode utilities
+  createVNode,
+  createTextVNode,
+  isVNode,
+  Text,
+
+  // Types
+  type VNode,
+  type VNodeChild,
+  type VNodeChildren,
+  type VNodeType,
+  type ComponentFunction,
+  type ComponentInstance,
+  type JSXElement,
+  type AppConfig,
+} from '@bromium/runtime';
+
+// Router
+export {
+  // Router creation
+  createRouter,
+
+  // Hooks
+  useRouter,
+  useRoute,
+  useParams,
+  useQuery,
+  useRouteMeta,
+  useNavigate,
+  useRouteMatch,
+
+  // Components
+  Link,
+  RouterView,
+  Redirect,
+  Navigate,
+
+  // Types
+  type Router,
+  type Route,
+  type RouteLocation,
+  type MatchedRoute,
+  type NavigationTarget,
+  type NavigationGuard,
+  type NavigationHook,
+} from '@bromium/router';

package/src/jsx-runtime.ts

@@ -0,0 +1,2 @@
+// Re-export JSX runtime for jsxImportSource
+export { jsx, jsxs, jsxDEV, Fragment } from '@bromium/runtime';

package/src/vite-plugin.ts

@@ -0,0 +1,4 @@
+// Re-export Vite plugin
+import { bromiumPlugin } from '@bromium/vite-plugin';
+export { bromiumPlugin, type BromiumPluginOptions } from '@bromium/vite-plugin';
+export default bromiumPlugin;