@cj-tech-master/excelts 9.4.0 → 9.4.1

package/dist/types/index.browser.d.ts

@@ -11,6 +11,7 @@ export { Range } from "./modules/excel/range.js";
 export { Image } from "./modules/excel/image.js";
 export * from "./modules/excel/anchor.js";
 export { Table } from "./modules/excel/table.js";
+export { Note } from "./modules/excel/note.js";
 export { DataValidations } from "./modules/excel/data-validations.js";
 export { FormCheckbox } from "./modules/excel/form-control.js";
 export * from "./modules/excel/enums.js";

package/dist/types/index.d.ts

@@ -7,6 +7,7 @@ export { Range } from "./modules/excel/range.js";
 export { Image } from "./modules/excel/image.js";
 export * from "./modules/excel/anchor.js";
 export { Table } from "./modules/excel/table.js";
+export { Note } from "./modules/excel/note.js";
 export { DataValidations } from "./modules/excel/data-validations.js";
 export { FormCheckbox } from "./modules/excel/form-control.js";
 export { WorkbookWriter } from "./modules/excel/stream/workbook-writer.js";

package/dist/types/modules/excel/cell.d.ts

@@ -47,6 +47,7 @@ export interface NoteConfig {
 export interface NoteModel {
     type: string;
     note: NoteConfig;
+    author?: string;
 }
 export interface CellModel {
     address: string;

package/dist/types/modules/excel/note.d.ts

@@ -1,29 +1,9 @@
-import type { Font } from "./types.js";
-interface NoteText {
-    text: string;
-    font?: Partial<Font>;
-}
-interface NoteConfig {
-    margins?: {
-        insetmode?: string;
-        inset?: number[];
-    };
-    protection?: {
-        locked?: string;
-        lockText?: string;
-    };
-    editAs?: string;
-    texts?: NoteText[];
-    anchor?: string;
-}
-interface NoteModel {
-    type: string;
-    note: NoteConfig;
-}
+import type { NoteConfig, NoteModel } from "./cell.js";
 declare class Note {
     note: string | NoteConfig | undefined;
+    author: string | undefined;
     static readonly DEFAULT_CONFIGS: NoteModel;
-    constructor(note?: string | NoteConfig);
+    constructor(note?: string | NoteConfig, author?: string);
     get model(): NoteModel;
     set model(value: NoteModel);
     static fromModel(model: NoteModel): Note;

package/dist/types/modules/excel/utils/ooxml-paths.d.ts

@@ -23,7 +23,11 @@ export declare function getDrawingNameFromPath(path: string): string | undefined
 export declare function getDrawingNameFromRelsPath(path: string): string | undefined;
 export declare function getVmlDrawingNameFromPath(path: string): string | undefined;
 export declare function getVmlDrawingHFNameFromPath(path: string): string | undefined;
-export declare function getCommentsIndexFromPath(path: string): string | undefined;
+/**
+ * Check if a zip entry path is a comments XML file.
+ * Works for both `xl/comments1.xml` and `xl/comments/comment1.xml`.
+ */
+export declare function isCommentsPath(path: string): boolean;
 export declare function getTableNameFromPath(path: string): string | undefined;
 export declare function getPivotTableNameFromPath(path: string): string | undefined;
 export declare function getPivotTableNameFromRelsPath(path: string): string | undefined;
@@ -59,6 +63,7 @@ export declare function pivotCacheDefinitionRelsPath(n: number | string): string
 export declare function pivotCacheRecordsPath(n: number | string): string;
 export declare function pivotCacheRecordsRelTarget(n: number | string): string;
 export declare function pivotTablePath(n: number | string): string;
+export declare function pivotTablePathFromName(name: string): string;
 export declare function pivotTableRelsPath(n: number | string): string;
 export declare function externalLinkPath(n: number | string): string;
 export declare function externalLinkRelsPath(n: number | string): string;
@@ -80,12 +85,19 @@ export declare function commentsRelTargetFromWorksheet(sheetId: number | string)
 export declare function vmlDrawingRelTargetFromWorksheet(sheetId: number | string): string;
 export declare function vmlDrawingHFRelTargetFromWorksheet(sheetId: number | string): string;
 export declare function drawingRelTargetFromWorksheet(drawingName: string): string;
-export declare function vmlDrawingRelTargetFromWorksheetName(vmlName: string): string;
-export declare function commentsRelTargetFromWorksheetName(commentName: string): string;
 export declare function pivotTableRelTargetFromWorksheet(n: number | string): string;
-export declare function pivotTableRelTargetFromWorksheetName(pivotName: string): string;
 export declare function tableRelTargetFromWorksheet(target: string): string;
-export declare function tableRelTargetFromWorksheetName(name: string): string;
 export declare function mediaRelTargetFromRels(filename: string): string;
 export declare function ctrlPropPath(id: number | string): string;
 export declare function ctrlPropRelTargetFromWorksheet(id: number | string): string;
+/**
+ * Resolve a relationship Target (relative or absolute) to a normalized zip path.
+ *
+ * OOXML relationship targets may be:
+ *   - Relative: `../comments1.xml` (resolved against `baseDir`)
+ *   - Absolute: `/xl/comments/comment1.xml` (leading slash stripped)
+ *
+ * @param baseDir  The directory containing the source part (e.g. `xl/worksheets/`)
+ * @param target   The raw Target value from the .rels file
+ */
+export declare function resolveRelTarget(baseDir: string, target: string): string;

package/dist/types/modules/excel/xlsx/xform/comment/comments-xform.d.ts

@@ -8,6 +8,14 @@ declare class CommentsXform extends BaseXform<CommentsModel> {
         [key: string]: CommentXform;
     };
     parser: any;
+    /** Authors collected while parsing the <authors> element. */
+    private _authors;
+    /** Whether we are currently inside the <authors> element. */
+    private _inAuthors;
+    /** Whether we are currently inside an <author> element (collecting text). */
+    private _inAuthor;
+    /** Accumulator for the current <author> text content. */
+    private _currentAuthor;
     constructor();
     render(xmlStream: any, model?: CommentsModel): void;
     parseOpen(node: any): boolean;

package/dist/types/modules/excel/xlsx/xform/comment/vml-client-data-xform.d.ts

@@ -7,6 +7,8 @@ interface ClientDataModel {
     anchor: any;
     protection: Protection;
     editAs: string;
+    row?: number;
+    col?: number;
 }
 interface RenderModel {
     note: {
@@ -23,6 +25,10 @@ declare class VmlClientDataXform extends BaseXform<ClientDataModel> {
         [key: string]: any;
     };
     parser: any;
+    /** Name of the current simple leaf element being parsed (e.g. "x:Row"). */
+    private _leafName;
+    /** Accumulated text for the current leaf element. */
+    private _leafText;
     constructor();
     get tag(): string;
     render(xmlStream: any, model: RenderModel): void;

package/dist/types/modules/excel/xlsx/xlsx.browser.d.ts

@@ -338,8 +338,8 @@ declare class XLSX {
         subtotal?: string;
     }>, defaultMetric: PivotTableSubtotal): PivotTableSubtotal[];
     _processWorksheetEntry(stream: IParseStream, model: any, sheetNo: number, options: XlsxOptions | undefined, path: string): Promise<void>;
-    _processCommentEntry(stream: IParseStream, model: any, name: string): Promise<void>;
-    _processTableEntry(stream: IParseStream, model: any, name: string): Promise<void>;
+    _processCommentEntry(stream: IParseStream, model: any, zipPath: string): Promise<void>;
+    _processTableEntry(stream: IParseStream, model: any, zipPath: string): Promise<void>;
     _processWorksheetRelsEntry(stream: IParseStream, model: any, sheetNo: number): Promise<void>;
     _processMediaEntry(stream: IParseStream, model: any, filename: string): Promise<void>;
     /**
@@ -352,7 +352,7 @@ declare class XLSX {
      */
     _processDrawingEntry(stream: IParseStream, model: any, name: string, rawData?: Uint8Array): Promise<void>;
     _processDrawingRelsEntry(entry: any, model: any, name: string): Promise<void>;
-    _processVmlDrawingEntry(entry: any, model: any, name: string): Promise<void>;
+    _processVmlDrawingEntry(entry: any, model: any, zipPath: string): Promise<void>;
     _processVmlDrawingHFEntry(entry: any, model: any, _name: string): Promise<void>;
     _processThemeEntry(stream: IParseStream, model: any, name: string): Promise<void>;
     _processPivotTableEntry(stream: IParseStream, model: any, name: string): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cj-tech-master/excelts",
-  "version": "9.4.0",
+  "version": "9.4.1",
   "description": "Zero-dependency TypeScript toolkit — Excel (XLSX), PDF, CSV, Markdown, XML, ZIP/TAR, and streaming.",
   "keywords": [
     "archive",
@@ -200,7 +200,7 @@
   "devDependencies": {
     "@rspack/core": "^1.7.11",
     "@types/node": "^25.6.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260418.1",
+    "@typescript/native-preview": "^7.0.0-dev.20260420.1",
     "@vitest/browser": "^4.1.4",
     "@vitest/browser-playwright": "^4.1.4",
     "@vitest/ui": "^4.1.4",
@@ -209,8 +209,8 @@
     "esbuild": "^0.28.0",
     "fast-xml-parser": "^5.7.1",
     "husky": "^9.1.7",
-    "oxfmt": "^0.45.0",
-    "oxlint": "^1.60.0",
+    "oxfmt": "^0.46.0",
+    "oxlint": "^1.61.0",
     "oxlint-tsgolint": "latest",
     "playwright": "^1.59.1",
     "rimraf": "^6.1.3",