wu-framework 1.0.6 → 1.1.1

package/src/adapters/index.js

@@ -0,0 +1,157 @@
+/**
+ * 🚀 WU-FRAMEWORK ADAPTERS
+ *
+ * Adapters oficiales para integrar Wu Framework con frameworks populares.
+ * Soporta: React, Vue, Angular, Svelte, Preact, Solid.js, Lit, Vanilla JS
+ *
+ * @example
+ * // Importar adapter específico
+ * import { wuReact } from 'wu-framework/adapters/react';
+ * import { wuVue } from 'wu-framework/adapters/vue';
+ * import { wuAngular } from 'wu-framework/adapters/angular';
+ * import { wuSvelte } from 'wu-framework/adapters/svelte';
+ * import { wuPreact } from 'wu-framework/adapters/preact';
+ * import { wuSolid } from 'wu-framework/adapters/solid';
+ * import { wuLit } from 'wu-framework/adapters/lit';
+ * import { wuVanilla } from 'wu-framework/adapters/vanilla';
+ *
+ * @example
+ * // Importar todo
+ * import {
+ *   wuReact, wuVue, wuAngular, wuSvelte,
+ *   wuPreact, wuSolid, wuLit, wuVanilla
+ * } from 'wu-framework/adapters';
+ */
+
+// ============================================
+// REACT ADAPTER
+// ============================================
+export {
+  wuReact,
+  register as registerReact,
+  createWuSlot,
+  createUseWuEvents,
+  createUseWuStore
+} from './react.js';
+
+// ============================================
+// VUE ADAPTER
+// ============================================
+export {
+  wuVue,
+  register as registerVue,
+  WuSlot,
+  useWuEvents,
+  useWuStore,
+  wuVuePlugin
+} from './vue.js';
+
+// ============================================
+// ANGULAR ADAPTER
+// ============================================
+export {
+  wuAngular,
+  register as registerAngular,
+  registerStandalone as registerAngularStandalone,
+  createWuService,
+  createWuSlotComponent,
+  getWuSlotModuleConfig
+} from './angular.js';
+
+// ============================================
+// SVELTE ADAPTER
+// ============================================
+export {
+  wuSvelte,
+  register as registerSvelte,
+  registerSvelte5,
+  createWuStore as createSvelteWuStore,
+  createWuEventStore,
+  useWuEvents as useSvelteWuEvents,
+  createWuSlotConfig
+} from './svelte.js';
+
+// ============================================
+// PREACT ADAPTER
+// ============================================
+export {
+  wuPreact,
+  register as registerPreact,
+  registerCompat as registerPreactCompat,
+  createWuSlot as createPreactWuSlot,
+  createUseWuEvents as createPreactUseWuEvents,
+  createUseWuStore as createPreactUseWuStore
+} from './preact.js';
+
+// ============================================
+// SOLID.JS ADAPTER
+// ============================================
+export {
+  wuSolid,
+  register as registerSolid,
+  createWuSlot as createSolidWuSlot,
+  createWuStore as createSolidWuStore,
+  createWuEvent,
+  useWuEvents as useSolidWuEvents,
+  createWuContext
+} from './solid.js';
+
+// ============================================
+// LIT (WEB COMPONENTS) ADAPTER
+// ============================================
+export {
+  wuLit,
+  register as registerLit,
+  registerWebComponent,
+  createWuSlotElement,
+  WuMixin,
+  wuProperty,
+  createSimpleElement
+} from './lit.js';
+
+// ============================================
+// VANILLA JS ADAPTER
+// ============================================
+export {
+  wuVanilla,
+  register as registerVanilla,
+  registerClass,
+  registerTemplate,
+  createComponent,
+  createWuSlot as createVanillaWuSlot,
+  useWuEvents as useVanillaWuEvents,
+  useWuStore as useVanillaWuStore
+} from './vanilla.js';
+
+// ============================================
+// SHARED UTILITIES
+// ============================================
+export { getWuInstance, waitForWu } from './react.js';
+
+// ============================================
+// ALL ADAPTERS OBJECT
+// ============================================
+import { wuReact } from './react.js';
+import { wuVue } from './vue.js';
+import { wuAngular } from './angular.js';
+import { wuSvelte } from './svelte.js';
+import { wuPreact } from './preact.js';
+import { wuSolid } from './solid.js';
+import { wuLit } from './lit.js';
+import { wuVanilla } from './vanilla.js';
+
+/**
+ * Objeto con todos los adapters disponibles
+ */
+export const adapters = {
+  react: wuReact,
+  vue: wuVue,
+  angular: wuAngular,
+  svelte: wuSvelte,
+  preact: wuPreact,
+  solid: wuSolid,
+  lit: wuLit,
+  vanilla: wuVanilla
+};
+
+export default adapters;

package/src/adapters/lit.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 🚀 WU-FRAMEWORK LIT ADAPTER - TypeScript Declarations
+ */
+
+import type { WuCore } from '../core/wu-core';
+
+// Lit types (generics to avoid hard dependency)
+type LitElement = any;
+type TemplateResult = any;
+
+/**
+ * Opciones de registro Lit
+ */
+export interface LitRegisterOptions {
+  /** Nombre del custom element (auto-generado si no se provee) */
+  tagName?: string;
+  /** Propiedades iniciales */
+  properties?: Record<string, any>;
+  /** Callback después de montar */
+  onMount?: (container: HTMLElement, element: HTMLElement) => void;
+  /** Callback antes de desmontar */
+  onUnmount?: (container: HTMLElement, element: HTMLElement) => void;
+  /** Permitir ejecución standalone */
+  standalone?: boolean;
+  /** Selector para modo standalone */
+  standaloneContainer?: string;
+}
+
+/**
+ * Configuración para crear elemento simple
+ */
+export interface SimpleElementConfig {
+  /** Nombre del custom element */
+  name: string;
+  /** Template HTML */
+  template: string | ((element: HTMLElement) => string);
+  /** Estilos CSS */
+  styles?: string;
+  /** Usar Shadow DOM */
+  shadow?: boolean;
+  /** Atributos observados */
+  observedAttributes?: string[];
+  /** Callback cuando se conecta */
+  connectedCallback?: (this: HTMLElement) => void;
+  /** Callback cuando se desconecta */
+  disconnectedCallback?: (this: HTMLElement) => void;
+  /** Callback cuando cambia un atributo */
+  attributeChangedCallback?: (this: HTMLElement, name: string, oldVal: string, newVal: string) => void;
+}
+
+/**
+ * Clase WuSlot Element
+ */
+export interface WuSlotElementClass {
+  new(): HTMLElement & {
+    name: string;
+    url: string;
+    appName: string | null;
+    fallbackText: string | null;
+    loading: boolean;
+    error: string | null;
+  };
+}
+
+/**
+ * Tipo para el Mixin de Wu
+ */
+export type WuMixinResult<T extends new (...args: any[]) => any> = T & {
+  new (...args: any[]): InstanceType<T> & {
+    readonly wu: WuCore | null;
+    wuEmit(event: string, data?: any, options?: any): void;
+    wuOn(event: string, callback: (data: any) => void): () => void;
+    wuOnce(event: string, callback: (data: any) => void): () => void;
+    wuGetState(path?: string): any;
+    wuSetState(path: string, value: any): void;
+    wuOnStateChange(pattern: string, callback: (value: any) => void): () => void;
+  };
+};
+
+export function register(
+  appName: string,
+  ElementClass: CustomElementConstructor,
+  options?: LitRegisterOptions
+): Promise<boolean>;
+
+export function registerWebComponent(
+  appName: string,
+  ElementClass: CustomElementConstructor,
+  options?: LitRegisterOptions
+): Promise<boolean>;
+
+export function createWuSlotElement(
+  LitElement: any,
+  html: (strings: TemplateStringsArray, ...values: any[]) => TemplateResult,
+  css?: (strings: TemplateStringsArray, ...values: any[]) => any
+): WuSlotElementClass;
+
+export function WuMixin<T extends new (...args: any[]) => any>(Base: T): WuMixinResult<T>;
+
+export function wuProperty(storePath: string): PropertyDecorator;
+
+export function createSimpleElement(config: SimpleElementConfig): CustomElementConstructor;
+
+export function getWuInstance(): WuCore | null;
+
+export function waitForWu(timeout?: number): Promise<WuCore>;
+
+export interface WuLitAdapter {
+  register: typeof register;
+  registerWebComponent: typeof registerWebComponent;
+  createWuSlotElement: typeof createWuSlotElement;
+  WuMixin: typeof WuMixin;
+  wuProperty: typeof wuProperty;
+  createSimpleElement: typeof createSimpleElement;
+  getWuInstance: typeof getWuInstance;
+  waitForWu: typeof waitForWu;
+}
+
+export const wuLit: WuLitAdapter;
+export default wuLit;