@diviops/mcp-server 1.5.12 → 1.5.14

package/dist/preset-cli/__tests__/write-path.test.js

@@ -7,9 +7,11 @@
  */
 import { test } from "node:test";
 import assert from "node:assert/strict";
-import { applyButtonPreset, applyHeadingFontPreset, assertStorageCapability, buildClientFromEnv, CapabilityMissingError, CredentialsMissingError, STORAGE_CAPABILITY, PRESET_CREATE_ROUTE, } from "../write-path.js";
+import { applyButtonPreset, applyHeadingFontPreset, applyTextBodyFontPreset, applySpacingPreset, assertStorageCapability, buildClientFromEnv, CapabilityMissingError, CredentialsMissingError, STORAGE_CAPABILITY, PRESET_CREATE_ROUTE, } from "../write-path.js";
 import { emitButtonGroupPreset } from "../button-emitter.js";
 import { emitHeadingFontGroupPreset } from "../heading-font-emitter.js";
+import { emitTextBodyFontGroupPreset } from "../text-body-font-emitter.js";
+import { emitSpacingGroupPreset } from "../spacing-emitter.js";
 import { loadRegistry } from "../registry.js";
 const registry = loadRegistry();
 function handshake(capabilities) {
@@ -155,6 +157,117 @@ test("applyHeadingFontPreset threads dry_run into the body when requested", asyn
     const options = client.calls[0].options;
     assert.equal(options.body.dry_run, true);
 });
+// ------------------------------------------------------------------
+// text-body-font apply-mode — mocked only (Track 6).
+// Mirrors the heading-font apply-mode coverage. pattern_variant is
+// in-memory metadata and must NOT appear in the wire body. Pattern B is
+// refused at the emitter level (registry-absence) — apply-mode is never
+// reached for `--pattern local`, so it has no mocked test here.
+// ------------------------------------------------------------------
+test("applyTextBodyFontPreset gates capability BEFORE issuing the write", async () => {
+    const client = mockClient({ capabilities: {} });
+    const entry = emitTextBodyFontGroupPreset({ name: "Body", pattern: "google", family: "Inter", weight: "400" }, registry);
+    await assert.rejects(() => applyTextBodyFontPreset(client, entry, {
+        serverVersion: TEST_SERVER_VERSION,
+    }), CapabilityMissingError);
+    assert.equal(client.calls.length, 0, "no write issued when capability is absent");
+});
+test("applyTextBodyFontPreset posts to /preset/create with the canonical body", async () => {
+    const client = mockClient({ capabilities: { [STORAGE_CAPABILITY]: true } });
+    const entry = emitTextBodyFontGroupPreset({
+        name: "Body",
+        pattern: "google",
+        family: "Inter",
+        weight: "400",
+        color: "gcid-body-color",
+        size: "16px",
+    }, registry);
+    const result = await applyTextBodyFontPreset(client, entry, {
+        serverVersion: TEST_SERVER_VERSION,
+    });
+    assert.equal(client.handshakeVersions[0], TEST_SERVER_VERSION);
+    assert.equal(client.calls.length, 1);
+    const call = client.calls[0];
+    assert.equal(call.endpoint, PRESET_CREATE_ROUTE);
+    const options = call.options;
+    assert.equal(options.method, "POST");
+    assert.equal(options.body.type, "group");
+    assert.equal(options.body.module_name, "divi/text");
+    assert.equal(options.body.group_name, "divi/font-body");
+    assert.equal(options.body.group_id, "designText");
+    assert.equal(options.body.name, "Body");
+    assert.deepEqual(options.body.attrs, entry.attrs);
+    assert.equal("pattern_variant" in options.body, false, "pattern_variant is client-side gating metadata; it must not be on the wire");
+    assert.equal("dry_run" in options.body, false);
+    assert.deepEqual(result, { ok: true, data: { preset_id: "mocked123" } });
+});
+test("applyTextBodyFontPreset threads dry_run into the body when requested", async () => {
+    const client = mockClient({ capabilities: { [STORAGE_CAPABILITY]: true } });
+    const entry = emitTextBodyFontGroupPreset({ name: "Body", pattern: "google", family: "Inter" }, registry);
+    await applyTextBodyFontPreset(client, entry, {
+        serverVersion: TEST_SERVER_VERSION,
+        dry_run: true,
+    });
+    const options = client.calls[0].options;
+    assert.equal(options.body.dry_run, true);
+});
+// ------------------------------------------------------------------
+// applySpacingPreset — Track 7b mocked apply-mode coverage.
+// Mirrors the text-body-font apply-mode coverage. Notably the spacing
+// body DOES carry primary_attr_name on the wire (the section cell needs
+// it per Track 7a load-bearing finding); the other emitters omit it.
+// ------------------------------------------------------------------
+test("applySpacingPreset gates capability BEFORE issuing the write", async () => {
+    const client = mockClient({ capabilities: {} });
+    const entry = emitSpacingGroupPreset({
+        name: "Sec",
+        module: "divi/section",
+        padding: { top: "40px" },
+    }, registry);
+    await assert.rejects(() => applySpacingPreset(client, entry, { serverVersion: TEST_SERVER_VERSION }), CapabilityMissingError);
+    assert.equal(client.calls.length, 0, "no write issued when capability is absent");
+});
+test("applySpacingPreset posts to /preset/create with the canonical body", async () => {
+    const client = mockClient({ capabilities: { [STORAGE_CAPABILITY]: true } });
+    const entry = emitSpacingGroupPreset({
+        name: "Section Rhythm",
+        module: "divi/section",
+        padding: { top: "80px", bottom: "80px" },
+        margin: { bottom: "40px" },
+    }, registry);
+    await applySpacingPreset(client, entry, {
+        serverVersion: TEST_SERVER_VERSION,
+    });
+    assert.equal(client.handshakeVersions[0], TEST_SERVER_VERSION);
+    assert.equal(client.calls.length, 1);
+    const call = client.calls[0];
+    assert.equal(call.endpoint, PRESET_CREATE_ROUTE);
+    const options = call.options;
+    assert.equal(options.method, "POST");
+    assert.equal(options.body.type, "group");
+    assert.equal(options.body.module_name, "divi/section");
+    assert.equal(options.body.group_name, "divi/spacing");
+    assert.equal(options.body.group_id, "designSpacing");
+    assert.equal(options.body.primary_attr_name, "module");
+    assert.deepEqual(options.body.attrs, entry.attrs);
+    assert.equal("styleAttrs" in options.body, false, "styleAttrs is mirrored at the route layer; CLI body carries attrs only");
+    assert.equal("renderAttrs" in options.body, false, "renderAttrs is mirrored at the route layer; CLI body carries attrs only");
+    assert.equal("dry_run" in options.body, false);
+});
+test("applySpacingPreset threads dry_run into the body when requested", async () => {
+    const client = mockClient({ capabilities: { [STORAGE_CAPABILITY]: true } });
+    const entry = emitSpacingGroupPreset({
+        name: "Sec",
+        module: "divi/section",
+        padding: { top: "40px" },
+    }, registry);
+    await applySpacingPreset(client, entry, {
+        serverVersion: TEST_SERVER_VERSION,
+        dry_run: true,
+    });
+    const options = client.calls[0].options;
+    assert.equal(options.body.dry_run, true);
+});
 test("buildClientFromEnv throws CredentialsMissingError when env vars are absent", () => {
     assert.throws(() => buildClientFromEnv({}), (err) => {
         assert.ok(err instanceof CredentialsMissingError);

package/dist/preset-cli/cli.d.ts

@@ -24,6 +24,8 @@
  */
 import { type ButtonEmitterInput } from "./button-emitter.js";
 import { type HeadingFontEmitterInput } from "./heading-font-emitter.js";
+import { type TextBodyFontEmitterInput } from "./text-body-font-emitter.js";
+import { type SpacingEmitterInput } from "./spacing-emitter.js";
 export declare const EXIT: {
     readonly OK: 0;
     readonly INVALID_INPUT: 1;
@@ -53,6 +55,10 @@ export declare class UsageError extends Error {
 export declare function buildButtonInput(parsed: ParsedArgs): ButtonEmitterInput;
 /** Map parsed `heading-font` options into the heading-font emitter input shape. */
 export declare function buildHeadingFontInput(parsed: ParsedArgs): HeadingFontEmitterInput;
+/** Map parsed `text-body-font` options into the text-body-font emitter input shape. */
+export declare function buildTextBodyFontInput(parsed: ParsedArgs): TextBodyFontEmitterInput;
+/** Map parsed `spacing` options into the spacing emitter input shape. */
+export declare function buildSpacingInput(parsed: ParsedArgs): SpacingEmitterInput;
 /**
  * Run the CLI. Returns the structured exit code (does NOT call
  * `process.exit` — the thin bin wrapper does). `io` is injectable so

package/dist/preset-cli/cli.js

@@ -24,8 +24,10 @@
  */
 import { emitButtonGroupPreset, buildPresetCreateBody, } from "./button-emitter.js";
 import { emitHeadingFontGroupPreset, buildHeadingFontPresetCreateBody, UnsupportedVariantCombinationError, } from "./heading-font-emitter.js";
+import { emitTextBodyFontGroupPreset, buildTextBodyFontPresetCreateBody, } from "./text-body-font-emitter.js";
+import { emitSpacingGroupPreset, buildSpacingPresetCreateBody, } from "./spacing-emitter.js";
 import { EvidenceGateError } from "./registry.js";
-import { applyButtonPreset, applyHeadingFontPreset, buildClientFromEnv, CredentialsMissingError, CapabilityMissingError, } from "./write-path.js";
+import { applyButtonPreset, applyHeadingFontPreset, applyTextBodyFontPreset, applySpacingPreset, buildClientFromEnv, CredentialsMissingError, CapabilityMissingError, } from "./write-path.js";
 export const EXIT = {
     OK: 0,
     INVALID_INPUT: 1,
@@ -40,10 +42,14 @@ const realIO = {
 const HELP = `diviops-preset — Divi 5.5.x canonical preset-emitter CLI
 
 USAGE
-  diviops-preset button [options]         Emit a divi/button group preset
-  diviops-preset heading-font [options]   Emit a divi/font group preset for
-                                          divi/heading
-  diviops-preset --help                   Show this help
+  diviops-preset button [options]           Emit a divi/button group preset
+  diviops-preset heading-font [options]     Emit a divi/font group preset for
+                                            divi/heading
+  diviops-preset text-body-font [options]   Emit a divi/font-body group preset
+                                            for divi/text (Pattern A only)
+  diviops-preset spacing [options]          Emit a divi/spacing group preset
+                                            (currently divi/section only)
+  diviops-preset --help                     Show this help
 
 MODE
   --dry-run            Compose + print canonical JSON only (DEFAULT).
@@ -99,6 +105,59 @@ heading-font OPTIONS (all styling fields optional; emit-on-specification only)
   --font-size <v>          Font size (e.g. "48px").
   --font-line-height <v>   Font line-height (e.g. "1.1").
 
+text-body-font OPTIONS (all styling fields optional; emit-on-specification only)
+  --name <string>          Preset display name (required).
+  --pattern <google|local> Required. Example: --pattern google.
+                           Pattern A is the only supported variant for now:
+                             google — Pattern A: plain family + optional
+                                      numeric weight (e.g. family "Inter",
+                                      weight "400"). Verified against
+                                      round-2 body-text fixture.
+                             local  — Pattern B for divi/font-body is NOT
+                                      registered (no canonical-shape
+                                      capture exists yet). Selecting it
+                                      lands on a registry-absence refusal.
+                           There is NO default; omitting --pattern is
+                           invalid input.
+  --font-family <string>   Font family (plain name, e.g. "Inter").
+  --font-weight <string>   Font weight (e.g. "400").
+  --font-color <value>     Font color. Hex literal, bare gcid-*/gvid-*
+                           token, or already-formed $variable(...)$ token.
+  --font-size <v>          Font size (e.g. "16px").
+  --font-line-height <v>   Font line-height (e.g. "1.5").
+
+spacing OPTIONS (sparse-emit per axis; paired sync flags per axis)
+  --name <string>          Preset display name (required).
+  --module <name>          Required. Currently only divi/section is wired
+                           (Track 7a verified only the divi/section cell).
+                           Other modules (divi/heading, divi/text,
+                           divi/button, etc.) resolve to the registry gate
+                           and are refused with EvidenceGateError —
+                           promoting them requires a Track-7a-style
+                           canonical capture PR plus a follow-up
+                           implementation/docs PR (NOT a free dispatch-
+                           clear via the gate alone).
+  --padding-top <v>        Desktop padding corners. Pass any subset; only
+  --padding-right <v>      passed corners emit (sparse-emit per axis). v1
+  --padding-bottom <v>     accepts literal CSS lengths only (px / rem /
+  --padding-left <v>       em / % / vw / vh) — $variable(...) / gvid-*
+                           tokens are refused (deferred until canonical
+                           variable-token capture lands).
+  --margin-top <v>         Desktop margin corners. Same shape rules as
+  --margin-right <v>       padding; padding and margin are independent —
+  --margin-bottom <v>      passing only padding flags omits the margin bag
+  --margin-left <v>        from the output, and vice versa.
+  --padding-sync-vertical <on|off>
+                           Explicit padding sync flag (default "off").
+                           Both syncVertical AND syncHorizontal always
+  --padding-sync-horizontal <on|off>
+                           emit as paired siblings when the padding axis
+                           has any touched corner.
+  --margin-sync-vertical <on|off>
+                           Explicit margin sync flag (default "off").
+  --margin-sync-horizontal <on|off>
+                           Same paired-siblings rule as padding.
+
 EXIT CODES
   0 success   1 invalid input   2 evidence-gate refusal
   3 capability missing   4 write error
@@ -117,6 +176,13 @@ EXAMPLES
   diviops-preset heading-font --name "Heading H1 (local)" --pattern local \\
     --font-family "Sora 700" \\
     --font-color gcid-heading-color --font-size 48px
+
+  diviops-preset text-body-font --name "Body Text" --pattern google \\
+    --font-family Inter --font-weight 400 \\
+    --font-color gcid-body-color --font-size 16px
+
+  diviops-preset spacing --name "Section Rhythm" --module divi/section \\
+    --padding-top 80px --padding-bottom 80px --margin-bottom 40px
 `;
 const VALUE_FLAGS = new Set([
     "--name",
@@ -137,6 +203,19 @@ const VALUE_FLAGS = new Set([
     "--font-size",
     "--font-line-height",
     "--pattern",
+    "--module",
+    "--padding-top",
+    "--padding-right",
+    "--padding-bottom",
+    "--padding-left",
+    "--margin-top",
+    "--margin-right",
+    "--margin-bottom",
+    "--margin-left",
+    "--padding-sync-vertical",
+    "--padding-sync-horizontal",
+    "--margin-sync-vertical",
+    "--margin-sync-horizontal",
 ]);
 /** Parse argv (after `node script`) into a structured shape. Throws on unknown flags. */
 export function parseArgs(argv) {
@@ -201,7 +280,12 @@ export class UsageError extends Error {
     }
 }
 /** Known CLI commands. The CLI rejects anything else with EXIT.INVALID_INPUT. */
-const KNOWN_COMMANDS = new Set(["button", "heading-font"]);
+const KNOWN_COMMANDS = new Set([
+    "button",
+    "heading-font",
+    "text-body-font",
+    "spacing",
+]);
 /** Map parsed `button` options into the emitter input shape. */
 export function buildButtonInput(parsed) {
     const opt = (k) => {
@@ -324,6 +408,109 @@ export function buildHeadingFontInput(parsed) {
         input.lineHeight = lineHeight;
     return input;
 }
+/** Map parsed `text-body-font` options into the text-body-font emitter input shape. */
+export function buildTextBodyFontInput(parsed) {
+    const opt = (k) => {
+        const v = parsed.options.get(k);
+        return typeof v === "string" ? v : undefined;
+    };
+    const name = opt("--name");
+    if (!name) {
+        throw new UsageError("text-body-font command requires --name <string>.");
+    }
+    // --pattern is REQUIRED — there is no safe default. Pattern A only;
+    // passing "local" lands on the registry-absence refusal downstream
+    // (no Pattern B entry exists for `divi/font-body`).
+    const patternRaw = opt("--pattern");
+    if (patternRaw === undefined) {
+        throw new UsageError("text-body-font command requires --pattern <google|local>. " +
+            "Example: --pattern google. Pattern A (google) is the only " +
+            "supported variant for now; Pattern B (local) has no registry " +
+            "entry for `divi/font-body` and will be refused.");
+    }
+    if (patternRaw !== "google" && patternRaw !== "local") {
+        throw new UsageError(`--pattern must be "google" or "local"; got ${JSON.stringify(patternRaw)}.`);
+    }
+    const pattern = patternRaw;
+    const input = { name, pattern };
+    const family = opt("--font-family");
+    if (family !== undefined)
+        input.family = family;
+    const weight = opt("--font-weight");
+    if (weight !== undefined)
+        input.weight = weight;
+    const color = opt("--font-color");
+    if (color !== undefined)
+        input.color = color;
+    const size = opt("--font-size");
+    if (size !== undefined)
+        input.size = size;
+    const lineHeight = opt("--font-line-height");
+    if (lineHeight !== undefined)
+        input.lineHeight = lineHeight;
+    return input;
+}
+/** Parse an optional `on|off` flag value; throw a usage error otherwise. */
+function parseOnOff(raw, flag) {
+    if (raw === undefined)
+        return undefined;
+    if (raw !== "on" && raw !== "off") {
+        throw new UsageError(`${flag} must be "on" or "off"; got ${JSON.stringify(raw)}.`);
+    }
+    return raw;
+}
+/** Map parsed `spacing` options into the spacing emitter input shape. */
+export function buildSpacingInput(parsed) {
+    const opt = (k) => {
+        const v = parsed.options.get(k);
+        return typeof v === "string" ? v : undefined;
+    };
+    const name = opt("--name");
+    if (!name) {
+        throw new UsageError("spacing command requires --name <string>.");
+    }
+    const module = opt("--module");
+    if (!module) {
+        throw new UsageError("spacing command requires --module <name>. Currently only " +
+            "divi/section is wired; other modules are refused by the registry " +
+            "gate (heading/text/button cells are SCHEMA_OBSERVED).");
+    }
+    const input = { name, module };
+    // Sparse-emit at parse time too: only attach an axis bag when at least
+    // one corner OR a sync flag was passed. (Sync-flag-only input lands on
+    // the emitter's per-axis sync-without-corner refusal.) Padding and
+    // margin follow the identical shape rule, so the per-axis collection
+    // is hoisted into a single helper.
+    const buildAxis = (prefix) => {
+        const bag = {};
+        const t = opt(`--${prefix}-top`);
+        if (t !== undefined)
+            bag.top = t;
+        const r = opt(`--${prefix}-right`);
+        if (r !== undefined)
+            bag.right = r;
+        const b = opt(`--${prefix}-bottom`);
+        if (b !== undefined)
+            bag.bottom = b;
+        const l = opt(`--${prefix}-left`);
+        if (l !== undefined)
+            bag.left = l;
+        const sv = parseOnOff(opt(`--${prefix}-sync-vertical`), `--${prefix}-sync-vertical`);
+        if (sv !== undefined)
+            bag.syncVertical = sv;
+        const sh = parseOnOff(opt(`--${prefix}-sync-horizontal`), `--${prefix}-sync-horizontal`);
+        if (sh !== undefined)
+            bag.syncHorizontal = sh;
+        return Object.keys(bag).length > 0 ? bag : undefined;
+    };
+    const padding = buildAxis("padding");
+    if (padding)
+        input.padding = padding;
+    const margin = buildAxis("margin");
+    if (margin)
+        input.margin = margin;
+    return input;
+}
 /**
  * Run the CLI. Returns the structured exit code (does NOT call
  * `process.exit` — the thin bin wrapper does). `io` is injectable so
@@ -365,13 +552,35 @@ export async function run(argv, io = realIO, serverVersion) {
             dryRunBody = buildPresetCreateBody(entry, { dry_run: true });
             applyFn = (client, sv) => applyButtonPreset(client, entry, { serverVersion: sv });
         }
-        else {
-            // heading-font
+        else if (parsed.command === "heading-font") {
             const input = buildHeadingFontInput(parsed);
             const entry = emitHeadingFontGroupPreset(input);
             dryRunBody = buildHeadingFontPresetCreateBody(entry, { dry_run: true });
             applyFn = (client, sv) => applyHeadingFontPreset(client, entry, { serverVersion: sv });
         }
+        else if (parsed.command === "text-body-font") {
+            // text-body-font (Pattern A only; Pattern B lands on the
+            // registry-absence refusal in emitTextBodyFontGroupPreset).
+            const input = buildTextBodyFontInput(parsed);
+            const entry = emitTextBodyFontGroupPreset(input);
+            dryRunBody = buildTextBodyFontPresetCreateBody(entry, { dry_run: true });
+            applyFn = (client, sv) => applyTextBodyFontPreset(client, entry, { serverVersion: sv });
+        }
+        else if (parsed.command === "spacing") {
+            // spacing (divi/section only — other modules land on the registry
+            // gate in emitSpacingGroupPreset and surface as EvidenceGateError).
+            const input = buildSpacingInput(parsed);
+            const entry = emitSpacingGroupPreset(input);
+            dryRunBody = buildSpacingPresetCreateBody(entry, { dry_run: true });
+            applyFn = (client, sv) => applySpacingPreset(client, entry, { serverVersion: sv });
+        }
+        else {
+            // Defensive: a new entry in KNOWN_COMMANDS without a dispatch
+            // branch here would silently break dry-run/apply. parseArgs
+            // already gates on KNOWN_COMMANDS upstream, so reaching this is a
+            // programmer error in the dispatch wiring.
+            throw new UsageError(`Unhandled command: ${parsed.command}`);
+        }
     }
     catch (err) {
         if (err instanceof EvidenceGateError) {

package/dist/preset-cli/spacing-emitter.d.ts

@@ -0,0 +1,132 @@
+/**
+ * `divi/spacing` section group-preset emitter — Track 7b vertical slice.
+ *
+ * Emits a byte-canonical Divi 5.6.0 `type: "group"` `divi/spacing` preset
+ * targeting `divi/section` at
+ * `attrs.module.decoration.spacing.desktop.value.{padding|margin}.*`,
+ * gated by the verified-attrs registry. Canonical shape:
+ * `docs/verification/evidence/canonical-shape-dumps-2026-05-23/round-5-spacing-section.json`.
+ *
+ * Scope: `divi/section` ONLY. Heading / text / button spacing cells remain
+ * `SCHEMA_OBSERVED` and resolve to `EvidenceGateError` here per
+ * `feedback_preset_map_per_module` (no cross-module shape carry-over).
+ *
+ * Shape rules enforced here (brief §4):
+ *  - Sparse-emit per axis — only user-touched corners appear under
+ *    `padding`/`margin`. Untouched corners are absent (not present-as-empty,
+ *    not present-as-null).
+ *  - Paired sync flags per axis — any spacing touch on an axis emits BOTH
+ *    `syncVertical` AND `syncHorizontal` as siblings. Default `"off"` on
+ *    both unless the caller explicitly toggled them.
+ *  - Padding and margin are INDEPENDENT bags — passing only padding flags
+ *    omits the margin bag entirely, and vice versa.
+ *  - `attrs == styleAttrs == renderAttrs` at the route layer (the plugin's
+ *    `/preset/create` route mirrors `attrs` into all three buckets to match
+ *    VB save semantics); the CLI request body only carries `attrs`. The
+ *    Track 7a fixture captures the post-write storage shape — do NOT add
+ *    `styleAttrs` / `renderAttrs` keys to the emitter output.
+ *  - `groupId: "designSpacing"` — the Composable Settings panel id, NOT a
+ *    dotted attr path (the prior schema-inferred `module.decoration.spacing`
+ *    note was a misread, corrected in PR #751).
+ *  - `primaryAttrName: "module"` for section spacing.
+ *  - Variable tokens (`$variable(...)` / bare `gvid-*`) in length flags are
+ *    REFUSED — Track 7a capture exercised literal CSS lengths only;
+ *    variable-token shape needs its own capture before this emitter writes
+ *    it.
+ */
+import { type VerifiedAttrsRegistry } from "./registry.js";
+export declare const SPACING_GROUP_NAME = "divi/spacing";
+export declare const SPACING_GROUP_ID = "designSpacing";
+export declare const SPACING_PRIMARY_ATTR_NAME = "module";
+export declare const SPACING_PATTERN_FAMILY = "divi/spacing";
+/**
+ * The single currently-supported module cell. The `--module` flag accepts
+ * any string and routes through the registry gate (so the surface stays
+ * stable when heading/text/button cells eventually promote), but only
+ * `divi/section` is wired with fixtures + tests + canonical shape today.
+ *
+ * Promoting another module is NOT a free dispatch-clear via the registry
+ * gate — each new cell needs a Track-7a-style canonical capture PR landing
+ * first AND a follow-up implementation/docs PR.
+ */
+export declare const SPACING_SUPPORTED_MODULES: readonly ["divi/section"];
+export type SpacingCornerInput = {
+    top?: string;
+    right?: string;
+    bottom?: string;
+    left?: string;
+    syncVertical?: "on" | "off";
+    syncHorizontal?: "on" | "off";
+};
+export interface SpacingEmitterInput {
+    /** Required display name for the preset. */
+    name: string;
+    /**
+     * Required module selector. Forward-compat-shaped; only `divi/section` is
+     * wired today, everything else lands on `EvidenceGateError` via the
+     * registry gate (or a SCHEMA_OBSERVED cell evidence-gate refusal).
+     */
+    module: string;
+    /** Desktop padding corner-and-sync bag. */
+    padding?: SpacingCornerInput;
+    /** Desktop margin corner-and-sync bag. */
+    margin?: SpacingCornerInput;
+}
+/** The composed canonical preset entry shape sent to `/preset/create`. */
+export interface SpacingPresetEntry {
+    type: "group";
+    module_name: string;
+    group_name: string;
+    group_id: string;
+    primary_attr_name: string;
+    name: string;
+    attrs: Record<string, unknown>;
+}
+/**
+ * Compose the canonical
+ * `attrs.module.decoration.spacing.desktop.value.{padding|margin}` bag.
+ * Sparse-emit per axis; padding and margin are independent.
+ *
+ * Returns BOTH the full `attrs` tree (what the emitter ships) AND the
+ * inner `value` bag — the caller does empty-preset validation against
+ * `value` without re-walking the nested attrs tree (no `as any` deep
+ * casts).
+ */
+export declare function composeSpacingAttrs(input: SpacingEmitterInput): {
+    attrs: Record<string, unknown>;
+    value: Record<string, unknown>;
+};
+/**
+ * Emit a canonical `divi/spacing` section group preset.
+ *
+ * 1. Validate input shape (name, module, at least one corner across either
+ *    axis).
+ * 2. Reject variable-token values in any length flag (deferred until a
+ *    canonical capture lands).
+ * 3. Compose sparse-emit `attrs.module.decoration.spacing.desktop.value.*`
+ *    with paired sync flags.
+ * 4. Gate `(divi/spacing, <module>)` against the verified-attrs registry —
+ *    throws `EvidenceGateError` when effective evidence is below
+ *    `VB_PRESET_STORAGE_VERIFIED`.
+ *
+ * `styleAttrs` and `renderAttrs` are intentionally NOT part of this entry:
+ * the plugin's `/preset/create` route mirrors the single `attrs` bag into
+ * all three buckets at write time. The Track 7a fixture captures the
+ * post-write storage shape (which is why both `attrs` and `styleAttrs`
+ * appear there byte-identical); the CLI emits the request shape only.
+ */
+export declare function emitSpacingGroupPreset(input: SpacingEmitterInput, registry?: VerifiedAttrsRegistry): SpacingPresetEntry;
+/**
+ * Build the `POST /diviops/v1/preset/create` request body from a spacing
+ * preset entry. Matches the body shape the `diviops_preset_create` MCP
+ * tool posts — the CLI reuses the existing route, it does not add one.
+ *
+ * `primary_attr_name` IS sent on the wire (the plugin's `/preset/create`
+ * route accepts it as an optional snake_case param and stores it as
+ * `primaryAttrName` in the preset). Tracks 4/5/6 emitters omit it because
+ * their preset types do not carry it; the divi/spacing cell does, per the
+ * Track 7a capture's load-bearing finding #2.
+ */
+export declare function buildSpacingPresetCreateBody(entry: SpacingPresetEntry, opts?: {
+    dry_run?: boolean;
+}): Record<string, unknown>;