@getquick/content 0.3.0 → 0.3.2

package/dist/{version-D_Ao31D3.js → version-DkpQm85L.js}

@@ -1,6 +1,6 @@
 //#endregion
 //#region frontend/src/consent/version.ts
 /** The UI/adapter version recorded with each decision (CN-R7). */
-const CONSENT_UI_VERSION = `gq-content@0.3.0`;
+const CONSENT_UI_VERSION = `gq-content@0.3.2`;
 //#endregion
 export { CONSENT_UI_VERSION as t };

package/dist/video-hero-D8AcMR4q.js

@@ -0,0 +1,69 @@
+/** Object-fit geometry for a 16:9 YouTube frame in the actual authored media box.
+* Adapters must size the iframe itself; object-fit cannot crop its document.
+* The intrinsic frame size matches the player's 560 × 315 embedding dimensions.
+*/
+function videoHeroFrameGeometry(box, fit = "cover", position = {
+	x: .5,
+	y: .5
+}) {
+	const contain = Math.min(box.width / 560, box.height / 315);
+	const scale = fit === "cover" ? Math.max(box.width / 560, box.height / 315) : fit === "contain" ? contain : fit === "scale-down" ? Math.min(1, contain) : 1;
+	const width = fit === "fill" ? box.width : 560 * scale;
+	const height = fit === "fill" ? box.height : 315 * scale;
+	return {
+		width,
+		height,
+		left: (box.width - width) * position.x || 0,
+		top: (box.height - height) * position.y || 0
+	};
+}
+/** Canonical structural CSS for every Video Hero adapter; presentation stays in the shared model. */
+function videoHeroStyleSheet() {
+	return `.wp-block-getquick-design-video-hero {
+  position: relative;
+  display: grid;
+  box-sizing: border-box;
+  isolation: isolate;
+}
+
+.wp-block-getquick-design-video-hero > .gqd-video-hero__media {
+  position: absolute;
+  z-index: 0;
+  overflow: hidden;
+  inset: 0;
+  background: inherit;
+  pointer-events: none;
+}
+
+.wp-block-getquick-design-video-hero > .gqd-video-hero__media > .gqd-video-hero__video,
+.wp-block-getquick-design-video-hero > .gqd-video-hero__media > .gqd-video-hero__poster {
+  position: absolute;
+  width: 100%;
+  height: 100%;
+  inset: 0;
+  object-fit: cover;
+}
+
+.wp-block-getquick-design-video-hero > .gqd-video-hero__media > iframe.gqd-video-hero__video {
+  inset: auto;
+  border: 0;
+}
+
+.wp-block-getquick-design-video-hero > .gqd-video-hero__content {
+  position: relative;
+  z-index: 1;
+  display: flex;
+  min-width: 0;
+  box-sizing: border-box;
+  flex-direction: column;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .wp-block-getquick-design-video-hero > .gqd-video-hero__media > .gqd-video-hero__video {
+    visibility: hidden;
+  }
+}
+`;
+}
+//#endregion
+export { videoHeroStyleSheet as n, videoHeroFrameGeometry as t };

package/dist/{wordpress-D_HG2rEt.d.ts → wordpress-C1xs3xHN.d.ts}

@@ -1,5 +1,221 @@
 import { r as ConsentConfiguration, t as AnalyticsSettings } from "./configuration-C_JGygQI.js";
 import { r as LegalLanguage } from "./legal-C5Xiq59W.js";
+//#endregion
+//#region frontend/src/design-text.d.ts
+/** Already loaded, authorized values. No lookup, fetching or query selection.
+ * Site title and description are plain text, as returned by WP settings. */
+interface DesignTextContext {
+  site?: {
+    title?: string;
+    description?: string;
+    url?: string;
+  };
+  post?: {
+    uri?: string;
+    /** Caller selects/formats the requested date using the block's format,
+     * date source and Site timezone; this adapter never guesses them. */
+    date?: {
+      text: string;
+      dateTime: string;
+    };
+    /** Supplied inline rich text, not a generated/truncated post body. */
+    excerpt?: string;
+  };
+}
+/** Restore source-only native text. Saved, producer-sanitized shells stay with
+ * the caller; childrenHtml contains HTML already rendered by that same caller.
+ * undefined means this adapter cannot supply the block, never placeholder text.
+ * Presentation validation and all styling belong to the shared renderer. */
+declare function renderDesignText(name: string, attributes: Record<string, unknown>, childrenHtml?: string, context?: DesignTextContext): string | undefined;
+/** Small shared source-rich-text boundary; also suitable for Image captions.
+ * Rebuild parsed HTML, preserving safe inline formatting without executable
+ * attributes, embedded documents, foreign namespaces or source CSS. */
+declare function safeDesignRichText(value: string): string;
+//#endregion
+//#region frontend/src/design-query.d.ts
+/** Authorized, synchronously preloaded content; supplied by the caller's data layer. */
+interface DesignPostContext {
+  id: number | string;
+  /** Plain text, escaped when rendered as a native Post Title. */
+  title: string;
+  blocks: DesignBlock[];
+  uri?: string;
+  featuredImage?: {
+    sourceUrl: string;
+    altText: string;
+  } | null;
+}
+/** A producer-selected identity, not permission to fetch an arbitrary post. */
+interface DesignQueryItem {
+  id: number | string;
+  type?: string;
+  slug?: string;
+  uri?: string;
+}
+interface DesignQueryResolverOptions {
+  /** Map lookup or other synchronous lookup of already authorized, loaded posts. */
+  resolvePost?: (item: DesignQueryItem) => DesignPostContext | null | undefined;
+}
+interface DesignQueryRenderContext extends DesignQueryResolverOptions {
+  post?: DesignPostContext;
+  /** Use the same renderer and Site overrides recursively, under this post context. */
+  render: (blocks: DesignBlock[], post?: DesignPostContext) => string;
+  /** Optional Site URL normalization, followed by the shared safe-link boundary. */
+  href?: (url: unknown) => string;
+}
+/** Repeat the delivered template once per delivered item, without selecting again.
+ * Returns undefined for other blocks. No Query or synced-pattern shell is added.
+ */
+declare function renderDesignQuery(block: DesignBlock, context: DesignQueryRenderContext): string | undefined;
+/** Native post-dependent blocks and already-resolved synced references.
+ * Call only after Site renderer overrides have had precedence.
+ */
+declare function renderDesignPostBlock(block: DesignBlock, context: DesignQueryRenderContext): string | undefined;
+/** Find identities already selected by producers, including resolved patterns.
+ * This never interprets query arguments or requests content. */
+declare function designQueryItems(pattern: {
+  blocks: DesignBlock[];
+} | DesignBlock[] | null | undefined): DesignQueryItem[];
+interface DesignPostRecord {
+  id: string | number;
+  databaseId?: number;
+  title: string;
+  uri: string;
+  designBlocks?: DesignBlock[];
+  featuredImage?: {
+    sourceUrl: string;
+    altText: string;
+  } | null;
+}
+/** Convert an existing authorized publication; absent neutral delivery is explicit. */
+declare function designPostContext(record: DesignPostRecord): DesignPostContext | null;
+interface DesignPreloadedPosts extends DesignQueryResolverOptions {
+  posts: ReadonlyMap<string, DesignPostContext>;
+  resolvePost: (item: DesignQueryItem) => DesignPostContext | null;
+}
+/** Preload producer-selected URIs through a caller's existing publication loader.
+ * Selection/order stay with the producer; nested contexts use the same boundary. */
+declare function preloadDesignQueryPosts(pattern: {
+  blocks: DesignBlock[];
+} | DesignBlock[] | null | undefined, load: (item: DesignQueryItem) => Promise<DesignPostRecord | null>): Promise<DesignPreloadedPosts>;
+//#endregion
+/** Neutral resolved dimensions; palette identities and dark governance stay in DesignTokens. */
+interface DesignTheme {
+  spacing: string;
+  breakpoints: Record<"sm" | "md" | "lg" | "xl" | "2xl", string>;
+  colors: Record<string, string>;
+  fontFamilies: Record<string, string>;
+  fontSizes: Record<string, string>;
+  fontSizeLineHeights: Record<string, string>;
+  fontWeights: Record<string, string>;
+  letterSpacings: Record<string, string>;
+  lineHeights: Record<string, string>;
+  radii: Record<string, string>;
+  maxWidths: Record<string, string>;
+}
+type DesignThemeOverrides = { [K in keyof DesignTheme]?: DesignTheme[K] extends string ? string : Partial<DesignTheme[K]>; };
+/** The same bounded override vocabulary PHP and JSON Schema validate. */
+declare function resolveDesignTheme(overrides?: unknown): DesignTheme;
+/** Complete theme declarations for every supported value, independent of CMS content scanning. */
+declare function designThemeVariables(overrides?: DesignThemeOverrides): Record<string, string>;
+/** Exact pinned Preflight, deliberately scoped away from inspectors and wp-admin. */
+declare function designThemeStyleSheet(overrides?: DesignThemeOverrides, scope?: string): string;
+/** Color/font extension for the shared presentation parser; never raw utility strings. */
+declare function resolvePresentationToken(kind: string, value: unknown): string | undefined;
+//#endregion
+type PresentationBreakpoint = "base" | "sm" | "md" | "lg" | "xl" | "2xl";
+interface PresentationModel {
+  baseline: string;
+  breakpoints: Record<PresentationBreakpoint, string | null>;
+  properties: Record<string, Property>;
+  capabilities: Record<string, string[]>;
+  targets?: Record<string, PresentationTargets>;
+  selectors?: Record<string, string>;
+  nativeSupports?: Record<string, string[][]>;
+  shorthands?: Record<string, string[]>;
+  defaultDisplay?: Record<string, string>;
+  variablesFrom?: Record<string, Record<string, {
+    path: string[];
+    values: Record<string, string>;
+    default?: string;
+  }>>;
+  defaults: Record<string, Record<string, string | number>>;
+}
+interface PresentationTargets {
+  selector?: string;
+  elements?: Record<string, string[]>;
+  properties?: Record<string, string>;
+  cssProperties?: Record<string, string[]>;
+  styles?: Record<string, Record<string, string>>;
+  conditionalStyles?: {
+    property: string;
+    target: string;
+    declarations: Record<string, string>;
+  }[];
+  /** Native structural baselines; authored presentation has higher priority. */
+  rules?: {
+    target: string;
+    important?: boolean;
+    declarations: Record<string, string>;
+    media?: {
+      minWidth?: string;
+      maxWidth?: string;
+    };
+  }[];
+}
+interface PresentationExtension {
+  /** Existing canonical properties only; extensions never define CSS values. */
+  properties: readonly string[];
+  /** A single wrapper class. Defaults to the conventional WordPress block class. */
+  selector?: string;
+  /** Optional descendant/child class paths, keyed by declared property. */
+  targets?: Readonly<Record<string, string>>;
+  /** Native wrapper mode restored by Display Auto/reset and editor hidden preview. */
+  defaultDisplay?: string;
+}
+type PresentationExtensions = Readonly<Record<string, PresentationExtension>>;
+/** Explicit Site additions reuse the canonical vocabulary without changing core capabilities. */
+declare function createPresentationModel(extensions?: PresentationExtensions): PresentationModel;
+/** One bounded catalog shared by controls, producers and Site adapters. */
+declare const presentationModel: PresentationModel;
+type Presentation = Partial<Record<PresentationBreakpoint, Record<string, string | number | {
+  x: number;
+  y: number;
+} | {
+  palette: string;
+} | {
+  theme: string;
+} | {
+  literal: string;
+}>>>;
+type PresentationTheme = DesignThemeOverrides;
+type Property = {
+  label: string;
+  valueType?: string;
+  scale?: string;
+  themeToken?: string;
+  valueSchema?: Record<string, unknown>;
+  cssProperty: string;
+  companionCssProperty?: string;
+  reset: string;
+  values: {
+    value: string | number;
+    css: string;
+    label: string;
+    editorCss?: string;
+    companionCss?: string;
+  }[];
+};
+/** Invalid or unsupported settings fail explicitly; omission never means Auto/reset. */
+declare function presentationVariables(name: string, presentation?: unknown, options?: {
+  editor?: boolean;
+  attributes?: Record<string, unknown>;
+  model?: PresentationModel;
+}): Record<string, string>;
+/** Static, complete CSS: content first authored after a production build still works. */
+declare function presentationStyleSheet(theme?: PresentationTheme, options?: {
+  model?: PresentationModel;
+}): string;
 declare namespace content_types_d_exports {
   export { Archives, CmsFailure, CmsFailureReason, CollectionMembership, CollectionTerm, Delivery, DesignPresets, EntryContent, Extended, Found, HomeContent, Missing, PublishedEntry, SiteChrome, Translation, Unavailable, WordPressImage, WordPressMenuItem, WordPressPost, WordPressSettings };
 }
@@ -8,6 +224,8 @@ interface WordPressImage {
   altText: string;
 }
 interface WordPressPost {
+  databaseId?: number;
+  designBlocks?: DesignBlock[];
   id: string;
   title: string;
   excerpt: string;
@@ -29,6 +247,8 @@ interface WordPressSettings {
   description: string;
 }
 interface DesignPresets {
+  /** Resolved CMS theme; absent in publications written before theme delivery. */
+  theme?: DesignTheme;
   spacingSizes: Array<{
     slug: string;
     size: string;
@@ -54,6 +274,8 @@ interface HomeContent<X = unknown> extends DesignPresets {
     title: string;
     content: string;
     hasVideoHero: boolean;
+    databaseId?: number;
+    designBlocks?: DesignBlock[];
   } & Extended<X>;
   /** WordPress failed on the blocks, so this is the page without them. */
   blocksOmitted: boolean;
@@ -176,12 +398,16 @@ declare function parseDesignBlocks(value: unknown): DesignBlock[] | undefined;
 declare function escapeHtml(value: string): string;
 /** What a block renderer is given besides its block. */
 interface DesignRenderContext {
+  colorScheme?: "light" | "dark";
+  siteTitle?: string;
+  /** Current preloaded post when rendering a Query item or a post body. */
+  post?: DesignPostContext;
   /** The block's children, rendered in order by the same renderers (when read). */
   children: string;
   /** The blocks it is inside, outermost first. */
   ancestors: DesignBlock[];
   /** Renders other blocks (a subset of the children, say) by the same renderers. */
-  render(this: void, blocks: DesignBlock[]): string;
+  render(this: void, blocks: DesignBlock[], post?: DesignPostContext): string;
   /**
    * A link from CMS data as the Frontend serves it: one into this Site (the
    * CMS or the Site origin) becomes its path, another http(s) link stays
@@ -196,7 +422,17 @@ interface DesignRenderContext {
  * CMS supplied (`escapeHtml`) and pass links through `context.href`.
  */
 type DesignBlockRenderer = (block: DesignBlock, context: DesignRenderContext) => string;
-interface DesignRenderOptions {
+interface DesignRenderOptions extends DesignQueryResolverOptions {
+  /** Explicit surface scheme for the canonical Branding logo selection. */
+  colorScheme?: "light" | "dark";
+  /** Preloaded native Site text sources; no lookup occurs during rendering. */
+  textContext?: DesignTextContext;
+  /** Explicit Site-added capability model, shared with its stylesheet. */
+  presentationModel?: PresentationModel;
+  /** Gate generated media before composing already-delivered child HTML. */
+  mediaHtml?: (html: string) => string;
+  /** Preloaded context for native Post Title/Post Content outside a Query. */
+  post?: DesignPostContext;
   /**
    * The Site's renderers, by block name: its own blocks (such as
    * `getquick/header-navigation`), and any core block it renders itself.
@@ -562,6 +798,8 @@ declare function createContentRuntime<X = never>(input: ContentConfig<X>): {
    * `renderDesignPattern`), with links into the CMS or `siteOrigin` served
    * as this Site's paths.
    */
+  /** Preload selected standard Post/Page records through the existing store reader. */
+  preloadDesignQueryPosts: (pattern: DesignPattern | DesignBlock[] | null | undefined, siteOrigin?: string) => Promise<DesignPreloadedPosts>;
   renderDesignPattern: (pattern: DesignPattern | DesignBlock[] | null | undefined, options?: DesignRenderOptions & {
     siteOrigin?: string;
   }) => string;
@@ -603,4 +841,4 @@ interface WordPressClient<X = unknown> {
   }): Promise<Found<SiteChrome> | Unavailable>;
 }
 //#endregion
-export { Found as $, htmlLang as A, designMenuItems as B, Moved as C, SqlStatement as D, SqlDatabase as E, DesignBlock as F, CmsFailure as G, parseDesignBlocks as H, DesignBlockRenderer as I, CollectionTerm as J, CmsFailureReason as K, DesignPattern as L, languageSubject as M, routeLanguage as N, SiteLanguage as O, siteLanguages as P, Extended as Q, DesignRenderContext as R, HomePublication as S, ContentBindings as T, renderDesignPattern as U, escapeHtml as V, Archives as W, DesignPresets as X, Delivery as Y, EntryContent as Z, EntryDelivery as _, ContentExtension as a, Unavailable as at, HomeDelivery as b, createContentRuntime as c, WordPressPost as ct, CollectionListing as d, HomeContent as et, CollectionPage as f, DeliveryFailureReason as g, CollectionTermListing as h, ContentConsentConfig as i, Translation as it, isLanguageHome as j, WordPressLanguages as k, Alternate as l, WordPressSettings as lt, CollectionTermCount as m, CollectionConfig as n, PublishedEntry as nt, ContentRuntime as o, WordPressImage as ot, CollectionQuery as p, CollectionMembership as q, ContentConfig as r, SiteChrome as rt, ExtensionNode as s, WordPressMenuItem as st, WordPressClient as t, Missing as tt, CollectionItem as u, EntryPage as v, NotServed as w, HomePage as x, EntryPublication as y, DesignRenderOptions as z };
+export { Found as $, htmlLang as A, DesignQueryRenderContext as At, designMenuItems as B, Moved as C, designThemeVariables as Ct, SqlStatement as D, DesignPostRecord as Dt, SqlDatabase as E, DesignPostContext as Et, DesignBlock as F, renderDesignPostBlock as Ft, CmsFailure as G, parseDesignBlocks as H, DesignBlockRenderer as I, renderDesignQuery as It, CollectionTerm as J, CmsFailureReason as K, DesignPattern as L, DesignTextContext as Lt, languageSubject as M, designPostContext as Mt, routeLanguage as N, designQueryItems as Nt, SiteLanguage as O, DesignPreloadedPosts as Ot, siteLanguages as P, preloadDesignQueryPosts as Pt, Extended as Q, DesignRenderContext as R, renderDesignText as Rt, HomePublication as S, designThemeStyleSheet as St, ContentBindings as T, resolvePresentationToken as Tt, renderDesignPattern as U, escapeHtml as V, Archives as W, DesignPresets as X, Delivery as Y, EntryContent as Z, EntryDelivery as _, presentationModel as _t, ContentExtension as a, Unavailable as at, HomeDelivery as b, DesignTheme as bt, createContentRuntime as c, WordPressPost as ct, CollectionListing as d, PresentationBreakpoint as dt, HomeContent as et, CollectionPage as f, PresentationModel as ft, DeliveryFailureReason as g, createPresentationModel as gt, CollectionTermListing as h, Property as ht, ContentConsentConfig as i, Translation as it, isLanguageHome as j, DesignQueryResolverOptions as jt, WordPressLanguages as k, DesignQueryItem as kt, Alternate as l, WordPressSettings as lt, CollectionTermCount as m, PresentationTheme as mt, CollectionConfig as n, PublishedEntry as nt, ContentRuntime as o, WordPressImage as ot, CollectionQuery as p, PresentationTargets as pt, CollectionMembership as q, ContentConfig as r, SiteChrome as rt, ExtensionNode as s, WordPressMenuItem as st, WordPressClient as t, Missing as tt, CollectionItem as u, Presentation as ut, EntryPage as v, presentationStyleSheet as vt, NotServed as w, resolveDesignTheme as wt, HomePage as x, DesignThemeOverrides as xt, EntryPublication as y, presentationVariables as yt, DesignRenderOptions as z, safeDesignRichText as zt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getquick/content",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "license": "UNLICENSED",
   "files": [
     "dist",
@@ -57,6 +57,10 @@
     "./metadata/content": {
       "types": "./dist/metadata-content.d.ts",
       "import": "./dist/metadata-content.js"
+    },
+    "./design/client": {
+      "types": "./dist/design-client.d.ts",
+      "import": "./dist/design-client.js"
     }
   },
   "publishConfig": {