Version 2.0

Co-authored-by: Copilot <copilot@github.com>

Author: MADEVAL

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

.github/workflows/minify.yml

@@ -1,4 +1,4 @@
-name: Build and Minify
+name: Build, Test and Minify
 
 on:
   push:
@@ -11,36 +11,48 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
 
     - name: Setup Node.js
-      uses: actions/setup-node@v3
+      uses: actions/setup-node@v4
       with:
-        node-version: '16'
-        # Удаляем опцию cache, которая вызывает ошибку
-        # cache: 'npm'
+        node-version: '20'
+        cache: 'npm'
 
     - name: Install dependencies
       run: npm install
 
-    - name: Minify GStime.js
+    - name: Run tests
+      run: npm test
+
+    - name: Build minified bundle
       run: npm run build
 
+    - name: Report bundle size
+      run: npm run size
+
     - name: Commit minified file
-      uses: stefanzweifel/git-auto-commit-action@v4
+      if: github.event_name == 'push'
+      uses: stefanzweifel/git-auto-commit-action@v5
       with:
         commit_message: "Build: Minify GStime.js"
-        file_pattern: 'GStime.min.js'
+        file_pattern: 'GStime.min.js GStime.min.js.map'
 
     - name: Send success message to Telegram
-      if: success()
+      if: success() && env.TELEGRAM_BOT_TOKEN != ''
+      env:
+        TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
+        TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}
       run: |
-          curl -X POST "https://api.telegram.org/bot${{ secrets.TELEGRAM_BOT_TOKEN }}/sendMessage" \
-                  -d chat_id="${{ secrets.TELEGRAM_CHAT_ID }}" \
+          curl -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
+                  -d chat_id="${TELEGRAM_CHAT_ID}" \
                   -d text="🟢 $GITHUB_REPOSITORY [${{ github.event.pusher.name }}] - OK"
     - name: Send error message to Telegram
-      if: failure()
+      if: failure() && env.TELEGRAM_BOT_TOKEN != ''
+      env:
+        TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
+        TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}
       run: |
-          curl -X POST "https://api.telegram.org/bot${{ secrets.TELEGRAM_BOT_TOKEN }}/sendMessage" \
-          -d chat_id="${{ secrets.TELEGRAM_CHAT_ID }}" \
+          curl -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
+          -d chat_id="${TELEGRAM_CHAT_ID}" \
           -d text="🔴 $GITHUB_REPOSITORY [${{ github.event.pusher.name }}] - ERROR"   

.gitignore

@@ -0,0 +1,28 @@
+# Node
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+.pnpm-store/
+
+# Build / coverage
+coverage/
+.nyc_output/
+*.tsbuildinfo
+
+# Editor / OS
+.vscode/
+.idea/
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+
+# Env
+.env
+.env.local
+.env.*.local
+
+# Vitest
+.vitest-cache/

.npmignore

@@ -0,0 +1,13 @@
+.git
+.github
+node_modules
+examples
+tests
+scripts
+coverage
+*.log
+.vscode
+.editorconfig
+.eslintrc*
+.prettierrc*
+README_*.md

CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [2.0.0]
+
+### Breaking
+- `createHTML(html)` now returns an `Element[]` instead of a single `Element`. Multi-root HTML strings are supported.
+- The library is now distributed as UMD (CommonJS / AMD / global). Importing in Node no longer silently no-ops.
+- `colorAnimate` now always emits `rgba(...)` to keep alpha consistent.
+
+### Fixed
+- `.off(event, handler)` now actually removes handlers attached via `.on()` (previous versions wrapped the user callback in an internal closure, making removal impossible).
+- `.on(event, selector, handler)` delegation now uses `target.matches(selector)`, scoped to the bound element. Previously it queried `document.querySelectorAll(selector)` on every event, broke for dynamically inserted elements, and could fire across unrelated containers.
+- `.animate()` honours per-property units. `opacity` is now correctly treated as unitless (was emitted as `"0.5px"` and silently rejected by browsers, breaking `fadeIn`/`fadeOut`).
+- `.colorAnimate()` no longer collapses all elements to a single key (used `Element` as object key, coerced via `toString()`); now uses a `WeakMap`. Supports named colors and `#RGBA`.
+- `.slideUp()` / `.slideDown()` add a fallback timeout, so the callback always fires even when `transitionend` is suppressed (`prefers-reduced-motion`, hidden tabs, `transition: none`). `slideDown` no longer permanently overrides `display`.
+- `.remove()` no longer crashes when an element has no parent.
+- `GStime.ajax()`:
+  - Uses `AbortController` so `timeout` actually aborts the request.
+  - Strips non-fetch keys before passing to `fetch()`.
+  - Adds `success` and `complete` callbacks; `error` is invoked before `reject`.
+  - Default `credentials: "same-origin"`, `mode: "cors"`.
+  - `text/javascript` and `text/*` are returned as text; only `xml` content types are parsed via `DOMParser`.
+
+### Added
+- `GStime.noConflict()` to restore the previous `window.$`.
+- `$.fn` alias of `GStime.prototype` for plugin-style extension.
+- `$(function)` is a shorthand for `GStime.ready(function)`.
+- TypeScript declarations (`GStime.d.ts`).
+- Cross-platform build script (`scripts/build.js`) using `terser` + source map.
+- Vitest test suite (jsdom environment).
+
+## [1.4.0]
+- Last release of the IIFE/browser-only build. See git history.

GStime.d.ts

@@ -0,0 +1,137 @@
+// Type definitions for GStime 2.0.0
+
+export interface AjaxSettings {
+  url: string;
+  method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | string;
+  headers?: Record<string, string>;
+  data?: unknown;
+  timeout?: number;
+  credentials?: RequestCredentials;
+  mode?: RequestMode;
+  cache?: RequestCache;
+  redirect?: RequestRedirect;
+  referrer?: string;
+  integrity?: string;
+  beforeSend?: () => boolean | void;
+  success?: (data: unknown) => void;
+  error?: (error: Error) => void;
+  complete?: () => void;
+}
+
+export interface Offset {
+  top: number;
+  left: number;
+}
+
+export type GStimeSelector =
+  | string
+  | Element
+  | Document
+  | Window
+  | NodeList
+  | HTMLCollection
+  | Element[]
+  | (() => void)
+  | null
+  | undefined;
+
+export class GStime {
+  constructor(selector?: GStimeSelector);
+  elements: Element[];
+
+  createHTML(html: string): Element[];
+  each(callback: (this: Element, index: number, el: Element) => void): this;
+
+  on(event: string, callback: (this: Element, e: Event) => void): this;
+  on(event: string, selector: string, callback: (this: Element, e: Event) => void): this;
+  off(event: string, callback?: (this: Element, e: Event) => void): this;
+
+  val(): string | undefined;
+  val(newVal: string): this;
+
+  append(html: string): this;
+  prepend(html: string): this;
+  before(html: string): this;
+  after(html: string): this;
+  remove(): this;
+
+  html(): string | undefined;
+  html(html: string): this;
+
+  css(prop: string): string | undefined;
+  css(prop: string, value: string | number): this;
+  css(properties: Record<string, string | number>): this;
+
+  hide(): this;
+  show(): this;
+  toggle(): this;
+  clone(): GStime;
+
+  animate(properties: Record<string, number | string>, duration: number, callback?: () => void): this;
+  fadeIn(duration: number, callback?: () => void): this;
+  fadeOut(duration: number, callback?: () => void): this;
+  slideUp(duration: number, callback?: (this: Element) => void): this;
+  slideDown(duration: number, callback?: (this: Element) => void): this;
+  slideToggle(duration: number, callback?: (this: Element) => void): this;
+  colorAnimate(properties: Record<string, string>, duration: number, callback?: () => void): this;
+
+  hasClass(className: string): boolean;
+  addClass(className: string): this;
+  removeClass(className: string): this;
+  toggleClass(className: string): this;
+
+  attr(name: string): string | null | undefined;
+  attr(name: string, value: string): this;
+  removeAttr(name: string): this;
+
+  width(): number | undefined;
+  width(value: number | string): this;
+  height(): number | undefined;
+  height(value: number | string): this;
+
+  offset(): Offset | undefined;
+  position(): Offset | undefined;
+
+  parent(): GStime;
+  children(): GStime;
+  siblings(): GStime;
+  find(selector: string): GStime;
+  closest(selector: string): GStime;
+
+  static ajax(settings: AjaxSettings): Promise<unknown>;
+  static get(url: string, data?: unknown, options?: Partial<AjaxSettings>): Promise<unknown>;
+  static post(url: string, data?: unknown, options?: Partial<AjaxSettings>): Promise<unknown>;
+  static put(url: string, data?: unknown, options?: Partial<AjaxSettings>): Promise<unknown>;
+  static delete(url: string, data?: unknown, options?: Partial<AjaxSettings>): Promise<unknown>;
+
+  static each<T>(obj: T[] | Record<string, T>, callback: (this: T, key: string | number, value: T) => void): typeof obj;
+  static map<T, U>(obj: T[], callback: (value: T, index: number) => U): U[];
+  static map<T, U>(obj: Record<string, T>, callback: (this: T, key: string, value: T) => U): Record<string, U>;
+  static ready(callback: () => void): void;
+  static noConflict(): GStimeFactory;
+}
+
+export interface GStimeFactory {
+  (selector?: GStimeSelector): GStime;
+  fn: GStime;
+  ajax: typeof GStime.ajax;
+  get: typeof GStime.get;
+  post: typeof GStime.post;
+  put: typeof GStime.put;
+  delete: typeof GStime.delete;
+  each: typeof GStime.each;
+  map: typeof GStime.map;
+  ready: typeof GStime.ready;
+  noConflict: typeof GStime.noConflict;
+}
+
+declare const _default: { GStime: typeof GStime; $: GStimeFactory };
+export default _default;
+export const $: GStimeFactory;
+
+declare global {
+  interface Window {
+    GStime: typeof GStime;
+    $: GStimeFactory;
+  }
+}