@wix/ditto-codegen-public 1.0.246 → 1.0.247

package/dist/out.js

@@ -70075,6 +70075,41 @@ var require_SPIAgent = __commonJS({
   }
 });
 
+// ../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`;
+    };
+    exports2.getDataCollectionDecisionGuide = getDataCollectionDecisionGuide;
+  }
+});
+
 // ../codegen-common-logic/dist/extensions/BackendExtensions.js
 var require_BackendExtensions = __commonJS({
   "../codegen-common-logic/dist/extensions/BackendExtensions.js"(exports2) {
@@ -70084,7 +70119,8 @@ var require_BackendExtensions = __commonJS({
     var BackendApiAgent_1 = require_BackendApiAgent();
     var BackendEventAgent_1 = require_BackendEventAgent();
     var SPIAgent_1 = require_SPIAgent();
-    var getBackendExtensionsDocumentation = () => {
+    var DataCollectionAgent_1 = require_DataCollectionAgent();
+    var getBackendExtensionsDocumentation = (options) => {
       return `### Backend Extensions
 
   Backend extensions provide server-side functionality.
@@ -70093,7 +70129,9 @@ var require_BackendExtensions = __commonJS({
 
   ${(0, BackendEventAgent_1.getBackendEventAgentDocumentation)()}
 
-  ${(0, SPIAgent_1.getSPIAgentDocumentation)()}`;
+  ${(0, SPIAgent_1.getSPIAgentDocumentation)()}${options?.enableNewExtensions ? `
+
+  ${(0, DataCollectionAgent_1.getDataCollectionAgentDocumentation)()}` : ""}`;
     };
     exports2.getBackendExtensionsDocumentation = getBackendExtensionsDocumentation;
   }
@@ -70105,7 +70143,8 @@ var require_CustomElementAgent = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.getSiteWidgetDecisionGuide = exports2.getCustomElementAgentDocumentation = void 0;
-    var getCustomElementAgentDocumentation = () => {
+    var getCustomElementAgentDocumentation = (options) => {
+      const whenToChoose = options?.enableNewExtensions ? `- **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.` : `- **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 all site functionality.`;
       return `<site_widget>
 #### Site Widgets
 
@@ -70127,12 +70166,13 @@ var require_CustomElementAgent = __commonJS({
   - 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 all site functionality.
+${whenToChoose}
 - **IMPORTANT**: Do NOT pair Site Widgets with a Dashboard Page unless the user explicitly requests shared/centralized configuration management. The widget panel handles per-instance configuration.
 </site_widget>`;
     };
     exports2.getCustomElementAgentDocumentation = getCustomElementAgentDocumentation;
-    var getSiteWidgetDecisionGuide = () => {
+    var getSiteWidgetDecisionGuide = (options) => {
+      const defaultChoice = options?.enableNewExtensions ? `- \u2705 **DEFAULT choice for site functionality not tied to a Wix business solution page**` : `- \u2705 **DEFAULT choice for all site functionality**`;
       return `### Choose Site Widgets when:
 
 - \u2705 Creating reusable page components
@@ -70140,7 +70180,7 @@ var require_CustomElementAgent = __commonJS({
 - \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 all site functionality**
+${defaultChoice}
 
 ### Site Widget Panel vs Dashboard Page:
 - \u2705 Use the **built-in widget panel** for per-instance configuration (text, dates, styles, toggles) - NO Dashboard Page needed
@@ -70297,6 +70337,53 @@ var require_SiteComponentAgent = __commonJS({
   }
 });
 
+// ../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.
+- **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`;
+    };
+    exports2.getSitePluginDecisionGuide = getSitePluginDecisionGuide;
+  }
+});
+
 // ../codegen-common-logic/dist/extensions/SiteExtensions.js
 var require_SiteExtensions = __commonJS({
   "../codegen-common-logic/dist/extensions/SiteExtensions.js"(exports2) {
@@ -70306,7 +70393,8 @@ var require_SiteExtensions = __commonJS({
     var EmbeddedScriptAgent_1 = require_EmbeddedScriptAgent();
     var SiteComponentAgent_1 = require_SiteComponentAgent();
     var CustomElementAgent_1 = require_CustomElementAgent();
-    var getSiteExtensionsDocumentation = () => {
+    var SitePluginAgent_1 = require_SitePluginAgent();
+    var getSiteExtensionsDocumentation = (options) => {
       return `### Site Extensions
 
 Site extensions add functionality directly to user websites.
@@ -70315,7 +70403,9 @@ ${(0, EmbeddedScriptAgent_1.getEmbeddedScriptAgentDocumentation)()}
 
 ${(0, SiteComponentAgent_1.getSiteComponentAgentDocumentation)()}
 
-${(0, CustomElementAgent_1.getCustomElementAgentDocumentation)()}`;
+${(0, CustomElementAgent_1.getCustomElementAgentDocumentation)(options)}${options?.enableNewExtensions ? `
+
+${(0, SitePluginAgent_1.getSitePluginAgentDocumentation)()}` : ""}`;
     };
     exports2.getSiteExtensionsDocumentation = getSiteExtensionsDocumentation;
   }
@@ -70397,7 +70487,7 @@ var require_DashboardMenuPlugins = __commonJS({
   "../codegen-common-logic/dist/extensions/DashboardMenuPlugins.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.getDashboardMenuPluginsAgentDocumentation = void 0;
+    exports2.getDashboardMenuPluginsDecisionGuide = exports2.getDashboardMenuPluginsAgentDocumentation = void 0;
     var getDashboardMenuPluginsAgentDocumentation = () => {
       return `<dashboard_menu_plugins>
 #### Dashboard Menu Plugins
@@ -70411,6 +70501,15 @@ var require_DashboardMenuPlugins = __commonJS({
 </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;
   }
 });
 
@@ -70459,21 +70558,27 @@ var require_extensionsDecisionGuide = __commonJS({
     var BackendApiAgent_1 = require_BackendApiAgent();
     var BackendEventAgent_1 = require_BackendEventAgent();
     var SPIAgent_1 = require_SPIAgent();
-    var getExtensionDecisionMatrix = () => {
+    var SitePluginAgent_1 = require_SitePluginAgent();
+    var DataCollectionAgent_1 = require_DataCollectionAgent();
+    var getExtensionDecisionMatrix = (options) => {
       return `## Decision Matrix
   ${(0, DashboardPageAgent_1.getDashboardPageDecisionGuide)()}
 
   ${(0, EmbeddedScriptAgent_1.getEmbeddedScriptDecisionGuide)()}
 
-  ${(0, CustomElementAgent_1.getSiteWidgetDecisionGuide)()}
+  ${(0, CustomElementAgent_1.getSiteWidgetDecisionGuide)(options)}
 
-  ${(0, SiteComponentAgent_1.getSiteComponentDecisionGuide)()}
+  ${(0, SiteComponentAgent_1.getSiteComponentDecisionGuide)()}${options?.enableNewExtensions ? `
+
+  ${(0, SitePluginAgent_1.getSitePluginDecisionGuide)()}` : ""}
 
   ${(0, BackendApiAgent_1.getBackendApiDecisionGuide)()}
 
   ${(0, BackendEventAgent_1.getBackendEventDecisionGuide)()}
 
-  ${(0, SPIAgent_1.getSPIDecisionGuide)()}`;
+  ${(0, SPIAgent_1.getSPIDecisionGuide)()}${options?.enableNewExtensions ? `
+
+  ${(0, DataCollectionAgent_1.getDataCollectionDecisionGuide)()}` : ""}`;
     };
     exports2.getExtensionDecisionMatrix = getExtensionDecisionMatrix;
   }
@@ -70485,12 +70590,8 @@ var require_commonUseCasesGuide = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.getCommonUseCasesGuide = void 0;
-    var getCommonUseCasesGuide = () => {
-      return `## Quick Reference for Common Use Cases
-
-| **Need**                      | **Recommended Extension**    | **Specific Slot/Location**             | **Reason**                             |
-| ----------------------------- | ---------------------------- | -------------------------------------- | -------------------------------------- |
-| Analytics tracking            | Embedded Scripts             | Site-wide injection                    | Perfect for third-party code injection |
+    var getCommonUseCasesGuide = (options) => {
+      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 |
@@ -70506,6 +70607,31 @@ var require_commonUseCasesGuide = __commonJS({
 | 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  |`;
+      const newExtensionRows = `| Product reviews on product page | Site Plugins                | Predefined slots in product pages      | Reviews are contextually tied to each product \u2192 Site Plugin, not Site Widget |
+| 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                 | Predefined slots in eCommerce pages    | Fixed slot integration in checkout flow |
+| 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
+
+| **Site 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** | **Site Widget vs Embedded Script** |
+| ------------------------------------- | ---------------------------------- |
+| Dashboard Page: admin-only interface for managing settings/data | Site 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}${options?.enableNewExtensions ? `
+${newExtensionRows}
+${comparisonGuide}` : ""}`;
     };
     exports2.getCommonUseCasesGuide = getCommonUseCasesGuide;
   }
@@ -71348,6 +71474,8 @@ var require_dist12 = __commonJS({
     __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_system_prompts(), exports2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.246",
+  "version": "1.0.247",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -28,5 +28,5 @@
     "@wix/ditto-codegen": "1.0.0",
     "esbuild": "^0.27.2"
   },
-  "falconPackageHash": "54aee6086f8c14810a73a32f78183ca7213e34d07eb7301d1aa17b45"
+  "falconPackageHash": "b0bc16c0911edf87e5e0585d73f3277742d1fb1061aa28a99b642eca"
 }