@syncfusion/ej2-office-common 35.1.37

package/.eslintrc.json

@@ -0,0 +1,263 @@
+{
+    "env": {
+        "browser": true,
+        "es2021": true
+    },
+    "extends": [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended",
+        "plugin:jsdoc/recommended",
+        "plugin:security/recommended"
+    ],
+    "parser": "@typescript-eslint/parser",
+    "parserOptions": {
+        "ecmaFeatures": { "js": true },
+        "ecmaVersion": 2018,
+        "project": "./tsconfig.json",
+        "sourceType": "module"
+    },
+    "ignorePatterns": ["*.d.ts", "*.js"],
+    "plugins": [
+        "@typescript-eslint",
+        "@typescript-eslint/tslint",
+        "eslint-plugin-security",
+        "jsdoc"
+    ],
+    "rules": {
+        "use-isnan": "error",
+        "security/detect-unsafe-regex":"error",
+        "security/detect-buffer-noassert":"error",
+        "security/detect-child-process":"error",
+        "security/detect-disable-mustache-escape":"error",
+        "security/detect-eval-with-expression":"error",
+        "security/detect-no-csrf-before-method-override":"error",
+        "security/detect-non-literal-fs-filename":"error",
+        "security/detect-non-literal-regexp":"error",
+        "security/detect-non-literal-require":"error",
+        "security/detect-object-injection":"error",
+        "security/detect-possible-timing-attacks":"error",
+        "security/detect-pseudoRandomBytes":"error",
+        "security/detect-new-buffer":"error",
+        "security/detect-bidi-characters":"error",
+        "no-prototype-builtins": "warn",
+        "no-extend-native": ["warn"],
+        "@typescript-eslint/no-inferrable-types": "off",
+        "@typescript-eslint/ban-types": ["warn", {
+            "types": {
+                "Object": false,
+                "object": false,
+                "{}": false,
+                "Function": false
+            }
+        }],
+        "jsdoc/check-tag-names": 0,
+        "@typescript-eslint/tslint/config": [
+            "error",
+            {
+                "rules": {
+                    "ban": true,
+                    "chai-vague-errors": true,
+                    "max-func-body-length": [
+                        true,
+                        120,
+                        {
+                            "ignore-parameters-to-function-regex": "describe"
+                        }
+                    ],
+                    "missing-jsdoc": true,
+                    "no-backbone-get-set-outside-model": false,
+                    "no-cookies": false,
+                    "no-delete-expression": false,
+                    "no-disable-auto-sanitization": true,
+                    "no-duplicate-case": true,
+                    "no-duplicate-parameter-names": true,
+                    "no-empty-interfaces": false,
+                    "no-exec-script": true,
+                    "no-function-expression": false,
+                    "no-multiple-var-decl": false,
+                    "no-string-based-set-immediate": false,
+                    "no-string-based-set-interval": false,
+                    "no-unnecessary-bind": false,
+                    "no-unused-imports": true,
+                    "no-with-statement": false,
+                    "prefer-array-literal": false,
+                    "typedef": [
+                        true,
+                        "call-signature",
+                        "parameter",
+                        "property-declaration",
+                        "variable-declaration",
+                        "arrow-parameter",
+                        "member-variable-declaration"
+                    ],
+                    "use-named-parameter": false,
+                    "valid-typeof": true,
+                    "whitespace": [
+                        true,
+                        "check-branch",
+                        "check-decl",
+                        "check-operator",
+                        "check-separator",
+                        "check-type"
+                    ]
+                }
+            }
+        ],
+        "no-control-regex": "error",
+        "no-constant-condition": "error",
+        "no-invalid-regexp": "error",
+        "curly": "error",
+        "eol-last": [
+            "error",
+            "always"
+        ],
+        "guard-for-in": "error",
+        "no-labels": "error",
+        "max-len": [
+            "error",
+            {
+                "code": 140,
+                "tabWidth": 4,
+                "ignoreComments": true,
+                "ignoreStrings": true,
+                "ignoreTemplateLiterals": true,
+                "ignoreRegExpLiterals": true
+            }
+        ],
+        "no-console": [
+            "error",
+            {
+                "allow": [
+                    "warn",
+                    "dir",
+                    "timeLog",
+                    "assert",
+                    "clear",
+                    "count",
+                    "countReset",
+                    "group",
+                    "groupEnd",
+                    "table",
+                    "dirxml",
+                    "error",
+                    "groupCollapsed",
+                    "Console",
+                    "profile",
+                    "profileEnd",
+                    "timeStamp",
+                    "context"
+                ]
+            }
+        ],
+        "no-redeclare": [
+            "error",
+            {
+                "builtinGlobals": true
+            }
+        ],
+        "@typescript-eslint/no-parameter-properties": "error",
+        "@typescript-eslint/indent": [
+            "error",
+            4,
+            {
+                "CallExpression": {
+                    "arguments": "first"
+                },
+                "FunctionDeclaration": {
+                    "parameters": "first"
+                },
+                "FunctionExpression": {
+                    "parameters": "first"
+                }
+            }
+        ],
+        "no-debugger": "error",
+        "no-eval": "error",
+        "no-extra-semi": "error",
+        "no-throw-literal": "error",
+        "no-fallthrough": "error",
+        "comma-dangle": [
+            "error",
+            "never"
+        ],
+        "no-trailing-spaces": "error",
+        "@typescript-eslint/no-unused-expressions": "error",
+        "@typescript-eslint/no-var-requires": "error",
+        "one-var": [
+            "error",
+            "never"
+        ],
+        "@typescript-eslint/no-explicit-any": "warn",
+        "no-cond-assign": [
+            "error",
+            "always"
+        ],
+        "@typescript-eslint/consistent-type-assertions": "off",
+        "jsdoc/check-alignment": "error",
+        "no-empty": "error",
+        "quotes": [
+            "error",
+            "single"
+        ],
+        "semi": [
+            "error",
+            "always"
+        ],
+        "eqeqeq": [
+            "error",
+            "smart"
+        ],
+        "valid-typeof": [
+            "error",
+            {
+                "requireStringLiterals": true
+            }
+        ],
+        "camelcase": [
+            "error",
+            {
+                "properties": "always",
+                "ignoreDestructuring": true,
+                "ignoreImports": true
+            }
+        ],
+        "no-irregular-whitespace": [
+            "error",
+            {
+                "skipStrings": true,
+                "skipComments": true,
+                "skipRegExps": true,
+                "skipTemplates": true
+            }
+        ],
+        "valid-jsdoc": [
+            "error",
+            {
+                "prefer": {
+                    "arg": "param",
+                    "argument": "param",
+                    "class": "constructor",
+                    "return": "returns",
+                    "virtual": "abstract"
+                }
+            }
+        ],
+        "no-var": "error",
+        "radix": "error"
+    },
+    "reportUnusedDisableDirectives": true,
+    "overrides": [
+        {
+            "files": [
+                "node_modules",
+                "dist",
+                "public",
+                "coverage",
+                "test-report"
+            ],
+            "rules": {
+                "no-unused-expressions": "off"
+            }
+        }
+    ]
+}

package/.prettierrc.json

@@ -0,0 +1,5 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100
+}

package/README.md

@@ -0,0 +1,167 @@
+# @syncfusion/ej2-office-common
+
+A programmatic DOCX/OOXML class library for JavaScript and TypeScript — read, create,
+and modify Word documents in Node and the browser, without Word and without losing
+anything the library does not yet understand.
+
+> **Status: milestone-review.** Phase 1 tasks TASK-1001–1012 are done. Report:
+> `docs/milestones/2026-08-29-phase-1.md`. Consume this package from git; it is not
+> published to npm.
+
+## Why this repository looks like this
+
+The library is built by coding agents running autonomously. That only works if the rules
+are written down, so most of what you see here is the control plane: policies agents must
+follow, workflows they execute, skills they invoke, and gates that stop them shipping
+something broken.
+
+`.agent/` is the single source of truth. `CLAUDE.md`, `.github/copilot-instructions.md`
+and `.cursor/rules/` are thin adapters that all point back to it, so Claude Code, OpenAI
+Codex, Cursor, GitHub Copilot and other repository-aware agents get the same rules.
+
+## Guiding principle
+
+> Parse what you understand. Preserve what you do not understand.
+
+A consumer must be able to open a document from any conforming producer, change one
+thing, save, and lose nothing — including the charts, revisions, macros and vendor
+extensions this library has no semantic model for. That constraint shapes the whole
+architecture, and it is why preservation and round-trip tests outrank feature count.
+
+## Prerequisites
+
+| Requirement | For | Needed when |
+|---|---|---|
+| Node.js ≥ 20.11 | the library and harness CLI | always |
+| Python 3.9+ | `scripts/verify_harness.py` | always |
+| .NET 10 SDK | Open XML SDK validation, DocIO fixtures | before release |
+| Syncfusion DocIO licence | fixture generation and read-back | before release |
+| Playwright + Chromium | browser performance benchmarks | before release |
+
+The last three are optional during early development. When one is missing its gate
+reports `NOT RUN` with a reason — never `PASS` — and is recorded as a standing exception
+in `PROJECT-STATE.md`, which blocks release. See `.agent/policies/toolchain.md`.
+
+Everything else works offline. No test, build, or format decision may depend on network
+access (`.agent/policies/offline.md`).
+
+## Getting started
+
+Install from git (the package is `"private": true` and is not published to npm):
+
+```bash
+npm install git+https://github.com/vijays-git/@syncfusion/ej2-office-common.git
+```
+
+```ts
+import { Document } from '@syncfusion/ej2-office-common';
+
+const doc = Document.create();
+const paragraph = doc.body.paragraphs[0];
+if (paragraph !== undefined) {
+  paragraph.appendRun().text = 'Hello';
+}
+const bytes = await doc.save();
+const again = await Document.load(bytes);
+```
+
+`load` / `save` and `loadSync` / `saveSync` take and return `Uint8Array`. There is no
+streaming API and no filesystem helper in this version.
+
+Inspect where the project stands:
+
+```bash
+node tools/harness.mjs state
+```
+
+The phase is `phase-1`. Inspect the board and continue the task loop:
+
+```bash
+node tools/harness.mjs tasks
+```
+
+After the roadmap is approved, every session runs the same loop
+(`.agent/workflows/task-loop.md`): pick the next ready task, run the workflow for its
+type, satisfy the Definition of Done, commit, update state, repeat.
+
+Useful during that loop:
+
+```bash
+node tools/harness.mjs tasks                    # the task board, grouped by state
+node tools/harness.mjs spec-search "w:tblPr"    # bounded search of the OOXML corpus
+node tools/harness.mjs quality                  # gates, explicit PASS/FAIL/N-A each
+node tools/harness.mjs verify                   # harness structural verification
+```
+
+## What the harness provides
+
+- an autonomous task loop with a durable file-based task board and run state, so work
+  survives context resets
+- decision authority, bounded retry, and blocked-task handling, so one stuck task never
+  stalls the project
+- requirements discovery from the local OOXML corpus, then requirements, technical
+  specifications, tasks, and ADRs
+- TypeScript language standards — strict compiler settings, branded measurement units,
+  discriminated unions with exhaustiveness checks, a typed error hierarchy
+- public API standards, a committed API baseline, and SemVer gates
+- test-first development: unit, parser, writer, document-mutation, round-trip,
+  preservation, malformed, and regression suites
+- Syncfusion DocIO on-demand fixtures and independent Microsoft Open XML SDK validation
+- StrykerJS source mutation testing, focused on changed modules during development
+- ESM, tree shaking, lazy-loaded feature modules, and bundle-size gates
+- security policy with concrete limits for ZIP, XML, external and active content
+- performance, memory-retention, heap and browser benchmark lifecycle
+- milestone and release checkpoints, with honest gate reporting
+- harness self-verification and a content lock, so the rules cannot drift unnoticed
+- CI running both (`.github/workflows/quality.yml`)
+
+## Validation hierarchy
+
+When sources disagree about the format, higher wins:
+
+1. ECMA-376 / ISO/IEC 29500 and Microsoft Open Specifications
+2. Microsoft Open XML SDK validation and reference behavior
+3. Syncfusion DocIO fixture generation and read-back
+4. the JavaScript/TypeScript library under test
+
+DocIO is a fixture and interoperability oracle, not the normative specification. When
+producers disagree with the standards, the standards win and the case is escalated
+rather than resolved by whichever tool is convenient.
+
+## Repository map
+
+| Path | What it is |
+|---|---|
+| `AGENTS.md` | entry point every coding agent reads first |
+| `PROJECT-STATE.md` | current phase, active task, blockers, standing exceptions |
+| `.agent/` | canonical policies, agents, skills, workflows, checklists, templates |
+| `specs/` | offline OOXML specification corpus — normative, read-only |
+| `src/`, `types/`, `tests/` | the library, its ambient declarations, and its tests |
+| `docs/` | requirements, specs, tasks, roadmap, ADRs, OOXML mapping, journal |
+| `corpus/`, `benchmarks/` | test documents and accepted performance baselines |
+| `tools/`, `scripts/` | deterministic harness tooling and gates |
+| `.generated/` | ephemeral fixture and tool output — git-ignored, never committed |
+
+`.agent/policies/repository-layout.md` is the full map and the rule for where new
+artifacts belong.
+
+## Contributing
+
+Read `AGENTS.md` first — it applies to humans as well as agents. In short: work one task
+at a time from `docs/tasks/`, search `specs/` and cite it before implementing any format
+behavior, never invent OOXML, and satisfy `.agent/checklists/definition-of-done.md`
+before marking anything done.
+
+Changing the harness itself means updating its catalog and `manifest.json` in the same
+change, then re-locking:
+
+```bash
+python3 scripts/verify_harness.py --lock
+```
+
+## Licence
+
+The library licence will be documented to align with Syncfusion; there is no `LICENSE`
+file yet. Runtime open-source dependencies, if any, must be MIT or Apache-2.0. Syncfusion
+DocIO is first-party fixture tooling. See
+`docs/requirements/PRODUCT-DECISIONS-REQUIRED.md`.

package/api-extractor.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
+  "mainEntryPointFilePath": "<projectFolder>/dist/index.d.ts",
+  "bundledPackages": [],
+  "compiler": {
+    "tsconfigFilePath": "<projectFolder>/tsconfig.build.json"
+  },
+  "apiReport": {
+    "enabled": true,
+    "reportFolder": "<projectFolder>/docs/api",
+    "reportFileName": "@syncfusion/ej2-office-common.api.md"
+  },
+  "docModel": {
+    "enabled": false
+  },
+  "dtsRollup": {
+    "enabled": true,
+    "publicTrimmedFilePath": "<projectFolder>/dist/@syncfusion/ej2-office-common.d.ts"
+  },
+  "tsdocMetadata": {
+    "enabled": false
+  },
+  "messages": {
+    "extractorMessageReporting": {
+      "default": {
+        "logLevel": "warning"
+      }
+    },
+    "compilerMessageReporting": {
+      "default": {
+        "logLevel": "warning"
+      }
+    }
+  }
+}

package/core.js

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