@glw907/cairn-cms 0.6.0-rc.0 → 0.6.0

package/dist/components/ManageEditors.svelte

@@ -9,8 +9,8 @@ named `?/setRole`, `?/remove`, and `?/add` actions.
   import type { Editor } from '../auth/types.js';
 
   interface Props {
-    /** The editors load's data, plus the site name. */
-    data: { editors: Editor[]; self: string; siteName: string };
+    /** The editors load's data: the allowlist and the acting owner's email. */
+    data: { editors: Editor[]; self: string };
     /** The last action's result (an error message when it failed). */
     form: { error?: string; ok?: boolean } | null;
   }

package/dist/components/ManageEditors.svelte.d.ts

@@ -1,10 +1,9 @@
 import type { Editor } from '../auth/types.js';
 interface Props {
-    /** The editors load's data, plus the site name. */
+    /** The editors load's data: the allowlist and the acting owner's email. */
     data: {
         editors: Editor[];
         self: string;
-        siteName: string;
     };
     /** The last action's result (an error message when it failed). */
     form: {

package/dist/components/ManageEditors.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ManageEditors.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/ManageEditors.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG7C,UAAU,KAAK;IACb,mDAAmD;IACnD,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,kEAAkE;IAClE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/C;AAyEH;;;;;GAKG;AACH,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ManageEditors.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/ManageEditors.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG7C,UAAU,KAAK;IACb,2EAA2E;IAC3E,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,kEAAkE;IAClE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/C;AAyEH;;;;;GAKG;AACH,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/render/pipeline.d.ts

@@ -1,9 +1,10 @@
 import { type PluggableList } from 'unified';
 import type { ComponentRegistry } from './registry.js';
 export interface RendererOptions {
-    /** A site's per-index motion formula for the top-level rise stagger
-     *  (e.g. ecnordic's `(i) => '--rise:' + …`). Omit for no stagger. */
-    rise?: (idx: number) => string;
+    /** Stamp a `data-rise` ordinal (0, 1, 2, …) on each top-level component so a site's
+     *  CSS can drive an entrance-cascade delay off it. Omit for no stagger. The ordinal
+     *  is inert, so a consumer's sanitize floor can keep `data-rise` and drop `style`. */
+    stagger?: boolean;
 }
 /** Compose a site's render pipeline from its component registry: directive syntax to
  *  stamped markers to registry-built hast. Returns `renderMarkdown` plus the remark/

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/lib/render/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAUtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B;yEACqE;IACrE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC;AAED;;uFAEuF;AACvF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,GAAE,eAAoB;;;8BAarD,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;EAE3D"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/lib/render/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAUtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B;;0FAEsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;uFAEuF;AACvF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,GAAE,eAAoB;;;8BAarD,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;EAE3D"}

package/dist/render/pipeline.js

@@ -13,7 +13,7 @@ import { rehypeDispatch } from './rehype-dispatch.js';
  *  rehype plugin arrays (so the Carta editor preview can reuse the exact same set). */
 export function createRenderer(registry, options = {}) {
     const remarkPlugins = [remarkDirective, [remarkDirectiveStamp, registry]];
-    const rehypePlugins = [rehypeRaw, [rehypeDispatch, registry, options.rise], rehypeSlug];
+    const rehypePlugins = [rehypeRaw, [rehypeDispatch, registry, options.stagger], rehypeSlug];
     const processor = unified()
         .use(remarkParse)
         .use(remarkGfm)

package/dist/render/registry.d.ts

@@ -9,8 +9,10 @@ export interface ComponentDef {
     description: string;
     /** Markdown scaffold inserted at the cursor by the editor palette. */
     insertTemplate: string;
-    /** Build the final hast element from the stamped directive element. */
-    build: (node: Element, rise?: string) => Element;
+    /** Build the final hast element from the stamped directive element. The engine
+     *  stamps the entrance-stagger ordinal (`data-rise`) on the top-level result, so a
+     *  build fn stays free of any motion concern. */
+    build: (node: Element) => Element;
     /** Optional role-to-default-icon, e.g. `{ caution: 'warning' }`. */
     defaultIconByRole?: Record<string, string>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/lib/render/registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACjD,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,UAAU,EAAE,EAAE;IAAE,UAAU,EAAE,YAAY,EAAE,CAAA;CAAE,GAAG,iBAAiB,CAQhG"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/lib/render/registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB;;qDAEiD;IACjD,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IAClC,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,UAAU,EAAE,EAAE;IAAE,UAAU,EAAE,YAAY,EAAE,CAAA;CAAE,GAAG,iBAAiB,CAQhG"}

package/dist/render/rehype-dispatch.d.ts

@@ -10,15 +10,16 @@ export declare function splitHead(node: Element, makeIcon?: MakeIcon): {
     head: Element;
     rest: ElementContent[];
 };
-/** Section wrapper: `<section class=…><div class="card-body">…</div></section>`,
- *  with an optional inline rise style. */
-export declare function cardShell(classes: string[], rise: string | undefined, body: ElementContent[]): Element;
+/** Section wrapper: `<section class=…><div class="card-body">…</div></section>`. */
+export declare function cardShell(classes: string[], body: ElementContent[]): Element;
 /** Tag the first <ul> among children with `ec-grid` and strip its whitespace-only
  *  text nodes so the bare list serializes without newlines. Returns that <ul>. */
 export declare function markFirstList(children: ElementContent[]): Element | undefined;
 /** Rehype transformer: dispatch each stamped element through its registry `build`
- *  fn. Top-level primitives get a document-order rise stagger when `rise` is
- *  supplied (a site's per-index motion formula); nested ones don't. Non-primitive
+ *  fn. When `stagger` is on, each top-level primitive gets a `data-rise` attribute
+ *  carrying its document-order index (0, 1, 2, …); the site's CSS maps that ordinal
+ *  to an entrance delay. The index is inert, so a consumer's sanitize floor can keep
+ *  `data-rise` while dropping `style`. Nested primitives never get it. Non-primitive
  *  content (lede, intro paragraphs, the page-toc nav) passes through untouched. */
-export declare function rehypeDispatch(registry: ComponentRegistry, rise?: (idx: number) => string): (tree: Root) => void;
+export declare function rehypeDispatch(registry: ComponentRegistry, stagger?: boolean): (tree: Root) => void;
 //# sourceMappingURL=rehype-dispatch.d.ts.map

package/dist/render/rehype-dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rehype-dispatch.d.ts","sourceRoot":"","sources":["../../src/lib/render/rehype-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAc,MAAM,MAAM,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,IAAI,OAAO,CAE3E;AAKD,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGvE;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;AAMhE,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,cAAc,EAAE,CAAA;CAAE,CAYvG;AAED;0CAC0C;AAC1C,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAItG;AAED;kFACkF;AAClF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,GAAG,SAAS,CAS7E;AAmBD;;;mFAGmF;AACnF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,IAChF,MAAM,IAAI,UAUnB"}
+{"version":3,"file":"rehype-dispatch.d.ts","sourceRoot":"","sources":["../../src/lib/render/rehype-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,IAAI,OAAO,CAE3E;AAKD,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGvE;AAED,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;AAMhE,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,cAAc,EAAE,CAAA;CAAE,CAYvG;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,OAAO,CAE5E;AAED;kFACkF;AAClF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,GAAG,SAAS,CAS7E;AAoBD;;;;;mFAKmF;AACnF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,OAAO,IACnE,MAAM,IAAI,UAYnB"}

package/dist/render/rehype-dispatch.js

@@ -32,13 +32,9 @@ export function splitHead(node, makeIcon) {
     headKids.push(h2);
     return { head: h('div', { className: ['ec-head'] }, headKids), rest };
 }
-/** Section wrapper: `<section class=…><div class="card-body">…</div></section>`,
- *  with an optional inline rise style. */
-export function cardShell(classes, rise, body) {
-    const properties = { className: classes };
-    if (rise)
-        properties.style = rise;
-    return h('section', properties, [h('div', { className: ['card-body'] }, body)]);
+/** Section wrapper: `<section class=…><div class="card-body">…</div></section>`. */
+export function cardShell(classes, body) {
+    return h('section', { className: classes }, [h('div', { className: ['card-body'] }, body)]);
 }
 /** Tag the first <ul> among children with `ec-grid` and strip its whitespace-only
  *  text nodes so the bare list serializes without newlines. Returns that <ul>. */
@@ -51,7 +47,8 @@ export function markFirstList(children) {
     return ul;
 }
 // Recurse into a node's children, transforming any nested primitive sections
-// (a grid inside a card, panels inside a split) WITHOUT a rise stagger.
+// (a grid inside a card, panels inside a split). Nested primitives never carry the
+// entrance stagger; only top-level ones do (stamped in the transformer below).
 function transformChildren(children, registry) {
     return children.map((c) => {
         if (isElement(c) && c.properties?.dataPrimitive)
@@ -61,22 +58,27 @@ function transformChildren(children, registry) {
         return c;
     });
 }
-function transformNode(node, registry, rise) {
+function transformNode(node, registry) {
     node.children = transformChildren(node.children, registry);
     const name = strProp(node, 'dataPrimitive');
     const def = name ? registry.get(name) : undefined;
-    return def ? def.build(node, rise) : node;
+    return def ? def.build(node) : node;
 }
 /** Rehype transformer: dispatch each stamped element through its registry `build`
- *  fn. Top-level primitives get a document-order rise stagger when `rise` is
- *  supplied (a site's per-index motion formula); nested ones don't. Non-primitive
+ *  fn. When `stagger` is on, each top-level primitive gets a `data-rise` attribute
+ *  carrying its document-order index (0, 1, 2, …); the site's CSS maps that ordinal
+ *  to an entrance delay. The index is inert, so a consumer's sanitize floor can keep
+ *  `data-rise` while dropping `style`. Nested primitives never get it. Non-primitive
  *  content (lede, intro paragraphs, the page-toc nav) passes through untouched. */
-export function rehypeDispatch(registry, rise) {
+export function rehypeDispatch(registry, stagger) {
     return (tree) => {
         let idx = 0;
         tree.children = tree.children.map((child) => {
             if (isElement(child) && child.properties?.dataPrimitive) {
-                return transformNode(child, registry, rise ? rise(idx++) : undefined);
+                const el = transformNode(child, registry);
+                if (stagger)
+                    el.properties = { ...el.properties, dataRise: String(idx++) };
+                return el;
             }
             if (isElement(child))
                 child.children = transformChildren(child.children, registry);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glw907/cairn-cms",
-  "version": "0.6.0-rc.0",
+  "version": "0.6.0",
   "description": "Embedded, magic-link, GitHub-committing CMS for SvelteKit/Cloudflare sites.",
   "type": "module",
   "sideEffects": [
@@ -85,6 +85,7 @@
     "@sveltejs/kit": "^2.61",
     "@sveltejs/package": "^2",
     "@sveltejs/vite-plugin-svelte": "^7.1",
+    "@types/node": "^22.19.19",
     "@vitest/browser": "^4.1.7",
     "@vitest/browser-playwright": "^4.1.7",
     "carta-md": "^4.11",

package/src/lib/components/ManageEditors.svelte

@@ -9,8 +9,8 @@ named `?/setRole`, `?/remove`, and `?/add` actions.
   import type { Editor } from '../auth/types.js';
 
   interface Props {
-    /** The editors load's data, plus the site name. */
-    data: { editors: Editor[]; self: string; siteName: string };
+    /** The editors load's data: the allowlist and the acting owner's email. */
+    data: { editors: Editor[]; self: string };
     /** The last action's result (an error message when it failed). */
     form: { error?: string; ok?: boolean } | null;
   }

package/src/lib/render/pipeline.ts

@@ -11,9 +11,10 @@ import { rehypeDispatch } from './rehype-dispatch.js';
 import type { ComponentRegistry } from './registry.js';
 
 export interface RendererOptions {
-  /** A site's per-index motion formula for the top-level rise stagger
-   *  (e.g. ecnordic's `(i) => '--rise:' + …`). Omit for no stagger. */
-  rise?: (idx: number) => string;
+  /** Stamp a `data-rise` ordinal (0, 1, 2, …) on each top-level component so a site's
+   *  CSS can drive an entrance-cascade delay off it. Omit for no stagger. The ordinal
+   *  is inert, so a consumer's sanitize floor can keep `data-rise` and drop `style`. */
+  stagger?: boolean;
 }
 
 /** Compose a site's render pipeline from its component registry: directive syntax to
@@ -21,7 +22,7 @@ export interface RendererOptions {
  *  rehype plugin arrays (so the Carta editor preview can reuse the exact same set). */
 export function createRenderer(registry: ComponentRegistry, options: RendererOptions = {}) {
   const remarkPlugins: PluggableList = [remarkDirective, [remarkDirectiveStamp, registry]];
-  const rehypePlugins: PluggableList = [rehypeRaw, [rehypeDispatch, registry, options.rise], rehypeSlug];
+  const rehypePlugins: PluggableList = [rehypeRaw, [rehypeDispatch, registry, options.stagger], rehypeSlug];
   const processor = unified()
     .use(remarkParse)
     .use(remarkGfm)

package/src/lib/render/registry.ts

@@ -15,8 +15,10 @@ export interface ComponentDef {
   description: string;
   /** Markdown scaffold inserted at the cursor by the editor palette. */
   insertTemplate: string;
-  /** Build the final hast element from the stamped directive element. */
-  build: (node: Element, rise?: string) => Element;
+  /** Build the final hast element from the stamped directive element. The engine
+   *  stamps the entrance-stagger ordinal (`data-rise`) on the top-level result, so a
+   *  build fn stays free of any motion concern. */
+  build: (node: Element) => Element;
   /** Optional role-to-default-icon, e.g. `{ caution: 'warning' }`. */
   defaultIconByRole?: Record<string, string>;
 }

package/src/lib/render/rehype-dispatch.ts

@@ -1,4 +1,4 @@
-import type { Root, Element, ElementContent, Properties } from 'hast';
+import type { Root, Element, ElementContent } from 'hast';
 import { h } from 'hastscript';
 import type { ComponentRegistry } from './registry.js';
 
@@ -41,12 +41,9 @@ export function splitHead(node: Element, makeIcon?: MakeIcon): { head: Element;
   return { head: h('div', { className: ['ec-head'] }, headKids), rest };
 }
 
-/** Section wrapper: `<section class=…><div class="card-body">…</div></section>`,
- *  with an optional inline rise style. */
-export function cardShell(classes: string[], rise: string | undefined, body: ElementContent[]): Element {
-  const properties: Properties = { className: classes };
-  if (rise) properties.style = rise;
-  return h('section', properties, [h('div', { className: ['card-body'] }, body)]);
+/** Section wrapper: `<section class=…><div class="card-body">…</div></section>`. */
+export function cardShell(classes: string[], body: ElementContent[]): Element {
+  return h('section', { className: classes }, [h('div', { className: ['card-body'] }, body)]);
 }
 
 /** Tag the first <ul> among children with `ec-grid` and strip its whitespace-only
@@ -63,7 +60,8 @@ export function markFirstList(children: ElementContent[]): Element | undefined {
 }
 
 // Recurse into a node's children, transforming any nested primitive sections
-// (a grid inside a card, panels inside a split) WITHOUT a rise stagger.
+// (a grid inside a card, panels inside a split). Nested primitives never carry the
+// entrance stagger; only top-level ones do (stamped in the transformer below).
 function transformChildren(children: ElementContent[], registry: ComponentRegistry): ElementContent[] {
   return children.map((c) => {
     if (isElement(c) && c.properties?.dataPrimitive) return transformNode(c, registry);
@@ -72,23 +70,27 @@ function transformChildren(children: ElementContent[], registry: ComponentRegist
   });
 }
 
-function transformNode(node: Element, registry: ComponentRegistry, rise?: string): Element {
+function transformNode(node: Element, registry: ComponentRegistry): Element {
   node.children = transformChildren(node.children as ElementContent[], registry);
   const name = strProp(node, 'dataPrimitive');
   const def = name ? registry.get(name) : undefined;
-  return def ? def.build(node, rise) : node;
+  return def ? def.build(node) : node;
 }
 
 /** Rehype transformer: dispatch each stamped element through its registry `build`
- *  fn. Top-level primitives get a document-order rise stagger when `rise` is
- *  supplied (a site's per-index motion formula); nested ones don't. Non-primitive
+ *  fn. When `stagger` is on, each top-level primitive gets a `data-rise` attribute
+ *  carrying its document-order index (0, 1, 2, …); the site's CSS maps that ordinal
+ *  to an entrance delay. The index is inert, so a consumer's sanitize floor can keep
+ *  `data-rise` while dropping `style`. Nested primitives never get it. Non-primitive
  *  content (lede, intro paragraphs, the page-toc nav) passes through untouched. */
-export function rehypeDispatch(registry: ComponentRegistry, rise?: (idx: number) => string) {
+export function rehypeDispatch(registry: ComponentRegistry, stagger?: boolean) {
   return (tree: Root) => {
     let idx = 0;
     tree.children = (tree.children as ElementContent[]).map((child) => {
       if (isElement(child) && child.properties?.dataPrimitive) {
-        return transformNode(child, registry, rise ? rise(idx++) : undefined);
+        const el = transformNode(child, registry);
+        if (stagger) el.properties = { ...el.properties, dataRise: String(idx++) };
+        return el;
       }
       if (isElement(child)) child.children = transformChildren(child.children as ElementContent[], registry);
       return child;