@cosmicdrift/kumiko-samples 0.377.0 → 0.379.0

package/packages/bundled-features/src/template-resolver/template-validation.ts

@@ -7,12 +7,12 @@ import type {
 import type { Element as ScanElement } from "happy-dom";
 import * as z from "zod";
 import { conditionScopeElement, withParsedDocument } from "./document-sanitizer.ts";
+import type { TemplateMeta } from "./template-meta.ts";
 import {
   DOCUMENT_CONDITION_ATTRIBUTE,
   isDocumentPlaceholderHref,
   isDocumentReferenceName,
-} from "./document-schema.ts";
-import type { TemplateMeta } from "./template-meta.ts";
+} from "./web/document-schema.ts";
 
 export const SYSTEM_PLACEHOLDERS: ReadonlySet<string> = new Set([
   "tenantName",
@@ -65,6 +65,7 @@ const scalarVariableSchema = z.discriminatedUnion("type", [
 
 const variableDefSchema = z.union([
   scalarVariableSchema,
+  z.object({ ...variableCommon, type: z.literal("images") }),
   z.object({
     ...variableCommon,
     type: z.literal("list"),
@@ -126,17 +127,24 @@ function listItemFields(
   return def?.type === "list" ? def.item : {};
 }
 
+// An images variable holds file ids: as text it would leak them, so only an images block
+// (and a condition on its presence) may name it.
 function isKnownName(
   name: string,
   scope: PlaceholderScope,
   itemFields: Readonly<Record<string, unknown>>,
+  allowImages = false,
 ): Resolution {
   const { variables } = scope;
   const root = rootName(name);
   // Declared variables and item fields are scalars: a dotted path under one never renders a value.
   if (Object.hasOwn(itemFields, name)) return { known: true, used: "" };
   if (scope.systemPlaceholders.has(root)) return { known: true, used: "" };
-  if (Object.hasOwn(variables, name)) return { known: true, used: name };
+  if (Object.hasOwn(variables, name)) {
+    return variables[name]?.type === "images" && !allowImages
+      ? { known: false, used: "" }
+      : { known: true, used: name };
+  }
   return { known: false, used: "" };
 }
 
@@ -144,8 +152,9 @@ function recordName(
   name: string,
   itemFields: Readonly<Record<string, unknown>>,
   scope: PlaceholderScope,
+  allowImages = false,
 ) {
-  const resolution = isKnownName(name, scope, itemFields);
+  const resolution = isKnownName(name, scope, itemFields, allowImages);
   if (!resolution.known) scope.unknown.add(name);
   else if (resolution.used !== "") scope.used.add(resolution.used);
 }
@@ -154,10 +163,18 @@ function enclosingEachName(element: ScanElement): string | null {
   return element.closest("tr[data-each]")?.getAttribute("data-each") ?? null;
 }
 
-const NAME_ATTRIBUTE_BY_TAG: Readonly<Record<string, string>> = {
-  span: "data-variable",
-  div: "data-steps",
-};
+function nameAttributeOf(element: ScanElement): string | undefined {
+  const tag = element.tagName.toLowerCase();
+  if (tag === "span") return "data-variable";
+  if (tag !== "div") return undefined;
+  return element.hasAttribute("data-images") ? "data-images" : "data-steps";
+}
+
+function recordImagesName(name: string, scope: PlaceholderScope): void {
+  const def = Object.hasOwn(scope.variables, name) ? scope.variables[name] : undefined;
+  if (def?.type === "images") scope.used.add(name);
+  else scope.unknown.add(name);
+}
 
 function scanRepeatRows(root: ScanElement, scope: PlaceholderScope): void {
   for (const element of Array.from(root.querySelectorAll("tr[data-each]"))) {
@@ -174,18 +191,22 @@ function scanConditions(root: ScanElement, scope: PlaceholderScope): void {
       scope.variables,
       enclosingEachName(conditionScopeElement(element)),
     );
-    recordName(element.getAttribute(DOCUMENT_CONDITION_ATTRIBUTE) ?? "", itemFields, scope);
+    recordName(element.getAttribute(DOCUMENT_CONDITION_ATTRIBUTE) ?? "", itemFields, scope, true);
   }
 }
 
 function scanReferences(root: ScanElement, scope: PlaceholderScope): void {
   for (const element of Array.from(
-    root.querySelectorAll("span[data-variable], div[data-steps], a[href], img[data-resource]"),
+    root.querySelectorAll(
+      "span[data-variable], div[data-steps], div[data-images], a[href], img[data-resource]",
+    ),
   )) {
     const itemFields = listItemFields(scope.variables, enclosingEachName(element));
     const tag = element.tagName.toLowerCase();
-    const nameAttribute = NAME_ATTRIBUTE_BY_TAG[tag];
-    if (nameAttribute !== undefined) {
+    const nameAttribute = nameAttributeOf(element);
+    if (nameAttribute === "data-images") {
+      recordImagesName(element.getAttribute(nameAttribute) ?? "", scope);
+    } else if (nameAttribute !== undefined) {
       recordName(element.getAttribute(nameAttribute) ?? "", itemFields, scope);
     } else if (tag === "a") {
       const href = element.getAttribute("href") ?? "";

package/packages/bundled-features/src/template-resolver/testing.ts

@@ -6,6 +6,7 @@ import type { DbConnection } from "@cosmicdrift/kumiko-framework/db";
 import { seedRow } from "@cosmicdrift/kumiko-testing/helpers";
 import type { ResolveRequest, TemplateResource } from "./api.ts";
 import { TemplateNotFoundError } from "./api.ts";
+import { templateResourcesTable } from "./table.ts";
 import {
   type ContentFormat,
   FALLBACK_LOCALE,
@@ -13,8 +14,7 @@ import {
   SYSTEM_TENANT_ID,
   type TemplateScope,
   type TemplateStatus,
-} from "./constants.ts";
-import { templateResourcesTable } from "./table.ts";
+} from "./web/constants.ts";
 
 export type TemplateConsumer = {
   readonly resolve: (args: ResolveRequest) => Promise<TemplateResource>;

package/packages/bundled-features/src/template-resolver/user-content-table.ts

@@ -5,8 +5,8 @@ import {
   createSelectField,
   createTextField,
 } from "@cosmicdrift/kumiko-framework/engine";
-import { CONTENT_FORMATS, TEMPLATE_KINDS } from "./constants.ts";
 import type { EntityAuditColumns } from "./table.ts";
+import { CONTENT_FORMATS, TEMPLATE_KINDS } from "./web/constants.ts";
 
 // UserContentEntry — the per-user half of the content store: mail signatures
 // and personal reply snippets, one row per (tenantId, ownerId, slug, kind,

package/packages/bundled-features/src/template-resolver/web/client-plugin.tsx

@@ -1,5 +1,4 @@
 import { EMPTY_VALUE_PLACEHOLDER } from "@cosmicdrift/kumiko-renderer/headless";
-// @runtime client
 // Client feature factory for the text-block content tree. Apps mount it via
 // createKumikoApp({ clientFeatures: [textBlocksClient()] }); it loads the
 // blocks from the by-tenant query, groups them by their `folder` field and
@@ -35,15 +34,15 @@ import {
 } from "@cosmicdrift/kumiko-renderer/web";
 import type { ContentEditorFormat } from "@cosmicdrift/kumiko-types/nav";
 import { type FormEvent, type ReactNode, useEffect, useId, useState } from "react";
+import { DocumentBlocksContext, DocumentContentEditor } from "./document-editor.tsx";
+import { documentBlocksForKind } from "./document-toolbar-blocks.ts";
+import { defaultTranslations } from "./i18n.ts";
 import {
   collectionHandlerName,
   collectionQueryName,
   TemplateResolverHandlers,
   TemplateResolverQueries,
-} from "../qualified-names.ts";
-import { DocumentBlocksContext, DocumentContentEditor } from "./document-editor.tsx";
-import { documentBlocksForKind } from "./document-toolbar-blocks.ts";
-import { defaultTranslations } from "./i18n.ts";
+} from "./qualified-names.ts";
 
 // Exported for the unit test — groupBlocksByFolder is a pure function.
 export type BlockSummary = {

package/packages/bundled-features/src/template-resolver/{constants.ts → web/constants.ts}

@@ -1,11 +1,9 @@
-// @runtime client
 // Plain data, no imports — the content tree in web/ needs TEXT_BLOCK_KIND to
 // pick between the public and the admin query.
 //
-// RenderKind identifiziert die Konsumenten-Klasse eines Templates.
-// Plugin-Renderer in `renderer-foundation` matchen auf kind; der
-// Resolver hier ist kind-agnostisch — er lädt nur, das Content-Format
-// (markdown/mjml/html) entscheidet wer's rendert.
+// RenderKind identifies the consumer class of a template. Plugin renderers in
+// `renderer-foundation` match on kind; the resolver here is kind-agnostic: it
+// only loads, and the content format (markdown/mjml/html) decides who renders it.
 export const RENDER_KINDS = ["mail", "document-pdf", "image-snapshot"] as const;
 export type RenderKind = (typeof RENDER_KINDS)[number];
 
@@ -92,10 +90,12 @@ export const MAIL_PREVIEW_MAX_BYTES = 10 * 1024 * 1024;
 
 export const TEST_MAIL_SUBJECT_PREFIX = "[TEST] ";
 
-// System-Templates leben unter der canonical SYSTEM_TENANT_ID-Sentinel-UUID.
-// Re-Export aus framework — single source of truth, vermeidet Drift.
-export { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-framework/engine";
+// System templates live under the SYSTEM_TENANT_ID sentinel; the client-safe types package is its single source.
+export { SYSTEM_TENANT_ID } from "@cosmicdrift/kumiko-types/identifiers";
 
-// Default-Locale wenn Tenant keinen eigenen Default konfiguriert. Resolver
-// fällt darauf zurück wenn requested locale + tenant-default fehlen.
+// Default locale when the tenant configures none. The resolver falls back to
+// it when the requested locale and the tenant default are missing.
 export const FALLBACK_LOCALE = "de";
+
+// A collection mounted without `access` is maintained by the platform only; TenantAdmin access is an explicit mount decision.
+export const DEFAULT_COLLECTION_ACCESS = { roles: ["SystemAdmin"] } as const;

package/packages/bundled-features/src/template-resolver/{document-blocks.ts → web/document-blocks.ts}

@@ -1,4 +1,3 @@
-// @runtime client
 export type DocumentToolbarBlock =
   | "image"
   | "table"
@@ -7,7 +6,8 @@ export type DocumentToolbarBlock =
   | "repeat"
   | "pageBreak"
   | "align"
-  | "steps";
+  | "steps"
+  | "images";
 
 export const MAIL_DOCUMENT_BLOCKS = [
   "image",
@@ -25,6 +25,7 @@ export const PDF_DOCUMENT_BLOCKS = [
   "divider",
   "repeat",
   "steps",
+  "images",
   "pageBreak",
 ] as const satisfies readonly DocumentToolbarBlock[];
 

package/packages/bundled-features/src/template-resolver/web/document-editor-extensions.ts

@@ -1,17 +1,17 @@
-// @runtime client
 import type { Extensions, NodeViewRenderer } from "@tiptap/core";
 import { ListKeymap } from "@tiptap/extension-list";
 import { Dropcursor, Gapcursor, Placeholder, UndoRedo } from "@tiptap/extensions";
 import type { Node as ProseMirrorNode } from "@tiptap/pm/model";
 import {
   DocumentButton,
+  DocumentImages,
   DocumentPageBreak,
   DocumentResource,
   DocumentSteps,
   DocumentVariable,
   documentExtensions,
-} from "../document-schema.ts";
-import { readDocumentStepsAttribute } from "../document-steps.ts";
+} from "./document-schema.ts";
+import { readDocumentStepsAttribute } from "./document-steps.ts";
 import type { DocumentResourcePreview } from "./document-toolbar-blocks.ts";
 
 const DOCUMENT_RESOURCE_SIZE_TOKEN = "{size}";
@@ -23,6 +23,7 @@ export type DocumentEditorLabels = {
   readonly pageBreak: string;
   readonly button?: string;
   readonly steps?: string;
+  readonly images?: string;
   /** Canvas block label of an image, e.g. "Image · inline". */
   readonly imageBlock?: string;
   readonly variableLabels?: Readonly<Record<string, string>>;
@@ -206,6 +207,31 @@ function createStepsView(labels: DocumentEditorLabels): NodeViewRenderer {
   };
 }
 
+// A sketch only: the photos are record data, known at render time.
+function createImagesView(labels: DocumentEditorLabels): NodeViewRenderer {
+  return ({ node }) => {
+    const dom = createElementWithClass(
+      "div",
+      "relative my-3 rounded border border-dashed border-input px-3 pb-3 pt-4",
+    );
+    dom.setAttribute(DOCUMENT_BLOCK_ATTRIBUTE, "");
+    dom.contentEditable = "false";
+    const variable = String(node.attrs["variable"]);
+    const variableLabels = labels.variableLabels ?? {};
+    const variableLabel = Object.hasOwn(variableLabels, variable)
+      ? variableLabels[variable]
+      : undefined;
+    dom.append(createBlockLabel(`${labels.images ?? "Photos"} · ${variableLabel ?? variable}`));
+    const grid = createElementWithClass("div", "grid grid-cols-2 gap-1.5");
+    grid.append(
+      createElementWithClass("div", "h-12 rounded bg-muted"),
+      createElementWithClass("div", "h-12 rounded bg-muted"),
+    );
+    dom.append(grid);
+    return { dom };
+  };
+}
+
 // Replaced by name, not appended: the schema must keep exactly one node per
 // name, and only the editor view differs from the shared document schema.
 export function createDocumentEditorExtensions(labels: DocumentEditorLabels): Extensions {
@@ -224,6 +250,8 @@ export function createDocumentEditorExtensions(labels: DocumentEditorLabels): Ex
           : extension;
       case DocumentSteps.name:
         return DocumentSteps.extend({ addNodeView: () => createStepsView(labels) });
+      case DocumentImages.name:
+        return DocumentImages.extend({ addNodeView: () => createImagesView(labels) });
       case DocumentPageBreak.name:
         return DocumentPageBreak.extend({
           addNodeView: () => createPageBreakView(labels.pageBreak),

package/packages/bundled-features/src/template-resolver/web/document-editor.tsx

@@ -1,4 +1,3 @@
-// @runtime client
 //
 // Lazy boundary: tiptap only loads when a "document" collection is rendered.
 // Never import document-tiptap-editor or document-editor-extensions statically here.

package/packages/bundled-features/src/template-resolver/web/document-images.ts

@@ -0,0 +1,28 @@
+// The record's photos: a block bound to an `images` variable whose FileRef ids the
+// app passes at render time. Universal like document-schema.ts.
+import { Node } from "@tiptap/core";
+
+export function createDocumentImagesNode(isReferenceName: (value: string) => boolean) {
+  return Node.create({
+    name: "images",
+    group: "block",
+    atom: true,
+    addAttributes() {
+      return { variable: { default: null } };
+    },
+    parseHTML() {
+      return [
+        {
+          tag: "div[data-images]",
+          getAttrs: (element) => {
+            const variable = element.getAttribute("data-images");
+            return variable !== null && isReferenceName(variable) ? { variable } : false;
+          },
+        },
+      ];
+    },
+    renderHTML({ node }) {
+      return ["div", { "data-images": node.attrs["variable"] }];
+    },
+  });
+}

package/packages/bundled-features/src/template-resolver/{document-schema.ts → web/document-schema.ts}

@@ -1,4 +1,3 @@
-// @runtime client
 // Canonical document model for template bodies (kinds mail, document-pdf).
 // Universal on purpose: the web editor and the server sanitizer load the same
 // extension list, so what the editor can produce is exactly what the server
@@ -8,6 +7,7 @@ import { Extension, type Extensions, Node } from "@tiptap/core";
 import { Link } from "@tiptap/extension-link";
 import { Table, TableCell, TableHeader, TableRow } from "@tiptap/extension-table";
 import StarterKit from "@tiptap/starter-kit";
+import { createDocumentImagesNode } from "./document-images.ts";
 import { createDocumentStepsNode } from "./document-steps.ts";
 
 const PLACEHOLDER_HREF = /^\{\{(.+)\}\}$/;
@@ -73,6 +73,7 @@ export const DOCUMENT_NODE_NAMES = [
   "divider",
   "pageBreak",
   "steps",
+  "images",
 ] as const;
 
 export const DocumentVariable = Node.create({
@@ -184,6 +185,8 @@ export const DocumentPageBreak = Node.create({
 
 export const DocumentSteps = createDocumentStepsNode(isDocumentReferenceName);
 
+export const DocumentImages = createDocumentImagesNode(isDocumentReferenceName);
+
 // A repeat row is a table row carrying `each`: prosemirror-tables requires
 // the tableRow node type, so a separate node type is not an option.
 export const DocumentTableRow = TableRow.extend({
@@ -378,6 +381,7 @@ export const documentExtensions: Extensions = [
   DocumentDivider,
   DocumentPageBreak,
   DocumentSteps,
+  DocumentImages,
   DocumentTextAlign,
   DocumentTextSize,
   DocumentCondition,

package/packages/bundled-features/src/template-resolver/{document-steps.ts → web/document-steps.ts}

@@ -1,4 +1,3 @@
-// @runtime client
 // A progress row: fixed stages stored in the template, the reached stage read
 // from a variable at render time. Universal like document-schema.ts.
 import { Node } from "@tiptap/core";

package/packages/bundled-features/src/template-resolver/web/document-tiptap-editor.tsx

@@ -1,4 +1,3 @@
-// @runtime client
 //
 // tiptap-backed implementation behind DocumentContentEditor's lazy() boundary —
 // never import this file statically, tiptap must only load when a "document"
@@ -25,6 +24,7 @@ import {
   Bold as BoldIcon,
   Braces,
   ChevronDown,
+  GalleryThumbnails,
   Image as ImageIcon,
   Italic as ItalicIcon,
   Link as LinkIcon,
@@ -40,6 +40,10 @@ import {
 } from "lucide-react";
 import { Fragment, type ReactNode, useEffect, useMemo, useState } from "react";
 import { createPortal } from "react-dom";
+import {
+  createDocumentEditorExtensions,
+  DOCUMENT_BLOCK_ATTRIBUTE,
+} from "./document-editor-extensions.ts";
 import {
   DOCUMENT_TEXT_ALIGNMENTS,
   type DocumentTextAlignment,
@@ -47,12 +51,8 @@ import {
   isDocumentPlaceholderHref,
   isDocumentReferenceName,
   isDocumentResourceKey,
-} from "../document-schema.ts";
-import { parseDocumentStepsInput } from "../document-steps.ts";
-import {
-  createDocumentEditorExtensions,
-  DOCUMENT_BLOCK_ATTRIBUTE,
-} from "./document-editor-extensions.ts";
+} from "./document-schema.ts";
+import { parseDocumentStepsInput } from "./document-steps.ts";
 import {
   type DocumentEditorProps,
   type DocumentResourcePreview,
@@ -72,7 +72,15 @@ function previewsKey(previews: Readonly<Record<string, DocumentResourcePreview>>
     .join("\n");
 }
 
-type PanelKind = "link" | "placeholder" | "image" | "button" | "repeat" | "align" | "steps";
+type PanelKind =
+  | "link"
+  | "placeholder"
+  | "image"
+  | "button"
+  | "repeat"
+  | "align"
+  | "steps"
+  | "images";
 
 // Blocks that stay in the canvas toolbar; the rest moves into the overflow menu.
 const CANVAS_INLINE_BLOCKS: readonly DocumentToolbarBlock[] = ["image", "table"];
@@ -83,6 +91,7 @@ const BLOCK_PANEL: Partial<Record<DocumentToolbarBlock, PanelKind>> = {
   repeat: "repeat",
   align: "align",
   steps: "steps",
+  images: "images",
 };
 
 const ALIGNMENT_ICONS: Record<DocumentTextAlignment, ReactNode> = {
@@ -392,7 +401,11 @@ function InsertPanel({
   };
 
   const needsVariables =
-    kind === "button" || kind === "repeat" || kind === "placeholder" || kind === "steps";
+    kind === "button" ||
+    kind === "repeat" ||
+    kind === "placeholder" ||
+    kind === "steps" ||
+    kind === "images";
   const noVariables = needsVariables && selectable.length === 0;
   const idPrefix = `${editorId}-panel`;
 
@@ -498,6 +511,16 @@ function InsertPanel({
           onChange={setChosenName}
         />
       )}
+      {kind === "images" && !noVariables && (
+        <NameSelect
+          id={`${idPrefix}-images-variable`}
+          label={t("template-resolver.documentEditor.imagesVariable")}
+          names={selectable}
+          labels={variableLabels}
+          value={selectedName}
+          onChange={setChosenName}
+        />
+      )}
       {kind === "steps" && !noVariables && (
         <>
           <NameSelect
@@ -551,6 +574,10 @@ function InsertPanel({
           {...(kind === "repeat" &&
             !noVariables && { onInsert: () => insertAndClose(repeatTableContent(selectedName)) })}
           {...(kind === "steps" && !noVariables && { onInsert: submitSteps })}
+          {...(kind === "images" &&
+            !noVariables && {
+              onInsert: () => insertAndClose({ type: "images", attrs: { variable: selectedName } }),
+            })}
         />
       </div>
     </div>
@@ -563,7 +590,8 @@ export default function DocumentTiptapEditor({
   onChange,
   variables,
   readOnly,
-  blocks = MAIL_DOCUMENT_BLOCKS,
+  blocks: configuredBlocks = MAIL_DOCUMENT_BLOCKS,
+  imageVariables = NO_NAMES,
   variableLabels = NO_LABELS,
   systemVariables = NO_NAMES,
   resourcePreviews = NO_PREVIEWS,
@@ -581,6 +609,11 @@ export default function DocumentTiptapEditor({
   const canvas = chrome === "canvas";
   const compact = toolbar === "compact" && !canvas;
   const hosted = toolbarHost !== undefined;
+  // A photo block needs an images variable to bind to; without one the button would open an empty panel.
+  const blocks =
+    imageVariables.length === 0
+      ? configuredBlocks.filter((block) => block !== "images")
+      : configuredBlocks;
 
   const placeholderLabel = t("template-resolver.documentEditor.placeholder");
   const imageLabel = t("template-resolver.documentEditor.image");
@@ -588,6 +621,7 @@ export default function DocumentTiptapEditor({
   const pageBreakLabel = t("template-resolver.documentEditor.pageBreak");
   const buttonLabel = t("template-resolver.documentEditor.button");
   const stepsLabel = t("template-resolver.documentEditor.steps");
+  const imagesLabel = t("template-resolver.documentEditor.images");
   const stableLabels = useStableByKey(variableLabels, JSON.stringify(variableLabels));
   const stableSystem = useStableByKey(systemVariables, systemVariables.join("\n"));
   const stablePreviews = useStableByKey(resourcePreviews, previewsKey(resourcePreviews));
@@ -599,6 +633,7 @@ export default function DocumentTiptapEditor({
         pageBreak: pageBreakLabel,
         button: buttonLabel,
         steps: stepsLabel,
+        images: imagesLabel,
         imageBlock: imageBlockLabel,
         variableLabels: stableLabels,
         systemVariables: stableSystem,
@@ -612,6 +647,7 @@ export default function DocumentTiptapEditor({
       pageBreakLabel,
       buttonLabel,
       stepsLabel,
+      imagesLabel,
       stableLabels,
       stableSystem,
       stablePreviews,
@@ -731,6 +767,7 @@ export default function DocumentTiptapEditor({
     pageBreak: { label: pageBreakLabel, icon: <Scissors size={16} /> },
     align: { label: t("template-resolver.documentEditor.align"), icon: <AlignLeft size={16} /> },
     steps: { label: stepsLabel, icon: <ListChecks size={16} /> },
+    images: { label: imagesLabel, icon: <GalleryThumbnails size={16} /> },
   };
 
   const repeatTable = activeState?.repeatTable ?? null;
@@ -1058,7 +1095,7 @@ export default function DocumentTiptapEditor({
       editor={editor}
       editorId={id}
       kind={openPanel}
-      variables={variables}
+      variables={openPanel === "images" ? imageVariables : variables}
       variableLabels={stableLabels}
       onClose={() => setOpenPanel(null)}
     />

package/packages/bundled-features/src/template-resolver/web/document-toolbar-blocks.ts

@@ -1,7 +1,6 @@
-// @runtime client
 import type { ContentEditorProps } from "@cosmicdrift/kumiko-renderer";
 import type { ReactNode } from "react";
-import type { DocumentToolbarBlock } from "../document-blocks.ts";
+import type { DocumentToolbarBlock } from "./document-blocks.ts";
 
 /** Imperative access for an outside panel (placeholder list, resource list). */
 export type DocumentEditorHandle = {
@@ -22,6 +21,8 @@ export type DocumentEditorChrome = "default" | "canvas";
 
 export type DocumentEditorProps = ContentEditorProps & {
   readonly blocks?: readonly DocumentToolbarBlock[];
+  /** Names of the template's images variables; the photo block offers exactly these and is hidden without any. */
+  readonly imageVariables?: readonly string[];
   /** Display label per variable name, as inserted (list item fields use the
    *  dotted form, e.g. "lines.description"). A chip shows label and name. */
   readonly variableLabels?: Readonly<Record<string, string>>;
@@ -46,4 +47,4 @@ export {
   documentBlocksForKind,
   MAIL_DOCUMENT_BLOCKS,
   PDF_DOCUMENT_BLOCKS,
-} from "../document-blocks.ts";
+} from "./document-blocks.ts";

package/packages/bundled-features/src/template-resolver/web/editor-handle.ts

@@ -1,6 +1,5 @@
-// @runtime client
 import type { Editor } from "@tiptap/core";
-import { isDocumentReferenceName, isDocumentResourceKey } from "../document-schema.ts";
+import { isDocumentReferenceName, isDocumentResourceKey } from "./document-schema.ts";
 import type { DocumentEditorHandle } from "./document-toolbar-blocks.ts";
 
 export function createEditorHandle(editor: Editor): DocumentEditorHandle {

package/packages/bundled-features/src/template-resolver/web/i18n.ts

@@ -1,4 +1,3 @@
-// @runtime client
 // Default translation bundle for the text-block editor. textBlocksClient()
 // hangs it into the LocaleProvider as a fallback bundle — apps override
 // individual keys via mergeTranslations at the createKumikoApp level.
@@ -43,6 +42,8 @@ export const defaultTranslations: TranslationsByLocale = {
     "template-resolver.documentEditor.removeLink": "Remove link",
     "template-resolver.documentEditor.repeat": "Repeat",
     "template-resolver.documentEditor.repeatList": "List to repeat",
+    "template-resolver.documentEditor.images": "Photos",
+    "template-resolver.documentEditor.imagesVariable": "Photos from",
     "template-resolver.documentEditor.steps": "Steps",
     "template-resolver.documentEditor.stepsVariable": "Current step from",
     "template-resolver.documentEditor.stepsList": "Steps, separated by commas (value=label)",
@@ -58,6 +59,8 @@ export const defaultTranslations: TranslationsByLocale = {
     "template-resolver.editor.saving": "Saving…",
     "template-resolver.editor.created": "Created.",
     "template-resolver.editor.saved": "Saved.",
+    "templateResolver.errors.document.imagesBlockPdfOnly":
+      "Photo blocks are only allowed in PDF documents.",
     "templateResolver.errors.document.buttonHrefNotPlaceholder":
       "The button target “{detail}” must be a placeholder.",
     "templateResolver.errors.document.disallowedLinkHref":
@@ -122,6 +125,10 @@ export const defaultTranslations: TranslationsByLocale = {
     "templateResolver.errors.noDraft": "There is no draft to discard.",
     "templateResolver.errors.systemOnlyTemplate":
       "Only the platform maintains this template; it cannot be overridden per tenant.",
+    "templateResolver.errors.templateNotTenantEditable":
+      "Only the platform may edit this template.",
+    "templateResolver.overview.lockedOverride":
+      "Own version stored but not delivered: the template is not unlocked for tenants.",
     "templateResolver.errors.template.invalidMeta": "The template settings are invalid.",
     "templateResolver.errors.template.meta.subject.required": "The subject is missing.",
     "templateResolver.errors.template.meta.subject.invalid":

package/packages/bundled-features/src/template-resolver/web/index.ts

@@ -1,23 +1,9 @@
-// @runtime client
 // Public exports for the browser side of template-resolver. Consumed through
 // the sub-path export `@cosmicdrift/kumiko-bundled-features/template-resolver/web`
 // — the server side (defineFeature) lives in
 // `@cosmicdrift/kumiko-bundled-features/template-resolver` and has no React or
 // DOM deps.
 
-export { MAIL_TONES, type MailTone } from "../mail-constants.ts";
-export {
-  PDF_DEFAULT_MARGIN_MM,
-  PDF_FOOTER_MARGIN_MM,
-  PDF_HEADER_MARGIN_MM,
-  PDF_ORIENTATIONS,
-  PDF_PAGE_FORMATS,
-} from "../pdf-constants.ts";
-export {
-  TemplateResolverErrors,
-  TemplateResolverHandlers,
-  TemplateResolverQueries,
-} from "../qualified-names.ts";
 export { textBlocksClient } from "./client-plugin.tsx";
 export { DocumentContentEditor } from "./document-editor.tsx";
 export {
@@ -29,7 +15,20 @@ export {
   MAIL_DOCUMENT_BLOCKS,
   PDF_DOCUMENT_BLOCKS,
 } from "./document-toolbar-blocks.ts";
+export { MAIL_TONES, type MailTone } from "./mail-constants.ts";
+export {
+  PDF_DEFAULT_MARGIN_MM,
+  PDF_FOOTER_MARGIN_MM,
+  PDF_HEADER_MARGIN_MM,
+  PDF_ORIENTATIONS,
+  PDF_PAGE_FORMATS,
+} from "./pdf-constants.ts";
 export {
   PlaceholderLineEditor,
   type PlaceholderLineEditorProps,
 } from "./placeholder-line-editor-lazy.tsx";
+export {
+  TemplateResolverErrors,
+  TemplateResolverHandlers,
+  TemplateResolverQueries,
+} from "./qualified-names.ts";

package/packages/bundled-features/src/template-resolver/{mail-constants.ts → web/mail-constants.ts}

@@ -1,4 +1,3 @@
-// @runtime client
 // No imports: web/ re-exports these, and template-meta.ts pulls in zod and the framework engine.
 export const MAIL_TONES = ["accent", "info", "success", "warning", "danger", "neutral"] as const;
 export type MailTone = (typeof MAIL_TONES)[number];

package/packages/bundled-features/src/template-resolver/{pdf-constants.ts → web/pdf-constants.ts}

@@ -1,4 +1,3 @@
-// @runtime client
 // No imports: web/ re-exports these, and constants.ts pulls in the framework engine.
 export const PDF_PAGE_FORMATS = ["A4", "Letter"] as const;
 export type PdfPageFormat = (typeof PDF_PAGE_FORMATS)[number];