x4js 1.5.14 → 1.5.15

package/lib/cjs/form.js

@@ -271,7 +271,8 @@ class Form extends layout_1.VLayout {
         return (0, request_1.ajaxRequest)(cfg);
     }
     /**
-     *
+     * to be abble to see the dirty flag, you need to call this method
+     * cf. isDirty, setDirty
      */
     watchChanges() {
         if (this.dom) {
@@ -287,9 +288,15 @@ class Form extends layout_1.VLayout {
             this.m_watchChanges = true;
         }
     }
+    /**
+     * cf. watchChanges
+     */
     setDirty(set = true) {
         this.m_dirty = set;
     }
+    /**
+     * cf. watchChanges
+     */
     isDirty() {
         return this.m_dirty;
     }

package/lib/cjs/spreadsheet.js

@@ -99,8 +99,14 @@ class Spreadsheet extends layout_1.VLayout {
         this.m_columns[col].title = title;
         this.update(10);
     }
+    /**
+     * reset the spreadsheet
+     * @param columns
+     */
     reset(columns) {
-        this.m_columns = columns;
+        if (columns) {
+            this.m_columns = columns;
+        }
         this.m_cells_data = new Map();
         this.m_rows_data = new Map();
         this.update(10);

package/lib/cjs/svgcomponent.js

@@ -312,9 +312,6 @@ class SVGShape extends SVGItem {
         super(tag);
     }
 }
-/**
- *
- */
 class SVGGradient extends SVGItem {
     constructor(x1, y1, x2, y2) {
         super('linearGradient');
@@ -379,7 +376,20 @@ class SVGGroup extends SVGItem {
         this.m_items.push(shape);
         return shape;
     }
-    gradient(x1, y1, x2, y2) {
+    /**
+     *
+     * example
+     * ```ts
+     * const g = c.linear_gradient( '0%', '0%', '0%', '100%' )
+     * 				.addStop( 0, 'red' )
+     * 				.addStop( 100, 'green' );
+     *
+     * p.rect( 0, 0, 100, 100 )
+     * 		.stroke( g.id );
+     *
+     * ```
+     */
+    linear_gradient(x1, y1, x2, y2) {
         const grad = new SVGGradient(x1, y1, x2, y2);
         this.m_items.push(grad);
         return grad;

package/lib/cjs/version.js

@@ -29,4 +29,4 @@
 **/
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.x4js_version = void 0;
-exports.x4js_version = "1.5.14";
+exports.x4js_version = "1.5.15";

package/lib/esm/form.js

@@ -272,7 +272,8 @@ export class Form extends VLayout {
         return ajaxRequest(cfg);
     }
     /**
-     *
+     * to be abble to see the dirty flag, you need to call this method
+     * cf. isDirty, setDirty
      */
     watchChanges() {
         if (this.dom) {
@@ -288,9 +289,15 @@ export class Form extends VLayout {
             this.m_watchChanges = true;
         }
     }
+    /**
+     * cf. watchChanges
+     */
     setDirty(set = true) {
         this.m_dirty = set;
     }
+    /**
+     * cf. watchChanges
+     */
     isDirty() {
         return this.m_dirty;
     }

package/lib/esm/spreadsheet.js

@@ -116,8 +116,14 @@ export class Spreadsheet extends VLayout {
         this.m_columns[col].title = title;
         this.update(10);
     }
+    /**
+     * reset the spreadsheet
+     * @param columns
+     */
     reset(columns) {
-        this.m_columns = columns;
+        if (columns) {
+            this.m_columns = columns;
+        }
         this.m_cells_data = new Map();
         this.m_rows_data = new Map();
         this.update(10);

package/lib/esm/svgcomponent.js

@@ -314,9 +314,6 @@ class SVGShape extends SVGItem {
         super(tag);
     }
 }
-/**
- *
- */
 class SVGGradient extends SVGItem {
     static g_id = 1;
     m_id;
@@ -384,7 +381,20 @@ class SVGGroup extends SVGItem {
         this.m_items.push(shape);
         return shape;
     }
-    gradient(x1, y1, x2, y2) {
+    /**
+     *
+     * example
+     * ```ts
+     * const g = c.linear_gradient( '0%', '0%', '0%', '100%' )
+     * 				.addStop( 0, 'red' )
+     * 				.addStop( 100, 'green' );
+     *
+     * p.rect( 0, 0, 100, 100 )
+     * 		.stroke( g.id );
+     *
+     * ```
+     */
+    linear_gradient(x1, y1, x2, y2) {
         const grad = new SVGGradient(x1, y1, x2, y2);
         this.m_items.push(grad);
         return grad;

package/lib/esm/version.js

@@ -26,4 +26,4 @@
 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 **/
-export const x4js_version = "1.5.14";
+export const x4js_version = "1.5.15";

package/lib/src/form.ts

@@ -337,7 +337,8 @@ export class Form<T extends FormProps = FormProps, E extends FormEventMap = Form
 	}
 
 	/**
-	 * 
+	 * to be abble to see the dirty flag, you need to call this method
+	 * cf. isDirty, setDirty
 	 */
 
 	watchChanges() {
@@ -356,10 +357,18 @@ export class Form<T extends FormProps = FormProps, E extends FormEventMap = Form
 		}
 	}
 
+	/**
+	 * cf. watchChanges
+	 */
+
 	setDirty(set = true) {
 		this.m_dirty = set;
 	}
 
+	/**
+	 * cf. watchChanges
+	 */
+
 	isDirty() {
 		return this.m_dirty;
 	}

package/lib/src/spreadsheet.ts

@@ -192,8 +192,15 @@ export class Spreadsheet extends VLayout<SpreadsheetProps, SpreadsheetEventSet>
 		this.update(10);
 	}
 
-	reset(columns: ColProp[]) {
-		this.m_columns = columns;
+	/**
+	 * reset the spreadsheet
+	 * @param columns 
+	 */
+	reset(columns?: ColProp[]) {
+		if( columns ) {
+			this.m_columns = columns;
+		}
+		
 		this.m_cells_data = new Map<number, CellData>();
 		this.m_rows_data = new Map<number, string>();
 		this.update(10);

package/lib/src/svgcomponent.ts

@@ -383,14 +383,16 @@ class SVGShape extends SVGItem {
  * 
  */
 
+type number_or_perc = number | `${string}%`
+
 class SVGGradient extends SVGItem {
 
 	private static g_id = 1;
 
 	private m_id: string;
-	private m_stops: { offset: number, color: string } [];
+	private m_stops: { offset: number_or_perc, color: string } [];
 
-	constructor( x1: number, y1: number, x2: number, y2: number ) {
+	constructor( x1: number_or_perc, y1: number_or_perc, x2: number_or_perc, y2: number_or_perc ) {
 		super( 'linearGradient')
 		
 		this.m_id = 'gx-'+SVGGradient.g_id;
@@ -408,7 +410,7 @@ class SVGGradient extends SVGItem {
 		return 'url(#'+this.m_id+')';
 	}
 
-	addStop( offset: number, color: string ): this {
+	addStop( offset: number_or_perc, color: string ): this {
 		this.m_stops.push( {offset,color} );
 		return this;
 	}
@@ -469,7 +471,21 @@ class SVGGroup extends SVGItem {
 		return shape;
 	}
 
-	gradient( x1, y1, x2, y2 ) {
+	/**
+	 * 
+	 * example
+	 * ```ts
+	 * const g = c.linear_gradient( '0%', '0%', '0%', '100%' )
+	 * 				.addStop( 0, 'red' )
+	 * 				.addStop( 100, 'green' );
+	 * 
+	 * p.rect( 0, 0, 100, 100 )
+	 * 		.stroke( g.id );
+	 * 
+	 * ```
+	 */
+
+	linear_gradient( x1: number_or_perc, y1: number_or_perc, x2: number_or_perc, y2: number_or_perc ) {
 		const grad = new SVGGradient( x1, y1, x2, y2 );
 		this.m_items.push( grad );
 		return grad;

package/lib/src/version.ts

@@ -27,4 +27,4 @@
 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 **/
 
-export const x4js_version = "1.5.14";
+export const x4js_version = "1.5.15";

package/lib/types/form.d.ts

@@ -118,9 +118,16 @@ export declare class Form<T extends FormProps = FormProps, E extends FormEventMa
      */
     submit(cfg: RequestProps, cbvalidation: Function): false | Function;
     /**
-     *
+     * to be abble to see the dirty flag, you need to call this method
+     * cf. isDirty, setDirty
      */
     watchChanges(): void;
+    /**
+     * cf. watchChanges
+     */
     setDirty(set?: boolean): void;
+    /**
+     * cf. watchChanges
+     */
     isDirty(): boolean;
 }

package/lib/types/spreadsheet.d.ts

@@ -95,7 +95,11 @@ export declare class Spreadsheet extends VLayout<SpreadsheetProps, SpreadsheetEv
     setColWidth(col: number, width: number): void;
     getColWidth(col: number): number;
     setColTitle(col: number, title: string): void;
-    reset(columns: ColProp[]): void;
+    /**
+     * reset the spreadsheet
+     * @param columns
+     */
+    reset(columns?: ColProp[]): void;
     /**
      * insert a row
      * @param before row number before wich insert the new row

package/lib/types/svgcomponent.d.ts

@@ -153,13 +153,14 @@ declare class SVGShape extends SVGItem {
 /**
  *
  */
+type number_or_perc = number | `${string}%`;
 declare class SVGGradient extends SVGItem {
     private static g_id;
     private m_id;
     private m_stops;
-    constructor(x1: number, y1: number, x2: number, y2: number);
+    constructor(x1: number_or_perc, y1: number_or_perc, x2: number_or_perc, y2: number_or_perc);
     get id(): string;
-    addStop(offset: number, color: string): this;
+    addStop(offset: number_or_perc, color: string): this;
     renderContent(): string;
 }
 /**
@@ -172,7 +173,20 @@ declare class SVGGroup extends SVGItem {
     text(x: any, y: any, txt: any): SVGText;
     ellipse(x: any, y: any, r1: any, r2?: any): SVGShape;
     rect(x: any, y: any, w: any, h: any): SVGShape;
-    gradient(x1: any, y1: any, x2: any, y2: any): SVGGradient;
+    /**
+     *
+     * example
+     * ```ts
+     * const g = c.linear_gradient( '0%', '0%', '0%', '100%' )
+     * 				.addStop( 0, 'red' )
+     * 				.addStop( 100, 'green' );
+     *
+     * p.rect( 0, 0, 100, 100 )
+     * 		.stroke( g.id );
+     *
+     * ```
+     */
+    linear_gradient(x1: number_or_perc, y1: number_or_perc, x2: number_or_perc, y2: number_or_perc): SVGGradient;
     /**
      * clear
      */

package/lib/types/version.d.ts

@@ -26,4 +26,4 @@
 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 **/
-export declare const x4js_version = "1.5.14";
+export declare const x4js_version = "1.5.15";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "x4js",
-	"version": "1.5.14",
+	"version": "1.5.15",
 	"description": "X4js core files",
 	"main": "lib/cjs/index.js",
 	"types": "lib/types/index.d.ts",