@virtualdisplay.io/client 3.7.0 → 4.0.0-alpha.1

package/package.json

@@ -1,57 +1,11 @@
 {
   "name": "@virtualdisplay.io/client",
   "description": "TypeScript-first 3D model integration library with iframe-based architecture",
-  "version": "3.7.0",
+  "version": "4.0.0-alpha.1",
   "author": "Virtualdisplay <support@virtualdisplay.io>",
-  "browserslist": [
-    "last 2 Chrome versions",
-    "last 2 Firefox versions",
-    "last 2 Safari versions",
-    "last 2 Edge versions"
-  ],
-  "bugs": {
-    "url": "https://github.com/virtualdisplay-io/client/issues"
-  },
-  "bundledDependencies": [
-    "@virtualdisplay-io/logger"
-  ],
-  "dependencies": {
-    "@virtualdisplay-io/logger": "1.2.0",
-    "ajv": "8.17.1"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.32.0",
-    "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/exec": "7.1.0",
-    "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^11.0.3",
-    "@semantic-release/npm": "^12.0.2",
-    "@semantic-release/release-notes-generator": "^14.0.3",
-    "@types/node": "^24.1.0",
-    "@typescript-eslint/eslint-plugin": "^8.38.0",
-    "@typescript-eslint/parser": "^8.38.0",
-    "@virtualdisplay-io/shared-config": "^1.4.0",
-    "@vitest/coverage-v8": "^3.2.4",
-    "conventional-changelog-conventionalcommits": "9.1.0",
-    "eslint": "^9.32.0",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsx-a11y": "^6.10.2",
-    "eslint-plugin-prettier": "^5.5.3",
-    "eslint-plugin-unicorn": "^60.0.0",
-    "globals": "^16.3.0",
-    "jsdom": "^26.1.0",
-    "markdownlint-cli2": "^0.18.1",
-    "markdownlint-cli2-formatter-pretty": "^0.0.8",
-    "prettier": "^3.6.2",
-    "semantic-release": "^24.2.7",
-    "terser": "^5.43.1",
-    "typescript": "^5.8.3",
-    "vite": "^7.0.6",
-    "vite-bundle-visualizer": "^1.2.1",
-    "vite-plugin-dts": "^4.5.4",
-    "vitest": "^3.2.4"
-  },
+  "homepage": "https://virtualdisplay.io",
+  "license": "MIT",
+  "type": "module",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -59,14 +13,17 @@
       "require": "./dist/virtualdisplay.client.cjs.js"
     }
   },
+  "main": "dist/virtualdisplay.client.cjs.js",
+  "module": "dist/virtualdisplay.client.es.js",
+  "types": "dist/index.d.ts",
   "files": [
     "dist",
-    "schemas",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
+    "CHANGELOG.md"
   ],
-  "homepage": "https://github.com/virtualdisplay-io/client#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
   "keywords": [
     "3d",
     "iframe",
@@ -74,46 +31,5 @@
     "typescript",
     "visualization",
     "webgl"
-  ],
-  "license": "MIT",
-  "main": "dist/virtualdisplay.client.cjs.js",
-  "module": "dist/virtualdisplay.client.es.js",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/virtualdisplay-io/client.git"
-  },
-  "scripts": {
-    "analyze": "vite-bundle-visualizer --template treemap --output stats.html --open false",
-    "build": "tsc -p tsconfig.build.json && vite build",
-    "coverage": "vitest run --coverage --reporter=verbose",
-    "coverage:feature": "vitest run test/feature --coverage --reporter=verbose",
-    "coverage:integration": "vitest run test/integration --coverage --reporter=verbose",
-    "coverage:unit": "vitest run test/unit --coverage --reporter=verbose",
-    "dev": "vite build --watch",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "lint": "pnpm run lint:eslint && pnpm run lint:md && pnpm run lint:types && pnpm run lint:format",
-    "lint:eslint": "eslint .",
-    "lint:eslint:fix": "eslint . --fix",
-    "lint:fix": "pnpm run lint:eslint:fix && pnpm run lint:md:fix && pnpm run lint:format:fix && npx fixpack",
-    "lint:format": "prettier --check .",
-    "lint:format:fix": "prettier --write .",
-    "lint:md": "markdownlint-cli2 '**/*.md' --config .markdownlint-cli2.jsonc",
-    "lint:md:fix": "markdownlint-cli2 '**/*.md' --config .markdownlint-cli2.jsonc --fix",
-    "lint:types": "tsc --noEmit",
-    "prepare": "node -e \"if (!process.env.CI) require('child_process').execSync('pnpm build', {stdio: 'inherit'})\"",
-    "release": "semantic-release",
-    "test": "vitest run",
-    "test:feature": "vitest run test/feature",
-    "test:integration": "vitest run test/integration",
-    "test:unit": "vitest run test/unit",
-    "test:watch": "vitest",
-    "type-check": "tsc --noEmit"
-  },
-  "type": "module",
-  "types": "dist/index.d.ts"
-}
+  ]
+}

package/README.npm.md

@@ -1,78 +0,0 @@
-# Virtualdisplay client
-
-TypeScript library for embedding interactive 3D product models in web applications.
-
-## Installation
-
-```bash
-npm install @virtualdisplay.io/client
-# or
-pnpm add @virtualdisplay.io/client
-# or
-yarn add @virtualdisplay.io/client
-```
-
-## Quick start
-
-### Simple product (no options)
-
-```typescript
-import { VirtualdisplayClient } from '@virtualdisplay.io/client';
-
-// That's it! Your 3D model is now displayed
-const client = new VirtualdisplayClient({
-  parent: '#product-container',
-  license: 'your-license-key',
-  model: 'statue-model',
-});
-```
-
-### Configurable product (with options)
-
-```typescript
-import { VirtualdisplayClient } from '@virtualdisplay.io/client';
-
-// Create client instance
-const client = new VirtualdisplayClient({
-  parent: '#product-container',
-  license: 'your-license-key',
-  model: 'sneaker',
-});
-
-// Map product options to 3D parts
-client.setMapping({
-  attributes: [
-    {
-      name: 'Color',
-      values: [
-        { value: 'Red', nodeIds: ['laces_red', 'sole_red'], isSelected: true },
-        { value: 'Blue', nodeIds: ['laces_blue', 'sole_blue'] },
-      ],
-    },
-  ],
-});
-
-// Control via product options
-client.getAttribute('Color')?.select('Red');
-```
-
-## Key features
-
-- **Simple API**: Attribute-based product configuration
-- **Fire-and-forget**: Send commands without waiting for responses
-- **State sync**: Automatic synchronization between client and 3D viewer
-- **Framework-agnostic**: Works with React, Vue, Angular, or vanilla JS
-- **TypeScript first**: Full type safety and IntelliSense support
-- **Minimal dependencies**: Only essential validation and logging included
-
-## Documentation
-
-For complete documentation including:
-
-- API reference
-- Advanced examples
-- Integration guides
-- Architecture diagrams
-- Troubleshooting
-
-Visit our [GitHub repository](https://github.com/virtualdisplay-io/client)

package/node_modules/@virtualdisplay-io/logger/CHANGELOG.md

@@ -1,82 +0,0 @@
-# [1.2.0](https://github.com/virtualdisplay-io/logger/compare/v1.1.2...v1.2.0) (2025-06-13)
-
-
-### Features
-
-* simplify logger API by removing environment detection ([#11](https://github.com/virtualdisplay-io/logger/issues/11)) ([8580f93](https://github.com/virtualdisplay-io/logger/commit/8580f93eb2b9eb7dd6fc6b4ae90b5512ac9b55bc))
-
-## [1.1.2](https://github.com/virtualdisplay-io/logger/compare/v1.1.1...v1.1.2) (2025-06-08)
-
-
-### Bug Fixes
-
-* resolve linting issues in console-transport ([#8](https://github.com/virtualdisplay-io/logger/issues/8)) ([10b8f1a](https://github.com/virtualdisplay-io/logger/commit/10b8f1adaf3ed04efb6c46ace9194f39c8d60b00))
-
-## [1.1.1](https://github.com/virtualdisplay-io/logger/compare/v1.1.0...v1.1.1) (2025-06-08)
-
-
-### Bug Fixes
-
-* remove hardcoded VirtualDisplay prefix from console transport ([f3734d5](https://github.com/virtualdisplay-io/logger/commit/f3734d5f3b66c9a1e190a13e7c91f9021543324c))
-
-# [1.1.0](https://github.com/virtualdisplay-io/logger/compare/v1.0.1...v1.1.0) (2025-06-08)
-
-
-### Features
-
-* update semantic-release config to match client library ([ec76794](https://github.com/virtualdisplay-io/logger/commit/ec7679460926ec5423fad52a9859ef34d547a9ef))
-
-## [1.0.1](https://github.com/virtualdisplay-io/logger/compare/v1.0.0...v1.0.1) (2025-06-08)
-
-
-### Bug Fixes
-
-* ensure production build is created before release ([#7](https://github.com/virtualdisplay-io/logger/issues/7)) ([459af10](https://github.com/virtualdisplay-io/logger/commit/459af105c3e6e123b75f4cb96bbaa5c89722fdb8))
-
-# 1.0.0 (2025-06-08)
-
-
-### Features
-
-* initial Virtual Display Logger implementation ([dcbda81](https://github.com/virtualdisplay-io/logger/commit/dcbda81cf31a097eed8df61a6d5294a8b0d9f1c4))
-
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Added
-- Initial release of @virtualdisplay-io/logger
-- Core logging functionality with debug, info, warn, error levels
-- Singleton pattern with Logger.getInstance()
-- Child logger support with context inheritance
-- Multiple transport system (Console, Memory)
-- Formatter system (Context, JSON)
-- Environment-aware logging
-- Test environment auto-detection
-- TypeScript support with full type definitions
-- Comprehensive test suite with 100% coverage
-- Zero dependencies
-- Browser and Node.js compatibility
-- Memory transport with querying and export capabilities
-- Global muting functionality
-- Configurable log levels and filtering
-
-### Features
-- **ConsoleTransport**: Console output with colors and timestamps
-- **MemoryTransport**: In-memory log storage with search and export
-- **ContextFormatter**: Appends context data to messages
-- **JSONFormatter**: Full JSON serialization of log entries
-- **Child Loggers**: Hierarchical logging with context merging
-- **Smart Environment Detection**: Automatic test environment detection
-- **Performance Optimized**: Zero runtime dependencies, efficient memory usage
-- **Developer Experience**: Comprehensive TypeScript types, clear API
-
-## [1.0.0] - 2025-01-XX
-
-### Added
-- Initial stable release

package/node_modules/@virtualdisplay-io/logger/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Virtual Display
-
-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.

package/node_modules/@virtualdisplay-io/logger/README.md

@@ -1,314 +0,0 @@
-# @virtualdisplay-io/logger
-
-A simple, TypeScript-first logging library for browser and Node.js applications.
-
-[![GitHub Package](https://img.shields.io/badge/%40virtualdisplay--io%2Flogger-GitHub%20Package-blue)](https://github.com/virtualdisplay-io/logger/packages)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
-
-## Features
-
-- **Simple API** - Just `enabled` and `level`, no complex configuration
-- **TypeScript Native** - Full type safety and autocompletion
-- **Lightweight** - ~3KB gzipped, zero dependencies
-- **Visual Clarity** - Emoji indicators and colors for log levels (📘 ⚠️ ❌ 🐛)
-- **Universal** - Works in Node.js, browsers, and workers
-- **Extensible** - Custom transports and formatters
-- **Memory Transport** - Built-in log analysis and debugging
-- **Child Loggers** - Contextual logging with inherited settings
-
-## Installation
-
-This package is published to GitHub Packages. First, configure your npm to use the GitHub Package Registry:
-
-```bash
-echo "@virtualdisplay-io:registry=https://npm.pkg.github.com" >> .npmrc
-```
-
-Then install the package:
-
-```bash
-npm install @virtualdisplay-io/logger
-```
-
-```bash
-yarn add @virtualdisplay-io/logger
-```
-
-```bash
-pnpm add @virtualdisplay-io/logger
-```
-
-## Quick Start
-
-```typescript
-import { logger } from '@virtualdisplay-io/logger';
-
-// The default logger has no prefix - clean and neutral
-logger.info('Application started');      // 📘 Application started
-logger.warn('This is a warning');        // ⚠️ This is a warning
-logger.error('Something went wrong', { userId: '123' }); // ❌ Something went wrong
-
-// Create a logger with your own prefix
-import { Logger } from '@virtualdisplay-io/logger';
-
-const appLogger = new Logger({ prefix: 'MyApp' });
-appLogger.info('Application started');   // 📘 [MyApp] Application started
-```
-
-## Advanced Usage
-
-### Simple Configuration
-
-```typescript
-import { Logger } from '@virtualdisplay-io/logger';
-
-const logger = new Logger({
-  prefix: 'MyApp',
-  level: 'info',         // Only show info, warn, and error
-  enabled: true,         // Turn logging on/off
-  colors: true,          // Enable colors in browser (default: true)
-  context: { version: '1.0.0' }
-});
-
-logger.info('Server started');    // Shows (info level or higher)
-logger.debug('Cache cleared');    // Hidden (below info level)
-```
-
-### Control Log Levels
-
-```typescript
-// Set level dynamically
-logger.setLevel('debug');         // Now debug messages will show
-logger.setLevel('error');         // Only errors will show
-
-// Turn logging on/off
-logger.setEnabled(false);         // All logging disabled
-logger.setEnabled(true);          // Logging re-enabled
-```
-
-### Child Loggers
-
-```typescript
-import { Logger } from '@virtualdisplay-io/logger';
-
-// Create a base logger without prefix
-const baseLogger = new Logger();
-
-// Create child logger with additional context
-const authLogger = baseLogger.child({
-  prefix: 'Auth',
-  context: { module: 'authentication' },
-});
-
-const userLogger = authLogger.child({
-  context: { userId: '123', action: 'login' },
-});
-
-userLogger.info('User login attempt');
-// Output: [timestamp] [Auth] INFO: User login attempt {module="authentication" userId="123" action="login"}
-
-// Or add a prefix to the default logger
-import { logger } from '@virtualdisplay-io/logger';
-const apiLogger = logger.child({ prefix: 'API', context: { service: 'users' } });
-// Output will have [API] prefix
-```
-
-
-### Custom Formatters
-
-```typescript
-import { Logger } from '@virtualdisplay-io/logger';
-import type { LogFormatter, LogEntry } from '@virtualdisplay-io/logger';
-
-class CustomFormatter implements LogFormatter {
-  name = 'custom';
-
-  format(entry: LogEntry): LogEntry {
-    return {
-      ...entry,
-      message: `🎯 ${entry.message.toUpperCase()}`,
-    };
-  }
-}
-
-const logger = new Logger({
-  formatters: [new CustomFormatter()],
-});
-
-logger.info('hello world'); // Output: 🎯 HELLO WORLD
-```
-
-### Memory Transport for Log Analysis
-
-```typescript
-import { Logger } from '@virtualdisplay-io/logger';
-
-// Memory transport is loaded dynamically to keep bundle size small
-const logger = new Logger();
-
-// Enable memory logging when needed
-await logger.enableMemoryLogging(500); // Store max 500 entries
-
-// Log some events
-logger.info('User created', { userId: '123' });
-logger.warn('Rate limit exceeded', { ip: '192.168.1.1' });
-logger.error('Database connection failed');
-
-// Use the logger's debug methods to analyze logs
-const allLogs = JSON.parse(logger.exportLogs());
-const errors = logger.getRecentErrors();
-const searchResults = logger.searchLogs(/database/i);
-
-// Export logs
-console.log(logger.exportLogs());     // JSON format
-console.log(logger.exportLogsCSV());  // CSV format
-```
-
-### Global Muting
-
-```typescript
-import { Logger } from '@virtualdisplay-io/logger';
-
-// Mute all logger instances
-Logger.setMute(true);
-logger.info('This will not be logged');
-
-// Unmute
-Logger.setMute(false);
-logger.info('This will be logged');
-```
-
-## API Reference
-
-### Logger Class
-
-#### Basic methods:
-- `debug(message: string, ...args: unknown[]): void`
-- `info(message: string, ...args: unknown[]): void`
-- `warn(message: string, ...args: unknown[]): void`
-- `error(message: string, ...args: unknown[]): void`
-- `child(options?: Partial<LoggerOptions>): Logger`
-
-#### Configuration methods:
-- `setLevel(level: LogLevel): void` - Set the minimum log level
-- `getLevel(): LogLevel` - Get the current log level
-- `setEnabled(enabled: boolean): void` - Enable/disable logging
-- `isEnabled(): boolean` - Check if logging is enabled
-
-#### Transport & Formatter methods:
-- `addTransport(transport: LogTransport): void`
-- `removeTransport(name: string): void`
-- `getTransport(name: string): LogTransport | undefined`
-- `addFormatter(formatter: LogFormatter): void`
-- `removeFormatter(name: string): void`
-- `getFormatter(name: string): LogFormatter | undefined`
-
-#### Debug methods (when memory transport is added):
-- `enableMemoryLogging(maxSize?: number): Promise<void>`
-- `exportLogs(): string` - Export logs as JSON
-- `exportLogsCSV(): string` - Export logs as CSV
-- `getRecentErrors(minutes?: number): LogEntry[]`
-- `searchLogs(query: string | RegExp): LogEntry[]`
-- `clearLogs(): void`
-
-### Log Levels
-
-- `debug` (0) - Detailed debugging information
-- `info` (1) - General information
-- `warn` (2) - Warning messages
-- `error` (3) - Error messages
-
-### Built-in Transports
-
-- **ConsoleTransport** - Outputs to console with colors, emojis, and grouped logging
-  - Colors for visual clarity (can be disabled)
-  - Collapsible groups showing origin and arguments
-  - Automatic fallback for environments without color support
-- **MemoryTransport** - Stores logs in memory with query capabilities (loaded on-demand)
-
-### Built-in Formatters
-
-- **ContextFormatter** - Appends context data to log messages
-- **JSONFormatter** - Converts log entries to JSON format
-
-## Browser Support
-
-- **Modern browsers** (ES2022+)
-- **Node.js** 18+
-
-## Debug Features
-
-The logger includes some basic debug features when using the memory transport:
-
-```typescript
-import { logger } from '@virtualdisplay-io/logger';
-
-// Enable memory logging to store logs
-await logger.enableMemoryLogging(1000); // Store max 1000 log entries
-
-// Export logs as JSON
-const logs = logger.exportLogs();
-
-// Export logs as CSV
-const csv = logger.exportLogsCSV();
-
-// Get recent errors
-const errors = logger.getRecentErrors();
-
-// Search logs
-const searchResults = logger.searchLogs('search term');
-```
-
-
-## Basic Example
-
-```typescript
-import { Logger } from '@virtualdisplay-io/logger';
-
-// Create a logger for your application
-const appLogger = new Logger({ prefix: 'MyApp' });
-
-// Log some messages
-appLogger.info('Application started');
-appLogger.warn('This is a warning');
-appLogger.error('An error occurred');
-
-// Create child loggers with context
-const userLogger = appLogger.child({
-  context: { userId: '123', module: 'auth' }
-});
-
-userLogger.info('User logged in');
-```
-
-## Examples
-
-The `examples/` directory contains focused examples for each feature:
-
-- **`basic-usage.ts`** - Getting started, log levels, prefixes
-- **`child-loggers.ts`** - Hierarchical logging with context inheritance  
-- **`memory-transport.ts`** - Log analysis and debugging commands
-- **`custom-colors.ts`** - Customize visual appearance
-- **`custom-transports.ts`** - Create your own logging destinations
-- **`formatters.ts`** - Transform log messages before output
-- **`grouped-logging.ts`** - Collapsible browser console groups
-- **`advanced-usage.ts`** - Multiple features working together
-- **`production-setup.ts`** - Real-world production configuration
-
-Run any example with:
-```bash
-npx tsx examples/basic-usage.ts
-```
-
-## Contributing
-
-Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details.
-
-## License
-
-MIT © [Virtual Display](LICENSE)
-
----
-
-Built with ❤️ by the Virtual Display team