elementdrawing 1.0.0

package/src/index.js

@@ -0,0 +1,746 @@
+/**
+ * ElementDrawing Framework - Main Entry Point
+ * Export everything from the framework, including runtime, hooks,
+ * components, utilities, and framework configuration.
+ *
+ * @version 1.0.0
+ * @license MIT
+ */
+
+'use strict';
+
+// ─── Runtime ──────────────────────────────────────────────────────────────────
+
+const runtime = require('./jsx/runtime');
+
+// Core createElement and render
+const createElement = runtime.createElement;
+const render = runtime.render;
+const Fragment = runtime.Fragment;
+const cloneElement = runtime.cloneElement;
+const createPortal = runtime.createPortal;
+const createSuspense = runtime.createSuspense;
+const createStrictMode = runtime.createStrictMode;
+const createErrorBoundary = runtime.createErrorBoundary;
+const Suspense = runtime.Suspense;
+const StrictMode = runtime.StrictMode;
+const ErrorBoundary = runtime.ErrorBoundary;
+const lazy = runtime.lazy;
+const isValidElement = runtime.isValidElement;
+const isValidElementType = runtime.isValidElementType;
+const isFunctionComponent = runtime.isFunctionComponent;
+const isClassComponent = runtime.isClassComponent;
+const countChildren = runtime.countChildren;
+const mapChildren = runtime.mapChildren;
+const forEachChild = runtime.forEachChild;
+const onlyChild = runtime.onlyChild;
+const mergeProps = runtime.mergeProps;
+
+// Render pipeline
+const hydrate = runtime.hydrate;
+const unmountContainer = runtime.unmountContainer;
+const renderApp = runtime.renderApp;
+const unmountApp = runtime.unmountApp;
+
+// Runtime management
+const initRuntime = runtime.initRuntime;
+const onRuntimeInit = runtime.onRuntimeInit;
+const isRuntimeInitialized = runtime.isRuntimeInitialized;
+const configureRuntime = runtime.configureRuntime;
+const getRuntimeConfig = runtime.getRuntimeConfig;
+const getRuntimeStats = runtime.getRuntimeStats;
+const registerDevToolsHandler = runtime.registerDevToolsHandler;
+const sendDevToolsMessage = runtime.sendDevToolsMessage;
+
+// Internal types
+const REACT_ELEMENT_TYPE = runtime.REACT_ELEMENT_TYPE;
+const REACT_FRAGMENT_TYPE = runtime.REACT_FRAGMENT_TYPE;
+const REACT_PORTAL_TYPE = runtime.REACT_PORTAL_TYPE;
+const REACT_SUSPENSE_TYPE = runtime.REACT_SUSPENSE_TYPE;
+const REACT_LAZY_TYPE = runtime.REACT_LAZY_TYPE;
+const REACT_STRICT_MODE_TYPE = runtime.REACT_STRICT_MODE_TYPE;
+const REACT_ERROR_BOUNDARY_TYPE = runtime.REACT_ERROR_BOUNDARY_TYPE;
+
+// ─── Hooks ────────────────────────────────────────────────────────────────────
+
+const hooks = require('./jsx/hooks');
+
+// Core hooks
+const useState = hooks.useState;
+const useEffect = hooks.useEffect;
+const useContext = hooks.useContext;
+const useReducer = hooks.useReducer;
+const useCallback = hooks.useCallback;
+const useMemo = hooks.useMemo;
+const useRef = hooks.useRef;
+const useLayoutEffect = hooks.useLayoutEffect;
+
+// Extended hooks
+const useInsertionEffect = hooks.useInsertionEffect;
+const useIsomorphicLayoutEffect = hooks.useIsomorphicLayoutEffect;
+const useTransition = hooks.useTransition;
+const useDeferredValue = hooks.useDeferredValue;
+const useDebouncedCallback = hooks.useDebouncedCallback;
+const useThrottledCallback = hooks.useThrottledCallback;
+const useOnceCallback = hooks.useOnceCallback;
+const useDeepCompareCallback = hooks.useDeepCompareCallback;
+const useDeepCompareMemo = hooks.useDeepCompareMemo;
+const useDeepCompareEffect = hooks.useDeepCompareEffect;
+const useMemoWith = hooks.useMemoWith;
+const useMemoTTL = hooks.useMemoTTL;
+const useEffectOnce = hooks.useEffectOnce;
+const useUpdateEffect = hooks.useUpdateEffect;
+const usePrevious = hooks.usePrevious;
+const usePreviousWithInit = hooks.usePreviousWithInit;
+const useMutationObserver = hooks.useMutationObserver;
+const useResizeObserver = hooks.useResizeObserver;
+const useAutoFocus = hooks.useAutoFocus;
+const useContextSelector = hooks.useContextSelector;
+const useContextObserver = hooks.useContextObserver;
+
+// Context API
+const createContext = hooks.createContext;
+const useMergedContext = hooks.useMergedContext;
+const composeContexts = hooks.composeContexts;
+
+// Ref utilities
+const createRef = hooks.createRef;
+const useCallbackRef = hooks.useCallbackRef;
+const forwardRef = hooks.forwardRef;
+const isForwardRef = hooks.isForwardRef;
+const useMergedRefs = hooks.useMergedRefs;
+const useMeasureRef = hooks.useMeasureRef;
+const useInViewRef = hooks.useInViewRef;
+const useFocusRef = hooks.useFocusRef;
+const useScrollRef = hooks.useScrollRef;
+
+// Batching
+const batchedUpdates = hooks.batchedUpdates;
+const batchDispatches = hooks.batchDispatches;
+const runWithPriority = hooks.runWithPriority;
+const startTransition = hooks.startTransition;
+
+// State comparison
+const deepEqual = hooks.deepEqual;
+const shallowEqual = hooks.shallowEqual;
+const areDepsEqual = hooks.areDepsEqual;
+const areDepsDeepEqual = hooks.areDepsDeepEqual;
+
+// Framework integration
+const setCurrentComponent = hooks.setCurrentComponent;
+const resetHookIndex = hooks.resetHookIndex;
+const cleanupComponent = hooks.cleanupComponent;
+const flushAllEffects = hooks.flushAllEffects;
+const postRenderProcess = hooks.postRenderProcess;
+
+// Development tools
+const registerDevTools = hooks.registerDevTools;
+const setHookValidation = hooks.setHookValidation;
+const validateHookOrder = hooks.validateHookOrder;
+const setProfiling = hooks.setProfiling;
+const getComponentProfile = hooks.getComponentProfile;
+const setStrictMode = hooks.setStrictMode;
+const isInStrictMode = hooks.isInStrictMode;
+const cancelEffect = hooks.cancelEffect;
+const getContextVersion = hooks.getContextVersion;
+const getPendingEffectCounts = hooks.getPendingEffectCounts;
+
+// Constants
+const PRIORITY = hooks.PRIORITY;
+const LAYOUT_PRIORITY = hooks.LAYOUT_PRIORITY;
+
+// Persistence
+const configurePersistence = hooks.configurePersistence;
+
+// Middleware
+const createLoggerMiddleware = hooks.createLoggerMiddleware;
+const createValidationMiddleware = hooks.createValidationMiddleware;
+const createTransformMiddleware = hooks.createTransformMiddleware;
+const createThrottleMiddleware = hooks.createThrottleMiddleware;
+const createActionCreators = hooks.createActionCreators;
+const createAction = hooks.createAction;
+
+// Memo invalidation
+const invalidateMemo = hooks.invalidateMemo;
+const invalidateAllMemos = hooks.invalidateAllMemos;
+
+// ─── Components ───────────────────────────────────────────────────────────────
+
+const components = require('./jsx/components');
+
+const Button = components.Button;
+const Card = components.Card;
+const Modal = components.Modal;
+const Input = components.Input;
+const Table = components.Table;
+const Navbar = components.Navbar;
+const Sidebar = components.Sidebar;
+const Form = components.Form;
+const Tabs = components.Tabs;
+const Accordion = components.Accordion;
+const Alert = components.Alert;
+const Avatar = components.Avatar;
+const Badge = components.Badge;
+const Breadcrumb = components.Breadcrumb;
+const Carousel = components.Carousel;
+const Checkbox = components.Checkbox;
+const Dialog = components.Dialog;
+const Drawer = components.Drawer;
+const Dropdown = components.Dropdown;
+const Menu = components.Menu;
+const Pagination = components.Pagination;
+const Progress = components.Progress;
+const Radio = components.Radio;
+const Select = components.Select;
+const Slider = components.Slider;
+const Spinner = components.Spinner;
+const Switch = components.Switch;
+const Textarea = components.Textarea;
+const Toast = components.Toast;
+const Tooltip = components.Tooltip;
+const Typography = components.Typography;
+
+// ─── DOM Utilities ────────────────────────────────────────────────────────────
+
+const dom = require('./js/dom');
+
+// ─── Event Utilities ──────────────────────────────────────────────────────────
+
+const events = require('./js/events');
+
+// ─── General Utilities ────────────────────────────────────────────────────────
+
+const utils = require('./js/utils');
+
+// ─── Animation Utilities ──────────────────────────────────────────────────────
+
+const animation = require('./js/animation');
+
+// ─── HTTP Client ──────────────────────────────────────────────────────────────
+
+const http = require('./js/http');
+
+// ─── Router ───────────────────────────────────────────────────────────────────
+
+const router = require('./js/router');
+
+// ─── Store ────────────────────────────────────────────────────────────────────
+
+const store = require('./js/store');
+
+// ─── Validator ────────────────────────────────────────────────────────────────
+
+const validator = require('./js/validator');
+
+// ─── Version ──────────────────────────────────────────────────────────────────
+
+const VERSION = '1.0.0';
+
+// ─── Framework Configuration ─────────────────────────────────────────────────
+
+/**
+ * Default framework configuration.
+ * @type {Object}
+ */
+const defaultConfig = {
+  version: VERSION,
+  strictMode: false,
+  profiling: false,
+  concurrentMode: false,
+  eventDelegation: true,
+  hydration: false,
+  devTools: false,
+  errorBoundaries: true,
+  suspense: true,
+  theme: 'light',
+  locale: 'en-US',
+  debug: false,
+};
+
+/**
+ * Current framework configuration.
+ * @type {Object}
+ */
+let frameworkConfig = Object.assign({}, defaultConfig);
+
+/**
+ * Configure the ElementDrawing framework.
+ * @param {Object} config - Configuration options
+ * @returns {Object} The updated configuration
+ */
+function configure(config) {
+  frameworkConfig = Object.assign({}, frameworkConfig, config);
+
+  // Apply configuration to runtime
+  if (config.strictMode !== undefined || config.profiling !== undefined ||
+      config.concurrentMode !== undefined || config.devTools !== undefined) {
+    configureRuntime({
+      strictMode: config.strictMode,
+      profiling: config.profiling,
+      concurrentMode: config.concurrentMode,
+      devTools: config.devTools,
+    });
+  }
+
+  // Apply hook strict mode
+  if (config.strictMode !== undefined) {
+    setStrictMode(config.strictMode);
+  }
+
+  return Object.assign({}, frameworkConfig);
+}
+
+/**
+ * Get the current framework configuration.
+ * @returns {Object} A copy of the current configuration
+ */
+function getConfig() {
+  return Object.assign({}, frameworkConfig);
+}
+
+/**
+ * Reset framework configuration to defaults.
+ * @returns {Object} The default configuration
+ */
+function resetConfig() {
+  frameworkConfig = Object.assign({}, defaultConfig);
+  return Object.assign({}, frameworkConfig);
+}
+
+// ─── Component Registration ──────────────────────────────────────────────────
+
+/**
+ * Registry of custom components that can be registered at runtime.
+ * @type {Map<string, Function>}
+ */
+const componentRegistry = new Map();
+
+/**
+ * Register a custom component with the framework.
+ * @param {string} name - Component name
+ * @param {Function} component - Component function/class
+ * @returns {boolean} True if registration was successful
+ */
+function registerComponent(name, component) {
+  if (typeof name !== 'string' || name.trim() === '') {
+    console.error('[ElementDrawing] Component name must be a non-empty string');
+    return false;
+  }
+  if (typeof component !== 'function') {
+    console.error('[ElementDrawing] Component must be a function or class');
+    return false;
+  }
+  componentRegistry.set(name, component);
+  return true;
+}
+
+/**
+ * Unregister a previously registered custom component.
+ * @param {string} name - Component name to unregister
+ * @returns {boolean} True if the component was found and removed
+ */
+function unregisterComponent(name) {
+  return componentRegistry.delete(name);
+}
+
+/**
+ * Get a registered custom component by name.
+ * @param {string} name - Component name
+ * @returns {Function|undefined}
+ */
+function getRegisteredComponent(name) {
+  return componentRegistry.get(name);
+}
+
+/**
+ * Get all registered custom component names.
+ * @returns {string[]}
+ */
+function getRegisteredComponents() {
+  return Array.from(componentRegistry.keys());
+}
+
+// ─── Plugin System ────────────────────────────────────────────────────────────
+
+/**
+ * Registry of installed plugins.
+ * @type {Map<string, Object>}
+ */
+const pluginRegistry = new Map();
+
+/**
+ * Install a plugin into the framework.
+ * A plugin is an object with an `install` method that receives the framework.
+ * @param {Object} plugin - Plugin object with install method
+ * @param {Object} [options] - Plugin options
+ * @returns {boolean} True if installation was successful
+ */
+function usePlugin(plugin, options) {
+  if (!plugin || typeof plugin.install !== 'function') {
+    console.error('[ElementDrawing] Plugin must have an install method');
+    return false;
+  }
+
+  const name = plugin.name || 'anonymous';
+
+  if (pluginRegistry.has(name)) {
+    console.warn('[ElementDrawing] Plugin "' + name + '" is already installed');
+    return false;
+  }
+
+  try {
+    const api = {
+      createElement,
+      render,
+      Fragment,
+      useState,
+      useEffect,
+      useContext,
+      useReducer,
+      useCallback,
+      useMemo,
+      useRef,
+      useLayoutEffect,
+      createContext,
+      registerComponent,
+      configure,
+      VERSION,
+    };
+
+    plugin.install(api, options);
+    pluginRegistry.set(name, { plugin, options });
+    return true;
+  } catch (error) {
+    console.error('[ElementDrawing] Plugin "' + name + '" installation failed:', error);
+    return false;
+  }
+}
+
+/**
+ * Uninstall a previously installed plugin.
+ * @param {string} name - Plugin name
+ * @returns {boolean} True if the plugin was found and removed
+ */
+function uninstallPlugin(name) {
+  const entry = pluginRegistry.get(name);
+  if (!entry) return false;
+
+  if (typeof entry.plugin.uninstall === 'function') {
+    try {
+      entry.plugin.uninstall();
+    } catch (error) {
+      console.error('[ElementDrawing] Plugin "' + name + '" uninstall failed:', error);
+    }
+  }
+
+  return pluginRegistry.delete(name);
+}
+
+/**
+ * Check if a plugin is installed.
+ * @param {string} name - Plugin name
+ * @returns {boolean}
+ */
+function isPluginInstalled(name) {
+  return pluginRegistry.has(name);
+}
+
+// ─── Global Error Handler ────────────────────────────────────────────────────
+
+/**
+ * Global error handler for the framework.
+ * @type {Function|null}
+ */
+let globalErrorHandler = null;
+
+/**
+ * Set a global error handler for uncaught framework errors.
+ * @param {Function} handler - Error handler function (error) => void
+ */
+function setErrorHandler(handler) {
+  if (typeof handler === 'function') {
+    globalErrorHandler = handler;
+  }
+}
+
+/**
+ * Handle a framework error.
+ * @param {Error} error - The error to handle
+ * @param {string} [source] - Error source context
+ */
+function handleError(error, source) {
+  if (globalErrorHandler) {
+    try {
+      globalErrorHandler(error, source);
+    } catch (handlerError) {
+      console.error('[ElementDrawing] Error handler failed:', handlerError);
+      console.error('[ElementDrawing] Original error:', error);
+    }
+  } else {
+    console.error('[ElementDrawing]' + (source ? ' (' + source + ')' : '') + ':', error);
+  }
+}
+
+// ─── Debug Mode ───────────────────────────────────────────────────────────────
+
+/**
+ * Enable or disable debug mode.
+ * @param {boolean} enabled
+ */
+function setDebugMode(enabled) {
+  frameworkConfig.debug = !!enabled;
+  if (enabled) {
+    console.log('[ElementDrawing] Debug mode enabled (v' + VERSION + ')');
+  }
+}
+
+/**
+ * Check if debug mode is enabled.
+ * @returns {boolean}
+ */
+function isDebugMode() {
+  return !!frameworkConfig.debug;
+}
+
+// ─── Framework Info ───────────────────────────────────────────────────────────
+
+/**
+ * Get comprehensive framework information.
+ * @returns {Object}
+ */
+function getFrameworkInfo() {
+  return {
+    name: 'ElementDrawing',
+    version: VERSION,
+    config: Object.assign({}, frameworkConfig),
+    runtime: getRuntimeStats(),
+    registeredComponents: getRegisteredComponents(),
+    installedPlugins: Array.from(pluginRegistry.keys()),
+    initialized: isRuntimeInitialized(),
+  };
+}
+
+// ─── Exports ──────────────────────────────────────────────────────────────────
+
+module.exports = {
+  // ── Version ──
+  VERSION,
+
+  // ── Runtime: createElement & render ──
+  createElement,
+  render,
+  Fragment,
+  cloneElement,
+  createPortal,
+  createSuspense,
+  createStrictMode,
+  createErrorBoundary,
+  Suspense,
+  StrictMode,
+  ErrorBoundary,
+  lazy,
+  isValidElement,
+  isValidElementType,
+  isFunctionComponent,
+  isClassComponent,
+  countChildren,
+  mapChildren,
+  forEachChild,
+  onlyChild,
+  mergeProps,
+
+  // ── Runtime: render pipeline ──
+  hydrate,
+  unmountContainer,
+  renderApp,
+  unmountApp,
+
+  // ── Runtime: management ──
+  initRuntime,
+  onRuntimeInit,
+  isRuntimeInitialized,
+  configureRuntime,
+  getRuntimeConfig,
+  getRuntimeStats,
+  registerDevToolsHandler,
+  sendDevToolsMessage,
+
+  // ── Runtime: internal types ──
+  REACT_ELEMENT_TYPE,
+  REACT_FRAGMENT_TYPE,
+  REACT_PORTAL_TYPE,
+  REACT_SUSPENSE_TYPE,
+  REACT_LAZY_TYPE,
+  REACT_STRICT_MODE_TYPE,
+  REACT_ERROR_BOUNDARY_TYPE,
+
+  // ── Hooks: core ──
+  useState,
+  useEffect,
+  useContext,
+  useReducer,
+  useCallback,
+  useMemo,
+  useRef,
+  useLayoutEffect,
+
+  // ── Hooks: extended ──
+  useInsertionEffect,
+  useIsomorphicLayoutEffect,
+  useTransition,
+  useDeferredValue,
+  useDebouncedCallback,
+  useThrottledCallback,
+  useOnceCallback,
+  useDeepCompareCallback,
+  useDeepCompareMemo,
+  useDeepCompareEffect,
+  useMemoWith,
+  useMemoTTL,
+  useEffectOnce,
+  useUpdateEffect,
+  usePrevious,
+  usePreviousWithInit,
+  useMutationObserver,
+  useResizeObserver,
+  useAutoFocus,
+  useContextSelector,
+  useContextObserver,
+
+  // ── Hooks: context API ──
+  createContext,
+  useMergedContext,
+  composeContexts,
+
+  // ── Hooks: ref utilities ──
+  createRef,
+  useCallbackRef,
+  forwardRef,
+  isForwardRef,
+  useMergedRefs,
+  useMeasureRef,
+  useInViewRef,
+  useFocusRef,
+  useScrollRef,
+
+  // ── Hooks: batching ──
+  batchedUpdates,
+  batchDispatches,
+  runWithPriority,
+  startTransition,
+
+  // ── Hooks: state comparison ──
+  deepEqual,
+  shallowEqual,
+  areDepsEqual,
+  areDepsDeepEqual,
+
+  // ── Hooks: framework integration ──
+  setCurrentComponent,
+  resetHookIndex,
+  cleanupComponent,
+  flushAllEffects,
+  postRenderProcess,
+
+  // ── Hooks: development tools ──
+  registerDevTools,
+  setHookValidation,
+  validateHookOrder,
+  setProfiling,
+  getComponentProfile,
+  setStrictMode,
+  isInStrictMode,
+  cancelEffect,
+  getContextVersion,
+  getPendingEffectCounts,
+
+  // ── Hooks: constants ──
+  PRIORITY,
+  LAYOUT_PRIORITY,
+
+  // ── Hooks: persistence ──
+  configurePersistence,
+
+  // ── Hooks: middleware ──
+  createLoggerMiddleware,
+  createValidationMiddleware,
+  createTransformMiddleware,
+  createThrottleMiddleware,
+  createActionCreators,
+  createAction,
+
+  // ── Hooks: memo invalidation ──
+  invalidateMemo,
+  invalidateAllMemos,
+
+  // ── Components ──
+  Button,
+  Card,
+  Modal,
+  Input,
+  Table,
+  Navbar,
+  Sidebar,
+  Form,
+  Tabs,
+  Accordion,
+  Alert,
+  Avatar,
+  Badge,
+  Breadcrumb,
+  Carousel,
+  Checkbox,
+  Dialog,
+  Drawer,
+  Dropdown,
+  Menu,
+  Pagination,
+  Progress,
+  Radio,
+  Select,
+  Slider,
+  Spinner,
+  Switch,
+  Textarea,
+  Toast,
+  Tooltip,
+  Typography,
+
+  // ── Utility Modules ──
+  dom,
+  events,
+  utils,
+  animation,
+  http,
+  router,
+  store,
+  validator,
+
+  // ── Framework Configuration ──
+  configure,
+  getConfig,
+  resetConfig,
+  defaultConfig,
+
+  // ── Component Registration ──
+  registerComponent,
+  unregisterComponent,
+  getRegisteredComponent,
+  getRegisteredComponents,
+
+  // ── Plugin System ──
+  usePlugin,
+  uninstallPlugin,
+  isPluginInstalled,
+
+  // ── Error Handling ──
+  setErrorHandler,
+  handleError,
+
+  // ── Debug Mode ──
+  setDebugMode,
+  isDebugMode,
+
+  // ── Framework Info ──
+  getFrameworkInfo,
+};