@portel/photon 1.32.5 → 1.33.0

package/dist/tsx-compiler.d.ts

@@ -9,15 +9,75 @@
  * ui/ folder to use React/Preact/Solid if they prefer.
  */
 /**
- * Compile a TSX file into a self-contained HTML document.
+ * Result of compiling a .tsx view.
+ *
+ * The bundled JS is written to a content-hashed sidecar file rather than
+ * inlined, so every serving path (local server, Beam, `photon build`, the
+ * Cloudflare [assets] binding) gets URL-level cache-busting for free: the
+ * hash changes whenever the source or the esbuild toolchain changes, so a
+ * browser never executes a stale bundle. The tiny HTML shell carries no
+ * code and is served with revalidation; the hashed JS is immutable.
+ */
+export interface CompiledTsx {
+    /** sha256 of (bundle + esbuild version), 12 hex chars. Empty on build error. */
+    hash: string;
+    /** Hashed JS filename the shell references, e.g. `app.1a2b3c4d5e6f.js`. */
+    jsFileName: string;
+    /** The HTML shell (references `./<jsFileName>`). On error this is the error page. */
+    html: string;
+    /** The bundled browser JS. Empty on build error. */
+    js: string;
+    /** On-disk cache directory holding `<jsFileName>` and `index.html`. */
+    dir: string;
+    /** Absolute path to the written HTML shell. */
+    htmlPath: string;
+    /** Absolute path to the written hashed JS (empty string on build error). */
+    jsPath: string;
+    /** Absolute paths of every module in the bundle (entry + imports). */
+    inputs: string[];
+}
+/**
+ * Self-contained document with the bundle inlined. Used only by the MCP
+ * resource path (Claude Desktop apps): an MCP-app webview renders the
+ * returned HTML with no HTTP origin, so a `./<hash>.js` sibling reference
+ * would not resolve. Cache-busting is irrelevant there — the client
+ * re-reads the resource on every `resources/read`.
+ */
+export declare function inlineHtml(js: string): string;
+/** Immutable: hash in the URL changes whenever the bundle changes. */
+export declare const TSX_JS_CACHE_CONTROL = "public, max-age=31536000, immutable";
+/** Tiny, code-free shell — always revalidate so a new hash is picked up. */
+export declare const TSX_SHELL_CACHE_CONTROL = "no-cache";
+export interface TsxHttpResponse {
+    status: 200 | 404;
+    /** Response body. */
+    body: string;
+    headers: Record<string, string>;
+}
+/**
+ * Resolve an HTTP request for a compiled `.tsx` view into a response.
+ *
+ * - `restPath` empty / `index.html` → the HTML shell (revalidated, ETag).
+ * - `restPath` === the hashed JS filename → the bundle (immutable).
+ * - anything else → 404 (caller may then try its own sibling resolution).
+ *
+ * Used by every browser-facing serving path (local server, Beam,
+ * streamable-http, and — via precompiled files — the Cloudflare
+ * [assets] binding) so the cache contract is identical everywhere.
+ */
+export declare function tsxHttpResponse(result: CompiledTsx, restPath: string): TsxHttpResponse;
+/**
+ * Compile a TSX file into a hashed JS bundle plus an HTML shell.
  */
-export declare function compileTsx(filePath: string): Promise<string>;
+export declare function compileTsx(filePath: string): Promise<CompiledTsx>;
 /**
- * Compile with mtime-based caching. Re-transpiles only when the file changes.
+ * Compile with dependency-graph-aware caching. Re-transpiles when the
+ * entry file OR any imported module changes (the previous mtime-only
+ * cache silently served a stale bundle after an imported-component edit).
  */
-export declare function compileTsxCached(filePath: string): Promise<string>;
+export declare function compileTsxCached(filePath: string): Promise<CompiledTsx>;
 /**
  * Synchronous variant for the build command (uses esbuild.buildSync).
  */
-export declare function compileTsxSync(filePath: string): string;
+export declare function compileTsxSync(filePath: string): CompiledTsx;
 //# sourceMappingURL=tsx-compiler.d.ts.map

package/dist/tsx-compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsx-compiler.d.ts","sourceRoot":"","sources":["../src/tsx-compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAwQH;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUvD"}
+{"version":3,"file":"tsx-compiler.d.ts","sourceRoot":"","sources":["../src/tsx-compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkYH;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAoPD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAe7C;AAED,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,wCAAwC,CAAC;AAC1E,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAClB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAsBtF;AAoDD;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAUvE;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAW7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAU5D"}