@dani-builder/strapi-plugin-builder 0.1.0 → 0.3.0

package/AGENTS.md

@@ -0,0 +1,149 @@
+# @dani-builder/strapi-plugin-builder
+
+Strapi v5 plugin providing 11 content types, 31 components, and smart API endpoints for a page builder CMS. Installed as a Strapi plugin — not used standalone.
+
+## Installation & Setup
+
+```bash
+# 1. Install the plugin
+pnpm add @dani-builder/strapi-plugin-builder
+
+# 2. Enable in Strapi config (config/plugins.ts)
+export default () => ({
+  builder: { enabled: true },
+});
+
+# 3. Start Strapi — the plugin registers all Builder content types itself
+```
+
+**Do not copy Builder schemas into `src/api/`.** The plugin owns the content
+types and their core REST routes; copied schemas duplicate collection names and
+prevent Strapi from booting.
+
+## Content Types (11)
+
+### Collection Types (8)
+
+| singularName | pluralName | REST endpoint | draftAndPublish | i18n |
+|---|---|---|---|---|
+| page | pages | `api/builder/pages` | true | yes |
+| article | articles | `api/builder/articles` | true | yes |
+| faq | faqs | `api/builder/faqs` | true | yes |
+| category | categories | `api/builder/categories` | false | yes |
+| tag | tags | `api/builder/tags` | false | yes |
+| author | authors | `api/builder/authors` | false | no |
+| inquiry | inquiries | `api/builder/inquiries` | false | no |
+| series | all-series | `api/builder/all-series` | false | yes |
+
+### Single Types (3)
+
+| singularName | pluralName | REST endpoint | draftAndPublish | i18n |
+|---|---|---|---|---|
+| navigation | navigations | `api/builder/navigation` | true | yes |
+| global | globals | `api/builder/global` | true | yes |
+| site-setting | site-settings | `api/builder/site-setting` | false | no |
+
+**Series quirk:** `pluralName` is `all-series` (not `series`) because Strapi requires singular and plural names to differ.
+
+## Components (31)
+
+### Blocks (14) — used in Page.blocks dynamic zone
+
+`blocks.hero`, `blocks.features`, `blocks.cta`, `blocks.slider`, `blocks.inquiry-form`, `blocks.faq`, `blocks.highlights`, `blocks.bento-grid`, `blocks.testimonials`, `blocks.logo-cloud`, `blocks.stats`, `blocks.pricing`, `blocks.content`, `blocks.team`
+
+### Elements (2)
+
+`elements.section`, `elements.footer`
+
+### Shared (15)
+
+`shared.link`, `shared.seo`, `shared.feature-item`, `shared.highlight-item`, `shared.bento-item`, `shared.slider-item`, `shared.stat-item`, `shared.team-member`, `shared.testimonial-item`, `shared.pricing-tier`, `shared.logo-item`, `shared.navigation-group`, `shared.brand-colors`, `shared.analytics-setting`, `shared.chatbot-setting`, `shared.site-verification`
+
+## Smart API Endpoints
+
+Server-side deep populate — no need for client-side populate building.
+
+| Method | Path | Description |
+|---|---|---|
+| GET | `/api/builder/pages` | List pages (minimal populate) |
+| GET | `/api/builder/pages/:documentId` | Single page with all blocks deeply populated |
+| GET | `/api/builder/global` | Global settings (siteWideBlocks + footer, fully populated) |
+
+## Critical Rules
+
+1. **Component registration** — The plugin uses `strapi.get('components').add(map)`. Never assign directly to `strapi.components[uid]`.
+2. **Components require metadata** — Each component JSON must include `__schema__`, `globalId`, and `collectionName` fields.
+3. **`__component` required in dynamic zones** — Every block object needs `"__component": "blocks.hero"` etc.
+4. **Block text lives in `section`** — heading, subheading, and theme are on the `section` sub-component, NOT at block root.
+5. **Section.theme is a Tailwind preset key** — Values like `'dark'`, `'default'`. No arbitrary CSS colors.
+6. **`name` fields are admin-only** — Used for CMS identification. Never display in frontend.
+7. **All media fields are nullable** — Render defensively even for "required" media fields.
+8. **CT directory names match singularName** — `site-setting/` not `site-settings/`.
+
+## Variant-Based Layouts
+
+Blocks use a `variant` enum instead of separate components per layout. Only use values defined in the schema:
+
+| Block | Variants |
+|---|---|
+| hero | `side-by-side`, `media-extending`, `fullscreen-media`, `stacked-media` |
+| features | `simple-grid`, `card-grid`, `icon-grid` |
+| cta | `side-by-side`, `centered` |
+| pricing | `card-grid`, `comparison-table` |
+| testimonials | `card-grid`, `alternating`, `single-highlight` |
+| highlights | `media-aside`, `alternating`, `card-grid` |
+| bento-grid | `auto`, `featured-left`, `featured-right` |
+| stats | `simple-row`, `card-grid` |
+| team | `card-grid`, `simple-grid` |
+| logo-cloud | `simple-grid`, `ticker` |
+| slider | `fullscreen`, `card-carousel` |
+
+**Never invent variant values** — always check the schema definition.
+
+## REST API Rules (for MCP / programmatic content creation)
+
+```json
+// POST api/builder/pages — create a page with blocks
+{
+  "data": {
+    "title": "About",
+    "slug": "about",
+    "locale": "en",
+    "blocks": [
+      {
+        "__component": "blocks.hero",
+        "variant": "side-by-side",
+        "section": {
+          "heading": "About Us",
+          "subheading": "Our story",
+          "theme": "dark"
+        },
+        "ctaLink": { "label": "Learn more", "href": "/contact" }
+      }
+    ]
+  }
+}
+```
+
+1. **`data` wrapper required** — POST/PUT body must be `{ "data": { ... } }`
+2. **`locale` required** — i18n-enabled CTs fail with `Invalid key` without it
+3. **Media uploaded separately** — Upload via Strapi Upload API, then reference by ID
+4. **Deep reads via Smart API** — Standard REST only populates 1 level; use `/api/builder/pages/:docId` for full data
+
+## File Structure
+
+```
+server/src/
+  content-types/       — Plugin-owned content type schemas
+  register.ts         — Programmatic component registration
+  controllers/        — Smart API controllers (page, global)
+  services/           — Populate service (deep populate definitions for all 14 blocks)
+  routes/             — Core and smart API route definitions
+  components/         — Component JSON schemas (blocks, elements, shared)
+```
+
+## Peer Dependencies
+
+- `@strapi/strapi` ^5.0.0
+- `@strapi/plugin-color-picker` ^5.0.0
+- `@d3levvv/strapi-react-icons-plugin` ^1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HJ-company
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# @dani-builder/strapi-plugin-builder
+
+Reusable CMS building blocks for **Strapi v5** — 11 content types, 31 block/element
+components, and a "smart API" that returns fully deep-populated pages and globals
+in a single request. Powers the [Daniworks Builder](https://github.com/HJ-company/daniworks-builder-v2)
+block-based site builder.
+
+## Install
+
+```bash
+pnpm add @dani-builder/strapi-plugin-builder @strapi/plugin-color-picker @d3levvv/strapi-react-icons-plugin
+```
+
+The two peer plugins are required: builder components use their custom
+fields (`plugin::color-picker.color`, `plugin::icon-picker.icon`), and Strapi
+only loads plugins listed in your own `package.json`. Without them the app
+fails to boot with `Could not find Custom Field: plugin::color-picker.color`.
+
+Enable it in `config/plugins.ts`:
+
+```ts
+export default () => ({
+  builder: { enabled: true },
+});
+```
+
+## Plugin-owned content types
+
+The plugin directly registers all 11 content types as `plugin::builder.*`.
+Do not copy schemas into a consumer's `src/api` directory: that would create
+conflicting `collectionName` registrations. Core REST endpoints are available
+under `/api/builder/*`.
+
+The `inquiry` endpoint is write-only (`POST /api/builder/inquiries`) and IP
+rate-limited so submitter PII cannot be listed over the public API.
+
+## Extending from your project
+
+Add your own blocks to `Page.blocks` and extra fields to plugin components
+from `src/extensions/builder/strapi-server.ts` in your Strapi project — no
+plugin fork needed. Register populate for custom blocks with
+`strapi.plugin('builder').service('populate').registerBlock(uid, populate)`.
+Step-by-step guide with the failure cases to avoid:
+[docs/guides/extending-builder.md](https://github.com/HJ-company/daniworks-builder-v2/blob/main/docs/guides/extending-builder.md).
+Claude Code users get the same procedure as the `builder-extender` skill.
+
+## Smart API
+
+Deep-populated, published-only reads (drafts never leak):
+
+| Method | Endpoint | Purpose |
+|--------|----------|---------|
+| GET | `/api/builder/pages` | List pages (minimal populate) |
+| GET | `/api/builder/pages/:documentId` | Single page, deep block populate |
+| GET | `/api/builder/global` | Global settings, deep populate |
+
+Consume it with [`@dani-builder/strapi-client`](https://www.npmjs.com/package/@dani-builder/strapi-client).
+
+## License
+
+MIT © HJ-company

package/dist/server/src/bootstrap.d.ts

@@ -1,4 +1,4 @@
-import type { Core } from '@strapi/strapi';
+import type { Core } from "@strapi/strapi";
 declare const bootstrap: ({ strapi }: {
     strapi: Core.Strapi;
 }) => void;

package/dist/server/src/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../server/src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,QAAA,MAAM,SAAS,GAAI,YAAY;IAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAA;CAAE,SAGrD,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../server/src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAI3C,QAAA,MAAM,SAAS,GAAI,YAAY;IAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAA;CAAE,SAUrD,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/server/src/bootstrap.js

@@ -1,8 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const AGENT_PLUGIN_ID = "agent";
 const bootstrap = ({ strapi }) => {
     // Initialize populate service with core block definitions
-    strapi.plugin('builder').service('populate').buildBlocksPopulate();
+    strapi.plugin("builder").service("populate").buildBlocksPopulate();
+    // The agent plugin is optional. Its first registration set is deliberately
+    // empty; future agent work adds observed serializer overrides here.
+    const serializer = strapi.plugins[AGENT_PLUGIN_ID]?.services?.serializer;
+    if (serializer && typeof serializer.registerOverrides === "function") {
+        serializer.registerOverrides({});
+    }
 };
 exports.default = bootstrap;
 //# sourceMappingURL=bootstrap.js.map

package/dist/server/src/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../server/src/bootstrap.ts"],"names":[],"mappings":";;AAEA,MAAM,SAAS,GAAG,CAAC,EAAE,MAAM,EAA2B,EAAE,EAAE;IACxD,0DAA0D;IAC1D,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,mBAAmB,EAAE,CAAC;AACrE,CAAC,CAAC;AAEF,kBAAe,SAAS,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../server/src/bootstrap.ts"],"names":[],"mappings":";;AAEA,MAAM,eAAe,GAAG,OAAO,CAAC;AAEhC,MAAM,SAAS,GAAG,CAAC,EAAE,MAAM,EAA2B,EAAE,EAAE;IACxD,0DAA0D;IAC1D,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,mBAAmB,EAAE,CAAC;IAEnE,2EAA2E;IAC3E,oEAAoE;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC;IACzE,IAAI,UAAU,IAAI,OAAO,UAAU,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QACrE,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;AACH,CAAC,CAAC;AAEF,kBAAe,SAAS,CAAC"}

package/dist/server/src/bootstrap.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bootstrap.test.d.ts.map

package/dist/server/src/bootstrap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.test.d.ts","sourceRoot":"","sources":["../../../server/src/bootstrap.test.ts"],"names":[],"mappings":""}

package/dist/server/src/bootstrap.test.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const bootstrap_1 = __importDefault(require("./bootstrap"));
+function createStrapi(serializerInstalled) {
+    const registerOverrides = vitest_1.vi.fn();
+    const buildBlocksPopulate = vitest_1.vi.fn();
+    const plugins = serializerInstalled
+        ? { agent: { services: { serializer: { registerOverrides } } } }
+        : {};
+    return {
+        plugins,
+        plugin: vitest_1.vi.fn((name) => {
+            if (name === "builder")
+                return { service: () => ({ buildBlocksPopulate }) };
+            return { service: () => ({ registerOverrides }) };
+        }),
+        registerOverrides,
+        buildBlocksPopulate,
+    };
+}
+(0, vitest_1.describe)("builder bootstrap", () => {
+    (0, vitest_1.it)("does not access agent services when the optional plugin is absent", () => {
+        const strapi = createStrapi(false);
+        (0, bootstrap_1.default)({ strapi: strapi });
+        (0, vitest_1.expect)(strapi.buildBlocksPopulate).toHaveBeenCalledOnce();
+        (0, vitest_1.expect)(strapi.plugin).toHaveBeenCalledTimes(1);
+    });
+    (0, vitest_1.it)("registers the empty serializer override set when agent is installed", () => {
+        const strapi = createStrapi(true);
+        (0, bootstrap_1.default)({ strapi: strapi });
+        (0, vitest_1.expect)(strapi.registerOverrides).toHaveBeenCalledWith({});
+    });
+    (0, vitest_1.it)("does not access an unrelated plugin registered as agent", () => {
+        const strapi = createStrapi(false);
+        strapi.plugins.agent = {};
+        (0, bootstrap_1.default)({ strapi: strapi });
+        (0, vitest_1.expect)(strapi.registerOverrides).not.toHaveBeenCalled();
+        (0, vitest_1.expect)(strapi.plugin).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=bootstrap.test.js.map

package/dist/server/src/bootstrap.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.test.js","sourceRoot":"","sources":["../../../server/src/bootstrap.test.ts"],"names":[],"mappings":";;;;;AAAA,mCAAkD;AAClD,4DAAoC;AAEpC,SAAS,YAAY,CAAC,mBAA4B;IAChD,MAAM,iBAAiB,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;IAClC,MAAM,mBAAmB,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;IACpC,MAAM,OAAO,GAA4B,mBAAmB;QAC1D,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,EAAE;QAChE,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;QACL,OAAO;QACP,MAAM,EAAE,WAAE,CAAC,EAAE,CAAC,CAAC,IAAY,EAAE,EAAE;YAC7B,IAAI,IAAI,KAAK,SAAS;gBACpB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC;YACtD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;QACpD,CAAC,CAAC;QACF,iBAAiB;QACjB,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED,IAAA,iBAAQ,EAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAA,WAAE,EAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,IAAA,mBAAS,EAAC,EAAE,MAAM,EAAE,MAAe,EAAE,CAAC,CAAC;QACvC,IAAA,eAAM,EAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC1D,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAClC,IAAA,mBAAS,EAAC,EAAE,MAAM,EAAE,MAAe,EAAE,CAAC,CAAC;QACvC,IAAA,eAAM,EAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QAC1B,IAAA,mBAAS,EAAC,EAAE,MAAM,EAAE,MAAe,EAAE,CAAC,CAAC;QACvC,IAAA,eAAM,EAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACxD,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/server/src/components/blocks/cta.json

@@ -13,12 +13,20 @@
     },
     "variant": {
       "type": "enumeration",
-      "enum": ["inline-spread", "inline-centered", "inline-stacked", "card-stacked", "card-centered", "card-horizontal"]
+      "enum": [
+        "inline-spread",
+        "inline-centered",
+        "inline-stacked",
+        "card-stacked",
+        "card-centered",
+        "card-horizontal"
+      ],
+      "default": "inline-spread"
     },
-    "ctaMedia": {
-      "type": "media",
-      "multiple": false,
-      "allowedTypes": ["images", "videos"]
+    "image": {
+      "type": "component",
+      "component": "shared.image",
+      "repeatable": false
     },
     "ctaText": {
       "type": "text"

package/dist/server/src/components/blocks/faq.json

@@ -14,7 +14,7 @@
     "items": {
       "type": "relation",
       "relation": "oneToMany",
-      "target": "api::faq.faq"
+      "target": "plugin::builder.faq"
     }
   }
 }

package/dist/server/src/components/blocks/features.json

@@ -11,17 +11,22 @@
     },
     "variant": {
       "type": "enumeration",
-      "enum": ["simple-grid", "dual-column", "media-aside", "media-aside-compact"]
+      "enum": [
+        "simple-grid",
+        "dual-column",
+        "media-aside",
+        "media-aside-compact"
+      ]
     },
     "section": {
       "type": "component",
       "component": "elements.section",
       "repeatable": false
     },
-    "media": {
-      "type": "media",
-      "multiple": false,
-      "allowedTypes": ["images"]
+    "image": {
+      "type": "component",
+      "component": "shared.image",
+      "repeatable": false
     },
     "items": {
       "type": "component",

package/dist/server/src/components/blocks/hero.json

@@ -8,17 +8,22 @@
   "attributes": {
     "variant": {
       "type": "enumeration",
-      "enum": ["side-by-side", "media-extending", "fullscreen-media", "stacked-media"]
+      "enum": [
+        "side-by-side",
+        "media-extending",
+        "fullscreen-media",
+        "stacked-media"
+      ]
     },
     "section": {
       "type": "component",
       "component": "elements.section",
       "repeatable": false
     },
-    "heroMedia": {
-      "type": "media",
-      "multiple": false,
-      "allowedTypes": ["images", "videos"]
+    "image": {
+      "type": "component",
+      "component": "shared.image",
+      "repeatable": false
     },
     "ctaText": {
       "type": "text"
@@ -35,7 +40,11 @@
     },
     "headerMode": {
       "type": "enumeration",
-      "enum": ["none", "transparent-black", "transparent-white"],
+      "enum": [
+        "none",
+        "transparent-black",
+        "transparent-white"
+      ],
       "default": "none"
     }
   }

package/dist/server/src/components/blocks/highlights.json

@@ -11,12 +11,16 @@
     },
     "variant": {
       "type": "enumeration",
-      "enum": ["dual-column", "triple-column", "alternating"]
+      "enum": [
+        "dual-column",
+        "triple-column",
+        "alternating"
+      ]
     },
-    "media": {
-      "type": "media",
-      "multiple": false,
-      "allowedTypes": ["images", "videos"]
+    "image": {
+      "type": "component",
+      "component": "shared.image",
+      "repeatable": false
     },
     "section": {
       "type": "component",

package/dist/server/src/components/blocks/inquiry-form.json

@@ -13,6 +13,9 @@
     },
     "successMessage": {
       "type": "text"
+    },
+    "errorMessage": {
+      "type": "text"
     }
   }
 }

package/dist/server/src/components/blocks/logo-cloud.json

@@ -11,7 +11,12 @@
     },
     "variant": {
       "type": "enumeration",
-      "enum": ["inline", "grid", "split"]
+      "enum": [
+        "inline",
+        "grid",
+        "split",
+        "marquee"
+      ]
     },
     "section": {
       "type": "component",

package/dist/server/src/components/blocks/stats.json

@@ -11,17 +11,21 @@
     },
     "variant": {
       "type": "enumeration",
-      "enum": ["simple", "card-grid", "split"]
+      "enum": [
+        "simple",
+        "card-grid",
+        "split"
+      ]
     },
     "section": {
       "type": "component",
       "component": "elements.section",
       "repeatable": false
     },
-    "media": {
-      "type": "media",
-      "multiple": false,
-      "allowedTypes": ["images", "videos"]
+    "image": {
+      "type": "component",
+      "component": "shared.image",
+      "repeatable": false
     },
     "items": {
       "type": "component",

package/dist/server/src/components/blocks/testimonials.json

@@ -11,17 +11,22 @@
     },
     "variant": {
       "type": "enumeration",
-      "enum": ["centered", "side-by-side", "card-grid", "subtle-grid"]
+      "enum": [
+        "centered",
+        "side-by-side",
+        "card-grid",
+        "subtle-grid"
+      ]
     },
     "section": {
       "type": "component",
       "component": "elements.section",
       "repeatable": false
     },
-    "media": {
-      "type": "media",
-      "multiple": false,
-      "allowedTypes": ["images", "videos"]
+    "image": {
+      "type": "component",
+      "component": "shared.image",
+      "repeatable": false
     },
     "items": {
       "type": "component",

package/dist/server/src/components/shared/bento-item.json

@@ -12,10 +12,10 @@
     "description": {
       "type": "text"
     },
-    "media": {
-      "type": "media",
-      "multiple": false,
-      "allowedTypes": ["images"]
+    "image": {
+      "type": "component",
+      "component": "shared.image",
+      "repeatable": false
     },
     "icon": {
       "type": "customField",

package/dist/server/src/components/shared/highlight-item.json

@@ -12,11 +12,11 @@
     "description": {
       "type": "richtext"
     },
-    "media": {
-      "type": "media",
-      "multiple": false,
-      "required": true,
-      "allowedTypes": ["images", "videos"]
+    "image": {
+      "type": "component",
+      "component": "shared.image",
+      "repeatable": false,
+      "required": true
     },
     "link": {
       "type": "component",

package/dist/server/src/components/shared/image.json

@@ -0,0 +1,24 @@
+{
+  "collectionName": "components_shared_images",
+  "info": {
+    "displayName": "Image",
+    "icon": "picture",
+    "description": "Informational image with per-usage fit control and localized alt override"
+  },
+  "attributes": {
+    "media": {
+      "type": "media",
+      "multiple": false,
+      "required": true,
+      "allowedTypes": ["images", "videos"]
+    },
+    "alt": {
+      "type": "string"
+    },
+    "fit": {
+      "type": "enumeration",
+      "enum": ["auto", "cover", "contain"],
+      "default": "auto"
+    }
+  }
+}

package/dist/server/src/components/shared/slider-item.json

@@ -17,11 +17,11 @@
       "component": "shared.link",
       "repeatable": false
     },
-    "media": {
-      "type": "media",
-      "multiple": false,
-      "required": true,
-      "allowedTypes": ["images", "videos"]
+    "image": {
+      "type": "component",
+      "component": "shared.image",
+      "repeatable": false,
+      "required": true
     }
   }
 }