tina4js 1.0.6 → 1.0.7

package/TINA4.md

@@ -15,6 +15,8 @@
 | Navigate | `navigate('/path')` |
 | API | `await api.get('/path')`, `.post`, `.put`, `.patch`, `.delete` |
 | PWA | `pwa.register({ name, themeColor, cacheStrategy })` |
+| WebSocket | `ws.connect('wss://...', { reconnect: true })` — signals for status/messages |
+| Debug | `import 'tina4js/debug'` — toggle with Ctrl+Shift+D |
 
 ## File Conventions
 
@@ -36,6 +38,8 @@
 8. Use `static props = { name: String }` for component attributes
 9. Use `` static styles = `css` `` for scoped styles (Shadow DOM)
 10. Use `static shadow = false` for light DOM components
+11. `route(pattern, handler)` — pattern is ALWAYS the first argument, handler/config is second
+12. `api.configure()` must be called before any API calls if you need auth or a base URL
 
 ## Signal Patterns
 
@@ -43,12 +47,18 @@
 // Create
 const count = signal(0);
 
+// Create with debug label (shows in debug overlay)
+const count = signal(0, 'count');
+
 // Read
 count.value; // 0
 
 // Write (triggers DOM updates)
 count.value = 5;
 
+// Read without subscribing
+count.peek(); // 5
+
 // Derived (auto-updates)
 const doubled = computed(() => count.value * 2);
 
@@ -58,6 +68,9 @@ effect(() => console.log(count.value));
 // Batch multiple updates
 batch(() => { a.value = 1; b.value = 2; }); // one notification
 
+// Check if something is a signal
+isSignal(count); // true
+
 // In templates — signals interpolate directly
 html`<span>${count}</span>`; // auto-updates when count changes
 ```
@@ -98,13 +111,32 @@ customElements.define('my-widget', MyWidget);
 ```ts
 import { route, router, navigate, html } from 'tina4js';
 
+// Simple route
 route('/', () => html`<h1>Home</h1>`);
+
+// Route with params
 route('/user/{id}', ({ id }) => html`<h1>User ${id}</h1>`);
-route('/admin', { guard: () => isLoggedIn() || '/login', handler: () => html`<h1>Admin</h1>` });
+
+// Route with guard (returns false to block, or string to redirect)
+route('/admin', {
+  guard: () => isLoggedIn() || '/login',
+  handler: () => html`<h1>Admin</h1>`
+});
+
+// Catch-all (must be last)
 route('*', () => html`<h1>404</h1>`);
 
+// Start router — call AFTER all routes are registered
 router.start({ target: '#root', mode: 'hash' }); // or mode: 'history'
+
+// Programmatic navigation
 navigate('/user/42');
+navigate('/login', { replace: true }); // replace history entry
+
+// Listen for route changes
+router.on('change', (event) => {
+  // event: { path, params, pattern, durationMs }
+});
 ```
 
 ## API Pattern (tina4-php/python compatible)
@@ -112,17 +144,69 @@ navigate('/user/42');
 ```ts
 import { api } from 'tina4js';
 
-api.configure({ baseUrl: '/api', auth: true });
+// Configure — call before making requests
+api.configure({
+  baseUrl: '/api',
+  auth: true,                        // enables Bearer token + formToken
+  tokenKey: 'tina4_token',           // localStorage key (default)
+  headers: { 'X-API-Key': 'abc' },  // default headers on every request
+});
+
+// GET with query params
+const users = await api.get('/users', { params: { page: 1, limit: 20 } });
+// => GET /api/users?page=1&limit=20
+
+// GET with custom headers
+const data = await api.get('/data', { headers: { 'Accept-Language': 'en' } });
 
-const users = await api.get('/users');
-const user = await api.get('/users/{id}', { id: 42 });
+// POST with body
 await api.post('/users', { name: 'Andre' });
+
+// POST with body + custom headers
+await api.post('/upload', formData, { headers: { 'Content-Type': 'multipart/form-data' } });
+
+// PUT, PATCH, DELETE
 await api.put('/users/42', { name: 'Updated' });
+await api.patch('/users/42', { active: false });
 await api.delete('/users/42');
 
-// Interceptors
-api.intercept('request', (config) => { config.headers['X-Custom'] = 'val'; return config; });
-api.intercept('response', (res) => { if (res.status === 401) navigate('/login'); return res; });
+// DELETE with query params
+await api.delete('/users/42', { params: { permanent: true } });
+
+// Error handling — non-2xx throws an ApiResponse object
+try {
+  await api.get('/protected');
+} catch (err) {
+  // err: { status: 401, data: {...}, ok: false, headers: Headers }
+}
+
+// Interceptors — modify every request/response
+api.intercept('request', (config) => {
+  config.headers['X-Custom'] = 'val';
+  return config;
+});
+
+api.intercept('response', (res) => {
+  if (res.status === 401) navigate('/login');
+  return res;
+});
+```
+
+### RequestOptions
+
+All API methods accept an optional `RequestOptions` object:
+
+```ts
+interface RequestOptions {
+  headers?: Record<string, string>;           // per-request headers
+  params?: Record<string, string | number | boolean>; // query string params
+}
+
+api.get(path, options?)
+api.post(path, body?, options?)
+api.put(path, body?, options?)
+api.patch(path, body?, options?)
+api.delete(path, options?)
 ```
 
 ## Conditional & List Rendering
@@ -156,6 +240,58 @@ tina4 build --target python
 - `formToken` injected into POST/PUT/PATCH/DELETE body
 - Token auto-rotated via `FreshToken` response header
 
+## WebSocket (Signal-Driven)
+
+```ts
+import { ws } from 'tina4js/ws';
+import { signal } from 'tina4js';
+
+// Connect with auto-reconnect
+const socket = ws.connect('wss://api.example.com/live', {
+  reconnect: true,           // auto-reconnect (default: true)
+  reconnectDelay: 1000,      // initial delay ms (default: 1000)
+  reconnectMaxDelay: 30000,  // max backoff ms (default: 30000)
+  reconnectAttempts: Infinity, // max attempts (default: Infinity)
+});
+
+// Reactive state — all signals
+socket.status.value;      // 'connecting' | 'open' | 'closed' | 'reconnecting'
+socket.connected.value;   // boolean
+socket.lastMessage.value; // last parsed message
+socket.error.value;       // last error or null
+socket.reconnectCount.value; // number of reconnect attempts
+
+// Send — objects auto-stringify
+socket.send({ type: 'chat', text: 'hello' });
+socket.send('raw string');
+
+// Listen for events
+socket.on('message', (data) => { /* parsed JSON or string */ });
+socket.on('open', () => { });
+socket.on('close', (code, reason) => { });
+socket.on('error', (err) => { });
+
+// Pipe messages directly into a signal
+const messages = signal<ChatMessage[]>([]);
+socket.pipe(messages, (msg, current) => [...current, msg as ChatMessage]);
+
+// Disconnect (stops reconnect)
+socket.close();
+```
+
+### Real-time UI with Signals
+
+```ts
+// Chat example — messages auto-render in the template
+const chatLog = signal<{user: string, text: string}[]>([]);
+const socket = ws.connect('wss://chat.example.com');
+socket.pipe(chatLog, (msg, log) => [...log, msg as any]);
+
+route('/chat', () => html`
+  <ul>${() => chatLog.value.map(m => html`<li><b>${m.user}</b>: ${m.text}</li>`)}</ul>
+`);
+```
+
 ## Debug Overlay
 
 ```ts
@@ -167,18 +303,21 @@ if (import.meta.env.DEV) import('tina4js/debug');
 ```
 
 - Toggle with **Ctrl+Shift+D**
-- Shows: live signal values + subscriber counts, mounted components, route navigation history with timing, API request/response log
+- Panels: live signal values + subscriber counts, mounted components, route navigation history with timing, API request/response log
 - Zero cost in production when using the `import.meta.env.DEV` guard (tree-shaken by Vite/Rollup)
+- Signals can have debug labels: `signal(0, 'count')` — shows in the signals panel
 
 ## Framework Size
 
 | Module | Gzipped |
 |--------|---------|
-| Core (signals + html + component) | 2.44 KB |
-| Router | 1.13 KB |
-| API | 0.82 KB |
-| PWA | 1.13 KB |
-| **Total (all modules)** | **5.52 KB** |
+| Core (signals + html + component) | ~1.5 KB |
+| Router | ~0.12 KB |
+| API | ~0.97 KB |
+| WebSocket | ~0.91 KB |
+| PWA | ~1.16 KB |
+| Debug overlay | ~5.1 KB |
+| **Total (core modules)** | **~4.66 KB** |
 
 ## Architecture
 
@@ -186,15 +325,46 @@ if (import.meta.env.DEV) import('tina4js/debug');
 src/
   core/       signal.ts, html.ts, component.ts  — reactive primitives
   router/     router.ts                          — client-side routing
-  api/        fetch.ts                           — HTTP with auth
+  api/        fetch.ts                           — HTTP with auth + headers
+  ws/         ws.ts                              — WebSocket with auto-reconnect
   pwa/        pwa.ts                             — service worker + manifest
+  debug/      overlay, trackers, panels          — dev debug overlay
   index.ts    barrel re-export
 ```
 
-Tree-shakeable: import only what you need.
+### Exports Map
+
+```ts
+import { signal, html, computed, effect, batch, isSignal, Tina4Element } from 'tina4js';
+import { route, router, navigate } from 'tina4js';
+import { api } from 'tina4js';
+import { pwa } from 'tina4js';
+
+// Or import individual modules (tree-shakeable):
+import { signal, html } from 'tina4js/core';
+import { route, router } from 'tina4js/router';
+import { api } from 'tina4js/api';
+import { pwa } from 'tina4js/pwa';
+import { ws } from 'tina4js/ws';
+import 'tina4js/debug';
+```
+
+### TypeScript Types
+
 ```ts
-import { signal, html } from 'tina4js/core';       // 2.44 KB
-import { route, router } from 'tina4js/router';     // 1.13 KB
-import { api } from 'tina4js/api';                   // 0.82 KB
-import { pwa } from 'tina4js/pwa';                   // 1.13 KB
+import type { Signal, ReadonlySignal } from 'tina4js';
+import type { RouteParams, RouteHandler, RouteGuard, RouteConfig } from 'tina4js';
+import type { ApiConfig, ApiResponse, RequestOptions } from 'tina4js';
+import type { SocketStatus, SocketOptions, ManagedSocket } from 'tina4js';
+import type { PWAConfig } from 'tina4js';
+import type { PropType } from 'tina4js';
 ```
+
+## Common Mistakes to Avoid
+
+1. **Reversed route arguments**: `route('/path', handler)` NOT `route(handler, '/path')`
+2. **Forgetting `.value`**: `count.value++` NOT `count++`
+3. **Calling `router.start()` before routes**: Register all routes first, then start
+4. **Not returning from `render()`**: Always `return html\`...\``
+5. **Missing `api.configure()`**: Must configure before making authenticated requests
+6. **Using `api.get('/users/{id}', { id: 42 })`**: Changed to `api.get('/users/42')` — use params for query strings: `api.get('/users', { params: { id: 42 } })`

package/dist/api/fetch.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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>;
+}
+export declare const api: {
+    configure(c: Partial<ApiConfig>): void;
+    get<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    delete<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    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,eAAO,MAAM,GAAG;iBACD,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;QAIlC,CAAC,kBAAkB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;SAI/D,CAAC,kBAAkB,MAAM,SAAS,OAAO,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;QAIjF,CAAC,kBAAkB,MAAM,SAAS,OAAO,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;UAI9E,CAAC,kBAAkB,MAAM,SAAS,OAAO,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;WAI/E,CAAC,kBAAkB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;oBAIvD,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/api.cjs.js

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

package/dist/api.es.js

@@ -1,90 +1,100 @@
-const o = {
+const s = {
   baseUrl: "",
   auth: !1,
-  tokenKey: "tina4_token"
-}, l = [], h = [];
-function g() {
+  tokenKey: "tina4_token",
+  headers: {}
+}, h = [], d = [];
+let I = 0;
+function T() {
   try {
-    return localStorage.getItem(o.tokenKey);
+    return localStorage.getItem(s.tokenKey);
   } catch {
     return null;
   }
 }
-function y(e) {
+function j(e) {
   try {
-    localStorage.setItem(o.tokenKey, e);
+    localStorage.setItem(s.tokenKey, e);
   } catch {
   }
 }
-async function i(e, t, c) {
-  let a = {
+async function l(e, t, r, c) {
+  let o = {
     method: e,
     headers: {
-      "Content-Type": "application/json"
+      "Content-Type": "application/json",
+      ...s.headers
     }
   };
-  if (o.auth) {
-    const n = g();
-    n && (a.headers.Authorization = `Bearer ${n}`);
+  if (s.auth) {
+    const n = T();
+    n && (o.headers.Authorization = `Bearer ${n}`);
   }
-  if (c !== void 0 && e !== "GET") {
-    let n = typeof c == "object" && c !== null ? { ...c } : c;
-    if (o.auth && typeof n == "object" && n !== null) {
-      const s = g();
-      s && (n.formToken = s);
+  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);
     }
-    a.body = JSON.stringify(n);
+    o.body = JSON.stringify(n);
   }
-  for (const n of l) {
-    const s = n(a);
-    s && (a = s);
+  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;
   }
-  const k = o.baseUrl + t, r = await fetch(k, a), p = r.headers.get("FreshToken");
-  p && y(p);
-  const T = r.headers.get("Content-Type") ?? "";
-  let f;
-  T.includes("json") ? f = await r.json() : f = await r.text();
-  let u = {
-    status: r.status,
-    data: f,
-    ok: r.ok,
-    headers: r.headers
-  };
+  const g = s.baseUrl + t;
+  o._url = g, o._requestId = ++I;
   for (const n of h) {
-    const s = n(u);
-    s && (u = s);
+    const a = n(o);
+    a && (o = a);
+  }
+  const u = await fetch(g, o), k = u.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
+  };
+  for (const n of d) {
+    const a = n(f);
+    a && (f = a);
   }
-  if (!r.ok)
-    throw u;
-  return u.data;
+  if (!u.ok)
+    throw f;
+  return f.data;
 }
-const d = {
+const q = {
   configure(e) {
-    Object.assign(o, e);
+    Object.assign(s, e);
   },
   get(e, t) {
-    return t && (e = e.replace(/\{(\w+)\}/g, (c, a) => String(t[a] ?? ""))), i("GET", e);
+    return l("GET", e, void 0, t);
   },
-  post(e, t) {
-    return i("POST", e, t);
+  post(e, t, r) {
+    return l("POST", e, t, r);
   },
-  put(e, t) {
-    return i("PUT", e, t);
+  put(e, t, r) {
+    return l("PUT", e, t, r);
   },
-  patch(e, t) {
-    return i("PATCH", e, t);
+  patch(e, t, r) {
+    return l("PATCH", e, t, r);
   },
-  delete(e) {
-    return i("DELETE", e);
+  delete(e, t) {
+    return l("DELETE", e, void 0, t);
   },
   intercept(e, t) {
-    e === "request" ? l.push(t) : h.push(t);
+    e === "request" ? h.push(t) : d.push(t);
   },
   /** @internal Reset state (for tests). */
   _reset() {
-    o.baseUrl = "", o.auth = !1, o.tokenKey = "tina4_token", l.length = 0, h.length = 0;
+    s.baseUrl = "", s.auth = !1, s.tokenKey = "tina4_token", s.headers = {}, h.length = 0, d.length = 0;
   }
 };
 export {
-  d as api
+  q as api
 };

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,8 @@
+/**
+ * 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.
+ */
+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,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,42 @@
+/**
+ * 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;
+}
+export declare function signal<T>(initial: T, label?: string): Signal<T>;
+export declare function computed<T>(fn: () => T): ReadonlySignal<T>;
+export declare function effect(fn: () => void): () => void;
+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,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAoD/D;AAID,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CA2B1D;AAID,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAgCjD;AAID,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"}