@cosmicdrift/kumiko-samples 0.418.0 → 0.419.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 (79) hide show
  1. package/package.json +1 -1
  2. package/packages/bundled-features/package.json +6 -1
  3. package/packages/bundled-features/src/template-resolver/changes.json +38 -0
  4. package/packages/bundled-features/src/template-resolver/compile-document-body.ts +3 -8
  5. package/packages/bundled-features/src/template-resolver/compile-document-styles.ts +102 -0
  6. package/packages/bundled-features/src/template-resolver/document-frames.ts +25 -0
  7. package/packages/bundled-features/src/template-resolver/document-op-blocks.ts +568 -0
  8. package/packages/bundled-features/src/template-resolver/document-ops.ts +136 -126
  9. package/packages/bundled-features/src/template-resolver/document-print-only.ts +41 -0
  10. package/packages/bundled-features/src/template-resolver/document-sanitizer.ts +41 -19
  11. package/packages/bundled-features/src/template-resolver/feature.ts +15 -0
  12. package/packages/bundled-features/src/template-resolver/handlers/apply-layout.write.ts +137 -0
  13. package/packages/bundled-features/src/template-resolver/handlers/create-layout.write.ts +87 -0
  14. package/packages/bundled-features/src/template-resolver/handlers/document-base.ts +2 -2
  15. package/packages/bundled-features/src/template-resolver/handlers/document-blocks.query.ts +13 -8
  16. package/packages/bundled-features/src/template-resolver/handlers/document-region.ts +47 -0
  17. package/packages/bundled-features/src/template-resolver/handlers/failure-reason.ts +13 -0
  18. package/packages/bundled-features/src/template-resolver/handlers/import-bundle-system.write.ts +3 -0
  19. package/packages/bundled-features/src/template-resolver/handlers/layout-source.query.ts +17 -5
  20. package/packages/bundled-features/src/template-resolver/handlers/overview.query.ts +16 -4
  21. package/packages/bundled-features/src/template-resolver/handlers/patch-draft.write.ts +19 -6
  22. package/packages/bundled-features/src/template-resolver/handlers/publish-templates.write.ts +69 -0
  23. package/packages/bundled-features/src/template-resolver/handlers/set.write.ts +7 -0
  24. package/packages/bundled-features/src/template-resolver/handlers/template-write.ts +15 -3
  25. package/packages/bundled-features/src/template-resolver/handlers/tenant-settings.ts +122 -0
  26. package/packages/bundled-features/src/template-resolver/handlers/toggle-status.write.ts +25 -10
  27. package/packages/bundled-features/src/template-resolver/handlers/upsert-system.write.ts +7 -3
  28. package/packages/bundled-features/src/template-resolver/handlers/usage.query.ts +131 -18
  29. package/packages/bundled-features/src/template-resolver/handlers/validate.query.ts +10 -0
  30. package/packages/bundled-features/src/template-resolver/i18n.ts +3 -0
  31. package/packages/bundled-features/src/template-resolver/index.ts +29 -0
  32. package/packages/bundled-features/src/template-resolver/layout-regions.ts +54 -16
  33. package/packages/bundled-features/src/template-resolver/print-document.ts +3 -1
  34. package/packages/bundled-features/src/template-resolver/seeding.ts +4 -0
  35. package/packages/bundled-features/src/template-resolver/template-delivery-policy.ts +11 -1
  36. package/packages/bundled-features/src/template-resolver/template-edit-policy.ts +37 -1
  37. package/packages/bundled-features/src/template-resolver/template-meta.ts +25 -6
  38. package/packages/bundled-features/src/template-resolver/template-preview.ts +6 -7
  39. package/packages/bundled-features/src/template-resolver/template-validation.ts +10 -3
  40. package/packages/bundled-features/src/template-resolver/web/constants.ts +29 -0
  41. package/packages/bundled-features/src/template-resolver/web/document-blocks.ts +5 -0
  42. package/packages/bundled-features/src/template-resolver/web/document-editor-extensions.ts +34 -2
  43. package/packages/bundled-features/src/template-resolver/web/document-editor-fonts.ts +13 -0
  44. package/packages/bundled-features/src/template-resolver/web/document-fonts.ts +21 -0
  45. package/packages/bundled-features/src/template-resolver/web/document-frame-control.ts +428 -0
  46. package/packages/bundled-features/src/template-resolver/web/document-frame-node-view.tsx +207 -0
  47. package/packages/bundled-features/src/template-resolver/web/document-print-decorations.ts +196 -0
  48. package/packages/bundled-features/src/template-resolver/web/document-print-defaults.ts +59 -0
  49. package/packages/bundled-features/src/template-resolver/web/document-print-style.ts +246 -0
  50. package/packages/bundled-features/src/template-resolver/web/document-repeat-strip.ts +104 -0
  51. package/packages/bundled-features/src/template-resolver/web/document-schema.ts +29 -9
  52. package/packages/bundled-features/src/template-resolver/web/document-style-css.ts +107 -0
  53. package/packages/bundled-features/src/template-resolver/web/document-tiptap-bubble.tsx +24 -2
  54. package/packages/bundled-features/src/template-resolver/web/document-tiptap-content.tsx +66 -7
  55. package/packages/bundled-features/src/template-resolver/web/document-tiptap-context.ts +13 -1
  56. package/packages/bundled-features/src/template-resolver/web/document-tiptap-editor.tsx +24 -4
  57. package/packages/bundled-features/src/template-resolver/web/document-tiptap-helpers.ts +149 -4
  58. package/packages/bundled-features/src/template-resolver/web/document-tiptap-toolbar-groups.tsx +290 -10
  59. package/packages/bundled-features/src/template-resolver/web/document-tiptap-toolbar.tsx +90 -8
  60. package/packages/bundled-features/src/template-resolver/web/document-toolbar-blocks.ts +20 -0
  61. package/packages/bundled-features/src/template-resolver/web/fontsource-css.d.ts +2 -0
  62. package/packages/bundled-features/src/template-resolver/web/i18n.ts +28 -0
  63. package/packages/bundled-features/src/template-resolver/web/index.ts +34 -0
  64. package/packages/bundled-features/src/template-resolver/web/pdf-constants.ts +6 -0
  65. package/packages/bundled-features/src/template-resolver/web/qualified-names.ts +7 -0
  66. package/packages/bundled-features/src/template-resolver/web/use-document-tiptap-model.ts +74 -5
  67. package/packages/bundled-features/src/tenant/company-config.ts +48 -0
  68. package/packages/bundled-features/src/tenant/feature.ts +11 -0
  69. package/packages/bundled-features/src/tenant/i18n.ts +14 -0
  70. package/samples/apps/ui-walkthrough/src/app/auth-constants.ts +51 -0
  71. package/samples/apps/ui-walkthrough/src/app/seed-print-editor-tenants.ts +118 -0
  72. package/samples/apps/ui-walkthrough/src/app/seed-templates.ts +2 -0
  73. package/samples/apps/ui-walkthrough/src/app/server.ts +9 -1
  74. package/samples/apps/ui-walkthrough/src/app/template-seed-data.ts +27 -1
  75. package/samples/apps/ui-walkthrough/src/run-config.ts +1 -0
  76. package/samples/apps/use-all-bundled/feature-manifest.json +236 -0
  77. package/samples/recipes/pdf-letterhead/README.md +23 -0
  78. package/samples/recipes/pdf-letterhead/package.json +12 -0
  79. package/samples/recipes/pdf-letterhead/src/letterhead.ts +92 -0
@@ -1,14 +1,31 @@
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";
11
14
  import type { TiptapContext } from "./document-tiptap-context.ts";
15
+ import {
16
+ FONT_SIZES_PT,
17
+ LINE_HEIGHTS,
18
+ PARAGRAPH_SPACES_PT,
19
+ setPrintBlockStyle,
20
+ setPrintTextStyle,
21
+ toggleTableBorders,
22
+ } from "./document-tiptap-helpers.ts";
23
+
24
+ export function Separator({ compact = false }: { readonly compact?: boolean }): ReactNode {
25
+ return (
26
+ <span aria-hidden="true" className={cn("h-5 w-px bg-border", compact ? "mx-0.5" : "mx-2")} />
27
+ );
28
+ }
12
29
 
13
30
  // Canvas chrome is one flat row: unframed ghost buttons, glyph plus text for the longer names.
14
31
  export function iconButton(
@@ -59,6 +76,32 @@ function markContent(
59
76
  return canvas ? <span className={className}>{letter}</span> : icon;
60
77
  }
61
78
 
79
+ function FlatSelectBox({
80
+ flat,
81
+ widthClass,
82
+ testId,
83
+ children,
84
+ }: {
85
+ readonly flat: boolean;
86
+ readonly widthClass: string;
87
+ readonly testId?: string;
88
+ readonly children: ReactNode;
89
+ }): ReactNode {
90
+ return (
91
+ <div
92
+ data-testid={testId}
93
+ // biome-ignore lint/plugin: the toolbar selects sit flush in the editor toolbar; ComboboxInput has no flat trigger variant
94
+ className={cn(
95
+ !flat && widthClass,
96
+ flat &&
97
+ "w-auto shrink-0 [&_button[aria-haspopup=listbox]]:border-transparent [&_button[aria-haspopup=listbox]]:bg-transparent [&_button[aria-haspopup=listbox]]:shadow-none",
98
+ )}
99
+ >
100
+ {children}
101
+ </div>
102
+ );
103
+ }
104
+
62
105
  export function renderParagraphStyleSelect(c: TiptapContext): ReactNode {
63
106
  const { t, Field, Input, id, canvas, compact, readOnly, activeState } = c;
64
107
  const paragraphStyleLabel = t("template-resolver.documentEditor.paragraphStyle");
@@ -69,14 +112,7 @@ export function renderParagraphStyleSelect(c: TiptapContext): ReactNode {
69
112
  { value: "3", label: t("template-resolver.documentEditor.heading3") },
70
113
  ];
71
114
  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
- >
115
+ <FlatSelectBox flat={canvas} widthClass={compact ? "w-24" : "w-40"}>
80
116
  <Field id={`${id}-paragraph-style`} label={paragraphStyleLabel} hideLabel>
81
117
  <Input
82
118
  kind="select"
@@ -89,7 +125,7 @@ export function renderParagraphStyleSelect(c: TiptapContext): ReactNode {
89
125
  disabled={readOnly}
90
126
  />
91
127
  </Field>
92
- </div>
128
+ </FlatSelectBox>
93
129
  );
94
130
  }
95
131
 
@@ -150,3 +186,247 @@ export function renderListButtons(c: TiptapContext): ReactNode {
150
186
  </>
151
187
  );
152
188
  }
189
+
190
+ const DEFAULT_OPTION_VALUE = "";
191
+ const FALLBACK_COLOR = "#000000";
192
+
193
+ function numberOptions(
194
+ values: readonly number[],
195
+ current: number | null,
196
+ defaultLabel: string,
197
+ format: (value: number) => string,
198
+ ) {
199
+ const all =
200
+ current === null || values.includes(current)
201
+ ? values
202
+ : [...values, current].sort((a, b) => a - b);
203
+ return [
204
+ { value: DEFAULT_OPTION_VALUE, label: defaultLabel },
205
+ ...all.map((value) => ({ value: String(value), label: format(value) })),
206
+ ];
207
+ }
208
+
209
+ function parseOptionNumber(value: string): number | null {
210
+ return value === DEFAULT_OPTION_VALUE ? null : Number(value);
211
+ }
212
+
213
+ type PrintSelectSpec = {
214
+ readonly key: string;
215
+ readonly leading?: ReactNode;
216
+ readonly label: string;
217
+ readonly value: string;
218
+ readonly options: readonly { readonly value: string; readonly label: string }[];
219
+ readonly onChange: (value: string) => void;
220
+ };
221
+
222
+ function printSelect(c: TiptapContext, spec: PrintSelectSpec): ReactNode {
223
+ const { Field, Input, id, readOnly } = c;
224
+ const fieldId = `${id}-${spec.key}`;
225
+ return (
226
+ <EditorToolbarPill key={spec.key}>
227
+ {spec.leading}
228
+ <FlatSelectBox flat widthClass="" testId={`document-toolbar-${spec.key}`}>
229
+ <Field id={fieldId} label={spec.label} hideLabel>
230
+ <Input
231
+ kind="select"
232
+ id={fieldId}
233
+ name={spec.key}
234
+ value={spec.value}
235
+ onChange={spec.onChange}
236
+ options={spec.options}
237
+ display="dropdown"
238
+ disabled={readOnly}
239
+ />
240
+ </Field>
241
+ </FlatSelectBox>
242
+ </EditorToolbarPill>
243
+ );
244
+ }
245
+
246
+ function colorPicker(
247
+ c: TiptapContext,
248
+ testId: string,
249
+ label: string,
250
+ value: string | null,
251
+ onPick: (color: string | null) => void,
252
+ ): ReactNode {
253
+ return (
254
+ <EditorToolbarPill>
255
+ {/* biome-ignore lint/plugin: no color primitive exists and this toolbar is web-only; the native picker needs no extra widget */}
256
+ <input
257
+ type="color"
258
+ data-testid={testId}
259
+ aria-label={label}
260
+ title={label}
261
+ disabled={c.readOnly}
262
+ value={value ?? FALLBACK_COLOR}
263
+ onChange={(event) => onPick(event.target.value)}
264
+ className="ml-1.5 h-5 w-5 cursor-pointer rounded border border-input bg-transparent p-0"
265
+ />
266
+ <span className="pr-2 pl-1.5 text-xs text-muted-foreground">{label}</span>
267
+ {value !== null && (
268
+ <c.Button
269
+ type="button"
270
+ variant="ghost"
271
+ size="sm"
272
+ ariaLabel={c.t("documentDesigner.editor.colorReset")}
273
+ title={c.t("documentDesigner.editor.colorReset")}
274
+ testId={`${testId}-reset`}
275
+ onClick={() => onPick(null)}
276
+ >
277
+ ×
278
+ </c.Button>
279
+ )}
280
+ </EditorToolbarPill>
281
+ );
282
+ }
283
+
284
+ export function renderPrintTextStyleGroup(c: TiptapContext): ReactNode {
285
+ const { t, editor } = c;
286
+ const text = c.activeState?.textStyle ?? { font: null, sizePt: null, color: null };
287
+ const block = c.activeState?.paragraphStyle ?? {
288
+ lineHeight: null,
289
+ spaceBeforePt: null,
290
+ spaceAfterPt: null,
291
+ };
292
+ const defaults = c.printDefaults;
293
+ const space = (
294
+ key: string,
295
+ label: string,
296
+ defaultLabel: string,
297
+ current: number | null,
298
+ field: "spaceBeforePt" | "spaceAfterPt",
299
+ format: (value: number) => string,
300
+ ) =>
301
+ printSelect(c, {
302
+ key,
303
+ label,
304
+ value: current === null ? DEFAULT_OPTION_VALUE : String(current),
305
+ options: numberOptions(PARAGRAPH_SPACES_PT, current, defaultLabel, format),
306
+ onChange: (value) => setPrintBlockStyle(editor, { [field]: parseOptionNumber(value) }),
307
+ });
308
+ return (
309
+ <>
310
+ {printSelect(c, {
311
+ key: "font",
312
+ label: t("documentDesigner.editor.font"),
313
+ value: text.font ?? DEFAULT_OPTION_VALUE,
314
+ options: [
315
+ { value: DEFAULT_OPTION_VALUE, label: defaults.font },
316
+ ...DOCUMENT_FONTS.map((font) => ({ value: font, label: DOCUMENT_FONT_LABELS[font] })),
317
+ ],
318
+ onChange: (value) =>
319
+ setPrintTextStyle(editor, { font: isOneOf(DOCUMENT_FONTS, value) ? value : null }),
320
+ })}
321
+ {printSelect(c, {
322
+ key: "size",
323
+ label: t("documentDesigner.editor.fontSize"),
324
+ value: text.sizePt === null ? DEFAULT_OPTION_VALUE : String(text.sizePt),
325
+ options: numberOptions(FONT_SIZES_PT, text.sizePt, defaults.size, defaults.formatSize),
326
+ onChange: (value) => setPrintTextStyle(editor, { sizePt: parseOptionNumber(value) }),
327
+ })}
328
+ {colorPicker(
329
+ c,
330
+ "document-toolbar-color",
331
+ t("documentDesigner.editor.textColor"),
332
+ text.color,
333
+ (color) => setPrintTextStyle(editor, { color }),
334
+ )}
335
+ <Separator compact={c.canvas} />
336
+ {printSelect(c, {
337
+ key: "line-height",
338
+ leading: (
339
+ <MoveVertical
340
+ size={14}
341
+ aria-hidden="true"
342
+ className="ml-2 shrink-0 text-muted-foreground"
343
+ />
344
+ ),
345
+ label: t("documentDesigner.editor.lineHeight"),
346
+ value: block.lineHeight === null ? DEFAULT_OPTION_VALUE : String(block.lineHeight),
347
+ options: numberOptions(
348
+ LINE_HEIGHTS,
349
+ block.lineHeight,
350
+ defaults.lineHeight,
351
+ defaults.formatLineHeight,
352
+ ),
353
+ onChange: (value) => setPrintBlockStyle(editor, { lineHeight: parseOptionNumber(value) }),
354
+ })}
355
+ {block.spaceBeforePt !== null &&
356
+ space(
357
+ "space-before",
358
+ t("documentDesigner.editor.spaceBefore"),
359
+ defaults.spaceBefore,
360
+ block.spaceBeforePt,
361
+ "spaceBeforePt",
362
+ defaults.formatSpaceBefore,
363
+ )}
364
+ {space(
365
+ "space-after",
366
+ t("documentDesigner.editor.spaceAfter"),
367
+ defaults.spaceAfter,
368
+ block.spaceAfterPt,
369
+ "spaceAfterPt",
370
+ defaults.formatSpaceAfter,
371
+ )}
372
+ </>
373
+ );
374
+ }
375
+
376
+ export function renderPrintTableGroup(c: TiptapContext): ReactNode {
377
+ const { t, editor, Button } = c;
378
+ const table = c.activeState?.printTable ?? null;
379
+ if (table === null) return null;
380
+ return (
381
+ <>
382
+ <EditorToolbarPill>
383
+ <Button
384
+ type="button"
385
+ variant="ghost"
386
+ size="sm"
387
+ pressed={!table.bordersOff}
388
+ disabled={c.readOnly}
389
+ testId="document-table-borders"
390
+ onClick={() => toggleTableBorders(editor)}
391
+ >
392
+ {t("documentDesigner.editor.tableBorders")}
393
+ </Button>
394
+ </EditorToolbarPill>
395
+ {colorPicker(
396
+ c,
397
+ "document-cell-color",
398
+ t("documentDesigner.editor.cellColor"),
399
+ table.cellBackground,
400
+ (color) => editor.chain().focus().setCellAttribute("background", color).run(),
401
+ )}
402
+ <EditorToolbarPill>
403
+ <Button
404
+ type="button"
405
+ variant="ghost"
406
+ size="sm"
407
+ disabled={c.readOnly}
408
+ testId="document-table-add-column"
409
+ onClick={() => {
410
+ editor.chain().focus().addColumnAfter().run();
411
+ }}
412
+ >
413
+ {t("documentDesigner.editor.table.addColumn")}
414
+ </Button>
415
+ </EditorToolbarPill>
416
+ <EditorToolbarPill>
417
+ <Button
418
+ type="button"
419
+ variant="ghost"
420
+ size="sm"
421
+ disabled={c.readOnly}
422
+ testId="document-table-remove-column"
423
+ onClick={() => {
424
+ editor.chain().focus().deleteColumn().run();
425
+ }}
426
+ >
427
+ {t("documentDesigner.editor.table.removeColumn")}
428
+ </Button>
429
+ </EditorToolbarPill>
430
+ </>
431
+ );
432
+ }
@@ -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,82 @@ 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 renderMainToolbarRow(c: TiptapContext): ReactNode {
136
216
  const { t, id, canvas, compact, ActionOverflowMenu } = c;
137
217
  const blockButtons = blockButtonsOf(c);
138
218
  // The canvas toolbar never scrolls sideways: the rarer blocks and the HTML view sit in the menu.
@@ -168,6 +248,8 @@ export function renderToolbarBar(c: TiptapContext): ReactNode {
168
248
  })}
169
249
  {inlineBlocks.length > 0 && <Separator compact={compact || canvas} />}
170
250
  {inlineBlocks.map((block) => renderInlineBlock(c, block, blockButtons))}
251
+ {c.print !== "none" && <Separator compact={compact || canvas} />}
252
+ {renderPrintBlockMenu(c)}
171
253
  {overflowItems.length > 0 && ActionOverflowMenu !== undefined && (
172
254
  <span className="ml-auto shrink-0">
173
255
  <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 {
@@ -0,0 +1,2 @@
1
+ // @fontsource packages ship plain CSS files; the dynamic font loader only imports them for their side effect.
2
+ declare module "@fontsource/*";
@@ -61,6 +61,17 @@ export const defaultTranslations: TranslationsByLocale = {
61
61
  "template-resolver.editor.saved": "Saved.",
62
62
  "templateResolver.errors.document.imagesBlockPdfOnly":
63
63
  "Photo blocks are only allowed in PDF documents.",
64
+ "templateResolver.errors.document.printStylePdfOnly":
65
+ "Print styling (fonts, colors, spacing, frames) is only allowed in PDF documents.",
66
+ "templateResolver.errors.template_not_tenant_editable": "You may not edit this template.",
67
+ "templateResolver.errors.template_already_active": "Nothing to publish, no open draft.",
68
+ "templateResolver.errors.layout_not_published": "Publish the layout first.",
69
+ "templateResolver.errors.template_resource_not_found": "Template not found.",
70
+ "templateResolver.errors.invalid_meta": "The template settings are invalid.",
71
+ "templateResolver.errors.unknown_placeholder": "The template uses an unknown placeholder.",
72
+ "templateResolver.errors.missing_required_placeholder": "A required placeholder is missing.",
73
+ "templateResolver.errors.document.frameNotTopLevel":
74
+ "A frame must sit directly in the document body, not inside another block or a layout region.",
64
75
  "templateResolver.errors.document.buttonHrefNotPlaceholder":
65
76
  "The button target “{detail}” must be a placeholder.",
66
77
  "templateResolver.errors.document.disallowedLinkHref":
@@ -85,6 +96,23 @@ export const defaultTranslations: TranslationsByLocale = {
85
96
  "templateResolver.checks.sizeUnderCap": "The mail is within the 10 MiB size limit",
86
97
  "templateResolver.checks.requiredPlaceholders": "All required placeholders are used",
87
98
  "templateResolver.errors.preview.renderFailed": "The preview could not be rendered.",
99
+ "templateResolver.errors.patch.printStyleNotAllowed":
100
+ "Fonts, sizes, colors, spacing, borders and backgrounds are only available in PDF templates, not in {kind}.",
101
+ "templateResolver.errors.patch.textOrRunsRequired":
102
+ "Give either text or runs, not both and not neither.",
103
+ "templateResolver.errors.patch.invalidTable": "The table is not valid: {problem}.",
104
+ "templateResolver.errors.patch.invalidRepeatVariable":
105
+ "The name {each} is not a valid list variable for a repeat row.",
106
+ "templateResolver.errors.patch.tooManyBlocks":
107
+ "The body may have at most {max} blocks, including the ones inside frames.",
108
+ "templateResolver.errors.patch.regionRequired":
109
+ "A PDF layout is edited one region at a time; set region to header, signature or footer.",
110
+ "templateResolver.errors.patch.regionNotAllowed":
111
+ "A region only applies to PDF layouts, not to {kind}.",
112
+ "templateResolver.errors.patch.layoutExists": "A layout with the slug {slug} already exists.",
113
+ "templateResolver.errors.template.reservedLayoutSlug":
114
+ "The prefix {prefix} is reserved for tenant layouts.",
115
+ "templateResolver.errors.patch.emptyFormat": "Give at least one of align, style or textStyle.",
88
116
  "templateResolver.errors.patch.unknownBlock":
89
117
  "The block {blockId} does not exist in the template.",
90
118
  "templateResolver.errors.patch.blockRemoved":
@@ -6,11 +6,42 @@
6
6
 
7
7
  export { textBlocksClient } from "./client-plugin.tsx";
8
8
  export type { EditableTemplateKind } from "./constants.ts";
9
+ export { COMPANY_PLACEHOLDERS, MAX_SELECTED_TEMPLATES } from "./constants.ts";
9
10
  export { DocumentContentEditor } from "./document-editor.tsx";
11
+ export {
12
+ DOCUMENT_FONT_LABELS,
13
+ DOCUMENT_FONT_PRINT_STACKS,
14
+ DOCUMENT_FONTS,
15
+ type DocumentFont,
16
+ } from "./document-fonts.ts";
17
+ export type { DocumentFrameControl } from "./document-frame-control.ts";
18
+ export {
19
+ COLWIDTH_PX_RANGE,
20
+ type DocumentFrameAttributes,
21
+ type DocumentFramePreset,
22
+ FRAME_MM_RANGE,
23
+ FRAME_PRESETS,
24
+ LINE_HEIGHT_RANGE,
25
+ PARAGRAPH_SPACE_PT_RANGE,
26
+ TEXT_SIZE_PT_RANGE,
27
+ } from "./document-print-style.ts";
28
+ export {
29
+ type DocumentBlockStyle,
30
+ type DocumentFrameBox,
31
+ type DocumentTextStyle,
32
+ documentBlockStyleCss,
33
+ documentCellStyleCss,
34
+ documentFrameCss,
35
+ documentTextStyleCss,
36
+ } from "./document-style-css.ts";
37
+ export { FONT_SIZES_PT } from "./document-tiptap-helpers.ts";
10
38
  export {
11
39
  type DocumentEditorChrome,
12
40
  type DocumentEditorHandle,
13
41
  type DocumentEditorProps,
42
+ type DocumentLayoutValues,
43
+ type DocumentPrintBlock,
44
+ type DocumentPrintMode,
14
45
  type DocumentResourcePreview,
15
46
  type DocumentToolbarBlock,
16
47
  MAIL_DOCUMENT_BLOCKS,
@@ -25,11 +56,14 @@ export {
25
56
  MAIL_LAYOUT_WIDTHS,
26
57
  } from "./mail-layout-constants.ts";
27
58
  export {
59
+ PDF_DEFAULT_FONT_SIZE_PT,
28
60
  PDF_DEFAULT_MARGIN_MM,
29
61
  PDF_FOOTER_MARGIN_MM,
30
62
  PDF_HEADER_MARGIN_MM,
31
63
  PDF_ORIENTATIONS,
32
64
  PDF_PAGE_FORMATS,
65
+ PDF_TABLE_STYLES,
66
+ type PdfTableStyle,
33
67
  } from "./pdf-constants.ts";
34
68
  export {
35
69
  PlaceholderLineEditor,
@@ -9,3 +9,9 @@ export type PdfOrientation = (typeof PDF_ORIENTATIONS)[number];
9
9
  export const PDF_DEFAULT_MARGIN_MM = 15;
10
10
  export const PDF_HEADER_MARGIN_MM = 30;
11
11
  export const PDF_FOOTER_MARGIN_MM = 20;
12
+
13
+ // Body text size of a printed document; header and footer fall back to it, so no region reads smaller than the body.
14
+ export const PDF_DEFAULT_FONT_SIZE_PT = 10.5;
15
+
16
+ export const PDF_TABLE_STYLES = ["plain", "lines", "header", "grid"] as const;
17
+ export type PdfTableStyle = (typeof PDF_TABLE_STYLES)[number];
@@ -20,8 +20,14 @@ export const TemplateResolverHandlers = {
20
20
  resourceLinkPdf: "template-resolver:write:resource-link-pdf",
21
21
  sendTest: "template-resolver:write:send-test",
22
22
  patchDraft: "template-resolver:write:patch-draft",
23
+ applyLayout: "template-resolver:write:apply-layout",
24
+ createLayout: "template-resolver:write:create-layout",
25
+ publishTemplates: "template-resolver:write:publish-templates",
23
26
  } as const;
24
27
 
28
+ // The config feature's write handler, which applyLayout dispatches to for the tenant default layout.
29
+ export const ConfigHandlers = { set: "config:write:set" } as const;
30
+
25
31
  export const TemplateResolverQueries = {
26
32
  findById: "template-resolver:query:find-by-id",
27
33
  list: "template-resolver:query:list",
@@ -66,6 +72,7 @@ export const TemplateResolverErrors = {
66
72
  systemResourcesNeedSystemTenant: "system_resources_need_system_tenant",
67
73
  systemOnlyTemplate: "system_only_template",
68
74
  templateNotTenantEditable: "template_not_tenant_editable",
75
+ layoutNotPublished: "layout_not_published",
69
76
  bundleLocalesDiffer: "bundle_locales_differ",
70
77
  resourceTooLarge: "template_resource_too_large",
71
78
  resourceUnsupportedImage: "template_resource_unsupported_image",