@cosmicdrift/kumiko-bundled-features 0.364.0 → 0.365.0

package/dist/template-resolver/template-validation.js

@@ -76,15 +76,13 @@ function listItemFields(variables, listName) {
 function isKnownName(name, scope, itemFields) {
     const { variables } = scope;
     const root = rootName(name);
-    if (Object.hasOwn(itemFields, name) || Object.hasOwn(itemFields, root)) {
+    // 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, root))
-        return { known: true, used: root };
     return { known: false, used: "" };
 }
 function recordName(name, itemFields, scope) {
@@ -97,6 +95,10 @@ function recordName(name, itemFields, scope) {
 function enclosingEachName(element) {
     return element.closest("tr[data-each]")?.getAttribute("data-each") ?? null;
 }
+const NAME_ATTRIBUTE_BY_TAG = {
+    span: "data-variable",
+    div: "data-steps",
+};
 function scanBodyPlaceholders(body, scope) {
     withParsedDocument(body, (root) => {
         for (const element of Array.from(root.querySelectorAll("tr[data-each]"))) {
@@ -107,11 +109,12 @@ function scanBodyPlaceholders(body, scope) {
             else
                 scope.unknown.add(listName);
         }
-        for (const element of Array.from(root.querySelectorAll("span[data-variable], a[href], img[data-resource]"))) {
+        for (const element of Array.from(root.querySelectorAll("span[data-variable], div[data-steps], a[href], img[data-resource]"))) {
             const itemFields = listItemFields(scope.variables, enclosingEachName(element));
             const tag = element.tagName.toLowerCase();
-            if (tag === "span") {
-                recordName(element.getAttribute("data-variable") ?? "", itemFields, scope);
+            const nameAttribute = NAME_ATTRIBUTE_BY_TAG[tag];
+            if (nameAttribute !== undefined) {
+                recordName(element.getAttribute(nameAttribute) ?? "", itemFields, scope);
             }
             else if (tag === "a") {
                 const href = element.getAttribute("href") ?? "";
@@ -127,7 +130,7 @@ function scanBodyPlaceholders(body, scope) {
     });
 }
 const HANDLEBARS_EXPRESSION = /\{\{([^{}]*)\}\}/g;
-// Meta text supports only plain `{{name}}` / `{{name.field}}`; every other
+// Meta text supports only plain `{{name}}` references; every other
 // Handlebars construct is reported as unknown so it can never reach the compiler.
 function scanMetaPlaceholders(text, scope) {
     const leftover = text.replace(HANDLEBARS_EXPRESSION, (_match, inner) => {
@@ -144,7 +147,7 @@ function scanMetaPlaceholders(text, scope) {
 function metaTexts(meta) {
     if (meta === null || !("subject" in meta))
         return [];
-    return [meta.subject, ...(meta.previewText === undefined ? [] : [meta.previewText])];
+    return [meta.subject, meta.previewText, meta.headerChip, meta.tone, meta.footerNote].filter((text) => text !== undefined);
 }
 export function validateTemplatePlaceholders(input) {
     const scope = {

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

@@ -6,6 +6,7 @@ export type DocumentEditorLabels = {
     readonly image: string;
     readonly pageBreak: string;
     readonly button?: string;
+    readonly steps?: string;
     /** Canvas block label of an image, e.g. "Image · inline". */
     readonly imageBlock?: string;
     readonly variableLabels?: Readonly<Record<string, string>>;

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

@@ -1,6 +1,7 @@
 import { ListKeymap } from "@tiptap/extension-list";
 import { Dropcursor, Gapcursor, Placeholder, UndoRedo } from "@tiptap/extensions";
-import { DocumentButton, DocumentPageBreak, DocumentResource, DocumentVariable, documentExtensions, } from "../document-schema.js";
+import { DocumentButton, DocumentPageBreak, DocumentResource, DocumentSteps, DocumentVariable, documentExtensions, } from "../document-schema.js";
+import { readDocumentStepsAttribute } from "../document-steps.js";
 const DOCUMENT_RESOURCE_SIZE_TOKEN = "{size}";
 export const DOCUMENT_BLOCK_ATTRIBUTE = "data-document-block";
 function createElementWithClass(tag, className, text) {
@@ -110,6 +111,28 @@ function createPageBreakView(pageBreakLabel) {
         return { dom };
     };
 }
+// A static sketch of the row: which stage is reached is only known at render time.
+function createStepsView(labels) {
+    return ({ node }) => {
+        const dom = createElementWithClass("div", "relative my-3 rounded border border-dashed border-input px-3 pb-2 pt-3");
+        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.steps ?? "Steps"} · ${variableLabel ?? variable}`));
+        const row = createElementWithClass("div", "flex gap-1.5");
+        for (const step of readDocumentStepsAttribute(node.attrs["steps"])) {
+            const cell = createElementWithClass("div", "min-w-0 flex-1");
+            cell.append(createElementWithClass("div", "h-1 rounded-full bg-primary/40"), createElementWithClass("div", "truncate pt-1.5 text-xs text-muted-foreground", step.label));
+            row.append(cell);
+        }
+        dom.append(row);
+        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) {
@@ -125,6 +148,8 @@ export function createDocumentEditorExtensions(labels) {
                 return labels.blockLabels
                     ? DocumentButton.extend({ addNodeView: () => createButtonView(labels.button ?? "") })
                     : extension;
+            case DocumentSteps.name:
+                return DocumentSteps.extend({ addNodeView: () => createStepsView(labels) });
             case DocumentPageBreak.name:
                 return DocumentPageBreak.extend({
                     addNodeView: () => createPageBreakView(labels.pageBreak),

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

@@ -13,5 +13,9 @@ export const DocumentBlocksContext = createContext(undefined);
 export function DocumentContentEditor(props) {
     const contextBlocks = useContext(DocumentBlocksContext);
     const editorProps = props.blocks === undefined ? { ...props, blocks: contextBlocks } : 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, { ...editorProps }) }));
+    return (_jsx(Suspense
+    // Read-only without chips: a textarea would insert {{name}} text and plaintext into a document body.
+    , { 
+        // Read-only without chips: a textarea would insert {{name}} text and plaintext into a document body.
+        fallback: _jsx(TextareaContentEditor, { id: props.id, value: props.value, onChange: props.onChange, variables: [], readOnly: true }), children: _jsx(LazyDocumentTiptapEditor, { ...editorProps }) }));
 }

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

@@ -10,10 +10,11 @@ import { cn } from "@cosmicdrift/kumiko-renderer-web";
 import { isOneOf } from "@cosmicdrift/kumiko-types/type-guards";
 import { EditorContent, useEditor, useEditorState } from "@tiptap/react";
 import { BubbleMenu } from "@tiptap/react/menus";
-import { AlignCenter, AlignJustify, AlignLeft, AlignRight, Bold as BoldIcon, Braces, ChevronDown, Image as ImageIcon, Italic as ItalicIcon, Link as LinkIcon, List, ListOrdered, Minus, MousePointerClick, Repeat, Scissors, Table as TableIcon, Underline as UnderlineIcon, } from "lucide-react";
+import { AlignCenter, AlignJustify, AlignLeft, AlignRight, Bold as BoldIcon, Braces, ChevronDown, Image as ImageIcon, Italic as ItalicIcon, Link as LinkIcon, List, ListChecks, ListOrdered, Minus, MousePointerClick, Repeat, Scissors, Table as TableIcon, Underline as UnderlineIcon, } from "lucide-react";
 import { Fragment, useEffect, useMemo, useState } from "react";
 import { createPortal } from "react-dom";
 import { DOCUMENT_TEXT_ALIGNMENTS, isAllowedDocumentLinkHref, isDocumentPlaceholderHref, isDocumentReferenceName, isDocumentResourceKey, } from "../document-schema.js";
+import { parseDocumentStepsInput } from "../document-steps.js";
 import { createDocumentEditorExtensions, DOCUMENT_BLOCK_ATTRIBUTE, } from "./document-editor-extensions.js";
 import { MAIL_DOCUMENT_BLOCKS, } from "./document-toolbar-blocks.js";
 import { createEditorHandle } from "./editor-handle.js";
@@ -33,6 +34,7 @@ const BLOCK_PANEL = {
     button: "button",
     repeat: "repeat",
     align: "align",
+    steps: "steps",
 };
 const ALIGNMENT_ICONS = {
     left: _jsx(AlignLeft, { size: 16 }),
@@ -185,6 +187,7 @@ function InsertPanel({ editor, editorId, kind, variables, onClose }) {
     const [resource, setResource] = useState("");
     const [alt, setAlt] = useState("");
     const [buttonText, setButtonText] = useState(() => t("template-resolver.documentEditor.buttonDefaultText"));
+    const [stepsText, setStepsText] = useState(() => t("template-resolver.documentEditor.stepsDefault"));
     const [chosenName, setChosenName] = useState("");
     const [error, setError] = useState(null);
     const referenceNames = variables.filter(isDocumentReferenceName);
@@ -231,7 +234,15 @@ function InsertPanel({ editor, editorId, kind, variables, onClose }) {
         }
         insertAndClose({ type: "resource", attrs: { resource, alt: alt || null } });
     };
-    const needsVariables = kind === "button" || kind === "repeat" || kind === "placeholder";
+    const submitSteps = () => {
+        const steps = parseDocumentStepsInput(stepsText);
+        if (steps === null) {
+            setError(t("template-resolver.documentEditor.invalidSteps"));
+            return;
+        }
+        insertAndClose({ type: "steps", attrs: { variable: selectedName, steps } });
+    };
+    const needsVariables = kind === "button" || kind === "repeat" || kind === "placeholder" || kind === "steps";
     const noVariables = needsVariables && selectable.length === 0;
     const idPrefix = `${editorId}-panel`;
     return (_jsxs("div", { className: "flex flex-col gap-2 border-b border-input bg-muted/40 p-2", children: [noVariables && (_jsx("p", { className: "text-sm text-muted-foreground", children: t("template-resolver.documentEditor.noVariables") })), kind === "link" && (_jsx(Field, { id: `${idPrefix}-href`, label: t("template-resolver.documentEditor.linkHref"), children: _jsx(Input, { kind: "text", id: `${idPrefix}-href`, name: "href", value: href, onChange: setHref, placeholder: t("template-resolver.documentEditor.linkHrefPlaceholder") }) })), kind === "placeholder" && !noVariables && (_jsx("div", { className: "flex flex-wrap gap-1", children: _jsx(VariableChips, { variables: selectable, onInsert: (name) => insertAndClose({ type: "variable", attrs: { name } }) }) })), kind === "align" && (_jsx("div", { className: "flex flex-wrap gap-1", children: DOCUMENT_TEXT_ALIGNMENTS.map((alignment) => (_jsxs(Button, { type: "button", variant: "secondary", size: "sm", onClick: () => {
@@ -242,7 +253,7 @@ function InsertPanel({ editor, editorId, kind, variables, onClose }) {
                             .updateAttributes("heading", { textAlign: alignment })
                             .run();
                         onClose();
-                    }, children: [ALIGNMENT_ICONS[alignment], t(ALIGNMENT_LABEL_KEYS[alignment])] }, alignment))) })), kind === "image" && (_jsxs(_Fragment, { children: [_jsx(Field, { id: `${idPrefix}-resource`, label: t("template-resolver.documentEditor.resourceKey"), children: _jsx(Input, { kind: "text", id: `${idPrefix}-resource`, name: "resource", value: resource, onChange: setResource }) }), _jsx(Field, { id: `${idPrefix}-alt`, label: t("template-resolver.documentEditor.imageAlt"), children: _jsx(Input, { kind: "text", id: `${idPrefix}-alt`, name: "alt", value: alt, onChange: setAlt }) })] })), kind === "button" && !noVariables && (_jsxs(_Fragment, { children: [_jsx(NameSelect, { id: `${idPrefix}-target`, label: t("template-resolver.documentEditor.buttonTarget"), names: selectable, value: selectedName, onChange: setChosenName }), _jsx(Field, { id: `${idPrefix}-text`, label: t("template-resolver.documentEditor.buttonText"), children: _jsx(Input, { kind: "text", id: `${idPrefix}-text`, name: "text", value: buttonText, onChange: setButtonText }) })] })), kind === "repeat" && !noVariables && (_jsx(NameSelect, { id: `${idPrefix}-list`, label: t("template-resolver.documentEditor.repeatList"), names: selectable, value: selectedName, onChange: setChosenName })), error !== null && (_jsx("p", { role: "alert", className: "text-sm text-destructive", children: error })), _jsx("div", { className: "flex flex-wrap gap-2", children: _jsx(PanelActions, { onCancel: onClose, ...(kind === "link" && { onInsert: submitLink }), ...(kind === "link" &&
+                    }, children: [ALIGNMENT_ICONS[alignment], t(ALIGNMENT_LABEL_KEYS[alignment])] }, alignment))) })), kind === "image" && (_jsxs(_Fragment, { children: [_jsx(Field, { id: `${idPrefix}-resource`, label: t("template-resolver.documentEditor.resourceKey"), children: _jsx(Input, { kind: "text", id: `${idPrefix}-resource`, name: "resource", value: resource, onChange: setResource }) }), _jsx(Field, { id: `${idPrefix}-alt`, label: t("template-resolver.documentEditor.imageAlt"), children: _jsx(Input, { kind: "text", id: `${idPrefix}-alt`, name: "alt", value: alt, onChange: setAlt }) })] })), kind === "button" && !noVariables && (_jsxs(_Fragment, { children: [_jsx(NameSelect, { id: `${idPrefix}-target`, label: t("template-resolver.documentEditor.buttonTarget"), names: selectable, value: selectedName, onChange: setChosenName }), _jsx(Field, { id: `${idPrefix}-text`, label: t("template-resolver.documentEditor.buttonText"), children: _jsx(Input, { kind: "text", id: `${idPrefix}-text`, name: "text", value: buttonText, onChange: setButtonText }) })] })), kind === "repeat" && !noVariables && (_jsx(NameSelect, { id: `${idPrefix}-list`, label: t("template-resolver.documentEditor.repeatList"), names: selectable, value: selectedName, onChange: setChosenName })), kind === "steps" && !noVariables && (_jsxs(_Fragment, { children: [_jsx(NameSelect, { id: `${idPrefix}-steps-variable`, label: t("template-resolver.documentEditor.stepsVariable"), names: selectable, value: selectedName, onChange: setChosenName }), _jsx(Field, { id: `${idPrefix}-steps-list`, label: t("template-resolver.documentEditor.stepsList"), children: _jsx(Input, { kind: "text", id: `${idPrefix}-steps-list`, name: "steps", value: stepsText, onChange: setStepsText }) })] })), error !== null && (_jsx("p", { role: "alert", className: "text-sm text-destructive", children: error })), _jsx("div", { className: "flex flex-wrap gap-2", children: _jsx(PanelActions, { onCancel: onClose, ...(kind === "link" && { onInsert: submitLink }), ...(kind === "link" &&
                         editor.isActive("link") && {
                         onRemoveLink: () => {
                             editor.chain().focus().extendMarkRange("link").unsetLink().run();
@@ -256,7 +267,7 @@ function InsertPanel({ editor, editorId, kind, variables, onClose }) {
                             content: buttonText ? [{ type: "text", text: buttonText }] : [],
                         }),
                     }), ...(kind === "repeat" &&
-                        !noVariables && { onInsert: () => insertAndClose(repeatTableContent(selectedName)) }) }) })] }));
+                        !noVariables && { onInsert: () => insertAndClose(repeatTableContent(selectedName)) }), ...(kind === "steps" && !noVariables && { onInsert: submitSteps }) }) })] }));
 }
 export default function DocumentTiptapEditor({ id, value, onChange, variables, readOnly, blocks = MAIL_DOCUMENT_BLOCKS, variableLabels = NO_LABELS, systemVariables = NO_NAMES, resourcePreviews = NO_PREVIEWS, chrome = "default", toolbar = "full", renderPaper, toolbarHost, onEditorReady, }) {
     const t = useTranslation();
@@ -272,6 +283,7 @@ export default function DocumentTiptapEditor({ id, value, onChange, variables, r
     const imageBlockLabel = t("template-resolver.documentEditor.imageBlock");
     const pageBreakLabel = t("template-resolver.documentEditor.pageBreak");
     const buttonLabel = t("template-resolver.documentEditor.button");
+    const stepsLabel = t("template-resolver.documentEditor.steps");
     const stableLabels = useStableByKey(variableLabels, JSON.stringify(variableLabels));
     const stableSystem = useStableByKey(systemVariables, systemVariables.join("\n"));
     const stablePreviews = useStableByKey(resourcePreviews, previewsKey(resourcePreviews));
@@ -280,6 +292,7 @@ export default function DocumentTiptapEditor({ id, value, onChange, variables, r
         image: imageLabel,
         pageBreak: pageBreakLabel,
         button: buttonLabel,
+        steps: stepsLabel,
         imageBlock: imageBlockLabel,
         variableLabels: stableLabels,
         systemVariables: stableSystem,
@@ -291,6 +304,7 @@ export default function DocumentTiptapEditor({ id, value, onChange, variables, r
         imageBlockLabel,
         pageBreakLabel,
         buttonLabel,
+        stepsLabel,
         stableLabels,
         stableSystem,
         stablePreviews,
@@ -308,6 +322,7 @@ export default function DocumentTiptapEditor({ id, value, onChange, variables, r
         immediatelyRender: false,
         editorProps: { attributes: { id } },
         onCreate: ({ editor: created }) => onEditorReady?.(createEditorHandle(created)),
+        onDestroy: () => onEditorReady?.(null),
         onUpdate: ({ editor: e }) => onChange(e.getHTML()),
     }, [extensions]);
     // @tiptap/react v3 does not re-render on selection-only transactions, so
@@ -344,18 +359,25 @@ export default function DocumentTiptapEditor({ id, value, onChange, variables, r
     });
     // The entry loads asynchronously, so `value` arrives after useEditor read
     // its initial content; the guard keeps in-flight typing from being clobbered.
+    // When `extensions` change, useEditor's own effect destroys this render's
+    // editor earlier in the same commit (a late validate result in the layout
+    // editor does that); reading it then throws and unmounts the whole app. The
+    // replacement editor re-renders and syncs `value` itself.
     // kumiko-lint-ignore no-raw-hooks DOM integration: syncs the controlled value into the imperative tiptap editor
     useEffect(() => {
-        if (editor && value !== editor.getHTML()) {
+        if (editor && !editor.isDestroyed && value !== editor.getHTML()) {
             editor.commands.setContent(value, { emitUpdate: false });
         }
     }, [value, editor]);
     // kumiko-lint-ignore no-raw-hooks DOM integration: tiptap exposes editability only imperatively via setEditable
     useEffect(() => {
-        editor?.setEditable(!readOnly);
+        // setEditable emits "update" by default, which would report the mount as an edit.
+        if (editor && !editor.isDestroyed)
+            editor.setEditable(!readOnly, false);
     }, [readOnly, editor]);
+    // Read-only without chips: a textarea would insert {{name}} text and plaintext into a document body.
     if (!editor)
-        return (_jsx(TextareaContentEditor, { id: id, value: value, onChange: onChange, variables: variables, readOnly: readOnly }));
+        return (_jsx(TextareaContentEditor, { id: id, value: value, onChange: onChange, variables: [], readOnly: true }));
     const togglePanel = (kind) => setOpenPanel((current) => (current === kind ? null : kind));
     const setBlockStyle = (style) => {
         if (!isParagraphStyle(style))
@@ -391,6 +413,7 @@ export default function DocumentTiptapEditor({ id, value, onChange, variables, r
         repeat: { label: t("template-resolver.documentEditor.repeat"), icon: _jsx(Repeat, { size: 16 }) },
         pageBreak: { label: pageBreakLabel, icon: _jsx(Scissors, { size: 16 }) },
         align: { label: t("template-resolver.documentEditor.align"), icon: _jsx(AlignLeft, { size: 16 }) },
+        steps: { label: stepsLabel, icon: _jsx(ListChecks, { size: 16 }) },
     };
     const repeatTable = activeState?.repeatTable ?? null;
     const repeatListLabel = repeatTable !== null && repeatTable.lists.length === 1

package/dist/template-resolver/web/document-toolbar-blocks.d.ts

@@ -1,6 +1,6 @@
 import type { ContentEditorProps } from "@cosmicdrift/kumiko-renderer";
 import type { ReactNode } from "react";
-export type DocumentToolbarBlock = "image" | "table" | "button" | "divider" | "repeat" | "pageBreak" | "align";
+export type DocumentToolbarBlock = "image" | "table" | "button" | "divider" | "repeat" | "pageBreak" | "align" | "steps";
 /** Imperative access for an outside panel (placeholder list, resource list). */
 export type DocumentEditorHandle = {
     readonly insertPlaceholder: (name: string) => void;
@@ -32,10 +32,10 @@ export type DocumentEditorProps = ContentEditorProps & {
     /** Canvas only: renders the toolbar (and its insert panel) into this element instead of above the editor;
      *  null renders none. Lets several region editors share one toolbar that follows the focused one. */
     readonly toolbarHost?: HTMLElement | null;
-    /** Called with the handle once the editor exists and with null when it is destroyed. */
-    readonly onEditorReady?: (handle: DocumentEditorHandle) => void;
+    /** 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. */
+    readonly onEditorReady?: (handle: DocumentEditorHandle | null) => void;
 };
-export declare const MAIL_DOCUMENT_BLOCKS: readonly ["image", "table", "button", "divider", "repeat"];
-export declare const PDF_DOCUMENT_BLOCKS: readonly ["align", "image", "table", "divider", "repeat", "pageBreak"];
+export declare const MAIL_DOCUMENT_BLOCKS: readonly ["image", "table", "button", "divider", "repeat", "steps"];
+export declare const PDF_DOCUMENT_BLOCKS: readonly ["align", "image", "table", "divider", "repeat", "steps", "pageBreak"];
 /** Block set for a template-resource kind; every kind except "document-pdf" gets the mail set. */
 export declare function documentBlocksForKind(kind: string | undefined): readonly DocumentToolbarBlock[];

package/dist/template-resolver/web/document-toolbar-blocks.js

@@ -4,6 +4,7 @@ export const MAIL_DOCUMENT_BLOCKS = [
     "button",
     "divider",
     "repeat",
+    "steps",
 ];
 export const PDF_DOCUMENT_BLOCKS = [
     "align",
@@ -11,6 +12,7 @@ export const PDF_DOCUMENT_BLOCKS = [
     "table",
     "divider",
     "repeat",
+    "steps",
     "pageBreak",
 ];
 /** Block set for a template-resource kind; every kind except "document-pdf" gets the mail set. */

package/dist/template-resolver/web/i18n.js

@@ -39,6 +39,11 @@ export const defaultTranslations = {
         "template-resolver.documentEditor.removeLink": "Remove link",
         "template-resolver.documentEditor.repeat": "Repeat",
         "template-resolver.documentEditor.repeatList": "List to repeat",
+        "template-resolver.documentEditor.steps": "Steps",
+        "template-resolver.documentEditor.stepsVariable": "Current step from",
+        "template-resolver.documentEditor.stepsList": "Steps, separated by commas (value=label)",
+        "template-resolver.documentEditor.stepsDefault": "reported=Reported, investigating=Investigating, resolved=Resolved",
+        "template-resolver.documentEditor.invalidSteps": "Enter 1 to 8 different steps; values use letters, digits, - and _.",
         "template-resolver.documentEditor.resourceKey": "Resource key",
         "template-resolver.documentEditor.table": "Table",
         "template-resolver.editor.titleLabel": "Title",

package/dist/template-resolver/web/index.d.ts

@@ -1,3 +1,4 @@
+export { MAIL_TONES, type MailTone } from "../mail-constants.js";
 export { PDF_DEFAULT_MARGIN_MM, PDF_FOOTER_MARGIN_MM, PDF_HEADER_MARGIN_MM, PDF_ORIENTATIONS, PDF_PAGE_FORMATS, } from "../pdf-constants.js";
 export { TemplateResolverErrors, TemplateResolverHandlers, TemplateResolverQueries, } from "../qualified-names.js";
 export { textBlocksClient } from "./client-plugin.js";

package/dist/template-resolver/web/index.js

@@ -4,6 +4,7 @@
 // — the server side (defineFeature) lives in
 // `@cosmicdrift/kumiko-bundled-features/template-resolver` and has no React or
 // DOM deps.
+export { MAIL_TONES } from "../mail-constants.js";
 export { PDF_DEFAULT_MARGIN_MM, PDF_FOOTER_MARGIN_MM, PDF_HEADER_MARGIN_MM, PDF_ORIENTATIONS, PDF_PAGE_FORMATS, } from "../pdf-constants.js";
 export { TemplateResolverErrors, TemplateResolverHandlers, TemplateResolverQueries, } from "../qualified-names.js";
 export { textBlocksClient } from "./client-plugin.js";

package/dist/template-resolver/web/placeholder-line-editor.d.ts

@@ -11,7 +11,9 @@ export type PlaceholderLineEditorProps = {
     readonly readOnly?: boolean;
     /** Drops the input frame so the line sits flat inside a label/value row. */
     readonly flat?: boolean;
-    readonly onEditorReady?: (handle: DocumentEditorHandle) => void;
+    /** Hint shown while the line is empty. */
+    readonly placeholder?: string;
+    readonly onEditorReady?: (handle: DocumentEditorHandle | null) => void;
     readonly "aria-label": string;
 };
-export default function PlaceholderLineEditor({ id, value, onChange, variableLabels, systemVariables, readOnly, flat, onEditorReady, "aria-label": ariaLabel, }: PlaceholderLineEditorProps): ReactNode;
+export default function PlaceholderLineEditor({ id, value, onChange, variableLabels, systemVariables, readOnly, flat, placeholder, onEditorReady, "aria-label": ariaLabel, }: PlaceholderLineEditorProps): ReactNode;

package/dist/template-resolver/web/placeholder-line-editor.js

@@ -6,7 +6,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 // as chips while editing. Lives in the same lazy chunk as the document editor.
 import { cn } from "@cosmicdrift/kumiko-renderer-web";
 import { Extension, Node } from "@tiptap/core";
-import { UndoRedo } from "@tiptap/extensions";
+import { Placeholder, UndoRedo } from "@tiptap/extensions";
 import { EditorContent, useEditor } from "@tiptap/react";
 import StarterKit from "@tiptap/starter-kit";
 import { useMemo, useState } from "react";
@@ -25,7 +25,7 @@ const BlockLineBreaks = Extension.create({
 });
 const NO_LABELS = {};
 const NO_NAMES = [];
-function LineEditorBody({ id, initialValue, onChange, variableLabels, systemVariables, readOnly, flat, onEditorReady, ariaLabel, }) {
+function LineEditorBody({ id, initialValue, onChange, variableLabels, systemVariables, readOnly, flat, placeholder, onEditorReady, ariaLabel, }) {
     const extensions = useMemo(() => [
         LineDocument,
         StarterKit.configure({
@@ -55,7 +55,8 @@ function LineEditorBody({ id, initialValue, onChange, variableLabels, systemVari
         }),
         UndoRedo,
         BlockLineBreaks,
-    ], [variableLabels, systemVariables, flat]);
+        ...(placeholder === undefined ? [] : [Placeholder.configure({ placeholder })]),
+    ], [variableLabels, systemVariables, flat, placeholder]);
     const editor = useEditor({
         extensions,
         content: {
@@ -71,11 +72,12 @@ function LineEditorBody({ id, initialValue, onChange, variableLabels, systemVari
             transformPastedHTML: (html) => singleLine(html.replace(/<[^>]*>/g, " ")),
         },
         onCreate: ({ editor: created }) => onEditorReady?.(createEditorHandle(created)),
+        onDestroy: () => onEditorReady?.(null),
         onUpdate: ({ editor: e }) => onChange(contentToLine(e.getJSON().content?.[0]?.content)),
     });
-    return (_jsx(EditorContent, { editor: editor, className: cn("flex items-center bg-transparent text-base md:text-sm", flat ? "min-h-10" : "min-h-9 rounded-md border border-input px-3", "[&_.ProseMirror]:w-full [&_.ProseMirror]:whitespace-nowrap [&_.ProseMirror]:outline-none", "[&_p]:m-0", readOnly && "opacity-60") }));
+    return (_jsx(EditorContent, { editor: editor, className: cn("flex items-center bg-transparent text-base md:text-sm", flat ? "min-h-10" : "min-h-9 rounded-md border border-input px-3", "[&_.ProseMirror]:w-full [&_.ProseMirror]:whitespace-nowrap [&_.ProseMirror]:outline-none", "[&_p]:m-0", "[&_.is-editor-empty]:before:pointer-events-none [&_.is-editor-empty]:before:float-left [&_.is-editor-empty]:before:h-0 [&_.is-editor-empty]:before:text-muted-foreground [&_.is-editor-empty]:before:content-[attr(data-placeholder)]", readOnly && "opacity-60") }));
 }
-export default function PlaceholderLineEditor({ id, value, onChange, variableLabels = NO_LABELS, systemVariables = NO_NAMES, readOnly = false, flat = false, onEditorReady, "aria-label": ariaLabel, }) {
+export default function PlaceholderLineEditor({ id, value, onChange, variableLabels = NO_LABELS, systemVariables = NO_NAMES, readOnly = false, flat = false, placeholder, onEditorReady, "aria-label": ariaLabel, }) {
     const stableLabels = useStableByKey(variableLabels, JSON.stringify(variableLabels));
     const stableSystem = useStableByKey(systemVariables, systemVariables.join("\n"));
     // The text is the source of truth. Typing reports it through onChange and
@@ -90,5 +92,5 @@ export default function PlaceholderLineEditor({ id, value, onChange, variableLab
     return (_jsx(LineEditorBody, { id: id, initialValue: value, onChange: (next) => {
             setEmitted(next);
             onChange(next);
-        }, variableLabels: stableLabels, systemVariables: stableSystem, readOnly: readOnly, flat: flat, onEditorReady: onEditorReady, ariaLabel: ariaLabel }, `${epoch}-${readOnly}-${JSON.stringify(stableLabels)}`));
+        }, variableLabels: stableLabels, systemVariables: stableSystem, readOnly: readOnly, flat: flat, placeholder: placeholder, onEditorReady: onEditorReady, ariaLabel: ariaLabel }, `${epoch}-${readOnly}-${JSON.stringify(stableLabels)}-${stableSystem.join("\n")}`));
 }

package/dist/tenant/handlers/update-member-roles.write.js

@@ -21,9 +21,6 @@ function resolveTargetTenantId(isSystem, payloadTenantId, sessionTenantId) {
         return sessionTenantId;
     return parseTenantId(payloadTenantId) ?? undefined;
 }
-function foreignStreamTenant(user, targetTenantId) {
-    return targetTenantId === user.tenantId ? undefined : targetTenantId;
-}
 // Editing your OWN roles keeps the current session: roles are re-derived per
 // request, so the new roles apply at once without a re-login. Other sessions
 // of that user and any foreign edit still revoke all.
@@ -123,13 +120,13 @@ export const updateMemberRolesWrite = defineWriteHandler({
             await ctx.writeAs(createSystemUser(targetTenantId), REVOKE_ALL_SESSIONS_QN, revokeSessionsPayload(event.payload.userId, targetTenantId, event.user));
         }
         // The membership stream lives on the membership's tenant (where seedTenantMembership/
-        // invite-accept wrote it); a cross-tenant operator addresses it without becoming a member.
-        // Same-tenant writes run on a tenant-mode db, which refuses a stream override.
+        // invite-accept wrote it); streamTenantId addresses it with the operator as actor, also
+        // without membership there.
         const result = await executor.update({
             id: row["id"], // @cast-boundary db-row
             version: row["version"], // @cast-boundary db-row
             changes: { roles: JSON.stringify(nextRoles) },
-        }, event.user, db, { streamTenantId: foreignStreamTenant(event.user, targetTenantId) });
+        }, event.user, db, { streamTenantId: targetTenantId });
         return withResponseData(result, {
             ...event.payload,
             roles: nextRoles,

package/dist/tenant/seeding.js

@@ -42,6 +42,26 @@ const tenantExecutor = createEventStoreExecutor(tenantTable, tenantEntity, {
 const executor = createEventStoreExecutor(tenantMembershipsTable, tenantMembershipEntity, {
     entityName: "tenant-membership",
 });
+function buildSeedHookNotify(context, scopedUser, targetTenantId, notifyTiming) {
+    const notifyFactory = context._notifyFactory;
+    if (!notifyFactory)
+        return context.notify;
+    const notifyAfterCommit = (context._notifyAfterCommitFactory ?? notifyFactory)(scopedUser, targetTenantId);
+    if (notifyTiming === "inline")
+        return notifyAfterCommit;
+    // Still inside the caller's write tx: delivery DB work must not wait for an app-pool slot.
+    const notifyInsideTransaction = (context._notifyInTransactionFactory ?? notifyFactory)(scopedUser, targetTenantId);
+    const scheduleAfterCommit = context.scheduleAfterCommit;
+    if (!scheduleAfterCommit)
+        return notifyInsideTransaction;
+    return createDeferringNotify({
+        registry: context.registry,
+        tenantId: targetTenantId,
+        notifyAfterCommit,
+        notifyNow: notifyInsideTransaction,
+        scheduleAfterCommit,
+    });
+}
 // Shared by seedTenant/seedTenantMembership/auth-email-password's
 // seedUserWithPassword: fires the same entity-scoped postSave hooks the
 // real dispatcher would (registry.getEntityPostSaveHooks by entityName),
@@ -61,26 +81,6 @@ const executor = createEventStoreExecutor(tenantMembershipsTable, tenantMembersh
 // (HandlerContext from a live write), afterCommit hooks are queued onto the
 // dispatcher's sink and flush post-commit. Without a sink (fixture / plain
 // Connection) they still fire immediately — there is no outer TX to wait for.
-//
-function buildSeedHookNotify(context, scopedUser, targetTenantId, notifyTiming) {
-    const notifyFactory = context._notifyFactory;
-    if (!notifyFactory)
-        return context.notify;
-    if (notifyTiming === "inline")
-        return notifyFactory(scopedUser, targetTenantId);
-    // Still inside the caller's write tx: delivery DB work must not wait for an app-pool slot.
-    const notifyInsideTransaction = (context._notifyInTransactionFactory ?? notifyFactory)(scopedUser, targetTenantId);
-    const scheduleAfterCommit = context.scheduleAfterCommit;
-    if (!scheduleAfterCommit)
-        return notifyInsideTransaction;
-    return createDeferringNotify({
-        registry: context.registry,
-        tenantId: targetTenantId,
-        notifyAfterCommit: notifyFactory(scopedUser, targetTenantId),
-        notifyNow: notifyInsideTransaction,
-        scheduleAfterCommit,
-    });
-}
 // `runner` comes from the caller, which already holds a declared DbRunner —
 // a TenantDb exposes no runner back out to feature code.
 function scopeSeedHookContext(context, targetTenantId, runner, 
@@ -132,11 +132,10 @@ target) {
     const scopedContext = target === undefined
         ? hooks.context
         : scopeSeedHookContext(hooks.context, target.tenantId, target.db, "deferUntilCommit");
-    const afterCommitContext = target === undefined
-        ? hooks.context
-        : scopeSeedHookContext(hooks.context, target.tenantId, target.db, "inline");
     await lifecycle.runPostSave(pseudoType, entityData, scopedContext, HookPhases.inTransaction);
-    const runAfterCommit = () => lifecycle.runPostSave(pseudoType, entityData, afterCommitContext, HookPhases.afterCommit);
+    const runAfterCommit = () => lifecycle.runPostSave(pseudoType, entityData, target === undefined
+        ? hooks.context
+        : scopeSeedHookContext(hooks.context, target.tenantId, target.db, "inline"), HookPhases.afterCommit);
     if (scopedContext.scheduleAfterCommit) {
         scopedContext.scheduleAfterCommit(runAfterCommit);
     }

package/dist/tenant-handover/move-entity-graph.js

@@ -21,7 +21,7 @@
 // child entity, kumiko-framework#3035's named-error requirement), the WHOLE
 // transaction — root row included — rolls back, so a caller can safely
 // retry the same token after fixing the app's `transferable` declarations.
-import { entityTableFromRegistry, executeRawQuery, extractTableName, physicalColumnName, } from "@cosmicdrift/kumiko-framework/db";
+import { entityTableFromRegistry, executeRawQuery, extractTableName, physicalColumnName, toPostgresArrayLiteral, } from "@cosmicdrift/kumiko-framework/db";
 import { MAX_TRANSFER_DEPTH } from "@cosmicdrift/kumiko-framework/engine";
 import { UnprocessableError } from "@cosmicdrift/kumiko-framework/errors";
 import { transferAggregateStreams } from "@cosmicdrift/kumiko-framework/event-store";
@@ -47,7 +47,12 @@ async function moveFileRefs(args) {
     if (args.entityIds.length === 0)
         return 0;
     const rows = await executeRawQuery(args.db, `UPDATE ${FILE_REFS_TABLE} SET tenant_id = $1 ` +
-        `WHERE tenant_id = $2 AND entity_type = $3 AND entity_id = ANY($4) RETURNING id`, [args.destinationTenantId, args.sourceTenantId, args.entityType, args.entityIds]);
+        `WHERE tenant_id = $2 AND entity_type = $3 AND entity_id = ANY($4) RETURNING id`, [
+        args.destinationTenantId,
+        args.sourceTenantId,
+        args.entityType,
+        toPostgresArrayLiteral(args.entityIds),
+    ]);
     const movedIds = rows.map((row) => row.id);
     if (movedIds.length === 0)
         return 0;
@@ -78,7 +83,12 @@ async function moveFileRefs(args) {
 async function moveChildRows(args) {
     const rows = await executeRawQuery(args.db, `UPDATE "${args.tableName}" SET "${args.tenantCol}" = $1 ` +
         `WHERE "${args.typeCol}" = $2 AND "${args.idCol}" = ANY($3) AND "${args.tenantCol}" = $4 ` +
-        `RETURNING "${args.pkCol}" AS id`, [args.destinationTenantId, args.parentEntityType, args.parentRowIds, args.sourceTenantId]);
+        `RETURNING "${args.pkCol}" AS id`, [
+        args.destinationTenantId,
+        args.parentEntityType,
+        toPostgresArrayLiteral(args.parentRowIds),
+        args.sourceTenantId,
+    ]);
     return rows.map((row) => row.id);
 }
 // A `reference` field names its target entity in the schema, so unlike a
@@ -87,7 +97,7 @@ async function moveChildRows(args) {
 async function moveReferencedChildRows(args) {
     const rows = await executeRawQuery(args.db, `UPDATE "${args.tableName}" SET "${args.tenantCol}" = $1 ` +
         `WHERE "${args.refCol}" = ANY($2) AND "${args.tenantCol}" = $3 ` +
-        `RETURNING "${args.pkCol}" AS id`, [args.destinationTenantId, args.parentRowIds, args.sourceTenantId]);
+        `RETURNING "${args.pkCol}" AS id`, [args.destinationTenantId, toPostgresArrayLiteral(args.parentRowIds), args.sourceTenantId]);
     return rows.map((row) => row.id);
 }
 // Resolves one edge against the ids its parent type just moved, and reports

package/dist/tenant-lifecycle/run-tenant-destroy.d.ts

@@ -20,6 +20,7 @@ export declare function runNextDestructionStage(args: {
     readonly escapeHatchAuditSink?: EscapeHatchAuditSink;
     readonly escapeHatchAuditLog?: Logger;
     readonly actor?: string;
+    readonly deadlineAt?: number;
 }): Promise<StageTickResult>;
 export declare function hasTenantDestructionWork(reads: Pick<TenantDb, "count">, now: Temporal.Instant): Promise<boolean>;
 /** Cron entry: start destruction for tenants past grace, then advance stages. */

package/dist/tenant-lifecycle/run-tenant-destroy.js

@@ -164,7 +164,7 @@ export async function runNextDestructionStage(args) {
         escapeHatchAuditSink: args.escapeHatchAuditSink,
         escapeHatchAuditLog: args.escapeHatchAuditLog,
         actor: args.actor,
-        deadlineAt: Date.now() + DESTRUCTION_STAGE_TICK_BUDGET_MS,
+        deadlineAt: args.deadlineAt ?? Date.now() + DESTRUCTION_STAGE_TICK_BUDGET_MS,
     };
     let version = lastEventVersion(events);
     if (!isStageContinuation(events, next.name)) {
@@ -249,9 +249,16 @@ export async function runTenantDestructionSweep(args) {
     }
     let advanced = 0;
     const destroying = await selectMany(args.db, tenantTable, destroyingWhere);
+    // One budget per sweep tick, split evenly so a large tenant cannot eat the
+    // window and starve the ones behind it. Each slice starts when its tenant
+    // starts: anchoring to a shared tick deadline would hand tenants after an
+    // overrun a zero slice, and a no-progress stage counts as a failed attempt.
+    const sliceMs = DESTRUCTION_STAGE_TICK_BUDGET_MS / Math.max(1, destroying.length);
     for (const row of destroying) {
+        const tenantDeadlineAt = Date.now() + sliceMs;
         try {
             const result = await runNextDestructionStage({
+                deadlineAt: tenantDeadlineAt,
                 db: args.db,
                 registry: args.registry,
                 tenantId: row.id,

package/dist/tenant-lifecycle/stages.js

@@ -13,8 +13,9 @@ const tenantCrud = createEventStoreExecutor(tenantTable, tenantEntity, { entityN
 const tenantMembershipCrud = createEventStoreExecutor(tenantMembershipsTable, tenantMembershipEntity, {
     entityName: "tenant-membership",
 });
-// Every hook still runs each tick (they are idempotent), so a later hook is not
-// starved by an earlier one that keeps reporting done:false.
+// Every hook runs each tick (they are idempotent) but all share one ctx.deadlineAt: an
+// earlier hook that keeps reporting done:false can use up the budget, so later chunking
+// hooks time out with nothing processed until it finishes.
 function newOutcomeAccumulator() {
     let allDone = true;
     let processed = 0;

package/dist/tier-engine/constants.d.ts

@@ -9,6 +9,8 @@ export declare const TierAssignmentSources: {
     readonly billing: "billing";
     readonly default: "default";
 };
+export type TierAssignmentSource = (typeof TierAssignmentSources)[keyof typeof TierAssignmentSources];
+export declare function isTierAssignmentSource(value: unknown): value is TierAssignmentSource;
 export declare const TierEngineQueries: {
     readonly list: "tier-engine:query:tier-assignment:list";
     readonly getActiveTier: "tier-engine:query:get-active-tier";

package/dist/tier-engine/constants.js

@@ -19,6 +19,10 @@ export const TierAssignmentSources = {
     billing: "billing",
     default: "default",
 };
+const TIER_ASSIGNMENT_SOURCE_VALUES = Object.values(TierAssignmentSources);
+export function isTierAssignmentSource(value) {
+    return typeof value === "string" && TIER_ASSIGNMENT_SOURCE_VALUES.includes(value);
+}
 // Qualified query handler names.
 export const TierEngineQueries = {
     list: "tier-engine:query:tier-assignment:list",