@batterai/block-sdk 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# @batterai/block-sdk
+
+## 0.1.0
+
+- Baseline web-component block SDK with first-party callout, form, image, and DSD render helpers.
+- Ships as Node-compatible ESM with declaration files under `dist/`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Batterai.eu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# @batterai/block-sdk
+
+Framework-neutral block registration and server-rendering helpers for Battery blocks.
+
+## What It Provides
+
+- `defineBlock` and tag helpers for block packages.
+- A Lit-based base element for browser rendering.
+- Declarative Shadow DOM server rendering utilities.
+- Built-in callout, form, and image block examples.
+
+## Install
+
+```bash
+npm install @batterai/block-sdk
+```
+
+Requires Node.js `>=20.11`.
+
+## Boundary
+
+Blocks receive resolved props and host-supplied data. They do not own page persistence; the host CMS remains the durable source of truth.

package/dist/base-element.d.ts

@@ -0,0 +1,37 @@
+/**
+ * BatteryBlockElement — the Lit base class for block elements.
+ * - pure function of the `config` PROPERTY (host-assigned; contract §3)
+ * - DSD adoption: with `@lit-labs/ssr-client`'s hydrate support loaded FIRST
+ *   (invariant A), an existing server shadow root is adopted, never re-rendered
+ * - emits be-ready on connect; helpers for be-edit / be-intent
+ * - editingRegion contract (plan §5.1): subclasses call `suppressedRegion()`
+ *   to render an identical-box placeholder while that region is overlay-edited
+ */
+import { LitElement } from "lit";
+import { type BeEditDetail, type BeIntentDetail, type BlockConfig } from "@batterai/contract";
+export declare class BatteryBlockElement extends LitElement {
+    /** `config` is BOTH a property (host mount path) and a JSON attribute (the
+     * SSR path): HTML cannot serialize JS properties into DSD, so the server
+     * binds the attribute and the upgraded client element parses it — giving
+     * hydration the IDENTICAL data the server rendered with (invariant A;
+     * spike-proven; the research memo's "DSD property-binding gap"). */
+    static properties: {
+        config: {
+            attribute: string;
+            type: ObjectConstructor;
+        };
+    };
+    config: BlockConfig | null;
+    /** Set by defineBlock() so be-ready carries identity without subclass code. */
+    static blockType: string;
+    static blockVersion: string;
+    constructor();
+    connectedCallback(): void;
+    protected emitEdit(detail: BeEditDetail): void;
+    protected emitIntent(detail: BeIntentDetail): void;
+    /** True when `regionId` must render as a stable-box placeholder because the
+     * host's overlay is editing it (editMode only; renderToDSD paths never see
+     * an editingRegion — invariant L). */
+    protected suppressedRegion(regionId: string): boolean;
+}
+//# sourceMappingURL=base-element.d.ts.map

package/dist/base-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-element.d.ts","sourceRoot":"","sources":["../src/base-element.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,mBAAoB,SAAQ,UAAU;IACjD;;;;wEAIoE;IACpE,MAAM,CAAC,UAAU;;;;;MAEf;IAEM,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAEnC,+EAA+E;IAC/E,MAAM,CAAC,SAAS,SAAM;IACtB,MAAM,CAAC,YAAY,SAAM;;IAOhB,iBAAiB,IAAI,IAAI;IAMlC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAI9C,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIlD;;0CAEsC;IACtC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGtD"}

package/dist/base-element.js

@@ -0,0 +1,46 @@
+/**
+ * BatteryBlockElement — the Lit base class for block elements.
+ * - pure function of the `config` PROPERTY (host-assigned; contract §3)
+ * - DSD adoption: with `@lit-labs/ssr-client`'s hydrate support loaded FIRST
+ *   (invariant A), an existing server shadow root is adopted, never re-rendered
+ * - emits be-ready on connect; helpers for be-edit / be-intent
+ * - editingRegion contract (plan §5.1): subclasses call `suppressedRegion()`
+ *   to render an identical-box placeholder while that region is overlay-edited
+ */
+import { LitElement } from "lit";
+import { BE_READY, emitBlockEvent, } from "@batterai/contract";
+export class BatteryBlockElement extends LitElement {
+    /** `config` is BOTH a property (host mount path) and a JSON attribute (the
+     * SSR path): HTML cannot serialize JS properties into DSD, so the server
+     * binds the attribute and the upgraded client element parses it — giving
+     * hydration the IDENTICAL data the server rendered with (invariant A;
+     * spike-proven; the research memo's "DSD property-binding gap"). */
+    static properties = {
+        config: { attribute: "config", type: Object },
+    };
+    /** Set by defineBlock() so be-ready carries identity without subclass code. */
+    static blockType = "";
+    static blockVersion = "";
+    constructor() {
+        super();
+        this.config = null;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        const ctor = this.constructor;
+        emitBlockEvent(this, BE_READY, { type: ctor.blockType, version: ctor.blockVersion });
+    }
+    emitEdit(detail) {
+        emitBlockEvent(this, "be-edit", detail);
+    }
+    emitIntent(detail) {
+        emitBlockEvent(this, "be-intent", detail);
+    }
+    /** True when `regionId` must render as a stable-box placeholder because the
+     * host's overlay is editing it (editMode only; renderToDSD paths never see
+     * an editingRegion — invariant L). */
+    suppressedRegion(regionId) {
+        return this.config?.context.editMode === true && this.config.context.editingRegion === regionId;
+    }
+}
+//# sourceMappingURL=base-element.js.map

package/dist/base-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-element.js","sourceRoot":"","sources":["../src/base-element.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EACL,QAAQ,EACR,cAAc,GAIf,MAAM,oBAAoB,CAAC;AAE5B,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD;;;;wEAIoE;IACpE,MAAM,CAAC,UAAU,GAAG;QAClB,MAAM,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE;KAC9C,CAAC;IAIF,+EAA+E;IAC/E,MAAM,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC;IAEzB;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEQ,iBAAiB;QACxB,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAyC,CAAC;QAC5D,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACvF,CAAC;IAES,QAAQ,CAAC,MAAoB;QACrC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAES,UAAU,CAAC,MAAsB;QACzC,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;0CAEsC;IAC5B,gBAAgB,CAAC,QAAgB;QACzC,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,KAAK,QAAQ,CAAC;IAClG,CAAC"}

package/dist/blocks/callout.css

@@ -0,0 +1 @@
+be-battery-callout-v1 { display: block; }

package/dist/blocks/callout.d.ts

@@ -0,0 +1,13 @@
+import { type Locale } from "@batterai/contract";
+import type { BlockManifest, BlockPackage } from "@batterai/contract";
+import { BatteryBlockElement } from "../base-element";
+export declare function createCalloutManifest(locale?: Locale | string): BlockManifest;
+export declare const calloutManifest: BlockManifest;
+export declare class BatteryCallout extends BatteryBlockElement {
+    static styles: import("lit").CSSResult;
+    private regionClick;
+    render(): import("lit").TemplateResult<1>;
+}
+export declare function createCalloutPackage(locale?: Locale | string): BlockPackage;
+export declare const calloutPackage: BlockPackage;
+//# sourceMappingURL=callout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callout.d.ts","sourceRoot":"","sources":["../../src/blocks/callout.ts"],"names":[],"mappings":"AAOA,OAAO,EAAyB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAwBtD,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAoB7E;AAED,eAAO,MAAM,eAAe,EAAE,aAA2C,CAAC;AAE1E,qBAAa,cAAe,SAAQ,mBAAmB;IACrD,MAAM,CAAC,MAAM,0BASX;IAEF,OAAO,CAAC,WAAW;IAQV,MAAM;CAsBhB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAO3E;AAED,eAAO,MAAM,cAAc,EAAE,YAAyC,CAAC"}

package/dist/blocks/callout.js

@@ -0,0 +1,106 @@
+/**
+ * First-party proof block `battery.callout` (Tier 2, contract §10 example
+ * generalized): title + body with an accent bar; both regions inline-editable
+ * via be-intent{edit-region} in editMode; pure function of RESOLVED props.
+ * Used by the Phase-4 gate specs and every later phase's fixtures.
+ */
+import { css, html, nothing } from "lit";
+import { fieldName } from "@batterai/contract";
+import { MULTILINE_TEXT_COMPONENT } 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("title"),
+            label: blockSdkMessage(locale, "callout.field.title.label"),
+            valueType: "string",
+            cardinality: "one",
+            bindable: true,
+        },
+        {
+            name: fieldName("body"),
+            label: blockSdkMessage(locale, "callout.field.body.label"),
+            valueType: "string",
+            cardinality: "one",
+            bindable: true,
+            render: { component: MULTILINE_TEXT_COMPONENT },
+        },
+    ];
+}
+export function createCalloutManifest(locale) {
+    return {
+        type: "battery.callout",
+        version: "1.0.0",
+        source: "battery",
+        label: blockSdkMessage(locale, "callout.manifest.label"),
+        summary: blockSdkMessage(locale, "callout.manifest.summary"),
+        category: "content",
+        icon: "text",
+        fields: fields(locale),
+        defaultProps: {
+            title: blockSdkMessage(locale, "callout.default.title"),
+            body: blockSdkMessage(locale, "callout.default.body"),
+        },
+        editableRegions: [
+            { regionId: "title", field: "title", target: "[data-edit='title']", kind: "rich" },
+            { regionId: "body", field: "body", target: "[data-edit='body']", kind: "rich", multiline: true },
+        ],
+        capabilities: { ssr: true, hydration: "partial" },
+    };
+}
+export const calloutManifest = createCalloutManifest("en");
+export class BatteryCallout extends BatteryBlockElement {
+    static styles = css `
+    .bar {
+      border-left: 4px solid var(--be-color-accent, rebeccapurple);
+      padding: 8px 16px;
+      font-family: system-ui, sans-serif;
+    }
+    h3 { margin: 0 0 4px; font-size: 20px; line-height: 1.3; }
+    p { margin: 0; font-size: 16px; line-height: 1.5; }
+    .be-region-placeholder { visibility: hidden; }
+  `;
+    regionClick(field, regionId, e) {
+        if (!this.config?.context.editMode)
+            return;
+        this.emitIntent({
+            action: "edit-region",
+            payload: { field, regionId, clientX: e.clientX, clientY: e.clientY },
+        });
+    }
+    render() {
+        const c = this.config;
+        if (!c)
+            return html `<p class="be-unconfigured">${blockSdkMessage(undefined, "block.unconfigured")}</p>`;
+        const title = typeof c.props.title === "string" ? c.props.title : "";
+        const body = typeof c.props.body === "string" ? c.props.body : "";
+        return html `<article class="bar">
+      <h3
+        data-edit="title"
+        class=${this.suppressedRegion("title") ? "be-region-placeholder" : nothing}
+        @click=${(e) => this.regionClick("title", "title", e)}
+      >
+        ${title}
+      </h3>
+      <p
+        data-edit="body"
+        class=${this.suppressedRegion("body") ? "be-region-placeholder" : nothing}
+        @click=${(e) => this.regionClick("body", "body", e)}
+      >
+        ${body}
+      </p>
+    </article>`;
+    }
+}
+export function createCalloutPackage(locale) {
+    const manifest = createCalloutManifest(locale);
+    return {
+        manifest,
+        stylesheets: [new URL("./callout.css", import.meta.url).href],
+        defineElement: defineBlock(manifest, BatteryCallout),
+    };
+}
+export const calloutPackage = createCalloutPackage("en");
+//# sourceMappingURL=callout.js.map

package/dist/blocks/callout.js.map

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

package/dist/blocks/first-party.d.ts

@@ -0,0 +1,3 @@
+import type { BlockManifest, Locale } from "@batterai/contract";
+export declare function createFirstPartyBlockManifests(locale?: Locale | string): readonly BlockManifest[];
+//# sourceMappingURL=first-party.d.ts.map

package/dist/blocks/first-party.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-party.d.ts","sourceRoot":"","sources":["../../src/blocks/first-party.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAKhE,wBAAgB,8BAA8B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,aAAa,EAAE,CAEjG"}

package/dist/blocks/first-party.js

@@ -0,0 +1,7 @@
+import { createCalloutManifest } from "./callout.js";
+import { createFormManifest } from "./form.js";
+import { createImageManifest } from "./image.js";
+export function createFirstPartyBlockManifests(locale) {
+    return [createCalloutManifest(locale), createImageManifest(locale), createFormManifest(locale)];
+}
+//# sourceMappingURL=first-party.js.map

package/dist/blocks/first-party.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-party.js","sourceRoot":"","sources":["../../src/blocks/first-party.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,UAAU,8BAA8B,CAAC,MAAwB;IACrE,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AAClG,CAAC"}

package/dist/blocks/form.css

@@ -0,0 +1 @@
+be-battery-form-v1 { display: block; }

package/dist/blocks/form.d.ts

@@ -0,0 +1,67 @@
+/**
+ * First-party `battery.form` (Tier 3, hydration "partial") — the v1 form
+ * block posts to a host action endpoint, which routes through HostApi.mutate:
+ *  - fields render from a literal `fieldsJson` spec (name/label/required/
+ *    multiline) — SSR'd, so the form is usable at first paint;
+ *  - the write TARGET is never wire-authored: the block posts only
+ *    { formId, instanceId, idempotencyKey, values } to the host `action`
+ *    endpoint; the host maps formId -> registered target server-side and
+ *    runs checkWriteAuthz (tenant-scoped, invariant D order);
+ *  - client-side required validation shows a visible inline error and does
+ *    NOT submit; server errors render verbatim in a role=alert region;
+ *  - idempotency: one key per user INTENT (minted at mount and after each
+ *    success), constant across retries of a failed submit — the host dedupes;
+ *  - visible states throughout: pending disables the button, success is a
+ *    role=status message, failure a role=alert — never a silent outcome.
+ */
+import { type TemplateResult } from "lit";
+import { type BlockManifest, type BlockPackage, type Locale } from "@batterai/contract";
+import { BatteryBlockElement } from "../base-element";
+export declare function createFormManifest(locale?: Locale | string): BlockManifest;
+export declare const formManifest: BlockManifest;
+export interface FormFieldSpec {
+    readonly name: string;
+    readonly label: string;
+    readonly required?: boolean;
+    readonly multiline?: boolean;
+}
+/** Parse the literal fieldsJson prop; malformed JSON is a VISIBLE config
+ * error, not a silently empty form. */
+export declare function parseFormFields(raw: unknown, locale?: Locale | string): FormFieldSpec[] | Error;
+type Status = {
+    kind: "idle";
+} | {
+    kind: "pending";
+} | {
+    kind: "success";
+    message: string;
+} | {
+    kind: "error";
+    message: string;
+};
+export declare class BatteryForm extends BatteryBlockElement {
+    static styles: import("lit").CSSResult;
+    static properties: {
+        status: {
+            state: boolean;
+        };
+        fieldErrors: {
+            state: boolean;
+        };
+        config: {
+            attribute: string;
+            type: ObjectConstructor;
+        };
+    };
+    status: Status;
+    fieldErrors: Record<string, string>;
+    /** One key per user INTENT: constant across retries, rotated on success. */
+    private idempotencyKey;
+    constructor();
+    private submit;
+    render(): TemplateResult;
+}
+export declare function createFormPackage(locale?: Locale | string): BlockPackage;
+export declare const formPackage: BlockPackage;
+export {};
+//# sourceMappingURL=form.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/blocks/form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAC9D,OAAO,EAAa,KAAK,aAAa,EAAE,KAAK,YAAY,EAAc,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAsBtD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAoB1E;AAED,eAAO,MAAM,YAAY,EAAE,aAAwC,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;uCACuC;AACvC,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,EAAE,GAAG,KAAK,CAc/F;AAED,KAAK,MAAM,GACP;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,qBAAa,WAAY,SAAQ,mBAAmB;IAClD,MAAM,CAAC,MAAM,0BASX;IAEF,MAAM,CAAC,UAAU;;;;;;;;;;;MAIf;IAEM,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,4EAA4E;IAC5E,OAAO,CAAC,cAAc,CAAuB;;YAQ/B,MAAM;IAgDX,MAAM,IAAI,cAAc;CAoClC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAOxE;AAED,eAAO,MAAM,WAAW,EAAE,YAAsC,CAAC"}

package/dist/blocks/form.js

@@ -0,0 +1,199 @@
+/**
+ * First-party `battery.form` (Tier 3, hydration "partial") — the v1 form
+ * block posts to a host action endpoint, which routes through HostApi.mutate:
+ *  - fields render from a literal `fieldsJson` spec (name/label/required/
+ *    multiline) — SSR'd, so the form is usable at first paint;
+ *  - the write TARGET is never wire-authored: the block posts only
+ *    { formId, instanceId, idempotencyKey, values } to the host `action`
+ *    endpoint; the host maps formId -> registered target server-side and
+ *    runs checkWriteAuthz (tenant-scoped, invariant D order);
+ *  - client-side required validation shows a visible inline error and does
+ *    NOT submit; server errors render verbatim in a role=alert region;
+ *  - idempotency: one key per user INTENT (minted at mount and after each
+ *    success), constant across retries of a failed submit — the host dedupes;
+ *  - visible states throughout: pending disables the button, success is a
+ *    role=status message, failure a role=alert — never a silent outcome.
+ */
+import { css, html, nothing } from "lit";
+import { fieldName } 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("title"), label: blockSdkMessage(locale, "form.field.title.label"), valueType: "string", cardinality: "one", bindable: true },
+        {
+            name: fieldName("fieldsJson"),
+            label: blockSdkMessage(locale, "form.field.fieldsJson.label"),
+            help: blockSdkMessage(locale, "form.field.fieldsJson.help"),
+            valueType: "json",
+            cardinality: "one",
+            bindable: false,
+        },
+        { name: fieldName("submitLabel"), label: blockSdkMessage(locale, "form.field.submitLabel.label"), valueType: "string", cardinality: "one", bindable: false },
+        { name: fieldName("successMessage"), label: blockSdkMessage(locale, "form.field.successMessage.label"), valueType: "string", cardinality: "one", bindable: false },
+        { name: fieldName("action"), label: blockSdkMessage(locale, "form.field.action.label"), valueType: "string", cardinality: "one", bindable: false },
+        { name: fieldName("formId"), label: blockSdkMessage(locale, "form.field.formId.label"), valueType: "string", cardinality: "one", bindable: false },
+    ];
+}
+export function createFormManifest(locale) {
+    return {
+        type: "battery.form",
+        version: "1.0.0",
+        source: "battery",
+        label: blockSdkMessage(locale, "form.manifest.label"),
+        summary: blockSdkMessage(locale, "form.manifest.summary"),
+        category: "input",
+        icon: "form",
+        fields: fields(locale),
+        defaultProps: {
+            title: "",
+            fieldsJson: "[]",
+            submitLabel: blockSdkMessage(locale, "form.default.submitLabel"),
+            successMessage: blockSdkMessage(locale, "form.default.successMessage"),
+            action: "/__form",
+            formId: "",
+        },
+        capabilities: { ssr: true, hydration: "partial" },
+    };
+}
+export const formManifest = createFormManifest("en");
+/** Parse the literal fieldsJson prop; malformed JSON is a VISIBLE config
+ * error, not a silently empty form. */
+export function parseFormFields(raw, locale) {
+    if (typeof raw !== "string")
+        return new Error(blockSdkMessage(locale, "form.parse.missing"));
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return new Error(blockSdkMessage(locale, "form.parse.list"));
+        for (const f of parsed) {
+            if (typeof f?.name !== "string" || !f.name || typeof f?.label !== "string") {
+                return new Error(blockSdkMessage(locale, "form.parse.field"));
+            }
+        }
+        return parsed;
+    }
+    catch {
+        return new Error(blockSdkMessage(locale, "form.parse.invalidJson"));
+    }
+}
+export class BatteryForm extends BatteryBlockElement {
+    static styles = css `
+    form { font-family: system-ui, sans-serif; display: grid; gap: 8px; max-width: 480px; }
+    label { display: grid; gap: 2px; font-size: 14px; }
+    input, textarea { font: inherit; padding: 6px 8px; border: 1px solid #bbb; border-radius: 4px; }
+    button { justify-self: start; font: inherit; padding: 6px 16px; border-radius: 4px; border: 1px solid #666; cursor: pointer; }
+    button[disabled] { opacity: 0.6; cursor: wait; }
+    .be-form-error { background: #f7c1c1; padding: 6px 10px; border-radius: 4px; font-size: 14px; }
+    .be-form-success { background: #c9ecc9; padding: 6px 10px; border-radius: 4px; font-size: 14px; }
+    .be-field-error { color: #a4262c; font-size: 12px; }
+  `;
+    static properties = {
+        ...BatteryBlockElement.properties,
+        status: { state: true },
+        fieldErrors: { state: true },
+    };
+    /** One key per user INTENT: constant across retries, rotated on success. */
+    idempotencyKey = crypto.randomUUID();
+    constructor() {
+        super();
+        this.status = { kind: "idle" };
+        this.fieldErrors = {};
+    }
+    async submit(e) {
+        e.preventDefault();
+        const c = this.config;
+        if (!c || this.status.kind === "pending")
+            return;
+        const specs = parseFormFields(c.props.fieldsJson, c.context.locale);
+        if (specs instanceof Error)
+            return;
+        const form = e.target;
+        const values = {};
+        const errors = {};
+        for (const spec of specs) {
+            const el = form.elements.namedItem(spec.name);
+            const value = el?.value?.trim() ?? "";
+            if (spec.required && !value) {
+                errors[spec.name] = blockSdkMessage(c.context.locale, "form.validation.required", { label: spec.label });
+            }
+            values[spec.name] = value;
+        }
+        this.fieldErrors = errors;
+        if (Object.keys(errors).length > 0)
+            return; // visible inline, no request
+        this.status = { kind: "pending" };
+        try {
+            const res = await fetch(String(c.props.action ?? "/__form"), {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    formId: String(c.props.formId ?? ""),
+                    instanceId: c.data.instanceId,
+                    idempotencyKey: this.idempotencyKey,
+                    values,
+                }),
+            });
+            if (res.ok) {
+                this.idempotencyKey = crypto.randomUUID(); // next intent = next key
+                this.status = {
+                    kind: "success",
+                    message: String(c.props.successMessage ?? blockSdkMessage(c.context.locale, "form.status.processed")),
+                };
+                form.reset();
+            }
+            else {
+                this.status = { kind: "error", message: await res.text() };
+            }
+        }
+        catch {
+            this.status = { kind: "error", message: blockSdkMessage(c.context.locale, "form.status.connectionFailed") };
+        }
+    }
+    render() {
+        const c = this.config;
+        if (!c)
+            return html `<p class="be-unconfigured">${blockSdkMessage(undefined, "block.unconfigured")}</p>`;
+        const title = typeof c.props.title === "string" ? c.props.title : "";
+        const specs = parseFormFields(c.props.fieldsJson, c.context.locale);
+        if (specs instanceof Error) {
+            return html `<p class="be-form-error" role="alert">
+        ${blockSdkMessage(c.context.locale, "form.config.invalid", { message: specs.message })}
+      </p>`;
+        }
+        return html `<form @submit=${(e) => void this.submit(e)} novalidate>
+      ${title ? html `<h3>${title}</h3>` : nothing}
+      ${specs.map((spec) => html `<label>
+          ${spec.label}${spec.required ? " *" : ""}
+          ${spec.multiline
+            ? html `<textarea name=${spec.name} rows="3"></textarea>`
+            : html `<input name=${spec.name} type="text" />`}
+          ${this.fieldErrors[spec.name]
+            ? html `<span class="be-field-error" role="alert">${this.fieldErrors[spec.name]}</span>`
+            : nothing}
+        </label>`)}
+      <button type="submit" ?disabled=${this.status.kind === "pending"}>
+        ${this.status.kind === "pending"
+            ? blockSdkMessage(c.context.locale, "form.status.pending")
+            : String(c.props.submitLabel ?? blockSdkMessage(c.context.locale, "form.default.submitLabel"))}
+      </button>
+      ${this.status.kind === "success"
+            ? html `<p class="be-form-success" role="status">${this.status.message}</p>`
+            : nothing}
+      ${this.status.kind === "error"
+            ? html `<p class="be-form-error" role="alert">${this.status.message}</p>`
+            : nothing}
+    </form>`;
+    }
+}
+export function createFormPackage(locale) {
+    const manifest = createFormManifest(locale);
+    return {
+        manifest,
+        stylesheets: [new URL("./form.css", import.meta.url).href],
+        defineElement: defineBlock(manifest, BatteryForm),
+    };
+}
+export const formPackage = createFormPackage("en");
+//# sourceMappingURL=form.js.map

package/dist/blocks/form.js.map

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

package/dist/blocks/image.css

@@ -0,0 +1 @@
+be-battery-image-v1 { display: block; }

package/dist/blocks/image.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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 { type TemplateResult } from "lit";
+import { type BlockManifest, type BlockPackage, type Locale } from "@batterai/contract";
+import { BatteryBlockElement } from "../base-element";
+export declare function createImageManifest(locale?: Locale | string): BlockManifest;
+export declare const imageManifest: BlockManifest;
+export type ImageView = "single" | "carousel" | "grid";
+/** The host-injected media payload (`config.data.media` or `.images`). */
+export interface ImageMediaData {
+    readonly src: string;
+    readonly srcset?: string;
+    readonly width: number;
+    readonly height: number;
+    readonly alt: string;
+    readonly title?: string;
+    readonly caption?: string;
+    readonly href?: string;
+    readonly focal?: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly aspectRatio?: string;
+    readonly sizing?: {
+        readonly width?: string;
+        readonly height?: string;
+        readonly objectFit?: "cover" | "contain" | "fill";
+    };
+    readonly opacity?: number;
+}
+export declare class BatteryImage extends BatteryBlockElement {
+    static styles: import("lit").CSSResult;
+    render(): TemplateResult;
+}
+export declare function createImagePackage(locale?: Locale | string): BlockPackage;
+export declare const imagePackage: BlockPackage;
+//# sourceMappingURL=image.d.ts.map