@web-ppt/edit-core 0.5.0-beta.1 → 0.5.0-beta.7

package/dist/ink.js

@@ -0,0 +1,324 @@
+import { readInkData as ne, renderInkXml as ce } from "@web-ppt/core/ink-edit";
+import { sourcePartBytes as S } from "@web-ppt/edit-core";
+import { xmlElementChildren as I, parseXmlTree as M, createXmlElement as B, insertXmlChildUnchecked as j, removeXmlChild as F, setXmlAttribute as _, createXmlText as ue, serializeXmlTree as we, removeXmlAttribute as ge, serializeXmlTreeBytes as L } from "@web-ppt/edit-core/xml";
+import "@web-ppt/edit-core/cfb";
+import "fflate";
+import "@web-ppt/edit-core/opc";
+import { sha256 as xe } from "@web-ppt/core";
+function ve(e) {
+  return [...xe(e)].map((t) => t.toString(16).padStart(2, "0")).join("");
+}
+const K = Symbol.for("@web-ppt/edit-core/extensions/v1"), ae = Symbol.for("@web-ppt/edit-core/extensions-generation/v1"), Q = Symbol.for("@web-ppt/edit-core/extensions-listeners/v1"), be = /^[a-z][a-z0-9-]{0,63}$/;
+function V() {
+  const e = globalThis;
+  return e[Q] ?? (e[Q] = { documents: /* @__PURE__ */ new WeakMap(), pending: /* @__PURE__ */ new Map(), active: /* @__PURE__ */ new Set(), resolvers: /* @__PURE__ */ new WeakMap() });
+}
+function ye(e) {
+  if (!be.test(e))
+    throw new Error(`编辑扩展命名空间无效：${e}`);
+}
+function ke() {
+  const e = globalThis;
+  return e[K] ?? (e[K] = /* @__PURE__ */ new Map());
+}
+function Ee(e, t) {
+  var i;
+  ye(e), ke().set(e, t);
+  const r = globalThis;
+  r[ae] = (r[ae] ?? 0) + 1;
+  const n = new Set(V().pending.get(e));
+  if (t.migrate) for (const o of V().active) n.add(o);
+  V().pending.delete(e);
+  for (const o of n ?? [])
+    try {
+      o(e);
+    } catch (c) {
+      (i = globalThis.reportError) == null || i.call(globalThis, c);
+    }
+}
+const z = "http://schemas.openxmlformats.org/officeDocument/2006/relationships", E = (e, t) => {
+  var r;
+  return (r = e.attributes.find((n) => n.localName === t)) == null ? void 0 : r.value;
+}, O = (e, t) => e ? I(e).filter((r) => r.localName === t) : [], W = (e, t) => O(e, t)[0], pe = (e) => e.replace(/([^/]+)$/, "_rels/$1.rels");
+function fe(e, t) {
+  if (/[:\\?#]/.test(t)) throw new Error("嵌入文档关系必须指向包内文件");
+  const r = t.startsWith("/") ? [] : e.split("/").slice(0, -1);
+  for (const n of t.split("/"))
+    if (n === "..") {
+      if (!r.length) throw new Error("嵌入文档关系越界");
+      r.pop();
+    } else n && n !== "." && r.push(n);
+  return r.join("/");
+}
+const te = "http://www.w3.org/2003/InkML", Ne = "http://schemas.microsoft.com/office/powerpoint/2010/main";
+function re(e, t) {
+  var x, h, m;
+  const r = e.elements[t], n = r == null ? void 0 : r.meta.origin;
+  if (!n || r.meta.editable !== "frame") return null;
+  let i = r.parent;
+  for (; e.elements[i]; ) i = e.elements[i].parent;
+  const o = ((h = (x = e.slides[i]) == null ? void 0 : x.creation) == null ? void 0 : h.duplicateSourcePart) ?? n.part, c = S(e, o), f = S(e, pe(o));
+  if (!c || !f) return null;
+  const l = O(M(f).root, "Relationship"), s = [M(c).root];
+  for (; s.length; ) {
+    const w = s.pop();
+    if (s.push(...I(w)), w.namespaceUri !== Ne || w.localName !== "contentPart") continue;
+    const v = W(W(w, "nvContentPartPr"), "cNvPr");
+    if (!v || Number(E(v, "id")) !== n.spid) continue;
+    const T = (m = w.attributes.find((d) => d.namespaceUri === z && d.localName === "id")) == null ? void 0 : m.value, k = l.find((d) => E(d, "Id") === T && E(d, "TargetMode") !== "External");
+    if (!k) return null;
+    const p = fe(o, E(k, "Target") ?? ""), a = S(e, p);
+    return a ? { host: o, part: p, xml: new TextDecoder().decode(a) } : null;
+  }
+  return null;
+}
+const Se = (e, t) => {
+  const r = [], n = [e];
+  for (; n.length; ) {
+    const i = n.pop();
+    i.namespaceUri === te && i.localName === t && r.push(i), n.push(...I(i).reverse());
+  }
+  return r;
+};
+function Y(e) {
+  const t = e;
+  if (!t || !Array.isArray(t.strokes) || !t.strokes.length || t.strokes.length > 1e3 || !t.bounds) throw new Error("墨迹笔画数量无效");
+  const { x: r, y: n, width: i, height: o } = t.bounds;
+  if (![r, n, i, o].every((s) => Number.isFinite(s) && Math.abs(s) < 1e9) || i < 0 || o < 0) throw new Error("墨迹画布无效");
+  const c = /* @__PURE__ */ new Set();
+  let f = 0;
+  return { strokes: t.strokes.map((s) => {
+    if (!s || typeof s.id != "string" || !/^[a-z_][\w.-]{0,100}$/i.test(s.id) || c.has(s.id)) throw new Error("墨迹笔画身份无效");
+    if (c.add(s.id), !Array.isArray(s.channels) || s.channels.length < 2 || s.channels.length > 32 || new Set(s.channels).size !== s.channels.length || !s.channels.includes("X") || !s.channels.includes("Y") || s.channels.some((h) => typeof h != "string" || !/^[A-Z][A-Z0-9_]{0,30}$/.test(h))) throw new Error("墨迹采样通道无效");
+    if (!Array.isArray(s.points) || s.points.length < 2 || (f += s.points.length) > 1e5) throw new Error("墨迹采样数量无效");
+    if (!Number.isFinite(s.width) || s.width < 0 || s.width > 1e6 || typeof s.color != "string" || !/^(?:#[\da-f]{3}(?:[\da-f]{3})?|[a-z]{1,30}|rgba?\([\d.,%\s]+\))$/i.test(s.color)) throw new Error("墨迹笔刷无效");
+    const x = s.points.map((h) => {
+      if (!h || ![h.x, h.y].every((w) => Number.isFinite(w) && Math.abs(w) < 1e9) || !Array.isArray(h.values) || h.values.length > s.channels.length || !h.values.every((w) => Number.isFinite(w) && Math.abs(w) < 1e12)) throw new Error("墨迹采样值无效");
+      const m = [...h.values];
+      return m[s.channels.indexOf("X")] = h.x, m[s.channels.indexOf("Y")] = h.y, { x: h.x, y: h.y, values: m };
+    });
+    return { id: s.id, points: x, channels: [...s.channels], color: s.color, width: s.width };
+  }), bounds: { x: r, y: n, width: i, height: o } };
+}
+function oe(e, t) {
+  var k;
+  const r = ne(e), n = M(e), i = Se(n.root, "trace"), o = new Map(r.strokes.map((p, a) => [p.id, i[a]])), c = new Set(t.strokes.map((p) => p.id)), f = /* @__PURE__ */ new Map(), l = [n.root];
+  for (; l.length; ) {
+    const p = l.pop();
+    for (const a of I(p))
+      f.set(a, p), l.push(a);
+  }
+  let s = W(n.root, "definitions");
+  s || (s = B("inkml:definitions", { attributes: [["xmlns:inkml", te]] }), j(n.root, s, I(n.root)[0] ?? null));
+  const x = /* @__PURE__ */ new Set();
+  for (const p of [n.root, ...f.keys()]) {
+    const a = (k = p.attributes.find((d) => d.name === "xml:id")) == null ? void 0 : k.value;
+    a && x.add(a);
+  }
+  const h = (p) => {
+    let a = p, d = 1;
+    for (; x.has(a); ) a = p + d++;
+    return x.add(a), a;
+  }, m = (p, a, d = []) => {
+    const N = B("inkml:" + a, { attributes: [["xmlns:inkml", te], ...d] });
+    return j(p, N), N;
+  }, w = h("webPptInkCanvas"), v = m(s, "canvas", [["xml:id", w]]), T = m(v, "traceFormat");
+  for (const p of ["X", "Y"]) {
+    const a = p === "X" ? t.bounds.x : t.bounds.y, d = p === "X" ? t.bounds.width : t.bounds.height;
+    m(T, "channel", [["name", p], ["type", "decimal"], ["min", String(a)], ["max", String(a + d)]]);
+  }
+  for (const [p, a] of o) c.has(p) || F(f.get(a), a);
+  for (const [p, a] of t.strokes.entries()) {
+    let d = o.get(a.id);
+    if (!d) {
+      if (x.has(a.id)) throw new Error("新增墨迹身份与原始定义冲突");
+      d = m(n.root, "trace", [["xml:id", a.id]]);
+    }
+    const N = h("webPptInkContext" + p), R = m(s, "context", [["xml:id", N], ["canvasRef", "#" + w]]), $ = m(R, "traceFormat");
+    for (const g of a.channels) m($, "channel", [["name", g], ["type", "decimal"]]);
+    let P = d;
+    for (; P; ) {
+      const g = E(P, "contextRef");
+      if (g) {
+        _(R, "contextRef", g);
+        break;
+      }
+      P = f.get(P);
+    }
+    _(d, "contextRef", "#" + N);
+    const U = h("webPptInkBrush" + p), G = m(s, "brush", [["xml:id", U]]);
+    for (const [g, X] of [["width", String(a.width)], ["height", String(a.width)], ["color", a.color]]) m(G, "brushProperty", [["name", g], ["value", X]]);
+    _(d, "brushRef", "#" + U);
+    for (const g of [...d.children]) (g.type === "text" || g.type === "cdata") && F(d, g);
+    j(d, ue(a.points.map((g) => a.channels.map((X, D) => "!" + (g.values[D] ?? 0)).join(" ")).join(",")));
+  }
+  return we(n);
+}
+const H = (e, t) => {
+  var r, n, i;
+  return (i = (n = (r = e.elements[t]) == null ? void 0 : r.ovr.extensions) == null ? void 0 : n.ink) == null ? void 0 : i.value;
+};
+function le(e, t, r, n, i = !1) {
+  const o = new Set([...r].filter((l) => /^ppt\/(ink|media)\/web-ppt-ink-/.test(l)));
+  for (const l of o)
+    n[l] = null, r.delete(l);
+  let c;
+  const f = () => {
+    if (!c) {
+      c = M(n["[Content_Types].xml"] ?? S(e, "[Content_Types].xml"));
+      for (const l of O(c.root, "Override")) o.has((E(l, "PartName") ?? "").slice(1)) && F(c.root, l);
+    }
+    return c;
+  };
+  for (const l of Object.values(e.elements)) {
+    const s = H(e, l.id);
+    if (!s) continue;
+    const x = re(e, l.id);
+    if (!x) throw new Error("墨迹来源丢失");
+    const h = oe(x.xml, Y(JSON.parse(s))), m = ve(new TextEncoder().encode(l.id)).slice(0, 16);
+    let w = `ppt/ink/web-ppt-ink-${m}.xml`, v = `ppt/media/web-ppt-ink-${m}.svg`, T = 1;
+    for (; S(e, w) && !o.has(w) || S(e, v) && !o.has(v); )
+      w = `ppt/ink/web-ppt-ink-${m}-${T}.xml`, v = `ppt/media/web-ppt-ink-${m}-${T++}.svg`;
+    let k = l.parent;
+    for (; e.elements[k]; ) k = e.elements[k].parent;
+    const p = i ? `ppt/slides/slide${e.slideOrder.indexOf(k) + 1}.xml` : x.host, a = pe(p), d = S(e, p), N = S(e, a);
+    i || (d && (t[p] ?? (t[p] = d)), N && (t[a] ?? (t[a] = N)));
+    const R = M(n[p] ?? d), $ = M(n[a] ?? N);
+    for (const u of O($.root, "Relationship")) E(u, "TargetMode") !== "External" && o.has(fe(p, E(u, "Target"))) && F($.root, u);
+    const P = (u, A) => {
+      let y = "webPptInk" + m, J = 1;
+      for (; O($.root, "Relationship").some((C) => E(C, "Id") === y); ) y = "webPptInk" + m + "_" + J++;
+      return j($.root, B("Relationship", { attributes: [["Id", y], ["Type", A], ["Target", "../" + u.slice(4)]] })), y;
+    }, U = P(w, `${z}/customXml`), G = P(v, `${z}/image`), g = [R.root], X = /* @__PURE__ */ new Map();
+    let D = !1;
+    for (; g.length; ) {
+      const u = g.pop();
+      for (const b of I(u))
+        X.set(b, u), g.push(b);
+      if (E(u, "webPptInkEdit") !== l.id) continue;
+      D = !0;
+      const A = u.attributes.find((b) => b.namespaceUri === z && b.localName === "id");
+      if (!A) throw new Error("墨迹数据关系丢失");
+      _(u, A.name, U), ge(u, "webPptInkEdit");
+      let y = X.get(u);
+      for (; y && y.localName !== "AlternateContent"; ) y = X.get(y);
+      const J = y && W(y, "Fallback"), C = J ? [J] : [];
+      for (; C.length; ) {
+        const b = C.pop();
+        if (C.push(...I(b)), b.localName === "blip") {
+          const se = b.attributes.find((q) => q.namespaceUri === z && q.localName === "embed");
+          se && _(b, se.name, G);
+          for (const q of O(b, "extLst")) F(b, q);
+        }
+      }
+    }
+    if (!D) throw new Error("保存找不到墨迹对象");
+    const ie = (u) => u.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;"), he = ce(h, l.src.w, l.src.h).map((u) => `<path transform="translate(${u.x} ${u.y})" d="${ie(u.path ?? "")}" fill="none" stroke="${ie(u.stroke.color)}" stroke-width="${u.stroke.width}" stroke-linecap="round" stroke-linejoin="round"/>`).join(""), me = `<svg xmlns="http://www.w3.org/2000/svg" width="${l.src.w}" height="${l.src.h}" viewBox="0 0 ${l.src.w} ${l.src.h}">${he}</svg>`;
+    n[w] = new TextEncoder().encode(h), n[v] = new TextEncoder().encode(me), r.add(w), r.add(v), n[p] = L(R), n[a] = L($);
+    for (const [u, A] of [[w, "application/inkml+xml"], [v, "image/svg+xml"]]) j(f().root, B("Override", { attributes: [["PartName", "/" + u], ["ContentType", A]] }));
+  }
+  o.size && f(), c && (n["[Content_Types].xml"] = L(c));
+}
+const Z = (e, t) => {
+  const r = re(e, t);
+  if (!r) throw new Error("对象不是可编辑墨迹");
+  return r;
+};
+function ee(e, t) {
+  const r = H(e, t);
+  return r ? Y(JSON.parse(r)) : ne(Z(e, t).xml);
+}
+function de(e, t, r) {
+  const n = Y(r);
+  return oe(Z(e, t).xml, n), n;
+}
+function $e(e, t, r) {
+  if (e.meta.readonly) throw new Error("文稿只读");
+  const n = H(e, t.id), i = t.payload === null ? void 0 : de(e, t.id, t.payload);
+  let o = i ? JSON.stringify(i) : void 0;
+  o === JSON.stringify(ne(Z(e, t.id).xml)) && (o = void 0);
+  const c = ["elements", t.id, "ovr", "extensions", "ink", "value"], f = (l) => l === void 0 ? { op: "del", path: c, origin: r } : { op: "set", path: c, origin: r, value: l };
+  return n === o ? { forward: [], inverse: [] } : { forward: [f(o)], inverse: [f(n)] };
+}
+Ee("ink", {
+  command: $e,
+  validatePatch(e, t) {
+    if (t.path[0] !== "elements" || t.path.length !== 6 || t.path[5] !== "value") throw new Error("墨迹补丁路径无效");
+    if (t.op === "set") {
+      if (typeof t.value != "string") throw new Error("墨迹补丁值无效");
+      de(e, t.path[1], JSON.parse(t.value));
+    }
+  },
+  project(e, t, r) {
+    const n = H(e, t);
+    return !n || r.kind !== "group" ? r : { ...r, children: ce(oe(Z(e, t).xml, Y(JSON.parse(n))), r.w, r.h) };
+  },
+  materialize(e, t, r, n) {
+    var o, c;
+    if (!((c = (o = t.ovr.extensions) == null ? void 0 : o.ink) != null && c.value)) return;
+    const i = [n.locateElementHost(e, t).host];
+    for (; i.length; ) {
+      const f = i.pop();
+      f.localName === "contentPart" && n.setXmlAttribute(f, "webPptInkEdit", t.id), i.push(...n.xmlElementChildren(f));
+    }
+  },
+  materializePackage: le,
+  generateParts(e, t) {
+    const r = { ...t };
+    le(e, {}, /* @__PURE__ */ new Set(), r, !0);
+    for (const [n, i] of Object.entries(r))
+      i ? t[n] = i : delete t[n];
+  }
+});
+function Re(e) {
+  return Object.values(e.elements).filter((t) => re(e, t.id)).map((t) => ({ id: t.id, name: t.src.name ?? "墨迹" }));
+}
+function Ce(e) {
+  const t = (n, i) => {
+    const o = ee(e.doc, n);
+    i(o), e.exec({ type: "Extension", namespace: "ink", id: n, payload: o });
+  }, r = (n, i) => {
+    const o = n.strokes.find((c) => c.id === i);
+    if (!o) throw new Error("笔画不存在");
+    return o;
+  };
+  return {
+    query: (n) => ee(e.doc, n),
+    setStyle(n, i, o) {
+      t(n, (c) => {
+        const f = r(c, i);
+        o.color !== void 0 && (f.color = o.color), o.width !== void 0 && (f.width = o.width);
+      });
+    },
+    setPoints(n, i, o) {
+      t(n, (c) => {
+        r(c, i).points = o;
+      });
+    },
+    translate(n, i, o, c) {
+      t(n, (f) => {
+        for (const l of r(f, i).points)
+          l.x += o, l.y += c;
+      });
+    },
+    addStroke(n, i, o, c = "ink-" + crypto.randomUUID()) {
+      return t(n, (f) => {
+        f.strokes.push({ id: c, points: i.map((l) => ({ x: l.x, y: l.y, values: [l.x, l.y, l.pressure ?? 0.5] })), channels: ["X", "Y", "F"], ...o });
+      }), c;
+    },
+    removeStroke(n, i) {
+      const o = ee(e.doc, n);
+      r(o, i), o.strokes.length === 1 ? e.exec({ type: "RemoveElement", id: n }) : t(n, (c) => {
+        c.strokes = c.strokes.filter((f) => f.id !== i);
+      });
+    },
+    reset(n) {
+      e.exec({ type: "Extension", namespace: "ink", id: n, payload: null });
+    }
+  };
+}
+export {
+  Ce as createInkEditor,
+  Re as listEditableInk,
+  ee as queryInk
+};

package/dist/layout-assets.d.ts

@@ -1,4 +1,4 @@
-import type { Slide } from '@web-ppt/core';
+import type { Slide, SlideLayoutTemplate, SlideMasterTemplate } from '@web-ppt/core';
 import type { EditDoc } from './types';
 interface LayoutAsset {
     readonly mime: string;
@@ -6,5 +6,7 @@ interface LayoutAsset {
 }
 /** 只兑现 Schema 的资源槽；普通字符串即使形似内部 token 也必须逐字保留。 */
 export declare function hydrateLayoutSlideAssets(doc: EditDoc, slide: Slide, assets: readonly LayoutAsset[]): Slide;
+export declare function hydrateLayoutTemplateAssets(doc: EditDoc, layout: SlideLayoutTemplate, assets: readonly LayoutAsset[]): SlideLayoutTemplate;
+export declare function hydrateMasterTemplateAssets(doc: EditDoc, master: SlideMasterTemplate, assets: readonly LayoutAsset[]): SlideMasterTemplate;
 export declare function releaseLayoutAssetCache(doc: EditDoc): void;
 export {};

package/dist/layout-projection.d.ts

@@ -1,12 +1,23 @@
-import type { GeomSpec, ShapeCreationDefaults, Slide, SlideElement, TableCreationDefaults, TextBody } from '@web-ppt/core';
+import type { Fill, GeomSpec, ShapeCreationDefaults, Slide, SlideElement, SlideLayoutTemplate, SlideMasterTemplate, TableCreationDefaults, TextBody } from '@web-ppt/core';
 import type { EditDoc, ElementId, SlideId } from './types';
+type LayoutElementResolver = (id: ElementId) => SlideElement;
+/** 主题覆盖后的版式来源仍由 core 的 OOXML 继承器求值，编辑层只按来源身份对回稳定节点。 */
+export declare function resolvedLayoutTemplate(doc: EditDoc, layoutId: string): SlideLayoutTemplate | null;
+export declare function resolvedLayoutElementSource(doc: EditDoc, layoutId: string, record: EditDoc['elements'][string]): SlideElement | null;
+export declare function resolvedMasterTemplate(doc: EditDoc, masterId: string): SlideMasterTemplate | null;
+export declare function resolvedMasterElementSource(doc: EditDoc, masterId: string, record: EditDoc['elements'][string]): SlideElement | null;
 export declare function resolvedLayoutSlide(doc: EditDoc, slideId: SlideId): Slide | null;
 export declare function releaseLayoutProjectionCache(doc: EditDoc): void;
-export declare function changedLayout(doc: EditDoc, slideId: SlideId): import("@web-ppt/core").SlideLayoutTemplate | undefined;
+export declare function changedLayout(doc: EditDoc, slideId: SlideId): import("./layout-types").LayoutRecord | undefined;
+export declare function slideDesignChanged(doc: EditDoc, slideId: SlideId): boolean;
+export declare function layoutShowsMaster(doc: EditDoc, layoutId: string): boolean;
+export declare function effectiveLayoutBackground(doc: EditDoc, layoutId: string, resolved?: {
+    readonly background: Fill | null;
+} | null): Fill | null;
 export declare function currentShapeDefaults(doc: EditDoc, slideId: SlideId): ShapeCreationDefaults | undefined;
 export declare function currentTableDefaults(doc: EditDoc, slideId: SlideId): TableCreationDefaults | undefined;
 /** 页面级 showMasterSp=false 必须继续压过新关系指向的版式/母版。 */
-export declare function projectedLayoutElements(doc: EditDoc, slideId: SlideId): SlideElement[];
+export declare function projectedLayoutElements(doc: EditDoc, slideId: SlideId, resolveLayoutElement?: LayoutElementResolver): SlideElement[];
 export declare function projectionContentIds(doc: EditDoc, slideId: SlideId): ElementId[];
 /** 目标没有宿主且来源变换本来只靠旧版式继承时，保存必须把有效 frame 降级为页面直设。 */
 export declare function layoutFallbackElementIds(doc: EditDoc, slideId: SlideId): ElementId[];
@@ -16,9 +27,12 @@ export declare function layoutFallbackGeometry(record: EditDoc['elements'][strin
 export declare function projectedSlideElementIds(doc: EditDoc, slideId: SlideId): Array<ElementId | null>;
 /** 尚无 slide 内容节点的目标占位符只供 edit interaction layer 提示，不进入业务渲染。 */
 export declare function unboundLayoutPlaceholders(doc: EditDoc, slideId: SlideId): SlideElement[];
-export declare function rebasedElementBase(doc: EditDoc, slideId: SlideId, record: EditDoc['elements'][string]): {
+export declare function rebasedElementBase(doc: EditDoc, slideId: SlideId, record: EditDoc['elements'][string], resolveLayoutElement?: LayoutElementResolver): {
     base: SlideElement;
     geom?: GeomSpec;
 };
 /** 文字命令从当前版式的重基值起步，不能把旧版式有效值烘进首次覆盖。 */
-export declare function rebasedTextBase(doc: EditDoc, slideId: SlideId, id: ElementId): TextBody | null;
+export declare function rebasedTextBase(doc: EditDoc, slideId: SlideId, id: ElementId, resolveLayoutElement?: LayoutElementResolver): TextBody | null;
+/** 列表改级必须读取九级样式目录，不能从当前段落反推相邻级别的继承值。 */
+export declare function rebasedTextLevelTemplate(doc: EditDoc, slideId: SlideId, id: ElementId): TextBody | undefined;
+export {};

package/dist/layout-state.d.ts

@@ -0,0 +1,2 @@
+import type { EditDoc } from './types';
+export declare function layoutHasEdits(doc: EditDoc, id: string): boolean;

package/dist/layout-types.d.ts

@@ -0,0 +1,42 @@
+import type { Fill, SlideLayoutTemplate, Transition } from '@web-ppt/core';
+import type { ElementId } from './identities';
+/** 设计来源必须带领域种类，调用方不能把 OPC part 冒充普通 SlideId。 */
+export type LayoutDesignTarget = {
+    readonly kind: 'layout';
+    readonly id: string;
+};
+export type MasterDesignTarget = {
+    readonly kind: 'master';
+    readonly id: string;
+};
+export type DesignTarget = LayoutDesignTarget | MasterDesignTarget;
+export interface LayoutOverrides {
+    /** 缺少字段表示来源；显式无背景使用 Fill.none。 */
+    background?: Exclude<Fill, {
+        type: 'image';
+    }>;
+    /** 缺少字段表示来源；Transition.none 表示明确关闭。 */
+    transition?: Transition;
+}
+/** 保留原目录字段以兼容新增页调用方；编辑状态只进入 children / ovr。 */
+export interface LayoutRecord extends SlideLayoutTemplate {
+    children: ElementId[];
+    ovr: LayoutOverrides;
+}
+export interface LayoutCatalogItem {
+    readonly id: string;
+    readonly name: string;
+    readonly masterId: string;
+    readonly themeId?: string;
+    readonly target: LayoutDesignTarget;
+}
+export interface LayoutPropertyState<T> {
+    readonly value: T;
+    readonly source: T;
+    readonly direct: boolean;
+}
+/** 面板只读取求值结果与稀疏覆盖状态，不暴露可变的 LayoutRecord。 */
+export interface LayoutDesignState extends LayoutCatalogItem {
+    readonly background: LayoutPropertyState<Fill | null>;
+    readonly transition: LayoutPropertyState<Transition | null>;
+}

package/dist/layout.d.ts

@@ -0,0 +1,5 @@
+import type { Slide } from '@web-ppt/core';
+import type { EditDoc, LayoutCatalogItem, LayoutDesignState, LayoutDesignTarget } from './types';
+export declare function listLayouts(doc: EditDoc): LayoutCatalogItem[];
+export declare function queryLayout(doc: EditDoc, target: LayoutDesignTarget): LayoutDesignState;
+export declare function toLayoutCanvas(doc: EditDoc, target: LayoutDesignTarget): Slide;

package/dist/lint/color.d.ts

@@ -0,0 +1,5 @@
+import type { Fill } from '@web-ppt/core';
+export declare function color(value: string): readonly [number, number, number, number];
+export declare function over(fg: readonly number[], bg: readonly number[]): readonly [number, number, number, number];
+export declare function contrast(fg: readonly number[], bg: readonly number[]): number;
+export declare function paint(fill: Fill | null | undefined, bg: readonly number[]): readonly number[] | null;

package/dist/lint/index.d.ts

@@ -0,0 +1,7 @@
+import type { EditDoc } from '@web-ppt/edit-core';
+import type { TextMeasure } from '@web-ppt/core';
+import type { LayoutLintOptions, LayoutLintReport } from './types';
+export { LayoutLintError, LAYOUT_CHECKS } from './types';
+export type { LayoutCheck, LayoutIssue, LayoutLintOptions, LayoutLintReport, LintContext, ContrastContext, ContrastSamples } from './types';
+export declare function prepareLintText(doc: EditDoc, measureText: TextMeasure): void;
+export declare function lintPresentation(doc: EditDoc, options?: LayoutLintOptions): Promise<LayoutLintReport>;

package/dist/lint/prompts.d.ts

@@ -0,0 +1,3 @@
+import type { EditDoc } from '@web-ppt/edit-core';
+import type { DescriptionElement } from '../describe/types';
+export declare function promptReader(doc: EditDoc): (element: DescriptionElement) => string[];

package/dist/lint/report.d.ts

@@ -0,0 +1,21 @@
+import type { DescriptionElement } from '../describe/types';
+export declare const LAYOUT_CHECKS: readonly ["text-overflow", "element-overlap", "off-canvas", "low-contrast", "missing-font", "placeholder-prompt-left", "image-distorted"];
+export type LayoutCheck = typeof LAYOUT_CHECKS[number];
+export interface LayoutIssue {
+    readonly reason: LayoutCheck;
+    readonly slideNumber: number;
+    readonly elementId: string;
+    readonly bounds: DescriptionElement['bounds'];
+    readonly cell: {
+        readonly row: number;
+        readonly column: number;
+    } | null;
+    readonly measurements: Readonly<Record<string, number | string | boolean | readonly string[]>>;
+}
+export interface LayoutLintReport {
+    readonly version: 1;
+    readonly checks: readonly LayoutCheck[];
+    readonly totalSlides: number;
+    readonly totalElements: number;
+    readonly issues: readonly LayoutIssue[];
+}

package/dist/lint/sampler-batch.d.ts

@@ -0,0 +1,4 @@
+import type { ContrastContext, ContrastSamples } from './types';
+import type { SvgContrastSamplerOptions } from './sampler';
+/** 每页只渲染完整图、无字底图和颜色标记图，避免图表密集页按 run 重复光栅化。 */
+export declare function createSvgContrastSampler(options: SvgContrastSamplerOptions): (context: ContrastContext) => Promise<ContrastSamples>;

package/dist/lint/sampler-images.d.ts

@@ -0,0 +1,2 @@
+/** 遮挡形状保留 alpha、统一绘黑；图片填充与普通图片同样不能泄漏 run 标记颜色。 */
+export declare function blackenImages(svg: string): string;

package/dist/lint/sampler.d.ts

@@ -0,0 +1,9 @@
+import type { EmbeddedFont } from '@web-ppt/core';
+export interface SvgContrastSamplerOptions {
+    readonly rasterize: (svg: string, width: number, height: number, signal?: AbortSignal) => Promise<Uint8Array | Uint8ClampedArray>;
+    readonly embeddedFonts?: readonly EmbeddedFont[];
+    readonly fontFamily?: string;
+    readonly scale?: number;
+    readonly maxPixels?: number;
+}
+export { createSvgContrastSampler } from './sampler-batch';

package/dist/lint/snapshot.d.ts

@@ -0,0 +1,34 @@
+import type { Fill, SlideElement, TextBody } from '@web-ppt/core';
+import type { EditDoc } from '@web-ppt/edit-core';
+export interface TextUnit {
+    body: TextBody;
+    width: number;
+    height: number;
+    fill: Fill | null;
+    cell: {
+        row: number;
+        column: number;
+    } | null;
+}
+export declare function textUnits(element: SlideElement): TextUnit[];
+export declare function snapshot(doc: EditDoc): {
+    description: import("../describe").PresentationDescription;
+    slides: {
+        elements: SlideElement[];
+        background: Fill | null;
+        notes?: string;
+        hidden?: boolean;
+        layoutName?: string;
+        transition?: import("@web-ppt/core").Transition;
+        animations?: import("@web-ppt/core").AnimStep[];
+        comments?: import("@web-ppt/core").SlideComment[];
+        editInfo?: import("@web-ppt/core").SlideEditInfo;
+    }[];
+    elements: {
+        item: import("../describe").DescriptionElement;
+        raw: SlideElement;
+        visible: SlideElement;
+        rendered: SlideElement;
+        units: TextUnit[];
+    }[][];
+};

package/dist/lint/types.d.ts

@@ -0,0 +1,67 @@
+import type { ImageMetadata, Paragraph, Slide, SlideElement, TextBody, TextMeasure, TextRun } from '@web-ppt/core';
+import type { LayoutCheck } from './report';
+export { LAYOUT_CHECKS } from './report';
+export type { LayoutCheck, LayoutIssue, LayoutLintReport } from './report';
+export interface LintContext {
+    readonly slideNumber: number;
+    readonly elementId: string;
+    readonly element: Readonly<SlideElement>;
+    readonly slide: Readonly<Slide>;
+    readonly canvas: {
+        readonly width: number;
+        readonly height: number;
+        readonly color: string;
+    };
+    readonly resource: (url: string) => {
+        readonly bytes: Uint8Array;
+        readonly mime: string;
+    } | undefined;
+    readonly bindings: readonly {
+        readonly elementId: string;
+        readonly element: Readonly<SlideElement>;
+    }[];
+    readonly signal?: AbortSignal;
+}
+export interface ContrastContext extends LintContext {
+    readonly body: Readonly<TextBody>;
+    readonly paragraph: Readonly<Paragraph>;
+    readonly run: Readonly<TextRun>;
+    readonly textIndex: number;
+    readonly paragraphIndex: number;
+    readonly runIndex: number;
+}
+export interface LayoutLintOptions {
+    readonly checks?: readonly LayoutCheck[];
+    readonly measureText?: TextMeasure;
+    readonly fonts?: {
+        readonly available: readonly string[];
+        readonly embedded: readonly string[];
+    };
+    readonly canvasColor?: string;
+    readonly overlapRatio?: number;
+    readonly imageDeviation?: number;
+    readonly tolerancePx?: number;
+    readonly maxIssues?: number;
+    readonly signal?: AbortSignal;
+    readonly onProgress?: (progress: {
+        completed: number;
+        total: number;
+    }) => void | Promise<void>;
+    readonly resolveContrast?: (context: ContrastContext) => ContrastSamples | Promise<ContrastSamples>;
+    readonly resolveImageMetadata?: (context: LintContext) => ImageMetadata | undefined | Promise<ImageMetadata | undefined>;
+    readonly resolvePlaceholderPrompts?: (context: LintContext) => readonly string[] | undefined | Promise<readonly string[] | undefined>;
+}
+export type ContrastSamples = readonly {
+    foreground: string;
+    background: string;
+}[] | {
+    readonly visible: false;
+};
+export declare class LayoutLintError extends Error {
+    readonly reason: string;
+    readonly slideNumber: number | null;
+    readonly elementId: string | null;
+    constructor(reason: string, message: string, slideNumber?: number | null, elementId?: string | null);
+}
+export declare function active(signal?: AbortSignal): void;
+export declare function waitFor<T>(value: T | Promise<T>, signal?: AbortSignal): Promise<T>;