tina4js 1.0.14 → 1.1.0

package/bin/tina4.js

@@ -201,7 +201,7 @@ route('/', homePage);
 route('/about', () => html\`
   <div class="page">
     <h1>About</h1>
-    <p>Built with <a href="https://github.com/tina4stack/tina4-js">tina4-js</a> — a sub-3KB reactive framework.</p>
+    <p>Built with <a href="https://github.com/tina4stack/tina4-js">tina4-js</a> — a sub-3KB core, reactive framework.</p>
     <a href="/">Back home</a>
   </div>
 \`);
@@ -443,7 +443,7 @@ async def spa_catchall(path, request, response):
 
 function printHelp() {
   console.log(`
-${c.bold('tina4js')} — Sub-3KB reactive framework
+${c.bold('tina4js')} — Sub-3KB core, reactive framework
 
 ${c.bold('Usage:')}
   tina4js create <name>               Create a new project

package/dist/api/fetch.d.ts

@@ -84,6 +84,24 @@ export declare const api: {
     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.
      *

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

@@ -1 +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;;;;;;;;;;;;;OAaG;oBACa,SAAS,GAAG,UAAU,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,IAAI;IAQ3F,yCAAyC;cAC/B,IAAI;CAQf,CAAC"}
+{"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.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s={baseUrl:"",auth:!1,tokenKey:"tina4_token",headers:{}},d=[],h=[];let j=0;function T(){try{return localStorage.getItem(s.tokenKey)}catch{return null}}function I(e){try{localStorage.setItem(s.tokenKey,e)}catch{}}async function i(e,t,n,c){let o={method:e,headers:{"Content-Type":"application/json",...s.headers}};if(s.auth){const r=T();r&&(o.headers.Authorization=`Bearer ${r}`)}if(n!==void 0&&e!=="GET"){let r=typeof n=="object"&&n!==null?{...n}:n;if(s.auth&&typeof r=="object"&&r!==null){const a=T();a&&(r.formToken=a)}o.body=JSON.stringify(r)}if(c!=null&&c.headers&&Object.assign(o.headers,c.headers),c!=null&&c.params){const r=Object.entries(c.params).map(([a,y])=>`${encodeURIComponent(a)}=${encodeURIComponent(String(y))}`).join("&");t+=(t.includes("?")?"&":"?")+r}const g=s.baseUrl+t;o._url=g,o._requestId=++j;for(const r of d){const a=r(o);a&&(o=a)}const u=await fetch(g,o),k=u.headers.get("FreshToken");k&&I(k);const p=u.headers.get("Content-Type")??"";let f;p.includes("json")?f=await u.json():f=await u.text();let l={status:u.status,data:f,ok:u.ok,headers:u.headers,_requestId:o._requestId};for(const r of h){const a=r(l);a&&(l=a)}if(!u.ok)throw l;return l.data}const q={configure(e){Object.assign(s,e)},get(e,t){return i("GET",e,void 0,t)},post(e,t,n){return i("POST",e,t,n)},put(e,t,n){return i("PUT",e,t,n)},patch(e,t,n){return i("PATCH",e,t,n)},delete(e,t){return i("DELETE",e,void 0,t)},intercept(e,t){e==="request"?d.push(t):h.push(t)},_reset(){s.baseUrl="",s.auth=!1,s.tokenKey="tina4_token",s.headers={},d.length=0,h.length=0}};exports.api=q;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a={baseUrl:"",auth:!1,tokenKey:"tina4_token",headers:{}},k=[],T=[];let j=0;function y(){try{return localStorage.getItem(a.tokenKey)}catch{return null}}function I(e){try{localStorage.setItem(a.tokenKey,e)}catch{}}async function h(e,s,r,n){let c={method:e,headers:{"Content-Type":"application/json",...a.headers}};if(a.auth){const t=y();t&&(c.headers.Authorization=`Bearer ${t}`)}if(r!==void 0&&e!=="GET"){let t=typeof r=="object"&&r!==null?{...r}:r;if(a.auth&&typeof t=="object"&&t!==null){const u=y();u&&(t.formToken=u)}c.body=JSON.stringify(t)}if(n!=null&&n.headers&&Object.assign(c.headers,n.headers),n!=null&&n.params){const t=Object.entries(n.params).map(([u,m])=>`${encodeURIComponent(u)}=${encodeURIComponent(String(m))}`).join("&");s+=(s.includes("?")?"&":"?")+t}const d=a.baseUrl+s;c._url=d,c._requestId=++j;for(const t of k){const u=t(c);u&&(c=u)}const f=await fetch(d,c),g=f.headers.get("FreshToken");g&&I(g);const i=f.headers.get("Content-Type")??"";let l;i.includes("json")?l=await f.json():l=await f.text();let o={status:f.status,data:l,ok:f.ok,headers:f.headers,_requestId:c._requestId};for(const t of T){const u=t(o);u&&(o=u)}if(!f.ok)throw o;return o.data}const q={configure(e){Object.assign(a,e)},get(e,s){return h("GET",e,void 0,s)},post(e,s,r){return h("POST",e,s,r)},put(e,s,r){return h("PUT",e,s,r)},patch(e,s,r){return h("PATCH",e,s,r)},delete(e,s){return h("DELETE",e,void 0,s)},async upload(e,s,r){let n={method:"POST",headers:{...a.headers},body:s};if(delete n.headers["Content-Type"],delete n.headers["content-type"],a.auth){const o=y();o&&(n.headers.Authorization=`Bearer ${o}`)}if(r!=null&&r.headers&&Object.assign(n.headers,r.headers),r!=null&&r.params){const o=Object.entries(r.params).map(([t,u])=>`${encodeURIComponent(t)}=${encodeURIComponent(String(u))}`).join("&");e+=(e.includes("?")?"&":"?")+o}const c=a.baseUrl+e;n._url=c,n._requestId=++j;for(const o of k){const t=o(n);t&&(n=t)}const d=await fetch(c,n),f=d.headers.get("FreshToken");f&&I(f);const g=d.headers.get("Content-Type")??"";let i;g.includes("json")?i=await d.json():i=await d.text();let l={status:d.status,data:i,ok:d.ok,headers:d.headers,_requestId:n._requestId};for(const o of T){const t=o(l);t&&(l=t)}if(!d.ok)throw l;return l.data},intercept(e,s){e==="request"?k.push(s):T.push(s)},_reset(){a.baseUrl="",a.auth=!1,a.tokenKey="tina4_token",a.headers={},k.length=0,T.length=0}};exports.api=q;

package/dist/api.es.js

@@ -1,74 +1,74 @@
-const s = {
+const a = {
   baseUrl: "",
   auth: !1,
   tokenKey: "tina4_token",
   headers: {}
-}, h = [], d = [];
+}, g = [], T = [];
 let I = 0;
-function T() {
+function y() {
   try {
-    return localStorage.getItem(s.tokenKey);
+    return localStorage.getItem(a.tokenKey);
   } catch {
     return null;
   }
 }
 function j(e) {
   try {
-    localStorage.setItem(s.tokenKey, e);
+    localStorage.setItem(a.tokenKey, e);
   } catch {
   }
 }
-async function l(e, t, r, c) {
-  let o = {
+async function h(e, s, r, n) {
+  let c = {
     method: e,
     headers: {
       "Content-Type": "application/json",
-      ...s.headers
+      ...a.headers
     }
   };
-  if (s.auth) {
-    const n = T();
-    n && (o.headers.Authorization = `Bearer ${n}`);
+  if (a.auth) {
+    const t = y();
+    t && (c.headers.Authorization = `Bearer ${t}`);
   }
   if (r !== void 0 && e !== "GET") {
-    let n = typeof r == "object" && r !== null ? { ...r } : r;
-    if (s.auth && typeof n == "object" && n !== null) {
-      const a = T();
-      a && (n.formToken = a);
+    let t = typeof r == "object" && r !== null ? { ...r } : r;
+    if (a.auth && typeof t == "object" && t !== null) {
+      const u = y();
+      u && (t.formToken = u);
     }
-    o.body = JSON.stringify(n);
+    c.body = JSON.stringify(t);
   }
-  if (c != null && c.headers && Object.assign(o.headers, c.headers), c != null && c.params) {
-    const n = Object.entries(c.params).map(([a, y]) => `${encodeURIComponent(a)}=${encodeURIComponent(String(y))}`).join("&");
-    t += (t.includes("?") ? "&" : "?") + n;
+  if (n != null && n.headers && Object.assign(c.headers, n.headers), n != null && n.params) {
+    const t = Object.entries(n.params).map(([u, q]) => `${encodeURIComponent(u)}=${encodeURIComponent(String(q))}`).join("&");
+    s += (s.includes("?") ? "&" : "?") + t;
   }
-  const g = s.baseUrl + t;
-  o._url = g, o._requestId = ++I;
-  for (const n of h) {
-    const a = n(o);
-    a && (o = a);
+  const d = a.baseUrl + s;
+  c._url = d, c._requestId = ++I;
+  for (const t of g) {
+    const u = t(c);
+    u && (c = u);
   }
-  const u = await fetch(g, o), k = u.headers.get("FreshToken");
+  const f = await fetch(d, c), k = f.headers.get("FreshToken");
   k && j(k);
-  const p = u.headers.get("Content-Type") ?? "";
-  let i;
-  p.includes("json") ? i = await u.json() : i = await u.text();
-  let f = {
-    status: u.status,
-    data: i,
-    ok: u.ok,
-    headers: u.headers,
-    _requestId: o._requestId
+  const i = f.headers.get("Content-Type") ?? "";
+  let l;
+  i.includes("json") ? l = await f.json() : l = await f.text();
+  let o = {
+    status: f.status,
+    data: l,
+    ok: f.ok,
+    headers: f.headers,
+    _requestId: c._requestId
   };
-  for (const n of d) {
-    const a = n(f);
-    a && (f = a);
+  for (const t of T) {
+    const u = t(o);
+    u && (o = u);
   }
-  if (!u.ok)
-    throw f;
-  return f.data;
+  if (!f.ok)
+    throw o;
+  return o.data;
 }
-const q = {
+const m = {
   /**
    * Configure the API client. Call once at app startup.
    *
@@ -81,7 +81,7 @@ const q = {
    * });
    */
   configure(e) {
-    Object.assign(s, e);
+    Object.assign(a, e);
   },
   /**
    * HTTP GET request.
@@ -90,8 +90,8 @@ const q = {
    * @example
    * const data = await api.get('/products', { params: { page: 2, limit: 20 } });
    */
-  get(e, t) {
-    return l("GET", e, void 0, t);
+  get(e, s) {
+    return h("GET", e, void 0, s);
   },
   /**
    * HTTP POST request.
@@ -101,20 +101,80 @@ const q = {
    * @example
    * await api.post('/users', { name: 'Alice', role: 'admin' });
    */
-  post(e, t, r) {
-    return l("POST", e, t, r);
+  post(e, s, r) {
+    return h("POST", e, s, r);
   },
   /** HTTP PUT — full replace. */
-  put(e, t, r) {
-    return l("PUT", e, t, r);
+  put(e, s, r) {
+    return h("PUT", e, s, r);
   },
   /** HTTP PATCH — partial update. */
-  patch(e, t, r) {
-    return l("PATCH", e, t, r);
+  patch(e, s, r) {
+    return h("PATCH", e, s, r);
   },
   /** HTTP DELETE. */
-  delete(e, t) {
-    return l("DELETE", e, void 0, t);
+  delete(e, s) {
+    return h("DELETE", e, void 0, s);
+  },
+  /**
+   * 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);
+   */
+  async upload(e, s, r) {
+    let n = {
+      method: "POST",
+      headers: {
+        ...a.headers
+        // Do NOT set Content-Type — browser sets it with multipart boundary
+      },
+      body: s
+    };
+    if (delete n.headers["Content-Type"], delete n.headers["content-type"], a.auth) {
+      const o = y();
+      o && (n.headers.Authorization = `Bearer ${o}`);
+    }
+    if (r != null && r.headers && Object.assign(n.headers, r.headers), r != null && r.params) {
+      const o = Object.entries(r.params).map(([t, u]) => `${encodeURIComponent(t)}=${encodeURIComponent(String(u))}`).join("&");
+      e += (e.includes("?") ? "&" : "?") + o;
+    }
+    const c = a.baseUrl + e;
+    n._url = c, n._requestId = ++I;
+    for (const o of g) {
+      const t = o(n);
+      t && (n = t);
+    }
+    const d = await fetch(c, n), f = d.headers.get("FreshToken");
+    f && j(f);
+    const k = d.headers.get("Content-Type") ?? "";
+    let i;
+    k.includes("json") ? i = await d.json() : i = await d.text();
+    let l = {
+      status: d.status,
+      data: i,
+      ok: d.ok,
+      headers: d.headers,
+      _requestId: n._requestId
+    };
+    for (const o of T) {
+      const t = o(l);
+      t && (l = t);
+    }
+    if (!d.ok)
+      throw l;
+    return l.data;
   },
   /**
    * Register a request or response interceptor.
@@ -130,14 +190,14 @@ const q = {
    *   if (res.status === 401) navigate('/login');
    * });
    */
-  intercept(e, t) {
-    e === "request" ? h.push(t) : d.push(t);
+  intercept(e, s) {
+    e === "request" ? g.push(s) : T.push(s);
   },
   /** @internal Reset state (for tests). */
   _reset() {
-    s.baseUrl = "", s.auth = !1, s.tokenKey = "tina4_token", s.headers = {}, h.length = 0, d.length = 0;
+    a.baseUrl = "", a.auth = !1, a.tokenKey = "tina4_token", a.headers = {}, g.length = 0, T.length = 0;
   }
 };
 export {
-  q as api
+  m as api
 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * tina4js — Sub-3KB reactive framework.
+ * tina4js — Sub-3KB core, reactive framework.
  *
  * Signals + tagged template rendering + web components + routing + API + PWA.
  */
@@ -16,4 +16,6 @@ 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

@@ -1 +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"}
+{"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/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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tina4js",
-  "version": "1.0.14",
-  "description": "Sub-3KB reactive framework — signals, web components, routing, PWA",
+  "version": "1.1.0",
+  "description": "1.5KB core gzipped, reactive framework — signals, web components, routing, PWA",
   "type": "module",
   "main": "dist/tina4.cjs.js",
   "module": "dist/tina4.es.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,

package/readme.md

@@ -3,10 +3,10 @@
 </p>
 
 <h1 align="center">tina4-js</h1>
-<h3 align="center">This Is Now A 4Framework</h3>
+<h3 align="center">The Intelligent Native Application 4ramework</h3>
 
 <p align="center">
-  Sub-3KB reactive frontend. Signals. Web Components. Zero dependencies.
+  Sub-3KB core, reactive frontend. Signals. Web Components. Zero dependencies.
 </p>
 
 <p align="center">
@@ -311,4 +311,4 @@ npm run dev       # dev server with HMR
 
 MIT
 
-*tina4-js — This is not a framework. [tina4.com](https://tina4.com)*
+*tina4-js — The Intelligent Native Application 4ramework. [tina4.com](https://tina4.com)*