v1.7.1

fix(build): migrate smart config setup and align TypeScript compatibility updates
v1.7.0
2026-04-02 12:50:20 +00:00 · 2026-04-02 12:50:20 +00:00 · 2026-01-02 10:59:51 +00:00 · 2026-01-02 10:59:51 +00:00
18 changed files with 3103 additions and 2900 deletions
@@ -17,6 +17,20 @@
      "accessLevel": "public"
    }
  },
+  "@git.zone/tsbundle": {
+    "bundles": [
+      {
+        "from": "./ts_web/index.ts",
+        "to": "./dist_bundle/bundle.js",
+        "outputMode": "bundle",
+        "bundler": "esbuild",
+        "production": true
+      }
+    ]
+  },
+  "@git.zone/tswatch": {
+    "preset": "element"
+  },
  "@ship.zone/szci": {
    "npmRegistryUrl": "verdaccio.lossless.one",
    "npmGlobalTools": []
@@ -1,7 +1,7 @@
 {
  "json.schemas": [
    {
-      "fileMatch": ["/npmextra.json"],
+      "fileMatch": ["/.smartconfig.json"],
      "schema": {
        "type": "object",
        "properties": {
@@ -1,5 +1,22 @@
 # Changelog

+## 2026-04-02 - 1.7.1 - fix(build)
+migrate smart config setup and align TypeScript compatibility updates
+
+- replace npmextra.json with .smartconfig.json and simplify build/watch script usage
+- update runtime and development dependencies to newer versions
+- rename browser tests to the Chromium-specific convention expected by the test tooling
+- add explicit property initializers and non-null assertions to satisfy stricter TypeScript checks
+
+## 2026-01-02 - 1.7.0 - feat(recorder)
+lazy-load rrweb and rrweb-player from CDN via SioServiceLibLoader and switch sio-recorder to use the loader
+
+- Add SioServiceLibLoader service to lazy-load rrweb and rrweb-player (and inject rrweb-player CSS)
+- Add versions file (CDN_VERSIONS and CDN_BASE) and export loader from ts_web/index.ts
+- Update sio-recorder to use the loader for recording and playback instead of bundling rrweb/rrweb-player
+- Remove rrweb, rrweb-player and rrweb-snapshot from dependencies and bump lucide and @design.estate/dees-wcctools versions
+- Small package.json changes: remove --skiplibcheck from build script and bump @git.zone/tstest devDependency
+
 ## 2025-12-18 - 1.6.1 - fix(sio-combox)
 tweak dropdown shadow and bind close event on conversation selector

@@ -1,56 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Social.io Catalog Demo</title>
-    <style>
-        body {
-            margin: 0;
-            padding: 20px;
-            font-family: sans-serif;
-            background: #f5f5f5;
-        }
-        .demo-section {
-            margin: 20px 0;
-            padding: 20px;
-            background: white;
-            border-radius: 8px;
-            box-shadow: 0 2px 10px rgba(0,0,0,0.1);
-        }
-        h2 {
-            margin-top: 0;
-        }
-        .component-container {
-            position: relative;
-            height: 600px;
-            margin: 20px 0;
-            border: 1px solid #ddd;
-            border-radius: 4px;
-            overflow: hidden;
-        }
-        sio-combox {
-            position: relative !important;
-            width: 100% !important;
-            height: 100% !important;
-            right: auto !important;
-        }
-    </style>
-    <script type="module" src="./dist_bundle/bundle.js"></script>
-</head>
-<body>
-    <div class="demo-section">
-        <h2>Combox Component</h2>
-        <div class="component-container">
-            <sio-combox></sio-combox>
-        </div>
-    </div>
-
-    <div class="demo-section">
-        <h2>FAB with Combox</h2>
-        <div style="position: relative; height: 700px;">
-            <sio-fab showCombox></sio-fab>
-        </div>
-    </div>
-</body>
-</html>
@@ -1,4 +1,4 @@
-Copyright (c) 2020 Lossless GmbH (hello@lossless.com)
+Copyright (c) 2020 Task Venture Capital GmbH (hello@task.vc)

 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -1,6 +1,6 @@
 {
  "name": "@social.io/catalog",
-  "version": "1.6.1",
+  "version": "1.7.1",
  "private": false,
  "description": "catalog for social.io",
  "main": "dist_ts_web/index.js",
@@ -8,32 +8,28 @@
  "type": "module",
  "scripts": {
    "test": "tstest test/",
-    "build": "tsbuild tsfolders --allowimplicitany --skiplibcheck && tsbundle element --production",
-    "watch": "tswatch element",
+    "build": "tsbuild tsfolders --allowimplicitany --skiplibcheck && tsbundle",
+    "watch": "tswatch",
    "buildDocs": "tsdoc"
  },
  "author": "Lossless GmbH",
  "license": "UNLICENSED",
  "dependencies": {
-    "@design.estate/dees-domtools": "^2.3.6",
-    "@design.estate/dees-element": "^2.1.3",
-    "@design.estate/dees-wcctools": "^2.0.1",
-    "@losslessone_private/loint-pubapi": "^1.0.14",
+    "@design.estate/dees-domtools": "^2.5.1",
+    "@design.estate/dees-element": "^2.2.3",
+    "@design.estate/dees-wcctools": "^3.8.0",
    "@social.io/interfaces": "^1.2.1",
-    "lucide": "^0.561.0",
-    "rrweb": "2.0.0-alpha.4",
-    "rrweb-player": "1.0.0-alpha.4",
-    "rrweb-snapshot": "2.0.0-alpha.4"
+    "lucide": "^1.6.0"
  },
  "devDependencies": {
-    "@git.zone/tsbuild": "^4.0.2",
-    "@git.zone/tsbundle": "^2.6.3",
-    "@git.zone/tsrun": "^2.0.1",
-    "@git.zone/tstest": "^3.1.3",
-    "@git.zone/tswatch": "^2.3.13",
+    "@git.zone/tsbuild": "^4.4.0",
+    "@git.zone/tsbundle": "^2.10.0",
+    "@git.zone/tsrun": "^2.0.2",
+    "@git.zone/tstest": "^3.6.0",
+    "@git.zone/tswatch": "^3.3.2",
    "@push.rocks/projectinfo": "^5.0.2",
    "@push.rocks/smartenv": "^6.0.0",
-    "@types/node": "^25.0.3"
+    "@types/node": "^25.5.0"
  },
  "files": [
    "ts/**/*",
@@ -44,7 +40,7 @@
    "dist_ts_web/**/*",
    "assets/**/*",
    "cli.js",
-    "npmextra.json",
+    ".smartconfig.json",
    "readme.md"
  ],
  "browserslist": [
@@ -1,6 +1,6 @@
 # @social.io/catalog

-A modern, beautifully designed UI component library for building conversational interfaces and support chat experiences. Built with Lit Element and TypeScript.
+A modern, beautifully crafted UI component library for building conversational interfaces and support chat experiences. Built with [Lit Element](https://lit.dev/) and TypeScript, featuring a shadcn-inspired design system with full dark mode support. 🚀

 ## Issue Reporting and Security

@@ -8,20 +8,19 @@ For reporting bugs, issues, or security vulnerabilities, please visit [community

 ## 🎯 Features

- **Complete Chat UI** - Ready-to-use conversation components with message threads, typing indicators, and attachments
- **Floating Action Button** - Eye-catching FAB with smooth animations for triggering the chat interface
- **PDF Viewer** - Built-in PDF rendering with zoom, pagination, and download capabilities
- **Image Lightbox** - Full-featured lightbox with zoom, pan, and keyboard navigation
- **Modern Design Tokens** - Consistent styling with customizable colors, spacing, typography, and shadows
- **Dark Mode Ready** - Full light/dark theme support out of the box
- **Accessibility** - Keyboard navigation and proper ARIA attributes
- **TypeScript First** - Full type definitions for all components
+- **Complete Chat UI** — Ready-to-use conversation components with message threads, typing indicators, and file attachments
+- **Floating Action Button** — Eye-catching FAB with smooth gradient animations and glow effects
+- **PDF Viewer** — Built-in PDF rendering with zoom, pagination, and download capabilities
+- **Image Lightbox** — Full-featured lightbox with zoom, pan, and keyboard navigation
+- **Design Token System** — Comprehensive tokens for colors, spacing, typography, shadows, and animations
+- **Dark Mode Ready** — Full light/dark theme support out of the box via `bdTheme()` helper
+- **Accessibility** — Keyboard navigation and proper ARIA attributes throughout
+- **TypeScript First** — Full type definitions and IntelliSense for all components
+- **Lazy-loaded Libraries** — rrweb for session recording is loaded on-demand from CDN via `SioServiceLibLoader`

 ## 📦 Installation

 ```bash
-npm install @social.io/catalog
-# or
 pnpm add @social.io/catalog
 ```

@@ -30,8 +29,7 @@ pnpm add @social.io/catalog
 ```typescript
 import { SioFab, SioCombox } from '@social.io/catalog';

-// Components auto-register as custom elements
-// Just use them in your HTML:
+// Components auto-register as custom elements — just drop them into your HTML:
 ```

 ```html
@@ -46,54 +44,74 @@ import { SioFab, SioCombox } from '@social.io/catalog';

 ### Core Components

-| Component | Description |
-|-----------|-------------|
-| `<sio-fab>` | Floating action button with animated chat icon |
-| `<sio-combox>` | Complete chat interface with conversation list and message view |
-| `<sio-button>` | Styled button with variants (primary, secondary, destructive, outline, ghost) |
-| `<sio-icon>` | Lucide icon wrapper with size and color customization |
-| `<sio-dropdown-menu>` | Animated dropdown menu with keyboard support |
+| Component | Tag | Description |
+|-----------|-----|-------------|
+| `SioFab` | `<sio-fab>` | Floating action button with animated gradient, glow effects, and pulse animation |
+| `SioCombox` | `<sio-combox>` | Complete chat interface combining conversation list, message view, and input |
+| `SioButton` | `<sio-button>` | Styled button with variants: `primary`, `secondary`, `destructive`, `outline`, `ghost` |
+| `SioIcon` | `<sio-icon>` | [Lucide](https://lucide.dev/) icon wrapper with size, color, and strokeWidth customization |
+| `SioDropdownMenu` | `<sio-dropdown-menu>` | Animated dropdown menu with keyboard support and auto-positioning |

 ### Conversation Components

-| Component | Description |
-|-----------|-------------|
-| `<sio-conversation-selector>` | Searchable list of conversations with unread indicators |
-| `<sio-conversation-view>` | Message thread with typing indicators and file attachments |
-| `<sio-message-input>` | Auto-expanding textarea with file upload |
+| Component | Tag | Description |
+|-----------|-----|-------------|
+| `SioConversationSelector` | `<sio-conversation-selector>` | Searchable list of conversations with unread indicators and status badges |
+| `SioConversationView` | `<sio-conversation-view>` | Message thread with typing indicators, timestamps, and file attachment support |
+| `SioMessageInput` | `<sio-message-input>` | Auto-expanding textarea with file upload capabilities |

 ### Media Components

-| Component | Description |
-|-----------|-------------|
-| `<sio-image-lightbox>` | Fullscreen image viewer with zoom and pan |
-| `<sio-pdf-viewer>` | PDF renderer with page navigation and zoom controls |
+| Component | Tag | Description |
+|-----------|-----|-------------|
+| `SioImageLightbox` | `<sio-image-lightbox>` | Fullscreen image viewer with zoom, pan, and keyboard navigation; also handles PDF files |
+| `SioPdfViewer` | `<sio-pdf-viewer>` | PDF renderer with page navigation, zoom controls, and download button |

 ### Utility Components

-| Component | Description |
-|-----------|-------------|
-| `<sio-recorder>` | Session recording using rrweb |
+| Component | Tag | Description |
+|-----------|-----|-------------|
+| `SioRecorder` | `<sio-recorder>` | Session recording and playback using [rrweb](https://www.rrweb.io/), lazy-loaded from CDN |

-## 💅 Styling & Theming
+### Services

-The library uses CSS custom properties for theming. The design system includes:
+| Export | Description |
+|--------|-------------|
+| `SioServiceLibLoader` | CDN-based lazy loader for rrweb and rrweb-player libraries |

- **Colors** - Primary, secondary, accent, destructive, muted, and semantic colors
- **Typography** - System font stack with size and weight variants
- **Spacing** - Consistent spacing scale (0.5rem increments)
- **Radius** - Border radius tokens from sm to full
- **Shadows** - Elevation system from sm to 2xl
- **Transitions** - Smooth animation presets
+## 💅 Design System
+
+The library ships a comprehensive, shadcn/ui-inspired design token system. All tokens are exported so you can use them in your own components.
+
+### Colors
+
+```typescript
+import { colors, bdTheme } from '@social.io/catalog/elements/00colors.js';
+```
+
+Includes `primary`, `secondary`, `accent`, `destructive`, `muted`, `success`, `background`, `foreground`, `card`, `popover`, `border`, `input`, `ring`, and 5 chart colors — each with light and dark variants.
+
+### Spacing, Radius, Shadows & More
+
+```typescript
+import { spacing, radius, shadows, transitions, sizes, zIndex, breakpoints } from '@social.io/catalog/elements/00tokens.js';
+```
+
+- **Spacing** — Tailwind-compatible scale from `0` to `96` (0–384px)
+- **Radius** — From `sm` (2px) through `full` (9999px)
+- **Shadows** — Elevation system from `sm` to `2xl`, plus theme-aware `card` and `dropdown` shadows
+- **Transitions** — Presets (`all`, `colors`, `opacity`, `shadow`, `transform`) with timing functions
+- **Z-index** — Semantic layers: `dropdown`, `sticky`, `fixed`, `modal`, `popover`, `tooltip`
+- **Breakpoints** — `sm` (640px) through `2xl` (1536px)

 ### Dark Mode

-Dark mode is automatically supported. The components use `bdTheme()` helper that switches between light and dark values:
+Dark mode is automatically supported. Use the `bdTheme()` helper for theme-aware values:

 ```typescript
-import { bdTheme } from '@social.io/catalog';
+import { bdTheme } from '@social.io/catalog/elements/00colors.js';

-// Usage in styles
+// Returns the correct value based on the current theme
 css`
  background: ${bdTheme('hsl(0 0% 100%)', 'hsl(0 0% 10%)')};
 `
@@ -101,40 +119,55 @@ css`

 ## 📖 Usage Examples

-### Basic Chat FAB
+### 💬 Chat FAB

 ```html
 <sio-fab></sio-fab>
 ```

-The FAB opens a complete chat interface when clicked. It includes:
- Keyboard shortcut (Ctrl+S) to toggle
+The FAB positions itself at the bottom-right corner and opens a complete chat interface when clicked. It features:
+- Animated gradient background (indigo → violet → purple)
+- Glow effect on hover
 - Smooth scale and pulse animations
- Gradient background with glow effects

-### Custom Button Variants
+### 🔘 Buttons

 ```html
+<sio-button>Default</sio-button>
 <sio-button type="primary">Submit</sio-button>
 <sio-button type="destructive">Delete</sio-button>
 <sio-button type="outline">Cancel</sio-button>
 <sio-button type="ghost" size="sm">
  <sio-icon icon="settings"></sio-icon>
 </sio-button>
+<sio-button size="lg">Large</sio-button>
+<sio-button disabled>Disabled</sio-button>
 ```

-### Image Lightbox
+Sizes: `sm`, `default`, `lg`. Status: `normal`, `pending`, `success`, `error`.
+
+### 🖼️ Image Lightbox

 ```typescript
 const lightbox = document.querySelector('sio-image-lightbox');
-lightbox.open({
+
+// Open with an image
+await lightbox.open({
  url: 'https://example.com/photo.jpg',
  name: 'My Photo',
  size: 1024000
 });
+
+// Or open with a PDF
+await lightbox.open({
+  url: 'https://example.com/document.pdf',
+  name: 'report.pdf',
+  type: 'application/pdf',
+  size: 565000
+});
 ```

-### PDF Viewer
+### 📄 PDF Viewer

 ```html
 <sio-pdf-viewer
@@ -143,12 +176,13 @@ lightbox.open({
 ></sio-pdf-viewer>
 ```

-### Dropdown Menu
+### ☰ Dropdown Menu

 ```html
 <sio-dropdown-menu
  .items=${[
    { id: 'edit', label: 'Edit', icon: 'pencil' },
+    { id: 'divider', label: '', divider: true },
    { id: 'delete', label: 'Delete', icon: 'trash', destructive: true }
  ]}
  @item-selected=${(e) => console.log('Selected:', e.detail.item)}
@@ -159,6 +193,17 @@ lightbox.open({
 </sio-dropdown-menu>
 ```

+### 🎨 Icons
+
+Uses the full [Lucide](https://lucide.dev/) icon set. Pass kebab-case icon names:
+
+```html
+<sio-icon icon="search"></sio-icon>
+<sio-icon icon="message-square" color="#3b82f6"></sio-icon>
+<sio-icon icon="x" size="32"></sio-icon>
+<sio-icon icon="send" .strokeWidth=${3}></sio-icon>
+```
+
 ## 🔧 Development

 ```bash
@@ -168,23 +213,26 @@ pnpm install
 # Start development server with hot reload
 pnpm watch

-# Run tests
-pnpm test
-
 # Build for production
 pnpm build
+
+# Run tests (Chromium browser tests)
+pnpm test
 ```

 ## 📚 Dependencies

- **@design.estate/dees-element** - Lit Element base with utilities
- **@design.estate/dees-domtools** - DOM manipulation helpers
- **lucide** - Beautiful open-source icons
- **rrweb** - Session recording/replay (for recorder component)
+| Package | Purpose |
+|---------|---------|
+| [`@design.estate/dees-element`](https://www.npmjs.com/package/@design.estate/dees-element) | Lit Element base class with theming utilities |
+| [`@design.estate/dees-domtools`](https://www.npmjs.com/package/@design.estate/dees-domtools) | DOM manipulation and convenience helpers |
+| [`@design.estate/dees-wcctools`](https://www.npmjs.com/package/@design.estate/dees-wcctools) | Web component catalog tools |
+| [`lucide`](https://lucide.dev/) | Beautiful, consistent open-source icon set |
+| [`rrweb`](https://www.rrweb.io/) | Session recording/replay (lazy-loaded from CDN) |

 ## License and Legal Information

-This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [LICENSE](./LICENSE) file.
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [license](./license) file.

 **Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.

@@ -3,6 +3,6 @@
 */
 export const commitinfo = {
  name: '@social.io/catalog',
-  version: '1.6.1',
+  version: '1.7.1',
  description: 'catalog for social.io'
 }
@@ -58,7 +58,7 @@ export class SioCombox extends DeesElement {
  }

  @property({ type: Object })
-  public accessor referenceObject: HTMLElement;
+  public accessor referenceObject: HTMLElement = null as any;

  @state()
  private accessor selectedConversationId: string | null = null;
@@ -57,9 +57,9 @@ export class SioDropdownMenu extends DeesElement {
  @state()
  private accessor isOpen: boolean = false;

-  private documentClickHandler: (e: MouseEvent) => void;
-  private scrollHandler: () => void;
-  private resizeHandler: () => void;
+  private documentClickHandler!: (e: MouseEvent) => void;
+  private scrollHandler!: () => void;
+  private resizeHandler!: () => void;

  public static styles = [
    cssManager.defaultStyles,
@@ -29,7 +29,7 @@ export class SioIcon extends DeesElement {
  `;

  @property({ type: String })
-  public accessor icon: string;
+  public accessor icon: string = '';

  @property({ type: Number })
  public accessor size: number = 24;
@@ -140,7 +140,7 @@ export class SioIcon extends DeesElement {
        
        // Limit cache size
        if (SioIcon.iconCache.size > SioIcon.MAX_CACHE_SIZE) {
-          const firstKey = SioIcon.iconCache.keys().next().value;
+          const firstKey = SioIcon.iconCache.keys().next().value!;
          SioIcon.iconCache.delete(firstKey);
        }

@@ -523,7 +523,7 @@ export class SioPdfViewer extends DeesElement {
      this.renderTask = page.render(renderContext);
      await this.renderTask.promise;
    } catch (error) {
-      if (error.name !== 'RenderingCancelledException') {
+      if ((error as any).name !== 'RenderingCancelledException') {
        console.error('Error rendering page:', error);
      }
    }
@@ -6,11 +6,7 @@ import {
  property,
  query,
 } from '@design.estate/dees-element';
-import * as rrwebMod from 'rrweb';
-import rrwebPlayerMod from 'rrweb-player';
-
-const rrweb: any = rrwebMod;
-const rrwebPlayer: typeof rrwebPlayerMod.default = rrwebPlayerMod as any;
+import { SioServiceLibLoader } from '../services/SioServiceLibLoader.js';

 /**
 * Use rrweb's eventWithTime if you like strict typing:
@@ -106,6 +102,10 @@ export class SioRecorder extends DeesElement {
   */
  private async startRecording(): Promise<void> {
    await this.domtoolsPromise;
+
+    // Load rrweb from CDN
+    const rrweb = await SioServiceLibLoader.getInstance().loadRrweb();
+
    this.status = 'recording';
    this.events = [];

@@ -148,7 +148,12 @@ export class SioRecorder extends DeesElement {
  private async playRecording(): Promise<void> {
    await this.domtoolsPromise;
    if (!this.playbackDiv) return;
-    const replayer = new rrwebPlayer({
+
+    // Load rrweb-player from CDN
+    const rrwebPlayerBundle = await SioServiceLibLoader.getInstance().loadRrwebPlayer();
+    const RrwebPlayer = rrwebPlayerBundle.default;
+
+    const replayer = new RrwebPlayer({
      target: this.playbackDiv, // customizable root element
      props: {
        events: this.events as any,
@@ -172,11 +177,11 @@ export class SioRecorder extends DeesElement {
  public async fixPosition() {
    await this.domtoolsPromise;
    await this.domtools.convenience.smartdelay.delayFor(0);
-    const playbackDiv = this.shadowRoot.querySelector('#playback') as HTMLElement;
-    const replayerWrapper = this.shadowRoot.querySelector('.replayer-wrapper') as HTMLElement;
-    const replayerMouse = this.shadowRoot.querySelector('.replayer-mouse') as HTMLElement;
-    const replayerMouseTail = this.shadowRoot.querySelector('.replayer-mouse-tail') as HTMLElement;
-    const iframe = this.shadowRoot.querySelector('iframe');
+    const playbackDiv = this.shadowRoot!.querySelector('#playback') as HTMLElement;
+    const replayerWrapper = this.shadowRoot!.querySelector('.replayer-wrapper') as HTMLElement;
+    const replayerMouse = this.shadowRoot!.querySelector('.replayer-mouse') as HTMLElement;
+    const replayerMouseTail = this.shadowRoot!.querySelector('.replayer-mouse-tail') as HTMLElement;
+    const iframe = this.shadowRoot!.querySelector('iframe')!;
    replayerWrapper.style.position = 'absolute';
    replayerWrapper.style.top = '0px';
    replayerWrapper.style.left = '0px';
@@ -1 +1,2 @@
 export * from './elements/index.js';
+export * from './services/SioServiceLibLoader.js';
@@ -0,0 +1,200 @@
+import { CDN_BASE, CDN_VERSIONS } from './versions.js';
+
+/**
+ * rrweb record options
+ */
+export interface IRrwebRecordOptions {
+  emit: (event: any) => void;
+  recordCanvas?: boolean;
+  recordCrossOriginIframes?: boolean;
+  checkoutEveryNms?: number;
+  [key: string]: any;
+}
+
+/**
+ * rrweb record function type
+ */
+export type TRrwebRecordFn = (options: IRrwebRecordOptions) => () => void;
+
+/**
+ * Bundle type for rrweb recording library
+ */
+export interface IRrwebBundle {
+  record: TRrwebRecordFn;
+}
+
+/**
+ * rrweb-player constructor options
+ */
+export interface IRrwebPlayerOptions {
+  target: HTMLElement;
+  props: {
+    events: any[];
+    root?: HTMLElement;
+    showController?: boolean;
+    width?: number;
+    height?: number;
+    [key: string]: any;
+  };
+}
+
+/**
+ * rrweb-player instance
+ */
+export interface IRrwebPlayerInstance {
+  play: () => Promise<void>;
+  pause: () => void;
+  [key: string]: any;
+}
+
+/**
+ * rrweb-player constructor type
+ */
+export type TRrwebPlayerConstructor = new (options: IRrwebPlayerOptions) => IRrwebPlayerInstance;
+
+/**
+ * Bundle type for rrweb-player
+ */
+export interface IRrwebPlayerBundle {
+  default: TRrwebPlayerConstructor;
+}
+
+/**
+ * Singleton service for lazy-loading rrweb libraries from CDN.
+ *
+ * This reduces initial bundle size by loading libraries only when needed.
+ * Libraries are cached after first load to avoid duplicate fetches.
+ *
+ * @example
+ * ```typescript
+ * const libLoader = SioServiceLibLoader.getInstance();
+ * const rrweb = await libLoader.loadRrweb();
+ * const stopFn = rrweb.record({ emit: (event) => { ... } });
+ * ```
+ */
+export class SioServiceLibLoader {
+  private static instance: SioServiceLibLoader;
+
+  // Cached library references
+  private rrwebLib: IRrwebBundle | null = null;
+  private rrwebPlayerLib: IRrwebPlayerBundle | null = null;
+
+  // Loading promises to prevent duplicate concurrent loads
+  private rrwebLoadingPromise: Promise<IRrwebBundle> | null = null;
+  private rrwebPlayerLoadingPromise: Promise<IRrwebPlayerBundle> | null = null;
+
+  private constructor() {}
+
+  /**
+   * Get the singleton instance of SioServiceLibLoader
+   */
+  public static getInstance(): SioServiceLibLoader {
+    if (!SioServiceLibLoader.instance) {
+      SioServiceLibLoader.instance = new SioServiceLibLoader();
+    }
+    return SioServiceLibLoader.instance;
+  }
+
+  /**
+   * Load rrweb recording library from CDN
+   * @returns Promise resolving to rrweb module with record function
+   */
+  public async loadRrweb(): Promise<IRrwebBundle> {
+    if (this.rrwebLib) {
+      return this.rrwebLib;
+    }
+
+    if (this.rrwebLoadingPromise) {
+      return this.rrwebLoadingPromise;
+    }
+
+    this.rrwebLoadingPromise = (async () => {
+      const url = `${CDN_BASE}/rrweb@${CDN_VERSIONS.rrweb}/+esm`;
+      const module = await import(/* @vite-ignore */ url);
+
+      this.rrwebLib = {
+        record: module.record,
+      };
+      return this.rrwebLib;
+    })();
+
+    return this.rrwebLoadingPromise;
+  }
+
+  /**
+   * Load rrweb-player from CDN
+   * @returns Promise resolving to rrweb-player module
+   */
+  public async loadRrwebPlayer(): Promise<IRrwebPlayerBundle> {
+    if (this.rrwebPlayerLib) {
+      return this.rrwebPlayerLib;
+    }
+
+    if (this.rrwebPlayerLoadingPromise) {
+      return this.rrwebPlayerLoadingPromise;
+    }
+
+    this.rrwebPlayerLoadingPromise = (async () => {
+      const url = `${CDN_BASE}/rrweb-player@${CDN_VERSIONS.rrwebPlayer}/+esm`;
+      const module = await import(/* @vite-ignore */ url);
+
+      // Inject rrweb-player CSS styles
+      await this.injectRrwebPlayerStyles();
+
+      this.rrwebPlayerLib = {
+        default: module.default,
+      };
+      return this.rrwebPlayerLib;
+    })();
+
+    return this.rrwebPlayerLoadingPromise;
+  }
+
+  /**
+   * Inject rrweb-player CSS styles into the document head
+   */
+  private async injectRrwebPlayerStyles(): Promise<void> {
+    const styleId = 'rrweb-player-cdn-styles';
+    if (document.getElementById(styleId)) {
+      return; // Already injected
+    }
+
+    const cssUrl = `${CDN_BASE}/rrweb-player@${CDN_VERSIONS.rrwebPlayer}/dist/style.css`;
+    try {
+      const response = await fetch(cssUrl);
+      const cssText = await response.text();
+
+      const style = document.createElement('style');
+      style.id = styleId;
+      style.textContent = cssText;
+      document.head.appendChild(style);
+    } catch (error) {
+      console.warn('Failed to load rrweb-player styles from CDN:', error);
+    }
+  }
+
+  /**
+   * Preload all rrweb libraries in parallel
+   * Useful for warming the cache before recording is needed
+   */
+  public async preloadAll(): Promise<void> {
+    await Promise.all([
+      this.loadRrweb(),
+      this.loadRrwebPlayer(),
+    ]);
+  }
+
+  /**
+   * Check if a specific library is already loaded
+   */
+  public isLoaded(library: 'rrweb' | 'rrwebPlayer'): boolean {
+    switch (library) {
+      case 'rrweb':
+        return this.rrwebLib !== null;
+      case 'rrwebPlayer':
+        return this.rrwebPlayerLib !== null;
+      default:
+        return false;
+    }
+  }
+}
@@ -0,0 +1,13 @@
+/**
+ * CDN versions for lazy-loaded libraries.
+ * Keep these in sync with package.json for type compatibility.
+ */
+export const CDN_VERSIONS = {
+  rrweb: '2.0.0-alpha.4',
+  rrwebPlayer: '1.0.0-alpha.4',
+} as const;
+
+/**
+ * Base CDN URL for jsdelivr ESM imports
+ */
+export const CDN_BASE = 'https://cdn.jsdelivr.net/npm';
Author	SHA1	Message	Date
jkunz	1d71f45309	v1.7.1 Default (tags) / security (push) Failing after 0s Details Default (tags) / test (push) Failing after 0s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-04-02 12:50:20 +00:00
jkunz	47f2a64a61	fix(build): migrate smart config setup and align TypeScript compatibility updates	2026-04-02 12:50:20 +00:00
jkunz	3338261cfa	v1.7.0 Default (tags) / security (push) Failing after 0s Details Default (tags) / test (push) Failing after 0s Details Default (tags) / release (push) Has been skipped Details Default (tags) / metadata (push) Has been skipped Details	2026-01-02 10:59:51 +00:00
jkunz	888ec95185	feat(recorder): lazy-load rrweb and rrweb-player from CDN via SioServiceLibLoader and switch sio-recorder to use the loader	2026-01-02 10:59:51 +00:00