@btst/stack 2.11.3 → 2.11.5

package/dist/shared/{stack.CLrGRIj0.d.mts → stack.DiodAFAa.d.mts}

@@ -1,11 +1,12 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.Sod_PZhB.mjs';
+import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.mjs';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { DBAdapter } from '@btst/db';
 import * as better_call from 'better-call';
 import { z } from 'zod';
+import { c as createPostSchema, u as updatePostSchema } from './stack.CuhcFsAx.mjs';
 
 /**
  * Parameters for filtering/paginating posts.
@@ -316,12 +317,6 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
             title: string;
             content: string;
             excerpt: string;
-            slug?: string | undefined;
-            published?: boolean | undefined;
-            publishedAt?: unknown;
-            createdAt?: unknown;
-            updatedAt?: unknown;
-            image?: string | undefined;
             tags?: ({
                 name: string;
             } | {
@@ -329,16 +324,16 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 name: string;
                 slug: string;
             })[] | undefined;
-        }, {
-            title: string;
-            content: string;
-            excerpt: string;
             slug?: string | undefined;
             published?: boolean | undefined;
             publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
             image?: string | undefined;
+        }, {
+            title: string;
+            content: string;
+            excerpt: string;
             tags?: ({
                 name: string;
             } | {
@@ -346,6 +341,12 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 name: string;
                 slug: string;
             })[] | undefined;
+            slug?: string | undefined;
+            published?: boolean | undefined;
+            publishedAt?: unknown;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            image?: string | undefined;
         }>;
     }, Post>;
     readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {} & {

package/dist/shared/stack.Dsatjh0B.d.cts

@@ -0,0 +1,35 @@
+type Post = {
+    id: string;
+    authorId?: string;
+    defaultLocale?: string;
+    slug: string;
+    title: string;
+    content: string;
+    excerpt: string;
+    image?: string;
+    published: boolean;
+    status?: "DRAFT" | "PUBLISHED";
+    tags: Tag[];
+    publishedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+};
+type Tag = {
+    id: string;
+    slug: string;
+    name: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+interface SerializedPost extends Omit<Post, "createdAt" | "updatedAt" | "publishedAt" | "tags"> {
+    tags: SerializedTag[];
+    publishedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface SerializedTag extends Omit<Tag, "createdAt" | "updatedAt"> {
+    createdAt: string;
+    updatedAt: string;
+}
+
+export type { Post as P, SerializedPost as S, Tag as T, SerializedTag as a };

package/dist/shared/stack.Dsatjh0B.d.mts

@@ -0,0 +1,35 @@
+type Post = {
+    id: string;
+    authorId?: string;
+    defaultLocale?: string;
+    slug: string;
+    title: string;
+    content: string;
+    excerpt: string;
+    image?: string;
+    published: boolean;
+    status?: "DRAFT" | "PUBLISHED";
+    tags: Tag[];
+    publishedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+};
+type Tag = {
+    id: string;
+    slug: string;
+    name: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+interface SerializedPost extends Omit<Post, "createdAt" | "updatedAt" | "publishedAt" | "tags"> {
+    tags: SerializedTag[];
+    publishedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface SerializedTag extends Omit<Tag, "createdAt" | "updatedAt"> {
+    createdAt: string;
+    updatedAt: string;
+}
+
+export type { Post as P, SerializedPost as S, Tag as T, SerializedTag as a };

package/dist/shared/stack.Dsatjh0B.d.ts

@@ -0,0 +1,35 @@
+type Post = {
+    id: string;
+    authorId?: string;
+    defaultLocale?: string;
+    slug: string;
+    title: string;
+    content: string;
+    excerpt: string;
+    image?: string;
+    published: boolean;
+    status?: "DRAFT" | "PUBLISHED";
+    tags: Tag[];
+    publishedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+};
+type Tag = {
+    id: string;
+    slug: string;
+    name: string;
+    createdAt: Date;
+    updatedAt: Date;
+};
+interface SerializedPost extends Omit<Post, "createdAt" | "updatedAt" | "publishedAt" | "tags"> {
+    tags: SerializedTag[];
+    publishedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface SerializedTag extends Omit<Tag, "createdAt" | "updatedAt"> {
+    createdAt: string;
+    updatedAt: string;
+}
+
+export type { Post as P, SerializedPost as S, Tag as T, SerializedTag as a };

package/dist/shared/{stack.fQjVhw5a.d.ts → stack.fXlShnhv.d.ts}

@@ -87,12 +87,36 @@ interface CreateCMSContentItemInput {
     /** Arbitrary data payload — should match the content type schema */
     data: Record<string, unknown>;
 }
+/**
+ * Options for {@link createCMSContentItem}.
+ */
+interface CreateCMSContentItemOptions {
+    /**
+     * When `true`, persist relation fields (`belongsTo`, `hasMany`,
+     * `manyToMany`) into the `contentRelation` junction table in addition to
+     * the item's JSON payload.
+     *
+     * This is what the HTTP `POST /content/:typeSlug` route does, and is
+     * required for the admin "Related Items" panel / inverse-relation queries
+     * to find the item.
+     *
+     * Seeds and other programmatic callers that want the admin UI to work
+     * should enable this flag. Callers are still expected to pass
+     * pre-created target IDs (`{ id }` or `[{ id }, ...]`) — inline `_new`
+     * creation is only supported via the HTTP route.
+     *
+     * Defaults to `false` for backwards compatibility (a no-op for content
+     * types without relations).
+     */
+    syncRelations?: boolean;
+}
 /**
  * Create a new content item for a content type (looked up by slug).
  *
- * Bypasses Zod schema validation and relation processing — the caller is
- * responsible for providing valid, relation-free data. For relation fields or
- * schema validation, use the HTTP endpoint instead.
+ * Bypasses Zod schema validation and inline `_new` relation creation — the
+ * caller is responsible for providing valid data and pre-created relation
+ * IDs. For schema validation or inline creation of related items, use the
+ * HTTP endpoint instead.
  *
  * Throws if the content type is not found or the slug is already taken within
  * that content type.
@@ -104,8 +128,11 @@ interface CreateCMSContentItemInput {
  * @param adapter - The database adapter
  * @param contentTypeSlug - Slug of the target content type
  * @param input - Item slug and data payload
+ * @param options - See {@link CreateCMSContentItemOptions}. Pass
+ *   `{ syncRelations: true }` to also populate the `contentRelation`
+ *   junction table for relation fields in the payload.
  */
-declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput): Promise<SerializedContentItem>;
+declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
 
 /**
  * Route keys for the CMS plugin — matches the keys returned by
@@ -331,7 +358,7 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
     getContentItemBySlug: (contentTypeSlug: string, slug: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
     getContentItemById: (id: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
     prefetchForRoute: CMSPrefetchForRoute;
-    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2]) => Promise<SerializedContentItem>;
+    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2], options?: Parameters<typeof createCMSContentItem>[3]) => Promise<SerializedContentItem>;
 }>;
 type CMSApiRouter = ReturnType<ReturnType<typeof cmsBackendPlugin>["routes"]>;
 
@@ -368,5 +395,5 @@ declare const CMS_QUERY_KEYS: {
     contentDetail: (typeSlug: string, id: string) => readonly ["cmsContent", "detail", string, string];
 };
 
-export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as l, serializeContentType as s };
-export type { CMSApiRouter as C, ContentListDiscriminator as a, CMSRouteKey as b, CreateCMSContentItemInput as k };
+export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as m, serializeContentType as s };
+export type { CMSApiRouter as C, ContentListDiscriminator as a, CMSRouteKey as b, CreateCMSContentItemInput as k, CreateCMSContentItemOptions as l };

package/dist/shared/{stack.C9zoS1TN.d.cts → stack.r6HohbyX.d.cts}

@@ -87,12 +87,36 @@ interface CreateCMSContentItemInput {
     /** Arbitrary data payload — should match the content type schema */
     data: Record<string, unknown>;
 }
+/**
+ * Options for {@link createCMSContentItem}.
+ */
+interface CreateCMSContentItemOptions {
+    /**
+     * When `true`, persist relation fields (`belongsTo`, `hasMany`,
+     * `manyToMany`) into the `contentRelation` junction table in addition to
+     * the item's JSON payload.
+     *
+     * This is what the HTTP `POST /content/:typeSlug` route does, and is
+     * required for the admin "Related Items" panel / inverse-relation queries
+     * to find the item.
+     *
+     * Seeds and other programmatic callers that want the admin UI to work
+     * should enable this flag. Callers are still expected to pass
+     * pre-created target IDs (`{ id }` or `[{ id }, ...]`) — inline `_new`
+     * creation is only supported via the HTTP route.
+     *
+     * Defaults to `false` for backwards compatibility (a no-op for content
+     * types without relations).
+     */
+    syncRelations?: boolean;
+}
 /**
  * Create a new content item for a content type (looked up by slug).
  *
- * Bypasses Zod schema validation and relation processing — the caller is
- * responsible for providing valid, relation-free data. For relation fields or
- * schema validation, use the HTTP endpoint instead.
+ * Bypasses Zod schema validation and inline `_new` relation creation — the
+ * caller is responsible for providing valid data and pre-created relation
+ * IDs. For schema validation or inline creation of related items, use the
+ * HTTP endpoint instead.
  *
  * Throws if the content type is not found or the slug is already taken within
  * that content type.
@@ -104,8 +128,11 @@ interface CreateCMSContentItemInput {
  * @param adapter - The database adapter
  * @param contentTypeSlug - Slug of the target content type
  * @param input - Item slug and data payload
+ * @param options - See {@link CreateCMSContentItemOptions}. Pass
+ *   `{ syncRelations: true }` to also populate the `contentRelation`
+ *   junction table for relation fields in the payload.
  */
-declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput): Promise<SerializedContentItem>;
+declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
 
 /**
  * Route keys for the CMS plugin — matches the keys returned by
@@ -331,7 +358,7 @@ declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugin
     getContentItemBySlug: (contentTypeSlug: string, slug: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
     getContentItemById: (id: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
     prefetchForRoute: CMSPrefetchForRoute;
-    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2]) => Promise<SerializedContentItem>;
+    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2], options?: Parameters<typeof createCMSContentItem>[3]) => Promise<SerializedContentItem>;
 }>;
 type CMSApiRouter = ReturnType<ReturnType<typeof cmsBackendPlugin>["routes"]>;
 
@@ -368,5 +395,5 @@ declare const CMS_QUERY_KEYS: {
     contentDetail: (typeSlug: string, id: string) => readonly ["cmsContent", "detail", string, string];
 };
 
-export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as l, serializeContentType as s };
-export type { CMSApiRouter as C, ContentListDiscriminator as a, CMSRouteKey as b, CreateCMSContentItemInput as k };
+export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as m, serializeContentType as s };
+export type { CMSApiRouter as C, ContentListDiscriminator as a, CMSRouteKey as b, CreateCMSContentItemInput as k, CreateCMSContentItemOptions as l };

package/dist/shared/{stack.BQSy-NDc.d.ts → stack.ufcExQIR.d.ts}

@@ -1,11 +1,12 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.Sod_PZhB.js';
+import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.js';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { DBAdapter } from '@btst/db';
 import * as better_call from 'better-call';
 import { z } from 'zod';
+import { c as createPostSchema, u as updatePostSchema } from './stack.CuhcFsAx.js';
 
 /**
  * Parameters for filtering/paginating posts.
@@ -316,12 +317,6 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
             title: string;
             content: string;
             excerpt: string;
-            slug?: string | undefined;
-            published?: boolean | undefined;
-            publishedAt?: unknown;
-            createdAt?: unknown;
-            updatedAt?: unknown;
-            image?: string | undefined;
             tags?: ({
                 name: string;
             } | {
@@ -329,16 +324,16 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 name: string;
                 slug: string;
             })[] | undefined;
-        }, {
-            title: string;
-            content: string;
-            excerpt: string;
             slug?: string | undefined;
             published?: boolean | undefined;
             publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
             image?: string | undefined;
+        }, {
+            title: string;
+            content: string;
+            excerpt: string;
             tags?: ({
                 name: string;
             } | {
@@ -346,6 +341,12 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 name: string;
                 slug: string;
             })[] | undefined;
+            slug?: string | undefined;
+            published?: boolean | undefined;
+            publishedAt?: unknown;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            image?: string | undefined;
         }>;
     }, Post>;
     readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {} & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btst/stack",
-  "version": "2.11.3",
+  "version": "2.11.5",
   "description": "A composable, plugin-based library for building full-stack applications.",
   "repository": {
     "type": "git",
@@ -127,6 +127,16 @@
         "default": "./dist/plugins/blog/client/index.cjs"
       }
     },
+    "./plugins/blog/client/components": {
+      "import": {
+        "types": "./dist/plugins/blog/client/components/index.d.ts",
+        "default": "./dist/plugins/blog/client/components/index.mjs"
+      },
+      "require": {
+        "types": "./dist/plugins/blog/client/components/index.d.cts",
+        "default": "./dist/plugins/blog/client/components/index.cjs"
+      }
+    },
     "./plugins/blog/client/hooks": {
       "import": {
         "types": "./dist/plugins/blog/client/hooks/index.d.ts",
@@ -607,6 +617,9 @@
       "plugins/blog/client": [
         "./dist/plugins/blog/client/index.d.ts"
       ],
+      "plugins/blog/client/components": [
+        "./dist/plugins/blog/client/components/index.d.ts"
+      ],
       "plugins/blog/client/hooks": [
         "./dist/plugins/blog/client/hooks/index.d.ts"
       ],

package/src/plugins/blog/client/components/index.tsx

@@ -3,9 +3,61 @@ import { HomePageComponent as PostListPageImpl } from "./pages/home-page";
 import { NewPostPageComponent as NewPostPageImpl } from "./pages/new-post-page";
 import { PostPageComponent as PostPageImpl } from "./pages/post-page";
 import { EditPostPageComponent as EditPostPageImpl } from "./pages/edit-post-page";
+import { PostCard as PostCardImpl } from "./shared/post-card";
+import { PostsList as PostsListImpl } from "./shared/posts-list";
+import { EmptyList as EmptyListImpl } from "./shared/empty-list";
+import { RecentPostsCarousel as RecentPostsCarouselImpl } from "./shared/recent-posts-carousel";
+import { PostNavigation as PostNavigationImpl } from "./shared/post-navigation";
+import { TagsList as TagsListImpl } from "./shared/tags-list";
+import { PostCardSkeleton as PostCardSkeletonImpl } from "./loading/post-card-skeleton";
 
 // Re-export to ensure the client boundary is preserved
 export const PostListPage = PostListPageImpl;
 export const NewPostPage = NewPostPageImpl;
 export const PostPage = PostPageImpl;
 export const EditPostPage = EditPostPageImpl;
+
+/**
+ * Card component that renders a single blog post summary
+ * (cover image, title, date, tags). Used by the built-in posts list and
+ * available for composing custom blog landing pages.
+ *
+ * Requires a `StackProvider` with the blog plugin registered so that
+ * `Link` and `Image` overrides are resolved correctly.
+ */
+export const PostCard = PostCardImpl;
+
+/**
+ * Skeleton placeholder that mirrors the layout of {@link PostCard}.
+ * Use inside a `<Suspense>` fallback or while data is loading.
+ */
+export const PostCardSkeleton = PostCardSkeletonImpl;
+
+/**
+ * Grid of {@link PostCard}s with optional load-more pagination and a
+ * built-in search input. Pass an array of `SerializedPost`s.
+ */
+export const PostsList = PostsListImpl;
+
+/**
+ * Empty-state placeholder used by the built-in blog list pages.
+ * Renders a centered icon and a customisable message.
+ */
+export const EmptyList = EmptyListImpl;
+
+/**
+ * Horizontal carousel of recent posts. Drop-in component for "you might
+ * also like" sections on a blog post page.
+ */
+export const RecentPostsCarousel = RecentPostsCarouselImpl;
+
+/**
+ * Previous/next post navigation strip, typically rendered at the bottom
+ * of a post page.
+ */
+export const PostNavigation = PostNavigationImpl;
+
+/**
+ * Renders a list of tags for a post or for the whole blog.
+ */
+export const TagsList = TagsListImpl;

package/src/plugins/cms/__tests__/auto-form-nested-config.test.ts

@@ -0,0 +1,177 @@
+import { describe, it, expect, vi } from "vitest";
+import { z } from "zod";
+import { buildFieldConfigFromJsonSchema } from "@workspace/ui/components/auto-form/helpers";
+
+/**
+ * Verifies that buildFieldConfigFromJsonSchema recurses into nested objects AND
+ * array items.properties so that per-property metadata (label, placeholder,
+ * fieldType, etc.) reaches the AutoForm renderer for fields nested inside
+ * arrays-of-objects.
+ *
+ * The CMS auto-form pipeline relies on this for blend-style schemas like:
+ *   components: z.array(z.object({
+ *     name: z.string(),
+ *     compoundId: z.object({ id: z.string() }).meta({ fieldType: "relation" }),
+ *   }))
+ *
+ * Without this recursion, AutoFormArray would render the inner items with no
+ * field config — placeholders and custom field components on nested array
+ * properties would silently disappear.
+ */
+
+type ConfigMap = Record<string, Record<string, unknown> | undefined>;
+
+function getConfig(map: ConfigMap, key: string): Record<string, unknown> {
+	const value = map[key];
+	if (!value) {
+		throw new Error(`Expected config entry for "${key}" but got undefined`);
+	}
+	return value;
+}
+
+describe("buildFieldConfigFromJsonSchema — nested + array recursion", () => {
+	it("propagates per-item placeholders into the array's field config", () => {
+		const schema = z.object({
+			components: z
+				.array(
+					z.object({
+						name: z.string().meta({ placeholder: "e.g. GHK-Cu" }),
+						doseLow: z.coerce.number().meta({ placeholder: "1" }),
+					}),
+				)
+				.default([])
+				.meta({ description: "Blend components" }),
+		});
+
+		const jsonSchema = z.toJSONSchema(schema) as Record<string, unknown>;
+		const config = buildFieldConfigFromJsonSchema(jsonSchema) as ConfigMap;
+		const components = getConfig(config, "components") as ConfigMap & {
+			description?: string;
+		};
+
+		expect(components.description).toBe("Blend components");
+
+		// Per-item configs must live as keys on the array's FieldConfigObject so
+		// that AutoFormObject (rendered per array item) can look them up by name.
+		const nameConfig = getConfig(components, "name") as {
+			inputProps?: { placeholder?: string };
+		};
+		expect(nameConfig.inputProps?.placeholder).toBe("e.g. GHK-Cu");
+
+		const doseLowConfig = getConfig(components, "doseLow") as {
+			inputProps?: { placeholder?: string };
+		};
+		expect(doseLowConfig.inputProps?.placeholder).toBe("1");
+	});
+
+	it("propagates fieldType (textarea) into array items", () => {
+		const schema = z.object({
+			components: z
+				.array(
+					z.object({
+						notes: z.string().meta({ fieldType: "textarea" }),
+					}),
+				)
+				.default([]),
+		});
+
+		const jsonSchema = z.toJSONSchema(schema) as Record<string, unknown>;
+		const config = buildFieldConfigFromJsonSchema(jsonSchema) as ConfigMap;
+		const components = getConfig(config, "components") as ConfigMap;
+		const notesConfig = getConfig(components, "notes") as {
+			fieldType?: string;
+		};
+
+		expect(notesConfig.fieldType).toBe("textarea");
+	});
+
+	it("invokes a custom fieldComponent for nested array fields", () => {
+		const schema = z.object({
+			components: z
+				.array(
+					z.object({
+						compoundId: z
+							.object({ id: z.string() })
+							.meta({ fieldType: "relation" }),
+					}),
+				)
+				.default([]),
+		});
+
+		const jsonSchema = z.toJSONSchema(schema) as Record<string, unknown>;
+
+		const RelationStub = () => null;
+		const config = buildFieldConfigFromJsonSchema(jsonSchema, {
+			relation: RelationStub,
+		}) as ConfigMap;
+
+		const components = getConfig(config, "components") as ConfigMap;
+		const compoundIdConfig = getConfig(components, "compoundId") as {
+			fieldType?: unknown;
+		};
+
+		// fieldComponents["relation"] should be wired up for the nested array
+		// element field, not just top-level fields.
+		expect(typeof compoundIdConfig.fieldType).toBe("function");
+	});
+
+	it("still propagates per-property configs into nested objects (regression)", () => {
+		const schema = z.object({
+			seo: z.object({
+				title: z.string().meta({ placeholder: "Page title" }),
+			}),
+		});
+
+		const jsonSchema = z.toJSONSchema(schema) as Record<string, unknown>;
+		const config = buildFieldConfigFromJsonSchema(jsonSchema) as ConfigMap;
+		const seo = getConfig(config, "seo") as ConfigMap;
+		const titleConfig = getConfig(seo, "title") as {
+			inputProps?: { placeholder?: string };
+		};
+
+		expect(titleConfig.inputProps?.placeholder).toBe("Page title");
+	});
+
+	it("warns and skips item properties whose names collide with reserved FieldConfigItem keys", () => {
+		const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+
+		const schema = z.object({
+			items: z
+				.array(
+					z.object({
+						// "label" is a reserved key on FieldConfigItem and would
+						// silently overwrite the array's own label if not guarded.
+						label: z.string().meta({ placeholder: "Item label" }),
+						value: z.string().meta({ placeholder: "Item value" }),
+					}),
+				)
+				.default([])
+				.meta({ description: "An array" }),
+		});
+
+		const jsonSchema = z.toJSONSchema(schema) as Record<string, unknown>;
+		const config = buildFieldConfigFromJsonSchema(jsonSchema) as ConfigMap;
+		const items = getConfig(config, "items") as ConfigMap & {
+			description?: string;
+		};
+
+		// The array's own description should remain intact (not overwritten by
+		// a nested item field also named "description").
+		expect(items.description).toBe("An array");
+
+		// Non-reserved item properties propagate normally.
+		const valueConfig = getConfig(items, "value") as {
+			inputProps?: { placeholder?: string };
+		};
+		expect(valueConfig.inputProps?.placeholder).toBe("Item value");
+
+		// The "label" item property collides with a reserved FieldConfigItem
+		// key and must be skipped + warned about.
+		expect(warn).toHaveBeenCalledWith(
+			expect.stringContaining(
+				'Array field "items" has an item property named "label"',
+			),
+		);
+		warn.mockRestore();
+	});
+});

package/src/plugins/cms/api/index.ts

@@ -15,5 +15,6 @@ export {
 export {
 	createCMSContentItem,
 	type CreateCMSContentItemInput,
+	type CreateCMSContentItemOptions,
 } from "./mutations";
 export { CMS_QUERY_KEYS } from "./query-key-defs";