@cosmicdrift/kumiko-samples 0.418.0 → 0.420.0

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.
Files changed (90) hide show
  1. package/package.json +1 -1
  2. package/packages/bundled-features/package.json +11 -1
  3. package/packages/bundled-features/src/shared/index.ts +6 -0
  4. package/packages/bundled-features/src/shared/tenant-scoped-subject.ts +28 -0
  5. package/packages/bundled-features/src/signature/changes.json +6 -0
  6. package/packages/bundled-features/src/signature/feature.ts +1 -1
  7. package/packages/bundled-features/src/signature/grant.ts +13 -14
  8. package/packages/bundled-features/src/signature/png.ts +33 -12
  9. package/packages/bundled-features/src/template-resolver/api.ts +17 -7
  10. package/packages/bundled-features/src/template-resolver/changes.json +62 -0
  11. package/packages/bundled-features/src/template-resolver/compile-document-body.ts +10 -9
  12. package/packages/bundled-features/src/template-resolver/compile-document-styles.ts +170 -0
  13. package/packages/bundled-features/src/template-resolver/document-frames.ts +68 -0
  14. package/packages/bundled-features/src/template-resolver/document-op-blocks.ts +682 -0
  15. package/packages/bundled-features/src/template-resolver/document-ops.ts +170 -128
  16. package/packages/bundled-features/src/template-resolver/document-print-only.ts +65 -0
  17. package/packages/bundled-features/src/template-resolver/document-sanitizer.ts +53 -19
  18. package/packages/bundled-features/src/template-resolver/feature.ts +15 -0
  19. package/packages/bundled-features/src/template-resolver/handlers/apply-layout.write.ts +137 -0
  20. package/packages/bundled-features/src/template-resolver/handlers/create-layout.write.ts +87 -0
  21. package/packages/bundled-features/src/template-resolver/handlers/document-base.ts +2 -2
  22. package/packages/bundled-features/src/template-resolver/handlers/document-blocks.query.ts +13 -8
  23. package/packages/bundled-features/src/template-resolver/handlers/document-region.ts +47 -0
  24. package/packages/bundled-features/src/template-resolver/handlers/failure-reason.ts +13 -0
  25. package/packages/bundled-features/src/template-resolver/handlers/import-bundle-system.write.ts +3 -0
  26. package/packages/bundled-features/src/template-resolver/handlers/layout-source.query.ts +17 -5
  27. package/packages/bundled-features/src/template-resolver/handlers/overview.query.ts +16 -4
  28. package/packages/bundled-features/src/template-resolver/handlers/patch-draft.write.ts +20 -6
  29. package/packages/bundled-features/src/template-resolver/handlers/publish-templates.write.ts +69 -0
  30. package/packages/bundled-features/src/template-resolver/handlers/set.write.ts +7 -0
  31. package/packages/bundled-features/src/template-resolver/handlers/template-write.ts +15 -3
  32. package/packages/bundled-features/src/template-resolver/handlers/tenant-settings.ts +159 -0
  33. package/packages/bundled-features/src/template-resolver/handlers/toggle-status.write.ts +25 -10
  34. package/packages/bundled-features/src/template-resolver/handlers/upsert-system.write.ts +7 -3
  35. package/packages/bundled-features/src/template-resolver/handlers/usage.query.ts +131 -18
  36. package/packages/bundled-features/src/template-resolver/handlers/validate.query.ts +10 -0
  37. package/packages/bundled-features/src/template-resolver/i18n.ts +3 -0
  38. package/packages/bundled-features/src/template-resolver/index.ts +39 -0
  39. package/packages/bundled-features/src/template-resolver/layout-regions.ts +54 -16
  40. package/packages/bundled-features/src/template-resolver/print-document.ts +3 -1
  41. package/packages/bundled-features/src/template-resolver/seeding.ts +4 -0
  42. package/packages/bundled-features/src/template-resolver/template-delivery-policy.ts +11 -1
  43. package/packages/bundled-features/src/template-resolver/template-edit-policy.ts +37 -1
  44. package/packages/bundled-features/src/template-resolver/template-meta.ts +31 -6
  45. package/packages/bundled-features/src/template-resolver/template-preview.ts +29 -9
  46. package/packages/bundled-features/src/template-resolver/template-validation.ts +10 -3
  47. package/packages/bundled-features/src/template-resolver/web/constants.ts +33 -0
  48. package/packages/bundled-features/src/template-resolver/web/document-blocks.ts +5 -0
  49. package/packages/bundled-features/src/template-resolver/web/document-editor-extensions.ts +93 -25
  50. package/packages/bundled-features/src/template-resolver/web/document-editor-fonts.ts +13 -0
  51. package/packages/bundled-features/src/template-resolver/web/document-editor.tsx +4 -1
  52. package/packages/bundled-features/src/template-resolver/web/document-fonts.ts +21 -0
  53. package/packages/bundled-features/src/template-resolver/web/document-frame-control.ts +428 -0
  54. package/packages/bundled-features/src/template-resolver/web/document-frame-node-view.tsx +207 -0
  55. package/packages/bundled-features/src/template-resolver/web/document-print-decorations.ts +246 -0
  56. package/packages/bundled-features/src/template-resolver/web/document-print-defaults.ts +59 -0
  57. package/packages/bundled-features/src/template-resolver/web/document-print-style.ts +381 -0
  58. package/packages/bundled-features/src/template-resolver/web/document-repeat-strip.ts +80 -0
  59. package/packages/bundled-features/src/template-resolver/web/document-schema.ts +87 -19
  60. package/packages/bundled-features/src/template-resolver/web/document-style-css.ts +214 -0
  61. package/packages/bundled-features/src/template-resolver/web/document-tiptap-bubble.tsx +185 -16
  62. package/packages/bundled-features/src/template-resolver/web/document-tiptap-content.tsx +70 -7
  63. package/packages/bundled-features/src/template-resolver/web/document-tiptap-context.ts +13 -1
  64. package/packages/bundled-features/src/template-resolver/web/document-tiptap-editor.tsx +25 -4
  65. package/packages/bundled-features/src/template-resolver/web/document-tiptap-helpers.ts +276 -23
  66. package/packages/bundled-features/src/template-resolver/web/document-tiptap-toolbar-groups.tsx +449 -10
  67. package/packages/bundled-features/src/template-resolver/web/document-tiptap-toolbar.tsx +108 -17
  68. package/packages/bundled-features/src/template-resolver/web/document-toolbar-blocks.ts +20 -0
  69. package/packages/bundled-features/src/template-resolver/web/fontsource-css.d.ts +2 -0
  70. package/packages/bundled-features/src/template-resolver/web/i18n.ts +32 -0
  71. package/packages/bundled-features/src/template-resolver/web/index.ts +38 -0
  72. package/packages/bundled-features/src/template-resolver/web/pdf-constants.ts +16 -0
  73. package/packages/bundled-features/src/template-resolver/web/placeholder-text.ts +6 -3
  74. package/packages/bundled-features/src/template-resolver/web/qualified-names.ts +7 -0
  75. package/packages/bundled-features/src/template-resolver/web/use-document-tiptap-model.ts +74 -5
  76. package/packages/bundled-features/src/tenant/company-config.ts +48 -0
  77. package/packages/bundled-features/src/tenant/feature.ts +11 -0
  78. package/packages/bundled-features/src/tenant/i18n.ts +14 -0
  79. package/samples/apps/ui-walkthrough/src/app/auth-constants.ts +51 -0
  80. package/samples/apps/ui-walkthrough/src/app/seed-print-editor-tenants.ts +118 -0
  81. package/samples/apps/ui-walkthrough/src/app/seed-templates.ts +2 -0
  82. package/samples/apps/ui-walkthrough/src/app/server.ts +9 -1
  83. package/samples/apps/ui-walkthrough/src/app/template-seed-data.ts +27 -1
  84. package/samples/apps/ui-walkthrough/src/features/rental/i18n.ts +8 -0
  85. package/samples/apps/ui-walkthrough/src/features/rental/screens.ts +1 -0
  86. package/samples/apps/ui-walkthrough/src/run-config.ts +1 -0
  87. package/samples/apps/use-all-bundled/feature-manifest.json +236 -0
  88. package/samples/recipes/pdf-letterhead/README.md +23 -0
  89. package/samples/recipes/pdf-letterhead/package.json +12 -0
  90. package/samples/recipes/pdf-letterhead/src/letterhead.ts +92 -0
@@ -1,14 +1,43 @@
1
- import { cn } from "@cosmicdrift/kumiko-renderer/web";
1
+ import { cn, EditorToolbarPill } from "@cosmicdrift/kumiko-renderer/web";
2
+ import { isOneOf } from "@cosmicdrift/kumiko-types/type-guards";
2
3
  import {
3
4
  Bold as BoldIcon,
4
5
  Italic as ItalicIcon,
5
6
  Link as LinkIcon,
6
7
  List,
7
8
  ListOrdered,
9
+ MoveVertical,
8
10
  Underline as UnderlineIcon,
9
11
  } from "lucide-react";
10
12
  import type { ReactNode } from "react";
13
+ import { DOCUMENT_FONT_LABELS, DOCUMENT_FONTS } from "./document-fonts.ts";
14
+ import {
15
+ CELL_PADDING_MM_RANGE,
16
+ DIVIDER_WEIGHT_PT_RANGE,
17
+ DOCUMENT_TABLE_ALIGNMENTS,
18
+ TABLE_WIDTH_MM_RANGE,
19
+ } from "./document-print-style.ts";
20
+ import type { DocumentRowLine } from "./document-style-css.ts";
11
21
  import type { TiptapContext } from "./document-tiptap-context.ts";
22
+ import {
23
+ addPlainRowBelow,
24
+ DEFAULT_ROW_LINE,
25
+ FONT_SIZES_PT,
26
+ LINE_HEIGHTS,
27
+ PARAGRAPH_SPACES_PT,
28
+ type PrintTableState,
29
+ setPrintBlockStyle,
30
+ setPrintTextStyle,
31
+ setRowLine,
32
+ setTableAttributes,
33
+ toggleTableBorders,
34
+ } from "./document-tiptap-helpers.ts";
35
+
36
+ export function Separator({ compact = false }: { readonly compact?: boolean }): ReactNode {
37
+ return (
38
+ <span aria-hidden="true" className={cn("h-5 w-px bg-border", compact ? "mx-0.5" : "mx-2")} />
39
+ );
40
+ }
12
41
 
13
42
  // Canvas chrome is one flat row: unframed ghost buttons, glyph plus text for the longer names.
14
43
  export function iconButton(
@@ -59,6 +88,32 @@ function markContent(
59
88
  return canvas ? <span className={className}>{letter}</span> : icon;
60
89
  }
61
90
 
91
+ function FlatSelectBox({
92
+ flat,
93
+ widthClass,
94
+ testId,
95
+ children,
96
+ }: {
97
+ readonly flat: boolean;
98
+ readonly widthClass: string;
99
+ readonly testId?: string;
100
+ readonly children: ReactNode;
101
+ }): ReactNode {
102
+ return (
103
+ <div
104
+ data-testid={testId}
105
+ // biome-ignore lint/plugin: the toolbar selects sit flush in the editor toolbar; ComboboxInput has no flat trigger variant
106
+ className={cn(
107
+ !flat && widthClass,
108
+ flat &&
109
+ "w-auto shrink-0 [&_button[aria-haspopup=listbox]]:border-transparent [&_button[aria-haspopup=listbox]]:bg-transparent [&_button[aria-haspopup=listbox]]:shadow-none",
110
+ )}
111
+ >
112
+ {children}
113
+ </div>
114
+ );
115
+ }
116
+
62
117
  export function renderParagraphStyleSelect(c: TiptapContext): ReactNode {
63
118
  const { t, Field, Input, id, canvas, compact, readOnly, activeState } = c;
64
119
  const paragraphStyleLabel = t("template-resolver.documentEditor.paragraphStyle");
@@ -69,14 +124,7 @@ export function renderParagraphStyleSelect(c: TiptapContext): ReactNode {
69
124
  { value: "3", label: t("template-resolver.documentEditor.heading3") },
70
125
  ];
71
126
  return (
72
- <div
73
- // biome-ignore lint/plugin: the toolbar paragraph select sits flush in the editor toolbar; ComboboxInput has no flat trigger variant
74
- className={cn(
75
- !canvas && (compact ? "w-24" : "w-40"),
76
- canvas &&
77
- "w-auto shrink-0 [&_button[aria-haspopup=listbox]]:border-transparent [&_button[aria-haspopup=listbox]]:bg-transparent [&_button[aria-haspopup=listbox]]:shadow-none",
78
- )}
79
- >
127
+ <FlatSelectBox flat={canvas} widthClass={compact ? "w-24" : "w-40"}>
80
128
  <Field id={`${id}-paragraph-style`} label={paragraphStyleLabel} hideLabel>
81
129
  <Input
82
130
  kind="select"
@@ -89,7 +137,7 @@ export function renderParagraphStyleSelect(c: TiptapContext): ReactNode {
89
137
  disabled={readOnly}
90
138
  />
91
139
  </Field>
92
- </div>
140
+ </FlatSelectBox>
93
141
  );
94
142
  }
95
143
 
@@ -150,3 +198,394 @@ export function renderListButtons(c: TiptapContext): ReactNode {
150
198
  </>
151
199
  );
152
200
  }
201
+
202
+ const DEFAULT_OPTION_VALUE = "";
203
+ const FALLBACK_COLOR = "#000000";
204
+
205
+ function numberOptions(
206
+ values: readonly number[],
207
+ current: number | null,
208
+ defaultLabel: string,
209
+ format: (value: number) => string,
210
+ ) {
211
+ const all =
212
+ current === null || values.includes(current)
213
+ ? values
214
+ : [...values, current].sort((a, b) => a - b);
215
+ return [
216
+ { value: DEFAULT_OPTION_VALUE, label: defaultLabel },
217
+ ...all.map((value) => ({ value: String(value), label: format(value) })),
218
+ ];
219
+ }
220
+
221
+ function parseOptionNumber(value: string): number | null {
222
+ return value === DEFAULT_OPTION_VALUE ? null : Number(value);
223
+ }
224
+
225
+ type PrintSelectSpec = {
226
+ readonly key: string;
227
+ readonly leading?: ReactNode;
228
+ readonly label: string;
229
+ readonly value: string;
230
+ readonly options: readonly { readonly value: string; readonly label: string }[];
231
+ readonly onChange: (value: string) => void;
232
+ };
233
+
234
+ function printSelect(c: TiptapContext, spec: PrintSelectSpec): ReactNode {
235
+ const { Field, Input, id, readOnly } = c;
236
+ const fieldId = `${id}-${spec.key}`;
237
+ return (
238
+ <EditorToolbarPill key={spec.key}>
239
+ {spec.leading}
240
+ <FlatSelectBox flat widthClass="" testId={`document-toolbar-${spec.key}`}>
241
+ <Field id={fieldId} label={spec.label} hideLabel>
242
+ <Input
243
+ kind="select"
244
+ id={fieldId}
245
+ name={spec.key}
246
+ value={spec.value}
247
+ onChange={spec.onChange}
248
+ options={spec.options}
249
+ display="dropdown"
250
+ disabled={readOnly}
251
+ />
252
+ </Field>
253
+ </FlatSelectBox>
254
+ </EditorToolbarPill>
255
+ );
256
+ }
257
+
258
+ export function colorPicker(
259
+ c: TiptapContext,
260
+ testId: string,
261
+ label: string,
262
+ value: string | null,
263
+ onPick: (color: string | null) => void,
264
+ ): ReactNode {
265
+ return (
266
+ <EditorToolbarPill>
267
+ {/* biome-ignore lint/plugin: no color primitive exists and this toolbar is web-only; the native picker needs no extra widget */}
268
+ <input
269
+ type="color"
270
+ data-testid={testId}
271
+ aria-label={label}
272
+ title={label}
273
+ disabled={c.readOnly}
274
+ value={value ?? FALLBACK_COLOR}
275
+ onChange={(event) => onPick(event.target.value)}
276
+ className="ml-1.5 h-5 w-5 cursor-pointer rounded border border-input bg-transparent p-0"
277
+ />
278
+ <span className="pr-2 pl-1.5 text-xs text-muted-foreground">{label}</span>
279
+ {value !== null && (
280
+ <c.Button
281
+ type="button"
282
+ variant="ghost"
283
+ size="sm"
284
+ ariaLabel={c.t("documentDesigner.editor.colorReset")}
285
+ title={c.t("documentDesigner.editor.colorReset")}
286
+ testId={`${testId}-reset`}
287
+ onClick={() => onPick(null)}
288
+ >
289
+ ×
290
+ </c.Button>
291
+ )}
292
+ </EditorToolbarPill>
293
+ );
294
+ }
295
+
296
+ export function renderPrintTextStyleGroup(c: TiptapContext): ReactNode {
297
+ const { t, editor } = c;
298
+ const text = c.activeState?.textStyle ?? { font: null, sizePt: null, color: null };
299
+ const block = c.activeState?.paragraphStyle ?? {
300
+ lineHeight: null,
301
+ spaceBeforePt: null,
302
+ spaceAfterPt: null,
303
+ };
304
+ const defaults = c.printDefaults;
305
+ const space = (
306
+ key: string,
307
+ label: string,
308
+ defaultLabel: string,
309
+ current: number | null,
310
+ field: "spaceBeforePt" | "spaceAfterPt",
311
+ format: (value: number) => string,
312
+ ) =>
313
+ printSelect(c, {
314
+ key,
315
+ label,
316
+ value: current === null ? DEFAULT_OPTION_VALUE : String(current),
317
+ options: numberOptions(PARAGRAPH_SPACES_PT, current, defaultLabel, format),
318
+ onChange: (value) => setPrintBlockStyle(editor, { [field]: parseOptionNumber(value) }),
319
+ });
320
+ return (
321
+ <>
322
+ {printSelect(c, {
323
+ key: "font",
324
+ label: t("documentDesigner.editor.font"),
325
+ value: text.font ?? DEFAULT_OPTION_VALUE,
326
+ options: [
327
+ { value: DEFAULT_OPTION_VALUE, label: defaults.font },
328
+ ...DOCUMENT_FONTS.map((font) => ({ value: font, label: DOCUMENT_FONT_LABELS[font] })),
329
+ ],
330
+ onChange: (value) =>
331
+ setPrintTextStyle(editor, { font: isOneOf(DOCUMENT_FONTS, value) ? value : null }),
332
+ })}
333
+ {printSelect(c, {
334
+ key: "size",
335
+ label: t("documentDesigner.editor.fontSize"),
336
+ value: text.sizePt === null ? DEFAULT_OPTION_VALUE : String(text.sizePt),
337
+ options: numberOptions(FONT_SIZES_PT, text.sizePt, defaults.size, defaults.formatSize),
338
+ onChange: (value) => setPrintTextStyle(editor, { sizePt: parseOptionNumber(value) }),
339
+ })}
340
+ {colorPicker(
341
+ c,
342
+ "document-toolbar-color",
343
+ t("documentDesigner.editor.textColor"),
344
+ text.color,
345
+ (color) => setPrintTextStyle(editor, { color }),
346
+ )}
347
+ <Separator compact={c.canvas} />
348
+ {printSelect(c, {
349
+ key: "line-height",
350
+ leading: (
351
+ <MoveVertical
352
+ size={14}
353
+ aria-hidden="true"
354
+ className="ml-2 shrink-0 text-muted-foreground"
355
+ />
356
+ ),
357
+ label: t("documentDesigner.editor.lineHeight"),
358
+ value: block.lineHeight === null ? DEFAULT_OPTION_VALUE : String(block.lineHeight),
359
+ options: numberOptions(
360
+ LINE_HEIGHTS,
361
+ block.lineHeight,
362
+ defaults.lineHeight,
363
+ defaults.formatLineHeight,
364
+ ),
365
+ onChange: (value) => setPrintBlockStyle(editor, { lineHeight: parseOptionNumber(value) }),
366
+ })}
367
+ {block.spaceBeforePt !== null &&
368
+ space(
369
+ "space-before",
370
+ t("documentDesigner.editor.spaceBefore"),
371
+ defaults.spaceBefore,
372
+ block.spaceBeforePt,
373
+ "spaceBeforePt",
374
+ defaults.formatSpaceBefore,
375
+ )}
376
+ {space(
377
+ "space-after",
378
+ t("documentDesigner.editor.spaceAfter"),
379
+ defaults.spaceAfter,
380
+ block.spaceAfterPt,
381
+ "spaceAfterPt",
382
+ defaults.formatSpaceAfter,
383
+ )}
384
+ </>
385
+ );
386
+ }
387
+
388
+ const NUMBER_FIELD_CLASS = "w-16 [&_input]:h-5 [&_input]:px-1 [&_input]:text-[10px]";
389
+
390
+ export function renderNumberField(
391
+ c: TiptapContext,
392
+ spec: {
393
+ readonly id: string;
394
+ readonly label: string;
395
+ readonly value: number | null;
396
+ readonly range: { readonly min: number; readonly max: number };
397
+ readonly onChange: (value: number | null) => void;
398
+ },
399
+ ): ReactNode {
400
+ const { Field, Input } = c;
401
+ return (
402
+ <span className="inline-flex items-center gap-1" data-testid={`${spec.id}-field`}>
403
+ <span className="whitespace-nowrap text-xs text-muted-foreground">{spec.label}</span>
404
+ <span className={NUMBER_FIELD_CLASS}>
405
+ <Field id={`${c.id}-${spec.id}`} label={spec.label} hideLabel>
406
+ <Input
407
+ kind="number"
408
+ id={`${c.id}-${spec.id}`}
409
+ name={spec.id}
410
+ value={spec.value ?? ""}
411
+ onChange={(value) =>
412
+ spec.onChange(
413
+ value === null || value === undefined
414
+ ? null
415
+ : Math.min(spec.range.max, Math.max(spec.range.min, value)),
416
+ )
417
+ }
418
+ testId={spec.id}
419
+ />
420
+ </Field>
421
+ </span>
422
+ </span>
423
+ );
424
+ }
425
+
426
+ function renderRowLineControls(
427
+ c: TiptapContext,
428
+ edge: "lineAbove" | "lineBelow",
429
+ line: DocumentRowLine | null,
430
+ ): ReactNode {
431
+ const { t, editor, Button } = c;
432
+ const id = edge === "lineAbove" ? "document-row-line-above" : "document-row-line-below";
433
+ const label = t(`documentDesigner.editor.table.${edge}`);
434
+ return (
435
+ <>
436
+ <EditorToolbarPill>
437
+ <Button
438
+ type="button"
439
+ variant="ghost"
440
+ size="sm"
441
+ pressed={line !== null}
442
+ disabled={c.readOnly}
443
+ testId={id}
444
+ onClick={() => setRowLine(editor, edge, line === null ? DEFAULT_ROW_LINE : null)}
445
+ >
446
+ {label}
447
+ </Button>
448
+ </EditorToolbarPill>
449
+ {line !== null && (
450
+ <>
451
+ {colorPicker(c, `${id}-color`, label, line.color, (color) =>
452
+ setRowLine(editor, edge, { ...line, color: color ?? line.color }),
453
+ )}
454
+ {renderNumberField(c, {
455
+ id: `${id}-weight`,
456
+ label: t("documentDesigner.editor.table.lineWeight"),
457
+ value: line.weightPt,
458
+ range: DIVIDER_WEIGHT_PT_RANGE,
459
+ onChange: (weightPt) =>
460
+ setRowLine(editor, edge, { ...line, weightPt: weightPt ?? line.weightPt }),
461
+ })}
462
+ </>
463
+ )}
464
+ </>
465
+ );
466
+ }
467
+
468
+ function renderTableLayoutControls(c: TiptapContext, table: PrintTableState): ReactNode {
469
+ const { t, editor, Button } = c;
470
+ return (
471
+ <EditorToolbarPill>
472
+ {renderNumberField(c, {
473
+ id: "document-table-padding",
474
+ label: t("documentDesigner.editor.table.cellPadding"),
475
+ value: table.cellPaddingMm,
476
+ range: CELL_PADDING_MM_RANGE,
477
+ onChange: (cellPaddingMm) => setTableAttributes(editor, { cellPaddingMm }),
478
+ })}
479
+ {renderNumberField(c, {
480
+ id: "document-table-width",
481
+ label: t("documentDesigner.editor.table.width"),
482
+ value: table.widthMm,
483
+ range: TABLE_WIDTH_MM_RANGE,
484
+ onChange: (widthMm) => setTableAttributes(editor, { widthMm }),
485
+ })}
486
+ {DOCUMENT_TABLE_ALIGNMENTS.map((align) => (
487
+ <Button
488
+ key={align}
489
+ type="button"
490
+ variant="ghost"
491
+ size="sm"
492
+ pressed={table.align === align}
493
+ disabled={c.readOnly}
494
+ testId={`document-table-align-${align}`}
495
+ onClick={() =>
496
+ setTableAttributes(editor, { align: table.align === align ? null : align })
497
+ }
498
+ >
499
+ {t(`documentDesigner.editor.imageAlign.${align}`)}
500
+ </Button>
501
+ ))}
502
+ </EditorToolbarPill>
503
+ );
504
+ }
505
+
506
+ export function renderPrintTableGroup(c: TiptapContext): ReactNode {
507
+ const { t, editor, Button } = c;
508
+ const table = c.activeState?.printTable ?? null;
509
+ if (table === null) return null;
510
+ return (
511
+ <>
512
+ <EditorToolbarPill>
513
+ <Button
514
+ type="button"
515
+ variant="ghost"
516
+ size="sm"
517
+ pressed={!table.bordersOff}
518
+ disabled={c.readOnly}
519
+ testId="document-table-borders"
520
+ onClick={() => toggleTableBorders(editor)}
521
+ >
522
+ {t("documentDesigner.editor.tableBorders")}
523
+ </Button>
524
+ </EditorToolbarPill>
525
+ {renderTableLayoutControls(c, table)}
526
+ {renderRowLineControls(c, "lineAbove", table.lineAbove)}
527
+ {renderRowLineControls(c, "lineBelow", table.lineBelow)}
528
+ {colorPicker(
529
+ c,
530
+ "document-cell-color",
531
+ t("documentDesigner.editor.cellColor"),
532
+ table.cellBackground,
533
+ (color) => editor.chain().focus().setCellAttribute("background", color).run(),
534
+ )}
535
+ <EditorToolbarPill>
536
+ <Button
537
+ type="button"
538
+ variant="ghost"
539
+ size="sm"
540
+ disabled={c.readOnly}
541
+ testId="document-table-add-row"
542
+ onClick={() => addPlainRowBelow(editor)}
543
+ >
544
+ {t("documentDesigner.editor.table.addRow")}
545
+ </Button>
546
+ </EditorToolbarPill>
547
+ <EditorToolbarPill>
548
+ <Button
549
+ type="button"
550
+ variant="ghost"
551
+ size="sm"
552
+ disabled={c.readOnly}
553
+ testId="document-table-remove-row"
554
+ onClick={() => {
555
+ editor.chain().focus().deleteRow().run();
556
+ }}
557
+ >
558
+ {t("documentDesigner.editor.table.removeRow")}
559
+ </Button>
560
+ </EditorToolbarPill>
561
+ <EditorToolbarPill>
562
+ <Button
563
+ type="button"
564
+ variant="ghost"
565
+ size="sm"
566
+ disabled={c.readOnly}
567
+ testId="document-table-add-column"
568
+ onClick={() => {
569
+ editor.chain().focus().addColumnAfter().run();
570
+ }}
571
+ >
572
+ {t("documentDesigner.editor.table.addColumn")}
573
+ </Button>
574
+ </EditorToolbarPill>
575
+ <EditorToolbarPill>
576
+ <Button
577
+ type="button"
578
+ variant="ghost"
579
+ size="sm"
580
+ disabled={c.readOnly}
581
+ testId="document-table-remove-column"
582
+ onClick={() => {
583
+ editor.chain().focus().deleteColumn().run();
584
+ }}
585
+ >
586
+ {t("documentDesigner.editor.table.removeColumn")}
587
+ </Button>
588
+ </EditorToolbarPill>
589
+ </>
590
+ );
591
+ }
@@ -1,16 +1,20 @@
1
1
  import type { ActionMenuItemSpec } from "@cosmicdrift/kumiko-renderer";
2
- import { cn } from "@cosmicdrift/kumiko-renderer/web";
2
+ import { ActionMenu, cn } from "@cosmicdrift/kumiko-renderer/web";
3
3
  import {
4
4
  AlignLeft,
5
5
  Braces,
6
6
  ChevronDown,
7
+ Columns3,
7
8
  GalleryThumbnails,
8
9
  Image as ImageIcon,
9
10
  ListChecks,
11
+ Mail,
10
12
  Minus,
11
13
  MousePointerClick,
14
+ Plus,
12
15
  Repeat,
13
16
  Scissors,
17
+ SquareDashed,
14
18
  Table as TableIcon,
15
19
  } from "lucide-react";
16
20
  import { Fragment, type ReactNode } from "react";
@@ -21,17 +25,18 @@ import {
21
25
  renderListButtons,
22
26
  renderMarkButtons,
23
27
  renderParagraphStyleSelect,
28
+ renderPrintTableGroup,
29
+ renderPrintTextStyleGroup,
30
+ Separator,
24
31
  } from "./document-tiptap-toolbar-groups.tsx";
25
- import type { DocumentToolbarBlock } from "./document-toolbar-blocks.ts";
32
+ import type {
33
+ DocumentPrintBlock,
34
+ DocumentPrintMode,
35
+ DocumentToolbarBlock,
36
+ } from "./document-toolbar-blocks.ts";
26
37
 
27
38
  type BlockButtons = Record<DocumentToolbarBlock, { label: string; icon: ReactNode }>;
28
39
 
29
- function Separator({ compact = false }: { readonly compact?: boolean }): ReactNode {
30
- return (
31
- <span aria-hidden="true" className={cn("h-5 w-px bg-border", compact ? "mx-0.5" : "mx-2")} />
32
- );
33
- }
34
-
35
40
  function blockButtonsOf(c: TiptapContext): BlockButtons {
36
41
  const { t } = c;
37
42
  const { imageLabel, pageBreakLabel, stepsLabel, imagesLabel } = c.labels;
@@ -132,7 +137,99 @@ function overflowItemsOf(
132
137
  ];
133
138
  }
134
139
 
140
+ const PRINT_BLOCKS_BY_MODE: Readonly<Record<DocumentPrintMode, readonly DocumentPrintBlock[]>> = {
141
+ none: [],
142
+ flow: ["columns"],
143
+ page: ["address", "textFrame", "columns"],
144
+ };
145
+
146
+ const PRINT_BLOCK_TEST_IDS: Readonly<Record<DocumentPrintBlock, string>> = {
147
+ address: "document-block-address",
148
+ textFrame: "document-block-textframe",
149
+ columns: "document-block-columns",
150
+ };
151
+
152
+ const PRINT_BLOCK_ICONS: Readonly<Record<DocumentPrintBlock, ReactNode>> = {
153
+ address: <Mail size={16} />,
154
+ textFrame: <SquareDashed size={16} />,
155
+ columns: <Columns3 size={16} />,
156
+ };
157
+
158
+ function renderPrintBlockMenu(c: TiptapContext): ReactNode {
159
+ const { t } = c;
160
+ const blocks = PRINT_BLOCKS_BY_MODE[c.print];
161
+ if (blocks.length === 0) return null;
162
+ return (
163
+ <ActionMenu
164
+ testId="document-block-menu"
165
+ triggerLabel={t("documentDesigner.editor.blockMenu")}
166
+ align="start"
167
+ minWidth="18rem"
168
+ trigger={
169
+ <span className="inline-flex h-7 shrink-0 items-center gap-1.5 rounded-full border border-primary/40 bg-primary/10 px-3 text-xs font-medium text-primary">
170
+ <Plus size={14} />
171
+ {t("documentDesigner.editor.blockMenu")}
172
+ <ChevronDown size={12} />
173
+ </span>
174
+ }
175
+ items={blocks.map((block) => ({
176
+ kind: "item",
177
+ id: block,
178
+ label: t(`documentDesigner.editor.block.${block}`),
179
+ description: t(`documentDesigner.editor.block.${block}.hint`),
180
+ icon: PRINT_BLOCK_ICONS[block],
181
+ testId: PRINT_BLOCK_TEST_IDS[block],
182
+ disabled: c.readOnly,
183
+ onSelect: () => c.runPrintBlock(block),
184
+ }))}
185
+ />
186
+ );
187
+ }
188
+
189
+ function renderPrintStyleRow(c: TiptapContext): ReactNode {
190
+ const { canvas } = c;
191
+ return (
192
+ <div
193
+ className={cn(
194
+ "flex items-center border-b border-input",
195
+ canvas
196
+ ? "min-h-9 flex-wrap gap-1.5 bg-background px-1.5 py-1 [&>*]:shrink-0"
197
+ : "flex-wrap gap-1 p-1",
198
+ )}
199
+ >
200
+ {renderPrintTextStyleGroup(c)}
201
+ {renderPrintTableGroup(c)}
202
+ </div>
203
+ );
204
+ }
205
+
135
206
  export function renderToolbarBar(c: TiptapContext): ReactNode {
207
+ return (
208
+ <>
209
+ {renderMainToolbarRow(c)}
210
+ {c.print !== "none" && renderPrintStyleRow(c)}
211
+ </>
212
+ );
213
+ }
214
+
215
+ function renderPlaceholderButton(c: TiptapContext): ReactNode {
216
+ if (c.variables.length === 0) return null;
217
+ return (
218
+ <>
219
+ <Separator compact={c.compact || c.canvas} />
220
+ {labelledButton(c, {
221
+ label: c.t("template-resolver.documentEditor.insertPlaceholder"),
222
+ icon: <Braces size={16} />,
223
+ showIcon: true,
224
+ trailingIcon: c.canvas ? <ChevronDown size={12} /> : undefined,
225
+ expanded: c.openPanel === "placeholder",
226
+ onClick: () => c.togglePanel("placeholder"),
227
+ })}
228
+ </>
229
+ );
230
+ }
231
+
232
+ function renderMainToolbarRow(c: TiptapContext): ReactNode {
136
233
  const { t, id, canvas, compact, ActionOverflowMenu } = c;
137
234
  const blockButtons = blockButtonsOf(c);
138
235
  // The canvas toolbar never scrolls sideways: the rarer blocks and the HTML view sit in the menu.
@@ -157,17 +254,11 @@ export function renderToolbarBar(c: TiptapContext): ReactNode {
157
254
  {renderMarkButtons(c)}
158
255
  <Separator compact={compact || canvas} />
159
256
  {renderListButtons(c)}
160
- <Separator compact={compact || canvas} />
161
- {labelledButton(c, {
162
- label: t("template-resolver.documentEditor.insertPlaceholder"),
163
- icon: <Braces size={16} />,
164
- showIcon: true,
165
- trailingIcon: canvas ? <ChevronDown size={12} /> : undefined,
166
- expanded: c.openPanel === "placeholder",
167
- onClick: () => c.togglePanel("placeholder"),
168
- })}
257
+ {renderPlaceholderButton(c)}
169
258
  {inlineBlocks.length > 0 && <Separator compact={compact || canvas} />}
170
259
  {inlineBlocks.map((block) => renderInlineBlock(c, block, blockButtons))}
260
+ {c.print !== "none" && <Separator compact={compact || canvas} />}
261
+ {renderPrintBlockMenu(c)}
171
262
  {overflowItems.length > 0 && ActionOverflowMenu !== undefined && (
172
263
  <span className="ml-auto shrink-0">
173
264
  <ActionOverflowMenu
@@ -1,6 +1,22 @@
1
1
  import type { ContentEditorProps } from "@cosmicdrift/kumiko-renderer";
2
2
  import type { ReactNode } from "react";
3
3
  import type { DocumentToolbarBlock } from "./document-blocks.ts";
4
+ import type { DocumentFont } from "./document-fonts.ts";
5
+ import type { DocumentFrameControl } from "./document-frame-control.ts";
6
+
7
+ /** The text values the layout gives; a missing one makes the matching toolbar default show the control's name. */
8
+ export type DocumentLayoutValues = {
9
+ readonly fontFamily?: DocumentFont;
10
+ readonly fontSizePt?: number;
11
+ readonly lineHeight?: number;
12
+ readonly spaceBeforePt?: number;
13
+ readonly spaceAfterPt?: number;
14
+ };
15
+
16
+ /** "none" = mail; "flow" = PDF text flow (styling, columns); "page" = PDF body on a canvas paper, which also places frames. */
17
+ export type DocumentPrintMode = "none" | "flow" | "page";
18
+
19
+ export type DocumentPrintBlock = "address" | "textFrame" | "columns";
4
20
 
5
21
  /** Imperative access for an outside panel (placeholder list, resource list). */
6
22
  export type DocumentEditorHandle = {
@@ -31,6 +47,8 @@ export type DocumentEditorProps = ContentEditorProps & {
31
47
  /** Image previews by resource key; resources without one show a key placeholder. */
32
48
  readonly resourcePreviews?: Readonly<Record<string, DocumentResourcePreview>>;
33
49
  readonly chrome?: DocumentEditorChrome;
50
+ /** Print toolbar only: what the "inherit" option of each text select resolves to. */
51
+ readonly layoutValues?: DocumentLayoutValues;
34
52
  /** "compact" renders the placeholder and block buttons icon-only with a tooltip, for narrow columns. Default "full". */
35
53
  readonly toolbar?: "full" | "compact";
36
54
  /** Canvas only: wraps the editable area in a caller-owned page (letterhead, margins) instead of the default mail paper. */
@@ -40,6 +58,8 @@ export type DocumentEditorProps = ContentEditorProps & {
40
58
  readonly toolbarHost?: HTMLElement | null;
41
59
  /** Called with the handle once the editor exists and with null when it is destroyed (unmount or rebuild), so a held handle never outlives its editor. */
42
60
  readonly onEditorReady?: (handle: DocumentEditorHandle | null) => void;
61
+ /** PDF body on a canvas paper only: reports the frame the selection is in or on (null otherwise), with controls for a side panel. */
62
+ readonly onFrameControlChange?: (control: DocumentFrameControl | null) => void;
43
63
  };
44
64
 
45
65
  export {