@styleflow.app/flowpress-astro-core 0.2.0-beta.9 → 1.0.0-beta.1

package/dist/astro/blocks/ImageBlock.astro

@@ -0,0 +1,90 @@
+---
+import S from "@styleflow.app/astro/S.astro";
+import type { StyleflowContract } from "../../styleflow.js";
+import type { FlowpressBlock } from "../../types.js";
+import {
+  blockHtmlAttributes,
+  semanticProps
+} from "./helpers.js";
+
+interface Props {
+  block: FlowpressBlock;
+  contract?: StyleflowContract;
+}
+
+type ImageLoading = "eager" | "lazy";
+type ImageDecoding = "async" | "auto" | "sync";
+type ImageFetchPriority = "auto" | "high" | "low";
+
+const { block, contract } = Astro.props;
+const attributes = block.attributes;
+const media = attributes.image && typeof attributes.image === "object"
+  ? attributes.image as Record<string, unknown>
+  : {};
+
+function text(value: unknown): string {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function positiveInteger(value: unknown): number | undefined {
+  const number = typeof value === "number" ? value : Number(value);
+  return Number.isInteger(number) && number > 0 ? number : undefined;
+}
+
+function loadingValue(value: unknown): ImageLoading {
+  return value === "eager" ? "eager" : "lazy";
+}
+
+function decodingValue(value: unknown): ImageDecoding {
+  return ["async", "auto", "sync"].includes(String(value))
+    ? String(value) as ImageDecoding
+    : "async";
+}
+
+function fetchPriorityValue(value: unknown): ImageFetchPriority {
+  return ["auto", "high", "low"].includes(String(value))
+    ? String(value) as ImageFetchPriority
+    : "auto";
+}
+
+const src = text(media.url) || text(media.sourceUrl);
+const srcSet = text(media.srcSet) || text(media.srcset);
+const sizes = srcSet
+  ? text(attributes.sizes) || text(media.sizes) || undefined
+  : undefined;
+const alt = typeof attributes.alt === "string"
+  ? attributes.alt
+  : typeof media.alt === "string"
+    ? media.alt
+    : typeof media.altText === "string"
+      ? media.altText
+      : "";
+const imageClassName = text(attributes.imageClassName)
+  .replace(/\s+/g, " ") || undefined;
+const width = positiveInteger(media.width);
+const height = positiveInteger(media.height);
+const loading = loadingValue(attributes.loading);
+const decoding = decodingValue(attributes.decoding);
+const fetchPriority = fetchPriorityValue(attributes.fetchPriority);
+---
+
+{src ? (
+  <S
+    as="div"
+    {...semanticProps(attributes, contract)}
+    {...blockHtmlAttributes(attributes)}
+  >
+    <img
+      src={src}
+      srcset={srcSet || undefined}
+      sizes={sizes}
+      width={width}
+      height={height}
+      alt={alt}
+      class={imageClassName}
+      loading={loading}
+      decoding={decoding}
+      fetchpriority={fetchPriority}
+    />
+  </S>
+) : null}

package/dist/astro/blocks/NumberSpinnerBlock.astro

@@ -0,0 +1,130 @@
+---
+import S from "@styleflow.app/astro/S.astro";
+import {
+  clampSpinnerDuration,
+  spinnerFractionDigits
+} from "../../number-spinner.js";
+import type { StyleflowContract } from "../../styleflow.js";
+import type { FlowpressBlock } from "../../types.js";
+import {
+  blockHtmlAttributes,
+  prefixedTextSemanticProps,
+  semanticProps,
+  textHtmlTag
+} from "./helpers.js";
+
+interface Props {
+  block: FlowpressBlock;
+  contract?: StyleflowContract;
+}
+
+const { block, contract } = Astro.props;
+const attributes = block.attributes;
+const prefix = String(attributes.prefix ?? "");
+const suffix = String(attributes.suffix ?? "");
+const candidateNumber = Number(attributes.number);
+const number = Number.isFinite(candidateNumber) ? candidateNumber : 0;
+const duration = clampSpinnerDuration(attributes.duration);
+const fractionDigits = spinnerFractionDigits(number);
+const locale = Astro.currentLocale ?? "";
+const numberText = String(number);
+const semantic = semanticProps(attributes, contract);
+const htmlAttributes = blockHtmlAttributes(
+  attributes,
+  "flowpress-number-spinner"
+);
+const prefixSemantic = prefixedTextSemanticProps(
+  attributes,
+  "prefix",
+  contract,
+  { ty: "body", v: "md", w: "default", foreground: "primary" }
+);
+const numberSemantic = prefixedTextSemanticProps(
+  attributes,
+  "number",
+  contract,
+  { ty: "heading", v: "2", w: "strong", foreground: "primary" }
+);
+const suffixSemantic = prefixedTextSemanticProps(
+  attributes,
+  "suffix",
+  contract,
+  { ty: "body", v: "md", w: "default", foreground: "primary" }
+);
+const prefixTag = textHtmlTag(attributes.prefixTag);
+const numberTag = textHtmlTag(attributes.numberTag);
+const suffixTag = textHtmlTag(attributes.suffixTag);
+---
+
+<S
+  as="div"
+  {...semantic}
+  {...htmlAttributes}
+  data-flowpress-number-spinner
+  data-spinner-target={number}
+  data-spinner-duration={duration}
+  data-spinner-fraction-digits={fractionDigits}
+  data-spinner-locale={locale || undefined}
+>
+  {prefix ? (
+    <S
+      as={prefixTag}
+      class="flowpress-number-spinner__segment"
+      {...prefixSemantic}
+    >
+      {prefix}
+    </S>
+  ) : null}
+  <S
+    as={numberTag}
+    class="flowpress-number-spinner__segment flowpress-number-spinner__number"
+    {...numberSemantic}
+  >
+    <span class="flowpress-number-spinner__accessible-value">
+      {numberText}
+    </span>
+    <span
+      aria-hidden="true"
+      data-flowpress-number-spinner-value
+    >
+      {numberText}
+    </span>
+  </S>
+  {suffix ? (
+    <S
+      as={suffixTag}
+      class="flowpress-number-spinner__segment"
+      {...suffixSemantic}
+    >
+      {suffix}
+    </S>
+  ) : null}
+</S>
+
+<script>
+  import { initializeNumberSpinners } from "../../number-spinner.js";
+
+  initializeNumberSpinners();
+</script>
+
+<style>
+  .flowpress-number-spinner {
+    display: inline-flex;
+    align-items: baseline;
+  }
+
+  .flowpress-number-spinner__segment {
+    display: inline;
+    margin: 0;
+  }
+
+  .flowpress-number-spinner__accessible-value {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    overflow: hidden;
+    clip: rect(0 0 0 0);
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+</style>

package/dist/astro/blocks/TextBlock.astro

@@ -4,8 +4,10 @@ import type { FlowpressBlock } from "../../types.js";
 import type { StyleflowContract } from "../../styleflow.js";
 import {
   blockHtmlAttributes,
+  preserveEmptyTextBlock,
   preserveRichTextSpacing,
   semanticProps,
+  textAlignmentStyle,
   textValue,
   unwrapCoreHtml
 } from "./helpers.js";
@@ -37,29 +39,39 @@ const defaults = heading
     };
 const semantic = semanticProps(attributes, contract, defaults);
 const htmlAttributes = blockHtmlAttributes(attributes);
-const html = name === "heading"
+const alignmentStyle = textAlignmentStyle(attributes);
+const coreHtml = String(
+  attributes.content
+  ?? attributes.value
+  ?? block.innerHtml
+  ?? ""
+);
+const normalizedHtml = name === "heading"
   ? textValue(block)
   : name === "rich-text"
     ? preserveRichTextSpacing(String(attributes.content ?? ""))
     : name === "quote"
       ? textValue(block, "quote")
-      : unwrapCoreHtml(String(attributes.content ?? attributes.value ?? block.innerHtml ?? ""));
+      : unwrapCoreHtml(preserveRichTextSpacing(coreHtml));
+const html = name === "core/list"
+  ? normalizedHtml
+  : preserveEmptyTextBlock(normalizedHtml);
 const listTag = Boolean(attributes.ordered) ? "ol" : "ul";
 ---
 
 {heading ? (
-  <S as={headingTag} {...semantic} {...htmlAttributes} set:html={html} />
+  <S as={headingTag} {...semantic} {...htmlAttributes} style={alignmentStyle} set:html={html} />
 ) : name === "core/list" ? (
-  <S as={listTag} {...semantic} {...htmlAttributes}>
+  <S as={listTag} {...semantic} {...htmlAttributes} style={alignmentStyle}>
     {hasChildren ? <slot /> : <Fragment set:html={html} />}
   </S>
 ) : name === "core/list-item" ? (
-  <S as="li" {...semantic} {...htmlAttributes}>
+  <S as="li" {...semantic} {...htmlAttributes} style={alignmentStyle}>
     <span set:html={html}></span>
     {hasChildren ? <slot /> : null}
   </S>
 ) : name === "quote" || name === "core/quote" ? (
-  <S as="blockquote" {...semantic} {...htmlAttributes}>
+  <S as="blockquote" {...semantic} {...htmlAttributes} style={alignmentStyle}>
     {hasChildren ? <slot /> : <div set:html={html}></div>}
     {attributes.citation ? <cite>{String(attributes.citation)}</cite> : null}
   </S>
@@ -68,6 +80,7 @@ const listTag = Boolean(attributes.ordered) ? "ol" : "ul";
     as={name === "core/paragraph" ? "p" : "div"}
     {...semantic}
     {...htmlAttributes}
+    style={alignmentStyle}
     set:html={html}
   />
 )}

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

@@ -5,11 +5,19 @@ 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;
 };
+export declare const TEXT_HTML_TAGS: readonly ["span", "p", "h1", "h2", "h3", "h4", "h5", "h6", "strong", "em", "small", "mark"];
+export type TextHtmlTag = (typeof TEXT_HTML_TAGS)[number];
+export declare function textHtmlTag(value: unknown): TextHtmlTag;
 export declare function semanticProps(attributes: Record<string, unknown>, contract?: StyleflowContract, defaults?: Record<string, unknown>): Record<string, unknown>;
+/** Resolve only Gutenberg's supported text-alignment values to inline CSS. */
+export declare function textAlignmentStyle(attributes: Record<string, unknown>): string | undefined;
+export declare function prefixedTextSemanticProps(attributes: Record<string, unknown>, prefix: string, contract?: StyleflowContract, defaults?: Record<string, unknown>): Record<string, unknown>;
 export declare function objectValue(block: FlowpressBlock, key: string): Record<string, unknown>;
 export declare function textValue(block: FlowpressBlock, key?: string): string;
 /**
@@ -18,6 +26,8 @@ export declare function textValue(block: FlowpressBlock, key?: string): string;
  * empty paragraph elements, or literal newlines in an attribute value.
  */
 export declare function preserveRichTextSpacing(html: string): string;
+/** Keep an empty text element at its typographic line height without visible text. */
+export declare function preserveEmptyTextBlock(html: string): string;
 export declare function linkValue(block: FlowpressBlock, key?: string): string;
 export declare function responsiveValues(attributes: Record<string, unknown>, prefix: "columns" | "span", fallback: number): Record<"base" | "sm" | "md" | "lg" | "xl" | "2xl", number>;
 export declare function unwrapCoreHtml(html: string): 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,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,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,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;AAsBD,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,CAoBzB;AAWD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,GAAG,SAAS,CAYpB;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

@@ -2,8 +2,23 @@ import { resolveDynamicStyleflowProps } from "../../styleflow.js";
 export const DEFAULT_SEMANTIC_PROPS = {
     surface: "default",
     layoutRole: "stack",
-    density: "md"
+    density: "regular"
 };
+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()
@@ -21,6 +36,7 @@ export function blockHtmlAttributes(attributes, baseClass = "") {
     };
 }
 const SEMANTIC_KEYS = [
+    "theme",
     "tone",
     "intensity",
     "surface",
@@ -38,13 +54,74 @@ const SEMANTIC_KEYS = [
     "noRadius",
     "noForeground"
 ];
+export const TEXT_HTML_TAGS = [
+    "span",
+    "p",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "strong",
+    "em",
+    "small",
+    "mark"
+];
+export function textHtmlTag(value) {
+    const candidate = String(value ?? "span");
+    return TEXT_HTML_TAGS.includes(candidate)
+        ? candidate
+        : "span";
+}
 export function semanticProps(attributes, contract, defaults = DEFAULT_SEMANTIC_PROPS) {
     const input = Object.fromEntries(SEMANTIC_KEYS
         .filter((key) => attributes[key] !== undefined)
         .map((key) => [key, attributes[key]]));
-    return contract
-        ? resolveDynamicStyleflowProps(input, defaults, contract)
-        : { ...defaults, ...input };
+    if (contract) {
+        return resolveDynamicStyleflowProps(input, defaults, contract, {
+            strict: process.env.NODE_ENV === "production" || process.env.STYLEFLOW_STRICT === "1",
+            onDiagnostic: (diagnostic) => console.warn(`[${diagnostic.code}] ${diagnostic.message}`)
+        });
+    }
+    const resolved = { ...defaults, ...input };
+    for (const key of ["tone", "intensity", "foreground"]) {
+        if (input[key] === "inherit") {
+            delete resolved[key];
+        }
+    }
+    return resolved;
+}
+const TEXT_ALIGNMENTS = new Set([
+    "left",
+    "center",
+    "right",
+    "justify",
+    "start",
+    "end"
+]);
+/** Resolve only Gutenberg's supported text-alignment values to inline CSS. */
+export function textAlignmentStyle(attributes) {
+    const style = attributes.style && typeof attributes.style === "object"
+        && !Array.isArray(attributes.style)
+        ? attributes.style
+        : {};
+    const typography = style.typography && typeof style.typography === "object"
+        && !Array.isArray(style.typography)
+        ? style.typography
+        : {};
+    const candidate = typography.textAlign ?? attributes.textAlign;
+    const alignment = String(candidate ?? "");
+    return TEXT_ALIGNMENTS.has(alignment) ? `text-align: ${alignment};` : undefined;
+}
+export function prefixedTextSemanticProps(attributes, prefix, contract, defaults = {}) {
+    const attributeName = (name) => `${prefix}${name.charAt(0).toUpperCase()}${name.slice(1)}`;
+    return semanticProps({
+        ty: attributes[attributeName("ty")],
+        v: attributes[attributeName("v")],
+        w: attributes[attributeName("w")],
+        foreground: attributes[attributeName("foreground")]
+    }, contract, defaults);
 }
 export function objectValue(block, key) {
     const value = block.attributes[key];
@@ -63,7 +140,7 @@ export function textValue(block, key = "text") {
 export function preserveRichTextSpacing(html) {
     const visibleEmptyBlocks = html
         .replace(/\r\n?/g, "\n")
-        .replace(/<(p|div)(\s[^>]*)?>(?:\s|&nbsp;|&#160;)*<\/\1>/gi, (_match, tag, attributes = "") => `<${tag}${attributes}><br aria-hidden="true"></${tag}>`);
+        .replace(/<(p|div)(\s[^>]*)?>(?:\s|&nbsp;|&#160;)*<\/\1>/gi, (_match, tag, attributes = "") => `<${tag}${attributes}>&nbsp;</${tag}>`);
     return visibleEmptyBlocks
         .split(/(<[^>]+>)/g)
         .map((part) => {
@@ -74,6 +151,10 @@ export function preserveRichTextSpacing(html) {
     })
         .join("");
 }
+/** Keep an empty text element at its typographic line height without visible text. */
+export function preserveEmptyTextBlock(html) {
+    return html.trim() === "" ? "&nbsp;" : html;
+}
 export function linkValue(block, key = "link") {
     const value = block.attributes[key];
     const href = typeof value === "string"

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/astro/blocks/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAE7B,MAAM,oBAAoB,CAAC;AAG5B,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,OAAO;IACnB,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,MAAM,UAAU,mBAAmB,CACjC,UAAmC,EACnC,SAAS,GAAG,EAAE;IAEd,MAAM,MAAM,GAAG,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ;QAClD,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE;QAC1B,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,WAAW,GAAG,OAAO,UAAU,CAAC,SAAS,KAAK,QAAQ;QAC1D,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE;QAC7B,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,SAAS,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC;SAC9C,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAExB,OAAO;QACL,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,aAAa,GAAG;IACpB,MAAM;IACN,WAAW;IACX,SAAS;IACT,YAAY;IACZ,SAAS;IACT,IAAI;IACJ,GAAG;IACH,GAAG;IACH,YAAY;IACZ,qBAAqB;IACrB,cAAc;IACd,UAAU;IACV,WAAW;IACX,OAAO;IACP,UAAU;IACV,cAAc;CACN,CAAC;AAEX,MAAM,UAAU,aAAa,CAC3B,UAAmC,EACnC,QAA4B,EAC5B,WAAoC,sBAAsB;IAE1D,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,aAAa;SACV,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;SAC9C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CACxC,CAAC;IACF,OAAO,QAAQ;QACb,CAAC,CAAC,4BAA4B,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC;QACzD,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAqB,EACrB,GAAW;IAEX,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAqB,EAAE,GAAG,GAAG,MAAM;IAC3D,OAAO,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,kBAAkB,GAAG,IAAI;SAC5B,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,OAAO,CACN,kDAAkD,EAClD,CAAC,MAAM,EAAE,GAAW,EAAE,UAAU,GAAG,EAAE,EAAE,EAAE,CACvC,IAAI,GAAG,GAAG,UAAU,6BAA6B,GAAG,GAAG,CAC1D,CAAC;IAEJ,OAAO,kBAAkB;SACtB,KAAK,CAAC,YAAY,CAAC;SACnB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,EAAE,CACnD,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CACpD,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAqB,EAAE,GAAG,GAAG,MAAM;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ;QACpC,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,2CAA2C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAAmC,EACnC,MAA0B,EAC1B,QAAgB;IAEhB,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAU,CAAC;IAC9D,MAAM,MAAM,GAAG,EAA2C,CAAC;IAC3D,IAAI,SAAS,GAAG,QAAQ,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,GAAG,KAAK,MAAM;YAC3B,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;YACrE,SAAS,GAAG,SAAS,CAAC;QACxB,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAC7B,+DAA+D,CAChE,CAAC;IACF,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC5B,CAAC","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 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 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}><br aria-hidden=\"true\"></${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\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: \"regular\"\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  \"theme\",\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  if (contract) {\n    return resolveDynamicStyleflowProps(input, defaults, contract, {\n      strict: process.env.NODE_ENV === \"production\" || process.env.STYLEFLOW_STRICT === \"1\",\n      onDiagnostic: (diagnostic) => console.warn(`[${diagnostic.code}] ${diagnostic.message}`)\n    });\n  }\n\n  const resolved = { ...defaults, ...input };\n  for (const key of [\"tone\", \"intensity\", \"foreground\"]) {\n    if (input[key] === \"inherit\") {\n      delete resolved[key];\n    }\n  }\n  return resolved;\n}\n\nconst TEXT_ALIGNMENTS = new Set([\n  \"left\",\n  \"center\",\n  \"right\",\n  \"justify\",\n  \"start\",\n  \"end\"\n]);\n\n/** Resolve only Gutenberg's supported text-alignment values to inline CSS. */\nexport function textAlignmentStyle(\n  attributes: Record<string, unknown>\n): string | undefined {\n  const style = attributes.style && typeof attributes.style === \"object\"\n    && !Array.isArray(attributes.style)\n    ? attributes.style as Record<string, unknown>\n    : {};\n  const typography = style.typography && typeof style.typography === \"object\"\n    && !Array.isArray(style.typography)\n    ? style.typography as Record<string, unknown>\n    : {};\n  const candidate = typography.textAlign ?? attributes.textAlign;\n  const alignment = String(candidate ?? \"\");\n  return TEXT_ALIGNMENTS.has(alignment) ? `text-align: ${alignment};` : undefined;\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

@@ -7,9 +7,32 @@ import type { FlowpressBlock } from "../../types.js";
 export const DEFAULT_SEMANTIC_PROPS = {
   surface: "default",
   layoutRole: "stack",
-  density: "md"
+  density: "regular"
 };
 
+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 = ""
@@ -32,6 +55,7 @@ export function blockHtmlAttributes(
 }
 
 const SEMANTIC_KEYS = [
+  "theme",
   "tone",
   "intensity",
   "surface",
@@ -50,6 +74,30 @@ const SEMANTIC_KEYS = [
   "noForeground"
 ] as const;
 
+export const TEXT_HTML_TAGS = [
+  "span",
+  "p",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "strong",
+  "em",
+  "small",
+  "mark"
+] as const;
+
+export type TextHtmlTag = (typeof TEXT_HTML_TAGS)[number];
+
+export function textHtmlTag(value: unknown): TextHtmlTag {
+  const candidate = String(value ?? "span");
+  return TEXT_HTML_TAGS.includes(candidate as TextHtmlTag)
+    ? candidate as TextHtmlTag
+    : "span";
+}
+
 export function semanticProps(
   attributes: Record<string, unknown>,
   contract?: StyleflowContract,
@@ -60,9 +108,62 @@ export function semanticProps(
       .filter((key) => attributes[key] !== undefined)
       .map((key) => [key, attributes[key]])
   );
-  return contract
-    ? resolveDynamicStyleflowProps(input, defaults, contract)
-    : { ...defaults, ...input };
+  if (contract) {
+    return resolveDynamicStyleflowProps(input, defaults, contract, {
+      strict: process.env.NODE_ENV === "production" || process.env.STYLEFLOW_STRICT === "1",
+      onDiagnostic: (diagnostic) => console.warn(`[${diagnostic.code}] ${diagnostic.message}`)
+    });
+  }
+
+  const resolved = { ...defaults, ...input };
+  for (const key of ["tone", "intensity", "foreground"]) {
+    if (input[key] === "inherit") {
+      delete resolved[key];
+    }
+  }
+  return resolved;
+}
+
+const TEXT_ALIGNMENTS = new Set([
+  "left",
+  "center",
+  "right",
+  "justify",
+  "start",
+  "end"
+]);
+
+/** Resolve only Gutenberg's supported text-alignment values to inline CSS. */
+export function textAlignmentStyle(
+  attributes: Record<string, unknown>
+): string | undefined {
+  const style = attributes.style && typeof attributes.style === "object"
+    && !Array.isArray(attributes.style)
+    ? attributes.style as Record<string, unknown>
+    : {};
+  const typography = style.typography && typeof style.typography === "object"
+    && !Array.isArray(style.typography)
+    ? style.typography as Record<string, unknown>
+    : {};
+  const candidate = typography.textAlign ?? attributes.textAlign;
+  const alignment = String(candidate ?? "");
+  return TEXT_ALIGNMENTS.has(alignment) ? `text-align: ${alignment};` : undefined;
+}
+
+export function prefixedTextSemanticProps(
+  attributes: Record<string, unknown>,
+  prefix: string,
+  contract?: StyleflowContract,
+  defaults: Record<string, unknown> = {}
+): Record<string, unknown> {
+  const attributeName = (name: string) =>
+    `${prefix}${name.charAt(0).toUpperCase()}${name.slice(1)}`;
+  return semanticProps({
+    ty: attributes[attributeName("ty")],
+    v: attributes[attributeName("v")],
+    w: attributes[attributeName("w")],
+    foreground: attributes[attributeName("foreground")]
+  }, contract, defaults);
 }
 
 export function objectValue(
@@ -90,7 +191,7 @@ export function preserveRichTextSpacing(html: string): string {
     .replace(
       /<(p|div)(\s[^>]*)?>(?:\s|&nbsp;|&#160;)*<\/\1>/gi,
       (_match, tag: string, attributes = "") =>
-        `<${tag}${attributes}><br aria-hidden="true"></${tag}>`
+        `<${tag}${attributes}>&nbsp;</${tag}>`
     );
 
   return visibleEmptyBlocks
@@ -106,6 +207,11 @@ export function preserveRichTextSpacing(html: string): string {
     .join("");
 }
 
+/** Keep an empty text element at its typographic line height without visible text. */
+export function preserveEmptyTextBlock(html: string): string {
+  return html.trim() === "" ? "&nbsp;" : html;
+}
+
 export function linkValue(block: FlowpressBlock, key = "link"): string {
   const value = block.attributes[key];
   const href = typeof value === "string"