@syncfusion/ej2-office-common 35.1.37

package/src/features/smart-art/diagram-xml.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Feature-local XML tree for DrawingML diagram parts.
+ *
+ * @remarks
+ * Encryption's EncryptionInfo parser drops text nodes and is unsuitable for
+ * `dgm:pt/dgm:t` text bodies. This helper keeps element children **and** text,
+ * rejects DTD/entity expansion, and applies nesting/attribute/text limits.
+ * Namespace URI is authoritative; prefixes are preserved for stable serialize.
+ *
+ * @private
+ */
+/** Attribute on a diagram XML element. */
+export interface DiagramXmlAttribute {
+    readonly prefix: string;
+    readonly localName: string;
+    readonly namespaceUri: string;
+    readonly value: string;
+    /** Original `name` or `prefix:name` as written in source. */
+    readonly qName: string;
+}
+/** Element node. */
+export interface DiagramXmlElement {
+    readonly kind: 'element';
+    readonly prefix: string;
+    readonly localName: string;
+    readonly namespaceUri: string;
+    readonly qName: string;
+    readonly attributes: ReadonlyArray<DiagramXmlAttribute>;
+    readonly children: ReadonlyArray<DiagramXmlNode>;
+}
+/** Text node (significant or whitespace). */
+export interface DiagramXmlText {
+    readonly kind: 'text';
+    readonly value: string;
+}
+export declare type DiagramXmlNode = DiagramXmlElement | DiagramXmlText;
+export interface DiagramXmlParseLimits {
+    readonly maxDepth?: number;
+    readonly maxAttributesPerElement?: number;
+    readonly maxTextNodeLength?: number;
+}
+/**
+ * Parses a single-root diagram part XML document.
+ *
+ * @throws {DiagramPartError} Malformed XML or missing root.
+ */
+export declare function parseDiagramXml(xmlText: string, limits?: DiagramXmlParseLimits): DiagramXmlElement;
+/**
+ * Serializes a diagram XML element tree to a UTF-8 XML document string.
+ */
+export declare function serializeDiagramXml(root: DiagramXmlElement, withDecl?: boolean): string;
+/** Returns unprefixed or namespace-aware attribute value. */
+export declare function getAttribute(el: DiagramXmlElement, localName: string, namespaceUri?: string): string | undefined;
+/** Element children only (skips text). */
+export declare function elementChildren(el: DiagramXmlElement): ReadonlyArray<DiagramXmlElement>;
+/** First child element with local name + namespace. */
+export declare function findChild(el: DiagramXmlElement, localName: string, namespaceUri: string): DiagramXmlElement | undefined;
+/** All child elements with local name + namespace. */
+export declare function findChildren(el: DiagramXmlElement, localName: string, namespaceUri: string): ReadonlyArray<DiagramXmlElement>;
+/**
+ * Deep-clones an element tree (for immutable public part wrappers).
+ */
+export declare function cloneElement(el: DiagramXmlElement): DiagramXmlElement;

package/src/features/smart-art/diagram-xml.js

@@ -0,0 +1,459 @@
+/**
+ * Feature-local XML tree for DrawingML diagram parts.
+ *
+ * @remarks
+ * Encryption's EncryptionInfo parser drops text nodes and is unsuitable for
+ * `dgm:pt/dgm:t` text bodies. This helper keeps element children **and** text,
+ * rejects DTD/entity expansion, and applies nesting/attribute/text limits.
+ * Namespace URI is authoritative; prefixes are preserved for stable serialize.
+ *
+ * @private
+ */
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spread = (this && this.__spread) || function () {
+    for (var ar = [], i = 0; i < arguments.length; i++) ar = ar.concat(__read(arguments[i]));
+    return ar;
+};
+var __values = (this && this.__values) || function (o) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator], i = 0;
+    if (m) return m.call(o);
+    return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+};
+import { DiagramPartError } from './errors';
+var DEFAULT_MAX_DEPTH = 256;
+var DEFAULT_MAX_ATTRS = 4096;
+var DEFAULT_MAX_TEXT = 32 * 1024 * 1024;
+var XMLNS_NS = 'http://www.w3.org/2000/xmlns/';
+var XML_NS = 'http://www.w3.org/XML/1998/namespace';
+/**
+ * Parses a single-root diagram part XML document.
+ *
+ * @throws {DiagramPartError} Malformed XML or missing root.
+ */
+export function parseDiagramXml(xmlText, limits) {
+    if (limits === void 0) { limits = {}; }
+    if (/<!DOCTYPE/i.test(xmlText) || /<!ENTITY/i.test(xmlText)) {
+        throw new DiagramPartError('Diagram XML must not contain DTD or entities');
+    }
+    var maxDepth = (limits.maxDepth != null ? limits.maxDepth : DEFAULT_MAX_DEPTH);
+    var maxAttrs = (limits.maxAttributesPerElement != null ? limits.maxAttributesPerElement : DEFAULT_MAX_ATTRS);
+    var maxText = (limits.maxTextNodeLength != null ? limits.maxTextNodeLength : DEFAULT_MAX_TEXT);
+    var i = 0;
+    var length = xmlText.length;
+    var skipWs = function () {
+        while (i < length) {
+            var c = xmlText.charCodeAt(i);
+            if (c === 0x20 || c === 0x09 || c === 0x0a || c === 0x0d) {
+                i += 1;
+            }
+            else {
+                break;
+            }
+        }
+    };
+    var peek = function () { return (i < length ? xmlText.charAt(i) : ''); };
+    var startsWith = function (s) { return xmlText.startsWith(s, i); };
+    var readName = function () {
+        var start = i;
+        while (i < length) {
+            var c = xmlText.charAt(i);
+            if (/[A-Za-z0-9:_.-]/.test(c)) {
+                i += 1;
+            }
+            else {
+                break;
+            }
+        }
+        if (i === start) {
+            throw new DiagramPartError('Diagram XML is invalid: expected name');
+        }
+        return xmlText.slice(start, i);
+    };
+    var decodeEntities = function (raw) {
+        return raw
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&apos;/g, "'")
+            .replace(/&amp;/g, '&');
+    };
+    var readAttrValue = function () {
+        var quote = peek();
+        if (quote !== '"' && quote !== "'") {
+            throw new DiagramPartError('Diagram XML is invalid: attribute value');
+        }
+        i += 1;
+        var start = i;
+        while (i < length && xmlText[i] !== quote) {
+            i += 1;
+            if (i - start > maxText) {
+                throw new DiagramPartError('Diagram XML text/attribute exceeds limit');
+            }
+        }
+        if (i >= length) {
+            throw new DiagramPartError('Diagram XML is invalid: unclosed attribute');
+        }
+        var value = xmlText.slice(start, i);
+        i += 1;
+        return decodeEntities(value);
+    };
+    var resolveQName = function (qName, nsStack, isAttr) {
+        var colon = qName.indexOf(':');
+        var prefix = colon === -1 ? '' : qName.slice(0, colon);
+        var localName = colon === -1 ? qName : qName.slice(colon + 1);
+        if (prefix === 'xmlns') {
+            return { prefix: prefix, localName: localName, namespaceUri: XMLNS_NS };
+        }
+        if (isAttr && prefix === '') {
+            if (localName === 'xmlns') {
+                return { prefix: '', localName: 'xmlns', namespaceUri: XMLNS_NS };
+            }
+            return { prefix: '', localName: localName, namespaceUri: '' };
+        }
+        if (prefix === 'xml') {
+            return { prefix: prefix, localName: localName, namespaceUri: XML_NS };
+        }
+        for (var s = nsStack.length - 1; s >= 0; s--) {
+            var frameAt = nsStack[s];
+            if (frameAt === undefined) {
+                continue;
+            }
+            var uri = frameAt.get(prefix);
+            if (uri !== undefined) {
+                return { prefix: prefix, localName: localName, namespaceUri: uri };
+            }
+        }
+        return { prefix: prefix, localName: localName, namespaceUri: '' };
+    };
+    var parseElement = function (nsStack, depth) {
+        if (depth > maxDepth) {
+            throw new DiagramPartError('Diagram XML nesting depth exceeds limit');
+        }
+        if (peek() !== '<') {
+            throw new DiagramPartError('Diagram XML is invalid: expected element');
+        }
+        i += 1;
+        if (peek() === '/') {
+            throw new DiagramPartError('Diagram XML is invalid: unexpected end tag');
+        }
+        var rawName = readName();
+        var frame = new Map();
+        var pendingAttrs = [];
+        skipWs();
+        while (peek() !== '>' && peek() !== '/' && i < length) {
+            var attrQName = readName();
+            skipWs();
+            if (peek() !== '=') {
+                throw new DiagramPartError('Diagram XML is invalid: expected = after attribute name');
+            }
+            i += 1;
+            skipWs();
+            var value = readAttrValue();
+            pendingAttrs.push({ qName: attrQName, value: value });
+            if (attrQName === 'xmlns') {
+                frame.set('', value);
+            }
+            else if (attrQName.startsWith('xmlns:')) {
+                frame.set(attrQName.slice(6), value);
+            }
+            skipWs();
+            if (pendingAttrs.length > maxAttrs) {
+                throw new DiagramPartError('Diagram XML attribute count exceeds limit');
+            }
+        }
+        var childStack = __spread(nsStack, [frame]);
+        var nameResolved = resolveQName(rawName, childStack, false);
+        var attributes = pendingAttrs.map(function (a) {
+            var r = resolveQName(a.qName, childStack, true);
+            return {
+                prefix: r.prefix,
+                localName: r.localName,
+                namespaceUri: r.namespaceUri,
+                value: a.value,
+                qName: a.qName,
+            };
+        });
+        var selfClosing = false;
+        if (startsWith('/>')) {
+            i += 2;
+            selfClosing = true;
+        }
+        else if (peek() === '>') {
+            i += 1;
+        }
+        else {
+            throw new DiagramPartError('Diagram XML is invalid: malformed start tag');
+        }
+        var children = [];
+        if (!selfClosing) {
+            for (;;) {
+                if (i >= length) {
+                    throw new DiagramPartError('Diagram XML is invalid: unclosed element');
+                }
+                if (startsWith('</')) {
+                    i += 2;
+                    var endName = readName();
+                    skipWs();
+                    if (peek() !== '>') {
+                        throw new DiagramPartError('Diagram XML is invalid: malformed end tag');
+                    }
+                    i += 1;
+                    if (endName !== rawName) {
+                        throw new DiagramPartError("Diagram XML is invalid: end tag " + endName + " does not match " + rawName);
+                    }
+                    break;
+                }
+                if (startsWith('<!--')) {
+                    var end = xmlText.indexOf('-->', i + 4);
+                    if (end < 0) {
+                        throw new DiagramPartError('Diagram XML is invalid: unclosed comment');
+                    }
+                    i = end + 3;
+                    continue;
+                }
+                if (startsWith('<?')) {
+                    var end = xmlText.indexOf('?>', i + 2);
+                    if (end < 0) {
+                        throw new DiagramPartError('Diagram XML is invalid: unclosed processing instruction');
+                    }
+                    i = end + 2;
+                    continue;
+                }
+                if (startsWith('<![CDATA[')) {
+                    var end = xmlText.indexOf(']]>', i + 9);
+                    if (end < 0) {
+                        throw new DiagramPartError('Diagram XML is invalid: unclosed CDATA');
+                    }
+                    var text = xmlText.slice(i + 9, end);
+                    if (text.length > maxText) {
+                        throw new DiagramPartError('Diagram XML text exceeds limit');
+                    }
+                    children.push({ kind: 'text', value: text });
+                    i = end + 3;
+                    continue;
+                }
+                if (peek() === '<') {
+                    children.push(parseElement(childStack, depth + 1));
+                    continue;
+                }
+                var textStart = i;
+                while (i < length && xmlText[i] !== '<') {
+                    i += 1;
+                    if (i - textStart > maxText) {
+                        throw new DiagramPartError('Diagram XML text exceeds limit');
+                    }
+                }
+                var rawText = xmlText.slice(textStart, i);
+                if (rawText.length > 0) {
+                    children.push({ kind: 'text', value: decodeEntities(rawText) });
+                }
+            }
+        }
+        return { kind: 'element',
+            prefix: nameResolved.prefix,
+            localName: nameResolved.localName,
+            namespaceUri: nameResolved.namespaceUri,
+            qName: rawName,
+            attributes: attributes,
+            children: children,
+        };
+    };
+    skipWs();
+    if (startsWith('\uFEFF')) {
+        i += 1;
+        skipWs();
+    }
+    while (startsWith('<?') || startsWith('<!--')) {
+        if (startsWith('<?')) {
+            var end = xmlText.indexOf('?>', i + 2);
+            if (end < 0) {
+                throw new DiagramPartError('Diagram XML is invalid: unclosed declaration');
+            }
+            i = end + 2;
+        }
+        else {
+            var end = xmlText.indexOf('-->', i + 4);
+            if (end < 0) {
+                throw new DiagramPartError('Diagram XML is invalid: unclosed comment');
+            }
+            i = end + 3;
+        }
+        skipWs();
+    }
+    var root = parseElement([new Map()], 1);
+    skipWs();
+    if (i < length) {
+        throw new DiagramPartError('Diagram XML is invalid: trailing content');
+    }
+    return root;
+}
+var escapeText = function (value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+};
+var escapeAttr = function (value) {
+    return escapeText(value).replace(/"/g, '&quot;');
+};
+/**
+ * Serializes a diagram XML element tree to a UTF-8 XML document string.
+ */
+export function serializeDiagramXml(root, withDecl) {
+    if (withDecl === void 0) { withDecl = true; }
+    var body = serializeNode(root);
+    return withDecl ? "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n" + body : body;
+}
+function serializeNode(node) {
+    var e_1, _a;
+    if (node.kind === 'text') {
+        return escapeText(node.value);
+    }
+    var attrParts = [];
+    try {
+        for (var _b = __values(node.attributes), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var a = _c.value;
+            attrParts.push(a.qName + "=\"" + escapeAttr(a.value) + "\"");
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    var attrStr = attrParts.length > 0 ? " " + attrParts.join(' ') : '';
+    if (node.children.length === 0) {
+        return "<" + node.qName + attrStr + "/>";
+    }
+    var inner = node.children.map(serializeNode).join('');
+    return "<" + node.qName + attrStr + ">" + inner + "</" + node.qName + ">";
+}
+/** Returns unprefixed or namespace-aware attribute value. */
+export function getAttribute(el, localName, namespaceUri) {
+    if (namespaceUri === void 0) { namespaceUri = ''; }
+    var e_2, _a;
+    try {
+        for (var _b = __values(el.attributes), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var a = _c.value;
+            if (a.localName === localName && a.namespaceUri === namespaceUri) {
+                return a.value;
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return undefined;
+}
+/** Element children only (skips text). */
+export function elementChildren(el) {
+    var e_3, _a;
+    var out = [];
+    try {
+        for (var _b = __values(el.children), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var c = _c.value;
+            if (c.kind === 'element') {
+                out.push(c);
+            }
+        }
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_3) throw e_3.error; }
+    }
+    return out;
+}
+/** First child element with local name + namespace. */
+export function findChild(el, localName, namespaceUri) {
+    var e_4, _a;
+    try {
+        for (var _b = __values(el.children), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var c = _c.value;
+            if (c.kind === 'element' && c.localName === localName && c.namespaceUri === namespaceUri) {
+                return c;
+            }
+        }
+    }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_4) throw e_4.error; }
+    }
+    return undefined;
+}
+/** All child elements with local name + namespace. */
+export function findChildren(el, localName, namespaceUri) {
+    var e_5, _a;
+    var out = [];
+    try {
+        for (var _b = __values(el.children), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var c = _c.value;
+            if (c.kind === 'element' && c.localName === localName && c.namespaceUri === namespaceUri) {
+                out.push(c);
+            }
+        }
+    }
+    catch (e_5_1) { e_5 = { error: e_5_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_5) throw e_5.error; }
+    }
+    return out;
+}
+/**
+ * Deep-clones an element tree (for immutable public part wrappers).
+ */
+export function cloneElement(el) {
+    return { kind: 'element',
+        prefix: el.prefix,
+        localName: el.localName,
+        namespaceUri: el.namespaceUri,
+        qName: el.qName,
+        attributes: el.attributes.map(function (a) { return (__assign({}, a)); }),
+        children: el.children.map(function (c) { return (c.kind === 'text' ? __assign({}, c) : cloneElement(c)); }),
+    };
+}

package/src/features/smart-art/errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Errors for DrawingML diagram (SmartArt) part parse and serialize.
+ *
+ * @remarks
+ * Explicit part APIs throw when required schema structure is absent (e.g. missing
+ * `ptLst` on `dataModel`). Package-level opaque preserve of unknown parts is a
+ * separate path and does not use these errors for unmodeled content.
+ *
+ * @public
+ */
+/**
+ * Thrown when diagram part XML cannot be parsed or fails a required schema check
+ * for an explicit SmartArt API call.
+ *
+ * @public
+ */
+export declare class DiagramPartError extends Error {
+    /**
+     * Creates a diagram part error.
+     *
+     * @param message - Human-readable description (no secrets).
+     */
+    constructor(message: string);
+}

package/src/features/smart-art/errors.js

@@ -0,0 +1,47 @@
+/**
+ * Errors for DrawingML diagram (SmartArt) part parse and serialize.
+ *
+ * @remarks
+ * Explicit part APIs throw when required schema structure is absent (e.g. missing
+ * `ptLst` on `dataModel`). Package-level opaque preserve of unknown parts is a
+ * separate path and does not use these errors for unmodeled content.
+ *
+ * @public
+ */
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+/**
+ * Thrown when diagram part XML cannot be parsed or fails a required schema check
+ * for an explicit SmartArt API call.
+ *
+ * @public
+ */
+var DiagramPartError = /** @class */ (function (_super) {
+    __extends(DiagramPartError, _super);
+    /**
+     * Creates a diagram part error.
+     *
+     * @param message - Human-readable description (no secrets).
+     */
+    function DiagramPartError(message) {
+        var _newTarget = this.constructor;
+        var _this = _super.call(this, message) || this;
+        _this.name = 'DiagramPartError';
+        // ES5 / AMD emit: restore prototype so `instanceof DiagramPartError` works in browsers.
+        Object.setPrototypeOf(_this, _newTarget.prototype);
+        return _this;
+    }
+    return DiagramPartError;
+}(Error));
+export { DiagramPartError };

package/src/features/smart-art/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Optional SmartArt / DrawingML diagram common layer.
+ *
+ * @remarks
+ * Host-neutral package constants, part parse/serialize, and content-type handlers
+ * shared by PowerPoint, Word, and Excel consumers. This module must not export
+ * slide, document-body, worksheet, or other host product types.
+ *
+ * Mapping: `docs/ooxml-mapping/smart-art.md`
+ * Requirement: `docs/requirements/smart-art-shared-common.md`
+ *
+ * @packageDocumentation
+ */
+export { DIAGRAM_COLORS_CONTENT_TYPE, DIAGRAM_COLORS_RELATIONSHIP_TYPE, DIAGRAM_CONTENT_TYPES, DIAGRAM_DATA_CONTENT_TYPE, DIAGRAM_DATA_RELATIONSHIP_TYPE, DIAGRAM_GRAPHIC_DATA_URI, DIAGRAM_LAYOUT_CONTENT_TYPE, DIAGRAM_LAYOUT_RELATIONSHIP_TYPE, DIAGRAM_NAMESPACE, DIAGRAM_QUICK_STYLE_RELATIONSHIP_TYPE, DIAGRAM_RELATIONSHIP_TYPES, DIAGRAM_STYLE_CONTENT_TYPE, DRAWINGML_MAIN_NAMESPACE, OFFICE_DOCUMENT_RELATIONSHIPS_NAMESPACE, OFFICE_IMAGE_RELATIONSHIP_TYPE, } from './namespaces';
+export { DiagramPartError } from './errors';
+export { DiagramPointType, CreateDiagramInstanceOptions, CreateDiagramInstanceResult, CreateDiagramInstanceSeeds, DiagramColorsPart, DiagramConnection, DiagramDataPart, DiagramGraphicHook, DiagramInstance, DiagramLayoutPart, DiagramPackageGraph, DiagramPackagePart, DiagramPackageRelationship, DiagramPartHandler, DiagramPartNames, DiagramPoint, DiagramRelIds, DiagramStylePart, GetDiagramInstanceOptions, RemoveDiagramInstanceOptions, RemoveDiagramInstanceResult, } from './types';
+export { parseDiagramData } from './parse-data';
+export { parseDiagramColors } from './parse-colors';
+export { parseDiagramLayout } from './parse-layout';
+export { parseDiagramStyle } from './parse-style';
+export { findDiagramRelIds, parseDiagramRelIds } from './parse-rel-ids';
+export { serializeDiagramColors, serializeDiagramData, serializeDiagramLayout, serializeDiagramStyle, } from './serialize';
+export { enumerateDiagramInstances, getDiagramInstance, listDiagramParts, normalizePartName, } from './package-graph';
+export { createDiagramInstance, removeDiagramInstance } from './mutators';
+export { diagramPoint, diagramPointText, listDiagramConnections, listDiagramPoints, withDiagramPointText, } from './point-text';
+export { getDiagramPartHandler, registerSmartArtFeature } from './register';

package/src/features/smart-art/index.js

@@ -0,0 +1,26 @@
+/**
+ * Optional SmartArt / DrawingML diagram common layer.
+ *
+ * @remarks
+ * Host-neutral package constants, part parse/serialize, and content-type handlers
+ * shared by PowerPoint, Word, and Excel consumers. This module must not export
+ * slide, document-body, worksheet, or other host product types.
+ *
+ * Mapping: `docs/ooxml-mapping/smart-art.md`
+ * Requirement: `docs/requirements/smart-art-shared-common.md`
+ *
+ * @packageDocumentation
+ */
+export { DIAGRAM_COLORS_CONTENT_TYPE, DIAGRAM_COLORS_RELATIONSHIP_TYPE, DIAGRAM_CONTENT_TYPES, DIAGRAM_DATA_CONTENT_TYPE, DIAGRAM_DATA_RELATIONSHIP_TYPE, DIAGRAM_GRAPHIC_DATA_URI, DIAGRAM_LAYOUT_CONTENT_TYPE, DIAGRAM_LAYOUT_RELATIONSHIP_TYPE, DIAGRAM_NAMESPACE, DIAGRAM_QUICK_STYLE_RELATIONSHIP_TYPE, DIAGRAM_RELATIONSHIP_TYPES, DIAGRAM_STYLE_CONTENT_TYPE, DRAWINGML_MAIN_NAMESPACE, OFFICE_DOCUMENT_RELATIONSHIPS_NAMESPACE, OFFICE_IMAGE_RELATIONSHIP_TYPE, } from './namespaces';
+export { DiagramPartError } from './errors';
+export { DiagramPointType, } from './types';
+export { parseDiagramData } from './parse-data';
+export { parseDiagramColors } from './parse-colors';
+export { parseDiagramLayout } from './parse-layout';
+export { parseDiagramStyle } from './parse-style';
+export { findDiagramRelIds, parseDiagramRelIds } from './parse-rel-ids';
+export { serializeDiagramColors, serializeDiagramData, serializeDiagramLayout, serializeDiagramStyle, } from './serialize';
+export { enumerateDiagramInstances, getDiagramInstance, listDiagramParts, normalizePartName, } from './package-graph';
+export { createDiagramInstance, removeDiagramInstance } from './mutators';
+export { diagramPoint, diagramPointText, listDiagramConnections, listDiagramPoints, withDiagramPointText, } from './point-text';
+export { getDiagramPartHandler, registerSmartArtFeature } from './register';

package/src/features/smart-art/minimal-samples.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Built-in minimal diagram part XML seeds for {@link createDiagramInstance}.
+ *
+ * @remarks
+ * Documented sample only — not a layout catalog. Roots match Transitional
+ * `dml-diagram.xsd` (`dataModel`, `layoutDef`, `colorsDef`, `styleDef`).
+ * ECMA-376 Part 1 §14.2.3–14.2.6.
+ *
+ * @private
+ */
+/** Minimal `dgm:dataModel` with required `ptLst` (doc + one node). */
+export declare const MINIMAL_DIAGRAM_DATA_XML: string;
+/** Minimal `dgm:layoutDef` with title/desc. */
+export declare const MINIMAL_DIAGRAM_LAYOUT_XML: string;
+/** Minimal `dgm:colorsDef`. */
+export declare const MINIMAL_DIAGRAM_COLORS_XML: string;
+/** Minimal `dgm:styleDef`. */
+export declare const MINIMAL_DIAGRAM_STYLE_XML: string;