elementdrawing 1.0.0

package/src/jsx/runtime/index.js

@@ -0,0 +1,356 @@
+/**
+ * JSX Runtime Index
+ * ElementDrawing Framework - Re-exports all runtime functions, provides
+ * comprehensive runtime initialization, configuration, development tools
+ * bridge, and global event system.
+ */
+
+'use strict';
+
+const createElementModule = require('./createElement');
+const renderModule = require('./render');
+const reconcileModule = require('./reconcile');
+const commitModule = require('./commit');
+
+// ─── Runtime Configuration ────────────────────────────────────────────────────
+
+const runtimeConfig = {
+  strictMode: false,
+  profiling: false,
+  concurrentMode: false,
+  eventDelegation: true,
+  hydration: false,
+  devTools: false,
+  errorBoundaries: true,
+  suspense: true,
+};
+
+/**
+ * Configure the runtime.
+ * @param {Object} config - Configuration options
+ * @param {boolean} [config.strictMode] - Enable strict mode
+ * @param {boolean} [config.profiling] - Enable profiling
+ * @param {boolean} [config.concurrentMode] - Enable concurrent features
+ * @param {boolean} [config.eventDelegation] - Enable event delegation
+ * @param {boolean} [config.devTools] - Enable dev tools bridge
+ */
+function configureRuntime(config) {
+  Object.assign(runtimeConfig, config);
+}
+
+/**
+ * Get the current runtime configuration.
+ * @returns {Object}
+ */
+function getRuntimeConfig() {
+  return Object.assign({}, runtimeConfig);
+}
+
+// ─── Runtime Initialization ───────────────────────────────────────────────────
+
+let isInitialized = false;
+const initCallbacks = [];
+
+/**
+ * Initialize the runtime. Called once before the first render.
+ * @param {Object} [config] - Optional initial configuration
+ */
+function initRuntime(config) {
+  if (isInitialized) return;
+
+  if (config) {
+    configureRuntime(config);
+  }
+
+  // Set up global error handler for error boundaries
+  if (runtimeConfig.errorBoundaries && typeof window !== 'undefined') {
+    window.addEventListener('error', function globalErrorHandler(event) {
+      // Allow error boundaries to handle uncaught errors
+      if (event.error && event.error.__edHandled) {
+        event.preventDefault();
+      }
+    });
+  }
+
+  // Initialize dev tools bridge
+  if (runtimeConfig.devTools && typeof window !== 'undefined') {
+    window.__ED_DEVTOOLS__ = {
+      version: '1.0.0',
+      getCommitStats: commitModule.getCommitStats,
+      getRuntimeConfig: getRuntimeConfig,
+    };
+  }
+
+  isInitialized = true;
+
+  // Run initialization callbacks
+  initCallbacks.forEach((cb) => {
+    try {
+      cb();
+    } catch (error) {
+      console.error('[runtime] Init callback error:', error);
+    }
+  });
+  initCallbacks.length = 0;
+}
+
+/**
+ * Register a callback to run after runtime initialization.
+ * If already initialized, runs immediately.
+ * @param {Function} callback
+ */
+function onRuntimeInit(callback) {
+  if (isInitialized) {
+    callback();
+  } else {
+    initCallbacks.push(callback);
+  }
+}
+
+/**
+ * Check if the runtime is initialized.
+ * @returns {boolean}
+ */
+function isRuntimeInitialized() {
+  return isInitialized;
+}
+
+// ─── Global Render Function ───────────────────────────────────────────────────
+
+/**
+ * High-level render function that handles the complete render pipeline:
+ * create element -> reconcile -> commit.
+ *
+ * @param {Object} vnode - Virtual DOM element to render
+ * @param {HTMLElement} container - Target DOM container
+ * @param {Function} [callback] - Called after render completes
+ * @returns {HTMLElement} The rendered DOM node
+ */
+function renderApp(vnode, container, callback) {
+  if (!isInitialized) {
+    initRuntime();
+  }
+
+  // Get the previous vnode stored on the container
+  const prevVNode = container.__ed_vnode || null;
+
+  // Reconcile old and new trees
+  const { operations, context } = reconcileModule.reconcile(prevVNode, vnode);
+
+  // Commit the changes to the DOM
+  commitModule.commitWork(operations, container, {
+    onComplete: () => {
+      // Store the new vnode for future reconciles
+      container.__ed_vnode = vnode;
+
+      if (typeof callback === 'function') callback();
+    },
+  });
+
+  // If no previous vnode, do initial render
+  if (!prevVNode) {
+    return renderModule.render(vnode, container, callback);
+  }
+
+  return container;
+}
+
+/**
+ * Unmount the app from a container.
+ * @param {HTMLElement} container
+ */
+function unmountApp(container) {
+  renderModule.unmountContainer(container);
+  delete container.__ed_vnode;
+}
+
+// ─── Component Utilities ──────────────────────────────────────────────────────
+
+/**
+ * Create a component that wraps children with error boundary behavior.
+ * @param {Function} fallback - Fallback renderer receiving (error, retry)
+ * @returns {Function} Error boundary component
+ */
+function createErrorBoundary(fallback) {
+  return function ErrorBoundaryComponent(props) {
+    return createElementModule.createElement(
+      createElementModule.ErrorBoundary,
+      { fallback, onError: props.onError },
+      props.children
+    );
+  };
+}
+
+/**
+ * Create a Suspense wrapper.
+ * @param {*} fallback - Fallback UI
+ * @returns {Function} Suspense component
+ */
+function createSuspenseWrapper(fallback) {
+  return function SuspenseWrapper(props) {
+    return createElementModule.createElement(
+      createElementModule.Suspense,
+      { fallback },
+      props.children
+    );
+  };
+}
+
+// ─── Development Tools Bridge ─────────────────────────────────────────────────
+
+const devToolsHandlers = new Set();
+
+/**
+ * Register a dev tools message handler.
+ * @param {Function} handler
+ * @returns {Function} Unregister function
+ */
+function registerDevToolsHandler(handler) {
+  devToolsHandlers.add(handler);
+  return function unregister() {
+    devToolsHandlers.delete(handler);
+  };
+}
+
+/**
+ * Send a message to dev tools.
+ * @param {string} type - Message type
+ * @param {*} data - Message data
+ */
+function sendDevToolsMessage(type, data) {
+  if (!runtimeConfig.devTools) return;
+
+  const message = { type, data, timestamp: Date.now() };
+
+  devToolsHandlers.forEach((handler) => {
+    try {
+      handler(message);
+    } catch (error) {
+      // Dev tools errors should not break the app
+    }
+  });
+
+  // Also send to window bridge if available
+  if (typeof window !== 'undefined' && window.__ED_DEVTOOLS_BRIDGE__) {
+    try {
+      window.__ED_DEVTOOLS_BRIDGE__(message);
+    } catch (error) {
+      // Ignore
+    }
+  }
+}
+
+// ─── Runtime Statistics ───────────────────────────────────────────────────────
+
+/**
+ * Get comprehensive runtime statistics.
+ * @returns {Object}
+ */
+function getRuntimeStats() {
+  return {
+    commit: commitModule.getCommitStats(),
+    config: getRuntimeConfig(),
+    initialized: isInitialized,
+  };
+}
+
+// ─── Exports ──────────────────────────────────────────────────────────────────
+
+module.exports = {
+  // ── createElement exports ──
+  createElement: createElementModule.createElement,
+  cloneElement: createElementModule.cloneElement,
+  mergeProps: createElementModule.mergeProps,
+  createTextElement: createElementModule.createTextElement,
+  createPortal: createElementModule.createPortal,
+  createSuspense: createElementModule.createSuspense,
+  createStrictMode: createElementModule.createStrictMode,
+  createErrorBoundary: createElementModule.createErrorBoundary,
+  Fragment: createElementModule.Fragment,
+  Suspense: createElementModule.Suspense,
+  StrictMode: createElementModule.StrictMode,
+  ErrorBoundary: createElementModule.ErrorBoundary,
+  lazy: createElementModule.lazy,
+  isValidElement: createElementModule.isValidElement,
+  isValidElementType: createElementModule.isValidElementType,
+  isFunctionComponent: createElementModule.isFunctionComponent,
+  isClassComponent: createElementModule.isClassComponent,
+  isHostElement: createElementModule.isHostElement,
+  isSuspenseElement: createElementModule.isSuspenseElement,
+  isStrictModeElement: createElementModule.isStrictModeElement,
+  isErrorBoundaryElement: createElementModule.isErrorBoundaryElement,
+  countChildren: createElementModule.countChildren,
+  mapChildren: createElementModule.mapChildren,
+  forEachChild: createElementModule.forEachChild,
+  onlyChild: createElementModule.onlyChild,
+
+  // ── render exports ──
+  render: renderModule.render,
+  hydrate: renderModule.hydrate,
+  unmountContainer: renderModule.unmountContainer,
+  createDOMElement: renderModule.createDOMElement,
+  createTextNode: renderModule.createTextNode,
+  setAttribute: renderModule.setAttribute,
+  removeAttribute: renderModule.removeAttribute,
+  applyStyle: renderModule.applyStyle,
+  applyClassName: renderModule.applyClassName,
+  setEventHandler: renderModule.setEventHandler,
+  removeEventHandler: renderModule.removeEventHandler,
+  assignRef: renderModule.assignRef,
+  detachRef: renderModule.detachRef,
+  renderVNode: renderModule.renderVNode,
+  hydrateVNode: renderModule.hydrateVNode,
+
+  // ── reconcile exports ──
+  reconcile: reconcileModule.reconcile,
+  reconcileChildren: reconcileModule.reconcileChildren,
+  reconcileElement: reconcileModule.reconcileElement,
+  diffProps: reconcileModule.diffProps,
+  diffStyle: reconcileModule.diffStyle,
+  diffEventHandlers: reconcileModule.diffEventHandlers,
+  diffRef: reconcileModule.diffRef,
+  memo: reconcileModule.memo,
+  shallowEqual: reconcileModule.shallowEqual,
+  isSameType: reconcileModule.isSameType,
+  createFiber: reconcileModule.createFiber,
+  longestIncreasingSubsequence: reconcileModule.longestIncreasingSubsequence,
+
+  // ── commit exports ──
+  commitWork: commitModule.commitWork,
+  batchCommitWork: commitModule.batchCommitWork,
+  processInsertions: commitModule.processInsertions,
+  processDeletions: commitModule.processDeletions,
+  processUpdates: commitModule.processUpdates,
+  processMoves: commitModule.processMoves,
+  processReplacements: commitModule.processReplacements,
+  flushPendingLayoutEffects: commitModule.flushPendingLayoutEffects,
+  schedulePassiveEffects: commitModule.schedulePassiveEffects,
+  handleErrorDuringCommit: commitModule.handleErrorDuringCommit,
+  captureSnapshot: commitModule.captureSnapshot,
+  getSnapshot: commitModule.getSnapshot,
+  findDOMNodeForVNode: commitModule.findDOMNodeForVNode,
+  getCommitStats: commitModule.getCommitStats,
+
+  // ── Runtime management ──
+  renderApp,
+  unmountApp,
+  initRuntime,
+  onRuntimeInit,
+  isRuntimeInitialized,
+  configureRuntime,
+  getRuntimeConfig,
+  getRuntimeStats,
+  createErrorBoundary,
+  createSuspenseWrapper,
+  registerDevToolsHandler,
+  sendDevToolsMessage,
+
+  // ── Internal types ──
+  REACT_ELEMENT_TYPE: createElementModule.REACT_ELEMENT_TYPE,
+  REACT_FRAGMENT_TYPE: createElementModule.REACT_FRAGMENT_TYPE,
+  REACT_PORTAL_TYPE: createElementModule.REACT_PORTAL_TYPE,
+  REACT_SUSPENSE_TYPE: createElementModule.REACT_SUSPENSE_TYPE,
+  REACT_LAZY_TYPE: createElementModule.REACT_LAZY_TYPE,
+  REACT_STRICT_MODE_TYPE: createElementModule.REACT_STRICT_MODE_TYPE,
+  REACT_ERROR_BOUNDARY_TYPE: createElementModule.REACT_ERROR_BOUNDARY_TYPE,
+};