@wix/ditto-codegen-public 1.0.364 → 1.0.366

package/dist/out.js

@@ -12176,9 +12176,1164 @@ var require_dist6 = __commonJS({
   }
 });
 
-// ../codegen-studio-2-config/dist/site-data-layer-rules.js
+// ../codegen-common-logic/dist/extensions/BackendApiAgent.js
+var require_BackendApiAgent = __commonJS({
+  "../codegen-common-logic/dist/extensions/BackendApiAgent.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getBackendApiDecisionGuide = exports2.getBackendApiAgentDocumentation = void 0;
+    var getBackendApiAgentDocumentation = () => {
+      return `<backend_api>
+#### Backend API (HTTP Endpoints)
+
+- **Description**:
+Backend APIs allow you to define HTTP server endpoints in your app's backend that you can call from your frontend.
+- **Use Cases**:
+- Third-party API integrations (e.g. calling the OpenAI API with an API key that you don't want to expose in your client code)
+- **When to Choose**: ONLY when the user prompt EXPLICITLY requests a backend, a server, or an endpoint AND the operation cannot be done on the frontend.
+
+- **[CRITICAL] When NOT to Choose**:
+- \u274C **DEFAULT RULE: Do NOT use Backend API unless absolutely necessary**
+- \u274C Don't use Backend API simply because you need to query or manipulate data
+- \u274C Don't use Backend API for CMS operations - use @wix/data directly in Site Widgets/Embedded Scripts/Dashboard Pages
+- \u274C Don't use Backend API for cart/order operations - use @wix/stores or @wix/ecom directly in frontend code
+- \u274C Don't use Backend API for customer/contact operations - use @wix/crm directly in frontend code
+- \u274C Don't use Backend API for displaying data on the site - query it directly in Site Widgets or Embedded Scripts
+- \u274C Don't use Backend API for checking conditions or filtering data - do it in frontend code
+
+- **Frontend-First Approach**:
+- \u2705 **Always prefer frontend packages**: @wix/data, @wix/crm, @wix/stores, @wix/ecom, @wix/members
+- \u2705 These packages work in Site Widgets, Embedded Scripts, and Dashboard Pages
+- \u2705 No backend needed for 90% of data operations
+</backend_api>`;
+    };
+    exports2.getBackendApiAgentDocumentation = getBackendApiAgentDocumentation;
+    var getBackendApiDecisionGuide = () => {
+      return `### Choose Backend API (HTTP Endpoints) when:
+
+- \u2705 The user EXPLICITLY requests a backend, a server, or an endpoint
+- \u2705 Need to hide credentials or secrets (e.g., calling third-party APIs with API keys)
+- \u2705 Integrating with third-party services that require server-side authentication
+
+### \u274C [CRITICAL] DO NOT choose Backend API (HTTP Endpoints) when:
+
+**IMPORTANT: 90% of operations can be done on the frontend - Backend API is rarely needed!**
+
+- \u274C **Working with CMS data** \u2192 Use @wix/data directly in Site Widgets, Embedded Scripts, or Dashboard Pages
+- \u274C **Working with contacts/customers** \u2192 Use @wix/crm directly in the frontend
+- \u274C **Working with products, orders, or cart** \u2192 Use @wix/stores or @wix/ecom directly in the frontend
+- \u274C **Displaying data on the site** \u2192 Query it directly in Site Widgets or Embedded Scripts
+- \u274C **Checking user conditions or filtering** \u2192 Do it in frontend code
+- \u274C **User simply wants "data operations"** \u2192 This does NOT require a backend
+
+**Examples of what DOES NOT need Backend API:**
+- "Create a CMS and display data on site" \u2192 Dashboard Page (for CMS management) + Embedded Script/Site Widget (query with @wix/data)
+- "Show popup with cart items" \u2192 Embedded Script with @wix/stores
+- "Display user-specific content" \u2192 Site Widget with @wix/members and @wix/data
+- "Check if user ID is in a list" \u2192 Embedded Script with @wix/data query`;
+    };
+    exports2.getBackendApiDecisionGuide = getBackendApiDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/BackendEventAgent.js
+var require_BackendEventAgent = __commonJS({
+  "../codegen-common-logic/dist/extensions/BackendEventAgent.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getBackendEventDecisionGuide = exports2.getBackendEventAgentDocumentation = void 0;
+    var getBackendEventAgentDocumentation = () => {
+      return `<backend_event>
+#### Backend Event Extensions
+
+- **Description**: Webhooks that respond to Wix platform events. These are server-side handlers automatically triggered when specific events occur on the Wix platform.
+- **Use Cases**:
+- Automated workflows triggered by user actions
+- Data synchronization when events occur
+- Notifications and alerts
+- Audit logging and tracking
+- Third-party integrations triggered by Wix events
+- Reacting to user actions and events
+- Triggering actions when platform events occur (e.g. send email when order is placed)
+
+- **When to Choose**: Look for these trigger patterns in user prompts:
+- "WHEN [event] happens" or "WHEN [action] occurs"
+- "AFTER [event]"
+- "Automatically when [event]"
+- "Trigger [action] on [event]"
+- "Display/show [element] when [event occurs]"
+- "Notify when [event]"
+- The action needs to happen on the server in response to a platform event
+
+- **[CRITICAL] If the prompt describes an action that should be triggered by a platform event, you must include a BACKEND_EVENT extension to handle the platform event. These scenarios require server-side event listeners to respond to platform events, not client-side conditional logic.**
+
+- **Examples of Platform Events**:
+- eCommerce: checkout created/completed, order created/updated
+- Contacts: contact created/updated
+- Bookings: booking created/canceled
+- Data: data item created/updated
+- Products: product created/updated
+</backend_event>`;
+    };
+    exports2.getBackendEventAgentDocumentation = getBackendEventAgentDocumentation;
+    var getBackendEventDecisionGuide = () => {
+      return `### Choose Backend Event Extensions (Webhooks) when:
+
+- \u2705 User prompt contains trigger words: "WHEN", "AFTER", "Automatically when", "Trigger on"
+- \u2705 Need to react to platform events (checkout completed, order created, product created, contact created, etc.)
+- \u2705 Building automated workflows triggered by user actions
+- \u2705 Synchronizing data with external systems when events occur
+- \u2705 Creating notification systems
+- \u2705 Need server-side webhooks/event handling (not user-initiated in browser)
+- \u2705 Action must happen automatically in response to a platform event
+- \u2705 Prompt describes actions triggered by platform events - these require BACKEND_EVENT webhooks, not client-side logic
+
+### Do NOT choose Backend Event Extensions (Webhooks) when:
+
+- \u274C User asks for "initialization" or "setup" logic (one-time operations) - webhooks are for recurring events
+- \u274C User wants to create/initialize collections - this is one-time setup, not event-driven
+- \u274C User wants server endpoints called from frontend
+- \u274C User wants conditional logic without platform event triggers
+- \u274C The action is NOT triggered by a Wix platform webhook
+For example when not to use Backend Event Extensions:
+- \u274C "Create a products collection when the app is installed"
+`;
+    };
+    exports2.getBackendEventDecisionGuide = getBackendEventDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/SPIAgent.js
+var require_SPIAgent = __commonJS({
+  "../codegen-common-logic/dist/extensions/SPIAgent.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getSPIDecisionGuide = exports2.getSPIAgentDocumentation = void 0;
+    var getSPIAgentDocumentation = () => {
+      return `<service_plugin>
+#### Service Plugin Extensions (SPIs) - Developer Preview
+
+- **Description**: Custom logic injection into existing Wix app flows (formerly called SPIs - Service Provider Interfaces)
+- **Use Cases**:
+- Custom shipping rate calculations
+- Payment processing modifications
+- Custom validation logic
+- Additional checkout fees
+- Gift card operations
+- Discount trigger customizations
+- Staff sorting in bookings
+- **Available SPI Types**:
+- eCommerce (shipping rates, fees, validations, payment settings, gift cards, discount triggers)
+- Bookings (staff sorting)
+- **When to Choose**: When you need to customize or extend core Wix business app functionality during a business flow
+
+**Available SPI Names (choose appropriate ones for relatedSpis):**
+- "ecom.shippingRates.getShippingRates" - For custom shipping rate calculations
+- "ecom.additionalFees.calculateAdditionalFees" - For calculating additional fees (handling, processing, etc.)
+- "ecom.paymentSettings.getPaymentSettings" - For payment configuration and 3D Secure settings
+- "ecom.validations.getValidationViolations" - For cart and checkout validations
+- "ecom.customTriggers.getEligibleTriggers" - For custom discount trigger logic
+- "ecom.customTriggers.listTriggers" - For listing available custom discount triggers
+- "ecom.giftCardsProvider.redeem" - For gift card redemption logic
+- "ecom.giftCardsProvider._void" - For voiding gift card transactions
+- "ecom.giftCardsProvider.getBalance" - For checking gift card balances
+- "bookings.staffSortingProvider.sortStaffMembers" - For custom staff sorting/assignment in bookings
+
+**SPI Selection Guidelines:**
+- For shipping-related requests \u2192 use "ecom.shippingRates.getShippingRates"
+- For fee calculations \u2192 use "ecom.additionalFees.calculateAdditionalFees"
+- For payment processing \u2192 use "ecom.paymentSettings.getPaymentSettings"
+- For cart/checkout validation \u2192 use "ecom.validations.getValidationViolations"
+- For discount logic \u2192 use "ecom.customTriggers.getEligibleTriggers" or "ecom.customTriggers.listTriggers"
+- For gift card functionality \u2192 use appropriate "ecom.giftCardsProvider.*" methods
+- For staff sorting/assignment in bookings \u2192 use "bookings.staffSortingProvider.sortStaffMembers"
+
+**\u274C UNSUPPORTED - DO NOT USE SERVICE_PLUGIN for these (no builders exist):**
+- Tax calculations \u2192 use BACKEND_EVENT listening to order events instead
+- Bookings custom pricing \u2192 use BACKEND_EVENT listening to booking events instead
+- Product recommendations \u2192 use BACKEND_EVENT or EMBEDDED_SCRIPT instead
+- External catalog integration \u2192 use BACKEND_API instead
+
+</service_plugin>`;
+    };
+    exports2.getSPIAgentDocumentation = getSPIAgentDocumentation;
+    var getSPIDecisionGuide = () => {
+      return `### Choose Service Plugin Extensions (SPIs) when:
+
+- \u2705 Need to customize core business logic (shipping rates, checkout fees, validations, payment settings)
+- \u2705 Want to inject custom logic into existing Wix flows DURING execution (not after events)
+- \u2705 Need to modify eCommerce checkout calculations (fees, shipping, gift cards, discounts)
+- \u2705 Need to customize Bookings staff assignment logic
+- \u274C NOT for tax calculations or bookings pricing (use BACKEND_EVENT instead)`;
+    };
+    exports2.getSPIDecisionGuide = getSPIDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/DataCollectionAgent.js
+var require_DataCollectionAgent = __commonJS({
+  "../codegen-common-logic/dist/extensions/DataCollectionAgent.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getDataCollectionDecisionGuide = exports2.getDataCollectionAgentDocumentation = void 0;
+    var getDataCollectionAgentDocumentation = () => {
+      return `<data_collection>
+#### Data Collections (CMS)
+
+- **Description**: CMS data collection schemas that define structured data storage for the app. Collections are automatically created when the app is installed on a site. Enables the site's code editor automatically, which is required for Wix Data APIs to work.
+- **Use Cases**:
+- Storing business data (products, orders, inventory, fees)
+- User-generated content (reviews, comments, submissions)
+- Custom app data that needs to persist across sessions
+- Relational data with references between collections
+- Content management for blog posts, articles, or catalog items
+- **When to Choose**: When the app needs to store and manage structured data that can be accessed from dashboard pages, site pages, backend code, or external applications. Essential when other extensions (Dashboard Pages, Site Widgets) need to read or write persistent data.
+</data_collection>`;
+    };
+    exports2.getDataCollectionAgentDocumentation = getDataCollectionAgentDocumentation;
+    var getDataCollectionDecisionGuide = () => {
+      return `### Choose Data Collections when:
+
+- \u2705 The app needs to store and manage structured business data
+- \u2705 Dashboard Pages need to manage data displayed on the site
+- \u2705 Site Widgets need to query persistent data
+- \u2705 You need relational data with references between collections
+- \u2705 User-generated content needs to be stored (reviews, submissions, comments)
+- \u2705 Multiple records of the same type need CRUD operations
+
+### Do NOT choose Data Collections when:
+
+- \u274C The domain is already covered by a Wix SDK (Stores, Bookings, eCommerce, Events, Restaurants, Blog, Forum, Portfolio, Pricing Plans, Donations, Gift Cards, Coupons, Members & Contacts, Forms, Loyalty Program, Communication) \u2014 use the SDK instead, **including for SDK-managed configuration** like earning rules, plans, services, rewards, or coupon rules
+- \u274C The data is "configuration" for an SDK that already exposes that configuration through its own API`;
+    };
+    exports2.getDataCollectionDecisionGuide = getDataCollectionDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/BackendExtensions.js
+var require_BackendExtensions = __commonJS({
+  "../codegen-common-logic/dist/extensions/BackendExtensions.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getBackendExtensionsDocumentation = void 0;
+    var BackendApiAgent_1 = require_BackendApiAgent();
+    var BackendEventAgent_1 = require_BackendEventAgent();
+    var SPIAgent_1 = require_SPIAgent();
+    var DataCollectionAgent_1 = require_DataCollectionAgent();
+    var getBackendExtensionsDocumentation = () => {
+      return `### Backend Extensions
+
+  Backend extensions provide server-side functionality.
+
+  ${(0, BackendApiAgent_1.getBackendApiAgentDocumentation)()}
+
+  ${(0, BackendEventAgent_1.getBackendEventAgentDocumentation)()}
+
+  ${(0, SPIAgent_1.getSPIAgentDocumentation)()}
+
+  ${(0, DataCollectionAgent_1.getDataCollectionAgentDocumentation)()}`;
+    };
+    exports2.getBackendExtensionsDocumentation = getBackendExtensionsDocumentation;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/CustomElementWidgetAgent.js
+var require_CustomElementWidgetAgent = __commonJS({
+  "../codegen-common-logic/dist/extensions/CustomElementWidgetAgent.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getCustomElementWidgetDecisionGuide = exports2.getCustomElementWidgetAgentDocumentation = void 0;
+    var getCustomElementWidgetAgentDocumentation = () => {
+      return `<custom_element_widget>
+#### Custom Element Widgets
+
+- **Description**: Custom HTML elements/widgets that site owners can add to their pages
+- **Use Cases**:
+- Interactive components
+- Custom forms
+- Data displays
+- Third-party service integrations
+- Custom calculators or tools
+- Counter components
+- Countdown components
+- **Built-in Settings Panel**: Custom Element Widgets have a built-in settings panel in the Wix Editor that allows site owners to configure the widget directly without needing a separate Dashboard Page. The panel can include:
+  - Text inputs (titles, labels, messages)
+  - Date/time pickers
+  - Color pickers and style options
+  - Toggle switches and checkboxes
+  - Dropdown selectors
+  - Number inputs
+- **When Panel is Sufficient**: For widgets where configuration is per-instance and managed by the site owner in the Editor (e.g., countdown target date, display text, colors, styles). NO Dashboard Page is needed.
+- **When Dashboard Page is Needed**: Only when the app requires storing shared configurations in a database, managing multiple configurations across widgets, or providing admin-level analytics/reporting.
+- **When to Choose**: When you need to provide reusable, configurable components for site builders and you need to add functionality to Wix sites for Wix site visitors. This is the DEFAULT choice for site functionality **that is NOT tied to a Wix business solution page**. If the functionality belongs on a product page, booking page, checkout, event page, or blog post \u2192 use Site Plugin instead.
+- **IMPORTANT**: Do NOT pair Custom Element Widgets with a Dashboard Page unless the user explicitly requests shared/centralized configuration management. The widget panel handles per-instance configuration.
+</custom_element_widget>`;
+    };
+    exports2.getCustomElementWidgetAgentDocumentation = getCustomElementWidgetAgentDocumentation;
+    var getCustomElementWidgetDecisionGuide = () => {
+      return `### Choose Custom Element Widgets when:
+
+- \u2705 Creating reusable page components
+- \u2705 Building interactive site elements
+- \u2705 Need configurable widgets for site builders
+- \u2705 Want to provide drag-and-drop functionality
+- \u2705 Need to add functionality to Wix sites for site visitors
+- \u2705 **DEFAULT choice for site functionality not tied to a Wix business solution page**
+
+### Custom Element Widget Panel vs Dashboard Page:
+- \u2705 Use the **built-in widget panel** for per-instance configuration (text, dates, styles, toggles) - NO Dashboard Page needed
+- \u274C Only add a Dashboard Page if the user explicitly needs shared/centralized configuration stored in a database`;
+    };
+    exports2.getCustomElementWidgetDecisionGuide = getCustomElementWidgetDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/DashboardPageAgent.js
+var require_DashboardPageAgent = __commonJS({
+  "../codegen-common-logic/dist/extensions/DashboardPageAgent.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getDashboardPageDecisionGuide = exports2.getDashboardPageAgentDocumentation = void 0;
+    var getDashboardPageAgentDocumentation = () => {
+      return `<dashboard_page>
+#### Dashboard Pages
+
+- **Description**: Administrative pages added to the dashboard with custom functionality
+- **Use Cases**:
+- Business management tools
+- Data visualization dashboards
+- Administrative interfaces
+- Custom reporting pages
+- **When to Choose**: When you need a dedicated administrative interface or custom business management functionality
+</dashboard_page>`;
+    };
+    exports2.getDashboardPageAgentDocumentation = getDashboardPageAgentDocumentation;
+    var getDashboardPageDecisionGuide = () => {
+      return `### Choose Dashboard Pages when:
+
+- \u2705 You need a dedicated administrative interface
+- \u2705 Creating business management tools
+- \u2705 Building custom reporting dashboards
+- \u2705 Need full control over page layout and functionality
+
+### Do NOT add Dashboard Pages for:
+
+- \u274C Site Widget configuration - use the widget's **built-in settings panel** instead`;
+    };
+    exports2.getDashboardPageDecisionGuide = getDashboardPageDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/DashboardPlugins.js
+var require_DashboardPlugins = __commonJS({
+  "../codegen-common-logic/dist/extensions/DashboardPlugins.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getDashboardPluginsDecisionGuide = exports2.getDashboardPluginsAgentDocumentation = void 0;
+    var getDashboardPluginsAgentDocumentation = () => {
+      return `<dashboard_plugins>
+#### Dashboard Plugins
+- **Description**: Interactive widgets embedded into existing Wix app dashboard pages via predefined plugin slots
+- **Slot System**: Plugins are placed in predefined page slots within existing Wix business app dashboards
+- **Use Cases**:
+  - Product analytics widgets on Wix Stores Products page
+  - Inventory monitoring on Wix Stores Inventory page
+  - Booking insights on Wix Bookings Services or Booking List pages
+  - Order details enrichment on Wix eCommerce Order page
+- **Context Access**: Automatic access to current page context (entity IDs, user permissions, page state)
+- **When to Choose**: When you need to enhance existing Wix business app dashboards with contextual functionality
+
+##### Supported Dashboard Plugin Page Slots:
+
+**Wix Stores:**
+- Products page \u2013 Embed a plugin on the Products list page
+- Inventory page \u2013 Embed a plugin on the Inventory management page
+
+**Wix Bookings:**
+- Staff page \u2013 Embed a plugin on the Staff management page
+- Edit Staff Profile page \u2013 Embed a plugin on a staff member's profile page
+- Services page \u2013 Embed a plugin on the Services list page
+- Booking List page \u2013 Embed a plugin on the Booking List page
+
+**Wix eCommerce:**
+- Order page \u2013 Embed a plugin on the Order details page
+- Edit Order page \u2013 Embed a plugin (e.g., additional fees) on the Edit Order page
+- Orders List page \u2013 Available via more actions menu
+
+**Wix Blog:**
+- Blog Overview page \u2013 Embed a plugin on the Blog Overview page
+- Categories page \u2013 Embed a plugin on the Categories page
+- Posts page \u2013 Embed a plugin on the Posts list page
+- Tags page \u2013 Embed a plugin on the Tags page
+
+**Wix Events:**
+- Event Features Tab, Overview Tab, Promotion Tab, Settings Tab, Tickets & Seating Tab
+
+**Wix Restaurants:**
+- Table Reservations page \u2013 Embed a plugin on the Table Reservations page
+
+##### Examples:
+- Wix Stores Products page \u2013 Product performance analytics widget
+- Wix Stores Inventory page \u2013 Low-stock alerts widget
+- Wix Bookings Services page \u2013 Service performance insights
+- Wix Bookings Booking List page \u2013 Quick rescheduling action buttons
+- Wix eCommerce Order page \u2013 Cross-sell recommendations
+- Wix Blog Posts page \u2013 SEO score widget for draft posts
+</dashboard_plugins>`;
+    };
+    exports2.getDashboardPluginsAgentDocumentation = getDashboardPluginsAgentDocumentation;
+    var getDashboardPluginsDecisionGuide = () => {
+      return `### Choose Dashboard Plugins when:
+
+- \u2705 You want to enhance existing Wix app pages with contextual widgets
+- \u2705 Need to integrate with Wix Bookings, Stores, etc. within their existing UI
+- \u2705 Want to add functionality to specific business app contexts (product pages, order pages, booking lists, etc.)
+- \u2705 Need automatic access to current page context (entity IDs, user permissions, page state)
+- \u2705 Building analytics, insights, or management tools that complement existing workflows
+- \u2705 Want to avoid creating separate pages for functionality that fits within existing contexts`;
+    };
+    exports2.getDashboardPluginsDecisionGuide = getDashboardPluginsDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/DashboardMenuPlugins.js
+var require_DashboardMenuPlugins = __commonJS({
+  "../codegen-common-logic/dist/extensions/DashboardMenuPlugins.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getDashboardMenuPluginsDecisionGuide = exports2.getDashboardMenuPluginsAgentDocumentation = void 0;
+    var getDashboardMenuPluginsAgentDocumentation = () => {
+      return `<dashboard_menu_plugins>
+#### Dashboard Menu Plugins
+
+- **Description**: Menu items added to dashboard page menus that can navigate to pages or open modals
+- **Use Cases**:
+  - Quick access to app features
+  - Navigation shortcuts
+  - Context-specific actions
+- **When to Choose**: When you need to add navigation items or quick actions to existing dashboard menus
+</dashboard_menu_plugins>`;
+    };
+    exports2.getDashboardMenuPluginsAgentDocumentation = getDashboardMenuPluginsAgentDocumentation;
+    var getDashboardMenuPluginsDecisionGuide = () => {
+      return `### Choose Dashboard Menu Plugins when:
+
+- \u2705 Need to add custom navigation items to the dashboard sidebar
+- \u2705 Want quick-access shortcuts to app features from the dashboard menu
+- \u2705 Need context-specific actions accessible from dashboard navigation
+- \u2705 Want to link dashboard menu items to Dashboard Pages`;
+    };
+    exports2.getDashboardMenuPluginsDecisionGuide = getDashboardMenuPluginsDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/DashboardExtensions.js
+var require_DashboardExtensions = __commonJS({
+  "../codegen-common-logic/dist/extensions/DashboardExtensions.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getDashboardExtensionsDocumentation = void 0;
+    var DashboardPageAgent_1 = require_DashboardPageAgent();
+    var DashboardPlugins_1 = require_DashboardPlugins();
+    var DashboardMenuPlugins_1 = require_DashboardMenuPlugins();
+    var getDashboardExtensionsDocumentation = () => {
+      return `### Dashboard Extensions
+  Dashboard extensions add functionality to the Wix Dashboard for site administrators. They are not visible on live sites.
+  ${(0, DashboardPageAgent_1.getDashboardPageAgentDocumentation)()}
+
+  ${(0, DashboardPlugins_1.getDashboardPluginsAgentDocumentation)()}
+
+  ${(0, DashboardMenuPlugins_1.getDashboardMenuPluginsAgentDocumentation)()}`;
+    };
+    exports2.getDashboardExtensionsDocumentation = getDashboardExtensionsDocumentation;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/EmbeddedScriptAgent.js
+var require_EmbeddedScriptAgent = __commonJS({
+  "../codegen-common-logic/dist/extensions/EmbeddedScriptAgent.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getEmbeddedScriptDecisionGuide = exports2.getEmbeddedScriptAgentDocumentation = void 0;
+    var getEmbeddedScriptAgentDocumentation = () => {
+      return `<embedded_script>
+#### Embedded Scripts
+
+- **Description**: HTML code fragments injected into site DOMs. These can include custom JavaScript, HTML elements, and can be configured through dynamic parameters managed via a Dashboard Page.
+- **Use Cases**:
+- Analytics tracking (Google Analytics, Mixpanel, Facebook Pixel)
+- Third-party integrations
+- Custom JavaScript functionality
+- Advertising code
+- Social media widgets
+- Site-wide notifications and popups
+- Countdown timers for events or promotions
+- Live chat widgets
+- Cookie consent banners
+- Custom tracking pixels
+- Dynamic content injection
+- Mouse/cursor effects (trails, custom cursors, sparkles, confetti following cursor)
+- Visual effects that follow user interactions site-wide (scroll effects, parallax, particle systems)
+- **Dynamic Parameters**: Can be configured with dynamic parameters that are managed through a Dashboard Page, allowing site owners to customize the script's behavior (e.g., headlines, messages, images, timing, activation modes)
+- **When to Choose**:
+- When you need to add third-party scripts or custom code to websites
+- When you need HTML/JavaScript that runs on every page or specific placements
+- When you need configurable site-wide features that can be managed via dashboard
+- When the functionality is better suited as injected code rather than a widget
+- **MANDATORY REQUIREMENT**: EVERY EMBEDDED_SCRIPT extension MUST be paired with one DASHBOARD_PAGE extension. The dashboard page is required to manage the script's configuration, settings, and dynamic parameters (e.g., countdown end date, popup message, tracking IDs, API keys, enable/disable toggles)
+- **CONSTRAINT**: An app can contain only ONE embedded script extension. Multiple embedded scripts are not supported.
+</embedded_script>`;
+    };
+    exports2.getEmbeddedScriptAgentDocumentation = getEmbeddedScriptAgentDocumentation;
+    var getEmbeddedScriptDecisionGuide = () => {
+      return `### Choose Embedded Scripts when:
+
+- \u2705 Integrating third-party analytics or tracking (Google Analytics, Mixpanel, Facebook Pixel)
+- \u2705 Adding external JavaScript libraries
+- \u2705 Need code to run on every page or at specific DOM positions
+- \u2705 Implementing advertising or social media widgets
+- \u2705 Creating site-wide features like popups, banners, or notifications
+- \u2705 Building countdown timers for events or promotions
+- \u2705 Need configurable parameters managed through a dashboard
+- \u2705 Implementing cookie consent or GDPR compliance features
+- \u2705 Adding live chat or customer support widgets
+- \u2705 When HTML/JavaScript injection is more suitable than a widget component
+- \u2705 Pair with DASHBOARD_PAGE when configuration/management is needed
+- \u2705 **Creating mouse/cursor effects (trails, sparkles, confetti, custom cursors)**
+- \u2705 **Visual effects that follow user interactions site-wide (not contained to a specific area)**
+- \u2705 **Any effect that needs to work globally across the entire page/site**`;
+    };
+    exports2.getEmbeddedScriptDecisionGuide = getEmbeddedScriptDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/EditorReactComponentAgent.js
+var require_EditorReactComponentAgent = __commonJS({
+  "../codegen-common-logic/dist/extensions/EditorReactComponentAgent.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getEditorReactComponentDecisionGuide = exports2.getEditorReactComponentAgentDocumentation = void 0;
+    var getEditorReactComponentAgentDocumentation = () => {
+      return `<editor_react_component>
+#### Editor React Components
+
+- **Description**: React components that work out-of-the-box in Wix sites. ONLY if React is EXPLICITLY requested.
+- **Use Cases**:
+- Interactive components with React
+- Custom forms with React
+- Data displays with React
+- Third-party service integrations with React
+- Custom calculators or tools with React
+- Counter components with React
+- Countdown components with React
+- **When to Choose**: ONLY when React is EXPLICITLY requested by the user AND you need to add functionality to Wix sites for Wix site visitors by writing React code. If React is not explicitly mentioned, choose Custom Element Widgets instead
+</editor_react_component>`;
+    };
+    exports2.getEditorReactComponentAgentDocumentation = getEditorReactComponentAgentDocumentation;
+    var getEditorReactComponentDecisionGuide = () => {
+      return `### Choose Editor React Components when:
+
+- \u2705 React is EXPLICITLY requested by the user
+- \u2705 Creating reusable page components with React
+- \u2705 Building interactive site elements with React
+- \u2705 Need configurable widgets for site builders with React
+- \u2705 Want to provide drag-and-drop functionality with React
+- \u2705 Need to add functionality to Wix sites for site visitors using React`;
+    };
+    exports2.getEditorReactComponentDecisionGuide = getEditorReactComponentDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/SitePluginAgent.js
+var require_SitePluginAgent = __commonJS({
+  "../codegen-common-logic/dist/extensions/SitePluginAgent.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getSitePluginDecisionGuide = exports2.getSitePluginAgentDocumentation = void 0;
+    var getSitePluginAgentDocumentation = () => {
+      return `<site_plugin>
+#### Site Plugins
+
+- **Description**: Custom elements rendered in predefined slots within Wix business solution pages (e.g., Wix Stores product pages, Wix Bookings service pages, Wix eCommerce checkout). Site plugins use native HTMLElement custom elements (not React).
+- **Use Cases**:
+- Product page enhancements (e.g., best seller badges, product reviews summary)
+- Booking page extensions (e.g., custom confirmation messages, appointment insights)
+- eCommerce slot integrations (e.g., checkout upsells, side cart additions)
+- Event page custom content
+- Blog post page enhancements
+- **Slot System**: Site plugins are placed in predefined slots within existing Wix business solution pages. Each slot is identified by an appDefinitionId, widgetId, and slotId. Site owners can add plugins to slots using the plugin explorer in Wix editors.
+- **Settings Panel**: Site plugins have a built-in settings panel in the Wix Editor for per-instance configuration using widget.getProp/setProp. Similar to Site Widgets, the panel handles configuration without needing a separate Dashboard Page. **Exception: Checkout page and side cart plugins may not support automatic addition upon installation \u2014 these MUST include a Dashboard Page for plugin placement management.**
+- **When to Choose**: When you need to extend existing Wix business solution pages (Stores, Bookings, eCommerce, Events, Blog) with custom UI in predefined slot positions. Unlike Site Widgets (which can be placed anywhere), Site Plugins are designed for specific integration points within Wix business apps.
+
+**Common Placement Areas:**
+- Product pages (Wix Stores)
+- Checkout and side cart (Wix eCommerce)
+- Booking and service pages (Wix Bookings)
+- Event pages (Wix Events)
+- Blog post pages (Wix Blog)
+
+**Key Differences from Site Widgets:**
+- Site Plugins go into predefined slots in business solution pages; Site Widgets can be placed anywhere on a site
+- Site Plugins integrate contextually with existing business app pages; Site Widgets are standalone components
+</site_plugin>`;
+    };
+    exports2.getSitePluginAgentDocumentation = getSitePluginAgentDocumentation;
+    var getSitePluginDecisionGuide = () => {
+      return `### Choose Site Plugins when:
+
+- \u2705 Need to extend existing Wix business solution pages (Stores, Bookings, eCommerce, Events, Blog)
+- \u2705 Want to add contextual UI to predefined slots within business app pages
+- \u2705 Building product page enhancements, booking page extensions, or checkout integrations
+- \u2705 Need to integrate with the specific page context (e.g., current product, current booking)
+- \u2705 Want to leverage the slot-based plugin explorer for site owners
+- \u26A0\uFE0F If targeting checkout or side cart slots, ALSO include a DASHBOARD_PAGE for plugin placement management (auto-add may not work for these slots)`;
+    };
+    exports2.getSitePluginDecisionGuide = getSitePluginDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/SiteExtensions.js
+var require_SiteExtensions = __commonJS({
+  "../codegen-common-logic/dist/extensions/SiteExtensions.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getSiteExtensionsDocumentation = void 0;
+    var EmbeddedScriptAgent_1 = require_EmbeddedScriptAgent();
+    var EditorReactComponentAgent_1 = require_EditorReactComponentAgent();
+    var CustomElementWidgetAgent_1 = require_CustomElementWidgetAgent();
+    var SitePluginAgent_1 = require_SitePluginAgent();
+    var getSiteExtensionsDocumentation = () => {
+      return `### Site Extensions
+
+Site extensions add functionality directly to user websites.
+
+${(0, EmbeddedScriptAgent_1.getEmbeddedScriptAgentDocumentation)()}
+
+${(0, EditorReactComponentAgent_1.getEditorReactComponentAgentDocumentation)()}
+
+${(0, CustomElementWidgetAgent_1.getCustomElementWidgetAgentDocumentation)()}
+
+${(0, SitePluginAgent_1.getSitePluginAgentDocumentation)()}`;
+    };
+    exports2.getSiteExtensionsDocumentation = getSiteExtensionsDocumentation;
+  }
+});
+
+// ../codegen-common-logic/dist/extensions/DashboardModals.js
+var require_DashboardModals = __commonJS({
+  "../codegen-common-logic/dist/extensions/DashboardModals.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getDashboardModalsDecisionGuide = exports2.getDashboardModalsAgentDocumentation = void 0;
+    var getDashboardModalsAgentDocumentation = () => {
+      return `<dashboard_modals>
+#### Dashboard Modals
+- **Description**: Pop-up windows that appear in the center of dashboard pages
+- **Use Cases**:
+  - Login/signup forms
+  - Confirmation dialogs
+  - Settings panels
+  - Terms and conditions
+  - Quick data entry forms
+- **When to Choose**: When you need temporary overlays for user interactions or confirmations
+</dashboard_modals>`;
+    };
+    exports2.getDashboardModalsAgentDocumentation = getDashboardModalsAgentDocumentation;
+    var getDashboardModalsDecisionGuide = () => {
+      return `### Choose Dashboard Modals when:
+
+- \u2705 Need temporary user interactions
+- \u2705 Creating forms or confirmation dialogs
+- \u2705 Want reusable pop-up functionality
+- \u2705 Need centered, focused user attention`;
+    };
+    exports2.getDashboardModalsDecisionGuide = getDashboardModalsDecisionGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/extensionsDecisionGuide.js
+var require_extensionsDecisionGuide = __commonJS({
+  "../codegen-common-logic/dist/extensionsDecisionGuide.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getExtensionDecisionMatrix = void 0;
+    var DashboardPageAgent_1 = require_DashboardPageAgent();
+    var DashboardPlugins_1 = require_DashboardPlugins();
+    var DashboardMenuPlugins_1 = require_DashboardMenuPlugins();
+    var EmbeddedScriptAgent_1 = require_EmbeddedScriptAgent();
+    var EditorReactComponentAgent_1 = require_EditorReactComponentAgent();
+    var CustomElementWidgetAgent_1 = require_CustomElementWidgetAgent();
+    var BackendApiAgent_1 = require_BackendApiAgent();
+    var BackendEventAgent_1 = require_BackendEventAgent();
+    var SPIAgent_1 = require_SPIAgent();
+    var SitePluginAgent_1 = require_SitePluginAgent();
+    var DataCollectionAgent_1 = require_DataCollectionAgent();
+    var getExtensionDecisionMatrix = () => {
+      return `## Decision Matrix
+  ${(0, DashboardPageAgent_1.getDashboardPageDecisionGuide)()}
+
+  ${(0, DashboardPlugins_1.getDashboardPluginsDecisionGuide)()}
+
+  ${(0, DashboardMenuPlugins_1.getDashboardMenuPluginsDecisionGuide)()}
+
+  ${(0, EmbeddedScriptAgent_1.getEmbeddedScriptDecisionGuide)()}
+
+  ${(0, CustomElementWidgetAgent_1.getCustomElementWidgetDecisionGuide)()}
+
+  ${(0, EditorReactComponentAgent_1.getEditorReactComponentDecisionGuide)()}
+
+  ${(0, SitePluginAgent_1.getSitePluginDecisionGuide)()}
+
+  ${(0, BackendApiAgent_1.getBackendApiDecisionGuide)()}
+
+  ${(0, BackendEventAgent_1.getBackendEventDecisionGuide)()}
+
+  ${(0, SPIAgent_1.getSPIDecisionGuide)()}
+
+  ${(0, DataCollectionAgent_1.getDataCollectionDecisionGuide)()}`;
+    };
+    exports2.getExtensionDecisionMatrix = getExtensionDecisionMatrix;
+  }
+});
+
+// ../codegen-common-logic/dist/commonUseCasesGuide.js
+var require_commonUseCasesGuide = __commonJS({
+  "../codegen-common-logic/dist/commonUseCasesGuide.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getCommonUseCasesGuide = void 0;
+    var getCommonUseCasesGuide = () => {
+      const baseRows = `| Analytics tracking            | Embedded Scripts             | Site-wide injection                    | Perfect for third-party code injection |
+| Site-wide popups              | Embedded Scripts             | Site-wide injection                    | Configurable overlays with dashboard control |
+| Countdown timers              | Embedded Scripts             | Site-wide injection                    | Event countdowns with dashboard management |
+| Cookie consent banners        | Embedded Scripts             | Site-wide injection                    | GDPR compliance with customization |
+| Live chat widgets             | Embedded Scripts             | Site-wide injection                    | Third-party chat integration |
+| Custom admin dashboard        | Dashboard Pages              | Dedicated page route                   | Full control over admin interface      |
+| Site calculators/tools        | Custom Element Widgets                 | Page elements                          | Reusable, configurable components      |
+| Site components with React    | Editor React Components              | Page elements                          | Reusable, configurable React components   |
+| Automated workflows           | Backend Event                | Server-side event triggers             | React to platform events for automation |
+| Action when event occurs      | Backend Event                | Platform event handlers                | Server-side reaction to platform events |
+| Sync data on external events  | Backend Event                | Platform event handlers                | React to events for data synchronization |
+| Notify when data changes      | Backend Event                | Platform event handlers                | Send alerts when platform events fire |
+| Order notification emails     | Backend Event                | ecom.orders.onOrderCreated handler     | Send notifications when orders are placed |
+| Custom shipping rates         | Service Plugins (SPIs)       | Checkout flow integration              | Modify existing business flows         |
+| Tax calculations              | Service Plugins (SPIs)       | Checkout flow integration              | Custom tax logic integration           |
+| Custom pricing logic          | Service Plugins (SPIs)       | Platform-level integration             | Platform-level business customization  |
+| Product analytics in Stores   | Dashboard Plugins            | Wix Stores Products page slot          | Contextual widget within existing Stores dashboard |
+| Booking insights                 | Dashboard Plugins         | Wix Bookings Booking List page slot    | Contextual widget within existing Bookings dashboard |
+| Product reviews on product page | Site Plugins                | Predefined slots in product pages      | Reviews are contextually tied to each product \u2192 Site Plugin, not Custom Element Widgets |
+| Product page enhancements     | Site Plugins                 | Predefined slots in business pages     | Contextual integration with Stores, Bookings, etc. |
+| Booking page extensions       | Site Plugins                 | Predefined slots in business pages     | Extend existing Wix business solution pages |
+| Checkout upsells              | Site Plugins + Dashboard Page | Predefined slots in eCommerce pages   | Checkout/side cart plugins need Dashboard Page for plugin placement management |
+| App-specific data storage     | Data Collections             | CMS data layer                         | Structured data for app extensions to read/write |
+| Per-product fees/rules        | Dashboard Page + Service Plugin + Data Collection | Admin + checkout + data | Dashboard manages rules, Data Collection stores them, Service Plugin reads at checkout |`;
+      const comparisonGuide = `
+## Extension Comparison Guide
+
+| **Custom Element Widget vs Site Plugin** | **Service Plugin vs Backend Event** |
+| ------------------------------ | ----------------------------------- |
+| Widget: user places anywhere on site | Service Plugin: runs DURING a business flow (checkout, shipping, tax) |
+| Plugin: fixed slot in a Wix business solution page (Stores, Bookings, etc.) | Backend Event: runs AFTER a platform event occurs (order created, contact added) |
+
+| **Dashboard Page vs Embedded Script** | **Custom Element Widget vs Embedded Script** |
+| ------------------------------------- | ---------------------------------- |
+| Dashboard Page: admin-only interface for managing settings/data | Custom Element Widget: standalone component placed on page by site owner |
+| Embedded Script: code injected into every site page for visitors | Embedded Script: code injected site-wide (analytics, popups, effects) |`;
+      return `## Quick Reference for Common Use Cases
+
+| **Need**                      | **Recommended Extension**    | **Specific Slot/Location**             | **Reason**                             |
+| ----------------------------- | ---------------------------- | -------------------------------------- | -------------------------------------- |
+${baseRows}
+${comparisonGuide}`;
+    };
+    exports2.getCommonUseCasesGuide = getCommonUseCasesGuide;
+  }
+});
+
+// ../codegen-common-logic/dist/availableSdks.js
+var require_availableSdks = __commonJS({
+  "../codegen-common-logic/dist/availableSdks.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.getAvailableSdksReference = void 0;
+    var getAvailableSdksReference = () => `<available_sdks>
+## Available Wix SDKs
+
+> **Rules \u2014 must follow when an SDK from this list covers the domain:**
+> 1. **Do not create a \`DATA_COLLECTION\`** for entities the SDK manages. SDK coverage includes both *records* (e.g., point balances, bookings, subscribers) **and** *configuration the SDK exposes* (e.g., earning rules, services, plans, rewards, coupon rules). Treat the SDK as the source of truth for both.
+> 2. **Name the SDK explicitly** in the \`summary\` and in each relevant extension \`description\` (e.g., "...via the Wix Loyalty Program SDK..."). Do **not** hedge with phrases like "if using the SDK", "optionally", or "unless using Wix's built-in X" \u2014 commit to the SDK.
+> 3. If a domain is **not** in this list, a \`DATA_COLLECTION\` is appropriate.
+
+### Commerce & catalog
+
+- **Stores** \u2014 Product catalog management. Includes products (physical/digital), inventory, variants, categories, and product collections.
+- **eCommerce** \u2014 End-to-end purchase flow. Includes cart, checkout, orders, refunds, and abandoned carts. Use for any sellable line item (products, services, custom items).
+- **Bookings** \u2014 Appointment scheduling. Includes services (classes, courses, appointments), staff, schedules, sessions, and customer bookings.
+- **Restaurants** \u2014 Restaurant ordering. Includes menus, items, modifiers, and online ordering for dine-in/takeout/delivery.
+- **Pricing Plans** \u2014 Recurring billing and access control. Includes subscription plans, one-time access plans, and member benefits. Use for paywalls, memberships, and course access.
+- **Donations** \u2014 Fundraising flows. Includes one-time and recurring donations, donor records, and campaigns. Use for nonprofits.
+- **Gift Cards** \u2014 Stored-value cards. Issue, redeem, and track gift card balances and transactions.
+- **Coupons** \u2014 Discount codes. Includes percent/fixed/free-shipping rules, expiration, and usage limits.
+
+### Content
+
+- **Blog** \u2014 Content publishing. Includes posts, categories, tags, authors, and comments.
+- **Forum** \u2014 Community discussion. Includes categories, threads, replies, votes, and member activity.
+- **Events** \u2014 Event management for any time-based gathering (events, meetups, sessions, gatherings, conferences, workshops). Includes events, RSVPs, ticketing, guest lists, and check-in.
+- **Portfolio** \u2014 Project showcases for creatives and agencies. Includes projects, media galleries, and project collections.
+
+### People & engagement
+
+- **Members & Contacts** \u2014 Identity and CRM. Includes site member accounts, login state, contact records, profile fields, and labels.
+- **Forms** \u2014 Site forms. Includes form definitions and captured submissions (e.g., contact forms, lead capture, surveys).
+- **Loyalty Program** \u2014 Customer rewards. Includes points, earning rules, tiers, rewards, and customer point balances.
+- **Communication** \u2014 Outbound messaging to contacts/members. Includes triggered emails, automations, and notifications (e.g., newsletters).
+</available_sdks>`;
+    exports2.getAvailableSdksReference = getAvailableSdksReference;
+  }
+});
+
+// ../../node_modules/dedent/dist/dedent.js
+var require_dedent = __commonJS({
+  "../../node_modules/dedent/dist/dedent.js"(exports2, module2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", {
+      value: true
+    });
+    exports2.default = void 0;
+    var dedent = createDedent({});
+    var _default = exports2.default = dedent;
+    function createDedent(options) {
+      dedent2.withOptions = (newOptions) => createDedent({
+        ...options,
+        ...newOptions
+      });
+      return dedent2;
+      function dedent2(strings, ...values) {
+        const raw = typeof strings === "string" ? [strings] : strings.raw;
+        const {
+          alignValues = false,
+          escapeSpecialCharacters = Array.isArray(strings),
+          trimWhitespace = true
+        } = options;
+        let result = "";
+        for (let i = 0; i < raw.length; i++) {
+          let next = raw[i];
+          if (escapeSpecialCharacters) {
+            next = next.replace(/\\\n[ \t]*/g, "").replace(/\\`/g, "`").replace(/\\\$/g, "$").replace(/\\\{/g, "{");
+          }
+          result += next;
+          if (i < values.length) {
+            const value = alignValues ? alignValue(values[i], result) : values[i];
+            result += value;
+          }
+        }
+        const lines = result.split("\n");
+        let mindent = null;
+        for (const l of lines) {
+          const m = l.match(/^(\s+)\S+/);
+          if (m) {
+            const indent = m[1].length;
+            if (!mindent) {
+              mindent = indent;
+            } else {
+              mindent = Math.min(mindent, indent);
+            }
+          }
+        }
+        if (mindent !== null) {
+          const m = mindent;
+          result = lines.map((l) => l[0] === " " || l[0] === "	" ? l.slice(m) : l).join("\n");
+        }
+        if (trimWhitespace) {
+          result = result.trim();
+        }
+        if (escapeSpecialCharacters) {
+          result = result.replace(/\\n/g, "\n");
+        }
+        if (typeof Bun !== "undefined") {
+          result = result.replace(
+            // Matches e.g. \\u{1f60a} or \\u5F1F
+            /\\u(?:\{([\da-fA-F]{1,6})\}|([\da-fA-F]{4}))/g,
+            (_, braced, unbraced) => {
+              var _ref;
+              const hex = (_ref = braced !== null && braced !== void 0 ? braced : unbraced) !== null && _ref !== void 0 ? _ref : "";
+              return String.fromCodePoint(parseInt(hex, 16));
+            }
+          );
+        }
+        return result;
+      }
+    }
+    function alignValue(value, precedingText) {
+      if (typeof value !== "string" || !value.includes("\n")) {
+        return value;
+      }
+      const currentLine = precedingText.slice(precedingText.lastIndexOf("\n") + 1);
+      const indentMatch = currentLine.match(/^(\s+)/);
+      if (indentMatch) {
+        const indent = indentMatch[1];
+        return value.replace(/\n/g, `
+${indent}`);
+      }
+      return value;
+    }
+    module2.exports = exports2.default;
+    module2.exports.default = exports2.default;
+  }
+});
+
+// ../codegen-common-logic/dist/system-prompts/context-explanation-instructions.js
+var require_context_explanation_instructions = __commonJS({
+  "../codegen-common-logic/dist/system-prompts/context-explanation-instructions.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.contextExplanationInstructions = void 0;
+    var contextExplanationInstructionsContent = () => `The user prompt may include several context sections to help you understand what already exists and what changes are planned.
+
+**IMPORTANT**: These context sections are informational - use them ONLY if they are relevant to your specific task. You are NOT required to use collections, API specs, or embedded script parameters unless they directly support the user's request.`;
+    var buildCollectionsContext = () => `You may receive TWO types of collection information:
+
+1. **EXISTING COLLECTIONS FROM PROJECT** (if present):
+   - These are CMS collections that ALREADY EXIST in the project
+   - They represent the CURRENT STATE of the data model
+   - Use these as reference ONLY IF you need to work with existing data
+   - DO NOT modify or recreate these collections unless explicitly requested
+   - Use the exact id for the id of the collection in the code
+
+2. **COLLECTIONS** from the plan (if present):
+   - These are NEW collections to create OR existing collections to MODIFY
+   - Each has an "operation" field: "insert" (new), "update" (modify), or "delete" (remove)
+   - Follow the operation specified for each collection
+   - For "update" operations, only modify what's specified in the plan
+   - Use the exact id for the id of the collection in the code`;
+    var buildEmbeddedScriptParametersContext = () => `You may receive TWO types of embedded script parameter information:
+
+1. **EXISTING EMBEDDED SCRIPT PARAMETERS FROM PROJECT** (if present):
+   - These are dynamic parameters that ALREADY EXIST in the project
+   - They represent the CURRENT STATE of configurable parameters
+   - Use these as reference ONLY IF you need to work with dynamic parameters
+   - DO NOT modify or recreate these parameters unless explicitly requested
+
+2. **EMBEDDED SCRIPT PARAMETERS** from the plan (if present):
+   - These are NEW parameters to create OR existing parameters to DELETE
+   - Each has an "operation" field: "insert" (add/replace all parameters) or "delete" (remove specific parameters by keys)
+   - Follow the operation specified for each parameter
+   - Note: There is NO "update" operation - to modify a parameter, you'll see a delete followed by an insert
+   - DELETE operations can remove multiple parameters at once by providing an array of keys`;
+    var buildApiSpecContext = () => `If present, the **API SPEC** section describes backend API endpoints.
+- Use these ONLY IF your implementation needs to call backend APIs
+- If your task doesn't involve API calls: Ignore this section`;
+    var buildCriticalPrinciples = () => `1. **Use only what's needed**: Don't force collections, APIs, or parameters into your implementation if they're not relevant to the user's request
+2. **Respect existing resources**: The presence of EXISTING resources does NOT mean you should modify them. Only modify when:
+   - The plan explicitly includes an "update" operation for that resource
+   - The user request explicitly asks for modifications to that resource
+   - The existing resource is insufficient for the new functionality being added
+3. **Keep it simple**: When in doubt, use existing resources as-is rather than modifying them, or don't use them at all if they're not needed
+
+Your goal is to implement EXACTLY what the user requested - no more, no less.`;
+    exports2.contextExplanationInstructions = {
+      content: contextExplanationInstructionsContent(),
+      collectionsContext: buildCollectionsContext(),
+      embeddedScriptParametersContext: buildEmbeddedScriptParametersContext(),
+      apiSpecContext: buildApiSpecContext(),
+      criticalPrinciples: buildCriticalPrinciples()
+    };
+  }
+});
+
+// ../codegen-common-logic/dist/system-prompts/context-explanation-prompt.js
+var require_context_explanation_prompt = __commonJS({
+  "../codegen-common-logic/dist/system-prompts/context-explanation-prompt.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.contextExplanationSystemPrompt = void 0;
+    var SystemPromptBuilder_1 = require_SystemPromptBuilder();
+    var context_explanation_instructions_1 = require_context_explanation_instructions();
+    var contextExplanationSystemPrompt = ({ apiDocumentation, useData, useIteration, useEmbeddedScript }) => {
+      const contextExplanationSystemPrompt2 = (0, SystemPromptBuilder_1.systemPromptBuilder)({
+        apiDocumentation,
+        useData,
+        useIteration,
+        useEmbeddedScript
+      });
+      contextExplanationSystemPrompt2.withSection("instructions", context_explanation_instructions_1.contextExplanationInstructions.content);
+      if (useData) {
+        contextExplanationSystemPrompt2.withSection("collections_context", context_explanation_instructions_1.contextExplanationInstructions.collectionsContext);
+      }
+      if (useEmbeddedScript) {
+        contextExplanationSystemPrompt2.withSection("embedded_script_parameters_context", context_explanation_instructions_1.contextExplanationInstructions.embeddedScriptParametersContext);
+      }
+      contextExplanationSystemPrompt2.withSection("api_spec_context", context_explanation_instructions_1.contextExplanationInstructions.apiSpecContext);
+      contextExplanationSystemPrompt2.withSection("critical_principles", context_explanation_instructions_1.contextExplanationInstructions.criticalPrinciples);
+      return contextExplanationSystemPrompt2.compose();
+    };
+    exports2.contextExplanationSystemPrompt = contextExplanationSystemPrompt;
+  }
+});
+
+// ../codegen-common-logic/dist/system-prompts/SystemPromptBuilder.js
+var require_SystemPromptBuilder = __commonJS({
+  "../codegen-common-logic/dist/system-prompts/SystemPromptBuilder.js"(exports2) {
+    "use strict";
+    var __importDefault2 = exports2 && exports2.__importDefault || function(mod) {
+      return mod && mod.__esModule ? mod : { "default": mod };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.systemPromptBuilder = exports2.SystemPromptBuilder = exports2.GeneralAgentType = exports2.CommonSections = void 0;
+    var dedent_1 = __importDefault2(require_dedent());
+    var context_explanation_prompt_1 = require_context_explanation_prompt();
+    var CommonSections;
+    (function(CommonSections2) {
+      CommonSections2["ROLE"] = "role";
+      CommonSections2["OUTPUT_CONSTRAINTS"] = "output_constraints";
+      CommonSections2["CONTEXT_EXPLANATION"] = "context_explanation";
+      CommonSections2["CORE_PRINCIPLES"] = "core_principles";
+      CommonSections2["CORE_KNOWLEDGE"] = "core_knowledge";
+      CommonSections2["IMPLEMENTATION_PATTERNS"] = "implementation_patterns";
+      CommonSections2["IMPLEMENTATION_GUIDELINES"] = "implementation_guidelines";
+      CommonSections2["AUTHENTICATION_ELEVATION_REQUIREMENT"] = "authentication_elevation_requirement";
+      CommonSections2["API_DOCS"] = "api_docs";
+      CommonSections2["EXAMPLES"] = "examples";
+    })(CommonSections || (exports2.CommonSections = CommonSections = {}));
+    var SECTION_ORDER = {
+      [CommonSections.ROLE]: 1,
+      [CommonSections.CONTEXT_EXPLANATION]: 2,
+      [CommonSections.CORE_PRINCIPLES]: 3,
+      [CommonSections.OUTPUT_CONSTRAINTS]: 4,
+      [CommonSections.CORE_KNOWLEDGE]: 5,
+      [CommonSections.IMPLEMENTATION_PATTERNS]: 6,
+      [CommonSections.IMPLEMENTATION_GUIDELINES]: 7,
+      [CommonSections.AUTHENTICATION_ELEVATION_REQUIREMENT]: 8,
+      [CommonSections.API_DOCS]: 9,
+      [CommonSections.EXAMPLES]: 10
+    };
+    var GeneralAgentType;
+    (function(GeneralAgentType2) {
+      GeneralAgentType2["CMS_PLANNER"] = "CMS_PLANNER";
+      GeneralAgentType2["PLANNER"] = "PLANNER";
+      GeneralAgentType2["ITERATION_AGENT"] = "ITERATION_AGENT";
+      GeneralAgentType2["AUTO_PATTERN_DECISION"] = "AUTO_PATTERN_DECISION";
+      GeneralAgentType2["AUTO_PATTERN_CONTEXT"] = "AUTO_PATTERN_CONTEXT";
+      GeneralAgentType2["SDK_PICKER"] = "SDK_PICKER";
+      GeneralAgentType2["EXTENSION_INDEXER"] = "EXTENSION_INDEXER";
+      GeneralAgentType2["UPDATE_EXTENSION_AGENT"] = "UPDATE_EXTENSION_AGENT";
+    })(GeneralAgentType || (exports2.GeneralAgentType = GeneralAgentType = {}));
+    var toPromptTag = (fromPromptType) => {
+      return `${fromPromptType}_PROMPT`;
+    };
+    var SystemPromptBuilder = class {
+      constructor({ agentType, apiDocumentation = "", useData = true, useIteration = false, useEmbeddedScript = false }) {
+        this.sections = {};
+        this.agentType = agentType;
+        this.apiDocumentation = apiDocumentation;
+        this.useData = useData;
+        this.useIteration = useIteration;
+        this.useEmbeddedScript = useEmbeddedScript;
+      }
+      withSection(tag, content) {
+        this.sections[tag] = content;
+        return this;
+      }
+      withRole(content) {
+        this.withSection(CommonSections.ROLE, content);
+        return this;
+      }
+      withImplementationPatterns(content) {
+        this.withSection(CommonSections.IMPLEMENTATION_PATTERNS, content);
+        return this;
+      }
+      withImplementationGuidelines(content) {
+        this.withSection(CommonSections.IMPLEMENTATION_GUIDELINES, content);
+        return this;
+      }
+      withCoreKnowledge(content) {
+        this.withSection(CommonSections.CORE_KNOWLEDGE, content);
+        return this;
+      }
+      withExamples(content) {
+        this.withSection(CommonSections.EXAMPLES, content);
+        return this;
+      }
+      withContextExplanation() {
+        const content = (0, context_explanation_prompt_1.contextExplanationSystemPrompt)({
+          agentType: void 0,
+          apiDocumentation: this.apiDocumentation,
+          useData: this.useData,
+          useIteration: this.useIteration,
+          useEmbeddedScript: this.useEmbeddedScript
+        });
+        this.withSection(CommonSections.CONTEXT_EXPLANATION, content);
+        return this;
+      }
+      compose() {
+        const sections = this.formatSections();
+        if (!this.agentType) {
+          return sections;
+        }
+        const promptTag = toPromptTag(this.agentType);
+        return (0, dedent_1.default)`<${promptTag}>\n${sections}\n</${promptTag}>`;
+      }
+      formatSections() {
+        const formatted = [];
+        const orderedSections = Object.entries(SECTION_ORDER).sort((a, b) => a[1] - b[1]).map(([key]) => key);
+        for (const section of orderedSections) {
+          const content = this.sections[section];
+          if (content) {
+            formatted.push(`
+<${section}>
+${content}
+</${section}>`);
+          }
+        }
+        const remainingSections = Object.keys(this.sections).filter((section) => !(section in SECTION_ORDER) && this.sections[section]).sort();
+        for (const section of remainingSections) {
+          formatted.push(`
+<${section}>
+${this.sections[section]}
+</${section}>`);
+        }
+        return formatted.join("\n");
+      }
+    };
+    exports2.SystemPromptBuilder = SystemPromptBuilder;
+    var systemPromptBuilder = (params) => {
+      return new SystemPromptBuilder(params);
+    };
+    exports2.systemPromptBuilder = systemPromptBuilder;
+  }
+});
+
+// ../codegen-common-logic/dist/system-prompts/index.js
+var require_system_prompts = __commonJS({
+  "../codegen-common-logic/dist/system-prompts/index.js"(exports2) {
+    "use strict";
+    var __createBinding2 = exports2 && exports2.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    }) : (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __exportStar2 = exports2 && exports2.__exportStar || function(m, exports3) {
+      for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports3, p)) __createBinding2(exports3, m, p);
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    __exportStar2(require_SystemPromptBuilder(), exports2);
+    __exportStar2(require_context_explanation_prompt(), exports2);
+    __exportStar2(require_context_explanation_instructions(), exports2);
+  }
+});
+
+// ../codegen-common-logic/dist/site-data-layer-rules.js
 var require_site_data_layer_rules = __commonJS({
-  "../codegen-studio-2-config/dist/site-data-layer-rules.js"(exports2) {
+  "../codegen-common-logic/dist/site-data-layer-rules.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.SITE_DATA_LAYER_RULES = void 0;
@@ -12197,17 +13352,80 @@ For any persistent-data need (CMS collections, tables, schemas, data models):
   }
 });
 
-// ../codegen-studio-2-config/dist/index.js
+// ../codegen-common-logic/dist/index.js
 var require_dist7 = __commonJS({
+  "../codegen-common-logic/dist/index.js"(exports2) {
+    "use strict";
+    var __createBinding2 = exports2 && exports2.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      var desc = Object.getOwnPropertyDescriptor(m, k);
+      if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+        desc = { enumerable: true, get: function() {
+          return m[k];
+        } };
+      }
+      Object.defineProperty(o, k2, desc);
+    }) : (function(o, m, k, k2) {
+      if (k2 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __exportStar2 = exports2 && exports2.__exportStar || function(m, exports3) {
+      for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports3, p)) __createBinding2(exports3, m, p);
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    __exportStar2(require_BackendApiAgent(), exports2);
+    __exportStar2(require_BackendEventAgent(), exports2);
+    __exportStar2(require_BackendExtensions(), exports2);
+    __exportStar2(require_CustomElementWidgetAgent(), exports2);
+    __exportStar2(require_DashboardPageAgent(), exports2);
+    __exportStar2(require_DashboardExtensions(), exports2);
+    __exportStar2(require_EmbeddedScriptAgent(), exports2);
+    __exportStar2(require_EditorReactComponentAgent(), exports2);
+    __exportStar2(require_SiteExtensions(), exports2);
+    __exportStar2(require_SPIAgent(), exports2);
+    __exportStar2(require_DashboardPlugins(), exports2);
+    __exportStar2(require_DashboardMenuPlugins(), exports2);
+    __exportStar2(require_DashboardModals(), exports2);
+    __exportStar2(require_SitePluginAgent(), exports2);
+    __exportStar2(require_DataCollectionAgent(), exports2);
+    __exportStar2(require_extensionsDecisionGuide(), exports2);
+    __exportStar2(require_commonUseCasesGuide(), exports2);
+    __exportStar2(require_availableSdks(), exports2);
+    __exportStar2(require_system_prompts(), exports2);
+    __exportStar2(require_site_data_layer_rules(), exports2);
+  }
+});
+
+// ../codegen-studio-2-config/dist/index.js
+var require_dist8 = __commonJS({
   "../codegen-studio-2-config/dist/index.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.studio2CodegenConfig = void 0;
     var codegen_checkpoint_plugin_1 = require_dist6();
-    var site_data_layer_rules_1 = require_site_data_layer_rules();
+    var codegen_common_logic_1 = require_dist7();
     exports2.studio2CodegenConfig = {
       codegenRules: [
-        { filename: "site-data-layer-rules.md", content: site_data_layer_rules_1.SITE_DATA_LAYER_RULES }
+        { filename: "site-data-layer-rules.md", content: codegen_common_logic_1.SITE_DATA_LAYER_RULES }
+      ],
+      askRules: [],
+      decisionCheckers: [],
+      plugins: [codegen_checkpoint_plugin_1.checkpointPluginFactory]
+    };
+  }
+});
+
+// ../codegen-harmony-config/dist/index.js
+var require_dist9 = __commonJS({
+  "../codegen-harmony-config/dist/index.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.harmonyCodegenConfig = void 0;
+    var codegen_checkpoint_plugin_1 = require_dist6();
+    var codegen_common_logic_1 = require_dist7();
+    exports2.harmonyCodegenConfig = {
+      codegenRules: [
+        { filename: "site-data-layer-rules.md", content: codegen_common_logic_1.SITE_DATA_LAYER_RULES }
       ],
       askRules: [],
       decisionCheckers: [],
@@ -12295,8 +13513,8 @@ Example: \`required-permissions({ permissions: ["SCOPE.DC-DATA.READ", "SCOPE.DC-
 
 USER ACTIONS:
 After the final \`validate\` pass and before you Stop, call the \`user-actions\` tool ONCE ONLY if the app needs the user to perform manual setup for it to ACTUALLY WORK. This includes setup OUTSIDE Wix (third-party API keys, connecting an external account, registering a webhook elsewhere) AND setup INSIDE Wix that you could not do in code (e.g. creating a Wix Triggered Email template, configuring a Wix Automation, adding a value in Secrets Manager). If there is no such setup, do NOT call the tool at all.
-Pass the steps in the \`output\` arg as a single markdown string \u2014 it is rendered directly to the user, so keep it concise and user-facing (a short intro line followed by a bulleted or numbered list). Example:
-"After installing the app, complete these steps:\\n\\n1. **Add your Stripe secret key** \u2014 open the app's settings and paste your Stripe secret key.\\n2. **Create the stock-alert email template** \u2014 in your Wix dashboard, create a Triggered Email template so subscribers receive the alert email."
+Pass the steps in the \`output\` arg as a single markdown string \u2014 it is rendered directly to the user, so keep it concise and user-facing (a short intro line followed by a bulleted or numbered list). FORMAT IT TIGHTLY: use a SINGLE newline (\`\\n\`) everywhere \u2014 between the intro line and the first item AND between items. Do NOT use blank lines (\`\\n\\n\`) anywhere. Blank lines make the client render each item on its own line with extra spacing. Example:
+"After installing the app, complete these steps:\\n1. **Add your Stripe secret key** \u2014 open the app's settings and paste your Stripe secret key.\\n2. **Create the stock-alert email template** \u2014 in your Wix dashboard, create a Triggered Email template so subscribers receive the alert email."
 
 AUDIENCE \u2014 be explicit about WHO performs each step. Two audiences exist: (1) the APP DEVELOPER (working in Dev Center / the app's own settings), and (2) the SITE OWNER who INSTALLS the app on their site (the merchant with the real Stripe account, their own Wix dashboard, etc.). Most third-party credentials and dashboard setup (their API key, creating a Triggered Email template in their dashboard, configuring an automation) are done by the INSTALLING site owner \u2014 not the developer. When a step is for the installing user, phrase it that way: start it with "After installing the app, \u2026" or "The site owner must \u2026", so it's clear it happens post-install on the installer's site. Use developer-facing phrasing only for steps the developer genuinely performs.
 
@@ -12314,7 +13532,7 @@ Do NOT include the steps Wix already handles through its own flows:
 - Publishing the site.
 Also do NOT include things you already did in code (created files, registered extensions) or things the app does automatically on install. In particular, a site plugin configured with \`installation: { autoAdd: true }\` is placed on its slot automatically \u2014 NEVER tell the user to add it in the Editor. Only declare manual placement for slots that don't support auto-add (e.g. the checkout page).
 
-Example: \`user-actions({ output: "To finish setting up your app:\\n\\n1. **Add your Stripe secret key** \u2014 open the app settings and paste it." })\``;
+Example: \`user-actions({ output: "To finish setting up your app:\\n1. **Add your Stripe secret key** \u2014 open the app settings and paste it." })\``;
   }
 });
 
@@ -12457,7 +13675,8 @@ var require_environments = __commonJS({
     exports2.getCodegenEnvironmentConfig = getCodegenEnvironmentConfig;
     var types_1 = require_types_impl();
     var codegen_app_builder_config_1 = require_dist5();
-    var codegen_studio_2_config_1 = require_dist7();
+    var codegen_studio_2_config_1 = require_dist8();
+    var codegen_harmony_config_1 = require_dist9();
     var codegen_rules_1 = require_codegen_rules();
     var ask_rules_1 = require_ask_rules();
     var job_decision_manager_1 = require_job_decision_manager();
@@ -12479,6 +13698,8 @@ var require_environments = __commonJS({
       switch (process.env.CODEGEN_ENVIRONMENT) {
         case types_1.Environment.STUDIO_2:
           return withSharedRules(codegen_studio_2_config_1.studio2CodegenConfig);
+        case types_1.Environment.HARMONY:
+          return withSharedRules(codegen_harmony_config_1.harmonyCodegenConfig);
         case types_1.Environment.APP_BUILDER:
         default:
           return withSharedRules({
@@ -16105,7 +17326,7 @@ var require_bi_logger_factory = __commonJS({
 });
 
 // ../../node_modules/@wix/wix-bi-logger-client/dist/index.js
-var require_dist8 = __commonJS({
+var require_dist10 = __commonJS({
   "../../node_modules/@wix/wix-bi-logger-client/dist/index.js"(exports2, module2) {
     "use strict";
     var BiLoggerClientFactory = require_bi_logger_factory();
@@ -18705,7 +19926,7 @@ var require_src2 = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.StandaloneNodeLogger = void 0;
     var tslib_1 = (init_tslib_es6(), __toCommonJS(tslib_es6_exports));
-    var wix_bi_logger_client_1 = tslib_1.__importDefault(require_dist8());
+    var wix_bi_logger_client_1 = tslib_1.__importDefault(require_dist10());
     var http_client_1 = require_index_node2();
     var defaultOptions = {
       baseUrl: process.env.BI_BASE_URL || "https://frog.wix.com",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.364",
+  "version": "1.0.366",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -29,5 +29,5 @@
     "esbuild": "^0.27.2",
     "vitest": "^4.0.16"
   },
-  "falconPackageHash": "d3f73d5ef81d405259fbb65db9cd00e9d67193b0aec3a09b82a69337"
+  "falconPackageHash": "fcb0cf778e55a780aca1cac6efea4c192f6bfc82a53a21a0068e72de"
 }