@wix/ditto-codegen-public 1.0.490 → 1.0.491

package/dist/out.js

@@ -12759,6 +12759,42 @@ For any persistent-data need (CMS collections, tables, schemas, data models):
   }
 });
 
+// ../codegen-common-logic/dist/rules/site-host-modules.js
+var require_site_host_modules = __commonJS({
+  "../codegen-common-logic/dist/rules/site-host-modules.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.SITE_HOST_MODULES_RULES = void 0;
+    exports2.SITE_HOST_MODULES_RULES = `# Site Host Modules Rules
+
+In React code that runs in the Studio 2 viewer (custom elements, Editor React Components, page code, context providers), never import \`@wix/site-*\` host modules (\`@wix/site-window\`, \`@wix/site-site\`, \`@wix/site-location\`, \`@wix/site-seo\`, ...). They call \`window.clientSdk\`, which Studio 2 pages do not have, so every call rejects with "Wix Site SDK only works in a Wix site environment" and nothing happens, in preview and on the published site.
+
+Use the matching site service instead, read with \`useService\` from \`@wix/services-manager-react\`. Take the service's API from the installed package's types, not from memory:
+
+| Instead of | Use |
+|---|---|
+| \`@wix/site-window\` \`openLightbox\` / \`lightbox.getContext\` / \`lightbox.close\` | \`@wix/site-service-lightbox\` |
+| \`@wix/site-window\` \`formFactor\` | \`@wix/site-service-device-info\`. Its device types are named differently from \`formFactor\`: use the values in its types |
+| \`@wix/site-window\` \`viewMode\` | \`@wix/site-service-editor-context\`. It only says whether the site is being previewed; it can't tell the editor from the live site |
+| \`@wix/site-window\` \`rendering.env\` | \`@wix/site-service-rendering-context\` |
+| \`@wix/site-window\` \`warmup-data\` \`get\` / \`set\` | \`@wix/site-service-warmup-data\` |
+| \`@wix/site-site\` \`regionalSettings\` / \`language\` / \`timezone\` (language, text direction, regional format, time zone) | \`@wix/site-service-locale\`. It reports the site's settings, not the language the visitor is viewing |
+| \`@wix/site-site\` \`getSiteDisplayName\` / \`revision\` | \`@wix/site-service-site-info\` |
+| \`@wix/site-site\` \`getSiteThemeHtml\` / \`getFontsHtml\` | \`@wix/site-service-site-theme\`. It returns the theme's colors and fonts as values, not HTML |
+| \`@wix/site-location\` \`to()\` | \`@wix/site-service-router\` |
+| \`@wix/site-location\` \`url\` | \`@wix/site-service-url\` |
+| \`@wix/site-site\` \`currentPage\` / site structure | \`@wix/site-service-pages\` |
+
+There is no service yet for these, so Studio 2 can't do them from viewer code: \`@wix/site-window\` \`multilingual\` (reading or switching the display language), \`@wix/site-seo\` (setting SEO tags from the browser), \`@wix/site-members\`, \`@wix/site-storage\`, \`@wix/site-ecom\`, \`@wix/site-stores\`, \`@wix/site-pricing-plans\`, \`@wix/site-crm\`, \`@wix/site-pay\`, \`@wix/site-realtime\`, \`@wix/site-events\`, \`@wix/site-bookings\`, the \`@wix/site-location\` helpers other than \`to()\` and \`url\` (\`path\`, \`query\`, \`onChange\`, ...), and the \`@wix/site-window\` browser helpers (\`scrollTo\`, \`copyToClipboard\`, \`getCurrentGeolocation\`, \`referrer\`, \`postMessage\`, \`openModal\`, consent policy). Do not substitute \`navigator.language\` for the display language: it is the browser's preference and can differ from the language the site is shown in. Do not set SEO tags from client code: a client effect can't reach crawlers. For any of these, don't guess a workaround; say in your final message that Studio 2 doesn't support it yet.
+
+If a host-module API you need isn't in the table, check the Wix docs for a supported replacement before choosing an approach. Never fall back to a \`@wix/site-*\` host module.
+
+A live site loads a site service only when an extension declares it in the manifest's \`serviceDependencies\`. Preview loads every service, so a missing declaration works in preview and fails after publish: always declare each service you use.
+
+**Embedded scripts are the exception.** They are plain HTML/JS injected into the page, with no services manager, so \`useService\` and \`serviceDependencies\` don't apply. Follow the \`wix-app\` embedded-script reference there, which creates its client from \`@wix/site\` and the \`@wix/site-*\` host modules.`;
+  }
+});
+
 // ../codegen-common-logic/dist/rules/telemetry.js
 var require_telemetry = __commonJS({
   "../codegen-common-logic/dist/rules/telemetry.js"(exports2) {
@@ -12869,6 +12905,7 @@ var require_rules = __commonJS({
     __exportStar2(require_brik_import(), exports2);
     __exportStar2(require_code_edits_scope(), exports2);
     __exportStar2(require_site_data_layer(), exports2);
+    __exportStar2(require_site_host_modules(), exports2);
     __exportStar2(require_telemetry(), exports2);
     __exportStar2(require_stores_catalog_version(), exports2);
     __exportStar2(require_user_attachments(), exports2);
@@ -14130,6 +14167,10 @@ var require_dist8 = __commonJS({
         { filename: "brik-import-rules.md", content: codegen_common_logic_1.BRIK_IMPORT_RULES },
         { filename: "code-edits-scope-rules.md", content: codegen_common_logic_1.CODE_EDITS_SCOPE_RULES },
         { filename: "user-attachments-rules.md", content: codegen_common_logic_1.USER_ATTACHMENTS_RULES },
+        {
+          filename: "site-host-modules-rules.md",
+          content: codegen_common_logic_1.SITE_HOST_MODULES_RULES
+        },
         { filename: "telemetry-rules.md", content: codegen_common_logic_1.TELEMETRY_RULES }
       ],
       askRules: [{ filename: "telemetry-ask-rules.md", content: codegen_common_logic_1.TELEMETRY_RULES }],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.490",
+  "version": "1.0.491",
   "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": "7decfa063afb512f018a47dd2b1618621515a849ccea73a3917ab628"
+  "falconPackageHash": "391e252562c6169552e19a164b9aef3c38086e2e12244a9e99e091d6"
 }