ooxml-core 0.2.0

package/dist/opc/content-types.d.ts

@@ -0,0 +1,14 @@
+export interface ContentTypes {
+    /** Extension (lower case, no dot) to content type. */
+    defaults: Map<string, string>;
+    /** Part name (leading slash) to content type. */
+    overrides: Map<string, string>;
+}
+/** Parses `[Content_Types].xml`; an absent part gives empty maps. */
+export declare function parseContentTypes(xml: string | undefined): ContentTypes;
+/** The content type of a part: its override if declared, else the default for its extension. */
+export declare function contentTypeForPart(types: ContentTypes, partName: string): string | undefined;
+export declare function buildContentTypesXml(types: ContentTypes): string;
+/** Adds a `Default` extension mapping when absent, returning the (possibly unchanged) XML. */
+export declare function ensureContentTypeDefault(xml: string | undefined, extension: string, contentType: string): string;
+//# sourceMappingURL=content-types.d.ts.map

package/dist/opc/content-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-types.d.ts","sourceRoot":"","sources":["../../src/opc/content-types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC5B,sDAAsD;IACtD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iDAAiD;IACjD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAKD,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAgBvE;AAED,gGAAgG;AAChG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM5F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAchE;AAED,8FAA8F;AAC9F,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GACjB,MAAM,CAKR"}

package/dist/opc/index.cjs

@@ -0,0 +1,228 @@
+'use strict';
+
+var xmldom = require('@xmldom/xmldom');
+
+// src/opc/relationship-types.ts
+var BASE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+var RELATIONSHIP_TYPES = {
+  officeDocument: `${BASE}/officeDocument`,
+  styles: `${BASE}/styles`,
+  numbering: `${BASE}/numbering`,
+  settings: `${BASE}/settings`,
+  theme: `${BASE}/theme`,
+  fontTable: `${BASE}/fontTable`,
+  webSettings: `${BASE}/webSettings`,
+  header: `${BASE}/header`,
+  footer: `${BASE}/footer`,
+  footnotes: `${BASE}/footnotes`,
+  endnotes: `${BASE}/endnotes`,
+  comments: `${BASE}/comments`,
+  image: `${BASE}/image`,
+  hyperlink: `${BASE}/hyperlink`,
+  oleObject: `${BASE}/oleObject`,
+  chart: `${BASE}/chart`,
+  package: `${BASE}/package`,
+  slide: `${BASE}/slide`,
+  slideLayout: `${BASE}/slideLayout`,
+  slideMaster: `${BASE}/slideMaster`,
+  notesSlide: `${BASE}/notesSlide`,
+  diagramData: `${BASE}/diagramData`,
+  diagramLayout: `${BASE}/diagramLayout`,
+  diagramQuickStyle: `${BASE}/diagramQuickStyle`,
+  diagramColors: `${BASE}/diagramColors`,
+  diagramDrawing: "http://schemas.microsoft.com/office/2007/relationships/diagramDrawing",
+  coreProperties: "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties",
+  extendedProperties: `${BASE}/extended-properties`,
+  customXml: `${BASE}/customXml`
+};
+
+// src/xml/namespaces.ts
+var NS = {
+  /** Relationships (`r:id`, `r:embed`). */
+  r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
+  /** OPC relationships part. */
+  rels: "http://schemas.openxmlformats.org/package/2006/relationships",
+  /** OPC content types part. */
+  contentTypes: "http://schemas.openxmlformats.org/package/2006/content-types"};
+function parseXml(xml, options = {}) {
+  const label = options.label ?? "OOXML";
+  if (/<!DOCTYPE|<!ENTITY/i.test(xml))
+    throw new Error(`${label} XML with DTD or entity declarations is not supported`);
+  let parseError = "";
+  let parsed;
+  try {
+    parsed = new xmldom.DOMParser({
+      onError: (level, message) => {
+        if (level !== "warning") parseError = message;
+      }
+    }).parseFromString(xml, "application/xml");
+  } catch (error) {
+    throw new Error(
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (parseError || !parsed.documentElement)
+    throw new Error(`Invalid ${label} XML: ${parseError || "missing root element"}`);
+  return parsed;
+}
+var isElement = (node) => node.nodeType === 1;
+var elements = (parent) => Array.from(parent.childNodes).filter(isElement);
+function attr(element, local, ns, prefix) {
+  return element?.getAttributeNS(ns, local) ?? element?.getAttribute(`${prefix}:${local}`) ?? void 0;
+}
+var relAttr = (element, local) => attr(element, local, NS.r, "r");
+
+// src/opc/relationships.ts
+function parseRelationships(xml) {
+  const map = /* @__PURE__ */ new Map();
+  if (!xml) return map;
+  const root = parseXml(xml).documentElement;
+  for (const node of elements(root)) {
+    if (node.localName !== "Relationship") continue;
+    const id = node.getAttribute("Id");
+    const target = node.getAttribute("Target");
+    if (!id || target == null) continue;
+    map.set(id, {
+      id,
+      type: node.getAttribute("Type") ?? "",
+      target,
+      mode: node.getAttribute("TargetMode") === "External" ? "External" : "Internal"
+    });
+  }
+  return map;
+}
+var escapeAttr = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+function buildRelationshipsXml(relationships) {
+  const items = Array.from(relationships).map(([id, rel]) => {
+    const mode = rel.mode === "External" ? ' TargetMode="External"' : "";
+    return `<Relationship Id="${escapeAttr(id)}" Type="${escapeAttr(rel.type)}" Target="${escapeAttr(rel.target)}"${mode}/>`;
+  }).join("");
+  return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="${NS.rels}">${items}</Relationships>`;
+}
+function resolvePartPath(basePart, target) {
+  if (target.startsWith("/")) return target.slice(1);
+  const baseDir = basePart.slice(0, basePart.lastIndexOf("/") + 1);
+  const resolved = [];
+  for (const segment of `${baseDir}${target}`.split("/")) {
+    if (segment === "." || segment === "") continue;
+    if (segment === "..") resolved.pop();
+    else resolved.push(segment);
+  }
+  return resolved.join("/");
+}
+function relationshipsPartFor(partName) {
+  const slash = partName.lastIndexOf("/");
+  return `${partName.slice(0, slash + 1)}_rels/${partName.slice(slash + 1)}.rels`;
+}
+function nextRelationshipId(used) {
+  let index = 1;
+  while (used.has(`rId${index}`)) index++;
+  return `rId${index}`;
+}
+var getRelationshipId = (element) => relAttr(element, "id") || void 0;
+
+// src/opc/content-types.ts
+var escapeAttr2 = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+function parseContentTypes(xml) {
+  const defaults = /* @__PURE__ */ new Map();
+  const overrides = /* @__PURE__ */ new Map();
+  if (!xml) return { defaults, overrides };
+  for (const node of elements(parseXml(xml).documentElement)) {
+    const contentType = node.getAttribute("ContentType");
+    if (!contentType) continue;
+    if (node.localName === "Default") {
+      const extension = node.getAttribute("Extension");
+      if (extension) defaults.set(extension.toLowerCase(), contentType);
+    } else if (node.localName === "Override") {
+      const partName = node.getAttribute("PartName");
+      if (partName) overrides.set(partName, contentType);
+    }
+  }
+  return { defaults, overrides };
+}
+function contentTypeForPart(types, partName) {
+  const overridePath = partName.startsWith("/") ? partName : `/${partName}`;
+  const override = types.overrides.get(overridePath);
+  if (override) return override;
+  const extension = partName.split(".").pop()?.toLowerCase();
+  return extension ? types.defaults.get(extension) : void 0;
+}
+function buildContentTypesXml(types) {
+  const defaults = Array.from(types.defaults).map(
+    ([extension, type]) => `<Default Extension="${extension}" ContentType="${escapeAttr2(type)}"/>`
+  ).join("");
+  const overrides = Array.from(types.overrides).map(
+    ([part, type]) => `<Override PartName="${escapeAttr2(part)}" ContentType="${escapeAttr2(type)}"/>`
+  ).join("");
+  return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Types xmlns="${NS.contentTypes}">${defaults}${overrides}</Types>`;
+}
+function ensureContentTypeDefault(xml, extension, contentType) {
+  const types = parseContentTypes(xml);
+  if (types.defaults.has(extension.toLowerCase())) return xml ?? buildContentTypesXml(types);
+  types.defaults.set(extension.toLowerCase(), contentType);
+  return buildContentTypesXml(types);
+}
+
+// src/opc/package.ts
+var CONTENT_TYPES_PATH = "[Content_Types].xml";
+var XML_DECLARATION = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>';
+var EMPTY_TYPES = `${XML_DECLARATION}<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"></Types>`;
+var EMPTY_RELS = `${XML_DECLARATION}<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>`;
+function attr2(tag, name) {
+  return new RegExp(`${name}="([^"]*)"`).exec(tag)?.[1];
+}
+async function ensureContentTypeOverride(zip, partName, contentType) {
+  const xml = await zip.file(CONTENT_TYPES_PATH)?.async("string") ?? EMPTY_TYPES;
+  const target = `/${partName}`;
+  for (const tag of xml.match(/<Override\b[^>]*\/>/g) ?? [])
+    if (attr2(tag, "PartName") === target) return;
+  const insertion = `<Override PartName="${target}" ContentType="${contentType}"/>`;
+  zip.file(CONTENT_TYPES_PATH, xml.replace("</Types>", `${insertion}</Types>`));
+}
+async function ensureRelationship(zip, relsPath, type, target) {
+  const xml = await zip.file(relsPath)?.async("string") ?? EMPTY_RELS;
+  const used = /* @__PURE__ */ new Set();
+  for (const tag of xml.match(/<Relationship\b[^>]*\/>/g) ?? []) {
+    const id2 = attr2(tag, "Id");
+    if (id2) used.add(id2);
+    if (id2 && attr2(tag, "Type") === type && attr2(tag, "Target") === target) return id2;
+  }
+  const highest = Math.max(
+    0,
+    ...[...used].map((id2) => Number(id2.replace(/^rId/, ""))).filter(Number.isFinite)
+  );
+  let id = `rId${highest + 1}`;
+  if (used.has(id)) id = nextRelationshipId(used);
+  const insertion = `<Relationship Id="${id}" Type="${type}" Target="${target}"/>`;
+  zip.file(relsPath, xml.replace("</Relationships>", `${insertion}</Relationships>`));
+  return id;
+}
+async function findOfficeDocumentPart(zip) {
+  const xml = await zip.file("_rels/.rels")?.async("string");
+  for (const tag of xml?.match(/<Relationship\b[^>]*\/>/g) ?? [])
+    if (attr2(tag, "Type") === RELATIONSHIP_TYPES.officeDocument) return attr2(tag, "Target");
+  return void 0;
+}
+
+// src/opc/safe-href.ts
+var SAFE_SCHEMES = /* @__PURE__ */ new Set(["http:", "https:", "mailto:"]);
+function isSafeHyperlinkHref(href) {
+  const scheme = /^([a-z][a-z0-9+.-]*:)/i.exec(href.trim())?.[1];
+  return scheme !== void 0 && SAFE_SCHEMES.has(scheme.toLowerCase());
+}
+
+exports.RELATIONSHIP_TYPES = RELATIONSHIP_TYPES;
+exports.buildContentTypesXml = buildContentTypesXml;
+exports.buildRelationshipsXml = buildRelationshipsXml;
+exports.contentTypeForPart = contentTypeForPart;
+exports.ensureContentTypeDefault = ensureContentTypeDefault;
+exports.ensureContentTypeOverride = ensureContentTypeOverride;
+exports.ensureRelationship = ensureRelationship;
+exports.findOfficeDocumentPart = findOfficeDocumentPart;
+exports.getRelationshipId = getRelationshipId;
+exports.isSafeHyperlinkHref = isSafeHyperlinkHref;
+exports.nextRelationshipId = nextRelationshipId;
+exports.parseContentTypes = parseContentTypes;
+exports.parseRelationships = parseRelationships;
+exports.relationshipsPartFor = relationshipsPartFor;
+exports.resolvePartPath = resolvePartPath;

package/dist/opc/index.d.ts

@@ -0,0 +1,6 @@
+export * from './relationship-types.js';
+export * from './relationships.js';
+export * from './content-types.js';
+export * from './package.js';
+export * from './safe-href.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/opc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/opc/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/opc/index.mjs

@@ -0,0 +1,212 @@
+import { DOMParser } from '@xmldom/xmldom';
+
+// src/opc/relationship-types.ts
+var BASE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+var RELATIONSHIP_TYPES = {
+  officeDocument: `${BASE}/officeDocument`,
+  styles: `${BASE}/styles`,
+  numbering: `${BASE}/numbering`,
+  settings: `${BASE}/settings`,
+  theme: `${BASE}/theme`,
+  fontTable: `${BASE}/fontTable`,
+  webSettings: `${BASE}/webSettings`,
+  header: `${BASE}/header`,
+  footer: `${BASE}/footer`,
+  footnotes: `${BASE}/footnotes`,
+  endnotes: `${BASE}/endnotes`,
+  comments: `${BASE}/comments`,
+  image: `${BASE}/image`,
+  hyperlink: `${BASE}/hyperlink`,
+  oleObject: `${BASE}/oleObject`,
+  chart: `${BASE}/chart`,
+  package: `${BASE}/package`,
+  slide: `${BASE}/slide`,
+  slideLayout: `${BASE}/slideLayout`,
+  slideMaster: `${BASE}/slideMaster`,
+  notesSlide: `${BASE}/notesSlide`,
+  diagramData: `${BASE}/diagramData`,
+  diagramLayout: `${BASE}/diagramLayout`,
+  diagramQuickStyle: `${BASE}/diagramQuickStyle`,
+  diagramColors: `${BASE}/diagramColors`,
+  diagramDrawing: "http://schemas.microsoft.com/office/2007/relationships/diagramDrawing",
+  coreProperties: "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties",
+  extendedProperties: `${BASE}/extended-properties`,
+  customXml: `${BASE}/customXml`
+};
+
+// src/xml/namespaces.ts
+var NS = {
+  /** Relationships (`r:id`, `r:embed`). */
+  r: "http://schemas.openxmlformats.org/officeDocument/2006/relationships",
+  /** OPC relationships part. */
+  rels: "http://schemas.openxmlformats.org/package/2006/relationships",
+  /** OPC content types part. */
+  contentTypes: "http://schemas.openxmlformats.org/package/2006/content-types"};
+function parseXml(xml, options = {}) {
+  const label = options.label ?? "OOXML";
+  if (/<!DOCTYPE|<!ENTITY/i.test(xml))
+    throw new Error(`${label} XML with DTD or entity declarations is not supported`);
+  let parseError = "";
+  let parsed;
+  try {
+    parsed = new DOMParser({
+      onError: (level, message) => {
+        if (level !== "warning") parseError = message;
+      }
+    }).parseFromString(xml, "application/xml");
+  } catch (error) {
+    throw new Error(
+      `Invalid ${label} XML: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (parseError || !parsed.documentElement)
+    throw new Error(`Invalid ${label} XML: ${parseError || "missing root element"}`);
+  return parsed;
+}
+var isElement = (node) => node.nodeType === 1;
+var elements = (parent) => Array.from(parent.childNodes).filter(isElement);
+function attr(element, local, ns, prefix) {
+  return element?.getAttributeNS(ns, local) ?? element?.getAttribute(`${prefix}:${local}`) ?? void 0;
+}
+var relAttr = (element, local) => attr(element, local, NS.r, "r");
+
+// src/opc/relationships.ts
+function parseRelationships(xml) {
+  const map = /* @__PURE__ */ new Map();
+  if (!xml) return map;
+  const root = parseXml(xml).documentElement;
+  for (const node of elements(root)) {
+    if (node.localName !== "Relationship") continue;
+    const id = node.getAttribute("Id");
+    const target = node.getAttribute("Target");
+    if (!id || target == null) continue;
+    map.set(id, {
+      id,
+      type: node.getAttribute("Type") ?? "",
+      target,
+      mode: node.getAttribute("TargetMode") === "External" ? "External" : "Internal"
+    });
+  }
+  return map;
+}
+var escapeAttr = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+function buildRelationshipsXml(relationships) {
+  const items = Array.from(relationships).map(([id, rel]) => {
+    const mode = rel.mode === "External" ? ' TargetMode="External"' : "";
+    return `<Relationship Id="${escapeAttr(id)}" Type="${escapeAttr(rel.type)}" Target="${escapeAttr(rel.target)}"${mode}/>`;
+  }).join("");
+  return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="${NS.rels}">${items}</Relationships>`;
+}
+function resolvePartPath(basePart, target) {
+  if (target.startsWith("/")) return target.slice(1);
+  const baseDir = basePart.slice(0, basePart.lastIndexOf("/") + 1);
+  const resolved = [];
+  for (const segment of `${baseDir}${target}`.split("/")) {
+    if (segment === "." || segment === "") continue;
+    if (segment === "..") resolved.pop();
+    else resolved.push(segment);
+  }
+  return resolved.join("/");
+}
+function relationshipsPartFor(partName) {
+  const slash = partName.lastIndexOf("/");
+  return `${partName.slice(0, slash + 1)}_rels/${partName.slice(slash + 1)}.rels`;
+}
+function nextRelationshipId(used) {
+  let index = 1;
+  while (used.has(`rId${index}`)) index++;
+  return `rId${index}`;
+}
+var getRelationshipId = (element) => relAttr(element, "id") || void 0;
+
+// src/opc/content-types.ts
+var escapeAttr2 = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+function parseContentTypes(xml) {
+  const defaults = /* @__PURE__ */ new Map();
+  const overrides = /* @__PURE__ */ new Map();
+  if (!xml) return { defaults, overrides };
+  for (const node of elements(parseXml(xml).documentElement)) {
+    const contentType = node.getAttribute("ContentType");
+    if (!contentType) continue;
+    if (node.localName === "Default") {
+      const extension = node.getAttribute("Extension");
+      if (extension) defaults.set(extension.toLowerCase(), contentType);
+    } else if (node.localName === "Override") {
+      const partName = node.getAttribute("PartName");
+      if (partName) overrides.set(partName, contentType);
+    }
+  }
+  return { defaults, overrides };
+}
+function contentTypeForPart(types, partName) {
+  const overridePath = partName.startsWith("/") ? partName : `/${partName}`;
+  const override = types.overrides.get(overridePath);
+  if (override) return override;
+  const extension = partName.split(".").pop()?.toLowerCase();
+  return extension ? types.defaults.get(extension) : void 0;
+}
+function buildContentTypesXml(types) {
+  const defaults = Array.from(types.defaults).map(
+    ([extension, type]) => `<Default Extension="${extension}" ContentType="${escapeAttr2(type)}"/>`
+  ).join("");
+  const overrides = Array.from(types.overrides).map(
+    ([part, type]) => `<Override PartName="${escapeAttr2(part)}" ContentType="${escapeAttr2(type)}"/>`
+  ).join("");
+  return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Types xmlns="${NS.contentTypes}">${defaults}${overrides}</Types>`;
+}
+function ensureContentTypeDefault(xml, extension, contentType) {
+  const types = parseContentTypes(xml);
+  if (types.defaults.has(extension.toLowerCase())) return xml ?? buildContentTypesXml(types);
+  types.defaults.set(extension.toLowerCase(), contentType);
+  return buildContentTypesXml(types);
+}
+
+// src/opc/package.ts
+var CONTENT_TYPES_PATH = "[Content_Types].xml";
+var XML_DECLARATION = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>';
+var EMPTY_TYPES = `${XML_DECLARATION}<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"></Types>`;
+var EMPTY_RELS = `${XML_DECLARATION}<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"></Relationships>`;
+function attr2(tag, name) {
+  return new RegExp(`${name}="([^"]*)"`).exec(tag)?.[1];
+}
+async function ensureContentTypeOverride(zip, partName, contentType) {
+  const xml = await zip.file(CONTENT_TYPES_PATH)?.async("string") ?? EMPTY_TYPES;
+  const target = `/${partName}`;
+  for (const tag of xml.match(/<Override\b[^>]*\/>/g) ?? [])
+    if (attr2(tag, "PartName") === target) return;
+  const insertion = `<Override PartName="${target}" ContentType="${contentType}"/>`;
+  zip.file(CONTENT_TYPES_PATH, xml.replace("</Types>", `${insertion}</Types>`));
+}
+async function ensureRelationship(zip, relsPath, type, target) {
+  const xml = await zip.file(relsPath)?.async("string") ?? EMPTY_RELS;
+  const used = /* @__PURE__ */ new Set();
+  for (const tag of xml.match(/<Relationship\b[^>]*\/>/g) ?? []) {
+    const id2 = attr2(tag, "Id");
+    if (id2) used.add(id2);
+    if (id2 && attr2(tag, "Type") === type && attr2(tag, "Target") === target) return id2;
+  }
+  const highest = Math.max(
+    0,
+    ...[...used].map((id2) => Number(id2.replace(/^rId/, ""))).filter(Number.isFinite)
+  );
+  let id = `rId${highest + 1}`;
+  if (used.has(id)) id = nextRelationshipId(used);
+  const insertion = `<Relationship Id="${id}" Type="${type}" Target="${target}"/>`;
+  zip.file(relsPath, xml.replace("</Relationships>", `${insertion}</Relationships>`));
+  return id;
+}
+async function findOfficeDocumentPart(zip) {
+  const xml = await zip.file("_rels/.rels")?.async("string");
+  for (const tag of xml?.match(/<Relationship\b[^>]*\/>/g) ?? [])
+    if (attr2(tag, "Type") === RELATIONSHIP_TYPES.officeDocument) return attr2(tag, "Target");
+  return void 0;
+}
+
+// src/opc/safe-href.ts
+var SAFE_SCHEMES = /* @__PURE__ */ new Set(["http:", "https:", "mailto:"]);
+function isSafeHyperlinkHref(href) {
+  const scheme = /^([a-z][a-z0-9+.-]*:)/i.exec(href.trim())?.[1];
+  return scheme !== void 0 && SAFE_SCHEMES.has(scheme.toLowerCase());
+}
+
+export { RELATIONSHIP_TYPES, buildContentTypesXml, buildRelationshipsXml, contentTypeForPart, ensureContentTypeDefault, ensureContentTypeOverride, ensureRelationship, findOfficeDocumentPart, getRelationshipId, isSafeHyperlinkHref, nextRelationshipId, parseContentTypes, parseRelationships, relationshipsPartFor, resolvePartPath };

package/dist/opc/package.d.ts

@@ -0,0 +1,14 @@
+import type JSZip from 'jszip';
+/**
+ * Adds an `<Override>` for `partName` to `[Content_Types].xml` unless one exists. Plain string
+ * surgery, so the rest of the part stays byte-identical.
+ */
+export declare function ensureContentTypeOverride(zip: JSZip, partName: string, contentType: string): Promise<void>;
+/**
+ * Returns the id of the relationship of `type` to `target` in the `.rels` part at `relsPath`,
+ * creating the relationship (and the part) when it does not exist. Existing XML is left intact.
+ */
+export declare function ensureRelationship(zip: JSZip, relsPath: string, type: string, target: string): Promise<string>;
+/** The package-level relationship to the main document part (`_rels/.rels`), if present. */
+export declare function findOfficeDocumentPart(zip: JSZip): Promise<string | undefined>;
+//# sourceMappingURL=package.d.ts.map

package/dist/opc/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/opc/package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B;;;GAGG;AACH,wBAAsB,yBAAyB,CAC9C,GAAG,EAAE,KAAK,EACV,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,KAAK,EACV,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,4FAA4F;AAC5F,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAKpF"}

package/dist/opc/relationship-types.d.ts

@@ -0,0 +1,34 @@
+/** Relationship type URIs for the parts the Office viewers read and write. */
+export declare const RELATIONSHIP_TYPES: {
+    readonly officeDocument: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument";
+    readonly styles: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles";
+    readonly numbering: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering";
+    readonly settings: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings";
+    readonly theme: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme";
+    readonly fontTable: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable";
+    readonly webSettings: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings";
+    readonly header: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header";
+    readonly footer: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer";
+    readonly footnotes: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes";
+    readonly endnotes: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes";
+    readonly comments: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
+    readonly image: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
+    readonly hyperlink: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
+    readonly oleObject: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/oleObject";
+    readonly chart: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart";
+    readonly package: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/package";
+    readonly slide: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide";
+    readonly slideLayout: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout";
+    readonly slideMaster: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideMaster";
+    readonly notesSlide: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide";
+    readonly diagramData: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramData";
+    readonly diagramLayout: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramLayout";
+    readonly diagramQuickStyle: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramQuickStyle";
+    readonly diagramColors: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramColors";
+    readonly diagramDrawing: "http://schemas.microsoft.com/office/2007/relationships/diagramDrawing";
+    readonly coreProperties: "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties";
+    readonly extendedProperties: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties";
+    readonly customXml: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml";
+};
+export type RelationshipTypeKey = keyof typeof RELATIONSHIP_TYPES;
+//# sourceMappingURL=relationship-types.d.ts.map

package/dist/opc/relationship-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-types.d.ts","sourceRoot":"","sources":["../../src/opc/relationship-types.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BrB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,kBAAkB,CAAC"}

package/dist/opc/relationships.d.ts

@@ -0,0 +1,29 @@
+import { type XmlElement } from '../xml/index.js';
+export interface Relationship {
+    id: string;
+    type: string;
+    target: string;
+    /** `External` for `TargetMode="External"` (hyperlinks, linked media), else `Internal`. */
+    mode: 'Internal' | 'External';
+}
+/** Parses a `.rels` part into a map keyed by relationship id; an absent part gives an empty map. */
+export declare function parseRelationships(xml: string | undefined): Map<string, Relationship>;
+/** A relationship to serialize; its id is the key of the map it is stored in. */
+export type RelationshipInput = Omit<Relationship, 'id'> & {
+    id?: string;
+};
+/** Serializes relationships into a `.rels` part, using each map key as the relationship id. */
+export declare function buildRelationshipsXml(relationships: ReadonlyMap<string, RelationshipInput>): string;
+/**
+ * Resolves a relationship `Target` against the part that declared it. Absolute targets (leading
+ * `/`) are package-rooted; relative ones resolve against the declaring part's folder, handling
+ * `.` and `..` segments. Returns a package part name without a leading slash.
+ */
+export declare function resolvePartPath(basePart: string, target: string): string;
+/** The `.rels` part name that holds the relationships of `partName` (`word/document.xml` -> `word/_rels/document.xml.rels`). */
+export declare function relationshipsPartFor(partName: string): string;
+/** The first `rIdN` that is not in `used`; the caller records the result. */
+export declare function nextRelationshipId(used: ReadonlySet<string>): string;
+/** The `r:id` relationship reference on an element such as `w:headerReference`. */
+export declare const getRelationshipId: (element: XmlElement) => string | undefined;
+//# sourceMappingURL=relationships.d.ts.map

package/dist/opc/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/opc/relationships.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnF,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;CAC9B;AAED,oGAAoG;AACpG,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAiBrF;AAKD,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,+FAA+F;AAC/F,wBAAgB,qBAAqB,CACpC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACnD,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUxE;AAED,gIAAgI;AAChI,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAIpE;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,GAAI,SAAS,UAAU,KAAG,MAAM,GAAG,SAC7B,CAAC"}

package/dist/opc/safe-href.d.ts

@@ -0,0 +1,3 @@
+/** Only http(s) and mailto targets are accepted; anything else (notably `javascript:`) is rejected. */
+export declare function isSafeHyperlinkHref(href: string): boolean;
+//# sourceMappingURL=safe-href.d.ts.map

package/dist/opc/safe-href.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-href.d.ts","sourceRoot":"","sources":["../../src/opc/safe-href.ts"],"names":[],"mappings":"AAEA,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzD"}