@glw907/cairn-cms 0.56.0 → 0.56.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.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,67 @@
2
2
 
3
3
  All notable changes to this project are recorded here, most recent first.
4
4
 
5
+ ## 0.56.2
6
+
7
+ The component insert picker gains a live preview and round-trip editing, and the component contract
8
+ grows the optional fields that make a good picker possible. These refine the existing
9
+ component-editing surface and are all additive, so it is a patch; existing definitions compile
10
+ unchanged with no action required.
11
+
12
+ How the design was reached. Two research arms ran first. One surveyed how comparable systems build
13
+ their insert pickers (Gutenberg, Sanity, Wagtail, Payload, Contentful, Builder, and the git-backed and
14
+ document tools). The other hunted documented complaints from both the editor and the developer, then
15
+ paired each with a correction. Five pains recur across systems that share no code, and cairn already
16
+ beats four of them by its existing architecture: a single `ComponentDef` co-locates render and schema
17
+ (no schema-render drift), content is markdown in git (no database-migration tax), and the parser reads
18
+ real directives (lossless re-edit stays reachable). The fifth pain, configuring a block without seeing
19
+ the result, no system has solved. An adversarial critique of the first mockup then caught the preview
20
+ faked with static HTML and an ironic "Untitled" placeholder, which the shipped design corrects.
21
+
22
+ What an editor gets. The picker lists components in one column, grouped under headings, each row a
23
+ glyph, a description, and a line on when to reach for it; a search box appears once a site declares
24
+ more than eight. Picking a component that declares a `preview` opens a two-pane configure step: the
25
+ fill form on the left, and on the right the configured component rendered through the site's own
26
+ pipeline, the same machinery the edit page preview uses. This is the part no comparable CMS offers,
27
+ and cairn can offer it because it already owns the render path. The preview settles on a debounce
28
+ rather than re-rendering on every keystroke, and it stays honest: a still-empty required field shows
29
+ the skeleton with the empty region called out rather than a fabricated result, and a render that
30
+ throws shows a failed-to-render surface and keeps the form. A component that declares no `preview`
31
+ keeps the single-column form. Required fields are marked and block Insert with inline messages, and
32
+ the modal collapses to one column on a narrow screen.
33
+
34
+ Round-trip editing closes the loop. With the cursor in a placed component, an Edit block control opens
35
+ it back into the same guided form, pre-filled, and Update rewrites that block in place. It is offered
36
+ only when the round-trip is provably lossless for that block: one that carries an attribute or a child
37
+ the component does not declare is left for hand-editing rather than silently rewritten, the failure
38
+ that corrupts content in the git-backed editors the research surveyed. A guided edit that does run
39
+ preserves content and normalizes formatting to the canonical serialization. A consumer site that
40
+ mounts `CairnAdmin` gets this with no change.
41
+
42
+ For consumers, the `ComponentDef` contract gains optional fields, so existing definitions compile
43
+ unchanged with no action required:
44
+
45
+ - `icon` shows a glyph from the site icon set beside the label in the picker.
46
+ - `group` puts a component under a category heading, in declaration order.
47
+ - `hidden` keeps a component out of the top-level picker (for a nested-only component).
48
+ - `preview` is a structured sample (`attributes` and `slots`) the picker seeds the form with and
49
+ renders. Declaring it is what opts a component into the two-pane preview layout.
50
+ - `pattern` and `validate` on an attribute field add inline validation, the regex case and a pure
51
+ cross-field escape hatch.
52
+ - `itemLabel` on a repeatable slot derives a row's label, so a list of items is not a column of blanks.
53
+
54
+ Round-trip editing of a placed component, a persistent catalog rail, and a slash-trigger are designed
55
+ for but deferred to a later pass.
56
+
57
+ ## 0.56.1
58
+
59
+ Test and CI reliability only; the published library is unchanged from 0.56.0. The component test job
60
+ flaked in CI on the editor's heavier pages because the editor's per-browser preferences live in
61
+ localStorage and nothing cleared it between tests, so a leaked zen preference could hide the toolbar a
62
+ later test waited for. localStorage is now isolated before each component test, with a regression
63
+ guard, plus a retry on the browser test project and steadier waits in the insert-dialog tests. No
64
+ consumer action.
65
+
5
66
  ## 0.56.0
6
67
 
7
68
  Two passes ship together: the markdown editor's folding gets a proper home, and the engine's gates,
package/README.md CHANGED
@@ -52,9 +52,16 @@ doesn't, cairn is the wrong tool and will not try to meet you halfway.
52
52
 
53
53
  ## Status
54
54
 
55
- cairn-cms runs the two production sites above. It is `0.x` and breaks between minor versions,
56
- so pin a caret range and read the [CHANGELOG](./CHANGELOG.md) before bumping; every breaking
57
- entry carries a "Consumers must" line. The author is still working through the core-feature
55
+ cairn-cms runs the two production sites above. It is `0.x`, and the version position signals scale.
56
+ A minor bump (`0.X.0`) is reserved for a new subsystem or public surface that did not exist before,
57
+ such as a new entry point, a new content concept, or the scaffolder, and it may break. Everything
58
+ that refines, extends, or adds an affordance to a surface that already exists (the editor, the admin,
59
+ auth, delivery) is a patch (`0.X.Y`), even when it gives an editor a new thing to do; a redesign, a
60
+ round-trip edit on an existing surface, or a new optional config field is a patch. When the call is
61
+ unclear, it is a patch. A minor release carries a `<!-- release-size: minor -->` marker in its
62
+ CHANGELOG entry, which the `check:version` gate requires, so a minor is always a deliberate,
63
+ documented choice. Pin a caret range and read the [CHANGELOG](./CHANGELOG.md) before taking a minor;
64
+ every breaking entry carries a "Consumers must" line. The author is still working through the core-feature
58
65
  [ROADMAP](./ROADMAP.md), and the project stays closely held until that core lands. A
59
66
  contributor who feels inspired is welcome to open an issue or a discussion; there is no
60
67
  formal contribution process yet, so this is not an open call for pull requests.
@@ -1,13 +1,17 @@
1
1
  <!--
2
2
  @component
3
- The schema-driven fill form for one component. It holds the working ComponentValues, seeded from
4
- emptyValues(def), and renders attribute fields and the title/body and other non-repeatable slots.
5
- Submit (Task 6) serializes and validates through buildComponentInsert and calls onInsert with the
6
- markdown. Back returns to the picker. This is not a nested HTML form; Insert calls a callback.
3
+ The schema-driven fill form for one component, the left column of the configure step. It holds the
4
+ working ComponentValues, seeded from previewValues(def) (the emptyValues base with any declared
5
+ preview sample overlaid), and renders attribute fields and the title/body and other slots. Required
6
+ fields carry an asterisk and aria-required, and Insert disables while any required field is empty.
7
+ Submit serializes and validates through buildComponentInsert and calls onInsert with the markdown.
8
+ This is not a nested HTML form; Insert calls a callback. The dialog owns the header (the Insert >
9
+ group breadcrumb and the Back control) and, in the two-pane case, the preview pane; this component
10
+ binds out its live `values` and `incomplete` so the dialog can render that preview.
7
11
  -->
8
12
  <script lang="ts">
9
13
  import { untrack } from 'svelte';
10
- import { emptyValues, type ComponentDef } from '../render/registry.js';
14
+ import { previewValues, type ComponentDef, type ComponentValues } from '../render/registry.js';
11
15
  import { buildComponentInsert } from '../render/component-insert.js';
12
16
  import type { IconSet } from '../render/glyph.js';
13
17
  import IconPicker from './IconPicker.svelte';
@@ -17,15 +21,39 @@ markdown. Back returns to the picker. This is not a nested HTML form; Insert cal
17
21
  icons?: IconSet;
18
22
  /** Called with the serialized markdown when the form validates. */
19
23
  onInsert: (markdown: string) => void;
20
- /** Return to the picker. */
21
- onBack: () => void;
24
+ /** The live working values, bound out so a host (the dialog) can render a preview from them. */
25
+ values?: ComponentValues;
26
+ /** True while a required attribute or slot is still empty, bound out so the host's preview can
27
+ * show the incomplete state and the host can mirror the disabled Insert. */
28
+ incomplete?: boolean;
29
+ /** Seed the working values from these instead of the schema's preview sample. The dialog passes
30
+ * it in edit mode to re-open a placed component into its own values; the catalog insert path
31
+ * leaves it unset and keeps the previewValues seed. */
32
+ initial?: ComponentValues;
33
+ /** The submit button's label. The dialog passes 'Update' in edit mode; the insert path keeps
34
+ * the default. */
35
+ submitLabel?: string;
22
36
  }
23
37
 
24
- let { def, icons, onInsert, onBack }: Props = $props();
38
+ let {
39
+ def,
40
+ icons,
41
+ onInsert,
42
+ values = $bindable(),
43
+ incomplete = $bindable(),
44
+ initial,
45
+ submitLabel = 'Insert',
46
+ }: Props = $props();
25
47
 
26
- // Working values, seeded once from the schema. $state makes the nested records deeply reactive.
27
- // untrack marks the seed as a deliberate one-time read of the initial def, not a reactive miss.
28
- let values = $state(untrack(() => emptyValues(def)));
48
+ // Working values, seeded once from `initial` in edit mode, otherwise from the schema and any
49
+ // declared preview sample. $state makes the nested records deeply reactive. untrack marks the
50
+ // seed as a deliberate one-time read, not a reactive miss. previewValues falls back to
51
+ // emptyValues when no preview.
52
+ let working = $state(untrack(() => initial ?? previewValues(def)));
53
+ // Mirror the working values out to the bindable prop so the dialog's preview reads them live.
54
+ $effect(() => {
55
+ values = working;
56
+ });
29
57
 
30
58
  const attributes = $derived(def.attributes ?? []);
31
59
  // Non-repeatable slots render here; the repeatable list is handled separately.
@@ -34,22 +62,32 @@ markdown. Back returns to the picker. This is not a nested HTML form; Insert cal
34
62
 
35
63
  // The live $state proxy array for a repeatable slot, so push/splice stay reactive.
36
64
  function slotItems(name: string): string[] {
37
- const v = values.slots[name];
65
+ const v = working.slots[name];
38
66
  return Array.isArray(v) ? v : [];
39
67
  }
40
68
 
41
69
  // Stable per-item ids run parallel to each repeatable slot's value array, so the {#each} keys by
42
70
  // identity instead of index. A mid-list removal then drops the right DOM node and the focused
43
71
  // item follows the data. Ids come from a monotonic module-local counter, never Math.random or
44
- // Date.now. The value arrays in values.slots stay the canonical string lists serializeComponent
45
- // reads, so the emitted markdown is unchanged. emptyValues seeds every repeatable slot to [], so
46
- // the id lists start empty and stay in lockstep with the values through addItem/removeItem.
72
+ // Date.now. The value arrays in working.slots stay the canonical string lists serializeComponent
73
+ // reads, so the emitted markdown is unchanged. The preview seed can fill a repeatable slot, so
74
+ // each seeded item needs a parallel id from the start.
47
75
  let nextId = 0;
48
76
  const itemIds = $state<Record<string, number[]>>(
49
- untrack(() => Object.fromEntries((def.slots ?? []).filter((s) => s.kind === 'repeatable').map((s) => [s.name, []]))),
77
+ untrack(() =>
78
+ Object.fromEntries(
79
+ (def.slots ?? [])
80
+ .filter((s) => s.kind === 'repeatable')
81
+ .map((s) => {
82
+ const seeded = working.slots[s.name];
83
+ const count = Array.isArray(seeded) ? seeded.length : 0;
84
+ return [s.name, Array.from({ length: count }, () => nextId++)];
85
+ }),
86
+ ),
87
+ ),
50
88
  );
51
89
 
52
- // emptyValues and the itemIds seed both cover every repeatable slot, so this read always hits.
90
+ // previewValues and the itemIds seed both cover every repeatable slot, so this read always hits.
53
91
  function slotIds(name: string): number[] {
54
92
  return itemIds[name] ?? [];
55
93
  }
@@ -64,41 +102,106 @@ markdown. Back returns to the picker. This is not a nested HTML form; Insert cal
64
102
  slotIds(name).splice(index, 1);
65
103
  }
66
104
 
105
+ // The row label for a repeatable item: the slot's itemLabel over the item's values and index,
106
+ // falling back to `${label} ${i + 1}` when it returns nothing. v1 repeatable items hold a single
107
+ // string under the first item field's key, so the item record passed to itemLabel carries it.
108
+ function rowLabel(slot: (typeof repeatableSlots)[number], value: string, index: number): string {
109
+ const fallback = `${slot.label} ${index + 1}`;
110
+ if (!slot.itemLabel) return fallback;
111
+ const key = slot.itemFields?.[0]?.key ?? 'text';
112
+ const derived = slot.itemLabel({ [key]: value }, index);
113
+ return derived && derived.trim() ? derived : fallback;
114
+ }
115
+
67
116
  // Typed accessors over the unions so explicit value targets stay sound.
68
117
  function asString(key: string): string {
69
- const v = values.attributes[key];
118
+ const v = working.attributes[key];
70
119
  return typeof v === 'string' ? v : '';
71
120
  }
72
121
  function asBool(key: string): boolean {
73
- return values.attributes[key] === true;
122
+ return working.attributes[key] === true;
74
123
  }
75
124
  function slotString(name: string): string {
76
- const v = values.slots[name];
125
+ const v = working.slots[name];
77
126
  return typeof v === 'string' ? v : '';
78
127
  }
79
128
 
80
- // Field-keyed validation errors from the last submit, keyed by attribute key or slot name.
81
- let errors = $state<Record<string, string>>({});
129
+ // A required attribute is unmet only for a text/select/icon field left empty; a boolean is always
130
+ // met (its false is a real choice). A required slot is unmet when its string is empty or its
131
+ // repeatable list has no non-empty item. This drives the asterisk-marked fields, the disabled
132
+ // Insert, and (through the bound `incomplete`) the dialog's incomplete preview state.
133
+ const incompleteState = $derived.by(() => {
134
+ for (const field of attributes) {
135
+ if (!field.required || field.type === 'boolean') continue;
136
+ if (asString(field.key) === '') return true;
137
+ }
138
+ for (const slot of def.slots ?? []) {
139
+ if (!slot.required) continue;
140
+ const v = working.slots[slot.name];
141
+ const filled = Array.isArray(v) ? v.some((i) => i !== '') : typeof v === 'string' && v !== '';
142
+ if (!filled) return true;
143
+ }
144
+ return false;
145
+ });
146
+ $effect(() => {
147
+ incomplete = incompleteState;
148
+ });
149
+
150
+ // Field-keyed validation errors from the last submit (pattern, validate, select-domain), keyed by
151
+ // attribute key or slot name.
152
+ let submitErrors = $state<Record<string, string>>({});
153
+
154
+ // Fields the editor has touched, so a required-empty error shows after interaction rather than on
155
+ // a fresh open. Keyed by attribute key or slot name.
156
+ let touched = $state<Record<string, boolean>>({});
157
+ function markTouched(key: string): void {
158
+ touched[key] = true;
159
+ }
160
+
161
+ // The visible field errors. Only the required-empty message ("{label} is required.") shows live,
162
+ // for a touched-and-empty required field; pattern and validate errors surface on submit. Both are
163
+ // merged here, the submit errors last so a pattern or validate message wins. Insert stays disabled
164
+ // while incompleteState holds, so a required-empty field never serializes; this surfaces the why
165
+ // next to the field meanwhile.
166
+ const errors = $derived.by(() => {
167
+ const out: Record<string, string> = {};
168
+ for (const field of attributes) {
169
+ if (field.required && field.type !== 'boolean' && touched[field.key] && asString(field.key) === '') {
170
+ out[field.key] = `${field.label} is required.`;
171
+ }
172
+ }
173
+ for (const slot of def.slots ?? []) {
174
+ if (!slot.required) continue;
175
+ const v = working.slots[slot.name];
176
+ const filled = Array.isArray(v) ? v.some((i) => i !== '') : typeof v === 'string' && v !== '';
177
+ if (touched[slot.name] && !filled) out[slot.name] = `${slot.label} is required.`;
178
+ }
179
+ return { ...out, ...submitErrors };
180
+ });
181
+
182
+ // The form container. Once it is bound, focus its first focusable control so the editor types
183
+ // straight into the form. The effect tracks formEl so it runs when the node lands; the focus call
184
+ // is untracked so a later value change does not steal focus back to the first field.
185
+ let formEl = $state<HTMLElement | null>(null);
186
+ $effect(() => {
187
+ if (!formEl) return;
188
+ untrack(() => formEl!.querySelector<HTMLElement>('input, select, textarea')?.focus());
189
+ });
82
190
 
83
191
  // Serialize and validate through the pure helper. On success clear errors and emit the markdown;
84
192
  // on failure keep the field-keyed errors so each field can show its message and insert nothing.
85
193
  async function submit() {
86
- const result = await buildComponentInsert(def, values);
194
+ const result = await buildComponentInsert(def, working);
87
195
  if (result.ok) {
88
- errors = {};
196
+ submitErrors = {};
89
197
  onInsert(result.markdown);
90
198
  } else {
91
- errors = result.errors;
199
+ submitErrors = result.errors;
92
200
  }
93
201
  }
94
202
  </script>
95
203
 
96
- <div class="flex flex-col gap-3">
97
- <div class="flex items-center justify-between">
98
- <h3 class="text-sm font-semibold">{def.label}</h3>
99
- <button type="button" class="btn btn-ghost btn-xs" onclick={onBack}>Back</button>
100
- </div>
101
-
204
+ <div class="flex flex-col gap-3" bind:this={formEl}>
102
205
  {#each attributes as field (field.key)}
103
206
  {#if field.type === 'boolean'}
104
207
  <label class="label cursor-pointer justify-start gap-2">
@@ -108,19 +211,24 @@ markdown. Back returns to the picker. This is not a nested HTML form; Insert cal
108
211
  aria-invalid={Boolean(errors[field.key])}
109
212
  aria-describedby={errors[field.key] ? `err-${field.key}` : undefined}
110
213
  checked={asBool(field.key)}
111
- onchange={(e) => (values.attributes[field.key] = e.currentTarget.checked)}
214
+ onchange={(e) => (working.attributes[field.key] = e.currentTarget.checked)}
112
215
  />
113
216
  <span class="text-sm">{field.label}</span>
114
217
  </label>
115
218
  {:else if field.type === 'select'}
116
219
  <label class="flex flex-col gap-1">
117
- <span class="text-sm font-medium">{field.label}</span>
220
+ <span class="text-sm font-medium">{field.label}{#if field.required}<span data-testid="cairn-pk-req" class="text-error" aria-hidden="true">*</span>{/if}</span>
118
221
  <select
119
222
  class="select"
223
+ aria-required={field.required ? 'true' : undefined}
120
224
  aria-invalid={Boolean(errors[field.key])}
121
225
  aria-describedby={errors[field.key] ? `err-${field.key}` : undefined}
122
226
  value={asString(field.key)}
123
- onchange={(e) => (values.attributes[field.key] = e.currentTarget.value)}
227
+ onchange={(e) => {
228
+ working.attributes[field.key] = e.currentTarget.value;
229
+ markTouched(field.key);
230
+ }}
231
+ onblur={() => markTouched(field.key)}
124
232
  >
125
233
  {#if !field.required}<option value="">—</option>{/if}
126
234
  {#each field.options ?? [] as opt (opt)}<option value={opt}>{opt}</option>{/each}
@@ -128,24 +236,29 @@ markdown. Back returns to the picker. This is not a nested HTML form; Insert cal
128
236
  </label>
129
237
  {:else if field.type === 'icon' && icons}
130
238
  <div class="flex flex-col gap-1">
131
- <span class="text-sm font-medium">{field.label}</span>
239
+ <span class="text-sm font-medium">{field.label}{#if field.required}<span data-testid="cairn-pk-req" class="text-error" aria-hidden="true">*</span>{/if}</span>
132
240
  <IconPicker
133
241
  {icons}
134
242
  label={field.label}
135
243
  value={asString(field.key)}
136
244
  required={field.required ?? false}
137
- onChange={(name) => (values.attributes[field.key] = name)}
245
+ onChange={(name) => (working.attributes[field.key] = name)}
138
246
  />
139
247
  </div>
140
248
  {:else}
141
249
  <label class="flex flex-col gap-1">
142
- <span class="text-sm font-medium">{field.label}</span>
250
+ <span class="text-sm font-medium">{field.label}{#if field.required}<span data-testid="cairn-pk-req" class="text-error" aria-hidden="true">*</span>{/if}</span>
143
251
  <input
144
252
  class="input"
253
+ aria-required={field.required ? 'true' : undefined}
145
254
  aria-invalid={Boolean(errors[field.key])}
146
255
  aria-describedby={errors[field.key] ? `err-${field.key}` : undefined}
147
256
  value={asString(field.key)}
148
- oninput={(e) => (values.attributes[field.key] = e.currentTarget.value)}
257
+ oninput={(e) => {
258
+ working.attributes[field.key] = e.currentTarget.value;
259
+ markTouched(field.key);
260
+ }}
261
+ onblur={() => markTouched(field.key)}
149
262
  />
150
263
  </label>
151
264
  {/if}
@@ -155,25 +268,35 @@ markdown. Back returns to the picker. This is not a nested HTML form; Insert cal
155
268
  {#each flatSlots as slot (slot.name)}
156
269
  {#if slot.kind === 'markdown'}
157
270
  <label class="flex flex-col gap-1">
158
- <span class="text-sm font-medium">{slot.label}</span>
271
+ <span class="text-sm font-medium">{slot.label}{#if slot.required}<span data-testid="cairn-pk-req" class="text-error" aria-hidden="true">*</span>{/if}</span>
159
272
  <textarea
160
273
  class="textarea"
274
+ aria-required={slot.required ? 'true' : undefined}
161
275
  aria-invalid={Boolean(errors[slot.name])}
162
276
  aria-describedby={errors[slot.name] ? `err-${slot.name}` : undefined}
163
277
  rows={3}
164
278
  value={slotString(slot.name)}
165
- oninput={(e) => (values.slots[slot.name] = e.currentTarget.value)}
279
+ oninput={(e) => {
280
+ working.slots[slot.name] = e.currentTarget.value;
281
+ markTouched(slot.name);
282
+ }}
283
+ onblur={() => markTouched(slot.name)}
166
284
  ></textarea>
167
285
  </label>
168
286
  {:else}
169
287
  <label class="flex flex-col gap-1">
170
- <span class="text-sm font-medium">{slot.label}</span>
288
+ <span class="text-sm font-medium">{slot.label}{#if slot.required}<span data-testid="cairn-pk-req" class="text-error" aria-hidden="true">*</span>{/if}</span>
171
289
  <input
172
290
  class="input"
291
+ aria-required={slot.required ? 'true' : undefined}
173
292
  aria-invalid={Boolean(errors[slot.name])}
174
293
  aria-describedby={errors[slot.name] ? `err-${slot.name}` : undefined}
175
294
  value={slotString(slot.name)}
176
- oninput={(e) => (values.slots[slot.name] = e.currentTarget.value)}
295
+ oninput={(e) => {
296
+ working.slots[slot.name] = e.currentTarget.value;
297
+ markTouched(slot.name);
298
+ }}
299
+ onblur={() => markTouched(slot.name)}
177
300
  />
178
301
  </label>
179
302
  {/if}
@@ -184,11 +307,17 @@ markdown. Back returns to the picker. This is not a nested HTML form; Insert cal
184
307
  {@const items = slotItems(slot.name)}
185
308
  {@const ids = slotIds(slot.name)}
186
309
  <fieldset class="rounded-box border border-[var(--cairn-card-border)] flex flex-col gap-2 p-2">
187
- <legend class="text-sm font-medium">{slot.label}</legend>
188
- <!-- Keyed by the parallel stable id so a mid-list removal drops the right node and focus follows the data; the value still binds to the canonical items[i] string the serializer reads. -->
310
+ <legend class="text-sm font-medium">{slot.label}{#if slot.required}<span data-testid="cairn-pk-req" class="text-error" aria-hidden="true">*</span>{/if}</legend>
311
+ <!-- Keyed by the parallel stable id so a mid-list removal drops the right node and focus follows the data; the value still binds to the canonical items[i] string the serializer reads. The visible row tag derives from itemLabel, falling back to the indexed label. -->
189
312
  {#each ids as id, i (id)}
313
+ {@const label = rowLabel(slot, items[i] ?? '', i)}
190
314
  <div class="flex items-center gap-2">
191
- <input class="input input-sm flex-1" aria-label={`${slot.label} ${i + 1}`} bind:value={items[i]} />
315
+ <span class="flex-none text-xs text-[var(--color-muted)]">{label}</span>
316
+ <input
317
+ class="input input-sm flex-1"
318
+ aria-label={`${slot.label} ${i + 1}`}
319
+ bind:value={items[i]}
320
+ />
192
321
  <button type="button" class="btn btn-ghost btn-sm" aria-label={`Remove item ${i + 1}`} onclick={() => removeItem(slot.name, i)}>✕</button>
193
322
  </div>
194
323
  {/each}
@@ -197,5 +326,5 @@ markdown. Back returns to the picker. This is not a nested HTML form; Insert cal
197
326
  </fieldset>
198
327
  {/each}
199
328
 
200
- <button type="button" class="btn btn-primary btn-sm mt-2" onclick={submit}>Insert</button>
329
+ <button type="button" class="btn btn-primary btn-sm mt-2 self-start" disabled={incompleteState} onclick={submit}>{submitLabel}</button>
201
330
  </div>
@@ -1,19 +1,33 @@
1
- import { type ComponentDef } from '../render/registry.js';
1
+ import { type ComponentDef, type ComponentValues } from '../render/registry.js';
2
2
  import type { IconSet } from '../render/glyph.js';
3
3
  interface Props {
4
4
  def: ComponentDef;
5
5
  icons?: IconSet;
6
6
  /** Called with the serialized markdown when the form validates. */
7
7
  onInsert: (markdown: string) => void;
8
- /** Return to the picker. */
9
- onBack: () => void;
8
+ /** The live working values, bound out so a host (the dialog) can render a preview from them. */
9
+ values?: ComponentValues;
10
+ /** True while a required attribute or slot is still empty, bound out so the host's preview can
11
+ * show the incomplete state and the host can mirror the disabled Insert. */
12
+ incomplete?: boolean;
13
+ /** Seed the working values from these instead of the schema's preview sample. The dialog passes
14
+ * it in edit mode to re-open a placed component into its own values; the catalog insert path
15
+ * leaves it unset and keeps the previewValues seed. */
16
+ initial?: ComponentValues;
17
+ /** The submit button's label. The dialog passes 'Update' in edit mode; the insert path keeps
18
+ * the default. */
19
+ submitLabel?: string;
10
20
  }
11
21
  /**
12
- * The schema-driven fill form for one component. It holds the working ComponentValues, seeded from
13
- * emptyValues(def), and renders attribute fields and the title/body and other non-repeatable slots.
14
- * Submit (Task 6) serializes and validates through buildComponentInsert and calls onInsert with the
15
- * markdown. Back returns to the picker. This is not a nested HTML form; Insert calls a callback.
22
+ * The schema-driven fill form for one component, the left column of the configure step. It holds the
23
+ * working ComponentValues, seeded from previewValues(def) (the emptyValues base with any declared
24
+ * preview sample overlaid), and renders attribute fields and the title/body and other slots. Required
25
+ * fields carry an asterisk and aria-required, and Insert disables while any required field is empty.
26
+ * Submit serializes and validates through buildComponentInsert and calls onInsert with the markdown.
27
+ * This is not a nested HTML form; Insert calls a callback. The dialog owns the header (the Insert >
28
+ * group breadcrumb and the Back control) and, in the two-pane case, the preview pane; this component
29
+ * binds out its live `values` and `incomplete` so the dialog can render that preview.
16
30
  */
17
- declare const ComponentForm: import("svelte").Component<Props, {}, "">;
31
+ declare const ComponentForm: import("svelte").Component<Props, {}, "incomplete" | "values">;
18
32
  type ComponentForm = ReturnType<typeof ComponentForm>;
19
33
  export default ComponentForm;