@styleflow.app/flowpress-astro-core 0.2.0-beta.13 → 0.2.0-beta.15

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.2.0-beta.15
+
+- Applied Hero image and video `object-position` from a sanitized pair of
+  percentage coordinates, with a safe centered fallback.
+
+## 0.2.0-beta.14
+
+- Added a recursive project block-renderer registry to
+  `GutenbergRenderer.astro`, including imported `sf/template` and resolved
+  query-item descendants.
+
 ## 0.2.0-beta.13
 
 - Kept number spinners static on their final values when

package/README.md

@@ -9,7 +9,7 @@ The package must not import from an application or project plugin.
 ## Install
 
 ```bash
-pnpm add @styleflow.app/flowpress-astro-core@0.2.0-beta.13
+pnpm add @styleflow.app/flowpress-astro-core@0.2.0-beta.15
 ```
 
 Prereleases are pinned exactly. The package expects Astro 7 or newer and the
@@ -44,6 +44,36 @@ visible characters. The exported
 from rendered CMS blocks so consumers can generate Tailwind
 `@source inline()` directives before compiling their frontend CSS.
 
+Hero image and video backgrounds apply the catalog `objectPosition` value as
+two percentages (for example `77% 100%`). Invalid or missing CMS values safely
+fall back to `50% 50%`.
+
+Projects can add renderers for project-owned Gutenberg blocks without copying
+or patching the core renderer. Pass a `FlowpressBlockRenderers` map keyed by the
+full block name; the registry is propagated through every recursive rendering
+path, including imported `sf/template` content and resolved query-item
+templates.
+
+```astro
+---
+import GutenbergRenderer from "@styleflow.app/flowpress-astro-core/GutenbergRenderer.astro";
+import type {
+  FlowpressBlockRenderers
+} from "@styleflow.app/flowpress-astro-core";
+import ProjectTimelineBlock from "./ProjectTimelineBlock.astro";
+
+const blockRenderers = {
+  "sf/timeline": ProjectTimelineBlock
+} satisfies FlowpressBlockRenderers;
+---
+
+<GutenbergRenderer blocks={blocks} blockRenderers={blockRenderers} />
+```
+
+Each custom renderer receives the original `block` and optional StyleFlow
+`contract`. Its default slot contains recursively rendered child blocks, so a
+container override can place `<slot />` where its children belong.
+
 `sf/number-spinner` renders prefix, target number and suffix with independent
 semantic tags and StyleFlow text coordinates. Its numeric value counts from
 zero only when it enters the viewport. The final target remains available to

package/dist/astro/GutenbergRenderer.astro

@@ -1,5 +1,6 @@
 ---
 import S from "@styleflow.app/astro/S.astro";
+import type { FlowpressBlockRenderers } from "../block-renderers.js";
 import type { StyleflowContract } from "../styleflow.js";
 import type { FlowpressBlock } from "../types.js";
 import ColumnBlock from "./blocks/ColumnBlock.astro";
@@ -20,9 +21,10 @@ import {
 interface Props {
   blocks: FlowpressBlock[];
   contract?: StyleflowContract;
+  blockRenderers?: FlowpressBlockRenderers;
 }
 
-const { blocks, contract } = Astro.props;
+const { blocks, contract, blockRenderers = {} } = Astro.props;
 
 function youtubeEmbedUrl(value: unknown): string | null {
   try {
@@ -47,11 +49,28 @@ function youtubeEmbedUrl(value: unknown): string | null {
   const children = block.innerBlocks ?? [];
   const semantic = semanticProps(block.attributes, contract);
   const htmlAttributes = blockHtmlAttributes(block.attributes);
+  const CustomBlockRenderer = blockRenderers[block.name];
+
+  if (CustomBlockRenderer) {
+    return (
+      <CustomBlockRenderer block={block} contract={contract}>
+        <Astro.self
+          blocks={children}
+          contract={contract}
+          blockRenderers={blockRenderers}
+        />
+      </CustomBlockRenderer>
+    );
+  }
 
   if (name === "hero") {
     return (
       <HeroBlock block={block} contract={contract}>
-        <Astro.self blocks={children} contract={contract} />
+        <Astro.self
+          blocks={children}
+          contract={contract}
+          blockRenderers={blockRenderers}
+        />
       </HeroBlock>
     );
   }
@@ -59,7 +78,11 @@ function youtubeEmbedUrl(value: unknown): string | null {
   if (name === "grid") {
     return (
       <GridBlock block={block} contract={contract}>
-        <Astro.self blocks={children} contract={contract} />
+        <Astro.self
+          blocks={children}
+          contract={contract}
+          blockRenderers={blockRenderers}
+        />
       </GridBlock>
     );
   }
@@ -67,7 +90,11 @@ function youtubeEmbedUrl(value: unknown): string | null {
   if (name === "column") {
     return (
       <ColumnBlock block={block} contract={contract}>
-        <Astro.self blocks={children} contract={contract} />
+        <Astro.self
+          blocks={children}
+          contract={contract}
+          blockRenderers={blockRenderers}
+        />
       </ColumnBlock>
     );
   }
@@ -88,7 +115,11 @@ function youtubeEmbedUrl(value: unknown): string | null {
   ].includes(name)) {
     return (
       <TextBlock block={block} contract={contract} hasChildren={children.length > 0}>
-        <Astro.self blocks={children} contract={contract} />
+        <Astro.self
+          blocks={children}
+          contract={contract}
+          blockRenderers={blockRenderers}
+        />
       </TextBlock>
     );
   }
@@ -216,7 +247,11 @@ function youtubeEmbedUrl(value: unknown): string | null {
         {items.map((item, index) => (
           <S as="li">
             {resolvedBlocks[index]?.length ? (
-              <Astro.self blocks={resolvedBlocks[index]} contract={contract} />
+              <Astro.self
+                blocks={resolvedBlocks[index]}
+                contract={contract}
+                blockRenderers={blockRenderers}
+              />
             ) : (
               <ListItemFallback item={item} />
             )}
@@ -229,10 +264,18 @@ function youtubeEmbedUrl(value: unknown): string | null {
   if (name === "template") {
     return Object.keys(htmlAttributes).length > 0 ? (
       <div {...htmlAttributes}>
-        <Astro.self blocks={children} contract={contract} />
+        <Astro.self
+          blocks={children}
+          contract={contract}
+          blockRenderers={blockRenderers}
+        />
       </div>
     ) : (
-      <Astro.self blocks={children} contract={contract} />
+      <Astro.self
+        blocks={children}
+        contract={contract}
+        blockRenderers={blockRenderers}
+      />
     );
   }
 
@@ -245,7 +288,11 @@ function youtubeEmbedUrl(value: unknown): string | null {
       <S as="div" {...semantic} {...htmlAttributes}>
         <details>
           <summary>{String(block.attributes.title ?? "")}</summary>
-          <Astro.self blocks={children} contract={contract} />
+          <Astro.self
+            blocks={children}
+            contract={contract}
+            blockRenderers={blockRenderers}
+          />
         </details>
       </S>
     );
@@ -296,7 +343,13 @@ function youtubeEmbedUrl(value: unknown): string | null {
     <S as={layoutTag} {...semantic} {...htmlAttributes}>
       {block.innerHtml && children.length === 0
         ? <S as="div" set:html={block.innerHtml} />
-        : <Astro.self blocks={children} contract={contract} />}
+        : (
+          <Astro.self
+            blocks={children}
+            contract={contract}
+            blockRenderers={blockRenderers}
+          />
+        )}
     </S>
   );
 })}

package/dist/astro/blocks/HeroBlock.astro

@@ -4,6 +4,7 @@ import type { FlowpressBlock } from "../../types.js";
 import type { StyleflowContract } from "../../styleflow.js";
 import {
   blockHtmlAttributes,
+  heroObjectPosition,
   objectValue,
   semanticProps
 } from "./helpers.js";
@@ -28,6 +29,7 @@ const image = objectValue(block, "backgroundImage");
 const video = objectValue(block, "backgroundVideo");
 const imageSrc = String(image.url ?? image.sourceUrl ?? "");
 const videoSrc = String(video.url ?? video.sourceUrl ?? video.mediaItemUrl ?? "");
+const objectPosition = heroObjectPosition(attributes.objectPosition);
 const scrimEnabled = Boolean(attributes.scrimEnabled) && backgroundType !== "color";
 const scrimIntensity = Math.min(10, Math.max(1, Number(attributes.scrimIntensity) || 6));
 ---
@@ -36,7 +38,10 @@ const scrimIntensity = Math.min(10, Math.max(1, Number(attributes.scrimIntensity
   as="section"
   {...semantic}
   {...htmlAttributes}
-  style={`--flowpress-scrim-opacity:${scrimIntensity * 10}%`}
+  style={[
+    `--flowpress-hero-object-position:${objectPosition}`,
+    `--flowpress-scrim-opacity:${scrimIntensity * 10}%`
+  ].join(";")}
 >
   {backgroundType === "image" && imageSrc ? (
     <img
@@ -87,6 +92,7 @@ const scrimIntensity = Math.min(10, Math.max(1, Number(attributes.scrimIntensity
   .flowpress-hero__media {
     z-index: -2;
     object-fit: cover;
+    object-position: var(--flowpress-hero-object-position);
   }
 
   .flowpress-hero__scrim {

package/dist/astro/blocks/helpers.d.ts

@@ -5,6 +5,8 @@ export declare const DEFAULT_SEMANTIC_PROPS: {
     layoutRole: string;
     density: string;
 };
+export declare const DEFAULT_HERO_OBJECT_POSITION = "50% 50%";
+export declare function heroObjectPosition(value: unknown): string;
 export declare function blockHtmlAttributes(attributes: Record<string, unknown>, baseClass?: string): {
     id?: string;
     class?: string;

package/dist/astro/blocks/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/astro/blocks/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,sBAAsB;;;;CAIlC,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,SAAS,SAAK,GACb;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBjC;AAqBD,eAAO,MAAM,cAAc,6FAajB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAKvD;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAA0B,GACzD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,SAAS,GAAG,MAAM,CAErE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB5D;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,SAAS,GAAG,MAAM,CAMrE;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,EAAE,SAAS,GAAG,MAAM,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,EAAE,MAAM,CAAC,CAe5D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/astro/blocks/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,sBAAsB;;;;CAIlC,CAAC;AAEF,eAAO,MAAM,4BAA4B,YAAY,CAAC;AAEtD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmBzD;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,SAAS,SAAK,GACb;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBjC;AAqBD,eAAO,MAAM,cAAc,6FAajB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAKvD;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAA0B,GACzD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,SAAS,GAAG,MAAM,CAErE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoB5D;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,SAAS,GAAG,MAAM,CAMrE;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,EAAE,SAAS,GAAG,MAAM,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,EAAE,MAAM,CAAC,CAe5D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD"}

package/dist/astro/blocks/helpers.js

@@ -4,6 +4,21 @@ export const DEFAULT_SEMANTIC_PROPS = {
     layoutRole: "stack",
     density: "md"
 };
+export const DEFAULT_HERO_OBJECT_POSITION = "50% 50%";
+export function heroObjectPosition(value) {
+    if (typeof value !== "string") {
+        return DEFAULT_HERO_OBJECT_POSITION;
+    }
+    const match = value.trim().match(/^(\d+(?:\.\d+)?|\.\d+)%\s+(\d+(?:\.\d+)?|\.\d+)%$/);
+    if (!match
+        || [match[1], match[2]].some((coordinate) => {
+            const numeric = Number(coordinate);
+            return !Number.isFinite(numeric) || numeric < 0 || numeric > 100;
+        })) {
+        return DEFAULT_HERO_OBJECT_POSITION;
+    }
+    return `${match[1]}% ${match[2]}%`;
+}
 export function blockHtmlAttributes(attributes, baseClass = "") {
     const anchor = typeof attributes.anchor === "string"
         ? attributes.anchor.trim()

package/dist/astro/blocks/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/astro/blocks/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  resolveDynamicStyleflowProps,\n  type StyleflowContract\n} from \"../../styleflow.js\";\nimport type { FlowpressBlock } from \"../../types.js\";\n\nexport const DEFAULT_SEMANTIC_PROPS = {\n  surface: \"default\",\n  layoutRole: \"stack\",\n  density: \"md\"\n};\n\nexport function blockHtmlAttributes(\n  attributes: Record<string, unknown>,\n  baseClass = \"\"\n): { id?: string; class?: string } {\n  const anchor = typeof attributes.anchor === \"string\"\n    ? attributes.anchor.trim()\n    : \"\";\n  const customClass = typeof attributes.className === \"string\"\n    ? attributes.className.trim()\n    : \"\";\n  const className = [baseClass.trim(), customClass]\n    .filter(Boolean)\n    .join(\" \")\n    .replace(/\\s+/g, \" \");\n\n  return {\n    ...(anchor ? { id: anchor } : {}),\n    ...(className ? { class: className } : {})\n  };\n}\n\nconst SEMANTIC_KEYS = [\n  \"tone\",\n  \"intensity\",\n  \"surface\",\n  \"layoutRole\",\n  \"density\",\n  \"ty\",\n  \"v\",\n  \"w\",\n  \"foreground\",\n  \"interactivePriority\",\n  \"noBackground\",\n  \"noBorder\",\n  \"noPadding\",\n  \"noGap\",\n  \"noRadius\",\n  \"noForeground\"\n] as const;\n\nexport const TEXT_HTML_TAGS = [\n  \"span\",\n  \"p\",\n  \"h1\",\n  \"h2\",\n  \"h3\",\n  \"h4\",\n  \"h5\",\n  \"h6\",\n  \"strong\",\n  \"em\",\n  \"small\",\n  \"mark\"\n] as const;\n\nexport type TextHtmlTag = (typeof TEXT_HTML_TAGS)[number];\n\nexport function textHtmlTag(value: unknown): TextHtmlTag {\n  const candidate = String(value ?? \"span\");\n  return TEXT_HTML_TAGS.includes(candidate as TextHtmlTag)\n    ? candidate as TextHtmlTag\n    : \"span\";\n}\n\nexport function semanticProps(\n  attributes: Record<string, unknown>,\n  contract?: StyleflowContract,\n  defaults: Record<string, unknown> = DEFAULT_SEMANTIC_PROPS\n): Record<string, unknown> {\n  const input = Object.fromEntries(\n    SEMANTIC_KEYS\n      .filter((key) => attributes[key] !== undefined)\n      .map((key) => [key, attributes[key]])\n  );\n  return contract\n    ? resolveDynamicStyleflowProps(input, defaults, contract)\n    : { ...defaults, ...input };\n}\n\nexport function prefixedTextSemanticProps(\n  attributes: Record<string, unknown>,\n  prefix: string,\n  contract?: StyleflowContract,\n  defaults: Record<string, unknown> = {}\n): Record<string, unknown> {\n  const attributeName = (name: string) =>\n    `${prefix}${name.charAt(0).toUpperCase()}${name.slice(1)}`;\n  return semanticProps({\n    ty: attributes[attributeName(\"ty\")],\n    v: attributes[attributeName(\"v\")],\n    w: attributes[attributeName(\"w\")],\n    foreground: attributes[attributeName(\"foreground\")]\n  }, contract, defaults);\n}\n\nexport function objectValue(\n  block: FlowpressBlock,\n  key: string\n): Record<string, unknown> {\n  const value = block.attributes[key];\n  return value && typeof value === \"object\" && !Array.isArray(value)\n    ? value as Record<string, unknown>\n    : {};\n}\n\nexport function textValue(block: FlowpressBlock, key = \"text\"): string {\n  return String(block.attributes[key] ?? \"\");\n}\n\n/**\n * Keep intentional blank lines visible across current and legacy RichText\n * serializations. Gutenberg can represent them either as repeated `<br>` tags,\n * empty paragraph elements, or literal newlines in an attribute value.\n */\nexport function preserveRichTextSpacing(html: string): string {\n  const visibleEmptyBlocks = html\n    .replace(/\\r\\n?/g, \"\\n\")\n    .replace(\n      /<(p|div)(\\s[^>]*)?>(?:\\s|&nbsp;|&#160;)*<\\/\\1>/gi,\n      (_match, tag: string, attributes = \"\") =>\n        `<${tag}${attributes}>&nbsp;</${tag}>`\n    );\n\n  return visibleEmptyBlocks\n    .split(/(<[^>]+>)/g)\n    .map((part) => {\n      if (part.startsWith(\"<\") || part.trim() === \"\") {\n        return part;\n      }\n      return part.replace(/\\n(?:[ \\t]*\\n)+/g, (newlines) =>\n        \"<br>\".repeat((newlines.match(/\\n/g) || []).length)\n      );\n    })\n    .join(\"\");\n}\n\n/** Keep an empty text element at its typographic line height without visible text. */\nexport function preserveEmptyTextBlock(html: string): string {\n  return html.trim() === \"\" ? \"&nbsp;\" : html;\n}\n\nexport function linkValue(block: FlowpressBlock, key = \"link\"): string {\n  const value = block.attributes[key];\n  const href = typeof value === \"string\"\n    ? value\n    : String(objectValue(block, key).url ?? \"\");\n  return /^(?:\\/(?!\\/)|#|https?:\\/\\/|mailto:|tel:)/i.test(href) ? href : \"\";\n}\n\nexport function responsiveValues(\n  attributes: Record<string, unknown>,\n  prefix: \"columns\" | \"span\",\n  fallback: number\n): Record<\"base\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\", number> {\n  const keys = [\"base\", \"sm\", \"md\", \"lg\", \"xl\", \"2xl\"] as const;\n  const result = {} as Record<(typeof keys)[number], number>;\n  let inherited = fallback;\n  for (const key of keys) {\n    const suffix = key === \"base\"\n      ? \"Base\"\n      : key === \"2xl\" ? \"2xl\" : key.charAt(0).toUpperCase() + key.slice(1);\n    const candidate = Number(attributes[`${prefix}${suffix}`]);\n    if (Number.isInteger(candidate) && candidate >= 1 && candidate <= 12) {\n      inherited = candidate;\n    }\n    result[key] = inherited;\n  }\n  return result;\n}\n\nexport function unwrapCoreHtml(html: string): string {\n  const match = html.trim().match(\n    /^<(p|h[1-6]|ul|ol|li|blockquote)(?:\\s[^>]*)?>([\\s\\S]*)<\\/\\1>$/\n  );\n  return match?.[2] ?? html;\n}\n"]}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/astro/blocks/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  resolveDynamicStyleflowProps,\n  type StyleflowContract\n} from \"../../styleflow.js\";\nimport type { FlowpressBlock } from \"../../types.js\";\n\nexport const DEFAULT_SEMANTIC_PROPS = {\n  surface: \"default\",\n  layoutRole: \"stack\",\n  density: \"md\"\n};\n\nexport const DEFAULT_HERO_OBJECT_POSITION = \"50% 50%\";\n\nexport function heroObjectPosition(value: unknown): string {\n  if (typeof value !== \"string\") {\n    return DEFAULT_HERO_OBJECT_POSITION;\n  }\n\n  const match = value.trim().match(\n    /^(\\d+(?:\\.\\d+)?|\\.\\d+)%\\s+(\\d+(?:\\.\\d+)?|\\.\\d+)%$/\n  );\n  if (\n    !match\n    || [match[1], match[2]].some((coordinate) => {\n      const numeric = Number(coordinate);\n      return !Number.isFinite(numeric) || numeric < 0 || numeric > 100;\n    })\n  ) {\n    return DEFAULT_HERO_OBJECT_POSITION;\n  }\n\n  return `${match[1]}% ${match[2]}%`;\n}\n\nexport function blockHtmlAttributes(\n  attributes: Record<string, unknown>,\n  baseClass = \"\"\n): { id?: string; class?: string } {\n  const anchor = typeof attributes.anchor === \"string\"\n    ? attributes.anchor.trim()\n    : \"\";\n  const customClass = typeof attributes.className === \"string\"\n    ? attributes.className.trim()\n    : \"\";\n  const className = [baseClass.trim(), customClass]\n    .filter(Boolean)\n    .join(\" \")\n    .replace(/\\s+/g, \" \");\n\n  return {\n    ...(anchor ? { id: anchor } : {}),\n    ...(className ? { class: className } : {})\n  };\n}\n\nconst SEMANTIC_KEYS = [\n  \"tone\",\n  \"intensity\",\n  \"surface\",\n  \"layoutRole\",\n  \"density\",\n  \"ty\",\n  \"v\",\n  \"w\",\n  \"foreground\",\n  \"interactivePriority\",\n  \"noBackground\",\n  \"noBorder\",\n  \"noPadding\",\n  \"noGap\",\n  \"noRadius\",\n  \"noForeground\"\n] as const;\n\nexport const TEXT_HTML_TAGS = [\n  \"span\",\n  \"p\",\n  \"h1\",\n  \"h2\",\n  \"h3\",\n  \"h4\",\n  \"h5\",\n  \"h6\",\n  \"strong\",\n  \"em\",\n  \"small\",\n  \"mark\"\n] as const;\n\nexport type TextHtmlTag = (typeof TEXT_HTML_TAGS)[number];\n\nexport function textHtmlTag(value: unknown): TextHtmlTag {\n  const candidate = String(value ?? \"span\");\n  return TEXT_HTML_TAGS.includes(candidate as TextHtmlTag)\n    ? candidate as TextHtmlTag\n    : \"span\";\n}\n\nexport function semanticProps(\n  attributes: Record<string, unknown>,\n  contract?: StyleflowContract,\n  defaults: Record<string, unknown> = DEFAULT_SEMANTIC_PROPS\n): Record<string, unknown> {\n  const input = Object.fromEntries(\n    SEMANTIC_KEYS\n      .filter((key) => attributes[key] !== undefined)\n      .map((key) => [key, attributes[key]])\n  );\n  return contract\n    ? resolveDynamicStyleflowProps(input, defaults, contract)\n    : { ...defaults, ...input };\n}\n\nexport function prefixedTextSemanticProps(\n  attributes: Record<string, unknown>,\n  prefix: string,\n  contract?: StyleflowContract,\n  defaults: Record<string, unknown> = {}\n): Record<string, unknown> {\n  const attributeName = (name: string) =>\n    `${prefix}${name.charAt(0).toUpperCase()}${name.slice(1)}`;\n  return semanticProps({\n    ty: attributes[attributeName(\"ty\")],\n    v: attributes[attributeName(\"v\")],\n    w: attributes[attributeName(\"w\")],\n    foreground: attributes[attributeName(\"foreground\")]\n  }, contract, defaults);\n}\n\nexport function objectValue(\n  block: FlowpressBlock,\n  key: string\n): Record<string, unknown> {\n  const value = block.attributes[key];\n  return value && typeof value === \"object\" && !Array.isArray(value)\n    ? value as Record<string, unknown>\n    : {};\n}\n\nexport function textValue(block: FlowpressBlock, key = \"text\"): string {\n  return String(block.attributes[key] ?? \"\");\n}\n\n/**\n * Keep intentional blank lines visible across current and legacy RichText\n * serializations. Gutenberg can represent them either as repeated `<br>` tags,\n * empty paragraph elements, or literal newlines in an attribute value.\n */\nexport function preserveRichTextSpacing(html: string): string {\n  const visibleEmptyBlocks = html\n    .replace(/\\r\\n?/g, \"\\n\")\n    .replace(\n      /<(p|div)(\\s[^>]*)?>(?:\\s|&nbsp;|&#160;)*<\\/\\1>/gi,\n      (_match, tag: string, attributes = \"\") =>\n        `<${tag}${attributes}>&nbsp;</${tag}>`\n    );\n\n  return visibleEmptyBlocks\n    .split(/(<[^>]+>)/g)\n    .map((part) => {\n      if (part.startsWith(\"<\") || part.trim() === \"\") {\n        return part;\n      }\n      return part.replace(/\\n(?:[ \\t]*\\n)+/g, (newlines) =>\n        \"<br>\".repeat((newlines.match(/\\n/g) || []).length)\n      );\n    })\n    .join(\"\");\n}\n\n/** Keep an empty text element at its typographic line height without visible text. */\nexport function preserveEmptyTextBlock(html: string): string {\n  return html.trim() === \"\" ? \"&nbsp;\" : html;\n}\n\nexport function linkValue(block: FlowpressBlock, key = \"link\"): string {\n  const value = block.attributes[key];\n  const href = typeof value === \"string\"\n    ? value\n    : String(objectValue(block, key).url ?? \"\");\n  return /^(?:\\/(?!\\/)|#|https?:\\/\\/|mailto:|tel:)/i.test(href) ? href : \"\";\n}\n\nexport function responsiveValues(\n  attributes: Record<string, unknown>,\n  prefix: \"columns\" | \"span\",\n  fallback: number\n): Record<\"base\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\", number> {\n  const keys = [\"base\", \"sm\", \"md\", \"lg\", \"xl\", \"2xl\"] as const;\n  const result = {} as Record<(typeof keys)[number], number>;\n  let inherited = fallback;\n  for (const key of keys) {\n    const suffix = key === \"base\"\n      ? \"Base\"\n      : key === \"2xl\" ? \"2xl\" : key.charAt(0).toUpperCase() + key.slice(1);\n    const candidate = Number(attributes[`${prefix}${suffix}`]);\n    if (Number.isInteger(candidate) && candidate >= 1 && candidate <= 12) {\n      inherited = candidate;\n    }\n    result[key] = inherited;\n  }\n  return result;\n}\n\nexport function unwrapCoreHtml(html: string): string {\n  const match = html.trim().match(\n    /^<(p|h[1-6]|ul|ol|li|blockquote)(?:\\s[^>]*)?>([\\s\\S]*)<\\/\\1>$/\n  );\n  return match?.[2] ?? html;\n}\n"]}

package/dist/astro/blocks/helpers.ts

@@ -10,6 +10,29 @@ export const DEFAULT_SEMANTIC_PROPS = {
   density: "md"
 };
 
+export const DEFAULT_HERO_OBJECT_POSITION = "50% 50%";
+
+export function heroObjectPosition(value: unknown): string {
+  if (typeof value !== "string") {
+    return DEFAULT_HERO_OBJECT_POSITION;
+  }
+
+  const match = value.trim().match(
+    /^(\d+(?:\.\d+)?|\.\d+)%\s+(\d+(?:\.\d+)?|\.\d+)%$/
+  );
+  if (
+    !match
+    || [match[1], match[2]].some((coordinate) => {
+      const numeric = Number(coordinate);
+      return !Number.isFinite(numeric) || numeric < 0 || numeric > 100;
+    })
+  ) {
+    return DEFAULT_HERO_OBJECT_POSITION;
+  }
+
+  return `${match[1]}% ${match[2]}%`;
+}
+
 export function blockHtmlAttributes(
   attributes: Record<string, unknown>,
   baseClass = ""

package/dist/block-renderers.d.ts

@@ -0,0 +1,10 @@
+import type { AstroComponentFactory } from "astro/runtime/server/index.js";
+import type { StyleflowContract } from "./styleflow.js";
+import type { FlowpressBlock } from "./types.js";
+export interface FlowpressBlockRendererProps {
+    block: FlowpressBlock;
+    contract?: StyleflowContract;
+}
+export type FlowpressBlockRenderer = AstroComponentFactory;
+export type FlowpressBlockRenderers = Readonly<Record<string, FlowpressBlockRenderer>>;
+//# sourceMappingURL=block-renderers.d.ts.map

package/dist/block-renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-renderers.d.ts","sourceRoot":"","sources":["../src/block-renderers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAE3D,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAC5C,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CACvC,CAAC"}

package/dist/block-renderers.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=block-renderers.js.map

package/dist/block-renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-renderers.js","sourceRoot":"","sources":["../src/block-renderers.ts"],"names":[],"mappings":"","sourcesContent":["import type { AstroComponentFactory } from \"astro/runtime/server/index.js\";\nimport type { StyleflowContract } from \"./styleflow.js\";\nimport type { FlowpressBlock } from \"./types.js\";\n\nexport interface FlowpressBlockRendererProps {\n  block: FlowpressBlock;\n  contract?: StyleflowContract;\n}\n\nexport type FlowpressBlockRenderer = AstroComponentFactory;\n\nexport type FlowpressBlockRenderers = Readonly<\n  Record<string, FlowpressBlockRenderer>\n>;\n"]}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./client.js";
+export * from "./block-renderers.js";
 export * from "./env.js";
 export * from "./number-spinner.js";
 export * from "./styleflow.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./client.js";
+export * from "./block-renderers.js";
 export * from "./env.js";
 export * from "./number-spinner.js";
 export * from "./styleflow.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./client.js\";\nexport * from \"./env.js\";\nexport * from \"./number-spinner.js\";\nexport * from \"./styleflow.js\";\nexport * from \"./style-classes.js\";\nexport * from \"./template-hierarchy.js\";\nexport * from \"./types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./client.js\";\nexport * from \"./block-renderers.js\";\nexport * from \"./env.js\";\nexport * from \"./number-spinner.js\";\nexport * from \"./styleflow.js\";\nexport * from \"./style-classes.js\";\nexport * from \"./template-hierarchy.js\";\nexport * from \"./types.js\";\n"]}

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/astro.d.ts","../src/client.ts","../src/env.ts","../src/index.ts","../src/number-spinner.ts","../src/style-classes.ts","../src/styleflow.ts","../src/template-hierarchy.ts","../src/templates.ts","../src/types.ts","../src/astro/blocks/helpers.ts"],"version":"5.9.3"}
+{"root":["../src/astro.d.ts","../src/block-renderers.ts","../src/client.ts","../src/env.ts","../src/index.ts","../src/number-spinner.ts","../src/style-classes.ts","../src/styleflow.ts","../src/template-hierarchy.ts","../src/templates.ts","../src/types.ts","../src/astro/blocks/helpers.ts"],"version":"5.9.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@styleflow.app/flowpress-astro-core",
-  "version": "0.2.0-beta.13",
+  "version": "0.2.0-beta.15",
   "description": "Project-agnostic WordPress routing, templates, SEO and GraphQL runtime for FlowPress Astro apps.",
   "type": "module",
   "private": false,
@@ -36,7 +36,8 @@
   "scripts": {
     "build": "tsc -b && node ./scripts/copy-astro.mjs",
     "typecheck": "tsc -b --pretty false && node ./scripts/copy-astro.mjs && astro check",
-    "test": "vitest run",
+    "test": "vitest run && npm run test:renderer",
+    "test:renderer": "node ./scripts/test-custom-renderer.mjs",
     "release:check": "npm run typecheck && npm test && npm pack --dry-run",
     "release:publish:next": "npm publish --access public --tag next",
     "release:publish:latest": "npm publish --access public --tag latest",