@endora-commerce/page-builder-core 0.100.0

package/dist/migration/rename-block-names-sql.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The DDL that creates the rewrite function, and the `drop` that retires it.
+ *
+ * `functionName` must be unique per migration: five migrations may share one
+ * pooled session, and a second `create function` over the same name would fail
+ * — so each migration names its own and drops it when it is done.
+ *
+ * The map is embedded as a **`jsonb` object literal** and the lookup is
+ * `map -> (value #>> '{}')`, a single hash probe per node rather than a join.
+ * `coalesce(…, v)` is the one branch `contracts/block-name-migration.md` §3.3
+ * describes: a name the map holds is replaced, anything else is left
+ * byte-identical — an already-namespaced name and an unrecognised one alike,
+ * because the map's domain is bare and its codomain is dotted.
+ */
+export declare function createRenameFunctionSql(functionName: string, renames: Readonly<Record<string, string>>): string;
+/** Retire the function created by {@link createRenameFunctionSql}. */
+export declare function dropRenameFunctionSql(functionName: string): string;
+/**
+ * Apply the function to one column.
+ *
+ * `where "<column>" is not null` and nothing finer: a `jsonb` document with no
+ * node in it is rewritten to a structurally identical document, so the update
+ * is a no-op in content and costs one rewritten row. Trying to narrow it with a
+ * `@>` containment test would need the node's shape, which is the thing the walk
+ * exists to find.
+ */
+export declare function applyRenameFunctionSql(functionName: string, table: string, column: string): string;
+//# sourceMappingURL=rename-block-names-sql.d.ts.map

package/dist/migration/rename-block-names-sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-block-names-sql.d.ts","sourceRoot":"","sources":["../../src/migration/rename-block-names-sql.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACxC,MAAM,CAgCR;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,MAAM,CAKR"}

package/dist/migration/rename-block-names-sql.js

@@ -0,0 +1,117 @@
+// The rename migration's SQL — feature 096, T403.
+//
+// **One generator, five migrations** (`contracts/block-name-migration.md` §3.4).
+// Each of the five table-owning modules writes its own migration over its own
+// columns; what none of them writes is the rewrite itself, because five copies
+// of a recursive `jsonb` walk are five chances to disagree about what a node is.
+//
+// ## The premise, verified before this file was written (T403a)
+//
+// `contracts/block-name-migration.md` §3.4 flagged the shape as unverified:
+// every migration in this tree uses `this.addSql(...)` with literal SQL and
+// **none creates a function**, so there was no precedent for `pg_temp`
+// surviving MikroORM's statement batching. It was probed against real
+// PostgreSQL before anything was built on it, on MikroORM 6.6.13: a
+// `create function pg_temp.…` issued through `addSql` **is** visible to a later
+// `addSql` in the same migration, the recursion works, and a slotted child two
+// levels down is renamed. The fallback — a batched row walk in TypeScript — was
+// therefore not needed and is not carried here.
+//
+// ## Why a function rather than an expression
+//
+// The rewrite is recursive: a Puck tree nests to arbitrary depth and places node
+// arrays under arbitrary prop keys. SQL has no recursive expression, so the
+// choice is a function or a row walk in TypeScript; the function runs inside the
+// migration's own transaction, needs no ORM and uses memory independent of the
+// data size.
+//
+// `pg_temp` and not a schema-qualified permanent function: the object lives for
+// the session and disappears with it, so an upgrade leaves nothing behind for an
+// operator to notice or clean up, and a failed migration's rollback removes it
+// with everything else.
+/**
+ * The DDL that creates the rewrite function, and the `drop` that retires it.
+ *
+ * `functionName` must be unique per migration: five migrations may share one
+ * pooled session, and a second `create function` over the same name would fail
+ * — so each migration names its own and drops it when it is done.
+ *
+ * The map is embedded as a **`jsonb` object literal** and the lookup is
+ * `map -> (value #>> '{}')`, a single hash probe per node rather than a join.
+ * `coalesce(…, v)` is the one branch `contracts/block-name-migration.md` §3.3
+ * describes: a name the map holds is replaced, anything else is left
+ * byte-identical — an already-namespaced name and an unrecognised one alike,
+ * because the map's domain is bare and its codomain is dotted.
+ */
+export function createRenameFunctionSql(functionName, renames) {
+    assertPgTempFunctionName(functionName);
+    const map = JSON.stringify(renames);
+    // Every value in the map is a block name — `^[a-z][a-z0-9_]*\.[A-Z][A-Za-z0-9]*$`
+    // — so it carries no quote, no backslash and no dollar sign, and the literal
+    // below cannot be terminated early. Asserted rather than assumed.
+    assertSqlSafeMap(renames);
+    return `
+    create function pg_temp.${functionName}(doc jsonb) returns jsonb as $fn096$
+      select case jsonb_typeof(doc)
+        when 'object' then (
+          select coalesce(
+            jsonb_object_agg(
+              e.k,
+              case
+                when e.k = 'type' and jsonb_typeof(e.v) = 'string'
+                  then coalesce('${map}'::jsonb -> (e.v #>> '{}'), e.v)
+                else pg_temp.${functionName}(e.v)
+              end
+            ),
+            '{}'::jsonb
+          )
+          from jsonb_each(doc) as e(k, v)
+        )
+        when 'array' then (
+          select coalesce(jsonb_agg(pg_temp.${functionName}(el)), '[]'::jsonb)
+          from jsonb_array_elements(doc) as el
+        )
+        else doc
+      end
+    $fn096$ language sql immutable;
+  `;
+}
+/** Retire the function created by {@link createRenameFunctionSql}. */
+export function dropRenameFunctionSql(functionName) {
+    assertPgTempFunctionName(functionName);
+    return `drop function if exists pg_temp.${functionName}(jsonb);`;
+}
+/**
+ * Apply the function to one column.
+ *
+ * `where "<column>" is not null` and nothing finer: a `jsonb` document with no
+ * node in it is rewritten to a structurally identical document, so the update
+ * is a no-op in content and costs one rewritten row. Trying to narrow it with a
+ * `@>` containment test would need the node's shape, which is the thing the walk
+ * exists to find.
+ */
+export function applyRenameFunctionSql(functionName, table, column) {
+    assertPgTempFunctionName(functionName);
+    assertIdentifier(table);
+    assertIdentifier(column);
+    return `update "${table}" set "${column}" = pg_temp.${functionName}("${column}") where "${column}" is not null;`;
+}
+function assertPgTempFunctionName(name) {
+    if (!/^[a-z][a-z0-9_]*$/.test(name)) {
+        throw new Error(`[page-builder-core] "${name}" is not a usable pg_temp function name.`);
+    }
+}
+function assertIdentifier(name) {
+    if (!/^[a-z][a-z0-9_]*$/.test(name)) {
+        throw new Error(`[page-builder-core] "${name}" is not a usable SQL identifier.`);
+    }
+}
+function assertSqlSafeMap(renames) {
+    for (const [from, to] of Object.entries(renames)) {
+        if (!/^[A-Za-z0-9_.]+$/.test(from) || !/^[A-Za-z0-9_.]+$/.test(to)) {
+            throw new Error(`[page-builder-core] block name "${from}" -> "${to}" carries a character that cannot ` +
+                'be embedded in the rename function literal.');
+        }
+    }
+}
+//# sourceMappingURL=rename-block-names-sql.js.map

package/dist/migration/rename-block-names-sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename-block-names-sql.js","sourceRoot":"","sources":["../../src/migration/rename-block-names-sql.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,iFAAiF;AACjF,8EAA8E;AAC9E,+EAA+E;AAC/E,iFAAiF;AACjF,EAAE;AACF,gEAAgE;AAChE,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,uEAAuE;AACvE,sEAAsE;AACtE,oEAAoE;AACpE,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,gDAAgD;AAChD,EAAE;AACF,8CAA8C;AAC9C,EAAE;AACF,iFAAiF;AACjF,4EAA4E;AAC5E,iFAAiF;AACjF,+EAA+E;AAC/E,aAAa;AACb,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,wBAAwB;AAExB;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CACrC,YAAoB,EACpB,OAAyC;IAEzC,wBAAwB,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,kFAAkF;IAClF,6EAA6E;IAC7E,kEAAkE;IAClE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1B,OAAO;8BACqB,YAAY;;;;;;;;mCAQP,GAAG;+BACP,YAAY;;;;;;;;8CAQG,YAAY;;;;;;GAMvD,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,qBAAqB,CAAC,YAAoB;IACxD,wBAAwB,CAAC,YAAY,CAAC,CAAC;IACvC,OAAO,mCAAmC,YAAY,UAAU,CAAC;AACnE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,YAAoB,EACpB,KAAa,EACb,MAAc;IAEd,wBAAwB,CAAC,YAAY,CAAC,CAAC;IACvC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxB,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,WAAW,KAAK,UAAU,MAAM,eAAe,YAAY,KAAK,MAAM,aAAa,MAAM,gBAAgB,CAAC;AACnH,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAY;IAC5C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,0CAA0C,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,mCAAmC,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAyC;IACjE,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,SAAS,EAAE,oCAAoC;gBACpF,6CAA6C,CAChD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/palette.d.ts

@@ -0,0 +1,47 @@
+import type { Config } from '@measured/puck';
+import type { PageBuilderContext } from './types/responsive.js';
+/** A section as the descriptor serves it — already merged across present modules. */
+export interface ServedPaletteSection {
+    readonly key: string;
+    readonly titleKey: string;
+    readonly contexts: readonly PageBuilderContext[];
+    readonly weight?: number | undefined;
+    readonly visible?: boolean | undefined;
+    /** The module whose declaration won the merge. Derived, never declared. */
+    readonly ownerModule?: string | undefined;
+}
+/** A block as the descriptor serves it — the fields this derivation reads. */
+export interface ServedPaletteBlock {
+    readonly name: string;
+    readonly ownerModule: string;
+    readonly category?: string | undefined;
+    readonly contexts?: readonly PageBuilderContext[] | undefined;
+    readonly weight?: number | undefined;
+}
+export interface BuildPaletteOptions {
+    /**
+     * Resolve a section's title. `titleKey` is **module-relative**, so the caller
+     * supplies the scope binding — `useTranslationContext().t(ownerModule, key)`
+     * in the admin. Returning the key unchanged is a legitimate answer and is what
+     * an unresolved key renders as.
+     */
+    readonly title: (section: ServedPaletteSection) => string;
+    /**
+     * Names the renderer map actually holds. A declared block with no renderer in
+     * this bundle is left out of the palette rather than offered and then
+     * exploding on insert; it still resolves to the missing-component placeholder
+     * when it is already in a document (FR-019).
+     */
+    readonly renderable: ReadonlySet<string>;
+}
+/**
+ * Build the Puck `categories` map for one context.
+ *
+ * Order is a function of the declarations alone — lowest `weight` first with an
+ * absent `weight` sorting after every declared one, ties by key (sections) or by
+ * name (blocks), both ascending — so the palette is stable under a
+ * re-composition or a reordering of `MODULES`, which is D-45 applied to a
+ * discovery surface.
+ */
+export declare function buildPaletteCategories(blocks: readonly ServedPaletteBlock[], sections: readonly ServedPaletteSection[], context: PageBuilderContext, options: BuildPaletteOptions): NonNullable<Config['categories']>;
+//# sourceMappingURL=palette.d.ts.map

package/dist/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../src/palette.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,MAAM,CAAC;IAC1D;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,mBAAmB,GAC3B,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CA6BnC"}

package/dist/palette.js

@@ -0,0 +1,84 @@
+// The derived palette — feature 096, T305/T310.
+//
+// **One layer answers "which sections does the palette for context X have, and
+// what is in them"** (`contracts/block-definition.md` §4.1.1). The three
+// hand-written `categories` maps that answered it before — one in
+// `cms-components`, one in `email-components`, one in `invoices`' Puck config —
+// are gone: a section is now declared by the module whose blocks occupy it, and
+// contributing a block into a section costs no edit to a file the contributor
+// does not own (FR-009). What arrives here is the *served* declarations, merged
+// across the effectively present modules by the registry
+// (`page-builder-registry.ts`), and what leaves is a Puck `categories` map.
+//
+// ## Admission, and why it is applied here and nowhere else
+//
+// `contexts` states what a block is **authored for**; which palette it
+// **appears in** is derived. The one admission the platform grants is
+// `email -> newsletter` — the newsletter palette *is* the e-mail palette, and no
+// block in this repository declares `newsletter`. The relation has one
+// implementation, `contextAdmits`, and this file imports it rather than spelling
+// `contexts.includes(context)`, which is correct for `cms`, `email` and
+// `invoice` and silently empties the fourth.
+//
+// **It applies to sections as well as to blocks, at the same fold.** That is not
+// a symmetry for its own sake: a palette that admits the blocks and not the
+// sections renders 28 entries in Puck's *Other* drawer — not empty, merely
+// unsectioned, which is the state defect D-c exists to close.
+//
+// ## What is derived from the blocks rather than from the declarations
+//
+// A declared section with no visible member in this context is **not rendered**.
+// That is reading 3's kept half (`contracts/block-definition.md` §1.1): the set
+// of sections actually rendered follows the blocks, so a module declaring a
+// section it then contributes nothing to adds no empty drawer.
+import { contextAdmits } from './define-component.js';
+/**
+ * Build the Puck `categories` map for one context.
+ *
+ * Order is a function of the declarations alone — lowest `weight` first with an
+ * absent `weight` sorting after every declared one, ties by key (sections) or by
+ * name (blocks), both ascending — so the palette is stable under a
+ * re-composition or a reordering of `MODULES`, which is D-45 applied to a
+ * discovery surface.
+ */
+export function buildPaletteCategories(blocks, sections, context, options) {
+    const admittedBlocks = blocks
+        .filter((block) => contextAdmits(block.contexts ?? ['cms'], context) && options.renderable.has(block.name))
+        .sort(compareByWeightThen((block) => block.name));
+    const membersByCategory = new Map();
+    for (const block of admittedBlocks) {
+        if (!block.category)
+            continue;
+        const bucket = membersByCategory.get(block.category);
+        if (bucket)
+            bucket.push(block.name);
+        else
+            membersByCategory.set(block.category, [block.name]);
+    }
+    const categories = {};
+    for (const section of [...sections]
+        .filter((section) => contextAdmits(section.contexts, context))
+        .sort(compareByWeightThen((section) => section.key))) {
+        const members = membersByCategory.get(section.key);
+        if (!members || members.length === 0)
+            continue;
+        categories[section.key] = {
+            title: options.title(section),
+            components: members,
+            ...(section.visible !== undefined ? { visible: section.visible } : {}),
+        };
+    }
+    return categories;
+}
+function compareByWeightThen(tiebreak) {
+    return (a, b) => {
+        const aw = a.weight ?? Number.POSITIVE_INFINITY;
+        const bw = b.weight ?? Number.POSITIVE_INFINITY;
+        if (aw !== bw)
+            return aw - bw;
+        const at = tiebreak(a);
+        const bt = tiebreak(b);
+        return at < bt ? -1 : at > bt ? 1 : 0;
+    };
+}
+//# sourceMappingURL=palette.js.map

package/dist/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../src/palette.ts"],"names":[],"mappings":"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"}

package/dist/render/responsive-styles.d.ts

@@ -0,0 +1,19 @@
+import type { CSSProperties } from 'react';
+import { type PageBuilderBreakpoints, type ResponsiveProp, hideOnDataAttrs, type BreakpointTier } from '../types/responsive.js';
+export type ResponsiveVisibility = ResponsiveProp<boolean>;
+export declare const DEFAULT_VISIBILITY: ResponsiveVisibility;
+export declare function resolveVisibility(visibility: ResponsiveVisibility | boolean | undefined, tier: BreakpointTier): boolean;
+export declare function breakpointCssVars(breakpoints?: PageBuilderBreakpoints): CSSProperties;
+export declare const RESPONSIVE_HIDE_ON_CLASS = "cmsc-pb-hide-on";
+export { hideOnDataAttrs };
+export declare function buildResponsiveNumberVars(name: string, value: number | ResponsiveProp<number> | undefined, fallback: number): CSSProperties;
+/** Unitless responsive CSS custom properties (font-weight, line-height multipliers). */
+export declare function buildResponsiveCSSValueVars(name: string, value: number | ResponsiveProp<number> | undefined, fallback: number): CSSProperties;
+export declare function responsiveRowAlignClass(value: ResponsiveProp<string> | string | undefined, fallback: string): string;
+export declare function resolveRowAlignClassForTier(value: ResponsiveProp<string> | string | undefined, tier: BreakpointTier, fallback: string): string;
+export declare function textAlignDataAttrs(value: ResponsiveProp<string> | string | undefined, fallback: string): Record<string, string>;
+export declare function resolveTextAlignForTier(value: ResponsiveProp<string> | string | undefined, tier: BreakpointTier, fallback: string): 'left' | 'center' | 'right';
+export declare function responsiveTextAlignClass(_value: ResponsiveProp<string> | string | undefined, _fallback: string): string;
+export declare function resolveTextAlignClassForTier(value: ResponsiveProp<string> | string | undefined, tier: BreakpointTier, fallback: string): string;
+export declare function resolveResponsiveNumber(value: number | ResponsiveProp<number> | undefined, tier: BreakpointTier, fallback: number): number;
+//# sourceMappingURL=responsive-styles.d.ts.map

package/dist/render/responsive-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive-styles.d.ts","sourceRoot":"","sources":["../../src/render/responsive-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EAGnB,eAAe,EACf,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;AAE3D,eAAO,MAAM,kBAAkB,EAAE,oBAAqC,CAAC;AAEvE,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,oBAAoB,GAAG,OAAO,GAAG,SAAS,EACtD,IAAI,EAAE,cAAc,GACnB,OAAO,CAIT;AAED,wBAAgB,iBAAiB,CAAC,WAAW,GAAE,sBAA4C,GAAG,aAAa,CAK1G;AAED,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,EAClD,QAAQ,EAAE,MAAM,GACf,aAAa,CASf;AAED,wFAAwF;AACxF,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,EAClD,QAAQ,EAAE,MAAM,GACf,aAAa,CASf;AAeD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,EAClD,QAAQ,EAAE,MAAM,GACf,MAAM,CAQR;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,EAClD,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,EAClD,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,EAClD,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,QAAQ,GAAG,OAAO,CAI7B;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,EACnD,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,EAClD,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,EAClD,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER"}

package/dist/render/responsive-styles.js

@@ -0,0 +1,91 @@
+import { DEFAULT_BREAKPOINTS, normalizeResponsive, resolveResponsive, hideOnDataAttrs, } from '../types/responsive.js';
+export const DEFAULT_VISIBILITY = { base: true };
+export function resolveVisibility(visibility, tier) {
+    if (visibility === undefined)
+        return true;
+    if (typeof visibility === 'boolean')
+        return visibility;
+    return resolveResponsive(visibility, tier, true);
+}
+export function breakpointCssVars(breakpoints = DEFAULT_BREAKPOINTS) {
+    return {
+        '--cmsc-bp-tablet': `${breakpoints.tabletMin}px`,
+        '--cmsc-bp-desktop': `${breakpoints.desktopMin}px`,
+    };
+}
+export const RESPONSIVE_HIDE_ON_CLASS = 'cmsc-pb-hide-on';
+export { hideOnDataAttrs };
+export function buildResponsiveNumberVars(name, value, fallback) {
+    const responsive = normalizeResponsive(value, fallback);
+    const tablet = responsive.tablet ?? responsive.base;
+    const desktop = responsive.desktop ?? tablet;
+    return {
+        [`--pb-${name}`]: `${responsive.base}px`,
+        [`--pb-${name}-md`]: `${tablet}px`,
+        [`--pb-${name}-lg`]: `${desktop}px`,
+    };
+}
+/** Unitless responsive CSS custom properties (font-weight, line-height multipliers). */
+export function buildResponsiveCSSValueVars(name, value, fallback) {
+    const responsive = normalizeResponsive(value, fallback);
+    const tablet = responsive.tablet ?? responsive.base;
+    const desktop = responsive.desktop ?? tablet;
+    return {
+        [`--pb-${name}`]: String(responsive.base),
+        [`--pb-${name}-md`]: String(tablet),
+        [`--pb-${name}-lg`]: String(desktop),
+    };
+}
+const ROW_ALIGN_CLASS = {
+    stretch: 'cmsc:items-stretch',
+    start: 'cmsc:items-start',
+    center: 'cmsc:items-center',
+    end: 'cmsc:items-end',
+};
+const TEXT_ALIGN_CLASS = {
+    left: 'cmsc:text-left',
+    center: 'cmsc:text-center',
+    right: 'cmsc:text-right',
+};
+export function responsiveRowAlignClass(value, fallback) {
+    const mobile = resolveResponsive(value, 'mobile', fallback);
+    const tablet = resolveResponsive(value, 'tablet', fallback);
+    const desktop = resolveResponsive(value, 'desktop', fallback);
+    const classes = [ROW_ALIGN_CLASS[mobile] ?? ROW_ALIGN_CLASS.stretch, 'cmsc-pb-row-align'];
+    if (tablet !== mobile)
+        classes.push(`cmsc-pb-row-align-md-${tablet}`);
+    if (desktop !== tablet)
+        classes.push(`cmsc-pb-row-align-lg-${desktop}`);
+    return classes.join(' ');
+}
+export function resolveRowAlignClassForTier(value, tier, fallback) {
+    const resolved = resolveResponsive(value, tier, fallback);
+    return ROW_ALIGN_CLASS[resolved] ?? 'cmsc:items-stretch';
+}
+export function textAlignDataAttrs(value, fallback) {
+    const normalized = normalizeResponsive(value, fallback);
+    const tablet = normalized.tablet ?? normalized.base;
+    const desktop = normalized.desktop ?? normalized.tablet ?? normalized.base;
+    return {
+        'data-align': normalized.base,
+        'data-align-md': tablet,
+        'data-align-lg': desktop,
+    };
+}
+export function resolveTextAlignForTier(value, tier, fallback) {
+    const resolved = resolveResponsive(value, tier, fallback);
+    if (resolved === 'center' || resolved === 'right')
+        return resolved;
+    return 'left';
+}
+export function responsiveTextAlignClass(_value, _fallback) {
+    return 'cmsc-pb-text-align';
+}
+export function resolveTextAlignClassForTier(value, tier, fallback) {
+    const resolved = resolveResponsive(value, tier, fallback);
+    return TEXT_ALIGN_CLASS[resolved] ?? 'cmsc:text-left';
+}
+export function resolveResponsiveNumber(value, tier, fallback) {
+    return resolveResponsive(value, tier, fallback);
+}
+//# sourceMappingURL=responsive-styles.js.map

package/dist/render/responsive-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsive-styles.js","sourceRoot":"","sources":["../../src/render/responsive-styles.ts"],"names":[],"mappings":"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"}

package/dist/types/background.d.ts

@@ -0,0 +1,26 @@
+export type BackgroundKind = 'none' | 'solid' | 'gradient' | 'image' | 'video';
+export type MediaSourceKind = 'url' | 'library';
+export interface BackgroundValue {
+    kind: BackgroundKind;
+    color?: string;
+    gradientFrom?: string;
+    gradientTo?: string;
+    gradientAngle?: number;
+    imageSource?: MediaSourceKind;
+    imageUrl?: string;
+    imageAssetId?: string;
+    videoSource?: MediaSourceKind;
+    videoUrl?: string;
+    videoAssetId?: string;
+}
+export type BackgroundProp = string | BackgroundValue | undefined;
+/** Rebases host-relative media URLs onto the API origin (never the page origin). */
+export declare function absolutizeBackgroundMediaUrl(url: string, mediaBaseUrl?: string): string;
+export declare function normalizeBackground(value: BackgroundProp): BackgroundValue;
+export declare function backgroundToStyle(value: BackgroundProp, assets?: Record<string, {
+    url: string;
+}>, mediaBaseUrl?: string): {
+    style: Record<string, string>;
+    videoUrl?: string;
+};
+//# sourceMappingURL=background.d.ts.map

package/dist/types/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/types/background.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAC/E,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;AAElE,oFAAoF;AACpF,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAU1E;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAM,EAC5C,YAAY,CAAC,EAAE,MAAM,GACpB;IACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAuDA"}

package/dist/types/background.js

@@ -0,0 +1,76 @@
+/** Rebases host-relative media URLs onto the API origin (never the page origin). */
+export function absolutizeBackgroundMediaUrl(url, mediaBaseUrl) {
+    if (!url)
+        return '';
+    if (/^(https?:|data:|blob:)/i.test(url))
+        return url;
+    if (!url.startsWith('/'))
+        return url;
+    const base = mediaBaseUrl?.replace(/\/+$/, '');
+    return base ? `${base}${url}` : url;
+}
+export function normalizeBackground(value) {
+    if (value === undefined || value === null || value === '') {
+        return { kind: 'none' };
+    }
+    if (typeof value === 'string') {
+        if (value === 'transparent')
+            return { kind: 'none' };
+        return { kind: 'solid', color: value };
+    }
+    if (!value.kind)
+        return { kind: 'none' };
+    return value;
+}
+export function backgroundToStyle(value, assets = {}, mediaBaseUrl) {
+    const bg = normalizeBackground(value);
+    if (bg.kind === 'none')
+        return { style: {} };
+    if (bg.kind === 'solid') {
+        const color = bg.color && bg.color !== 'transparent' ? bg.color : undefined;
+        return color ? { style: { backgroundColor: color } } : { style: {} };
+    }
+    if (bg.kind === 'gradient') {
+        const from = bg.gradientFrom ?? '#ffffff';
+        const to = bg.gradientTo ?? '#000000';
+        const angle = bg.gradientAngle ?? 135;
+        return {
+            style: {
+                background: `linear-gradient(${angle}deg, ${from}, ${to})`,
+            },
+        };
+    }
+    if (bg.kind === 'image') {
+        const raw = bg.imageSource === 'library' && bg.imageAssetId
+            ? assets[bg.imageAssetId]?.url ||
+                (bg.imageAssetId ? `/assets/file/${bg.imageAssetId}` : '')
+            : bg.imageUrl ?? '';
+        const url = absolutizeBackgroundMediaUrl(raw, mediaBaseUrl);
+        if (!url)
+            return { style: {} };
+        return {
+            style: {
+                backgroundImage: `url("${url.replace(/"/g, '\\"')}")`,
+                backgroundSize: 'cover',
+                backgroundPosition: 'center',
+                backgroundRepeat: 'no-repeat',
+            },
+        };
+    }
+    if (bg.kind === 'video') {
+        const raw = bg.videoSource === 'library' && bg.videoAssetId
+            ? assets[bg.videoAssetId]?.url ||
+                (bg.videoAssetId ? `/assets/file/${bg.videoAssetId}` : '')
+            : bg.videoUrl ?? '';
+        const url = absolutizeBackgroundMediaUrl(raw, mediaBaseUrl);
+        return {
+            style: {
+                position: 'relative',
+                overflow: 'hidden',
+            },
+            ...(url ? { videoUrl: url } : {}),
+        };
+    }
+    return { style: {} };
+}
+//# sourceMappingURL=background.js.map

package/dist/types/background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.js","sourceRoot":"","sources":["../../src/types/background.ts"],"names":[],"mappings":"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"}

package/dist/types/box-styles.d.ts

@@ -0,0 +1,67 @@
+import type { CSSProperties } from 'react';
+import { type BreakpointTier, type ResponsiveProp } from './responsive.js';
+export type SpacingValue = {
+    mode: 'uniform';
+    value: number;
+} | {
+    mode: 'sides';
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+export type BorderStyle = 'none' | 'solid' | 'dashed' | 'dotted';
+export type BorderSide = {
+    width: number;
+    style: BorderStyle;
+    color: string;
+};
+export type BorderValue = {
+    mode: 'none';
+} | {
+    mode: 'uniform';
+    width: number;
+    style: BorderStyle;
+    color: string;
+} | {
+    mode: 'sides';
+    top: BorderSide;
+    right: BorderSide;
+    bottom: BorderSide;
+    left: BorderSide;
+};
+export declare const DEFAULT_SPACING: SpacingValue;
+export declare const DEFAULT_BORDER: BorderValue;
+export declare function normalizeSpacing(value: SpacingValue | undefined): SpacingValue;
+export declare function normalizeBorder(value: BorderValue | undefined): BorderValue;
+export declare function spacingToCss(value: SpacingValue | undefined): string;
+export declare function borderToCss(value: BorderValue | undefined): string | undefined;
+export declare function borderSidesToCss(value: BorderValue | undefined): CSSProperties;
+export declare function buildResponsiveSpacingVars(name: string, value: SpacingValue | ResponsiveProp<SpacingValue> | undefined, fallback?: SpacingValue): CSSProperties;
+export declare function buildResponsiveBorderVars(value: BorderValue | ResponsiveProp<BorderValue> | undefined, fallback?: BorderValue): CSSProperties;
+export declare function resolveSpacing(value: SpacingValue | ResponsiveProp<SpacingValue> | undefined, tier: BreakpointTier, fallback?: SpacingValue): SpacingValue;
+export declare function resolveBorder(value: BorderValue | ResponsiveProp<BorderValue> | undefined, tier: BreakpointTier, fallback?: BorderValue): BorderValue;
+export declare function spacingStyleForTier(value: SpacingValue | ResponsiveProp<SpacingValue> | undefined, tier: BreakpointTier, property: 'margin' | 'padding', fallback?: SpacingValue): CSSProperties;
+export declare function borderStyleForTier(value: BorderValue | ResponsiveProp<BorderValue> | undefined, tier: BreakpointTier, fallback?: BorderValue): CSSProperties;
+export declare function gridTemplateColumnsFromCount(count: number): string;
+export declare function buildResponsiveColumnCountVars(value: number | ResponsiveProp<number> | undefined, fallback?: number): CSSProperties;
+export declare function resolveColumnCount(value: number | ResponsiveProp<number> | undefined, tier: BreakpointTier, fallback?: number): number;
+export type ContentWidth = 'full' | 'narrow' | 'wide';
+export type RowContentMaxWidth = 'none' | 'narrow' | 'wide' | 'custom';
+export type RowSectionLayout = 'in_flow' | 'full_width' | 'full_bleed';
+export type ContentPosition = 'top' | 'middle' | 'bottom';
+export type CornerRadius = 'none' | 'small' | 'medium' | 'large';
+export type Shadow = 'none' | 'soft' | 'medium';
+export type VerticalAlign = 'top' | 'middle' | 'bottom' | 'stretch';
+export declare const CONTENT_WIDTH_MAX: Record<ContentWidth, string | undefined>;
+export declare const ROW_CONTENT_MAX_WIDTH: Record<'narrow' | 'wide', string>;
+export declare function clampColumnSpan(value: number): number;
+export declare function resolveColumnSpan(value: number | ResponsiveProp<number> | undefined, tier: BreakpointTier, fallback?: number): number;
+export declare function buildResponsiveSpanVars(value: number | ResponsiveProp<number> | undefined, fallback?: number): CSSProperties;
+export declare const CORNER_RADIUS_PX: Record<CornerRadius, number>;
+export declare const SHADOW_CSS: Record<Shadow, string>;
+export declare function resolveContentPosition(position: ContentPosition | ResponsiveProp<ContentPosition> | undefined, tier: BreakpointTier): ContentPosition;
+export declare function contentPositionToJustify(position: ContentPosition): string;
+export declare function resolveVerticalAlign(value: VerticalAlign | ResponsiveProp<VerticalAlign> | undefined, tier: BreakpointTier): VerticalAlign;
+export declare function verticalAlignToCss(value: VerticalAlign): string;
+//# sourceMappingURL=box-styles.d.ts.map

package/dist/types/box-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"box-styles.d.ts","sourceRoot":"","sources":["../../src/types/box-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjE,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrE;IACE,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEN,eAAO,MAAM,eAAe,EAAE,YAA4C,CAAC;AAC3E,eAAO,MAAM,cAAc,EAAE,WAA8B,CAAC;AAE5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,CAa9E;AAWD,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,WAAW,CAkB3E;AAOD,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAIpE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAO9E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,CAa9E;AAcD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,GAAG,cAAc,CAAC,YAAY,CAAC,GAAG,SAAS,EAC9D,QAAQ,GAAE,YAA8B,GACvC,aAAa,CAUf;AAWD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG,SAAS,EAC5D,QAAQ,GAAE,WAA4B,GACrC,aAAa,CAUf;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,GAAG,cAAc,CAAC,YAAY,CAAC,GAAG,SAAS,EAC9D,IAAI,EAAE,cAAc,EACpB,QAAQ,GAAE,YAA8B,GACvC,YAAY,CAEd;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG,SAAS,EAC5D,IAAI,EAAE,cAAc,EACpB,QAAQ,GAAE,WAA4B,GACrC,WAAW,CAEb;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,GAAG,cAAc,CAAC,YAAY,CAAC,GAAG,SAAS,EAC9D,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,QAAQ,GAAE,YAA8B,GACvC,aAAa,CAEf;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG,SAAS,EAC5D,IAAI,EAAE,cAAc,EACpB,QAAQ,GAAE,WAA4B,GACrC,aAAa,CAEf;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,EAClD,QAAQ,SAAI,GACX,aAAa,CAUf;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,EAClD,IAAI,EAAE,cAAc,EACpB,QAAQ,SAAI,GACX,MAAM,CAGR;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AACtD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AACvE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,CAAC;AACvE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AACjE,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAItE,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,EAAE,MAAM,CAGnE,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,EAClD,IAAI,EAAE,cAAc,EACpB,QAAQ,SAAK,GACZ,MAAM,CAER;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,SAAS,EAClD,QAAQ,SAAK,GACZ,aAAa,CAUf;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKzD,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI7C,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc,CAAC,eAAe,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,cAAc,GAAG,eAAe,CAErJ;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAI1E;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,GAAG,cAAc,CAAC,aAAa,CAAC,GAAG,SAAS,EAChE,IAAI,EAAE,cAAc,GACnB,aAAa,CAEf;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAK/D"}