@syncfusion/ej2-office-common 35.1.37

package/dist/global/index.d.ts

@@ -0,0 +1,14 @@
+/*!
+*  filename: index.d.ts
+*  version : 35.1.37
+*  Copyright Syncfusion Inc. 2001 - 2025. All rights reserved.
+*  Use of this code is subject to the terms of our license.
+*  A copy of the current license can be obtained at any time by e-mailing
+*  licensing@syncfusion.com. Any infringement will be prosecuted under
+*  applicable laws. 
+*/
+import * as _officecommon from '@syncfusion/ej2-office-common';
+
+export declare namespace ej {
+    const officecommon: typeof _officecommon;
+}

package/encryption.js

@@ -0,0 +1,4 @@
+/**
+ * encryption
+ */
+export * from './src/encryption/index';

package/features.js

@@ -0,0 +1,4 @@
+/**
+ * features
+ */
+export * from './src/features/index';

package/global.json

@@ -0,0 +1,6 @@
+{
+  "sdk": {
+    "version": "10.0.400",
+    "rollForward": "latestFeature"
+  }
+}

package/index.js

@@ -0,0 +1,4 @@
+/**
+ * index
+ */
+export * from './src/index';

package/license

@@ -0,0 +1,10 @@
+Essential JS 2 library is available under the Syncfusion Essential Studio program,  and can be licensed either under the Syncfusion Community License Program or the Syncfusion commercial license.
+
+To be qualified for the Syncfusion Community License Program you must have a gross revenue of less than one (1) million U.S. dollars ($1,000,000.00 USD) per year and have less than five (5) developers in your organization, and agree to be bound by Syncfusion’s terms and conditions. 
+
+Customers who do not qualify for the community license can contact sales@syncfusion.com for commercial licensing options.
+
+Under no circumstances you can use this product without (1) either a Community License or a commercial license and (2) without agreeing and abiding by Syncfusion’s license containing all terms and conditions. 
+
+The Syncfusion license that contains the terms and conditions can be found at 
+https://www.syncfusion.com/content/downloads/syncfusion_license.pdf

package/nuget.config

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <packageSources>
+    <clear />
+    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
+  </packageSources>
+</configuration>

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@syncfusion/ej2-office-common",
+  "version": "35.1.37",
+  "description": "Shared OOXML codecs and domain models for EJ2 Office JavaScript libraries (ink, diagrams, mathml, smart-art, encryption).",
+  "author": "Syncfusion Inc.",
+  "license": "SEE LICENSE IN license",
+  "devDependencies": {},
+  "main": "./dist/ej2-office-common.umd.min.js",
+  "module": "./index.js",
+  "es2015": "./dist/es6/ej2-office-common.es5.js",
+  "typings": "index.d.ts",
+  "keywords": [
+    "ej2",
+    "syncfusion",
+    "office-common"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/syncfusion/ej2-javascript-ui-controls/tree/master/controls/office-common"
+  },
+  "sideEffects": false,
+  "homepage": "https://www.syncfusion.com/javascript-ui-controls"
+}

package/src/all.d.ts

@@ -0,0 +1,41 @@
+/**
+ * All-in entry for consumers who want every public API from @syncfusion/ej2-office-common.
+ * Prefer explicit `@syncfusion/ej2-office-common/<feature>` subpaths when bundle size matters.
+ *
+ * @remarks
+ * Re-exports the root surface (ink, mathml, encryption) plus the optional
+ * SmartArt (`./smart-art`) module. Diagram feature symbols remain on the
+ * `@syncfusion/ej2-office-common/diagrams` subpath only (same dual-export pattern as
+ * development). FEATURE_SUBPATHS lists every optional feature export.
+ *
+ * @packageDocumentation
+ */
+export * from './index';
+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, DiagramPartError, DiagramPointType, createDiagramInstance, diagramPoint, diagramPointText, enumerateDiagramInstances, findDiagramRelIds, getDiagramInstance, getDiagramPartHandler, listDiagramConnections, listDiagramParts, listDiagramPoints, normalizePartName, parseDiagramColors, parseDiagramData, parseDiagramLayout, parseDiagramRelIds, parseDiagramStyle, registerSmartArtFeature, removeDiagramInstance, serializeDiagramColors, serializeDiagramData, serializeDiagramLayout, serializeDiagramStyle, withDiagramPointText, CreateDiagramInstanceOptions, CreateDiagramInstanceResult, CreateDiagramInstanceSeeds, DiagramColorsPart, DiagramConnection, DiagramDataPart, DiagramGraphicHook, DiagramInstance, DiagramLayoutPart, DiagramPackageGraph, DiagramPackagePart, DiagramPackageRelationship, DiagramPartHandler, DiagramPartNames, DiagramPoint, DiagramRelIds, DiagramStylePart, GetDiagramInstanceOptions, RemoveDiagramInstanceOptions, RemoveDiagramInstanceResult, } from './features/smart-art/index';
+/**
+ * Feature subpaths registered for the configurator / bundle matrix.
+ * Must stay in sync with `package.json` `exports` feature keys.
+ *
+ * @remarks
+ * Non-feature surfaces such as `./encryption` are omitted here.
+ *
+ * @public
+ */
+export declare const FEATURE_SUBPATHS: string[];
+/**
+ * Union of FEATURE_SUBPATHS string literals.
+ *
+ * @public
+ */
+export declare type FeatureSubpath = (typeof FEATURE_SUBPATHS)[number];
+/**
+ * Registers every optional feature that installs side-effect handlers in this build.
+ *
+ * @remarks
+ * Invokes registerSmartArtFeature, which installs the four Transitional
+ * diagram content-type handlers (idempotent). Ink / diagrams / mathml modules
+ * do not expose a matching register hook on this tree.
+ *
+ * @public
+ */
+export declare function registerAllFeatures(): void;

package/src/all.js

@@ -0,0 +1,38 @@
+/**
+ * All-in entry for consumers who want every public API from @syncfusion/ej2-office-common.
+ * Prefer explicit `@syncfusion/ej2-office-common/<feature>` subpaths when bundle size matters.
+ *
+ * @remarks
+ * Re-exports the root surface (ink, mathml, encryption) plus the optional
+ * SmartArt (`./smart-art`) module. Diagram feature symbols remain on the
+ * `@syncfusion/ej2-office-common/diagrams` subpath only (same dual-export pattern as
+ * development). FEATURE_SUBPATHS lists every optional feature export.
+ *
+ * @packageDocumentation
+ */
+export * from './index';
+import { registerSmartArtFeature } from './features/smart-art/index';
+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, DiagramPartError, DiagramPointType, createDiagramInstance, diagramPoint, diagramPointText, enumerateDiagramInstances, findDiagramRelIds, getDiagramInstance, getDiagramPartHandler, listDiagramConnections, listDiagramParts, listDiagramPoints, normalizePartName, parseDiagramColors, parseDiagramData, parseDiagramLayout, parseDiagramRelIds, parseDiagramStyle, registerSmartArtFeature, removeDiagramInstance, serializeDiagramColors, serializeDiagramData, serializeDiagramLayout, serializeDiagramStyle, withDiagramPointText, } from './features/smart-art/index';
+/**
+ * Feature subpaths registered for the configurator / bundle matrix.
+ * Must stay in sync with `package.json` `exports` feature keys.
+ *
+ * @remarks
+ * Non-feature surfaces such as `./encryption` are omitted here.
+ *
+ * @public
+ */
+export var FEATURE_SUBPATHS = ['ink', 'diagrams', 'mathml', 'smart-art'];
+/**
+ * Registers every optional feature that installs side-effect handlers in this build.
+ *
+ * @remarks
+ * Invokes registerSmartArtFeature, which installs the four Transitional
+ * diagram content-type handlers (idempotent). Ink / diagrams / mathml modules
+ * do not expose a matching register hook on this tree.
+ *
+ * @public
+ */
+export function registerAllFeatures() {
+    registerSmartArtFeature();
+}

package/src/core/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Core shared OOXML primitives for EJ2 Office libraries.
+ *
+ * @packageDocumentation
+ */
+export * from './xml/index';

package/src/core/index.js

@@ -0,0 +1,6 @@
+/**
+ * Core shared OOXML primitives for EJ2 Office libraries.
+ *
+ * @packageDocumentation
+ */
+export * from './xml/index';

package/src/core/xml/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Open XML tree types for shared codecs.
+ *
+ * @packageDocumentation
+ */
+export { NamespaceDeclaration, OpenXmlAttribute, OpenXmlChild, OpenXmlElement, OpenXmlText, } from './model';
+export { XML_NAMESPACE, XMLNS_NAMESPACE } from './model';

package/src/core/xml/index.js

@@ -0,0 +1,6 @@
+/**
+ * Open XML tree types for shared codecs.
+ *
+ * @packageDocumentation
+ */
+export { XML_NAMESPACE, XMLNS_NAMESPACE } from './model';

package/src/core/xml/model.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Minimal Open XML element tree model shared by office-common codecs.
+ *
+ * Shape matches the application-repo OpenXml tree (`ej2-docx` `src/core/xml/model.ts`)
+ * so ink parse/serialize can accept host-supplied trees without a second DOM type.
+ *
+ * This module does **not** parse raw bytes — callers supply an element tree.
+ */
+/**
+ * Attribute on an {@link OpenXmlElement}.
+ *
+ * @public
+ */
+export interface OpenXmlAttribute {
+    readonly namespaceUri: string;
+    readonly localName: string;
+    readonly prefix: string;
+    readonly value: string;
+}
+/**
+ * `xmlns` declaration on an {@link OpenXmlElement}.
+ *
+ * @public
+ */
+export interface NamespaceDeclaration {
+    readonly prefix: string;
+    readonly namespaceUri: string;
+}
+/**
+ * Child of an {@link OpenXmlElement}.
+ *
+ * @public
+ */
+export declare type OpenXmlChild = OpenElement | OpenXmlText;
+/**
+ * Text node in the XML tree.
+ *
+ * @public
+ */
+export interface OpenXmlText {
+    readonly kind: 'text';
+    readonly value: string;
+}
+/**
+ * Element in the preserved XML tree.
+ *
+ * @public
+ */
+export interface OpenXmlElement {
+    readonly kind: 'element';
+    readonly namespaceUri: string;
+    readonly localName: string;
+    readonly prefix: string;
+    readonly attributes: ReadonlyArray<OpenXmlAttribute>;
+    readonly namespaceDeclarations: ReadonlyArray<NamespaceDeclaration>;
+    readonly children: ReadonlyArray<OpenXmlChild>;
+}
+/** Alias kept for internal clarity when building trees. */
+export declare type OpenElement = OpenXmlElement;
+/**
+ * XML namespace URI (`xml:`).
+ *
+ * @public
+ */
+export declare const XML_NAMESPACE = "http://www.w3.org/XML/1998/namespace";
+/**
+ * XMLNS namespace URI (`xmlns:`).
+ *
+ * @public
+ */
+export declare const XMLNS_NAMESPACE = "http://www.w3.org/2000/xmlns/";

package/src/core/xml/model.js

@@ -0,0 +1,20 @@
+/**
+ * Minimal Open XML element tree model shared by office-common codecs.
+ *
+ * Shape matches the application-repo OpenXml tree (`ej2-docx` `src/core/xml/model.ts`)
+ * so ink parse/serialize can accept host-supplied trees without a second DOM type.
+ *
+ * This module does **not** parse raw bytes — callers supply an element tree.
+ */
+/**
+ * XML namespace URI (`xml:`).
+ *
+ * @public
+ */
+export var XML_NAMESPACE = 'http://www.w3.org/XML/1998/namespace';
+/**
+ * XMLNS namespace URI (`xmlns:`).
+ *
+ * @public
+ */
+export var XMLNS_NAMESPACE = 'http://www.w3.org/2000/xmlns/';

package/src/encryption/agile-constants.d.ts

@@ -0,0 +1,61 @@
+/**
+ * EncryptionVersionInfo major for Agile: `0x0004` ([MS-OFFCRYPTO] §2.3.4.10).
+ *
+ * @public
+ */
+export declare const AGILE_VERSION_MAJOR = 4;
+/**
+ * EncryptionVersionInfo minor for Agile: `0x0004` ([MS-OFFCRYPTO] §2.3.4.10).
+ *
+ * @public
+ */
+export declare const AGILE_VERSION_MINOR = 4;
+/** Reserved field after version MUST be 0x00000040 (§2.3.4.10). */
+export declare const AGILE_RESERVED = 64;
+/** EncryptionInfo XML target namespace (§2.3.4.10). */
+export declare const AGILE_ENCRYPTION_NS = "http://schemas.microsoft.com/office/2006/encryption";
+/** PasswordKeyEncryptor URI on keyEncryptor (§2.3.4.10). */
+export declare const PASSWORD_KEY_ENCRYPTOR_URI = "http://schemas.microsoft.com/office/2006/keyEncryptor/password";
+/** PasswordKeyEncryptor element namespace (§2.3.4.10). */
+export declare const PASSWORD_KEY_ENCRYPTOR_NS = "http://schemas.microsoft.com/office/2006/keyEncryptor/password";
+/**
+ * Block key for encryptedVerifierHashInput (§2.3.4.13).
+ * Bytes: fe a7 d2 76 3b 4b 9e 79.
+ */
+export declare const BLOCK_KEY_VERIFIER_INPUT: Uint8Array;
+/**
+ * Block key for encryptedVerifierHashValue (§2.3.4.13).
+ * Bytes: d7 aa 0f 6d 30 61 34 4e.
+ */
+export declare const BLOCK_KEY_VERIFIER_HASH: Uint8Array;
+/**
+ * Block key for encryptedKeyValue (§2.3.4.13).
+ * Bytes: 14 6e 0b e7 ab ac d0 d6.
+ */
+export declare const BLOCK_KEY_ENCRYPTOR_KEY: Uint8Array;
+/**
+ * Block key for encryptedHmacKey (§2.3.4.14).
+ * Bytes: 5f b2 ad 01 0c b9 e1 f6.
+ */
+export declare const BLOCK_KEY_HMAC_KEY: Uint8Array;
+/**
+ * Block key for encryptedHmacValue (§2.3.4.14).
+ * Bytes: a0 67 7f 02 b2 2c 84 33.
+ */
+export declare const BLOCK_KEY_HMAC_VALUE: Uint8Array;
+/** EncryptedPackage segment size in bytes (§2.3.4.15). */
+export declare const ENCRYPTED_PACKAGE_SEGMENT_SIZE = 4096;
+/** CFB root stream names for OFFCRYPTO (§2.3.4.4, §2.3.4.10). */
+export declare const STREAM_ENCRYPTION_INFO = "EncryptionInfo";
+export declare const STREAM_ENCRYPTED_PACKAGE = "EncryptedPackage";
+/** Maximum spinCount from ST_SpinCount (§2.3.4.10). */
+export declare const MAX_SPIN_COUNT = 10000000;
+/**
+ * Standard Encryption EncryptionVersionInfo minor version (§2.3.4.5).
+ * Major is 2, 3, or 4 with minor 0x0002 — explicitly unsupported in Phase 6.
+ */
+export declare const STANDARD_ENCRYPTION_VERSION_MINOR = 2;
+/** Key padding byte when Hfinal is shorter than keyBits/8 (§2.3.4.11). */
+export declare const KEY_PAD_BYTE = 54;
+/** IV padding byte when IV is shorter than blockSize (§2.3.4.12). */
+export declare const IV_PAD_BYTE = 54;

package/src/encryption/agile-constants.js

@@ -0,0 +1,71 @@
+/*
+ * Agile OFFCRYPTO constants cited from local [MS-OFFCRYPTO].
+ *
+ * @remarks
+ * Never invent algorithm URIs, element names, or block keys. All values below
+ * are taken from `specs/microsoft/[MS-OFFCRYPTO].md` §2.3.4.10–§2.3.4.15.
+ * Re-exported from the encryption public surface for fixture / host harness use.
+ *
+ * @packageDocumentation
+ */
+/**
+ * EncryptionVersionInfo major for Agile: `0x0004` ([MS-OFFCRYPTO] §2.3.4.10).
+ *
+ * @public
+ */
+export var AGILE_VERSION_MAJOR = 0x0004;
+/**
+ * EncryptionVersionInfo minor for Agile: `0x0004` ([MS-OFFCRYPTO] §2.3.4.10).
+ *
+ * @public
+ */
+export var AGILE_VERSION_MINOR = 0x0004;
+/** Reserved field after version MUST be 0x00000040 (§2.3.4.10). */
+export var AGILE_RESERVED = 0x00000040;
+/** EncryptionInfo XML target namespace (§2.3.4.10). */
+export var AGILE_ENCRYPTION_NS = 'http://schemas.microsoft.com/office/2006/encryption';
+/** PasswordKeyEncryptor URI on keyEncryptor (§2.3.4.10). */
+export var PASSWORD_KEY_ENCRYPTOR_URI = 'http://schemas.microsoft.com/office/2006/keyEncryptor/password';
+/** PasswordKeyEncryptor element namespace (§2.3.4.10). */
+export var PASSWORD_KEY_ENCRYPTOR_NS = 'http://schemas.microsoft.com/office/2006/keyEncryptor/password';
+/**
+ * Block key for encryptedVerifierHashInput (§2.3.4.13).
+ * Bytes: fe a7 d2 76 3b 4b 9e 79.
+ */
+export var BLOCK_KEY_VERIFIER_INPUT = Uint8Array.of(0xfe, 0xa7, 0xd2, 0x76, 0x3b, 0x4b, 0x9e, 0x79);
+/**
+ * Block key for encryptedVerifierHashValue (§2.3.4.13).
+ * Bytes: d7 aa 0f 6d 30 61 34 4e.
+ */
+export var BLOCK_KEY_VERIFIER_HASH = Uint8Array.of(0xd7, 0xaa, 0x0f, 0x6d, 0x30, 0x61, 0x34, 0x4e);
+/**
+ * Block key for encryptedKeyValue (§2.3.4.13).
+ * Bytes: 14 6e 0b e7 ab ac d0 d6.
+ */
+export var BLOCK_KEY_ENCRYPTOR_KEY = Uint8Array.of(0x14, 0x6e, 0x0b, 0xe7, 0xab, 0xac, 0xd0, 0xd6);
+/**
+ * Block key for encryptedHmacKey (§2.3.4.14).
+ * Bytes: 5f b2 ad 01 0c b9 e1 f6.
+ */
+export var BLOCK_KEY_HMAC_KEY = Uint8Array.of(0x5f, 0xb2, 0xad, 0x01, 0x0c, 0xb9, 0xe1, 0xf6);
+/**
+ * Block key for encryptedHmacValue (§2.3.4.14).
+ * Bytes: a0 67 7f 02 b2 2c 84 33.
+ */
+export var BLOCK_KEY_HMAC_VALUE = Uint8Array.of(0xa0, 0x67, 0x7f, 0x02, 0xb2, 0x2c, 0x84, 0x33);
+/** EncryptedPackage segment size in bytes (§2.3.4.15). */
+export var ENCRYPTED_PACKAGE_SEGMENT_SIZE = 4096;
+/** CFB root stream names for OFFCRYPTO (§2.3.4.4, §2.3.4.10). */
+export var STREAM_ENCRYPTION_INFO = 'EncryptionInfo';
+export var STREAM_ENCRYPTED_PACKAGE = 'EncryptedPackage';
+/** Maximum spinCount from ST_SpinCount (§2.3.4.10). */
+export var MAX_SPIN_COUNT = 10000000;
+/**
+ * Standard Encryption EncryptionVersionInfo minor version (§2.3.4.5).
+ * Major is 2, 3, or 4 with minor 0x0002 — explicitly unsupported in Phase 6.
+ */
+export var STANDARD_ENCRYPTION_VERSION_MINOR = 0x0002;
+/** Key padding byte when Hfinal is shorter than keyBits/8 (§2.3.4.11). */
+export var KEY_PAD_BYTE = 0x36;
+/** IV padding byte when IV is shorter than blockSize (§2.3.4.12). */
+export var IV_PAD_BYTE = 0x36;

package/src/encryption/agile-encryption-info.d.ts

@@ -0,0 +1,46 @@
+import { AgileHashName } from './crypto-primitives';
+import { DecryptSecurityLimits } from './errors';
+/** Parsed KeyData from encryption XML. */
+export interface AgileKeyData {
+    readonly saltSize: number;
+    readonly blockSize: number;
+    readonly keyBits: number;
+    readonly hashSize: number;
+    readonly cipherAlgorithm: string;
+    readonly cipherChaining: string;
+    readonly hashAlgorithm: AgileHashName;
+    readonly saltValue: Uint8Array;
+}
+/** Parsed DataIntegrity (optional but expected on modern packages). */
+export interface AgileDataIntegrity {
+    readonly encryptedHmacKey: Uint8Array;
+    readonly encryptedHmacValue: Uint8Array;
+}
+/** Password key encryptor (p:encryptedKey attributes). */
+export interface AgilePasswordKeyEncryptor {
+    readonly spinCount: number;
+    readonly saltSize: number;
+    readonly blockSize: number;
+    readonly keyBits: number;
+    readonly hashSize: number;
+    readonly cipherAlgorithm: string;
+    readonly cipherChaining: string;
+    readonly hashAlgorithm: AgileHashName;
+    readonly saltValue: Uint8Array;
+    readonly encryptedVerifierHashInput: Uint8Array;
+    readonly encryptedVerifierHashValue: Uint8Array;
+    readonly encryptedKeyValue: Uint8Array;
+}
+/** Full Agile EncryptionInfo model used by decrypt. */
+export interface AgileEncryptionInfo {
+    readonly keyData: AgileKeyData;
+    readonly dataIntegrity: AgileDataIntegrity | undefined;
+    readonly passwordKeyEncryptor: AgilePasswordKeyEncryptor;
+}
+/**
+ * Parses EncryptionInfo stream bytes into an Agile model.
+ *
+ * @throws {UnsupportedEncryptionError} Standard Encryption or unknown version/alg.
+ * @throws {EncryptedPackageError} Truncated or missing required Agile fields.
+ */
+export declare function parseAgileEncryptionInfo(encryptionInfo: Uint8Array, limits: DecryptSecurityLimits): AgileEncryptionInfo;