fable 3.1.72 → 3.1.74

package/docs/services/dates.md

@@ -5,17 +5,23 @@ The Dates service provides date manipulation functionality using [day.js](https:
 ## Access
 
 ```javascript
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
 // Auto-instantiated, available directly
-fable.Dates
+console.log('fable.Dates:', typeof fable.Dates);
 ```
 
 ## Direct day.js Access
 
 ```javascript
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
 // Access the day.js library directly
-fable.Dates.dayJS();                           // Current date/time
-fable.Dates.dayJS('2024-01-15');               // Parse a date
-fable.Dates.dayJS('2024-01-15').format('YYYY-MM-DD');
+console.log('Now:',          fable.Dates.dayJS().toISOString());                              // Current date/time
+console.log('Parsed:',       fable.Dates.dayJS('2024-01-15').toISOString());                  // Parse a date
+console.log('Formatted:',    fable.Dates.dayJS('2024-01-15').format('YYYY-MM-DD'));
 ```
 
 ## Pre-loaded Plugins
@@ -37,56 +43,80 @@ All difference methods accept dates as strings, Date objects, or timestamps.
 ### Milliseconds
 
 ```javascript
-fable.Dates.dateMillisecondDifference('2024-01-01', '2024-01-02');
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateMillisecondDifference('2024-01-01', '2024-01-02'));
 // Returns: 86400000
 ```
 
 ### Seconds
 
 ```javascript
-fable.Dates.dateSecondDifference('2024-01-01 00:00:00', '2024-01-01 00:01:30');
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateSecondDifference('2024-01-01 00:00:00', '2024-01-01 00:01:30'));
 // Returns: 90
 ```
 
 ### Minutes
 
 ```javascript
-fable.Dates.dateMinuteDifference('2024-01-01 00:00', '2024-01-01 02:30');
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateMinuteDifference('2024-01-01 00:00', '2024-01-01 02:30'));
 // Returns: 150
 ```
 
 ### Hours
 
 ```javascript
-fable.Dates.dateHourDifference('2024-01-01', '2024-01-02');
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateHourDifference('2024-01-01', '2024-01-02'));
 // Returns: 24
 ```
 
 ### Days
 
 ```javascript
-fable.Dates.dateDayDifference('2024-01-01', '2024-01-15');
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateDayDifference('2024-01-01', '2024-01-15'));
 // Returns: 14
 ```
 
 ### Weeks
 
 ```javascript
-fable.Dates.dateWeekDifference('2024-01-01', '2024-02-01');
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateWeekDifference('2024-01-01', '2024-02-01'));
 // Returns: 4
 ```
 
 ### Months
 
 ```javascript
-fable.Dates.dateMonthDifference('2024-01-01', '2024-06-01');
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateMonthDifference('2024-01-01', '2024-06-01'));
 // Returns: 5
 ```
 
 ### Years
 
 ```javascript
-fable.Dates.dateYearDifference('2020-01-01', '2024-01-01');
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateYearDifference('2020-01-01', '2024-01-01'));
 // Returns: 4
 ```
 
@@ -95,8 +125,11 @@ fable.Dates.dateYearDifference('2020-01-01', '2024-01-01');
 All difference methods accept an optional third parameter to require the end date:
 
 ```javascript
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
 // Returns NaN if end date is not provided
-fable.Dates.dateDayDifference('2024-01-01', null, true);  // Returns NaN
+console.log(fable.Dates.dateDayDifference('2024-01-01', null, true));  // Returns NaN
 ```
 
 ## Date Addition Methods
@@ -104,68 +137,95 @@ fable.Dates.dateDayDifference('2024-01-01', null, true);  // Returns NaN
 ### Add Milliseconds
 
 ```javascript
-fable.Dates.dateAddMilliseconds('2024-01-01T00:00:00.000Z', 5000);
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateAddMilliseconds('2024-01-01T00:00:00.000Z', 5000));
 // Returns: '2024-01-01T00:00:05.000Z'
 ```
 
 ### Add Seconds
 
 ```javascript
-fable.Dates.dateAddSeconds('2024-01-01T00:00:00.000Z', 30);
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateAddSeconds('2024-01-01T00:00:00.000Z', 30));
 // Returns: '2024-01-01T00:00:30.000Z'
 ```
 
 ### Add Minutes
 
 ```javascript
-fable.Dates.dateAddMinutes('2024-01-01T00:00:00.000Z', 45);
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateAddMinutes('2024-01-01T00:00:00.000Z', 45));
 // Returns: '2024-01-01T00:45:00.000Z'
 ```
 
 ### Add Hours
 
 ```javascript
-fable.Dates.dateAddHours('2024-01-01T00:00:00.000Z', 3);
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateAddHours('2024-01-01T00:00:00.000Z', 3));
 // Returns: '2024-01-01T03:00:00.000Z'
 ```
 
 ### Add Days
 
 ```javascript
-fable.Dates.dateAddDays('2024-01-01', 10);
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateAddDays('2024-01-01', 10));
 // Returns: '2024-01-11T00:00:00.000Z'
 ```
 
 ### Add Weeks
 
 ```javascript
-fable.Dates.dateAddWeeks('2024-01-01', 2);
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateAddWeeks('2024-01-01', 2));
 // Returns: '2024-01-15T00:00:00.000Z'
 ```
 
 ### Add Months
 
 ```javascript
-fable.Dates.dateAddMonths('2024-01-15', 3);
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateAddMonths('2024-01-15', 3));
 // Returns: '2024-04-15T00:00:00.000Z'
 ```
 
 ### Add Years
 
 ```javascript
-fable.Dates.dateAddYears('2024-01-01', 5);
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateAddYears('2024-01-01', 5));
 // Returns: '2029-01-01T00:00:00.000Z'
 ```
 
 ## Generic Date Math
 
 ```javascript
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
 // Add operation
-fable.Dates.dateMath('2024-01-01', 5, 'day', 'add');
+console.log(fable.Dates.dateMath('2024-01-01', 5, 'day', 'add'));
 // Returns: '2024-01-06T00:00:00.000Z'
 
 // Subtract operation
-fable.Dates.dateMath('2024-01-15', 10, 'day', 'subtract');
+console.log(fable.Dates.dateMath('2024-01-15', 10, 'day', 'subtract'));
 // Returns: '2024-01-05T00:00:00.000Z'
 
 // Valid units: 'millisecond', 'second', 'minute', 'hour', 'day', 'week', 'month', 'year'
@@ -174,8 +234,11 @@ fable.Dates.dateMath('2024-01-15', 10, 'day', 'subtract');
 ## Create Date from Parts
 
 ```javascript
-fable.Dates.dateFromParts(2024, 6, 15);                    // June 15, 2024
-fable.Dates.dateFromParts(2024, 6, 15, 14, 30, 0, 0);     // June 15, 2024 2:30 PM
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
+console.log(fable.Dates.dateFromParts(2024, 6, 15));                    // June 15, 2024
+console.log(fable.Dates.dateFromParts(2024, 6, 15, 14, 30, 0, 0));     // June 15, 2024 2:30 PM
 // Returns: ISO string like '2024-06-15T14:30:00.000Z'
 ```
 
@@ -184,23 +247,26 @@ fable.Dates.dateFromParts(2024, 6, 15, 14, 30, 0, 0);     // June 15, 2024 2:30
 For more complex operations, use the day.js library directly:
 
 ```javascript
+const libFable = require('fable');
+const fable = new libFable({ Product: 'DatesDemo', ProductVersion: '1.0.0' });
+
 const dayjs = fable.Dates.dayJS;
 
 // Format dates
-dayjs().format('YYYY-MM-DD HH:mm:ss');
+console.log('Formatted now:',  dayjs().format('YYYY-MM-DD HH:mm:ss'));
 
 // Relative time
-dayjs('2024-01-01').fromNow();  // "3 months ago"
+console.log('fromNow:',        dayjs('2024-01-01').fromNow());
 
 // Timezone support
-dayjs().tz('America/New_York');
+console.log('NY time:',        dayjs().tz('America/New_York').format('YYYY-MM-DD HH:mm:ss z'));
 
 // Week operations
-dayjs().week();      // Week of year
-dayjs().isoWeek();   // ISO week
+console.log('Week of year:',   dayjs().week());
+console.log('ISO week:',       dayjs().isoWeek());
 
 // UTC mode
-dayjs.utc('2024-01-01');
+console.log('UTC date:',       dayjs.utc('2024-01-01').toISOString());
 ```
 
 ## Adding Locales
@@ -208,9 +274,10 @@ dayjs.utc('2024-01-01');
 Day.js supports localization. You can add locales as needed:
 
 ```javascript
-const localeDE = require('dayjs/locale/de');
-fable.Dates.dayJS.locale('de');
-
-// Now dates format in German
-fable.Dates.dayJS().format('MMMM');  // "Januar"
+// Node.js reference — requires loading dayjs locale packages which are not bundled in the browser playground.
+console.info("In Node.js:");
+console.info("    const localeDE = require('dayjs/locale/de');");
+console.info("    fable.Dates.dayJS.locale('de');");
+console.info("    fable.Dates.dayJS().format('MMMM');  // -> 'Januar'");
 ```
+

package/docs/services/environment-data.md

@@ -5,8 +5,11 @@ The EnvironmentData service identifies the runtime environment (Node.js or brows
 ## Access
 
 ```javascript
+const libFable = require('fable');
+const fable = new libFable({ Product: 'EnvironmentDataDemo', ProductVersion: '1.0.0' });
+
 // Auto-instantiated, available directly
-fable.EnvironmentData
+console.log('fable.EnvironmentData:', fable.EnvironmentData);
 ```
 
 ## Available Properties
@@ -14,7 +17,10 @@ fable.EnvironmentData
 ### Environment
 
 ```javascript
-fable.EnvironmentData.Environment
+const libFable = require('fable');
+const fable = new libFable({ Product: 'EnvironmentDataDemo', ProductVersion: '1.0.0' });
+
+console.log('Environment:', fable.EnvironmentData.Environment);
 // Returns 'node.js' in Node.js
 // Returns 'web' in the browser
 ```
@@ -31,10 +37,15 @@ Fable automatically uses the appropriate implementation:
 ### Environment-Specific Behavior
 
 ```javascript
+const libFable = require('fable');
+const fable = new libFable({ Product: 'EnvironmentDataDemo', ProductVersion: '1.0.0' });
+
 if (fable.EnvironmentData.Environment === 'node.js') {
     // Node.js-specific code (e.g., file system access)
+    console.log('Running in Node.js — file system access available');
 } else {
     // Browser-specific code (e.g., DOM manipulation)
+    console.log('Running in browser — Environment is:', fable.EnvironmentData.Environment);
 }
 ```