feature: ooxml-inspector dev tool CLI and lib

[harbournick]

• New package ooxml-spec-tool loads OOXML .xsd file definitions into a JSON schema
• adds CLI tool for tag inspection
• can be linked to SuperConverter for tag pre-processing, or SuperValidator for validation

OOXML Inspector

OOXML Inspector is a developer tool + library for working with Office Open XML (OOXML) schemas.
It bundles the transitional WordprocessingML schema into JSON and provides both:

• a CLI (ooxml) for inspecting schema relationships, and
• a JavaScript/TypeScript library for programmatic access.

Features

• Query OOXML element children, attributes, and namespaces
• Explore schema relationships and tag hierarchies
• Use as a CLI or import as a library in Node.js/TypeScript

Installation

npm install @superdoc-dev/ooxml-inspector

CLI Usage

npx ooxml children w:p
npx ooxml tags --parents
npx ooxml namespaces
npx ooxml attrs w:p

• children <prefix:local>: List allowed children for an element
• tags [prefix] [--parents] [--plain]: List tags, optionally filtering by namespace or parent status
• namespaces: List all namespaces in the schema
• attrs <prefix:local>: List attributes for an element

Library Usage

import { childrenOf } from '@superdoc-dev/ooxml-inspector';

const children = childrenOf('w:p'); // Get children of <w:p>

Development

• Build: npm run build
• Test: npm run test
• Coverage: npm run test:cov

License

AGPLv3

[Copilot]

Pull Request Overview

This PR introduces a new ooxml-spec-tool package that loads OOXML .xsd file definitions into JSON schema format and provides a CLI tool for tag inspection. The package can be integrated with SuperConverter for tag pre-processing or SuperValidator for validation.

• New package structure with OOXML schema definitions in XSD format
• CLI tool implementation for tag inspection capabilities
• JSON schema conversion functionality for OOXML specifications

Reviewed Changes

Copilot reviewed 23 out of 88 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
vml-wordprocessingDrawing.xsd	VML schema definitions for Word processing drawing elements including borders, wrapping, and anchoring
vml-spreadsheetDrawing.xsd	VML schema for Excel spreadsheet drawing with client data and object types
vml-presentationDrawing.xsd	Minimal VML schema for PowerPoint presentation drawing elements
vml-officeDrawing.xsd	Comprehensive VML office drawing schema with shapes, fills, strokes, and visual effects
vml-main.xsd	Core VML schema defining main shape elements, attributes, and type definitions
shared-relationshipReference.xsd	Schema for relationship references between OOXML document parts
shared-math.xsd	Mathematical expressions schema for OOXML documents
shared-documentPropertiesVariantTypes.xsd	Variant data types for document properties
shared-documentPropertiesExtended.xsd	Extended document properties schema
shared-documentPropertiesCustom.xsd	Custom document properties schema
shared-customXmlSchemaProperties.xsd	Schema for custom XML schema library properties
shared-customXmlDataProperties.xsd	Schema for custom XML data properties
shared-commonSimpleTypes.xsd	Common simple type definitions used across OOXML schemas
shared-bibliography.xsd	Bibliography and citation schema definitions
shared-additionalCharacteristics.xsd	Schema for additional document characteristics

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}