@cmssy/next 11.6.0 → 11.8.0

package/dist/{index-B64zk2X7.d.cts → index-BCHSAhKJ.d.cts}

@@ -15,15 +15,6 @@ interface CmssyEditorProps {
     resolvedContent?: Record<string, Record<string, unknown>>;
     appContext?: Record<string, unknown>;
 }
-/**
- * What the app wants its blocks to see, beyond the content: a signed-in member,
- * a feature flag, the active path. Given a function it is called per request
- * with the page being rendered, which is the useful form - a value fixed at
- * module scope cannot vary by visitor.
- *
- * Whatever it returns lands on `context.app`, untouched, on the deployed page
- * and in the editor alike.
- */
 type CmssyAppContext = Record<string, unknown> | ((args: {
     page: CmssyPageData;
     locale: string;
@@ -42,23 +33,7 @@ interface CatchAllProps {
     params?: Promise<CatchAllParams>;
     searchParams?: Promise<SearchParams>;
 }
-/**
- * Public catch-all page. Statically renderable: it never reads
- * `searchParams` or `headers()` - awaiting either forces every route
- * dynamic and kills ISR (CMS-952). Draft-mode preview (the authenticated
- * /api/draft cookie) still works per-request via `draftMode()`, which is
- * static-safe, and renders draft CONTENT without the editor (CMS-948).
- * The editor-iframe flow (`?cmssyEdit=1&cmssySecret=...`) is served by
- * the middleware rewrite (`cmssyEditRewrite`) onto the dynamic edit route
- * mounted with `createCmssyEditPage`.
- */
 declare function createCmssyPage(config: CmssyConfig, blocks: BlockDefinition[], options?: CreateCmssyPageOptions): ({ params, searchParams, }: CatchAllProps) => Promise<react_jsx_runtime.JSX.Element>;
-/**
- * Editor page for the middleware-rewritten edit route
- * (`app/cmssy-edit/[[...path]]/page.tsx`, `dynamic = "force-dynamic"`).
- * Re-verifies the `cmssyEdit` + `cmssySecret` pair itself, so a direct hit
- * on the route path (bypassing the middleware) cannot mount the editor.
- */
 declare function createCmssyEditPage(config: CmssyConfig, blocks: BlockDefinition[], options?: CreateCmssyPageOptions): ({ params, searchParams, }: CatchAllProps) => Promise<react_jsx_runtime.JSX.Element>;
 
 export { type CmssyAppContext as C, type CmssyEditorProps as a, type CreateCmssyPageOptions as b, createCmssyEditPage as c, createCmssyPage as d };

package/dist/{index-B64zk2X7.d.ts → index-BCHSAhKJ.d.ts}

@@ -15,15 +15,6 @@ interface CmssyEditorProps {
     resolvedContent?: Record<string, Record<string, unknown>>;
     appContext?: Record<string, unknown>;
 }
-/**
- * What the app wants its blocks to see, beyond the content: a signed-in member,
- * a feature flag, the active path. Given a function it is called per request
- * with the page being rendered, which is the useful form - a value fixed at
- * module scope cannot vary by visitor.
- *
- * Whatever it returns lands on `context.app`, untouched, on the deployed page
- * and in the editor alike.
- */
 type CmssyAppContext = Record<string, unknown> | ((args: {
     page: CmssyPageData;
     locale: string;
@@ -42,23 +33,7 @@ interface CatchAllProps {
     params?: Promise<CatchAllParams>;
     searchParams?: Promise<SearchParams>;
 }
-/**
- * Public catch-all page. Statically renderable: it never reads
- * `searchParams` or `headers()` - awaiting either forces every route
- * dynamic and kills ISR (CMS-952). Draft-mode preview (the authenticated
- * /api/draft cookie) still works per-request via `draftMode()`, which is
- * static-safe, and renders draft CONTENT without the editor (CMS-948).
- * The editor-iframe flow (`?cmssyEdit=1&cmssySecret=...`) is served by
- * the middleware rewrite (`cmssyEditRewrite`) onto the dynamic edit route
- * mounted with `createCmssyEditPage`.
- */
 declare function createCmssyPage(config: CmssyConfig, blocks: BlockDefinition[], options?: CreateCmssyPageOptions): ({ params, searchParams, }: CatchAllProps) => Promise<react_jsx_runtime.JSX.Element>;
-/**
- * Editor page for the middleware-rewritten edit route
- * (`app/cmssy-edit/[[...path]]/page.tsx`, `dynamic = "force-dynamic"`).
- * Re-verifies the `cmssyEdit` + `cmssySecret` pair itself, so a direct hit
- * on the route path (bypassing the middleware) cannot mount the editor.
- */
 declare function createCmssyEditPage(config: CmssyConfig, blocks: BlockDefinition[], options?: CreateCmssyPageOptions): ({ params, searchParams, }: CatchAllProps) => Promise<react_jsx_runtime.JSX.Element>;
 
 export { type CmssyAppContext as C, type CmssyEditorProps as a, type CreateCmssyPageOptions as b, createCmssyEditPage as c, createCmssyPage as d };

package/dist/index.cjs

@@ -20,6 +20,10 @@ Object.defineProperty(exports, "CMSSY_SECRET_QUERY_PARAM", {
   enumerable: true,
   get: function () { return core.CMSSY_SECRET_QUERY_PARAM; }
 });
+Object.defineProperty(exports, "CmssyWebhookError", {
+  enumerable: true,
+  get: function () { return core.CmssyWebhookError; }
+});
 Object.defineProperty(exports, "DEFAULT_CMSSY_EDITOR_ORIGINS", {
   enumerable: true,
   get: function () { return core.DEFAULT_CMSSY_EDITOR_ORIGINS; }
@@ -36,3 +40,7 @@ Object.defineProperty(exports, "resolveEditorOrigin", {
   enumerable: true,
   get: function () { return core.resolveEditorOrigin; }
 });
+Object.defineProperty(exports, "verifyCmssyWebhook", {
+  enumerable: true,
+  get: function () { return core.verifyCmssyWebhook; }
+});

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_LOCALE_HEADER, CMSSY_SECRET_QUERY_PARAM, CmssyConfig, CmssyEnvConfig, CmssyPageData, CmssyPageMeta, CmssyPageSummary, DEFAULT_CMSSY_EDITOR_ORIGINS, defineCmssyConfig, localizeHref, resolveEditorOrigin } from '@cmssy/core';
-export { C as CmssyAppContext, a as CmssyEditorProps, b as CreateCmssyPageOptions } from './index-B64zk2X7.cjs';
+export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_LOCALE_HEADER, CMSSY_SECRET_QUERY_PARAM, CmssyConfig, CmssyEnvConfig, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyWebhookError, CmssyWebhookEvent, DEFAULT_CMSSY_EDITOR_ORIGINS, VerifyCmssyWebhookOptions, defineCmssyConfig, localizeHref, resolveEditorOrigin, verifyCmssyWebhook } from '@cmssy/core';
+export { C as CmssyAppContext, a as CmssyEditorProps, b as CreateCmssyPageOptions } from './index-BCHSAhKJ.cjs';
 import 'react/jsx-runtime';
 import 'react';
 import '@cmssy/react';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_LOCALE_HEADER, CMSSY_SECRET_QUERY_PARAM, CmssyConfig, CmssyEnvConfig, CmssyPageData, CmssyPageMeta, CmssyPageSummary, DEFAULT_CMSSY_EDITOR_ORIGINS, defineCmssyConfig, localizeHref, resolveEditorOrigin } from '@cmssy/core';
-export { C as CmssyAppContext, a as CmssyEditorProps, b as CreateCmssyPageOptions } from './index-B64zk2X7.js';
+export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_LOCALE_HEADER, CMSSY_SECRET_QUERY_PARAM, CmssyConfig, CmssyEnvConfig, CmssyPageData, CmssyPageMeta, CmssyPageSummary, CmssyWebhookError, CmssyWebhookEvent, DEFAULT_CMSSY_EDITOR_ORIGINS, VerifyCmssyWebhookOptions, defineCmssyConfig, localizeHref, resolveEditorOrigin, verifyCmssyWebhook } from '@cmssy/core';
+export { C as CmssyAppContext, a as CmssyEditorProps, b as CreateCmssyPageOptions } from './index-BCHSAhKJ.js';
 import 'react/jsx-runtime';
 import 'react';
 import '@cmssy/react';

package/dist/index.js

@@ -1 +1 @@
-export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_LOCALE_HEADER, CMSSY_SECRET_QUERY_PARAM, DEFAULT_CMSSY_EDITOR_ORIGINS, defineCmssyConfig, localizeHref, resolveEditorOrigin } from '@cmssy/core';
+export { CMSSY_EDIT_HEADER, CMSSY_EDIT_QUERY_PARAM, CMSSY_LOCALE_HEADER, CMSSY_SECRET_QUERY_PARAM, CmssyWebhookError, DEFAULT_CMSSY_EDITOR_ORIGINS, defineCmssyConfig, localizeHref, resolveEditorOrigin, verifyCmssyWebhook } from '@cmssy/core';

package/dist/middleware.cjs

@@ -75,9 +75,6 @@ function createCmssyProxy(config, options = {}) {
         response.cookies.set(write.name, write.value, {
           ...DEFAULT_COOKIE_OPTIONS,
           ...write.options,
-          // Deletion wins over the caller's options. They will be the same
-          // options the cookie was written with, maxAge included, and honoring
-          // that here would keep an emptied cookie alive instead of removing it.
           ...write.value ? {} : { maxAge: 0 }
         });
       }

package/dist/middleware.d.cts

@@ -2,90 +2,24 @@ import { NextResponse, NextRequest } from 'next/server';
 import { CmssyConfig } from '@cmssy/core';
 export { CMSSY_EDIT_HEADER, CmssyCspOptions, applyCmssyCsp } from '@cmssy/core';
 
-/** A cookie the proxy writes on this request. An empty value deletes it. */
 interface CmssyProxyCookie {
     name: string;
     value: string;
-    /** Passed to `response.cookies.set`; defaults to httpOnly + sameSite lax. */
     options?: Omit<Parameters<NextResponse["cookies"]["set"]>[2], "name" | "value">;
 }
 interface CmssyProxyOptions {
-    /**
-     * Strip the language prefix before the app sees it, so static routes like
-     * `/shop/cart` serve `/no/shop/cart` too. Leave it off for a catch-all app
-     * that reads the language off the path itself.
-     */
     stripLocalePrefix?: boolean;
-    /**
-     * Cookies this request has to write - a refreshed session, a freshly minted
-     * cart id. They are set on the response AND merged into the cookie header the
-     * app is about to be rendered with, so THIS render already sees them; setting
-     * them on the response alone means the value only arrives on the next
-     * navigation, which is how a signed-in visitor renders signed-out once.
-     *
-     * It is the escape hatch that keeps an app from re-implementing the whole
-     * preset - locale, edit rewrite and CSP included - to add one cookie.
-     */
     cookies?: (request: NextRequest) => Promise<CmssyProxyCookie[]> | CmssyProxyCookie[];
 }
-/**
- * The whole middleware a cmssy app needs, in the order it has to happen:
- *
- *   1. resolve the language and pass it on (a route cannot read the prefix it
- *      never sees);
- *   2. send a VERIFIED editor request to /cmssy-edit, carrying that language and
- *      the edit flag - the public pages are static, and a static page never sees
- *      the query string that would put it in edit mode;
- *   3. strip the language prefix for everything else, if asked.
- *
- * The order is not a detail: resolve the locale after the rewrite and the editor
- * preview renders in the wrong language; forget the edit flag and the header and
- * footer become markup the editor can select but not fill. Both mistakes shipped
- * before this existed.
- */
 declare function createCmssyProxy(config: CmssyConfig, options?: CmssyProxyOptions): (request: NextRequest) => Promise<NextResponse>;
-/**
- * The matcher a cmssy app wants: everything except Next internals, API routes
- * and files with an extension.
- *
- * Next parses `export const config` at COMPILE time, so it rejects an imported
- * constant - copy this value into your proxy literally:
- *
- *   export const config = { matcher: ["/((?!_next/|api/|.*\\..*).*)"] };
- */
 declare const cmssyProxyMatcher: string[];
 
-/**
- * Where the middleware rewrites editor-preview traffic. Mount the matching
- * dynamic route in the consumer app:
- *
- *   app/cmssy-edit/[[...path]]/page.tsx
- *     export const dynamic = "force-dynamic";
- *     export default createCmssyEditPage(cmssy, blocks, { editor: Editor });
- */
 declare const CMSSY_EDIT_PATH_PREFIX = "/cmssy-edit";
-/**
- * Rewrite VERIFIED editor requests (`cmssyEdit=1` + a `cmssySecret` matching
- * the site's draft secret, CMS-948) onto the dedicated dynamic edit route, so
- * the public catch-all can stay fully static. A static page never sees its
- * query string - this rewrite is what makes the editor iframe work at all
- * once ISR is on. Draft-mode preview (the authenticated /api/draft cookie) is
- * NOT rewritten: it renders draft content on the public route via
- * `draftMode()`, without the editor. Returns null for normal traffic so it
- * composes with other middleware.
- */
 declare function cmssyEditRewrite(request: NextRequest, config: {
     draftSecret: string;
 }, options?: {
-    /**
-     * Headers to forward to the edit route, for a site whose middleware tells
-     * the app something the path alone does not - a resolved locale, say.
-     * Without them the editor preview renders in the default language while the
-     * public page renders in the visitor's.
-     */
     requestHeaders?: Headers;
 }): Promise<NextResponse | null>;
-/** Standalone middleware when the consumer has no other middleware to compose. */
 declare function createCmssyEditMiddleware(config: {
     draftSecret: string;
 }): (request: NextRequest) => Promise<NextResponse>;

package/dist/middleware.d.ts

@@ -2,90 +2,24 @@ import { NextResponse, NextRequest } from 'next/server';
 import { CmssyConfig } from '@cmssy/core';
 export { CMSSY_EDIT_HEADER, CmssyCspOptions, applyCmssyCsp } from '@cmssy/core';
 
-/** A cookie the proxy writes on this request. An empty value deletes it. */
 interface CmssyProxyCookie {
     name: string;
     value: string;
-    /** Passed to `response.cookies.set`; defaults to httpOnly + sameSite lax. */
     options?: Omit<Parameters<NextResponse["cookies"]["set"]>[2], "name" | "value">;
 }
 interface CmssyProxyOptions {
-    /**
-     * Strip the language prefix before the app sees it, so static routes like
-     * `/shop/cart` serve `/no/shop/cart` too. Leave it off for a catch-all app
-     * that reads the language off the path itself.
-     */
     stripLocalePrefix?: boolean;
-    /**
-     * Cookies this request has to write - a refreshed session, a freshly minted
-     * cart id. They are set on the response AND merged into the cookie header the
-     * app is about to be rendered with, so THIS render already sees them; setting
-     * them on the response alone means the value only arrives on the next
-     * navigation, which is how a signed-in visitor renders signed-out once.
-     *
-     * It is the escape hatch that keeps an app from re-implementing the whole
-     * preset - locale, edit rewrite and CSP included - to add one cookie.
-     */
     cookies?: (request: NextRequest) => Promise<CmssyProxyCookie[]> | CmssyProxyCookie[];
 }
-/**
- * The whole middleware a cmssy app needs, in the order it has to happen:
- *
- *   1. resolve the language and pass it on (a route cannot read the prefix it
- *      never sees);
- *   2. send a VERIFIED editor request to /cmssy-edit, carrying that language and
- *      the edit flag - the public pages are static, and a static page never sees
- *      the query string that would put it in edit mode;
- *   3. strip the language prefix for everything else, if asked.
- *
- * The order is not a detail: resolve the locale after the rewrite and the editor
- * preview renders in the wrong language; forget the edit flag and the header and
- * footer become markup the editor can select but not fill. Both mistakes shipped
- * before this existed.
- */
 declare function createCmssyProxy(config: CmssyConfig, options?: CmssyProxyOptions): (request: NextRequest) => Promise<NextResponse>;
-/**
- * The matcher a cmssy app wants: everything except Next internals, API routes
- * and files with an extension.
- *
- * Next parses `export const config` at COMPILE time, so it rejects an imported
- * constant - copy this value into your proxy literally:
- *
- *   export const config = { matcher: ["/((?!_next/|api/|.*\\..*).*)"] };
- */
 declare const cmssyProxyMatcher: string[];
 
-/**
- * Where the middleware rewrites editor-preview traffic. Mount the matching
- * dynamic route in the consumer app:
- *
- *   app/cmssy-edit/[[...path]]/page.tsx
- *     export const dynamic = "force-dynamic";
- *     export default createCmssyEditPage(cmssy, blocks, { editor: Editor });
- */
 declare const CMSSY_EDIT_PATH_PREFIX = "/cmssy-edit";
-/**
- * Rewrite VERIFIED editor requests (`cmssyEdit=1` + a `cmssySecret` matching
- * the site's draft secret, CMS-948) onto the dedicated dynamic edit route, so
- * the public catch-all can stay fully static. A static page never sees its
- * query string - this rewrite is what makes the editor iframe work at all
- * once ISR is on. Draft-mode preview (the authenticated /api/draft cookie) is
- * NOT rewritten: it renders draft content on the public route via
- * `draftMode()`, without the editor. Returns null for normal traffic so it
- * composes with other middleware.
- */
 declare function cmssyEditRewrite(request: NextRequest, config: {
     draftSecret: string;
 }, options?: {
-    /**
-     * Headers to forward to the edit route, for a site whose middleware tells
-     * the app something the path alone does not - a resolved locale, say.
-     * Without them the editor preview renders in the default language while the
-     * public page renders in the visitor's.
-     */
     requestHeaders?: Headers;
 }): Promise<NextResponse | null>;
-/** Standalone middleware when the consumer has no other middleware to compose. */
 declare function createCmssyEditMiddleware(config: {
     draftSecret: string;
 }): (request: NextRequest) => Promise<NextResponse>;

package/dist/middleware.js

@@ -74,9 +74,6 @@ function createCmssyProxy(config, options = {}) {
         response.cookies.set(write.name, write.value, {
           ...DEFAULT_COOKIE_OPTIONS,
           ...write.options,
-          // Deletion wins over the caller's options. They will be the same
-          // options the cookie was written with, maxAge included, and honoring
-          // that here would keep an emptied cookie alive instead of removing it.
           ...write.value ? {} : { maxAge: 0 }
         });
       }

package/dist/server.d.cts

@@ -1,4 +1,4 @@
-export { C as CmssyAppContext, a as CmssyEditorProps, b as CreateCmssyPageOptions, c as createCmssyEditPage, d as createCmssyPage } from './index-B64zk2X7.cjs';
+export { C as CmssyAppContext, a as CmssyEditorProps, b as CreateCmssyPageOptions, c as createCmssyEditPage, d as createCmssyPage } from './index-BCHSAhKJ.cjs';
 import { CmssyConfig, LayoutPosition } from '@cmssy/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ComponentType } from 'react';
@@ -15,32 +15,9 @@ declare function isCmssyEditMode(): Promise<boolean>;
 interface CmssyLayoutSlotBaseProps {
     config: CmssyConfig;
     blocks: BlockDefinition[];
-    /**
-     * Which layout position to render. Six exist - `top`, `header`,
-     * `sidebar_left`, `sidebar_right`, `footer`, `bottom` - and most sites use
-     * two of them; the type is what tells you about the other four.
-     */
     position: LayoutPosition;
-    /**
-     * Whether to render through the edit bridge. A parameter rather than a
-     * lookup: every way of asking the request - `headers()`, `draftMode()` - is a
-     * dynamic API, and one read makes the whole route uncacheable. The route
-     * segment already knows the answer, so it passes it.
-     *
-     * Required on purpose. A slot that guessed `false` in an edit route would
-     * wrap draft content in published chrome, and nothing would report it.
-     */
     editMode: boolean;
-    /** The page whose layout to render. Defaults to the site-wide header/footer. */
     page?: string;
-    /**
-     * The client wrapper around `CmssyLazyLayout`, rendered in edit mode.
-     *
-     * Required, and a component rather than a loader: the block registry has to
-     * be imported lazily ON THE CLIENT, and a function cannot cross the server
-     * boundary. Without it the editor gets a header it can select and not fill -
-     * which is why this is a type error rather than a runtime warning.
-     */
     editable: ComponentType<{
         groups: CmssyLayoutGroup[];
         position: string;
@@ -54,19 +31,8 @@ interface CmssyLayoutSlotBaseProps {
         resolvedContent?: Record<string, Record<string, unknown>>;
         appContext?: Record<string, unknown>;
     }>;
-    /** Forwarded untouched to every block as `context.app`. */
     appContext?: Record<string, unknown>;
 }
-/**
- * Where the language comes from - one of two, never neither.
- *
- * `path` is the catch-all segments **as routed**: the language prefix in them
- * IS the language, and reading it costs the route nothing. A caller with no
- * params (a root layout) has to resolve the language itself and pass `locale`;
- * there is deliberately no fallback to the request header, because a static
- * route never sees the header the proxy set and would render the wrong
- * language while looking like it worked.
- */
 type CmssyLayoutSlotLocaleSource = {
     path: string[];
     locale?: never;
@@ -75,20 +41,6 @@ type CmssyLayoutSlotLocaleSource = {
     path?: never;
 };
 type CmssyLayoutSlotProps = CmssyLayoutSlotBaseProps & CmssyLayoutSlotLocaleSource;
-/**
- * The site-wide header and footer, which are layout **blocks** rather than
- * markup the app owns. Rendered the way each mode needs them:
- *
- *  - published traffic: server-rendered blocks, no client cost;
- *  - the editor: the same blocks through the edit bridge, fetched with the
- *    preview secret and handed their server-resolved content, so a relation
- *    field shows records rather than the ids it stores.
- *
- * Getting any of that wrong is invisible - the site looks right while the
- * editor shows a header it cannot fill, or the published version of one. Every
- * app that wrote this by hand between 10.0 and 10.9 got at least one of the
- * three wrong, which is why it is back.
- */
 declare function CmssyLayoutSlot({ config, blocks, position, path, locale: explicitLocale, editMode, page, editable: Editable, appContext, }: CmssyLayoutSlotProps): Promise<react_jsx_runtime.JSX.Element>;
 
 export { type CmssyDraftRouteConfig, CmssyLayoutSlot, type CmssyLayoutSlotProps, createDraftRoute, isCmssyEditMode };

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-export { C as CmssyAppContext, a as CmssyEditorProps, b as CreateCmssyPageOptions, c as createCmssyEditPage, d as createCmssyPage } from './index-B64zk2X7.js';
+export { C as CmssyAppContext, a as CmssyEditorProps, b as CreateCmssyPageOptions, c as createCmssyEditPage, d as createCmssyPage } from './index-BCHSAhKJ.js';
 import { CmssyConfig, LayoutPosition } from '@cmssy/core';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ComponentType } from 'react';
@@ -15,32 +15,9 @@ declare function isCmssyEditMode(): Promise<boolean>;
 interface CmssyLayoutSlotBaseProps {
     config: CmssyConfig;
     blocks: BlockDefinition[];
-    /**
-     * Which layout position to render. Six exist - `top`, `header`,
-     * `sidebar_left`, `sidebar_right`, `footer`, `bottom` - and most sites use
-     * two of them; the type is what tells you about the other four.
-     */
     position: LayoutPosition;
-    /**
-     * Whether to render through the edit bridge. A parameter rather than a
-     * lookup: every way of asking the request - `headers()`, `draftMode()` - is a
-     * dynamic API, and one read makes the whole route uncacheable. The route
-     * segment already knows the answer, so it passes it.
-     *
-     * Required on purpose. A slot that guessed `false` in an edit route would
-     * wrap draft content in published chrome, and nothing would report it.
-     */
     editMode: boolean;
-    /** The page whose layout to render. Defaults to the site-wide header/footer. */
     page?: string;
-    /**
-     * The client wrapper around `CmssyLazyLayout`, rendered in edit mode.
-     *
-     * Required, and a component rather than a loader: the block registry has to
-     * be imported lazily ON THE CLIENT, and a function cannot cross the server
-     * boundary. Without it the editor gets a header it can select and not fill -
-     * which is why this is a type error rather than a runtime warning.
-     */
     editable: ComponentType<{
         groups: CmssyLayoutGroup[];
         position: string;
@@ -54,19 +31,8 @@ interface CmssyLayoutSlotBaseProps {
         resolvedContent?: Record<string, Record<string, unknown>>;
         appContext?: Record<string, unknown>;
     }>;
-    /** Forwarded untouched to every block as `context.app`. */
     appContext?: Record<string, unknown>;
 }
-/**
- * Where the language comes from - one of two, never neither.
- *
- * `path` is the catch-all segments **as routed**: the language prefix in them
- * IS the language, and reading it costs the route nothing. A caller with no
- * params (a root layout) has to resolve the language itself and pass `locale`;
- * there is deliberately no fallback to the request header, because a static
- * route never sees the header the proxy set and would render the wrong
- * language while looking like it worked.
- */
 type CmssyLayoutSlotLocaleSource = {
     path: string[];
     locale?: never;
@@ -75,20 +41,6 @@ type CmssyLayoutSlotLocaleSource = {
     path?: never;
 };
 type CmssyLayoutSlotProps = CmssyLayoutSlotBaseProps & CmssyLayoutSlotLocaleSource;
-/**
- * The site-wide header and footer, which are layout **blocks** rather than
- * markup the app owns. Rendered the way each mode needs them:
- *
- *  - published traffic: server-rendered blocks, no client cost;
- *  - the editor: the same blocks through the edit bridge, fetched with the
- *    preview secret and handed their server-resolved content, so a relation
- *    field shows records rather than the ids it stores.
- *
- * Getting any of that wrong is invisible - the site looks right while the
- * editor shows a header it cannot fill, or the published version of one. Every
- * app that wrote this by hand between 10.0 and 10.9 got at least one of the
- * three wrong, which is why it is back.
- */
 declare function CmssyLayoutSlot({ config, blocks, position, path, locale: explicitLocale, editMode, page, editable: Editable, appContext, }: CmssyLayoutSlotProps): Promise<react_jsx_runtime.JSX.Element>;
 
 export { type CmssyDraftRouteConfig, CmssyLayoutSlot, type CmssyLayoutSlotProps, createDraftRoute, isCmssyEditMode };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/next",
-  "version": "11.6.0",
+  "version": "11.8.0",
   "description": "Next.js App Router bindings for cmssy headless sites (createCmssyPage + draft preview)",
   "keywords": [
     "cmssy",
@@ -24,24 +24,44 @@
   "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./server": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js",
-      "require": "./dist/server.cjs"
+      "import": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      },
+      "require": {
+        "types": "./dist/server.d.cts",
+        "default": "./dist/server.cjs"
+      }
     },
     "./middleware": {
-      "types": "./dist/middleware.d.ts",
-      "import": "./dist/middleware.js",
-      "require": "./dist/middleware.cjs"
+      "import": {
+        "types": "./dist/middleware.d.ts",
+        "default": "./dist/middleware.js"
+      },
+      "require": {
+        "types": "./dist/middleware.d.cts",
+        "default": "./dist/middleware.cjs"
+      }
     },
     "./testing": {
-      "types": "./dist/testing.d.ts",
-      "import": "./dist/testing.js",
-      "require": "./dist/testing.cjs"
+      "import": {
+        "types": "./dist/testing.d.ts",
+        "default": "./dist/testing.js"
+      },
+      "require": {
+        "types": "./dist/testing.d.cts",
+        "default": "./dist/testing.cjs"
+      }
     }
   },
   "main": "./dist/index.cjs",
@@ -65,12 +85,12 @@
     "tsup": "^8.3.0",
     "typescript": "^5.6.0",
     "vitest": "^2.1.0",
-    "@cmssy/react": "11.6.0"
+    "@cmssy/react": "11.8.0"
   },
   "dependencies": {
     "@cmssy/types": "0.33.0",
     "server-only": "^0.0.1",
-    "@cmssy/core": "11.6.0"
+    "@cmssy/core": "11.8.0"
   },
   "scripts": {
     "build": "tsup",