Merge branch 'develop' of github.com:Harbour-Enterprises/SuperDoc into feat_numbering_validator

Author: falsaadehh

examples/vue-custom-node-example/src/custom-node.js

@@ -1,9 +1,9 @@
-import { Extensions } from '@harbour-enterprises/superdoc/super-editor';
+import { Extensions } from '@harbour-enterprises/superdoc';
 
 // Extensions includes the necessary classes for creating custom nodes
-const { Attribute } = Extensions;
+const { Attribute, Node } = Extensions;
 
-export const myCustomNode = Extensions.Node.create({
+export const myCustomNode = Node.create({
     name: 'customNode',
 
     group: 'inline',

examples/vue-linked-editor-sections/src/App.vue

@@ -3,7 +3,6 @@ import '@harbour-enterprises/superdoc/style.css';
 import { onMounted, shallowRef, ref } from 'vue';
 import { SuperDoc } from '@harbour-enterprises/superdoc';
 import UploadFile from './UploadFile.vue';
-import { SectionHelpers } from '@harbour-enterprises/superdoc';
 
 
 const superdoc = shallowRef(null);
@@ -69,7 +68,7 @@ const addSection = (section) => {
     html,
   }
 
-  const subEditor = SectionHelpers.getLinkedSectionEditor(id, options, editor.value);
+  const subEditor = editor.value.helpers.documentSection.getLinkedSectionEditor(id, options, editor.value);
 }
 
 const removeSection = (id) => {
@@ -90,12 +89,12 @@ const loadedMockHTML = {
 }
 
 const saveSectionsHTML = () => {
-  const sections = SectionHelpers.exportSectionsToHTML(editor.value);
+  const sections = editor.value.helpers.documentSection.exportSectionsToHTML(editor.value);
   console.log('Saving sections to DB:', sections);
 }
 
 const saveSectionsJSON = () => {
-  const sections = SectionHelpers.exportSectionsToJSON(editor.value);
+  const sections = editor.value.helpers.documentSection.exportSectionsToJSON(editor.value);
   console.log('Saving sections to DB:', sections);
 }
 

package-lock.json

@@ -7,7 +7,7 @@
     "shared/*"
   ],
   "scripts": {
-    "test": "vitest --root ./packages/super-editor",
+    "test": "vitest ./packages/superdoc/ ./packages/super-editor/",
     "unzip": "bash packages/super-editor/src/tests/helpers/unzip.sh",
     "dev": "npm --workspace=@harbour-enterprises/superdoc run dev",
     "dev:superdoc": "npm run dev --workspace=packages/superdoc",
@@ -32,7 +32,8 @@
     "pack": "npm run build:super-editor && npm --prefix ./packages/superdoc run pack",
     "prepare": "husky",
     "lint:staged": "lint-staged",
-    "watch": "npm run watch:es --workspace=packages/superdoc"
+    "watch": "npm run watch:es --workspace=packages/superdoc",
+    "check:all": "npm run format && npm run lint:fix && npm --workspace=packages/super-editor run types:build"
   },
   "lint-staged": {
     "*.{js,jsx}": [

package.json

@@ -0,0 +1,3 @@
+coverage/
+dist/
+node_modules/

packages/ooxml-inspector/.gitignore

@@ -0,0 +1,51 @@
+# OOXML Inspector
+
+**OOXML Inspector** is a developer tool + library for working with [Office Open XML (OOXML)](https://en.wikipedia.org/wiki/Office_Open_XML) 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
+
+```bash
+npm install @superdoc-dev/ooxml-inspector
+```
+
+## CLI Usage
+
+```bash
+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
+
+```js
+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

packages/ooxml-inspector/README.md

@@ -0,0 +1,4 @@
+import { childrenOf } from '@superdoc-dev/ooxml-inspector';
+
+const children = childrenOf('w:p');
+console.debug('Children of w:p', children);

packages/ooxml-inspector/example/index.js

@@ -0,0 +1,3 @@
+import { runGenerator } from './src/index.js';
+
+runGenerator();

packages/ooxml-inspector/generator/index.js

@@ -0,0 +1,13 @@
+/**
+ * Auto-assign a prefix for a given target namespace.
+ * @param {string} tns - The target namespace
+ * @param {Object} nsMap - The namespace map
+ * @returns {string} - The assigned prefix
+ */
+export const autoPrefix = (tns, nsMap) => {
+  if (!tns) return 'unknown';
+  if (nsMap[tns]) return nsMap[tns];
+  const newPrefix = 'g' + Object.keys(nsMap).length;
+  nsMap[tns] = newPrefix;
+  return newPrefix;
+};

packages/ooxml-inspector/generator/src/builder/autoprefix.js

@@ -0,0 +1,43 @@
+import { describe, it, expect } from 'vitest';
+import { autoPrefix } from './index.js';
+
+describe('autoPrefix', () => {
+  it('returns "unknown" if tns is falsy', () => {
+    const nsMap = {};
+    expect(autoPrefix('', nsMap)).toBe('unknown');
+    expect(autoPrefix(null, nsMap)).toBe('unknown');
+    expect(autoPrefix(undefined, nsMap)).toBe('unknown');
+  });
+
+  it('returns existing prefix if tns is already in nsMap', () => {
+    const nsMap = { 'http://example.com': 'ex' };
+    const result = autoPrefix('http://example.com', nsMap);
+    expect(result).toBe('ex');
+    expect(nsMap).toEqual({ 'http://example.com': 'ex' }); // unchanged
+  });
+
+  it('assigns a new prefix if tns is not in nsMap', () => {
+    const nsMap = {};
+    const result = autoPrefix('http://new.com', nsMap);
+    expect(result).toBe('g0');
+    expect(nsMap).toEqual({ 'http://new.com': 'g0' });
+  });
+
+  it('assigns incrementing prefixes based on nsMap size', () => {
+    const nsMap = { 'http://one.com': 'g0', 'http://two.com': 'g1' };
+    const result = autoPrefix('http://three.com', nsMap);
+    expect(result).toBe('g2');
+    expect(nsMap).toEqual({
+      'http://one.com': 'g0',
+      'http://two.com': 'g1',
+      'http://three.com': 'g2',
+    });
+  });
+
+  it('does not overwrite existing mapping for different tns', () => {
+    const nsMap = { 'http://foo.com': 'g0' };
+    autoPrefix('http://bar.com', nsMap);
+    expect(nsMap).toHaveProperty('http://foo.com', 'g0');
+    expect(nsMap).toHaveProperty('http://bar.com', 'g1');
+  });
+});