tina4js 1.0.15 → 1.1.0

package/dist/api/fetch.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Tina4 API — Fetch wrapper with auth token management.
+ *
+ * Compatible with tina4-php and tina4-python backends:
+ * - Sends Authorization: Bearer <token>
+ * - Reads FreshToken response header for token rotation
+ * - Sends formToken in POST/PUT/PATCH/DELETE bodies
+ */
+export interface ApiConfig {
+    baseUrl: string;
+    auth: boolean;
+    tokenKey: string;
+    headers: Record<string, string>;
+}
+export interface ApiResponse<T = unknown> {
+    status: number;
+    data: T;
+    ok: boolean;
+    headers: Headers;
+    /** @internal Used by debug tracker for request/response correlation. */
+    _requestId?: number;
+}
+export type RequestInterceptor = (config: RequestInit & {
+    headers: Record<string, string>;
+}) => (RequestInit & {
+    headers: Record<string, string>;
+}) | void;
+export type ResponseInterceptor = (response: ApiResponse) => ApiResponse | void;
+export interface RequestOptions {
+    headers?: Record<string, string>;
+    params?: Record<string, string | number | boolean>;
+}
+/**
+ * HTTP client pre-configured for tina4-php / tina4-python backends.
+ *
+ * Features:
+ * - Automatic `Authorization: Bearer <token>` header when `auth: true`
+ * - Token rotation via `FreshToken` response header
+ * - `formToken` injected into POST/PUT/PATCH/DELETE bodies for CSRF protection
+ * - Per-request `headers` and `params` via `RequestOptions`
+ * - Request/response interceptors
+ *
+ * @example
+ * api.configure({ baseUrl: 'https://api.example.com', auth: true });
+ *
+ * const users = await api.get('/users');
+ * const user  = await api.get('/users', { params: { id: 42 } });
+ * await api.post('/users', { name: 'Alice' });
+ * await api.delete('/users/1');
+ */
+export declare const api: {
+    /**
+     * Configure the API client. Call once at app startup.
+     *
+     * @example
+     * api.configure({
+     *   baseUrl: 'https://api.example.com',
+     *   auth: true,
+     *   tokenKey: 'my_token',   // localStorage key (default: 'tina4_token')
+     *   headers: { 'X-App': '1' }, // default headers on every request
+     * });
+     */
+    configure(c: Partial<ApiConfig>): void;
+    /**
+     * HTTP GET request.
+     * @param path    - API path relative to `baseUrl`.
+     * @param options - `{ params, headers }` — query string params and per-request headers.
+     * @example
+     * const data = await api.get('/products', { params: { page: 2, limit: 20 } });
+     */
+    get<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * HTTP POST request.
+     * @param path    - API path.
+     * @param body    - Request body (serialised as JSON).
+     * @param options - `{ params, headers }`.
+     * @example
+     * await api.post('/users', { name: 'Alice', role: 'admin' });
+     */
+    post<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /** HTTP PUT — full replace. */
+    put<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /** HTTP PATCH — partial update. */
+    patch<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /** HTTP DELETE. */
+    delete<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Upload files via FormData (multipart/form-data).
+     *
+     * Unlike `post()`, this does NOT JSON-stringify the body or set
+     * Content-Type — the browser sets the multipart boundary automatically.
+     * Auth uses the Bearer token header (formToken cannot be injected into FormData).
+     *
+     * @param path     - API path relative to `baseUrl`.
+     * @param formData - A FormData instance containing files and fields.
+     * @param options  - `{ params, headers }` — query string params and per-request headers.
+     *
+     * @example
+     * const form = new FormData();
+     * form.append('avatar', fileInput.files[0]);
+     * form.append('name', 'Alice');
+     * const result = await api.upload('/users/avatar', form);
+     */
+    upload<T = unknown>(path: string, formData: FormData, options?: RequestOptions): Promise<T>;
+    /**
+     * Register a request or response interceptor.
+     *
+     * @example
+     * // Add a custom header to every request
+     * api.intercept('request', (config) => {
+     *   config.headers['X-Client'] = 'my-app';
+     * });
+     *
+     * // Redirect to login on 401
+     * api.intercept('response', (res) => {
+     *   if (res.status === 401) navigate('/login');
+     * });
+     */
+    intercept(type: "request" | "response", fn: RequestInterceptor | ResponseInterceptor): void;
+    /** @internal Reset state (for tests). */
+    _reset(): void;
+};
+//# sourceMappingURL=fetch.d.ts.map

package/dist/api/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/api/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,KAAK,CAAC,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,GAAG,IAAI,CAAC;AAC3J,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,WAAW,KAAK,WAAW,GAAG,IAAI,CAAC;AA+BhF,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACpD;AA+FD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,GAAG;IACd;;;;;;;;;;OAUG;iBACU,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IAItC;;;;;;OAMG;QACC,CAAC,kBAAkB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpE;;;;;;;OAOG;SACE,CAAC,kBAAkB,MAAM,SAAS,OAAO,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrF,+BAA+B;QAC3B,CAAC,kBAAkB,MAAM,SAAS,OAAO,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpF,mCAAmC;UAC7B,CAAC,kBAAkB,MAAM,SAAS,OAAO,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAItF,mBAAmB;WACZ,CAAC,kBAAkB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAIvE;;;;;;;;;;;;;;;;OAgBG;WACU,CAAC,kBAAkB,MAAM,YAAY,QAAQ,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAiFjG;;;;;;;;;;;;;OAaG;oBACa,SAAS,GAAG,UAAU,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,IAAI;IAQ3F,yCAAyC;cAC/B,IAAI;CAQf,CAAC"}

package/dist/api/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * tina4js/api — Fetch wrapper with auth token management.
+ */
+export { api } from './fetch';
+export type { ApiConfig, ApiResponse, RequestOptions, RequestInterceptor, ResponseInterceptor } from './fetch';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAC9B,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/dist/core/component.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Tina4 Component — Base class for web components.
+ *
+ * Extends HTMLElement with reactive props, lifecycle hooks,
+ * optional Shadow DOM, and scoped styles.
+ */
+import { type Signal } from './signal';
+/** @internal Called when a Tina4Element is connected to the DOM. */
+export declare let __debugComponentMount: ((el: Tina4Element) => void) | null;
+/** @internal Called when a Tina4Element is disconnected from the DOM. */
+export declare let __debugComponentUnmount: ((el: Tina4Element) => void) | null;
+/** @internal Set the debug hooks. */
+export declare function __setDebugComponentHooks(onMount: typeof __debugComponentMount, onUnmount: typeof __debugComponentUnmount): void;
+export type PropType = typeof String | typeof Number | typeof Boolean;
+export declare abstract class Tina4Element extends HTMLElement {
+    /** Declare reactive props and their types. Override in subclass. */
+    static props: Record<string, PropType>;
+    /** Scoped CSS styles. Override in subclass. */
+    static styles: string;
+    /** Use Shadow DOM (true) or light DOM (false). Override in subclass. */
+    static shadow: boolean;
+    /** Internal reactive prop signals. */
+    private _props;
+    /** The render root (shadow or this). */
+    private _root;
+    /** Track if we've rendered. */
+    private _rendered;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, _old: string | null, value: string | null): void;
+    /**
+     * Get a reactive signal for a declared prop.
+     *
+     * ```ts
+     * render() {
+     *   return html`<span>${this.prop('name')}</span>`;
+     * }
+     * ```
+     */
+    prop<T = unknown>(name: string): Signal<T>;
+    /**
+     * Dispatch a custom event from this component.
+     *
+     * ```ts
+     * this.emit('activate', { detail: 42 });
+     * ```
+     */
+    emit(name: string, init?: CustomEventInit): void;
+    /** Called after first render. */
+    onMount(): void;
+    /** Called when removed from DOM. */
+    onUnmount(): void;
+    /** Return DOM content. Override in subclass. */
+    abstract render(): DocumentFragment | Node | null;
+    private _coerce;
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/core/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/core/component.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAI/C,oEAAoE;AACpE,eAAO,IAAI,qBAAqB,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAW,CAAC;AAC7E,yEAAyE;AACzE,eAAO,IAAI,uBAAuB,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAW,CAAC;AAC/E,qCAAqC;AACrC,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,qBAAqB,EACrC,SAAS,EAAE,OAAO,uBAAuB,QAI1C;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,MAAM,GAAG,OAAO,MAAM,GAAG,OAAO,OAAO,CAAC;AAEtE,8BAAsB,YAAa,SAAQ,WAAW;IACpD,oEAAoE;IACpE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAM;IAE5C,+CAA+C;IAC/C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAE3B,wEAAwE;IACxE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAQ;IAE9B,sCAAsC;IACtC,OAAO,CAAC,MAAM,CAAuC;IAErD,wCAAwC;IACxC,OAAO,CAAC,KAAK,CAA2B;IAExC,+BAA+B;IAC/B,OAAO,CAAC,SAAS,CAAS;IAE1B,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;;IAaD,iBAAiB,IAAI,IAAI;IAuBzB,oBAAoB,IAAI,IAAI;IAK5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAQvF;;;;;;;;OAQG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAO1C;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI;IAUhD,iCAAiC;IACjC,OAAO,IAAI,IAAI;IAEf,oCAAoC;IACpC,SAAS,IAAI,IAAI;IAEjB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,IAAI,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAIjD,OAAO,CAAC,OAAO;CAKhB"}

package/dist/core/html.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Tina4 HTML — Tagged template literal renderer.
+ *
+ * html`<div>${value}</div>` returns real DOM nodes (DocumentFragment).
+ * When a signal is interpolated, the DOM updates surgically — no diffing.
+ */
+/**
+ * Tagged template literal renderer — builds real DOM nodes with surgical reactive updates.
+ *
+ * Interpolated values are bound as follows:
+ * - `${signal}`      → reactive text node, updates in place when the signal changes
+ * - `${() => expr}`  → reactive block, re-renders when any signal read inside changes
+ * - `${fragment}`    → inserts a DocumentFragment (nested `html\`\``)
+ * - `${array}`       → renders each item as nodes
+ * - `${value}`       → static text node (escaped — XSS-safe)
+ *
+ * Attribute binding syntax (in tag attributes):
+ * - `.innerHTML=${val}`  → sets DOM property (use for raw HTML / inline SVG)
+ * - `.value=${signal}`   → reactive DOM property binding
+ * - `?disabled=${sig}`   → boolean attribute — added/removed reactively
+ * - `@click=${fn}`       → event listener
+ *
+ * **Important:** `${svgString}` in content position renders as escaped text.
+ * To inject raw HTML or SVG, use: `<div .innerHTML=${svgString}></div>`
+ *
+ * @param strings - Template string parts (static, cached by identity).
+ * @param values  - Interpolated values.
+ * @returns A DocumentFragment ready to append to the DOM.
+ *
+ * @example
+ * const name = signal('World');
+ * const frag = html`<h1>Hello, ${name}!</h1>`;
+ * document.body.appendChild(frag);
+ * name.value = 'Tina4'; // DOM updates automatically
+ */
+export declare function html(strings: TemplateStringsArray, ...values: unknown[]): DocumentFragment;
+//# sourceMappingURL=html.d.ts.map

package/dist/core/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/core/html.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAiC1F"}

package/dist/core/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * tina4js/core — Reactive primitives, HTML renderer, and web component base.
+ */
+export { signal, computed, effect, batch, isSignal } from './signal';
+export type { Signal, ReadonlySignal } from './signal';
+export { html } from './html';
+export { Tina4Element } from './component';
+export type { PropType } from './component';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACrE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/signal.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Tina4 Signals — Reactive state primitives.
+ *
+ * signal(value)       — create a reactive value
+ * computed(fn)        — derive a value that auto-tracks dependencies
+ * effect(fn)          — run a side-effect that auto-tracks dependencies
+ * batch(fn)           — batch multiple signal updates into one notification
+ */
+/** @internal Start collecting effect disposers (used by router). */
+export declare function _setEffectCollector(collector: (() => void)[] | null): void;
+/** @internal Read the current effect collector (used by html renderer). */
+export declare function _getEffectCollector(): (() => void)[] | null;
+/** @internal Called when a signal is created. */
+export declare let __debugSignalCreate: ((s: Signal<unknown>, label?: string) => void) | null;
+/** @internal Called when a signal value changes. */
+export declare let __debugSignalUpdate: ((s: Signal<unknown>, oldVal: unknown, newVal: unknown) => void) | null;
+/** @internal Set the debug hooks. */
+export declare function __setDebugSignalHooks(onCreate: typeof __debugSignalCreate, onUpdate: typeof __debugSignalUpdate): void;
+export interface Signal<T> {
+    value: T;
+    /** @internal */
+    readonly _t4: true;
+    /** @internal subscribe directly (used by html renderer) */
+    _subscribe(fn: () => void): () => void;
+    /** @internal read without tracking */
+    peek(): T;
+}
+export interface ReadonlySignal<T> {
+    readonly value: T;
+    /** @internal */
+    readonly _t4: true;
+    /** @internal */
+    _subscribe(fn: () => void): () => void;
+    peek(): T;
+}
+/**
+ * Create a reactive signal — a value that notifies subscribers when it changes.
+ *
+ * @param initial - The initial value.
+ * @param label   - Optional debug label shown in the debug overlay.
+ * @returns A signal whose `.value` getter/setter is reactive.
+ *
+ * @example
+ * const count = signal(0);
+ * count.value;      // read: 0
+ * count.value = 5;  // write: triggers all subscribers
+ *
+ * const name = signal('Alice', 'userName'); // labelled for debug overlay
+ */
+export declare function signal<T>(initial: T, label?: string): Signal<T>;
+/**
+ * Create a derived signal that auto-tracks its dependencies.
+ * Re-computes whenever any signal read inside `fn` changes.
+ * The result is read-only — writing throws.
+ *
+ * @param fn - Pure function that reads signals and returns a derived value.
+ * @returns A read-only signal.
+ *
+ * @example
+ * const price = signal(10);
+ * const qty   = signal(3);
+ * const total = computed(() => price.value * qty.value);
+ * total.value; // 30 — updates automatically when price or qty change
+ */
+export declare function computed<T>(fn: () => T): ReadonlySignal<T>;
+/**
+ * Run a side-effect that auto-tracks signal dependencies.
+ * Runs immediately, then re-runs whenever a dependency changes.
+ * If the effect throws, sibling effects still run; the first error is re-thrown
+ * after all subscribers have been notified.
+ *
+ * @param fn - The side-effect function. Reads signals to establish tracking.
+ * @returns A `dispose` function — call it to stop the effect.
+ *
+ * @example
+ * const count = signal(0);
+ * const stop = effect(() => {
+ *   console.log('count is', count.value);
+ * });
+ * // logs immediately, then on every count change
+ * stop(); // unsubscribe
+ */
+export declare function effect(fn: () => void): () => void;
+/**
+ * Batch multiple signal updates into a single notification pass.
+ * Subscribers are notified once after `fn` completes, not after each write.
+ *
+ * @param fn - Function containing one or more signal writes.
+ *
+ * @example
+ * const a = signal(1);
+ * const b = signal(2);
+ * batch(() => {
+ *   a.value = 10;
+ *   b.value = 20;
+ * }); // effects run once, not twice
+ */
+export declare function batch(fn: () => void): void;
+/** Check if a value is a tina4 signal. */
+export declare function isSignal(value: unknown): value is Signal<unknown>;
+//# sourceMappingURL=signal.d.ts.map

package/dist/core/signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/core/signal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,GAAG,IAAI,GAAG,IAAI,CAE1E;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE,GAAG,IAAI,CAE3D;AAID,iDAAiD;AACjD,eAAO,IAAI,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAW,CAAC;AAC7F,oDAAoD;AACpD,eAAO,IAAI,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAW,CAAC;AAC/G,qCAAqC;AACrC,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,OAAO,mBAAmB,EACpC,QAAQ,EAAE,OAAO,mBAAmB,QAIrC;AAUD,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC;IACT,gBAAgB;IAChB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACvC,sCAAsC;IACtC,IAAI,IAAI,CAAC,CAAC;CACX;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,gBAAgB;IAChB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,gBAAgB;IAChB,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IACvC,IAAI,IAAI,CAAC,CAAC;CACX;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAoD/D;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CA2B1D;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAgCjD;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAgB1C;AAID,0CAA0C;AAC1C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAEjE"}

package/dist/debug/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * tina4js/debug — Developer debug overlay.
+ *
+ * Import this module to enable the debug overlay:
+ *   import 'tina4js/debug';
+ *
+ * Or conditionally:
+ *   if (import.meta.env.DEV) import('tina4js/debug');
+ *
+ * Toggle: Ctrl+Shift+D
+ */
+/**
+ * Enable the debug overlay. Called automatically on import,
+ * or can be called explicitly.
+ */
+export declare function enableDebug(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAsDlC"}

package/dist/debug/overlay.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Debug Overlay — Shadow DOM custom element with tabbed panel UI.
+ */
+export declare class Tina4Debug extends HTMLElement {
+    private _shadow;
+    private _visible;
+    private _activeTab;
+    private _refreshTimer;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    toggle(): void;
+    show(): void;
+    hide(): void;
+    private _startAutoRefresh;
+    private _stopAutoRefresh;
+    private _switchTab;
+    private _getTabContent;
+    private _renderBody;
+    private _updateTabCounts;
+    private _render;
+}
+/** Register the custom element. Call before creating instances. */
+export declare function registerDebugElement(): void;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/debug/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/debug/overlay.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,aAAa,CAAuB;;IAO5C,iBAAiB;IAKjB,oBAAoB;IAIpB,MAAM;IAKN,IAAI;IAKJ,IAAI;IAKJ,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,OAAO;CAsDhB;AAED,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}

package/dist/debug/panels/api.d.ts

@@ -0,0 +1,5 @@
+/**
+ * API Panel — Request/response log.
+ */
+export declare function renderApiPanel(): string;
+//# sourceMappingURL=api.d.ts.map

package/dist/debug/panels/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/debug/panels/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuBH,wBAAgB,cAAc,IAAI,MAAM,CAyBvC"}

package/dist/debug/panels/components.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Components Panel — Mounted Tina4Elements inspector.
+ */
+export declare function renderComponentsPanel(): string;
+//# sourceMappingURL=components.d.ts.map

package/dist/debug/panels/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../src/debug/panels/components.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,qBAAqB,IAAI,MAAM,CAsB9C"}

package/dist/debug/panels/routes.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Routes Panel — Registered routes and navigation history.
+ */
+export declare function renderRoutesPanel(): string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/debug/panels/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/debug/panels/routes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,wBAAgB,iBAAiB,IAAI,MAAM,CA8C1C"}

package/dist/debug/panels/signals.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Signals Panel — Live signal inspector.
+ */
+export declare function renderSignalsPanel(): string;
+//# sourceMappingURL=signals.d.ts.map

package/dist/debug/panels/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../../src/debug/panels/signals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,wBAAgB,kBAAkB,IAAI,MAAM,CAuB3C"}

package/dist/debug/styles.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Debug Overlay Styles — Scoped inside Shadow DOM.
+ */
+export declare const debugStyles = "\n:host {\n  all: initial;\n  position: fixed;\n  bottom: 0;\n  right: 0;\n  z-index: 999999;\n  font-family: 'SF Mono', 'Fira Code', 'Cascadia Code', monospace;\n  font-size: 12px;\n  color: #e0e0e0;\n  line-height: 1.4;\n}\n\n* { box-sizing: border-box; }\n\n.t4-debug {\n  width: 480px;\n  max-height: 420px;\n  background: #1a1a2e;\n  border: 1px solid #333;\n  border-radius: 8px 0 0 0;\n  display: flex;\n  flex-direction: column;\n  box-shadow: -4px -4px 20px rgba(0,0,0,0.5);\n}\n\n.t4-debug.collapsed {\n  max-height: none;\n}\n\n.t4-header {\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  padding: 6px 12px;\n  background: #16213e;\n  border-bottom: 1px solid #333;\n  border-radius: 8px 0 0 0;\n  cursor: move;\n  user-select: none;\n}\n\n.t4-logo {\n  font-weight: 700;\n  font-size: 13px;\n  color: #00d4ff;\n  letter-spacing: 0.5px;\n}\n\n.t4-badge {\n  font-size: 10px;\n  padding: 1px 6px;\n  border-radius: 4px;\n  background: #0f3460;\n  color: #00d4ff;\n  margin-left: 8px;\n}\n\n.t4-header-right {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n}\n\n.t4-close {\n  background: none;\n  border: none;\n  color: #888;\n  cursor: pointer;\n  font-size: 16px;\n  padding: 2px 6px;\n  border-radius: 4px;\n}\n.t4-close:hover { color: #ff6b6b; background: rgba(255,107,107,0.1); }\n\n.t4-tabs {\n  display: flex;\n  border-bottom: 1px solid #333;\n  background: #16213e;\n}\n\n.t4-tab {\n  flex: 1;\n  padding: 6px 8px;\n  background: none;\n  border: none;\n  color: #888;\n  cursor: pointer;\n  font-size: 11px;\n  font-family: inherit;\n  border-bottom: 2px solid transparent;\n  transition: all 0.15s;\n}\n.t4-tab:hover { color: #ccc; background: rgba(255,255,255,0.03); }\n.t4-tab.active {\n  color: #00d4ff;\n  border-bottom-color: #00d4ff;\n  background: rgba(0,212,255,0.05);\n}\n\n.t4-tab-count {\n  font-size: 10px;\n  color: #666;\n  margin-left: 4px;\n}\n\n.t4-body {\n  flex: 1;\n  overflow-y: auto;\n  padding: 8px;\n  min-height: 200px;\n  max-height: 340px;\n}\n\n.t4-body::-webkit-scrollbar { width: 6px; }\n.t4-body::-webkit-scrollbar-track { background: transparent; }\n.t4-body::-webkit-scrollbar-thumb { background: #333; border-radius: 3px; }\n\n/* Panel table styles */\ntable {\n  width: 100%;\n  border-collapse: collapse;\n}\n\nth {\n  text-align: left;\n  padding: 4px 8px;\n  color: #888;\n  font-weight: 500;\n  font-size: 10px;\n  text-transform: uppercase;\n  letter-spacing: 0.5px;\n  border-bottom: 1px solid #2a2a3e;\n  position: sticky;\n  top: 0;\n  background: #1a1a2e;\n}\n\ntd {\n  padding: 3px 8px;\n  border-bottom: 1px solid rgba(255,255,255,0.03);\n  white-space: nowrap;\n  overflow: hidden;\n  text-overflow: ellipsis;\n  max-width: 150px;\n}\n\ntr:hover td { background: rgba(255,255,255,0.02); }\n\n/* Value displays */\n.val-string { color: #a8e6cf; }\n.val-number { color: #ffd3a5; }\n.val-boolean { color: #ff8b94; }\n.val-object { color: #b8b5ff; }\n.val-null { color: #666; font-style: italic; }\n\n/* Status badges */\n.status-ok { color: #66bb6a; }\n.status-err { color: #ff6b6b; }\n.status-pending { color: #ffa726; }\n\n/* Route pattern */\n.route-pattern { color: #b8b5ff; }\n.route-param { color: #ffd3a5; }\n\n/* Duration */\n.duration { color: #888; font-size: 11px; }\n.duration.fast { color: #66bb6a; }\n.duration.slow { color: #ffa726; }\n.duration.very-slow { color: #ff6b6b; }\n\n/* Empty state */\n.t4-empty {\n  text-align: center;\n  color: #555;\n  padding: 32px 16px;\n  font-size: 12px;\n}\n\n/* Collapsed mini-badge */\n.t4-mini {\n  position: fixed;\n  bottom: 12px;\n  right: 12px;\n  background: #1a1a2e;\n  border: 1px solid #333;\n  border-radius: 8px;\n  padding: 6px 12px;\n  cursor: pointer;\n  font-family: inherit;\n  font-size: 11px;\n  color: #00d4ff;\n  box-shadow: -2px -2px 10px rgba(0,0,0,0.3);\n  z-index: 999999;\n  display: flex;\n  align-items: center;\n  gap: 6px;\n}\n.t4-mini:hover { background: #16213e; }\n\n.t4-mini-dot {\n  width: 6px;\n  height: 6px;\n  border-radius: 50%;\n  background: #66bb6a;\n}\n";
+//# sourceMappingURL=styles.d.ts.map

package/dist/debug/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/debug/styles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,WAAW,+9HA8MvB,CAAC"}

package/dist/debug/trackers.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Debug Trackers — Data collection for signals, components, routes, and API.
+ */
+import type { Signal } from '../core/signal';
+import type { Tina4Element } from '../core/component';
+import type { ChangeEvent } from '../router/router';
+export interface TrackedSignal {
+    ref: WeakRef<Signal<unknown>>;
+    label?: string;
+    createdAt: number;
+    updateCount: number;
+    subs: WeakRef<Set<() => void>>;
+}
+export declare const signalTracker: {
+    add(s: Signal<unknown>, label?: string): void;
+    onUpdate(s: Signal<unknown>): void;
+    getAll(): {
+        label?: string;
+        value: unknown;
+        subscriberCount: number;
+        updateCount: number;
+        alive: boolean;
+    }[];
+    readonly count: number;
+};
+export interface TrackedComponent {
+    ref: WeakRef<Tina4Element>;
+    tagName: string;
+    mountedAt: number;
+}
+export declare const componentTracker: {
+    onMount(el: Tina4Element): void;
+    onUnmount(el: Tina4Element): void;
+    getAll(): {
+        tagName: string;
+        props: Record<string, unknown>;
+        alive: boolean;
+    }[];
+    readonly count: number;
+};
+export interface RouteEntry {
+    path: string;
+    pattern: string;
+    params: Record<string, string>;
+    durationMs: number;
+    timestamp: number;
+}
+declare let _getRoutesFn: (() => ReadonlyArray<{
+    pattern: string;
+    hasGuard: boolean;
+}>) | null;
+export declare const routeTracker: {
+    /** Set the function that reads registered routes (avoids direct import from router). */
+    setGetRoutes(fn: typeof _getRoutesFn): void;
+    getRegisteredRoutes(): ReadonlyArray<{
+        pattern: string;
+        hasGuard: boolean;
+    }>;
+    onNavigate(event: ChangeEvent): void;
+    getHistory(): readonly RouteEntry[];
+    readonly count: number;
+};
+export interface ApiEntry {
+    id: number;
+    method: string;
+    url: string;
+    status?: number;
+    durationMs?: number;
+    hasAuth: boolean;
+    timestamp: number;
+    pending: boolean;
+    error?: string;
+}
+export declare const apiTracker: {
+    onRequest(config: RequestInit & {
+        headers: Record<string, string>;
+        _url?: string;
+        _requestId?: number;
+    }): void;
+    onResponse(response: {
+        status: number;
+        ok: boolean;
+        _requestId?: number;
+    }): void;
+    getLog(): readonly ApiEntry[];
+    readonly count: number;
+};
+export {};
+//# sourceMappingURL=trackers.d.ts.map

package/dist/debug/trackers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackers.d.ts","sourceRoot":"","sources":["../../src/debug/trackers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;CAChC;AAID,eAAO,MAAM,aAAa;WACjB,MAAM,CAAC,OAAO,CAAC,UAAU,MAAM;gBAW1B,MAAM,CAAC,OAAO,CAAC;cASjB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE;;CAsB7G,CAAC;AAIF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,eAAO,MAAM,gBAAgB;gBACf,YAAY;kBAQV,YAAY;cAKhB;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE;;CAuBhF,CAAC;AAIF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,QAAA,IAAI,YAAY,EAAE,CAAC,MAAM,aAAa,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,GAAG,IAAW,CAAC;AAE9F,eAAO,MAAM,YAAY;IACvB,wFAAwF;qBACvE,OAAO,YAAY;2BAEb,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;sBAG1D,WAAW;kBAWf,SAAS,UAAU,EAAE;;CAKpC,CAAC;AAIF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,eAAO,MAAM,UAAU;sBACH,WAAW,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;yBAezF;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;cAatE,SAAS,QAAQ,EAAE;;CAK9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * tina4js — Sub-3KB core, reactive framework.
+ *
+ * Signals + tagged template rendering + web components + routing + API + PWA.
+ */
+export { signal, computed, effect, batch, isSignal } from './core/signal';
+export type { Signal, ReadonlySignal } from './core/signal';
+export { html } from './core/html';
+export { Tina4Element } from './core/component';
+export type { PropType } from './core/component';
+export { route, navigate, router } from './router/router';
+export type { RouteParams, RouteHandler, RouteGuard, RouteConfig } from './router/router';
+export { api } from './api/fetch';
+export type { ApiConfig, ApiResponse, RequestOptions } from './api/fetch';
+export { pwa } from './pwa/pwa';
+export type { PWAConfig } from './pwa/pwa';
+export { ws } from './ws/ws';
+export type { SocketStatus, SocketOptions, ManagedSocket } from './ws/ws';
+export { sse } from './sse/sse';
+export type { StreamStatus, StreamOptions, ManagedStream } from './sse/sse';
+//# 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;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1E,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG1F,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG1E,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG1E,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/pwa/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * tina4js/pwa — Service worker and manifest generation.
+ */
+export { pwa } from './pwa';
+export type { PWAConfig } from './pwa';
+//# sourceMappingURL=index.d.ts.map

package/dist/pwa/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pwa/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC"}

package/dist/pwa/pwa.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Tina4 PWA — Service worker registration and manifest generation.
+ *
+ * Optional module — tree-shaken away if not imported.
+ */
+export interface PWAConfig {
+    name: string;
+    shortName?: string;
+    themeColor?: string;
+    backgroundColor?: string;
+    display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';
+    icon?: string;
+    cacheStrategy?: 'cache-first' | 'network-first' | 'stale-while-revalidate';
+    precache?: string[];
+    offlineRoute?: string;
+}
+export declare const pwa: {
+    register(config: PWAConfig): void;
+    /** Generate SW code as a string (for build tools that write sw.js to disk). */
+    generateServiceWorker(config: PWAConfig): string;
+    /** Generate manifest object (for build tools that write manifest.json to disk). */
+    generateManifest(config: PWAConfig): object;
+};
+//# sourceMappingURL=pwa.d.ts.map

package/dist/pwa/pwa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwa.d.ts","sourceRoot":"","sources":["../../src/pwa/pwa.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,aAAa,GAAG,eAAe,GAAG,wBAAwB,CAAC;IAC3E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAkFD,eAAO,MAAM,GAAG;qBACG,SAAS,GAAG,IAAI;IA6BjC,+EAA+E;kCACjD,SAAS,GAAG,MAAM;IAIhD,mFAAmF;6BAC1D,SAAS,GAAG,MAAM;CAG5C,CAAC"}

package/dist/router/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * tina4js/router — Client-side routing.
+ */
+export { route, navigate, router, _resetRouter } from './router';
+export type { RouteParams, RouteHandler, RouteGuard, RouteConfig } from './router';
+//# sourceMappingURL=index.d.ts.map

package/dist/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/router/router.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Tina4 Router — Client-side routing with history and hash modes.
+ *
+ * route(path, handler)   — register a route
+ * navigate(path)         — programmatic navigation
+ * router.start(config)   — start the router
+ */
+export type RouteParams = Record<string, string>;
+export type RouteHandler = (params: RouteParams) => unknown;
+export type RouteGuard = () => boolean | string;
+export interface RouteConfig {
+    guard?: RouteGuard;
+    handler: RouteHandler;
+}
+interface RouterConfig {
+    target: string;
+    mode?: 'history' | 'hash';
+}
+export type ChangeEvent = {
+    path: string;
+    params: RouteParams;
+    pattern: string;
+    durationMs: number;
+};
+type ChangeListener = (event: ChangeEvent) => void;
+/**
+ * Register a route. Pattern is ALWAYS the first argument.
+ *
+ * Patterns support `{param}` segments — extracted and passed to the handler.
+ * Use `'*'` to match any path (catch-all / 404 route).
+ *
+ * @param pattern        - URL pattern, e.g. `'/'`, `'/users/{id}'`, `'*'`
+ * @param handlerOrConfig - Handler function or `{ handler, guard }` config.
+ *
+ * @example
+ * route('/', () => html`<h1>Home</h1>`);
+ * route('/users/{id}', ({ id }) => html`<p>User: ${id}</p>`);
+ * route('*', () => html`<h1>404</h1>`);
+ *
+ * // With a guard:
+ * route('/admin', {
+ *   guard: () => isLoggedIn.value || '/login',
+ *   handler: () => html`<admin-panel></admin-panel>`,
+ * });
+ */
+export declare function route(pattern: string, handlerOrConfig: RouteHandler | RouteConfig): void;
+/**
+ * Programmatically navigate to a path.
+ *
+ * @param path - The path to navigate to.
+ * @param opts - `{ replace: true }` uses `history.replaceState` instead of `pushState`.
+ *
+ * @example
+ * navigate('/dashboard');
+ * navigate('/login', { replace: true }); // no back-button entry
+ */
+export declare function navigate(path: string, opts?: {
+    replace?: boolean;
+}): void;
+export declare const router: {
+    start(config: RouterConfig): void;
+    on(event: "change", fn: ChangeListener): () => void;
+};
+/** @internal Read-only access to registered routes (for debug overlay). */
+export declare function _getRoutes(): ReadonlyArray<{
+    pattern: string;
+    hasGuard: boolean;
+}>;
+/** @internal Reset router state (for tests only). */
+export declare function _resetRouter(): void;
+export {};
+//# sourceMappingURL=router.d.ts.map

package/dist/router/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,GAAG,MAAM,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;CACvB;AAUD,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AACrG,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAiBnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,YAAY,GAAG,WAAW,GAAG,IAAI,CA2BxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAkBzE;AAiFD,eAAO,MAAM,MAAM;kBACH,YAAY,GAAG,IAAI;cAsCvB,QAAQ,MAAM,cAAc,GAAG,MAAM,IAAI;CAOpD,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,UAAU,IAAI,aAAa,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAElF;AAID,qDAAqD;AACrD,wBAAgB,YAAY,IAAI,IAAI,CASnC"}

package/dist/sse/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * tina4js/sse — Signal-driven SSE / NDJSON streaming client.
+ */
+export { sse } from './sse';
+export type { StreamStatus, StreamOptions, ManagedStream } from './sse';
+//# sourceMappingURL=index.d.ts.map

package/dist/sse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sse/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC"}

package/dist/sse/sse.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Tina4 SSE — Signal-driven Server-Sent Events / NDJSON streaming client.
+ *
+ * sse.connect(url, options?)   — create a managed event stream
+ * stream.status                — reactive signal: 'connecting' | 'open' | 'closed' | 'reconnecting'
+ * stream.connected             — reactive signal: boolean
+ * stream.lastMessage           — reactive signal: last parsed message
+ * stream.lastEvent             — reactive signal: last SSE event name (or null)
+ * stream.on(event, handler)    — listen for messages/open/close/error
+ * stream.pipe(signal, reducer) — pipe messages directly into a signal
+ * stream.close()               — disconnect (stops reconnect)
+ */
+import type { Signal } from '../core/signal';
+export type StreamStatus = 'connecting' | 'open' | 'closed' | 'reconnecting';
+export interface StreamOptions {
+    /** Transport: 'eventsource' (default) or 'fetch' for NDJSON/POST. */
+    mode?: 'eventsource' | 'fetch';
+    /** HTTP method for fetch mode (default: 'GET'). */
+    method?: string;
+    /** Custom headers for fetch mode. */
+    headers?: Record<string, string>;
+    /** Request body for fetch mode (objects are JSON.stringify'd). */
+    body?: unknown;
+    /** Enable auto-reconnect (default: true). */
+    reconnect?: boolean;
+    /** Initial reconnect delay in ms (default: 1000). */
+    reconnectDelay?: number;
+    /** Max reconnect delay in ms (default: 30000). */
+    reconnectMaxDelay?: number;
+    /** Max reconnect attempts (default: Infinity). */
+    reconnectAttempts?: number;
+    /** Named SSE events to listen for (eventsource mode only). */
+    events?: string[];
+    /** Parse each message as JSON (default: true). */
+    json?: boolean;
+}
+export type MessageHandler = (data: unknown, event?: string) => void;
+export type OpenHandler = () => void;
+export type CloseHandler = () => void;
+export type ErrorHandler = (error: Event | Error) => void;
+type EventMap = {
+    message: MessageHandler;
+    open: OpenHandler;
+    close: CloseHandler;
+    error: ErrorHandler;
+};
+export interface ManagedStream {
+    /** Reactive connection status. */
+    readonly status: Signal<StreamStatus>;
+    /** Reactive boolean — true when status is 'open'. */
+    readonly connected: Signal<boolean>;
+    /** Reactive — last received message (parsed JSON or raw string). */
+    readonly lastMessage: Signal<unknown>;
+    /** Reactive — last SSE event name, or null for unnamed/NDJSON. */
+    readonly lastEvent: Signal<string | null>;
+    /** Reactive — last error, or null. */
+    readonly error: Signal<Event | Error | null>;
+    /** Number of reconnect attempts so far. */
+    readonly reconnectCount: Signal<number>;
+    /** Listen for events. Returns unsubscribe function. */
+    on<K extends keyof EventMap>(event: K, handler: EventMap[K]): () => void;
+    /** Pipe messages into a signal via a reducer. */
+    pipe<T>(target: Signal<T>, reducer: (message: unknown, current: T) => T): () => void;
+    /** Close the connection and stop reconnecting. */
+    close(): void;
+}
+declare function createStream(url: string, options?: StreamOptions): ManagedStream;
+export declare const sse: {
+    connect: typeof createStream;
+};
+export {};
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/sse/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IAC/B,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kEAAkE;IAClE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AACrE,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AACrC,MAAM,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC;AACtC,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,KAAK,IAAI,CAAC;AAE1D,KAAK,QAAQ,GAAG;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACtC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC;IAC7C,2CAA2C;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAExC,uDAAuD;IACvD,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAEzE,iDAAiD;IACjD,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;IAErF,kDAAkD;IAClD,KAAK,IAAI,IAAI,CAAC;CACf;AAmBD,iBAAS,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,aAAa,CAqO7E;AAID,eAAO,MAAM,GAAG;;CAEf,CAAC"}

package/dist/sse.cjs.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("./signal.cjs.js"),I={mode:"eventsource",method:"GET",headers:{},body:void 0,reconnect:!0,reconnectDelay:1e3,reconnectMaxDelay:3e4,reconnectAttempts:1/0,events:[],json:!0};function N(E,k={}){const t={...I,...k},c=u.signal("connecting"),f=u.signal(!1),D=u.signal(null),T=u.signal(null),h=u.signal(null),b=u.signal(0),s={message:[],open:[],close:[],error:[]};let o=null,r=null,x=!1,v=t.reconnectDelay,d=null,a=0;function g(e){if(!t.json||typeof e!="string")return e;try{return JSON.parse(e)}catch{return e}}function m(e,n){D.value=e,T.value=n;for(const l of s.message)l(e,n??void 0)}function A(){c.value="open",f.value=!0,h.value=null,a=0,v=t.reconnectDelay,b.value=0;for(const e of s.open)e()}function y(){c.value="closed",f.value=!1;for(const e of s.close)e();!x&&t.reconnect&&a<t.reconnectAttempts&&L()}function S(e){h.value=e;for(const n of s.error)n(e)}function F(){c.value=a>0?"reconnecting":"connecting";try{o=new EventSource(E)}catch{c.value="closed",f.value=!1;return}o.onopen=()=>A(),o.onmessage=e=>{m(g(e.data),null)};for(const e of t.events)o.addEventListener(e,n=>{m(g(n.data),e)});o.onerror=e=>{S(e),o&&o.readyState===2&&(o=null,y())}}function J(){c.value=a>0?"reconnecting":"connecting",r=new AbortController;const e={method:t.method,headers:t.headers,signal:r.signal};t.body!==void 0&&(e.body=typeof t.body=="string"?t.body:JSON.stringify(t.body)),fetch(E,e).then(async n=>{if(!n.ok){S(new Error(`[tina4] SSE fetch ${n.status}`)),y();return}A();const l=n.body.getReader(),i=new TextDecoder;let p="";for(;;){const{done:R,value:q}=await l.read();if(R)break;p+=i.decode(q,{stream:!0});const j=p.split(`
+`);p=j.pop();for(const G of j){const w=G.trim();w&&m(g(w),null)}}const C=p.trim();C&&m(g(C),null),r=null,y()}).catch(n=>{n.name!=="AbortError"&&(r=null,S(n),y())})}function L(){a++,b.value=a,c.value="reconnecting",d=setTimeout(()=>{d=null,M()},v),v=Math.min(v*2,t.reconnectMaxDelay)}function M(){t.mode==="fetch"?J():F()}const O={status:c,connected:f,lastMessage:D,lastEvent:T,error:h,reconnectCount:b,on(e,n){return s[e].push(n),()=>{const l=s[e],i=l.indexOf(n);i>=0&&l.splice(i,1)}},pipe(e,n){const l=i=>{e.value=n(i,e.value)};return O.on("message",l)},close(){x=!0,d&&(clearTimeout(d),d=null),o&&(o.close(),o=null),r&&(r.abort(),r=null),c.value="closed",f.value=!1}};return M(),O}const P={connect:N};exports.sse=P;

package/dist/sse.es.js

@@ -0,0 +1,137 @@
+import { s as i } from "./signal.es.js";
+const N = {
+  mode: "eventsource",
+  method: "GET",
+  headers: {},
+  body: void 0,
+  reconnect: !0,
+  reconnectDelay: 1e3,
+  reconnectMaxDelay: 3e4,
+  reconnectAttempts: 1 / 0,
+  events: [],
+  json: !0
+};
+function U(D, k = {}) {
+  const t = { ...N, ...k }, c = i("connecting"), f = i(!1), S = i(null), x = i(null), h = i(null), b = i(0), s = {
+    message: [],
+    open: [],
+    close: [],
+    error: []
+  };
+  let o = null, l = null, T = !1, v = t.reconnectDelay, d = null, a = 0;
+  function m(e) {
+    if (!t.json || typeof e != "string") return e;
+    try {
+      return JSON.parse(e);
+    } catch {
+      return e;
+    }
+  }
+  function p(e, n) {
+    S.value = e, x.value = n;
+    for (const r of s.message) r(e, n ?? void 0);
+  }
+  function A() {
+    c.value = "open", f.value = !0, h.value = null, a = 0, v = t.reconnectDelay, b.value = 0;
+    for (const e of s.open) e();
+  }
+  function y() {
+    c.value = "closed", f.value = !1;
+    for (const e of s.close) e();
+    !T && t.reconnect && a < t.reconnectAttempts && L();
+  }
+  function E(e) {
+    h.value = e;
+    for (const n of s.error) n(e);
+  }
+  function F() {
+    c.value = a > 0 ? "reconnecting" : "connecting";
+    try {
+      o = new EventSource(D);
+    } catch {
+      c.value = "closed", f.value = !1;
+      return;
+    }
+    o.onopen = () => A(), o.onmessage = (e) => {
+      p(m(e.data), null);
+    };
+    for (const e of t.events)
+      o.addEventListener(e, (n) => {
+        p(m(n.data), e);
+      });
+    o.onerror = (e) => {
+      E(e), o && o.readyState === 2 && (o = null, y());
+    };
+  }
+  function J() {
+    c.value = a > 0 ? "reconnecting" : "connecting", l = new AbortController();
+    const e = {
+      method: t.method,
+      headers: t.headers,
+      signal: l.signal
+    };
+    t.body !== void 0 && (e.body = typeof t.body == "string" ? t.body : JSON.stringify(t.body)), fetch(D, e).then(async (n) => {
+      if (!n.ok) {
+        E(new Error(`[tina4] SSE fetch ${n.status}`)), y();
+        return;
+      }
+      A();
+      const r = n.body.getReader(), u = new TextDecoder();
+      let g = "";
+      for (; ; ) {
+        const { done: R, value: G } = await r.read();
+        if (R) break;
+        g += u.decode(G, { stream: !0 });
+        const w = g.split(`
+`);
+        g = w.pop();
+        for (const I of w) {
+          const j = I.trim();
+          j && p(m(j), null);
+        }
+      }
+      const O = g.trim();
+      O && p(m(O), null), l = null, y();
+    }).catch((n) => {
+      n.name !== "AbortError" && (l = null, E(n), y());
+    });
+  }
+  function L() {
+    a++, b.value = a, c.value = "reconnecting", d = setTimeout(() => {
+      d = null, C();
+    }, v), v = Math.min(v * 2, t.reconnectMaxDelay);
+  }
+  function C() {
+    t.mode === "fetch" ? J() : F();
+  }
+  const M = {
+    status: c,
+    connected: f,
+    lastMessage: S,
+    lastEvent: x,
+    error: h,
+    reconnectCount: b,
+    on(e, n) {
+      return s[e].push(n), () => {
+        const r = s[e], u = r.indexOf(n);
+        u >= 0 && r.splice(u, 1);
+      };
+    },
+    pipe(e, n) {
+      const r = (u) => {
+        e.value = n(u, e.value);
+      };
+      return M.on("message", r);
+    },
+    close() {
+      T = !0, d && (clearTimeout(d), d = null), o && (o.close(), o = null), l && (l.abort(), l = null), c.value = "closed", f.value = !1;
+    }
+  };
+  return C(), M;
+}
+const q = {
+  connect: U
+};
+export {
+  q as sse
+};

package/dist/tina4.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./signal.cjs.js"),r=require("./core.cjs.js"),i=require("./component.cjs.js"),t=require("./index.cjs.js"),n=require("./api.cjs.js"),a=require("./pwa.cjs.js"),o=require("./ws.cjs.js");exports.batch=e.batch;exports.computed=e.computed;exports.effect=e.effect;exports.isSignal=e.isSignal;exports.signal=e.signal;exports.html=r.html;exports.Tina4Element=i.Tina4Element;exports.navigate=t.navigate;exports.route=t.route;exports.router=t.router;exports.api=n.api;exports.pwa=a.pwa;exports.ws=o.ws;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./signal.cjs.js"),r=require("./core.cjs.js"),i=require("./component.cjs.js"),t=require("./index.cjs.js"),s=require("./api.cjs.js"),n=require("./pwa.cjs.js"),o=require("./ws.cjs.js"),a=require("./sse.cjs.js");exports.batch=e.batch;exports.computed=e.computed;exports.effect=e.effect;exports.isSignal=e.isSignal;exports.signal=e.signal;exports.html=r.html;exports.Tina4Element=i.Tina4Element;exports.navigate=t.navigate;exports.route=t.route;exports.router=t.router;exports.api=s.api;exports.pwa=n.pwa;exports.ws=o.ws;exports.sse=a.sse;

package/dist/tina4.es.js

@@ -1,14 +1,15 @@
-import { b as o, c as e, e as t, i as s, s as m } from "./signal.es.js";
+import { b as a, c as e, e as t, i as s, s as m } from "./signal.es.js";
 import { html as f } from "./core.es.js";
-import { T as x } from "./component.es.js";
+import { T as i } from "./component.es.js";
 import { n as c, r as l, a as g } from "./index.es.js";
 import { api as b } from "./api.es.js";
 import { pwa as w } from "./pwa.es.js";
 import { ws as d } from "./ws.es.js";
+import { sse as E } from "./sse.es.js";
 export {
-  x as Tina4Element,
+  i as Tina4Element,
   b as api,
-  o as batch,
+  a as batch,
   e as computed,
   t as effect,
   f as html,
@@ -18,5 +19,6 @@ export {
   l as route,
   g as router,
   m as signal,
+  E as sse,
   d as ws
 };

package/dist/ws/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * tina4js/ws — Signal-driven WebSocket client with auto-reconnect.
+ */
+export { ws } from './ws';
+export type { SocketStatus, SocketOptions, ManagedSocket } from './ws';
+//# sourceMappingURL=index.d.ts.map

package/dist/ws/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ws/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1B,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC"}

package/dist/ws/ws.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Tina4 WebSocket — Signal-driven WebSocket client with auto-reconnect.
+ *
+ * ws.connect(url, options?)  — create a managed WebSocket connection
+ * socket.status              — reactive signal: 'connecting' | 'open' | 'closed' | 'reconnecting'
+ * socket.connected            — reactive signal: boolean
+ * socket.lastMessage          — reactive signal: last parsed message
+ * socket.send(data)           — send data (auto-stringify objects)
+ * socket.on(event, handler)   — listen for messages/open/close/error
+ * socket.pipe(signal, reducer) — pipe messages directly into a signal
+ * socket.close()              — disconnect (stops reconnect)
+ */
+import type { Signal } from '../core/signal';
+export type SocketStatus = 'connecting' | 'open' | 'closed' | 'reconnecting';
+export interface SocketOptions {
+    /** Enable auto-reconnect on disconnect (default: true). */
+    reconnect?: boolean;
+    /** Initial reconnect delay in ms (default: 1000). */
+    reconnectDelay?: number;
+    /** Max reconnect delay in ms, for exponential backoff (default: 30000). */
+    reconnectMaxDelay?: number;
+    /** Max reconnect attempts before giving up (default: Infinity). */
+    reconnectAttempts?: number;
+    /** WebSocket sub-protocols. */
+    protocols?: string | string[];
+}
+export type MessageHandler = (data: unknown) => void;
+export type OpenHandler = () => void;
+export type CloseHandler = (code: number, reason: string) => void;
+export type ErrorHandler = (error: Event) => void;
+type EventMap = {
+    message: MessageHandler;
+    open: OpenHandler;
+    close: CloseHandler;
+    error: ErrorHandler;
+};
+export interface ManagedSocket {
+    /** Reactive connection status. */
+    readonly status: Signal<SocketStatus>;
+    /** Reactive boolean — true when status is 'open'. */
+    readonly connected: Signal<boolean>;
+    /** Reactive — last received message (parsed JSON or raw string). */
+    readonly lastMessage: Signal<unknown>;
+    /** Reactive — last error event, or null. */
+    readonly error: Signal<Event | null>;
+    /** Number of reconnect attempts so far. */
+    readonly reconnectCount: Signal<number>;
+    /** Send data. Objects are JSON.stringify'd automatically. */
+    send(data: unknown): void;
+    /** Listen for events. Returns unsubscribe function. */
+    on<K extends keyof EventMap>(event: K, handler: EventMap[K]): () => void;
+    /** Pipe messages into a signal via a reducer. */
+    pipe<T>(target: Signal<T>, reducer: (message: unknown, current: T) => T): () => void;
+    /** Close the connection and stop reconnecting. */
+    close(code?: number, reason?: string): void;
+}
+declare function createSocket(url: string, options?: SocketOptions): ManagedSocket;
+export declare const ws: {
+    connect: typeof createSocket;
+};
+export {};
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../../src/ws/ws.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AACrD,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AACrC,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAElD,KAAK,QAAQ,GAAG;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACtC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAExC,6DAA6D;IAC7D,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAE1B,uDAAuD;IACvD,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAEzE,iDAAiD;IACjD,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;IAErF,kDAAkD;IAClD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAcD,iBAAS,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,aAAa,CA0I7E;AAID,eAAO,MAAM,EAAE;;CAEd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tina4js",
-  "version": "1.0.15",
+  "version": "1.1.0",
   "description": "1.5KB core gzipped, reactive framework — signals, web components, routing, PWA",
   "type": "module",
   "main": "dist/tina4.cjs.js",
@@ -35,6 +35,10 @@
     "./ws": {
       "import": "./dist/ws.es.js",
       "types": "./dist/ws/index.d.ts"
+    },
+    "./sse": {
+      "import": "./dist/sse.es.js",
+      "types": "./dist/sse/index.d.ts"
     }
   },
   "sideEffects": false,