@adcp/sdk 13.0.0-rc.6 → 13.0.0-rc.8

package/dist/lib/testing/storyboard/creative-assets.mjs

@@ -0,0 +1,154 @@
+const BUILD_ASSETS_FROM_FORMAT_DIRECTIVE = "$build_assets_from_format";
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function asNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function normalizeAgentUrl(value) {
+  if (typeof value !== "string") return void 0;
+  return value.replace(/\/$/, "");
+}
+function formatIdMatches(candidate, requested) {
+  if (!isObject(candidate)) return false;
+  if (candidate.id !== requested.id) return false;
+  const requestedAgent = normalizeAgentUrl(requested.agent_url);
+  const candidateAgent = normalizeAgentUrl(candidate.agent_url);
+  return requestedAgent === void 0 || candidateAgent === requestedAgent;
+}
+function resolveFormat(value, context) {
+  if (!isObject(value)) return void 0;
+  if (Array.isArray(value.slots) || Array.isArray(value.assets) || Array.isArray(value.assets_required)) {
+    return value;
+  }
+  if (typeof value.id !== "string") return void 0;
+  const formats = Array.isArray(context.formats) ? context.formats : [];
+  return formats.find(
+    (candidate) => isObject(candidate) && formatIdMatches(candidate.format_id, value)
+  );
+}
+function dimensionsFromId(format) {
+  const formatId = isObject(format.format_id) ? format.format_id.id : void 0;
+  const match = typeof formatId === "string" ? formatId.match(/(?:^|_)(\d{2,4})x(\d{2,4})(?:_|$)/i) : null;
+  return match ? { width: Number(match[1]), height: Number(match[2]) } : {};
+}
+function formatDimensions(format) {
+  const direct = { width: asNumber(format.width), height: asNumber(format.height) };
+  if (direct.width !== void 0 || direct.height !== void 0) return direct;
+  const renders = Array.isArray(format.renders) ? format.renders : [];
+  for (const render of renders) {
+    if (!isObject(render)) continue;
+    const dimensions = isObject(render.dimensions) ? render.dimensions : render;
+    const width = asNumber(dimensions.width);
+    const height = asNumber(dimensions.height);
+    if (width !== void 0 || height !== void 0) return { width, height };
+  }
+  return dimensionsFromId(format);
+}
+function slotDimensions(slot, fallback) {
+  const requirements = isObject(slot.requirements) ? slot.requirements : {};
+  const nested = isObject(requirements.dimensions) ? requirements.dimensions : requirements;
+  return {
+    width: asNumber(slot.width) ?? asNumber(nested.width) ?? fallback.width,
+    height: asNumber(slot.height) ?? asNumber(nested.height) ?? fallback.height
+  };
+}
+function requiredSlots(format) {
+  const canonicalSlots = Array.isArray(format.slots) ? format.slots : void 0;
+  const legacySlots = Array.isArray(format.assets) ? format.assets : Array.isArray(format.assets_required) ? format.assets_required : void 0;
+  const slots = canonicalSlots ?? legacySlots ?? [];
+  const fallback = formatDimensions(format);
+  return slots.flatMap((slotValue) => {
+    if (!isObject(slotValue) || slotValue.required !== true) return [];
+    const id = canonicalSlots ? slotValue.asset_group_id : slotValue.asset_id;
+    if (typeof id !== "string" || typeof slotValue.asset_type !== "string") return [];
+    return [{ id, assetType: slotValue.asset_type, ...slotDimensions(slotValue, fallback) }];
+  });
+}
+function buildImage(slot, assets) {
+  const images = Array.isArray(assets.images) ? assets.images.filter(isObject) : [];
+  const image = images.find((candidate) => {
+    const widthMatches = slot.width === void 0 || candidate.width === slot.width;
+    const heightMatches = slot.height === void 0 || candidate.height === slot.height;
+    return widthMatches && heightMatches;
+  });
+  if (!image || typeof image.url !== "string") return void 0;
+  return {
+    asset_type: "image",
+    url: image.url,
+    ...asNumber(image.width) !== void 0 ? { width: image.width } : {},
+    ...asNumber(image.height) !== void 0 ? { height: image.height } : {},
+    ...typeof image.mime_type === "string" ? { mime_type: image.mime_type } : {}
+  };
+}
+function firstString(value) {
+  return Array.isArray(value) ? value.find((item) => typeof item === "string") : void 0;
+}
+function buildText(slot, assets) {
+  const text = isObject(assets.text) ? assets.text : {};
+  const id = slot.id.toLowerCase();
+  const content = id.includes("headline") ? firstString(text.headlines) : id.includes("description") || id.includes("body") ? firstString(text.descriptions) : id.includes("cta") || id.includes("call_to_action") ? firstString(text.cta) : firstString(text.headlines) ?? firstString(text.descriptions) ?? firstString(text.cta);
+  return content === void 0 ? void 0 : { asset_type: "text", content };
+}
+function buildAsset(slot, testKit) {
+  if (!isObject(testKit) || !isObject(testKit.assets)) return void 0;
+  const assets = testKit.assets;
+  if (slot.assetType === "image") return buildImage(slot, assets);
+  if (slot.assetType === "url" && typeof assets.click_url === "string") {
+    return { asset_type: "url", url: assets.click_url };
+  }
+  if (slot.assetType === "text") return buildText(slot, assets);
+  return void 0;
+}
+function buildAssets(value, context, testKit) {
+  const format = resolveFormat(value, context);
+  if (!format) return void 0;
+  const slots = requiredSlots(format);
+  if (slots.length === 0) return void 0;
+  const built = {};
+  for (const slot of slots) {
+    const asset = buildAsset(slot, testKit);
+    if (!asset) return void 0;
+    built[slot.id] = asset;
+  }
+  return built;
+}
+function expandCreativeAssetDirectives(value, context, testKit) {
+  if (Array.isArray(value)) {
+    return value.map((item) => expandCreativeAssetDirectives(item, context, testKit));
+  }
+  if (!isObject(value)) return value;
+  if (Object.prototype.hasOwnProperty.call(value, BUILD_ASSETS_FROM_FORMAT_DIRECTIVE)) {
+    const built = buildAssets(value[BUILD_ASSETS_FROM_FORMAT_DIRECTIVE], context, testKit);
+    if (!built) return value;
+    const siblings = Object.fromEntries(
+      Object.entries(value).filter(([key]) => key !== BUILD_ASSETS_FROM_FORMAT_DIRECTIVE).map(([key, item]) => [key, expandCreativeAssetDirectives(item, context, testKit)])
+    );
+    return { ...siblings, ...built };
+  }
+  return Object.fromEntries(
+    Object.entries(value).map(([key, item]) => [key, expandCreativeAssetDirectives(item, context, testKit)])
+  );
+}
+function findUnresolvedCreativeAssetDirectives(value) {
+  const paths = [];
+  const walk = (item, path) => {
+    if (Array.isArray(item)) {
+      item.forEach((entry, index) => walk(entry, `${path}[${index}]`));
+      return;
+    }
+    if (!isObject(item)) return;
+    if (Object.prototype.hasOwnProperty.call(item, BUILD_ASSETS_FROM_FORMAT_DIRECTIVE)) {
+      paths.push(`${path}.${BUILD_ASSETS_FROM_FORMAT_DIRECTIVE}`);
+    }
+    Object.entries(item).forEach(([key, entry]) => walk(entry, path ? `${path}.${key}` : key));
+  };
+  walk(value, "$");
+  return paths;
+}
+export {
+  BUILD_ASSETS_FROM_FORMAT_DIRECTIVE,
+  expandCreativeAssetDirectives,
+  findUnresolvedCreativeAssetDirectives
+};
+//# sourceMappingURL=creative-assets.mjs.map

package/dist/lib/testing/storyboard/creative-assets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/testing/storyboard/creative-assets.ts"],"sourcesContent":["import type { StoryboardContext } from './types';\n\nexport const BUILD_ASSETS_FROM_FORMAT_DIRECTIVE = '$build_assets_from_format';\n\ntype JsonObject = Record<string, unknown>;\n\ninterface Dimensions {\n  width?: number;\n  height?: number;\n}\n\ninterface RequiredSlot extends Dimensions {\n  id: string;\n  assetType: string;\n}\n\nfunction isObject(value: unknown): value is JsonObject {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction asNumber(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\nfunction normalizeAgentUrl(value: unknown): string | undefined {\n  if (typeof value !== 'string') return undefined;\n  return value.replace(/\\/$/, '');\n}\n\nfunction formatIdMatches(candidate: unknown, requested: JsonObject): boolean {\n  if (!isObject(candidate)) return false;\n  if (candidate.id !== requested.id) return false;\n  const requestedAgent = normalizeAgentUrl(requested.agent_url);\n  const candidateAgent = normalizeAgentUrl(candidate.agent_url);\n  return requestedAgent === undefined || candidateAgent === requestedAgent;\n}\n\nfunction resolveFormat(value: unknown, context: StoryboardContext): JsonObject | undefined {\n  if (!isObject(value)) return undefined;\n  if (Array.isArray(value.slots) || Array.isArray(value.assets) || Array.isArray(value.assets_required)) {\n    return value;\n  }\n\n  if (typeof value.id !== 'string') return undefined;\n  const formats = Array.isArray(context.formats) ? context.formats : [];\n  return formats.find(\n    (candidate): candidate is JsonObject => isObject(candidate) && formatIdMatches(candidate.format_id, value)\n  );\n}\n\nfunction dimensionsFromId(format: JsonObject): Dimensions {\n  const formatId = isObject(format.format_id) ? format.format_id.id : undefined;\n  const match = typeof formatId === 'string' ? formatId.match(/(?:^|_)(\\d{2,4})x(\\d{2,4})(?:_|$)/i) : null;\n  return match ? { width: Number(match[1]), height: Number(match[2]) } : {};\n}\n\nfunction formatDimensions(format: JsonObject): Dimensions {\n  const direct = { width: asNumber(format.width), height: asNumber(format.height) };\n  if (direct.width !== undefined || direct.height !== undefined) return direct;\n\n  const renders = Array.isArray(format.renders) ? format.renders : [];\n  for (const render of renders) {\n    if (!isObject(render)) continue;\n    const dimensions = isObject(render.dimensions) ? render.dimensions : render;\n    const width = asNumber(dimensions.width);\n    const height = asNumber(dimensions.height);\n    if (width !== undefined || height !== undefined) return { width, height };\n  }\n\n  return dimensionsFromId(format);\n}\n\nfunction slotDimensions(slot: JsonObject, fallback: Dimensions): Dimensions {\n  const requirements = isObject(slot.requirements) ? slot.requirements : {};\n  const nested = isObject(requirements.dimensions) ? requirements.dimensions : requirements;\n  return {\n    width: asNumber(slot.width) ?? asNumber(nested.width) ?? fallback.width,\n    height: asNumber(slot.height) ?? asNumber(nested.height) ?? fallback.height,\n  };\n}\n\nfunction requiredSlots(format: JsonObject): RequiredSlot[] {\n  const canonicalSlots = Array.isArray(format.slots) ? format.slots : undefined;\n  const legacySlots = Array.isArray(format.assets)\n    ? format.assets\n    : Array.isArray(format.assets_required)\n      ? format.assets_required\n      : undefined;\n  const slots = canonicalSlots ?? legacySlots ?? [];\n  const fallback = formatDimensions(format);\n\n  return slots.flatMap(slotValue => {\n    if (!isObject(slotValue) || slotValue.required !== true) return [];\n    const id = canonicalSlots ? slotValue.asset_group_id : slotValue.asset_id;\n    if (typeof id !== 'string' || typeof slotValue.asset_type !== 'string') return [];\n    return [{ id, assetType: slotValue.asset_type, ...slotDimensions(slotValue, fallback) }];\n  });\n}\n\nfunction buildImage(slot: RequiredSlot, assets: JsonObject): JsonObject | undefined {\n  const images = Array.isArray(assets.images) ? assets.images.filter(isObject) : [];\n  const image = images.find(candidate => {\n    const widthMatches = slot.width === undefined || candidate.width === slot.width;\n    const heightMatches = slot.height === undefined || candidate.height === slot.height;\n    return widthMatches && heightMatches;\n  });\n  if (!image || typeof image.url !== 'string') return undefined;\n  return {\n    asset_type: 'image',\n    url: image.url,\n    ...(asNumber(image.width) !== undefined ? { width: image.width } : {}),\n    ...(asNumber(image.height) !== undefined ? { height: image.height } : {}),\n    ...(typeof image.mime_type === 'string' ? { mime_type: image.mime_type } : {}),\n  };\n}\n\nfunction firstString(value: unknown): string | undefined {\n  return Array.isArray(value) ? value.find((item): item is string => typeof item === 'string') : undefined;\n}\n\nfunction buildText(slot: RequiredSlot, assets: JsonObject): JsonObject | undefined {\n  const text = isObject(assets.text) ? assets.text : {};\n  const id = slot.id.toLowerCase();\n  const content = id.includes('headline')\n    ? firstString(text.headlines)\n    : id.includes('description') || id.includes('body')\n      ? firstString(text.descriptions)\n      : id.includes('cta') || id.includes('call_to_action')\n        ? firstString(text.cta)\n        : (firstString(text.headlines) ?? firstString(text.descriptions) ?? firstString(text.cta));\n  return content === undefined ? undefined : { asset_type: 'text', content };\n}\n\nfunction buildAsset(slot: RequiredSlot, testKit: unknown): JsonObject | undefined {\n  if (!isObject(testKit) || !isObject(testKit.assets)) return undefined;\n  const assets = testKit.assets;\n  if (slot.assetType === 'image') return buildImage(slot, assets);\n  if (slot.assetType === 'url' && typeof assets.click_url === 'string') {\n    return { asset_type: 'url', url: assets.click_url };\n  }\n  if (slot.assetType === 'text') return buildText(slot, assets);\n  return undefined;\n}\n\nfunction buildAssets(value: unknown, context: StoryboardContext, testKit: unknown): JsonObject | undefined {\n  const format = resolveFormat(value, context);\n  if (!format) return undefined;\n  const slots = requiredSlots(format);\n  if (slots.length === 0) return undefined;\n\n  const built: JsonObject = {};\n  for (const slot of slots) {\n    const asset = buildAsset(slot, testKit);\n    if (!asset) return undefined;\n    built[slot.id] = asset;\n  }\n  return built;\n}\n\n/** Expand reserved storyboard creative-asset directives without mutating the fixture. */\nexport function expandCreativeAssetDirectives(value: unknown, context: StoryboardContext, testKit: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(item => expandCreativeAssetDirectives(item, context, testKit));\n  }\n  if (!isObject(value)) return value;\n\n  if (Object.prototype.hasOwnProperty.call(value, BUILD_ASSETS_FROM_FORMAT_DIRECTIVE)) {\n    const built = buildAssets(value[BUILD_ASSETS_FROM_FORMAT_DIRECTIVE], context, testKit);\n    if (!built) return value;\n    const siblings = Object.fromEntries(\n      Object.entries(value)\n        .filter(([key]) => key !== BUILD_ASSETS_FROM_FORMAT_DIRECTIVE)\n        .map(([key, item]) => [key, expandCreativeAssetDirectives(item, context, testKit)])\n    );\n    return { ...siblings, ...built };\n  }\n\n  return Object.fromEntries(\n    Object.entries(value).map(([key, item]) => [key, expandCreativeAssetDirectives(item, context, testKit)])\n  );\n}\n\nexport function findUnresolvedCreativeAssetDirectives(value: unknown): string[] {\n  const paths: string[] = [];\n  const walk = (item: unknown, path: string) => {\n    if (Array.isArray(item)) {\n      item.forEach((entry, index) => walk(entry, `${path}[${index}]`));\n      return;\n    }\n    if (!isObject(item)) return;\n    if (Object.prototype.hasOwnProperty.call(item, BUILD_ASSETS_FROM_FORMAT_DIRECTIVE)) {\n      paths.push(`${path}.${BUILD_ASSETS_FROM_FORMAT_DIRECTIVE}`);\n    }\n    Object.entries(item).forEach(([key, entry]) => walk(entry, path ? `${path}.${key}` : key));\n  };\n  walk(value, '$');\n  return paths;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/testing/storyboard/fixture-resolution.d.mts

@@ -0,0 +1,37 @@
+import { type SchemaEntityPath } from '../../validation/schema-loader.mjs';
+import type { FixtureMatchClause, FixtureResolutionStrategy, Storyboard } from './types.mjs';
+/** Normalize and validate the closed fixture matching DSL. */
+export declare function normalizeFixtureMatchExpression(expression: unknown, location: string): FixtureMatchClause[];
+/** Loader/runtime authoring validation for the AdCP 3.2 declaration block. */
+export declare function validateFixtureResolutionDeclarations(storyboard: Storyboard): void;
+/** True when a seller catalog entity satisfies every authored clause. */
+export declare function matchesFixtureRequirements(candidate: unknown, clauses: readonly FixtureMatchClause[]): boolean;
+export interface FixtureResolutionSpec {
+    entityType: 'product' | 'product_pricing_option';
+    handle: string;
+    parentProductHandle?: string;
+    fixture: Record<string, unknown>;
+    strategies: FixtureResolutionStrategy[];
+    clauses: FixtureMatchClause[];
+    allowReuse: boolean;
+}
+/** Normalize fixture rows + optional metadata into the ordered handle list. */
+export declare function buildFixtureResolutionSpecs(storyboard: Storyboard): FixtureResolutionSpec[];
+/** Run-scoped, pinned handle bindings. */
+export declare class FixtureBindingRegistry {
+    private readonly products;
+    private readonly productHandlesBySellerId;
+    private readonly pricingOptions;
+    private readonly pricingScopesByHandle;
+    bindProduct(handle: string, sellerProductId: string): void;
+    bindPricingOption(parentHandle: string, handle: string, sellerPricingOptionId: string): void;
+    productId(handle: string): string | undefined;
+    productHandle(value: string): string | undefined;
+    pricingOptionId(handle: string, parentValue?: string): string | undefined;
+}
+/**
+ * Replace exact handles only at request-schema leaves carrying the matching
+ * `x-entity` annotation. Pricing-option replacement runs first so its parent
+ * scope is read before the sibling product handle is rewritten.
+ */
+export declare function applyFixtureBindingsToRequest(request: Record<string, unknown>, toolName: string, bindings: FixtureBindingRegistry | undefined, version?: string, entityPaths?: readonly SchemaEntityPath[]): Record<string, unknown>;

package/dist/lib/testing/storyboard/fixture-resolution.d.ts

@@ -0,0 +1,38 @@
+import { type SchemaEntityPath } from '../../validation/schema-loader';
+import type { FixtureMatchClause, FixtureResolutionStrategy, Storyboard } from './types';
+/** Normalize and validate the closed fixture matching DSL. */
+export declare function normalizeFixtureMatchExpression(expression: unknown, location: string): FixtureMatchClause[];
+/** Loader/runtime authoring validation for the AdCP 3.2 declaration block. */
+export declare function validateFixtureResolutionDeclarations(storyboard: Storyboard): void;
+/** True when a seller catalog entity satisfies every authored clause. */
+export declare function matchesFixtureRequirements(candidate: unknown, clauses: readonly FixtureMatchClause[]): boolean;
+export interface FixtureResolutionSpec {
+    entityType: 'product' | 'product_pricing_option';
+    handle: string;
+    parentProductHandle?: string;
+    fixture: Record<string, unknown>;
+    strategies: FixtureResolutionStrategy[];
+    clauses: FixtureMatchClause[];
+    allowReuse: boolean;
+}
+/** Normalize fixture rows + optional metadata into the ordered handle list. */
+export declare function buildFixtureResolutionSpecs(storyboard: Storyboard): FixtureResolutionSpec[];
+/** Run-scoped, pinned handle bindings. */
+export declare class FixtureBindingRegistry {
+    private readonly products;
+    private readonly productHandlesBySellerId;
+    private readonly pricingOptions;
+    private readonly pricingScopesByHandle;
+    bindProduct(handle: string, sellerProductId: string): void;
+    bindPricingOption(parentHandle: string, handle: string, sellerPricingOptionId: string): void;
+    productId(handle: string): string | undefined;
+    productHandle(value: string): string | undefined;
+    pricingOptionId(handle: string, parentValue?: string): string | undefined;
+}
+/**
+ * Replace exact handles only at request-schema leaves carrying the matching
+ * `x-entity` annotation. Pricing-option replacement runs first so its parent
+ * scope is read before the sibling product handle is rewritten.
+ */
+export declare function applyFixtureBindingsToRequest(request: Record<string, unknown>, toolName: string, bindings: FixtureBindingRegistry | undefined, version?: string, entityPaths?: readonly SchemaEntityPath[]): Record<string, unknown>;
+//# sourceMappingURL=fixture-resolution.d.ts.map

package/dist/lib/testing/storyboard/fixture-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-resolution.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/fixture-resolution.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAEpG,OAAO,KAAK,EAEV,kBAAkB,EAElB,yBAAyB,EAEzB,UAAU,EACX,MAAM,SAAS,CAAC;AAqCjB,8DAA8D;AAC9D,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAK3G;AAqFD,8EAA8E;AAC9E,wBAAgB,qCAAqC,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CA6ElF;AAWD,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAmB9G;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,SAAS,GAAG,wBAAwB,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,yBAAyB,EAAE,CAAC;IACxC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,UAAU,GAAG,qBAAqB,EAAE,CAoF3F;AAED,0CAA0C;AAC1C,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAkC;IAC3E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAkC;IAExE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAW1D,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,IAAI;IAY5F,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI7C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUhD,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CA2B1E;AAyCD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,sBAAsB,GAAG,SAAS,EAC5C,OAAO,GAAE,MAAqB,EAC9B,WAAW,CAAC,EAAE,SAAS,gBAAgB,EAAE,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB"}