@jxrstudios/jxr 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JXR Studios
+
+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,107 @@
+# JXR.js — Edge OS Runtime Framework
+
+A JavaScript runtime framework for elite developers. Execute JavaScript at the edge with zero-build JSX transformation, virtual file system, worker pools, and secure module resolution.
+
+## Installation
+
+```bash
+npm install @jxrstudios/jxr
+```
+
+## Quick Start
+
+```typescript
+import { JXRRuntime, jxrRuntime } from '@jxrstudios/jxr';
+
+// Use the global singleton
+await jxrRuntime.init();
+
+// Or create your own instance
+const runtime = new JXRRuntime({
+  maxWorkers: 8,
+  moqEndpoint: 'wss://edge.jxr.dev',
+  enableCrypto: true,
+});
+await runtime.init();
+
+// Transform and execute JSX modules
+const module = await runtime.resolveModule('/src/App.tsx');
+
+// Build preview HTML
+const html = runtime.buildPreviewDocument();
+
+// Listen to metrics
+runtime.onMetrics((metrics) => {
+  console.log('Worker pool:', metrics.workerPool);
+  console.log('Cache size:', metrics.moduleCache.size);
+});
+```
+
+## Features
+
+- **VirtualFS** — In-memory file system with project templates
+- **JSXTransformer** — Zero-build JSX/TSX transformation
+- **WorkerPool** — Parallel task execution with metrics
+- **MoQTransport** — Edge data streaming (Media over QUIC)
+- **JXRCrypto** — Module integrity verification & signing
+- **ModuleCache** — LRU cache for resolved modules
+- **ImportMapBuilder** — Browser import map generation
+
+## Usage
+
+### Virtual File System
+
+```typescript
+import { VirtualFS, DEFAULT_PROJECT_FILES } from '@jxrstudios/jxr';
+
+const vfs = new VirtualFS(DEFAULT_PROJECT_FILES);
+vfs.write('/src/components/Button.tsx', `export const Button = () => <button>Click</button>`);
+const file = vfs.read('/src/components/Button.tsx');
+```
+
+### JSX Transformation
+
+```typescript
+import { JSXTransformer } from '@jxrstudios/jxr';
+
+const transformer = new JSXTransformer();
+const transformed = transformer.transform(
+  `export const App = () => <h1>Hello JXR</h1>`,
+  '/src/App.tsx'
+);
+const objectUrl = transformer.createObjectUrl(transformed);
+```
+
+### Worker Pool
+
+```typescript
+import { WorkerPool } from '@jxrstudios/jxr';
+
+const pool = new WorkerPool('/jxr-worker.js', { maxWorkers: 4 });
+const result = await pool.executeTask({
+  id: 'task-1',
+  type: 'transform',
+  payload: { code: '...' },
+  priority: 'high',
+});
+const metrics = pool.getMetrics();
+```
+
+### Web Crypto
+
+```typescript
+import { jxrCrypto } from '@jxrstudios/jxr';
+
+const hash = await jxrCrypto.hashModule('import React from "react"');
+const manifest = await jxrCrypto.signManifest({
+  modules: [{ path: '/src/App.tsx', hash }],
+}, 'your-private-key');
+```
+
+## API Reference
+
+See the TypeScript definitions for full API documentation.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * JXR.js — Edge OS Runtime Framework
+ * A runtime for executing JavaScript at the edge with:
+ * - Virtual File System
+ * - JSX Transformation (zero-build)
+ * - Worker Pool orchestration
+ * - MoQ Transport streaming
+ * - Web Crypto module integrity
+ */
+export { WorkerPool } from './worker-pool.js';
+export type { WorkerMetrics, PoolMetrics, WorkerStatus, TaskPriority, } from './worker-pool.js';
+export { MoQTransport } from './moq-transport.js';
+export type { MoQStreamMetrics, MoQConnectionState, MoQObject, MoQTrackNamespace, } from './moq-transport.js';
+export { JXRCrypto, jxrCrypto } from './web-crypto.js';
+export type { ModuleHash, SignedManifest } from './web-crypto.js';
+export { VirtualFS, JSXTransformer, ImportMapBuilder, ModuleCache, DEFAULT_PROJECT_FILES, } from './module-resolver.js';
+export type { VirtualFile, VirtualDirectory, ResolvedModule, ImportMap, } from './module-resolver.js';
+export { JXRRuntime, jxrRuntime } from './runtime.js';
+export type { JXRRuntimeConfig, JXRRuntimeMetrics } from './runtime.js';
+//# 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":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * JXR.js — Edge OS Runtime Framework
+ * A runtime for executing JavaScript at the edge with:
+ * - Virtual File System
+ * - JSX Transformation (zero-build)
+ * - Worker Pool orchestration
+ * - MoQ Transport streaming
+ * - Web Crypto module integrity
+ */
+export { WorkerPool } from './worker-pool.js';
+export { MoQTransport } from './moq-transport.js';
+export { JXRCrypto, jxrCrypto } from './web-crypto.js';
+export { VirtualFS, JSXTransformer, ImportMapBuilder, ModuleCache, DEFAULT_PROJECT_FILES, } from './module-resolver.js';
+export { JXRRuntime, jxrRuntime } from './runtime.js';
+//# 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;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/module-resolver.d.ts

@@ -0,0 +1,115 @@
+/**
+ * JXR.js — Module Resolver & Virtual File System
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Design: LavaFlow OS — Thermal Precision + Edge Command
+ * Layer: Core Runtime / Module System
+ *
+ * Architecture:
+ *   Zero-build-step module resolution pipeline:
+ *   1. VirtualFS: In-memory file system with change notification
+ *   2. ModuleResolver: Resolves imports to VirtualFS entries
+ *   3. JSXTransformer: Browser-native JSX → JS transform (no Babel/esbuild)
+ *   4. ImportMapBuilder: Generates browser-native import maps for esm.sh CDN
+ *   5. ModuleCache: LRU cache with crypto integrity verification
+ *
+ * The resolver produces browser-executable ES modules from JSX/TSX source
+ * without any build step, using the esm.sh CDN for npm package resolution.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+export interface VirtualFile {
+    path: string;
+    content: string;
+    language: 'tsx' | 'ts' | 'jsx' | 'js' | 'css' | 'json' | 'md' | 'html';
+    lastModified: number;
+    size: number;
+    dirty: boolean;
+}
+export interface VirtualDirectory {
+    path: string;
+    name: string;
+    children: (VirtualFile | VirtualDirectory)[];
+    expanded: boolean;
+}
+export interface ResolvedModule {
+    path: string;
+    source: string;
+    transformed: string;
+    objectUrl: string | null;
+    dependencies: string[];
+    resolvedAt: number;
+    transformMs: number;
+}
+export interface ImportMap {
+    imports: Record<string, string>;
+    scopes?: Record<string, Record<string, string>>;
+}
+type FileChangeHandler = (file: VirtualFile, event: 'create' | 'update' | 'delete') => void;
+/**
+ * VirtualFS — In-memory file system with reactive change notifications
+ */
+export declare class VirtualFS {
+    private files;
+    private changeHandlers;
+    constructor(initialFiles?: VirtualFile[]);
+    write(path: string, content: string): VirtualFile;
+    read(path: string): VirtualFile | null;
+    delete(path: string): boolean;
+    list(prefix?: string): VirtualFile[];
+    exists(path: string): boolean;
+    onChange(handler: FileChangeHandler): () => void;
+    private emit;
+    buildTree(rootPath?: string): VirtualDirectory;
+    toJSON(): Record<string, string>;
+    private detectLanguage;
+}
+/**
+ * JSXTransformer — Zero-dependency JSX → JS transform
+ *
+ * Uses a lightweight regex-based transform for simple JSX,
+ * with Sucrase-style transforms for production accuracy.
+ * Falls back to esm.sh/sucrase for complex transforms.
+ */
+export declare class JSXTransformer {
+    private objectUrls;
+    /**
+     * Transform JSX/TSX source to browser-executable ES module
+     * Uses the automatic JSX runtime (React 17+)
+     */
+    transform(source: string, filePath: string): string;
+    private stripTypeScript;
+    private transformJSX;
+    private parseProps;
+    private rewriteImports;
+    createObjectUrl(source: string, type?: string): string;
+    revokeObjectUrl(url: string): void;
+    cleanup(): void;
+}
+/**
+ * ImportMapBuilder — Generates browser-native import maps
+ */
+export declare class ImportMapBuilder {
+    private imports;
+    /** Add a package mapping to the import map */
+    add(specifier: string, url: string): this;
+    /** Add React and common packages */
+    addReactDefaults(reactVersion?: string): this;
+    build(): ImportMap;
+    toScriptTag(): string;
+}
+/**
+ * ModuleCache — LRU cache with integrity verification
+ */
+export declare class ModuleCache {
+    private cache;
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    set(path: string, module: ResolvedModule): void;
+    get(path: string): ResolvedModule | null;
+    invalidate(path: string): void;
+    clear(): void;
+    get size(): number;
+}
+/** Default project template files */
+export declare const DEFAULT_PROJECT_FILES: VirtualFile[];
+export {};
+//# sourceMappingURL=module-resolver.d.ts.map

package/dist/module-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-resolver.d.ts","sourceRoot":"","sources":["../src/module-resolver.ts"],"names":[],"mappings":"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"}