Bump version v0.0.6

- This upgrade the dependencies package version
- Introduce new exported PictureInsertType enumeration

.github/workflows/publish.yml

@@ -8,7 +8,7 @@ jobs:
   publish:
     strategy:
       matrix:
-        go-version: [1.20.x]
+        go-version: [1.22.x]
         os: [ubuntu-latest]
         targetplatform: [x64]
 
@@ -26,7 +26,7 @@ jobs:
         go-version: ${{ matrix.go-version }}
 
     - name: Checkout code
-      uses: actions/checkout@v3
+      uses: actions/checkout@v4
 
     - name: Get dependencies
       working-directory: ./cmd
@@ -39,7 +39,7 @@ jobs:
         GOOS=js GOARCH=wasm GO111MODULE=on go test -exec="$(go env GOROOT)/misc/wasm/go_js_wasm_exec" -v ./... -coverprofile=coverage.txt -covermode=atomic
 
     - name: Codecov
-      uses: codecov/codecov-action@v3
+      uses: codecov/codecov-action@v4
       with:
         directory: ./cmd
         file: coverage.txt

cmd/go.mod

@@ -4,7 +4,7 @@ go 1.18
 
 require (
 	github.com/stretchr/testify v1.8.4
-	github.com/xuri/excelize/v2 v2.8.1
+	github.com/xuri/excelize/v2 v2.8.2-0.20240328083735-ffad7aecb5b9
 	golang.org/x/image v0.15.0
 )
 
@@ -15,9 +15,9 @@ require (
 	github.com/richardlehane/mscfb v1.0.4 // indirect
 	github.com/richardlehane/msoleps v1.0.3 // indirect
 	github.com/xuri/efp v0.0.0-20231025114914-d1ff6096ae53 // indirect
-	github.com/xuri/nfp v0.0.0-20230919160717-d98342af3f05 // indirect
-	golang.org/x/crypto v0.20.0 // indirect
-	golang.org/x/net v0.21.0 // indirect
+	github.com/xuri/nfp v0.0.0-20240318013403-ab9948c2c4a7 // indirect
+	golang.org/x/crypto v0.21.0 // indirect
+	golang.org/x/net v0.22.0 // indirect
 	golang.org/x/text v0.14.0 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )

cmd/go.sum

@@ -13,16 +13,16 @@ github.com/stretchr/testify v1.8.4 h1:CcVxjf3Q8PM0mHUKJCdn+eZZtm5yQwehR5yeSVQQcU
 github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo=
 github.com/xuri/efp v0.0.0-20231025114914-d1ff6096ae53 h1:Chd9DkqERQQuHpXjR/HSV1jLZA6uaoiwwH3vSuF3IW0=
 github.com/xuri/efp v0.0.0-20231025114914-d1ff6096ae53/go.mod h1:ybY/Jr0T0GTCnYjKqmdwxyxn2BQf2RcQIIvex5QldPI=
-github.com/xuri/excelize/v2 v2.8.1 h1:pZLMEwK8ep+CLIUWpWmvW8IWE/yxqG0I1xcN6cVMGuQ=
-github.com/xuri/excelize/v2 v2.8.1/go.mod h1:oli1E4C3Pa5RXg1TBXn4ENCXDV5JUMlBluUhG7c+CEE=
-github.com/xuri/nfp v0.0.0-20230919160717-d98342af3f05 h1:qhbILQo1K3mphbwKh1vNm4oGezE1eF9fQWmNiIpSfI4=
-github.com/xuri/nfp v0.0.0-20230919160717-d98342af3f05/go.mod h1:WwHg+CVyzlv/TX9xqBFXEZAuxOPxn2k1GNHwG41IIUQ=
-golang.org/x/crypto v0.20.0 h1:jmAMJJZXr5KiCw05dfYK9QnqaqKLYXijU23lsEdcQqg=
-golang.org/x/crypto v0.20.0/go.mod h1:Xwo95rrVNIoSMx9wa1JroENMToLWn3RNVrTBpLHgZPQ=
+github.com/xuri/excelize/v2 v2.8.2-0.20240328083735-ffad7aecb5b9 h1:E5SrkqbATPg8t3kj5f8k/o48FM0FZio8Beng3rGdQYI=
+github.com/xuri/excelize/v2 v2.8.2-0.20240328083735-ffad7aecb5b9/go.mod h1:now5ovRPu2yX3nl7XR6yhLgNVGtFh2IM02YbKccI4L8=
+github.com/xuri/nfp v0.0.0-20240318013403-ab9948c2c4a7 h1:hPVCafDV85blFTabnqKgNhDCkJX25eik94Si9cTER4A=
+github.com/xuri/nfp v0.0.0-20240318013403-ab9948c2c4a7/go.mod h1:WwHg+CVyzlv/TX9xqBFXEZAuxOPxn2k1GNHwG41IIUQ=
+golang.org/x/crypto v0.21.0 h1:X31++rzVUdKhX5sWmSOFZxx8UW/ldWx55cbf08iNAMA=
+golang.org/x/crypto v0.21.0/go.mod h1:0BP7YvVV9gBbVKyeTG0Gyn+gZm94bibOW5BjDEYAOMs=
 golang.org/x/image v0.15.0 h1:kOELfmgrmJlw4Cdb7g/QGuB3CvDrXbqEIww/pNtNBm8=
 golang.org/x/image v0.15.0/go.mod h1:HUYqC05R2ZcZ3ejNQsIHQDQiwWM4JBqmm6MKANTp4LE=
-golang.org/x/net v0.21.0 h1:AQyQV4dYCvJ7vGmJyKki9+PBdyvhkSd8EIx/qb0AYv4=
-golang.org/x/net v0.21.0/go.mod h1:bIjVDfnllIU7BJ2DNgfnXvpSvtn8VRwhlsaeUTyUS44=
+golang.org/x/net v0.22.0 h1:9sGLhx7iRIHEiX0oAJ3MRZMUCElJgy7Br1nO+AMN3Tc=
+golang.org/x/net v0.22.0/go.mod h1:JKghWKKOSdJwpW2GEx0Ja7fmaKnMsbu+MWVZTokSYmg=
 golang.org/x/text v0.14.0 h1:ScX5w1eTa3QqT8oi6+ziP7dTV1S2+ALU0bI+0zXKWiQ=
 golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=

cmd/main.go

@@ -190,13 +190,11 @@ func regFuncs() {
 // regConstants register all exported JavaScript functions on the Window ot Global.
 func regConstants() {
 	for name, constant := range map[string]int{
+		// CultureName enumeration
 		"CultureNameUnknown": int(excelize.CultureNameUnknown),
 		"CultureNameEnUS":    int(excelize.CultureNameEnUS),
 		"CultureNameZhCN":    int(excelize.CultureNameZhCN),
-	} {
-		js.Global().Get("excelize").Set(name, constant)
-	}
-	for name, constant := range map[string]int{
+		// FormControlType enumeration
 		"FormControlNote":         int(excelize.FormControlNote),
 		"FormControlButton":       int(excelize.FormControlButton),
 		"FormControlOptionButton": int(excelize.FormControlOptionButton),
@@ -205,10 +203,7 @@ func regConstants() {
 		"FormControlGroupBox":     int(excelize.FormControlGroupBox),
 		"FormControlLabel":        int(excelize.FormControlLabel),
 		"FormControlScrollBar":    int(excelize.FormControlScrollBar),
-	} {
-		js.Global().Get("excelize").Set(name, constant)
-	}
-	for name, constant := range map[string]int{
+		// ChartType enumeration
 		"Area":                        int(excelize.Area),
 		"AreaStacked":                 int(excelize.AreaStacked),
 		"AreaPercentStacked":          int(excelize.AreaPercentStacked),
@@ -264,17 +259,11 @@ func regConstants() {
 		"WireframeContour":            int(excelize.WireframeContour),
 		"Bubble":                      int(excelize.Bubble),
 		"Bubble3D":                    int(excelize.Bubble3D),
-	} {
-		js.Global().Get("excelize").Set(name, constant)
-	}
-	for name, constant := range map[string]int{
+		// ChartLineType enumeration
 		"ChartLineSolid":     int(excelize.ChartLineSolid),
 		"ChartLineNone":      int(excelize.ChartLineNone),
 		"ChartLineAutomatic": int(excelize.ChartLineAutomatic),
-	} {
-		js.Global().Get("excelize").Set(name, constant)
-	}
-	for name, constant := range map[string]int{
+		// ChartDataLabelPositionType enumeration
 		"ChartDataLabelsPositionUnset":      int(excelize.ChartDataLabelsPositionUnset),
 		"ChartDataLabelsPositionBestFit":    int(excelize.ChartDataLabelsPositionBestFit),
 		"ChartDataLabelsPositionBelow":      int(excelize.ChartDataLabelsPositionBelow),
@@ -285,6 +274,10 @@ func regConstants() {
 		"ChartDataLabelsPositionOutsideEnd": int(excelize.ChartDataLabelsPositionOutsideEnd),
 		"ChartDataLabelsPositionRight":      int(excelize.ChartDataLabelsPositionRight),
 		"ChartDataLabelsPositionAbove":      int(excelize.ChartDataLabelsPositionAbove),
+		// PictureInsertType enumeration
+		"PictureInsertTypePlaceOverCells": int(excelize.PictureInsertTypePlaceOverCells),
+		"PictureInsertTypePlaceInCell":    int(excelize.PictureInsertTypePlaceInCell),
+		"PictureInsertTypeDISPIMG":        int(excelize.PictureInsertTypeDISPIMG),
 	} {
 		js.Global().Get("excelize").Set(name, constant)
 	}

package.json

@@ -1,6 +1,6 @@
 {
   "name": "excelize-wasm",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "A pure WebAssembly / Javascript port of Go Excelize library that allow you to write to and read from XLAM / XLSM / XLSX / XLTM / XLTX files",
   "author": "xuri <[email protected]>",
   "homepage": "https://xuri.me/excelize",

src/index.d.ts

@@ -659,13 +659,24 @@ declare module 'excelize-wasm' {
     Paragraph?: RichTextRun[];
   };
 
+  /**
+   * PictureInsertType defines the type of the picture has been inserted into
+   * the worksheet.
+   */
+  export enum PictureInsertType {
+    PictureInsertTypePlaceOverCells,
+    PictureInsertTypePlaceInCell,
+    PictureInsertTypeDISPIMG,
+  }
+
   /**
    * Picture maps the format settings of the picture.
    */
   export type Picture = {
     Extension: string;
     File: Uint8Array;
     Format: GraphicOptions;
+    InsertType: PictureInsertType;
   };
 
   /**
@@ -1556,9 +1567,13 @@ declare module 'excelize-wasm' {
     AddDataValidation(sheet: string, dv: DataValidation): { error: string | null }
 
     /**
-     * AddPictureFromBytes provides the method to add picture in a sheet by
-     * given picture format set (such as offset, scale, aspect ratio setting
-     * and print settings), file base name, extension name and file bytes.
+     * AddPictureFromBytes provides the method to add picture in a sheet by given
+     * picture format set (such as offset, scale, aspect ratio setting and print
+     * settings), file base name, extension name and file bytes, supported image
+     * types: EMF, EMZ, GIF, JPEG, JPG, PNG, SVG, TIF, TIFF, WMF, and WMZ. Note
+     * that this function only supports adding pictures placed over the cells
+     * currently, and doesn't support adding pictures placed in cells or
+     * creating the Kingsoft WPS Office embedded image cells.
      * @param sheet The worksheet name
      * @param cell The cell reference
      * @param name The picture name
@@ -2027,15 +2042,19 @@ declare module 'excelize-wasm' {
 
     /**
      * GetPictures provides a function to get picture meta info and raw content
-     * embed in spreadsheet by given worksheet and cell name.
+     * embed in spreadsheet by given worksheet and cell name. This function
+     * returns the image contents as []byte data types. This function is
+     * concurrency safe. Note that, this function doesn't support getting cell
+     * image inserted by IMAGE formula function currently.
      * @param sheet The worksheet name
      * @param cell The cell reference
      */
     GetPictures(sheet: string, cell: string): { pictures: Picture[], error: string | null }
 
     /**
      * GetPictureCells returns all picture cell references in a worksheet by a
-     * specific worksheet name.
+     * specific worksheet name. Note that, this function doesn't support getting
+     * cell image inserted by IMAGE formula function currently.
      * @param sheet The worksheet name
      */
     GetPictureCells(sheet: string): { cells: string[], error: string | null }