@cosmicdrift/kumiko-bundled-features 0.362.0 → 0.363.0

package/dist/template-resolver/testing.js

@@ -37,7 +37,7 @@ export async function assertConsumerHandlesNotFound(consumer, opts) {
         await consumer.resolve({
             tenantId,
             slug,
-            kind: "mail-html",
+            kind: "mail",
             locale: "de",
         });
     }
@@ -60,7 +60,7 @@ export async function assertConsumerRespectsLocaleFallback(consumer, opts) {
     await seedTemplate(db, {
         tenantId: SYSTEM_TENANT_ID,
         slug,
-        kind: "notification",
+        kind: "document-pdf",
         locale: FALLBACK_LOCALE,
         scope: "system",
         content: "conformance-fallback-content",
@@ -68,7 +68,7 @@ export async function assertConsumerRespectsLocaleFallback(consumer, opts) {
     const result = await consumer.resolve({
         tenantId,
         slug,
-        kind: "notification",
+        kind: "document-pdf",
         locale: "tr",
     });
     if (result.locale !== FALLBACK_LOCALE) {
@@ -89,7 +89,7 @@ export async function assertConsumerHandlesMissingResourceKeys(consumer, opts) {
     await seedTemplate(db, {
         tenantId: SYSTEM_TENANT_ID,
         slug,
-        kind: "mail-html",
+        kind: "mail",
         locale: "de",
         scope: "system",
         linkedResources: { logo: "file_missing" },
@@ -97,7 +97,7 @@ export async function assertConsumerHandlesMissingResourceKeys(consumer, opts) {
     const template = await consumer.resolve({
         tenantId,
         slug,
-        kind: "mail-html",
+        kind: "mail",
         locale: "de",
     });
     try {

package/dist/template-resolver/user-content-table.d.ts

@@ -49,26 +49,29 @@ export declare const userContentEntryEntity: import("@cosmicdrift/kumiko-types/f
     kind: {
         readonly type: "select";
         readonly description?: string;
-        readonly options: readonly ["notification", "mail-html", "document-pdf", "image-snapshot", "text-block", "ai-prompt"];
+        readonly options: readonly ["mail", "document-pdf", "image-snapshot", "notification", "text-block", "snippet", "ai-prompt", "mail-layout", "pdf-layout"];
         readonly required?: boolean;
         readonly sortable?: boolean;
         readonly filterable?: boolean;
         readonly sensitive?: boolean;
-        readonly default?: "ai-prompt" | "document-pdf" | "image-snapshot" | "mail-html" | "notification" | "text-block" | undefined;
+        readonly default?: "ai-prompt" | "document-pdf" | "image-snapshot" | "mail" | "mail-layout" | "notification" | "pdf-layout" | "snippet" | "text-block" | undefined;
         readonly access?: import("@cosmicdrift/kumiko-types/fields").FieldAccess;
         readonly display?: "radio" | "dropdown";
         readonly optionTones?: {
             readonly "ai-prompt"?: "bad" | "neutral" | "ok" | "warn" | undefined;
             readonly "document-pdf"?: "bad" | "neutral" | "ok" | "warn" | undefined;
             readonly "image-snapshot"?: "bad" | "neutral" | "ok" | "warn" | undefined;
-            readonly "mail-html"?: "bad" | "neutral" | "ok" | "warn" | undefined;
+            readonly mail?: "bad" | "neutral" | "ok" | "warn" | undefined;
+            readonly "mail-layout"?: "bad" | "neutral" | "ok" | "warn" | undefined;
             readonly notification?: "bad" | "neutral" | "ok" | "warn" | undefined;
+            readonly "pdf-layout"?: "bad" | "neutral" | "ok" | "warn" | undefined;
+            readonly snippet?: "bad" | "neutral" | "ok" | "warn" | undefined;
             readonly "text-block"?: "bad" | "neutral" | "ok" | "warn" | undefined;
         } | undefined;
         readonly optionsQuery?: string;
         readonly optionsQueryPayload?: import("@cosmicdrift/kumiko-types/fields").OptionsQueryPayload;
         readonly optionsAvailabilityQuery?: string;
-        readonly conditionalOptions?: readonly import("@cosmicdrift/kumiko-types/fields").SelectConditionalOptions<"ai-prompt" | "document-pdf" | "image-snapshot" | "mail-html" | "notification" | "text-block">[] | undefined;
+        readonly conditionalOptions?: readonly import("@cosmicdrift/kumiko-types/fields").SelectConditionalOptions<"ai-prompt" | "document-pdf" | "image-snapshot" | "mail" | "mail-layout" | "notification" | "pdf-layout" | "snippet" | "text-block">[] | undefined;
     } & import("@cosmicdrift/kumiko-types/fields").ResolvedPiiFlags & {
         required: true;
     };
@@ -232,26 +235,29 @@ export declare const userContentEntriesTable: import("@cosmicdrift/kumiko-framew
     kind: {
         readonly type: "select";
         readonly description?: string;
-        readonly options: readonly ["notification", "mail-html", "document-pdf", "image-snapshot", "text-block", "ai-prompt"];
+        readonly options: readonly ["mail", "document-pdf", "image-snapshot", "notification", "text-block", "snippet", "ai-prompt", "mail-layout", "pdf-layout"];
         readonly required?: boolean;
         readonly sortable?: boolean;
         readonly filterable?: boolean;
         readonly sensitive?: boolean;
-        readonly default?: "ai-prompt" | "document-pdf" | "image-snapshot" | "mail-html" | "notification" | "text-block" | undefined;
+        readonly default?: "ai-prompt" | "document-pdf" | "image-snapshot" | "mail" | "mail-layout" | "notification" | "pdf-layout" | "snippet" | "text-block" | undefined;
         readonly access?: import("@cosmicdrift/kumiko-types/fields").FieldAccess;
         readonly display?: "radio" | "dropdown";
         readonly optionTones?: {
             readonly "ai-prompt"?: "bad" | "neutral" | "ok" | "warn" | undefined;
             readonly "document-pdf"?: "bad" | "neutral" | "ok" | "warn" | undefined;
             readonly "image-snapshot"?: "bad" | "neutral" | "ok" | "warn" | undefined;
-            readonly "mail-html"?: "bad" | "neutral" | "ok" | "warn" | undefined;
+            readonly mail?: "bad" | "neutral" | "ok" | "warn" | undefined;
+            readonly "mail-layout"?: "bad" | "neutral" | "ok" | "warn" | undefined;
             readonly notification?: "bad" | "neutral" | "ok" | "warn" | undefined;
+            readonly "pdf-layout"?: "bad" | "neutral" | "ok" | "warn" | undefined;
+            readonly snippet?: "bad" | "neutral" | "ok" | "warn" | undefined;
             readonly "text-block"?: "bad" | "neutral" | "ok" | "warn" | undefined;
         } | undefined;
         readonly optionsQuery?: string;
         readonly optionsQueryPayload?: import("@cosmicdrift/kumiko-types/fields").OptionsQueryPayload;
         readonly optionsAvailabilityQuery?: string;
-        readonly conditionalOptions?: readonly import("@cosmicdrift/kumiko-types/fields").SelectConditionalOptions<"ai-prompt" | "document-pdf" | "image-snapshot" | "mail-html" | "notification" | "text-block">[] | undefined;
+        readonly conditionalOptions?: readonly import("@cosmicdrift/kumiko-types/fields").SelectConditionalOptions<"ai-prompt" | "document-pdf" | "image-snapshot" | "mail" | "mail-layout" | "notification" | "pdf-layout" | "snippet" | "text-block">[] | undefined;
     } & import("@cosmicdrift/kumiko-types/fields").ResolvedPiiFlags & {
         required: true;
     };

package/dist/template-resolver/web/client-plugin.d.ts

@@ -9,6 +9,7 @@ export type BlockSummary = {
     readonly modifiedAt: string | null;
 };
 export declare function groupBlocksByFolder(blocks: readonly BlockSummary[], tenantIdOverride?: string, collectionId?: string): readonly TreeNode[];
+export declare function resolveWriteContentFormat(collectionContentFormat: string | undefined, loadedContentFormat: string | undefined): string | undefined;
 export declare function textBlocksClient(opts?: {
     readonly navId?: string;
     readonly tenantId?: string;

package/dist/template-resolver/web/client-plugin.js

@@ -16,6 +16,7 @@ import { ContentPreview, useAppFeatures, useContentEditor, useDispatcher, usePri
 import { PlainContentEditor, RichContentEditor, } from "@cosmicdrift/kumiko-renderer-web";
 import { useEffect, useId, useState } from "react";
 import { collectionHandlerName, collectionQueryName, TemplateResolverHandlers, TemplateResolverQueries, } from "../qualified-names.js";
+import { DocumentContentEditor } from "./document-editor.js";
 import { defaultTranslations } from "./i18n.js";
 function newFolderNode() {
     return { leaves: [], subFolders: new Map() };
@@ -163,19 +164,20 @@ function findContentFormat(features, collectionId) {
 function findVariableExamples(features, collectionId) {
     return findCollection(features, collectionId)?.variableSchema ?? {};
 }
-// The collection's declared contentFormat ("plain" | "rich" | "markdown",
-// see ContentCollectionDefinition.contentFormat) uses a different vocabulary
+// The collection's declared contentFormat ("plain" | "rich" | "markdown" |
+// "document", see ContentCollectionDefinition.contentFormat) uses a different vocabulary
 // than the stored entry's contentFormat ("plain" | "html" | "markdown" |
-// "mjml", see CONTENT_FORMATS) — "rich" always stores HTML. Without this,
+// "mjml", see CONTENT_FORMATS) — "rich" and "document" always store HTML. Without this,
 // handleSave omitting contentFormat let the write schema's
 // contentFormatSchema.default("markdown") silently stamp every save as
 // markdown, clobbering e.g. a "plain" entry. Undefined (no collection, or
 // the collection didn't declare a format) keeps whatever was already saved
 // instead of guessing.
-function resolveWriteContentFormat(collectionContentFormat, loadedContentFormat) {
+// Exported for the unit test — resolveWriteContentFormat is a pure function.
+export function resolveWriteContentFormat(collectionContentFormat, loadedContentFormat) {
     if (collectionContentFormat === "plain")
         return "plain";
-    if (collectionContentFormat === "rich")
+    if (collectionContentFormat === "rich" || collectionContentFormat === "document")
         return "html";
     if (collectionContentFormat === "markdown")
         return "markdown";
@@ -301,12 +303,13 @@ export function textBlocksClient(opts) {
         resolvers: {
             "template-resolver:edit": TextBlockEditor,
         },
-        // The default for every "plain" collection (ai-prompt, mail-html without
+        // The default for every "plain" collection (ai-prompt, mail without
         // an explicit rich override) — an app-registered "plain" editor on
         // another clientFeature still wins, last-wins same as columnRenderers.
         contentEditors: {
             plain: PlainContentEditor,
             rich: RichContentEditor,
+            document: DocumentContentEditor,
             // ponytail: same textarea+chips as "plain" — markdown is stored as
             // text either way. Shares PlainContentEditor's fixed-DOM-id ceiling
             // (see its own file comment); swap for a live-preview widget or a

package/dist/template-resolver/web/document-editor-extensions.d.ts

@@ -0,0 +1,15 @@
+import type { Extensions, NodeViewRenderer } from "@tiptap/core";
+import type { DocumentResourcePreview } from "./document-toolbar-blocks.js";
+export type DocumentEditorLabels = {
+    readonly placeholder: string;
+    readonly image: string;
+    readonly pageBreak: string;
+    readonly button?: string;
+    readonly variableLabels?: Readonly<Record<string, string>>;
+    readonly systemVariables?: readonly string[];
+    readonly resourcePreviews?: Readonly<Record<string, DocumentResourcePreview>>;
+    /** Canvas chrome labels every block with its type. */
+    readonly blockLabels?: boolean;
+};
+export declare function createVariableView(variableLabels: Readonly<Record<string, string>>, systemVariables: readonly string[]): NodeViewRenderer;
+export declare function createDocumentEditorExtensions(labels: DocumentEditorLabels): Extensions;

package/dist/template-resolver/web/document-editor-extensions.js

@@ -0,0 +1,107 @@
+import { ListKeymap } from "@tiptap/extension-list";
+import { Dropcursor, Gapcursor, Placeholder, UndoRedo } from "@tiptap/extensions";
+import { DocumentButton, DocumentPageBreak, DocumentResource, DocumentVariable, documentExtensions, } from "../document-schema.js";
+function createElementWithClass(tag, className, text) {
+    const element = document.createElement(tag);
+    element.className = className;
+    if (text !== undefined)
+        element.textContent = text;
+    return element;
+}
+const CHIP_CLASS = "mx-0.5 inline-flex items-center gap-1 rounded border px-1.5 py-0.5 text-xs";
+const USER_CHIP_CLASS = `${CHIP_CLASS} border-primary/30 bg-primary/10 text-primary`;
+const SYSTEM_CHIP_CLASS = `${CHIP_CLASS} border-input bg-muted text-muted-foreground`;
+// The chip is display only: the stored node carries just the name, so a
+// label never reaches the document.
+export function createVariableView(variableLabels, systemVariables) {
+    return ({ node }) => {
+        const name = String(node.attrs["name"]);
+        const label = Object.hasOwn(variableLabels, name) ? variableLabels[name] : undefined;
+        const dom = createElementWithClass("span", systemVariables.includes(name) ? SYSTEM_CHIP_CLASS : USER_CHIP_CLASS);
+        dom.contentEditable = "false";
+        dom.append(document.createTextNode(label !== undefined && label !== "" ? label : name));
+        if (label !== undefined && label !== "" && label !== name) {
+            dom.append(createElementWithClass("small", "font-mono text-[10px] opacity-75", name));
+        }
+        return { dom };
+    };
+}
+// Same rule the sanitizer's image handling follows: previews never carry a
+// scriptable scheme.
+const PREVIEW_SRC = /^(data:image\/(png|jpeg|gif|webp);|blob:|https:\/\/|\/)/;
+function createBlockLabel(text) {
+    const label = createElementWithClass("span", "absolute -top-2 left-2 bg-card px-1 text-[10px] font-medium uppercase tracking-wide text-muted-foreground", text);
+    label.contentEditable = "false";
+    return label;
+}
+function createResourceView(labels) {
+    return ({ node }) => {
+        const key = String(node.attrs["resource"]);
+        const previews = labels.resourcePreviews ?? {};
+        const preview = Object.hasOwn(previews, key) ? previews[key] : undefined;
+        const dom = createElementWithClass("div", "relative my-3 flex items-center gap-3 rounded border border-dashed border-input px-3 py-3 text-sm text-muted-foreground");
+        dom.contentEditable = "false";
+        if (labels.blockLabels)
+            dom.append(createBlockLabel(labels.image));
+        if (preview !== undefined && PREVIEW_SRC.test(preview.src)) {
+            const image = createElementWithClass("img", "max-h-16 max-w-48 rounded");
+            image.src = preview.src;
+            image.alt = typeof node.attrs["alt"] === "string" ? node.attrs["alt"] : key;
+            dom.append(image);
+            dom.append(createElementWithClass("span", "text-xs", preview.caption ?? key));
+        }
+        else {
+            dom.append(createElementWithClass("span", "font-medium", labels.image), createElementWithClass("code", "text-xs", key));
+        }
+        return { dom };
+    };
+}
+function createButtonView(buttonLabel) {
+    return () => {
+        const dom = createElementWithClass("div", "relative my-3 rounded border border-dashed border-input p-3");
+        const button = document.createElement("a");
+        button.setAttribute("data-button", "");
+        dom.append(createBlockLabel(buttonLabel), button);
+        return { dom, contentDOM: button };
+    };
+}
+function createPageBreakView(pageBreakLabel) {
+    return () => {
+        const dom = createElementWithClass("div", "my-3 border-t border-dashed border-input pt-1 text-center text-xs text-muted-foreground", pageBreakLabel);
+        dom.contentEditable = "false";
+        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) {
+    const base = documentExtensions.map((extension) => {
+        switch (extension.name) {
+            case DocumentVariable.name:
+                return DocumentVariable.extend({
+                    addNodeView: () => createVariableView(labels.variableLabels ?? {}, labels.systemVariables ?? []),
+                });
+            case DocumentResource.name:
+                return DocumentResource.extend({ addNodeView: () => createResourceView(labels) });
+            case DocumentButton.name:
+                return labels.blockLabels
+                    ? DocumentButton.extend({ addNodeView: () => createButtonView(labels.button ?? "") })
+                    : extension;
+            case DocumentPageBreak.name:
+                return DocumentPageBreak.extend({
+                    addNodeView: () => createPageBreakView(labels.pageBreak),
+                });
+            default:
+                return extension;
+        }
+    });
+    // No TrailingNode: it appends an empty paragraph that breaks the HTML roundtrip.
+    return [
+        ...base,
+        UndoRedo,
+        Gapcursor,
+        Dropcursor,
+        ListKeymap,
+        Placeholder.configure({ placeholder: labels.placeholder }),
+    ];
+}

package/dist/template-resolver/web/document-editor.d.ts

@@ -0,0 +1,3 @@
+import { type ReactNode } from "react";
+import type { DocumentEditorProps } from "./document-toolbar-blocks.js";
+export declare function DocumentContentEditor(props: DocumentEditorProps): ReactNode;

package/dist/template-resolver/web/document-editor.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @runtime client
+//
+// Lazy boundary: tiptap only loads when a "document" collection is rendered.
+// Never import document-tiptap-editor or document-editor-extensions statically here.
+import { TextareaContentEditor } from "@cosmicdrift/kumiko-renderer";
+import { lazy, Suspense } from "react";
+const LazyDocumentTiptapEditor = lazy(() => import("./document-tiptap-editor.js"));
+export function DocumentContentEditor(props) {
+    return (_jsx(Suspense, { fallback: _jsx(TextareaContentEditor, { id: props.id, value: props.value, onChange: props.onChange, variables: props.variables, readOnly: props.readOnly }), children: _jsx(LazyDocumentTiptapEditor, { ...props }) }));
+}

package/dist/template-resolver/web/document-tiptap-editor.d.ts

@@ -0,0 +1,3 @@
+import { type ReactNode } from "react";
+import { type DocumentEditorProps } from "./document-toolbar-blocks.js";
+export default function DocumentTiptapEditor({ id, value, onChange, variables, readOnly, blocks, variableLabels, systemVariables, resourcePreviews, chrome, toolbar, onEditorReady, }: DocumentEditorProps): ReactNode;