@rocket/js 0.1.2 → 0.2.0

package/dist-types/src/menus/MainMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MainMenu.d.ts","sourceRoot":"","sources":["../../../src/menus/MainMenu.js"],"names":[],"mappings":"AAIA;IACE;;;;;;;MAGE;IA4CF,uCAIE;IA5CA,qDAAqD;IAErD,UAFW,OAAO,qBAAqB,EAAE,QAAQ,CAExB;IACzB,oBAAqB;IAGvB,2DAOC;IAED;;;;OAIG;IACH,WAJW,OAAO,qBAAqB,EAAE,QAAQ,UACtC,MAAM,GACJ,OAAO,KAAK,EAAE,cAAc,CAoBxC;CAOF;2BAzDqC,KAAK"}
+{"version":3,"file":"MainMenu.d.ts","sourceRoot":"","sources":["../../../src/menus/MainMenu.js"],"names":[],"mappings":"AAIA;IACE;;;;;;;MAGE;IAkDF,uCAIE;IAlDA,qDAAqD;IAErD,UAFW,OAAO,qBAAqB,EAAE,QAAQ,CAExB;IACzB,oBAAqB;IAGvB,2DAOC;IAED;;;;OAIG;IACH,WAJW,OAAO,qBAAqB,EAAE,QAAQ,UACtC,MAAM,GACJ,OAAO,KAAK,EAAE,cAAc,CA0BxC;CAOF;2BA/DqC,KAAK"}

package/dist-types/src/{development-page-module-loader.d.ts → page-module-loader.d.ts}

@@ -1,5 +1,10 @@
 /** @typedef {import('./page-runtime.js').PageModuleLoaderOptions} PageModuleLoaderOptions */
-export function createDevelopmentPageModuleLoader(): {
+/**
+ * The Page Module Loader used by both the development server and static builds.
+ * Loading goes through Rocket's import hooks, which behave the same in both
+ * runtime environments.
+ */
+export function createPageModuleLoader(): {
     /**
      * @param {PageModuleLoaderOptions} options
      */
@@ -12,4 +17,4 @@ export function createDevelopmentPageModuleLoader(): {
     }>;
 };
 export type PageModuleLoaderOptions = import("./page-runtime.js").PageModuleLoaderOptions;
-//# sourceMappingURL=development-page-module-loader.d.ts.map
+//# sourceMappingURL=page-module-loader.d.ts.map

package/dist-types/src/page-module-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-module-loader.d.ts","sourceRoot":"","sources":["../../src/page-module-loader.js"],"names":[],"mappings":"AAGA,6FAA6F;AAE7F;;;;GAIG;AACH;IAEI;;OAEG;4BADQ,uBAAuB;;;;;;;EAoBrC;sCA9Ba,OAAO,mBAAmB,EAAE,uBAAuB"}

package/dist-types/src/page-runtime.d.ts

@@ -71,6 +71,17 @@ export class PageRuntime {
     render(request: Request, { adapterContext }?: {
         adapterContext?: unknown;
     }): Promise<Response>;
+    /**
+     * Development falls back to the request origin so Page Feeds work before a
+     * Site Origin is configured; builds always pass the configured Site Origin.
+     *
+     * @param {{ page: Page; routePath: string }} feedMatch
+     * @param {string} requestOrigin
+     */
+    renderPageFeed(feedMatch: {
+        page: Page;
+        routePath: string;
+    }, requestOrigin: string): Response;
 }
 export type PageRegistry = import("@rocket/js/types.js").PageRegistry;
 export type Page = {

package/dist-types/src/page-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-runtime.d.ts","sourceRoot":"","sources":["../../src/page-runtime.js"],"names":[],"mappings":"AAmTA;;;GAGG;AACH,sDAHW,OAAO,GACL,QAAQ,CAepB;AA5TD,yEAAyE;AACzE,iKAAiK;AACjK,2IAA2I;AAC3I,kFAAkF;AAClF,mFAAmF;AACnF,wFAAwF;AACxF,mHAAmH;AACnH,2HAA2H;AAC3H,qFAAqF;AACrF,6EAA6E;AAC7E,mFAAmF;AAEnF;IACE;;;;OAIG;IACH,kBAJW,oBAAoB,WACpB,MAAM,YACN;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAQ9D;IAHC,2BAAgB;IAChB,uBAAwB;IACxB,8BAAkC;CAErC;AAED;IACE;;;;;;;;;;;;OAYG;IACH,qKAZW;QACN,KAAK,EAAE,YAAY,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,YAAY,CAAC,EAAE,kBAAkB,CAAC;QAClC,gBAAgB,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;QACxE,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,0BAA0B,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,aAAa,CAAC,EAAE,OAAO,qBAAqB,EAAE,mBAAmB,CAAC;QAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,cAAc,CAAC,EAAE,OAAO,YAAY,EAAE,cAAc,CAAC;KACtD,EAsBH;IATC,kDAAkB;IAClB,mCAAwC;IACxC,2EAAgC;IAChC,mFAAwC;IACxC,+BAA4B;IAC5B,4DAA4D;IAC5D,6EAAkC;IAClC,uCAA4C;IAC5C,gEAAoC;IAGtC;;;;OAIG;IACH,gBAJW,OAAO,uBACP;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1B,OAAO,CAAC,QAAQ,CAAC,CA+D7B;CACF;2BAlIa,OAAO,qBAAqB,EAAE,YAAY;mBAC1C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,qBAAqB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;0BAC1I,SAAS,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;yCAC7G;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE;uCACrC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE;+BACxC,0BAA0B,GAAG,wBAAwB;sCACrD;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE;+BACzE;IAAE,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAAE;iCACxF,OAAO,qBAAqB,EAAE,kBAAkB;6BAChD,OAAO,qBAAqB,EAAE,cAAc;mCAC5C,qBAAqB,GAAG,oBAAoB"}
+{"version":3,"file":"page-runtime.d.ts","sourceRoot":"","sources":["../../src/page-runtime.js"],"names":[],"mappings":"AAgWA;;;GAGG;AACH,sDAHW,OAAO,GACL,QAAQ,CAepB;AAxWD,yEAAyE;AACzE,iKAAiK;AACjK,2IAA2I;AAC3I,kFAAkF;AAClF,mFAAmF;AACnF,wFAAwF;AACxF,mHAAmH;AACnH,2HAA2H;AAC3H,qFAAqF;AACrF,6EAA6E;AAC7E,mFAAmF;AAEnF;IACE;;;;OAIG;IACH,kBAJW,oBAAoB,WACpB,MAAM,YACN;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EAQ9D;IAHC,2BAAgB;IAChB,uBAAwB;IACxB,8BAAkC;CAErC;AAED;IACE;;;;;;;;;;;;OAYG;IACH,qKAZW;QACN,KAAK,EAAE,YAAY,CAAC;QACpB,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,YAAY,CAAC,EAAE,kBAAkB,CAAC;QAClC,gBAAgB,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;QACxE,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,0BAA0B,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,aAAa,CAAC,EAAE,OAAO,qBAAqB,EAAE,mBAAmB,CAAC;QAClE,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,cAAc,CAAC,EAAE,OAAO,YAAY,EAAE,cAAc,CAAC;KACtD,EAsBH;IATC,kDAAkB;IAClB,mCAAwC;IACxC,2EAAgC;IAChC,mFAAwC;IACxC,+BAA4B;IAC5B,4DAA4D;IAC5D,6EAAkC;IAClC,uCAA4C;IAC5C,gEAAoC;IAGtC;;;;OAIG;IACH,gBAJW,OAAO,uBACP;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1B,OAAO,CAAC,QAAQ,CAAC,CA2E7B;IAED;;;;;;OAMG;IACH,0BAHW;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,iBACjC,MAAM,YAsBhB;CACF;2BA3Ka,OAAO,qBAAqB,EAAE,YAAY;mBAC1C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,qBAAqB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;0BAC1I,SAAS,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;yCAC7G;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE;uCACrC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE;+BACxC,0BAA0B,GAAG,wBAAwB;sCACrD;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE;+BACzE;IAAE,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAAE;iCACxF,OAAO,qBAAqB,EAAE,kBAAkB;6BAChD,OAAO,qBAAqB,EAAE,cAAc;mCAC5C,qBAAqB,GAAG,oBAAoB"}

package/dist-types/src/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/pages.js"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,+BAJW,MAAM,WACN,MAAM,EAAE,WACR,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,uDA6D7B;2BAtEa,OAAO,qBAAqB,EAAE,YAAY;iCAC1C,OAAO,qBAAqB,EAAE,kBAAkB;iCAChD,OAAO,qBAAqB,EAAE,kBAAkB"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/pages.js"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,+BAJW,MAAM,WACN,MAAM,EAAE,WACR,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,uDAsD7B;2BA/Da,OAAO,qBAAqB,EAAE,YAAY;iCAC1C,OAAO,qBAAqB,EAAE,kBAAkB;iCAChD,OAAO,qBAAqB,EAAE,kBAAkB"}

package/dist-types/src/route-pattern.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Compiling a URLPattern is comparatively expensive and route paths repeat on
+ * every request, so compiled patterns are cached per route path.
+ *
+ * @param {string} routePath
+ * @returns {URLPattern}
+ */
+export function routePattern(routePath: string): URLPattern;
+import { URLPattern } from 'urlpattern-polyfill';
+//# sourceMappingURL=route-pattern.d.ts.map

package/dist-types/src/route-pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-pattern.d.ts","sourceRoot":"","sources":["../../src/route-pattern.js"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wCAHW,MAAM,GACJ,UAAU,CAStB;2BAnB0B,qBAAqB"}

package/dist-types/src/siteDiscoverability.d.ts

@@ -21,6 +21,10 @@ export function createSitemap({ pages, siteOrigin }: {
     siteOrigin: string;
 }): string;
 /**
+ * The Robots File always references the canonical Sitemap URL, even when
+ * Rocket does not generate `sitemap.xml` itself — this is documented behavior
+ * so projects can supply a sitemap through other tooling.
+ *
  * @param {{
  *   pages?: import('@rocket/js/types.js').PageRegistry;
  *   siteOrigin: string;

package/dist-types/src/siteDiscoverability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"siteDiscoverability.d.ts","sourceRoot":"","sources":["../../src/siteDiscoverability.js"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,2EANW;IACN,KAAK,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,qBAAqB,EAAE,oBAAoB,CAAC;CAC5D,QAoBH;AAED;;;;;GAKG;AACH,qDALW;IACN,KAAK,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB,UAeH;AAED;;;;;GAKG;AACH,wDALW;IACN,KAAK,CAAC,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB,UAaH"}
+{"version":3,"file":"siteDiscoverability.d.ts","sourceRoot":"","sources":["../../src/siteDiscoverability.js"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,2EANW;IACN,KAAK,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,qBAAqB,EAAE,oBAAoB,CAAC;CAC5D,QAoBH;AAED;;;;;GAKG;AACH,qDALW;IACN,KAAK,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB,UAeH;AAED;;;;;;;;;GASG;AACH,wDALW;IACN,KAAK,CAAC,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB,UAaH"}

package/dist-types/src/socialPreviewImages.d.ts

@@ -134,9 +134,10 @@ export function createSocialPreviewTemplateData({ metadata, pageMetadata, pathna
 export function captureSocialPreviewImageWithBrowser({ html }: SocialPreviewCaptureOptions): Promise<Buffer<ArrayBufferLike>>;
 /**
  * @param {string} html
+ * @param {import('puppeteer-core').Browser} [existingBrowser] reused across captures; the caller owns closing it
  * @returns {Promise<Buffer>}
  */
-export function renderSocialPreviewImage(html: string): Promise<Buffer>;
+export function renderSocialPreviewImage(html: string, existingBrowser?: import("puppeteer-core").Browser): Promise<Buffer>;
 /**
  * @param {{
  *   platform?: NodeJS.Platform;

package/dist-types/src/socialPreviewImages.d.ts.map

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

package/dist-types/src/static-params.d.ts

@@ -0,0 +1,33 @@
+/** @typedef {import('@rocket/js/types.js').Page} Page */
+/** @typedef {import('@rocket/js/types.js').PageRegistry} PageRegistry */
+/** @typedef {import('@rocket/js/types.js').PageStaticParams} PageStaticParams */
+/** @typedef {import('@rocket/js/types.js').PageStaticParamsDeclaration} PageStaticParamsDeclaration */
+/**
+ * @param {Page} page
+ */
+export function hasStaticParams(page: Page): boolean;
+/**
+ * @param {string} pagePath
+ */
+export function hasPathParameter(pagePath: string): boolean;
+/**
+ * Enumerates the concrete output paths of a parameterized static JavaScript
+ * Page from its `staticParams` export.
+ *
+ * @param {{
+ *   pages: PageRegistry;
+ *   page: Page;
+ *   pagePath: string;
+ * }} options
+ * @returns {string[]}
+ */
+export function staticParamsPagePaths({ pages, page, pagePath }: {
+    pages: PageRegistry;
+    page: Page;
+    pagePath: string;
+}): string[];
+export type Page = import("@rocket/js/types.js").Page;
+export type PageRegistry = import("@rocket/js/types.js").PageRegistry;
+export type PageStaticParams = import("@rocket/js/types.js").PageStaticParams;
+export type PageStaticParamsDeclaration = import("@rocket/js/types.js").PageStaticParamsDeclaration;
+//# sourceMappingURL=static-params.d.ts.map

package/dist-types/src/static-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-params.d.ts","sourceRoot":"","sources":["../../src/static-params.js"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,yEAAyE;AACzE,iFAAiF;AACjF,uGAAuG;AAEvG;;GAEG;AACH,sCAFW,IAAI,WAId;AAED;;GAEG;AACH,2CAFW,MAAM,WAIhB;AAED;;;;;;;;;;GAUG;AACH,iEAPW;IACN,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB,GACS,MAAM,EAAE,CA8BpB;mBA1Da,OAAO,qBAAqB,EAAE,IAAI;2BAClC,OAAO,qBAAqB,EAAE,YAAY;+BAC1C,OAAO,qBAAqB,EAAE,gBAAgB;0CAC9C,OAAO,qBAAqB,EAAE,2BAA2B"}

package/dist-types/src/transform.d.ts

@@ -7,4 +7,8 @@ export function mdToJs(md: string): Promise<string>;
  * @param {string} demo
  */
 export function mdToJsSingleDemo(md: string, demo: string): Promise<string>;
+/**
+ * @param {import('mdast').Code} node
+ */
+export function isDemoCodeNode(node: import("mdast").Code): boolean;
 //# sourceMappingURL=transform.d.ts.map

package/dist-types/src/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/transform.js"],"names":[],"mappings":"AA8BA;;GAEG;AACH,2BAFW,MAAM,mBAoChB;AAED;;;GAGG;AACH,qCAHW,MAAM,QACN,MAAM,mBAwChB"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/transform.js"],"names":[],"mappings":"AA8BA;;GAEG;AACH,2BAFW,MAAM,mBAoChB;AAED;;;GAGG;AACH,qCAHW,MAAM,QACN,MAAM,mBAqChB;AAqSD;;GAEG;AACH,qCAFW,OAAO,OAAO,EAAE,IAAI,WAI9B"}

package/dist-types/src/wds-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wds-plugin.d.ts","sourceRoot":"","sources":["../../src/wds-plugin.js"],"names":[],"mappings":"yBA8BgB,iBAAO,EAAE,4BAAO,EAAE,kDAAY,EAAE,gDAAY,KADmG,OAAO,sBAAsB,EAAE,MAAM;;iCAJtL,OAAO,qBAAqB,EAAE,kBAAkB;2CAChD;IAAE,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,qBAAqB,EAAE,yBAAyB,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,qBAAqB,EAAE,mBAAmB,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,yBAAyB,CAAC,EAAE,OAAO,0BAA0B,EAAE,oBAAoB,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;yCACxZ,4BAA4B,GAAG,kBAAkB"}
+{"version":3,"file":"wds-plugin.d.ts","sourceRoot":"","sources":["../../src/wds-plugin.js"],"names":[],"mappings":"yBAkCgB,iBAAO,EAAE,4BAAO,EAAE,kDAAY,EAAE,gDAAY,KADmG,OAAO,sBAAsB,EAAE,MAAM;;iCAJtL,OAAO,qBAAqB,EAAE,kBAAkB;2CAChD;IAAE,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,qBAAqB,EAAE,yBAAyB,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,qBAAqB,EAAE,mBAAmB,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,yBAAyB,CAAC,EAAE,OAAO,0BAA0B,EAAE,oBAAoB,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE;yCACxZ,4BAA4B,GAAG,kBAAkB"}

package/exports/layouts/atlasBlog.js

@@ -0,0 +1,11 @@
+export {
+  atlasBlogComponents,
+  atlasBlogIndexLayout,
+  atlasPostLayout,
+  blogTagPath,
+  formatBlogDate,
+  renderBlogByline,
+  renderBlogPagination,
+  renderBlogPostList,
+  renderBlogTags,
+} from '../../src/layouts/atlas/atlasBlogLayout.js';

package/exports/types/rocket.test.ts

@@ -0,0 +1,26 @@
+import { html } from 'lit';
+import type { AtlasLayoutHeadContent, BlogData, DocData, HeroData } from './rocket.js';
+
+const pageAwareHeadContent: AtlasLayoutHeadContent = ({ pageData }) =>
+  html`<meta name="page-url" content=${pageData.url} />`;
+
+const siteWideHeadContent: AtlasLayoutHeadContent = () =>
+  html`<meta name="site-extension" content="enabled" />`;
+
+function sharedAtlasHeadContent(data: DocData | HeroData | BlogData) {
+  return data.headContent;
+}
+
+// @ts-expect-error Atlas Layout Head Content requires a Lit template result.
+const rawStringHeadContent: AtlasLayoutHeadContent = () => '<meta name="raw-string" />';
+
+// @ts-expect-error Atlas Layout Head Content is synchronous.
+const asyncHeadContent: AtlasLayoutHeadContent = async () => html`<meta name="async" />`;
+
+export {
+  asyncHeadContent,
+  pageAwareHeadContent,
+  rawStringHeadContent,
+  sharedAtlasHeadContent,
+  siteWideHeadContent,
+};

package/exports/types/rocket.ts

@@ -322,6 +322,8 @@ export type JsPage = (
 export type Module = {
   config: PageConfig;
   pagination?: PagePaginationDeclaration;
+  feed?: PageFeedDeclaration;
+  staticParams?: PageStaticParamsDeclaration;
   components?: Components;
   _$title$?: string;
   _$menuLinkText$?: string;
@@ -411,6 +413,37 @@ export type PagePagination = {
   previousPath?: string;
 };
 
+export type PageFeedConfig = {
+  /**
+   * Feed display title.
+   */
+  title: string;
+  /**
+   * Optional feed subtitle text.
+   */
+  description?: string;
+  /**
+   * Page Collection entries included as feed entries, in collection order.
+   */
+  collection: PageCollectionEntry[];
+  /**
+   * Optional maximum number of feed entries taken from the start of the collection.
+   */
+  limit?: number;
+};
+
+export type PageFeedDeclaration = PageFeedConfig | ((pageData: PageData) => PageFeedConfig);
+
+/**
+ * Concrete param values for one generated output document of a parameterized static
+ * JavaScript Page. Every route param in the Page path must be present.
+ */
+export type PageStaticParams = Record<string, string>;
+
+export type PageStaticParamsDeclaration =
+  | PageStaticParams[]
+  | ((pageData: PageData) => PageStaticParams[]);
+
 export type PageRegistrySortDirection = 'asc' | 'desc';
 
 export type PageRegistryQueryOptions = {
@@ -569,7 +602,24 @@ export type WorkflowData = {
   steps: WorkflowStep[];
 };
 
-export type HeroData = {
+export type AtlasLayoutHeadContentContext = {
+  /** The current PageData for this Page render. */
+  pageData: PageData;
+};
+
+/**
+ * Returns trusted Site Author markup appended after Atlas-owned document head content.
+ */
+export type AtlasLayoutHeadContent = (context: AtlasLayoutHeadContentContext) => TemplateResult;
+
+type AtlasLayoutHeadContentData = {
+  /**
+   * Trusted Site Author markup evaluated once and appended after Atlas-owned document head content.
+   */
+  headContent?: AtlasLayoutHeadContent;
+};
+
+export type HeroData = AtlasLayoutHeadContentData & {
   headerData: HeaderData;
   footerData: FooterSection[];
   /**
@@ -584,13 +634,31 @@ export type HeroData = {
   secondaryLinksData?: FooterLink[];
 };
 
+export type BlogData = AtlasLayoutHeadContentData & {
+  headerData: HeaderData;
+  /**
+   * Project-owned stylesheet URLs loaded after the package Atlas layout stylesheets.
+   */
+  stylesheets?: string[];
+  /**
+   * Site-root path prefix for tag archive links, e.g. '/blog/tags/'. Tags render as
+   * plain text when omitted.
+   */
+  tagPathPrefix?: string;
+  /**
+   * Site-root path of the blog's Page Feed, e.g. '/blog/feed.xml'. Adds a feed
+   * alternate link to the document head and a visible feed link on the index.
+   */
+  feedPath?: string;
+};
+
 export type AtlasDocAsideTip = {
   title?: string;
   description: string;
   iconName?: string;
 };
 
-export type DocData = {
+export type DocData = AtlasLayoutHeadContentData & {
   headerData: HeaderData;
   footerData: FooterSection[];
   /**

package/exports/types.ts

@@ -1,5 +1,8 @@
 export type {
+  AtlasLayoutHeadContent,
+  AtlasLayoutHeadContentContext,
   AtlasDocAsideTip,
+  BlogData,
   Components,
   DocData,
   Feature,
@@ -27,6 +30,8 @@ export type {
   PageCollectionEntry,
   PageDiscoverabilityConfig,
   PageConfig,
+  PageFeedConfig,
+  PageFeedDeclaration,
   PageMetadata,
   PageMetadataConfig,
   PageMetadataCustom,
@@ -38,6 +43,8 @@ export type {
   PageRegistryQuery,
   PageRegistryQueryOptions,
   PageRegistrySortDirection,
+  PageStaticParams,
+  PageStaticParamsDeclaration,
   PageTree,
   PackageIconLibrarySource,
   PathIconLibrarySource,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocket/js",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "HTML-first static-site metaframework for content sites and Web Component docs.",
   "license": "MIT",
   "type": "module",
@@ -16,6 +16,7 @@
       "types": "./dist-types/exports/*",
       "default": "./exports/*"
     },
+    "./layouts/atlasBlog.css": "./src/layouts/atlas/atlasBlog.css",
     "./layouts/atlasDoc.css": "./src/layouts/atlas/atlasDoc.css",
     "./layouts/atlasHero.css": "./src/layouts/atlas/atlasHero.css",
     "./layouts/atlasNotFound.css": "./src/layouts/atlas/atlasNotFound.css",
@@ -51,7 +52,7 @@
     "build": "rm -rf dist && npx rocket build",
     "build:start": "npx http-server dist -o",
     "ai:do": "node scripts/codex-issue-loop.js",
-    "ai:do:loop": "node scripts/codex-issue-loop.js --max 6",
+    "ai:do-loop": "node scripts/codex-issue-loop.js --max 6",
     "ai:check": "node scripts/codex-issue-loop.js --dry-run",
     "lint": "eslint . --ignore-pattern .gitignore && prettier \"**/*.{ts,js,json,md}\" --check --ignore-path .gitignore --ignore-path .prettierignore",
     "format": "eslint . --ignore-pattern .gitignore --fix && prettier \"**/*.{ts,js,json,md}\" --write --ignore-path .gitignore --ignore-path .prettierignore",
@@ -65,31 +66,19 @@
     "prepack": "npm run types",
     "release": "changeset publish"
   },
-  "eslintConfig": {
-    "overrides": [
-      {
-        "files": [
-          "*.demo.js"
-        ],
-        "rules": {
-          "no-console": "off"
-        }
-      }
-    ]
-  },
   "bin": {
     "rocket": "src/cli/cli.js"
   },
   "dependencies": {
     "@awesome.me/webawesome": "^3.7.0",
     "@lit-labs/ssr": "^4.1.0",
-    "@sparticuz/chromium": "^148.0.0",
+    "@sparticuz/chromium": "^149.0.0",
     "@web/dev-server": "^0.4.6",
     "bootstrap-icons": "^1.13.1",
-    "commander": "14.0.3",
+    "commander": "^15.0.0",
     "es-module-lexer": "^2.1.0",
     "lit": "^3.3.3",
-    "parse5": "^7.3.0",
+    "parse5": "^8.0.1",
     "puppeteer-core": "^25.1.0",
     "rehype-autolink-headings": "^7.1.0",
     "rehype-prism-plus": "^2.0.2",
@@ -98,40 +87,33 @@
     "rehype-stringify": "^10.0.1",
     "remark-gfm": "^4.0.1",
     "remark-rehype": "^11.1.2",
-    "typescript": "6.0.3",
+    "typescript": "^6.0.3",
     "unified": "^11.0.5",
-    "unist-util-inspect": "8.1.0",
     "unist-util-remove": "^4.0.0",
     "unist-util-visit": "^5.1.0",
-    "urlpattern-polyfill": "10.1.0",
+    "urlpattern-polyfill": "^10.1.0",
     "vite": "^8.0.14"
   },
   "devDependencies": {
     "@changesets/cli": "^2.31.0",
     "@eslint/eslintrc": "^3.3.5",
     "@eslint/js": "^10.0.1",
-    "@netlify/functions": "^5.2.2",
     "@open-wc/testing": "^4.0.0",
     "@types/hast": "^3.0.4",
-    "@types/mdast": "4.0.4",
-    "@types/node": "^24.12.4",
+    "@types/mdast": "^4.0.4",
+    "@types/node": "^24.13.3",
     "@typescript-eslint/eslint-plugin": "^8.59.4",
     "@typescript-eslint/parser": "^8.59.4",
-    "@web/mocks": "^2.0.0",
     "@web/test-runner": "^0.20.2",
-    "@web/test-runner-playwright": "^0.11.1",
-    "dotenv": "^17.4.2",
     "eslint": "^10.4.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-no-only-tests": "^3.4.0",
     "globals": "^17.6.0",
     "netlify-cli": "^26.0.2",
-    "patch-package": "^8.0.1",
     "prettier": "^3.8.3",
     "prettier-plugin-packagejson": "^3.0.2",
-    "typescript": "6.0.3",
     "typescript-eslint": "^8.59.4",
-    "vfile": "6.0.3",
+    "vfile": "^6.0.3",
     "wireit": "^0.14.12"
   },
   "engines": {
@@ -145,7 +127,7 @@
   },
   "wireit": {
     "deploy": {
-      "command": "rm -f ../../node_modules/ssh2/lib/protocol/crypto/build/Release/sshcrypto.node && netlify deploy --prod --site 2439aca3-b7d1-495c-bb8a-478ce089b666 --no-build",
+      "command": "netlify deploy --prod --site 2439aca3-b7d1-495c-bb8a-478ce089b666 --no-build",
       "files": [
         "dist/**/*"
       ],
@@ -159,7 +141,8 @@
       "command": "tsc --build --pretty",
       "files": [
         "src/**/*",
-        "types/**/*",
+        "exports/**/*",
+        "docs/**/*.js",
         "tsconfig.json"
       ],
       "output": [
@@ -186,6 +169,7 @@
       "files": [
         "exports/**/*",
         "src/**/*",
+        "scripts/**/*.js",
         "!src/**/*.test-browser.js"
       ],
       "output": []

package/src/PageData.js

@@ -26,11 +26,14 @@ export class PageData {
     url,
     { siteHeadMetadata, pageSiteHeadMetadata, defaultSocialPreviewImage, siteOrigin } = {},
   ) {
-    const pageMetadata = typeof metadata === 'string' ? { title: metadata } : metadata;
+    // Copy so layout/page writes (e.g. the title setter) never mutate the
+    // shared Page Registry across renders.
+    const pageMetadata = typeof metadata === 'string' ? { title: metadata } : { ...metadata };
     this.pageRegistry = pageRegistry;
     /** @type {import('@rocket/js/types.js').PageRegistryQuery} */
     this.pages = new PageRegistryQuery(pageRegistry);
-    this.pageTree = treeFromPages(pageRegistry);
+    /** @type {import('@rocket/js/types.js').PageTree | undefined} */
+    this._pageTree = undefined;
     this._clientCode = '';
     this._hydrationScript = '';
     /** @type {boolean} */
@@ -64,6 +67,13 @@ export class PageData {
         : undefined;
   }
 
+  get pageTree() {
+    if (!this._pageTree) {
+      this._pageTree = treeFromPages(this.pageRegistry);
+    }
+    return this._pageTree;
+  }
+
   get title() {
     return this.metadata.title;
   }

package/src/RocketJsDemo.js

@@ -250,6 +250,7 @@ export class RocketJsDemo extends LitElement {
         background-color: #eee;
         width: 100%;
         overflow: hidden;
+        z-index: 0;
       }
 
       #resize {

package/src/SocialPreviewPlayground.js

@@ -3,6 +3,7 @@ import {
   DEFAULT_SOCIAL_PREVIEW_IMAGE_WIDTH,
   defaultSocialPreviewTemplate,
 } from './defaultSocialPreviewTemplate.js';
+import { debounce } from './debounce.js';
 
 const DEFAULT_TITLE = 'Runtime Guide';
 const DEFAULT_DESCRIPTION = 'Learn how Acme UI components load, render, and ship with Rocket.';
@@ -81,22 +82,23 @@ export class SocialPreviewPlayground extends HTMLElement {
     this.templateFrame = null;
     /** @type {HTMLAnchorElement | null} */
     this.pngLink = null;
+    // Typing reloads the preview iframe and rewrites history, so batch keystrokes.
+    this.schedulePreviewUpdate = debounce(() => this.updatePreviewResources(), 150);
   }
 
   connectedCallback() {
-    if (this.shadowRoot) {
-      return;
+    if (!this.shadowRoot) {
+      this.config = this.readConfig();
+      this.state = this.initialState(this.config);
+      this.attachShadow({ mode: 'open' });
+      this.render();
+      this.connectControls();
+      this.updatePreviewResources();
     }
-    this.config = this.readConfig();
-    this.state = this.initialState(this.config);
-    const shadowRoot = this.attachShadow({ mode: 'open' });
-    this.render();
-    this.connectControls();
-    this.updatePreviewResources();
     this.resizePreviewFrame();
-    const frame = shadowRoot.querySelector('[data-social-preview-frame-shell]');
+    const frame = this.shadowRoot?.querySelector('[data-social-preview-frame-shell]');
     if (frame && 'ResizeObserver' in window) {
-      this.resizeObserver = new ResizeObserver(() => this.resizePreviewFrame());
+      this.resizeObserver ??= new ResizeObserver(() => this.resizePreviewFrame());
       this.resizeObserver.observe(frame);
     }
   }
@@ -160,8 +162,8 @@ export class SocialPreviewPlayground extends HTMLElement {
     const page = config.pages.find(candidate => candidate.path === config.selectedPath);
     return {
       selectedPath: page?.path ?? config.selectedPath,
-      title: config.defaultTitle || page?.title || DEFAULT_TITLE,
-      description: config.defaultDescription || page?.description || DEFAULT_DESCRIPTION,
+      title: page?.title || config.defaultTitle,
+      description: page?.description || config.defaultDescription,
     };
   }
 
@@ -423,11 +425,11 @@ export class SocialPreviewPlayground extends HTMLElement {
     });
     titleInput?.addEventListener('input', () => {
       this.state.title = titleInput.value;
-      this.updatePreviewResources();
+      this.schedulePreviewUpdate();
     });
     descriptionInput?.addEventListener('input', () => {
       this.state.description = descriptionInput.value;
-      this.updatePreviewResources();
+      this.schedulePreviewUpdate();
     });
     shadowRoot
       .querySelector('button[data-social-preview-previous-page]')
@@ -506,7 +508,11 @@ export class SocialPreviewPlayground extends HTMLElement {
       return;
     }
     if (this.config.templateUrl) {
-      this.templateFrame.src = this.socialPreviewResourcePath(this.config.templateUrl);
+      const templateSrc = this.socialPreviewResourcePath(this.config.templateUrl);
+      // assigning an unchanged src still reloads the iframe, so compare first
+      if (this.templateFrame.getAttribute('src') !== templateSrc) {
+        this.templateFrame.src = templateSrc;
+      }
     } else {
       this.templateFrame.srcdoc = this.previewHtml();
     }
@@ -515,11 +521,11 @@ export class SocialPreviewPlayground extends HTMLElement {
       this.pngLink.download = this.selectedPage()?.downloadFilename ?? 'social-preview.png';
     }
     if (this.config.syncHistory && this.config.workflowUrl) {
-      window.history.replaceState(
-        null,
-        '',
-        this.socialPreviewResourcePath(this.config.workflowUrl),
-      );
+      const workflowPath = this.socialPreviewResourcePath(this.config.workflowUrl);
+      const currentPath = `${window.location.pathname}${window.location.search}`;
+      if (workflowPath !== currentPath) {
+        window.history.replaceState(null, '', workflowPath);
+      }
     }
   }
 

package/src/asyncMessage.js

@@ -3,6 +3,11 @@
 
 /**
  * Turns a MessagePort into an AsyncPort, which can wait for responses.
+ *
+ * Do not use sendAndWait from inside module customization hooks: the main
+ * thread may be blocked in Atomics.wait (e.g. during a nested
+ * module.register() call) and unable to reply, which deadlocks the hook.
+ *
  * @param {MessagePort} port
  * @returns {AsyncPort}
  */
@@ -13,9 +18,10 @@ export function makeAsyncPort(port) {
     p._wait.resolve(message);
     p._wait = Promise.withResolvers();
   });
-  p.sendAndWait = async message => {
+  p.sendAndWait = message => {
+    const wait = p._wait;
     p.postMessage(message);
-    return p._wait;
+    return wait.promise;
   };
   return p;
 }