camox 0.13.0 → 0.14.1

package/dist/core/createApp.d.ts

@@ -271,8 +271,10 @@ declare function createApp({
               name: string;
               children: (item: any, index: number) => React.ReactNode;
             }) => React.ReactNode;
+            useSetting: (name: string) => unknown;
           }, index: number) => React.ReactNode;
         }) => React.ReactNode;
+        useSetting: <F extends string>(name: F) => never;
       }, index: number) => React.ReactNode;
     }) => _$react_jsx_runtime0.JSX.Element;
     useSetting: <K extends string>(name: K) => unknown;
@@ -593,8 +595,10 @@ declare function createApp({
               name: string;
               children: (item: any, index: number) => React.ReactNode;
             }) => React.ReactNode;
+            useSetting: (name: string) => unknown;
           }, index: number) => React.ReactNode;
         }) => React.ReactNode;
+        useSetting: <F extends string>(name: F) => never;
       }, index: number) => React.ReactNode;
     }) => _$react_jsx_runtime0.JSX.Element;
     useSetting: <K extends string>(name: K) => unknown;

package/dist/core/createBlock.d.ts

@@ -1,4 +1,4 @@
-import { EmbedURL, FileValue, ImageValue, LinkValue, ToMarkdownBuilder, Type } from "./lib/contentType.js";
+import { EmbedURL, FileValue, ImageValue, ItemSettingsBrand, LinkValue, ToMarkdownBuilder, Type } from "./lib/contentType.js";
 import * as _$_sinclair_typebox0 from "@sinclair/typebox";
 import { Static, TSchema, Type as Type$1 } from "@sinclair/typebox";
 import * as React from "react";
@@ -61,13 +61,16 @@ interface CreateBlockOptions<TSchemaShape extends Record<string, TSchema> = Reco
   /**
    * Builder for rendering block content as markdown.
    * `c` is a proxy typed on `content` keys — `c.title`, `c.description`, etc.
-   * Each returned entry becomes a paragraph (joined with `\n\n`).
-   * Lines where all referenced fields resolve to empty are omitted at render time.
+   * `s` is a proxy typed on `settings` keys — call a boolean setting with a line
+   * (`s.showCta(c.cta)`) or an enum with a value (`s.variant("banner", [...])`)
+   * to wrap lines in a conditional. Each returned entry becomes a paragraph
+   * (joined with `\n\n`). Lines where all referenced fields resolve to empty
+   * (or whose condition is false) are omitted at render time.
    *
    * @example
-   * toMarkdown: (c) => [`# ${c.title}`, c.description, c.illustration, c.cta]
+   * toMarkdown: (c, s) => [`# ${c.title}`, c.description, s.showCta(c.cta)]
    */
-  toMarkdown: ToMarkdownBuilder<TSchemaShape>;
+  toMarkdown: ToMarkdownBuilder<TSchemaShape, TSettingsShape>;
 }
 interface BlockData<TContent> {
   _id: number;
@@ -90,6 +93,7 @@ interface PeekItem {
   parentItemId: number | null;
   fieldName: string;
   content: unknown;
+  settings: Record<string, unknown> | null;
   summary: string;
   position: string;
   createdAt: number;
@@ -100,6 +104,7 @@ interface RepeatableItemSeed {
   parentTempId: string | null;
   fieldName: string;
   content: Record<string, unknown>;
+  settings?: Record<string, unknown>;
   position: string;
 }
 declare function createBlock<TSchemaShape extends Record<string, TSchema>, TSettingsShape extends Record<string, TSchema> = Record<string, never>, TLayoutOnly extends boolean = false>(options: CreateBlockOptions<TSchemaShape, TSettingsShape, TLayoutOnly>): {
@@ -1055,8 +1060,30 @@ declare function createBlock<TSchemaShape extends Record<string, TSchema>, TSett
             name: string;
             children: (item: any, index: number) => React.ReactNode;
           }) => React.ReactNode;
+          useSetting: (name: string) => unknown;
         }, index: number) => React.ReactNode;
       }) => React.ReactNode;
+      useSetting: <F extends keyof (TSchemaShape[K] extends {
+        readonly [ItemSettingsBrand]?: infer S;
+      } ? S extends Record<string, TSchema> ? _$_sinclair_typebox0.Evaluate<Readonly<Partial<Pick<{ [K_6 in keyof S]: (S[K_6] & {
+        params: unknown[] & [];
+      })["static"] }, { [K_7 in keyof S]: S[K_7] extends _$_sinclair_typebox0.TReadonly<TSchema> ? S[K_7] extends _$_sinclair_typebox0.TOptional<S[K_7]> ? K_7 : never : never }[keyof S]>>> & Readonly<Pick<{ [K_6 in keyof S]: (S[K_6] & {
+        params: unknown[] & [];
+      })["static"] }, { [K_8 in keyof S]: S[K_8] extends _$_sinclair_typebox0.TReadonly<TSchema> ? S[K_8] extends _$_sinclair_typebox0.TOptional<S[K_8]> ? never : K_8 : never }[keyof S]>> & Partial<Pick<{ [K_6 in keyof S]: (S[K_6] & {
+        params: unknown[] & [];
+      })["static"] }, { [K_9 in keyof S]: S[K_9] extends _$_sinclair_typebox0.TOptional<TSchema> ? S[K_9] extends _$_sinclair_typebox0.TReadonly<S[K_9]> ? never : K_9 : never }[keyof S]>> & Required<Pick<{ [K_6 in keyof S]: (S[K_6] & {
+        params: unknown[] & [];
+      })["static"] }, Exclude<keyof S, { [K_7 in keyof S]: S[K_7] extends _$_sinclair_typebox0.TReadonly<TSchema> ? S[K_7] extends _$_sinclair_typebox0.TOptional<S[K_7]> ? K_7 : never : never }[keyof S] | { [K_8 in keyof S]: S[K_8] extends _$_sinclair_typebox0.TReadonly<TSchema> ? S[K_8] extends _$_sinclair_typebox0.TOptional<S[K_8]> ? never : K_8 : never }[keyof S] | { [K_9 in keyof S]: S[K_9] extends _$_sinclair_typebox0.TOptional<TSchema> ? S[K_9] extends _$_sinclair_typebox0.TReadonly<S[K_9]> ? never : K_9 : never }[keyof S]>>>> : Record<string, never> : Record<string, never>)>(name: F) => (TSchemaShape[K] extends {
+        readonly [ItemSettingsBrand]?: infer S;
+      } ? S extends Record<string, TSchema> ? _$_sinclair_typebox0.Evaluate<Readonly<Partial<Pick<{ [K_6 in keyof S]: (S[K_6] & {
+        params: unknown[] & [];
+      })["static"] }, { [K_7 in keyof S]: S[K_7] extends _$_sinclair_typebox0.TReadonly<TSchema> ? S[K_7] extends _$_sinclair_typebox0.TOptional<S[K_7]> ? K_7 : never : never }[keyof S]>>> & Readonly<Pick<{ [K_6 in keyof S]: (S[K_6] & {
+        params: unknown[] & [];
+      })["static"] }, { [K_8 in keyof S]: S[K_8] extends _$_sinclair_typebox0.TReadonly<TSchema> ? S[K_8] extends _$_sinclair_typebox0.TOptional<S[K_8]> ? never : K_8 : never }[keyof S]>> & Partial<Pick<{ [K_6 in keyof S]: (S[K_6] & {
+        params: unknown[] & [];
+      })["static"] }, { [K_9 in keyof S]: S[K_9] extends _$_sinclair_typebox0.TOptional<TSchema> ? S[K_9] extends _$_sinclair_typebox0.TReadonly<S[K_9]> ? never : K_9 : never }[keyof S]>> & Required<Pick<{ [K_6 in keyof S]: (S[K_6] & {
+        params: unknown[] & [];
+      })["static"] }, Exclude<keyof S, { [K_7 in keyof S]: S[K_7] extends _$_sinclair_typebox0.TReadonly<TSchema> ? S[K_7] extends _$_sinclair_typebox0.TOptional<S[K_7]> ? K_7 : never : never }[keyof S] | { [K_8 in keyof S]: S[K_8] extends _$_sinclair_typebox0.TReadonly<TSchema> ? S[K_8] extends _$_sinclair_typebox0.TOptional<S[K_8]> ? never : K_8 : never }[keyof S] | { [K_9 in keyof S]: S[K_9] extends _$_sinclair_typebox0.TOptional<TSchema> ? S[K_9] extends _$_sinclair_typebox0.TReadonly<S[K_9]> ? never : K_9 : never }[keyof S]>>>> : Record<string, never> : Record<string, never>)[F];
     }, index: number) => React.ReactNode;
   }) => _$react_jsx_runtime0.JSX.Element;
   useSetting: <K extends keyof (TSettingsShape extends Record<string, never> ? Record<string, never> : _$_sinclair_typebox0.Evaluate<Readonly<Partial<Pick<{ [K_1 in keyof TSettingsShape]: (TSettingsShape[K_1] & {

package/dist/core/createBlock.js

@@ -67,6 +67,7 @@ function buildInitialSeeds(properties, parentTempId, content, allSeeds, counter)
 			if (propSchema.type === "array" && propSchema.items?.properties) continue;
 			if ("default" in propSchema) itemContent[propName] = propSchema.default;
 		}
+		const itemSettingsDefaults = fieldSchema.defaultItemSettings;
 		const markers = [];
 		let prevPosition = null;
 		for (let i = 0; i < defaultCount; i++) {
@@ -78,6 +79,7 @@ function buildInitialSeeds(properties, parentTempId, content, allSeeds, counter)
 				parentTempId,
 				fieldName,
 				content: { ...itemContent },
+				settings: itemSettingsDefaults ? { ...itemSettingsDefaults } : void 0,
 				position
 			});
 			markers.push({ _itemId: tempId });
@@ -102,6 +104,7 @@ function buildPeekItems(properties, blockId, parentItemId, content, allItems, co
 			if (propSchema.type === "array" && propSchema.items?.properties) continue;
 			if ("default" in propSchema) itemContent[propName] = propSchema.default;
 		}
+		const itemSettingsDefaults = fieldSchema.defaultItemSettings;
 		const markers = [];
 		let prevPosition = null;
 		for (let i = 0; i < defaultCount; i++) {
@@ -114,6 +117,7 @@ function buildPeekItems(properties, blockId, parentItemId, content, allItems, co
 				parentItemId,
 				fieldName,
 				content: { ...itemContent },
+				settings: itemSettingsDefaults ? { ...itemSettingsDefaults } : null,
 				summary: "",
 				position,
 				createdAt: 0,
@@ -139,7 +143,7 @@ function createBlock(options) {
 		description: options.description,
 		properties: typeboxSchema.properties,
 		required: Object.keys(options.content),
-		toMarkdown: resolveToMarkdown(options.toMarkdown)
+		toMarkdown: resolveToMarkdown(options.toMarkdown, options.settings, "block")
 	};
 	const settingsTypeboxSchema = options.settings ? Type$1.Object(options.settings) : null;
 	const settingsSchema = settingsTypeboxSchema ? {
@@ -157,12 +161,14 @@ function createBlock(options) {
 		contentDefaultsForStorage[key] = prop.default;
 	}
 	const repeatableItemDefaults = {};
+	const repeatableItemSettingsDefaults = {};
 	for (const [key, prop] of Object.entries(typeboxSchema.properties)) {
 		const p = prop;
 		if (p.type === "array" && p.items?.properties) {
 			const itemDefaults = {};
 			for (const [itemKey, itemProp] of Object.entries(p.items.properties)) if (itemProp && typeof itemProp === "object" && "default" in itemProp) itemDefaults[itemKey] = itemProp.default;
 			if (Object.keys(itemDefaults).length > 0) repeatableItemDefaults[key] = itemDefaults;
+			if (p.defaultItemSettings && typeof p.defaultItemSettings === "object") repeatableItemSettingsDefaults[key] = p.defaultItemSettings;
 		}
 	}
 	const settingsDefaults = {};
@@ -761,7 +767,9 @@ function createBlock(options) {
 		const repeaterContext = React.use(RepeaterItemContext);
 		const { filesMap } = useNormalizedData();
 		const rawSource = repeaterContext ? repeaterContext.itemContent[name] : content[name];
-		const fieldValue = (isFileMarker(rawSource) ? resolveFileMarker(rawSource, filesMap) : rawSource) ?? contentDefaults[String(name)];
+		const rawValue = isFileMarker(rawSource) ? resolveFileMarker(rawSource, filesMap) : rawSource;
+		const defaultValue = repeaterContext ? repeatableItemDefaults[repeaterContext.arrayFieldName]?.[String(name)] : contentDefaults[String(name)];
+		const fieldValue = rawValue ?? defaultValue;
 		const t1 = String(name);
 		let t2;
 		if ($[0] !== blockId || $[1] !== repeaterContext || $[2] !== t1) {
@@ -870,7 +878,7 @@ function createBlock(options) {
 		return t14;
 	};
 	const File = (t0) => {
-		const $ = c(7);
+		const $ = c(8);
 		const { name, children } = t0;
 		const blockContext = React.use(Context);
 		if (!blockContext) throw new Error("File must be used within a Block Component");
@@ -879,8 +887,10 @@ function createBlock(options) {
 		const { filesMap } = useNormalizedData();
 		const rawSource = repeaterContext ? repeaterContext.itemContent[name] : content[name];
 		let t1;
-		if ($[0] !== children || $[1] !== filesMap || $[2] !== name || $[3] !== rawSource) {
-			const fieldValue = (isFileMarker(rawSource) ? resolveFileMarker(rawSource, filesMap) : rawSource) ?? contentDefaults[String(name)];
+		if ($[0] !== children || $[1] !== filesMap || $[2] !== name || $[3] !== rawSource || $[4] !== repeaterContext) {
+			const rawValue = isFileMarker(rawSource) ? resolveFileMarker(rawSource, filesMap) : rawSource;
+			const defaultValue = repeaterContext ? repeatableItemDefaults[repeaterContext.arrayFieldName]?.[String(name)] : contentDefaults[String(name)];
+			const fieldValue = rawValue ?? defaultValue;
 			t1 = children({
 				href: fieldValue.url,
 				download: fieldValue.filename
@@ -889,14 +899,15 @@ function createBlock(options) {
 			$[1] = filesMap;
 			$[2] = name;
 			$[3] = rawSource;
-			$[4] = t1;
-		} else t1 = $[4];
+			$[4] = repeaterContext;
+			$[5] = t1;
+		} else t1 = $[5];
 		let t2;
-		if ($[5] !== t1) {
+		if ($[6] !== t1) {
 			t2 = /* @__PURE__ */ jsx(Fragment, { children: t1 });
-			$[5] = t1;
-			$[6] = t2;
-		} else t2 = $[6];
+			$[6] = t1;
+			$[7] = t2;
+		} else t2 = $[7];
 		return t2;
 	};
 	const RepeaterItemWrapper = (t0) => {
@@ -968,92 +979,141 @@ function createBlock(options) {
 		return t3;
 	};
 	const Repeater = (t0) => {
-		const $ = c(10);
+		const $ = c(28);
 		const { name, children } = t0;
 		const blockContext = React.use(Context);
 		if (!blockContext) throw new Error("Repeater must be used within a Block Component");
 		const { blockId, content, mode } = blockContext;
 		const parentRepeaterContext = React.use(RepeaterItemContext);
 		const fieldName = String(name);
-		const itemComponents = {
-			Field,
-			Link,
-			Embed,
-			Image,
-			File,
-			Repeater
-		};
+		const ItemField = Field;
+		const ItemLink = Link;
+		const ItemEmbed = Embed;
+		const ItemImage = Image;
+		const ItemFile = File;
+		const ItemRepeater = Repeater;
 		const source = parentRepeaterContext ? parentRepeaterContext.itemContent[name] : content[name];
 		const { itemsMap } = useNormalizedData();
-		let arrayValue = source ?? [];
-		if (!Array.isArray(arrayValue)) throw new Error(`Field "${String(name)}" is not an array`);
+		let T0;
 		let t1;
-		if ($[0] !== itemsMap) {
-			t1 = (item) => {
-				if (isItemMarker(item)) return itemsMap.get(item._itemId) ?? null;
-				return item;
-			};
-			$[0] = itemsMap;
-			$[1] = t1;
-		} else t1 = $[1];
-		arrayValue = arrayValue.map(t1).filter(Boolean);
-		if (arrayValue.length === 0) {
-			const fieldSchema = parentRepeaterContext ? typeboxSchema.properties[parentRepeaterContext.arrayFieldName]?.items?.properties?.[fieldName] : typeboxSchema.properties[fieldName];
-			const ait = fieldSchema?.arrayItemType;
-			if (ait === "Image" || ait === "File") {
-				const defaultCount = fieldSchema.defaultItems ?? 0;
-				const itemProps = fieldSchema.items?.properties;
-				if (defaultCount > 0 && itemProps) {
-					let t2;
-					if ($[2] !== defaultCount || $[3] !== itemProps) {
-						const itemContent = {};
-						for (const [propName, propSchema] of Object.entries(itemProps)) if (propSchema && typeof propSchema === "object" && "default" in propSchema) itemContent[propName] = propSchema.default;
-						t2 = Array.from({ length: defaultCount }, () => ({ ...itemContent }));
-						$[2] = defaultCount;
-						$[3] = itemProps;
-						$[4] = t2;
-					} else t2 = $[4];
-					arrayValue = t2;
+		let t2;
+		let t3;
+		if ($[0] !== blockId || $[1] !== children || $[2] !== fieldName || $[3] !== itemsMap || $[4] !== mode || $[5] !== name || $[6] !== parentRepeaterContext || $[7] !== source) {
+			let arrayValue = source ?? [];
+			if (!Array.isArray(arrayValue)) throw new Error(`Field "${String(name)}" is not an array`);
+			let t4;
+			if ($[12] !== itemsMap) {
+				t4 = (item) => {
+					if (isItemMarker(item)) return itemsMap.get(item._itemId) ?? null;
+					return item;
+				};
+				$[12] = itemsMap;
+				$[13] = t4;
+			} else t4 = $[13];
+			arrayValue = arrayValue.map(t4).filter(Boolean);
+			if (arrayValue.length === 0) {
+				const fieldSchema = parentRepeaterContext ? typeboxSchema.properties[parentRepeaterContext.arrayFieldName]?.items?.properties?.[fieldName] : typeboxSchema.properties[fieldName];
+				const ait = fieldSchema?.arrayItemType;
+				if (ait === "Image" || ait === "File") {
+					const defaultCount = fieldSchema.defaultItems ?? 0;
+					const itemProps = fieldSchema.items?.properties;
+					if (defaultCount > 0 && itemProps) {
+						let t5;
+						if ($[14] !== defaultCount || $[15] !== itemProps) {
+							const itemContent = {};
+							for (const [propName, propSchema] of Object.entries(itemProps)) if (propSchema && typeof propSchema === "object" && "default" in propSchema) itemContent[propName] = propSchema.default;
+							t5 = Array.from({ length: defaultCount }, () => ({ ...itemContent }));
+							$[14] = defaultCount;
+							$[15] = itemProps;
+							$[16] = t5;
+						} else t5 = $[16];
+						arrayValue = t5;
+					}
 				}
 			}
+			const settingsDefaultsForField = repeatableItemSettingsDefaults[fieldName];
+			T0 = RepeaterHoverProvider;
+			t1 = blockId;
+			t2 = fieldName;
+			let t5;
+			if ($[17] !== blockId || $[18] !== children || $[19] !== fieldName || $[20] !== mode || $[21] !== settingsDefaultsForField) {
+				t5 = (item_0, index) => {
+					const isDbItem = item_0.content !== void 0 && item_0.id != null;
+					const itemContent_0 = {
+						...repeatableItemDefaults[fieldName],
+						...isDbItem ? item_0.content : item_0
+					};
+					const itemSettings = {
+						...settingsDefaultsForField,
+						...(isDbItem ? item_0.settings : null) ?? {}
+					};
+					const itemId = isDbItem ? item_0.id : void 0;
+					const useItemSetting = (settingName) => itemSettings[settingName];
+					const itemApi = {
+						Field: ItemField,
+						Link: ItemLink,
+						Embed: ItemEmbed,
+						Image: ItemImage,
+						File: ItemFile,
+						Repeater: ItemRepeater,
+						useSetting: useItemSetting
+					};
+					return /* @__PURE__ */ jsx(RepeaterItemContext.Provider, {
+						value: {
+							arrayFieldName: fieldName,
+							itemIndex: index,
+							itemContent: itemContent_0,
+							itemSettings,
+							itemId
+						},
+						children: /* @__PURE__ */ jsx(RepeaterItemWrapper, {
+							itemId,
+							blockId,
+							mode,
+							children: children(itemApi, index)
+						})
+					}, itemId ?? index);
+				};
+				$[17] = blockId;
+				$[18] = children;
+				$[19] = fieldName;
+				$[20] = mode;
+				$[21] = settingsDefaultsForField;
+				$[22] = t5;
+			} else t5 = $[22];
+			t3 = arrayValue.map(t5);
+			$[0] = blockId;
+			$[1] = children;
+			$[2] = fieldName;
+			$[3] = itemsMap;
+			$[4] = mode;
+			$[5] = name;
+			$[6] = parentRepeaterContext;
+			$[7] = source;
+			$[8] = T0;
+			$[9] = t1;
+			$[10] = t2;
+			$[11] = t3;
+		} else {
+			T0 = $[8];
+			t1 = $[9];
+			t2 = $[10];
+			t3 = $[11];
 		}
-		const T0 = RepeaterHoverProvider;
-		const t2 = arrayValue.map((item_0, index) => {
-			const isDbItem = item_0.content !== void 0 && item_0.id != null;
-			const itemContent_0 = {
-				...repeatableItemDefaults[fieldName],
-				...isDbItem ? item_0.content : item_0
-			};
-			const itemId = isDbItem ? item_0.id : void 0;
-			return /* @__PURE__ */ jsx(RepeaterItemContext.Provider, {
-				value: {
-					arrayFieldName: fieldName,
-					itemIndex: index,
-					itemContent: itemContent_0,
-					itemId
-				},
-				children: /* @__PURE__ */ jsx(RepeaterItemWrapper, {
-					itemId,
-					blockId,
-					mode,
-					children: children(itemComponents, index)
-				})
-			}, itemId ?? index);
-		});
-		let t3;
-		if ($[5] !== T0 || $[6] !== blockId || $[7] !== fieldName || $[8] !== t2) {
-			t3 = /* @__PURE__ */ jsx(T0, {
-				blockId,
-				fieldName,
-				children: t2
+		let t4;
+		if ($[23] !== T0 || $[24] !== t1 || $[25] !== t2 || $[26] !== t3) {
+			t4 = /* @__PURE__ */ jsx(T0, {
+				blockId: t1,
+				fieldName: t2,
+				children: t3
 			});
-			$[5] = T0;
-			$[6] = blockId;
-			$[7] = fieldName;
-			$[8] = t2;
-			$[9] = t3;
-		} else t3 = $[9];
-		return t3;
+			$[23] = T0;
+			$[24] = t1;
+			$[25] = t2;
+			$[26] = t3;
+			$[27] = t4;
+		} else t4 = $[27];
+		return t4;
 	};
 	const BlockComponent = (t0) => {
 		const $ = c(69);

package/dist/core/lib/contentType.d.ts

@@ -1,5 +1,5 @@
 import * as _$_sinclair_typebox0 from "@sinclair/typebox";
-import { TArray, TObject, TSchema, TUnsafe } from "@sinclair/typebox";
+import { Static, TArray, TObject, TSchema, TUnsafe } from "@sinclair/typebox";
 
 //#region src/core/lib/contentType.d.ts
 declare class FieldToken {
@@ -7,12 +7,40 @@ declare class FieldToken {
   constructor(fieldName: string);
   toString(): string;
 }
+type SettingsScope = "block" | "item";
+/**
+ * Serializable conditional block produced by the settings proxy. Emits Handlebars-style
+ * `{{#if ...}}...{{/if}}` syntax wrapping each child line, tagged with its scope so the
+ * server-side resolver knows whether to read from `settings` or `itemSettings`.
+ */
+declare class Conditional {
+  readonly scope: SettingsScope;
+  readonly settingName: string;
+  readonly enumValue: string | null;
+  readonly children: ReadonlyArray<string | FieldToken | Conditional>;
+  constructor(scope: SettingsScope, settingName: string, enumValue: string | null, children: ReadonlyArray<string | FieldToken | Conditional>);
+  get openTag(): string;
+  get closeTag(): string;
+}
+type ConditionalChild = string | FieldToken | Conditional;
+type ConditionalLines = ConditionalChild | ReadonlyArray<ConditionalChild>;
 type ContentProxy<TShape extends Record<string, TSchema>> = { [K in keyof TShape & string]: FieldToken };
-type ToMarkdownBuilder<TShape extends Record<string, TSchema>> = (c: ContentProxy<TShape>) => ReadonlyArray<string | FieldToken>;
+/**
+ * Callable shape for one entry on the settings proxy. Booleans take a single `lines`
+ * argument; enums take `(value, lines)`. Settings of other shapes are disallowed — they
+ * don't make sense as conditions.
+ */
+type SettingCallable<T extends TSchema> = Static<T> extends boolean ? (lines: ConditionalLines) => Conditional : Static<T> extends string ? (value: Static<T>, lines: ConditionalLines) => Conditional : never;
+type SettingsProxy<TShape extends Record<string, TSchema>> = { [K in keyof TShape & string]: SettingCallable<TShape[K]> };
+type ToMarkdownBuilder<TContent extends Record<string, TSchema>, TSettings extends Record<string, TSchema> = Record<string, never>> = (c: ContentProxy<TContent>, s: SettingsProxy<TSettings>) => ReadonlyArray<string | FieldToken | Conditional>;
 declare const EmbedURLBrand: unique symbol;
 type EmbedURL = string & {
   readonly [EmbedURLBrand]: true;
 };
+declare const ItemSettingsBrand: unique symbol;
+type WithItemSettings<S extends Record<string, TSchema>> = {
+  readonly [ItemSettingsBrand]?: S;
+};
 declare const LinkBrand: unique symbol;
 type LinkValue = ({
   type: "external";
@@ -91,25 +119,33 @@ declare const Type$1: {
    * Creates a repeatable array of object items.
    * The default array is auto-generated based on minItems.
    *
+   * Items may also declare per-item `settings` (Enum/Boolean only) — not
+   * inline-editable; they appear in the sidebar when the item is selected,
+   * similar to block-level settings.
+   *
    * @example
    * Type.RepeatableItem({
    *   content: {
    *     title: Type.String({ default: 'Item' }),
    *     description: Type.String({ default: 'Description' }),
    *   },
+   *   settings: {
+   *     highlighted: Type.Boolean({ default: false, title: 'Highlighted' }),
+   *   },
    *   minItems: 1,
    *   maxItems: 10,
    *   title: 'Items',
    *   toMarkdown: (c) => [`### ${c.title}`, c.description],
    * })
    */
-  RepeatableItem: <T extends Record<string, TSchema>>(options: {
+  RepeatableItem: <T extends Record<string, TSchema>, S extends Record<string, TSchema> = Record<string, never>>(options: {
     content: T;
+    settings?: S;
     minItems: number;
     maxItems: number;
     title?: string;
-    toMarkdown: ToMarkdownBuilder<T>;
-  }) => TArray<TObject<T>>;
+    toMarkdown: ToMarkdownBuilder<T, S>;
+  }) => TArray<TObject<T>> & WithItemSettings<S>;
   /**
    * Creates an enum field with a set of predefined options.
    *
@@ -120,11 +156,11 @@ declare const Type$1: {
    *   title: 'Alignment'
    * })
    */
-  Enum: (options: {
-    default: string;
-    options: Record<string, string>;
+  Enum: <const O extends Record<string, string>>(options: {
+    default: keyof O & string;
+    options: O;
     title?: string;
-  }) => TUnsafe<string>;
+  }) => TUnsafe<keyof O & string>;
   /**
    * Creates a boolean toggle field.
    *
@@ -169,4 +205,4 @@ declare const Type$1: {
   File: typeof _fileType;
 };
 //#endregion
-export { EmbedURL, FileValue, ImageValue, LinkValue, ToMarkdownBuilder, Type$1 as Type };
+export { EmbedURL, FileValue, ImageValue, ItemSettingsBrand, LinkValue, ToMarkdownBuilder, Type$1 as Type };

package/dist/core/lib/contentType.js

@@ -9,14 +9,55 @@ var FieldToken = class {
 		return `{{${this.fieldName}}}`;
 	}
 };
+/**
+* Serializable conditional block produced by the settings proxy. Emits Handlebars-style
+* `{{#if ...}}...{{/if}}` syntax wrapping each child line, tagged with its scope so the
+* server-side resolver knows whether to read from `settings` or `itemSettings`.
+*/
+var Conditional = class {
+	constructor(scope, settingName, enumValue, children) {
+		this.scope = scope;
+		this.settingName = settingName;
+		this.enumValue = enumValue;
+		this.children = children;
+	}
+	get openTag() {
+		const root = this.scope === "block" ? "settings" : "itemSettings";
+		if (this.enumValue === null) return `{{#if ${root}.${this.settingName}}}`;
+		return `{{#if (eq ${root}.${this.settingName} "${this.enumValue}")}}`;
+	}
+	get closeTag() {
+		return "{{/if}}";
+	}
+};
 function createContentProxy() {
 	return new Proxy({}, { get(_target, prop) {
 		if (typeof prop !== "string") return void 0;
 		return new FieldToken(prop);
 	} });
 }
-function resolveToMarkdown(builder) {
-	return builder(createContentProxy()).map((entry) => entry instanceof FieldToken ? entry.toString() : String(entry));
+function createSettingsProxy(settingsShape, scope) {
+	return new Proxy({}, { get(_target, prop) {
+		if (typeof prop !== "string") return void 0;
+		const fieldType = (settingsShape?.[prop])?.fieldType;
+		if (fieldType === "Boolean") return (lines) => new Conditional(scope, prop, null, Array.isArray(lines) ? lines : [lines]);
+		if (fieldType === "Enum") return (value, lines) => new Conditional(scope, prop, value, Array.isArray(lines) ? lines : [lines]);
+		throw new Error(`toMarkdown settings proxy: "${prop}" is not a Boolean or Enum setting on this ${scope}.`);
+	} });
+}
+/** Flatten a `Conditional`'s children into wrapped lines, recursing into nested Conditionals. */
+function serializeConditional(cond) {
+	const out = [];
+	for (const child of cond.children) if (child instanceof Conditional) for (const nested of serializeConditional(child)) out.push(`${cond.openTag}${nested}${cond.closeTag}`);
+	else out.push(`${cond.openTag}${String(child)}${cond.closeTag}`);
+	return out;
+}
+function resolveToMarkdown(builder, settingsShape, scope) {
+	const entries = builder(createContentProxy(), createSettingsProxy(settingsShape, scope));
+	const out = [];
+	for (const entry of entries) if (entry instanceof Conditional) out.push(...serializeConditional(entry));
+	else out.push(entry instanceof FieldToken ? entry.toString() : String(entry));
+	return out;
 }
 function _imageType(options) {
 	const imageDefault = {
@@ -102,13 +143,25 @@ const Type$1 = {
 		const defaultItem = {};
 		for (const [key, prop] of Object.entries(objectSchema.properties)) if ("default" in prop) defaultItem[key] = prop.default;
 		const defaultArray = Array(options.minItems).fill(null).map(() => ({ ...defaultItem }));
+		const settingsTypeboxSchema = options.settings ? Type.Object(options.settings) : null;
+		const itemSettingsSchema = settingsTypeboxSchema ? {
+			type: "object",
+			properties: settingsTypeboxSchema.properties,
+			required: Object.keys(options.settings)
+		} : void 0;
+		const defaultItemSettings = {};
+		if (settingsTypeboxSchema) {
+			for (const [key, prop] of Object.entries(settingsTypeboxSchema.properties)) if ("default" in prop) defaultItemSettings[key] = prop.default;
+		}
 		return Type.Array(objectSchema, {
 			minItems: options.minItems,
 			maxItems: options.maxItems,
 			default: defaultArray,
 			title: options.title,
 			fieldType: "RepeatableItem",
-			toMarkdown: resolveToMarkdown(options.toMarkdown)
+			toMarkdown: resolveToMarkdown(options.toMarkdown, options.settings, "item"),
+			itemSettingsSchema,
+			defaultItemSettings: settingsTypeboxSchema ? defaultItemSettings : void 0
 		});
 	},
 	Enum: (options) => {

package/dist/features/preview/components/AddBlockSheet.js

@@ -254,7 +254,7 @@ const AddBlockSheet = () => {
 	} else t15 = $[30];
 	const t16 = "flex-1 overflow-auto p-2";
 	const T1 = Command;
-	const t17 = "bg-background overflow-visible";
+	const t17 = "overflow-visible";
 	const t18 = _temp7;
 	let t19;
 	if ($[31] === Symbol.for("react.memo_cache_sentinel")) {
@@ -286,10 +286,13 @@ const AddBlockSheet = () => {
 				handleAddBlock(block_3);
 			},
 			className: "group flex items-center justify-between gap-2",
-			children: [/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("span", { children: block_3._internal.title }), /* @__PURE__ */ jsx("span", {
-				className: "text-muted-foreground block",
-				children: displayCount(block_3._internal.id)
-			})] }), /* @__PURE__ */ jsxs(Tooltip, { children: [/* @__PURE__ */ jsx(TooltipTrigger, {
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: "flex-1",
+				children: [/* @__PURE__ */ jsx("span", { children: block_3._internal.title }), /* @__PURE__ */ jsx("span", {
+					className: "text-muted-foreground block",
+					children: displayCount(block_3._internal.id)
+				})]
+			}), /* @__PURE__ */ jsxs(Tooltip, { children: [/* @__PURE__ */ jsx(TooltipTrigger, {
 				className: "hidden group-focus-within:flex group-hover:flex",
 				children: /* @__PURE__ */ jsx(InfoIcon, {})
 			}), /* @__PURE__ */ jsx(TooltipContent, {

package/dist/features/preview/components/AgentChatSheet.js

@@ -20,7 +20,7 @@ const AgentChatSheet = () => {
 			className: "flex flex-1 items-center justify-center p-6",
 			children: /* @__PURE__ */ jsx("p", {
 				className: "text-muted-foreground text-center text-sm",
-				children: "Coming soon"
+				children: "Coming soon: MCP server and integrated chat"
 			})
 		});
 		$[1] = t1;