Update to latest standard

.eslintrc.cjs

@@ -0,0 +1,23 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+  ],
+  parserOptions: {
+    ecmaVersion: 2020,
+    sourceType: 'module',
+  },
+  env: {
+    browser: true,
+    es2020: true,
+    node: true,
+  },
+  rules: {
+    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+    '@typescript-eslint/no-explicit-any': 'warn',
+  },
+  ignorePatterns: ['dist/', 'dist-demo/', 'node_modules/', 'coverage/'],
+};

.github/workflows/deploy-pages.yml

@@ -0,0 +1,39 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [master]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - run: npm ci
+      - run: npm run build:demo
+
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist-demo
+
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,2 +1,40 @@
-node_modules
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
 
+# build output — only CDN bundles are tracked
+/dist/*
+!/dist/js-cloudimage-carousel.min.js
+!/dist/js-cloudimage-carousel.min.js.map
+/dist-demo
+
+# testing
+/coverage
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+# IDE
+.idea
+/.idea
+.vscode/
+
+# husky
+.husky/
+
+# claude
+.claude
+CLAUDE.md

CHANGELOG.md

@@ -0,0 +1,83 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.2] - 2026-03-20
+
+### Fixed
+
+- **Type declarations path** — `package.json` types field now points to correct `dist/index.d.ts` (was pointing to non-existent `dist/types/`)
+- **UMD global** — `window.CloudImageCarousel` is now the class directly, not a namespace object (CDN `<script>` usage works as documented)
+- **Named + default exports** — both `import CloudImageCarousel` and `import { CloudImageCarousel }` now work correctly
+- **Config immutability** — `validateConfig()` returns a new object instead of mutating the input
+- **Memory leak** — slide transition fallback `setTimeout` now tracked in cleanup stack
+- **Incomplete destroy()** — `keyboardHints` and `bottomContainer` DOM references now properly nulled
+
+### Changed
+
+- Removed all `as any` type casts (5 occurrences) — replaced with proper interfaces and public getters
+- Extracted ~15 hardcoded CSS class strings into typed constants in `classes.constants.ts`
+- Extracted magic numbers (`CONTROLS_HIDE_DELAY`, `PLACEHOLDER_SVG`) into constants
+- Cached `getComputedStyle()` transition duration — computed once during `init()` instead of per slide change
+- Adopted cleanup stack pattern in `CarouselControls` (keyboard + touch listeners)
+- Used `isBrowser()` utility consistently in `cloudimage.ts` instead of inline `typeof window` checks
+- Typed fullscreen vendor prefixes (`WebkitDocument`, `WebkitHTMLElement`) instead of `as any` casts
+
+### Added
+
+- **`addListener` utility** — typed event listener helper in `dom.utils.ts` that returns a cleanup function
+- **Dedicated `a11y/` module** — extracted ARIA, focus trap, and screen reader utilities from core
+- **Live region clearing** — clears before setting new message so duplicate announcements are detected
+- **Unique keyboard hints IDs** — uses incrementing counter instead of `Date.now()`
+- **ESLint configuration** — `.eslintrc.cjs` with TypeScript-eslint recommended rules
+- **Documentation** — `CHANGELOG.md`, `SPECS.md`, `IMPLEMENTATION.md`, `docs/` folder
+- **Test coverage expansion** — 178 tests across 12 files (up from 113 across 6)
+- **GitHub Pages deployment** — workflow + `build:demo` script
+
+## [1.0.1] - 2026-03-17
+
+### Changed
+
+- Renamed package from `js-carousel` to `js-cloudimage-carousel`
+- Migrated build system from Webpack/Babel to Vite (library mode) with ESM + CJS + UMD outputs
+- Rewrote codebase in TypeScript
+- Consolidated all CSS into single stylesheet with CSS custom properties for theming
+- Adopted cleanup stack pattern (`this.cleanups[]`) for robust teardown (following hotspot pattern)
+- Immutable config objects via spread-based `mergeConfig()` pattern
+
+### Added
+
+- **React wrapper** — `<CloudImageCarouselViewer>` component, `useCloudImageCarousel` hook, and ref API via `js-cloudimage-carousel/react`
+- **HTML data-attribute initialization** — `data-ci-carousel-*` attributes with `CloudImageCarousel.autoInit()`
+- **Four transition effects** — slide, fade, zoom, and flip with configurable easing via CSS variables
+- **CSS variable theming** — light and dark themes with 30+ customizable `--ci-carousel-*` properties
+- **Zoom & pan** — Ctrl+scroll, double-click, pinch-to-zoom, drag-to-pan with configurable min/max/step
+- **Autoplay** — with pause/resume controls (WCAG 2.2.2 compliant)
+- **Fullscreen mode** — via Fullscreen API with focus trapping for accessibility
+- **Accessibility (WCAG 2.1 AA)** — full keyboard navigation, ARIA attributes, focus management, live region announcements, `prefers-reduced-motion` support
+- **Cloudimage CDN integration** — optional responsive image loading with automatic `srcset` generation
+- **Lazy loading** — IntersectionObserver-based with eager fallback
+- **Image error handling** — graceful fallback for broken images with optional `onError` callback
+- **Swipe gestures** — touch support for mobile navigation
+- **Thumbnail strip** — with configurable visibility and active state
+- **Bullet indicators** — with `aria-pressed` for accessibility
+- **Filename overlay** — optional filename display on each slide
+- **TypeScript declarations** — full type definitions for all exports
+- **Comprehensive demo** — interactive showcase, configurator, and React demo
+- **GitHub Pages deployment** — automated via GitHub Actions
+
+## [1.0.0] - 2026-03-15
+
+### Features
+
+- **Image carousel** — navigate between images with thumbnails, bullets, or swipe gestures
+- **Zoom & pan** — CSS transform-based with mouse wheel, pinch-to-zoom, double-click, drag-to-pan
+- **Transitions** — slide and fade effects
+- **Navigation controls** — prev/next arrows and fullscreen toggle
+- **Cloudimage CDN** — optional responsive image loading via Scaleflex CDN
+- **Zero runtime dependencies**
+- **Output formats** — ESM, CJS, and UMD bundles
+
+[1.0.2]: https://github.com/scaleflex/js-cloudimage-carousel/releases/tag/v1.0.2
+[1.0.1]: https://github.com/scaleflex/js-cloudimage-carousel/releases/tag/v1.0.1
+[1.0.0]: https://github.com/scaleflex/js-cloudimage-carousel/releases/tag/v1.0.0