ooxml-core 0.19.0 → 0.21.0

package/dist/pptx/ui/index.mjs

@@ -0,0 +1,499 @@
+// src/color/color-primitives.ts
+function clampUnitInterval(value) {
+  return Math.min(1, Math.max(0, value));
+}
+function normalizeHexColor(value, fallback = "#111827") {
+  if (!value || value === "transparent") {
+    return fallback;
+  }
+  const candidate = value.startsWith("#") ? value : `#${value}`;
+  return /^#[0-9A-Fa-f]{6}$/.test(candidate) ? candidate : fallback;
+}
+function hexToRgbChannels(color) {
+  const normalized = color.replace("#", "");
+  if (!/^[0-9a-fA-F]{6}$/.test(normalized)) {
+    return null;
+  }
+  return {
+    r: Number.parseInt(normalized.slice(0, 2), 16),
+    g: Number.parseInt(normalized.slice(2, 4), 16),
+    b: Number.parseInt(normalized.slice(4, 6), 16)
+  };
+}
+function percentDivisorFor(text) {
+  return text.endsWith("%") ? 100 : 1e5;
+}
+function parseOoxmlPercent(value) {
+  const text = String(value ?? "").trim();
+  const divisor = percentDivisorFor(text);
+  const magnitude = Number.parseFloat(divisor === 100 ? text.slice(0, -1) : text);
+  if (!Number.isFinite(magnitude)) {
+    return void 0;
+  }
+  return magnitude / divisor;
+}
+function parseDrawingPercent(value) {
+  const parsed = parseOoxmlPercent(value);
+  return parsed === void 0 ? void 0 : clampUnitInterval(parsed);
+}
+function toHex(value) {
+  return Math.min(255, Math.max(0, Math.round(value))).toString(16).padStart(2, "0").toUpperCase();
+}
+function rgbToHsl(r, g, b) {
+  const rN = r / 255;
+  const gN = g / 255;
+  const bN = b / 255;
+  const cMax = Math.max(rN, gN, bN);
+  const cMin = Math.min(rN, gN, bN);
+  const delta = cMax - cMin;
+  const l = (cMax + cMin) / 2;
+  let s = 0;
+  if (delta !== 0) {
+    s = delta / (1 - Math.abs(2 * l - 1));
+  }
+  let h = 0;
+  if (delta !== 0) {
+    if (cMax === rN) {
+      h = 60 * ((gN - bN) / delta % 6);
+    } else if (cMax === gN) {
+      h = 60 * ((bN - rN) / delta + 2);
+    } else {
+      h = 60 * ((rN - gN) / delta + 4);
+    }
+  }
+  if (h < 0) {
+    h += 360;
+  }
+  return { h, s: clampUnitInterval(s), l: clampUnitInterval(l) };
+}
+function hslToRgb(h, s, l) {
+  const sC = clampUnitInterval(s);
+  const lC = clampUnitInterval(l);
+  const hN = (h % 360 + 360) % 360;
+  const c = (1 - Math.abs(2 * lC - 1)) * sC;
+  const x = c * (1 - Math.abs(hN / 60 % 2 - 1));
+  const m = lC - c / 2;
+  let rP = 0;
+  let gP = 0;
+  let bP = 0;
+  if (hN < 60) {
+    rP = c;
+    gP = x;
+    bP = 0;
+  } else if (hN < 120) {
+    rP = x;
+    gP = c;
+    bP = 0;
+  } else if (hN < 180) {
+    rP = 0;
+    gP = c;
+    bP = x;
+  } else if (hN < 240) {
+    rP = 0;
+    gP = x;
+    bP = c;
+  } else if (hN < 300) {
+    rP = x;
+    gP = 0;
+    bP = c;
+  } else {
+    rP = c;
+    gP = 0;
+    bP = x;
+  }
+  return {
+    r: Math.round((rP + m) * 255),
+    g: Math.round((gP + m) * 255),
+    b: Math.round((bP + m) * 255)
+  };
+}
+function parseDrawingFraction(value) {
+  return parseOoxmlPercent(value);
+}
+function parseDrawingHueDegrees(value) {
+  const parsed = Number.parseFloat(String(value ?? "").trim());
+  if (!Number.isFinite(parsed)) {
+    return void 0;
+  }
+  return parsed / 6e4;
+}
+
+// src/color/color-linear.ts
+function srgb255ToLinear(channel) {
+  const c = clampUnitInterval(channel / 255);
+  return c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+function linearToSrgb255(linear) {
+  const c = clampUnitInterval(linear);
+  return 255 * (c <= 31308e-7 ? c * 12.92 : 1.055 * c ** (1 / 2.4) - 0.055);
+}
+
+// src/pptx/core/color/color-transforms.ts
+function applyDrawingColorTransforms(baseColor, colorNode) {
+  const rgb = hexToRgbChannels(baseColor);
+  if (!rgb) {
+    return baseColor;
+  }
+  let r = rgb.r;
+  let g = rgb.g;
+  let b = rgb.b;
+  const getVal = (key) => colorNode[key]?.["@_val"];
+  if (colorNode["a:gamma"] !== void 0) {
+    const out = applySrgbGammaEncode(r, g, b);
+    r = out.r;
+    g = out.g;
+    b = out.b;
+  }
+  if (colorNode["a:invGamma"] !== void 0) {
+    const out = applySrgbGammaDecode(r, g, b);
+    r = out.r;
+    g = out.g;
+    b = out.b;
+  }
+  if (colorNode["a:comp"] !== void 0) {
+    const hsl = rgbToHsl(r, g, b);
+    hsl.h = (hsl.h + 180) % 360;
+    const out = hslToRgb(hsl.h, hsl.s, hsl.l);
+    r = out.r;
+    g = out.g;
+    b = out.b;
+  }
+  if (colorNode["a:inv"] !== void 0) {
+    r = 255 - r;
+    g = 255 - g;
+    b = 255 - b;
+  }
+  if (colorNode["a:gray"] !== void 0) {
+    const gray = Math.round(0.299 * r + 0.587 * g + 0.114 * b);
+    r = gray;
+    g = gray;
+    b = gray;
+  }
+  const shade = parseDrawingPercent(getVal("a:shade"));
+  if (shade !== void 0) {
+    r = linearToSrgb255(srgb255ToLinear(r) * shade);
+    g = linearToSrgb255(srgb255ToLinear(g) * shade);
+    b = linearToSrgb255(srgb255ToLinear(b) * shade);
+  }
+  const tint = parseDrawingPercent(getVal("a:tint"));
+  if (tint !== void 0) {
+    r = linearToSrgb255(1 - (1 - srgb255ToLinear(r)) * tint);
+    g = linearToSrgb255(1 - (1 - srgb255ToLinear(g)) * tint);
+    b = linearToSrgb255(1 - (1 - srgb255ToLinear(b)) * tint);
+  }
+  const hslKeys = [
+    "a:hue",
+    "a:hueMod",
+    "a:hueOff",
+    "a:sat",
+    "a:satMod",
+    "a:satOff",
+    "a:lum",
+    "a:lumMod",
+    "a:lumOff"
+  ];
+  const hasHsl = hslKeys.some((k) => colorNode[k] !== void 0);
+  if (hasHsl) {
+    const hsl = rgbToHsl(r, g, b);
+    const hueAbs = parseDrawingHueDegrees(getVal("a:hue"));
+    if (hueAbs !== void 0) {
+      hsl.h = (hueAbs % 360 + 360) % 360;
+    }
+    const hueMod = parseDrawingFraction(getVal("a:hueMod"));
+    if (hueMod !== void 0) {
+      hsl.h = (hsl.h * hueMod % 360 + 360) % 360;
+    }
+    const hueOff = parseDrawingHueDegrees(getVal("a:hueOff"));
+    if (hueOff !== void 0) {
+      hsl.h = ((hsl.h + hueOff) % 360 + 360) % 360;
+    }
+    const satAbs = parseDrawingFraction(getVal("a:sat"));
+    if (satAbs !== void 0) {
+      hsl.s = clampUnitInterval(satAbs);
+    }
+    const satMod = parseDrawingFraction(getVal("a:satMod"));
+    if (satMod !== void 0) {
+      hsl.s = clampUnitInterval(hsl.s * satMod);
+    }
+    const satOff = parseDrawingFraction(getVal("a:satOff"));
+    if (satOff !== void 0) {
+      hsl.s = clampUnitInterval(hsl.s + satOff);
+    }
+    const lumAbs = parseDrawingFraction(getVal("a:lum"));
+    if (lumAbs !== void 0) {
+      hsl.l = clampUnitInterval(lumAbs);
+    }
+    const lumMod = parseDrawingFraction(getVal("a:lumMod"));
+    if (lumMod !== void 0) {
+      hsl.l = clampUnitInterval(hsl.l * lumMod);
+    }
+    const lumOff = parseDrawingFraction(getVal("a:lumOff"));
+    if (lumOff !== void 0) {
+      hsl.l = clampUnitInterval(hsl.l + lumOff);
+    }
+    const out = hslToRgb(hsl.h, hsl.s, hsl.l);
+    r = out.r;
+    g = out.g;
+    b = out.b;
+  }
+  const redAbs = parseDrawingFraction(getVal("a:red"));
+  if (redAbs !== void 0) {
+    r = Math.round(clampUnitInterval(redAbs) * 255);
+  }
+  const redMod = parseDrawingFraction(getVal("a:redMod"));
+  if (redMod !== void 0) {
+    r = Math.min(255, Math.max(0, Math.round(r * redMod)));
+  }
+  const redOff = parseDrawingFraction(getVal("a:redOff"));
+  if (redOff !== void 0) {
+    r = Math.min(255, Math.max(0, Math.round(r + 255 * redOff)));
+  }
+  const greenAbs = parseDrawingFraction(getVal("a:green"));
+  if (greenAbs !== void 0) {
+    g = Math.round(clampUnitInterval(greenAbs) * 255);
+  }
+  const greenMod = parseDrawingFraction(getVal("a:greenMod"));
+  if (greenMod !== void 0) {
+    g = Math.min(255, Math.max(0, Math.round(g * greenMod)));
+  }
+  const greenOff = parseDrawingFraction(getVal("a:greenOff"));
+  if (greenOff !== void 0) {
+    g = Math.min(255, Math.max(0, Math.round(g + 255 * greenOff)));
+  }
+  const blueAbs = parseDrawingFraction(getVal("a:blue"));
+  if (blueAbs !== void 0) {
+    b = Math.round(clampUnitInterval(blueAbs) * 255);
+  }
+  const blueMod = parseDrawingFraction(getVal("a:blueMod"));
+  if (blueMod !== void 0) {
+    b = Math.min(255, Math.max(0, Math.round(b * blueMod)));
+  }
+  const blueOff = parseDrawingFraction(getVal("a:blueOff"));
+  if (blueOff !== void 0) {
+    b = Math.min(255, Math.max(0, Math.round(b + 255 * blueOff)));
+  }
+  return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+function srgbEncodeChannel(channel) {
+  const linear = Math.min(1, Math.max(0, channel / 255));
+  const companded = linear <= 31308e-7 ? 12.92 * linear : 1.055 * linear ** (1 / 2.4) - 0.055;
+  return Math.min(255, Math.max(0, Math.round(companded * 255)));
+}
+function srgbDecodeChannel(channel) {
+  const companded = Math.min(1, Math.max(0, channel / 255));
+  const linear = companded <= 0.04045 ? companded / 12.92 : ((companded + 0.055) / 1.055) ** 2.4;
+  return Math.min(255, Math.max(0, Math.round(linear * 255)));
+}
+function applySrgbGammaEncode(r, g, b) {
+  return { r: srgbEncodeChannel(r), g: srgbEncodeChannel(g), b: srgbEncodeChannel(b) };
+}
+function applySrgbGammaDecode(r, g, b) {
+  return { r: srgbDecodeChannel(r), g: srgbDecodeChannel(g), b: srgbDecodeChannel(b) };
+}
+
+// src/pptx/core/color/theme-color-ref.ts
+var DEFAULT_ALIASES = {
+  bg1: "lt1",
+  tx1: "dk1",
+  bg2: "lt2",
+  tx2: "dk2"
+};
+function percentVal(fraction) {
+  return String(Math.round(fraction * 1e5));
+}
+function themeColorRefToXml(ref) {
+  const node = { "@_val": ref.scheme };
+  if (ref.tint !== void 0) {
+    node["a:tint"] = { "@_val": percentVal(ref.tint) };
+  }
+  if (ref.shade !== void 0) {
+    node["a:shade"] = { "@_val": percentVal(ref.shade) };
+  }
+  if (ref.lumMod !== void 0) {
+    node["a:lumMod"] = { "@_val": percentVal(ref.lumMod) };
+  }
+  if (ref.lumOff !== void 0) {
+    node["a:lumOff"] = { "@_val": percentVal(ref.lumOff) };
+  }
+  if (ref.alpha !== void 0) {
+    node["a:alpha"] = { "@_val": percentVal(ref.alpha) };
+  }
+  return node;
+}
+function resolveThemeColorRef(ref, themeColorMap) {
+  if (!themeColorMap) {
+    return void 0;
+  }
+  const base = themeColorMap[ref.scheme] ?? themeColorMap[DEFAULT_ALIASES[ref.scheme] ?? ""];
+  if (!base) {
+    return void 0;
+  }
+  const node = themeColorRefToXml(ref);
+  delete node["a:alpha"];
+  return normalizeHexColor(
+    applyDrawingColorTransforms(normalizeHexColor(base), node)
+  ).toLowerCase();
+}
+
+// src/pptx/core/types/color-ref.ts
+var THEME_COLOR_PALETTE_COLUMNS = [
+  "bg1",
+  "tx1",
+  "bg2",
+  "tx2",
+  "accent1",
+  "accent2",
+  "accent3",
+  "accent4",
+  "accent5",
+  "accent6"
+];
+
+// src/pptx/ui/theme-color-swatches.ts
+var COLUMN_LABELS = {
+  bg1: "Background 1",
+  tx1: "Text 1",
+  bg2: "Background 2",
+  tx2: "Text 2",
+  accent1: "Accent 1",
+  accent2: "Accent 2",
+  accent3: "Accent 3",
+  accent4: "Accent 4",
+  accent5: "Accent 5",
+  accent6: "Accent 6",
+  dk1: "Text 1",
+  lt1: "Background 1",
+  dk2: "Text 2",
+  lt2: "Background 2",
+  hlink: "Hyperlink",
+  folHlink: "Followed Hyperlink"
+};
+function lighter(percent) {
+  return { kind: "lighter", percent };
+}
+function darker(percent) {
+  return { kind: "darker", percent };
+}
+function themeColorVariantsForLuminance(l) {
+  if (l < 0.05) {
+    return [lighter(50), lighter(35), lighter(25), lighter(15), lighter(5)];
+  }
+  if (l < 0.25) {
+    return [lighter(90), lighter(75), lighter(50), lighter(25), lighter(10)];
+  }
+  if (l < 0.75) {
+    return [lighter(80), lighter(60), lighter(40), darker(25), darker(50)];
+  }
+  if (l < 0.95) {
+    return [darker(10), darker(25), darker(50), darker(75), darker(90)];
+  }
+  return [darker(5), darker(15), darker(25), darker(35), darker(50)];
+}
+function themeColorVariantToRef(scheme, variant) {
+  const fraction = variant.percent / 100;
+  const lumMod = Math.round((1 - fraction) * 1e5) / 1e5;
+  return variant.kind === "lighter" ? { scheme, lumMod, lumOff: fraction } : { scheme, lumMod };
+}
+function describeThemeColorSwatch(ref, variant) {
+  const column = COLUMN_LABELS[ref.scheme] ?? ref.scheme;
+  if (!variant) {
+    return column;
+  }
+  const word = variant.kind === "lighter" ? "Lighter" : "Darker";
+  return `${column}, ${word} ${variant.percent}%`;
+}
+function themeColorVariantOfRef(ref) {
+  if (ref.lumMod === void 0 || ref.tint !== void 0 || ref.shade !== void 0) {
+    return void 0;
+  }
+  const percent = Math.round((1 - ref.lumMod) * 100);
+  if (ref.lumOff !== void 0) {
+    return Math.round(ref.lumOff * 100) === percent ? lighter(percent) : void 0;
+  }
+  return darker(percent);
+}
+function buildThemeColorSwatchGrid(themeColorMap) {
+  if (!themeColorMap) {
+    return [];
+  }
+  const columns = [];
+  for (const scheme of THEME_COLOR_PALETTE_COLUMNS) {
+    const baseRef = { scheme };
+    const baseHex = resolveThemeColorRef(baseRef, themeColorMap);
+    const rgb = baseHex ? hexToRgbChannels(baseHex) : null;
+    if (!baseHex || !rgb) {
+      continue;
+    }
+    const { l } = rgbToHsl(rgb.r, rgb.g, rgb.b);
+    const variants = [];
+    for (const variant of themeColorVariantsForLuminance(l)) {
+      const ref = themeColorVariantToRef(scheme, variant);
+      const hex = resolveThemeColorRef(ref, themeColorMap);
+      if (hex) {
+        variants.push({ ref, hex, label: describeThemeColorSwatch(ref, variant), variant });
+      }
+    }
+    columns.push({
+      scheme,
+      base: {
+        ref: baseRef,
+        hex: baseHex,
+        label: describeThemeColorSwatch(baseRef, void 0),
+        variant: void 0
+      },
+      variants
+    });
+  }
+  return columns;
+}
+
+// src/pptx/ui/theme-color-picker-state.ts
+function themeColorRefsEqual(a, b) {
+  if (!a || !b) {
+    return a === b;
+  }
+  return a.scheme === b.scheme && a.lumMod === b.lumMod && a.lumOff === b.lumOff && a.tint === b.tint && a.shade === b.shade;
+}
+function findSelectedThemeSwatch(columns, ref, hex) {
+  if (ref) {
+    for (const column of columns) {
+      const swatches = [column.base, ...column.variants];
+      const match = swatches.find((swatch) => themeColorRefsEqual(swatch.ref, ref));
+      if (match) {
+        return match;
+      }
+    }
+    return void 0;
+  }
+  if (!hex) {
+    return void 0;
+  }
+  const normalized = hex.trim().toLowerCase();
+  for (const column of columns) {
+    const swatches = [column.base, ...column.variants];
+    const match = swatches.find((swatch) => swatch.hex.toLowerCase() === normalized);
+    if (match) {
+      return match;
+    }
+  }
+  return void 0;
+}
+function themeSwatchCommit(swatch) {
+  return { hex: swatch.hex, ref: swatch.ref };
+}
+function customColorCommit(hex) {
+  return { hex, ref: void 0 };
+}
+function themeColorSwatchRows(columns) {
+  if (columns.length === 0) {
+    return [];
+  }
+  const variantRowCount = Math.max(...columns.map((column) => column.variants.length));
+  const rows = [columns.map((column) => column.base)];
+  for (let i = 0; i < variantRowCount; i++) {
+    rows.push(columns.map((column) => column.variants[i]));
+  }
+  return rows;
+}
+
+export { buildThemeColorSwatchGrid, customColorCommit, describeThemeColorSwatch, findSelectedThemeSwatch, themeColorRefsEqual, themeColorSwatchRows, themeColorVariantOfRef, themeColorVariantToRef, themeColorVariantsForLuminance, themeSwatchCommit };

package/dist/visio/index.cjs

@@ -25,7 +25,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)

package/dist/visio/index.mjs

@@ -19,7 +19,8 @@ function parseXml(xml, options = {}) {
     }).parseFromString(xml, "application/xml");
   } catch (error) {
     throw new Error(
-      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`,
+      { cause: error }
     );
   }
   if (parseError || !parsed.documentElement)

package/dist/visio/ui/contract.d.ts

@@ -0,0 +1,33 @@
+import type { VisioDocument } from '../index.js';
+export interface ViewerProperties {
+    document: VisioDocument | null;
+    pageIndex: number;
+    zoom: number;
+    showToolbar: boolean;
+}
+export interface ViewerEvents {
+    'document-load': VisioDocument;
+    'document-change': {
+        document: VisioDocument;
+        dirty: boolean;
+        kind: 'edit' | 'undo' | 'redo' | 'remote';
+    };
+    'document-error': Error;
+    'page-change': number;
+    'zoom-change': number;
+    'shape-select': {
+        id: string;
+        name: string;
+        pageId?: string;
+    } | null;
+}
+export type ViewerCallbacks = {
+    [K in keyof ViewerEvents]?: (detail: ViewerEvents[K]) => void;
+};
+export declare const propertyKeys: readonly ["document", "pageIndex", "zoom", "showToolbar"];
+export declare const eventKeys: readonly ["document-load", "document-change", "document-error", "page-change", "zoom-change", "shape-select"];
+export type VsdxSource = ArrayBuffer | Uint8Array | Blob;
+export interface ViewerOptions extends Partial<ViewerProperties> {
+    events?: ViewerCallbacks;
+}
+//# sourceMappingURL=contract.d.ts.map

package/dist/visio/ui/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/visio/ui/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACrB;AACD,MAAM,WAAW,YAAY;IAC5B,eAAe,EAAE,aAAa,CAAC;IAC/B,iBAAiB,EAAE;QAClB,QAAQ,EAAE,aAAa,CAAC;QACxB,KAAK,EAAE,OAAO,CAAC;QACf,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;KAC1C,CAAC;IACF,gBAAgB,EAAE,KAAK,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACrE;AACD,MAAM,MAAM,eAAe,GAAG;KAC5B,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI;CAC7D,CAAC;AACF,eAAO,MAAM,YAAY,2DAK+B,CAAC;AACzD,eAAO,MAAM,SAAS,+GAO8B,CAAC;AASrD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;AACzD,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IAC/D,MAAM,CAAC,EAAE,eAAe,CAAC;CACzB"}

package/dist/visio/ui/demo-document.d.ts

@@ -0,0 +1,4 @@
+import type { VisioDocument } from '../index.js';
+/** Original sample scene, not a Visio-authored reference fixture. */
+export declare const demoDocument: VisioDocument;
+//# sourceMappingURL=demo-document.d.ts.map

package/dist/visio/ui/demo-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-document.d.ts","sourceRoot":"","sources":["../../../src/visio/ui/demo-document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,aAAa,CAAC;AAyD7D,qEAAqE;AACrE,eAAO,MAAM,YAAY,EAAE,aAwD1B,CAAC"}

package/dist/visio/ui/diagnostics.d.ts

@@ -0,0 +1,10 @@
+import type { VisioDiagnostic } from '../index.js';
+export interface CompatibilityNote {
+    message: string;
+    count: number;
+    severity: 'info' | 'warning';
+}
+/** Presentation-only grouping keeps repeated per-shape diagnostics readable without losing counts. */
+export declare function compatibilityNotes(diagnostics: readonly VisioDiagnostic[], renderWarnings?: readonly string[]): CompatibilityNote[];
+export declare function compatibilityText(note: CompatibilityNote): string;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/visio/ui/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/visio/ui/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AACD,sGAAsG;AACtG,wBAAgB,kBAAkB,CACjC,WAAW,EAAE,SAAS,eAAe,EAAE,EACvC,cAAc,GAAE,SAAS,MAAM,EAAO,GACpC,iBAAiB,EAAE,CAwBrB;AACD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAEjE"}

package/dist/visio/ui/document-history.d.ts

@@ -0,0 +1,43 @@
+/** Source snapshots only. No document model is serialized by the viewer. */
+export interface EditDiagnostic {
+    readonly code: string;
+    readonly message: string;
+}
+export interface VsdxExportResult {
+    bytes: Uint8Array;
+    dirty: boolean;
+    diagnostics: readonly EditDiagnostic[];
+}
+export interface ViewerEditState {
+    readonly sourceAvailable: boolean;
+    readonly busy: boolean;
+    readonly dirty: boolean;
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    readonly historyTruncated: boolean;
+    readonly error: Error | null;
+    readonly diagnostics: readonly EditDiagnostic[];
+}
+export declare const EMPTY_EDIT_STATE: ViewerEditState;
+export declare const EDIT_HISTORY_LIMITS: Readonly<{
+    maxBytes: number;
+    maxEntries: 20;
+}>;
+export interface SourceSnapshot {
+    readonly bytes: Uint8Array;
+    readonly diagnostics: readonly EditDiagnostic[];
+}
+/** Private controller-owned bytes; transient worker copies and models are separate from this budget. */
+export declare class DocumentHistory {
+    #private;
+    readonly original: SourceSnapshot;
+    constructor(bytes: Uint8Array);
+    get current(): SourceSnapshot;
+    get undoTarget(): SourceSnapshot | undefined;
+    get redoTarget(): SourceSnapshot | undefined;
+    get state(): ViewerEditState;
+    append(bytes: Uint8Array, diagnostics: readonly EditDiagnostic[]): void;
+    move(target: SourceSnapshot): void;
+    export(): VsdxExportResult;
+}
+//# sourceMappingURL=document-history.d.ts.map

package/dist/visio/ui/document-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-history.d.ts","sourceRoot":"","sources":["../../../src/visio/ui/document-history.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;CACvC;AACD,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;CAChD;AACD,eAAO,MAAM,gBAAgB,EAAE,eAS7B,CAAC;AACH,eAAO,MAAM,mBAAmB;;;EAAgE,CAAC;AACjG,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;CAChD;AACD,wGAAwG;AACxG,qBAAa,eAAe;;IAC3B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAIlC,YAAY,KAAK,EAAE,UAAU,EAG5B;IACD,IAAI,OAAO,IAAI,cAAc,CAE5B;IACD,IAAI,UAAU,IAAI,cAAc,GAAG,SAAS,CAE3C;IACD,IAAI,UAAU,IAAI,cAAc,GAAG,SAAS,CAE3C;IACD,IAAI,KAAK,IAAI,eAAe,CAU3B;IACD,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAsBtE;IACD,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAKjC;IACD,MAAM,IAAI,gBAAgB,CAMzB;CACD"}

package/dist/visio/ui/document-text-search.d.ts

@@ -0,0 +1,45 @@
+import type { VisioDocument, VisioShape } from '../index.js';
+/** UTF-16 character bounds, applied before copying or case conversion. */
+export declare const TEXT_SEARCH_LIMITS: Readonly<{
+    queryCharacters: 256;
+    results: 500;
+    indexedCharacters: 2000000;
+    shapeCharacters: 32768;
+    previewCharacters: 160;
+    shapes: 25000;
+    depth: 64;
+}>;
+export interface TextSearchResult {
+    readonly pageIndex: number;
+    readonly pageId: string;
+    readonly pageName: string;
+    readonly shapeId: string;
+    readonly shapeName: string;
+    /** Bounded start-of-text preview, not a match offset or highlighted excerpt. */
+    readonly preview: string;
+}
+export interface TextSearchState {
+    readonly query: string;
+    readonly results: readonly TextSearchResult[];
+    /** -1 until the user explicitly navigates, or after manual page/shape selection. */
+    readonly activeIndex: number;
+    readonly indexTruncated: boolean;
+    readonly resultsTruncated: boolean;
+}
+interface SearchEntry {
+    readonly result: TextSearchResult;
+    readonly foldedText: string;
+}
+export interface DocumentTextIndex {
+    readonly entries: readonly SearchEntry[];
+    readonly truncated: boolean;
+}
+export declare const EMPTY_TEXT_SEARCH: TextSearchState;
+/** Index canonical text for the current display state. No XML, DOM or layout parsing. */
+export declare function indexDocumentText(model: VisioDocument | null, isVisible?: (shape: VisioShape) => boolean): DocumentTextIndex;
+export declare function validateSearchQuery(query: string): void;
+/** One match per shape, literal ECMAScript lowercase comparison; no regex or language collation. */
+export declare function searchDocumentText(index: DocumentTextIndex, query: string): TextSearchState;
+export declare function textSearchStatus(search: TextSearchState): string;
+export {};
+//# sourceMappingURL=document-text-search.d.ts.map

package/dist/visio/ui/document-text-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-text-search.d.ts","sourceRoot":"","sources":["../../../src/visio/ui/document-text-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7D,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB;;;;;;;;EAQ7B,CAAC;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACnC;AACD,UAAU,WAAW;IACpB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AACD,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC5B;AACD,eAAO,MAAM,iBAAiB,EAAE,eAM9B,CAAC;AAEH,yFAAyF;AACzF,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,SAAS,GAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAkC,GAClE,iBAAiB,CAmDnB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKvD;AACD,oGAAoG;AACpG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAsB3F;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAQhE"}

package/dist/visio/ui/edit-commands.d.ts

@@ -0,0 +1,4 @@
+import type { VisioEdit } from '../index.js';
+/** Bound cloning and strip arbitrary host properties. Semantic validation belongs to core. */
+export declare function snapshotEdits(edits: readonly VisioEdit[]): VisioEdit[];
+//# sourceMappingURL=edit-commands.d.ts.map

package/dist/visio/ui/edit-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-commands.d.ts","sourceRoot":"","sources":["../../../src/visio/ui/edit-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,CAqDtE"}