@betterportal/theme-runtime 1.0.0

package/README.md

@@ -0,0 +1,25 @@
+# @betterportal/theme-runtime
+
+Shared browser-shell runtime for BetterPortal Node theme packages.
+
+The package assembles one JavaScript asset on the backend in this order:
+
+1. HTMX core from the installed `htmx.org` package.
+2. The theme's presentation adapter.
+3. The BetterPortal `bp-shell` runtime.
+4. The bundled HTMX SSE extension.
+
+The browser never discovers or loads extensions dynamically. Required assets are resolved by the backend and missing assets fail bundle creation.
+
+```ts
+import { buildBetterPortalThemeRuntimeAsset } from "@betterportal/theme-runtime";
+
+const asset = await buildBetterPortalThemeRuntimeAsset({
+  themeId: "my-theme",
+  adapterSource
+});
+```
+
+The shared shell owns service/app URL rewriting, native API allowlist links, managed BP headers, header-aware preload, HTMX lifecycle handling, downloads, history, authentication failures, SSE, and background fragments. The fixed HTMX extension allowlist is `bp-shell, sse`.
+
+Theme adapters are presentation-only. They may implement loading/error UI, component initialization and disposal, overlay cleanup, and scrolling. Do not bundle the stock preload extension: BetterPortal's preload implementation is part of `bp-shell` so it can attach scoped BP headers and reuse the prefetched response.

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./runtime.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/lib/index.js

@@ -0,0 +1,2 @@
+export * from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/lib/runtime.d.ts

@@ -0,0 +1,13 @@
+export interface ThemeRuntimeAsset {
+    body: string;
+    contentType: string;
+}
+export declare const BETTERPORTAL_HTMX_EXTENSIONS = "bp-shell, sse";
+export declare function betterPortalShellRuntimeSource(themeId: string): string;
+export interface BuildBetterPortalThemeRuntimeOptions {
+    themeId: string;
+    adapterSource?: string;
+}
+export declare function buildBetterPortalThemeRuntimeAsset(options: BuildBetterPortalThemeRuntimeOptions): Promise<ThemeRuntimeAsset>;
+export declare function loadThemeRuntimeVendorAsset(assetPath: string): Promise<ThemeRuntimeAsset | null>;
+//# sourceMappingURL=runtime.d.ts.map

package/lib/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAqBD,eAAO,MAAM,4BAA4B,kBAAkB,CAAC;AAE5D,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAu9DtE;AAGD,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,oCAAoC,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAQ5B;AAED,wBAAsB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAUtG"}