@styleflow.app/flowpress-astro-core 1.0.0-beta.5 → 1.0.0-beta.6

package/dist/astro/blocks/ImageBlock.astro

@@ -69,8 +69,7 @@ const fetchPriority = fetchPriorityValue(attributes.fetchPriority);
 ---
 
 {src ? (
-  <S
-    as="div"
+  <S.div
     {...semanticProps(attributes, contract)}
     {...blockHtmlAttributes(attributes)}
   >
@@ -86,5 +85,5 @@ const fetchPriority = fetchPriorityValue(attributes.fetchPriority);
       decoding={decoding}
       fetchpriority={fetchPriority}
     />
-  </S>
+  </S.div>
 ) : null}

package/dist/astro/blocks/ListItemFallback.astro

@@ -22,9 +22,9 @@ const href = flowpressLinkHref(item.uri);
   />
 ) : null}
 {href ? (
-  <S as="a" href={href}>{String(item.title ?? "")}</S>
+  <S.a href={href}>{String(item.title ?? "")}</S.a>
 ) : (
-  <S as="span">{String(item.title ?? "")}</S>
+  <S.span>{String(item.title ?? "")}</S.span>
 )}
-{item.excerpt ? <S as="p">{String(item.excerpt)}</S> : null}
-{item.priceHtml ? <S as="div" set:html={String(item.priceHtml)} /> : null}
+{item.excerpt ? <S.p>{String(item.excerpt)}</S.p> : null}
+{item.priceHtml ? <S.div set:html={String(item.priceHtml)} /> : null}

package/dist/astro/blocks/NumberSpinnerBlock.astro

@@ -12,6 +12,7 @@ import {
   semanticProps,
   textHtmlTag
 } from "./helpers.js";
+import SemanticElement from "./SemanticElement.astro";
 
 interface Props {
   block: FlowpressBlock;
@@ -56,8 +57,7 @@ const numberTag = textHtmlTag(attributes.numberTag);
 const suffixTag = textHtmlTag(attributes.suffixTag);
 ---
 
-<S
-  as="div"
+<S.div
   {...semantic}
   {...htmlAttributes}
   data-flowpress-number-spinner
@@ -67,18 +67,22 @@ const suffixTag = textHtmlTag(attributes.suffixTag);
   data-spinner-locale={locale || undefined}
 >
   {prefix ? (
-    <S
-      as={prefixTag}
-      class="flowpress-number-spinner__segment"
-      {...prefixSemantic}
+    <SemanticElement
+      tag={prefixTag}
+      attributes={{
+        class: "flowpress-number-spinner__segment",
+        ...prefixSemantic
+      }}
     >
       {prefix}
-    </S>
+    </SemanticElement>
   ) : null}
-  <S
-    as={numberTag}
-    class="flowpress-number-spinner__segment flowpress-number-spinner__number"
-    {...numberSemantic}
+  <SemanticElement
+    tag={numberTag}
+    attributes={{
+      class: "flowpress-number-spinner__segment flowpress-number-spinner__number",
+      ...numberSemantic
+    }}
   >
     <span class="flowpress-number-spinner__accessible-value">
       {numberText}
@@ -89,17 +93,19 @@ const suffixTag = textHtmlTag(attributes.suffixTag);
     >
       {numberText}
     </span>
-  </S>
+  </SemanticElement>
   {suffix ? (
-    <S
-      as={suffixTag}
-      class="flowpress-number-spinner__segment"
-      {...suffixSemantic}
+    <SemanticElement
+      tag={suffixTag}
+      attributes={{
+        class: "flowpress-number-spinner__segment",
+        ...suffixSemantic
+      }}
     >
       {suffix}
-    </S>
+    </SemanticElement>
   ) : null}
-</S>
+</S.div>
 
 <script>
   import { initializeNumberSpinners } from "../../number-spinner.js";

package/dist/astro/blocks/SemanticElement.astro

@@ -0,0 +1,35 @@
+---
+import S from "@styleflow.app/astro/S.astro";
+
+type SemanticElementTag =
+  | "div" | "span" | "p" | "a" | "li" | "ol" | "ul" | "blockquote"
+  | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "strong" | "em"
+  | "small" | "mark";
+
+interface Props {
+  tag: SemanticElementTag;
+  attributes?: Record<string, unknown>;
+  html?: string;
+}
+
+const { tag, attributes = {}, html } = Astro.props;
+---
+
+{tag === "div" ? <S.div {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.div>
+  : tag === "span" ? <S.span {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.span>
+  : tag === "p" ? <S.p {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.p>
+  : tag === "a" ? <S.a {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.a>
+  : tag === "li" ? <S.li {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.li>
+  : tag === "ol" ? <S.ol {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.ol>
+  : tag === "ul" ? <S.ul {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.ul>
+  : tag === "blockquote" ? <S.blockquote {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.blockquote>
+  : tag === "h1" ? <S.h1 {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.h1>
+  : tag === "h2" ? <S.h2 {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.h2>
+  : tag === "h3" ? <S.h3 {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.h3>
+  : tag === "h4" ? <S.h4 {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.h4>
+  : tag === "h5" ? <S.h5 {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.h5>
+  : tag === "h6" ? <S.h6 {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.h6>
+  : tag === "strong" ? <S.strong {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.strong>
+  : tag === "em" ? <S.em {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.em>
+  : tag === "small" ? <S.small {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.small>
+  : <S.mark {...attributes}>{html === undefined ? <slot /> : <Fragment set:html={html} />}</S.mark>}

package/dist/astro/blocks/SiteLogoBlock.astro

@@ -0,0 +1,53 @@
+---
+import S from "@styleflow.app/astro/S.astro";
+import type { FlowpressBlockRendererProps } from "../../block-renderers.js";
+
+type LogoImage = { url?: string; width?: number; height?: number; alt?: string };
+type LogoData = {
+  images?: { positive?: LogoImage; negative?: LogoImage };
+  homeUrl?: string;
+  override?: "auto" | "positive" | "negative";
+};
+
+const { block, styleflowProps, htmlProps } = Astro.props as FlowpressBlockRendererProps;
+const data = (block.resolvedData ?? {}) as LogoData;
+const positive = data.images?.positive ?? {};
+const negative = data.images?.negative ?? {};
+const homeUrl = typeof data.homeUrl === "string" && data.homeUrl ? data.homeUrl : "/";
+const override = data.override === "positive" || data.override === "negative"
+  ? data.override
+  : "auto";
+const rootHtmlProps = {
+  ...htmlProps,
+  class: ["flowpress-site-logo", htmlProps.class].filter(Boolean).join(" ")
+};
+---
+
+{positive.url || negative.url ? (
+  <S.a
+    {...rootHtmlProps}
+    {...styleflowProps}
+    href={homeUrl}
+    data-flowpress-logo-override={override === "auto" ? undefined : override}
+    aria-label="Home"
+  >
+    {positive.url ? (
+      <img
+        class="flowpress-site-logo__image flowpress-site-logo__image--positive"
+        src={positive.url}
+        width={positive.width || undefined}
+        height={positive.height || undefined}
+        alt={positive.alt ?? ""}
+      />
+    ) : null}
+    {negative.url ? (
+      <img
+        class="flowpress-site-logo__image flowpress-site-logo__image--negative"
+        src={negative.url}
+        width={negative.width || undefined}
+        height={negative.height || undefined}
+        alt={negative.alt ?? ""}
+      />
+    ) : null}
+  </S.a>
+) : null}

package/dist/astro/blocks/TextBlock.astro

@@ -7,10 +7,12 @@ import {
   preserveEmptyTextBlock,
   preserveRichTextSpacing,
   semanticProps,
+  textBlockSemanticDefaults,
   textAlignmentStyle,
   textValue,
   unwrapCoreHtml
 } from "./helpers.js";
+import SemanticElement from "./SemanticElement.astro";
 
 interface Props {
   block: FlowpressBlock;
@@ -24,19 +26,7 @@ const attributes = block.attributes;
 const heading = name === "heading" || name === "core/heading";
 const level = Math.min(6, Math.max(1, Number(attributes.level ?? 2)));
 const headingTag = `h${level}` as "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
-const defaults = heading
-  ? {
-      ty: "heading",
-      v: String(attributes.v ?? attributes.variant ?? level),
-      w: String(attributes.w ?? attributes.weight ?? "strong"),
-      foreground: "primary"
-    }
-  : {
-      ty: "body",
-      v: String(attributes.v ?? (name.includes("quote") ? "lg" : "md")),
-      w: String(attributes.w ?? "default"),
-      foreground: "primary"
-    };
+const defaults = textBlockSemanticDefaults(name, attributes, contract);
 const semantic = semanticProps(attributes, contract, defaults);
 const htmlAttributes = blockHtmlAttributes(attributes);
 const alignmentStyle = textAlignmentStyle(attributes);
@@ -60,24 +50,38 @@ const listTag = Boolean(attributes.ordered) ? "ol" : "ul";
 ---
 
 {heading ? (
-  <S as={headingTag} {...semantic} {...htmlAttributes} style={alignmentStyle} set:html={html} />
+  <SemanticElement
+    tag={headingTag}
+    attributes={{ ...semantic, ...htmlAttributes, style: alignmentStyle }}
+    html={html}
+  />
 ) : name === "core/list" ? (
-  <S as={listTag} {...semantic} {...htmlAttributes} style={alignmentStyle}>
-    {hasChildren ? <slot /> : <Fragment set:html={html} />}
-  </S>
+  <SemanticElement
+    tag={listTag}
+    attributes={{ ...semantic, ...htmlAttributes, style: alignmentStyle }}
+    html={hasChildren ? undefined : html}
+  >
+    {hasChildren ? <slot /> : null}
+  </SemanticElement>
 ) : name === "core/list-item" ? (
-  <S as="li" {...semantic} {...htmlAttributes} style={alignmentStyle}>
+  <S.li {...semantic} {...htmlAttributes} style={alignmentStyle}>
     <span set:html={html}></span>
     {hasChildren ? <slot /> : null}
-  </S>
+  </S.li>
 ) : name === "quote" || name === "core/quote" ? (
-  <S as="blockquote" {...semantic} {...htmlAttributes} style={alignmentStyle}>
+  <S.blockquote {...semantic} {...htmlAttributes} style={alignmentStyle}>
     {hasChildren ? <slot /> : <div set:html={html}></div>}
     {attributes.citation ? <cite>{String(attributes.citation)}</cite> : null}
-  </S>
+  </S.blockquote>
+) : name === "core/paragraph" ? (
+  <S.p
+    {...semantic}
+    {...htmlAttributes}
+    style={alignmentStyle}
+    set:html={html}
+  />
 ) : (
-  <S
-    as={name === "core/paragraph" ? "p" : "div"}
+  <S.div
     {...semantic}
     {...htmlAttributes}
     style={alignmentStyle}

package/dist/astro/blocks/ThemeToggleBlock.astro

@@ -0,0 +1,23 @@
+---
+import S from "@styleflow.app/astro/S.astro";
+import type { FlowpressBlockRendererProps } from "../../block-renderers.js";
+
+const { block, styleflowProps, htmlProps, composition } = Astro.props as FlowpressBlockRendererProps;
+const label = typeof block.attributes.label === "string" && block.attributes.label.trim()
+  ? block.attributes.label.trim()
+  : "Change color theme";
+const showThemeName = block.attributes.showThemeName !== false;
+const themeName = "Theme";
+---
+
+<S.button
+  {...htmlProps}
+  {...styleflowProps}
+  type="button"
+  aria-label={label}
+  data-styleflow-theme-toggle
+>
+  <span data-styleflow-theme-label aria-hidden="true">
+    {showThemeName ? String(themeName) : "Theme"}
+  </span>
+</S.button>

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

@@ -13,6 +13,13 @@ export declare function blockHtmlAttributes(attributes: Record<string, unknown>,
 };
 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];
+/**
+ * Derive a variant only when Gutenberg omitted it. The selected typography
+ * type can differ from the block's native type, so a paragraph styled as a
+ * heading must not inherit the paragraph-only `md` variant.
+ */
+export declare function compatibleTypographyVariant(type: string, preferred: string, contract?: StyleflowContract): string;
+export declare function textBlockSemanticDefaults(blockName: string, attributes: Record<string, unknown>, contract?: StyleflowContract): Record<string, unknown>;
 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. */

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;AAGrD,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,CAErE;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;AAGrD,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;AAED,eAAO,MAAM,cAAc,6FAajB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAQ1D;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,MAAM,CAcR;AAED,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB;AAED,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,CAKzB;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,CAErE;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

@@ -1,4 +1,4 @@
-import { resolveDynamicStyleflowProps } from "../../styleflow.js";
+import { resolveFlowpressBlockStyleflowProps } from "../../styleflow.js";
 import { flowpressLinkHref } from "../../links.js";
 export const DEFAULT_SEMANTIC_PROPS = {
     surface: "default",
@@ -36,25 +36,6 @@ export function blockHtmlAttributes(attributes, baseClass = "") {
         ...(className ? { class: className } : {})
     };
 }
-const SEMANTIC_KEYS = [
-    "theme",
-    "tone",
-    "intensity",
-    "surface",
-    "layoutRole",
-    "density",
-    "ty",
-    "v",
-    "w",
-    "foreground",
-    "interactivePriority",
-    "noBackground",
-    "noBorder",
-    "noPadding",
-    "noGap",
-    "noRadius",
-    "noForeground"
-];
 export const TEXT_HTML_TAGS = [
     "span",
     "p",
@@ -69,6 +50,50 @@ export const TEXT_HTML_TAGS = [
     "small",
     "mark"
 ];
+function preferredTypographyVariant(type) {
+    if (type === "heading")
+        return "2";
+    if (type === "body" || type === "label" || type === "code")
+        return "md";
+    return undefined;
+}
+/**
+ * Derive a variant only when Gutenberg omitted it. The selected typography
+ * type can differ from the block's native type, so a paragraph styled as a
+ * heading must not inherit the paragraph-only `md` variant.
+ */
+export function compatibleTypographyVariant(type, preferred, contract) {
+    const variants = contract?.semantic.axes.typography.variantsByType[type];
+    if (!variants?.length)
+        return preferred;
+    return [
+        preferredTypographyVariant(type),
+        preferred,
+        contract?.semantic.agentPolicy.defaults.typography.ty === type
+            ? contract.semantic.agentPolicy.defaults.typography.v
+            : undefined,
+        variants[0]
+    ].find((candidate) => (typeof candidate === "string" && variants.includes(candidate))) ?? preferred;
+}
+export function textBlockSemanticDefaults(blockName, attributes, contract) {
+    const name = blockName.replace(/^sf\//, "");
+    const heading = name === "heading" || name === "core/heading";
+    const level = Math.min(6, Math.max(1, Number(attributes.level ?? 2)));
+    const defaultType = heading ? "heading" : "body";
+    const activeType = String(attributes.ty ?? defaultType);
+    const nativeVariant = heading
+        ? String(level)
+        : name.includes("quote") ? "lg" : "md";
+    const authoredVariant = attributes.v ?? attributes.variant;
+    return {
+        ty: defaultType,
+        v: authoredVariant === undefined
+            ? compatibleTypographyVariant(activeType, nativeVariant, contract)
+            : String(authoredVariant),
+        w: String(attributes.w ?? attributes.weight ?? (heading ? "strong" : "default")),
+        foreground: "primary"
+    };
+}
 export function textHtmlTag(value) {
     const candidate = String(value ?? "span");
     return TEXT_HTML_TAGS.includes(candidate)
@@ -76,22 +101,10 @@ export function textHtmlTag(value) {
         : "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]]));
-    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;
+    return resolveFlowpressBlockStyleflowProps(attributes, contract, defaults, {
+        strict: process.env.NODE_ENV === "production" || process.env.STYLEFLOW_STRICT === "1",
+        onDiagnostic: (diagnostic) => console.warn(`[${diagnostic.code}] ${diagnostic.message}`)
+    });
 }
 const TEXT_ALIGNMENTS = new Set([
     "left",

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\";\nimport { flowpressLinkHref } from \"../../links.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  return flowpressLinkHref(block.attributes[key]);\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  resolveFlowpressBlockStyleflowProps,\n  type StyleflowContract\n} from \"../../styleflow.js\";\nimport type { FlowpressBlock } from \"../../types.js\";\nimport { flowpressLinkHref } from \"../../links.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\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\nfunction preferredTypographyVariant(type: string): string | undefined {\n  if (type === \"heading\") return \"2\";\n  if (type === \"body\" || type === \"label\" || type === \"code\") return \"md\";\n  return undefined;\n}\n\n/**\n * Derive a variant only when Gutenberg omitted it. The selected typography\n * type can differ from the block's native type, so a paragraph styled as a\n * heading must not inherit the paragraph-only `md` variant.\n */\nexport function compatibleTypographyVariant(\n  type: string,\n  preferred: string,\n  contract?: StyleflowContract\n): string {\n  const variants = contract?.semantic.axes.typography.variantsByType[type];\n  if (!variants?.length) return preferred;\n\n  return [\n    preferredTypographyVariant(type),\n    preferred,\n    contract?.semantic.agentPolicy.defaults.typography.ty === type\n      ? contract.semantic.agentPolicy.defaults.typography.v\n      : undefined,\n    variants[0]\n  ].find((candidate): candidate is string => (\n    typeof candidate === \"string\" && variants.includes(candidate)\n  )) ?? preferred;\n}\n\nexport function textBlockSemanticDefaults(\n  blockName: string,\n  attributes: Record<string, unknown>,\n  contract?: StyleflowContract\n): Record<string, unknown> {\n  const name = blockName.replace(/^sf\\//, \"\");\n  const heading = name === \"heading\" || name === \"core/heading\";\n  const level = Math.min(6, Math.max(1, Number(attributes.level ?? 2)));\n  const defaultType = heading ? \"heading\" : \"body\";\n  const activeType = String(attributes.ty ?? defaultType);\n  const nativeVariant = heading\n    ? String(level)\n    : name.includes(\"quote\") ? \"lg\" : \"md\";\n  const authoredVariant = attributes.v ?? attributes.variant;\n\n  return {\n    ty: defaultType,\n    v: authoredVariant === undefined\n      ? compatibleTypographyVariant(activeType, nativeVariant, contract)\n      : String(authoredVariant),\n    w: String(attributes.w ?? attributes.weight ?? (heading ? \"strong\" : \"default\")),\n    foreground: \"primary\"\n  };\n}\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  return resolveFlowpressBlockStyleflowProps(attributes, contract, defaults, {\n    strict: process.env.NODE_ENV === \"production\" || process.env.STYLEFLOW_STRICT === \"1\",\n    onDiagnostic: (diagnostic) => console.warn(`[${diagnostic.code}] ${diagnostic.message}`)\n  });\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  return flowpressLinkHref(block.attributes[key]);\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

@@ -1,5 +1,5 @@
 import {
-  resolveDynamicStyleflowProps,
+  resolveFlowpressBlockStyleflowProps,
   type StyleflowContract
 } from "../../styleflow.js";
 import type { FlowpressBlock } from "../../types.js";
@@ -55,26 +55,6 @@ export function blockHtmlAttributes(
   };
 }
 
-const SEMANTIC_KEYS = [
-  "theme",
-  "tone",
-  "intensity",
-  "surface",
-  "layoutRole",
-  "density",
-  "ty",
-  "v",
-  "w",
-  "foreground",
-  "interactivePriority",
-  "noBackground",
-  "noBorder",
-  "noPadding",
-  "noGap",
-  "noRadius",
-  "noForeground"
-] as const;
-
 export const TEXT_HTML_TAGS = [
   "span",
   "p",
@@ -92,6 +72,62 @@ export const TEXT_HTML_TAGS = [
 
 export type TextHtmlTag = (typeof TEXT_HTML_TAGS)[number];
 
+function preferredTypographyVariant(type: string): string | undefined {
+  if (type === "heading") return "2";
+  if (type === "body" || type === "label" || type === "code") return "md";
+  return undefined;
+}
+
+/**
+ * Derive a variant only when Gutenberg omitted it. The selected typography
+ * type can differ from the block's native type, so a paragraph styled as a
+ * heading must not inherit the paragraph-only `md` variant.
+ */
+export function compatibleTypographyVariant(
+  type: string,
+  preferred: string,
+  contract?: StyleflowContract
+): string {
+  const variants = contract?.semantic.axes.typography.variantsByType[type];
+  if (!variants?.length) return preferred;
+
+  return [
+    preferredTypographyVariant(type),
+    preferred,
+    contract?.semantic.agentPolicy.defaults.typography.ty === type
+      ? contract.semantic.agentPolicy.defaults.typography.v
+      : undefined,
+    variants[0]
+  ].find((candidate): candidate is string => (
+    typeof candidate === "string" && variants.includes(candidate)
+  )) ?? preferred;
+}
+
+export function textBlockSemanticDefaults(
+  blockName: string,
+  attributes: Record<string, unknown>,
+  contract?: StyleflowContract
+): Record<string, unknown> {
+  const name = blockName.replace(/^sf\//, "");
+  const heading = name === "heading" || name === "core/heading";
+  const level = Math.min(6, Math.max(1, Number(attributes.level ?? 2)));
+  const defaultType = heading ? "heading" : "body";
+  const activeType = String(attributes.ty ?? defaultType);
+  const nativeVariant = heading
+    ? String(level)
+    : name.includes("quote") ? "lg" : "md";
+  const authoredVariant = attributes.v ?? attributes.variant;
+
+  return {
+    ty: defaultType,
+    v: authoredVariant === undefined
+      ? compatibleTypographyVariant(activeType, nativeVariant, contract)
+      : String(authoredVariant),
+    w: String(attributes.w ?? attributes.weight ?? (heading ? "strong" : "default")),
+    foreground: "primary"
+  };
+}
+
 export function textHtmlTag(value: unknown): TextHtmlTag {
   const candidate = String(value ?? "span");
   return TEXT_HTML_TAGS.includes(candidate as TextHtmlTag)
@@ -104,25 +140,10 @@ export function semanticProps(
   contract?: StyleflowContract,
   defaults: Record<string, unknown> = DEFAULT_SEMANTIC_PROPS
 ): Record<string, unknown> {
-  const input = Object.fromEntries(
-    SEMANTIC_KEYS
-      .filter((key) => attributes[key] !== undefined)
-      .map((key) => [key, attributes[key]])
-  );
-  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;
+  return resolveFlowpressBlockStyleflowProps(attributes, contract, defaults, {
+    strict: process.env.NODE_ENV === "production" || process.env.STYLEFLOW_STRICT === "1",
+    onDiagnostic: (diagnostic) => console.warn(`[${diagnostic.code}] ${diagnostic.message}`)
+  });
 }
 
 const TEXT_ALIGNMENTS = new Set([