@singleton-sd/post-kit-editor 0.5.0 → 0.7.0

package/README.md

@@ -25,14 +25,25 @@ import {
   EmailTemplateEditor,
   type TemplateSourceFiles,
   type SerializedTemplateSource,
+  type ValidationIssue,
 } from '@singleton-sd/post-kit-editor';
 
-export function TemplateAdminPage({ template }: { template: TemplateSourceFiles }) {
+export function TemplateAdminPage({
+  template,
+  loading,
+  loadError,
+}: {
+  template: TemplateSourceFiles;
+  loading?: boolean;
+  loadError?: string;
+}) {
   return (
     <EmailTemplateEditor
       template={template}
       availableVariables={[{ name: 'name', description: 'Recipient display name' }]}
-      onSave={async (serialized, files) => {
+      loading={loading}
+      loadError={loadError}
+      onSave={async (serialized: SerializedTemplateSource, files: TemplateSourceFiles) => {
         // Commit serialized.templateJson / metadataJson / previewJson to the
         // consumer repository (e.g. via the app's own server endpoint).
         const res = await fetch('/api/templates', {
@@ -47,10 +58,9 @@ export function TemplateAdminPage({ template }: { template: TemplateSourceFiles
       }}
       onSendTest={async (serialized, _files, recipient) => {
         // Browser → your trusted server only. The server uses
-        // @singleton-sd/post-kit-client with POSTKIT_API_KEY from Azure Key
-        // Vault `ssd-global-kv-prod-ae` (production). Local `.env` is for
-        // development only — never embed a long-lived PostKit API key in
-        // browser code.
+        // @singleton-sd/post-kit-client with secrets from Azure Key Vault
+        // (production) or local `.env` (development). Never embed a
+        // long-lived PostKit API key in browser code.
         const res = await fetch('/api/templates/send-test', {
           method: 'POST',
           headers: { 'Content-Type': 'application/json' },
@@ -63,6 +73,9 @@ export function TemplateAdminPage({ template }: { template: TemplateSourceFiles
       onDirtyChange={(dirty) => {
         // Optional: guard in-app navigation while dirty.
       }}
+      onValidationChange={(issues: ValidationIssue[]) => {
+        // Optional: mirror validation in the host chrome.
+      }}
       onPreviewRendered={(html) => {
         console.log('preview bytes', html.length);
       }}
@@ -72,6 +85,39 @@ export function TemplateAdminPage({ template }: { template: TemplateSourceFiles
 }
 ```
 
+A copy-pasteable single-file integration (plus synthetic sample JSON) lives in
+[`examples/minimal/`](./examples/minimal/).
+
+## Props
+
+| Prop | Type | Required | Description |
+| --- | --- | --- | --- |
+| `template` | `TemplateSourceFiles` | yes | Seeded working triple (`templateJson`, `metadata`, `previewData`). |
+| `onSave` | `(serialized, files) => SaveResult \| void \| Promise<…>` | yes | Persist working files. Receives serialized Git strings **and** structured files. |
+| `onSendTest` | `(serialized, files, recipient) => SendTestResult \| void \| Promise<…>` | no | When set, shows Send-test chrome. Must route through the consumer’s trusted server. |
+| `availableVariables` | `TemplateVariable[]` | no | Catalogue entries offered to the editing user. |
+| `onDirtyChange` | `(dirty: boolean) => void` | no | Fires when working state diverges from the seeded `template` (resets after successful save). |
+| `onValidationChange` | `(issues: ValidationIssue[]) => void` | no | Current validation issues whenever they change. |
+| `onPreviewRendered` | `(html: string) => void` | no | Successful preview HTML (e.g. open-in-new-tab without recompiling). |
+| `loading` | `boolean` | no | Non-interactive loading shell while the host fetches files. |
+| `loadError` | `string` | no | Non-interactive error shell with the host’s message. |
+| `className` | `string` | no | Extra class on the root element. |
+
+Also exported: `loadTemplateSource`, `serializeTemplateSource`,
+`validateTemplate`, `hasValidationErrors`, `EDITOR_CLASS_PREFIX`, and related
+types.
+
+## What this package does not do
+
+- **No persistence** — it never writes to disk, Git, or object storage. `onSave`
+  is the only way contents leave the editor.
+- **No sending** — it never calls PostKit or any mail transport. `onSendTest`
+  (when provided) is a consumer callback only.
+- **No credentials** — there are no API-key / token props. Secrets stay on the
+  consumer’s trusted server (Key Vault / env), never in browser bundles.
+- **No publish pipeline** — compilation and content hashing belong to
+  `@singleton-sd/post-kit-compiler` in CI or server tooling.
+
 ## Persistence is consumer-supplied
 
 Save serializes the working state with `serializeTemplateSource()` and passes
@@ -82,12 +128,29 @@ failure messages (no unhandled rejections).
 
 Send-test chrome appears **only** when `onSendTest` is provided. The editor
 validates a non-empty, plausible recipient address, then invokes the callback
-with the same serialized payload. Test delivery must go through the consumer's
-trusted server (typically `@singleton-sd/post-kit-client` server-side).
+with the same serialized payload plus the recipient. Test delivery must go
+through the consumer's trusted server (typically `@singleton-sd/post-kit-client`
+server-side).
 
 Optional `onDirtyChange` fires when working state diverges from the seeded
 `template` prop and resets after a successful save.
 
+## Validation and accessibility
+
+`validateTemplate(files)` (also exported) checks required metadata, key charset,
+undeclared / unused variables, preview coverage, and optional `render-failed`
+from the preview pane (passed through so the compiler is not invoked twice).
+Error-severity issues disable Save and Send-test; warnings never block.
+
+Optional props:
+
+- `onValidationChange` — current `ValidationIssue[]` whenever it changes
+- `loading` — non-interactive loading shell while the host fetches files
+- `loadError` — non-interactive error shell with the host’s message
+
+Inline field errors use `aria-describedby`. The validation summary is an
+`aria-live` region; each entry focuses the responsible control.
+
 ## Preview data (synthetic only)
 
 `preview.json` is edited in the preview-data panel and used to render the
@@ -127,12 +190,16 @@ against the resulting HTML string:
 ```tsx
 import { renderToStaticMarkup } from 'react-dom/server';
 
-const html = renderToStaticMarkup(<EmailTemplateEditor template={template} onSave={() => {}} />);
+const html = renderToStaticMarkup(
+  <EmailTemplateEditor template={template} onSave={() => {}} />,
+);
 ```
 
 Specs live next to the code as `src/**/*.spec.tsx`. Behaviour that needs
 interaction is factored into pure functions (preview rows, save/send helpers)
-that can be tested without a DOM.
+that can be tested without a DOM. The end-to-end suite (`src/e2e.spec.tsx`)
+drives load → edit → validate → save / send-test through those helpers plus SSR
+markup.
 
 ## Development
 
@@ -141,3 +208,7 @@ pnpm test   # type-check + run tests
 pnpm build  # emit CommonJS to dist/
 pnpm lint   # covered by root eslint
 ```
+
+`examples/` is documentation-only: it is not listed in the package `files`
+array and is outside `src/`, so it is neither published to npm nor emitted into
+`dist/`.

package/dist/EditorErrorBoundary.d.ts

@@ -0,0 +1,15 @@
+import { Component, type ErrorInfo, type ReactNode } from 'react';
+export interface EditorErrorBoundaryProps {
+    children: ReactNode;
+}
+interface EditorErrorBoundaryState {
+    error: Error | null;
+}
+export declare class EditorErrorBoundary extends Component<EditorErrorBoundaryProps, EditorErrorBoundaryState> {
+    state: EditorErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): EditorErrorBoundaryState;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    private handleRetry;
+    render(): ReactNode;
+}
+export {};

package/dist/EditorErrorBoundary.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EditorErrorBoundary = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const email_template_editor_1 = require("./email-template-editor");
+class EditorErrorBoundary extends react_1.Component {
+    constructor() {
+        super(...arguments);
+        this.state = { error: null };
+        this.handleRetry = () => {
+            this.setState({ error: null });
+        };
+    }
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    componentDidCatch(error, info) {
+        if (typeof process !== 'undefined' && process.env.NODE_ENV !== 'test') {
+            console.error('post-kit-editor render failure', error, info.componentStack);
+        }
+    }
+    render() {
+        const p = email_template_editor_1.EDITOR_CLASS_PREFIX;
+        if (this.state.error) {
+            return ((0, jsx_runtime_1.jsxs)("div", { className: `${p}fatal-error`, "data-testid": `${p}fatal-error`, role: "alert", children: [(0, jsx_runtime_1.jsx)("h2", { className: `${p}fatal-error-heading`, children: "Editor failed to render" }), (0, jsx_runtime_1.jsx)("p", { className: `${p}fatal-error-message`, children: this.state.error.message }), (0, jsx_runtime_1.jsx)("button", { type: "button", className: `${p}fatal-error-retry`, "data-testid": `${p}fatal-error-retry`, onClick: this.handleRetry, children: "Retry" })] }));
+        }
+        return this.props.children;
+    }
+}
+exports.EditorErrorBoundary = EditorErrorBoundary;
+//# sourceMappingURL=EditorErrorBoundary.js.map

package/dist/EditorErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditorErrorBoundary.js","sourceRoot":"","sources":["../src/EditorErrorBoundary.tsx"],"names":[],"mappings":";;;;AAAA,iCAAyE;AAEzE,mEAA8D;AAc9D,MAAa,mBAAoB,SAAQ,iBAGxC;IAHD;;QAIE,UAAK,GAA6B,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAa1C,gBAAW,GAAG,GAAS,EAAE;YAC/B,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC,CAAC;IAsBJ,CAAC;IAnCC,MAAM,CAAC,wBAAwB,CAAC,KAAY;QAC1C,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,iBAAiB,CAAC,KAAY,EAAE,IAAe;QAE7C,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACtE,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAMD,MAAM;QACJ,MAAM,CAAC,GAAG,2CAAmB,CAAC;QAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,CACL,iCAAK,SAAS,EAAE,GAAG,CAAC,aAAa,iBAAe,GAAG,CAAC,aAAa,EAAE,IAAI,EAAC,OAAO,aAC7E,+BAAI,SAAS,EAAE,GAAG,CAAC,qBAAqB,wCAA8B,EACtE,8BAAG,SAAS,EAAE,GAAG,CAAC,qBAAqB,YAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,GAAK,EACvE,mCACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,GAAG,CAAC,mBAAmB,iBACrB,GAAG,CAAC,mBAAmB,EACpC,OAAO,EAAE,IAAI,CAAC,WAAW,sBAGlB,IACL,CACP,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF;AAzCD,kDAyCC"}

package/dist/canvas/EmailBuilderCanvas.js

@@ -8,8 +8,8 @@ const EditorBlock_1 = require("./EditorBlock");
 const email_builder_1 = require("@usewaypoint/email-builder");
 function EmailBuilderCanvas({ document, onChange, readOnly = false, }) {
     if (readOnly) {
-        return ((0, jsx_runtime_1.jsx)("div", { className: `${email_template_editor_1.EDITOR_CLASS_PREFIX}canvas`, "data-testid": `${email_template_editor_1.EDITOR_CLASS_PREFIX}canvas`, children: (0, jsx_runtime_1.jsx)(email_builder_1.Reader, { document: document, rootBlockId: "root" }) }));
+        return ((0, jsx_runtime_1.jsx)("div", { id: `${email_template_editor_1.EDITOR_CLASS_PREFIX}canvas`, className: `${email_template_editor_1.EDITOR_CLASS_PREFIX}canvas`, "data-testid": `${email_template_editor_1.EDITOR_CLASS_PREFIX}canvas`, role: "region", tabIndex: -1, "aria-label": "Email document canvas", children: (0, jsx_runtime_1.jsx)(email_builder_1.Reader, { document: document, rootBlockId: "root" }) }));
     }
-    return ((0, jsx_runtime_1.jsx)(editor_context_1.CanvasEditorProvider, { document: document, onChange: onChange, children: (0, jsx_runtime_1.jsx)("div", { className: `${email_template_editor_1.EDITOR_CLASS_PREFIX}canvas`, "data-testid": `${email_template_editor_1.EDITOR_CLASS_PREFIX}canvas`, children: (0, jsx_runtime_1.jsx)(EditorBlock_1.EditorBlock, { id: "root" }) }) }));
+    return ((0, jsx_runtime_1.jsx)(editor_context_1.CanvasEditorProvider, { document: document, onChange: onChange, children: (0, jsx_runtime_1.jsx)("div", { id: `${email_template_editor_1.EDITOR_CLASS_PREFIX}canvas`, className: `${email_template_editor_1.EDITOR_CLASS_PREFIX}canvas`, "data-testid": `${email_template_editor_1.EDITOR_CLASS_PREFIX}canvas`, role: "region", tabIndex: -1, "aria-label": "Email document canvas", children: (0, jsx_runtime_1.jsx)(EditorBlock_1.EditorBlock, { id: "root" }) }) }));
 }
 //# sourceMappingURL=EmailBuilderCanvas.js.map

package/dist/canvas/EmailBuilderCanvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmailBuilderCanvas.js","sourceRoot":"","sources":["../../src/canvas/EmailBuilderCanvas.tsx"],"names":[],"mappings":";;AAcA,gDAoBC;;AA/BD,oEAA+D;AAC/D,qDAAwD;AACxD,+CAA4C;AAC5C,8DAAoD;AAQpD,SAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAQ,EACR,QAAQ,GAAG,KAAK,GACQ;IACxB,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CACL,gCAAK,SAAS,EAAE,GAAG,2CAAmB,QAAQ,iBAAe,GAAG,2CAAmB,QAAQ,YACzF,uBAAC,sBAAM,IAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAC,MAAM,GAAG,GAC7C,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,uBAAC,qCAAoB,IAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,YAC1D,gCAAK,SAAS,EAAE,GAAG,2CAAmB,QAAQ,iBAAe,GAAG,2CAAmB,QAAQ,YACzF,uBAAC,yBAAW,IAAC,EAAE,EAAC,MAAM,GAAG,GACrB,GACe,CACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"EmailBuilderCanvas.js","sourceRoot":"","sources":["../../src/canvas/EmailBuilderCanvas.tsx"],"names":[],"mappings":";;AAcA,gDAkCC;;AA7CD,oEAA+D;AAC/D,qDAAwD;AACxD,+CAA4C;AAC5C,8DAAoD;AAQpD,SAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAQ,EACR,QAAQ,GAAG,KAAK,GACQ;IACxB,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CACL,gCACE,EAAE,EAAE,GAAG,2CAAmB,QAAQ,EAClC,SAAS,EAAE,GAAG,2CAAmB,QAAQ,iBAC5B,GAAG,2CAAmB,QAAQ,EAC3C,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,CAAC,CAAC,gBACD,uBAAuB,YAElC,uBAAC,sBAAM,IAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAC,MAAM,GAAG,GAC7C,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,uBAAC,qCAAoB,IAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,YAC1D,gCACE,EAAE,EAAE,GAAG,2CAAmB,QAAQ,EAClC,SAAS,EAAE,GAAG,2CAAmB,QAAQ,iBAC5B,GAAG,2CAAmB,QAAQ,EAC3C,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,CAAC,CAAC,gBACD,uBAAuB,YAElC,uBAAC,yBAAW,IAAC,EAAE,EAAC,MAAM,GAAG,GACrB,GACe,CACxB,CAAC;AACJ,CAAC"}

package/dist/editor-shell-states.d.ts

@@ -0,0 +1,8 @@
+export interface EditorLoadingStateProps {
+    message?: string;
+}
+export declare function EditorLoadingState({ message, }: EditorLoadingStateProps): JSX.Element;
+export interface EditorLoadErrorStateProps {
+    message: string;
+}
+export declare function EditorLoadErrorState({ message }: EditorLoadErrorStateProps): JSX.Element;

package/dist/editor-shell-states.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EditorLoadingState = EditorLoadingState;
+exports.EditorLoadErrorState = EditorLoadErrorState;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const email_template_editor_1 = require("./email-template-editor");
+function EditorLoadingState({ message = 'Loading template…', }) {
+    const p = email_template_editor_1.EDITOR_CLASS_PREFIX;
+    return ((0, jsx_runtime_1.jsx)("div", { className: `${p}loading`, "data-testid": `${p}loading`, role: "status", "aria-busy": "true", "aria-live": "polite", children: (0, jsx_runtime_1.jsx)("p", { className: `${p}loading-message`, children: message }) }));
+}
+function EditorLoadErrorState({ message }) {
+    const p = email_template_editor_1.EDITOR_CLASS_PREFIX;
+    return ((0, jsx_runtime_1.jsxs)("div", { className: `${p}load-error`, "data-testid": `${p}load-error`, role: "alert", children: [(0, jsx_runtime_1.jsx)("h2", { className: `${p}load-error-heading`, children: "Could not load template" }), (0, jsx_runtime_1.jsx)("p", { className: `${p}load-error-message`, children: message })] }));
+}
+//# sourceMappingURL=editor-shell-states.js.map

package/dist/editor-shell-states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-shell-states.js","sourceRoot":"","sources":["../src/editor-shell-states.tsx"],"names":[],"mappings":";;AAUA,gDAeC;AAOD,oDAQC;;AAtCD,mEAA8D;AAQ9D,SAAgB,kBAAkB,CAAC,EACjC,OAAO,GAAG,mBAAmB,GACL;IACxB,MAAM,CAAC,GAAG,2CAAmB,CAAC;IAC9B,OAAO,CACL,gCACE,SAAS,EAAE,GAAG,CAAC,SAAS,iBACX,GAAG,CAAC,SAAS,EAC1B,IAAI,EAAC,QAAQ,eACH,MAAM,eACN,QAAQ,YAElB,8BAAG,SAAS,EAAE,GAAG,CAAC,iBAAiB,YAAG,OAAO,GAAK,GAC9C,CACP,CAAC;AACJ,CAAC;AAOD,SAAgB,oBAAoB,CAAC,EAAE,OAAO,EAA6B;IACzE,MAAM,CAAC,GAAG,2CAAmB,CAAC;IAC9B,OAAO,CACL,iCAAK,SAAS,EAAE,GAAG,CAAC,YAAY,iBAAe,GAAG,CAAC,YAAY,EAAE,IAAI,EAAC,OAAO,aAC3E,+BAAI,SAAS,EAAE,GAAG,CAAC,oBAAoB,wCAA8B,EACrE,8BAAG,SAAS,EAAE,GAAG,CAAC,oBAAoB,YAAG,OAAO,GAAK,IACjD,CACP,CAAC;AACJ,CAAC"}

package/dist/email-template-editor.d.ts

@@ -1,5 +1,6 @@
-import { type SaveResult, type SendTestResult, type SerializedTemplateSource } from './save-send/types';
+import type { SaveResult, SendTestResult, SerializedTemplateSource } from './save-send/types';
 import type { TemplateSourceFiles, TemplateVariable } from './types';
+import { type ValidationIssue } from './validation/validate';
 export declare const EDITOR_CLASS_PREFIX = "pk-editor-";
 export interface EmailTemplateEditorProps {
     template: TemplateSourceFiles;
@@ -7,7 +8,10 @@ export interface EmailTemplateEditorProps {
     onSave: (serialized: SerializedTemplateSource, files: TemplateSourceFiles) => Promise<SaveResult | void> | SaveResult | void;
     onSendTest?: (serialized: SerializedTemplateSource, files: TemplateSourceFiles, recipient: string) => Promise<SendTestResult | void> | SendTestResult | void;
     onDirtyChange?: (dirty: boolean) => void;
+    onValidationChange?: (issues: ValidationIssue[]) => void;
     onPreviewRendered?: (html: string) => void;
+    loading?: boolean;
+    loadError?: string;
     className?: string;
 }
-export declare function EmailTemplateEditor({ template, availableVariables, onSave, onSendTest, onDirtyChange, onPreviewRendered, className, }: EmailTemplateEditorProps): JSX.Element;
+export declare function EmailTemplateEditor(props: EmailTemplateEditorProps): JSX.Element;

package/dist/email-template-editor.js

@@ -5,24 +5,42 @@ exports.EmailTemplateEditor = EmailTemplateEditor;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const EmailBuilderCanvas_1 = require("./canvas/EmailBuilderCanvas");
+const EditorErrorBoundary_1 = require("./EditorErrorBoundary");
+const editor_shell_states_1 = require("./editor-shell-states");
 const insertion_target_1 = require("./insertion-target");
 const MetadataPanel_1 = require("./metadata/MetadataPanel");
 const PreviewDataEditor_1 = require("./preview/PreviewDataEditor");
 const PreviewPane_1 = require("./preview/PreviewPane");
 const dirty_1 = require("./save-send/dirty");
 const SaveSendBar_1 = require("./save-send/SaveSendBar");
-const types_1 = require("./save-send/types");
+const actions_1 = require("./save-send/actions");
+const ValidationSummary_1 = require("./validation/ValidationSummary");
+const validate_1 = require("./validation/validate");
 const VariableCatalogue_1 = require("./variables/VariableCatalogue");
 const working_files_1 = require("./working-files");
 exports.EDITOR_CLASS_PREFIX = 'pk-editor-';
-function EmailTemplateEditor({ template, availableVariables, onSave, onSendTest, onDirtyChange, onPreviewRendered, className, }) {
+function EmailTemplateEditor(props) {
+    const rootClassName = [`${exports.EDITOR_CLASS_PREFIX}root`, props.className].filter(Boolean).join(' ');
+    if (props.loading) {
+        return ((0, jsx_runtime_1.jsx)("div", { className: rootClassName, "data-testid": `${exports.EDITOR_CLASS_PREFIX}root`, children: (0, jsx_runtime_1.jsx)(editor_shell_states_1.EditorLoadingState, {}) }));
+    }
+    if (props.loadError) {
+        return ((0, jsx_runtime_1.jsx)("div", { className: rootClassName, "data-testid": `${exports.EDITOR_CLASS_PREFIX}root`, children: (0, jsx_runtime_1.jsx)(editor_shell_states_1.EditorLoadErrorState, { message: props.loadError }) }));
+    }
+    return ((0, jsx_runtime_1.jsx)("div", { className: rootClassName, "data-testid": `${exports.EDITOR_CLASS_PREFIX}root`, children: (0, jsx_runtime_1.jsx)(EditorErrorBoundary_1.EditorErrorBoundary, { children: (0, jsx_runtime_1.jsx)(EmailTemplateEditorInner, { ...props }) }) }));
+}
+function EmailTemplateEditorInner({ template, availableVariables, onSave, onSendTest, onDirtyChange, onValidationChange, onPreviewRendered, }) {
     const [workingFiles, setWorkingFiles] = (0, react_1.useState)(template);
     const [seedFiles, setSeedFiles] = (0, react_1.useState)(template);
     const [saveFeedback, setSaveFeedback] = (0, react_1.useState)({ status: 'idle' });
     const [sendFeedback, setSendFeedback] = (0, react_1.useState)({ status: 'idle' });
+    const [previewResult, setPreviewResult] = (0, react_1.useState)(null);
     const onDirtyChangeRef = (0, react_1.useRef)(onDirtyChange);
     onDirtyChangeRef.current = onDirtyChange;
+    const onValidationChangeRef = (0, react_1.useRef)(onValidationChange);
+    onValidationChangeRef.current = onValidationChange;
     const lastDirtyRef = (0, react_1.useRef)(null);
+    const lastIssuesKeyRef = (0, react_1.useRef)(null);
     const templateGenerationRef = (0, react_1.useRef)(0);
     const seedFilesRef = (0, react_1.useRef)(seedFiles);
     seedFilesRef.current = seedFiles;
@@ -33,6 +51,7 @@ function EmailTemplateEditor({ template, availableVariables, onSave, onSendTest,
         templateGenerationRef.current += 1;
         setSaveFeedback({ status: 'idle' });
         setSendFeedback({ status: 'idle' });
+        setPreviewResult(null);
         setWorkingFiles(template);
         setSeedFiles(template);
     }, [template]);
@@ -44,6 +63,24 @@ function EmailTemplateEditor({ template, availableVariables, onSave, onSendTest,
         lastDirtyRef.current = dirty;
         onDirtyChangeRef.current?.(dirty);
     }, [seedFiles, workingFiles]);
+    const issues = (0, validate_1.validateTemplate)(workingFiles, {
+        renderError: previewResult && !previewResult.ok ? previewResult.error : null,
+    });
+    (0, react_1.useEffect)(() => {
+        const key = JSON.stringify(issues);
+        if (lastIssuesKeyRef.current === key) {
+            return;
+        }
+        lastIssuesKeyRef.current = key;
+        onValidationChangeRef.current?.(issues);
+    }, [issues]);
+    const previewPending = previewResult === null;
+    const validationBlocked = (0, validate_1.hasValidationErrors)(issues) || previewPending;
+    const validationBlockedReason = previewPending
+        ? 'Wait for the preview to finish before saving or sending a test.'
+        : 'Fix validation errors before saving or sending a test.';
+    const metadataIssues = issues.filter((i) => i.field === 'metadata' || i.field === 'subject');
+    const previewDataIssues = issues.filter((i) => i.field === 'previewData');
     const handleDocumentChange = (0, react_1.useCallback)((document) => {
         setWorkingFiles((current) => (0, working_files_1.withDocument)(current, document));
     }, []);
@@ -58,73 +95,79 @@ function EmailTemplateEditor({ template, availableVariables, onSave, onSendTest,
     }, []);
     const busy = saveFeedback.status === 'pending' || sendFeedback.status === 'pending';
     const handleSave = (0, react_1.useCallback)(() => {
-        if (busy) {
+        const started = (0, actions_1.startSaveAction)({
+            busy,
+            validationBlocked,
+            files: workingFiles,
+        });
+        if (started.status === 'noop') {
             return;
         }
-        let payload;
-        try {
-            payload = (0, types_1.buildSavePayload)(workingFiles);
-        }
-        catch (error) {
-            setSaveFeedback({
-                status: 'failure',
-                message: error instanceof Error ? error.message : String(error),
-            });
+        if (started.status === 'serialize-error') {
+            setSaveFeedback({ status: 'failure', message: started.message });
             return;
         }
         const generation = templateGenerationRef.current;
         setSaveFeedback({ status: 'pending' });
         void (async () => {
-            const result = await (0, types_1.invokeConsumerAction)(() => onSave(payload.serialized, payload.files));
-            if (generation !== templateGenerationRef.current) {
+            const result = await (0, actions_1.finishSaveAction)({
+                payload: started.payload,
+                isGenerationCurrent: () => generation === templateGenerationRef.current,
+                onSave,
+            });
+            if (result.status === 'stale') {
                 return;
             }
-            if (result.ok) {
-                setSeedFiles(payload.files);
+            if (result.status === 'success') {
+                setSeedFiles(result.files);
                 setSaveFeedback({ status: 'success', message: result.message });
             }
             else {
                 setSaveFeedback({
                     status: 'failure',
-                    message: result.message ?? 'Save failed.',
+                    message: result.message,
                 });
             }
         })();
-    }, [busy, onSave, workingFiles]);
+    }, [busy, onSave, validationBlocked, workingFiles]);
     const handleSendTest = (0, react_1.useCallback)((recipient) => {
-        if (busy || !onSendTest) {
+        const started = (0, actions_1.startSendTestAction)({
+            busy,
+            validationBlocked,
+            sendTestEnabled: typeof onSendTest === 'function',
+            files: workingFiles,
+            recipient,
+        });
+        if (started.status === 'noop') {
             return;
         }
-        let payload;
-        try {
-            payload = (0, types_1.buildSavePayload)(workingFiles);
-        }
-        catch (error) {
-            setSendFeedback({
-                status: 'failure',
-                message: error instanceof Error ? error.message : String(error),
-            });
+        if (started.status === 'recipient-error' || started.status === 'serialize-error') {
+            setSendFeedback({ status: 'failure', message: started.message });
             return;
         }
         const generation = templateGenerationRef.current;
         setSendFeedback({ status: 'pending' });
         void (async () => {
-            const result = await (0, types_1.invokeConsumerAction)(() => onSendTest(payload.serialized, payload.files, recipient));
-            if (generation !== templateGenerationRef.current) {
+            const result = await (0, actions_1.finishSendTestAction)({
+                payload: started.payload,
+                recipient: started.recipient,
+                isGenerationCurrent: () => generation === templateGenerationRef.current,
+                onSendTest: onSendTest,
+            });
+            if (result.status === 'stale') {
                 return;
             }
-            if (result.ok) {
+            if (result.status === 'success') {
                 setSendFeedback({ status: 'success', message: result.message });
             }
             else {
                 setSendFeedback({
                     status: 'failure',
-                    message: result.message ?? 'Send test failed.',
+                    message: result.message,
                 });
             }
         })();
-    }, [busy, onSendTest, workingFiles]);
-    const rootClassName = [`${exports.EDITOR_CLASS_PREFIX}root`, className].filter(Boolean).join(' ');
-    return ((0, jsx_runtime_1.jsx)("div", { className: rootClassName, "data-testid": `${exports.EDITOR_CLASS_PREFIX}root`, children: (0, jsx_runtime_1.jsx)(insertion_target_1.InsertionTargetProvider, { children: (0, jsx_runtime_1.jsxs)("div", { className: `${exports.EDITOR_CLASS_PREFIX}layout`, "data-testid": `${exports.EDITOR_CLASS_PREFIX}layout`, children: [(0, jsx_runtime_1.jsxs)("aside", { className: `${exports.EDITOR_CLASS_PREFIX}sidebar`, children: [(0, jsx_runtime_1.jsx)(SaveSendBar_1.SaveSendBar, { saveFeedback: saveFeedback, sendFeedback: sendFeedback, busy: busy, showSendTest: typeof onSendTest === 'function', onSave: handleSave, onSendTest: handleSendTest }), (0, jsx_runtime_1.jsx)(MetadataPanel_1.MetadataPanel, { metadata: workingFiles.metadata, previewData: workingFiles.previewData, onChange: handleMetadataChange }), (0, jsx_runtime_1.jsx)(VariableCatalogue_1.VariableCatalogue, { availableVariables: availableVariables, metadataVariables: workingFiles.metadata.variables, onMetadataVariablesChange: handleMetadataVariablesChange }), (0, jsx_runtime_1.jsx)(PreviewDataEditor_1.PreviewDataEditor, { declaredVariables: workingFiles.metadata.variables, previewData: workingFiles.previewData, onChange: handlePreviewDataChange })] }), (0, jsx_runtime_1.jsxs)("div", { className: `${exports.EDITOR_CLASS_PREFIX}main`, children: [(0, jsx_runtime_1.jsx)(EmailBuilderCanvas_1.EmailBuilderCanvas, { document: workingFiles.templateJson, onChange: handleDocumentChange }), (0, jsx_runtime_1.jsx)(PreviewPane_1.PreviewPane, { files: workingFiles, onPreviewRendered: onPreviewRendered })] })] }) }) }));
+    }, [busy, onSendTest, validationBlocked, workingFiles]);
+    return ((0, jsx_runtime_1.jsx)(insertion_target_1.InsertionTargetProvider, { children: (0, jsx_runtime_1.jsxs)("div", { className: `${exports.EDITOR_CLASS_PREFIX}layout`, "data-testid": `${exports.EDITOR_CLASS_PREFIX}layout`, children: [(0, jsx_runtime_1.jsxs)("aside", { className: `${exports.EDITOR_CLASS_PREFIX}sidebar`, "aria-label": "Template settings", children: [(0, jsx_runtime_1.jsx)(SaveSendBar_1.SaveSendBar, { saveFeedback: saveFeedback, sendFeedback: sendFeedback, busy: busy, validationBlocked: validationBlocked, validationBlockedReason: validationBlockedReason, showSendTest: typeof onSendTest === 'function', onSave: handleSave, onSendTest: handleSendTest }), (0, jsx_runtime_1.jsx)(ValidationSummary_1.ValidationSummary, { issues: issues }), (0, jsx_runtime_1.jsx)(MetadataPanel_1.MetadataPanel, { metadata: workingFiles.metadata, previewData: workingFiles.previewData, onChange: handleMetadataChange, issues: metadataIssues }), (0, jsx_runtime_1.jsx)(VariableCatalogue_1.VariableCatalogue, { availableVariables: availableVariables, metadataVariables: workingFiles.metadata.variables, onMetadataVariablesChange: handleMetadataVariablesChange }), (0, jsx_runtime_1.jsx)(PreviewDataEditor_1.PreviewDataEditor, { declaredVariables: workingFiles.metadata.variables, previewData: workingFiles.previewData, onChange: handlePreviewDataChange, issues: previewDataIssues })] }), (0, jsx_runtime_1.jsxs)("div", { className: `${exports.EDITOR_CLASS_PREFIX}main`, "aria-label": "Template canvas and preview", children: [(0, jsx_runtime_1.jsx)(EmailBuilderCanvas_1.EmailBuilderCanvas, { document: workingFiles.templateJson, onChange: handleDocumentChange }), (0, jsx_runtime_1.jsx)(PreviewPane_1.PreviewPane, { files: workingFiles, onPreviewRendered: onPreviewRendered, onPreviewResultChange: setPreviewResult })] })] }) }));
 }
 //# sourceMappingURL=email-template-editor.js.map

package/dist/email-template-editor.js.map

@@ -1 +1 @@
-{"version":3,"file":"email-template-editor.js","sourceRoot":"","sources":["../src/email-template-editor.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"email-template-editor.js","sourceRoot":"","sources":["../src/email-template-editor.tsx"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,3 +3,4 @@ export { EDITOR_CLASS_PREFIX, EmailTemplateEditor, type EmailTemplateEditorProps
 export { EmailBuilderCanvas, type EmailBuilderCanvasProps } from './canvas/EmailBuilderCanvas';
 export { loadTemplateSource, serializeTemplateSource, TemplateSourceError } from './serialization';
 export type { SerializedTemplateSource, SaveResult, SendTestResult } from './save-send/types';
+export { validateTemplate, hasValidationErrors, type ValidationIssue, type ValidationSeverity, type ValidateTemplateOptions, } from './validation/validate';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TemplateSourceError = exports.serializeTemplateSource = exports.loadTemplateSource = exports.EmailBuilderCanvas = exports.EmailTemplateEditor = exports.EDITOR_CLASS_PREFIX = void 0;
+exports.hasValidationErrors = exports.validateTemplate = exports.TemplateSourceError = exports.serializeTemplateSource = exports.loadTemplateSource = exports.EmailBuilderCanvas = exports.EmailTemplateEditor = exports.EDITOR_CLASS_PREFIX = void 0;
 var email_template_editor_1 = require("./email-template-editor");
 Object.defineProperty(exports, "EDITOR_CLASS_PREFIX", { enumerable: true, get: function () { return email_template_editor_1.EDITOR_CLASS_PREFIX; } });
 Object.defineProperty(exports, "EmailTemplateEditor", { enumerable: true, get: function () { return email_template_editor_1.EmailTemplateEditor; } });
@@ -10,4 +10,7 @@ var serialization_1 = require("./serialization");
 Object.defineProperty(exports, "loadTemplateSource", { enumerable: true, get: function () { return serialization_1.loadTemplateSource; } });
 Object.defineProperty(exports, "serializeTemplateSource", { enumerable: true, get: function () { return serialization_1.serializeTemplateSource; } });
 Object.defineProperty(exports, "TemplateSourceError", { enumerable: true, get: function () { return serialization_1.TemplateSourceError; } });
+var validate_1 = require("./validation/validate");
+Object.defineProperty(exports, "validateTemplate", { enumerable: true, get: function () { return validate_1.validateTemplate; } });
+Object.defineProperty(exports, "hasValidationErrors", { enumerable: true, get: function () { return validate_1.hasValidationErrors; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAKA,iEAIiC;AAH/B,4HAAA,mBAAmB,OAAA;AACnB,4HAAA,mBAAmB,OAAA;AAGrB,kEAA+F;AAAtF,wHAAA,kBAAkB,OAAA;AAC3B,iDAAmG;AAA1F,mHAAA,kBAAkB,OAAA;AAAE,wHAAA,uBAAuB,OAAA;AAAE,oHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAKA,iEAIiC;AAH/B,4HAAA,mBAAmB,OAAA;AACnB,4HAAA,mBAAmB,OAAA;AAGrB,kEAA+F;AAAtF,wHAAA,kBAAkB,OAAA;AAC3B,iDAAmG;AAA1F,mHAAA,kBAAkB,OAAA;AAAE,wHAAA,uBAAuB,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAEzE,kDAM+B;AAL7B,4GAAA,gBAAgB,OAAA;AAChB,+GAAA,mBAAmB,OAAA"}

package/dist/metadata/MetadataPanel.d.ts

@@ -1,7 +1,9 @@
 import type { TemplatePreviewData, TemplateSourceMetadata } from '@singleton-sd/post-kit-types';
+import { type ValidationIssue } from '../validation/validate';
 export interface MetadataPanelProps {
     metadata: TemplateSourceMetadata;
     previewData: TemplatePreviewData;
     onChange: (metadata: TemplateSourceMetadata) => void;
+    issues?: readonly ValidationIssue[];
 }
-export declare function MetadataPanel({ metadata, previewData, onChange, }: MetadataPanelProps): JSX.Element;
+export declare function MetadataPanel({ metadata, previewData, onChange, issues, }: MetadataPanelProps): JSX.Element;

package/dist/metadata/MetadataPanel.js

@@ -5,12 +5,24 @@ const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const email_template_editor_1 = require("../email-template-editor");
 const insertion_target_1 = require("../insertion-target");
+const validate_1 = require("../validation/validate");
 const insert_at_cursor_1 = require("./insert-at-cursor");
 const subject_preview_1 = require("./subject-preview");
 const template_key_1 = require("./template-key");
-function MetadataPanel({ metadata, previewData, onChange, }) {
+function MetadataPanel({ metadata, previewData, onChange, issues = [], }) {
     const [keyError, setKeyError] = (0, react_1.useState)(null);
     const subjectRef = (0, react_1.useRef)(null);
+    const keyIssues = issues.filter((i) => i.field === 'metadata' && (i.code === 'missing-key' || i.code === 'invalid-key'));
+    const nameIssues = issues.filter((i) => i.field === 'metadata' && i.code === 'missing-name');
+    const subjectIssues = issues.filter((i) => i.field === 'subject');
+    const keyDescribedBy = [
+        keyError ? `${email_template_editor_1.EDITOR_CLASS_PREFIX}meta-key-error` : null,
+        ...keyIssues.map((i) => (0, validate_1.inlineIssueId)(i.code)),
+    ]
+        .filter(Boolean)
+        .join(' ');
+    const nameDescribedBy = nameIssues.map((i) => (0, validate_1.inlineIssueId)(i.code)).join(' ');
+    const subjectDescribedBy = subjectIssues.map((i) => (0, validate_1.inlineIssueId)(i.code, i.variable)).join(' ');
     const patch = (0, react_1.useCallback)((partial) => {
         onChange({ ...metadata, ...partial });
     }, [metadata, onChange]);
@@ -43,7 +55,7 @@ function MetadataPanel({ metadata, previewData, onChange, }) {
     const subjectFocus = (0, insertion_target_1.useRegisterInsertionTarget)('subject field', insertIntoSubject);
     const subjectPreview = (0, subject_preview_1.previewSubject)(metadata.subject, previewData);
     const p = email_template_editor_1.EDITOR_CLASS_PREFIX;
-    return ((0, jsx_runtime_1.jsxs)("section", { className: `${p}metadata`, "data-testid": `${p}metadata`, children: [(0, jsx_runtime_1.jsx)("h2", { className: `${p}metadata-heading`, children: "Template metadata" }), (0, jsx_runtime_1.jsxs)("div", { className: `${p}metadata-field`, children: [(0, jsx_runtime_1.jsx)("label", { className: `${p}metadata-label`, htmlFor: `${p}meta-key`, children: "Key" }), (0, jsx_runtime_1.jsx)("input", { id: `${p}meta-key`, className: `${p}metadata-input`, type: "text", value: metadata.key, onChange: handleKeyChange, autoComplete: "off", spellCheck: false, "data-testid": `${p}meta-key` }), keyError ? ((0, jsx_runtime_1.jsx)("p", { className: `${p}metadata-error`, "data-testid": `${p}meta-key-error`, role: "status", children: keyError })) : null] }), (0, jsx_runtime_1.jsxs)("div", { className: `${p}metadata-field`, children: [(0, jsx_runtime_1.jsx)("label", { className: `${p}metadata-label`, htmlFor: `${p}meta-name`, children: "Name" }), (0, jsx_runtime_1.jsx)("input", { id: `${p}meta-name`, className: `${p}metadata-input`, type: "text", value: metadata.name, onChange: (event) => patch({ name: event.target.value }), "data-testid": `${p}meta-name` })] }), (0, jsx_runtime_1.jsxs)("div", { className: `${p}metadata-field`, children: [(0, jsx_runtime_1.jsx)("label", { className: `${p}metadata-label`, htmlFor: `${p}meta-description`, children: "Description" }), (0, jsx_runtime_1.jsx)("textarea", { id: `${p}meta-description`, className: `${p}metadata-textarea`, value: metadata.description ?? '', onChange: (event) => {
+    return ((0, jsx_runtime_1.jsxs)("section", { className: `${p}metadata`, "data-testid": `${p}metadata`, children: [(0, jsx_runtime_1.jsx)("h2", { className: `${p}metadata-heading`, children: "Template metadata" }), (0, jsx_runtime_1.jsxs)("div", { className: `${p}metadata-field`, children: [(0, jsx_runtime_1.jsx)("label", { className: `${p}metadata-label`, htmlFor: `${p}meta-key`, children: "Key" }), (0, jsx_runtime_1.jsx)("input", { id: `${p}meta-key`, className: `${p}metadata-input`, type: "text", value: metadata.key, onChange: handleKeyChange, autoComplete: "off", spellCheck: false, "data-testid": `${p}meta-key`, "aria-invalid": keyError !== null || keyIssues.length > 0, "aria-describedby": keyDescribedBy || undefined }), keyError ? ((0, jsx_runtime_1.jsx)("p", { id: `${p}meta-key-error`, className: `${p}metadata-error`, "data-testid": `${p}meta-key-error`, role: "status", children: keyError })) : null, keyIssues.map((issue) => ((0, jsx_runtime_1.jsxs)("p", { id: (0, validate_1.inlineIssueId)(issue.code), className: `${p}metadata-error`, "data-testid": `${p}meta-key-validation`, role: "status", children: [(0, jsx_runtime_1.jsx)("span", { "aria-hidden": "true", children: "!" }), " ", issue.message] }, issue.code)))] }), (0, jsx_runtime_1.jsxs)("div", { className: `${p}metadata-field`, children: [(0, jsx_runtime_1.jsx)("label", { className: `${p}metadata-label`, htmlFor: `${p}meta-name`, children: "Name" }), (0, jsx_runtime_1.jsx)("input", { id: `${p}meta-name`, className: `${p}metadata-input`, type: "text", value: metadata.name, onChange: (event) => patch({ name: event.target.value }), "data-testid": `${p}meta-name`, "aria-invalid": nameIssues.length > 0, "aria-describedby": nameDescribedBy || undefined }), nameIssues.map((issue) => ((0, jsx_runtime_1.jsxs)("p", { id: (0, validate_1.inlineIssueId)(issue.code), className: `${p}metadata-error`, "data-testid": `${p}meta-name-validation`, role: "status", children: [(0, jsx_runtime_1.jsx)("span", { "aria-hidden": "true", children: "!" }), " ", issue.message] }, issue.code)))] }), (0, jsx_runtime_1.jsxs)("div", { className: `${p}metadata-field`, children: [(0, jsx_runtime_1.jsx)("label", { className: `${p}metadata-label`, htmlFor: `${p}meta-description`, children: "Description" }), (0, jsx_runtime_1.jsx)("textarea", { id: `${p}meta-description`, className: `${p}metadata-textarea`, value: metadata.description ?? '', onChange: (event) => {
                             const description = event.target.value;
                             if (description === '') {
                                 const { description: _removed, ...rest } = metadata;
@@ -51,6 +63,6 @@ function MetadataPanel({ metadata, previewData, onChange, }) {
                                 return;
                             }
                             patch({ description });
-                        }, rows: 3, "data-testid": `${p}meta-description` })] }), (0, jsx_runtime_1.jsxs)("div", { className: `${p}metadata-field`, children: [(0, jsx_runtime_1.jsx)("label", { className: `${p}metadata-label`, htmlFor: `${p}meta-subject`, children: "Subject" }), (0, jsx_runtime_1.jsx)("input", { id: `${p}meta-subject`, ref: subjectRef, className: `${p}metadata-input`, type: "text", value: metadata.subject, onChange: (event) => patch({ subject: event.target.value }), onFocus: subjectFocus.onFocus, onBlur: subjectFocus.onBlur, "data-testid": `${p}meta-subject` }), (0, jsx_runtime_1.jsxs)("p", { className: `${p}metadata-subject-preview`, "data-testid": `${p}meta-subject-preview`, children: ["Preview: ", subjectPreview] })] }), (0, jsx_runtime_1.jsxs)("div", { className: `${p}metadata-field`, children: [(0, jsx_runtime_1.jsx)("span", { className: `${p}metadata-label`, children: "Schema version" }), (0, jsx_runtime_1.jsx)("span", { className: `${p}metadata-readonly`, "data-testid": `${p}meta-schema-version`, children: metadata.schemaVersion })] })] }));
+                        }, rows: 3, "data-testid": `${p}meta-description` })] }), (0, jsx_runtime_1.jsxs)("div", { className: `${p}metadata-field`, children: [(0, jsx_runtime_1.jsx)("label", { className: `${p}metadata-label`, htmlFor: `${p}meta-subject`, children: "Subject" }), (0, jsx_runtime_1.jsx)("input", { id: `${p}meta-subject`, ref: subjectRef, className: `${p}metadata-input`, type: "text", value: metadata.subject, onChange: (event) => patch({ subject: event.target.value }), onFocus: subjectFocus.onFocus, onBlur: subjectFocus.onBlur, "data-testid": `${p}meta-subject`, "aria-invalid": subjectIssues.length > 0, "aria-describedby": subjectDescribedBy || undefined }), subjectIssues.map((issue) => ((0, jsx_runtime_1.jsxs)("p", { id: (0, validate_1.inlineIssueId)(issue.code, issue.variable), className: `${p}metadata-error`, "data-testid": `${p}meta-subject-validation`, role: "status", children: [(0, jsx_runtime_1.jsx)("span", { "aria-hidden": "true", children: "!" }), " ", issue.message] }, `${issue.code}:${issue.variable ?? ''}`))), (0, jsx_runtime_1.jsxs)("p", { className: `${p}metadata-subject-preview`, "data-testid": `${p}meta-subject-preview`, children: ["Preview: ", subjectPreview] })] }), (0, jsx_runtime_1.jsxs)("div", { className: `${p}metadata-field`, children: [(0, jsx_runtime_1.jsx)("span", { className: `${p}metadata-label`, children: "Schema version" }), (0, jsx_runtime_1.jsx)("span", { className: `${p}metadata-readonly`, "data-testid": `${p}meta-schema-version`, children: metadata.schemaVersion })] })] }));
 }
 //# sourceMappingURL=MetadataPanel.js.map