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

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## 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

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.12 \
+pnpm add @styleflow.app/flowpress-astro-core@1.0.0-beta.13 \
   @styleflow.app/astro@1.0.0-beta.6
 ```
 
@@ -137,8 +137,10 @@ 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. Native `dimRatio` is read only as a compatibility on/off signal and
-is not converted to an inline opacity.
+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
@@ -244,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.12` 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/blocks/CoverBlock.astro

@@ -15,6 +15,7 @@ import {
   coverObjectPosition,
   coverPosterSource,
   coverScrimEnabled,
+  coverScrimOpacity,
   coverTagName
 } from "./cover.js";
 
@@ -52,11 +53,13 @@ const minimumHeight = coverMinimumHeight(
 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-content-inline:${contentInlinePosition}`,
+  `--flowpress-cover-scrim-opacity:${scrimOpacity / 100}`
 ].filter(Boolean).join(";");
 const scrimEnabled = backgroundType !== "color" && coverScrimEnabled(attributes);
 const scrimStyleflowProps = resolvePrefixedFlowpressBlockStyleflowProps(
@@ -138,6 +141,7 @@ const tagName = coverTagName(attributes.tagName);
   .flowpress-cover__scrim {
     z-index: 1;
     background: var(--sf-background);
+    opacity: var(--flowpress-cover-scrim-opacity, 1);
     pointer-events: none;
   }
 

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

@@ -8,4 +8,5 @@ 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

@@ -1 +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"}
+{"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

@@ -90,4 +90,16 @@ export function coverScrimEnabled(attributes) {
     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

@@ -1 +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"]}
+{"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

@@ -103,3 +103,16 @@ export function coverScrimEnabled(attributes: Record<string, unknown>): boolean
   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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@styleflow.app/flowpress-astro-core",
-  "version": "1.0.0-beta.12",
+  "version": "1.0.0-beta.13",
   "description": "Project-agnostic WordPress routing, templates, SEO and GraphQL runtime for FlowPress Astro apps.",
   "type": "module",
   "private": false,