@osimatic/helpers-js 1.4.27 → 1.4.29

package/index.js

@@ -21,7 +21,7 @@ const { HexColor, RgbColor } = require('./draw');
 const { SocialNetwork } = require('./social_network');
 const { sleep, refresh } = require('./util');
 const { chr, ord, trim, empty } = require('./php.min');
-const { NumberFormatter } = require('./number');
+const { NumberFormatter, Rating } = require('./number');
 const { Password } = require('./user');
 
 // exports plugins "maison"
@@ -52,7 +52,7 @@ const { WebSocket } = require('./web_socket');
 
 module.exports = {
 	Array, Object, Number, String,
-	HTTPClient, Cookie, UrlAndQueryString, IBAN, BankCard, AudioMedia, VideoMedia, UserMedia, PersonName, Email, TelephoneNumber, DateTime, DatePeriod, TimestampUnix, SqlDate, SqlTime, SqlDateTime, Duration, File, CSV, Img, FormHelper, Country, PostalAddress, GeographicCoordinates, Polygon, HexColor, RgbColor, SocialNetwork, NumberFormatter, Password,
+	HTTPClient, Cookie, UrlAndQueryString, IBAN, BankCard, AudioMedia, VideoMedia, UserMedia, PersonName, Email, TelephoneNumber, DateTime, DatePeriod, TimestampUnix, SqlDate, SqlTime, SqlDateTime, Duration, File, CSV, Img, FormHelper, Country, PostalAddress, GeographicCoordinates, Polygon, HexColor, RgbColor, SocialNetwork, NumberFormatter, Rating, Password,
 	Browser, DataTable, Pagination, Navigation, DetailsSubArray, SelectAll, MultipleActionInTable, MultipleActionInDivList, MultiFilesInput, EditValue, FormDate, InputPeriod, ShoppingCart, FlashMessage, CountDown, ImportFromCsv, JwtToken, JwtSession, ApiTokenSession, ListBox, WebRTC, WebSocket, EventBus,
 	sleep, refresh, chr, ord, trim, empty,
 	Chartjs, GoogleCharts, GoogleRecaptcha, GoogleMap, OpenStreetMap

package/location.js

@@ -1,4 +1,7 @@
 
+const Address = require('ilib/lib/Address');
+const AddressFmt = require('ilib/lib/AddressFmt');
+
 class Country {
 	static setFlagsPath(flagsPath) {
 		Country.flagsPath = flagsPath;
@@ -356,9 +359,6 @@ class PostalAddress {
 			addressDataForPluging['locality'] = addressData['stateDistrict'];
 		}
 
-		//var Address = require("ilib/js/lib/Address");
-		//var AddressFmt = require("ilib/lib/AddressFmt");
-
 		let af = new AddressFmt();
 		let formattedAddress = af.format(new Address(addressDataForPluging));
 		return formattedAddress.replace(/\n+/g, separator);

package/number.js

@@ -96,4 +96,29 @@ if (!Number.random) {
 	};
 }
 
-module.exports = { NumberFormatter };
+class Rating {
+	static display(rating, maxRating = 5, imgOn = '★', imgOff = '☆', imgHalf = null) {
+		if (rating == null) {
+			return '';
+		}
+
+		const fullStars = Math.floor(rating);
+		const decimal = rating - fullStars;
+
+		let totalFull = fullStars;
+		let showHalf = false;
+
+		if (imgHalf !== null && decimal >= 0.25 && decimal < 0.75) {
+			showHalf = true;
+		}
+		else if (decimal >= (imgHalf !== null ? 0.75 : 0.5)) {
+			totalFull++;
+		}
+
+		return imgOn.repeat(totalFull)
+			+ (showHalf ? imgHalf : '')
+			+ imgOff.repeat(maxRating - totalFull - (showHalf ? 1 : 0));
+	}
+}
+
+module.exports = { NumberFormatter, Rating };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osimatic/helpers-js",
-  "version": "1.4.27",
+  "version": "1.4.29",
   "main": "main.js",
   "scripts": {
     "test": "jest",
@@ -13,7 +13,7 @@
   "license": "ISC",
   "description": "",
   "dependencies": {
-    "ilib": "^14.16.0"
+    "ilib": "^14.21"
   },
   "devDependencies": {
     "jest": "^30.2.0",

package/tests/location.test.js

@@ -1,4 +1,4 @@
-const { Country, GeographicCoordinates, Polygon } = require('../location');
+const { Country, PostalAddress, GeographicCoordinates, Polygon } = require('../location');
 
 describe('Country', () => {
 	describe('getCountries', () => {
@@ -592,4 +592,119 @@ describe('Polygon', () => {
 			expect(lastPoint).toEqual(firstPoint);
 		});
 	});
+});
+
+describe('PostalAddress', () => {
+	describe('format', () => {
+		test('should return a string', () => {
+			const result = PostalAddress.format({
+				streetAddress: '10 Rue de la Paix',
+				postalCode: '75001',
+				locality: 'Paris',
+				countryCode: 'FR',
+			});
+			expect(typeof result).toBe('string');
+		});
+
+		test('should contain streetAddress, postalCode and locality', () => {
+			const result = PostalAddress.format({
+				streetAddress: '10 Rue de la Paix',
+				postalCode: '75001',
+				locality: 'Paris',
+				countryCode: 'FR',
+			});
+			expect(result).toContain('10 Rue de la Paix');
+			expect(result).toContain('75001');
+			expect(result).toContain('Paris');
+		});
+
+		test('should use <br/> as default separator', () => {
+			const result = PostalAddress.format({
+				streetAddress: '10 Rue de la Paix',
+				postalCode: '75001',
+				locality: 'Paris',
+				countryCode: 'FR',
+			});
+			expect(result).toContain('<br/>');
+			expect(result).not.toContain('\n');
+		});
+
+		test('should use custom separator when provided', () => {
+			const result = PostalAddress.format({
+				streetAddress: '10 Rue de la Paix',
+				postalCode: '75001',
+				locality: 'Paris',
+				countryCode: 'FR',
+			}, ', ');
+			expect(result).toContain(', ');
+			expect(result).not.toContain('\n');
+		});
+
+		test('should include additionalAddress on a separate line', () => {
+			const result = PostalAddress.format({
+				streetAddress: '10 Rue de la Paix',
+				additionalAddress: 'Bât. B',
+				postalCode: '75001',
+				locality: 'Paris',
+				countryCode: 'FR',
+			});
+			expect(result).toContain('10 Rue de la Paix');
+			expect(result).toContain('Bât. B');
+		});
+
+		test('should use suburb as locality fallback when locality is null', () => {
+			const result = PostalAddress.format({
+				streetAddress: '5 High Street',
+				postalCode: 'SW1A 1AA',
+				suburb: 'Westminster',
+				countryCode: 'GB',
+			});
+			expect(result).toContain('Westminster');
+		});
+
+		test('should use stateDistrict as locality fallback when locality and suburb are null', () => {
+			const result = PostalAddress.format({
+				streetAddress: '5 High Street',
+				postalCode: 'SW1A 1AA',
+				stateDistrict: 'Greater London',
+				countryCode: 'GB',
+			});
+			expect(result).toContain('Greater London');
+		});
+
+		test('should handle null/undefined optional fields without throwing', () => {
+			expect(() => PostalAddress.format({
+				streetAddress: null,
+				additionalAddress: null,
+				postalCode: null,
+				locality: null,
+				state: null,
+				countryCode: null,
+			})).not.toThrow();
+		});
+
+		test('should handle empty strings for optional fields', () => {
+			expect(() => PostalAddress.format({
+				streetAddress: '',
+				additionalAddress: '',
+				postalCode: '',
+				locality: '',
+				state: '',
+				countryCode: '',
+			})).not.toThrow();
+		});
+
+		test('should include state/region in the formatted address', () => {
+			const result = PostalAddress.format({
+				streetAddress: '1600 Amphitheatre Pkwy',
+				locality: 'Mountain View',
+				state: 'CA',
+				postalCode: '94043',
+				countryCode: 'US',
+			});
+			expect(result).toContain('CA');
+			expect(result).toContain('Mountain View');
+			expect(result).toContain('94043');
+		});
+	});
 });

package/tests/number.test.js

@@ -1,4 +1,49 @@
 require('../number');
+const { Rating } = require('../number');
+
+describe('Rating', () => {
+	describe('display', () => {
+		test('should return empty string for null rating', () => {
+			expect(Rating.display(null)).toBe('');
+		});
+
+		test('should display full stars only', () => {
+			expect(Rating.display(3, 5)).toBe('★★★☆☆');
+		});
+
+		test('should round up at 0.5', () => {
+			expect(Rating.display(3.5, 5)).toBe('★★★★☆');
+		});
+
+		test('should round down below 0.5', () => {
+			expect(Rating.display(3.4, 5)).toBe('★★★☆☆');
+		});
+
+		test('should display max rating', () => {
+			expect(Rating.display(5, 5)).toBe('★★★★★');
+		});
+
+		test('should display zero rating', () => {
+			expect(Rating.display(0, 5)).toBe('☆☆☆☆☆');
+		});
+
+		test('should show half star when imgHalf provided and decimal in [0.25, 0.75)', () => {
+			expect(Rating.display(3.5, 5, '★', '☆', '½')).toBe('★★★½☆');
+		});
+
+		test('should round up with imgHalf when decimal >= 0.75', () => {
+			expect(Rating.display(3.8, 5, '★', '☆', '½')).toBe('★★★★☆');
+		});
+
+		test('should round down with imgHalf when decimal < 0.25', () => {
+			expect(Rating.display(3.1, 5, '&#9733;', '&#9734;', '½')).toBe('&#9733;&#9733;&#9733;&#9734;&#9734;');
+		});
+
+		test('should support custom image strings', () => {
+			expect(Rating.display(2, 3, '[on]', '[off]')).toBe('[on][on][off]');
+		});
+	});
+});
 
 describe('NumberFormatter', () => {
 	const { NumberFormatter } = require('../number');