@parhelia/core 0.4.12818 → 0.4.12871

package/dist/tour/sandbox-tour.js

@@ -5,11 +5,14 @@ import { SANDBOX_TOUR_COPY } from "./sandbox-tour-copy";
 export { SANDBOX_TOUR_COPY } from "./sandbox-tour-copy";
 const SELECTORS = {
     "start-tour": '[data-testid="pageEditoriframe"]',
+    "context-menu": '[data-testid="context-menu-content"]',
+    "frame-menu": '[data-testid="frame-menu"]',
     "insert-component": '[data-testid="insert-component-button"]',
     "undo-redo": 'div:has(> [data-testid="toolbar-undo-button"])',
     "content-tree": '[data-testid="content-tree-toggle-button"]',
     "preview-mode": '[data-testid="preview-mode-button"]',
     "device-switcher": '[data-testid="viewport-mode-switcher-button"]',
+    feedback: '[data-testid="toggle-comments-button"]',
     "agent-prompt": "[data-agent-terminal-root]",
     "agents-button": '[data-testid="agents-panel-button"]',
     help: '[data-testid="help-button"]',
@@ -27,15 +30,94 @@ const REQUIRED_CHROME_SELECTORS = [
     '[data-testid="genericToolbar"]',
 ];
 const SETTLE_TIMEOUT_MS = 3000;
+const CONTEXT_MENU_ANCHOR_TIMEOUT_MS = 2000;
+/** The menu renders transparent until it has measured its final position. */
+const CONTEXT_MENU_PAINT_POLLS = 30;
+function getPage(editContext) {
+    return (editContext.getActiveSlotContext?.()?.primaryPageViewContext?.getState()
+        .page ?? editContext.page);
+}
+/** The first component on the page (skipping empty placeholders), which the tour right-clicks. */
+export function findFirstComponent(placeholders) {
+    for (const placeholder of placeholders ?? []) {
+        const [first] = placeholder.components ?? [];
+        if (first)
+            return first;
+    }
+    return undefined;
+}
+function getContextMenuComponent(editContext) {
+    if (typeof editContext.showContextMenu !== "function")
+        return undefined;
+    return findFirstComponent(getPage(editContext)?.rootComponent?.placeholders);
+}
 export function createSandboxTour() {
     let settled = false;
     let settlePromise;
     let settleGeneration = 0;
+    let contextMenuRun;
     const resetSettleState = () => {
         settled = false;
         settlePromise = undefined;
         settleGeneration += 1;
     };
+    const closeContextMenu = () => {
+        const run = contextMenuRun;
+        if (!run)
+            return;
+        contextMenuRun = undefined;
+        run.cancelled = true;
+        // The shell closes the menu as soon as it no longer owns the overlay slot.
+        // Other owners are left alone: the menu is already gone in that case.
+        run.editContext.setCurrentOverlay?.((overlay) => overlay === "context-menu" ? undefined : overlay);
+        run.editContext.select(run.previousSelection);
+    };
+    // Mirrors a user selecting the first component and right-clicking its
+    // frame: the same menu items, opened at the same spot.
+    const openContextMenu = async (params) => {
+        closeContextMenu();
+        const { editContext } = params;
+        const component = getContextMenuComponent(editContext);
+        if (!component)
+            return;
+        const run = {
+            editContext,
+            previousSelection: editContext.getSelection?.() ?? [],
+            cancelled: false,
+        };
+        contextMenuRun = run;
+        editContext.select([component.id]);
+        const anchor = (await params.waitForElement(SELECTORS["frame-menu"], CONTEXT_MENU_ANCHOR_TIMEOUT_MS)) ??
+            (await params.waitForElement(SELECTORS["start-tour"], CONTEXT_MENU_ANCHOR_TIMEOUT_MS));
+        if (run.cancelled || !anchor)
+            return;
+        try {
+            // Loaded on demand: the editor's menu module must not become a static
+            // dependency of the tour configuration.
+            const { buildComponentContextMenuItems } = await import("../editor/ContextMenu");
+            const items = await buildComponentContextMenuItems([component], editContext);
+            if (run.cancelled || items.length === 0)
+                return;
+            const clientX = anchor.left + Math.min(32, anchor.width / 2);
+            const clientY = anchor.top + Math.min(24, anchor.height / 2);
+            editContext.showContextMenu(new MouseEvent("contextmenu", {
+                bubbles: true,
+                cancelable: true,
+                clientX,
+                clientY,
+            }), items);
+        }
+        catch (error) {
+            console.warn("Sandbox tour could not open the component menu", error);
+            return;
+        }
+        for (let attempt = 0; attempt < CONTEXT_MENU_PAINT_POLLS; attempt += 1) {
+            const menu = document.querySelector(SELECTORS["context-menu"]);
+            if (menu && getComputedStyle(menu).opacity === "1")
+                return;
+            await params.delay(16);
+        }
+    };
     return {
         dismissOnEscape: true,
         disableUserInput: true,
@@ -53,6 +135,17 @@ export function createSandboxTour() {
                     bubblePosition: "right",
                     bubbleVerticalAnchor: "center",
                 },
+                {
+                    id: "context-menu",
+                    focusElement: SELECTORS["context-menu"],
+                    presenceElement: SELECTORS["start-tour"],
+                    bubblePosition: "right",
+                    bubbleVerticalAnchor: "center",
+                    skipIf: () => !getContextMenuComponent(params.editContext) ||
+                        selectorShouldBeSkipped(SELECTORS["start-tour"]),
+                    prepareAction: () => openContextMenu(params),
+                    cleanupAction: closeContextMenu,
+                },
                 {
                     id: "insert-component",
                     focusElement: SELECTORS["insert-component"],
@@ -83,6 +176,12 @@ export function createSandboxTour() {
                     bubblePosition: "bottom",
                     skipIf: () => selectorShouldBeSkipped(SELECTORS["device-switcher"]),
                 },
+                {
+                    id: "feedback",
+                    focusElement: SELECTORS.feedback,
+                    bubblePosition: "bottom",
+                    skipIf: () => selectorShouldBeSkipped(SELECTORS.feedback),
+                },
                 {
                     id: "agent-prompt",
                     focusElement: SELECTORS["agent-prompt"],
@@ -131,9 +230,12 @@ export function createSandboxTour() {
             // the element-less closing step). Before the chrome has settled, absent
             // targets are deliberately not skipped, but counting them would make
             // "n of N" shrink once they are confirmed missing.
-            const isCounted = (definition) => !isSkipped(definition) &&
-                (!definition.focusElement ||
-                    elementState(definition.focusElement) === "visible");
+            const isCounted = (definition) => {
+                if (isSkipped(definition))
+                    return false;
+                const presence = definition.presenceElement ?? definition.focusElement;
+                return !presence || elementState(presence) === "visible";
+            };
             const visibleDefinitions = definitions.filter(isCounted);
             const findPreviousVisible = (index) => {
                 for (let previous = index - 1; previous >= 0; previous -= 1) {
@@ -161,6 +263,8 @@ export function createSandboxTour() {
                     bubblePosition: definition.bubblePosition,
                     bubbleVerticalAnchor: definition.bubbleVerticalAnchor,
                     skipIf: definition.skipIf,
+                    prepareAction: definition.prepareAction,
+                    cleanupAction: definition.cleanupAction,
                     nextStep: nextId,
                     ...(definition.id === "start-tour"
                         ? {

package/dist/tour/sandbox-tour.js.map

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

package/dist/types.d.ts

@@ -56,11 +56,12 @@ export type EditSession = {
     color: string;
 };
 export type EditOperation = {
-    type: "edit-field" | "remove-component" | "move-component" | "add-component" | "synchronize-components" | "link-component" | "duplicate-components" | "rename-item" | "change-template" | "create-item" | "delete-items" | "add-version" | "remove-version" | "move-items" | "copy-items" | "clone-items" | "import-items" | "publish-item" | "convert-to-shared" | "update-rendering-parameters" | "update-rendering-rules";
+    type: "edit-field" | "remove-component" | "move-component" | "add-component" | "synchronize-components" | "link-component" | "duplicate-components" | "paste-components" | "rename-item" | "change-template" | "create-item" | "delete-items" | "add-version" | "remove-version" | "move-items" | "copy-items" | "clone-items" | "import-items" | "publish-item" | "convert-to-shared" | "convert-component" | "rename-component" | "update-rendering-parameters" | "update-rendering-rules";
     date: string;
     id: string;
     user?: User;
     undone?: boolean;
+    undoDate?: string | null;
     sessionId?: string;
     title: string;
     description?: string;
@@ -149,6 +150,20 @@ export type DuplicateComponentsOperation = EditOperation & {
     componentIds: string[];
     sourceComponentIds: string[];
 };
+/**
+ * Copies clipboard components (possibly from another page) into a placeholder of
+ * `mainItem`. The sources are left untouched; `componentIds` holds the created copies.
+ */
+export type PasteComponentsOperation = EditOperation & {
+    type: "paste-components";
+    sourcePageItem: ItemDescriptor;
+    sourceComponentIds: string[];
+    placeholderKey: string;
+    placeholderIndex: number;
+    /** Component owning the placeholder on the target page (page root for root placeholders). */
+    targetParentComponentId?: string;
+    componentIds?: string[];
+};
 export type RemoveComponentOperation = EditOperation & {
     type: "remove-component";
     componentIds: string[];
@@ -256,6 +271,71 @@ export type ConvertToSharedOperation = EditOperation & {
     componentId: string;
     targetFolderId?: string;
 };
+export type ConversionMappingMode = "copy" | "convert" | "rewrite" | "generate" | "empty";
+export type ConversionFieldMapping = {
+    targetFieldId: string;
+    /** Merge mode: the source component the field is read from. */
+    sourceComponentId?: string;
+    sourceFieldId?: string;
+    mode: ConversionMappingMode;
+    instruction?: string;
+    /** Current-language AI value the user saw; used as-is for that language. */
+    previewValue?: string;
+    /** AI values the dialog wrote for the other languages: language -> raw value. */
+    previewValues?: Record<string, string>;
+};
+export type ConversionChildAction = {
+    componentId: string;
+    action: "move" | "remove" | "convert";
+    /** Base name of the placeholder on the new component, e.g. "ph-teaser-actions". */
+    targetPlaceholder?: string;
+    /** Nested conversion for "convert"; its source is `componentId`. */
+    conversion?: ConversionItem;
+};
+/** One resulting component of a convert-component operation. */
+export type ConversionItem = {
+    key?: string;
+    sourceComponentIds?: string[];
+    anchorComponentId?: string;
+    targetTypeId: string;
+    targetTypeName?: string;
+    targetPlaceholder?: string;
+    fieldMappings: ConversionFieldMapping[];
+    childActions?: ConversionChildAction[];
+    copyRenderingParameters?: boolean;
+    carryOverPersonalization?: boolean;
+    /** Filled in by the server. */
+    newComponentId?: string;
+    newComponentName?: string;
+};
+/**
+ * Replaces components with components of another type and migrates their
+ * content. "each": one conversion per selected component; "merge": one
+ * conversion with several sources. One undo restores everything.
+ */
+export type ConvertComponentOperation = EditOperation & {
+    type: "convert-component";
+    mode: "each" | "merge";
+    languages?: string[];
+    conversions: ConversionItem[];
+    /** The user's instructions for AI-written fields, oldest first. */
+    instructions?: string[];
+    /** Model for values the dialog did not write; unset for the default. */
+    modelId?: string;
+    warnings?: string[];
+};
+/**
+ * Renames a component. The components provider decides what is renamed: the
+ * datasource item for renderings, the embedded component item for content parts.
+ */
+export type RenameComponentOperation = EditOperation & {
+    type: "rename-component";
+    componentId: string;
+    newName: string;
+    oldName?: string;
+    /** The renamed item, filled in by the server. */
+    itemId?: string;
+};
 export type UpdateRenderingParametersOperation = EditOperation & {
     type: "update-rendering-parameters";
     componentId: string;
@@ -387,10 +467,14 @@ export type UserPreferences = {
     editorFormHidden?: boolean;
     /** Set to true once the user has seen the first-time hint explaining how to re-open the editor form. */
     editorFormHintSeen?: boolean;
+    /** Set to true once the user has inserted a component; hides the palette's how-to hint. */
+    componentInsertionHintSeen?: boolean;
     /** Last selected target folder for AI image jobs (Sitecore media folder item ID) */
     aiImageTargetFolderId?: string;
     /** ISO timestamp for the latest feedback item the user has seen on the home screen. */
     latestFeedbackLastSeenAt?: string;
+    /** Spell-check underlines and suggestions in text fields and on the canvas. Undefined means enabled. */
+    spellCheckEnabled?: boolean;
 };
 export type HistoryEntry = {
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parhelia/core",
-  "version": "0.4.12818",
+  "version": "0.4.12871",
   "publishConfig": {
     "access": "public"
   },
@@ -45,6 +45,8 @@
     "test:watch": "vitest"
   },
   "devDependencies": {
+    "@babel/core": "^8.0.1",
+    "@babel/parser": "^8.0.0",
     "@repo/eslint-config": "*",
     "@repo/typescript-config": "*",
     "@tailwindcss/postcss": "^4.3.3",
@@ -55,16 +57,18 @@
     "@types/node": "^26.4.0",
     "@types/react": "19.2.18",
     "@types/react-dom": "19.2.5",
+    "@typescript/native": "npm:typescript@7.0.2",
+    "babel-plugin-react-compiler": "^1.0.0",
     "copyfiles": "^2.4.1",
     "eslint": "^10.9.1",
     "jsdom": "^30.0.1",
     "tailwindcss": "^4.3.3",
-    "@typescript/native": "npm:typescript@7.0.2",
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "vitest": "^4.1.11"
   },
   "dependencies": {
     "@dagrejs/dagre": "^3.1.1",
+    "@discordapp/twemoji": "16.0.1",
     "@fontsource/inter": "^5.3.0",
     "@radix-ui/react-accordion": "^1.2.20",
     "@radix-ui/react-alert-dialog": "^1.1.23",

package/styles.css

@@ -77,9 +77,9 @@ body {
   .taskboard-wizard-communication-card:has(
     [data-testid="taskboard-wizard-agent-chat-tab"][aria-selected="true"]
   ) {
-    align-self: stretch;
-    height: 100%;
-    max-height: 100%;
+    align-self: start;
+    height: calc(100vh - 7rem);
+    max-height: calc(100vh - 7rem);
   }
 }
 
@@ -103,6 +103,8 @@ body {
 
   /* Neutral colors */
   --color-neutral-grey-100: hsl(0 0% 7%);
+  /* Field text: a step lighter than body text */
+  --color-neutral-grey-80: hsl(0 0% 26%);
   --color-neutral-grey-50: hsl(0 0% 54%);
   --color-neutral-grey-15: hsl(0 0% 86%);
   --color-neutral-grey-10: hsl(0 0% 91%);
@@ -380,6 +382,21 @@ body {
 }
 
 @layer components {
+  /* Canvas spell-check underline: a wavy strip drawn by the overlay under a
+     misspelled word. The wave is an SVG mask so the color still comes from the
+     feedback token (text surfaces use Tailwind's decoration-wavy instead). */
+  .spellcheck-underline {
+    background-color: var(--color-feedback-red);
+    mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='6' height='3' viewBox='0 0 6 3'%3E%3Cpath d='M0 2.2 Q1.5 0.3 3 2.2 T6 2.2' fill='none' stroke='black' stroke-width='1.2'/%3E%3C/svg%3E");
+    -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='6' height='3' viewBox='0 0 6 3'%3E%3Cpath d='M0 2.2 Q1.5 0.3 3 2.2 T6 2.2' fill='none' stroke='black' stroke-width='1.2'/%3E%3C/svg%3E");
+    mask-repeat: repeat-x;
+    -webkit-mask-repeat: repeat-x;
+    mask-size: 6px 3px;
+    -webkit-mask-size: 6px 3px;
+    mask-position: left bottom;
+    -webkit-mask-position: left bottom;
+  }
+
   /* Firefox and WebKit use a high-priority background for autofilled fields.
      Paint the review secret input's normal translucent fill over that color. */
   .secret-phrase-input:is(:autofill, :-webkit-autofill) {
@@ -605,6 +622,60 @@ body {
       --saved-bar-alpha: 0;
     }
   }
+
+  /* Running field action (AI image generation, field actions): the Parhelia
+     swirl in white on a black tile, centred on the field, drawing itself. The path has pathLength="1", so a dash of length 1 offset from 1
+     to 0 traces the outline; the fill then fades in, holds, and the whole
+     mark fades out before the loop restarts (at 0% nothing is visible, so
+     the opacity jump at the seam is not). No tint over the field. Decorative
+     only, pointer-events: none; the `executing-action` class stays as the
+     hook the e2e tests wait on. */
+  .field-action-tile {
+    background-color: var(--color-neutral-grey-100);
+    border-radius: 22%;
+  }
+
+  .field-action-mark-path {
+    fill: var(--color-white);
+    fill-opacity: 0;
+    stroke: var(--color-white);
+    stroke-width: 2.5;
+    stroke-linejoin: round;
+    stroke-dasharray: 1;
+    stroke-dashoffset: 1;
+    animation: field-action-draw 3.2s ease-in-out infinite;
+  }
+
+  @keyframes field-action-draw {
+    0% {
+      stroke-dashoffset: 1;
+      fill-opacity: 0;
+      opacity: 1;
+    }
+    50% {
+      stroke-dashoffset: 0;
+      fill-opacity: 0;
+    }
+    65% {
+      fill-opacity: 1;
+    }
+    86% {
+      opacity: 1;
+    }
+    100% {
+      stroke-dashoffset: 0;
+      fill-opacity: 1;
+      opacity: 0;
+    }
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    .field-action-mark-path {
+      animation: none;
+      fill-opacity: 1;
+      stroke-dashoffset: 0;
+    }
+  }
 }
 
 @layer base {

package/dist/editor/page-editor-chrome/bridgeLinkValue.d.ts

@@ -1,10 +0,0 @@
-import type { Link } from "../LinkEditorDialog";
-import type { BridgeSelectionLinkAttributes } from "../bridge/protocol";
-/**
- * Builds the LinkEditorDialog value for the anchor the canvas selection is
- * inside, so re-opening the link dialog on the WYSIWYG toolbar hydrates the
- * current link the same way the form editor does. Uses the rich text
- * converter's anchor parsing, so internal-link detection (dynamic links,
- * data attributes, editor-local hrefs) cannot drift between the two editors.
- */
-export declare function buildLinkValueFromBridgeAttributes(attributes: BridgeSelectionLinkAttributes | undefined): Link | null;

package/dist/editor/page-editor-chrome/bridgeLinkValue.js

@@ -1,55 +0,0 @@
-import { createLinkElementFromAnchor } from "../field-types/richtext/utils/conversion";
-/**
- * Builds the LinkEditorDialog value for the anchor the canvas selection is
- * inside, so re-opening the link dialog on the WYSIWYG toolbar hydrates the
- * current link the same way the form editor does. Uses the rich text
- * converter's anchor parsing, so internal-link detection (dynamic links,
- * data attributes, editor-local hrefs) cannot drift between the two editors.
- */
-export function buildLinkValueFromBridgeAttributes(attributes) {
-    if (!attributes?.href || typeof document === "undefined") {
-        return null;
-    }
-    const anchor = document.createElement("a");
-    anchor.setAttribute("href", attributes.href);
-    if (attributes.target)
-        anchor.setAttribute("target", attributes.target);
-    if (attributes.title)
-        anchor.setAttribute("title", attributes.title);
-    if (attributes.rel)
-        anchor.setAttribute("rel", attributes.rel);
-    if (attributes.dataInternal) {
-        anchor.setAttribute("data-internal", attributes.dataInternal);
-    }
-    if (attributes.dataItemId) {
-        anchor.setAttribute("data-item-id", attributes.dataItemId);
-    }
-    if (attributes.dataQuerystring) {
-        anchor.setAttribute("data-querystring", attributes.dataQuerystring);
-    }
-    const linkElement = createLinkElementFromAnchor(anchor, []);
-    const link = linkElement.link;
-    if (!link) {
-        return null;
-    }
-    if (link.type === "internal") {
-        return {
-            type: "internal",
-            itemId: link.itemId || link.targetItemLongId?.split("/").pop() || "",
-            targetItemLongId: link.targetItemLongId || "",
-            target: link.target === "_self" ? "" : link.target || "",
-            queryString: link.queryString || "",
-            title: link.title || "",
-            nofollow: !!link.nofollow,
-        };
-    }
-    return {
-        type: "external",
-        url: linkElement.url || link.url || "",
-        target: link.target === "_self" ? "" : link.target || "",
-        queryString: link.queryString || "",
-        title: link.title || "",
-        nofollow: !!link.nofollow,
-    };
-}
-//# sourceMappingURL=bridgeLinkValue.js.map

package/dist/editor/page-editor-chrome/bridgeLinkValue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bridgeLinkValue.js","sourceRoot":"","sources":["../../../src/editor/page-editor-chrome/bridgeLinkValue.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAEvF;;;;;;GAMG;AACH,MAAM,UAAU,kCAAkC,CAChD,UAAqD;IAErD,IAAI,CAAC,UAAU,EAAE,IAAI,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,MAAM;QAAE,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACxE,IAAI,UAAU,CAAC,KAAK;QAAE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACrE,IAAI,UAAU,CAAC,GAAG;QAAE,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/D,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;QAC5B,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QAC1B,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;QAC/B,MAAM,CAAC,YAAY,CAAC,kBAAkB,EAAE,UAAU,CAAC,eAAe,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,WAAW,GAAG,2BAA2B,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE;YACpE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,EAAE;YAC7C,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE;YACxD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,WAAW,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE;QACtC,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE;QACxD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QACnC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;QACvB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC"}