mazey 4.11.0 → 4.11.2

package/lib/index.esm.js

@@ -1,5 +1,5 @@
 /*!
- * Mazey v4.11.0 https://github.com/chengchuu/mazey
+ * Mazey v4.11.2 https://github.com/chengchuu/mazey
  * (c) 2018-2026 Cheng
  * Released under the MIT License.
  */

package/lib/mazey.min.js

@@ -1,5 +1,5 @@
 /*!
- * Mazey v4.11.0 https://github.com/chengchuu/mazey
+ * Mazey v4.11.2 https://github.com/chengchuu/mazey
  * (c) 2018-2026 Cheng
  * Released under the MIT License.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mazey",
-  "version": "4.11.0",
+  "version": "4.11.2",
   "description": "A functional library for daily frontend work.",
   "main": "lib/index.cjs.js",
   "module": "lib/index.esm.js",

package/scripts/rollup.config.mjs

@@ -57,6 +57,19 @@ const dTsConf = {
   ],
   external: [],
 };
+const indexDtsConf = {
+  input: _resolve("../src/index.ts"),
+  output: [
+    {
+      file: _resolve("../lib/index.d.ts"),
+      format: "es",
+    },
+  ],
+  plugins: [
+    dts(),
+  ],
+  external: [],
+};
 const gTsConf = {
   input: _resolve("../types/global.d.ts"),
   output: [
@@ -120,6 +133,7 @@ export default [
     ],
     external: [],
   },
+  indexDtsConf,
   dTsConf,
   gTsConf,
 ];

package/.dockerignore

@@ -1,35 +0,0 @@
-# Git
-**/.git
-**/.gitignore
-
-# Node.js
-**/node_modules
-**/npm-debug.log
-
-# PHP
-**/*.php
-
-# Cache & System Files
-**/.DS_Store
-**/Thumbs.db
-**/.vscode
-**/.idea
-**/.cache
-**/tmp
-**/temp
-**/*.code-workspace
-
-# Docs
-**/documents/**/*.md
-**/documents/**/*.txt
-
-# Cert
-**/cert/**/*.key
-**/cert/**/*.pem
-
-# LOG
-**/var-log-web
-
-# Archives
-**/*.tar.gz
-**/asset_frozen

package/.gitattributes

@@ -1,5 +0,0 @@
-*.ts text eol=lf
-*.js text eol=lf
-*.json text eol=lf
-*.yml text eol=lf
-*.yaml text eol=lf

package/.markdownlint.json

@@ -1,48 +0,0 @@
-{
-  "default": true,
-  "MD001": true,
-  "MD003": {
-    "style": "atx"
-  },
-  "MD004": {
-    "style": "dash"
-  },
-  "MD007": {
-    "indent": 2
-  },
-  "MD010": {
-    "code_blocks": false
-  },
-  "MD013": {
-    "line_length": 700,
-    "code_blocks": false,
-    "tables": false
-  },
-  "MD022": {
-    "lines_above": 1,
-    "lines_below": 1
-  },
-  "MD024": {
-    "siblings_only": true
-  },
-  "MD025": {
-    "front_matter_title": ""
-  },
-  "MD026": {
-    "punctuation": ".,;:!?"
-  },
-  "MD029": {
-    "style": "ordered"
-  },
-  "MD033": {
-    "allowed_elements": ["img", "br", "kbd", "sub", "sup"]
-  },
-  "MD036": false,
-  "MD041": false,
-  "MD046": {
-    "style": "fenced"
-  },
-  "MD048": {
-    "style": "backtick"
-  }
-}

package/AGENTS.md

@@ -1,111 +0,0 @@
-# AGENTS.md
-
-## Purpose
-
-This repository is a browser-focused utility library published as `mazey`. It is not an application or monorepo. The main job here is maintaining a flat public API of frontend helper functions and shipping it in multiple bundle formats.
-
-## Repo Map
-
-- `src/`: source of truth for the library
-- `types/`: extra global type declarations bundled into `lib/`
-- `test/`: Jest tests, generally one file per source module
-- `examples/`: demo page and TS entry used by the local dev server
-- `scripts/`: Rollup, Webpack, release, and docs helpers
-- `images/`: documentation assets
-- `.github/`: CI/workflows
-
-## Main Entry Points
-
-- Library source entry: `src/index.ts`
-- Published package outputs:
-  - `lib/index.cjs.js`
-  - `lib/index.esm.js`
-  - `lib/mazey.min.js`
-  - `lib/index.d.ts`
-- Dev/demo entry: `examples/index.ts`
-
-`src/index.ts` is intentionally simple: it re-exports all feature modules so consumers import from `"mazey"` and get a flat API.
-
-## Source Modules
-
-- `src/util.ts`: shared utility layer; many other modules depend on this
-- `src/typing.d.ts`: shared internal/public types
-- `src/url.ts`: URL parsing, query helpers, URL transforms, script query inspection
-- `src/dom.ts`: class/style/meta/image DOM helpers
-- `src/event.ts`: custom event registry on `window.MAZEY_DEFINE_LISTENERS`
-- `src/store.ts`: `sessionStorage`, `localStorage`, and cookie helpers
-- `src/load.ts`: dynamic script/CSS/image loading and page-load helpers
-- `src/browser.ts`: browser/platform/PWA detection
-- `src/perf.ts`: Performance API and navigation timing helpers
-- `src/debug.ts`: custom console wrappers
-- `src/calc.ts`: standalone algorithms and probability helpers
-
-## Data Flow
-
-Typical runtime flow:
-
-1. Consumer imports from `mazey`
-2. Package resolves to a built file from `lib/`
-3. Built file originates from `src/index.ts`
-4. `src/index.ts` re-exports functions from the feature modules
-5. Feature modules call browser APIs directly, with light reuse of shared helpers in `util.ts`, `debug.ts`, and `typing.d.ts`
-
-Important internal dependencies:
-
-- `util.ts` is the main shared dependency
-- `typing.d.ts` is imported across modules for signatures and shared types
-- `debug.ts` provides `mazeyCon`, used by modules like `dom.ts` and `browser.ts`
-- `load.ts` depends on `util.ts` and `url.ts`
-- `perf.ts` depends on `util.ts`
-- `browser.ts` depends on `util.ts`
-- `calc.ts` depends on `util.ts`
-
-This is a mostly flat architecture, not a layered service system.
-
-## Build And Dev Flow
-
-- `npm run build`: Rollup bundles `src/index.ts` into CJS, ESM, and IIFE outputs in `lib/`
-- `npm run dev`: Webpack serves `examples/index.ts` via `examples/index.html`
-- `npm test`: Jest suite across `test/`
-- `npm run docs`: TypeDoc using `README.md`
-
-Relevant config files:
-
-- `package.json`
-- `scripts/rollup.config.mjs`
-- `scripts/webpack.config.dev.js`
-- `tsconfig.json`
-
-## Working Style For Agents
-
-- Preserve the flat public API unless there is a strong reason to change it
-- Check `src/index.ts` whenever adding, renaming, or removing exported functions
-- Prefer small, targeted changes; most modules are independent
-- Be careful with browser globals like `window`, `document`, `location`, `navigator`, and `performance`
-- Keep examples and tests aligned with public behavior when you change an exported helper
-- Avoid introducing app-style abstractions unless the repo is clearly moving in that direction
-
-## Common Change Paths
-
-- Add a new utility:
-  - implement in the relevant `src/*.ts`
-  - export via `src/index.ts`
-  - add or update tests under `test/`
-  - ensure build output still succeeds
-
-- Change packaging behavior:
-  - inspect `package.json`
-  - inspect `scripts/rollup.config.mjs`
-  - inspect any generated type outputs in `lib/`
-
-- Change local demo behavior:
-  - inspect `examples/index.ts`
-  - inspect `examples/index.html`
-  - inspect `scripts/webpack.config.dev.js`
-
-## Notes
-
-- The library targets browser environments first
-- Some helpers intentionally cache data on `window`
-- Several functions have compatibility-oriented logic for older browsers
-- The README is broad, but the code in `src/` is the authoritative map of behavior

package/Dockerfile

@@ -1,30 +0,0 @@
-FROM node:22-bookworm
-
-ENV DEBIAN_FRONTEND=noninteractive
-WORKDIR /workspace
-
-# Match ubuntu-latest style tooling needed by your workflow
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    dos2unix \
-    git \
-    ca-certificates \
-  && rm -rf /var/lib/apt/lists/*
-
-# Copy repo
-COPY . .
-
-# Simulate workflow env
-ENV NODE_VERSION=22
-ENV PROJECT_NAME=mazey
-ENV GITHUB_ACTOR=local-dev
-
-# Default command runs "test job" behavior
-CMD bash -lc '\
-  set -euo pipefail; \
-  echo "== Install dependencies =="; \
-  npm install; \
-  echo "== Build package =="; \
-  npm run build --if-present; \
-  echo "== Run tests =="; \
-  npm test \
-'