@derive-to/artifacts 0.0.0-stage → 0.6.0

package/dist/server/plugins/comments/index.js

@@ -0,0 +1,79 @@
+import * as z from "zod/mini";
+import { commentBodyInput, quoteSchema, threadStateSchema } from "../../../protocol/index.js";
+import { definePlugin } from "../../kit/plugin.js";
+import { defineTool } from "../../kit/tool.js";
+import { threadRoutes } from "./routes.js";
+import { threadService } from "./service.js";
+const body = commentBodyInput;
+const forModel = ["model"];
+export const comments = (options = {}) => definePlugin({
+    id: "comments",
+    features: ["anchors"],
+    instructions: 'People comment on selected text. To let them comment on a chart, image, or row, give that element a stable data-anchor="name" attribute.',
+    setup: (kit) => {
+        const threads = threadService(kit.backend, kit.events, options.identity);
+        return {
+            routes: threadRoutes(kit, threads),
+            after: {
+                // A version that says it answers threads resolves them, with a note people see.
+                "version.published": async ({ artifact, version, actor, addresses }) => {
+                    const open = new Set((await threads.list(artifact))
+                        .filter((thread) => thread.state === "open")
+                        .map((thread) => thread.id));
+                    const current = { ...artifact, currentVersion: version.n };
+                    for (const threadId of addresses.filter((id) => open.has(id))) {
+                        // oxlint-disable-next-line no-await-in-loop -- each thread's note and state in order
+                        await threads.reply(actor, current, threadId, `Addressed in v${version.n}.`);
+                        // oxlint-disable-next-line no-await-in-loop -- see above
+                        await threads.setState(actor, current, threadId, "resolved");
+                    }
+                },
+            },
+            tools: [
+                defineTool({
+                    name: "artifact_threads",
+                    description: "Read comment threads, each with the quoted text it is anchored to.",
+                    visibility: forModel,
+                    access: "view",
+                    input: z.object({}),
+                    run: async (_, { artifact }) => ({ threads: await threads.list(artifact) }),
+                }),
+                defineTool({
+                    name: "artifact_comment",
+                    description: "Start a thread, optionally anchored to a quote from the artifact.",
+                    visibility: forModel,
+                    access: "comment",
+                    input: z.object({ body, quote: z.optional(quoteSchema) }),
+                    run: async (a, { actor, artifact }) => ({
+                        thread: await threads.start(actor, artifact, {
+                            body: a.body,
+                            quote: a.quote ?? null,
+                            version: artifact.currentVersion,
+                        }),
+                    }),
+                }),
+                defineTool({
+                    name: "artifact_reply",
+                    description: "Reply in a thread.",
+                    visibility: forModel,
+                    access: "comment",
+                    input: z.object({ threadId: z.string(), body }),
+                    run: async (a, { actor, artifact }) => ({
+                        thread: await threads.reply(actor, artifact, a.threadId, a.body),
+                    }),
+                }),
+                defineTool({
+                    name: "artifact_resolve",
+                    description: "Resolve or reopen a thread.",
+                    visibility: forModel,
+                    access: "comment",
+                    input: z.object({ threadId: z.string(), state: threadStateSchema }),
+                    run: async (a, { actor, artifact }) => ({
+                        thread: await threads.setState(actor, artifact, a.threadId, a.state),
+                    }),
+                }),
+            ],
+        };
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/server/plugins/comments/index.js.map

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

package/dist/server/plugins/comments/routes.d.ts

@@ -0,0 +1,6 @@
+import { Hono } from "hono";
+import type { Core } from "../../core/index.js";
+import { type Env } from "../../http/gates.js";
+import type { ThreadService } from "./service.js";
+export declare const threadRoutes: ({ gates }: Core, threads: ThreadService) => Hono<Env, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=routes.d.ts.map

package/dist/server/plugins/comments/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/server/plugins/comments/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAG3B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAE/C,OAAO,EAAW,KAAK,GAAG,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAWjD,eAAO,MAAM,YAAY,cAAe,IAAI,WAAW,aAAa,qDA+BnE,CAAA"}

package/dist/server/plugins/comments/routes.js

@@ -0,0 +1,34 @@
+import { Hono } from "hono";
+import * as z from "zod/mini";
+import { commentBodyInput, quoteSchema, threadStateSchema } from "../../../protocol/index.js";
+import { readJson } from "../../http/body.js";
+import { actorOf } from "../../http/gates.js";
+const bodySchema = commentBodyInput;
+const startSchema = z.object({
+    body: bodySchema,
+    quote: z.nullable(quoteSchema),
+    version: z.int().check(z.positive()),
+});
+const replySchema = z.object({ body: bodySchema });
+const stateSchema = z.object({ state: threadStateSchema });
+export const threadRoutes = ({ gates }, threads) => {
+    const { guard } = gates;
+    const app = new Hono();
+    app.get("/artifacts/:id/threads", guard("view"), async (c) => c.json({ threads: await threads.list(c.get("artifact")) }));
+    app.post("/artifacts/:id/threads", guard("comment"), async (c) => {
+        const body = await readJson(c, startSchema);
+        return c.json({ thread: await threads.start(actorOf(c), c.get("artifact"), body) }, 201);
+    });
+    app.post("/artifacts/:id/threads/:threadId/comments", guard("comment"), async (c) => {
+        const { body } = await readJson(c, replySchema);
+        const thread = await threads.reply(actorOf(c), c.get("artifact"), c.req.param("threadId"), body);
+        return c.json({ thread }, 201);
+    });
+    app.patch("/artifacts/:id/threads/:threadId", guard("comment"), async (c) => {
+        const { state } = await readJson(c, stateSchema);
+        const thread = await threads.setState(actorOf(c), c.get("artifact"), c.req.param("threadId"), state);
+        return c.json({ thread });
+    });
+    return app;
+};
+//# sourceMappingURL=routes.js.map

package/dist/server/plugins/comments/routes.js.map

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

package/dist/server/plugins/comments/service.d.ts

@@ -0,0 +1,20 @@
+import type { Actor, Quote, Thread, ThreadState } from "../../../protocol/index.js";
+import type { Events } from "../../kit/events.js";
+import type { ArtifactRow, Backend } from "../../ports.js";
+export type ThreadIdentity = () => {
+    threadId: string;
+    commentId: string;
+};
+export interface ThreadService {
+    list(artifact: ArtifactRow): Promise<Thread[]>;
+    start(actor: Actor, artifact: ArtifactRow, input: {
+        body: string;
+        quote: Quote | null;
+        version: number;
+    }): Promise<Thread>;
+    reply(actor: Actor, artifact: ArtifactRow, threadId: string, body: string): Promise<Thread>;
+    setState(actor: Actor, artifact: ArtifactRow, threadId: string, state: ThreadState): Promise<Thread>;
+}
+/** The host can retain its stored relation between root comment and thread identities. */
+export declare const threadService: ({ store }: Pick<Backend, "store">, events: Events, identity?: ThreadIdentity) => ThreadService;
+//# sourceMappingURL=service.d.ts.map

package/dist/server/plugins/comments/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/server/plugins/comments/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAInF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAc,MAAM,gBAAgB,CAAA;AAEtE,MAAM,MAAM,cAAc,GAAG,MAAM;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1E,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9C,KAAK,CACH,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAC5D,OAAO,CAAC,MAAM,CAAC,CAAA;IAClB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3F,QAAQ,CACN,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAAA;CACnB;AAOD,0FAA0F;AAC1F,eAAO,MAAM,aAAa,cACb,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,UACzB,MAAM,aACJ,cAAc,KACvB,aA4EF,CAAA"}

package/dist/server/plugins/comments/service.js

@@ -0,0 +1,66 @@
+import { notFound } from "../../core/errors.js";
+import { newId, nowIso } from "../../core/ids.js";
+import { threadViews } from "../../core/views.js";
+const separateIdentity = () => ({
+    threadId: newId("thr"),
+    commentId: newId("cmt"),
+});
+/** The host can retain its stored relation between root comment and thread identities. */
+export const threadService = ({ store }, events, identity = separateIdentity) => {
+    const comment = (fields, id = newId("cmt")) => ({
+        ...fields,
+        id,
+        createdAt: nowIso(),
+    });
+    /** The thread as it is now. Notifications run through the after-commit hooks. */
+    const changed = async (artifactId, threadId) => {
+        const { threads, comments } = await store.listThreads(artifactId);
+        const thread = threadViews(threads, comments).find((each) => each.id === threadId);
+        if (!thread)
+            throw notFound("No such thread.");
+        return thread;
+    };
+    /** Save one comment (the first of a new thread, or a reply) between the hooks. */
+    const post = async (actor, artifact, row, save) => {
+        await events.before("comment.create", { artifact, body: row.body, actor });
+        await save();
+        const thread = await changed(artifact.id, row.threadId);
+        const posted = thread.comments.find((each) => each.id === row.id);
+        if (posted)
+            await events.after("comment.created", { artifact, thread, comment: posted, actor });
+        return thread;
+    };
+    return {
+        list: async (artifact) => {
+            const { threads, comments } = await store.listThreads(artifact.id);
+            return threadViews(threads, comments);
+        },
+        start: async (actor, artifact, input) => {
+            const { threadId, commentId } = identity();
+            const first = comment({ artifactId: artifact.id, threadId, author: actor, ...input }, commentId);
+            return post(actor, artifact, first, () => store.createThread({ id: threadId, artifactId: artifact.id, state: "open" }, first));
+        },
+        reply: async (actor, artifact, threadId, body) => {
+            const { threads } = await store.listThreads(artifact.id);
+            if (!threads.some((thread) => thread.id === threadId))
+                throw notFound("No such thread.");
+            const row = comment({
+                artifactId: artifact.id,
+                threadId,
+                body,
+                author: actor,
+                version: artifact.currentVersion,
+                quote: null,
+            }, identity().commentId);
+            return post(actor, artifact, row, () => store.addComment(row));
+        },
+        setState: async (actor, artifact, threadId, state) => {
+            if (!(await store.setThreadState(artifact.id, threadId, state)))
+                throw notFound("No such thread.");
+            const thread = await changed(artifact.id, threadId);
+            await events.after("thread.updated", { artifact, thread, actor });
+            return thread;
+        },
+    };
+};
+//# sourceMappingURL=service.js.map

package/dist/server/plugins/comments/service.js.map

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

package/dist/server/plugins/components/catalog.d.ts

@@ -0,0 +1,15 @@
+import * as z from "zod/mini";
+import type { TagUse } from "./tags.js";
+export interface Component {
+    /** The tag after the prefix: "metric" in <sift-metric>. */
+    name: string;
+    /** What it shows and when to use it, for agents. */
+    description: string;
+    /** Attributes, all strings in HTML: use z.string, z.enum, and the like. */
+    props: z.ZodMiniObject;
+}
+/** The agent's guide to a pack, generated from the components so it can never drift. */
+export declare const catalog: (prefix: string, components: readonly Component[]) => string;
+/** What is wrong with one use of a pack tag, as sentences an agent can fix. */
+export declare const check: (prefix: string, components: readonly Component[], use: TagUse) => string[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/server/plugins/components/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/server/plugins/components/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAE7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEvC,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAA;IACnB,2EAA2E;IAC3E,KAAK,EAAE,CAAC,CAAC,aAAa,CAAA;CACvB;AAuBD,wFAAwF;AACxF,eAAO,MAAM,OAAO,WAAY,MAAM,cAAc,SAAS,SAAS,EAAE,KAAG,MAS7D,CAAA;AAKd,+EAA+E;AAC/E,eAAO,MAAM,KAAK,WAAY,MAAM,cAAc,SAAS,SAAS,EAAE,OAAO,MAAM,KAAG,MAAM,EAe3F,CAAA"}

package/dist/server/plugins/components/catalog.js

@@ -0,0 +1,39 @@
+import * as z from "zod/mini";
+import { toJSONSchema } from "zod/v4/core";
+const attributeDocs = (props) => {
+    const schema = toJSONSchema(props, { io: "input" });
+    const required = new Set(schema.required ?? []);
+    return Object.entries(schema.properties ?? {}).map(([name, doc]) => {
+        const kind = doc.enum ? doc.enum.map((v) => `"${v}"`).join(" | ") : (doc.type ?? "string");
+        const note = doc.description ? ` ${doc.description}` : "";
+        return `${name}${required.has(name) ? "" : " (optional)"}: ${kind}.${note}`;
+    });
+};
+const tagOf = (prefix, component) => `<${prefix}-${component.name}>`;
+/** The agent's guide to a pack, generated from the components so it can never drift. */
+export const catalog = (prefix, components) => [
+    `You can use these components in artifact HTML. They load live data for whoever is viewing; write them as custom elements with string attributes. Any other <${prefix}-…> tag is refused.`,
+    ...components.map((component) => [
+        `${tagOf(prefix, component)}: ${component.description}`,
+        ...attributeDocs(component.props).map((line) => `  ${line}`),
+    ].join("\n")),
+].join("\n");
+/** Attributes every element may carry, never part of a component's contract. */
+const GLOBAL = /^(?:id|class|style|slot|hidden|title|lang|dir|tabindex|data-.+|aria-.+)$/;
+/** What is wrong with one use of a pack tag, as sentences an agent can fix. */
+export const check = (prefix, components, use) => {
+    const component = components.find((each) => `${prefix}-${each.name}` === use.tag);
+    if (!component) {
+        const known = components.map((each) => tagOf(prefix, each)).join(", ");
+        return [`<${use.tag}> is not a component here; use one of ${known}.`];
+    }
+    const own = Object.fromEntries(Object.entries(use.attributes).filter(([name]) => !GLOBAL.test(name)));
+    const parsed = z.strictObject(component.props.shape).safeParse(own);
+    if (parsed.success)
+        return [];
+    return parsed.error.issues.map((issue) => {
+        const where = issue.path.join(".") || "attributes";
+        return `<${use.tag}> ${where}: ${issue.message}.`;
+    });
+};
+//# sourceMappingURL=catalog.js.map

package/dist/server/plugins/components/catalog.js.map

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

package/dist/server/plugins/components/index.d.ts

@@ -0,0 +1,21 @@
+import type { ToolDef } from "../../kit/tool.js";
+import { type Component } from "./catalog.js";
+import { type TagUse } from "./tags.js";
+export interface ComponentPackOptions {
+    /** Every tag starts with it: "sift" gives <sift-metric>. Lowercase letters and digits. */
+    prefix: string;
+    components: readonly Component[];
+    /** JavaScript that defines the elements (`customElements.define`), loaded into every
+     *  artifact. Elements reach your data with `window.artifact.call(tool, args)`. */
+    script: string;
+    /** The tools your elements call, usually visibility ["app"]. */
+    tools?: readonly ToolDef[];
+    /** If set, refuse tags whose saved source cannot render without live tools. */
+    exportable?: (use: TagUse) => boolean;
+}
+/** Your own components inside artifacts, OpenUI-style: typed contracts, a catalog generated
+ *  for agents, and only registered tags with valid attributes accepted at publish. They run
+ *  in the sandbox and get data only through your tools, as the person viewing. */
+export declare const componentPack: (options: ComponentPackOptions) => import("../../kit/plugin.js").ArtifactPlugin;
+export type { Component } from "./catalog.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/plugins/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/plugins/components/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,KAAK,SAAS,EAAkB,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAkB,MAAM,WAAW,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACnC,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;IAChC;sFACkF;IAClF,MAAM,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IAC1B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CACtC;AAED;;kFAEkF;AAClF,eAAO,MAAM,aAAa,YAAa,oBAAoB,iDA8B1D,CAAA;AAED,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA"}

package/dist/server/plugins/components/index.js

@@ -0,0 +1,35 @@
+import { refused } from "../../core/errors.js";
+import { definePlugin } from "../../kit/plugin.js";
+import { catalog, check } from "./catalog.js";
+import { tagsWithPrefix } from "./tags.js";
+/** Your own components inside artifacts, OpenUI-style: typed contracts, a catalog generated
+ *  for agents, and only registered tags with valid attributes accepted at publish. They run
+ *  in the sandbox and get data only through your tools, as the person viewing. */
+export const componentPack = (options) => {
+    const { prefix, components } = options;
+    if (!/^[a-z][a-z0-9]*$/.test(prefix))
+        throw new Error("A pack prefix is lowercase letters and digits.");
+    return definePlugin({
+        id: `components:${prefix}`,
+        features: ["components"],
+        instructions: catalog(prefix, components),
+        sandbox: [options.script],
+        setup: () => ({
+            tools: options.tools ?? [],
+            before: {
+                "version.export": ({ html }) => {
+                    const unsupported = options.exportable &&
+                        tagsWithPrefix(html, prefix).find((use) => !options.exportable?.(use));
+                    if (unsupported)
+                        throw refused("This edition contains live content. Create an edition with frozen data before exporting.");
+                },
+                "version.publish": ({ html }) => {
+                    const problems = tagsWithPrefix(html, prefix).flatMap((use) => check(prefix, components, use));
+                    if (problems.length > 0)
+                        throw refused(problems.slice(0, 5).join(" "));
+                },
+            },
+        }),
+    });
+};
+//# sourceMappingURL=index.js.map

package/dist/server/plugins/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/plugins/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAkB,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAe,cAAc,EAAE,MAAM,WAAW,CAAA;AAevD;;kFAEkF;AAClF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAA6B,EAAE,EAAE;IAC7D,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAA;IACtC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAA;IACnE,OAAO,YAAY,CAAC;QAClB,EAAE,EAAE,cAAc,MAAM,EAAE;QAC1B,QAAQ,EAAE,CAAC,YAAY,CAAC;QACxB,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC;QACzC,OAAO,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QACzB,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACZ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,EAAE;gBACN,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;oBAC7B,MAAM,WAAW,GACf,OAAO,CAAC,UAAU;wBAClB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;oBACxE,IAAI,WAAW;wBACb,MAAM,OAAO,CACX,0FAA0F,CAC3F,CAAA;gBACL,CAAC;gBACD,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;oBAC9B,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAC5D,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,CAC/B,CAAA;oBACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;wBAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;gBACxE,CAAC;aACF;SACF,CAAC;KACH,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/server/plugins/components/tags.d.ts

@@ -0,0 +1,9 @@
+/** A custom element as written in HTML: its tag and attributes, all strings. */
+export interface TagUse {
+    tag: string;
+    attributes: Record<string, string>;
+}
+/** Every custom element whose tag starts with `prefix-`, in order. A tolerant scan, not a
+ *  full parser: enough to check what an agent wrote against a catalog. */
+export declare const tagsWithPrefix: (html: string, prefix: string) => TagUse[];
+//# sourceMappingURL=tags.d.ts.map

package/dist/server/plugins/components/tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../../../src/server/plugins/components/tags.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC;AAeD;0EAC0E;AAC1E,eAAO,MAAM,cAAc,SAAU,MAAM,UAAU,MAAM,KAAG,MAAM,EAW7D,CAAA"}

package/dist/server/plugins/components/tags.js

@@ -0,0 +1,22 @@
+// Quoted attribute values may hold ">" or "<" (a query such as createdAt>-30d), so the
+// attribute part is quoted runs or any character but a bracket or quote.
+const TAG = /<([a-z][a-z0-9]*-[a-z0-9-]*)((?:\s(?:"[^"]*"|'[^']*'|[^<>"'])*)?)>/gi;
+const ATTRIBUTE = /([^\s"'=<>/`]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'=<>`]+)))?/g;
+const decode = (value) => value
+    .replace(/&quot;/g, '"')
+    .replace(/&#39;/g, "'")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&amp;/g, "&");
+/** Every custom element whose tag starts with `prefix-`, in order. A tolerant scan, not a
+ *  full parser: enough to check what an agent wrote against a catalog. */
+export const tagsWithPrefix = (html, prefix) => [...html.matchAll(TAG)]
+    .filter(([, tag = ""]) => tag.toLowerCase().startsWith(`${prefix}-`))
+    .map(([, tag = "", rest = ""]) => ({
+    tag: tag.toLowerCase(),
+    attributes: Object.fromEntries([...rest.replace(/\/\s*$/, "").matchAll(ATTRIBUTE)].map(([, name = "", a, b, c]) => [
+        name.toLowerCase(),
+        decode(a ?? b ?? c ?? ""),
+    ])),
+}));
+//# sourceMappingURL=tags.js.map

package/dist/server/plugins/components/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../../../src/server/plugins/components/tags.ts"],"names":[],"mappings":"AAMA,uFAAuF;AACvF,yEAAyE;AACzE,MAAM,GAAG,GAAG,sEAAsE,CAAA;AAClF,MAAM,SAAS,GAAG,oEAAoE,CAAA;AAEtF,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAC/B,KAAK;KACF,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;KACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;KACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;KACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;KACrB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;AAE3B;0EAC0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,MAAc,EAAY,EAAE,CACvE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;KACpB,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;KACpE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACjC,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE;IACtB,UAAU,EAAE,MAAM,CAAC,WAAW,CAC5B,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;QAClF,IAAI,CAAC,WAAW,EAAE;QAClB,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KAC1B,CAAC,CACH;CACF,CAAC,CAAC,CAAA"}

package/dist/server/plugins/editing/apply.d.ts

@@ -0,0 +1,9 @@
+import { type TextEdit } from "../../../protocol/index.js";
+/** Apply text edits to an artifact's source HTML, one after another. Each quote must be
+ *  found exactly once (or pinned by its context) inside one run of text; otherwise the
+ *  edit is refused with a sentence that says why, and nothing changes. */
+export declare const applyTextEdits: (html: string, edits: readonly TextEdit[]) => string;
+/** Mark every text block written in the source, so the page offers only those for editing:
+ *  rows and labels a script draws are not in the source, and could not be saved. */
+export declare const markSourceBlocks: (html: string) => string;
+//# sourceMappingURL=apply.d.ts.map

package/dist/server/plugins/editing/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../../src/server/plugins/editing/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,4BAA4B,CAAA;AAOnC;;0EAE0E;AAC1E,eAAO,MAAM,cAAc,SAAU,MAAM,SAAS,SAAS,QAAQ,EAAE,KAAG,MAiBhE,CAAA;AAQV;oFACoF;AACpF,eAAO,MAAM,gBAAgB,SAAU,MAAM,KAAG,MAC8C,CAAA"}

package/dist/server/plugins/editing/apply.js

@@ -0,0 +1,30 @@
+import { EDITABLE_BLOCKS, findQuoteStrictly, SOURCE_BLOCK, } from "../../../protocol/index.js";
+import { serializeSourceText } from "../../../protocol/source.js";
+import { badRequest } from "../../core/errors.js";
+import { sourceText } from "./source-text.js";
+const short = (text) => (text.length > 60 ? `${text.slice(0, 57)}…` : text);
+/** Apply text edits to an artifact's source HTML, one after another. Each quote must be
+ *  found exactly once (or pinned by its context) inside one run of text; otherwise the
+ *  edit is refused with a sentence that says why, and nothing changes. */
+export const applyTextEdits = (html, edits) => edits.reduce((source, edit) => {
+    const page = sourceText(source);
+    const span = findQuoteStrictly(page.text, edit.quote);
+    const words = `"${short(edit.quote.exact)}"`;
+    if (span === "ambiguous")
+        throw badRequest(`${words} appears more than once; include a little text around it.`);
+    if (!span)
+        throw badRequest(`${words} is not in the page's source; text a script draws cannot be edited here.`);
+    const range = page.sourceOf(span.start, span.end);
+    if (!range)
+        throw badRequest(`${words} crosses formatting; edit the plain words inside it.`);
+    const replacement = serializeSourceText(edit.text, range.literal);
+    if (replacement === null)
+        throw badRequest(`${words} is literal HTML text; use a source edit for less-than characters.`);
+    return source.slice(0, range.at) + replacement + source.slice(range.end);
+}, html);
+/** Script and style bodies, which must never be touched, or an editable block's opening tag. */
+const OPENING = new RegExp(`(<script\\b[\\s\\S]*?</script>|<style\\b[\\s\\S]*?</style>)|<(?:${EDITABLE_BLOCKS.join("|")})(?=[\\s>/])`, "gi");
+/** Mark every text block written in the source, so the page offers only those for editing:
+ *  rows and labels a script draws are not in the source, and could not be saved. */
+export const markSourceBlocks = (html) => html.replace(OPENING, (match, raw) => raw ?? `${match} ${SOURCE_BLOCK}`);
+//# sourceMappingURL=apply.js.map

package/dist/server/plugins/editing/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../../src/server/plugins/editing/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,YAAY,GAEb,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAEnF;;0EAE0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,KAA0B,EAAU,EAAE,CACjF,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;IAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IACrD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAA;IAC5C,IAAI,IAAI,KAAK,WAAW;QACtB,MAAM,UAAU,CAAC,GAAG,KAAK,2DAA2D,CAAC,CAAA;IACvF,IAAI,CAAC,IAAI;QACP,MAAM,UAAU,CACd,GAAG,KAAK,0EAA0E,CACnF,CAAA;IACH,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;IACjD,IAAI,CAAC,KAAK;QAAE,MAAM,UAAU,CAAC,GAAG,KAAK,sDAAsD,CAAC,CAAA;IAC5F,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IACjE,IAAI,WAAW,KAAK,IAAI;QACtB,MAAM,UAAU,CAAC,GAAG,KAAK,oEAAoE,CAAC,CAAA;IAChG,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAC1E,CAAC,EAAE,IAAI,CAAC,CAAA;AAEV,gGAAgG;AAChG,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,mEAAmE,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,EAC1G,IAAI,CACL,CAAA;AAED;oFACoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAU,EAAE,CACvD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,GAAuB,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,KAAK,IAAI,YAAY,EAAE,CAAC,CAAA"}

package/dist/server/plugins/editing/index.d.ts

@@ -0,0 +1,8 @@
+import { type ArtifactPlugin } from "../../kit/plugin.js";
+import { type InlineEditingOptions } from "./source.js";
+export type { InlineEditingOptions, SourceEditor } from "./source.js";
+/** Change words in place. People edit text in the page (the host toggles editing over the
+ *  extension); agents fix a sentence without republishing the whole page. Every save is a
+ *  new version, held to the same publish rules and hooks. */
+export declare const inlineEditing: (options?: InlineEditingOptions) => ArtifactPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/plugins/editing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/plugins/editing/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAgB,MAAM,qBAAqB,CAAA;AAGvE,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAE3E,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAErE;;6DAE6D;AAC7D,eAAO,MAAM,aAAa,aAAa,oBAAoB,KAAQ,cAyC/D,CAAA"}

package/dist/server/plugins/editing/index.js

@@ -0,0 +1,48 @@
+import * as z from "zod/mini";
+import { artifactLayoutSchema, textEditSchema } from "../../../protocol/index.js";
+import { badRequest, versionMoved } from "../../core/errors.js";
+import { definePlugin } from "../../kit/plugin.js";
+import { defineTool } from "../../kit/tool.js";
+import { markSourceBlocks } from "./apply.js";
+import { editOriginalSource } from "./source.js";
+/** Change words in place. People edit text in the page (the host toggles editing over the
+ *  extension); agents fix a sentence without republishing the whole page. Every save is a
+ *  new version, held to the same publish rules and hooks. */
+export const inlineEditing = (options = {}) => definePlugin({
+    id: "editing",
+    features: ["editing", "layout"],
+    servePage: markSourceBlocks,
+    instructions: "For text or layout changes, use artifact_edit_text with the version you read. Quote exact text. For layout, return the complete declared metadata and keep every element and region ID. Layout changes never change widget content.",
+    setup: ({ artifacts }) => ({
+        tools: [
+            defineTool({
+                name: "artifact_edit_text",
+                description: "Save text and layout as one artifact version. Each text edit quotes exact words, with context when needed. Optional layout replaces declared geometry and keeps all element and region IDs. `expected` is the version you read.",
+                visibility: ["model"],
+                access: "edit",
+                input: z.object({
+                    expected: z.int(),
+                    edits: z.array(textEditSchema).check(z.maxLength(100)),
+                    layout: z.optional(artifactLayoutSchema),
+                    addresses: z.optional(z.array(z.string()).check(z.maxLength(50))),
+                }),
+                run: async (a, { actor, artifact }) => {
+                    if (a.expected !== artifact.currentVersion)
+                        throw versionMoved();
+                    const source = await artifacts.sourceBytes(artifact, a.expected);
+                    if (a.edits.length === 0 && !a.layout)
+                        throw badRequest("Provide text or layout changes.");
+                    const edited = await editOriginalSource({
+                        source,
+                        edits: a.edits,
+                        layout: a.layout,
+                        context: { artifact, version: a.expected },
+                    }, options.editSource);
+                    const input = { ...edited, expected: a.expected, addresses: a.addresses };
+                    return { version: await artifacts.publishSourceEdit(actor, artifact, input) };
+                },
+            }),
+        ],
+    }),
+});
+//# sourceMappingURL=index.js.map

package/dist/server/plugins/editing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/plugins/editing/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAA;AAC7B,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AACjF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAuB,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EAAE,kBAAkB,EAA6B,MAAM,aAAa,CAAA;AAI3E;;6DAE6D;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAO,GAAyB,EAAE,EAAkB,EAAE,CAClF,YAAY,CAAC;IACX,EAAE,EAAE,SAAS;IACb,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC/B,SAAS,EAAE,gBAAgB;IAC3B,YAAY,EACV,qOAAqO;IACvO,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACzB,KAAK,EAAE;YACL,UAAU,CAAC;gBACT,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EACT,iOAAiO;gBACnO,UAAU,EAAE,CAAC,OAAO,CAAC;gBACrB,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;oBACd,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE;oBACjB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;oBACtD,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;oBACxC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;iBAClE,CAAC;gBACF,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE;oBACpC,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,cAAc;wBAAE,MAAM,YAAY,EAAE,CAAA;oBAChE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAA;oBAChE,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;wBACnC,MAAM,UAAU,CAAC,iCAAiC,CAAC,CAAA;oBACrD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACrC;wBACE,MAAM;wBACN,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;qBAC3C,EACD,OAAO,CAAC,UAAU,CACnB,CAAA;oBACD,MAAM,KAAK,GAAG,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAA;oBACzE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAA;gBAC/E,CAAC;aACF,CAAC;SACH;KACF,CAAC;CACH,CAAC,CAAA"}

package/dist/server/plugins/editing/layout.d.ts

@@ -0,0 +1,4 @@
+import { type ArtifactLayout } from "../../../protocol/index.js";
+/** Replace only declared geometry. A save cannot insert, remove, or rename content. */
+export declare const applyLayout: (html: string, next: ArtifactLayout) => string;
+//# sourceMappingURL=layout.d.ts.map

package/dist/server/plugins/editing/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../src/server/plugins/editing/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,4BAA4B,CAAA;AAOnC,uFAAuF;AACvF,eAAO,MAAM,WAAW,SAAU,MAAM,QAAQ,cAAc,KAAG,MAqBhE,CAAA"}

package/dist/server/plugins/editing/layout.js

@@ -0,0 +1,29 @@
+import { LAYOUT_ATTRIBUTE, serializeLayout, validateLayout, } from "../../../protocol/index.js";
+import { badRequest } from "../../core/errors.js";
+// Match whole script bodies first. A string inside executable code is never a layout.
+const SCRIPTS = /<script\b((?:[^>"']|"[^"]*"|'[^']*')*)>([\s\S]*?)<\/script\s*>/gi;
+const DECLARED = new RegExp(`(?:^|\\s)${LAYOUT_ATTRIBUTE}(?=\\s|=|$)`, "i");
+/** Replace only declared geometry. A save cannot insert, remove, or rename content. */
+export const applyLayout = (html, next) => {
+    const matches = [...html.matchAll(SCRIPTS)].filter((match) => DECLARED.test(match[1] ?? ""));
+    const match = matches[0];
+    if (matches.length !== 1 || !match || match.index === undefined)
+        throw badRequest("This page does not declare one editable layout.");
+    let before;
+    try {
+        before = validateLayout(JSON.parse(match[2] ?? ""));
+        validateLayout(next);
+    }
+    catch {
+        throw badRequest("The page layout is invalid. Reload before editing.");
+    }
+    const sameIds = (a, b) => a.length === b.length && a.every((entry) => b.some((other) => other.id === entry.id));
+    if (!sameIds(before.regions, next.regions) || !sameIds(before.elements, next.elements))
+        throw badRequest("Layout edits must preserve every region and element.");
+    if (!/(?:^|\s)type\s*=\s*(["'])application\/json\1(?:\s|$)/i.test(match[1] ?? ""))
+        throw badRequest("The editable layout must be JSON metadata.");
+    const opening = `<script${match[1]}>`;
+    const replacement = `${opening}${serializeLayout(next)}</script>`;
+    return html.slice(0, match.index) + replacement + html.slice(match.index + match[0].length);
+};
+//# sourceMappingURL=layout.js.map

package/dist/server/plugins/editing/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../../src/server/plugins/editing/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD,sFAAsF;AACtF,MAAM,OAAO,GAAG,kEAAkE,CAAA;AAClF,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,YAAY,gBAAgB,aAAa,EAAE,GAAG,CAAC,CAAA;AAE3E,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,IAAoB,EAAU,EAAE;IACxE,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAC5F,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACxB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAC7D,MAAM,UAAU,CAAC,iDAAiD,CAAC,CAAA;IACrE,IAAI,MAAsB,CAAA;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACnD,cAAc,CAAC,IAAI,CAAC,CAAA;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,UAAU,CAAC,oDAAoD,CAAC,CAAA;IACxE,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,CAAmB,EAAE,CAAmB,EAAE,EAAE,CAC3D,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IACvF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;QACpF,MAAM,UAAU,CAAC,sDAAsD,CAAC,CAAA;IAC1E,IAAI,CAAC,uDAAuD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/E,MAAM,UAAU,CAAC,4CAA4C,CAAC,CAAA;IAChE,MAAM,OAAO,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,GAAG,CAAA;IACrC,MAAM,WAAW,GAAG,GAAG,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,WAAW,CAAA;IACjE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAC7F,CAAC,CAAA"}

package/dist/server/plugins/editing/source-text.d.ts

@@ -0,0 +1,10 @@
+/** Shared projection: source offsets use runs rather than a map entry for every character. */
+export declare const sourceText: (html: string) => {
+    text: string;
+    sourceOf: (start: number, end: number) => {
+        at: number;
+        end: number;
+        literal?: true;
+    } | null;
+};
+//# sourceMappingURL=source-text.d.ts.map

package/dist/server/plugins/editing/source-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-text.d.ts","sourceRoot":"","sources":["../../../../src/server/plugins/editing/source-text.ts"],"names":[],"mappings":"AAEA,8FAA8F;AAC9F,eAAO,MAAM,UAAU,SAAU,MAAM;IAGnC,IAAI;IACJ,QAAQ,UAAU,MAAM,OAAO,MAAM;;;;;CAExC,CAAA"}