@phont/subtitles-core

Core subtitle engine for PHONT expressive subtitles. Pure TypeScript, framework-agnostic.

Purpose

This package contains the core logic for:

• Subtitle timing and synchronization
• Emotion detection and style mapping
• Word-by-word karaoke mode
• API client for fetching subtitle data

Usage

import { createSubtitleEngine, SubtitleTrack } from '@phont/subtitles-core';

const track: SubtitleTrack = {
  vodId: 'video-123',
  language: 'en',
  lines: [/* ... */]
};

const engine = createSubtitleEngine(track);
const state = engine.at(42.5); // Get subtitle state at 42.5 seconds

Development

# Build
pnpm build

# Watch mode
pnpm dev

# Test
pnpm test

# Type check
pnpm typecheck

Extraction Plan

This package will be created by extracting logic from:

• app/hooks/subtitle/useSentenceAnimation.js → src/engine.ts
• app/hooks/subtitle/useWordAnimation.js → src/engine.ts
• app/config/animation/ → src/emotionMapper.ts
• app/components/subtitle/data/SubtitleFetcher.js → src/client.ts