npm - @refrakt-md/sveltekit - Versions diffs - 0.15.0 → 0.16.0 - Mend

@refrakt-md/sveltekit 0.15.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/theme-hook.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import type { Handle } from '@sveltejs/kit';
+import { type ResolvedTintCascade } from '@refrakt-md/content';
+/** Minimal shape this hook needs from the loaded Site (the real `getSite` from
+ *  `virtual:refrakt/content` is structurally compatible). */
+interface SiteLike {
+    pages: Array<{
+        route: {
+            url: string;
+        };
+        tintCascade?: ResolvedTintCascade;
+    }>;
+}
+export declare function createThemeHandle(getSite: () => Promise<SiteLike>): Handle;
+export {};
+//# sourceMappingURL=theme-hook.d.ts.map

package/dist/theme-hook.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"theme-hook.d.ts","sourceRoot":"","sources":["../src/theme-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAIN,KAAK,mBAAmB,EACxB,MAAM,qBAAqB,CAAC;AA6B7B;6DAC6D;AAC7D,UAAU,QAAQ;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,WAAW,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,CAuC1E"}

package/dist/theme-hook.js ADDED Viewed

@@ -0,0 +1,63 @@
+import { htmlTintAttributes, colorSchemeMetaContent, prePaintScript, } from '@refrakt-md/content';
+/**
+ * Server-safe theme SSR plumbing for SvelteKit apps (SPEC-073).
+ *
+ * Imported from `@refrakt-md/sveltekit/hooks` (this entry deliberately avoids
+ * the Vite plugin so it can run in the server runtime). Returns a SvelteKit
+ * `Handle` that, per request, looks up the route's tint cascade and splices the
+ * no-flash chrome into the response: tint `data-*` attributes on `<html>`, the
+ * `color-scheme` meta, and the anti-FOIT pre-paint script — before any
+ * stylesheet so the saved theme applies before first paint.
+ *
+ * Apps wire it in one line instead of hand-rolling the boilerplate:
+ *
+ * ```ts
+ * // src/hooks.server.ts
+ * import { createThemeHandle } from '@refrakt-md/sveltekit/hooks';
+ * import { getSite } from '$lib/content';
+ * export const handle = createThemeHandle(getSite);
+ * ```
+ *
+ * Compose with other handles via SvelteKit's `sequence()` when needed.
+ */
+const DEFAULT_CASCADE = {
+    tint: null,
+    tintMode: 'auto',
+    locked: false,
+};
+export function createThemeHandle(getSite) {
+    const PRE_PAINT_SCRIPT = prePaintScript();
+    /** Resolve a URL's cascade from the loaded Site's pages; a sensible default
+     *  for URLs that don't match (SvelteKit-internal routes, sitemap, etc.). */
+    const cascadeForUrl = async (pathname) => {
+        try {
+            const site = await getSite();
+            const page = site.pages.find((p) => p.route.url === pathname);
+            return page?.tintCascade ?? DEFAULT_CASCADE;
+        }
+        catch (_) {
+            // Site load may fail during early bootstrap or in tests — fall back
+            // to the safe default rather than crashing the response.
+            return DEFAULT_CASCADE;
+        }
+    };
+    return async ({ event, resolve }) => {
+        const cascade = await cascadeForUrl(event.url.pathname);
+        const htmlAttrs = htmlTintAttributes(cascade);
+        const metaScheme = colorSchemeMetaContent(cascade);
+        return resolve(event, {
+            transformPageChunk: ({ html }) => {
+                let result = html;
+                // Splice the cascade attrs inside the opening <html lang="en"> tag.
+                if (htmlAttrs) {
+                    result = result.replace(/<html lang="en">/, `<html lang="en" ${htmlAttrs}>`);
+                }
+                // Pre-paint script + color-scheme meta just inside <head>, before
+                // any stylesheet, so the saved theme applies before first paint.
+                result = result.replace(/<head>/, `<head>\n\t\t<meta name="color-scheme" content="${metaScheme}" />\n\t\t<script>${PRE_PAINT_SCRIPT}</script>`);
+                return result;
+            },
+        });
+    };
+}
+//# sourceMappingURL=theme-hook.js.map

package/dist/theme-hook.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"theme-hook.js","sourceRoot":"","sources":["../src/theme-hook.ts"],"names":[],"mappings":"AACA,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,GAEd,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,eAAe,GAAwB;IAC5C,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,KAAK;CACb,CAAC;AAQF,MAAM,UAAU,iBAAiB,CAAC,OAAgC;IACjE,MAAM,gBAAgB,GAAG,cAAc,EAAE,CAAC;IAE1C;gFAC4E;IAC5E,MAAM,aAAa,GAAG,KAAK,EAAE,QAAgB,EAAgC,EAAE;QAC9E,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;YAC9D,OAAO,IAAI,EAAE,WAAW,IAAI,eAAe,CAAC;QAC7C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,oEAAoE;YACpE,yDAAyD;YACzD,OAAO,eAAe,CAAC;QACxB,CAAC;IACF,CAAC,CAAC;IAEF,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;QACnC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAEnD,OAAO,OAAO,CAAC,KAAK,EAAE;YACrB,kBAAkB,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;gBAChC,IAAI,MAAM,GAAG,IAAI,CAAC;gBAClB,oEAAoE;gBACpE,IAAI,SAAS,EAAE,CAAC;oBACf,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE,mBAAmB,SAAS,GAAG,CAAC,CAAC;gBAC9E,CAAC;gBACD,kEAAkE;gBAClE,iEAAiE;gBACjE,MAAM,GAAG,MAAM,CAAC,OAAO,CACtB,QAAQ,EACR,kDAAkD,UAAU,qBAAqB,gBAAgB,WAAW,CAC5G,CAAC;gBACF,OAAO,MAAM,CAAC;YACf,CAAC;SACD,CAAC,CAAC;IACJ,CAAC,CAAC;AACH,CAAC"}

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/sveltekit",
   "description": "SvelteKit integration plugin for refrakt.md",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -21,6 +21,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./hooks": {
+      "types": "./dist/theme-hook.d.ts",
+      "default": "./dist/theme-hook.js"
+    },
     "./virtual": {
       "types": "./virtual.d.ts"
     }
@@ -33,9 +37,11 @@
     "build": "tsc"
   },
   "dependencies": {
-    "@refrakt-md/types": "0.15.0"
+    "@refrakt-md/content": "0.16.0",
+    "@refrakt-md/types": "0.16.0"
   },
   "peerDependencies": {
+    "@sveltejs/kit": ">=2.0.0",
     "vite": ">=5.0.0"
   }
 }