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

package/dist/astro/blocks/CarouselBlock.astro

@@ -0,0 +1,198 @@
+---
+import "@splidejs/splide/css/core";
+import S from "@styleflow.app/astro/S.astro";
+import { carouselOptions, carouselSettings } from "../../carousel.js";
+import type { FlowpressBlock } from "../../types.js";
+import type { StyleflowContract } from "../../styleflow.js";
+import { blockHtmlAttributes, semanticProps } from "./helpers.js";
+
+interface Props {
+  block: FlowpressBlock;
+  contract?: StyleflowContract;
+  validChildren: boolean;
+  invalidChildNames?: string[];
+}
+
+const { block, contract, validChildren, invalidChildNames = [] } = Astro.props;
+const settings = carouselSettings(block.attributes);
+const options = carouselOptions(settings);
+const semantic = semanticProps(block.attributes, contract, {
+  surface: "default",
+  layoutRole: "container",
+  density: "regular"
+});
+const htmlAttributes = blockHtmlAttributes(
+  block.attributes,
+  `flowpress-carousel${validChildren ? " splide" : " flowpress-carousel--static"}`
+);
+const style = [
+  `--flowpress-carousel-gap:${settings.gap}px`,
+  `--flowpress-carousel-base:${settings.itemsPerView.base}`,
+  `--flowpress-carousel-sm:${settings.itemsPerView.sm}`,
+  `--flowpress-carousel-md:${settings.itemsPerView.md}`,
+  `--flowpress-carousel-lg:${settings.itemsPerView.lg}`,
+  `--flowpress-carousel-xl:${settings.itemsPerView.xl}`,
+  `--flowpress-carousel-2xl:${settings.itemsPerView["2xl"]}`
+].join(";");
+
+if (!validChildren && import.meta.env.DEV) {
+  console.warn(
+    `[flowpress-carousel-invalid-children] sf/carousel accepts only sf/carousel-item; received: ${invalidChildNames.join(", ") || "unknown"}. Rendering static content.`
+  );
+}
+---
+
+{validChildren ? (
+  <flowpress-carousel>
+    <S.section
+      {...semantic}
+      {...htmlAttributes}
+      aria-label={settings.ariaLabel}
+      data-flowpress-carousel-root
+      data-carousel-options={JSON.stringify(options)}
+      style={style}
+    >
+      {settings.showArrows ? (
+        <div class="splide__arrows" data-flowpress-carousel-controls>
+          <button class="splide__arrow splide__arrow--prev" type="button">
+            <span aria-hidden="true">←</span>
+          </button>
+          <button class="splide__arrow splide__arrow--next" type="button">
+            <span aria-hidden="true">→</span>
+          </button>
+        </div>
+      ) : null}
+      <div class="splide__track">
+        <ul class="splide__list">
+          <slot />
+        </ul>
+      </div>
+      {settings.showPagination ? <ul class="splide__pagination"></ul> : null}
+      {settings.autoplay ? (
+        <button
+          class="splide__toggle"
+          type="button"
+          data-flowpress-carousel-controls
+        >
+          <span class="splide__toggle__play">Avvia</span>
+          <span class="splide__toggle__pause">Pausa</span>
+        </button>
+      ) : null}
+    </S.section>
+  </flowpress-carousel>
+) : (
+  <S.section
+    {...semantic}
+    {...htmlAttributes}
+    aria-label={settings.ariaLabel}
+    data-flowpress-carousel-invalid
+    data-invalid-children={invalidChildNames.join(",")}
+    style={style}
+  >
+    <slot />
+  </S.section>
+)}
+
+<script>
+  import Splide from "@splidejs/splide";
+  import type { Options } from "@splidejs/splide";
+
+  if (!customElements.get("flowpress-carousel")) {
+    customElements.define("flowpress-carousel", class extends HTMLElement {
+      private instance?: Splide;
+
+      connectedCallback() {
+        if (this.instance) return;
+        const root = this.querySelector<HTMLElement>("[data-flowpress-carousel-root]");
+        if (!root) return;
+        try {
+          const options = JSON.parse(root.dataset.carouselOptions || "{}") as Options;
+          this.instance = new Splide(root, options);
+          this.instance.mount();
+        } catch (error) {
+          console.error("[flowpress-carousel-init] Unable to initialize carousel.", error);
+        }
+      }
+
+      disconnectedCallback() {
+        this.instance?.destroy(true);
+        this.instance = undefined;
+      }
+    });
+  }
+</script>
+
+<style>
+  flowpress-carousel { display: block; }
+  .flowpress-carousel { min-width: 0; }
+  .flowpress-carousel:not(.is-initialized) .splide__list {
+    display: grid;
+    grid-template-columns: repeat(var(--flowpress-carousel-base), minmax(0, 1fr));
+    gap: var(--flowpress-carousel-gap);
+  }
+  .flowpress-carousel:not(.is-initialized) [data-flowpress-carousel-controls],
+  .flowpress-carousel:not(.is-initialized) .splide__pagination {
+    display: none;
+  }
+  .flowpress-carousel--static {
+    display: grid;
+    gap: var(--flowpress-carousel-gap);
+  }
+  .splide__arrows {
+    display: flex;
+    justify-content: space-between;
+    gap: 0.5rem;
+    margin-block-end: 0.75rem;
+  }
+  .splide__arrow:disabled { opacity: 0.45; }
+  .splide__pagination {
+    display: flex;
+    justify-content: center;
+    gap: 0.5rem;
+    margin: 0.75rem 0 0;
+    padding: 0;
+  }
+  :global(.splide__pagination__page) {
+    width: 0.75rem;
+    height: 0.75rem;
+    border-radius: 999px;
+  }
+  .splide__toggle { margin-block-start: 0.75rem; }
+  .splide__toggle__pause { display: none; }
+  .splide__toggle.is-active .splide__toggle__play { display: none; }
+  .splide__toggle.is-active .splide__toggle__pause { display: inline; }
+  .splide__arrow:focus-visible,
+  :global(.splide__pagination__page:focus-visible),
+  .splide__toggle:focus-visible {
+    outline: 3px solid currentColor;
+    outline-offset: 3px;
+  }
+  @media (min-width: 40rem) {
+    .flowpress-carousel:not(.is-initialized) .splide__list {
+      grid-template-columns: repeat(var(--flowpress-carousel-sm), minmax(0, 1fr));
+    }
+  }
+  @media (min-width: 48rem) {
+    .flowpress-carousel:not(.is-initialized) .splide__list {
+      grid-template-columns: repeat(var(--flowpress-carousel-md), minmax(0, 1fr));
+    }
+  }
+  @media (min-width: 64rem) {
+    .flowpress-carousel:not(.is-initialized) .splide__list {
+      grid-template-columns: repeat(var(--flowpress-carousel-lg), minmax(0, 1fr));
+    }
+  }
+  @media (min-width: 80rem) {
+    .flowpress-carousel:not(.is-initialized) .splide__list {
+      grid-template-columns: repeat(var(--flowpress-carousel-xl), minmax(0, 1fr));
+    }
+  }
+  @media (min-width: 96rem) {
+    .flowpress-carousel:not(.is-initialized) .splide__list {
+      grid-template-columns: repeat(var(--flowpress-carousel-2xl), minmax(0, 1fr));
+    }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .flowpress-carousel * { scroll-behavior: auto !important; }
+  }
+</style>

package/dist/astro/blocks/CarouselItemBlock.astro

@@ -0,0 +1,26 @@
+---
+import S from "@styleflow.app/astro/S.astro";
+import type { FlowpressBlock } from "../../types.js";
+import type { StyleflowContract } from "../../styleflow.js";
+import { blockHtmlAttributes, semanticProps } from "./helpers.js";
+
+interface Props {
+  block: FlowpressBlock;
+  contract?: StyleflowContract;
+}
+
+const { block, contract } = Astro.props;
+const semantic = semanticProps(block.attributes, contract);
+const htmlAttributes = blockHtmlAttributes(
+  block.attributes,
+  "splide__slide flowpress-carousel-item"
+);
+---
+
+<S.li {...semantic} {...htmlAttributes}>
+  <slot />
+</S.li>
+
+<style>
+  .flowpress-carousel-item { min-width: 0; }
+</style>

package/dist/astro/blocks/ColumnBlock.astro

@@ -33,8 +33,7 @@ const style = [
 ].join(";");
 ---
 
-<S
-  as="div"
+<S.div
   {...semantic}
   {...htmlAttributes}
   data-partial={partial}
@@ -42,7 +41,7 @@ const style = [
   style={style}
 >
   <slot />
-</S>
+</S.div>
 
 <style>
   .flowpress-column {

package/dist/astro/blocks/FormBlock.astro

@@ -39,11 +39,11 @@ const optionLabel = (field: FormField, index: number): string =>
 ---
 
 {schema?.available ? (
-  <S as="div" {...semantic} {...htmlAttributes}>
+  <S.div {...semantic} {...htmlAttributes}>
     <flowpress-cf7-form>
       <form action={schema.submitUrl} method="post" enctype="multipart/form-data" novalidate>
         {block.attributes.title || schema.title ? (
-          <S as="h2">{String(block.attributes.title || schema.title)}</S>
+          <S.h2>{String(block.attributes.title || schema.title)}</S.h2>
         ) : null}
         {schema.fields.map((field) => {
           if (field.type === "submit") {
@@ -130,11 +130,11 @@ const optionLabel = (field: FormField, index: number): string =>
         <p data-form-status role="status" aria-live="polite"></p>
       </form>
     </flowpress-cf7-form>
-  </S>
+  </S.div>
 ) : (
-  <S as="p" {...semantic} {...htmlAttributes} role="status">
+  <S.p {...semantic} {...htmlAttributes} role="status">
     Il modulo non è temporaneamente disponibile.
-  </S>
+  </S.p>
 )}
 
 <script>

package/dist/astro/blocks/GridBlock.astro

@@ -38,9 +38,9 @@ const style = [
 ].join(";");
 ---
 
-<S as="div" {...semantic} {...htmlAttributes} data-align={align} style={style}>
+<S.div {...semantic} {...htmlAttributes} data-align={align} style={style}>
   <slot />
-</S>
+</S.div>
 
 <style>
   .flowpress-grid {

package/dist/astro/blocks/HeroBlock.astro

@@ -34,8 +34,7 @@ const scrimEnabled = Boolean(attributes.scrimEnabled) && backgroundType !== "col
 const scrimIntensity = Math.min(10, Math.max(1, Number(attributes.scrimIntensity) || 6));
 ---
 
-<S
-  as="section"
+<S.section
   {...semantic}
   {...htmlAttributes}
   style={[
@@ -71,7 +70,7 @@ const scrimIntensity = Math.min(10, Math.max(1, Number(attributes.scrimIntensity
   <div class="flowpress-hero__content">
     <slot />
   </div>
-</S>
+</S.section>
 
 <style>
   .flowpress-hero {

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

@@ -1,5 +1,6 @@
 ---
 import S from "@styleflow.app/astro/S.astro";
+import { flowpressLinkHref } from "../../links.js";
 
 interface Props {
   item: Record<string, unknown>;
@@ -9,6 +10,7 @@ const { item } = Astro.props;
 const image = item.image && typeof item.image === "object" && !Array.isArray(item.image)
   ? item.image as Record<string, unknown>
   : {};
+const href = flowpressLinkHref(item.uri);
 ---
 
 {image.url ? (
@@ -19,10 +21,10 @@ const image = item.image && typeof item.image === "object" && !Array.isArray(ite
     decoding="async"
   />
 ) : null}
-{item.uri ? (
-  <S as="a" href={String(item.uri)}>{String(item.title ?? "")}</S>
+{href ? (
+  <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;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"}
+{"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"}