@thorprovider/blocks 4.0.0 → 4.3.0

package/dist/blocks/designs/universal-banner/grid.mjs

@@ -0,0 +1,21 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { cn } from "@thorprovider/blocks";
+import { gridClasses, rowSpanClasses, spanClasses } from "./responsive.mjs";
+function BannerGrid({ layout, config, children, className }) {
+  return /* @__PURE__ */ jsx("div", { className: cn(gridClasses(layout, config), className), children: children.map((child, index) => {
+    const item = layout.items[index];
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: cn("min-w-0", item ? spanClasses(item) : void 0, item ? rowSpanClasses(item) : void 0),
+        children: child
+      },
+      index
+    );
+  }) });
+}
+export {
+  BannerGrid
+};
+//# sourceMappingURL=grid.mjs.map

package/dist/blocks/designs/universal-banner/grid.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/designs/universal-banner/grid.tsx"],"sourcesContent":["'use client'\n\nimport type { ReactNode } from 'react'\n\nimport { cn } from '@thorprovider/blocks'\n\nimport type { GridLayout } from './contracts'\nimport type { ResolvedLayout } from './presets'\nimport { gridClasses, rowSpanClasses, spanClasses } from './responsive'\n\nexport type BannerGridProps = {\n  layout: ResolvedLayout\n  config: GridLayout\n  children: ReactNode[]\n  className?: string\n}\n\n/**\n * CSS-grid container. It never touches the content of a banner: it only places\n * each cell, including the spans and row spans the preset resolved.\n */\nexport function BannerGrid({ layout, config, children, className }: BannerGridProps) {\n  return (\n    <div className={cn(gridClasses(layout, config), className)}>\n      {children.map((child, index) => {\n        const item = layout.items[index]\n        return (\n          <div\n            key={index}\n            className={cn('min-w-0', item ? spanClasses(item) : undefined, item ? rowSpanClasses(item) : undefined)}\n          >\n            {child}\n          </div>\n        )\n      })}\n    </div>\n  )\n}\n"],"mappings":";AA2BU;AAvBV,SAAS,UAAU;AAInB,SAAS,aAAa,gBAAgB,mBAAmB;AAalD,SAAS,WAAW,EAAE,QAAQ,QAAQ,UAAU,UAAU,GAAoB;AACnF,SACE,oBAAC,SAAI,WAAW,GAAG,YAAY,QAAQ,MAAM,GAAG,SAAS,GACtD,mBAAS,IAAI,CAAC,OAAO,UAAU;AAC9B,UAAM,OAAO,OAAO,MAAM,KAAK;AAC/B,WACE;AAAA,MAAC;AAAA;AAAA,QAEC,WAAW,GAAG,WAAW,OAAO,YAAY,IAAI,IAAI,QAAW,OAAO,eAAe,IAAI,IAAI,MAAS;AAAA,QAErG;AAAA;AAAA,MAHI;AAAA,IAIP;AAAA,EAEJ,CAAC,GACH;AAEJ;","names":[]}

package/dist/blocks/designs/universal-banner/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from './block';
+export type { UniversalBannerProps } from './block';
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/designs/universal-banner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/blocks/designs/universal-banner/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA"}

package/dist/blocks/designs/universal-banner/index.js

@@ -0,0 +1,36 @@
+"use strict";
+"use client";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var universal_banner_exports = {};
+__export(universal_banner_exports, {
+  default: () => import_block.default
+});
+module.exports = __toCommonJS(universal_banner_exports);
+var import_block = __toESM(require("./block.js"));
+//# sourceMappingURL=index.js.map

package/dist/blocks/designs/universal-banner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/designs/universal-banner/index.tsx"],"sourcesContent":["'use client'\n\nexport { default } from './block'\nexport type { UniversalBannerProps } from './block'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAAwB;","names":[]}

package/dist/blocks/designs/universal-banner/index.mjs

@@ -0,0 +1,6 @@
+"use client";
+import { default as default2 } from "./block.mjs";
+export {
+  default2 as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/blocks/designs/universal-banner/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/designs/universal-banner/index.tsx"],"sourcesContent":["'use client'\n\nexport { default } from './block'\nexport type { UniversalBannerProps } from './block'\n"],"mappings":";AAEA,SAAS,WAAAA,gBAAe;","names":["default"]}

package/dist/blocks/designs/universal-banner/links.d.ts

@@ -0,0 +1,33 @@
+import type { BannerRecord, Cta, LinkTarget } from './contracts';
+/**
+ * Navigation adapter. The component never imports a router: the host injects
+ * one, or the default storefront paths are used. Destinations are stable ids,
+ * not hand-written URLs.
+ */
+export type BannerRouter = {
+    product: (id: string) => string;
+    category: (id: string) => string;
+    collection: (id: string) => string;
+    page: (slug: string) => string;
+    search: (query: string) => string;
+};
+export declare const defaultRouter: BannerRouter;
+export declare function isValidExternal(url: string): boolean;
+export declare function resolveHref(target: LinkTarget | undefined, router?: BannerRouter): string | null;
+/** Reads the reference of any target kind; a malformed target reads as ''. */
+export declare function referenceOf(target: LinkTarget | undefined): string;
+/** Builds a well-formed target for a kind; never leaves a foreign `id` behind. */
+export declare function withReference(kind: LinkTarget['kind'], value: string): LinkTarget;
+export type BannerActions = {
+    wholeLink: string | null;
+    ctas: Array<{
+        cta: Cta;
+        href: string | null;
+    }>;
+};
+/**
+ * A banner is either a single link or a surface with CTAs, never both: the
+ * structure makes nested interactive elements impossible.
+ */
+export declare function resolveBannerActions(record: BannerRecord, router?: BannerRouter): BannerActions;
+//# sourceMappingURL=links.d.ts.map

package/dist/blocks/designs/universal-banner/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../../../src/blocks/designs/universal-banner/links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEhE;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IAC/B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IAChC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAC9B,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CAClC,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,YAM3B,CAAA;AAQD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,MAAM,GAAE,YAA4B,GAAG,MAAM,GAAG,IAAI,CAkB/G;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAYlE;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAajF;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;CAC/C,CAAA;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,GAAE,YAA4B,GAAG,aAAa,CAU9G"}

package/dist/blocks/designs/universal-banner/links.js

@@ -0,0 +1,109 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var links_exports = {};
+__export(links_exports, {
+  defaultRouter: () => defaultRouter,
+  isValidExternal: () => isValidExternal,
+  referenceOf: () => referenceOf,
+  resolveBannerActions: () => resolveBannerActions,
+  resolveHref: () => resolveHref,
+  withReference: () => withReference
+});
+module.exports = __toCommonJS(links_exports);
+const defaultRouter = {
+  product: (id) => `/products/${encodeURIComponent(id)}`,
+  category: (id) => `/categories/${encodeURIComponent(id)}`,
+  collection: (id) => `/collections/${encodeURIComponent(id)}`,
+  page: (slug) => `/${encodeURIComponent(slug)}`,
+  search: (query) => `/search?q=${encodeURIComponent(query)}`
+};
+const SAFE_REFERENCE = /^[A-Za-z0-9][A-Za-z0-9._~-]*$/;
+const isReference = (value) => typeof value === "string" && SAFE_REFERENCE.test(value);
+const isQuery = (value) => typeof value === "string" && value.trim() !== "";
+const isExternalUrl = (value) => typeof value === "string" && isValidExternal(value);
+function isValidExternal(url) {
+  try {
+    const parsed = new URL(url);
+    return parsed.protocol === "http:" || parsed.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function resolveHref(target, router = defaultRouter) {
+  if (!target) return null;
+  switch (target.kind) {
+    case "product":
+      return isReference(target.id) ? router.product(target.id) : null;
+    case "category":
+      return isReference(target.id) ? router.category(target.id) : null;
+    case "collection":
+      return isReference(target.id) ? router.collection(target.id) : null;
+    case "page":
+      return isReference(target.slug) ? router.page(target.slug) : null;
+    case "search":
+      return isQuery(target.query) ? router.search(target.query) : null;
+    case "external":
+      return isExternalUrl(target.url) ? target.url : null;
+    default:
+      return null;
+  }
+}
+function referenceOf(target) {
+  if (!target) return "";
+  switch (target.kind) {
+    case "page":
+      return typeof target.slug === "string" ? target.slug : "";
+    case "search":
+      return typeof target.query === "string" ? target.query : "";
+    case "external":
+      return typeof target.url === "string" ? target.url : "";
+    default:
+      return typeof target.id === "string" ? target.id : "";
+  }
+}
+function withReference(kind, value) {
+  switch (kind) {
+    case "page":
+      return { kind, slug: value };
+    case "search":
+      return { kind, query: value };
+    case "external":
+      return { kind, url: value };
+    case "product":
+    case "category":
+    case "collection":
+      return { kind, id: value };
+  }
+}
+function resolveBannerActions(record, router = defaultRouter) {
+  const ctas = record.content.ctas.map((cta) => ({ cta, href: resolveHref(cta.target, router) }));
+  const imageOnly = record.presentation.mode === "image-only";
+  const wholeLink = record.content.target !== void 0 && (imageOnly || ctas.length === 0) ? resolveHref(record.content.target, router) : null;
+  return { wholeLink, ctas };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defaultRouter,
+  isValidExternal,
+  referenceOf,
+  resolveBannerActions,
+  resolveHref,
+  withReference
+});
+//# sourceMappingURL=links.js.map

package/dist/blocks/designs/universal-banner/links.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/designs/universal-banner/links.ts"],"sourcesContent":["import type { BannerRecord, Cta, LinkTarget } from './contracts'\n\n/**\n * Navigation adapter. The component never imports a router: the host injects\n * one, or the default storefront paths are used. Destinations are stable ids,\n * not hand-written URLs.\n */\nexport type BannerRouter = {\n  product: (id: string) => string\n  category: (id: string) => string\n  collection: (id: string) => string\n  page: (slug: string) => string\n  search: (query: string) => string\n}\n\nexport const defaultRouter: BannerRouter = {\n  product: (id) => `/products/${encodeURIComponent(id)}`,\n  category: (id) => `/categories/${encodeURIComponent(id)}`,\n  collection: (id) => `/collections/${encodeURIComponent(id)}`,\n  page: (slug) => `/${encodeURIComponent(slug)}`,\n  search: (query) => `/search?q=${encodeURIComponent(query)}`,\n}\n\nconst SAFE_REFERENCE = /^[A-Za-z0-9][A-Za-z0-9._~-]*$/\n\nconst isReference = (value: unknown): value is string => typeof value === 'string' && SAFE_REFERENCE.test(value)\nconst isQuery = (value: unknown): value is string => typeof value === 'string' && value.trim() !== ''\nconst isExternalUrl = (value: unknown): value is string => typeof value === 'string' && isValidExternal(value)\n\nexport function isValidExternal(url: string): boolean {\n  try {\n    const parsed = new URL(url)\n    return parsed.protocol === 'http:' || parsed.protocol === 'https:'\n  } catch {\n    return false\n  }\n}\n\nexport function resolveHref(target: LinkTarget | undefined, router: BannerRouter = defaultRouter): string | null {\n  if (!target) return null\n  switch (target.kind) {\n    case 'product':\n      return isReference(target.id) ? router.product(target.id) : null\n    case 'category':\n      return isReference(target.id) ? router.category(target.id) : null\n    case 'collection':\n      return isReference(target.id) ? router.collection(target.id) : null\n    case 'page':\n      return isReference(target.slug) ? router.page(target.slug) : null\n    case 'search':\n      return isQuery(target.query) ? router.search(target.query) : null\n    case 'external':\n      return isExternalUrl(target.url) ? target.url : null\n    default:\n      return null\n  }\n}\n\n/** Reads the reference of any target kind; a malformed target reads as ''. */\nexport function referenceOf(target: LinkTarget | undefined): string {\n  if (!target) return ''\n  switch (target.kind) {\n    case 'page':\n      return typeof target.slug === 'string' ? target.slug : ''\n    case 'search':\n      return typeof target.query === 'string' ? target.query : ''\n    case 'external':\n      return typeof target.url === 'string' ? target.url : ''\n    default:\n      return typeof target.id === 'string' ? target.id : ''\n  }\n}\n\n/** Builds a well-formed target for a kind; never leaves a foreign `id` behind. */\nexport function withReference(kind: LinkTarget['kind'], value: string): LinkTarget {\n  switch (kind) {\n    case 'page':\n      return { kind, slug: value }\n    case 'search':\n      return { kind, query: value }\n    case 'external':\n      return { kind, url: value }\n    case 'product':\n    case 'category':\n    case 'collection':\n      return { kind, id: value }\n  }\n}\n\nexport type BannerActions = {\n  wholeLink: string | null\n  ctas: Array<{ cta: Cta; href: string | null }>\n}\n\n/**\n * A banner is either a single link or a surface with CTAs, never both: the\n * structure makes nested interactive elements impossible.\n */\nexport function resolveBannerActions(record: BannerRecord, router: BannerRouter = defaultRouter): BannerActions {\n  const ctas = record.content.ctas.map((cta) => ({ cta, href: resolveHref(cta.target, router) }))\n  // Image-only renders no content, so a CTA could never be shown: the target\n  // owns the whole-image link even if the record still carries CTAs.\n  const imageOnly = record.presentation.mode === 'image-only'\n  const wholeLink =\n    record.content.target !== undefined && (imageOnly || ctas.length === 0)\n      ? resolveHref(record.content.target, router)\n      : null\n  return { wholeLink, ctas }\n}\n"],"mappings":"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","names":[]}

package/dist/blocks/designs/universal-banner/links.mjs

@@ -0,0 +1,80 @@
+const defaultRouter = {
+  product: (id) => `/products/${encodeURIComponent(id)}`,
+  category: (id) => `/categories/${encodeURIComponent(id)}`,
+  collection: (id) => `/collections/${encodeURIComponent(id)}`,
+  page: (slug) => `/${encodeURIComponent(slug)}`,
+  search: (query) => `/search?q=${encodeURIComponent(query)}`
+};
+const SAFE_REFERENCE = /^[A-Za-z0-9][A-Za-z0-9._~-]*$/;
+const isReference = (value) => typeof value === "string" && SAFE_REFERENCE.test(value);
+const isQuery = (value) => typeof value === "string" && value.trim() !== "";
+const isExternalUrl = (value) => typeof value === "string" && isValidExternal(value);
+function isValidExternal(url) {
+  try {
+    const parsed = new URL(url);
+    return parsed.protocol === "http:" || parsed.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function resolveHref(target, router = defaultRouter) {
+  if (!target) return null;
+  switch (target.kind) {
+    case "product":
+      return isReference(target.id) ? router.product(target.id) : null;
+    case "category":
+      return isReference(target.id) ? router.category(target.id) : null;
+    case "collection":
+      return isReference(target.id) ? router.collection(target.id) : null;
+    case "page":
+      return isReference(target.slug) ? router.page(target.slug) : null;
+    case "search":
+      return isQuery(target.query) ? router.search(target.query) : null;
+    case "external":
+      return isExternalUrl(target.url) ? target.url : null;
+    default:
+      return null;
+  }
+}
+function referenceOf(target) {
+  if (!target) return "";
+  switch (target.kind) {
+    case "page":
+      return typeof target.slug === "string" ? target.slug : "";
+    case "search":
+      return typeof target.query === "string" ? target.query : "";
+    case "external":
+      return typeof target.url === "string" ? target.url : "";
+    default:
+      return typeof target.id === "string" ? target.id : "";
+  }
+}
+function withReference(kind, value) {
+  switch (kind) {
+    case "page":
+      return { kind, slug: value };
+    case "search":
+      return { kind, query: value };
+    case "external":
+      return { kind, url: value };
+    case "product":
+    case "category":
+    case "collection":
+      return { kind, id: value };
+  }
+}
+function resolveBannerActions(record, router = defaultRouter) {
+  const ctas = record.content.ctas.map((cta) => ({ cta, href: resolveHref(cta.target, router) }));
+  const imageOnly = record.presentation.mode === "image-only";
+  const wholeLink = record.content.target !== void 0 && (imageOnly || ctas.length === 0) ? resolveHref(record.content.target, router) : null;
+  return { wholeLink, ctas };
+}
+export {
+  defaultRouter,
+  isValidExternal,
+  referenceOf,
+  resolveBannerActions,
+  resolveHref,
+  withReference
+};
+//# sourceMappingURL=links.mjs.map

package/dist/blocks/designs/universal-banner/links.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/designs/universal-banner/links.ts"],"sourcesContent":["import type { BannerRecord, Cta, LinkTarget } from './contracts'\n\n/**\n * Navigation adapter. The component never imports a router: the host injects\n * one, or the default storefront paths are used. Destinations are stable ids,\n * not hand-written URLs.\n */\nexport type BannerRouter = {\n  product: (id: string) => string\n  category: (id: string) => string\n  collection: (id: string) => string\n  page: (slug: string) => string\n  search: (query: string) => string\n}\n\nexport const defaultRouter: BannerRouter = {\n  product: (id) => `/products/${encodeURIComponent(id)}`,\n  category: (id) => `/categories/${encodeURIComponent(id)}`,\n  collection: (id) => `/collections/${encodeURIComponent(id)}`,\n  page: (slug) => `/${encodeURIComponent(slug)}`,\n  search: (query) => `/search?q=${encodeURIComponent(query)}`,\n}\n\nconst SAFE_REFERENCE = /^[A-Za-z0-9][A-Za-z0-9._~-]*$/\n\nconst isReference = (value: unknown): value is string => typeof value === 'string' && SAFE_REFERENCE.test(value)\nconst isQuery = (value: unknown): value is string => typeof value === 'string' && value.trim() !== ''\nconst isExternalUrl = (value: unknown): value is string => typeof value === 'string' && isValidExternal(value)\n\nexport function isValidExternal(url: string): boolean {\n  try {\n    const parsed = new URL(url)\n    return parsed.protocol === 'http:' || parsed.protocol === 'https:'\n  } catch {\n    return false\n  }\n}\n\nexport function resolveHref(target: LinkTarget | undefined, router: BannerRouter = defaultRouter): string | null {\n  if (!target) return null\n  switch (target.kind) {\n    case 'product':\n      return isReference(target.id) ? router.product(target.id) : null\n    case 'category':\n      return isReference(target.id) ? router.category(target.id) : null\n    case 'collection':\n      return isReference(target.id) ? router.collection(target.id) : null\n    case 'page':\n      return isReference(target.slug) ? router.page(target.slug) : null\n    case 'search':\n      return isQuery(target.query) ? router.search(target.query) : null\n    case 'external':\n      return isExternalUrl(target.url) ? target.url : null\n    default:\n      return null\n  }\n}\n\n/** Reads the reference of any target kind; a malformed target reads as ''. */\nexport function referenceOf(target: LinkTarget | undefined): string {\n  if (!target) return ''\n  switch (target.kind) {\n    case 'page':\n      return typeof target.slug === 'string' ? target.slug : ''\n    case 'search':\n      return typeof target.query === 'string' ? target.query : ''\n    case 'external':\n      return typeof target.url === 'string' ? target.url : ''\n    default:\n      return typeof target.id === 'string' ? target.id : ''\n  }\n}\n\n/** Builds a well-formed target for a kind; never leaves a foreign `id` behind. */\nexport function withReference(kind: LinkTarget['kind'], value: string): LinkTarget {\n  switch (kind) {\n    case 'page':\n      return { kind, slug: value }\n    case 'search':\n      return { kind, query: value }\n    case 'external':\n      return { kind, url: value }\n    case 'product':\n    case 'category':\n    case 'collection':\n      return { kind, id: value }\n  }\n}\n\nexport type BannerActions = {\n  wholeLink: string | null\n  ctas: Array<{ cta: Cta; href: string | null }>\n}\n\n/**\n * A banner is either a single link or a surface with CTAs, never both: the\n * structure makes nested interactive elements impossible.\n */\nexport function resolveBannerActions(record: BannerRecord, router: BannerRouter = defaultRouter): BannerActions {\n  const ctas = record.content.ctas.map((cta) => ({ cta, href: resolveHref(cta.target, router) }))\n  // Image-only renders no content, so a CTA could never be shown: the target\n  // owns the whole-image link even if the record still carries CTAs.\n  const imageOnly = record.presentation.mode === 'image-only'\n  const wholeLink =\n    record.content.target !== undefined && (imageOnly || ctas.length === 0)\n      ? resolveHref(record.content.target, router)\n      : null\n  return { wholeLink, ctas }\n}\n"],"mappings":"AAeO,MAAM,gBAA8B;AAAA,EACzC,SAAS,CAAC,OAAO,aAAa,mBAAmB,EAAE,CAAC;AAAA,EACpD,UAAU,CAAC,OAAO,eAAe,mBAAmB,EAAE,CAAC;AAAA,EACvD,YAAY,CAAC,OAAO,gBAAgB,mBAAmB,EAAE,CAAC;AAAA,EAC1D,MAAM,CAAC,SAAS,IAAI,mBAAmB,IAAI,CAAC;AAAA,EAC5C,QAAQ,CAAC,UAAU,aAAa,mBAAmB,KAAK,CAAC;AAC3D;AAEA,MAAM,iBAAiB;AAEvB,MAAM,cAAc,CAAC,UAAoC,OAAO,UAAU,YAAY,eAAe,KAAK,KAAK;AAC/G,MAAM,UAAU,CAAC,UAAoC,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM;AACnG,MAAM,gBAAgB,CAAC,UAAoC,OAAO,UAAU,YAAY,gBAAgB,KAAK;AAEtG,SAAS,gBAAgB,KAAsB;AACpD,MAAI;AACF,UAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,WAAO,OAAO,aAAa,WAAW,OAAO,aAAa;AAAA,EAC5D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,YAAY,QAAgC,SAAuB,eAA8B;AAC/G,MAAI,CAAC,OAAQ,QAAO;AACpB,UAAQ,OAAO,MAAM;AAAA,IACnB,KAAK;AACH,aAAO,YAAY,OAAO,EAAE,IAAI,OAAO,QAAQ,OAAO,EAAE,IAAI;AAAA,IAC9D,KAAK;AACH,aAAO,YAAY,OAAO,EAAE,IAAI,OAAO,SAAS,OAAO,EAAE,IAAI;AAAA,IAC/D,KAAK;AACH,aAAO,YAAY,OAAO,EAAE,IAAI,OAAO,WAAW,OAAO,EAAE,IAAI;AAAA,IACjE,KAAK;AACH,aAAO,YAAY,OAAO,IAAI,IAAI,OAAO,KAAK,OAAO,IAAI,IAAI;AAAA,IAC/D,KAAK;AACH,aAAO,QAAQ,OAAO,KAAK,IAAI,OAAO,OAAO,OAAO,KAAK,IAAI;AAAA,IAC/D,KAAK;AACH,aAAO,cAAc,OAAO,GAAG,IAAI,OAAO,MAAM;AAAA,IAClD;AACE,aAAO;AAAA,EACX;AACF;AAGO,SAAS,YAAY,QAAwC;AAClE,MAAI,CAAC,OAAQ,QAAO;AACpB,UAAQ,OAAO,MAAM;AAAA,IACnB,KAAK;AACH,aAAO,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO;AAAA,IACzD,KAAK;AACH,aAAO,OAAO,OAAO,UAAU,WAAW,OAAO,QAAQ;AAAA,IAC3D,KAAK;AACH,aAAO,OAAO,OAAO,QAAQ,WAAW,OAAO,MAAM;AAAA,IACvD;AACE,aAAO,OAAO,OAAO,OAAO,WAAW,OAAO,KAAK;AAAA,EACvD;AACF;AAGO,SAAS,cAAc,MAA0B,OAA2B;AACjF,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO,EAAE,MAAM,MAAM,MAAM;AAAA,IAC7B,KAAK;AACH,aAAO,EAAE,MAAM,OAAO,MAAM;AAAA,IAC9B,KAAK;AACH,aAAO,EAAE,MAAM,KAAK,MAAM;AAAA,IAC5B,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,EAAE,MAAM,IAAI,MAAM;AAAA,EAC7B;AACF;AAWO,SAAS,qBAAqB,QAAsB,SAAuB,eAA8B;AAC9G,QAAM,OAAO,OAAO,QAAQ,KAAK,IAAI,CAAC,SAAS,EAAE,KAAK,MAAM,YAAY,IAAI,QAAQ,MAAM,EAAE,EAAE;AAG9F,QAAM,YAAY,OAAO,aAAa,SAAS;AAC/C,QAAM,YACJ,OAAO,QAAQ,WAAW,WAAc,aAAa,KAAK,WAAW,KACjE,YAAY,OAAO,QAAQ,QAAQ,MAAM,IACzC;AACN,SAAO,EAAE,WAAW,KAAK;AAC3B;","names":[]}

package/dist/blocks/designs/universal-banner/media.d.ts

@@ -0,0 +1,20 @@
+import type { BannerRecord, Breakpoint } from './contracts';
+export type MediaSources = {
+    src: string;
+    srcSet?: string;
+    sizes: string;
+    alt: string;
+    isFallback: boolean;
+};
+export declare function sizesFor(breakpoint: Breakpoint): string;
+/**
+ * `srcset` splits candidates on commas, and every data URI contains one, so a
+ * data-URI source can never be expressed as a candidate list. Real URLs get a
+ * width-descriptor set; the demo's hermetic data URIs fall back to `src`.
+ */
+export declare function buildSrcSet(entries: Array<{
+    src: string;
+    width: number;
+}>): string | undefined;
+export declare function resolveMedia(record: BannerRecord, breakpoint: Breakpoint): MediaSources;
+//# sourceMappingURL=media.d.ts.map

package/dist/blocks/designs/universal-banner/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../../src/blocks/designs/universal-banner/media.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE3D,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAUD,wBAAgB,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAEvD;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,GAAG,SAAS,CAI9F;AAQD,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,GAAG,YAAY,CAoBvF"}

package/dist/blocks/designs/universal-banner/media.js

@@ -0,0 +1,69 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var media_exports = {};
+__export(media_exports, {
+  buildSrcSet: () => buildSrcSet,
+  resolveMedia: () => resolveMedia,
+  sizesFor: () => sizesFor
+});
+module.exports = __toCommonJS(media_exports);
+var import_contracts = require("@thorprovider/blocks/contracts");
+const WIDTHS = { mobile: 640, tablet: 1024, desktop: 1600 };
+const SIZES = {
+  base: "100vw",
+  md: "(min-width: 672px) 50vw, 100vw",
+  "2xl": "(min-width: 672px) 50vw, 100vw"
+};
+function sizesFor(breakpoint) {
+  return SIZES[breakpoint];
+}
+const isUrlSource = (value) => typeof value === "string" && (value.startsWith("http://") || value.startsWith("https://") || value.startsWith("/"));
+function buildSrcSet(entries) {
+  if (entries.length < 2) return void 0;
+  if (!entries.every((entry) => isUrlSource(entry.src))) return void 0;
+  return entries.map((entry) => `${entry.src} ${entry.width}w`).join(", ");
+}
+const PREFERENCE = {
+  base: ["mobile", "tablet", "desktop"],
+  md: ["tablet", "desktop", "mobile"],
+  "2xl": ["desktop", "tablet", "mobile"]
+};
+function resolveMedia(record, breakpoint) {
+  const media = record.media;
+  const chosen = PREFERENCE[breakpoint].map((key) => media[key]).find((value) => value !== void 0);
+  const alt = record.content.alt;
+  if (chosen === void 0) {
+    return { src: import_contracts.PRODUCT_IMAGE_FALLBACK, sizes: sizesFor(breakpoint), alt, isFallback: true };
+  }
+  const entries = ["mobile", "tablet", "desktop"].filter((key) => isUrlSource(media[key])).map((key) => ({ src: media[key], width: WIDTHS[key] }));
+  return {
+    src: chosen,
+    srcSet: buildSrcSet(entries),
+    sizes: sizesFor(breakpoint),
+    alt,
+    isFallback: false
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildSrcSet,
+  resolveMedia,
+  sizesFor
+});
+//# sourceMappingURL=media.js.map

package/dist/blocks/designs/universal-banner/media.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/designs/universal-banner/media.ts"],"sourcesContent":["import { PRODUCT_IMAGE_FALLBACK } from '@thorprovider/blocks/contracts'\n\nimport type { BannerRecord, Breakpoint } from './contracts'\n\nexport type MediaSources = {\n  src: string\n  srcSet?: string\n  sizes: string\n  alt: string\n  isFallback: boolean\n}\n\nconst WIDTHS = { mobile: 640, tablet: 1024, desktop: 1600 } as const\n\nconst SIZES: Record<Breakpoint, string> = {\n  base: '100vw',\n  md: '(min-width: 672px) 50vw, 100vw',\n  '2xl': '(min-width: 672px) 50vw, 100vw',\n}\n\nexport function sizesFor(breakpoint: Breakpoint): string {\n  return SIZES[breakpoint]\n}\n\nconst isUrlSource = (value: string | undefined): value is string =>\n  typeof value === 'string' &&\n  (value.startsWith('http://') || value.startsWith('https://') || value.startsWith('/'))\n\n/**\n * `srcset` splits candidates on commas, and every data URI contains one, so a\n * data-URI source can never be expressed as a candidate list. Real URLs get a\n * width-descriptor set; the demo's hermetic data URIs fall back to `src`.\n */\nexport function buildSrcSet(entries: Array<{ src: string; width: number }>): string | undefined {\n  if (entries.length < 2) return undefined\n  if (!entries.every((entry) => isUrlSource(entry.src))) return undefined\n  return entries.map((entry) => `${entry.src} ${entry.width}w`).join(', ')\n}\n\nconst PREFERENCE: Record<Breakpoint, Array<keyof typeof WIDTHS>> = {\n  base: ['mobile', 'tablet', 'desktop'],\n  md: ['tablet', 'desktop', 'mobile'],\n  '2xl': ['desktop', 'tablet', 'mobile'],\n}\n\nexport function resolveMedia(record: BannerRecord, breakpoint: Breakpoint): MediaSources {\n  const media = record.media\n  const chosen = PREFERENCE[breakpoint].map((key) => media[key]).find((value) => value !== undefined)\n  const alt = record.content.alt\n\n  if (chosen === undefined) {\n    return { src: PRODUCT_IMAGE_FALLBACK, sizes: sizesFor(breakpoint), alt, isFallback: true }\n  }\n\n  const entries = (['mobile', 'tablet', 'desktop'] as const)\n    .filter((key) => isUrlSource(media[key]))\n    .map((key) => ({ src: media[key] as string, width: WIDTHS[key] }))\n\n  return {\n    src: chosen,\n    srcSet: buildSrcSet(entries),\n    sizes: sizesFor(breakpoint),\n    alt,\n    isFallback: false,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAAuC;AAYvC,MAAM,SAAS,EAAE,QAAQ,KAAK,QAAQ,MAAM,SAAS,KAAK;AAE1D,MAAM,QAAoC;AAAA,EACxC,MAAM;AAAA,EACN,IAAI;AAAA,EACJ,OAAO;AACT;AAEO,SAAS,SAAS,YAAgC;AACvD,SAAO,MAAM,UAAU;AACzB;AAEA,MAAM,cAAc,CAAC,UACnB,OAAO,UAAU,aAChB,MAAM,WAAW,SAAS,KAAK,MAAM,WAAW,UAAU,KAAK,MAAM,WAAW,GAAG;AAO/E,SAAS,YAAY,SAAoE;AAC9F,MAAI,QAAQ,SAAS,EAAG,QAAO;AAC/B,MAAI,CAAC,QAAQ,MAAM,CAAC,UAAU,YAAY,MAAM,GAAG,CAAC,EAAG,QAAO;AAC9D,SAAO,QAAQ,IAAI,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,KAAK,IAAI;AACzE;AAEA,MAAM,aAA6D;AAAA,EACjE,MAAM,CAAC,UAAU,UAAU,SAAS;AAAA,EACpC,IAAI,CAAC,UAAU,WAAW,QAAQ;AAAA,EAClC,OAAO,CAAC,WAAW,UAAU,QAAQ;AACvC;AAEO,SAAS,aAAa,QAAsB,YAAsC;AACvF,QAAM,QAAQ,OAAO;AACrB,QAAM,SAAS,WAAW,UAAU,EAAE,IAAI,CAAC,QAAQ,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,UAAU,UAAU,MAAS;AAClG,QAAM,MAAM,OAAO,QAAQ;AAE3B,MAAI,WAAW,QAAW;AACxB,WAAO,EAAE,KAAK,yCAAwB,OAAO,SAAS,UAAU,GAAG,KAAK,YAAY,KAAK;AAAA,EAC3F;AAEA,QAAM,UAAW,CAAC,UAAU,UAAU,SAAS,EAC5C,OAAO,CAAC,QAAQ,YAAY,MAAM,GAAG,CAAC,CAAC,EACvC,IAAI,CAAC,SAAS,EAAE,KAAK,MAAM,GAAG,GAAa,OAAO,OAAO,GAAG,EAAE,EAAE;AAEnE,SAAO;AAAA,IACL,KAAK;AAAA,IACL,QAAQ,YAAY,OAAO;AAAA,IAC3B,OAAO,SAAS,UAAU;AAAA,IAC1B;AAAA,IACA,YAAY;AAAA,EACd;AACF;","names":[]}

package/dist/blocks/designs/universal-banner/media.mjs

@@ -0,0 +1,43 @@
+import { PRODUCT_IMAGE_FALLBACK } from "@thorprovider/blocks/contracts";
+const WIDTHS = { mobile: 640, tablet: 1024, desktop: 1600 };
+const SIZES = {
+  base: "100vw",
+  md: "(min-width: 672px) 50vw, 100vw",
+  "2xl": "(min-width: 672px) 50vw, 100vw"
+};
+function sizesFor(breakpoint) {
+  return SIZES[breakpoint];
+}
+const isUrlSource = (value) => typeof value === "string" && (value.startsWith("http://") || value.startsWith("https://") || value.startsWith("/"));
+function buildSrcSet(entries) {
+  if (entries.length < 2) return void 0;
+  if (!entries.every((entry) => isUrlSource(entry.src))) return void 0;
+  return entries.map((entry) => `${entry.src} ${entry.width}w`).join(", ");
+}
+const PREFERENCE = {
+  base: ["mobile", "tablet", "desktop"],
+  md: ["tablet", "desktop", "mobile"],
+  "2xl": ["desktop", "tablet", "mobile"]
+};
+function resolveMedia(record, breakpoint) {
+  const media = record.media;
+  const chosen = PREFERENCE[breakpoint].map((key) => media[key]).find((value) => value !== void 0);
+  const alt = record.content.alt;
+  if (chosen === void 0) {
+    return { src: PRODUCT_IMAGE_FALLBACK, sizes: sizesFor(breakpoint), alt, isFallback: true };
+  }
+  const entries = ["mobile", "tablet", "desktop"].filter((key) => isUrlSource(media[key])).map((key) => ({ src: media[key], width: WIDTHS[key] }));
+  return {
+    src: chosen,
+    srcSet: buildSrcSet(entries),
+    sizes: sizesFor(breakpoint),
+    alt,
+    isFallback: false
+  };
+}
+export {
+  buildSrcSet,
+  resolveMedia,
+  sizesFor
+};
+//# sourceMappingURL=media.mjs.map

package/dist/blocks/designs/universal-banner/media.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/blocks/designs/universal-banner/media.ts"],"sourcesContent":["import { PRODUCT_IMAGE_FALLBACK } from '@thorprovider/blocks/contracts'\n\nimport type { BannerRecord, Breakpoint } from './contracts'\n\nexport type MediaSources = {\n  src: string\n  srcSet?: string\n  sizes: string\n  alt: string\n  isFallback: boolean\n}\n\nconst WIDTHS = { mobile: 640, tablet: 1024, desktop: 1600 } as const\n\nconst SIZES: Record<Breakpoint, string> = {\n  base: '100vw',\n  md: '(min-width: 672px) 50vw, 100vw',\n  '2xl': '(min-width: 672px) 50vw, 100vw',\n}\n\nexport function sizesFor(breakpoint: Breakpoint): string {\n  return SIZES[breakpoint]\n}\n\nconst isUrlSource = (value: string | undefined): value is string =>\n  typeof value === 'string' &&\n  (value.startsWith('http://') || value.startsWith('https://') || value.startsWith('/'))\n\n/**\n * `srcset` splits candidates on commas, and every data URI contains one, so a\n * data-URI source can never be expressed as a candidate list. Real URLs get a\n * width-descriptor set; the demo's hermetic data URIs fall back to `src`.\n */\nexport function buildSrcSet(entries: Array<{ src: string; width: number }>): string | undefined {\n  if (entries.length < 2) return undefined\n  if (!entries.every((entry) => isUrlSource(entry.src))) return undefined\n  return entries.map((entry) => `${entry.src} ${entry.width}w`).join(', ')\n}\n\nconst PREFERENCE: Record<Breakpoint, Array<keyof typeof WIDTHS>> = {\n  base: ['mobile', 'tablet', 'desktop'],\n  md: ['tablet', 'desktop', 'mobile'],\n  '2xl': ['desktop', 'tablet', 'mobile'],\n}\n\nexport function resolveMedia(record: BannerRecord, breakpoint: Breakpoint): MediaSources {\n  const media = record.media\n  const chosen = PREFERENCE[breakpoint].map((key) => media[key]).find((value) => value !== undefined)\n  const alt = record.content.alt\n\n  if (chosen === undefined) {\n    return { src: PRODUCT_IMAGE_FALLBACK, sizes: sizesFor(breakpoint), alt, isFallback: true }\n  }\n\n  const entries = (['mobile', 'tablet', 'desktop'] as const)\n    .filter((key) => isUrlSource(media[key]))\n    .map((key) => ({ src: media[key] as string, width: WIDTHS[key] }))\n\n  return {\n    src: chosen,\n    srcSet: buildSrcSet(entries),\n    sizes: sizesFor(breakpoint),\n    alt,\n    isFallback: false,\n  }\n}\n"],"mappings":"AAAA,SAAS,8BAA8B;AAYvC,MAAM,SAAS,EAAE,QAAQ,KAAK,QAAQ,MAAM,SAAS,KAAK;AAE1D,MAAM,QAAoC;AAAA,EACxC,MAAM;AAAA,EACN,IAAI;AAAA,EACJ,OAAO;AACT;AAEO,SAAS,SAAS,YAAgC;AACvD,SAAO,MAAM,UAAU;AACzB;AAEA,MAAM,cAAc,CAAC,UACnB,OAAO,UAAU,aAChB,MAAM,WAAW,SAAS,KAAK,MAAM,WAAW,UAAU,KAAK,MAAM,WAAW,GAAG;AAO/E,SAAS,YAAY,SAAoE;AAC9F,MAAI,QAAQ,SAAS,EAAG,QAAO;AAC/B,MAAI,CAAC,QAAQ,MAAM,CAAC,UAAU,YAAY,MAAM,GAAG,CAAC,EAAG,QAAO;AAC9D,SAAO,QAAQ,IAAI,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,KAAK,IAAI;AACzE;AAEA,MAAM,aAA6D;AAAA,EACjE,MAAM,CAAC,UAAU,UAAU,SAAS;AAAA,EACpC,IAAI,CAAC,UAAU,WAAW,QAAQ;AAAA,EAClC,OAAO,CAAC,WAAW,UAAU,QAAQ;AACvC;AAEO,SAAS,aAAa,QAAsB,YAAsC;AACvF,QAAM,QAAQ,OAAO;AACrB,QAAM,SAAS,WAAW,UAAU,EAAE,IAAI,CAAC,QAAQ,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,UAAU,UAAU,MAAS;AAClG,QAAM,MAAM,OAAO,QAAQ;AAE3B,MAAI,WAAW,QAAW;AACxB,WAAO,EAAE,KAAK,wBAAwB,OAAO,SAAS,UAAU,GAAG,KAAK,YAAY,KAAK;AAAA,EAC3F;AAEA,QAAM,UAAW,CAAC,UAAU,UAAU,SAAS,EAC5C,OAAO,CAAC,QAAQ,YAAY,MAAM,GAAG,CAAC,CAAC,EACvC,IAAI,CAAC,SAAS,EAAE,KAAK,MAAM,GAAG,GAAa,OAAO,OAAO,GAAG,EAAE,EAAE;AAEnE,SAAO;AAAA,IACL,KAAK;AAAA,IACL,QAAQ,YAAY,OAAO;AAAA,IAC3B,OAAO,SAAS,UAAU;AAAA,IAC1B;AAAA,IACA,YAAY;AAAA,EACd;AACF;","names":[]}

package/dist/blocks/designs/universal-banner/presets.d.ts

@@ -0,0 +1,26 @@
+import type { Breakpoint, PresetId } from './contracts';
+export type ItemLayout = {
+    colSpan: Record<Breakpoint, number>;
+    rowSpan: Record<Breakpoint, number>;
+};
+export type ResolvedLayout = {
+    columns: Record<Breakpoint, number>;
+    rows: Record<Breakpoint, number>;
+    items: ItemLayout[];
+};
+export declare const PRESET_IDS: PresetId[];
+/**
+ * Resolves the cell of every banner for a preset. It never leaves a hole: when
+ * the banner count does not fill the pattern exactly, the preset degrades to
+ * equal columns instead of a ragged row.
+ */
+export declare function resolveLayout(preset: PresetId, count: number, custom?: {
+    columns?: Record<Breakpoint, number>;
+    spans?: number[];
+}): ResolvedLayout;
+/**
+ * True when the resolved cells leave an empty cell inside the occupied rows.
+ * Used by the tests as the "never leave a hole" oracle.
+ */
+export declare function hasGaps(layout: ResolvedLayout, breakpoint: Breakpoint): boolean;
+//# sourceMappingURL=presets.d.ts.map

package/dist/blocks/designs/universal-banner/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../src/blocks/designs/universal-banner/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEvD,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IACnC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IACnC,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IAChC,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,QAAQ,EAShC,CAAA;AAyED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAClE,cAAc,CAyChB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CA2C/E"}