@livepeer-frameworks/streamcrafter-wc 0.1.0

package/dist/types/components/fw-sc-advanced.d.ts

@@ -0,0 +1,20 @@
+/**
+ * <fw-sc-advanced> — Advanced/dev mode side panel.
+ * Simplified port of AdvancedPanel.tsx from streamcrafter-react.
+ */
+import { LitElement } from "lit";
+import type { IngestControllerHost } from "../controllers/ingest-controller-host.js";
+export declare class FwScAdvanced extends LitElement {
+    ic: IngestControllerHost;
+    private _activeTab;
+    static styles: import("lit").CSSResult[];
+    protected render(): import("lit").TemplateResult<1>;
+    private _renderStats;
+    private _renderInfo;
+    private _row;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "fw-sc-advanced": FwScAdvanced;
+    }
+}

package/dist/types/components/fw-sc-compositor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * <fw-sc-compositor> — Compact floating compositor controls overlay.
+ * Port of CompositorControls.tsx from streamcrafter-react.
+ */
+import { LitElement } from "lit";
+import type { IngestControllerHost } from "../controllers/ingest-controller-host.js";
+export declare class FwScCompositor extends LitElement {
+    ic: IngestControllerHost;
+    private _tooltipText;
+    private _tooltipTarget;
+    static styles: import("lit").CSSResult[];
+    protected render(): import("lit").TemplateResult<1>;
+    private _handleLayoutSelect;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "fw-sc-compositor": FwScCompositor;
+    }
+}

package/dist/types/components/fw-sc-layer-list.d.ts

@@ -0,0 +1,30 @@
+/**
+ * <fw-sc-layer-list> — Drag-to-reorder layer list.
+ * Port of LayerList.tsx from streamcrafter-react.
+ */
+import { LitElement } from "lit";
+import type { Layer, MediaSource } from "@livepeer-frameworks/streamcrafter-core";
+export declare class FwScLayerList extends LitElement {
+    layers: Layer[];
+    sources: MediaSource[];
+    selectedLayerId: string | null;
+    private _draggedId;
+    private _dragOverId;
+    private _editingLayerId;
+    static styles: import("lit").CSSResult[];
+    private get _sortedLayers();
+    private _getSourceLabel;
+    private _getSourceIcon;
+    protected render(): import("lit").TemplateResult<1>;
+    private _dispatch;
+    private _handleDragStart;
+    private _handleDragOver;
+    private _handleDrop;
+    private _moveUp;
+    private _moveDown;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "fw-sc-layer-list": FwScLayerList;
+    }
+}

package/dist/types/components/fw-sc-scene-switcher.d.ts

@@ -0,0 +1,23 @@
+/**
+ * <fw-sc-scene-switcher> — Horizontal scene selector with transition controls.
+ * Port of SceneSwitcher.tsx from streamcrafter-react.
+ */
+import { LitElement } from "lit";
+import type { Scene } from "@livepeer-frameworks/streamcrafter-core";
+export declare class FwScSceneSwitcher extends LitElement {
+    scenes: Scene[];
+    activeSceneId: string | null;
+    showTransitionControls: boolean;
+    private _selectedTransition;
+    private _transitionDuration;
+    private _isTransitioning;
+    static styles: import("lit").CSSResult[];
+    protected render(): import("lit").TemplateResult<1>;
+    private _handleSceneClick;
+    private _handleDelete;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "fw-sc-scene-switcher": FwScSceneSwitcher;
+    }
+}

package/dist/types/components/fw-sc-volume.d.ts

@@ -0,0 +1,30 @@
+/**
+ * <fw-sc-volume> — Volume slider with snap-to-100% and popup tooltip.
+ * Port of VolumeSlider.tsx from streamcrafter-react.
+ */
+import { LitElement } from "lit";
+export declare class FwScVolume extends LitElement {
+    value: number;
+    min: number;
+    max: number;
+    snapThreshold: number;
+    compact: boolean;
+    private _isDragging;
+    private _popupPosition;
+    private _slider;
+    static styles: import("lit").CSSResult[];
+    private get _displayValue();
+    private get _isBoost();
+    private get _isDefault();
+    private get _accentColor();
+    private _handleChange;
+    private _handleMouseDown;
+    private _handleMouseUp;
+    private _updatePopupPosition;
+    protected render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "fw-sc-volume": FwScVolume;
+    }
+}

package/dist/types/components/fw-streamcrafter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * <fw-streamcrafter> — Main orchestrator for StreamCrafter Web Component.
+ * Port of StreamCrafter.tsx from streamcrafter-react.
+ */
+import { LitElement } from "lit";
+import { IngestControllerHost } from "../controllers/ingest-controller-host.js";
+import type { QualityProfile, MediaSource } from "@livepeer-frameworks/streamcrafter-core";
+export declare class FwStreamCrafter extends LitElement {
+    whipUrl: string;
+    gatewayUrl: string;
+    streamKey: string;
+    initialProfile: QualityProfile;
+    autoStartCamera: boolean;
+    devMode: boolean;
+    debug: boolean;
+    enableCompositor: boolean;
+    private _showSettings;
+    private _showSources;
+    private _isAdvancedPanelOpen;
+    private _videoEl;
+    pc: IngestControllerHost;
+    static styles: import("lit").CSSResult[];
+    constructor();
+    connectedCallback(): void;
+    willUpdate(changed: Map<string, unknown>): void;
+    updated(changed: Map<string, unknown>): void;
+    private _initController;
+    private _syncVideoPreview;
+    startCamera(options?: Parameters<IngestControllerHost["startCamera"]>[0]): Promise<MediaSource>;
+    startScreenShare(options?: Parameters<IngestControllerHost["startScreenShare"]>[0]): Promise<MediaSource | null>;
+    startStreaming(): Promise<void>;
+    stopStreaming(): Promise<void>;
+    stopCapture(): Promise<void>;
+    removeSource(id: string): void;
+    setSourceVolume(id: string, vol: number): void;
+    setSourceMuted(id: string, m: boolean): void;
+    setPrimaryVideoSource(id: string): void;
+    setMasterVolume(vol: number): void;
+    setQualityProfile(p: QualityProfile): Promise<void>;
+    destroy(): void;
+    protected render(): import("lit").TemplateResult<1>;
+    private _renderSourceRow;
+    private _renderSettingsPopup;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "fw-streamcrafter": FwStreamCrafter;
+    }
+}

package/dist/types/controllers/ingest-controller-host.d.ts

@@ -0,0 +1,77 @@
+/**
+ * IngestControllerHost — Lit ReactiveController wrapping IngestControllerV2.
+ * Direct port of useStreamCrafterV2.ts from streamcrafter-react.
+ */
+import type { ReactiveController, ReactiveControllerHost } from "lit";
+import { IngestControllerV2, type IngestControllerConfigV2, type IngestState, type IngestStateContextV2, type IngestStats, type CaptureOptions, type ScreenCaptureOptions, type DeviceInfo, type MediaSource, type QualityProfile, type ReconnectionState, type EncoderOverrides } from "@livepeer-frameworks/streamcrafter-core";
+export interface EncoderStats {
+    video: {
+        framesEncoded: number;
+        framesPending: number;
+        bytesEncoded: number;
+        lastFrameTime: number;
+    };
+    audio: {
+        samplesEncoded: number;
+        samplesPending: number;
+        bytesEncoded: number;
+        lastSampleTime: number;
+    };
+    timestamp: number;
+}
+export interface IngestControllerHostState {
+    state: IngestState;
+    stateContext: IngestStateContextV2;
+    isStreaming: boolean;
+    isCapturing: boolean;
+    isReconnecting: boolean;
+    error: string | null;
+    mediaStream: MediaStream | null;
+    sources: MediaSource[];
+    qualityProfile: QualityProfile;
+    reconnectionState: ReconnectionState | null;
+    stats: IngestStats | null;
+    useWebCodecs: boolean;
+    isWebCodecsActive: boolean;
+    isWebCodecsAvailable: boolean;
+    encoderStats: EncoderStats | null;
+}
+type HostElement = ReactiveControllerHost & HTMLElement;
+export declare class IngestControllerHost implements ReactiveController {
+    host: HostElement;
+    private controller;
+    private unsubs;
+    private encoderStatsCleanup;
+    s: IngestControllerHostState;
+    constructor(host: HostElement, initialProfile?: QualityProfile);
+    initialize(config: IngestControllerConfigV2): void;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private teardown;
+    private update;
+    private subscribeToEvents;
+    private setupEncoderStatsListener;
+    private dispatchEvent;
+    startCamera(options?: CaptureOptions): Promise<MediaSource>;
+    startScreenShare(options?: ScreenCaptureOptions): Promise<MediaSource | null>;
+    addCustomSource(stream: MediaStream, label: string): MediaSource;
+    removeSource(sourceId: string): void;
+    stopCapture(): Promise<void>;
+    setSourceVolume(sourceId: string, volume: number): void;
+    setSourceMuted(sourceId: string, muted: boolean): void;
+    setSourceActive(sourceId: string, active: boolean): void;
+    setPrimaryVideoSource(sourceId: string): void;
+    setMasterVolume(volume: number): void;
+    getMasterVolume(): number;
+    setQualityProfile(profile: QualityProfile): Promise<void>;
+    startStreaming(): Promise<void>;
+    stopStreaming(): Promise<void>;
+    getDevices(): Promise<DeviceInfo[]>;
+    switchVideoDevice(deviceId: string): Promise<void>;
+    switchAudioDevice(deviceId: string): Promise<void>;
+    getStats(): Promise<IngestStats | null>;
+    setUseWebCodecs(enabled: boolean): void;
+    setEncoderOverrides(overrides: EncoderOverrides): void;
+    getController(): IngestControllerV2 | null;
+}
+export {};

package/dist/types/define.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/icons/index.d.ts

@@ -0,0 +1,29 @@
+export declare const cameraIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const monitorIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const micIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const micMutedIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const xIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const settingsIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const chevronsRightIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const chevronsLeftIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const eyeIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const eyeOffIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const videoIcon: (size?: number) => import("lit").TemplateResult<1>;
+export declare const soloIcon: () => import("lit").TemplateResult<1>;
+export declare const pipBRIcon: () => import("lit").TemplateResult<1>;
+export declare const pipBLIcon: () => import("lit").TemplateResult<1>;
+export declare const pipTRIcon: () => import("lit").TemplateResult<1>;
+export declare const pipTLIcon: () => import("lit").TemplateResult<1>;
+export declare const splitHIcon: () => import("lit").TemplateResult<1>;
+export declare const splitVIcon: () => import("lit").TemplateResult<1>;
+export declare const focusLIcon: () => import("lit").TemplateResult<1>;
+export declare const focusRIcon: () => import("lit").TemplateResult<1>;
+export declare const gridIcon: () => import("lit").TemplateResult<1>;
+export declare const stackIcon: () => import("lit").TemplateResult<1>;
+export declare const dualPipIcon: () => import("lit").TemplateResult<1>;
+export declare const splitPipIcon: () => import("lit").TemplateResult<1>;
+export declare const featuredIcon: () => import("lit").TemplateResult<1>;
+export declare const featuredRIcon: () => import("lit").TemplateResult<1>;
+export declare const letterboxIcon: () => import("lit").TemplateResult<1>;
+export declare const cropIcon: () => import("lit").TemplateResult<1>;
+export declare const stretchIcon: () => import("lit").TemplateResult<1>;

package/dist/types/iife-entry.d.ts

@@ -0,0 +1,11 @@
+/**
+ * IIFE entry — bundles everything and auto-registers custom elements.
+ * For CDN <script> tag consumers.
+ *
+ * Usage:
+ *   <script src="fw-streamcrafter.iife.js"></script>
+ *   <fw-streamcrafter whip-url="..."></fw-streamcrafter>
+ */
+import "./define.js";
+export { FwStreamCrafter } from "./components/fw-streamcrafter.js";
+export { IngestControllerHost } from "./controllers/ingest-controller-host.js";

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ESM entry — exports all classes and types but does NOT auto-register custom elements.
+ * Use `import '@livepeer-frameworks/streamcrafter-wc/define'` to register elements.
+ */
+export { FwStreamCrafter } from "./components/fw-streamcrafter.js";
+export { FwScCompositor } from "./components/fw-sc-compositor.js";
+export { FwScSceneSwitcher } from "./components/fw-sc-scene-switcher.js";
+export { FwScLayerList } from "./components/fw-sc-layer-list.js";
+export { FwScVolume } from "./components/fw-sc-volume.js";
+export { FwScAdvanced } from "./components/fw-sc-advanced.js";
+export { IngestControllerHost } from "./controllers/ingest-controller-host.js";
+export type { IngestControllerHostState, EncoderStats, } from "./controllers/ingest-controller-host.js";

package/dist/types/styles/shared-styles.d.ts

@@ -0,0 +1 @@
+export declare const sharedStyles: import("lit").CSSResult;

package/dist/types/styles/utility-styles.d.ts

@@ -0,0 +1 @@
+export declare const utilityStyles: import("lit").CSSResult;

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@livepeer-frameworks/streamcrafter-wc",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Lit Web Components for StreamCrafter - framework-agnostic streaming UI",
+  "main": "dist/cjs/index.cjs",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    },
+    "./define": {
+      "source": "./src/define.ts",
+      "types": "./dist/types/define.d.ts",
+      "import": "./dist/esm/define.js",
+      "require": "./dist/cjs/define.cjs"
+    },
+    "./fw-streamcrafter.js": {
+      "source": "./src/iife-entry.ts",
+      "default": "./dist/fw-streamcrafter.iife.js"
+    }
+  },
+  "scripts": {
+    "build:css": "node scripts/generate-shared-styles.js",
+    "build:types": "tsc --noEmit false --emitDeclarationOnly --outDir dist/types",
+    "build": "pnpm run build:css && pnpm run build:types && NODE_ENV=production rollup -c",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@livepeer-frameworks/streamcrafter-core": "workspace:*",
+    "lit": "^3.2.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "rollup": "^4.57.1",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.2",
+    "vitest": "^4.0.18"
+  },
+  "author": "Livepeer FrameWorks",
+  "license": "Unlicense"
+}

package/src/components/fw-sc-advanced.ts

@@ -0,0 +1,221 @@
+/**
+ * <fw-sc-advanced> — Advanced/dev mode side panel.
+ * Simplified port of AdvancedPanel.tsx from streamcrafter-react.
+ */
+import { LitElement, html, css, nothing } from "lit";
+import { customElement, property, state } from "lit/decorators.js";
+import { classMap } from "lit/directives/class-map.js";
+import { sharedStyles } from "../styles/shared-styles.js";
+import { utilityStyles } from "../styles/utility-styles.js";
+import { xIcon } from "../icons/index.js";
+import type { IngestControllerHost } from "../controllers/ingest-controller-host.js";
+
+type TabId = "stats" | "info";
+
+@customElement("fw-sc-advanced")
+export class FwScAdvanced extends LitElement {
+  @property({ attribute: false }) ic!: IngestControllerHost;
+
+  @state() private _activeTab: TabId = "stats";
+
+  static styles = [
+    sharedStyles,
+    utilityStyles,
+    css`
+      :host {
+        display: block;
+      }
+      .panel {
+        width: 320px;
+        height: 100%;
+        border-left: 1px solid rgba(90, 96, 127, 0.3);
+        background: #1a1b26;
+        overflow: auto;
+        font-size: 0.75rem;
+        color: #a9b1d6;
+      }
+      .header {
+        display: flex;
+        align-items: center;
+        justify-content: space-between;
+        padding: 0.5rem 0.75rem;
+        border-bottom: 1px solid rgba(90, 96, 127, 0.3);
+      }
+      .tabs {
+        display: flex;
+        gap: 0.5rem;
+      }
+      .tab {
+        padding: 0.25rem 0.5rem;
+        border: none;
+        background: none;
+        color: #565f89;
+        font-size: 0.6875rem;
+        font-weight: 600;
+        cursor: pointer;
+        border-radius: 0.25rem;
+      }
+      .tab--active {
+        color: #c0caf5;
+        background: rgba(90, 96, 127, 0.2);
+      }
+      .close {
+        display: flex;
+        background: none;
+        border: none;
+        color: #565f89;
+        cursor: pointer;
+        padding: 0;
+      }
+      .close:hover {
+        color: #c0caf5;
+      }
+      .body {
+        padding: 0.75rem;
+      }
+      .section {
+        margin-bottom: 0.75rem;
+      }
+      .label {
+        font-size: 0.625rem;
+        font-weight: 600;
+        text-transform: uppercase;
+        letter-spacing: 0.05em;
+        color: #565f89;
+        margin-bottom: 0.375rem;
+      }
+      .row {
+        display: flex;
+        justify-content: space-between;
+        padding: 0.125rem 0;
+      }
+      .row-label {
+        color: #565f89;
+      }
+      .row-value {
+        color: #c0caf5;
+        font-family: ui-monospace, monospace;
+        font-variant-numeric: tabular-nums;
+      }
+    `,
+  ];
+
+  protected render() {
+    return html`
+      <div class="panel">
+        <div class="header">
+          <div class="tabs">
+            <button
+              class=${classMap({ tab: true, "tab--active": this._activeTab === "stats" })}
+              @click=${() => {
+                this._activeTab = "stats";
+              }}
+            >
+              Stats
+            </button>
+            <button
+              class=${classMap({ tab: true, "tab--active": this._activeTab === "info" })}
+              @click=${() => {
+                this._activeTab = "info";
+              }}
+            >
+              Info
+            </button>
+          </div>
+          <button
+            class="close"
+            @click=${() =>
+              this.dispatchEvent(new CustomEvent("fw-close", { bubbles: true, composed: true }))}
+            aria-label="Close panel"
+          >
+            ${xIcon(14)}
+          </button>
+        </div>
+        <div class="body">
+          ${this._activeTab === "stats" ? this._renderStats() : this._renderInfo()}
+        </div>
+      </div>
+    `;
+  }
+
+  private _renderStats() {
+    const s = this.ic.s;
+    const stats = s.stats;
+    return html`
+      <div class="section">
+        <div class="label">Connection</div>
+        ${this._row("State", s.state)}
+        ${this._row(
+          "WebCodecs",
+          s.isWebCodecsActive ? "Active" : s.useWebCodecs ? "Pending" : "Off"
+        )}
+      </div>
+      ${stats
+        ? html`
+            <div class="section">
+              <div class="label">WebRTC Stats</div>
+              ${this._row(
+                "Video bitrate",
+                stats.video.bitrate ? `${Math.round(stats.video.bitrate / 1000)} kbps` : "—"
+              )}
+              ${this._row(
+                "Audio bitrate",
+                stats.audio.bitrate ? `${Math.round(stats.audio.bitrate / 1000)} kbps` : "—"
+              )}
+              ${this._row(
+                "RTT",
+                stats.connection.rtt ? `${(stats.connection.rtt * 1000).toFixed(0)} ms` : "—"
+              )}
+              ${this._row(
+                "FPS",
+                stats.video.framesPerSecond ? String(stats.video.framesPerSecond) : "—"
+              )}
+              ${this._row("Packets sent", String(stats.video.packetsSent))}
+              ${this._row("Packets lost", String(stats.video.packetsLost))}
+            </div>
+          `
+        : nothing}
+      ${s.encoderStats
+        ? html`
+            <div class="section">
+              <div class="label">Encoder</div>
+              ${this._row("Video frames", String(s.encoderStats.video.framesEncoded))}
+              ${this._row("Video pending", String(s.encoderStats.video.framesPending))}
+              ${this._row("Audio samples", String(s.encoderStats.audio.samplesEncoded))}
+            </div>
+          `
+        : nothing}
+    `;
+  }
+
+  private _renderInfo() {
+    const s = this.ic.s;
+    return html`
+      <div class="section">
+        <div class="label">Configuration</div>
+        ${this._row("Profile", s.qualityProfile)} ${this._row("Sources", String(s.sources.length))}
+        ${this._row("WebCodecs Available", s.isWebCodecsAvailable ? "Yes" : "No")}
+      </div>
+      <div class="section">
+        <div class="label">Sources</div>
+        ${s.sources.map(
+          (source) => html`
+            ${this._row(source.label, `${source.type} ${source.muted ? "(muted)" : ""}`)}
+          `
+        )}
+      </div>
+    `;
+  }
+
+  private _row(label: string, value: string) {
+    return html`<div class="row">
+      <span class="row-label">${label}</span><span class="row-value">${value}</span>
+    </div>`;
+  }
+}
+
+declare global {
+  interface HTMLElementTagNameMap {
+    "fw-sc-advanced": FwScAdvanced;
+  }
+}