Initialize #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft

MaverikMinett wants to merge 53 commits into main from initialize

LICENSE

-Original file line number
+Diff line change
@@ -0,0 +1,20 @@
+    MIT License
+    Copyright (c) 2025 Maverik Minett
+    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.

README.md

-Original file line number
+Diff line change
@@ -1,2 +1,36 @@
-    # agape-datetime
-    Date and time parsing and formatting
+    # @agape/datetime
+    Date and time utilities for TypeScript applications.
+    ## ✨ Features
+    - Date manipulation and formatting
+    - Time zone handling
+    - Date arithmetic operations
+    - Date parsing and validation
+    - Relative time calculations
+    ---
+    ## 🚀 Example
+    ```ts
+    import { formatDate, addDays, isWeekend } from '@agape/datetime';
+    const today = new Date();
+    const tomorrow = addDays(today, 1);
+    const formatted = formatDate(today, 'YYYY-MM-DD');
+    console.log(`Today: ${formatted}`);
+    console.log(`Is weekend: ${isWeekend(today)}`);
+    ```
+    ---
+    ## 📚 Documentation
+    See the full API documentation at [agape.dev/api](https://agape.dev/api).
+    ## 📦 Agape Toolkit
+    This package is part of the [Agape Toolkit](https://github.com/AgapeToolkit/AgapeToolkit) - a comprehensive collection of TypeScript utilities and libraries for modern web development.

jest.config.ts

-Original file line number
+Diff line change
@@ -0,0 +1,16 @@
+    /* eslint-disable */
+    export default {
+      displayName: 'agape-datetime',
+      preset: '../../jest.preset.js',
+      globals: {
+        'ts-jest': {
+          tsconfig: '<rootDir>/tsconfig.spec.json',
+        },
+      },
+      testEnvironment: 'node',
+      transform: {
+        '^.+\\.[tj]s$': 'ts-jest',
+      },
+      moduleFileExtensions: ['ts', 'js', 'html'],
+      coverageDirectory: '../../../coverage/libs/datetime',
+    };

package.json

-Original file line number
+Diff line change
@@ -0,0 +1,39 @@
+    {
+      "name": "@agape/datetime",
+      "version": "0.1.0",
+      "description": "Date and time utilities",
+      "main": "./cjs/index.js",
+      "module": "./es2022/index.js",
+      "author": {
+        "name": "Maverik Minett",
+        "email": "maverik.minett@gmail.com"
+      },
+      "license": "MIT",
+      "publishConfig": {
+        "access": "public"
+      },
+      "homepage": "https://agape.dev",
+      "repository": {
+        "type": "git",
+        "url": "https://github.com/AgapeToolkit/AgapeToolkit"
+      },
+      "keywords": [
+        "agape",
+        "datetime",
+        "date",
+        "time"
+      ],
+      "es2022": "./es2022/index.js",
+      "exports": {
+        "./package.json": {
+          "default": "./package.json"
+        },
+        ".": {
+          "es2022": "./es2022/index.js",
+          "node": "./cjs/index.js",
+          "default": "./es2022/index.js",
+          "require": "./cjs/index.js",
+          "import": "./es2022/index.js"
+        }
+      }
+    }

project.json

-Original file line number
+Diff line change
@@ -0,0 +1,47 @@
+    {
+      "name": "datetime",
+      "$schema": "../../node_modules/nx/schemas/project-schema.json",
+      "sourceRoot": "libs/datetime/src",
+      "projectType": "library",
+      "targets": {
+        "build": {
+          "executor": "@nx/js:tsc",
+          "outputs": ["{options.outputPath}"],
+          "options": {
+            "outputPath": "dist/libs/datetime",
+            "main": "libs/datetime/src/index.ts",
+            "tsConfig": "libs/datetime/tsconfig.lib.json",
+            "assets": ["libs/datetime/*.md"]
+          }
+        },
+        "publish": {
+          "executor": "nx:run-commands",
+          "options": {
+            "command": "node tools/scripts/publish.mjs datetime {args.ver} {args.tag}"
+          },
+          "dependsOn": ["build"]
+        },
+        "lint": {
+          "executor": "@nx/linter:eslint",
+          "outputs": ["{options.outputFile}"],
+          "options": {
+            "lintFilePatterns": ["libs/datetime/**/*.ts"]
+          }
+        },
+        "test": {
+          "executor": "@nx/jest:jest",
+          "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
+          "options": {
+            "jestConfig": "libs/datetime/jest.config.ts",
+            "passWithNoTests": true
+          },
+          "configurations": {
+            "ci": {
+              "ci": true,
+              "codeCoverage": true
+            }
+          }
+        }
+      },
+      "tags": []
+    }

src/index.ts

-Original file line number
+Diff line change
@@ -0,0 +1,6 @@
+    // @agape/datetime
+    // Date and time utilities for TypeScript applications
+    export * from './lib/names';
+    export * from './lib/values';
+    export * from './lib/types';

src/lib/names/common-era-names.spec.ts

-Original file line number
+Diff line change
@@ -0,0 +1,159 @@
+    import { CommonEraNames } from './common-era-names';
+    describe('CommonEraNames', () => {
+      const testLocales = ['en-US', 'es-US', 'ru-RU', 'ja-JP', 'de-DE', 'fr-FR', 'en-GB'];
+      const testCases = ['default', 'uppercase', 'lowercase'] as const;
+      describe('get() method', () => {
+        test('should return same instance for same parameters', () => {
+          const instance1 = CommonEraNames.get({ locale: 'en-US', case: 'default' });
+          const instance2 = CommonEraNames.get({ locale: 'en-US', case: 'default' });
+          expect(instance1).toBe(instance2);
+        });
+        test('should return different instances for different parameters', () => {
+          const instance1 = CommonEraNames.get({ locale: 'en-US', case: 'default' });
+          const instance2 = CommonEraNames.get({ locale: 'en-US', case: 'uppercase' });
+          const instance3 = CommonEraNames.get({ locale: 'es-US', case: 'default' });
+          expect(instance1).not.toBe(instance2);
+          expect(instance1).not.toBe(instance3);
+          expect(instance2).not.toBe(instance3);
+        });
+        test('should use default locale when not provided', () => {
+          const instance = CommonEraNames.get();
+          expect(instance.locale).toBeDefined();
+        });
+        test('should use default case when not provided', () => {
+          const instance = CommonEraNames.get({ locale: 'en-US' });
+          expect(instance.case).toBe('default');
+        });
+      });
+      describe('long property', () => {
+        test.each(testLocales)('should return correct long names for locale %s', (locale) => {
+          const instance = CommonEraNames.get({ locale, case: 'default' });
+          const long = instance.long;
+          expect(long).toHaveLength(2);
+          expect(long[0]).toContain('Before');
+          expect(long[1]).toContain('Common');
+        });
+        test.each(testCases)('should handle case %s correctly', (caseType) => {
+          const instance = CommonEraNames.get({ locale: 'en-US', case: caseType });
+          const long = instance.long;
+          expect(long).toHaveLength(2);
+          if (caseType === 'uppercase') {
+            expect(long[0]).toBe(long[0].toUpperCase());
+            expect(long[1]).toBe(long[1].toUpperCase());
+          } else if (caseType === 'lowercase') {
+            expect(long[0]).toBe(long[0].toLowerCase());
+            expect(long[1]).toBe(long[1].toLowerCase());
+          }
+        });
+        test('should use locale-aware case transformation', () => {
+          const instance = CommonEraNames.get({ locale: 'tr-TR', case: 'uppercase' });
+          const long = instance.long;
+          // Turkish has special case rules (İ vs I)
+          expect(long[0]).toContain('BEFORE');
+          expect(long[1]).toContain('COMMON');
+        });
+      });
+      describe('short property', () => {
+        test.each(testLocales)('should return correct short names for locale %s', (locale) => {
+          const instance = CommonEraNames.get({ locale, case: 'default' });
+          const short = instance.short;
+          expect(short).toHaveLength(2);
+          expect(short[0]).toBe('BCE');
+          expect(short[1]).toBe('CE');
+        });
+        test.each(testCases)('should handle case %s correctly', (caseType) => {
+          const instance = CommonEraNames.get({ locale: 'en-US', case: caseType });
+          const short = instance.short;
+          expect(short).toHaveLength(2);
+          if (caseType === 'uppercase') {
+            expect(short[0]).toBe('BCE');
+            expect(short[1]).toBe('CE');
+          } else if (caseType === 'lowercase') {
+            expect(short[0]).toBe('bce');
+            expect(short[1]).toBe('ce');
+          } else {
+            expect(short[0]).toBe('BCE');
+            expect(short[1]).toBe('CE');
+          }
+        });
+      });
+      describe('narrow property', () => {
+        test.each(testLocales)('should return correct narrow names for locale %s', (locale) => {
+          const instance = CommonEraNames.get({ locale, case: 'default' });
+          const narrow = instance.narrow;
+          expect(narrow).toHaveLength(2);
+          expect(narrow[0]).toBe('B');
+          expect(narrow[1]).toBe('C');
+        });
+        test.each(testCases)('should handle case %s correctly', (caseType) => {
+          const instance = CommonEraNames.get({ locale: 'en-US', case: caseType });
+          const narrow = instance.narrow;
+          expect(narrow).toHaveLength(2);
+          if (caseType === 'uppercase') {
+            expect(narrow[0]).toBe('B');
+            expect(narrow[1]).toBe('C');
+          } else if (caseType === 'lowercase') {
+            expect(narrow[0]).toBe('b');
+            expect(narrow[1]).toBe('c');
+          } else {
+            expect(narrow[0]).toBe('B');
+            expect(narrow[1]).toBe('C');
+          }
+        });
+      });
+      describe('caching behavior', () => {
+        test('should cache instances correctly', () => {
+          const instance1 = CommonEraNames.get({ locale: 'en-US', case: 'default' });
+          const instance2 = CommonEraNames.get({ locale: 'en-US', case: 'default' });
+          const instance3 = CommonEraNames.get({ locale: 'en-US', case: 'uppercase' });
+          expect(instance1).toBe(instance2);
+          expect(instance1).not.toBe(instance3);
+        });
+        test('should cache different locales separately', () => {
+          const enInstance = CommonEraNames.get({ locale: 'en-US', case: 'default' });
+          const esInstance = CommonEraNames.get({ locale: 'es-US', case: 'default' });
+          expect(enInstance).not.toBe(esInstance);
+        });
+      });
+      describe('locale property', () => {
+        test.each(testLocales)('should set correct locale %s', (locale) => {
+          const instance = CommonEraNames.get({ locale });
+          expect(instance.locale).toBe(locale);
+        });
+      });
+      describe('case property', () => {
+        test.each(testCases)('should set correct case %s', (caseType) => {
+          const instance = CommonEraNames.get({ locale: 'en-US', case: caseType });
+          expect(instance.case).toBe(caseType);
+        });
+      });
+    });

src/lib/names/common-era-names.ts

-Original file line number
+Diff line change
@@ -0,0 +1,63 @@
+    import { getLocale } from '@agape/locale';
+    import { Names } from './names';
+    import { CommonEraNamesParams } from './types/common-era-names-params';
+    const commonEraNamesRegistry = new Map<string, CommonEraNames>();
+    export class CommonEraNames extends Names {
+      private _long?: readonly string[];
+      private _short?: readonly string[];
+      private _narrow?: readonly string[];
+      get long(): readonly string[] {
+        if (this._long) return this._long;
+        if (this.case === 'default') {
+          this._long = ['Before Common Era', 'Common Era'];
+        } else {
+          const defaultInstance = CommonEraNames.get({ locale: this.locale, case: 'default' });
+          this._long = this.applyCase(defaultInstance.long);
+        }
+        return this._long;
+      }
+      get short(): readonly string[] {
+        if (this._short) return this._short;
+        if (this.case === 'default') {
+          this._short = ['BCE', 'CE'];
+        } else {
+          const defaultInstance = CommonEraNames.get({ locale: this.locale, case: 'default' });
+          this._short = this.applyCase(defaultInstance.short);
+        }
+        return this._short;
+      }
+      get narrow(): readonly string[] {
+        if (this._narrow) return this._narrow;
+        if (this.case === 'default') {
+          this._narrow = ['B', 'C'];
+        } else {
+          const defaultInstance = CommonEraNames.get({ locale: this.locale, case: 'default' });
+          this._narrow = this.applyCase(defaultInstance.narrow);
+        }
+        return this._narrow;
+      }
+      static get(params: CommonEraNamesParams = {}): CommonEraNames {
+        const locale = params.locale ?? getLocale();
+        const caseType = params.case ?? 'default';
+        const key = `${locale}-${caseType}`;
+        const cached = commonEraNamesRegistry.get(key);
+        if (cached) return cached;
+        const created = new CommonEraNames({ locale, case: caseType });
+        commonEraNamesRegistry.set(key, created);
+        return created;
+      }
+    }

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Initialize #1

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!

Initialize #1

Are you sure you want to change the base?

Uh oh!

Initialize #1

Uh oh!

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!