fix(types): auto-generate TS types by converting barrel to TypeScript (SD-2261) (#2565)

* fix(types): auto-generate TS types by converting barrel to TypeScript (SD-2261)

Convert super-editor barrel from index.js to index.ts with type re-exports,
replacing the hand-written index.d.ts with types derived from actual source
files. This ensures type declarations always match runtime behavior.

- Rename super-editor/src/index.js → index.ts, add type re-exports
- Delete hand-written index.d.ts (1140 lines of manually maintained types)
- Delete redundant Editor.d.ts sidecar (shadows Editor.ts)
- Add missing types: BoundingRect, BinaryData, UnsupportedContentItem
- Update vite.config.js and package.json entry points
- Expand superdoc barrel with missing runtime exports and JSDoc type re-exports

* fix(types): correct OpenOptions import path and superdoc vite alias

- Move OpenOptions re-export from EditorConfig.js to Editor.js (where
  it's actually defined)
- Update superdoc vite.config.js aliases from index.js to index.ts

* fix(types): add missing type re-exports for backward compat

Add CoreCommandMap, ExtensionCommandMap, and LayoutUpdatePayload to
type re-exports — these were in the old hand-written index.d.ts and
need to remain available for consumers.

* fix(types): fix shim generation for export type re-exports and common subpaths

- Update ensure-types.cjs regex to match `export type { ... } from` in
  addition to `import { ... } from`, so re-exported names like Fragment
  are included in workspace package shims
- Allow @superdoc/common subpath imports (e.g. BasicUpload.vue) to be
  shimmed instead of skipped
- Update public-api test to reference renamed index.ts

* fix(types): include Vue shim in tsconfig and add missing sidecar export

- Add vue-shim.d.ts to super-editor tsconfig include so tsc can resolve
  .vue imports from the renamed index.ts barrel
- Add createOrUpdateTrackedChangeComment to comments-plugin.d.ts sidecar

* test(types): add TS compatibility matrix and fix .ts extension paths

Add typecheck-matrix.mjs that tests consumer types across 9 scenarios:
bundler/node16/nodenext module resolution, strict/loose mode,
headless Node.js usage, and superdoc/super-editor sub-exports.

Fix ensure-types.cjs to convert .ts extensions to .js in generated
.d.ts import paths — vite-plugin-dts preserves .ts from the source
entry point, but consumers need .js for TypeScript resolution.

* fix(types): type CommentsPluginKey and remove dead branch in matrix

- Type CommentsPluginKey as PluginKey instead of any
- Remove duplicated srcErrors === 0 branch in typecheck matrix

* fix(types): delegate runtime exports to v1 barrel, fix type re-export paths

The index.ts was duplicating all imports from editors/v1/index.js with
wrong relative paths (missing editors/v1/ prefix). Use export * from
the v1 barrel for runtime exports and only keep type re-exports with
corrected paths.

* fix(types): add event and parts type re-exports for consumer handlers

Export all types consumers need to type EditorEventMap handlers:
- EditorEvents: Comment, CommentsPayload, CommentLocationsPayload,
  FontsResolvedPayload, PaginationPayload, ListDefinitionsPayload,
  ProtectionChangeSource, EditorEventMap
- Parts: PartChangedEvent, PartId, PartSectionId
- Document API: DocumentProtectionState

* fix(types): export EditorOptions, User, ProseMirrorJSON and all config types

Add all public-facing types consumers need for constructor options,
method params, and configuration: EditorOptions, User, ProseMirrorJSON,
ExportFormat, EditorLifecycleState, ViewOptions, CommentConfig,
CollaborationProvider, LinkPopoverResolver, PermissionParams, etc.

Author: caio-pizzol

packages/super-editor/package.json

@@ -8,7 +8,7 @@
   ],
   "exports": {
     ".": {
-      "source": "./src/index.js",
+      "source": "./src/index.ts",
       "types": "./dist/src/index.d.ts",
       "import": "./dist/super-editor.es.js"
     },
@@ -72,7 +72,7 @@
       "import": "./dist/style.css"
     },
     "./presentation-editor": {
-      "source": "./src/index.js",
+      "source": "./src/index.ts",
       "import": "./dist/super-editor.es.js",
       "types": "./dist/index.d.ts"
     }

packages/super-editor/src/editors/v1/core/Editor.d.ts

@@ -388,6 +388,15 @@ export type RangeRect = {
   height: number;
 };
 
+export type BoundingRect = {
+  top: number;
+  left: number;
+  bottom: number;
+  right: number;
+  width: number;
+  height: number;
+};
+
 export type HeaderFooterMode = 'body' | 'header' | 'footer';
 
 export type HeaderFooterSession = {

packages/super-editor/src/editors/v1/core/presentation-editor/types.ts

@@ -85,6 +85,20 @@ export interface Toolbar {
   [key: string]: unknown;
 }
 
+/**
+ * Binary data accepted by document open/import APIs.
+ */
+export type BinaryData = ArrayBuffer | ArrayBufferView;
+
+/**
+ * Represents an unsupported HTML element dropped during paste.
+ */
+export type UnsupportedContentItem = {
+  tagName: string;
+  outerHTML: string;
+  count: number;
+};
+
 /**
  * Re-export commonly used types
  */

packages/super-editor/src/editors/v1/core/types/EditorTypes.ts

@@ -1 +1,3 @@
-export const CommentsPluginKey: any;
+import type { PluginKey } from 'prosemirror-state';
+export const CommentsPluginKey: PluginKey;
+export function createOrUpdateTrackedChangeComment(options: any): any;