@actuate-media/cms-core 0.26.0 → 0.27.0

package/dist/sections/index.js

@@ -0,0 +1,12 @@
+/**
+ * Flat, section-based Page Editor model — shared across the admin editor,
+ * the REST API, and the MCP server.
+ *
+ * Exposed as the `@actuate-media/cms-core/page-sections` subpath (NOT the
+ * package root) to avoid colliding with the page-builder *tree* model,
+ * which already exports `SectionSettings` / `createSection` from the root.
+ */
+export { SECTION_TYPES, SECTION_TYPE_LIST, getSectionType, getSectionTypesForScope, sectionTypeLabel, isKnownSectionType, } from './registry.js';
+export { generateSectionId, createSection, buildSection, addSection, removeSection, duplicateSection, toggleSectionVisibility, setSectionVisibility, moveSection, reorderSections, updateSectionContent, updateSectionSettings, updateSectionMeta, coerceSections, defaultPostHeader, coercePostHeader, createPostTemplate, coercePostTemplate, } from './helpers.js';
+export { validateSectionContent } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/sections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA"}

package/dist/sections/registry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Section-type registry — the single source of truth for the flat Page
+ * Editor model. The admin editor re-exports this; the REST API and MCP
+ * server read it for discovery + validation.
+ *
+ * Only types listed here can be added/created, so neither the Add Section
+ * gallery nor an AI agent can produce a section without a working renderer
+ * + inspector + schema ("no dead sections").
+ */
+import type { SectionScope, SectionTypeDef, SectionTypeId } from './types.js';
+export declare const SECTION_TYPES: Record<SectionTypeId, SectionTypeDef>;
+/** Ordered list for the Add Section gallery + discovery endpoints. */
+export declare const SECTION_TYPE_LIST: SectionTypeDef[];
+export declare function getSectionType(id: string): SectionTypeDef | undefined;
+/**
+ * Section types available in a given editor context, in registry order.
+ *
+ * The Page editor passes `'page'`, the Post editor + Post Template editor
+ * pass `'post'`, so each Add Section gallery shows only the types that make
+ * sense (and have a working renderer) for that surface.
+ */
+export declare function getSectionTypesForScope(scope: SectionScope): SectionTypeDef[];
+/** Human label for a section type id, with a graceful fallback. */
+export declare function sectionTypeLabel(id: string): string;
+/** True when `id` is a registered, renderable section type. */
+export declare function isKnownSectionType(id: string): id is SectionTypeId;
+//# sourceMappingURL=registry.d.ts.map

package/dist/sections/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/sections/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAmB,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI9F,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,cAAc,CA0T/D,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAW7C,CAAA;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,EAAE,CAE7E;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,aAAa,CAElE"}

package/dist/sections/registry.js

@@ -0,0 +1,349 @@
+const BASE_SETTINGS = { backgroundType: 'none', paddingY: 'lg' };
+export const SECTION_TYPES = {
+    hero: {
+        id: 'hero',
+        name: 'Hero Banner',
+        icon: 'layout-template',
+        description: 'Full-width banner with headline, body, and a primary call to action.',
+        category: 'layout',
+        accent: 'purple',
+        scope: ['page', 'post'],
+        defaultContent: {
+            eyebrow: '',
+            heading: 'Your headline goes here',
+            body: 'A short supporting sentence that sets up the value of the page.',
+            primaryButtonLabel: 'Get Started',
+            primaryButtonUrl: '/contact',
+            secondaryButtonLabel: '',
+            secondaryButtonUrl: '',
+        },
+        defaultSettings: { backgroundType: 'solid', backgroundColor: 'purple', paddingY: 'xl' },
+        fields: [
+            { key: 'eyebrow', label: 'Eyebrow', type: 'text', placeholder: 'Optional small label' },
+            { key: 'heading', label: 'Heading', type: 'textarea', required: true },
+            { key: 'body', label: 'Body', type: 'textarea' },
+            { key: 'primaryButtonLabel', label: 'Primary button', type: 'text' },
+            { key: 'primaryButtonUrl', label: 'Primary button URL', type: 'url' },
+            { key: 'secondaryButtonLabel', label: 'Secondary button', type: 'text' },
+            { key: 'secondaryButtonUrl', label: 'Secondary button URL', type: 'url' },
+        ],
+    },
+    text: {
+        id: 'text',
+        name: 'Text Block',
+        icon: 'align-left',
+        description: 'A heading and paragraph, useful for mission statements and prose.',
+        category: 'content',
+        accent: 'blue',
+        scope: ['page', 'post'],
+        defaultContent: {
+            heading: 'A short, clear heading',
+            body: 'Write the supporting copy for this section here.',
+            alignment: 'center',
+        },
+        defaultSettings: { ...BASE_SETTINGS, paddingY: 'xl' },
+        fields: [
+            { key: 'heading', label: 'Heading', type: 'textarea', required: true },
+            { key: 'body', label: 'Body', type: 'textarea' },
+            {
+                key: 'alignment',
+                label: 'Alignment',
+                type: 'select',
+                options: [
+                    { label: 'Left', value: 'left' },
+                    { label: 'Center', value: 'center' },
+                ],
+            },
+        ],
+    },
+    feature: {
+        id: 'feature',
+        name: 'Image + Text',
+        icon: 'panels-top-left',
+        description: 'Two-column feature highlight with copy on one side and media on the other.',
+        category: 'media',
+        accent: 'green',
+        scope: ['page', 'post'],
+        defaultContent: {
+            label: 'Feature Highlight',
+            heading: 'A standout capability',
+            body: 'Describe the feature and why it matters to your audience.',
+            imageUrl: '',
+            imageAlt: '',
+            imagePosition: 'right',
+            buttonLabel: '',
+            buttonUrl: '',
+        },
+        defaultSettings: { ...BASE_SETTINGS },
+        fields: [
+            {
+                key: 'label',
+                label: 'Section label',
+                type: 'text',
+                help: 'Small eyebrow above the heading',
+            },
+            { key: 'heading', label: 'Heading', type: 'textarea', required: true },
+            { key: 'body', label: 'Body', type: 'textarea' },
+            { key: 'imageUrl', label: 'Image', type: 'media' },
+            {
+                key: 'imageAlt',
+                label: 'Image alt text',
+                type: 'text',
+                help: 'Required when an image is set',
+            },
+            {
+                key: 'imagePosition',
+                label: 'Image position',
+                type: 'select',
+                options: [
+                    { label: 'Right', value: 'right' },
+                    { label: 'Left', value: 'left' },
+                ],
+            },
+            { key: 'buttonLabel', label: 'Button', type: 'text' },
+            { key: 'buttonUrl', label: 'Button URL', type: 'url' },
+        ],
+    },
+    stats: {
+        id: 'stats',
+        name: 'By the Numbers',
+        icon: 'bar-chart-3',
+        description: 'A row of key metrics with values and labels.',
+        category: 'content',
+        accent: 'orange',
+        scope: ['page', 'post'],
+        defaultContent: {
+            heading: 'By the numbers',
+            body: '',
+            stats: [
+                { value: '99.99%', label: 'Uptime', description: '' },
+                { value: '124ms', label: 'Avg response time', description: '' },
+                { value: '3M+', label: 'API requests served', description: '' },
+            ],
+        },
+        defaultSettings: { ...BASE_SETTINGS },
+        fields: [
+            { key: 'heading', label: 'Heading', type: 'textarea' },
+            { key: 'body', label: 'Body', type: 'textarea' },
+            { key: 'stats', label: 'Stats', type: 'stats' },
+        ],
+    },
+    cta: {
+        id: 'cta',
+        name: 'CTA Banner',
+        icon: 'megaphone',
+        description: 'A focused call-to-action band with heading, body, and a button.',
+        category: 'conversion',
+        accent: 'pink',
+        scope: ['page', 'post'],
+        defaultContent: {
+            heading: 'Ready to get started?',
+            body: 'A short nudge that motivates the next step.',
+            buttonLabel: 'Start Building',
+            buttonUrl: '/contact',
+        },
+        defaultSettings: { backgroundType: 'solid', backgroundColor: 'purple', paddingY: 'xl' },
+        fields: [
+            { key: 'heading', label: 'Heading', type: 'textarea', required: true },
+            { key: 'body', label: 'Body', type: 'textarea' },
+            { key: 'buttonLabel', label: 'Button', type: 'text' },
+            { key: 'buttonUrl', label: 'Button URL', type: 'url' },
+        ],
+    },
+    // ─── Post-oriented section types (scope: post) ─────────────────────
+    'article-body': {
+        id: 'article-body',
+        name: 'Article Body',
+        icon: 'text',
+        description: "Renders the post's main body content with optional reading aids.",
+        category: 'content',
+        accent: 'blue',
+        scope: ['post'],
+        defaultContent: {
+            // `source: 'field'` binds the rendered body to the post's own `body`
+            // field (single source of truth). `override` lets the author type
+            // body copy directly into the section instead.
+            source: 'field',
+            body: '',
+            width: 'normal',
+            showToc: false,
+        },
+        defaultSettings: { ...BASE_SETTINGS, paddingY: 'lg' },
+        fields: [
+            {
+                key: 'source',
+                label: 'Body source',
+                type: 'select',
+                help: "Use the post's Body field, or write copy here in this section.",
+                options: [
+                    { label: "Post's Body field", value: 'field' },
+                    { label: 'Custom copy', value: 'override' },
+                ],
+            },
+            {
+                key: 'body',
+                label: 'Custom body',
+                type: 'richText',
+                help: 'Used only when Body source is "Custom copy".',
+            },
+            {
+                key: 'width',
+                label: 'Content width',
+                type: 'select',
+                options: [
+                    { label: 'Normal', value: 'normal' },
+                    { label: 'Wide', value: 'wide' },
+                ],
+            },
+            { key: 'showToc', label: 'Show table of contents', type: 'boolean' },
+        ],
+    },
+    quote: {
+        id: 'quote',
+        name: 'Pull Quote',
+        icon: 'quote',
+        description: 'A highlighted quotation with optional attribution.',
+        category: 'content',
+        accent: 'purple',
+        scope: ['post'],
+        defaultContent: {
+            quote: 'A memorable line worth pulling out of the body copy.',
+            attribution: '',
+            role: '',
+        },
+        defaultSettings: { ...BASE_SETTINGS, paddingY: 'lg' },
+        fields: [
+            { key: 'quote', label: 'Quote', type: 'textarea', required: true },
+            { key: 'attribution', label: 'Attribution', type: 'text', placeholder: 'Jane Doe' },
+            { key: 'role', label: 'Role / source', type: 'text', placeholder: 'CEO, Acme' },
+        ],
+    },
+    'author-bio': {
+        id: 'author-bio',
+        name: 'Author Bio',
+        icon: 'user',
+        description: "A short biography block for the post's author.",
+        category: 'content',
+        accent: 'green',
+        scope: ['post'],
+        defaultContent: {
+            heading: 'About the author',
+            showAvatar: true,
+            showSocial: true,
+        },
+        defaultSettings: { ...BASE_SETTINGS },
+        fields: [
+            { key: 'heading', label: 'Heading', type: 'text' },
+            { key: 'showAvatar', label: 'Show avatar', type: 'boolean' },
+            { key: 'showSocial', label: 'Show social links', type: 'boolean' },
+        ],
+    },
+    'related-posts': {
+        id: 'related-posts',
+        name: 'Related Posts',
+        icon: 'layout-grid',
+        description: 'A grid of related posts, chosen automatically or hand-picked.',
+        category: 'content',
+        accent: 'orange',
+        scope: ['post'],
+        defaultContent: {
+            heading: 'Related posts',
+            mode: 'auto',
+            count: '3',
+            postSlugs: [],
+        },
+        defaultSettings: { ...BASE_SETTINGS },
+        fields: [
+            { key: 'heading', label: 'Heading', type: 'text' },
+            {
+                key: 'mode',
+                label: 'Selection',
+                type: 'select',
+                options: [
+                    { label: 'Automatic (newest in this type)', value: 'auto' },
+                    { label: 'Hand-picked', value: 'manual' },
+                ],
+            },
+            {
+                key: 'count',
+                label: 'How many',
+                type: 'select',
+                options: [
+                    { label: '3', value: '3' },
+                    { label: '4', value: '4' },
+                    { label: '6', value: '6' },
+                ],
+            },
+            {
+                key: 'postSlugs',
+                label: 'Posts',
+                type: 'relationship',
+                help: 'Used only when Selection is "Hand-picked".',
+            },
+        ],
+    },
+    gallery: {
+        id: 'gallery',
+        name: 'Image Gallery',
+        icon: 'images',
+        description: 'A grid of images with captions.',
+        category: 'media',
+        accent: 'pink',
+        scope: ['post'],
+        defaultContent: {
+            heading: '',
+            columns: '3',
+            images: [],
+        },
+        defaultSettings: { ...BASE_SETTINGS },
+        fields: [
+            { key: 'heading', label: 'Heading', type: 'text' },
+            {
+                key: 'columns',
+                label: 'Columns',
+                type: 'select',
+                options: [
+                    { label: '2', value: '2' },
+                    { label: '3', value: '3' },
+                    { label: '4', value: '4' },
+                ],
+            },
+            { key: 'images', label: 'Images', type: 'gallery' },
+        ],
+    },
+};
+/** Ordered list for the Add Section gallery + discovery endpoints. */
+export const SECTION_TYPE_LIST = [
+    SECTION_TYPES.hero,
+    SECTION_TYPES.text,
+    SECTION_TYPES.feature,
+    SECTION_TYPES.stats,
+    SECTION_TYPES.cta,
+    SECTION_TYPES['article-body'],
+    SECTION_TYPES.quote,
+    SECTION_TYPES['author-bio'],
+    SECTION_TYPES['related-posts'],
+    SECTION_TYPES.gallery,
+];
+export function getSectionType(id) {
+    return SECTION_TYPES[id];
+}
+/**
+ * Section types available in a given editor context, in registry order.
+ *
+ * The Page editor passes `'page'`, the Post editor + Post Template editor
+ * pass `'post'`, so each Add Section gallery shows only the types that make
+ * sense (and have a working renderer) for that surface.
+ */
+export function getSectionTypesForScope(scope) {
+    return SECTION_TYPE_LIST.filter((def) => def.scope.includes(scope));
+}
+/** Human label for a section type id, with a graceful fallback. */
+export function sectionTypeLabel(id) {
+    return getSectionType(id)?.name ?? 'Section';
+}
+/** True when `id` is a registered, renderable section type. */
+export function isKnownSectionType(id) {
+    return getSectionType(id) !== undefined;
+}
+//# sourceMappingURL=registry.js.map

package/dist/sections/registry.js.map

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

package/dist/sections/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Shared types for the flat, section-based Page Editor model.
+ *
+ * A page is an ordered list of `PageSection`s stored in a page document's
+ * `data.sections` JSON field. A section's `sectionType` keys into the
+ * {@link SECTION_TYPES} registry, which is the single source of truth for:
+ *   - the Add Section gallery (label / icon / description / category)
+ *   - default content + settings when a section is created
+ *   - the inspector field schema (which content controls to render)
+ *   - the renderer component (dispatches on the same `sectionType` key)
+ *   - server + MCP validation of AI-authored section content
+ *
+ * This module lives in `cms-core` (not `cms-admin`) so the admin editor,
+ * the REST API, and the MCP server all validate against ONE definition.
+ *
+ * NOTE: this is deliberately distinct from the page-builder *tree* model
+ * (`SectionNode` etc. in `../page-builder`). That model is a recursive
+ * node tree; this one is a flat list of named, schema-driven sections.
+ */
+/**
+ * Stable ids for the built-in section types.
+ *
+ * The first group is shared (usable on both pages and posts); the second
+ * group is post-oriented (article body, pull quote, author bio, related
+ * posts, image gallery). Which types appear in a given editor is governed
+ * by {@link SectionTypeDef.scope}.
+ */
+export type SectionTypeId = 'hero' | 'text' | 'feature' | 'stats' | 'cta' | 'article-body' | 'quote' | 'author-bio' | 'related-posts' | 'gallery';
+/** Where a section type may be used. Drives the Add Section gallery filter. */
+export type SectionScope = 'page' | 'post';
+/** Field kinds the inspector + validator understand. */
+export type SectionFieldType = 'text' | 'textarea' | 'richText' | 'url' | 'media' | 'select' | 'boolean' | 'color' | 'relationship' | 'stats' | 'gallery';
+export interface SectionFieldDef {
+    /** key into `PageSection.content` */
+    key: string;
+    label: string;
+    type: SectionFieldType;
+    placeholder?: string;
+    /** options for `type: 'select'` */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** collection slug a `relationship` field points at (defaults to the host post type) */
+    relationTo?: string;
+    /** marks the field required for publish-time validation */
+    required?: boolean;
+    help?: string;
+}
+export interface SectionSettings {
+    backgroundType?: 'none' | 'solid' | 'gradient';
+    backgroundColor?: string;
+    paddingY?: 'sm' | 'md' | 'lg' | 'xl';
+    anchorId?: string;
+    cssClass?: string;
+}
+export interface SectionTypeDef {
+    id: SectionTypeId;
+    /** Display name used in the Sections panel + Add gallery */
+    name: string;
+    /** lucide-react icon name (resolved by the admin panel/gallery) */
+    icon: string;
+    description: string;
+    category: 'layout' | 'content' | 'media' | 'conversion';
+    /** accent color key (maps to the shared badge palette) */
+    accent: 'purple' | 'green' | 'orange' | 'blue' | 'pink';
+    /** which editors expose this type. Defaults (when omitted) to page-only. */
+    scope: SectionScope[];
+    defaultContent: Record<string, unknown>;
+    defaultSettings: SectionSettings;
+    /** content fields shown in the inspector, in order */
+    fields: SectionFieldDef[];
+}
+/** A single section on a page. Persisted in `data.sections[]`. */
+export interface PageSection {
+    id: string;
+    sectionType: SectionTypeId;
+    /** Editor-facing display name (defaults to the type name). */
+    name: string;
+    /** Optional internal-only label for the team. */
+    internalLabel?: string;
+    visible: boolean;
+    content: Record<string, unknown>;
+    settings: SectionSettings;
+}
+/** A structured validation finding for a single section. */
+export interface SectionValidationIssue {
+    /** the section type the issue belongs to */
+    sectionType: string;
+    /** content field key when the issue is field-scoped */
+    field?: string;
+    message: string;
+}
+export interface SectionValidationResult {
+    valid: boolean;
+    errors: SectionValidationIssue[];
+    warnings: SectionValidationIssue[];
+}
+/**
+ * Design-driven header layout for a post type. These are presentation
+ * toggles only — the actual values (title, image, author, date) come from
+ * each post document's own fields, never from the template.
+ */
+export interface PostHeaderConfig {
+    /** Overall header composition. */
+    layout: 'centered' | 'left' | 'overlay';
+    showFeaturedImage: boolean;
+    showExcerpt: boolean;
+    showAuthor: boolean;
+    showDate: boolean;
+    showCategory: boolean;
+    showReadingTime: boolean;
+}
+/**
+ * A post type's editable template: the header layout plus the ordered list
+ * of sections new posts of that type inherit. Stored as a single document
+ * per post type in the hidden `post-templates` collection
+ * (`data: { postType, header, sections }`).
+ */
+export interface PostTemplate {
+    /** slug of the post-type collection this template belongs to */
+    postType: string;
+    header: PostHeaderConfig;
+    /** default body/trailing sections new posts inherit */
+    sections: PageSection[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/sections/types.js

@@ -0,0 +1,21 @@
+/**
+ * Shared types for the flat, section-based Page Editor model.
+ *
+ * A page is an ordered list of `PageSection`s stored in a page document's
+ * `data.sections` JSON field. A section's `sectionType` keys into the
+ * {@link SECTION_TYPES} registry, which is the single source of truth for:
+ *   - the Add Section gallery (label / icon / description / category)
+ *   - default content + settings when a section is created
+ *   - the inspector field schema (which content controls to render)
+ *   - the renderer component (dispatches on the same `sectionType` key)
+ *   - server + MCP validation of AI-authored section content
+ *
+ * This module lives in `cms-core` (not `cms-admin`) so the admin editor,
+ * the REST API, and the MCP server all validate against ONE definition.
+ *
+ * NOTE: this is deliberately distinct from the page-builder *tree* model
+ * (`SectionNode` etc. in `../page-builder`). That model is a recursive
+ * node tree; this one is a flat list of named, schema-driven sections.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sections/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sections/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/sections/validate.d.ts

@@ -0,0 +1,10 @@
+import type { SectionSettings, SectionValidationResult } from './types.js';
+/**
+ * Validate one section's content + settings against its type schema.
+ *
+ * An unknown `sectionType` is a hard error (the agent asked for a type with
+ * no renderer). Required fields, button URL validity, and image alt text
+ * are enforced; everything else is advisory.
+ */
+export declare function validateSectionContent(sectionType: string, content: Record<string, unknown>, _settings?: SectionSettings): SectionValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/sections/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/sections/validate.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAe1E;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,eAAe,GAC1B,uBAAuB,CAgEzB"}