@wix/ditto-codegen-public 1.0.186 → 1.0.188

package/dist/out.js

@@ -36910,7 +36910,17 @@ var require_CustomElementAgent = __commonJS({
 - Custom calculators or tools
 - Counter components
 - Countdown components
+- **Built-in Settings Panel**: Site 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 all site functionality.
+- **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;
@@ -36922,7 +36932,11 @@ 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**`;
+- \u2705 **DEFAULT choice for all site functionality**
+
+### 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
+- \u274C Only add a Dashboard Page if the user explicitly needs shared/centralized configuration stored in a database`;
     };
     exports2.getSiteWidgetDecisionGuide = getSiteWidgetDecisionGuide;
   }
@@ -36954,7 +36968,11 @@ var require_DashboardPageAgent = __commonJS({
 - \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`;
+- \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;
   }
@@ -36999,6 +37017,8 @@ var require_EmbeddedScriptAgent = __commonJS({
 - 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
@@ -37023,7 +37043,10 @@ var require_EmbeddedScriptAgent = __commonJS({
 - \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 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;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.186",
+  "version": "1.0.188",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -24,5 +24,5 @@
     "@wix/ditto-codegen": "1.0.0",
     "esbuild": "^0.25.9"
   },
-  "falconPackageHash": "b1628cd6dfc189b04102b158e38183b1a94b6c78fe322d6a351a2e03"
+  "falconPackageHash": "b3e1d6f35c4c8cf997f4f0b20238bd32d113dbbd82c389819b9321bd"
 }