raktajs 0.1.0

package/dist/pwa/cache.d.ts

@@ -0,0 +1,6 @@
+import type { CacheStrategyOptions } from "./types";
+/** Builds a versioned cache name, e.g. "rakta-shrimp-harbor-v1". */
+export declare function buildCacheName(cacheName: string, cacheVersion: string): string;
+/** Returns the list of URLs that should be precached, including the offline fallback. */
+export declare function resolvePrecacheList(options: CacheStrategyOptions): string[];
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/pwa/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,oEAAoE;AACpE,wBAAgB,cAAc,CAC7B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GAClB,MAAM,CAKR;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAK3E"}

package/dist/pwa/index.d.ts

@@ -0,0 +1,5 @@
+export { buildCacheName, resolvePrecacheList } from "./cache";
+export { createManifestHandler, generateManifest, generateManifestJson, } from "./manifest";
+export { generateServiceWorkerSource } from "./serviceWorker";
+export type { CacheStrategyOptions, ManifestDisplayMode, ManifestIcon, ManifestOptions, ServiceWorkerOptions, WebAppManifest, WebAppManifestIcon, } from "./types";
+//# 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,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EACN,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAE9D,YAAY,EACX,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,kBAAkB,GAClB,MAAM,SAAS,CAAC"}

package/dist/pwa/index.js

@@ -0,0 +1,136 @@
+// @bun
+// src/pwa/cache.ts
+function buildCacheName(cacheName, cacheVersion) {
+  const sanitizedName = cacheName.trim().toLowerCase().replace(/\s+/g, "-");
+  const sanitizedVersion = cacheVersion.trim().toLowerCase();
+  return `${sanitizedName}-${sanitizedVersion}`;
+}
+function resolvePrecacheList(options) {
+  const uniqueUrls = new Set(options.precacheUrls);
+  uniqueUrls.add(options.offlineFallbackUrl);
+  return Array.from(uniqueUrls);
+}
+// src/pwa/manifest.ts
+function generateManifest(options) {
+  const manifestObject = {
+    name: options.name,
+    short_name: options.shortName,
+    start_url: options.startUrl ?? "/",
+    scope: options.scope ?? "/",
+    display: options.display ?? "standalone",
+    background_color: options.backgroundColor ?? "#050505",
+    theme_color: options.themeColor ?? "#dc2626",
+    icons: options.icons.map((icon) => {
+      const manifestIcon = {
+        src: icon.src,
+        sizes: icon.sizes,
+        type: icon.type
+      };
+      if (icon.purpose !== undefined) {
+        return {
+          ...manifestIcon,
+          purpose: icon.purpose
+        };
+      }
+      return manifestIcon;
+    })
+  };
+  if (options.description !== undefined) {
+    return {
+      ...manifestObject,
+      description: options.description
+    };
+  }
+  return manifestObject;
+}
+function generateManifestJson(options) {
+  return JSON.stringify(generateManifest(options), undefined, 2);
+}
+function createManifestHandler(options) {
+  return () => {
+    const manifestJson = generateManifestJson(options);
+    return new Response(manifestJson, {
+      status: 200,
+      headers: {
+        "Content-Type": "application/manifest+json; charset=utf-8",
+        "Cache-Control": "public, max-age=3600"
+      }
+    });
+  };
+}
+// src/pwa/serviceWorker.ts
+function toJsStringArray(values) {
+  return `[${values.map((value) => JSON.stringify(value)).join(", ")}]`;
+}
+function generateServiceWorkerSource(options) {
+  const cacheName = buildCacheName(options.cacheName, options.cacheVersion);
+  const precacheList = resolvePrecacheList(options);
+  const offlineFallbackUrl = options.offlineFallbackUrl;
+  return `// Generated by Rakta.js ShrimpHarbor - do not edit manually.
+// Re-run "bun rakta pwa:generate" to regenerate this file.
+
+const CACHE_NAME = ${JSON.stringify(cacheName)};
+const OFFLINE_FALLBACK_URL = ${JSON.stringify(offlineFallbackUrl)};
+const PRECACHE_URLS = ${toJsStringArray(precacheList)};
+
+self.addEventListener("install", (installEvent) => {
+  installEvent.waitUntil(
+    caches.open(CACHE_NAME).then((cache) => cache.addAll(PRECACHE_URLS)),
+  );
+  self.skipWaiting();
+});
+
+self.addEventListener("activate", (activateEvent) => {
+  activateEvent.waitUntil(
+    caches.keys().then((cacheKeys) =>
+      Promise.all(
+        cacheKeys
+          .filter((cacheKey) => cacheKey !== CACHE_NAME)
+          .map((staleCacheKey) => caches.delete(staleCacheKey)),
+      ),
+    ),
+  );
+  self.clients.claim();
+});
+
+self.addEventListener("fetch", (fetchEvent) => {
+  if (fetchEvent.request.method !== "GET") {
+    return;
+  }
+
+  fetchEvent.respondWith(
+    caches.match(fetchEvent.request).then((cachedResponse) => {
+      if (cachedResponse) {
+        return cachedResponse;
+      }
+
+      return fetch(fetchEvent.request)
+        .then((networkResponse) => {
+          const responseClone = networkResponse.clone();
+          caches
+            .open(CACHE_NAME)
+            .then((cache) => cache.put(fetchEvent.request, responseClone));
+          return networkResponse;
+        })
+        .catch(() => {
+          if (fetchEvent.request.mode === "navigate") {
+            return caches.match(OFFLINE_FALLBACK_URL);
+          }
+
+          return caches.match(fetchEvent.request);
+        });
+    }),
+  );
+});
+`;
+}
+export {
+  resolvePrecacheList,
+  generateServiceWorkerSource,
+  generateManifestJson,
+  generateManifest,
+  createManifestHandler,
+  buildCacheName
+};
+
+//# debugId=A887C53731F3975E64756E2164756E21

package/dist/pwa/index.js.map

@@ -0,0 +1,12 @@
+{
+  "version": 3,
+  "sources": ["..\\..\\src\\pwa\\cache.ts", "..\\..\\src\\pwa\\manifest.ts", "..\\..\\src\\pwa\\serviceWorker.ts"],
+  "sourcesContent": [
+    "import type { CacheStrategyOptions } from \"./types\";\n\n/** Builds a versioned cache name, e.g. \"rakta-shrimp-harbor-v1\". */\nexport function buildCacheName(\n\tcacheName: string,\n\tcacheVersion: string,\n): string {\n\tconst sanitizedName = cacheName.trim().toLowerCase().replace(/\\s+/g, \"-\");\n\tconst sanitizedVersion = cacheVersion.trim().toLowerCase();\n\n\treturn `${sanitizedName}-${sanitizedVersion}`;\n}\n\n/** Returns the list of URLs that should be precached, including the offline fallback. */\nexport function resolvePrecacheList(options: CacheStrategyOptions): string[] {\n\tconst uniqueUrls = new Set<string>(options.precacheUrls);\n\tuniqueUrls.add(options.offlineFallbackUrl);\n\n\treturn Array.from(uniqueUrls);\n}\n",
+    "import type { ManifestOptions, WebAppManifest } from \"./types\";\n\n/**\n * ShrimpHarbor — generates a web app manifest object for PWA installability.\n * Serialize with JSON.stringify and serve as /manifest.webmanifest.\n */\nexport function generateManifest(options: ManifestOptions): WebAppManifest {\n\tconst manifestObject: WebAppManifest = {\n\t\tname: options.name,\n\t\tshort_name: options.shortName,\n\t\tstart_url: options.startUrl ?? \"/\",\n\t\tscope: options.scope ?? \"/\",\n\t\tdisplay: options.display ?? \"standalone\",\n\t\tbackground_color: options.backgroundColor ?? \"#050505\",\n\t\ttheme_color: options.themeColor ?? \"#dc2626\",\n\t\ticons: options.icons.map((icon) => {\n\t\t\tconst manifestIcon = {\n\t\t\t\tsrc: icon.src,\n\t\t\t\tsizes: icon.sizes,\n\t\t\t\ttype: icon.type,\n\t\t\t};\n\n\t\t\tif (icon.purpose !== undefined) {\n\t\t\t\treturn {\n\t\t\t\t\t...manifestIcon,\n\t\t\t\t\tpurpose: icon.purpose,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\treturn manifestIcon;\n\t\t}),\n\t};\n\n\tif (options.description !== undefined) {\n\t\treturn {\n\t\t\t...manifestObject,\n\t\t\tdescription: options.description,\n\t\t};\n\t}\n\n\treturn manifestObject;\n}\n\n/** Serializes the manifest to a JSON string ready to write to disk or serve. */\nexport function generateManifestJson(options: ManifestOptions): string {\n\treturn JSON.stringify(generateManifest(options), undefined, 2);\n}\n\n/** Creates a Bun/Tide-compatible request handler that serves the manifest. */\nexport function createManifestHandler(\n\toptions: ManifestOptions,\n): () => Response {\n\treturn () => {\n\t\tconst manifestJson = generateManifestJson(options);\n\n\t\treturn new Response(manifestJson, {\n\t\t\tstatus: 200,\n\t\t\theaders: {\n\t\t\t\t\"Content-Type\": \"application/manifest+json; charset=utf-8\",\n\t\t\t\t\"Cache-Control\": \"public, max-age=3600\",\n\t\t\t},\n\t\t});\n\t};\n}\n",
+    "import { buildCacheName, resolvePrecacheList } from \"./cache\";\nimport type { ServiceWorkerOptions } from \"./types\";\n\nfunction toJsStringArray(values: readonly string[]): string {\n\treturn `[${values.map((value) => JSON.stringify(value)).join(\", \")}]`;\n}\n\n/**\n * ShrimpHarbor — generates the source text of a service worker file\n * implementing a cache-first strategy with an offline fallback page.\n *\n * Write the returned string to public/sw.js in the generated app.\n * This function only produces text; it does not touch the filesystem\n * or any browser-only APIs, so it is safe to call at build time.\n */\nexport function generateServiceWorkerSource(\n\toptions: ServiceWorkerOptions,\n): string {\n\tconst cacheName = buildCacheName(options.cacheName, options.cacheVersion);\n\tconst precacheList = resolvePrecacheList(options);\n\tconst offlineFallbackUrl = options.offlineFallbackUrl;\n\n\treturn `// Generated by Rakta.js ShrimpHarbor - do not edit manually.\n// Re-run \"bun rakta pwa:generate\" to regenerate this file.\n\nconst CACHE_NAME = ${JSON.stringify(cacheName)};\nconst OFFLINE_FALLBACK_URL = ${JSON.stringify(offlineFallbackUrl)};\nconst PRECACHE_URLS = ${toJsStringArray(precacheList)};\n\nself.addEventListener(\"install\", (installEvent) => {\n  installEvent.waitUntil(\n    caches.open(CACHE_NAME).then((cache) => cache.addAll(PRECACHE_URLS)),\n  );\n  self.skipWaiting();\n});\n\nself.addEventListener(\"activate\", (activateEvent) => {\n  activateEvent.waitUntil(\n    caches.keys().then((cacheKeys) =>\n      Promise.all(\n        cacheKeys\n          .filter((cacheKey) => cacheKey !== CACHE_NAME)\n          .map((staleCacheKey) => caches.delete(staleCacheKey)),\n      ),\n    ),\n  );\n  self.clients.claim();\n});\n\nself.addEventListener(\"fetch\", (fetchEvent) => {\n  if (fetchEvent.request.method !== \"GET\") {\n    return;\n  }\n\n  fetchEvent.respondWith(\n    caches.match(fetchEvent.request).then((cachedResponse) => {\n      if (cachedResponse) {\n        return cachedResponse;\n      }\n\n      return fetch(fetchEvent.request)\n        .then((networkResponse) => {\n          const responseClone = networkResponse.clone();\n          caches\n            .open(CACHE_NAME)\n            .then((cache) => cache.put(fetchEvent.request, responseClone));\n          return networkResponse;\n        })\n        .catch(() => {\n          if (fetchEvent.request.mode === \"navigate\") {\n            return caches.match(OFFLINE_FALLBACK_URL);\n          }\n\n          return caches.match(fetchEvent.request);\n        });\n    }),\n  );\n});\n`;\n}\n"
+  ],
+  "mappings": ";;AAGO,SAAS,cAAc,CAC7B,WACA,cACS;AAAA,EACT,MAAM,gBAAgB,UAAU,KAAK,EAAE,YAAY,EAAE,QAAQ,QAAQ,GAAG;AAAA,EACxE,MAAM,mBAAmB,aAAa,KAAK,EAAE,YAAY;AAAA,EAEzD,OAAO,GAAG,iBAAiB;AAAA;AAIrB,SAAS,mBAAmB,CAAC,SAAyC;AAAA,EAC5E,MAAM,aAAa,IAAI,IAAY,QAAQ,YAAY;AAAA,EACvD,WAAW,IAAI,QAAQ,kBAAkB;AAAA,EAEzC,OAAO,MAAM,KAAK,UAAU;AAAA;;ACZtB,SAAS,gBAAgB,CAAC,SAA0C;AAAA,EAC1E,MAAM,iBAAiC;AAAA,IACtC,MAAM,QAAQ;AAAA,IACd,YAAY,QAAQ;AAAA,IACpB,WAAW,QAAQ,YAAY;AAAA,IAC/B,OAAO,QAAQ,SAAS;AAAA,IACxB,SAAS,QAAQ,WAAW;AAAA,IAC5B,kBAAkB,QAAQ,mBAAmB;AAAA,IAC7C,aAAa,QAAQ,cAAc;AAAA,IACnC,OAAO,QAAQ,MAAM,IAAI,CAAC,SAAS;AAAA,MAClC,MAAM,eAAe;AAAA,QACpB,KAAK,KAAK;AAAA,QACV,OAAO,KAAK;AAAA,QACZ,MAAM,KAAK;AAAA,MACZ;AAAA,MAEA,IAAI,KAAK,YAAY,WAAW;AAAA,QAC/B,OAAO;AAAA,aACH;AAAA,UACH,SAAS,KAAK;AAAA,QACf;AAAA,MACD;AAAA,MAEA,OAAO;AAAA,KACP;AAAA,EACF;AAAA,EAEA,IAAI,QAAQ,gBAAgB,WAAW;AAAA,IACtC,OAAO;AAAA,SACH;AAAA,MACH,aAAa,QAAQ;AAAA,IACtB;AAAA,EACD;AAAA,EAEA,OAAO;AAAA;AAID,SAAS,oBAAoB,CAAC,SAAkC;AAAA,EACtE,OAAO,KAAK,UAAU,iBAAiB,OAAO,GAAG,WAAW,CAAC;AAAA;AAIvD,SAAS,qBAAqB,CACpC,SACiB;AAAA,EACjB,OAAO,MAAM;AAAA,IACZ,MAAM,eAAe,qBAAqB,OAAO;AAAA,IAEjD,OAAO,IAAI,SAAS,cAAc;AAAA,MACjC,QAAQ;AAAA,MACR,SAAS;AAAA,QACR,gBAAgB;AAAA,QAChB,iBAAiB;AAAA,MAClB;AAAA,IACD,CAAC;AAAA;AAAA;;AC1DH,SAAS,eAAe,CAAC,QAAmC;AAAA,EAC3D,OAAO,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,KAAK,CAAC,EAAE,KAAK,IAAI;AAAA;AAW3D,SAAS,2BAA2B,CAC1C,SACS;AAAA,EACT,MAAM,YAAY,eAAe,QAAQ,WAAW,QAAQ,YAAY;AAAA,EACxE,MAAM,eAAe,oBAAoB,OAAO;AAAA,EAChD,MAAM,qBAAqB,QAAQ;AAAA,EAEnC,OAAO;AAAA;AAAA;AAAA,qBAGa,KAAK,UAAU,SAAS;AAAA,+BACd,KAAK,UAAU,kBAAkB;AAAA,wBACxC,gBAAgB,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "debugId": "A887C53731F3975E64756E2164756E21",
+  "names": []
+}

package/dist/pwa/manifest.d.ts

@@ -0,0 +1,11 @@
+import type { ManifestOptions, WebAppManifest } from "./types";
+/**
+ * ShrimpHarbor — generates a web app manifest object for PWA installability.
+ * Serialize with JSON.stringify and serve as /manifest.webmanifest.
+ */
+export declare function generateManifest(options: ManifestOptions): WebAppManifest;
+/** Serializes the manifest to a JSON string ready to write to disk or serve. */
+export declare function generateManifestJson(options: ManifestOptions): string;
+/** Creates a Bun/Tide-compatible request handler that serves the manifest. */
+export declare function createManifestHandler(options: ManifestOptions): () => Response;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/pwa/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAmCzE;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAErE;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,eAAe,GACtB,MAAM,QAAQ,CAYhB"}

package/dist/pwa/serviceWorker.d.ts

@@ -0,0 +1,11 @@
+import type { ServiceWorkerOptions } from "./types";
+/**
+ * ShrimpHarbor — generates the source text of a service worker file
+ * implementing a cache-first strategy with an offline fallback page.
+ *
+ * Write the returned string to public/sw.js in the generated app.
+ * This function only produces text; it does not touch the filesystem
+ * or any browser-only APIs, so it is safe to call at build time.
+ */
+export declare function generateServiceWorkerSource(options: ServiceWorkerOptions): string;
+//# sourceMappingURL=serviceWorker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serviceWorker.d.ts","sourceRoot":"","sources":["../../src/pwa/serviceWorker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAMpD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,oBAAoB,GAC3B,MAAM,CA8DR"}

package/dist/pwa/types.d.ts

@@ -0,0 +1,45 @@
+export interface ManifestIcon {
+    readonly src: string;
+    readonly sizes: string;
+    readonly type: string;
+    readonly purpose?: "any" | "maskable" | "monochrome";
+}
+export type ManifestDisplayMode = "standalone" | "fullscreen" | "minimal-ui" | "browser";
+export interface ManifestOptions {
+    readonly name: string;
+    readonly shortName: string;
+    readonly description?: string;
+    readonly startUrl?: string;
+    readonly scope?: string;
+    readonly display?: ManifestDisplayMode;
+    readonly backgroundColor?: string;
+    readonly themeColor?: string;
+    readonly icons: ManifestIcon[];
+}
+export interface WebAppManifestIcon {
+    src: string;
+    sizes: string;
+    type: string;
+    purpose?: "any" | "maskable" | "monochrome";
+}
+export interface WebAppManifest {
+    name: string;
+    short_name: string;
+    start_url: string;
+    scope: string;
+    display: ManifestDisplayMode;
+    background_color: string;
+    theme_color: string;
+    icons: WebAppManifestIcon[];
+    description?: string;
+}
+export interface CacheStrategyOptions {
+    readonly cacheName: string;
+    readonly cacheVersion: string;
+    readonly precacheUrls: string[];
+    readonly offlineFallbackUrl: string;
+}
+export interface ServiceWorkerOptions extends CacheStrategyOptions {
+    readonly runtimeCachePatterns?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pwa/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,YAAY,CAAC;CACrD;AAED,MAAM,MAAM,mBAAmB,GAC5B,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,SAAS,CAAC;AAEb,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,YAAY,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,mBAAmB,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IACjE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACzC"}

package/dist/render/index.d.ts

@@ -0,0 +1,5 @@
+export { getModeDescriptor, isBuildTimeMode, isRoadmapMode, RENDER_MODE_DESCRIPTORS, requiresServer, resolveRouteMode, } from "./modes";
+export type { RendererOptions } from "./renderer";
+export { render, renderNotFound, renderServerError, } from "./renderer";
+export type { HybridRouteEntry, RenderConfig, RenderContext, RenderFailure, RenderMode, RenderModeDescriptor, RenderResult, RenderSource, RenderSuccess, ResolvedRouteMode, RouteRenderMap, StaticEntry, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AACA,OAAO,EACN,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,gBAAgB,GAChB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACN,MAAM,EACN,cAAc,EACd,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,WAAW,GACX,MAAM,SAAS,CAAC"}

package/dist/render/index.js

@@ -0,0 +1,183 @@
+// @bun
+// src/render/modes.ts
+var RENDER_MODE_DESCRIPTORS = {
+  csr: {
+    mode: "csr",
+    label: "Client-Side Rendering",
+    shortLabel: "CSR",
+    description: "React renders entirely in the browser. The server sends a minimal HTML shell with a JS bundle. No server required at runtime.",
+    serverRequired: false,
+    buildTimeGenerated: false,
+    clientHydration: true,
+    roadmap: false
+  },
+  ssr: {
+    mode: "ssr",
+    label: "Server-Side Rendering",
+    shortLabel: "SSR",
+    description: "React renders to HTML on the server per request. The client receives full HTML and then hydrates. Requires a running Node/Bun server.",
+    serverRequired: true,
+    buildTimeGenerated: false,
+    clientHydration: true,
+    roadmap: true
+  },
+  ssg: {
+    mode: "ssg",
+    label: "Static Site Generation",
+    shortLabel: "SSG",
+    description: "Pages are fully rendered at build time. Output is static HTML files. No server required at runtime.",
+    serverRequired: false,
+    buildTimeGenerated: true,
+    clientHydration: false,
+    roadmap: true
+  },
+  csg: {
+    mode: "csg",
+    label: "Client-Side Generation",
+    shortLabel: "CSG",
+    description: "A static shell is generated at build time, data is fetched and rendered on the client. Combines SSG speed with dynamic data.",
+    serverRequired: false,
+    buildTimeGenerated: true,
+    clientHydration: true,
+    roadmap: true
+  },
+  spa: {
+    mode: "spa",
+    label: "Single Page Application",
+    shortLabel: "SPA",
+    description: "A single HTML entry point is served for all routes. React handles all routing client-side. Equivalent to a standard Vite SPA.",
+    serverRequired: false,
+    buildTimeGenerated: false,
+    clientHydration: true,
+    roadmap: false
+  },
+  hybrid: {
+    mode: "hybrid",
+    label: "Hybrid Rendering",
+    shortLabel: "Hybrid",
+    description: "Different routes use different render modes. Configured via the `render.routes` map in rakta.config.ts. The top-level mode is the fallback.",
+    serverRequired: false,
+    buildTimeGenerated: false,
+    clientHydration: true,
+    roadmap: false
+  }
+};
+function pathMatchesPattern(pathname, pattern) {
+  if (pattern === pathname)
+    return true;
+  const patternParts = pattern.split("/");
+  const pathParts = pathname.split("/");
+  if (patternParts.length !== pathParts.length)
+    return false;
+  for (let i = 0;i < patternParts.length; i++) {
+    const pp = patternParts[i];
+    const path = pathParts[i];
+    if (pp === undefined || path === undefined)
+      return false;
+    if (pp.startsWith(":"))
+      continue;
+    if (pp !== path)
+      return false;
+  }
+  return true;
+}
+function resolveRouteMode(pathname, config) {
+  const patterns = Object.keys(config.routes).sort((a, b) => b.length - a.length);
+  for (const pattern of patterns) {
+    const overrideMode = config.routes[pattern];
+    if (overrideMode !== undefined && pathMatchesPattern(pathname, pattern)) {
+      return {
+        routePath: pathname,
+        mode: overrideMode,
+        source: "route-override"
+      };
+    }
+  }
+  return {
+    routePath: pathname,
+    mode: config.defaultMode,
+    source: "default"
+  };
+}
+function getModeDescriptor(mode) {
+  return RENDER_MODE_DESCRIPTORS[mode];
+}
+function isRoadmapMode(mode) {
+  return RENDER_MODE_DESCRIPTORS[mode].roadmap;
+}
+function requiresServer(mode) {
+  return RENDER_MODE_DESCRIPTORS[mode].serverRequired;
+}
+function isBuildTimeMode(mode) {
+  return RENDER_MODE_DESCRIPTORS[mode].buildTimeGenerated;
+}
+// src/render/renderer.ts
+function buildHtmlShell(options) {
+  return `
+  <!DOCTYPE html>
+    <html lang="${options.lang}">
+        <head>
+            <meta charset="UTF-8" />
+            <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+            <title>
+                ${options.appName}
+            </title>
+            <link rel="stylesheet" href="${options.cssPath}" />
+        </head>
+        <body>
+            <div id="rakta-root"></div>
+            <script type="module" src="${options.scriptPath}"></script>
+        </body>
+    </html>`;
+}
+function makeSuccess(html, mode, renderMs, httpStatus = 200, fromCache = false) {
+  return {
+    kind: "success",
+    html,
+    mode,
+    httpStatus,
+    responseHeaders: { "Content-Type": "text/html; charset=utf-8" },
+    fromCache,
+    renderMs
+  };
+}
+function makeFailure(reason, mode, httpStatus = 500) {
+  return { kind: "failure", reason, mode, httpStatus };
+}
+async function render(context, options) {
+  const startMs = Date.now();
+  if (isRoadmapMode(context.mode)) {
+    console.warn(`[Rakta.js] Render mode "${context.mode}" is a roadmap feature (v0.2.0). ` + `Falling back to CSR for: ${context.routePath}`);
+    return makeSuccess(buildHtmlShell(options), "csr", Date.now() - startMs);
+  }
+  switch (context.mode) {
+    case "csr":
+    case "spa":
+      return makeSuccess(buildHtmlShell(options), context.mode, Date.now() - startMs);
+    case "hybrid":
+      return makeSuccess(buildHtmlShell(options), "csr", Date.now() - startMs);
+    case "ssr":
+    case "ssg":
+    case "csg":
+      return makeFailure(`Render mode "${context.mode}" is not yet implemented.`, context.mode, 501);
+  }
+}
+function renderNotFound(options) {
+  return makeSuccess(buildHtmlShell(options), "csr", 0, 404);
+}
+function renderServerError(reason, mode) {
+  return makeFailure(reason, mode, 500);
+}
+export {
+  resolveRouteMode,
+  requiresServer,
+  renderServerError,
+  renderNotFound,
+  render,
+  isRoadmapMode,
+  isBuildTimeMode,
+  getModeDescriptor,
+  RENDER_MODE_DESCRIPTORS
+};
+
+//# debugId=CC5E8D5EC6EA00C564756E2164756E21

package/dist/render/index.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["..\\..\\src\\render\\modes.ts", "..\\..\\src\\render\\renderer.ts"],
+  "sourcesContent": [
+    "import type {\n\tRenderConfig,\n\tRenderMode,\n\tRenderModeDescriptor,\n\tResolvedRouteMode,\n} from \"./types\";\n\nexport const RENDER_MODE_DESCRIPTORS: Readonly<\n\tRecord<RenderMode, RenderModeDescriptor>\n> = {\n\tcsr: {\n\t\tmode: \"csr\",\n\t\tlabel: \"Client-Side Rendering\",\n\t\tshortLabel: \"CSR\",\n\t\tdescription:\n\t\t\t\"React renders entirely in the browser. The server sends a minimal HTML shell with a JS bundle. No server required at runtime.\",\n\t\tserverRequired: false,\n\t\tbuildTimeGenerated: false,\n\t\tclientHydration: true,\n\t\troadmap: false,\n\t},\n\tssr: {\n\t\tmode: \"ssr\",\n\t\tlabel: \"Server-Side Rendering\",\n\t\tshortLabel: \"SSR\",\n\t\tdescription:\n\t\t\t\"React renders to HTML on the server per request. The client receives full HTML and then hydrates. Requires a running Node/Bun server.\",\n\t\tserverRequired: true,\n\t\tbuildTimeGenerated: false,\n\t\tclientHydration: true,\n\t\troadmap: true, // Roadmap: v0.2.0\n\t},\n\tssg: {\n\t\tmode: \"ssg\",\n\t\tlabel: \"Static Site Generation\",\n\t\tshortLabel: \"SSG\",\n\t\tdescription:\n\t\t\t\"Pages are fully rendered at build time. Output is static HTML files. No server required at runtime.\",\n\t\tserverRequired: false,\n\t\tbuildTimeGenerated: true,\n\t\tclientHydration: false,\n\t\troadmap: true, // Roadmap: v0.2.0\n\t},\n\tcsg: {\n\t\tmode: \"csg\",\n\t\tlabel: \"Client-Side Generation\",\n\t\tshortLabel: \"CSG\",\n\t\tdescription:\n\t\t\t\"A static shell is generated at build time, data is fetched and rendered on the client. Combines SSG speed with dynamic data.\",\n\t\tserverRequired: false,\n\t\tbuildTimeGenerated: true,\n\t\tclientHydration: true,\n\t\troadmap: true, // Roadmap: v0.2.0\n\t},\n\tspa: {\n\t\tmode: \"spa\",\n\t\tlabel: \"Single Page Application\",\n\t\tshortLabel: \"SPA\",\n\t\tdescription:\n\t\t\t\"A single HTML entry point is served for all routes. React handles all routing client-side. Equivalent to a standard Vite SPA.\",\n\t\tserverRequired: false,\n\t\tbuildTimeGenerated: false,\n\t\tclientHydration: true,\n\t\troadmap: false,\n\t},\n\thybrid: {\n\t\tmode: \"hybrid\",\n\t\tlabel: \"Hybrid Rendering\",\n\t\tshortLabel: \"Hybrid\",\n\t\tdescription:\n\t\t\t\"Different routes use different render modes. Configured via the `render.routes` map in rakta.config.ts. The top-level mode is the fallback.\",\n\t\tserverRequired: false,\n\t\tbuildTimeGenerated: false,\n\t\tclientHydration: true,\n\t\troadmap: false,\n\t},\n};\n\n/**\n * Returns true if the pathname matches a given route pattern.\n * Supports exact paths and simple :param segments (e.g. /blog/:slug).\n */\nfunction pathMatchesPattern(pathname: string, pattern: string): boolean {\n\tif (pattern === pathname) return true;\n\n\tconst patternParts = pattern.split(\"/\");\n\tconst pathParts = pathname.split(\"/\");\n\n\tif (patternParts.length !== pathParts.length) return false;\n\n\tfor (let i = 0; i < patternParts.length; i++) {\n\t\tconst pp = patternParts[i];\n\t\tconst path = pathParts[i];\n\t\tif (pp === undefined || path === undefined) return false;\n\t\tif (pp.startsWith(\":\")) continue; // dynamic segment — always matches\n\t\tif (pp !== path) return false;\n\t}\n\n\treturn true;\n}\n\n/**\n * Resolves the render mode for the given pathname using the provided config.\n * Route-specific overrides take priority. The most specific (longest) matching\n * pattern wins. Falls back to `config.defaultMode`.\n */\nexport function resolveRouteMode(\n\tpathname: string,\n\tconfig: RenderConfig,\n): ResolvedRouteMode {\n\tconst patterns = Object.keys(config.routes).sort(\n\t\t(a, b) => b.length - a.length, // longest pattern first (most specific)\n\t);\n\n\tfor (const pattern of patterns) {\n\t\tconst overrideMode = config.routes[pattern];\n\t\tif (overrideMode !== undefined && pathMatchesPattern(pathname, pattern)) {\n\t\t\treturn {\n\t\t\t\troutePath: pathname,\n\t\t\t\tmode: overrideMode,\n\t\t\t\tsource: \"route-override\",\n\t\t\t};\n\t\t}\n\t}\n\n\treturn {\n\t\troutePath: pathname,\n\t\tmode: config.defaultMode,\n\t\tsource: \"default\",\n\t};\n}\n\nexport function getModeDescriptor(mode: RenderMode): RenderModeDescriptor {\n\treturn RENDER_MODE_DESCRIPTORS[mode];\n}\n\nexport function isRoadmapMode(mode: RenderMode): boolean {\n\treturn RENDER_MODE_DESCRIPTORS[mode].roadmap;\n}\n\nexport function requiresServer(mode: RenderMode): boolean {\n\treturn RENDER_MODE_DESCRIPTORS[mode].serverRequired;\n}\n\nexport function isBuildTimeMode(mode: RenderMode): boolean {\n\treturn RENDER_MODE_DESCRIPTORS[mode].buildTimeGenerated;\n}\n",
+    "import { isRoadmapMode } from \"./modes\";\nimport type {\n\tRenderContext,\n\tRenderFailure,\n\tRenderMode,\n\tRenderResult,\n\tRenderSuccess,\n} from \"./types\";\n\nexport interface RendererOptions {\n\treadonly appName: string;\n\treadonly scriptPath: string;\n\treadonly cssPath: string;\n\treadonly lang: string;\n}\n\nfunction buildHtmlShell(options: RendererOptions): string {\n\treturn `\n  <!DOCTYPE html>\n    <html lang=\"${options.lang}\">\n        <head>\n            <meta charset=\"UTF-8\" />\n            <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n            <title>\n                ${options.appName}\n            </title>\n            <link rel=\"stylesheet\" href=\"${options.cssPath}\" />\n        </head>\n        <body>\n            <div id=\"rakta-root\"></div>\n            <script type=\"module\" src=\"${options.scriptPath}\"></script>\n        </body>\n    </html>`;\n}\n\nfunction makeSuccess(\n\thtml: string,\n\tmode: RenderMode,\n\trenderMs: number,\n\thttpStatus: number = 200,\n\tfromCache: boolean = false,\n): RenderSuccess {\n\treturn {\n\t\tkind: \"success\",\n\t\thtml,\n\t\tmode,\n\t\thttpStatus,\n\t\tresponseHeaders: { \"Content-Type\": \"text/html; charset=utf-8\" },\n\t\tfromCache,\n\t\trenderMs,\n\t};\n}\n\nfunction makeFailure(\n\treason: string,\n\tmode: RenderMode,\n\thttpStatus: number = 500,\n): RenderFailure {\n\treturn { kind: \"failure\", reason, mode, httpStatus };\n}\n\n/**\n * Render a page using the resolved mode from the context.\n * Roadmap modes (ssr, ssg, csg) fall back to a CSR shell in v0.1.0.\n */\nexport async function render(\n\tcontext: RenderContext,\n\toptions: RendererOptions,\n): Promise<RenderResult> {\n\tconst startMs = Date.now();\n\n\t// Roadmap modes: fall back to CSR shell with a warning\n\tif (isRoadmapMode(context.mode)) {\n\t\tconsole.warn(\n\t\t\t`[Rakta.js] Render mode \"${context.mode}\" is a roadmap feature (v0.2.0). ` +\n\t\t\t\t`Falling back to CSR for: ${context.routePath}`,\n\t\t);\n\t\treturn makeSuccess(buildHtmlShell(options), \"csr\", Date.now() - startMs);\n\t}\n\n\tswitch (context.mode) {\n\t\tcase \"csr\":\n\t\tcase \"spa\":\n\t\t\treturn makeSuccess(\n\t\t\t\tbuildHtmlShell(options),\n\t\t\t\tcontext.mode,\n\t\t\t\tDate.now() - startMs,\n\t\t\t);\n\n\t\tcase \"hybrid\":\n\t\t\t// Hybrid resolution happens upstream in Tide. If it reaches the renderer\n\t\t\t// as hybrid, the route had no specific override - fall back to CSR.\n\t\t\treturn makeSuccess(buildHtmlShell(options), \"csr\", Date.now() - startMs);\n\n\t\tcase \"ssr\":\n\t\tcase \"ssg\":\n\t\tcase \"csg\":\n\t\t\t// These are already caught by isRoadmapMode above, but TypeScript\n\t\t\t// requires an exhaustive switch for the RenderMode union.\n\t\t\treturn makeFailure(\n\t\t\t\t`Render mode \"${context.mode}\" is not yet implemented.`,\n\t\t\t\tcontext.mode,\n\t\t\t\t501,\n\t\t\t);\n\t}\n}\n\nexport function renderNotFound(options: RendererOptions): RenderSuccess {\n\treturn makeSuccess(buildHtmlShell(options), \"csr\", 0, 404);\n}\n\nexport function renderServerError(\n\treason: string,\n\tmode: RenderMode,\n): RenderFailure {\n\treturn makeFailure(reason, mode, 500);\n}\n"
+  ],
+  "mappings": ";;AAOO,IAAM,0BAET;AAAA,EACH,KAAK;AAAA,IACJ,MAAM;AAAA,IACN,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,aACC;AAAA,IACD,gBAAgB;AAAA,IAChB,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB,SAAS;AAAA,EACV;AAAA,EACA,KAAK;AAAA,IACJ,MAAM;AAAA,IACN,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,aACC;AAAA,IACD,gBAAgB;AAAA,IAChB,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB,SAAS;AAAA,EACV;AAAA,EACA,KAAK;AAAA,IACJ,MAAM;AAAA,IACN,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,aACC;AAAA,IACD,gBAAgB;AAAA,IAChB,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB,SAAS;AAAA,EACV;AAAA,EACA,KAAK;AAAA,IACJ,MAAM;AAAA,IACN,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,aACC;AAAA,IACD,gBAAgB;AAAA,IAChB,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB,SAAS;AAAA,EACV;AAAA,EACA,KAAK;AAAA,IACJ,MAAM;AAAA,IACN,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,aACC;AAAA,IACD,gBAAgB;AAAA,IAChB,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB,SAAS;AAAA,EACV;AAAA,EACA,QAAQ;AAAA,IACP,MAAM;AAAA,IACN,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,aACC;AAAA,IACD,gBAAgB;AAAA,IAChB,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB,SAAS;AAAA,EACV;AACD;AAMA,SAAS,kBAAkB,CAAC,UAAkB,SAA0B;AAAA,EACvE,IAAI,YAAY;AAAA,IAAU,OAAO;AAAA,EAEjC,MAAM,eAAe,QAAQ,MAAM,GAAG;AAAA,EACtC,MAAM,YAAY,SAAS,MAAM,GAAG;AAAA,EAEpC,IAAI,aAAa,WAAW,UAAU;AAAA,IAAQ,OAAO;AAAA,EAErD,SAAS,IAAI,EAAG,IAAI,aAAa,QAAQ,KAAK;AAAA,IAC7C,MAAM,KAAK,aAAa;AAAA,IACxB,MAAM,OAAO,UAAU;AAAA,IACvB,IAAI,OAAO,aAAa,SAAS;AAAA,MAAW,OAAO;AAAA,IACnD,IAAI,GAAG,WAAW,GAAG;AAAA,MAAG;AAAA,IACxB,IAAI,OAAO;AAAA,MAAM,OAAO;AAAA,EACzB;AAAA,EAEA,OAAO;AAAA;AAQD,SAAS,gBAAgB,CAC/B,UACA,QACoB;AAAA,EACpB,MAAM,WAAW,OAAO,KAAK,OAAO,MAAM,EAAE,KAC3C,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MACxB;AAAA,EAEA,WAAW,WAAW,UAAU;AAAA,IAC/B,MAAM,eAAe,OAAO,OAAO;AAAA,IACnC,IAAI,iBAAiB,aAAa,mBAAmB,UAAU,OAAO,GAAG;AAAA,MACxE,OAAO;AAAA,QACN,WAAW;AAAA,QACX,MAAM;AAAA,QACN,QAAQ;AAAA,MACT;AAAA,IACD;AAAA,EACD;AAAA,EAEA,OAAO;AAAA,IACN,WAAW;AAAA,IACX,MAAM,OAAO;AAAA,IACb,QAAQ;AAAA,EACT;AAAA;AAGM,SAAS,iBAAiB,CAAC,MAAwC;AAAA,EACzE,OAAO,wBAAwB;AAAA;AAGzB,SAAS,aAAa,CAAC,MAA2B;AAAA,EACxD,OAAO,wBAAwB,MAAM;AAAA;AAG/B,SAAS,cAAc,CAAC,MAA2B;AAAA,EACzD,OAAO,wBAAwB,MAAM;AAAA;AAG/B,SAAS,eAAe,CAAC,MAA2B;AAAA,EAC1D,OAAO,wBAAwB,MAAM;AAAA;;ACjItC,SAAS,cAAc,CAAC,SAAkC;AAAA,EACzD,OAAO;AAAA;AAAA,kBAEU,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA,kBAKR,QAAQ;AAAA;AAAA,2CAEiB,QAAQ;AAAA;AAAA;AAAA;AAAA,yCAIV,QAAQ;AAAA;AAAA;AAAA;AAKjD,SAAS,WAAW,CACnB,MACA,MACA,UACA,aAAqB,KACrB,YAAqB,OACL;AAAA,EAChB,OAAO;AAAA,IACN,MAAM;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA,iBAAiB,EAAE,gBAAgB,2BAA2B;AAAA,IAC9D;AAAA,IACA;AAAA,EACD;AAAA;AAGD,SAAS,WAAW,CACnB,QACA,MACA,aAAqB,KACL;AAAA,EAChB,OAAO,EAAE,MAAM,WAAW,QAAQ,MAAM,WAAW;AAAA;AAOpD,eAAsB,MAAM,CAC3B,SACA,SACwB;AAAA,EACxB,MAAM,UAAU,KAAK,IAAI;AAAA,EAGzB,IAAI,cAAc,QAAQ,IAAI,GAAG;AAAA,IAChC,QAAQ,KACP,2BAA2B,QAAQ,0CAClC,4BAA4B,QAAQ,WACtC;AAAA,IACA,OAAO,YAAY,eAAe,OAAO,GAAG,OAAO,KAAK,IAAI,IAAI,OAAO;AAAA,EACxE;AAAA,EAEA,QAAQ,QAAQ;AAAA,SACV;AAAA,SACA;AAAA,MACJ,OAAO,YACN,eAAe,OAAO,GACtB,QAAQ,MACR,KAAK,IAAI,IAAI,OACd;AAAA,SAEI;AAAA,MAGJ,OAAO,YAAY,eAAe,OAAO,GAAG,OAAO,KAAK,IAAI,IAAI,OAAO;AAAA,SAEnE;AAAA,SACA;AAAA,SACA;AAAA,MAGJ,OAAO,YACN,gBAAgB,QAAQ,iCACxB,QAAQ,MACR,GACD;AAAA;AAAA;AAII,SAAS,cAAc,CAAC,SAAyC;AAAA,EACvE,OAAO,YAAY,eAAe,OAAO,GAAG,OAAO,GAAG,GAAG;AAAA;AAGnD,SAAS,iBAAiB,CAChC,QACA,MACgB;AAAA,EAChB,OAAO,YAAY,QAAQ,MAAM,GAAG;AAAA;",
+  "debugId": "CC5E8D5EC6EA00C564756E2164756E21",
+  "names": []
+}

package/dist/render/modes.d.ts

@@ -0,0 +1,13 @@
+import type { RenderConfig, RenderMode, RenderModeDescriptor, ResolvedRouteMode } from "./types";
+export declare const RENDER_MODE_DESCRIPTORS: Readonly<Record<RenderMode, RenderModeDescriptor>>;
+/**
+ * Resolves the render mode for the given pathname using the provided config.
+ * Route-specific overrides take priority. The most specific (longest) matching
+ * pattern wins. Falls back to `config.defaultMode`.
+ */
+export declare function resolveRouteMode(pathname: string, config: RenderConfig): ResolvedRouteMode;
+export declare function getModeDescriptor(mode: RenderMode): RenderModeDescriptor;
+export declare function isRoadmapMode(mode: RenderMode): boolean;
+export declare function requiresServer(mode: RenderMode): boolean;
+export declare function isBuildTimeMode(mode: RenderMode): boolean;
+//# sourceMappingURL=modes.d.ts.map

package/dist/render/modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../src/render/modes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAC7C,MAAM,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAoExC,CAAC;AAyBF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,GAClB,iBAAiB,CAqBnB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,CAExE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEvD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAExD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEzD"}

package/dist/render/renderer.d.ts

@@ -0,0 +1,15 @@
+import type { RenderContext, RenderFailure, RenderMode, RenderResult, RenderSuccess } from "./types";
+export interface RendererOptions {
+    readonly appName: string;
+    readonly scriptPath: string;
+    readonly cssPath: string;
+    readonly lang: string;
+}
+/**
+ * Render a page using the resolved mode from the context.
+ * Roadmap modes (ssr, ssg, csg) fall back to a CSR shell in v0.1.0.
+ */
+export declare function render(context: RenderContext, options: RendererOptions): Promise<RenderResult>;
+export declare function renderNotFound(options: RendererOptions): RenderSuccess;
+export declare function renderServerError(reason: string, mode: RenderMode): RenderFailure;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/render/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/render/renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,EACZ,aAAa,EACb,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AA+CD;;;GAGG;AACH,wBAAsB,MAAM,CAC3B,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,YAAY,CAAC,CAqCvB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAEtE;AAED,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,GACd,aAAa,CAEf"}

package/dist/render/types.d.ts

@@ -0,0 +1,72 @@
+/** All supported rendering modes in Rakta.js. */
+export type RenderMode = "csr" | "ssr" | "ssg" | "csg" | "spa" | "hybrid";
+/** Where the mode decision came from. */
+export type RenderSource = "route-override" | "default";
+/** Per-route render mode map. Keys are URL patterns, values are modes. */
+export interface RouteRenderMap {
+    readonly [routePattern: string]: RenderMode;
+}
+/** Render configuration block inside rakta.config.ts. */
+export interface RenderConfig {
+    readonly defaultMode: RenderMode;
+    readonly routes: RouteRenderMap;
+}
+/** Result of resolving the render mode for a specific pathname. */
+export interface ResolvedRouteMode {
+    readonly routePath: string;
+    readonly mode: RenderMode;
+    readonly source: RenderSource;
+}
+/** Static descriptor for a render mode. */
+export interface RenderModeDescriptor {
+    readonly mode: RenderMode;
+    readonly label: string;
+    readonly shortLabel: string;
+    readonly description: string;
+    readonly serverRequired: boolean;
+    readonly buildTimeGenerated: boolean;
+    readonly clientHydration: boolean;
+    /** True if this mode is planned but not yet implemented. */
+    readonly roadmap: boolean;
+}
+/** Execution context passed to every renderer call. */
+export interface RenderContext {
+    readonly routePath: string;
+    readonly mode: RenderMode;
+    readonly params: Readonly<Record<string, string>>;
+    readonly searchParams: Readonly<Record<string, string>>;
+    readonly requestHeaders: Readonly<Record<string, string>>;
+    readonly timestampMs: number;
+}
+/** Successful render outcome. */
+export interface RenderSuccess {
+    readonly kind: "success";
+    readonly html: string;
+    readonly mode: RenderMode;
+    readonly httpStatus: number;
+    readonly responseHeaders: Record<string, string>;
+    readonly fromCache: boolean;
+    readonly renderMs: number;
+}
+/** Failed render outcome. */
+export interface RenderFailure {
+    readonly kind: "failure";
+    readonly reason: string;
+    readonly mode: RenderMode;
+    readonly httpStatus: number;
+}
+export type RenderResult = RenderSuccess | RenderFailure;
+/** A pre-generated static page entry (SSG / CSG). */
+export interface StaticEntry {
+    readonly routePath: string;
+    readonly html: string;
+    readonly generatedAt: string;
+    readonly mode: "ssg" | "csg";
+    readonly sizeBytes: number;
+}
+/** Per-route mode assignment used inside a hybrid config. */
+export interface HybridRouteEntry {
+    readonly pattern: string;
+    readonly mode: Exclude<RenderMode, "hybrid">;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/render/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/render/types.ts"],"names":[],"mappings":"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"}

package/dist/router/index.d.ts

@@ -0,0 +1,5 @@
+export { generateManifest, printManifest, readManifest, writeManifest, } from "./manifest.js";
+export { findLayoutsForPathname, findSpecialRoute, matchRoute, } from "./matcher.js";
+export { scanRoutes } from "./scanner.js";
+export type { ApiMethod, ApiRouteHandler, ApiRouteModule, GenerateMetadataFn, LayoutProps, MatchedRoute, PageProps, RouteContext, RouteKind, RouteManifest, RouteManifestEntry, RouteSegment, } from "./types.js";
+//# 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,OAAO,EACN,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,aAAa,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,YAAY,EACX,SAAS,EACT,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,YAAY,GACZ,MAAM,YAAY,CAAC"}