een-api-toolkit 0.3.91 → 0.3.101

package/.claude/agents/api-coverage-agent.md

@@ -205,40 +205,82 @@ Implemented: [brief list of what IS implemented]
 
 #### Document 4: `docs/een-api-coverage.html`
 
-Generate a self-contained HTML file with:
-
-**Header section**:
-- Title: "Eagle Eye Networks API v3.0 - Toolkit Coverage"
-- Generation date
-- Summary stat cards: Total endpoints, Implemented, Missing, Coverage percentage with progress bar
-
-**Filter bar**:
-- Status filter dropdown (All / Implemented / Missing)
-- Category filter dropdown (All + each category)
-- Method filter dropdown (All / GET / POST / PATCH / DELETE / PUT)
-- Text search input for path/function/description
-
-**Data table**:
-- Columns: #, Category, Subcategory, Method, Path, Description, Status, Toolkit Function
-- Sortable by clicking column headers
-- Color-coded method badges (GET=blue, POST=green, PATCH=yellow, DELETE=red, PUT=indigo)
-- Status badges (Implemented=green, Missing=red)
-- Monospace font for function names
-
-**Styling**:
-- Clean, modern CSS with system font stack
-- Light background (#f5f7fa)
-- White card-style table with subtle shadows
-- Responsive layout
-- All styles inline (self-contained, no external dependencies)
+Generate a self-contained HTML file matching this exact visual style:
+
+**Global reset and body**:
+- `*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }`
+- Font: `-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, sans-serif`
+- Background: `#f5f7fa`, color: `#1a202c`
+
+**Header** (`<header>`):
+- Dark navy background: `#1a365d`, white text
+- Padding: `24px 32px`
+- `<h1>` at `1.5rem` bold: "Eagle Eye Networks API v3.0 — Toolkit Coverage"
+- `<p>` at `0.875rem`, color `#bee3f8`: generation date and source info
+
+**Container**: `max-width: 100%` (use full page width), centered, padding `24px 32px`
+
+**Stat cards** (`.stats` grid):
+- `grid-template-columns: repeat(auto-fit, minmax(180px, 1fr))`, gap `16px`
+- Each card: white background, `border-radius: 8px`, padding `20px`, `box-shadow: 0 1px 3px rgba(0,0,0,.08)`
+- Colored `border-top: 4px solid` — blue (`#4299e1`) for Total, green (`#48bb78`) for Implemented, red (`#fc8181`) for Missing, indigo (`#667eea`) for Coverage
+- Label: `0.75rem` uppercase, `letter-spacing: .05em`, color `#718096`
+- Value: `2rem` bold, color `#2d3748`
+- Sub text: `0.8rem`, color `#718096`
+
+**Progress bar** (`.progress-wrap`):
+- White card with same shadow/radius as stat cards
+- Label row: flex with `justify-content: space-between`, `0.875rem`, color `#4a5568`
+- Bar background: `#e2e8f0`, `border-radius: 9999px`, height `12px`
+- Fill: `linear-gradient(90deg, #48bb78, #38a169)`, same radius, `transition: width .4s ease`
+
+**Filter bar** (`.filter-bar`):
+- White card, flex with `flex-wrap: wrap`, gap `12px`
+- Labels: `0.8rem`, color `#718096`
+- Inputs/selects: border `1px solid #e2e8f0`, `border-radius: 6px`, padding `6px 10px`, `0.875rem`
+- Focus: `border-color: #4299e1`, `box-shadow: 0 0 0 3px rgba(66,153,225,.15)`
+- Text input width: `220px`
+- Filter count: `margin-left: auto`, `0.8rem`, color `#718096`
+- Dropdowns: Status (All/Implemented/Missing), Category (All + each category), Method (All/GET/POST/PATCH/DELETE/PUT)
+- Text search placeholder: "path, function, description..."
+
+**Table** (`.table-wrap`):
+- White card with `overflow-x: auto` for horizontal scrollbar on narrow viewports
+- The `<table>` element must have `min-width: 1200px` so content is never clipped — the scrollbar activates instead of truncating columns
+- `<thead>`: dark background `#2d3748`, white text, uppercase `0.75rem`, `letter-spacing: .05em`
+- Headers clickable (cursor pointer) with sort icon `⇅`, changing to `▲`/`▼` when sorted
+- `<tbody>` rows: `border-bottom: 1px solid #edf2f7`, hover `#f7fafc`
+- Cell padding: `10px 14px`
+- Column classes:
+  - `.td-num`: color `#a0aec0`, `0.75rem`, width `44px`
+  - `.td-cat`: color `#4a5568`, `font-weight: 500`
+  - `.td-sub`: color `#718096`
+  - `.td-path`: monospace (`'SFMono-Regular', Consolas, monospace`), `0.8rem`, color `#2d3748`
+  - `.td-desc`: color `#4a5568`, `max-width: 280px`
+  - `.td-func`: monospace, `0.78rem`, color `#553c9a`
+
+**Badges** (`.badge`):
+- `display: inline-flex`, padding `2px 8px`, `border-radius: 4px`, `0.72rem` bold uppercase
+- Method colors: GET (`#ebf8ff`/`#2b6cb0`), POST (`#f0fff4`/`#276749`), PATCH (`#fffff0`/`#975a16`), DELETE (`#fff5f5`/`#c53030`), PUT (`#f0e6ff`/`#553c9a`)
+- Status colors: Implemented (`#f0fff4`/`#276749`), Missing (`#fff5f5`/`#c53030`)
+
+**Empty state**: centered, padding `48px`, color `#a0aec0`, with a search SVG icon
+
+**Footer**: centered, padding `24px`, color `#a0aec0`, `0.8rem`
+
+**Columns**: #, Category, Subcategory, Method, Path, Description, Status, Toolkit Function (8 columns)
 
 **JavaScript**:
 - All endpoint data in a `const endpoints = [...]` array with objects: `{cat, sub, method, path, desc, status, func}`
+- Endpoints grouped by category/subcategory with `// ─── Category - Subcategory ───` comment dividers
 - `status` values: `"impl"` for implemented, `"miss"` for missing
 - `func` is empty string for missing endpoints
-- `renderTable(data)` function to populate tbody
-- `filterTable()` function combining all filter inputs
-- `sortTable(colIndex)` function with toggle direction
+- `methodBadge(m)` and `statusBadge(s)` helper functions
+- `renderTable(data)` function to populate tbody and update filter count
+- `filterTable()` function combining all four filter inputs (status, category, method, text search across path+func+desc+sub)
+- `sortTable(colIndex)` function with toggle direction, updating header sort icons
+- `sortCol`/`sortAsc` state variables
+- Initial call to `renderTable(endpoints)` at the end
 - All code inline (no external dependencies)
 
 ## Important Guidelines

package/.claude/agents/een-ptz-agent.md

@@ -221,14 +221,24 @@ nested `capabilities.ptz.capable` field. The structure is:
 ```
 
 **IMPORTANT:** The PTZ capability is at `capabilities.ptz.capable` (nested under a `ptz` object),
-NOT at `capabilities.ptzCapable` (flat). Always use `capabilities?.ptz?.capable` to check.
+NOT at `capabilities.ptzCapable` (flat). Fisheye cameras report `capabilities.ptz.capable: true`
+but are NOT true PTZ cameras — always exclude them. Use this pattern:
+
+```typescript
+import { computed } from 'vue'
+
+const isPtzCapable = computed(() => {
+  const ptz = camera.value?.capabilities?.ptz
+  return ptz?.capable === true && ptz?.fisheye !== true
+})
+```
 
 Also check `effectivePermissions.controlPTZ` to verify the user has permission to move the camera,
 and `effectivePermissions.editPTZStations` for managing presets.
 
 ## Constraints
 - Always check authentication before API calls
-- Verify camera has PTZ capability (`capabilities.ptz.capable`) before showing controls
+- Verify camera has PTZ capability (`capabilities.ptz.capable`) and is not fisheye (`capabilities.ptz.fisheye !== true`) before showing controls
 - Check user permissions (`effectivePermissions.controlPTZ`) before enabling movement
 - Poll position periodically (every 5s) for position display
 - Handle 204 responses for PUT/PATCH (no response body)

package/CHANGELOG.md

@@ -2,78 +2,66 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.3.91] - 2026-02-21
+## [0.3.101] - 2026-02-23
 
 ### Release Summary
 
-#### PR #118: Release v0.3.85 - API coverage docs and workflow security fix
+#### PR #130: Release v0.3.96: PTZ fisheye exclusion and API coverage docs
 ## Summary
+- Add fisheye camera exclusion to PTZ type definitions, agent docs, AI reference docs, and vue-ptz example
+- Add PTZ sub-capability fields (`fisheye`, `panTilt`, `zoom`, `positionMove`, `directionMove`, `centerOnMove`) to `Camera.capabilities.ptz` type
+- Regenerate API coverage docs with full-width layout and scrollbar fix
 
-- Add EEN API v3.0 coverage documentation (4 documents comparing 211 API endpoints against 51 implemented, 24.2% coverage)
-- Add `api-coverage-agent` for on-demand regeneration of coverage docs
-- Update README with agent list and coverage section
-- Fix workflow_dispatch restriction to production branch (security)
+## Version
+v0.3.96
 
 ## Commits
+- `1d9da62` docs: regenerate API coverage docs with full-width layout and scrollbar fix
+- `044c9ae` docs: add fisheye camera exclusion guidance to PTZ agent
+- `f65ff2e` fix: add PTZ sub-capability fields to Camera type and update docs
+- `6ecf253` fix: address review findings for PTZ fisheye guidance
+- `97cf632` fix: exclude fisheye cameras from PTZ selector in vue-ptz example
 
-- `baa7e1b` feat: add EEN API coverage documentation and agent
-- `eea17e8` docs: add missing agents to README agent list
-- `bb47cc2` docs: rename een-api-coverage-agent to api-coverage-agent
-- `c794fba` fix: restrict workflow_dispatch to production branch to prevent supply chain attack
-- `6e782e2` fix: restrict npm-publish workflow_dispatch to production branch
-
-## Test Results (from PR #117)
-
-- **Lint**: Passed
-- **Unit tests**: 644 passed
-- **Build**: Succeeded
-- **E2E tests**: 236 passed across all 11 example apps
-- **Security review**: No vulnerabilities
-- **Code review**: Approved by Claude Sonnet 4.5
-
-## Version
-
-v0.3.85
+## Test Results
+- Lint: passed (1 pre-existing warning)
+- Unit tests: 683/683 passed
+- Build: passed
+- E2E: 12/12 example apps passed
+- Security: no vulnerabilities (type/docs changes only)
+- Confidential data scan: clean across 280 changed .md files
 
 🤖 Generated with [Claude Code](https://claude.com/claude-code)
 
-#### PR #128: Release v0.3.89: PTZ camera control API and vue-ptz example
+#### PR #134: release: v0.3.101 - multi-move-type PTZ support
 ## Summary
+- Add move type dropdown (Position / Direction / Center On) to the PositionInput panel in `examples/vue-ptz`
+- Dynamic input fields per move type with proper validation
+- Replace auto-updating x/y/z with explicit "Import Current Position" button
+- Refactored `apply()` with `buildMove()` extraction for cleaner code
+- `try/finally` for defensive state reset, null-safe optional chaining
 
-This release adds PTZ (Pan/Tilt/Zoom) camera control support to the toolkit:
-
-- **PTZ API functions**: `getPtzPosition()`, `movePtz()`, `getPtzSettings()`, `updatePtzSettings()` with full TypeScript types
-- **PTZ types**: `PtzPosition`, `PtzMove` (discriminated union: position/direction/centerOn), `PtzSettings`, `PtzPreset`, `PtzSettingsUpdate`
-- **vue-ptz example app**: Complete PTZ control application with live video, direction pad, click-to-center, position display, preset management, and API call logging
-- **Camera capabilities**: Added `capabilities` field to `Camera` type for PTZ detection via `include: ['capabilities']`
-- **Documentation**: AI-PTZ.md reference doc, een-ptz-agent, updated AI-CONTEXT.md and CLAUDE.md
-- **E2E tests**: Conditional PTZ API tests that exercise position read, direction move, and preset loading when a PTZ camera is available
-
-### Additional changes
-- Dependabot: CodeQL action bump to 4.32.3
-- CI: Use floating v1 tag for claude-code-action instead of SHA pin
+## Version
+`0.3.101`
 
 ## Commits
-
-- `c552fd0` feat: add PTZ camera control API and vue-ptz example app
-- `6a12649` fix: use single getCameras call with include and pagination for PTZ discovery
-- `2b04b26` fix: address review findings in vue-ptz example app
-- `92a18e4` fix: address remaining review findings
-- `4d01c2c` fix: use floating v1 tag for claude-code-action instead of SHA pin
-- `3f197ba` chore(deps): bump github/codeql-action from 4.32.2 to 4.32.3
-
-## Test Results
-
-| Check | Result |
-|-------|--------|
-| Lint | Pass (0 errors) |
-| Unit tests | 681 passed (24 suites) |
-| Build | Pass |
-| E2E (12 apps) | All passed |
-| Security review | No vulnerabilities found |
-| Confidential data scan | Clean |
-
-**Version**: 0.3.89
+- `2a4aac8f` feat: add multi-move-type support to vue-ptz PositionInput
+- `f125139c` fix: address code review findings for PositionInput
+- `addcc0ec` fix: wrap movePtz calls in try/finally to always reset applying state
+- `a1365f24` fix: address remaining review findings for PositionInput
+
+## Local test results
+- Lint: passed (0 errors, 1 pre-existing warning)
+- Unit tests: 684/684 passed
+- Build: success
+- E2E tests: 12/12 example apps passed
+- Security review: no issues found
+- Docs confidential data scan: clean (274 .md files scanned)
+
+## Test plan
+- [ ] Select "Position" move type — verify x/y/z inputs, Import Current Position button
+- [ ] Select "Direction" move type — verify checkboxes + step size, Apply sends direction move
+- [ ] Select "Center On" move type — verify rX/rY inputs, Apply sends centerOn move
+- [ ] Verify x/y/z fields do NOT auto-update when position refreshes
 
 🤖 Generated with [Claude Code](https://claude.com/claude-code)
 
@@ -81,22 +69,16 @@ This release adds PTZ (Pan/Tilt/Zoom) camera control support to the toolkit:
 ### Detailed Changes
 
 #### Features
-- feat: add PTZ camera control API and vue-ptz example app
+- feat: add multi-move-type support to vue-ptz PositionInput
 
 #### Bug Fixes
-- fix: address remaining PR #128 review findings
-- fix: address PR #128 review findings
-- fix: address remaining review findings
-- fix: address review findings in vue-ptz example app
-- fix: use single getCameras call with include and pagination for PTZ discovery
-- fix: use floating v1 tag for claude-code-action instead of SHA pin
-
-#### Other Changes
-- chore(deps): bump github/codeql-action from 4.32.2 to 4.32.3
+- fix: address remaining review findings for PositionInput
+- fix: wrap movePtz calls in try/finally to always reset applying state
+- fix: address code review findings for PositionInput
 
 ### Links
 - [npm package](https://www.npmjs.com/package/een-api-toolkit)
-- [Full Changelog](https://github.com/klaushofrichter/een-api-toolkit/compare/v0.3.85...v0.3.91)
+- [Full Changelog](https://github.com/klaushofrichter/een-api-toolkit/compare/v0.3.97...v0.3.101)
 
 ---
-*Released: 2026-02-21 17:41:30 CST*
+*Released: 2026-02-23 18:17:46 CST*

package/dist/index.d.ts

@@ -610,6 +610,18 @@ export declare interface Camera {
         ptz?: {
             /** Whether this camera supports PTZ controls */
             capable?: boolean;
+            /** Whether this is a fisheye camera (not a true PTZ camera) */
+            fisheye?: boolean;
+            /** Whether the camera supports pan/tilt movements */
+            panTilt?: boolean;
+            /** Whether the camera supports zoom */
+            zoom?: boolean;
+            /** Whether the camera supports absolute position moves */
+            positionMove?: boolean;
+            /** Whether the camera supports directional moves */
+            directionMove?: boolean;
+            /** Whether the camera supports center-on moves */
+            centerOnMove?: boolean;
         };
     };
     /** List of enabled analytics on this camera */

package/docs/AI-CONTEXT.md

@@ -1,6 +1,6 @@
 # EEN API Toolkit - AI Reference
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > This documentation is optimized for AI assistants. It provides focused, domain-specific
 > references to help you understand and use the een-api-toolkit efficiently.

package/docs/ai-reference/AI-AUTH.md

@@ -1,6 +1,6 @@
 # Authentication - EEN API Toolkit
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > OAuth flow implementation, token management, and session handling.
 > Load this document when implementing login, logout, or auth guards.

package/docs/ai-reference/AI-AUTOMATIONS.md

@@ -1,6 +1,6 @@
 # Automations API - EEN API Toolkit
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > Complete reference for automation rules and alert actions.
 > Load this document when working with automated alert workflows.

package/docs/ai-reference/AI-DEVICES.md

@@ -1,6 +1,6 @@
 # Cameras & Bridges API - EEN API Toolkit
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > Complete reference for camera and bridge management.
 > Load this document when working with devices.
@@ -33,6 +33,17 @@ interface Camera {
   deviceInfo?: CameraDeviceInfo
   shareDetails?: CameraShareDetails
   devicePosition?: CameraDevicePosition
+  capabilities?: {
+    ptz?: {
+      capable?: boolean
+      fisheye?: boolean
+      panTilt?: boolean
+      zoom?: boolean
+      positionMove?: boolean
+      directionMove?: boolean
+      centerOnMove?: boolean
+    }
+  }
   createdAt?: string
   updatedAt?: string
 }

package/docs/ai-reference/AI-EVENT-DATA-SCHEMAS.md

@@ -1,6 +1,6 @@
 # Event Type to Data Schemas Mapping - EEN API Toolkit
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > Complete reference for event type to data schema mappings.
 > Load this document when building dynamic event queries with the `include` parameter.

package/docs/ai-reference/AI-EVENTS.md

@@ -1,6 +1,6 @@
 # Events, Alerts & Real-Time Streaming - EEN API Toolkit
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > Complete reference for events, alerts, metrics, and SSE subscriptions.
 > Load this document when implementing event-driven features.

package/docs/ai-reference/AI-GROUPING.md

@@ -1,6 +1,6 @@
 # Layouts API - EEN API Toolkit
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > Complete reference for layout management (camera grouping).
 > Load this document when working with layouts.

package/docs/ai-reference/AI-JOBS.md

@@ -1,6 +1,6 @@
 # Jobs, Exports, Files & Downloads - EEN API Toolkit
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > Complete reference for async jobs, video exports, and file management.
 > Load this document when implementing export workflows or file downloads.

package/docs/ai-reference/AI-MEDIA.md

@@ -1,6 +1,6 @@
 # Media & Live Video - EEN API Toolkit
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > Complete reference for media retrieval, live streaming, and video playback.
 > Load this document when implementing video features.

package/docs/ai-reference/AI-PTZ.md

@@ -1,6 +1,6 @@
 # PTZ Camera Controls
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > Pan/Tilt/Zoom camera control: position, movement, presets, and automation.
 
@@ -142,6 +142,22 @@ function handleVideoClick(event: MouseEvent) {
 | FORBIDDEN | No permission | Show access denied |
 | VALIDATION_ERROR | Empty camera ID | Fix input |
 
+## Fisheye Camera Exclusion
+
+**IMPORTANT:** Fisheye cameras report `capabilities.ptz.capable: true` but are NOT true PTZ cameras.
+Always exclude fisheye cameras when checking PTZ capability:
+
+```typescript
+import { computed } from 'vue'
+
+const isPtzCapable = computed(() => {
+  const ptz = camera.value?.capabilities?.ptz
+  return ptz?.capable === true && ptz?.fisheye !== true
+})
+```
+
+Also check `effectivePermissions.controlPTZ` to verify the user has permission to move the camera.
+
 ---
 
 ## Reference Examples

package/docs/ai-reference/AI-SETUP.md

@@ -1,6 +1,6 @@
 # Vue 3 Application Setup - EEN API Toolkit
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > Complete guide for setting up a Vue 3 application with the een-api-toolkit.
 > Load this document when creating a new project or troubleshooting setup issues.

package/docs/ai-reference/AI-USERS.md

@@ -1,6 +1,6 @@
 # Users API - EEN API Toolkit
 
-> **Version:** 0.3.91
+> **Version:** 0.3.101
 >
 > Complete reference for user management.
 > Load this document when working with user data.

package/examples/vue-ptz/README.md

@@ -214,7 +214,7 @@ let pageToken: string | undefined
 do {
   const result = await getCameras({ pageSize: 100, include: ['capabilities'], pageToken })
   for (const cam of result.data?.results || []) {
-    if (cam.capabilities?.ptz?.capable) ptzCameras.push(cam)
+    if (cam.capabilities?.ptz?.capable && !cam.capabilities?.ptz?.fisheye) ptzCameras.push(cam)
   }
   pageToken = result.data?.nextPageToken ?? undefined
 } while (pageToken)

package/examples/vue-ptz/src/components/CameraSelector.vue

@@ -35,7 +35,7 @@ async function loadPtzCameras() {
 
     const allCameras = result.data?.results || []
     for (const cam of allCameras) {
-      if (cam.capabilities?.ptz?.capable) {
+      if (cam.capabilities?.ptz?.capable && !cam.capabilities?.ptz?.fisheye) {
         ptzCameras.push(cam)
       }
     }

package/examples/vue-ptz/src/components/PositionInput.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { ref, watch } from 'vue'
 import { movePtz } from 'een-api-toolkit'
-import type { PtzPositionResponse } from 'een-api-toolkit'
+import type { PtzPositionResponse, PtzDirection, PtzStepSize, PtzMoveType, PtzMove } from 'een-api-toolkit'
 import { useApiLog } from '../composables/useApiLog'
 
 const props = defineProps<{
@@ -14,45 +14,97 @@ const emit = defineEmits<{
 }>()
 
 const { log: apiLog } = useApiLog()
+
+// Move type selection
+const moveType = ref<PtzMoveType>('position')
+
+// Position fields
 const x = ref<string>('0')
 const y = ref<string>('0')
 const z = ref<string>('0')
+
+// Direction fields
+const directions = ref<PtzDirection[]>([])
+const stepSize = ref<PtzStepSize>('medium')
+const allDirections: PtzDirection[] = ['up', 'down', 'left', 'right', 'in', 'out']
+
+// CenterOn fields
+const relativeX = ref<string>('0.5')
+const relativeY = ref<string>('0.5')
+
 const applying = ref(false)
 const error = ref<string | null>(null)
 
-watch(() => props.currentPosition, (pos) => {
-  if (pos) {
-    x.value = pos.x?.toFixed(3) ?? '0'
-    y.value = pos.y?.toFixed(3) ?? '0'
-    z.value = pos.z?.toFixed(3) ?? '0'
+watch(moveType, () => {
+  error.value = null
+})
+
+function importPosition() {
+  if (props.currentPosition) {
+    x.value = props.currentPosition.x?.toFixed(3) ?? '0'
+    y.value = props.currentPosition.y?.toFixed(3) ?? '0'
+    z.value = props.currentPosition.z?.toFixed(3) ?? '0'
   }
-}, { immediate: true })
+}
 
-async function apply() {
-  if (!props.cameraId || applying.value) return
+function buildMove(): PtzMove | null {
+  if (moveType.value === 'position') {
+    const xVal = parseFloat(x.value)
+    const yVal = parseFloat(y.value)
+    const zVal = parseFloat(z.value)
+
+    if (isNaN(xVal) || isNaN(yVal) || isNaN(zVal)) {
+      error.value = 'Invalid numeric values'
+      return null
+    }
+
+    // Position coordinates are camera-specific absolute values (not normalised to 0-1)
+    return { moveType: 'position', x: xVal, y: yVal, z: zVal }
+  } else if (moveType.value === 'direction') {
+    if (directions.value.length === 0) {
+      error.value = 'Select at least one direction'
+      return null
+    }
 
-  const xVal = parseFloat(x.value)
-  const yVal = parseFloat(y.value)
-  const zVal = parseFloat(z.value)
+    return { moveType: 'direction', direction: [...directions.value], stepSize: stepSize.value }
+  } else {
+    const rxVal = parseFloat(relativeX.value)
+    const ryVal = parseFloat(relativeY.value)
+
+    if (isNaN(rxVal) || isNaN(ryVal)) {
+      error.value = 'Invalid numeric values'
+      return null
+    }
 
-  if (isNaN(xVal) || isNaN(yVal) || isNaN(zVal)) {
-    error.value = 'Invalid numeric values'
-    return
+    if (rxVal < 0 || rxVal > 1 || ryVal < 0 || ryVal > 1) {
+      error.value = 'Values must be between 0 and 1'
+      return null
+    }
+
+    return { moveType: 'centerOn', relativeX: rxVal, relativeY: ryVal }
   }
+}
+
+async function apply() {
+  if (!props.cameraId || applying.value) return
 
-  applying.value = true
   error.value = null
 
-  const move = { moveType: 'position' as const, x: xVal, y: yVal, z: zVal }
-  const result = await movePtz(props.cameraId, move)
-  apiLog('movePtz', { cameraId: props.cameraId, move }, result.error ?? result.data, !!result.error)
+  const move = buildMove()
+  if (!move) return
 
-  applying.value = false
+  applying.value = true
+  try {
+    const result = await movePtz(props.cameraId, move)
+    apiLog('movePtz', { cameraId: props.cameraId, move }, result.error ?? result.data, !!result.error)
 
-  if (result.error) {
-    error.value = result.error.message
-  } else {
-    emit('move-complete')
+    if (result.error) {
+      error.value = result.error.message
+    } else {
+      emit('move-complete')
+    }
+  } finally {
+    applying.value = false
   }
 }
 </script>
@@ -60,39 +112,114 @@ async function apply() {
 <template>
   <div class="position-input" data-testid="position-input">
     <div class="input-row">
-      <label>X</label>
-      <input
-        v-model="x"
-        type="number"
-        step="0.01"
-        :disabled="!cameraId || applying"
-        data-testid="input-x"
-        @keyup.enter="apply"
-      />
-    </div>
-    <div class="input-row">
-      <label>Y</label>
-      <input
-        v-model="y"
-        type="number"
-        step="0.01"
-        :disabled="!cameraId || applying"
-        data-testid="input-y"
-        @keyup.enter="apply"
-      />
-    </div>
-    <div class="input-row">
-      <label>Z</label>
-      <input
-        v-model="z"
-        type="number"
-        step="0.1"
-        min="0"
-        :disabled="!cameraId || applying"
-        data-testid="input-z"
-        @keyup.enter="apply"
-      />
+      <label>Move</label>
+      <select v-model="moveType" :disabled="!cameraId || applying" data-testid="move-type-select">
+        <option value="position">Position</option>
+        <option value="direction">Direction</option>
+        <option value="centerOn">Center On</option>
+      </select>
     </div>
+
+    <!-- Position fields -->
+    <template v-if="moveType === 'position'">
+      <div class="input-row">
+        <label>X</label>
+        <input
+          v-model="x"
+          type="number"
+          step="0.01"
+          :disabled="!cameraId || applying"
+          data-testid="input-x"
+          @keyup.enter="apply"
+        />
+      </div>
+      <div class="input-row">
+        <label>Y</label>
+        <input
+          v-model="y"
+          type="number"
+          step="0.01"
+          :disabled="!cameraId || applying"
+          data-testid="input-y"
+          @keyup.enter="apply"
+        />
+      </div>
+      <div class="input-row">
+        <label>Z</label>
+        <input
+          v-model="z"
+          type="number"
+          step="0.1"
+          min="0"
+          :disabled="!cameraId || applying"
+          data-testid="input-z"
+          @keyup.enter="apply"
+        />
+      </div>
+      <button
+        class="import-btn"
+        :disabled="!cameraId || !currentPosition || applying"
+        @click="importPosition"
+        data-testid="import-position"
+      >
+        Import Current Position
+      </button>
+    </template>
+
+    <!-- Direction fields -->
+    <template v-else-if="moveType === 'direction'">
+      <div class="direction-checkboxes">
+        <label v-for="dir in allDirections" :key="dir" class="checkbox-label">
+          <input
+            type="checkbox"
+            :value="dir"
+            v-model="directions"
+            :disabled="!cameraId || applying"
+            :data-testid="'dir-' + dir"
+          />
+          {{ dir }}
+        </label>
+      </div>
+      <div class="input-row">
+        <label>Step</label>
+        <select v-model="stepSize" :disabled="!cameraId || applying" data-testid="step-size-select">
+          <option value="small">Small</option>
+          <option value="medium">Medium</option>
+          <option value="large">Large</option>
+        </select>
+      </div>
+    </template>
+
+    <!-- CenterOn fields -->
+    <template v-else>
+      <div class="input-row">
+        <label>rX</label>
+        <input
+          v-model="relativeX"
+          type="number"
+          step="0.01"
+          min="0"
+          max="1"
+          :disabled="!cameraId || applying"
+          data-testid="input-relative-x"
+          @keyup.enter="apply"
+        />
+      </div>
+      <div class="input-row">
+        <label>rY</label>
+        <input
+          v-model="relativeY"
+          type="number"
+          step="0.01"
+          min="0"
+          max="1"
+          :disabled="!cameraId || applying"
+          data-testid="input-relative-y"
+          @keyup.enter="apply"
+        />
+      </div>
+    </template>
+
     <button
       class="apply-btn"
       :disabled="!cameraId || applying"
@@ -127,7 +254,7 @@ async function apply() {
   font-size: 13px;
   font-weight: 600;
   color: #555;
-  min-width: 20px;
+  min-width: 32px;
   text-align: right;
 }
 
@@ -140,10 +267,61 @@ async function apply() {
   font-family: monospace;
 }
 
-.input-row input:disabled {
+.input-row select {
+  flex: 1;
+  padding: 5px 8px;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  font-size: 13px;
+}
+
+.input-row input:disabled,
+.input-row select:disabled {
   opacity: 0.5;
 }
 
+.direction-checkboxes {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 4px 12px;
+  margin-bottom: 8px;
+}
+
+.checkbox-label {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 13px;
+  color: #555;
+  cursor: pointer;
+  text-transform: capitalize;
+}
+
+.checkbox-label input[type="checkbox"] {
+  margin: 0;
+}
+
+.import-btn {
+  width: 100%;
+  padding: 6px;
+  font-size: 11px;
+  background: #6c757d;
+  color: white;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  margin-bottom: 4px;
+}
+
+.import-btn:hover:not(:disabled) {
+  background: #5a6268;
+}
+
+.import-btn:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+
 .apply-btn {
   width: 100%;
   padding: 8px;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "een-api-toolkit",
-  "version": "0.3.91",
+  "version": "0.3.101",
   "description": "EEN Video platform API v3.0 library for Vue 3",
   "type": "module",
   "main": "./dist/index.cjs",