@batterai/block-sdk 0.1.0

package/dist/blocks/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/blocks/image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAC9D,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAEjB,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAgDtD,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAa3E;AAED,eAAO,MAAM,aAAa,EAAE,aAAyC,CAAC;AAEtE,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvD,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;KACnD,CAAC;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAQD,qBAAa,YAAa,SAAQ,mBAAmB;IACnD,MAAM,CAAC,MAAM,0BA6BX;IAEO,MAAM,IAAI,cAAc;CAyBlC;AA2GD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAOzE;AAED,eAAO,MAAM,YAAY,EAAE,YAAuC,CAAC"}

package/dist/blocks/image.js

@@ -0,0 +1,238 @@
+/**
+ * First-party `battery.image` (Tier 1, hydration "none" — 0 kb client JS):
+ * a bound image through @batterai/media (plan §8 Phase 7). The block is a pure
+ * function of RESOLVED props + host-supplied media data:
+ *  - `assetId`/`alt`/`caption` props are bindable like any other prop;
+ *  - the HOST resolves assetId -> src/srcset/dimensions via its MediaStore and
+ *    injects the result as `config.data.media` (blocks never do I/O — the
+ *    media lookup is host render machinery, shared by page + fragment +
+ *    canvas so all three agree, invariant A);
+ *  - an assetId without media data renders a VISIBLE diagnostic (`be-media-
+ *    missing`, role=alert) — never a broken <img>, never a silent gap;
+ *  - alt precedence: bound/authored `alt` prop, else the asset's own alt (the
+ *    store validates alt at upload, so the floor is never empty).
+ */
+import { css, html, nothing } from "lit";
+import { fieldName, isCssLength, } from "@batterai/contract";
+import { BatteryBlockElement } from "../base-element.js";
+import { defineBlock } from "../define.js";
+import { blockSdkMessage } from "../i18n.js";
+function fields(locale) {
+    return [
+        {
+            name: fieldName("assetId"),
+            label: blockSdkMessage(locale, "image.field.assetId.label"),
+            valueType: "media",
+            cardinality: "one",
+            bindable: true,
+            constraints: {
+                media: {
+                    view: "single",
+                    maxCount: 1,
+                    allowedMimeTypes: ["image/avif", "image/gif", "image/jpeg", "image/png", "image/webp"],
+                },
+            },
+        },
+        { name: fieldName("alt"), label: blockSdkMessage(locale, "image.field.alt.label"), valueType: "string", cardinality: "one", bindable: true },
+        { name: fieldName("caption"), label: blockSdkMessage(locale, "image.field.caption.label"), valueType: "string", cardinality: "one", bindable: true },
+        {
+            name: fieldName("view"),
+            label: blockSdkMessage(locale, "image.field.view.label"),
+            valueType: "string",
+            cardinality: "one",
+            bindable: false,
+            options: {
+                kind: "static",
+                items: [
+                    { value: "single", label: blockSdkMessage(locale, "image.field.view.single") },
+                    { value: "carousel", label: blockSdkMessage(locale, "image.field.view.carousel") },
+                    { value: "grid", label: blockSdkMessage(locale, "image.field.view.grid") },
+                ],
+            },
+        },
+        {
+            name: fieldName("sizes"),
+            label: blockSdkMessage(locale, "image.field.sizes.label"),
+            help: blockSdkMessage(locale, "image.field.sizes.help"),
+            valueType: "string",
+            cardinality: "one",
+            bindable: false,
+        },
+    ];
+}
+export function createImageManifest(locale) {
+    return {
+        type: "battery.image",
+        version: "1.0.0",
+        source: "battery",
+        label: blockSdkMessage(locale, "image.manifest.label"),
+        summary: blockSdkMessage(locale, "image.manifest.summary"),
+        category: "media",
+        icon: "image",
+        fields: fields(locale),
+        defaultProps: { assetId: "", alt: "", caption: "", view: "single", sizes: "100vw" },
+        capabilities: { ssr: true, hydration: "none" },
+    };
+}
+export const imageManifest = createImageManifest("en");
+export class BatteryImage extends BatteryBlockElement {
+    static styles = css `
+    :host { display: block; }
+    figure { margin: 0; }
+    img { max-width: 100%; height: auto; display: block; }
+    .be-image__link { color: inherit; display: block; text-decoration: none; }
+    .be-image--carousel {
+      display: flex;
+      gap: 12px;
+      overflow-x: auto;
+      overscroll-behavior-inline: contain;
+      scroll-snap-type: x mandatory;
+    }
+    .be-image--carousel .be-image__item {
+      flex: 0 0 100%;
+      scroll-snap-align: start;
+    }
+    .be-image--grid {
+      display: grid;
+      gap: 12px;
+      grid-template-columns: repeat(auto-fit, minmax(min(12rem, 100%), 1fr));
+    }
+    .be-image__frame {
+      overflow: hidden;
+    }
+    figcaption { font: 14px/1.4 system-ui, sans-serif; color: #555; padding-top: 4px; }
+    .be-media-missing {
+      font: 14px/1.4 system-ui, sans-serif;
+      background: #f7c1c1; padding: 8px 12px; border-radius: 4px;
+    }
+  `;
+    render() {
+        const c = this.config;
+        if (!c)
+            return html `<p class="be-unconfigured">${blockSdkMessage(undefined, "block.unconfigured")}</p>`;
+        const assetId = typeof c.props.assetId === "string" ? c.props.assetId : "";
+        const data = c.data;
+        const images = mediaEntries(data);
+        if (images.length === 0) {
+            if (assetId) {
+                // VISIBLE failure (plan §0 rule 4): the asset didn't resolve.
+                return html `<p class="be-media-missing" role="alert">
+          ${blockSdkMessage(c.context.locale, "image.missing", { assetId })}
+        </p>`;
+            }
+            // Author hasn't picked an image yet — empty placeholder only in editMode.
+            return c.context.editMode ? html `<p class="be-media-missing" role="note">${blockSdkMessage(c.context.locale, "image.empty")}</p>` : html ``;
+        }
+        const view = imageView(data.view ?? c.props.view);
+        const caption = typeof c.props.caption === "string" ? c.props.caption : "";
+        const altOverride = typeof c.props.alt === "string" && c.props.alt.trim() ? c.props.alt : undefined;
+        const sizes = typeof c.props.sizes === "string" && c.props.sizes ? c.props.sizes : "100vw";
+        const rendered = (view === "single" ? images.slice(0, 1) : images).map((media) => renderImageItem(media, { altOverride: view === "single" ? altOverride : undefined, caption, sizes }));
+        return html `<div class=${`be-image be-image--${view}`} data-image-view=${view}>${rendered}</div>`;
+    }
+}
+function mediaEntries(data) {
+    if (Array.isArray(data.images))
+        return data.images.filter(isImageMediaData);
+    return isImageMediaData(data.media) ? [data.media] : [];
+}
+function isImageMediaData(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const item = value;
+    return (typeof item.src === "string" &&
+        typeof item.width === "number" &&
+        typeof item.height === "number" &&
+        typeof item.alt === "string");
+}
+function imageView(value) {
+    return value === "carousel" || value === "grid" ? value : "single";
+}
+function renderImageItem(media, opts) {
+    const caption = media.caption ?? opts.caption;
+    const image = html `<img
+    src=${media.src}
+    srcset=${media.srcset ?? nothing}
+    sizes=${media.srcset ? opts.sizes : nothing}
+    width=${media.width}
+    height=${media.height}
+    alt=${opts.altOverride ?? media.alt}
+    title=${media.title ?? nothing}
+    style=${imageStyle(media)}
+  />`;
+    const body = safeHref(media.href) ? html `<a class="be-image__link" href=${media.href}>${image}</a>` : image;
+    return html `<figure class="be-image__item">
+    <div class="be-image__frame" style=${frameStyle(media)}>${body}</div>
+    ${caption ? html `<figcaption>${caption}</figcaption>` : nothing}
+  </figure>`;
+}
+function frameStyle(media) {
+    const styles = [];
+    if (isAspectRatio(media.aspectRatio)) {
+        styles.push(`aspect-ratio: ${media.aspectRatio}`);
+    }
+    if (typeof media.sizing?.width === "string" && isCssLength(media.sizing.width)) {
+        styles.push(`width: ${media.sizing.width}`);
+    }
+    if (typeof media.sizing?.height === "string" && isCssLength(media.sizing.height)) {
+        styles.push(`height: ${media.sizing.height}`);
+    }
+    return styles.length > 0 ? styles.join("; ") : nothing;
+}
+function imageStyle(media) {
+    const styles = [];
+    const focal = validFocal(media.focal);
+    const framed = isAspectRatio(media.aspectRatio);
+    const objectFit = validObjectFit(media.sizing?.objectFit);
+    if (focal) {
+        styles.push(`object-position: ${Math.round(focal.x * 100)}% ${Math.round(focal.y * 100)}%`);
+    }
+    if (framed) {
+        styles.push("width: 100%", "height: 100%", `object-fit: ${objectFit ?? "cover"}`);
+    }
+    else if (objectFit) {
+        styles.push(`object-fit: ${objectFit}`);
+    }
+    if (typeof media.opacity === "number" && Number.isFinite(media.opacity) && media.opacity >= 0 && media.opacity <= 1) {
+        styles.push(`opacity: ${media.opacity}`);
+    }
+    return styles.length > 0 ? styles.join("; ") : nothing;
+}
+function validObjectFit(value) {
+    return value === "cover" || value === "contain" || value === "fill" ? value : undefined;
+}
+function validFocal(value) {
+    return value &&
+        Number.isFinite(value.x) &&
+        Number.isFinite(value.y) &&
+        value.x >= 0 &&
+        value.x <= 1 &&
+        value.y >= 0 &&
+        value.y <= 1
+        ? value
+        : undefined;
+}
+function isAspectRatio(value) {
+    return typeof value === "string" && /^(?:\d+|\d*\.\d+)\s*\/\s*(?:\d+|\d*\.\d+)$/.test(value);
+}
+function safeHref(value) {
+    if (typeof value !== "string" || !value.trim())
+        return false;
+    try {
+        const url = new URL(value, "https://battery.local");
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+export function createImagePackage(locale) {
+    const manifest = createImageManifest(locale);
+    return {
+        manifest,
+        stylesheets: [new URL("./image.css", import.meta.url).href],
+        defineElement: defineBlock(manifest, BatteryImage),
+    };
+}
+export const imagePackage = createImagePackage("en");
+//# sourceMappingURL=image.js.map

package/dist/blocks/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/blocks/image.ts"],"names":[],"mappings":"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"}

package/dist/define.d.ts

@@ -0,0 +1,9 @@
+/**
+ * defineBlock — the idempotent element-definition helper every BlockPackage
+ * uses. Guards double-registration (contract §1: defineElement is idempotent)
+ * and stamps identity onto the class for be-ready.
+ */
+import type { BlockManifest } from "@batterai/contract";
+import type { BatteryBlockElement } from "./base-element";
+export declare function defineBlock(manifest: BlockManifest, elementClass: typeof BatteryBlockElement): () => void;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,wBAAgB,WAAW,CACzB,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,OAAO,mBAAmB,GACvC,MAAM,IAAI,CAQZ"}

package/dist/define.js

@@ -0,0 +1,12 @@
+import { tagFor } from "./tag.js";
+export function defineBlock(manifest, elementClass) {
+    const tag = tagFor(manifest.type, manifest.version);
+    elementClass.blockType = manifest.type;
+    elementClass.blockVersion = manifest.version;
+    return function defineElement() {
+        if (customElements.get(tag))
+            return; // idempotent
+        customElements.define(tag, elementClass);
+    };
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B,MAAM,UAAU,WAAW,CACzB,QAAuB,EACvB,YAAwC;IAExC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,YAAY,CAAC,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC;IACvC,YAAY,CAAC,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC7C,OAAO,SAAS,aAAa;QAC3B,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,aAAa;QAClD,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,YAAmD,CAAC,CAAC;IAClF,CAAC,CAAC;AACJ,CAAC"}

package/dist/html-package.d.ts

@@ -0,0 +1,16 @@
+import type { BlockConfig, BlockElement, BlockManifest, BlockPackage } from "@batterai/contract";
+export type HtmlBlockRender = (config: BlockConfig) => string;
+export type HtmlBlockPackageOptions = {
+    readonly manifest: BlockManifest;
+    readonly render: HtmlBlockRender;
+    readonly stylesheets: readonly string[];
+    readonly renderMode?: "light" | "shadow";
+    readonly connect?: (element: BlockElement) => void | (() => void);
+};
+/**
+ * Creates the browser custom element and public SSR adapter from one pure HTML
+ * render function. This is the canonical factory for framework-neutral blocks:
+ * there is no second editor/public renderer to drift.
+ */
+export declare function createHtmlBlockPackage(options: HtmlBlockPackageOptions): BlockPackage;
+//# sourceMappingURL=html-package.d.ts.map

package/dist/html-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-package.d.ts","sourceRoot":"","sources":["../src/html-package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIjG,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;CACnE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,YAAY,CAoGrF"}

package/dist/html-package.js

@@ -0,0 +1,104 @@
+import { BE_EDIT, BE_INTENT, BE_READY } from "@batterai/contract";
+import { tagFor } from "./tag.js";
+/**
+ * Creates the browser custom element and public SSR adapter from one pure HTML
+ * render function. This is the canonical factory for framework-neutral blocks:
+ * there is no second editor/public renderer to drift.
+ */
+export function createHtmlBlockPackage(options) {
+    const { manifest, render, connect, stylesheets } = options;
+    const renderMode = options.renderMode ?? "light";
+    const tag = tagFor(manifest.type, manifest.version);
+    return {
+        manifest,
+        stylesheets,
+        renderMode,
+        renderToDSD: render,
+        defineElement() {
+            if (customElements.get(tag))
+                return;
+            class HtmlBlockElement extends HTMLElement {
+                #config = null;
+                #disconnect;
+                #root;
+                constructor() {
+                    super();
+                    this.#root = renderMode === "shadow" ? this.attachShadow({ mode: "open" }) : this;
+                }
+                get config() {
+                    return this.#config;
+                }
+                set config(value) {
+                    this.#config = value;
+                    this.#render();
+                }
+                connectedCallback() {
+                    const attribute = this.getAttribute("config");
+                    if (!this.#config && attribute) {
+                        try {
+                            this.#config = JSON.parse(attribute);
+                        }
+                        catch {
+                            this.#config = null;
+                        }
+                    }
+                    this.#render();
+                    const disconnect = connect?.(this);
+                    this.#disconnect = typeof disconnect === "function" ? disconnect : undefined;
+                    this.dispatchEvent(new CustomEvent(BE_READY, {
+                        bubbles: true,
+                        composed: true,
+                        detail: { type: manifest.type, version: manifest.version },
+                    }));
+                }
+                disconnectedCallback() {
+                    this.#disconnect?.();
+                    this.#disconnect = undefined;
+                }
+                focusRegion(regionId) {
+                    const selector = manifest.editableRegions?.find((region) => region.regionId === regionId)?.target;
+                    const target = selector ? this.#root.querySelector(selector) : null;
+                    target?.focus();
+                }
+                #render() {
+                    if (!this.#config)
+                        return;
+                    this.#root.innerHTML = render(this.#config);
+                    if (!this.#config.context.editMode)
+                        return;
+                    for (const region of manifest.editableRegions ?? []) {
+                        const target = this.#root.querySelector(region.target);
+                        if (!target)
+                            continue;
+                        target.dataset.edit = region.regionId;
+                        target.addEventListener("click", (event) => {
+                            const mouse = event;
+                            this.dispatchEvent(new CustomEvent(BE_INTENT, {
+                                bubbles: true,
+                                composed: true,
+                                detail: {
+                                    action: "edit-region",
+                                    payload: {
+                                        field: region.field,
+                                        regionId: region.regionId,
+                                        clientX: mouse.clientX,
+                                        clientY: mouse.clientY,
+                                    },
+                                },
+                            }));
+                        });
+                        target.addEventListener("change", () => {
+                            this.dispatchEvent(new CustomEvent(BE_EDIT, {
+                                bubbles: true,
+                                composed: true,
+                                detail: { field: region.field, value: target.textContent ?? "" },
+                            }));
+                        });
+                    }
+                }
+            }
+            customElements.define(tag, HtmlBlockElement);
+        },
+    };
+}
+//# sourceMappingURL=html-package.js.map

package/dist/html-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-package.js","sourceRoot":"","sources":["../src/html-package.ts"],"names":[],"mappings":"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"}

package/dist/i18n.d.ts

@@ -0,0 +1,88 @@
+import { type Locale, type MessageParams } from "@batterai/contract";
+export declare const BLOCK_SDK_MESSAGES_EN: {
+    readonly "block.unconfigured": "missing config";
+    readonly "callout.field.title.label": "Title";
+    readonly "callout.field.body.label": "Body";
+    readonly "callout.manifest.label": "Callout";
+    readonly "callout.manifest.summary": "Title + body with an accent bar.";
+    readonly "callout.default.title": "New callout";
+    readonly "callout.default.body": "Write here...";
+    readonly "image.field.assetId.label": "Image";
+    readonly "image.field.alt.label": "Alt text";
+    readonly "image.field.caption.label": "Caption";
+    readonly "image.field.view.label": "View";
+    readonly "image.field.view.single": "Single image";
+    readonly "image.field.view.carousel": "Carousel";
+    readonly "image.field.view.grid": "Grid";
+    readonly "image.field.sizes.label": "Sizes";
+    readonly "image.field.sizes.help": "The HTML sizes attribute for responsive loading.";
+    readonly "image.manifest.label": "Image";
+    readonly "image.manifest.summary": "Responsive image from the media library, with bindable caption.";
+    readonly "image.missing": "image unavailable: {assetId}";
+    readonly "image.empty": "No image selected yet.";
+    readonly "form.field.title.label": "Title";
+    readonly "form.field.fieldsJson.label": "Fields (JSON)";
+    readonly "form.field.fieldsJson.help": "For example [{\"name\":\"message\",\"label\":\"Message\",\"required\":true,\"multiline\":true}]";
+    readonly "form.field.submitLabel.label": "Submit button";
+    readonly "form.field.successMessage.label": "Success message";
+    readonly "form.field.action.label": "Action endpoint";
+    readonly "form.field.formId.label": "Form id";
+    readonly "form.manifest.label": "Form";
+    readonly "form.manifest.summary": "Form that posts to a host action endpoint; the host routes to HostApi.mutate.";
+    readonly "form.default.submitLabel": "Submit";
+    readonly "form.default.successMessage": "Thanks, your submission has been processed.";
+    readonly "form.parse.missing": "fieldsJson is missing";
+    readonly "form.parse.list": "fieldsJson must be a list";
+    readonly "form.parse.field": "each field needs a name and label";
+    readonly "form.parse.invalidJson": "fieldsJson is not valid JSON";
+    readonly "form.validation.required": "{label} is required";
+    readonly "form.status.processed": "Processed.";
+    readonly "form.status.pending": "Sending...";
+    readonly "form.status.connectionFailed": "Submit failed. Check the connection and try again.";
+    readonly "form.config.invalid": "form misconfigured: {message}";
+};
+export declare const BLOCK_SDK_MESSAGES_NL: {
+    readonly "block.unconfigured": "geen config";
+    readonly "callout.field.title.label": "Titel";
+    readonly "callout.field.body.label": "Tekst";
+    readonly "callout.manifest.label": "Callout";
+    readonly "callout.manifest.summary": "Titel + tekst met een accentbalk.";
+    readonly "callout.default.title": "Nieuwe callout";
+    readonly "callout.default.body": "Schrijf hier...";
+    readonly "image.field.assetId.label": "Afbeelding";
+    readonly "image.field.alt.label": "Alt-tekst";
+    readonly "image.field.caption.label": "Bijschrift";
+    readonly "image.field.view.label": "Weergave";
+    readonly "image.field.view.single": "Enkele afbeelding";
+    readonly "image.field.view.carousel": "Carousel";
+    readonly "image.field.view.grid": "Grid";
+    readonly "image.field.sizes.label": "Sizes";
+    readonly "image.field.sizes.help": "Het HTML sizes-attribuut voor responsive laden.";
+    readonly "image.manifest.label": "Afbeelding";
+    readonly "image.manifest.summary": "Responsive afbeelding uit de mediabibliotheek, met bindbaar bijschrift.";
+    readonly "image.missing": "afbeelding niet beschikbaar: {assetId}";
+    readonly "image.empty": "Nog geen afbeelding gekozen.";
+    readonly "form.field.title.label": "Titel";
+    readonly "form.field.fieldsJson.label": "Velden (JSON)";
+    readonly "form.field.fieldsJson.help": "Bijv. [{\"name\":\"bericht\",\"label\":\"Bericht\",\"required\":true,\"multiline\":true}]";
+    readonly "form.field.submitLabel.label": "Verstuurknop";
+    readonly "form.field.successMessage.label": "Succesmelding";
+    readonly "form.field.action.label": "Actie-endpoint";
+    readonly "form.field.formId.label": "Formulier-id";
+    readonly "form.manifest.label": "Formulier";
+    readonly "form.manifest.summary": "Formulier dat naar een host action-endpoint post; de host routeert naar HostApi.mutate.";
+    readonly "form.default.submitLabel": "Versturen";
+    readonly "form.default.successMessage": "Bedankt, je inzending is verwerkt.";
+    readonly "form.parse.missing": "fieldsJson ontbreekt";
+    readonly "form.parse.list": "fieldsJson moet een lijst zijn";
+    readonly "form.parse.field": "elk veld heeft een name en label nodig";
+    readonly "form.parse.invalidJson": "fieldsJson is geen geldige JSON";
+    readonly "form.validation.required": "{label} is verplicht";
+    readonly "form.status.processed": "Verwerkt.";
+    readonly "form.status.pending": "Bezig...";
+    readonly "form.status.connectionFailed": "Versturen mislukt. Controleer de verbinding en probeer opnieuw.";
+    readonly "form.config.invalid": "formulier verkeerd geconfigureerd: {message}";
+};
+export type BlockSdkMessageKey = keyof typeof BLOCK_SDK_MESSAGES_EN;
+export declare function blockSdkMessage(locale: Locale | string | undefined, key: BlockSdkMessageKey, params?: MessageParams): string;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,MAAM,EAAuB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE1G,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCC,CAAC;AAEpC,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCqC,CAAC;AAExE,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAOpE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACnC,GAAG,EAAE,kBAAkB,EACvB,MAAM,CAAC,EAAE,aAAa,GACrB,MAAM,CAER"}

package/dist/i18n.js

@@ -0,0 +1,93 @@
+import { resolveMessage } from "@batterai/contract";
+export const BLOCK_SDK_MESSAGES_EN = {
+    "block.unconfigured": "missing config",
+    "callout.field.title.label": "Title",
+    "callout.field.body.label": "Body",
+    "callout.manifest.label": "Callout",
+    "callout.manifest.summary": "Title + body with an accent bar.",
+    "callout.default.title": "New callout",
+    "callout.default.body": "Write here...",
+    "image.field.assetId.label": "Image",
+    "image.field.alt.label": "Alt text",
+    "image.field.caption.label": "Caption",
+    "image.field.view.label": "View",
+    "image.field.view.single": "Single image",
+    "image.field.view.carousel": "Carousel",
+    "image.field.view.grid": "Grid",
+    "image.field.sizes.label": "Sizes",
+    "image.field.sizes.help": "The HTML sizes attribute for responsive loading.",
+    "image.manifest.label": "Image",
+    "image.manifest.summary": "Responsive image from the media library, with bindable caption.",
+    "image.missing": "image unavailable: {assetId}",
+    "image.empty": "No image selected yet.",
+    "form.field.title.label": "Title",
+    "form.field.fieldsJson.label": "Fields (JSON)",
+    "form.field.fieldsJson.help": 'For example [{"name":"message","label":"Message","required":true,"multiline":true}]',
+    "form.field.submitLabel.label": "Submit button",
+    "form.field.successMessage.label": "Success message",
+    "form.field.action.label": "Action endpoint",
+    "form.field.formId.label": "Form id",
+    "form.manifest.label": "Form",
+    "form.manifest.summary": "Form that posts to a host action endpoint; the host routes to HostApi.mutate.",
+    "form.default.submitLabel": "Submit",
+    "form.default.successMessage": "Thanks, your submission has been processed.",
+    "form.parse.missing": "fieldsJson is missing",
+    "form.parse.list": "fieldsJson must be a list",
+    "form.parse.field": "each field needs a name and label",
+    "form.parse.invalidJson": "fieldsJson is not valid JSON",
+    "form.validation.required": "{label} is required",
+    "form.status.processed": "Processed.",
+    "form.status.pending": "Sending...",
+    "form.status.connectionFailed": "Submit failed. Check the connection and try again.",
+    "form.config.invalid": "form misconfigured: {message}",
+};
+export const BLOCK_SDK_MESSAGES_NL = {
+    "block.unconfigured": "geen config",
+    "callout.field.title.label": "Titel",
+    "callout.field.body.label": "Tekst",
+    "callout.manifest.label": "Callout",
+    "callout.manifest.summary": "Titel + tekst met een accentbalk.",
+    "callout.default.title": "Nieuwe callout",
+    "callout.default.body": "Schrijf hier...",
+    "image.field.assetId.label": "Afbeelding",
+    "image.field.alt.label": "Alt-tekst",
+    "image.field.caption.label": "Bijschrift",
+    "image.field.view.label": "Weergave",
+    "image.field.view.single": "Enkele afbeelding",
+    "image.field.view.carousel": "Carousel",
+    "image.field.view.grid": "Grid",
+    "image.field.sizes.label": "Sizes",
+    "image.field.sizes.help": "Het HTML sizes-attribuut voor responsive laden.",
+    "image.manifest.label": "Afbeelding",
+    "image.manifest.summary": "Responsive afbeelding uit de mediabibliotheek, met bindbaar bijschrift.",
+    "image.missing": "afbeelding niet beschikbaar: {assetId}",
+    "image.empty": "Nog geen afbeelding gekozen.",
+    "form.field.title.label": "Titel",
+    "form.field.fieldsJson.label": "Velden (JSON)",
+    "form.field.fieldsJson.help": 'Bijv. [{"name":"bericht","label":"Bericht","required":true,"multiline":true}]',
+    "form.field.submitLabel.label": "Verstuurknop",
+    "form.field.successMessage.label": "Succesmelding",
+    "form.field.action.label": "Actie-endpoint",
+    "form.field.formId.label": "Formulier-id",
+    "form.manifest.label": "Formulier",
+    "form.manifest.summary": "Formulier dat naar een host action-endpoint post; de host routeert naar HostApi.mutate.",
+    "form.default.submitLabel": "Versturen",
+    "form.default.successMessage": "Bedankt, je inzending is verwerkt.",
+    "form.parse.missing": "fieldsJson ontbreekt",
+    "form.parse.list": "fieldsJson moet een lijst zijn",
+    "form.parse.field": "elk veld heeft een name en label nodig",
+    "form.parse.invalidJson": "fieldsJson is geen geldige JSON",
+    "form.validation.required": "{label} is verplicht",
+    "form.status.processed": "Verwerkt.",
+    "form.status.pending": "Bezig...",
+    "form.status.connectionFailed": "Versturen mislukt. Controleer de verbinding en probeer opnieuw.",
+    "form.config.invalid": "formulier verkeerd geconfigureerd: {message}",
+};
+const BLOCK_SDK_CATALOGS = {
+    en: BLOCK_SDK_MESSAGES_EN,
+    nl: BLOCK_SDK_MESSAGES_NL,
+};
+export function blockSdkMessage(locale, key, params) {
+    return resolveMessage(BLOCK_SDK_CATALOGS, locale ? String(locale) : "en", key, BLOCK_SDK_MESSAGES_EN[key], params);
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @batterai/block-sdk — the framework-neutral block boundary (plan §4 L1).
+ * Lit-based base element + pure DSD server render + tag scheme + defineBlock.
+ * Imports contract + bind-core only (depcruise-enforced).
+ */
+export * from "./tag";
+export * from "./base-element";
+export * from "./define";
+export * from "./i18n";
+export * from "./render-to-dsd";
+export * from "./html-package";
+export * from "./blocks/callout";
+export * from "./blocks/first-party";
+export * from "./blocks/form";
+export * from "./blocks/image";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}