@bettercms-ai/kit 3.1.1 → 3.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -30,6 +30,7 @@ function SlotField({ field, path }) {
30
30
  const write = (next) => form.setAt(path, ensureKeys(next));
31
31
  const ops = useListOps(field, path, list, write, (i) => drill?.([...path, i]));
32
32
  const available = useAvailableBlocks(field);
33
+ const unavailable = useUnavailableBlocks(field);
33
34
  const rows = list.map((it, i) => {
34
35
  const type = isObj(it) && typeof it._type === "string" ? it._type : "";
35
36
  return {
@@ -78,6 +79,7 @@ function SlotField({ field, path }) {
78
79
  emptyLabel: "No blocks yet. Add one to start composing.",
79
80
  addButton: /* @__PURE__ */ jsx(BlockPicker, {
80
81
  blocks: available,
82
+ unavailable,
81
83
  disabled: readOnly || ops.atMax,
82
84
  onPick: (b) => ops.add(newBlock(b, field.slotSettings))
83
85
  })
@@ -98,14 +100,38 @@ function useAvailableBlocks(field) {
98
100
  form.resolveSchema
99
101
  ]);
100
102
  }
101
- function BlockPicker({ blocks, onPick, disabled, label = "Add block" }) {
103
+ /** BL-595: the allow list's names no library or resolver knows — listed in the picker, disabled, with why. */
104
+ function useUnavailableBlocks(field) {
105
+ const form = useForm();
106
+ const allow = slotAllow(field);
107
+ return React.useMemo(() => {
108
+ const lib = form.blockLibrary ?? [];
109
+ return (allow ?? []).filter((t) => !lib.some((b) => b.name === t) && !form.resolveSchema?.(t)).map((t) => ({
110
+ block: {
111
+ name: t,
112
+ title: t,
113
+ kind: "block",
114
+ fields: []
115
+ },
116
+ reason: MISSING_BLOCK
117
+ }));
118
+ }, [
119
+ allow?.join("|"),
120
+ form.blockLibrary,
121
+ form.resolveSchema
122
+ ]);
123
+ }
124
+ var MISSING_BLOCK = "This block isn't in the block library, so it can't be added here.";
125
+ function BlockPicker({ blocks, unavailable = [], onPick, disabled, label = "Add block" }) {
102
126
  const [open, setOpen] = React.useState(false);
103
127
  const [q, setQ] = React.useState("");
104
128
  const [active, setActive] = React.useState(0);
105
- const list = blocks.filter((b) => !q || `${b.title} ${b.category ?? ""} ${b.description ?? ""}`.toLowerCase().includes(q.toLowerCase()));
129
+ const why = new Map(unavailable.map((u) => [u.block, u.reason]));
130
+ const list = [...blocks, ...unavailable.map((u) => u.block)].filter((b) => !q || `${b.title} ${b.category ?? ""} ${b.description ?? ""}`.toLowerCase().includes(q.toLowerCase()));
106
131
  const cats = Array.from(new Set(list.map((b) => b.category ?? "Blocks")));
107
132
  const flat = cats.flatMap((c) => list.filter((b) => (b.category ?? "Blocks") === c));
108
133
  const pick = (b) => {
134
+ if (why.has(b)) return;
109
135
  onPick(b);
110
136
  setOpen(false);
111
137
  setQ("");
@@ -174,15 +200,17 @@ function BlockPicker({ blocks, onPick, disabled, label = "Add block" }) {
174
200
  children: c
175
201
  }), list.filter((b) => (b.category ?? "Blocks") === c).map((b) => {
176
202
  const i = flat.indexOf(b);
203
+ const reason = why.get(b);
177
204
  return /* @__PURE__ */ jsxs("button", {
178
205
  type: "button",
179
206
  role: "option",
180
207
  "aria-selected": i === active,
208
+ "aria-disabled": reason !== void 0 || void 0,
181
209
  onMouseEnter: () => setActive(i),
182
210
  onClick: () => pick(b),
183
- className: cn("flex w-full items-center gap-2.5 rounded-kit-md p-1.5 text-left", i === active && "bg-kit-hover"),
211
+ className: cn("flex w-full items-center gap-2.5 rounded-kit-md p-1.5 text-left", reason !== void 0 && "cursor-not-allowed", i === active && "bg-kit-hover"),
184
212
  children: [/* @__PURE__ */ jsx("span", {
185
- className: "flex size-8 shrink-0 items-center justify-center rounded-kit-md border border-kit-line bg-kit-surface text-kit-fg-2 shadow-kit-xs",
213
+ className: cn("flex size-8 shrink-0 items-center justify-center rounded-kit-md border border-kit-line bg-kit-surface text-kit-fg-2 shadow-kit-xs", reason !== void 0 && "opacity-50"),
186
214
  children: /* @__PURE__ */ jsx(KitIcon, {
187
215
  name: b.icon,
188
216
  className: "size-4"
@@ -190,9 +218,12 @@ function BlockPicker({ blocks, onPick, disabled, label = "Add block" }) {
190
218
  }), /* @__PURE__ */ jsxs("span", {
191
219
  className: "min-w-0 flex-1",
192
220
  children: [/* @__PURE__ */ jsx("span", {
193
- className: "block truncate text-kit-sm text-kit-fg",
221
+ className: cn("block truncate text-kit-sm", reason !== void 0 ? "text-kit-fg-3" : "text-kit-fg"),
194
222
  children: b.title
195
- }), b.description ? /* @__PURE__ */ jsx("span", {
223
+ }), reason !== void 0 ? /* @__PURE__ */ jsx("span", {
224
+ className: "block text-kit-xs text-kit-fg-3",
225
+ children: reason
226
+ }) : b.description ? /* @__PURE__ */ jsx("span", {
196
227
  className: "block truncate text-kit-xs text-kit-fg-3",
197
228
  children: b.description
198
229
  }) : null]
@@ -211,6 +242,6 @@ function BlockPicker({ blocks, onPick, disabled, label = "Add block" }) {
211
242
  });
212
243
  }
213
244
  //#endregion
214
- export { BlockPicker, SlotField, useAvailableBlocks };
245
+ export { BlockPicker, SlotField, useAvailableBlocks, useUnavailableBlocks };
215
246
 
216
247
  //# sourceMappingURL=slot.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"slot.js","names":[],"sources":["../../src/engine/slot.tsx"],"sourcesContent":["/**\n * SLOTS — blocks inside blocks (tabs, columns, bento, carousels, mega-menu panels; V2 HEAD 9829bf1 kit/engine/slot.tsx).\n * Rows show the block icon, its name and a variant chip; \"+ Add block\" opens a compact, searchable block picker;\n * opening a row drills into THAT block's own schema (resolved with `resolveSchema(blockType)`).\n *\n * Drill rows call the RowsHostContext frame push (see array.tsx); with nothing to draw the frame they are inert.\n */\nimport * as React from \"react\";\nimport { IconPlus, IconSearch } from \"@tabler/icons-react\";\nimport { KitIcon } from \"../lib/icons\";\nimport { Button } from \"../ui/button\";\nimport { Popover, PopoverContent, PopoverTrigger } from \"../ui/overlay\";\nimport { cn } from \"../lib/cn\";\nimport type { FieldPath, FieldSchema, TypeSchema } from \"../schema/types\";\nimport { useForm } from \"../context\";\nimport { ensureKeys, isObj, itemId, pathKey } from \"../lib/path\";\nimport { newBlock, slotAllow, slotRowOf } from \"../lib/schema\";\nimport { RowList, useDrill, useListOps, type RowModel } from \"./array\";\nimport { FieldShell } from \"./field-shell\";\nimport { useFieldAccess } from \"./kit-field\";\n\nexport function SlotField({ field, path }: { field: FieldSchema; path: FieldPath }) {\n const form = useForm()!;\n const drill = useDrill();\n const id = React.useId();\n const { readOnly } = useFieldAccess(field);\n const key = pathKey(path);\n const value = form.getAt(path);\n const list = Array.isArray(value) ? value : [];\n const write = (next: unknown[]) => form.setAt(path, ensureKeys(next));\n const ops = useListOps(field, path, list, write, (i) => drill?.([...path, i]));\n const available = useAvailableBlocks(field);\n const rows: RowModel[] = list.map((it, i) => {\n const type = isObj(it) && typeof it._type === \"string\" ? it._type : \"\";\n return { id: itemId(it, i), index: i, item: it, path: [...path, i], ...slotRowOf(form.resolveSchema?.(type), it, i, list.length, field.slotSettings) };\n });\n return (\n <FieldShell\n field={field}\n path={path}\n id={id}\n value={list}\n onChange={(v) => form.setAt(path, v)}\n readOnly={readOnly}\n issue={form.visibleIssue(key)}\n meta={<span className=\"text-kit-xs text-kit-fg-3\">{list.length} {list.length === 1 ? \"block\" : \"blocks\"}{field.validation?.max != null ? ` · max ${field.validation.max}` : \"\"}</span>}\n >\n <RowList\n field={field}\n rows={rows}\n readOnly={readOnly}\n layout=\"list\"\n mode=\"drill\"\n openId={null}\n onOpen={drill && ((r) => drill(r.path))}\n onCloseInline={() => {}}\n ops={ops}\n renderInline={() => null}\n leading={(r) => (\n <span className=\"flex size-7 shrink-0 items-center justify-center rounded-kit-md border border-kit-line bg-kit-control-bg text-kit-fg-2 shadow-kit-xs\">\n <KitIcon name={r.preview.icon} className=\"size-4\" />\n </span>\n )}\n emptyLabel=\"No blocks yet. Add one to start composing.\"\n addButton={<BlockPicker blocks={available} disabled={readOnly || ops.atMax} onPick={(b) => ops.add(newBlock(b, field.slotSettings))} />}\n />\n </FieldShell>\n );\n}\n\n/** Blocks this slot accepts: its allow list resolved through `resolveSchema`, else the whole block library. */\nexport function useAvailableBlocks(field: FieldSchema): TypeSchema[] {\n const form = useForm()!;\n const allow = slotAllow(field);\n return React.useMemo(() => {\n const lib = form.blockLibrary ?? [];\n if (!allow?.length) return lib;\n return allow.map((t) => lib.find((b) => b.name === t) ?? form.resolveSchema?.(t)).filter((b): b is TypeSchema => !!b);\n }, [allow?.join(\"|\"), form.blockLibrary, form.resolveSchema]); // eslint-disable-line react-hooks/exhaustive-deps\n}\n\nexport function BlockPicker({ blocks, onPick, disabled, label = \"Add block\" }: { blocks: TypeSchema[]; onPick: (b: TypeSchema) => void; disabled?: boolean; label?: string }) {\n const [open, setOpen] = React.useState(false);\n const [q, setQ] = React.useState(\"\");\n const [active, setActive] = React.useState(0);\n const list = blocks.filter((b) => !q || `${b.title} ${b.category ?? \"\"} ${b.description ?? \"\"}`.toLowerCase().includes(q.toLowerCase()));\n const cats = Array.from(new Set(list.map((b) => b.category ?? \"Blocks\")));\n const flat = cats.flatMap((c) => list.filter((b) => (b.category ?? \"Blocks\") === c));\n const pick = (b: TypeSchema) => {\n onPick(b);\n setOpen(false);\n setQ(\"\");\n };\n return (\n <Popover open={open} onOpenChange={(o) => { setOpen(o); setQ(\"\"); setActive(0); }}>\n <PopoverTrigger render={<Button size=\"sm\" variant=\"ghost\" className=\"text-kit-fg-2\" leftIcon={<IconPlus stroke={1.5} />} disabled={disabled} />}>{label}</PopoverTrigger>\n <PopoverContent className=\"w-[300px] p-0\" align=\"start\">\n <label\n className=\"flex h-10 items-center gap-2 border-b border-kit-line px-3 text-kit-fg-3\"\n onKeyDown={(e) => {\n if (e.key === \"ArrowDown\") { e.preventDefault(); setActive((a) => (a + 1) % Math.max(1, flat.length)); }\n if (e.key === \"ArrowUp\") { e.preventDefault(); setActive((a) => (a - 1 + flat.length) % Math.max(1, flat.length)); }\n if (e.key === \"Enter\" && flat[active]) { e.preventDefault(); pick(flat[active]); }\n }}\n >\n <IconSearch className=\"size-4 shrink-0\" stroke={1.5} />\n <input autoFocus value={q} onChange={(e) => { setQ(e.target.value); setActive(0); }} placeholder=\"Search blocks\" aria-label=\"Search blocks\" className=\"h-full min-w-0 flex-1 bg-transparent text-kit-sm text-kit-fg outline-none placeholder:text-kit-fg-3\" />\n </label>\n <div className=\"max-h-80 overflow-y-auto p-1\" role=\"listbox\">\n {flat.length === 0 ? <p className=\"px-3 py-6 text-center text-kit-sm text-kit-fg-3\">No blocks match</p> : null}\n {cats.map((c) => (\n <div key={c} className=\"pb-1\">\n <div className=\"px-2 pb-1 pt-1.5 text-kit-2xs font-medium text-kit-fg-3\">{c}</div>\n {list.filter((b) => (b.category ?? \"Blocks\") === c).map((b) => {\n const i = flat.indexOf(b);\n return (\n <button\n key={b.name}\n type=\"button\"\n role=\"option\"\n aria-selected={i === active}\n onMouseEnter={() => setActive(i)}\n onClick={() => pick(b)}\n className={cn(\"flex w-full items-center gap-2.5 rounded-kit-md p-1.5 text-left\", i === active && \"bg-kit-hover\")}\n >\n <span className=\"flex size-8 shrink-0 items-center justify-center rounded-kit-md border border-kit-line bg-kit-surface text-kit-fg-2 shadow-kit-xs\">\n <KitIcon name={b.icon} className=\"size-4\" />\n </span>\n <span className=\"min-w-0 flex-1\">\n <span className=\"block truncate text-kit-sm text-kit-fg\">{b.title}</span>\n {b.description ? <span className=\"block truncate text-kit-xs text-kit-fg-3\">{b.description}</span> : null}\n </span>\n </button>\n );\n })}\n </div>\n ))}\n </div>\n <div data-hint=\"shortcuts\" className=\"border-t border-kit-line px-3 py-1.5 text-kit-2xs text-kit-fg-3\">↵ add · type to search</div>\n </PopoverContent>\n </Popover>\n );\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"slot.js","names":[],"sources":["../../src/engine/slot.tsx"],"sourcesContent":["/**\n * SLOTS — blocks inside blocks (tabs, columns, bento, carousels, mega-menu panels; V2 HEAD 9829bf1 kit/engine/slot.tsx).\n * Rows show the block icon, its name and a variant chip; \"+ Add block\" opens a compact, searchable block picker;\n * opening a row drills into THAT block's own schema (resolved with `resolveSchema(blockType)`).\n *\n * Drill rows call the RowsHostContext frame push (see array.tsx); with nothing to draw the frame they are inert.\n */\nimport * as React from \"react\";\nimport { IconPlus, IconSearch } from \"@tabler/icons-react\";\nimport { KitIcon } from \"../lib/icons\";\nimport { Button } from \"../ui/button\";\nimport { Popover, PopoverContent, PopoverTrigger } from \"../ui/overlay\";\nimport { cn } from \"../lib/cn\";\nimport type { FieldPath, FieldSchema, TypeSchema } from \"../schema/types\";\nimport { useForm } from \"../context\";\nimport { ensureKeys, isObj, itemId, pathKey } from \"../lib/path\";\nimport { newBlock, slotAllow, slotRowOf } from \"../lib/schema\";\nimport { RowList, useDrill, useListOps, type RowModel } from \"./array\";\nimport { FieldShell } from \"./field-shell\";\nimport { useFieldAccess } from \"./kit-field\";\n\nexport function SlotField({ field, path }: { field: FieldSchema; path: FieldPath }) {\n const form = useForm()!;\n const drill = useDrill();\n const id = React.useId();\n const { readOnly } = useFieldAccess(field);\n const key = pathKey(path);\n const value = form.getAt(path);\n const list = Array.isArray(value) ? value : [];\n const write = (next: unknown[]) => form.setAt(path, ensureKeys(next));\n const ops = useListOps(field, path, list, write, (i) => drill?.([...path, i]));\n const available = useAvailableBlocks(field);\n const unavailable = useUnavailableBlocks(field);\n const rows: RowModel[] = list.map((it, i) => {\n const type = isObj(it) && typeof it._type === \"string\" ? it._type : \"\";\n return { id: itemId(it, i), index: i, item: it, path: [...path, i], ...slotRowOf(form.resolveSchema?.(type), it, i, list.length, field.slotSettings) };\n });\n return (\n <FieldShell\n field={field}\n path={path}\n id={id}\n value={list}\n onChange={(v) => form.setAt(path, v)}\n readOnly={readOnly}\n issue={form.visibleIssue(key)}\n meta={<span className=\"text-kit-xs text-kit-fg-3\">{list.length} {list.length === 1 ? \"block\" : \"blocks\"}{field.validation?.max != null ? ` · max ${field.validation.max}` : \"\"}</span>}\n >\n <RowList\n field={field}\n rows={rows}\n readOnly={readOnly}\n layout=\"list\"\n mode=\"drill\"\n openId={null}\n onOpen={drill && ((r) => drill(r.path))}\n onCloseInline={() => {}}\n ops={ops}\n renderInline={() => null}\n leading={(r) => (\n <span className=\"flex size-7 shrink-0 items-center justify-center rounded-kit-md border border-kit-line bg-kit-control-bg text-kit-fg-2 shadow-kit-xs\">\n <KitIcon name={r.preview.icon} className=\"size-4\" />\n </span>\n )}\n emptyLabel=\"No blocks yet. Add one to start composing.\"\n addButton={<BlockPicker blocks={available} unavailable={unavailable} disabled={readOnly || ops.atMax} onPick={(b) => ops.add(newBlock(b, field.slotSettings))} />}\n />\n </FieldShell>\n );\n}\n\n/** Blocks this slot accepts: its allow list resolved through `resolveSchema`, else the whole block library. */\nexport function useAvailableBlocks(field: FieldSchema): TypeSchema[] {\n const form = useForm()!;\n const allow = slotAllow(field);\n return React.useMemo(() => {\n const lib = form.blockLibrary ?? [];\n if (!allow?.length) return lib;\n return allow.map((t) => lib.find((b) => b.name === t) ?? form.resolveSchema?.(t)).filter((b): b is TypeSchema => !!b);\n }, [allow?.join(\"|\"), form.blockLibrary, form.resolveSchema]); // eslint-disable-line react-hooks/exhaustive-deps\n}\n\n/** BL-595: the allow list's names no library or resolver knows — listed in the picker, disabled, with why. */\nexport function useUnavailableBlocks(field: FieldSchema): UnavailableBlock[] {\n const form = useForm()!;\n const allow = slotAllow(field);\n return React.useMemo(() => {\n const lib = form.blockLibrary ?? [];\n return (allow ?? [])\n .filter((t) => !lib.some((b) => b.name === t) && !form.resolveSchema?.(t))\n .map((t) => ({ block: { name: t, title: t, kind: \"block\" as const, fields: [] }, reason: MISSING_BLOCK }));\n }, [allow?.join(\"|\"), form.blockLibrary, form.resolveSchema]); // eslint-disable-line react-hooks/exhaustive-deps\n}\nconst MISSING_BLOCK = \"This block isn't in the block library, so it can't be added here.\";\n\n/** A block the picker lists but cannot add here, and the sentence that says why (as controls/slot.tsx SlotPicker does). */\nexport interface UnavailableBlock {\n block: TypeSchema;\n reason: string;\n}\n\nexport function BlockPicker({\n blocks,\n unavailable = [],\n onPick,\n disabled,\n label = \"Add block\",\n}: {\n blocks: TypeSchema[];\n /** BL-595: blocks shown disabled with their reason, never picked, so an empty list is never a bare \"No blocks match\" */\n unavailable?: UnavailableBlock[];\n onPick: (b: TypeSchema) => void;\n disabled?: boolean;\n label?: string;\n}) {\n const [open, setOpen] = React.useState(false);\n const [q, setQ] = React.useState(\"\");\n const [active, setActive] = React.useState(0);\n const why = new Map(unavailable.map((u) => [u.block, u.reason]));\n const list = [...blocks, ...unavailable.map((u) => u.block)].filter((b) => !q || `${b.title} ${b.category ?? \"\"} ${b.description ?? \"\"}`.toLowerCase().includes(q.toLowerCase()));\n const cats = Array.from(new Set(list.map((b) => b.category ?? \"Blocks\")));\n const flat = cats.flatMap((c) => list.filter((b) => (b.category ?? \"Blocks\") === c));\n const pick = (b: TypeSchema) => {\n if (why.has(b)) return;\n onPick(b);\n setOpen(false);\n setQ(\"\");\n };\n return (\n <Popover open={open} onOpenChange={(o) => { setOpen(o); setQ(\"\"); setActive(0); }}>\n <PopoverTrigger render={<Button size=\"sm\" variant=\"ghost\" className=\"text-kit-fg-2\" leftIcon={<IconPlus stroke={1.5} />} disabled={disabled} />}>{label}</PopoverTrigger>\n <PopoverContent className=\"w-[300px] p-0\" align=\"start\">\n <label\n className=\"flex h-10 items-center gap-2 border-b border-kit-line px-3 text-kit-fg-3\"\n onKeyDown={(e) => {\n if (e.key === \"ArrowDown\") { e.preventDefault(); setActive((a) => (a + 1) % Math.max(1, flat.length)); }\n if (e.key === \"ArrowUp\") { e.preventDefault(); setActive((a) => (a - 1 + flat.length) % Math.max(1, flat.length)); }\n if (e.key === \"Enter\" && flat[active]) { e.preventDefault(); pick(flat[active]); }\n }}\n >\n <IconSearch className=\"size-4 shrink-0\" stroke={1.5} />\n <input autoFocus value={q} onChange={(e) => { setQ(e.target.value); setActive(0); }} placeholder=\"Search blocks\" aria-label=\"Search blocks\" className=\"h-full min-w-0 flex-1 bg-transparent text-kit-sm text-kit-fg outline-none placeholder:text-kit-fg-3\" />\n </label>\n <div className=\"max-h-80 overflow-y-auto p-1\" role=\"listbox\">\n {flat.length === 0 ? <p className=\"px-3 py-6 text-center text-kit-sm text-kit-fg-3\">No blocks match</p> : null}\n {cats.map((c) => (\n <div key={c} className=\"pb-1\">\n <div className=\"px-2 pb-1 pt-1.5 text-kit-2xs font-medium text-kit-fg-3\">{c}</div>\n {list.filter((b) => (b.category ?? \"Blocks\") === c).map((b) => {\n const i = flat.indexOf(b);\n const reason = why.get(b);\n return (\n <button\n key={b.name}\n type=\"button\"\n role=\"option\"\n aria-selected={i === active}\n aria-disabled={reason !== undefined || undefined}\n onMouseEnter={() => setActive(i)}\n onClick={() => pick(b)}\n className={cn(\"flex w-full items-center gap-2.5 rounded-kit-md p-1.5 text-left\", reason !== undefined && \"cursor-not-allowed\", i === active && \"bg-kit-hover\")}\n >\n <span className={cn(\"flex size-8 shrink-0 items-center justify-center rounded-kit-md border border-kit-line bg-kit-surface text-kit-fg-2 shadow-kit-xs\", reason !== undefined && \"opacity-50\")}>\n <KitIcon name={b.icon} className=\"size-4\" />\n </span>\n <span className=\"min-w-0 flex-1\">\n <span className={cn(\"block truncate text-kit-sm\", reason !== undefined ? \"text-kit-fg-3\" : \"text-kit-fg\")}>{b.title}</span>\n {reason !== undefined ? (\n <span className=\"block text-kit-xs text-kit-fg-3\">{reason}</span>\n ) : b.description ? (\n <span className=\"block truncate text-kit-xs text-kit-fg-3\">{b.description}</span>\n ) : null}\n </span>\n </button>\n );\n })}\n </div>\n ))}\n </div>\n <div data-hint=\"shortcuts\" className=\"border-t border-kit-line px-3 py-1.5 text-kit-2xs text-kit-fg-3\">↵ add · type to search</div>\n </PopoverContent>\n </Popover>\n );\n}\n"],"mappings":"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"}
package/dist/index.js CHANGED
@@ -28,7 +28,7 @@ import { LINK_TYPES, LinkControl, LinkField, LinkForm, LinkLine, LinkOptions, Li
28
28
  import { BUTTON_ICONS, ButtonControl, ButtonIconPicker, ButtonLinkEditor, ButtonPreview, ButtonScreen, ButtonStyleGrid, STYLE_ITEMS, StyleGlyph, lookLabel, lookOf, nextButton } from "./controls/button.js";
29
29
  import { FieldList } from "./engine/field-list.js";
30
30
  import { ItemList, OrderLockSlot, SharedSortProvider, arrayMove, useDragReorder, useSharedSort } from "./engine/item-list.js";
31
- import { ADD_SEARCH_AT, ARRAY_CONTROLS, ArrayField, RowList, RowsHostContext, rowToggleField, useDrill, useListOps } from "./engine/array.js";
31
+ import { ADD_SEARCH_AT, ARRAY_CONTROLS, ArrayField, RowList, RowsHostContext, listMeta, rowToggleField, useDrill, useListOps } from "./engine/array.js";
32
32
  import { isDrillable, resolveFrames, rootFrame } from "./lib/frames.js";
33
33
  import { ExpandedEditorModal } from "./ui/expanded-editor-modal.js";
34
34
  import { FrameCrumbs, KitBreadcrumb, crumbSignature, framesToCrumbs, kitPathItems } from "./engine/breadcrumb.js";
@@ -36,7 +36,7 @@ import { ChoiceSwitch, SEGMENTED_MAX, SEGMENTED_MAX_LABEL, fitsSegmented } from
36
36
  import { FrameHeader, FrameSlotsProvider, FrameStage, FrameView, frameContext, frameDirection, parentTitleOf, useFrameNavigation, useFrameSlots } from "./engine/frame.js";
37
37
  import { TableControl, TableFrame, TableFullScreenAction } from "./controls/table/table.js";
38
38
  import { COALESCE_MS, SchemaForm, UNDO_STEPS } from "./engine/schema-form.js";
39
- import { BlockPicker, SlotField, useAvailableBlocks } from "./engine/slot.js";
39
+ import { BlockPicker, SlotField, useAvailableBlocks, useUnavailableBlocks } from "./engine/slot.js";
40
40
  import { CodeControl, CodeDialogField, CodeSurface, UnreadableValue, jsonProblem } from "./controls/code.js";
41
41
  import { JsonControl } from "./controls/json.js";
42
42
  import { ACTIONS, ACTION_WHEN_READ_ONLY, CONTROLS, FallbackControl, KitField, LegacyFallback, NavRow, NestedForm, plainOf, useFieldAccess, withDefaultHelp } from "./engine/kit-field.js";
@@ -79,6 +79,6 @@ import "./kit.css";
79
79
  //#region src/index.ts
80
80
  registerKitControls();
81
81
  //#endregion
82
- export { ACTIONS, ACTION_WHEN_READ_ONLY, ADD_SEARCH_AT, AGENT_PRESENCE, AI_PRESETS, ARRAY_CONTROLS, ActionTray, AnimatedFields, Appear, ArrayField, Autocomplete, Avatar, AvatarStack, BUTTON_ICONS, Badge, BlockPicker, BooleanControl, BreakpointGroup, Button, ButtonControl, ButtonIconPicker, ButtonLinkEditor, ButtonPreview, ButtonScreen, ButtonStyleGrid, C1_ACTIONS, C1_CONTROLS, C2_CONTROLS, CAP_IDS, CATEGORY_TO_PROD, COALESCE_MS, CONTROLS, Card, CardHeader, Checkbox, ChoiceCard, ChoiceList, ChoiceSwitch, CodeControl, CodeDialogField, CodeSurface, ColorControl, ComponentSlotControl, DEFAULT_ENV, DEV_FIELD, DEV_ONLY_FIELD, DateControl, Dot, EmailControl, EmptyState, ExpandedEditorModal, FLOATING_LAYER, FallbackControl, Field, FieldDescribedByContext, FieldHeaderSlot, FieldInset, FieldLabelledByContext, FieldList, FieldSection, FieldShell, FieldUnit, FieldUnitRow, FieldsetSection, FileControl, FlowBody, FlowClose, FlowFooter, FlowHeader, FlowLabel, FlowModal, FormPickerControl, FormProvider, FrameCrumbs, FrameHeader, FrameSlotsProvider, FrameStage, FrameView, GalleryControl, GroupTabs, HELP_STRINGS, HEX_COLOR, HISTORY_SEGMENT, HeaderStatus, HelpMore, Highlight, HintTooltip, HoverCard, HoverCardContent, HoverCardTrigger, IconButton, IconControl, IconPicker, IconValueGlyph, ImageControl, Input, InsetScope, IssueDot, ItemList, JsonControl, KIT_ICONS, Kbd, Kbdish, KitAddressContext, KitBreadcrumb, KitEnvProvider, KitField, KitIcon, KitSectionTitle, KitServicesProvider, KitToaster, LABEL_HINT_AT, LINK_TYPES, Label, LegacyFallback, LinkControl, LinkField, LinkForm, LinkLine, LinkOptions, LinkPicker, LinkPopoverBody, LinkQuickEdit, LocationControl, MediaPicker, Menu, MenuCheckItem, MenuContent, MenuGroup, MenuItem, MenuLabel, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSub, MenuSubContent, MenuSubTrigger, MenuTrigger, MiniCalendar, Modal, ModalBody, ModalClose, ModalContent, ModalFooter, ModalHeader, ModalTrigger, ModeBar, ModeBarDot, ModeBarLink, MoreOptions, MultiSelectControl, NUMBER_SCALE, NavRow, NestedForm, NumberControl, OptionRow, OrderLockSlot, PageHeader, PeerStack, PlainNumber, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverTrigger, Progress, REL_ITEMS, RHYTHM, RT_PROSE, Radio, RadioGroup, RatingControl, RefThumb, ReferenceControl, ReferencesControl, RevealLink, RichTextControl, RichTextEditor, RichTextExpandAction, RowChrome, RowList, RowsHostContext, SEARCH_THRESHOLD, SEGMENTED_MAX, SEGMENTED_MAX_LABEL, SHOPIFY_REF_LOCK, SITE_PALETTE, STYLE_ITEMS, ScaleControl, ScaleSlider, SchemaForm, SearchInput, SectionAnchorsProvider, Segmented, Select, SelectControl, Separator, SettingsSection, SharedSortProvider, Sheet, SheetClose, SheetContent, SheetTrigger, ShortcutHint, ShortcutHintsProvider, Skeleton, Slider, SlotDepthContext, SlotField, SlotPicker, SlugControl, SlugGenerate, Sparkle, Spinner, Stat, StatusMark, StatusPill, StringControl, StyleGlyph, Switch, TARGET_KEYS, TEXT_FOCUS, Tab, TabList, TabPanel, Table, TableControl, TableFrame, TableFullScreenAction, Tabs, TagsControl, Td, TextControl, Textarea, Th, Thumb, ToggleGroup, ToggleItem, Tooltip, TooltipProvider, TooltipScope, Tr, TrayMeta, TrayMore, UNDO_STEPS, UnknownValueNote, UnreadableValue, UrlControl, VideoControl, VideoPreview, acceptsFile, actionTrayClass, apiName, arrangeFields, arrayMove, avatarRingSpread, badgeVariants, blockDefToSchema, buttonFromProd, buttonToProd, buttonVariants, cn, codeFromProd, codeToProd, collectIssues, colorFor, conventionalHelp, cropChoice, cropPreset, cropRect, crumbSignature, dateFromProd, dateToProd, datetimeFromProd, datetimeToProd, defaultGroup, describeLink, detectType, ensureKeys, failingRules, fieldAccessOf, fieldDefToSchema, fieldDefsToSchema, fileNameFromUrl, fileTarget, filterOptions, finalizeLink, findTarget, fitsSegmented, formatBytes, frameContext, frameDirection, framesToCrumbs, fromAsset, fromTypeSchema, getIn, groupSummary, hasLink, hrefOf, iconButtonVariants, iconKey, imageFromProd, imageToProd, inferField, isBreakpointName, isCropRect, isDockIcon, isDrillable, isFormOnly, isHidden, isShort, isVideoUrl, jsonProblem, kitPathItems, kitToast, kitToastManager, leafValuePlan, linkFromProd, linkIcon, linkProblem, linkShapeOf, linkText, linkToProd, listFromProd, listToProd, locationFromDraft, lookLabel, lookOf, matchPositions, matchScore, newBlock, newItem, nextButton, nodeText, normImage, normLink, optionIcons, parentTitleOf, parseTargetTag, pathKey, pickerHex, plainOf, plainText, planFromProd, planToProd, platformKeys, presenceColor, presenceSlot, previewOf, prod_types_exports as prod, propDefToField, propsToTypeSchema, ratingFromProd, ratingScale, ratingToProd, refFilterText, referenceFromProd, referenceNoun, referenceToProd, registerC1Controls, registerC2Controls, registerKitControls, registerKitServices, registerPresenceRoster, resetFieldClipboard, resolveFieldAccess, resolveFrames, resolveHelp, rootFrame, rowToggleField, scaleFromProd, scaleToProd, schemaSlugOf, seesDevSurfaces, selectTriggerClass, setIn, shortcutHintsOn, slugSource, slugTidy, slugTyping, snapRating, statusMap, storedLink, str, summarize, tableFromProd, tableToProd, tagRefusal, tagsFromProd, tagsToProd, targetTag, textLength, titleFromKey, toNum, toTypeSchema, typedRowsFromProd, typedRowsToProd, uniqueKey, useAvailableBlocks, useDragReorder, useDrill, useFieldAccess, useFieldDescribedBy, useFieldId, useFieldLabelledBy, useFocusReturn, useForm, useFrameNavigation, useFrameSlots, useGroupStatus, useInsetDepth, useKitEnv, useKitServices, useLinkTargets, useListOps, useLoadedFit, useOwnDescription, useReferenceRecords, useRhythm, useRichTextRefs, useSharedSort, useShortcutHints, useUpload, validateValue, variantFamilyFromTypeSchema, variantFamilyToTypeSchema, variantGroupV2, videoFromProd, videoProvider, videoToProd, visibleFields, visibleSchema, withCrop, withDefaultHelp, withTarget, withText, youTubeId, zoneListFromProd, zoneListToProd };
82
+ export { ACTIONS, ACTION_WHEN_READ_ONLY, ADD_SEARCH_AT, AGENT_PRESENCE, AI_PRESETS, ARRAY_CONTROLS, ActionTray, AnimatedFields, Appear, ArrayField, Autocomplete, Avatar, AvatarStack, BUTTON_ICONS, Badge, BlockPicker, BooleanControl, BreakpointGroup, Button, ButtonControl, ButtonIconPicker, ButtonLinkEditor, ButtonPreview, ButtonScreen, ButtonStyleGrid, C1_ACTIONS, C1_CONTROLS, C2_CONTROLS, CAP_IDS, CATEGORY_TO_PROD, COALESCE_MS, CONTROLS, Card, CardHeader, Checkbox, ChoiceCard, ChoiceList, ChoiceSwitch, CodeControl, CodeDialogField, CodeSurface, ColorControl, ComponentSlotControl, DEFAULT_ENV, DEV_FIELD, DEV_ONLY_FIELD, DateControl, Dot, EmailControl, EmptyState, ExpandedEditorModal, FLOATING_LAYER, FallbackControl, Field, FieldDescribedByContext, FieldHeaderSlot, FieldInset, FieldLabelledByContext, FieldList, FieldSection, FieldShell, FieldUnit, FieldUnitRow, FieldsetSection, FileControl, FlowBody, FlowClose, FlowFooter, FlowHeader, FlowLabel, FlowModal, FormPickerControl, FormProvider, FrameCrumbs, FrameHeader, FrameSlotsProvider, FrameStage, FrameView, GalleryControl, GroupTabs, HELP_STRINGS, HEX_COLOR, HISTORY_SEGMENT, HeaderStatus, HelpMore, Highlight, HintTooltip, HoverCard, HoverCardContent, HoverCardTrigger, IconButton, IconControl, IconPicker, IconValueGlyph, ImageControl, Input, InsetScope, IssueDot, ItemList, JsonControl, KIT_ICONS, Kbd, Kbdish, KitAddressContext, KitBreadcrumb, KitEnvProvider, KitField, KitIcon, KitSectionTitle, KitServicesProvider, KitToaster, LABEL_HINT_AT, LINK_TYPES, Label, LegacyFallback, LinkControl, LinkField, LinkForm, LinkLine, LinkOptions, LinkPicker, LinkPopoverBody, LinkQuickEdit, LocationControl, MediaPicker, Menu, MenuCheckItem, MenuContent, MenuGroup, MenuItem, MenuLabel, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSub, MenuSubContent, MenuSubTrigger, MenuTrigger, MiniCalendar, Modal, ModalBody, ModalClose, ModalContent, ModalFooter, ModalHeader, ModalTrigger, ModeBar, ModeBarDot, ModeBarLink, MoreOptions, MultiSelectControl, NUMBER_SCALE, NavRow, NestedForm, NumberControl, OptionRow, OrderLockSlot, PageHeader, PeerStack, PlainNumber, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverTrigger, Progress, REL_ITEMS, RHYTHM, RT_PROSE, Radio, RadioGroup, RatingControl, RefThumb, ReferenceControl, ReferencesControl, RevealLink, RichTextControl, RichTextEditor, RichTextExpandAction, RowChrome, RowList, RowsHostContext, SEARCH_THRESHOLD, SEGMENTED_MAX, SEGMENTED_MAX_LABEL, SHOPIFY_REF_LOCK, SITE_PALETTE, STYLE_ITEMS, ScaleControl, ScaleSlider, SchemaForm, SearchInput, SectionAnchorsProvider, Segmented, Select, SelectControl, Separator, SettingsSection, SharedSortProvider, Sheet, SheetClose, SheetContent, SheetTrigger, ShortcutHint, ShortcutHintsProvider, Skeleton, Slider, SlotDepthContext, SlotField, SlotPicker, SlugControl, SlugGenerate, Sparkle, Spinner, Stat, StatusMark, StatusPill, StringControl, StyleGlyph, Switch, TARGET_KEYS, TEXT_FOCUS, Tab, TabList, TabPanel, Table, TableControl, TableFrame, TableFullScreenAction, Tabs, TagsControl, Td, TextControl, Textarea, Th, Thumb, ToggleGroup, ToggleItem, Tooltip, TooltipProvider, TooltipScope, Tr, TrayMeta, TrayMore, UNDO_STEPS, UnknownValueNote, UnreadableValue, UrlControl, VideoControl, VideoPreview, acceptsFile, actionTrayClass, apiName, arrangeFields, arrayMove, avatarRingSpread, badgeVariants, blockDefToSchema, buttonFromProd, buttonToProd, buttonVariants, cn, codeFromProd, codeToProd, collectIssues, colorFor, conventionalHelp, cropChoice, cropPreset, cropRect, crumbSignature, dateFromProd, dateToProd, datetimeFromProd, datetimeToProd, defaultGroup, describeLink, detectType, ensureKeys, failingRules, fieldAccessOf, fieldDefToSchema, fieldDefsToSchema, fileNameFromUrl, fileTarget, filterOptions, finalizeLink, findTarget, fitsSegmented, formatBytes, frameContext, frameDirection, framesToCrumbs, fromAsset, fromTypeSchema, getIn, groupSummary, hasLink, hrefOf, iconButtonVariants, iconKey, imageFromProd, imageToProd, inferField, isBreakpointName, isCropRect, isDockIcon, isDrillable, isFormOnly, isHidden, isShort, isVideoUrl, jsonProblem, kitPathItems, kitToast, kitToastManager, leafValuePlan, linkFromProd, linkIcon, linkProblem, linkShapeOf, linkText, linkToProd, listFromProd, listMeta, listToProd, locationFromDraft, lookLabel, lookOf, matchPositions, matchScore, newBlock, newItem, nextButton, nodeText, normImage, normLink, optionIcons, parentTitleOf, parseTargetTag, pathKey, pickerHex, plainOf, plainText, planFromProd, planToProd, platformKeys, presenceColor, presenceSlot, previewOf, prod_types_exports as prod, propDefToField, propsToTypeSchema, ratingFromProd, ratingScale, ratingToProd, refFilterText, referenceFromProd, referenceNoun, referenceToProd, registerC1Controls, registerC2Controls, registerKitControls, registerKitServices, registerPresenceRoster, resetFieldClipboard, resolveFieldAccess, resolveFrames, resolveHelp, rootFrame, rowToggleField, scaleFromProd, scaleToProd, schemaSlugOf, seesDevSurfaces, selectTriggerClass, setIn, shortcutHintsOn, slugSource, slugTidy, slugTyping, snapRating, statusMap, storedLink, str, summarize, tableFromProd, tableToProd, tagRefusal, tagsFromProd, tagsToProd, targetTag, textLength, titleFromKey, toNum, toTypeSchema, typedRowsFromProd, typedRowsToProd, uniqueKey, useAvailableBlocks, useDragReorder, useDrill, useFieldAccess, useFieldDescribedBy, useFieldId, useFieldLabelledBy, useFocusReturn, useForm, useFrameNavigation, useFrameSlots, useGroupStatus, useInsetDepth, useKitEnv, useKitServices, useLinkTargets, useListOps, useLoadedFit, useOwnDescription, useReferenceRecords, useRhythm, useRichTextRefs, useSharedSort, useShortcutHints, useUnavailableBlocks, useUpload, validateValue, variantFamilyFromTypeSchema, variantFamilyToTypeSchema, variantGroupV2, videoFromProd, videoProvider, videoToProd, visibleFields, visibleSchema, withCrop, withDefaultHelp, withTarget, withText, youTubeId, zoneListFromProd, zoneListToProd };
83
83
 
84
84
  //# sourceMappingURL=index.js.map
@@ -21,6 +21,7 @@ export interface KitIssue {
21
21
  }
22
22
  type Raw = Omit<KitIssue, "key" | "path">;
23
23
  export declare const textLength: (v: unknown) => number;
24
+ export declare const isColour: (v: string) => boolean;
24
25
  /** Validate one value against its field (not recursing into children). */
25
26
  export declare function validateValue(f: FieldSchema, v: unknown): Raw | null;
26
27
  /**
@@ -3,6 +3,9 @@ import { tableIssues } from "../schema/table.js";
3
3
  import { isEmptyValue, isHidden, itemSchemaFor, plainText, primitiveItem } from "./schema.js";
4
4
  //#region src/lib/validate.ts
5
5
  var textLength = (v) => plainText(v).length;
6
+ /** A colour as a stylesheet takes it: hex (#RGB · #RRGGBB · #RRGGBBAA), a colour function, or a custom property (BL-567). */
7
+ var COLOUR = /^(?:#(?:[0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})|(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\([^()]*\)|var\(--[\w-]+\))$/i;
8
+ var isColour = (v) => COLOUR.test(v.trim());
6
9
  var counted = (f) => f.type === "string" || f.type === "text" || f.type === "richtext";
7
10
  /** Validate one value against its field (not recursing into children). */
8
11
  function validateValue(f, v) {
@@ -14,6 +17,16 @@ function validateValue(f, v) {
14
17
  message: f.type === "image" ? `Add an image for ${label.toLowerCase()}` : f.type === "reference" ? `Choose ${label.toLowerCase()}` : f.type === "array" || f.type === "slot" ? `Add at least one item to ${label.toLowerCase()}` : `${label} is required`
15
18
  };
16
19
  if (isEmptyValue(v)) return null;
20
+ if (r.required && f.type === "button" && isObj(v) && !String(v.label ?? "").trim()) return {
21
+ level: "error",
22
+ kind: "required",
23
+ message: `Add a label for ${label.toLowerCase()}`
24
+ };
25
+ if (f.type === "color" && typeof v === "string" && !isColour(v)) return {
26
+ level: "error",
27
+ kind: "rule",
28
+ message: "Use a hex colour, like #1a73e8"
29
+ };
17
30
  if (counted(f)) {
18
31
  const n = textLength(v);
19
32
  if (r.max && n > r.max) return {
@@ -235,6 +248,6 @@ function collectIssues(fields, obj, base, resolveSchema, out = [], cc, peers) {
235
248
  return out;
236
249
  }
237
250
  //#endregion
238
- export { collectIssues, textLength, uniqueKey, validateValue };
251
+ export { collectIssues, isColour, textLength, uniqueKey, validateValue };
239
252
 
240
253
  //# sourceMappingURL=validate.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"validate.js","names":[],"sources":["../../src/lib/validate.ts"],"sourcesContent":["/**\n * Validation — rules live in the schema (`validation`), messages state the rule in plain words.\n * Two kinds: \"required\" (shown after blur or a publish attempt) and \"rule\" (shown on blur too, never while\n * typing for the first time — the shell decides). Warnings (recommendedMax, missing alt) never block publish.\n */\nimport type { FieldPath, FieldSchema, TypeSchema } from \"../schema/types\";\nimport { isObj, pathKey } from \"./path\";\nimport { tableIssues } from \"../schema/table\";\nimport { isEmptyValue, isHidden, itemSchemaFor, plainText, primitiveItem, type CondCtx } from \"./schema\";\n\nexport interface KitIssue {\n key: string;\n path: FieldPath;\n level: \"error\" | \"warning\";\n kind: \"required\" | \"rule\";\n message: string;\n /** shown at once, even while the field is being typed in (a host's live check, e.g. the schema editor's help check) */\n live?: boolean;\n /** one fix the shell offers after the message (\"Clear help\") */\n fix?: { label: string; apply: () => void };\n}\ntype Raw = Omit<KitIssue, \"key\" | \"path\">;\n\nexport const textLength = (v: unknown) => plainText(v).length;\nconst counted = (f: FieldSchema) => f.type === \"string\" || f.type === \"text\" || f.type === \"richtext\";\n\n/** Validate one value against its field (not recursing into children). */\nexport function validateValue(f: FieldSchema, v: unknown): Raw | null {\n const r = f.validation ?? {};\n const label = f.title;\n if (r.required && isEmptyValue(v)) {\n const msg =\n f.type === \"image\" ? `Add an image for ${label.toLowerCase()}` :\n f.type === \"reference\" ? `Choose ${label.toLowerCase()}` :\n f.type === \"array\" || f.type === \"slot\" ? `Add at least one item to ${label.toLowerCase()}` :\n `${label} is required`;\n return { level: \"error\", kind: \"required\", message: msg };\n }\n if (isEmptyValue(v)) return null;\n\n if (counted(f)) {\n const n = textLength(v);\n if (r.max && n > r.max) return { level: \"error\", kind: \"rule\", message: `Keep it under ${r.max} characters (${n - r.max} over)` };\n if (r.min && n < r.min) return { level: \"error\", kind: \"rule\", message: `Use at least ${r.min} characters` };\n if (r.recommendedMax && n > r.recommendedMax)\n return { level: \"warning\", kind: \"rule\", message: `Longer than the recommended ${r.recommendedMax} characters. It may get cut off.` };\n }\n if ((f.type === \"array\" || f.type === \"slot\" || f.type === \"tags\" || f.type === \"multiselect\") && Array.isArray(v)) {\n if (r.min && v.length < r.min) return { level: \"error\", kind: \"rule\", message: `Add at least ${r.min} ${r.min === 1 ? \"item\" : \"items\"}` };\n if (r.max && v.length > r.max) return { level: \"error\", kind: \"rule\", message: `Use at most ${r.max} items` };\n }\n if (f.type === \"number\" && typeof v === \"number\") {\n const lo = r.min ?? f.numeric?.min;\n const hi = r.max ?? f.numeric?.max;\n if (lo != null && v < lo) return { level: \"error\", kind: \"rule\", message: `Use ${lo} or more` };\n if (hi != null && v > hi) return { level: \"error\", kind: \"rule\", message: `Use ${hi} or less` };\n }\n if (typeof v === \"string\") {\n if (f.type === \"email\" && !/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(v)) return { level: \"error\", kind: \"rule\", message: \"Use a full email address, like hello@caldera.com\" };\n if (f.type === \"url\" && !/^(https?:\\/\\/|\\/|#|mailto:|tel:)[^\\s]*$/.test(v)) return { level: \"error\", kind: \"rule\", message: \"Use a full URL, like https://example.com, or a path like /shop\" };\n if (f.type === \"url\" && /^(javascript|data):/i.test(v)) return { level: \"error\", kind: \"rule\", message: \"This kind of link isn't allowed\" };\n if (f.type === \"slug\" && !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(v)) return { level: \"error\", kind: \"rule\", message: \"Use lowercase letters, numbers and hyphens\" };\n if (f.type === \"json\") {\n try {\n JSON.parse(v);\n } catch {\n return { level: \"error\", kind: \"rule\", message: \"Invalid JSON\" };\n }\n }\n if (r.pattern && !new RegExp(r.pattern).test(v)) return { level: \"error\", kind: \"rule\", message: r.patternMessage ?? \"This doesn't match the expected format\" };\n }\n if (f.type === \"table\") {\n // caption, header labels, typed cells, row limits, markup readiness (src/schema/table.ts) — first error wins\n const issues = tableIssues(v, { ...f.table, minRows: f.table?.minRows ?? r.min, maxRows: f.table?.maxRows ?? r.max });\n const first = issues.find((i) => i.level === \"error\") ?? issues[0];\n if (first) return { level: first.level, kind: \"rule\", message: first.message };\n }\n if (f.type === \"image\" && isObj(v) && v.url && !v.alt && r.required) return { level: \"warning\", kind: \"rule\", message: \"No alt text. Describe the image for accessibility.\" };\n return null;\n}\n\n/**\n * Values other records already hold for a ROOT field with `validation.unique` (a collection's other entries). The host\n * passes it; without it a root `unique` field is not checked (lists always are).\n */\nexport type UniquePeers = (field: FieldSchema, path: FieldPath) => unknown[] | undefined;\n\n/**\n * What makes two values \"the same\" for `unique` (V2 uniqueKey, as the server judges a placement in backend prop-fields\n * tableProblem): text trimmed and case-folded, numbers and booleans as written, a reference or link by its id. null =\n * nothing to compare. A list's items compare whole (itemKey), strings case-folded, rows without their `_id` / `_key`.\n */\nexport function uniqueKey(v: unknown): string | null {\n if (typeof v === \"string\") return v.trim() ? v.trim().toLocaleLowerCase(\"und\") : null;\n if ((typeof v === \"number\" && Number.isFinite(v)) || typeof v === \"boolean\") return String(v);\n if (!isObj(v)) return null;\n const id = v._ref ?? v.id ?? v.value ?? v.href ?? v.url;\n return typeof id === \"string\" || typeof id === \"number\" ? uniqueKey(String(id)) : null;\n}\nconst itemKey = (v: unknown): string => {\n if (typeof v === \"string\") return `s:${v.trim().toLocaleLowerCase(\"und\")}`;\n if (isObj(v)) {\n const { _id: _i, _key: _k, ...rest } = v;\n return `o:${JSON.stringify(Object.fromEntries(Object.entries(rest).sort(([a], [b]) => a.localeCompare(b))))}`;\n }\n return `j:${JSON.stringify(v)}`;\n};\n/** Indexes of the values whose key repeats one an earlier value already used. */\nfunction repeats(values: unknown[], key: (v: unknown) => string | null): number[] {\n const seen = new Set<string>();\n const out: number[] = [];\n values.forEach((v, i) => {\n const k = key(v);\n if (k === null) return;\n if (seen.has(k)) out.push(i);\n else seen.add(k);\n });\n return out;\n}\nconst shown = (v: unknown) => {\n const s = typeof v === \"string\" ? v.trim() : isObj(v) ? String(v.title ?? v.label ?? v._ref ?? v.id ?? \"\") : String(v ?? \"\");\n return s.length > 40 ? `${s.slice(0, 39)}…` : s;\n};\n\n/** Walk fields under `obj` and collect every issue, recursing into objects, array items and slot blocks. */\nexport function collectIssues(\n fields: FieldSchema[],\n obj: unknown,\n base: FieldPath,\n resolveSchema?: (t: string) => TypeSchema | undefined,\n out: KitIssue[] = [],\n /** what a `_variant` condition reads above this level (V2; the root call: the value itself) */\n cc?: CondCtx,\n /** root fields with `unique`: the values the model's other records hold (the root call only) */\n peers?: UniquePeers,\n): KitIssue[] {\n const v = isObj(obj) ? obj : {};\n const here: CondCtx = cc ?? { root: v, variant: typeof v._variant === \"string\" ? v._variant : undefined };\n const below: CondCtx = { root: here.root, parent: v, variant: here.variant };\n for (const f of fields) {\n if (isHidden(f, v, here)) continue;\n const p = [...base, f.name];\n const val = v[f.name];\n const raw = validateValue(f, val);\n if (raw) out.push({ ...raw, key: pathKey(p), path: p });\n else if (peers && !base.length && f.validation?.unique && f.type !== \"array\") {\n const k = uniqueKey(val);\n if (k !== null && (peers(f, p) ?? []).some((o) => uniqueKey(o) === k))\n out.push({ level: \"error\", kind: \"rule\", message: `Another item already uses “${shown(val)}”. ${f.title} must be different on each one.`, key: pathKey(p), path: p });\n }\n if (f.type === \"object\" && f.fields) collectIssues(f.fields, val, p, resolveSchema, out, below);\n // A list's `unique`: no item twice (the first repeat is reported on the list).\n if ((f.type === \"array\" || f.type === \"tags\" || f.type === \"multiselect\") && Array.isArray(val) && f.validation?.unique && !raw) {\n const [r] = repeats(val, itemKey);\n if (r !== undefined) out.push({ level: \"error\", kind: \"rule\", message: typeof val[r] === \"string\" ? `“${shown(val[r])}” is in the list twice. Each item can be added once.` : `Item ${r + 1} repeats an earlier item. Each item must be different.`, key: pathKey(p), path: p });\n }\n if (f.type === \"array\" && Array.isArray(val) && !primitiveItem(f)) {\n val.forEach((it, i) => {\n const s = itemSchemaFor(f, it);\n if (s?.fields) collectIssues(s.fields, it, [...p, i], resolveSchema, out, below);\n });\n // A field inside the items with `unique` (or the list's `uniqueBy`): no two items share its value.\n const keys = new Set<string>();\n for (const it of val) for (const x of itemSchemaFor(f, it)?.fields ?? []) if (x.validation?.unique || f.validation?.uniqueBy === x.name) keys.add(x.name);\n for (const k of keys) {\n const vals = val.map((it) => (isObj(it) ? it[k] : undefined));\n for (const i of repeats(vals, uniqueKey)) {\n const fp = [...p, i, k];\n const title = itemSchemaFor(f, val[i])?.fields?.find((x) => x.name === k)?.title ?? k;\n if (!out.some((x) => x.key === pathKey(fp))) out.push({ level: \"error\", kind: \"rule\", message: `${title} must be different on each item. “${shown(vals[i])}” is already used.`, key: pathKey(fp), path: fp });\n }\n }\n }\n if (f.type === \"slot\" && Array.isArray(val) && resolveSchema) {\n val.forEach((it, i) => {\n const b = isObj(it) && typeof it._type === \"string\" ? resolveSchema(it._type) : undefined;\n if (b) collectIssues(b.fields, it, [...p, i], resolveSchema, out, { root: it, variant: isObj(it) && typeof it._variant === \"string\" ? it._variant : b.variants?.[0]?.id });\n if (f.slotSettings && isObj(it)) collectIssues(f.slotSettings, it._settings, [...p, i, \"_settings\"], resolveSchema, out);\n });\n }\n }\n return out;\n}\n"],"mappings":";;;;AAuBA,IAAa,cAAc,MAAe,UAAU,CAAC,CAAC,CAAC;AACvD,IAAM,WAAW,MAAmB,EAAE,SAAS,YAAY,EAAE,SAAS,UAAU,EAAE,SAAS;;AAG3F,SAAgB,cAAc,GAAgB,GAAwB;CACpE,MAAM,IAAI,EAAE,cAAc,CAAC;CAC3B,MAAM,QAAQ,EAAE;CAChB,IAAI,EAAE,YAAY,aAAa,CAAC,GAM9B,OAAO;EAAE,OAAO;EAAS,MAAM;EAAY,SAJzC,EAAE,SAAS,UAAU,oBAAoB,MAAM,YAAY,MAC3D,EAAE,SAAS,cAAc,UAAU,MAAM,YAAY,MACrD,EAAE,SAAS,WAAW,EAAE,SAAS,SAAS,4BAA4B,MAAM,YAAY,MACxF,GAAG,MAAM;CAC6C;CAE1D,IAAI,aAAa,CAAC,GAAG,OAAO;CAE5B,IAAI,QAAQ,CAAC,GAAG;EACd,MAAM,IAAI,WAAW,CAAC;EACtB,IAAI,EAAE,OAAO,IAAI,EAAE,KAAK,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS,iBAAiB,EAAE,IAAI,eAAe,IAAI,EAAE,IAAI;EAAQ;EAChI,IAAI,EAAE,OAAO,IAAI,EAAE,KAAK,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS,gBAAgB,EAAE,IAAI;EAAa;EAC3G,IAAI,EAAE,kBAAkB,IAAI,EAAE,gBAC5B,OAAO;GAAE,OAAO;GAAW,MAAM;GAAQ,SAAS,+BAA+B,EAAE,eAAe;EAAkC;CACxI;CACA,KAAK,EAAE,SAAS,WAAW,EAAE,SAAS,UAAU,EAAE,SAAS,UAAU,EAAE,SAAS,kBAAkB,MAAM,QAAQ,CAAC,GAAG;EAClH,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS,gBAAgB,EAAE,IAAI,GAAG,EAAE,QAAQ,IAAI,SAAS;EAAU;EACzI,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS,eAAe,EAAE,IAAI;EAAQ;CAC9G;CACA,IAAI,EAAE,SAAS,YAAY,OAAO,MAAM,UAAU;EAChD,MAAM,KAAK,EAAE,OAAO,EAAE,SAAS;EAC/B,MAAM,KAAK,EAAE,OAAO,EAAE,SAAS;EAC/B,IAAI,MAAM,QAAQ,IAAI,IAAI,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS,OAAO,GAAG;EAAU;EAC9F,IAAI,MAAM,QAAQ,IAAI,IAAI,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS,OAAO,GAAG;EAAU;CAChG;CACA,IAAI,OAAO,MAAM,UAAU;EACzB,IAAI,EAAE,SAAS,WAAW,CAAC,6BAA6B,KAAK,CAAC,GAAG,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS;EAAmD;EACpK,IAAI,EAAE,SAAS,SAAS,CAAC,0CAA0C,KAAK,CAAC,GAAG,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS;EAAiE;EAC7L,IAAI,EAAE,SAAS,SAAS,uBAAuB,KAAK,CAAC,GAAG,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS;EAAkC;EAC1I,IAAI,EAAE,SAAS,UAAU,CAAC,6BAA6B,KAAK,CAAC,GAAG,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS;EAA6C;EAC7J,IAAI,EAAE,SAAS,QACb,IAAI;GACF,KAAK,MAAM,CAAC;EACd,QAAQ;GACN,OAAO;IAAE,OAAO;IAAS,MAAM;IAAQ,SAAS;GAAe;EACjE;EAEF,IAAI,EAAE,WAAW,CAAC,IAAI,OAAO,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO;GAAE,OAAO;GAAS,MAAM;GAAQ,SAAS,EAAE,kBAAkB;EAAyC;CAChK;CACA,IAAI,EAAE,SAAS,SAAS;EAEtB,MAAM,SAAS,YAAY,GAAG;GAAE,GAAG,EAAE;GAAO,SAAS,EAAE,OAAO,WAAW,EAAE;GAAK,SAAS,EAAE,OAAO,WAAW,EAAE;EAAI,CAAC;EACpH,MAAM,QAAQ,OAAO,MAAM,MAAM,EAAE,UAAU,OAAO,KAAK,OAAO;EAChE,IAAI,OAAO,OAAO;GAAE,OAAO,MAAM;GAAO,MAAM;GAAQ,SAAS,MAAM;EAAQ;CAC/E;CACA,IAAI,EAAE,SAAS,WAAW,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,OAAO;EAAE,OAAO;EAAW,MAAM;EAAQ,SAAS;CAAqD;CAC5K,OAAO;AACT;;;;;;AAaA,SAAgB,UAAU,GAA2B;CACnD,IAAI,OAAO,MAAM,UAAU,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,CAAC,CAAC,kBAAkB,KAAK,IAAI;CACjF,IAAK,OAAO,MAAM,YAAY,OAAO,SAAS,CAAC,KAAM,OAAO,MAAM,WAAW,OAAO,OAAO,CAAC;CAC5F,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO;CACtB,MAAM,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE;CACpD,OAAO,OAAO,OAAO,YAAY,OAAO,OAAO,WAAW,UAAU,OAAO,EAAE,CAAC,IAAI;AACpF;AACA,IAAM,WAAW,MAAuB;CACtC,IAAI,OAAO,MAAM,UAAU,OAAO,KAAK,EAAE,KAAK,CAAC,CAAC,kBAAkB,KAAK;CACvE,IAAI,MAAM,CAAC,GAAG;EACZ,MAAM,EAAE,KAAK,IAAI,MAAM,IAAI,GAAG,SAAS;EACvC,OAAO,KAAK,KAAK,UAAU,OAAO,YAAY,OAAO,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;CAC5G;CACA,OAAO,KAAK,KAAK,UAAU,CAAC;AAC9B;;AAEA,SAAS,QAAQ,QAAmB,KAA8C;CAChF,MAAM,uBAAO,IAAI,IAAY;CAC7B,MAAM,MAAgB,CAAC;CACvB,OAAO,SAAS,GAAG,MAAM;EACvB,MAAM,IAAI,IAAI,CAAC;EACf,IAAI,MAAM,MAAM;EAChB,IAAI,KAAK,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC;OACtB,KAAK,IAAI,CAAC;CACjB,CAAC;CACD,OAAO;AACT;AACA,IAAM,SAAS,MAAe;CAC5B,MAAM,IAAI,OAAO,MAAM,WAAW,EAAE,KAAK,IAAI,MAAM,CAAC,IAAI,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,OAAO,KAAK,EAAE;CAC3H,OAAO,EAAE,SAAS,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,KAAK;AAChD;;AAGA,SAAgB,cACd,QACA,KACA,MACA,eACA,MAAkB,CAAC,GAEnB,IAEA,OACY;CACZ,MAAM,IAAI,MAAM,GAAG,IAAI,MAAM,CAAC;CAC9B,MAAM,OAAgB,MAAM;EAAE,MAAM;EAAG,SAAS,OAAO,EAAE,aAAa,WAAW,EAAE,WAAW,KAAA;CAAU;CACxG,MAAM,QAAiB;EAAE,MAAM,KAAK;EAAM,QAAQ;EAAG,SAAS,KAAK;CAAQ;CAC3E,KAAK,MAAM,KAAK,QAAQ;EACtB,IAAI,SAAS,GAAG,GAAG,IAAI,GAAG;EAC1B,MAAM,IAAI,CAAC,GAAG,MAAM,EAAE,IAAI;EAC1B,MAAM,MAAM,EAAE,EAAE;EAChB,MAAM,MAAM,cAAc,GAAG,GAAG;EAChC,IAAI,KAAK,IAAI,KAAK;GAAE,GAAG;GAAK,KAAK,QAAQ,CAAC;GAAG,MAAM;EAAE,CAAC;OACjD,IAAI,SAAS,CAAC,KAAK,UAAU,EAAE,YAAY,UAAU,EAAE,SAAS,SAAS;GAC5E,MAAM,IAAI,UAAU,GAAG;GACvB,IAAI,MAAM,SAAS,MAAM,GAAG,CAAC,KAAK,CAAC,EAAA,CAAG,MAAM,MAAM,UAAU,CAAC,MAAM,CAAC,GAClE,IAAI,KAAK;IAAE,OAAO;IAAS,MAAM;IAAQ,SAAS,8BAA8B,MAAM,GAAG,EAAE,KAAK,EAAE,MAAM;IAAkC,KAAK,QAAQ,CAAC;IAAG,MAAM;GAAE,CAAC;EACxK;EACA,IAAI,EAAE,SAAS,YAAY,EAAE,QAAQ,cAAc,EAAE,QAAQ,KAAK,GAAG,eAAe,KAAK,KAAK;EAE9F,KAAK,EAAE,SAAS,WAAW,EAAE,SAAS,UAAU,EAAE,SAAS,kBAAkB,MAAM,QAAQ,GAAG,KAAK,EAAE,YAAY,UAAU,CAAC,KAAK;GAC/H,MAAM,CAAC,KAAK,QAAQ,KAAK,OAAO;GAChC,IAAI,MAAM,KAAA,GAAW,IAAI,KAAK;IAAE,OAAO;IAAS,MAAM;IAAQ,SAAS,OAAO,IAAI,OAAO,WAAW,IAAI,MAAM,IAAI,EAAE,EAAE,wDAAwD,QAAQ,IAAI,EAAE;IAAyD,KAAK,QAAQ,CAAC;IAAG,MAAM;GAAE,CAAC;EACjR;EACA,IAAI,EAAE,SAAS,WAAW,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG;GACjE,IAAI,SAAS,IAAI,MAAM;IACrB,MAAM,IAAI,cAAc,GAAG,EAAE;IAC7B,IAAI,GAAG,QAAQ,cAAc,EAAE,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,eAAe,KAAK,KAAK;GACjF,CAAC;GAED,MAAM,uBAAO,IAAI,IAAY;GAC7B,KAAK,MAAM,MAAM,KAAK,KAAK,MAAM,KAAK,cAAc,GAAG,EAAE,CAAC,EAAE,UAAU,CAAC,GAAG,IAAI,EAAE,YAAY,UAAU,EAAE,YAAY,aAAa,EAAE,MAAM,KAAK,IAAI,EAAE,IAAI;GACxJ,KAAK,MAAM,KAAK,MAAM;IACpB,MAAM,OAAO,IAAI,KAAK,OAAQ,MAAM,EAAE,IAAI,GAAG,KAAK,KAAA,CAAU;IAC5D,KAAK,MAAM,KAAK,QAAQ,MAAM,SAAS,GAAG;KACxC,MAAM,KAAK;MAAC,GAAG;MAAG;MAAG;KAAC;KACtB,MAAM,QAAQ,cAAc,GAAG,IAAI,EAAE,CAAC,EAAE,QAAQ,MAAM,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS;KACpF,IAAI,CAAC,IAAI,MAAM,MAAM,EAAE,QAAQ,QAAQ,EAAE,CAAC,GAAG,IAAI,KAAK;MAAE,OAAO;MAAS,MAAM;MAAQ,SAAS,GAAG,MAAM,oCAAoC,MAAM,KAAK,EAAE,EAAE;MAAqB,KAAK,QAAQ,EAAE;MAAG,MAAM;KAAG,CAAC;IAC9M;GACF;EACF;EACA,IAAI,EAAE,SAAS,UAAU,MAAM,QAAQ,GAAG,KAAK,eAC7C,IAAI,SAAS,IAAI,MAAM;GACrB,MAAM,IAAI,MAAM,EAAE,KAAK,OAAO,GAAG,UAAU,WAAW,cAAc,GAAG,KAAK,IAAI,KAAA;GAChF,IAAI,GAAG,cAAc,EAAE,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,eAAe,KAAK;IAAE,MAAM;IAAI,SAAS,MAAM,EAAE,KAAK,OAAO,GAAG,aAAa,WAAW,GAAG,WAAW,EAAE,WAAW,EAAE,EAAE;GAAG,CAAC;GACzK,IAAI,EAAE,gBAAgB,MAAM,EAAE,GAAG,cAAc,EAAE,cAAc,GAAG,WAAW;IAAC,GAAG;IAAG;IAAG;GAAW,GAAG,eAAe,GAAG;EACzH,CAAC;CAEL;CACA,OAAO;AACT"}
1
+ {"version":3,"file":"validate.js","names":[],"sources":["../../src/lib/validate.ts"],"sourcesContent":["/**\n * Validation — rules live in the schema (`validation`), messages state the rule in plain words.\n * Two kinds: \"required\" (shown after blur or a publish attempt) and \"rule\" (shown on blur too, never while\n * typing for the first time — the shell decides). Warnings (recommendedMax, missing alt) never block publish.\n */\nimport type { FieldPath, FieldSchema, TypeSchema } from \"../schema/types\";\nimport { isObj, pathKey } from \"./path\";\nimport { tableIssues } from \"../schema/table\";\nimport { isEmptyValue, isHidden, itemSchemaFor, plainText, primitiveItem, type CondCtx } from \"./schema\";\n\nexport interface KitIssue {\n key: string;\n path: FieldPath;\n level: \"error\" | \"warning\";\n kind: \"required\" | \"rule\";\n message: string;\n /** shown at once, even while the field is being typed in (a host's live check, e.g. the schema editor's help check) */\n live?: boolean;\n /** one fix the shell offers after the message (\"Clear help\") */\n fix?: { label: string; apply: () => void };\n}\ntype Raw = Omit<KitIssue, \"key\" | \"path\">;\n\nexport const textLength = (v: unknown) => plainText(v).length;\n/** A colour as a stylesheet takes it: hex (#RGB · #RRGGBB · #RRGGBBAA), a colour function, or a custom property (BL-567). */\nconst COLOUR = /^(?:#(?:[0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})|(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\\([^()]*\\)|var\\(--[\\w-]+\\))$/i;\nexport const isColour = (v: string): boolean => COLOUR.test(v.trim());\nconst counted = (f: FieldSchema) => f.type === \"string\" || f.type === \"text\" || f.type === \"richtext\";\n\n/** Validate one value against its field (not recursing into children). */\nexport function validateValue(f: FieldSchema, v: unknown): Raw | null {\n const r = f.validation ?? {};\n const label = f.title;\n if (r.required && isEmptyValue(v)) {\n const msg =\n f.type === \"image\" ? `Add an image for ${label.toLowerCase()}` :\n f.type === \"reference\" ? `Choose ${label.toLowerCase()}` :\n f.type === \"array\" || f.type === \"slot\" ? `Add at least one item to ${label.toLowerCase()}` :\n `${label} is required`;\n return { level: \"error\", kind: \"required\", message: msg };\n }\n if (isEmptyValue(v)) return null;\n // BL-567: a required button with a link and no words is a blank button on the page.\n if (r.required && f.type === \"button\" && isObj(v) && !String(v.label ?? \"\").trim())\n return { level: \"error\", kind: \"required\", message: `Add a label for ${label.toLowerCase()}` };\n if (f.type === \"color\" && typeof v === \"string\" && !isColour(v)) return { level: \"error\", kind: \"rule\", message: \"Use a hex colour, like #1a73e8\" };\n\n if (counted(f)) {\n const n = textLength(v);\n if (r.max && n > r.max) return { level: \"error\", kind: \"rule\", message: `Keep it under ${r.max} characters (${n - r.max} over)` };\n if (r.min && n < r.min) return { level: \"error\", kind: \"rule\", message: `Use at least ${r.min} characters` };\n if (r.recommendedMax && n > r.recommendedMax)\n return { level: \"warning\", kind: \"rule\", message: `Longer than the recommended ${r.recommendedMax} characters. It may get cut off.` };\n }\n if ((f.type === \"array\" || f.type === \"slot\" || f.type === \"tags\" || f.type === \"multiselect\") && Array.isArray(v)) {\n if (r.min && v.length < r.min) return { level: \"error\", kind: \"rule\", message: `Add at least ${r.min} ${r.min === 1 ? \"item\" : \"items\"}` };\n if (r.max && v.length > r.max) return { level: \"error\", kind: \"rule\", message: `Use at most ${r.max} items` };\n }\n if (f.type === \"number\" && typeof v === \"number\") {\n const lo = r.min ?? f.numeric?.min;\n const hi = r.max ?? f.numeric?.max;\n if (lo != null && v < lo) return { level: \"error\", kind: \"rule\", message: `Use ${lo} or more` };\n if (hi != null && v > hi) return { level: \"error\", kind: \"rule\", message: `Use ${hi} or less` };\n }\n if (typeof v === \"string\") {\n if (f.type === \"email\" && !/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(v)) return { level: \"error\", kind: \"rule\", message: \"Use a full email address, like hello@caldera.com\" };\n if (f.type === \"url\" && !/^(https?:\\/\\/|\\/|#|mailto:|tel:)[^\\s]*$/.test(v)) return { level: \"error\", kind: \"rule\", message: \"Use a full URL, like https://example.com, or a path like /shop\" };\n if (f.type === \"url\" && /^(javascript|data):/i.test(v)) return { level: \"error\", kind: \"rule\", message: \"This kind of link isn't allowed\" };\n if (f.type === \"slug\" && !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(v)) return { level: \"error\", kind: \"rule\", message: \"Use lowercase letters, numbers and hyphens\" };\n if (f.type === \"json\") {\n try {\n JSON.parse(v);\n } catch {\n return { level: \"error\", kind: \"rule\", message: \"Invalid JSON\" };\n }\n }\n if (r.pattern && !new RegExp(r.pattern).test(v)) return { level: \"error\", kind: \"rule\", message: r.patternMessage ?? \"This doesn't match the expected format\" };\n }\n if (f.type === \"table\") {\n // caption, header labels, typed cells, row limits, markup readiness (src/schema/table.ts) — first error wins\n const issues = tableIssues(v, { ...f.table, minRows: f.table?.minRows ?? r.min, maxRows: f.table?.maxRows ?? r.max });\n const first = issues.find((i) => i.level === \"error\") ?? issues[0];\n if (first) return { level: first.level, kind: \"rule\", message: first.message };\n }\n if (f.type === \"image\" && isObj(v) && v.url && !v.alt && r.required) return { level: \"warning\", kind: \"rule\", message: \"No alt text. Describe the image for accessibility.\" };\n return null;\n}\n\n/**\n * Values other records already hold for a ROOT field with `validation.unique` (a collection's other entries). The host\n * passes it; without it a root `unique` field is not checked (lists always are).\n */\nexport type UniquePeers = (field: FieldSchema, path: FieldPath) => unknown[] | undefined;\n\n/**\n * What makes two values \"the same\" for `unique` (V2 uniqueKey, as the server judges a placement in backend prop-fields\n * tableProblem): text trimmed and case-folded, numbers and booleans as written, a reference or link by its id. null =\n * nothing to compare. A list's items compare whole (itemKey), strings case-folded, rows without their `_id` / `_key`.\n */\nexport function uniqueKey(v: unknown): string | null {\n if (typeof v === \"string\") return v.trim() ? v.trim().toLocaleLowerCase(\"und\") : null;\n if ((typeof v === \"number\" && Number.isFinite(v)) || typeof v === \"boolean\") return String(v);\n if (!isObj(v)) return null;\n const id = v._ref ?? v.id ?? v.value ?? v.href ?? v.url;\n return typeof id === \"string\" || typeof id === \"number\" ? uniqueKey(String(id)) : null;\n}\nconst itemKey = (v: unknown): string => {\n if (typeof v === \"string\") return `s:${v.trim().toLocaleLowerCase(\"und\")}`;\n if (isObj(v)) {\n const { _id: _i, _key: _k, ...rest } = v;\n return `o:${JSON.stringify(Object.fromEntries(Object.entries(rest).sort(([a], [b]) => a.localeCompare(b))))}`;\n }\n return `j:${JSON.stringify(v)}`;\n};\n/** Indexes of the values whose key repeats one an earlier value already used. */\nfunction repeats(values: unknown[], key: (v: unknown) => string | null): number[] {\n const seen = new Set<string>();\n const out: number[] = [];\n values.forEach((v, i) => {\n const k = key(v);\n if (k === null) return;\n if (seen.has(k)) out.push(i);\n else seen.add(k);\n });\n return out;\n}\nconst shown = (v: unknown) => {\n const s = typeof v === \"string\" ? v.trim() : isObj(v) ? String(v.title ?? v.label ?? v._ref ?? v.id ?? \"\") : String(v ?? \"\");\n return s.length > 40 ? `${s.slice(0, 39)}…` : s;\n};\n\n/** Walk fields under `obj` and collect every issue, recursing into objects, array items and slot blocks. */\nexport function collectIssues(\n fields: FieldSchema[],\n obj: unknown,\n base: FieldPath,\n resolveSchema?: (t: string) => TypeSchema | undefined,\n out: KitIssue[] = [],\n /** what a `_variant` condition reads above this level (V2; the root call: the value itself) */\n cc?: CondCtx,\n /** root fields with `unique`: the values the model's other records hold (the root call only) */\n peers?: UniquePeers,\n): KitIssue[] {\n const v = isObj(obj) ? obj : {};\n const here: CondCtx = cc ?? { root: v, variant: typeof v._variant === \"string\" ? v._variant : undefined };\n const below: CondCtx = { root: here.root, parent: v, variant: here.variant };\n for (const f of fields) {\n if (isHidden(f, v, here)) continue;\n const p = [...base, f.name];\n const val = v[f.name];\n const raw = validateValue(f, val);\n if (raw) out.push({ ...raw, key: pathKey(p), path: p });\n else if (peers && !base.length && f.validation?.unique && f.type !== \"array\") {\n const k = uniqueKey(val);\n if (k !== null && (peers(f, p) ?? []).some((o) => uniqueKey(o) === k))\n out.push({ level: \"error\", kind: \"rule\", message: `Another item already uses “${shown(val)}”. ${f.title} must be different on each one.`, key: pathKey(p), path: p });\n }\n if (f.type === \"object\" && f.fields) collectIssues(f.fields, val, p, resolveSchema, out, below);\n // A list's `unique`: no item twice (the first repeat is reported on the list).\n if ((f.type === \"array\" || f.type === \"tags\" || f.type === \"multiselect\") && Array.isArray(val) && f.validation?.unique && !raw) {\n const [r] = repeats(val, itemKey);\n if (r !== undefined) out.push({ level: \"error\", kind: \"rule\", message: typeof val[r] === \"string\" ? `“${shown(val[r])}” is in the list twice. Each item can be added once.` : `Item ${r + 1} repeats an earlier item. Each item must be different.`, key: pathKey(p), path: p });\n }\n if (f.type === \"array\" && Array.isArray(val) && !primitiveItem(f)) {\n val.forEach((it, i) => {\n const s = itemSchemaFor(f, it);\n if (s?.fields) collectIssues(s.fields, it, [...p, i], resolveSchema, out, below);\n });\n // A field inside the items with `unique` (or the list's `uniqueBy`): no two items share its value.\n const keys = new Set<string>();\n for (const it of val) for (const x of itemSchemaFor(f, it)?.fields ?? []) if (x.validation?.unique || f.validation?.uniqueBy === x.name) keys.add(x.name);\n for (const k of keys) {\n const vals = val.map((it) => (isObj(it) ? it[k] : undefined));\n for (const i of repeats(vals, uniqueKey)) {\n const fp = [...p, i, k];\n const title = itemSchemaFor(f, val[i])?.fields?.find((x) => x.name === k)?.title ?? k;\n if (!out.some((x) => x.key === pathKey(fp))) out.push({ level: \"error\", kind: \"rule\", message: `${title} must be different on each item. “${shown(vals[i])}” is already used.`, key: pathKey(fp), path: fp });\n }\n }\n }\n if (f.type === \"slot\" && Array.isArray(val) && resolveSchema) {\n val.forEach((it, i) => {\n const b = isObj(it) && typeof it._type === \"string\" ? resolveSchema(it._type) : undefined;\n if (b) collectIssues(b.fields, it, [...p, i], resolveSchema, out, { root: it, variant: isObj(it) && typeof it._variant === \"string\" ? it._variant : b.variants?.[0]?.id });\n if (f.slotSettings && isObj(it)) collectIssues(f.slotSettings, it._settings, [...p, i, \"_settings\"], resolveSchema, out);\n });\n }\n }\n return out;\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bettercms-ai/kit",
3
- "version": "3.1.1",
3
+ "version": "3.1.2",
4
4
  "description": "The BetterCMS V2 Block Kit: schema language, form engine, controls and design tokens.",
5
5
  "license": "MIT",
6
6
  "type": "module",