elit 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -125,6 +125,96 @@ declare const cleanupUnused: (root: HTMLElement) => number;
 declare const throttle: <T extends any[]>(fn: (...args: T) => void, delay: number) => (...args: T) => void;
 declare const debounce: <T extends any[]>(fn: (...args: T) => void, delay: number) => (...args: T) => void;
 
+/**
+ * Shared State for Elit
+ * Integrates with @elit/server for real-time state synchronization
+ */
+
+type StateChangeCallback<T = any> = (value: T, oldValue: T) => void;
+/**
+ * Shared State - syncs with @elit/server
+ */
+declare class SharedState<T = any> {
+    readonly key: string;
+    private wsUrl?;
+    private localState;
+    private ws;
+    private pendingUpdates;
+    private previousValue;
+    constructor(key: string, defaultValue: T, wsUrl?: string | undefined);
+    /**
+     * Get current value
+     */
+    get value(): T;
+    /**
+     * Set new value and sync to server
+     */
+    set value(newValue: T);
+    /**
+     * Get the underlying Elit State (for reactive binding)
+     */
+    get state(): State<T>;
+    /**
+     * Subscribe to changes (returns Elit State for reactive)
+     */
+    onChange(callback: StateChangeCallback<T>): () => void;
+    /**
+     * Update value using a function
+     */
+    update(updater: (current: T) => T): void;
+    /**
+     * Connect to WebSocket
+     */
+    private connect;
+    /**
+     * Subscribe to server state
+     */
+    private subscribe;
+    /**
+     * Handle message from server
+     */
+    private handleMessage;
+    /**
+     * Send value to server
+     */
+    private sendToServer;
+    /**
+     * Disconnect
+     */
+    disconnect(): void;
+    /**
+     * Destroy state and cleanup
+     */
+    destroy(): void;
+}
+/**
+ * Create a shared state that syncs with @elit/server
+ */
+declare function createSharedState<T>(key: string, defaultValue: T, wsUrl?: string): SharedState<T>;
+/**
+ * Shared State Manager for managing multiple shared states
+ */
+declare class SharedStateManager {
+    private states;
+    /**
+     * Create or get a shared state
+     */
+    create<T>(key: string, defaultValue: T, wsUrl?: string): SharedState<T>;
+    /**
+     * Get existing state
+     */
+    get<T>(key: string): SharedState<T> | undefined;
+    /**
+     * Delete a state
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all states
+     */
+    clear(): void;
+}
+declare const sharedStateManager: SharedStateManager;
+
 /**
  * Elit - Reactive Rendering Helpers
  */
@@ -472,6 +562,45 @@ declare const mathMsub: ElementFactory;
 declare const mathMsup: ElementFactory;
 declare const varElement: ElementFactory;
 
+/**
+ * DOM utility functions - Shorthand helpers for common document operations
+ */
+declare const doc: Document;
+declare const el: {
+    <K extends keyof HTMLElementTagNameMap>(selectors: K): HTMLElementTagNameMap[K] | null;
+    <K extends keyof SVGElementTagNameMap>(selectors: K): SVGElementTagNameMap[K] | null;
+    <K extends keyof MathMLElementTagNameMap>(selectors: K): MathMLElementTagNameMap[K] | null;
+    <K extends keyof HTMLElementDeprecatedTagNameMap>(selectors: K): HTMLElementDeprecatedTagNameMap[K] | null;
+    <E extends Element = Element>(selectors: string): E | null;
+};
+declare const els: {
+    <K extends keyof HTMLElementTagNameMap>(selectors: K): NodeListOf<HTMLElementTagNameMap[K]>;
+    <K extends keyof SVGElementTagNameMap>(selectors: K): NodeListOf<SVGElementTagNameMap[K]>;
+    <K extends keyof MathMLElementTagNameMap>(selectors: K): NodeListOf<MathMLElementTagNameMap[K]>;
+    <K extends keyof HTMLElementDeprecatedTagNameMap>(selectors: K): NodeListOf<HTMLElementDeprecatedTagNameMap[K]>;
+    <E extends Element = Element>(selectors: string): NodeListOf<E>;
+};
+declare const createEl: {
+    <K extends keyof HTMLElementTagNameMap>(tagName: K, options?: ElementCreationOptions): HTMLElementTagNameMap[K];
+    <K extends keyof HTMLElementDeprecatedTagNameMap>(tagName: K, options?: ElementCreationOptions): HTMLElementDeprecatedTagNameMap[K];
+    (tagName: string, options?: ElementCreationOptions): HTMLElement;
+};
+declare const createSvgEl: (qualifiedName: string, options?: string | ElementCreationOptions | undefined) => Element;
+declare const createMathEl: (qualifiedName: string, options?: string | ElementCreationOptions | undefined) => Element;
+declare const fragment: () => DocumentFragment;
+declare const textNode: (data: string) => Text;
+declare const commentNode: (data: string) => Comment;
+declare const elId: (elementId: string) => HTMLElement | null;
+declare const elClass: (classNames: string) => HTMLCollectionOf<Element>;
+declare const elTag: {
+    <K extends keyof HTMLElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<HTMLElementTagNameMap[K]>;
+    <K extends keyof SVGElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<SVGElementTagNameMap[K]>;
+    <K extends keyof MathMLElementTagNameMap>(qualifiedName: K): HTMLCollectionOf<MathMLElementTagNameMap[K]>;
+    <K extends keyof HTMLElementDeprecatedTagNameMap>(qualifiedName: K): HTMLCollectionOf<HTMLElementDeprecatedTagNameMap[K]>;
+    (qualifiedName: string): HTMLCollectionOf<Element>;
+};
+declare const elName: (elementName: string) => NodeListOf<HTMLElement>;
+
 /**
  * Elit - Optimized lightweight library for creating DOM elements with reactive state
  */
@@ -498,4 +627,4 @@ declare const renderVNodeToString: (json: VNodeJson, options?: {
     indent?: number;
 }) => string;
 
-export { type CSSRule, type CSSVariable, type Child, type Children, type ContainerRule, CreateStyle, DomNode, type ElementFactory, type FontFace, type JsonNode, type KeyframeStep, type Keyframes, type LayerRule, type MediaRule, type Props, type RefCallback, type RefObject, type Route, type RouteLocation, type RouteParams, type Router, type RouterOptions, type State, type StateOptions, type SupportsRule, type VNode, type VNodeJson, type VirtualListController, a, abbr, addLink, addMeta, addStyle, address, area, article, aside, audio, b, base, batchRender, bdi, bdo, bindChecked, bindValue, blockquote, body, br, button, canvas, caption, cite, cleanupUnused, code, col, colgroup, computed, createElementFactory, createRouter, createRouterView, createState, createVirtualList, data, datalist, dd, debounce, del, details, dfn, dialog, div, dl, domNode, dt, effect, elements, em, embed, fieldset, figcaption, figure, footer, form, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, jsonToVNode, kbd, label, lazy, legend, li, link, main, map, mark, mathMath, mathMfrac, mathMi, mathMn, mathMo, mathMroot, mathMrow, mathMs, mathMsqrt, mathMsub, mathMsup, mathMtext, menu, meta, meter, nav, noscript, object, ol, optgroup, option, output, p, param, picture, portal, pre, progress, q, reactive, reactiveAs, renderChunked, renderJson, renderJsonToString, renderToHead, renderToString, renderVNode, renderVNodeToString, routerLink, rp, rt, ruby, s, samp, script, section, select, setTitle, slot, small, source, span, strong, style, sub, summary, sup, svgAnimate, svgAnimateMotion, svgAnimateTransform, svgCircle, svgClipPath, svgDefs, svgEllipse, svgFeBlend, svgFeColorMatrix, svgFeComponentTransfer, svgFeComposite, svgFeConvolveMatrix, svgFeDiffuseLighting, svgFeDisplacementMap, svgFeFlood, svgFeGaussianBlur, svgFeMorphology, svgFeOffset, svgFeSpecularLighting, svgFeTile, svgFeTurbulence, svgFilter, svgForeignObject, svgG, svgImage, svgLine, svgLinearGradient, svgMarker, svgMask, svgPath, svgPattern, svgPolygon, svgPolyline, svgRadialGradient, svgRect, svgSet, svgStop, svgSvg, svgSymbol, svgText, svgTspan, svgUse, table, tbody, td, template, text, textarea, tfoot, th, thead, throttle, time, title, tr, track, u, ul, vNodeJsonToVNode, varElement, video, wbr };
+export { type CSSRule, type CSSVariable, type Child, type Children, type ContainerRule, CreateStyle, DomNode, type ElementFactory, type FontFace, type JsonNode, type KeyframeStep, type Keyframes, type LayerRule, type MediaRule, type Props, type RefCallback, type RefObject, type Route, type RouteLocation, type RouteParams, type Router, type RouterOptions, SharedState, type State, type StateOptions, type SupportsRule, type VNode, type VNodeJson, type VirtualListController, a, abbr, addLink, addMeta, addStyle, address, area, article, aside, audio, b, base, batchRender, bdi, bdo, bindChecked, bindValue, blockquote, body, br, button, canvas, caption, cite, cleanupUnused, code, col, colgroup, commentNode, computed, createEl, createElementFactory, createMathEl, createRouter, createRouterView, createSharedState, createState, createSvgEl, createVirtualList, data, datalist, dd, debounce, del, details, dfn, dialog, div, dl, doc, domNode, dt, effect, el, elClass, elId, elName, elTag, elements, els, em, embed, fieldset, figcaption, figure, footer, form, fragment, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, jsonToVNode, kbd, label, lazy, legend, li, link, main, map, mark, mathMath, mathMfrac, mathMi, mathMn, mathMo, mathMroot, mathMrow, mathMs, mathMsqrt, mathMsub, mathMsup, mathMtext, menu, meta, meter, nav, noscript, object, ol, optgroup, option, output, p, param, picture, portal, pre, progress, q, reactive, reactiveAs, renderChunked, renderJson, renderJsonToString, renderToHead, renderToString, renderVNode, renderVNodeToString, routerLink, rp, rt, ruby, s, samp, script, section, select, setTitle, sharedStateManager, slot, small, source, span, strong, style, sub, summary, sup, svgAnimate, svgAnimateMotion, svgAnimateTransform, svgCircle, svgClipPath, svgDefs, svgEllipse, svgFeBlend, svgFeColorMatrix, svgFeComponentTransfer, svgFeComposite, svgFeConvolveMatrix, svgFeDiffuseLighting, svgFeDisplacementMap, svgFeFlood, svgFeGaussianBlur, svgFeMorphology, svgFeOffset, svgFeSpecularLighting, svgFeTile, svgFeTurbulence, svgFilter, svgForeignObject, svgG, svgImage, svgLine, svgLinearGradient, svgMarker, svgMask, svgPath, svgPattern, svgPolygon, svgPolyline, svgRadialGradient, svgRect, svgSet, svgStop, svgSvg, svgSymbol, svgText, svgTspan, svgUse, table, tbody, td, template, text, textNode, textarea, tfoot, th, thead, throttle, time, title, tr, track, u, ul, vNodeJsonToVNode, varElement, video, wbr };