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

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 ## Unreleased
 
+## 1.0.0-beta.13
+
+- Added `scrimOpacity` as an explicit `0–100` percentage for the official
+  Cover renderer, clamped at the public boundary and emitted through a scoped
+  CSS custom property.
+- Preserved legacy Cover content by using native `dimRatio` as the opacity
+  fallback only when `scrimOpacity` is absent or invalid.
+
+## 1.0.0-beta.12
+
+- Added the official `core/cover` renderer and editable default adapter with
+  image/video media, focal point, validated minimum height, nested content and
+  Styleflow root props.
+- Added prefixed Styleflow coordinates for semantic scrims and kept native
+  `dimRatio` only as a temporary compatibility switch, never as raw CSS.
+- Added a `default` root export so Node CommonJS resolution can locate the ESM
+  entry used by project scaffolding commands.
+
 ## 1.0.0-beta.11
 
 - Made the official default adapter usable by both Site Editor compositions

package/README.md

@@ -9,7 +9,7 @@ The package must not import from an application or project plugin.
 ## Install
 
 ```bash
-pnpm add @styleflow.app/flowpress-astro-core@1.0.0-beta.11 \
+pnpm add @styleflow.app/flowpress-astro-core@1.0.0-beta.13 \
   @styleflow.app/astro@1.0.0-beta.6
 ```
 
@@ -131,6 +131,17 @@ remain composition-only. File discovery never changes a
 source used by scaffolding when `--from-default` is selected. Unsupported
 blocks throw instead of pretending that a semantic implementation exists.
 
+`core/cover` is part of catalog version 2. Its public `CoverBlock.astro`
+renderer accepts the native image/video URL, focal point, content position and
+minimum height, renders nested blocks through a slot and keeps media at
+`object-fit: cover`. The root uses the normal Styleflow props; the overlay uses
+the same validated contract through prefixed attributes such as `scrimTone`,
+`scrimIntensity`, `scrimSurface` and `scrimTheme`. `scrimEnabled` controls its
+presence and `scrimOpacity` accepts an explicit percentage from `0` to `100`.
+Values outside the interval are clamped. Native `dimRatio` remains a
+compatibility input for both activation and opacity when the explicit
+Styleflow-facing fields are absent.
+
 Static adapters produce no JavaScript by default. A project opts into client
 runtime only inside adapters classified as interactive; React views rendered
 without `client:*` remain server-only HTML.
@@ -235,7 +246,7 @@ The TypeScript template-hierarchy suite is self-contained. Its additional PHP
 parity test runs when the sibling `flowpress-wordpress-core` checkout is
 available locally and is skipped in a standalone package checkout.
 
-Publish `1.0.0-beta.11` on `next` only after the exact Styleflow prerelease is
+Publish `1.0.0-beta.13` on `next` only after the exact Styleflow prerelease is
 available. Inspect `npm view`, `gitHead`, integrity and the downloaded tarball.
 Promote to `latest` only after the DMO canary and rollback gate.
 

package/dist/astro/GutenbergRenderer.astro

@@ -19,6 +19,7 @@ import type { DynamicStyleflowProps } from "../styleflow.js";
 import ColumnBlock from "./blocks/ColumnBlock.astro";
 import CarouselBlock from "./blocks/CarouselBlock.astro";
 import CarouselItemBlock from "./blocks/CarouselItemBlock.astro";
+import CoverBlock from "./blocks/CoverBlock.astro";
 import FormBlock from "./blocks/FormBlock.astro";
 import GridBlock from "./blocks/GridBlock.astro";
 import HeroBlock from "./blocks/HeroBlock.astro";
@@ -254,6 +255,25 @@ function nestedRendererProps(nextParentBlockName: string) {
     return <NumberSpinnerBlock block={block} contract={contract} />;
   }
 
+  if (block.name === "core/cover") {
+    return (
+      <CoverBlock
+        block={block}
+        contract={contract}
+        htmlProps={htmlAttributes}
+        styleflowProps={semantic}
+      >
+        <Astro.self
+          blocks={children}
+          contract={contract}
+          blockRenderers={blockRenderers}
+          iconRenderer={IconRenderer}
+          {...nestedRendererProps(block.name)}
+        />
+      </CoverBlock>
+    );
+  }
+
   if ([
     "heading",
     "rich-text",

package/dist/astro/blocks/CoverBlock.astro

@@ -0,0 +1,155 @@
+---
+import S from "@styleflow.app/astro/S.astro";
+import type { DynamicStyleflowProps, StyleflowContract } from "../../styleflow.js";
+import { resolvePrefixedFlowpressBlockStyleflowProps } from "../../styleflow.js";
+import type {
+  FlowpressBlock,
+  FlowpressBlockHtmlProps
+} from "../../types.js";
+import { blockHtmlAttributes, semanticProps } from "./helpers.js";
+import {
+  coverBackgroundType,
+  coverContentPosition,
+  coverMediaSource,
+  coverMinimumHeight,
+  coverObjectPosition,
+  coverPosterSource,
+  coverScrimEnabled,
+  coverScrimOpacity,
+  coverTagName
+} from "./cover.js";
+
+interface Props {
+  block: FlowpressBlock;
+  contract?: StyleflowContract;
+  htmlProps?: FlowpressBlockHtmlProps;
+  styleflowProps?: DynamicStyleflowProps;
+}
+
+const { block, contract, htmlProps, styleflowProps } = Astro.props;
+const attributes = block.attributes;
+const rootStyleflowProps = styleflowProps ?? semanticProps(attributes, contract, {
+  layoutRole: "region",
+  density: "regular"
+});
+const normalizedHtmlProps = htmlProps ?? blockHtmlAttributes(attributes);
+const rootHtmlProps = {
+  ...normalizedHtmlProps,
+  class: ["wp-block-cover", "flowpress-cover", normalizedHtmlProps.class]
+    .filter(Boolean)
+    .join(" ")
+};
+const backgroundType = coverBackgroundType(block);
+const source = coverMediaSource(block);
+const poster = coverPosterSource(block);
+const alt = String(attributes.alt ?? block.resolvedData?.alt ?? "");
+const width = Number(block.resolvedData?.width) || undefined;
+const height = Number(block.resolvedData?.height) || undefined;
+const objectPosition = coverObjectPosition(attributes.focalPoint);
+const minimumHeight = coverMinimumHeight(
+  attributes.minHeight,
+  attributes.minHeightUnit
+);
+const [contentBlockPosition, contentInlinePosition] = coverContentPosition(
+  attributes.contentPosition
+);
+const scrimOpacity = coverScrimOpacity(attributes);
+const rootStyle = [
+  `--flowpress-cover-object-position:${objectPosition}`,
+  minimumHeight ? `--flowpress-cover-min-height:${minimumHeight}` : "",
+  `--flowpress-cover-content-block:${contentBlockPosition}`,
+  `--flowpress-cover-content-inline:${contentInlinePosition}`,
+  `--flowpress-cover-scrim-opacity:${scrimOpacity / 100}`
+].filter(Boolean).join(";");
+const scrimEnabled = backgroundType !== "color" && coverScrimEnabled(attributes);
+const scrimStyleflowProps = resolvePrefixedFlowpressBlockStyleflowProps(
+  attributes,
+  "scrim",
+  contract,
+  {},
+  {
+    strict: process.env.NODE_ENV === "production" || process.env.STYLEFLOW_STRICT === "1",
+    onDiagnostic: (diagnostic) => console.warn(`[${diagnostic.code}] ${diagnostic.message}`)
+  }
+);
+const tagName = coverTagName(attributes.tagName);
+---
+
+<S as={tagName} {...rootStyleflowProps} {...rootHtmlProps} style={rootStyle}>
+  {backgroundType === "image" && source ? (
+    <img
+      class="wp-block-cover__image-background flowpress-cover__media"
+      src={source}
+      width={width}
+      height={height}
+      alt={alt}
+      aria-hidden={alt ? undefined : "true"}
+      loading="lazy"
+      decoding="async"
+    />
+  ) : null}
+  {backgroundType === "video" && source ? (
+    <video
+      class="wp-block-cover__video-background flowpress-cover__media"
+      src={source}
+      poster={poster}
+      autoplay
+      muted
+      loop
+      playsinline
+      preload="metadata"
+      aria-hidden="true"
+      tabindex="-1"
+    />
+  ) : null}
+  {scrimEnabled ? (
+    <S.span
+      class="wp-block-cover__background flowpress-cover__scrim"
+      {...scrimStyleflowProps}
+      data-flowpress-cover-scrim
+      aria-hidden="true"
+    />
+  ) : null}
+  <S.div class="wp-block-cover__inner-container flowpress-cover__content">
+    <slot />
+  </S.div>
+</S>
+
+<style>
+  .flowpress-cover {
+    position: relative;
+    display: grid;
+    min-height: var(--flowpress-cover-min-height, 0);
+    overflow: hidden;
+    isolation: isolate;
+  }
+
+  .flowpress-cover__media,
+  .flowpress-cover__scrim {
+    position: absolute;
+    inset: 0;
+    width: 100%;
+    height: 100%;
+  }
+
+  .flowpress-cover__media {
+    z-index: 0;
+    object-fit: cover;
+    object-position: var(--flowpress-cover-object-position, 50% 50%);
+  }
+
+  .flowpress-cover__scrim {
+    z-index: 1;
+    background: var(--sf-background);
+    opacity: var(--flowpress-cover-scrim-opacity, 1);
+    pointer-events: none;
+  }
+
+  .flowpress-cover__content {
+    position: relative;
+    z-index: 2;
+    display: grid;
+    align-items: var(--flowpress-cover-content-block, center);
+    justify-items: var(--flowpress-cover-content-inline, center);
+  }
+</style>

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

@@ -0,0 +1,12 @@
+import type { FlowpressBlock } from "../../types.js";
+export type CoverBackgroundType = "color" | "image" | "video";
+export declare function coverTagName(value: unknown): string;
+export declare function coverMediaSource(block: FlowpressBlock): string;
+export declare function coverPosterSource(block: FlowpressBlock): string | undefined;
+export declare function coverBackgroundType(block: FlowpressBlock): CoverBackgroundType;
+export declare function coverObjectPosition(value: unknown): string;
+export declare function coverMinimumHeight(value: unknown, unitValue: unknown): string | undefined;
+export declare function coverContentPosition(value: unknown): [string, string];
+export declare function coverScrimEnabled(attributes: Record<string, unknown>): boolean;
+export declare function coverScrimOpacity(attributes: Record<string, unknown>): number;
+//# sourceMappingURL=cover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cover.d.ts","sourceRoot":"","sources":["../../../src/astro/blocks/cover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAwC9D,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGnD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAI3E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,mBAAmB,CAK9E;AAUD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ1D;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,OAAO,GACjB,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAGrE;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAM9E;AAQD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAK7E"}

package/dist/astro/blocks/cover.js

@@ -0,0 +1,105 @@
+const COVER_TAGS = new Set([
+    "article",
+    "aside",
+    "div",
+    "footer",
+    "header",
+    "main",
+    "section"
+]);
+const HEIGHT_UNITS = new Set([
+    "px",
+    "%",
+    "em",
+    "rem",
+    "vh",
+    "svh",
+    "lvh",
+    "dvh",
+    "vw"
+]);
+const CONTENT_POSITIONS = {
+    "top left": ["start", "start"],
+    "top center": ["start", "center"],
+    "top right": ["start", "end"],
+    "center left": ["center", "start"],
+    "center center": ["center", "center"],
+    "center right": ["center", "end"],
+    "bottom left": ["end", "start"],
+    "bottom center": ["end", "center"],
+    "bottom right": ["end", "end"]
+};
+function text(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+export function coverTagName(value) {
+    const candidate = text(value).toLowerCase();
+    return COVER_TAGS.has(candidate) ? candidate : "div";
+}
+export function coverMediaSource(block) {
+    return text(block.attributes.url) || text(block.resolvedData?.url);
+}
+export function coverPosterSource(block) {
+    return text(block.attributes.poster)
+        || text(block.resolvedData?.poster)
+        || undefined;
+}
+export function coverBackgroundType(block) {
+    const requested = text(block.attributes.backgroundType).toLowerCase();
+    if (requested === "video")
+        return "video";
+    if (requested === "color")
+        return "color";
+    return coverMediaSource(block) ? "image" : "color";
+}
+function percentage(value) {
+    const numeric = typeof value === "number" ? value : Number(value);
+    if (!Number.isFinite(numeric))
+        return undefined;
+    if (numeric >= 0 && numeric <= 1)
+        return numeric * 100;
+    if (numeric >= 0 && numeric <= 100)
+        return numeric;
+    return undefined;
+}
+export function coverObjectPosition(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return "50% 50%";
+    }
+    const focalPoint = value;
+    const x = percentage(focalPoint.x);
+    const y = percentage(focalPoint.y);
+    return x === undefined || y === undefined ? "50% 50%" : `${x}% ${y}%`;
+}
+export function coverMinimumHeight(value, unitValue) {
+    const numeric = typeof value === "number" ? value : Number(value);
+    if (!Number.isFinite(numeric) || numeric < 0)
+        return undefined;
+    const requestedUnit = text(unitValue).toLowerCase();
+    const unit = HEIGHT_UNITS.has(requestedUnit) ? requestedUnit : "px";
+    return `${numeric}${unit}`;
+}
+export function coverContentPosition(value) {
+    return CONTENT_POSITIONS[text(value).toLowerCase()]
+        ?? ["center", "center"];
+}
+export function coverScrimEnabled(attributes) {
+    if (typeof attributes.scrimEnabled === "boolean") {
+        return attributes.scrimEnabled;
+    }
+    const nativeDimRatio = Number(attributes.dimRatio);
+    return Number.isFinite(nativeDimRatio) && nativeDimRatio > 0;
+}
+function clampedPercentage(value) {
+    const numeric = typeof value === "number" ? value : Number(value);
+    if (!Number.isFinite(numeric))
+        return undefined;
+    return Math.min(100, Math.max(0, numeric));
+}
+export function coverScrimOpacity(attributes) {
+    const explicitOpacity = clampedPercentage(attributes.scrimOpacity);
+    if (explicitOpacity !== undefined)
+        return explicitOpacity;
+    return clampedPercentage(attributes.dimRatio) ?? 100;
+}
+//# sourceMappingURL=cover.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cover.js","sourceRoot":"","sources":["../../../src/astro/blocks/cover.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FlowpressBlock } from \"../../types.js\";\n\nexport type CoverBackgroundType = \"color\" | \"image\" | \"video\";\n\nconst COVER_TAGS = new Set([\n  \"article\",\n  \"aside\",\n  \"div\",\n  \"footer\",\n  \"header\",\n  \"main\",\n  \"section\"\n]);\n\nconst HEIGHT_UNITS = new Set([\n  \"px\",\n  \"%\",\n  \"em\",\n  \"rem\",\n  \"vh\",\n  \"svh\",\n  \"lvh\",\n  \"dvh\",\n  \"vw\"\n]);\n\nconst CONTENT_POSITIONS: Record<string, [string, string]> = {\n  \"top left\": [\"start\", \"start\"],\n  \"top center\": [\"start\", \"center\"],\n  \"top right\": [\"start\", \"end\"],\n  \"center left\": [\"center\", \"start\"],\n  \"center center\": [\"center\", \"center\"],\n  \"center right\": [\"center\", \"end\"],\n  \"bottom left\": [\"end\", \"start\"],\n  \"bottom center\": [\"end\", \"center\"],\n  \"bottom right\": [\"end\", \"end\"]\n};\n\nfunction text(value: unknown): string {\n  return typeof value === \"string\" ? value.trim() : \"\";\n}\n\nexport function coverTagName(value: unknown): string {\n  const candidate = text(value).toLowerCase();\n  return COVER_TAGS.has(candidate) ? candidate : \"div\";\n}\n\nexport function coverMediaSource(block: FlowpressBlock): string {\n  return text(block.attributes.url) || text(block.resolvedData?.url);\n}\n\nexport function coverPosterSource(block: FlowpressBlock): string | undefined {\n  return text(block.attributes.poster)\n    || text(block.resolvedData?.poster)\n    || undefined;\n}\n\nexport function coverBackgroundType(block: FlowpressBlock): CoverBackgroundType {\n  const requested = text(block.attributes.backgroundType).toLowerCase();\n  if (requested === \"video\") return \"video\";\n  if (requested === \"color\") return \"color\";\n  return coverMediaSource(block) ? \"image\" : \"color\";\n}\n\nfunction percentage(value: unknown): number | undefined {\n  const numeric = typeof value === \"number\" ? value : Number(value);\n  if (!Number.isFinite(numeric)) return undefined;\n  if (numeric >= 0 && numeric <= 1) return numeric * 100;\n  if (numeric >= 0 && numeric <= 100) return numeric;\n  return undefined;\n}\n\nexport function coverObjectPosition(value: unknown): string {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return \"50% 50%\";\n  }\n  const focalPoint = value as Record<string, unknown>;\n  const x = percentage(focalPoint.x);\n  const y = percentage(focalPoint.y);\n  return x === undefined || y === undefined ? \"50% 50%\" : `${x}% ${y}%`;\n}\n\nexport function coverMinimumHeight(\n  value: unknown,\n  unitValue: unknown\n): string | undefined {\n  const numeric = typeof value === \"number\" ? value : Number(value);\n  if (!Number.isFinite(numeric) || numeric < 0) return undefined;\n  const requestedUnit = text(unitValue).toLowerCase();\n  const unit = HEIGHT_UNITS.has(requestedUnit) ? requestedUnit : \"px\";\n  return `${numeric}${unit}`;\n}\n\nexport function coverContentPosition(value: unknown): [string, string] {\n  return CONTENT_POSITIONS[text(value).toLowerCase()]\n    ?? [\"center\", \"center\"];\n}\n\nexport function coverScrimEnabled(attributes: Record<string, unknown>): boolean {\n  if (typeof attributes.scrimEnabled === \"boolean\") {\n    return attributes.scrimEnabled;\n  }\n  const nativeDimRatio = Number(attributes.dimRatio);\n  return Number.isFinite(nativeDimRatio) && nativeDimRatio > 0;\n}\n\nfunction clampedPercentage(value: unknown): number | undefined {\n  const numeric = typeof value === \"number\" ? value : Number(value);\n  if (!Number.isFinite(numeric)) return undefined;\n  return Math.min(100, Math.max(0, numeric));\n}\n\nexport function coverScrimOpacity(attributes: Record<string, unknown>): number {\n  const explicitOpacity = clampedPercentage(attributes.scrimOpacity);\n  if (explicitOpacity !== undefined) return explicitOpacity;\n\n  return clampedPercentage(attributes.dimRatio) ?? 100;\n}\n"]}

package/dist/astro/blocks/cover.ts

@@ -0,0 +1,118 @@
+import type { FlowpressBlock } from "../../types.js";
+
+export type CoverBackgroundType = "color" | "image" | "video";
+
+const COVER_TAGS = new Set([
+  "article",
+  "aside",
+  "div",
+  "footer",
+  "header",
+  "main",
+  "section"
+]);
+
+const HEIGHT_UNITS = new Set([
+  "px",
+  "%",
+  "em",
+  "rem",
+  "vh",
+  "svh",
+  "lvh",
+  "dvh",
+  "vw"
+]);
+
+const CONTENT_POSITIONS: Record<string, [string, string]> = {
+  "top left": ["start", "start"],
+  "top center": ["start", "center"],
+  "top right": ["start", "end"],
+  "center left": ["center", "start"],
+  "center center": ["center", "center"],
+  "center right": ["center", "end"],
+  "bottom left": ["end", "start"],
+  "bottom center": ["end", "center"],
+  "bottom right": ["end", "end"]
+};
+
+function text(value: unknown): string {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+export function coverTagName(value: unknown): string {
+  const candidate = text(value).toLowerCase();
+  return COVER_TAGS.has(candidate) ? candidate : "div";
+}
+
+export function coverMediaSource(block: FlowpressBlock): string {
+  return text(block.attributes.url) || text(block.resolvedData?.url);
+}
+
+export function coverPosterSource(block: FlowpressBlock): string | undefined {
+  return text(block.attributes.poster)
+    || text(block.resolvedData?.poster)
+    || undefined;
+}
+
+export function coverBackgroundType(block: FlowpressBlock): CoverBackgroundType {
+  const requested = text(block.attributes.backgroundType).toLowerCase();
+  if (requested === "video") return "video";
+  if (requested === "color") return "color";
+  return coverMediaSource(block) ? "image" : "color";
+}
+
+function percentage(value: unknown): number | undefined {
+  const numeric = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(numeric)) return undefined;
+  if (numeric >= 0 && numeric <= 1) return numeric * 100;
+  if (numeric >= 0 && numeric <= 100) return numeric;
+  return undefined;
+}
+
+export function coverObjectPosition(value: unknown): string {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return "50% 50%";
+  }
+  const focalPoint = value as Record<string, unknown>;
+  const x = percentage(focalPoint.x);
+  const y = percentage(focalPoint.y);
+  return x === undefined || y === undefined ? "50% 50%" : `${x}% ${y}%`;
+}
+
+export function coverMinimumHeight(
+  value: unknown,
+  unitValue: unknown
+): string | undefined {
+  const numeric = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(numeric) || numeric < 0) return undefined;
+  const requestedUnit = text(unitValue).toLowerCase();
+  const unit = HEIGHT_UNITS.has(requestedUnit) ? requestedUnit : "px";
+  return `${numeric}${unit}`;
+}
+
+export function coverContentPosition(value: unknown): [string, string] {
+  return CONTENT_POSITIONS[text(value).toLowerCase()]
+    ?? ["center", "center"];
+}
+
+export function coverScrimEnabled(attributes: Record<string, unknown>): boolean {
+  if (typeof attributes.scrimEnabled === "boolean") {
+    return attributes.scrimEnabled;
+  }
+  const nativeDimRatio = Number(attributes.dimRatio);
+  return Number.isFinite(nativeDimRatio) && nativeDimRatio > 0;
+}
+
+function clampedPercentage(value: unknown): number | undefined {
+  const numeric = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(numeric)) return undefined;
+  return Math.min(100, Math.max(0, numeric));
+}
+
+export function coverScrimOpacity(attributes: Record<string, unknown>): number {
+  const explicitOpacity = clampedPercentage(attributes.scrimOpacity);
+  if (explicitOpacity !== undefined) return explicitOpacity;
+
+  return clampedPercentage(attributes.dimRatio) ?? 100;
+}

package/dist/default-blocks.d.ts

@@ -1,4 +1,4 @@
-export declare const FLOWPRESS_DEFAULT_BLOCK_CATALOG_VERSION: "1";
+export declare const FLOWPRESS_DEFAULT_BLOCK_CATALOG_VERSION: "2";
 export interface FlowpressDefaultBlockCatalogEntry {
     blockName: string;
     template: "DefaultBlockAdapter.astro";

package/dist/default-blocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-blocks.d.ts","sourceRoot":"","sources":["../src/default-blocks.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uCAAuC,EAAG,GAAY,CAAC;AAEpE,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,2BAA2B,CAAC;CACvC;AAoCD,eAAO,MAAM,4BAA4B,EAAE,SAAS,iCAAiC,EACE,CAAC;AAIxF,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,wBAAgB,wCAAwC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAalF"}
+{"version":3,"file":"default-blocks.d.ts","sourceRoot":"","sources":["../src/default-blocks.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uCAAuC,EAAG,GAAY,CAAC;AAEpE,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,2BAA2B,CAAC;CACvC;AAqCD,eAAO,MAAM,4BAA4B,EAAE,SAAS,iCAAiC,EACE,CAAC;AAIxF,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,wBAAgB,wCAAwC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA+BlF"}

package/dist/default-blocks.js

@@ -1,5 +1,6 @@
-export const FLOWPRESS_DEFAULT_BLOCK_CATALOG_VERSION = "1";
+export const FLOWPRESS_DEFAULT_BLOCK_CATALOG_VERSION = "2";
 const blockNames = [
+    "core/cover",
     "core/group",
     "core/heading",
     "core/list",
@@ -41,6 +42,24 @@ export function createFlowpressDefaultBlockAdapterSource(blockName) {
     if (!hasFlowpressDefaultBlockAdapter(blockName)) {
         throw new Error(`FlowPress has no official default adapter for ${blockName}.`);
     }
+    if (blockName === "core/cover") {
+        return `---
+import CoverBlock from "@styleflow.app/flowpress-astro-core/blocks/CoverBlock.astro";
+import type { FlowpressBlockRendererProps } from "@styleflow.app/flowpress-astro-core";
+
+const { block, contract, htmlProps, styleflowProps } = Astro.props as FlowpressBlockRendererProps;
+---
+
+<CoverBlock
+  block={block}
+  contract={contract}
+  htmlProps={htmlProps}
+  styleflowProps={styleflowProps}
+>
+  <slot />
+</CoverBlock>
+`;
+    }
     return `---
 import DefaultBlockAdapter from "@styleflow.app/flowpress-astro-core/DefaultBlockAdapter.astro";
 import type { FlowpressBlockRendererProps } from "@styleflow.app/flowpress-astro-core";

package/dist/default-blocks.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-blocks.js","sourceRoot":"","sources":["../src/default-blocks.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uCAAuC,GAAG,GAAY,CAAC;AAOpE,MAAM,UAAU,GAAG;IACjB,YAAY;IACZ,cAAc;IACd,WAAW;IACX,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,mBAAmB;IACnB,WAAW;IACX,SAAS;IACT,aAAa;IACb,kBAAkB;IAClB,SAAS;IACT,SAAS;IACT,WAAW;IACX,iBAAiB;IACjB,SAAS;IACT,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,SAAS;IACT,SAAS;IACT,UAAU;IACV,QAAQ;IACR,mBAAmB;IACnB,UAAU;IACV,cAAc;IACd,YAAY;IACZ,aAAa;IACb,cAAc;IACd,UAAU;IACV,kBAAkB;CACV,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GACvC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,2BAA2B,EAAE,CAAC,CAAC,CAAC;AAExF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,UAAU,CAAC,CAAC;AAE9C,MAAM,UAAU,+BAA+B,CAAC,SAAiB;IAC/D,OAAO,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,wCAAwC,CAAC,SAAiB;IACxE,IAAI,CAAC,+BAA+B,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,iDAAiD,SAAS,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,OAAO;;;;;;;;CAQR,CAAC;AACF,CAAC","sourcesContent":["export const FLOWPRESS_DEFAULT_BLOCK_CATALOG_VERSION = \"1\" as const;\n\nexport interface FlowpressDefaultBlockCatalogEntry {\n  blockName: string;\n  template: \"DefaultBlockAdapter.astro\";\n}\n\nconst blockNames = [\n  \"core/group\",\n  \"core/heading\",\n  \"core/list\",\n  \"core/list-item\",\n  \"core/paragraph\",\n  \"core/quote\",\n  \"sf/accordion-item\",\n  \"sf/button\",\n  \"sf/card\",\n  \"sf/carousel\",\n  \"sf/carousel-item\",\n  \"sf/chip\",\n  \"sf/code\",\n  \"sf/column\",\n  \"sf/content-list\",\n  \"sf/form\",\n  \"sf/gallery\",\n  \"sf/grid\",\n  \"sf/heading\",\n  \"sf/hero\",\n  \"sf/icon\",\n  \"sf/image\",\n  \"sf/map\",\n  \"sf/number-spinner\",\n  \"sf/quote\",\n  \"sf/rich-text\",\n  \"sf/section\",\n  \"sf/template\",\n  \"sf/term-list\",\n  \"sf/video\",\n  \"sf/video-youtube\"\n] as const;\n\nexport const flowpressDefaultBlockCatalog: readonly FlowpressDefaultBlockCatalogEntry[] =\n  blockNames.map((blockName) => ({ blockName, template: \"DefaultBlockAdapter.astro\" }));\n\nconst supported = new Set<string>(blockNames);\n\nexport function hasFlowpressDefaultBlockAdapter(blockName: string): boolean {\n  return supported.has(blockName);\n}\n\nexport function createFlowpressDefaultBlockAdapterSource(blockName: string): string {\n  if (!hasFlowpressDefaultBlockAdapter(blockName)) {\n    throw new Error(`FlowPress has no official default adapter for ${blockName}.`);\n  }\n  return `---\nimport DefaultBlockAdapter from \"@styleflow.app/flowpress-astro-core/DefaultBlockAdapter.astro\";\nimport type { FlowpressBlockRendererProps } from \"@styleflow.app/flowpress-astro-core\";\n\nconst props = Astro.props as FlowpressBlockRendererProps;\n---\n\n<DefaultBlockAdapter {...props} />\n`;\n}\n"]}
+{"version":3,"file":"default-blocks.js","sourceRoot":"","sources":["../src/default-blocks.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uCAAuC,GAAG,GAAY,CAAC;AAOpE,MAAM,UAAU,GAAG;IACjB,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,WAAW;IACX,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,mBAAmB;IACnB,WAAW;IACX,SAAS;IACT,aAAa;IACb,kBAAkB;IAClB,SAAS;IACT,SAAS;IACT,WAAW;IACX,iBAAiB;IACjB,SAAS;IACT,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,SAAS;IACT,SAAS;IACT,UAAU;IACV,QAAQ;IACR,mBAAmB;IACnB,UAAU;IACV,cAAc;IACd,YAAY;IACZ,aAAa;IACb,cAAc;IACd,UAAU;IACV,kBAAkB;CACV,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GACvC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,2BAA2B,EAAE,CAAC,CAAC,CAAC;AAExF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,UAAU,CAAC,CAAC;AAE9C,MAAM,UAAU,+BAA+B,CAAC,SAAiB;IAC/D,OAAO,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,wCAAwC,CAAC,SAAiB;IACxE,IAAI,CAAC,+BAA+B,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,iDAAiD,SAAS,GAAG,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAC/B,OAAO;;;;;;;;;;;;;;;CAeV,CAAC;IACA,CAAC;IACD,OAAO;;;;;;;;CAQR,CAAC;AACF,CAAC","sourcesContent":["export const FLOWPRESS_DEFAULT_BLOCK_CATALOG_VERSION = \"2\" as const;\n\nexport interface FlowpressDefaultBlockCatalogEntry {\n  blockName: string;\n  template: \"DefaultBlockAdapter.astro\";\n}\n\nconst blockNames = [\n  \"core/cover\",\n  \"core/group\",\n  \"core/heading\",\n  \"core/list\",\n  \"core/list-item\",\n  \"core/paragraph\",\n  \"core/quote\",\n  \"sf/accordion-item\",\n  \"sf/button\",\n  \"sf/card\",\n  \"sf/carousel\",\n  \"sf/carousel-item\",\n  \"sf/chip\",\n  \"sf/code\",\n  \"sf/column\",\n  \"sf/content-list\",\n  \"sf/form\",\n  \"sf/gallery\",\n  \"sf/grid\",\n  \"sf/heading\",\n  \"sf/hero\",\n  \"sf/icon\",\n  \"sf/image\",\n  \"sf/map\",\n  \"sf/number-spinner\",\n  \"sf/quote\",\n  \"sf/rich-text\",\n  \"sf/section\",\n  \"sf/template\",\n  \"sf/term-list\",\n  \"sf/video\",\n  \"sf/video-youtube\"\n] as const;\n\nexport const flowpressDefaultBlockCatalog: readonly FlowpressDefaultBlockCatalogEntry[] =\n  blockNames.map((blockName) => ({ blockName, template: \"DefaultBlockAdapter.astro\" }));\n\nconst supported = new Set<string>(blockNames);\n\nexport function hasFlowpressDefaultBlockAdapter(blockName: string): boolean {\n  return supported.has(blockName);\n}\n\nexport function createFlowpressDefaultBlockAdapterSource(blockName: string): string {\n  if (!hasFlowpressDefaultBlockAdapter(blockName)) {\n    throw new Error(`FlowPress has no official default adapter for ${blockName}.`);\n  }\n  if (blockName === \"core/cover\") {\n    return `---\nimport CoverBlock from \"@styleflow.app/flowpress-astro-core/blocks/CoverBlock.astro\";\nimport type { FlowpressBlockRendererProps } from \"@styleflow.app/flowpress-astro-core\";\n\nconst { block, contract, htmlProps, styleflowProps } = Astro.props as FlowpressBlockRendererProps;\n---\n\n<CoverBlock\n  block={block}\n  contract={contract}\n  htmlProps={htmlProps}\n  styleflowProps={styleflowProps}\n>\n  <slot />\n</CoverBlock>\n`;\n  }\n  return `---\nimport DefaultBlockAdapter from \"@styleflow.app/flowpress-astro-core/DefaultBlockAdapter.astro\";\nimport type { FlowpressBlockRendererProps } from \"@styleflow.app/flowpress-astro-core\";\n\nconst props = Astro.props as FlowpressBlockRendererProps;\n---\n\n<DefaultBlockAdapter {...props} />\n`;\n}\n"]}

package/dist/styleflow.d.ts

@@ -56,6 +56,13 @@ export interface ResolveDynamicStyleflowOptions {
 }
 /** Select and validate the semantic attributes authored on a Gutenberg block. */
 export declare function resolveFlowpressBlockStyleflowProps(attributes: Record<string, unknown>, contract?: StyleflowContract, defaults?: DynamicStyleflowProps, options?: ResolveDynamicStyleflowOptions): DynamicStyleflowProps;
+/**
+ * Resolve a second, namespaced set of Styleflow coordinates stored on a block.
+ *
+ * A `scrimTone` attribute is therefore validated exactly like `tone`, without
+ * leaking the prefixed authoring attribute into the rendered DOM.
+ */
+export declare function resolvePrefixedFlowpressBlockStyleflowProps(attributes: Record<string, unknown>, prefix: string, contract?: StyleflowContract, defaults?: DynamicStyleflowProps, options?: ResolveDynamicStyleflowOptions): DynamicStyleflowProps;
 /** Validate CMS-authored props against the grouped vNext project contract. */
 export declare function resolveDynamicStyleflowProps(input: DynamicStyleflowProps, defaults: DynamicStyleflowProps, contract: StyleflowContract, options?: ResolveDynamicStyleflowOptions): DynamicStyleflowProps;
 //# sourceMappingURL=styleflow.d.ts.map

package/dist/styleflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styleflow.d.ts","sourceRoot":"","sources":["../src/styleflow.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACnH,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACvG,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC7F,WAAW,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACzD;AACD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,EAAE,qBAAqB,CAAC;QAC5B,WAAW,EAAE;YAAE,QAAQ,EAAE;gBAAE,UAAU,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE;oBAAE,EAAE,EAAE,MAAM,CAAC;oBAAC,CAAC,EAAE,MAAM,CAAC;oBAAC,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAA;SAAE,CAAC;KACtH,CAAC;CACH;AACD,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,sBAAsB,GAAG,uBAAuB,CAAC;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC1D;AAuBD,iFAAiF;AACjF,wBAAgB,mCAAmC,CACjD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,QAAQ,GAAE,qBAA0B,EACpC,OAAO,GAAE,8BAAmC,GAC3C,qBAAqB,CAevB;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,8BAAmC,GAC3C,qBAAqB,CAiCvB"}
+{"version":3,"file":"styleflow.d.ts","sourceRoot":"","sources":["../src/styleflow.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACnH,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACvG,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC7F,WAAW,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACzD;AACD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,EAAE,qBAAqB,CAAC;QAC5B,WAAW,EAAE;YAAE,QAAQ,EAAE;gBAAE,UAAU,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE;oBAAE,EAAE,EAAE,MAAM,CAAC;oBAAC,CAAC,EAAE,MAAM,CAAC;oBAAC,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAA;SAAE,CAAC;KACtH,CAAC;CACH;AACD,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,sBAAsB,GAAG,uBAAuB,CAAC;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAC1D;AAuBD,iFAAiF;AACjF,wBAAgB,mCAAmC,CACjD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,QAAQ,GAAE,qBAA0B,EACpC,OAAO,GAAE,8BAAmC,GAC3C,qBAAqB,CAevB;AAED;;;;;GAKG;AACH,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,QAAQ,GAAE,qBAA0B,EACpC,OAAO,GAAE,8BAAmC,GAC3C,qBAAqB,CAWvB;AAED,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,qBAAqB,EAC/B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,8BAAmC,GAC3C,qBAAqB,CAiCvB"}

package/dist/styleflow.js

@@ -33,6 +33,19 @@ export function resolveFlowpressBlockStyleflowProps(attributes, contract, defaul
     }
     return resolved;
 }
+/**
+ * Resolve a second, namespaced set of Styleflow coordinates stored on a block.
+ *
+ * A `scrimTone` attribute is therefore validated exactly like `tone`, without
+ * leaking the prefixed authoring attribute into the rendered DOM.
+ */
+export function resolvePrefixedFlowpressBlockStyleflowProps(attributes, prefix, contract, defaults = {}, options = {}) {
+    const prefixed = Object.fromEntries(BLOCK_STYLEFLOW_PROPS.flatMap((key) => {
+        const name = `${prefix}${key.charAt(0).toUpperCase()}${key.slice(1)}`;
+        return attributes[name] === undefined ? [] : [[key, attributes[name]]];
+    }));
+    return resolveFlowpressBlockStyleflowProps(prefixed, contract, defaults, options);
+}
 /** Validate CMS-authored props against the grouped vNext project contract. */
 export function resolveDynamicStyleflowProps(input, defaults, contract, options = {}) {
     const resolved = { ...defaults };

package/dist/styleflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"styleflow.js","sourceRoot":"","sources":["../src/styleflow.ts"],"names":[],"mappings":"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","sourcesContent":["export interface StyleflowContractAxes {\n  color: { tones: string[]; intensitiesByTone: Record<string, string[]>; surfaces: string[]; foregrounds: string[] };\n  layout: { roles: string[]; densities: string[]; breakpoints: Array<{ id: string; minWidth: number }> };\n  typography: { types: string[]; variantsByType: Record<string, string[]>; weights: string[] };\n  interaction: { priorities: string[]; states: string[] };\n}\nexport interface StyleflowContract {\n  defaultTheme?: string;\n  semantic: {\n    themes: string[];\n    axes: StyleflowContractAxes;\n    agentPolicy: { defaults: { layoutRole: string; density: string; typography: { ty: string; v: string; w: string } } };\n  };\n}\nexport type DynamicStyleflowProps = Record<string, unknown>;\nexport interface StyleflowDiagnostic {\n  code: \"FP_STYLEFLOW_INVALID\" | \"FP_STYLEFLOW_FALLBACK\";\n  prop: string;\n  value: unknown;\n  fallback?: unknown;\n  blocking: boolean;\n  message: string;\n}\nexport interface ResolveDynamicStyleflowOptions {\n  strict?: boolean;\n  onDiagnostic?: (diagnostic: StyleflowDiagnostic) => void;\n}\n\nconst INHERITED_PROPS = new Set([\"theme\", \"tone\", \"intensity\", \"foreground\"]);\nconst BLOCK_STYLEFLOW_PROPS = [\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\n/** Select and validate the semantic attributes authored on a Gutenberg block. */\nexport function resolveFlowpressBlockStyleflowProps(\n  attributes: Record<string, unknown>,\n  contract?: StyleflowContract,\n  defaults: DynamicStyleflowProps = {},\n  options: ResolveDynamicStyleflowOptions = {}\n): DynamicStyleflowProps {\n  const input = Object.fromEntries(\n    BLOCK_STYLEFLOW_PROPS\n      .filter((key) => attributes[key] !== undefined)\n      .map((key) => [key, attributes[key]])\n  );\n  if (contract) {\n    return resolveDynamicStyleflowProps(input, defaults, contract, options);\n  }\n\n  const resolved = { ...defaults, ...input };\n  for (const key of INHERITED_PROPS) {\n    if (input[key] === \"inherit\") delete resolved[key];\n  }\n  return resolved;\n}\n\n/** Validate CMS-authored props against the grouped vNext project contract. */\nexport function resolveDynamicStyleflowProps(\n  input: DynamicStyleflowProps,\n  defaults: DynamicStyleflowProps,\n  contract: StyleflowContract,\n  options: ResolveDynamicStyleflowOptions = {}\n): DynamicStyleflowProps {\n  const resolved: DynamicStyleflowProps = { ...defaults };\n  for (const [key, value] of Object.entries(input)) {\n    if (value === undefined || value === null || value === \"\") continue;\n    if (INHERITED_PROPS.has(key) && value === \"inherit\") { delete resolved[key]; continue; }\n    if (key === \"interactionState\") {\n      invalid(key, value, undefined, options); delete resolved[key]; continue;\n    }\n    const allowed = allowedValues(key, input, defaults, contract);\n    if (!allowed) { resolved[key] = value; continue; }\n    const candidate = typeof value === \"string\"\n      ? value\n      : typeof value === \"number\" && Number.isFinite(value)\n        ? String(value)\n        : undefined;\n    if (candidate !== undefined && allowed.includes(candidate)) {\n      resolved[key] = candidate;\n      continue;\n    }\n    const fallback = explicitFallback(key, defaults, contract);\n    invalid(key, value, fallback, options);\n    if (fallback === undefined) delete resolved[key]; else resolved[key] = fallback;\n  }\n  // Validate dependent defaults too: a default is not permission to emit a\n  // coordinate absent from the current project contract.\n  for (const key of [\"theme\", \"tone\", \"intensity\", \"surface\", \"foreground\", \"layoutRole\", \"density\", \"ty\", \"v\", \"w\", \"interactivePriority\"]) {\n    if (resolved[key] === undefined) continue;\n    const allowed = allowedValues(key, resolved, defaults, contract);\n    if (allowed && !allowed.includes(String(resolved[key]))) {\n      invalid(key, resolved[key], undefined, options); delete resolved[key];\n    }\n  }\n  return resolved;\n}\n\nfunction allowedValues(\n  key: string, input: DynamicStyleflowProps, defaults: DynamicStyleflowProps,\n  contract: StyleflowContract\n): string[] | undefined {\n  const axes = contract.semantic.axes;\n  if (key === \"theme\") return contract.semantic.themes;\n  if (key === \"tone\") return axes.color.tones;\n  if (key === \"intensity\") {\n    const tone = String(input.tone ?? defaults.tone ?? \"\");\n    return tone ? axes.color.intensitiesByTone[tone] ?? [] : [...new Set(Object.values(axes.color.intensitiesByTone).flat())];\n  }\n  if (key === \"surface\") return axes.color.surfaces;\n  if (key === \"foreground\") return axes.color.foregrounds;\n  if (key === \"layoutRole\") return axes.layout.roles;\n  if (key === \"density\") return axes.layout.densities;\n  if (key === \"ty\") return axes.typography.types;\n  if (key === \"v\") {\n    const authoredType = input.ty ?? defaults.ty;\n    if (authoredType !== undefined && authoredType !== null && authoredType !== \"\") {\n      return axes.typography.variantsByType[String(authoredType)] ?? [];\n    }\n    return [...new Set(Object.values(axes.typography.variantsByType).flat())];\n  }\n  if (key === \"w\") return axes.typography.weights;\n  if (key === \"interactivePriority\") return axes.interaction.priorities;\n  return undefined;\n}\n\nfunction explicitFallback(key: string, defaults: DynamicStyleflowProps, contract: StyleflowContract): unknown {\n  if (defaults[key] !== undefined) return defaults[key];\n  if (key === \"layoutRole\") return contract.semantic.agentPolicy.defaults.layoutRole;\n  if (key === \"density\") return contract.semantic.agentPolicy.defaults.density;\n  if (key === \"ty\" || key === \"v\" || key === \"w\") return contract.semantic.agentPolicy.defaults.typography[key];\n  if (key === \"theme\") return contract.defaultTheme;\n  return undefined;\n}\nfunction invalid(key: string, value: unknown, fallback: unknown, options: ResolveDynamicStyleflowOptions): void {\n  const diagnostic: StyleflowDiagnostic = {\n    code: fallback === undefined ? \"FP_STYLEFLOW_INVALID\" : \"FP_STYLEFLOW_FALLBACK\",\n    prop: key, value, ...(fallback !== undefined ? { fallback } : {}),\n    blocking: options.strict === true,\n    message: fallback === undefined\n      ? `Styleflow prop ${key}=${JSON.stringify(value)} is not in the grouped project contract.`\n      : `Styleflow prop ${key}=${JSON.stringify(value)} fell back to ${JSON.stringify(fallback)}.`\n  };\n  (options.onDiagnostic ?? ((item) => console.warn(`[${item.code}] ${item.message}`)))(diagnostic);\n  if (options.strict) throw new Error(`${diagnostic.code}: ${diagnostic.message}`);\n}\n"]}
+{"version":3,"file":"styleflow.js","sourceRoot":"","sources":["../src/styleflow.ts"],"names":[],"mappings":"AA4BA,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;AAC9E,MAAM,qBAAqB,GAAG;IAC5B,OAAO;IACP,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,iFAAiF;AACjF,MAAM,UAAU,mCAAmC,CACjD,UAAmC,EACnC,QAA4B,EAC5B,WAAkC,EAAE,EACpC,UAA0C,EAAE;IAE5C,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,qBAAqB;SAClB,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,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,4BAA4B,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2CAA2C,CACzD,UAAmC,EACnC,MAAc,EACd,QAA4B,EAC5B,WAAkC,EAAE,EACpC,UAA0C,EAAE;IAE5C,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACxE,MAAM,IAAI,GAAG,GAAG,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC,CAAC;IACJ,OAAO,mCAAmC,CACxC,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,CACR,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,4BAA4B,CAC1C,KAA4B,EAC5B,QAA+B,EAC/B,QAA2B,EAC3B,UAA0C,EAAE;IAE5C,MAAM,QAAQ,GAA0B,EAAE,GAAG,QAAQ,EAAE,CAAC;IACxD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QACpE,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAAC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACxF,IAAI,GAAG,KAAK,kBAAkB,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAAC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;YAAC,SAAS;QAC1E,CAAC;QACD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,OAAO,EAAE,CAAC;YAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAAC,SAAS;QAAC,CAAC;QAClD,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,QAAQ;YACzC,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACnD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBACf,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3D,QAAQ,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;;YAAM,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;IAClF,CAAC;IACD,yEAAyE;IACzE,uDAAuD;IACvD,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,qBAAqB,CAAC,EAAE,CAAC;QAC1I,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,SAAS;QAC1C,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjE,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAAC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CACpB,GAAW,EAAE,KAA4B,EAAE,QAA+B,EAC1E,QAA2B;IAE3B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;IACpC,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;IACrD,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC5C,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5H,CAAC;IACD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAClD,IAAI,GAAG,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;IACxD,IAAI,GAAG,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IACnD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;IACpD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;IAC/C,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,KAAK,CAAC,EAAE,IAAI,QAAQ,CAAC,EAAE,CAAC;QAC7C,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,EAAE,EAAE,CAAC;YAC/E,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;QACpE,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;IAChD,IAAI,GAAG,KAAK,qBAAqB;QAAE,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;IACtE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,QAA+B,EAAE,QAA2B;IACjG,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,GAAG,KAAK,YAAY;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;IACnF,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC7E,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9G,IAAI,GAAG,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC,YAAY,CAAC;IAClD,OAAO,SAAS,CAAC;AACnB,CAAC;AACD,SAAS,OAAO,CAAC,GAAW,EAAE,KAAc,EAAE,QAAiB,EAAE,OAAuC;IACtG,MAAM,UAAU,GAAwB;QACtC,IAAI,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,uBAAuB;QAC/E,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,QAAQ,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI;QACjC,OAAO,EAAE,QAAQ,KAAK,SAAS;YAC7B,CAAC,CAAC,kBAAkB,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,0CAA0C;YAC1F,CAAC,CAAC,kBAAkB,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG;KAC/F,CAAC;IACF,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACjG,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;AACnF,CAAC","sourcesContent":["export interface StyleflowContractAxes {\n  color: { tones: string[]; intensitiesByTone: Record<string, string[]>; surfaces: string[]; foregrounds: string[] };\n  layout: { roles: string[]; densities: string[]; breakpoints: Array<{ id: string; minWidth: number }> };\n  typography: { types: string[]; variantsByType: Record<string, string[]>; weights: string[] };\n  interaction: { priorities: string[]; states: string[] };\n}\nexport interface StyleflowContract {\n  defaultTheme?: string;\n  semantic: {\n    themes: string[];\n    axes: StyleflowContractAxes;\n    agentPolicy: { defaults: { layoutRole: string; density: string; typography: { ty: string; v: string; w: string } } };\n  };\n}\nexport type DynamicStyleflowProps = Record<string, unknown>;\nexport interface StyleflowDiagnostic {\n  code: \"FP_STYLEFLOW_INVALID\" | \"FP_STYLEFLOW_FALLBACK\";\n  prop: string;\n  value: unknown;\n  fallback?: unknown;\n  blocking: boolean;\n  message: string;\n}\nexport interface ResolveDynamicStyleflowOptions {\n  strict?: boolean;\n  onDiagnostic?: (diagnostic: StyleflowDiagnostic) => void;\n}\n\nconst INHERITED_PROPS = new Set([\"theme\", \"tone\", \"intensity\", \"foreground\"]);\nconst BLOCK_STYLEFLOW_PROPS = [\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\n/** Select and validate the semantic attributes authored on a Gutenberg block. */\nexport function resolveFlowpressBlockStyleflowProps(\n  attributes: Record<string, unknown>,\n  contract?: StyleflowContract,\n  defaults: DynamicStyleflowProps = {},\n  options: ResolveDynamicStyleflowOptions = {}\n): DynamicStyleflowProps {\n  const input = Object.fromEntries(\n    BLOCK_STYLEFLOW_PROPS\n      .filter((key) => attributes[key] !== undefined)\n      .map((key) => [key, attributes[key]])\n  );\n  if (contract) {\n    return resolveDynamicStyleflowProps(input, defaults, contract, options);\n  }\n\n  const resolved = { ...defaults, ...input };\n  for (const key of INHERITED_PROPS) {\n    if (input[key] === \"inherit\") delete resolved[key];\n  }\n  return resolved;\n}\n\n/**\n * Resolve a second, namespaced set of Styleflow coordinates stored on a block.\n *\n * A `scrimTone` attribute is therefore validated exactly like `tone`, without\n * leaking the prefixed authoring attribute into the rendered DOM.\n */\nexport function resolvePrefixedFlowpressBlockStyleflowProps(\n  attributes: Record<string, unknown>,\n  prefix: string,\n  contract?: StyleflowContract,\n  defaults: DynamicStyleflowProps = {},\n  options: ResolveDynamicStyleflowOptions = {}\n): DynamicStyleflowProps {\n  const prefixed = Object.fromEntries(BLOCK_STYLEFLOW_PROPS.flatMap((key) => {\n    const name = `${prefix}${key.charAt(0).toUpperCase()}${key.slice(1)}`;\n    return attributes[name] === undefined ? [] : [[key, attributes[name]]];\n  }));\n  return resolveFlowpressBlockStyleflowProps(\n    prefixed,\n    contract,\n    defaults,\n    options\n  );\n}\n\n/** Validate CMS-authored props against the grouped vNext project contract. */\nexport function resolveDynamicStyleflowProps(\n  input: DynamicStyleflowProps,\n  defaults: DynamicStyleflowProps,\n  contract: StyleflowContract,\n  options: ResolveDynamicStyleflowOptions = {}\n): DynamicStyleflowProps {\n  const resolved: DynamicStyleflowProps = { ...defaults };\n  for (const [key, value] of Object.entries(input)) {\n    if (value === undefined || value === null || value === \"\") continue;\n    if (INHERITED_PROPS.has(key) && value === \"inherit\") { delete resolved[key]; continue; }\n    if (key === \"interactionState\") {\n      invalid(key, value, undefined, options); delete resolved[key]; continue;\n    }\n    const allowed = allowedValues(key, input, defaults, contract);\n    if (!allowed) { resolved[key] = value; continue; }\n    const candidate = typeof value === \"string\"\n      ? value\n      : typeof value === \"number\" && Number.isFinite(value)\n        ? String(value)\n        : undefined;\n    if (candidate !== undefined && allowed.includes(candidate)) {\n      resolved[key] = candidate;\n      continue;\n    }\n    const fallback = explicitFallback(key, defaults, contract);\n    invalid(key, value, fallback, options);\n    if (fallback === undefined) delete resolved[key]; else resolved[key] = fallback;\n  }\n  // Validate dependent defaults too: a default is not permission to emit a\n  // coordinate absent from the current project contract.\n  for (const key of [\"theme\", \"tone\", \"intensity\", \"surface\", \"foreground\", \"layoutRole\", \"density\", \"ty\", \"v\", \"w\", \"interactivePriority\"]) {\n    if (resolved[key] === undefined) continue;\n    const allowed = allowedValues(key, resolved, defaults, contract);\n    if (allowed && !allowed.includes(String(resolved[key]))) {\n      invalid(key, resolved[key], undefined, options); delete resolved[key];\n    }\n  }\n  return resolved;\n}\n\nfunction allowedValues(\n  key: string, input: DynamicStyleflowProps, defaults: DynamicStyleflowProps,\n  contract: StyleflowContract\n): string[] | undefined {\n  const axes = contract.semantic.axes;\n  if (key === \"theme\") return contract.semantic.themes;\n  if (key === \"tone\") return axes.color.tones;\n  if (key === \"intensity\") {\n    const tone = String(input.tone ?? defaults.tone ?? \"\");\n    return tone ? axes.color.intensitiesByTone[tone] ?? [] : [...new Set(Object.values(axes.color.intensitiesByTone).flat())];\n  }\n  if (key === \"surface\") return axes.color.surfaces;\n  if (key === \"foreground\") return axes.color.foregrounds;\n  if (key === \"layoutRole\") return axes.layout.roles;\n  if (key === \"density\") return axes.layout.densities;\n  if (key === \"ty\") return axes.typography.types;\n  if (key === \"v\") {\n    const authoredType = input.ty ?? defaults.ty;\n    if (authoredType !== undefined && authoredType !== null && authoredType !== \"\") {\n      return axes.typography.variantsByType[String(authoredType)] ?? [];\n    }\n    return [...new Set(Object.values(axes.typography.variantsByType).flat())];\n  }\n  if (key === \"w\") return axes.typography.weights;\n  if (key === \"interactivePriority\") return axes.interaction.priorities;\n  return undefined;\n}\n\nfunction explicitFallback(key: string, defaults: DynamicStyleflowProps, contract: StyleflowContract): unknown {\n  if (defaults[key] !== undefined) return defaults[key];\n  if (key === \"layoutRole\") return contract.semantic.agentPolicy.defaults.layoutRole;\n  if (key === \"density\") return contract.semantic.agentPolicy.defaults.density;\n  if (key === \"ty\" || key === \"v\" || key === \"w\") return contract.semantic.agentPolicy.defaults.typography[key];\n  if (key === \"theme\") return contract.defaultTheme;\n  return undefined;\n}\nfunction invalid(key: string, value: unknown, fallback: unknown, options: ResolveDynamicStyleflowOptions): void {\n  const diagnostic: StyleflowDiagnostic = {\n    code: fallback === undefined ? \"FP_STYLEFLOW_INVALID\" : \"FP_STYLEFLOW_FALLBACK\",\n    prop: key, value, ...(fallback !== undefined ? { fallback } : {}),\n    blocking: options.strict === true,\n    message: fallback === undefined\n      ? `Styleflow prop ${key}=${JSON.stringify(value)} is not in the grouped project contract.`\n      : `Styleflow prop ${key}=${JSON.stringify(value)} fell back to ${JSON.stringify(fallback)}.`\n  };\n  (options.onDiagnostic ?? ((item) => console.warn(`[${item.code}] ${item.message}`)))(diagnostic);\n  if (options.strict) throw new Error(`${diagnostic.code}: ${diagnostic.message}`);\n}\n"]}

package/dist/tsconfig.tsbuildinfo

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@styleflow.app/flowpress-astro-core",
-  "version": "1.0.0-beta.11",
+  "version": "1.0.0-beta.13",
   "description": "Project-agnostic WordPress routing, templates, SEO and GraphQL runtime for FlowPress Astro apps.",
   "type": "module",
   "private": false,
@@ -21,7 +21,8 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./templates": "./dist/templates.js",
     "./BaseLayout.astro": "./dist/astro/BaseLayout.astro",
@@ -31,6 +32,7 @@
     "./DefaultBlockAdapter.astro": "./dist/astro/DefaultBlockAdapter.astro",
     "./ThemeRuntime.astro": "./dist/astro/ThemeRuntime.astro",
     "./blocks/ThemeToggleBlock.astro": "./dist/astro/blocks/ThemeToggleBlock.astro",
+    "./blocks/CoverBlock.astro": "./dist/astro/blocks/CoverBlock.astro",
     "./blocks/SiteLogoBlock.astro": "./dist/astro/blocks/SiteLogoBlock.astro"
   },
   "files": [