Merge branch 'master' into release

Author: YaroslawEkimov

README.md

@@ -13,6 +13,11 @@ This repository contains Aspose.Words Cloud SDK for PHP source code. This SDK al
 * Watermarks and protection
 * Full read & write access to Document Object Model, including sections, paragraphs, text, images, tables, headers/footers and many others
 
+## Enhancements in Version 24.7
+
+- Added support for azw3 (Amazon Kindle Format) documents.
+
+
 ## Enhancements in Version 24.6
 
 - Added the 'TranslateNodeId' method to transalate a node id to a node path.

composer-test.json

@@ -134,7 +134,7 @@ class Configuration
      * Version of Aspose.Words Cloud API
      *
      */
-    protected $clientVersion = '24.6';
+    protected $clientVersion = '24.7';
 
     /*
      * Stores timeout in seconds
@@ -539,7 +539,7 @@ public static function toDebugReport()
         $report  = 'PHP SDK (Aspose\Words) Debug Report:' . PHP_EOL;
         $report .= '    OS: ' . php_uname() . PHP_EOL;
         $report .= '    PHP Version: ' . PHP_VERSION . PHP_EOL;
-        $report .= '    OpenAPI Spec Version: 24.6' . PHP_EOL;
+        $report .= '    OpenAPI Spec Version: 24.7' . PHP_EOL;
         $report .= '    Temp Folder Path: ' . self::getDefaultConfiguration()->getTempFolderPath() . PHP_EOL;
 
         return $report;

src/Aspose/Words/Configuration.php

@@ -0,0 +1,285 @@
+<?php
+/*
+ * --------------------------------------------------------------------------------
+ * <copyright company="Aspose" file="Azw3SaveOptionsData.php">
+ *   Copyright (c) 2024 Aspose.Words for Cloud
+ * </copyright>
+ * <summary>
+ *   Permission is hereby granted, free of charge, to any person obtaining a copy
+ *  of this software and associated documentation files (the "Software"), to deal
+ *  in the Software without restriction, including without limitation the rights
+ *  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ *  copies of the Software, and to permit persons to whom the Software is
+ *  furnished to do so, subject to the following conditions:
+ * 
+ *  The above copyright notice and this permission notice shall be included in all
+ *  copies or substantial portions of the Software.
+ * 
+ *  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ *  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ *  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ *  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ *  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ *  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ *  SOFTWARE.
+ * </summary>
+ * --------------------------------------------------------------------------------
+ */
+
+namespace Aspose\Words\Model;
+use \Aspose\Words\ObjectSerializer;
+
+/*
+ * Azw3SaveOptionsData
+ *
+ * @description Container class for azw3 save options.
+ */
+class Azw3SaveOptionsData extends HtmlSaveOptionsData
+{
+    const DISCRIMINATOR = null;
+
+    /*
+     * The original name of the model.
+     *
+     * @var string
+     */
+    protected static $swaggerModelName = "Azw3SaveOptionsData";
+
+    /*
+     * Array of property to type mappings. Used for (de)serialization
+     *
+     * @var string[]
+     */
+    protected static $swaggerTypes = [
+        'navigation_map_level' => 'int'
+    ];
+
+    /*
+     * Array of property to format mappings. Used for (de)serialization
+     *
+     * @var string[]
+     */
+    protected static $swaggerFormats = [
+        'navigation_map_level' => 'null'
+    ];
+
+    /*
+     * Array of property to type mappings. Used for (de)serialization
+     *
+     * @return array
+     */
+    public static function swaggerTypes()
+    {
+        return self::$swaggerTypes + parent::swaggerTypes();
+    }
+
+    /*
+     * Array of property to format mappings. Used for (de)serialization
+     *
+     * @return array
+     */
+    public static function swaggerFormats()
+    {
+        return self::$swaggerFormats + parent::swaggerFormats();
+    }
+
+    /*
+     * Array of attributes where the key is the local name,
+     * and the value is the original name
+     *
+     * @var string[]
+     */
+    protected static $attributeMap = [
+        'navigation_map_level' => 'NavigationMapLevel'
+    ];
+
+    /*
+     * Array of attributes to setter functions (for deserialization of responses)
+     *
+     * @var string[]
+     */
+    protected static $setters = [
+        'navigation_map_level' => 'setNavigationMapLevel'
+    ];
+
+    /*
+     * Array of attributes to getter functions (for serialization of requests)
+     *
+     * @var string[]
+     */
+    protected static $getters = [
+        'navigation_map_level' => 'getNavigationMapLevel'
+    ];
+
+    /*
+     * Array of attributes where the key is the local name,
+     * and the value is the original name
+     *
+     * @return array
+     */
+    public static function attributeMap()
+    {
+        return parent::attributeMap() + self::$attributeMap;
+    }
+
+    /*
+     * Array of attributes to setter functions (for deserialization of responses)
+     *
+     * @return array
+     */
+    public static function setters()
+    {
+        return parent::setters() + self::$setters;
+    }
+
+    /*
+     * Array of attributes to getter functions (for serialization of requests)
+     *
+     * @return array
+     */
+    public static function getters()
+    {
+        return parent::getters() + self::$getters;
+    }
+
+    /*
+     * The original name of the model.
+     *
+     * @return string
+     */
+    public function getModelName()
+    {
+        return self::$swaggerModelName;
+    }
+
+
+
+    /*
+     * Constructor
+     *
+     * @param mixed[] $data Associated array of property values
+     *                      initializing the model
+     */
+    public function __construct(array $data = null)
+    {
+        parent::__construct($data);
+        $this->container['navigation_map_level'] = isset($data['navigation_map_level']) ? $data['navigation_map_level'] : null;
+        $this->container['save_format'] = "azw3";
+    }
+
+    /*
+     * Validate all the properties in the model
+     */
+    public function validate()
+    {
+        parent::validate();
+
+    }
+
+    /*
+     * Gets navigation_map_level
+     *
+     * @return int
+     */
+    public function getNavigationMapLevel()
+    {
+        return $this->container['navigation_map_level'];
+    }
+
+    /*
+     * Sets navigation_map_level
+     *
+     * @param int $navigation_map_level Gets or sets the maximum level of headings populated to the navigation map when exporting.
+     *
+     * @return $this
+     */
+    public function setNavigationMapLevel($navigation_map_level)
+    {
+        $this->container['navigation_map_level'] = $navigation_map_level;
+        return $this;
+    }
+
+
+    /*
+     * Returns true if offset exists. False otherwise.
+     *
+     * @param integer $offset Offset
+     *
+     * @return boolean
+     */
+	#[\ReturnTypeWillChange]
+    public function offsetExists($offset)
+    {
+        return isset($this->container[$offset]);
+    }
+
+    /*
+     * Gets offset.
+     *
+     * @param integer $offset Offset
+     *
+     * @return mixed
+     */
+	#[\ReturnTypeWillChange]
+    public function offsetGet($offset)
+    {
+        return isset($this->container[$offset]) ? $this->container[$offset] : null;
+    }
+
+    /*
+     * Sets value based on offset.
+     *
+     * @param integer $offset Offset
+     * @param mixed   $value  Value to be set
+     *
+     * @return void
+     */
+	#[\ReturnTypeWillChange]
+    public function offsetSet($offset, $value)
+    {
+        if (is_null($offset)) {
+            $this->container[] = $value;
+        } else {
+            $this->container[$offset] = $value;
+        }
+    }
+
+    /*
+     * Unsets offset.
+     *
+     * @param integer $offset Offset
+     *
+     * @return void
+     */
+	#[\ReturnTypeWillChange]
+    public function offsetUnset($offset)
+    {
+        unset($this->container[$offset]);
+    }
+
+    /*
+     * Collect all FileReference variables to list
+     */
+    public function collectFilesContent($resultFilesContent)
+    {
+        return $resultFilesContent;
+    }
+
+    /*
+     * Gets the string presentation of the object
+     *
+     * @return string
+     */
+    public function __toString()
+    {
+        if (defined('JSON_PRETTY_PRINT')) { // use JSON pretty print
+            return json_encode(
+                ObjectSerializer::sanitizeForSerialization($this),
+                JSON_PRETTY_PRINT
+            );
+        }
+
+        return json_encode(ObjectSerializer::sanitizeForSerialization($this));
+    }
+}
+

src/Aspose/Words/Model/Azw3SaveOptionsData.php

@@ -199,6 +199,7 @@ public function getModelName()
     const SOURCE_FORMAT_XPS = 'Xps';
     const SOURCE_FORMAT_TIFF = 'Tiff';
     const SOURCE_FORMAT_SVG = 'Svg';
+    const SOURCE_FORMAT_AZW3 = 'Azw3';
 
     /*
      * Gets allowable values of the enum
@@ -228,7 +229,8 @@ public function getSourceFormatAllowableValues()
             self::SOURCE_FORMAT_PDF,
             self::SOURCE_FORMAT_XPS,
             self::SOURCE_FORMAT_TIFF,
-            self::SOURCE_FORMAT_SVG
+            self::SOURCE_FORMAT_SVG,
+            self::SOURCE_FORMAT_AZW3
         ];
     }
 

src/Aspose/Words/Model/Document.php

@@ -289,7 +289,9 @@ public function getModelName()
     const COMPLIANCE_PDF_A2A = 'PdfA2a';
     const COMPLIANCE_PDF_A2U = 'PdfA2u';
     const COMPLIANCE_PDF_A4 = 'PdfA4';
+    const COMPLIANCE_PDF_A4_UA2 = 'PdfA4Ua2';
     const COMPLIANCE_PDF_UA1 = 'PdfUa1';
+    const COMPLIANCE_PDF_UA2 = 'PdfUa2';
     const CUSTOM_PROPERTIES_EXPORT_NONE = 'None';
     const CUSTOM_PROPERTIES_EXPORT_STANDARD = 'Standard';
     const CUSTOM_PROPERTIES_EXPORT_METADATA = 'Metadata';
@@ -331,7 +333,9 @@ public function getComplianceAllowableValues()
             self::COMPLIANCE_PDF_A2A,
             self::COMPLIANCE_PDF_A2U,
             self::COMPLIANCE_PDF_A4,
-            self::COMPLIANCE_PDF_UA1
+            self::COMPLIANCE_PDF_A4_UA2,
+            self::COMPLIANCE_PDF_UA1,
+            self::COMPLIANCE_PDF_UA2
         ];
     }
     /*