@upstart.gg/vite-plugins 0.1.83 → 0.1.85

package/dist/site-theme.d.ts

@@ -0,0 +1,55 @@
+import z from "zod";
+
+//#region src/site-theme.d.ts
+/** The theme colors the panel edits, in the theme file's naming. */
+declare const EDITABLE_THEME_COLORS: readonly ["base100", "base200", "base300", "baseContent", "primary", "primaryContent", "secondary", "secondaryContent", "accent", "accentContent", "neutral", "neutralContent"];
+type EditableThemeColor = (typeof EDITABLE_THEME_COLORS)[number];
+type ThemeColors = Partial<Record<EditableThemeColor, string>>;
+declare const payloadGetTheme: z.ZodObject<{
+  action: z.ZodLiteral<"getTheme">;
+}, z.core.$strip>;
+type PayloadGetTheme = z.infer<typeof payloadGetTheme>;
+declare const payloadSetTheme: z.ZodObject<{
+  action: z.ZodLiteral<"setTheme">;
+  colors: z.ZodRecord<z.ZodEnum<{
+    accent: "accent";
+    accentContent: "accentContent";
+    base100: "base100";
+    base200: "base200";
+    base300: "base300";
+    baseContent: "baseContent";
+    neutral: "neutral";
+    neutralContent: "neutralContent";
+    primary: "primary";
+    primaryContent: "primaryContent";
+    secondary: "secondary";
+    secondaryContent: "secondaryContent";
+  }> & z.core.$partial, z.ZodString>;
+}, z.core.$strip>;
+type PayloadSetTheme = z.infer<typeof payloadSetTheme>;
+interface ThemePalette {
+  /** Stable id: "current" for the chosen mockup, "palette-<n>" for its variants. */
+  id: string;
+  /** The catalog palette's description, when known (e.g. "Blush base, deep rose text…"). */
+  label: string;
+  colors: ThemeColors;
+}
+type GetThemeResult = {
+  success: true;
+  themeId: string;
+  colors: ThemeColors;
+  palettes: ThemePalette[];
+} | {
+  success: false;
+  error: string;
+};
+type SetThemeResult = {
+  success: true;
+  filePaths: string[];
+} | {
+  success: false;
+  error: string;
+};
+//#endregion
+export { EDITABLE_THEME_COLORS, EditableThemeColor, GetThemeResult, PayloadGetTheme, PayloadSetTheme, SetThemeResult, ThemeColors, ThemePalette, payloadGetTheme, payloadSetTheme };
+//# sourceMappingURL=site-theme.d.ts.map

package/dist/site-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-theme.d.ts","names":[],"sources":["../src/site-theme.ts"],"mappings":";;;;cAiBa,qBAAA;AAAA,KAcD,kBAAA,WAA6B,qBAAA;AAAA,KAC7B,WAAA,GAAc,OAAA,CAAQ,MAAA,CAAO,kBAAA;AAAA,cAS5B,eAAA,EAAe,CAAA,CAAA,SAAA;;;KAChB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,eAAA;AAAA,cAEhC,eAAA,EAAe,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;KAIhB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,eAAA;AAAA,UAE5B,YAAA;;EAEf,EAAA;;EAEA,KAAA;EACA,MAAA,EAAQ,WAAA;AAAA;AAAA,KAGE,cAAA;EACN,OAAA;EAAe,OAAA;EAAiB,MAAA,EAAQ,WAAA;EAAa,QAAA,EAAU,YAAA;AAAA;EAC/D,OAAA;EAAgB,KAAA;AAAA;AAAA,KAEV,cAAA;EAAmB,OAAA;EAAe,SAAA;AAAA;EAA0B,OAAA;EAAgB,KAAA;AAAA"}

package/dist/site-theme.js

@@ -0,0 +1,184 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import z from "zod";
+//#region src/site-theme.ts
+/**
+* The site's colors, editable from the editor's "Colors" panel.
+*
+* A site's colors live in its theme file (`app/config/themes/<id>.json`, the one `site.json` names
+* as the default), read by the theme plugin at build time. A new site also keeps the palettes the
+* client was offered when choosing its look (`docs/mockups/<direction>/` and its `palettes/<n>/`
+* variants, see the `PaletteVariants` tool): the panel offers them again, next to a free picker.
+*
+* Saving also records in `docs/DESIGN.md` that the user chose the colors themselves: agents read
+* the brief before any UI work, and would otherwise bring the brief's palette back.
+*/
+/** The theme colors the panel edits, in the theme file's naming. */
+const EDITABLE_THEME_COLORS = [
+	"base100",
+	"base200",
+	"base300",
+	"baseContent",
+	"primary",
+	"primaryContent",
+	"secondary",
+	"secondaryContent",
+	"accent",
+	"accentContent",
+	"neutral",
+	"neutralContent"
+];
+/** A CSS color as theme files hold them: oklch(), hex, rgb() or hsl(). */
+const cssColor = z.string().trim().max(80).regex(/^(#[0-9a-fA-F]{3,8}|(oklch|oklab|rgba?|hsla?)\([0-9.,%\s/+-]+\))$/, "Not a CSS color");
+const payloadGetTheme = z.object({ action: z.literal("getTheme") });
+const payloadSetTheme = z.object({
+	action: z.literal("setTheme"),
+	colors: z.partialRecord(z.enum(EDITABLE_THEME_COLORS), cssColor)
+});
+/** Mockup token (Tailwind config of a mockup) → theme color. */
+const MOCKUP_TOKENS = {
+	"base-100": "base100",
+	"base-200": "base200",
+	"base-300": "base300",
+	"base-content": "baseContent",
+	primary: "primary",
+	"primary-content": "primaryContent",
+	secondary: "secondary",
+	"secondary-content": "secondaryContent",
+	accent: "accent",
+	"accent-content": "accentContent",
+	neutral: "neutral",
+	"neutral-content": "neutralContent"
+};
+/** The colors a mockup sets in its Tailwind config, in the theme's naming. */
+function mockupThemeColors(html) {
+	const script = [...html.matchAll(/<script\b[^>]*>([\s\S]*?)<\/script>/g)].find((m) => m[1].includes("tailwind.config"))?.[1];
+	const colors = {};
+	if (!script) return colors;
+	for (const [token, key] of Object.entries(MOCKUP_TOKENS)) {
+		const value = new RegExp(`['"]?${token.replace(/-/g, "\\-")}['"]?\\s*:\\s*(['"])([^'"]*)\\1`).exec(script)?.[2];
+		if (value && cssColor.safeParse(value).success) colors[key] = value.trim();
+	}
+	return colors;
+}
+/** The block `setTheme` keeps up to date at the end of the brief. */
+const BRIEF_START = "<!-- upstart:theme-colors -->";
+const BRIEF_END = "<!-- /upstart:theme-colors -->";
+function briefWithUserColors(brief, themeFile) {
+	const block = [
+		BRIEF_START,
+		"## Colors chosen by the user",
+		`The user set the site's colors themselves in the editor. \`${themeFile}\` is the source of truth for colors and wins over any palette above: keep its values, and use its tokens (bg-base-100, text-primary…) rather than new colors.`,
+		BRIEF_END
+	].join("\n");
+	const start = brief.indexOf(BRIEF_START);
+	const end = brief.indexOf(BRIEF_END);
+	if (start !== -1 && end > start) return `${brief.slice(0, start)}${block}${brief.slice(end + 30)}`;
+	return `${brief.trimEnd()}\n\n${block}\n`;
+}
+/** The theme file the site uses by default, from `app/config/site.json`. */
+async function defaultThemeFile(projectRoot) {
+	try {
+		const site = JSON.parse(await fs.readFile(path.join(projectRoot, "app", "config", "site.json"), "utf-8"));
+		const themeId = site.themes?.[site.themes.default ?? "light"] ?? site.themes?.light;
+		if (!themeId || !/^[a-z0-9-]+$/.test(themeId)) return null;
+		return {
+			themeId,
+			filePath: path.join(projectRoot, "app", "config", "themes", `${themeId}.json`)
+		};
+	} catch {
+		return null;
+	}
+}
+/** The mockup the brief names as its reference (`docs/mockups/<direction>/…`). */
+async function chosenMockup(projectRoot) {
+	const brief = await fs.readFile(path.join(projectRoot, "docs", "DESIGN.md"), "utf-8").catch(() => "");
+	return /docs\/mockups\/([a-z0-9-]+)\//.exec(brief)?.[1] ?? null;
+}
+/** The palettes the client was offered for the chosen mockup; none for an older site. */
+async function offeredPalettes(projectRoot) {
+	const direction = await chosenMockup(projectRoot);
+	if (!direction) return [];
+	const dir = path.join(projectRoot, "docs", "mockups", direction);
+	const readPalette = async (id, folder) => {
+		const colors = mockupThemeColors(await fs.readFile(path.join(folder, "index.html"), "utf-8").catch(() => ""));
+		if (Object.keys(colors).length < 3) return null;
+		return {
+			id,
+			label: (await fs.readFile(path.join(folder, "variant.json"), "utf-8").then((raw) => JSON.parse(raw)).catch(() => ({}))).palette ?? "",
+			colors
+		};
+	};
+	const variants = await fs.readdir(path.join(dir, "palettes")).catch(() => []);
+	return (await Promise.all([readPalette("current", dir), ...variants.filter((n) => /^\d+$/.test(n)).sort((a, b) => Number(a) - Number(b)).map((n) => readPalette(`palette-${n}`, path.join(dir, "palettes", n)))])).filter((p) => p !== null);
+}
+async function getSiteTheme(projectRoot) {
+	const theme = await defaultThemeFile(projectRoot);
+	if (!theme) return {
+		success: false,
+		error: "This site has no theme in app/config/site.json"
+	};
+	try {
+		const content = JSON.parse(await fs.readFile(theme.filePath, "utf-8"));
+		const colors = {};
+		for (const key of EDITABLE_THEME_COLORS) {
+			const value = content.colors?.[key];
+			if (typeof value === "string") colors[key] = value;
+		}
+		return {
+			success: true,
+			themeId: theme.themeId,
+			colors,
+			palettes: await offeredPalettes(projectRoot)
+		};
+	} catch {
+		return {
+			success: false,
+			error: `The theme file app/config/themes/${theme.themeId}.json is missing`
+		};
+	}
+}
+async function setSiteTheme(projectRoot, params) {
+	const parsed = payloadSetTheme.safeParse(params);
+	if (!parsed.success) return {
+		success: false,
+		error: `Invalid payload: ${parsed.error.message}`
+	};
+	if (Object.keys(parsed.data.colors).length === 0) return {
+		success: true,
+		filePaths: []
+	};
+	const theme = await defaultThemeFile(projectRoot);
+	if (!theme) return {
+		success: false,
+		error: "This site has no theme in app/config/site.json"
+	};
+	try {
+		const content = JSON.parse(await fs.readFile(theme.filePath, "utf-8"));
+		content.colors = {
+			...content.colors,
+			...parsed.data.colors
+		};
+		await fs.writeFile(theme.filePath, `${JSON.stringify(content, null, 2)}\n`);
+		const filePaths = [theme.filePath];
+		const briefPath = path.join(projectRoot, "docs", "DESIGN.md");
+		const brief = await fs.readFile(briefPath, "utf-8").catch(() => null);
+		if (brief !== null) {
+			await fs.writeFile(briefPath, briefWithUserColors(brief, path.relative(projectRoot, theme.filePath)));
+			filePaths.push(briefPath);
+		}
+		return {
+			success: true,
+			filePaths
+		};
+	} catch (err) {
+		return {
+			success: false,
+			error: String(err)
+		};
+	}
+}
+//#endregion
+export { EDITABLE_THEME_COLORS, getSiteTheme, payloadGetTheme, payloadSetTheme, setSiteTheme };
+
+//# sourceMappingURL=site-theme.js.map

package/dist/site-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-theme.js","names":[],"sources":["../src/site-theme.ts"],"sourcesContent":["/**\n * The site's colors, editable from the editor's \"Colors\" panel.\n *\n * A site's colors live in its theme file (`app/config/themes/<id>.json`, the one `site.json` names\n * as the default), read by the theme plugin at build time. A new site also keeps the palettes the\n * client was offered when choosing its look (`docs/mockups/<direction>/` and its `palettes/<n>/`\n * variants, see the `PaletteVariants` tool): the panel offers them again, next to a free picker.\n *\n * Saving also records in `docs/DESIGN.md` that the user chose the colors themselves: agents read\n * the brief before any UI work, and would otherwise bring the brief's palette back.\n */\n\nimport fs from \"fs/promises\";\nimport path from \"path\";\nimport z from \"zod\";\n\n/** The theme colors the panel edits, in the theme file's naming. */\nexport const EDITABLE_THEME_COLORS = [\n  \"base100\",\n  \"base200\",\n  \"base300\",\n  \"baseContent\",\n  \"primary\",\n  \"primaryContent\",\n  \"secondary\",\n  \"secondaryContent\",\n  \"accent\",\n  \"accentContent\",\n  \"neutral\",\n  \"neutralContent\",\n] as const;\nexport type EditableThemeColor = (typeof EDITABLE_THEME_COLORS)[number];\nexport type ThemeColors = Partial<Record<EditableThemeColor, string>>;\n\n/** A CSS color as theme files hold them: oklch(), hex, rgb() or hsl(). */\nconst cssColor = z\n  .string()\n  .trim()\n  .max(80)\n  .regex(/^(#[0-9a-fA-F]{3,8}|(oklch|oklab|rgba?|hsla?)\\([0-9.,%\\s/+-]+\\))$/, \"Not a CSS color\");\n\nexport const payloadGetTheme = z.object({ action: z.literal(\"getTheme\") });\nexport type PayloadGetTheme = z.infer<typeof payloadGetTheme>;\n\nexport const payloadSetTheme = z.object({\n  action: z.literal(\"setTheme\"),\n  colors: z.partialRecord(z.enum(EDITABLE_THEME_COLORS), cssColor),\n});\nexport type PayloadSetTheme = z.infer<typeof payloadSetTheme>;\n\nexport interface ThemePalette {\n  /** Stable id: \"current\" for the chosen mockup, \"palette-<n>\" for its variants. */\n  id: string;\n  /** The catalog palette's description, when known (e.g. \"Blush base, deep rose text…\"). */\n  label: string;\n  colors: ThemeColors;\n}\n\nexport type GetThemeResult =\n  | { success: true; themeId: string; colors: ThemeColors; palettes: ThemePalette[] }\n  | { success: false; error: string };\n\nexport type SetThemeResult = { success: true; filePaths: string[] } | { success: false; error: string };\n\n/** Mockup token (Tailwind config of a mockup) → theme color. */\nconst MOCKUP_TOKENS: Record<string, EditableThemeColor> = {\n  \"base-100\": \"base100\",\n  \"base-200\": \"base200\",\n  \"base-300\": \"base300\",\n  \"base-content\": \"baseContent\",\n  primary: \"primary\",\n  \"primary-content\": \"primaryContent\",\n  secondary: \"secondary\",\n  \"secondary-content\": \"secondaryContent\",\n  accent: \"accent\",\n  \"accent-content\": \"accentContent\",\n  neutral: \"neutral\",\n  \"neutral-content\": \"neutralContent\",\n};\n\n/** The colors a mockup sets in its Tailwind config, in the theme's naming. */\nexport function mockupThemeColors(html: string): ThemeColors {\n  const script = [...html.matchAll(/<script\\b[^>]*>([\\s\\S]*?)<\\/script>/g)].find((m) =>\n    m[1].includes(\"tailwind.config\"),\n  )?.[1];\n  const colors: ThemeColors = {};\n  if (!script) return colors;\n  for (const [token, key] of Object.entries(MOCKUP_TOKENS)) {\n    const pattern = new RegExp(`['\"]?${token.replace(/-/g, \"\\\\-\")}['\"]?\\\\s*:\\\\s*(['\"])([^'\"]*)\\\\1`);\n    const value = pattern.exec(script)?.[2];\n    if (value && cssColor.safeParse(value).success) colors[key] = value.trim();\n  }\n  return colors;\n}\n\n/** The block `setTheme` keeps up to date at the end of the brief. */\nconst BRIEF_START = \"<!-- upstart:theme-colors -->\";\nconst BRIEF_END = \"<!-- /upstart:theme-colors -->\";\n\nexport function briefWithUserColors(brief: string, themeFile: string): string {\n  const block = [\n    BRIEF_START,\n    \"## Colors chosen by the user\",\n    `The user set the site's colors themselves in the editor. \\`${themeFile}\\` is the source of truth for colors and wins over any palette above: keep its values, and use its tokens (bg-base-100, text-primary…) rather than new colors.`,\n    BRIEF_END,\n  ].join(\"\\n\");\n  const start = brief.indexOf(BRIEF_START);\n  const end = brief.indexOf(BRIEF_END);\n  if (start !== -1 && end > start) {\n    return `${brief.slice(0, start)}${block}${brief.slice(end + BRIEF_END.length)}`;\n  }\n  return `${brief.trimEnd()}\\n\\n${block}\\n`;\n}\n\n/** The theme file the site uses by default, from `app/config/site.json`. */\nasync function defaultThemeFile(projectRoot: string): Promise<{ themeId: string; filePath: string } | null> {\n  try {\n    const site = JSON.parse(\n      await fs.readFile(path.join(projectRoot, \"app\", \"config\", \"site.json\"), \"utf-8\"),\n    ) as {\n      themes?: { light?: string; dark?: string; default?: \"light\" | \"dark\" };\n    };\n    const themeId = site.themes?.[site.themes.default ?? \"light\"] ?? site.themes?.light;\n    if (!themeId || !/^[a-z0-9-]+$/.test(themeId)) return null;\n    return { themeId, filePath: path.join(projectRoot, \"app\", \"config\", \"themes\", `${themeId}.json`) };\n  } catch {\n    return null;\n  }\n}\n\n/** The mockup the brief names as its reference (`docs/mockups/<direction>/…`). */\nasync function chosenMockup(projectRoot: string): Promise<string | null> {\n  const brief = await fs.readFile(path.join(projectRoot, \"docs\", \"DESIGN.md\"), \"utf-8\").catch(() => \"\");\n  return /docs\\/mockups\\/([a-z0-9-]+)\\//.exec(brief)?.[1] ?? null;\n}\n\n/** The palettes the client was offered for the chosen mockup; none for an older site. */\nexport async function offeredPalettes(projectRoot: string): Promise<ThemePalette[]> {\n  const direction = await chosenMockup(projectRoot);\n  if (!direction) return [];\n  const dir = path.join(projectRoot, \"docs\", \"mockups\", direction);\n  const readPalette = async (id: string, folder: string): Promise<ThemePalette | null> => {\n    const html = await fs.readFile(path.join(folder, \"index.html\"), \"utf-8\").catch(() => \"\");\n    const colors = mockupThemeColors(html);\n    if (Object.keys(colors).length < 3) return null;\n    const variant = await fs\n      .readFile(path.join(folder, \"variant.json\"), \"utf-8\")\n      .then((raw) => JSON.parse(raw) as { palette?: string })\n      .catch((): { palette?: string } => ({}));\n    return { id, label: variant.palette ?? \"\", colors };\n  };\n  const variants = await fs.readdir(path.join(dir, \"palettes\")).catch((): string[] => []);\n  const palettes = await Promise.all([\n    readPalette(\"current\", dir),\n    ...variants\n      .filter((n) => /^\\d+$/.test(n))\n      .sort((a, b) => Number(a) - Number(b))\n      .map((n) => readPalette(`palette-${n}`, path.join(dir, \"palettes\", n))),\n  ]);\n  return palettes.filter((p): p is ThemePalette => p !== null);\n}\n\nexport async function getSiteTheme(projectRoot: string): Promise<GetThemeResult> {\n  const theme = await defaultThemeFile(projectRoot);\n  if (!theme) return { success: false, error: \"This site has no theme in app/config/site.json\" };\n  try {\n    const content = JSON.parse(await fs.readFile(theme.filePath, \"utf-8\")) as {\n      colors?: Record<string, string>;\n    };\n    const colors: ThemeColors = {};\n    for (const key of EDITABLE_THEME_COLORS) {\n      const value = content.colors?.[key];\n      if (typeof value === \"string\") colors[key] = value;\n    }\n    return { success: true, themeId: theme.themeId, colors, palettes: await offeredPalettes(projectRoot) };\n  } catch {\n    return { success: false, error: `The theme file app/config/themes/${theme.themeId}.json is missing` };\n  }\n}\n\nexport async function setSiteTheme(projectRoot: string, params: PayloadSetTheme): Promise<SetThemeResult> {\n  const parsed = payloadSetTheme.safeParse(params);\n  if (!parsed.success) return { success: false, error: `Invalid payload: ${parsed.error.message}` };\n  if (Object.keys(parsed.data.colors).length === 0) return { success: true, filePaths: [] };\n  const theme = await defaultThemeFile(projectRoot);\n  if (!theme) return { success: false, error: \"This site has no theme in app/config/site.json\" };\n  try {\n    const content = JSON.parse(await fs.readFile(theme.filePath, \"utf-8\")) as {\n      colors?: Record<string, string>;\n    };\n    content.colors = { ...content.colors, ...parsed.data.colors };\n    await fs.writeFile(theme.filePath, `${JSON.stringify(content, null, 2)}\\n`);\n    const filePaths = [theme.filePath];\n\n    const briefPath = path.join(projectRoot, \"docs\", \"DESIGN.md\");\n    const brief = await fs.readFile(briefPath, \"utf-8\").catch(() => null);\n    if (brief !== null) {\n      await fs.writeFile(briefPath, briefWithUserColors(brief, path.relative(projectRoot, theme.filePath)));\n      filePaths.push(briefPath);\n    }\n    return { success: true, filePaths };\n  } catch (err) {\n    return { success: false, error: String(err) };\n  }\n}\n"],"mappings":"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"}

package/dist/upstart-editor-api.d.ts

@@ -1,4 +1,5 @@
 import { EditableEntry } from "./vite-plugin-upstart-attrs.js";
+import { EDITABLE_THEME_COLORS, EditableThemeColor, GetThemeResult, PayloadGetTheme, PayloadSetTheme, SetThemeResult, ThemeColors, ThemePalette, payloadGetTheme, payloadSetTheme } from "./site-theme.js";
 import z from "zod";
 
 //#region src/upstart-editor-api.d.ts
@@ -16,6 +17,38 @@ declare function escapeStringLiteralBody(value: string, quote: string): string;
 declare function readLocaleValue(data: Record<string, unknown>, key: string): string | null;
 /** Write a key, keeping the shape it already has; new keys are created flat. */
 declare function writeLocaleValue(data: Record<string, unknown>, key: string, value: string): void;
+interface SourceRange {
+  start: number;
+  end: number;
+}
+/**
+ * The result of moving a range: the new code, plus what changed so the offsets of other
+ * elements can be mapped onto it (see `mapOffset`). Offsets are in the ORIGINAL code, except
+ * `moved`, which is the new range of the moved element.
+ */
+interface MoveEdit {
+  code: string;
+  /** Removed source range. */
+  removeStart: number;
+  removeEnd: number;
+  /** Where the moved text was inserted, and its length. */
+  insertAt: number;
+  insertLength: number;
+  moved: SourceRange;
+}
+/**
+ * Move the `src` range before or after the `tgt` range (`tgt` must not be inside `src`).
+ * Elements alone on their lines are moved as whole lines, re-indented to the target's level;
+ * inline elements are moved as-is. Inserting at the far edge of the target keeps the target's
+ * own range untouched even when the source sits inside it (e.g. a <span> out of its <p>).
+ */
+declare function moveRange(code: string, src: SourceRange, tgt: SourceRange, position: "before" | "after"): MoveEdit;
+/**
+ * Where an offset of the original code (outside the removed range) lands after `edit`.
+ * A start sitting exactly at the insertion point is pushed after the inserted text, an end
+ * sitting there stays before it.
+ */
+declare function mapOffset(edit: MoveEdit, offset: number, isEnd: boolean): number;
 declare const payloadEditText: z.ZodObject<{
   action: z.ZodLiteral<"editText">;
   language: z.ZodString;
@@ -61,6 +94,25 @@ declare const payloadArraySet: z.ZodObject<{
   items: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
 type PayloadArraySet = z.infer<typeof payloadArraySet>;
+declare const payloadMoveElements: z.ZodObject<{
+  action: z.ZodLiteral<"moveElements">;
+  moves: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    targetId: z.ZodString;
+    position: z.ZodEnum<{
+      after: "after";
+      before: "before";
+    }>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type PayloadMoveElements = z.infer<typeof payloadMoveElements>;
+type MoveElementsResult = {
+  success: true;
+  filePaths: string[];
+} | {
+  success: false;
+  error: string;
+};
 declare const payloadGetPageMeta: z.ZodObject<{
   action: z.ZodLiteral<"getPageMeta">;
   routeId: z.ZodString;
@@ -218,6 +270,12 @@ declare class UpstartEditorAPI {
    * batched ✓ apply so a whole add/delete session is a single edit + rebuild.
    */
   arraySet(params: PayloadArraySet): Promise<EditResult>;
+  /**
+   * Apply a batch of element moves (editor drag & drop), in order. Every element involved is
+   * tracked across the moves, so a later move finds elements an earlier one shifted. Files are
+   * only written when every move succeeded and every result still parses.
+   */
+  moveElements(params: PayloadMoveElements): Promise<MoveElementsResult>;
   /**
    * Read the page metadata shown in the browser tab and in search results.
    *
@@ -243,6 +301,10 @@ declare class UpstartEditorAPI {
    * workspace by the caller, which has bucket access.
    */
   setSiteMeta(params: PayloadSetSiteMeta): Promise<SetSiteMetaResult>;
+  /** The site's colors and, for a new site, the palettes offered with its mockup (see site-theme.ts). */
+  getTheme(_params: PayloadGetTheme): Promise<GetThemeResult>;
+  /** Write colors to the site's theme file, and record in the brief that the user chose them. */
+  setTheme(params: PayloadSetTheme): Promise<SetThemeResult>;
   private readSiteConfig;
   private readRootFile;
   private setMetaExport;
@@ -278,5 +340,5 @@ declare class UpstartEditorAPI {
   getElementsByFile(file: string): Record<string, EditableEntry>;
 }
 //#endregion
-export { EditResult, EditableRegistry, GetPageMetaResult, GetSiteMetaResult, PageMetaField, PayloadArrayItemAdd, PayloadArrayItemDelete, PayloadArraySet, PayloadEditClassName, PayloadEditImage, PayloadEditText, PayloadEditTextDirect, PayloadGetPageMeta, PayloadGetSiteMeta, PayloadSetPageMeta, PayloadSetSiteMeta, SetPageMetaResult, SetSiteMetaResult, UpstartEditorAPI, escapeStringLiteralBody, payloadArrayItemAdd, payloadArrayItemDelete, payloadArraySet, payloadEditClassName, payloadEditImage, payloadEditText, payloadEditTextDirect, payloadGetPageMeta, payloadGetSiteMeta, payloadSetPageMeta, payloadSetSiteMeta, readLocaleValue, writeLocaleValue };
+export { EDITABLE_THEME_COLORS, EditResult, EditableRegistry, type EditableThemeColor, GetPageMetaResult, GetSiteMetaResult, type GetThemeResult, MoveEdit, MoveElementsResult, PageMetaField, PayloadArrayItemAdd, PayloadArrayItemDelete, PayloadArraySet, PayloadEditClassName, PayloadEditImage, PayloadEditText, PayloadEditTextDirect, PayloadGetPageMeta, PayloadGetSiteMeta, type PayloadGetTheme, PayloadMoveElements, PayloadSetPageMeta, PayloadSetSiteMeta, type PayloadSetTheme, SetPageMetaResult, SetSiteMetaResult, type SetThemeResult, type ThemeColors, type ThemePalette, UpstartEditorAPI, escapeStringLiteralBody, mapOffset, moveRange, payloadArrayItemAdd, payloadArrayItemDelete, payloadArraySet, payloadEditClassName, payloadEditImage, payloadEditText, payloadEditTextDirect, payloadGetPageMeta, payloadGetSiteMeta, payloadGetTheme, payloadMoveElements, payloadSetPageMeta, payloadSetSiteMeta, payloadSetTheme, readLocaleValue, writeLocaleValue };
 //# sourceMappingURL=upstart-editor-api.d.ts.map

package/dist/upstart-editor-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upstart-editor-api.d.ts","names":[],"sources":["../src/upstart-editor-api.ts"],"mappings":"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"}
+{"version":3,"file":"upstart-editor-api.d.ts","names":[],"sources":["../src/upstart-editor-api.ts"],"mappings":";;;;;;AAoCA;;;;;iBAAgB,uBAAA,CAAwB,KAAA,UAAe,KAAA;;;;;iBAgQvC,eAAA,CAAgB,IAAA,EAAM,MAAA,mBAAyB,GAAA;;iBAY/C,gBAAA,CAAiB,IAAA,EAAM,MAAA,mBAAyB,GAAA,UAAa,KAAA;AAAA,UAuCnE,WAAA;EACR,KAAA;EACA,GAAA;AAAA;;;;;;UAyDe,QAAA;EACf,IAAA;EA5DQ;EA8DR,WAAA;EACA,SAAA;EA9DA;EAgEA,QAAA;EACA,YAAA;EACA,KAAA,EAAO,WAAA;AAAA;;;;;;;iBASO,SAAA,CACd,IAAA,UACA,GAAA,EAAK,WAAA,EACL,GAAA,EAAK,WAAA,EACL,QAAA,uBACC,QAAA;;;;AALH;;iBA6DgB,SAAA,CAAU,IAAA,EAAM,QAAA,EAAU,MAAA,UAAgB,KAAA;AAAA,cAc7C,eAAA,EAAe,CAAA,CAAA,SAAA;;;;;;;KAWhB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,eAAA;AAAA,cAEhC,qBAAA,EAAqB,CAAA,CAAA,SAAA;;;;;KAMtB,qBAAA,GAAwB,CAAA,CAAE,KAAA,QAAa,qBAAA;AAAA,cAEtC,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;;;KAarB,oBAAA,GAAuB,CAAA,CAAE,KAAA,QAAa,oBAAA;AAAA,cAErC,gBAAA,EAAgB,CAAA,CAAA,SAAA;;;;;KAOjB,gBAAA,GAAmB,CAAA,CAAE,KAAA,QAAa,gBAAA;AAAA,cAGjC,mBAAA,EAAmB,CAAA,CAAA,SAAA;;;;;KAOpB,mBAAA,GAAsB,CAAA,CAAE,KAAA,QAAa,mBAAA;AAAA,cAEpC,sBAAA,EAAsB,CAAA,CAAA,SAAA;;;;;KAMvB,sBAAA,GAAyB,CAAA,CAAE,KAAA,QAAa,sBAAA;AAAA,cAKvC,eAAA,EAAe,CAAA,CAAA,SAAA;;;;;KAMhB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,eAAA;AAAA,cAKhC,mBAAA,EAAmB,CAAA,CAAA,SAAA;;;;;;;;;;;KAcpB,mBAAA,GAAsB,CAAA,CAAE,KAAA,QAAa,mBAAA;AAAA,KAErC,kBAAA;EAAuB,OAAA;EAAe,SAAA;AAAA;EAA0B,OAAA;EAAgB,KAAA;AAAA;AAAA,cAY/E,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;;;KAUnB,kBAAA,GAAqB,CAAA,CAAE,KAAA,QAAa,kBAAA;AAAA,cAEnC,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;;;;;;;KAcnB,kBAAA,GAAqB,CAAA,CAAE,KAAA,QAAa,kBAAA;AAAA,cAEnC,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;KAInB,kBAAA,GAAqB,CAAA,CAAE,KAAA,QAAa,kBAAA;AAAA,cAQnC,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;;;KAOnB,kBAAA,GAAqB,CAAA,CAAE,KAAA,QAAa,kBAAA;AAAA,KAEpC,iBAAA;EAEN,OAAA;EACA,OAAA;EACA,WAAA,iBA3I2B;EA6I3B,QAAA;EACA,MAAA;AAAA;EAEA,OAAA;EAAgB,KAAA;AAAA;AAAA,KAEV,iBAAA;EAAsB,OAAA;EAAe,SAAA;AAAA;EAA0B,OAAA;EAAgB,KAAA;AAAA;AAAA,UAE1E,aAAA;EACf,KAAA;EACA,QAAA;EApJ+B;EAsJ/B,MAAA;EAtJ+B;EAwJ/B,UAAA;EACA,OAAA;;;;;;EAMA,MAAA;;EAEA,MAAA;EACA,MAAA;AAAA;AAAA,KAGU,iBAAA;EAEN,OAAA;EACA,QAAA;EACA,YAAA;EAEA,IAAA;EACA,SAAA;EACA,QAAA;EACA,KAAA,EAAO,aAAA;EACP,WAAA,EAAa,aAAA;EACb,QAAA,EAAU,aAAA;EACV,cAAA;EACA,cAAA;EACA,YAAA;AAAA;EAEA,OAAA;EAAgB,KAAA;AAAA;AAAA,KAEV,iBAAA;EAAsB,OAAA;EAAe,SAAA;AAAA;EAA0B,OAAA;EAAgB,KAAA;AAAA;AAAA,UAE1E,gBAAA;EACf,OAAA;EACA,WAAA;EACA,QAAA,EAAU,MAAA,SAAe,aAAA;AAAA;AAAA,KAGf,UAAA;EAEN,OAAA;EACA,KAAA;EACA,QAAA;AAAA;EAGA,OAAA;EACA,KAAA;EACA,QAAA;AAAA;AAAA,cAGO,gBAAA;EAAA,QACH,QAAA;EAAA,QACA,WAAA;EAAA,QACA,YAAA;EAER,WAAA,CAAY,WAAA,UAAqB,YAAA;EA1LvB;;;EAkMJ,YAAA,CAAA,GAAgB,OAAA;EAlMO;;;EA0M7B,WAAA,CAAA,GAAe,gBAAA;EA1M6C;AAG9D;;EA8ME,WAAA,CAAY,QAAA,EAAU,gBAAA;;;;;;EAShB,QAAA,CAAS,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,UAAA;EAvNnB;;;;EAgRxB,cAAA,CAAe,MAAA,EAAQ,qBAAA,GAAwB,OAAA,CAAQ,UAAA;;;;EAgCvD,aAAA,CAAc,MAAA,EAAQ,oBAAA,GAAuB,OAAA,CAAQ,UAAA;EAAA,QA2B7C,qBAAA;;;;;;;EAgER,SAAA,CAAU,MAAA,EAAQ,gBAAA,GAAmB,OAAA,CAAQ,UAAA;;;;AApYrD;;;EAoaQ,YAAA,CAAa,MAAA,EAAQ,mBAAA,GAAsB,OAAA,CAAQ,UAAA;EApazB;;;;EAgd1B,eAAA,CAAgB,MAAA,EAAQ,sBAAA,GAAyB,OAAA,CAAQ,UAAA;EA9cpD;;;;;EA4fL,QAAA,CAAS,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,UAAA;;;;;;EAqD3C,YAAA,CAAa,MAAA,EAAQ,mBAAA,GAAsB,OAAA,CAAQ,kBAAA;;;;;;;;EAoGnD,WAAA,CAAY,MAAA,EAAQ,kBAAA,GAAqB,OAAA,CAAQ,iBAAA;;;;;;EAkGjD,WAAA,CAAY,MAAA,EAAQ,kBAAA,GAAqB,OAAA,CAAQ,iBAAA;EAjvB7C;;;;EA63BJ,WAAA,CAAY,MAAA,EAAQ,kBAAA,GAAqB,OAAA,CAAQ,iBAAA;EA73BlB;;;;AAKvC;EAo5BQ,WAAA,CAAY,MAAA,EAAQ,kBAAA,GAAqB,OAAA,CAAQ,iBAAA;;EA+CjD,QAAA,CAAS,OAAA,EAAS,eAAA,GAAkB,OAAA,CAAQ,cAAA;;EAK5C,QAAA,CAAS,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,cAAA;EAAA,QAInC,cAAA;EAAA,QAUA,YAAA;EAAA,QAiBA,aAAA;EAAA,QAqCA,cAAA;EAAA,QAiBA,aAAA;EAAA,QAiCA,aAAA;EAAA,QAeA,eAAA;EAAA,QAcN,UAAA;EAAA,QAIM,UAAA;EAAA,QAeA,cAAA;;;;;UA4BN,kBAAA;EAAA,QA+BM,eAAA;EAAA,QAwBA,gBAAA;;UAmBN,cAAA;EAAA,QAYM,SAAA;EAAA,QAwEA,kBAAA;;;AAlyChB;EA8zCE,UAAA,CAAW,EAAA,WAAa,aAAA;;;;EAOxB,iBAAA,CAAkB,IAAA,yBAA6B,MAAA,SAAe,aAAA;EAr0CnB;;;EAs1C3C,iBAAA,CAAkB,IAAA,WAAe,MAAA,SAAe,aAAA;AAAA"}

package/dist/upstart-editor-api.js

@@ -1,5 +1,6 @@
 import { analyzeRouteMeta } from "./page-meta.js";
 import { ensureRootSiteMeta } from "./site-meta.js";
+import { EDITABLE_THEME_COLORS, getSiteTheme, payloadGetTheme, payloadSetTheme, setSiteTheme } from "./site-theme.js";
 import MagicString from "magic-string";
 import { parseSync } from "oxc-parser";
 import fs from "node:fs/promises";
@@ -260,6 +261,109 @@ function printMetaTag(fieldName, value) {
 	if (fieldName === "title") return !/[{}<>&\n]/.test(value) ? `<title>${value}</title>` : `<title>{"${escapeStringLiteralBody(value, "\"")}"}</title>`;
 	return `<meta name="${fieldName}" ${/["\n]/.test(value) ? `content={"${escapeStringLiteralBody(value, "\"")}"}` : `content="${value}"`} />`;
 }
+/**
+* Current range of an element in `code`: `hint` when the source still matches there, otherwise
+* the occurrence of its source nearest to `hint` (an earlier edit shifted it), and as a last
+* resort a whitespace-insensitive match (a move re-indented it).
+*/
+function locateElement(code, hint) {
+	const { start, end, content } = hint;
+	if (code.slice(start, end) === content) return hint;
+	if (content.trim() === "") return null;
+	const nearest = (a, b) => Math.abs(a - start) < Math.abs(b - start);
+	let best = -1;
+	for (let i = code.indexOf(content); i !== -1; i = code.indexOf(content, i + 1)) if (best === -1 || nearest(i, best)) best = i;
+	if (best !== -1) return {
+		start: best,
+		end: best + content.length,
+		content
+	};
+	const pattern = content.trim().split(/\s+/).map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("\\s+");
+	let found = null;
+	for (const m of code.matchAll(new RegExp(pattern, "g"))) if (!found || nearest(m.index, found.start)) found = {
+		start: m.index,
+		end: m.index + m[0].length,
+		content: m[0]
+	};
+	return found;
+}
+/**
+* The full lines a range occupies (from the line start to just after its trailing newline)
+* when nothing else than whitespace shares those lines, plus the indentation of the first one.
+*/
+function ownLines(code, range) {
+	const lineStart = code.lastIndexOf("\n", range.start - 1) + 1;
+	const indent = code.slice(lineStart, range.start);
+	if (indent.trim() !== "") return null;
+	const newline = code.indexOf("\n", range.end);
+	const lineEnd = newline === -1 ? code.length : newline;
+	if (code.slice(range.end, lineEnd).trim() !== "") return null;
+	return {
+		start: lineStart,
+		end: newline === -1 ? code.length : newline + 1,
+		indent
+	};
+}
+/**
+* Move the `src` range before or after the `tgt` range (`tgt` must not be inside `src`).
+* Elements alone on their lines are moved as whole lines, re-indented to the target's level;
+* inline elements are moved as-is. Inserting at the far edge of the target keeps the target's
+* own range untouched even when the source sits inside it (e.g. a <span> out of its <p>).
+*/
+function moveRange(code, src, tgt, position) {
+	const srcLines = ownLines(code, src);
+	const tgtLines = ownLines(code, tgt);
+	let removeStart = src.start;
+	let removeEnd = src.end;
+	let insertAt = position === "before" ? tgt.start : tgt.end;
+	let inserted = code.slice(src.start, src.end);
+	let elementOffset = 0;
+	let elementLength = inserted.length;
+	if (srcLines && tgtLines) {
+		const body = inserted.split("\n").map((line, i) => {
+			if (i === 0) return line;
+			return line.startsWith(srcLines.indent) ? tgtLines.indent + line.slice(srcLines.indent.length) : line;
+		}).join("\n");
+		removeStart = srcLines.start;
+		removeEnd = srcLines.end;
+		elementOffset = tgtLines.indent.length;
+		elementLength = body.length;
+		if (position === "before") {
+			insertAt = tgtLines.start;
+			inserted = `${tgtLines.indent}${body}\n`;
+		} else {
+			insertAt = tgtLines.end;
+			const atEofWithoutNewline = tgtLines.end === code.length && !code.endsWith("\n");
+			inserted = atEofWithoutNewline ? `\n${tgtLines.indent}${body}` : `${tgtLines.indent}${body}\n`;
+			if (atEofWithoutNewline) elementOffset += 1;
+		}
+	}
+	const removed = removeEnd - removeStart;
+	const next = insertAt <= removeStart ? code.slice(0, insertAt) + inserted + code.slice(insertAt, removeStart) + code.slice(removeEnd) : code.slice(0, removeStart) + code.slice(removeEnd, insertAt) + inserted + code.slice(insertAt);
+	const movedStart = (insertAt <= removeStart ? insertAt : insertAt - removed) + elementOffset;
+	return {
+		code: next,
+		removeStart,
+		removeEnd,
+		insertAt,
+		insertLength: inserted.length,
+		moved: {
+			start: movedStart,
+			end: movedStart + elementLength
+		}
+	};
+}
+/**
+* Where an offset of the original code (outside the removed range) lands after `edit`.
+* A start sitting exactly at the insertion point is pushed after the inserted text, an end
+* sitting there stays before it.
+*/
+function mapOffset(edit, offset, isEnd) {
+	let mapped = offset;
+	if (offset >= edit.removeEnd) mapped -= edit.removeEnd - edit.removeStart;
+	if (isEnd ? offset > edit.insertAt : offset >= edit.insertAt) mapped += edit.insertLength;
+	return mapped;
+}
 /** Start of the line `offset` sits on, so a removed tag doesn't leave a blank line behind. */
 function lineRangeStart(code, offset) {
 	const lineStart = code.lastIndexOf("\n", offset);
@@ -310,6 +414,14 @@ const payloadArraySet = z.object({
 	arrayId: z.string().min(1),
 	items: z.array(z.string()).min(1)
 });
+const payloadMoveElements = z.object({
+	action: z.literal("moveElements"),
+	moves: z.array(z.object({
+		id: z.string().min(1),
+		targetId: z.string().min(1),
+		position: z.enum(["before", "after"])
+	})).min(1).max(200)
+});
 const routeIdSchema = z.string().min(1).regex(/^[a-zA-Z0-9._$/()[\]+~-]+$/).refine((id) => !id.split("/").includes("..") && !id.startsWith("/"), "Invalid route id");
 const payloadGetPageMeta = z.object({
 	action: z.literal("getPageMeta"),
@@ -716,6 +828,118 @@ var UpstartEditorAPI = class {
 		}
 	}
 	/**
+	* Apply a batch of element moves (editor drag & drop), in order. Every element involved is
+	* tracked across the moves, so a later move finds elements an earlier one shifted. Files are
+	* only written when every move succeeded and every result still parses.
+	*/
+	async moveElements(params) {
+		const parsed = payloadMoveElements.safeParse(params);
+		if (!parsed.success) return {
+			success: false,
+			error: `Invalid payload: ${parsed.error.message}`
+		};
+		if (!this.registry) try {
+			await this.loadRegistry();
+		} catch (err) {
+			return {
+				success: false,
+				error: `Failed to load registry: ${err}`
+			};
+		}
+		const elements = this.registry.elements;
+		const codes = /* @__PURE__ */ new Map();
+		const tracked = /* @__PURE__ */ new Map();
+		try {
+			for (const { id, targetId, position } of parsed.data.moves) {
+				if (id === targetId) return {
+					success: false,
+					error: "Cannot move an element onto itself"
+				};
+				const source = elements[id];
+				const target = elements[targetId];
+				if (source?.type !== "element") return {
+					success: false,
+					error: `Element ${id} not found in registry`
+				};
+				if (target?.type !== "element") return {
+					success: false,
+					error: `Element ${targetId} not found in registry`
+				};
+				if (source.file !== target.file) return {
+					success: false,
+					error: "Elements can only be moved within the same file"
+				};
+				const file = source.file;
+				let code = codes.get(file);
+				if (code === void 0) {
+					code = await fs.readFile(path.join(this.projectRoot, file), "utf-8");
+					codes.set(file, code);
+					for (const [elementId, entry] of Object.entries(elements)) {
+						if (entry.type !== "element" || entry.file !== file) continue;
+						tracked.set(elementId, {
+							start: entry.startOffset,
+							end: entry.endOffset,
+							content: entry.originalContent
+						});
+					}
+				}
+				const src = locateElement(code, tracked.get(id));
+				const tgt = locateElement(code, tracked.get(targetId));
+				if (!src || !tgt) return {
+					success: false,
+					error: `Element not found in ${file}. The file may have been modified.`
+				};
+				if (tgt.start >= src.start && tgt.end <= src.end) return {
+					success: false,
+					error: "Cannot move an element inside itself"
+				};
+				const edit = moveRange(code, src, tgt, position);
+				codes.set(file, edit.code);
+				for (const [elementId, el] of tracked) {
+					if (elementId === id) continue;
+					if (elements[elementId].file !== file) continue;
+					if (el.start >= src.start && el.end <= src.end) {
+						const delta = edit.moved.start - src.start;
+						tracked.set(elementId, {
+							...el,
+							start: el.start + delta,
+							end: el.end + delta
+						});
+					} else tracked.set(elementId, {
+						...el,
+						start: mapOffset(edit, el.start, false),
+						end: mapOffset(edit, el.end, true)
+					});
+				}
+				tracked.set(id, {
+					...edit.moved,
+					content: edit.code.slice(edit.moved.start, edit.moved.end)
+				});
+			}
+			const changed = [];
+			for (const [file, code] of codes) {
+				const filePath = path.join(this.projectRoot, file);
+				if (code === await fs.readFile(filePath, "utf-8")) continue;
+				if (parseSync(file, code, { sourceType: "module" }).errors.length > 0) return {
+					success: false,
+					error: `Moving the elements would produce invalid code in ${file}`
+				};
+				changed.push([filePath, code]);
+			}
+			for (const [filePath, code] of changed) await fs.writeFile(filePath, code);
+			if (changed.length > 0) this.registry = null;
+			return {
+				success: true,
+				filePaths: changed.map(([filePath]) => filePath)
+			};
+		} catch (err) {
+			return {
+				success: false,
+				error: String(err)
+			};
+		}
+	}
+	/**
 	* Read the page metadata shown in the browser tab and in search results.
 	*
 	* Two shapes are supported, in this order: React-rendered tags (`<title>{title}</title>`
@@ -1012,6 +1236,14 @@ var UpstartEditorAPI = class {
 			};
 		}
 	}
+	/** The site's colors and, for a new site, the palettes offered with its mockup (see site-theme.ts). */
+	async getTheme(_params) {
+		return getSiteTheme(this.projectRoot);
+	}
+	/** Write colors to the site's theme file, and record in the brief that the user chose them. */
+	async setTheme(params) {
+		return setSiteTheme(this.projectRoot, params);
+	}
 	async readSiteConfig() {
 		try {
 			const raw = await fs.readFile(path.join(this.projectRoot, "app", "config", "site.json"), "utf-8");
@@ -1342,6 +1574,6 @@ var UpstartEditorAPI = class {
 	}
 };
 //#endregion
-export { UpstartEditorAPI, escapeStringLiteralBody, payloadArrayItemAdd, payloadArrayItemDelete, payloadArraySet, payloadEditClassName, payloadEditImage, payloadEditText, payloadEditTextDirect, payloadGetPageMeta, payloadGetSiteMeta, payloadSetPageMeta, payloadSetSiteMeta, readLocaleValue, writeLocaleValue };
+export { EDITABLE_THEME_COLORS, UpstartEditorAPI, escapeStringLiteralBody, mapOffset, moveRange, payloadArrayItemAdd, payloadArrayItemDelete, payloadArraySet, payloadEditClassName, payloadEditImage, payloadEditText, payloadEditTextDirect, payloadGetPageMeta, payloadGetSiteMeta, payloadGetTheme, payloadMoveElements, payloadSetPageMeta, payloadSetSiteMeta, payloadSetTheme, readLocaleValue, writeLocaleValue };
 
 //# sourceMappingURL=upstart-editor-api.js.map