@wix/ditto-codegen-public 1.0.234 → 1.0.236

package/dist/examples-apps/react-builder/manifest.json

@@ -1,4 +1,16 @@
 {
+  "installation": {
+    "staticContainer": "HOMEPAGE",
+    "initialSize": {
+      "width": {
+        "sizingType": "pixels",
+        "pixels": 400
+      },
+      "height": {
+        "sizingType": "stretched"
+      }
+    }
+  },
   "editorElement": {
     "selector": ".perfect-example",
     "displayName": "Perfect Example",

package/dist/out.js

@@ -92401,8 +92401,46 @@ All animations: pure CSS, smooth, purposeful.
 - Emojis or decorative shapes \u2192 Avoid unless core to request
 - Looping animations \u2192 Only for loading states
 - Center-aligned multi-line body text \u2192 Hard to read`;
+    var installationDocumentation = `The installation property defines how the component is initially placed and sized when added to a page.
+
+### Installation Fields
+- **staticContainer**: Specifies automatic installation location. Use "HOMEPAGE" to auto-install on homepage
+- **initialSize**: Defines the initial dimensions when the component is added
+  - **width**: Width configuration (InitialSizeSetting)
+    - sizingType: "content" | "stretched" | "pixels"
+    - pixels: number (only usable when sizingType is "pixels")
+  - **height**: Height configuration (InitialSizeSetting)
+    - sizingType: "content" | "stretched" | "pixels"
+    - pixels: number (only usable when sizingType is "pixels")
+
+### SizingType Values
+- **content**: Component auto-sizes based on its content
+- **stretched**: Component stretches to fill available space
+- **pixels**: Component has a fixed pixel dimension (requires pixels property)
+
+### Examples:
+\`\`\`json
+// Fixed width, content-based height
+{
+  "installation": {
+    "staticContainer": "HOMEPAGE",
+    "initialSize": {
+      "width": { "sizingType": "pixels", "pixels": 400 },
+      "height": { "sizingType": "pixels", "pixels": 300 }
+    }
+  }
+}
+\`\`\`
+
+**Guidelines**:
+- Always include "staticContainer": "HOMEPAGE" for automatic installation on Harmony editor
+- Default initial size is 400px width, 300px height (matches Wix Harmony defaults)
+- Use "content" for height when the component should auto-size based on its content
+- Use "stretched" when the component should fill available space
+- Use "pixels" for fixed dimensions (buttons: 120-200px, cards: 300-400px)`;
     var responseFormat = `Output as JSON with files array containing:
 1. **manifest.json** - Component manifest (JSON) containing:
+   - installation: initial size and placement configuration
    - editorElement: full editor element configuration (selector, displayName, archetype, layout, cssProperties, data, elements, behaviors)
 2. **component.tsx** - React component implementation
 3. **style.css** - CSS styles
@@ -92413,6 +92451,13 @@ Each file: { path: string, content: string, operation: "insert" }
 ### manifest.json Structure Example:
 \`\`\`json
 {
+  "installation": {
+    "staticContainer": "HOMEPAGE",
+    "initialSize": {
+      "width": { "sizingType": "pixels", "pixels": 400 },
+      "height": { "sizingType": "pixels", "pixels": 300 }
+    }
+  },
   "editorElement": {
     "selector": ".component-name",
     "displayName": "Component Name",
@@ -92466,6 +92511,7 @@ import { heroImage } from './assets/defaultImages'
       props: propsDocumentation,
       componentElementsGuidelines,
       manifestGuidelines: componentManifestGuidelines,
+      installation: installationDocumentation,
       reactGuidelines: componentReactGuidelines,
       cssGuidelines: componentCssGuidelines,
       designGuidelines,
@@ -92492,7 +92538,7 @@ var require_site_component_prompt = __commonJS({
         apiDocumentation,
         useData,
         useIteration
-      }).withRole(site_component_instructions_1.siteComponentInstructions.role).withSection("core_documentation", site_component_instructions_1.siteComponentInstructions.coreDocumentation).withSection("data_types", site_component_instructions_1.siteComponentInstructions.dataTypes).withSection("css_properties", site_component_instructions_1.siteComponentInstructions.cssProperties).withSection("editor_element", site_component_instructions_1.siteComponentInstructions.editorElement).withSection("layout", site_component_instructions_1.siteComponentInstructions.layout).withSection("elements", site_component_instructions_1.siteComponentInstructions.elements).withSection("props", site_component_instructions_1.siteComponentInstructions.props).withSection("component_elements_guidelines", site_component_instructions_1.siteComponentInstructions.componentElementsGuidelines).withSection("manifest_guidelines", site_component_instructions_1.siteComponentInstructions.manifestGuidelines).withSection("react_guidelines", site_component_instructions_1.siteComponentInstructions.reactGuidelines).withSection("css_guidelines", site_component_instructions_1.siteComponentInstructions.cssGuidelines).withSection("design_guidelines", site_component_instructions_1.siteComponentInstructions.designGuidelines).withSection("asset_guidelines", site_component_instructions_1.siteComponentInstructions.assetGuidelines).withSection("response_format", site_component_instructions_1.siteComponentInstructions.responseFormat).withSection("hard_constraints", site_component_instructions_1.siteComponentInstructions.hardConstraints).withImplementationGuidelines(site_component_instructions_1.siteComponentInstructions.typescriptQualityGuidelines);
+      }).withRole(site_component_instructions_1.siteComponentInstructions.role).withSection("core_documentation", site_component_instructions_1.siteComponentInstructions.coreDocumentation).withSection("data_types", site_component_instructions_1.siteComponentInstructions.dataTypes).withSection("css_properties", site_component_instructions_1.siteComponentInstructions.cssProperties).withSection("editor_element", site_component_instructions_1.siteComponentInstructions.editorElement).withSection("layout", site_component_instructions_1.siteComponentInstructions.layout).withSection("elements", site_component_instructions_1.siteComponentInstructions.elements).withSection("props", site_component_instructions_1.siteComponentInstructions.props).withSection("component_elements_guidelines", site_component_instructions_1.siteComponentInstructions.componentElementsGuidelines).withSection("manifest_guidelines", site_component_instructions_1.siteComponentInstructions.manifestGuidelines).withSection("installation", site_component_instructions_1.siteComponentInstructions.installation).withSection("react_guidelines", site_component_instructions_1.siteComponentInstructions.reactGuidelines).withSection("css_guidelines", site_component_instructions_1.siteComponentInstructions.cssGuidelines).withSection("design_guidelines", site_component_instructions_1.siteComponentInstructions.designGuidelines).withSection("asset_guidelines", site_component_instructions_1.siteComponentInstructions.assetGuidelines).withSection("response_format", site_component_instructions_1.siteComponentInstructions.responseFormat).withSection("hard_constraints", site_component_instructions_1.siteComponentInstructions.hardConstraints).withImplementationGuidelines(site_component_instructions_1.siteComponentInstructions.typescriptQualityGuidelines);
     };
     var siteComponentCorePrompt = () => {
       return createCoreBuilder({

package/dist/wix-cli-templates/src/site/components/my-component/manifest.json

@@ -1,4 +1,17 @@
 {
+  "installation": {
+    "staticContainer": "HOMEPAGE",
+    "initialSize": {
+      "width": {
+        "sizingType": "pixels",
+        "pixels": 400
+      },
+      "height": {
+        "sizingType": "pixels",
+        "pixels": 300
+      }
+    }
+  },
   "editorElement": {
     "data": {
       "text": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.234",
+  "version": "1.0.236",
   "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": "f2b144b85739248671d0347b8952d7ee8702bd0076e2df5cde88a4e9"
+  "falconPackageHash": "4695f084eebd5cfaa3357467ab672d18b687395276473b526c91c5db"
 }