withsapling · jaydanurwin · Feb 11, 2025 · Feb 4, 2025 · Feb 4, 2025 · Feb 4, 2025
diff --git a/packages/sapling/deno.json b/packages/sapling/deno.json
@@ -2,7 +2,7 @@
   "name": "@sapling/sapling",
   "description": "A micro SSR framework",
   "license": "MIT",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "imports": {
     "@std/media-types": "jsr:@std/media-types@^1.1.0",
     "@std/path": "jsr:@std/path@^1.0.8",

diff --git a/packages/sapling/src/constants.ts b/packages/sapling/src/constants.ts
@@ -1 +1 @@
-export const SAPLING_VERSION = "0.3.1";
+export const SAPLING_VERSION = "0.4.0";
diff --git a/packages/sapling/src/sapling-layout.ts b/packages/sapling/src/sapling-layout.ts
@@ -17,6 +17,7 @@ import { SAPLING_VERSION } from "./constants.ts";
  * @param props.children - The content to render in the body of the page
  * @param props.stream - When true, returns a ReadableStream to stream the HTML output. Defaults to false
  * @param props.disableUnoCSS - When true, skips UnoCSS generation
+ * @param props.enableIslands - When true, adds the islands script and CSS
  *
  * @example
  * ```ts
@@ -78,6 +79,15 @@ export function Layout(props: LayoutProps): Promise<string> | ReadableStream {
           <style>${css.css}</style>`
               : ``
           }
+          ${
+            props.enableIslands
+              ? `
+          <!-- Sapling Islands -->
+          <script type="module" src="https://sapling-is.land"></script>
+          <style>sapling-island{display:contents}</style>
+          `
+              : ``
+          }
           ${props.head}
         </head>
         ${props.bodyClass ? `<body class="${props.bodyClass}">` : `<body>`}
@@ -117,6 +127,15 @@ export function Layout(props: LayoutProps): Promise<string> | ReadableStream {
             <style>${css.css}</style>`
                 : ``
             }
+            ${
+              props.enableIslands
+                ? `
+            <!-- Sapling Islands -->
+            <script type="module" src="https://sapling-is.land"></script>
+            <style>sapling-island{display:contents}</style>
+            `
+                : ``
+            }
             ${props.head}`
         )
       );

diff --git a/packages/sapling/src/sapling.ts b/packages/sapling/src/sapling.ts
@@ -726,10 +726,17 @@ export class Sapling {
   /**
    * Generate pre-rendered HTML files for registered routes
    * @param outputDir - The directory to output the HTML files
+   * @returns {Promise<void>} A promise that resolves when all files have been generated
    * @example
    * ```ts
    * // Generate pre-rendered pages in the dist directory
-   * await site.buildPrerenderRoutes("dist");
+   * await site.buildPrerenderRoutes("./dist");
+   *
+   * // You can also use a relative path
+   * await site.buildPrerenderRoutes("../dist");
+   *
+   * // Or an absolute path
+   * await site.buildPrerenderRoutes("/var/www/html");
    * ```
    */
   async buildPrerenderRoutes(outputDir: string): Promise<void> {

diff --git a/packages/sapling/src/types/index.ts b/packages/sapling/src/types/index.ts
@@ -21,6 +21,10 @@ export interface LayoutProps {
    * Whether to disable the tailwind reset
    */
   disableTailwindReset?: boolean;
+  /**
+   * Whether to enable Sapling Islands functionality
+   */
+  enableIslands?: boolean;
   /**
    * The head content
    */
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		export const SAPLING_VERSION = "0.3.1";
		export const SAPLING_VERSION = "0.4.0";