subcraft 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ranjith Gowda
+
+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/README.md

@@ -1,3 +1,296 @@
-# Temporary Holding Version
+# subcraft
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **Zero-dependency, isomorphic TypeScript engine for subtitle parsing, frame-rate retiming, and Unicode grapheme-cluster quality linting (powered by `Intl.Segmenter`).**
+
+[![npm version](https://img.shields.io/badge/npm-v0.1.0-blue.svg)](https://www.npmjs.com/package/subcraft)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.8-blue.svg)](https://www.typescriptlang.org/)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](https://www.npmjs.com/package/subcraft)
+[![Tests](https://img.shields.io/badge/tests-42%20passed-brightgreen.svg)](https://vitest.dev/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## Highlights
+
+* **100% Zero Dependencies:** Lightweight and fast. Runs natively in any JavaScript runtime (Browsers, Web Workers, Node.js 20+, and Edge runtimes) without polyfills.
+* **Resilient Parsing:** Strips UTF-8 BOM (`\uFEFF`), normalizes mixed line endings (`CRLF`, `CR`, `LF`), and captures syntax errors without crashing or throwing unhandled exceptions.
+* **Deterministic Timecode Math:** Lossless millisecond arithmetic with integer precision (`Math.round`), frame-rate drift scaling (`retime`), and linear audio-sync shifting (`shiftTimecodes`).
+* **Grapheme-Aware Quality Linter:** Uses the native ECMAScript `Intl.Segmenter` API to measure true visual characters rather than UTF-16 code units—eliminating false reading-speed warnings in Indic scripts (Kannada, Hindi) and emoji-heavy text.
+* **First-Class TypeScript:** Authored in strict TypeScript with comprehensive type declarations (`.d.ts` and `.d.cts`) and verified dual ESM/CJS exports via `publint`.
+
+---
+
+## Table of Contents
+
+1. [Installation](#installation)
+2. [Quick Start](#quick-start)
+3. [Core Modules](#core-modules)
+   - [1. SRT Parsing & Resilient Error Collection](#1-srt-parsing--resilient-error-collection)
+   - [2. SRT Serialization](#2-srt-serialization)
+   - [3. Timecode Conversions](#3-timecode-conversions)
+   - [4. Audio Sync & Frame-Rate Drift Retiming](#4-audio-sync--frame-rate-drift-retiming)
+   - [5. Locale-Aware Quality Linter](#5-locale-aware-quality-linter)
+4. [The Indic / Unicode Grapheme Problem](#the-indic--unicode-grapheme-problem)
+5. [Comparison with Legacy Libraries](#comparison-with-legacy-libraries)
+6. [API Reference & Types](#api-reference--types)
+7. [License](#license)
+
+---
+
+## Installation
+
+```bash
+# Using npm
+npm install subcraft
+
+# Using pnpm
+pnpm add subcraft
+
+# Using yarn
+yarn add subcraft
+```
+
+---
+
+## Quick Start
+
+```typescript
+import { parseSRT, stringifySRT, lintCues, shiftTimecodes } from 'subcraft';
+
+const rawSRT = `1
+00:00:01,000 --> 00:00:04,000
+Welcome to subcraft!
+
+2
+00:00:03,800 --> 00:00:06,000
+Overlapping subtitle cue.`;
+
+// 1. Parse SRT text resiliently
+const { cues, errors } = parseSRT(rawSRT);
+console.log(`Parsed ${cues.length} cues with ${errors.length} syntax errors.`);
+
+// 2. Lint for quality defects (overlaps, reading speed, duration)
+const diagnostics = lintCues(cues);
+console.log(diagnostics);
+// Output flags: Cue 2 overlaps with Cue 1 by 200ms!
+
+// 3. Shift timings by +500ms (to fix audio desync)
+const shiftedCues = shiftTimecodes(cues, 500);
+
+// 4. Serialize back to standard SRT string
+const updatedSRT = stringifySRT(shiftedCues);
+```
+
+---
+
+## Core Modules
+
+### 1. SRT Parsing & Resilient Error Collection
+
+Unlike traditional parsers that throw fatal exceptions when encountering corrupted blocks or missing line numbers, `parseSRT` collects syntax errors alongside successfully parsed cues:
+
+```typescript
+import { parseSRT } from 'subcraft';
+
+const { cues, errors } = parseSRT(dirtySubtitleContent);
+
+if (errors.length > 0) {
+  errors.forEach(err => {
+    console.warn(`Block error around index ${err.index}: ${err.message}`);
+    console.warn(`Raw block: "${err.rawBlock}"`);
+  });
+}
+```
+
+* Automatically strips UTF-8 BOM (`\uFEFF`).
+* Normalizes Windows (`\r\n`) and Unix (`\n`) newlines.
+* Handles missing or non-numeric cue IDs by assigning fallback sequential numbers.
+
+---
+
+### 2. SRT Serialization
+
+Formats structured `SubtitleCue[]` objects back into strict standard SubRip (.srt) syntax:
+
+```typescript
+import { stringifySRT, SubtitleCue } from 'subcraft';
+
+const cues: SubtitleCue[] = [
+  { id: '1', start: 1000, end: 4000, text: 'Hello world' }
+];
+
+const srtString = stringifySRT(cues);
+```
+
+---
+
+### 3. Timecode Conversions
+
+Convert between standard timecode strings and integer milliseconds without floating-point drift:
+
+```typescript
+import { timecodeToMs, msToTimecode } from 'subcraft';
+
+// Convert string to milliseconds
+timecodeToMs('00:01:23,456'); // Returns: 83456
+timecodeToMs('01:23.456');    // WebVTT short form -> Returns: 83456
+
+// Convert milliseconds to formatted timecode
+msToTimecode(83456, 'srt');   // "00:01:23,456"
+msToTimecode(83456, 'vtt');   // "00:01:23.456"
+```
+
+---
+
+### 4. Audio Sync & Frame-Rate Drift Retiming
+
+#### Linear Shift (`shiftTimecodes`)
+Add or subtract a constant offset across all cues (e.g. delaying subtitles by 500ms). Negative results are safely clamped to `0ms`:
+
+```typescript
+import { shiftTimecodes } from 'subcraft';
+
+// Shift all cues forward by 1.5 seconds
+const delayed = shiftTimecodes(cues, 1500);
+```
+
+#### Frame-Rate Scaling (`retime`)
+When videos are converted between frame rates (e.g., 24 fps Film to 25 fps PAL television), timecodes drift multiplicatively over time. `retime` applies a scaling ratio, strictly rounding each millisecond with `Math.round`:
+
+```typescript
+import { retime } from 'subcraft';
+
+// 24 fps to 25 fps (PAL speed-up): video runs ~4% faster, timecodes compress
+const palCues = retime(filmCues, 24 / 25); // ratio: 0.96
+
+// 25 fps to 24 fps (Slowdown): video runs slower, timecodes stretch
+const filmCues = retime(palCues, 25 / 24); // ratio: 1.04167
+```
+
+---
+
+### 5. Locale-Aware Quality Linter
+
+Inspects subtitles against broadcaster standards (Netflix / BBC style guides):
+
+```typescript
+import { lintCues, DEFAULT_PROFILES } from 'subcraft';
+
+// Lint using standard Latin rules (default)
+const diagnostics = lintCues(cues);
+
+// Lint using Indic (Kannada) profile
+const kannadaDiagnostics = lintCues(cues, DEFAULT_PROFILES.indicKannada);
+
+// Custom profile overrides
+const customDiagnostics = lintCues(cues, {
+  maxCps: 18,
+  maxCpl: 40,
+  minDurationMs: 1000,
+  maxDurationMs: 6000,
+  includeSpaces: true,
+  locale: 'kn',
+});
+```
+
+#### Rules Enforced:
+| Rule | Severity | Description | Default Threshold |
+| :--- | :---: | :--- | :--- |
+| `out-of-order` | `error` | Cue start timestamp is earlier than previous cue start | Ascending chronological order |
+| `zero-or-negative-duration` | `error` | Cue duration is zero or negative (`end <= start`) | `end > start` |
+| `overlap` | `error` | Cue start timestamp precedes the previous cue's end timestamp | `start >= prevEnd` |
+| `min-duration` | `warning` | Cue flashes too quickly for human cognitive reading | Min `800ms` |
+| `max-duration` | `warning` | Cue stays on screen for too long, distracting from video | Max `7,000ms` |
+| `max-cpl` | `warning` | Line length exceeds display boundary limits | Max `42` CPL (Latin) / `35` CPL (Indic) |
+| `max-cps` | `warning` | Reading speed exceeds human reading speed capacity | Max `20` CPS (Latin) / `15` CPS (Indic) |
+
+---
+
+## The Indic / Unicode Grapheme Problem
+
+In standard JavaScript, `string.length` counts **UTF-16 code units**, not visual characters. 
+
+In Indic scripts (such as Kannada, Hindi, Telugu, Tamil), conjunct consonants, viramas, and vowel modifiers (matras) are stored across multiple code units:
+
+```javascript
+// Standard JavaScript string.length:
+console.log('ವಿದ್ಯಾರ್ಥಿ'.length); // 10 code units!
+console.log('ಬೆಂಗಳೂರು'.length);   // 8 code units!
+```
+
+If a subtitle validation tool calculates **Characters Per Second (CPS)** using `string.length`, it counts **10 characters** for a 5-character word like `"ವಿದ್ಯಾರ್ಥಿ"`. This **doubles the reading speed calculation**, triggering false-positive "Reading speed too fast!" warnings.
+
+### How `subcraft` Solves This:
+`subcraft` uses the native ECMAScript standard **`Intl.Segmenter`** (UAX #29 Unicode grapheme clustering):
+
+```typescript
+import { countGraphemes } from 'subcraft';
+
+countGraphemes('ವಿದ್ಯಾರ್ಥಿ', 'kn'); // Accurately returns: 5 graphemes
+countGraphemes('ಬೆಂಗಳೂರು', 'kn');   // Accurately returns: 4 graphemes
+```
+
+`subcraft` also automatically strips HTML markup (`<i>`, `<b>`, `<font...>`) before counting characters, ensuring that visual styling does not artificially penalize reading speed metrics.
+
+---
+
+## Comparison with Legacy Libraries
+
+| Feature | `subcraft` | `subtitle.js` (legacy) | `srt-parser-2` |
+| :--- | :---: | :---: | :---: |
+| **Dependencies** | **0 (Zero)** | Depends on Node.js `stream` | 0 |
+| **Browser & Web Worker Native** | ✅ **100% Native** | ❌ Requires Node polyfills | ✅ |
+| **Built-in Quality Linter** | ✅ **Comprehensive** | ❌ None | ❌ None |
+| **Unicode Grapheme CPS / CPL** | ✅ **`Intl.Segmenter`** | ❌ None | ❌ None |
+| **Overlap & Chronology Checks** | ✅ **Yes** | ❌ None | ❌ None |
+| **Frame-rate Drift Retiming** | ✅ **Yes (`retime`)** | ❌ Only linear shift | ❌ None |
+| **Resilient Error Collection** | ✅ **Returns `{ cues, errors }`** | ❌ Throws errors | ❌ Incomplete |
+| **Type Definitions** | ✅ **Strict ESM + CJS `.d.ts`** | ⚠️ Partial | ⚠️ Basic |
+
+---
+
+## API Reference & Types
+
+### Data Models
+
+```typescript
+export interface SubtitleCue {
+  id: string;      // Unique identifier (e.g., "1", "2")
+  start: number;   // Integer start time in milliseconds
+  end: number;     // Integer end time in milliseconds
+  text: string;    // Raw subtitle text payload (may contain newlines)
+}
+
+export interface ParseResult {
+  cues: SubtitleCue[];
+  errors: ParseError[];
+}
+
+export interface ParseError {
+  index?: number;
+  rawBlock: string;
+  message: string;
+}
+
+export interface LintDiagnostic {
+  cueId: string;
+  rule: 
+    | 'out-of-order'
+    | 'zero-or-negative-duration'
+    | 'overlap'
+    | 'min-duration'
+    | 'max-duration'
+    | 'max-cpl'
+    | 'max-cps';
+  severity: 'error' | 'warning';
+  message: string;
+  expected?: number | string;
+  actual?: number | string;
+}
+```
+
+---
+
+## License
+
+MIT © 2026 [Ranjith Gowda](https://github.com/Ranjithgowda007)

package/dist/index.cjs

@@ -0,0 +1,292 @@
+'use strict';
+
+// src/types.ts
+var getCueDuration = (cue) => cue.end - cue.start;
+
+// src/timecode.ts
+var TIMECODE_REGEX = /^(?:(?:(\d{1,2}):)?(\d{2}):)?(\d{2})[,.](\d{3})$/;
+function timecodeToMs(timecode) {
+  const trimmed = timecode.trim();
+  const match = trimmed.match(TIMECODE_REGEX);
+  if (!match) {
+    throw new Error(
+      `Invalid timecode format: "${timecode}". Expected "HH:MM:SS,mmm" or "HH:MM:SS.mmm".`
+    );
+  }
+  const hours = match[1] ? parseInt(match[1], 10) : 0;
+  const minutes = match[2] ? parseInt(match[2], 10) : 0;
+  const seconds = parseInt(match[3] ?? "0", 10);
+  const milliseconds = parseInt(match[4] ?? "0", 10);
+  return hours * 36e5 + minutes * 6e4 + seconds * 1e3 + milliseconds;
+}
+function msToTimecode(ms, format = "srt") {
+  const safeMs = Math.max(0, Math.floor(ms));
+  const hours = Math.floor(safeMs / 36e5);
+  const minutes = Math.floor(safeMs % 36e5 / 6e4);
+  const seconds = Math.floor(safeMs % 6e4 / 1e3);
+  const remainderMs = safeMs % 1e3;
+  const hh = String(hours).padStart(2, "0");
+  const mm = String(minutes).padStart(2, "0");
+  const ss = String(seconds).padStart(2, "0");
+  const mmm = String(remainderMs).padStart(3, "0");
+  const delimiter = format === "vtt" ? "." : ",";
+  return `${hh}:${mm}:${ss}${delimiter}${mmm}`;
+}
+function shiftTimecodes(cues, offsetMs) {
+  return cues.map((cue) => ({
+    ...cue,
+    start: Math.max(0, cue.start + offsetMs),
+    end: Math.max(0, cue.end + offsetMs)
+  }));
+}
+function retime(cues, ratio) {
+  if (ratio <= 0) {
+    throw new Error(`Retime ratio must be greater than 0. Received: ${ratio}`);
+  }
+  return cues.map((cue) => ({
+    ...cue,
+    start: Math.round(cue.start * ratio),
+    end: Math.round(cue.end * ratio)
+  }));
+}
+
+// src/parser.ts
+var ARROW_REGEX = /((?:\d{1,2}:)?\d{2}:\d{2}[,.]\d{3})\s*-->\s*((?:\d{1,2}:)?\d{2}:\d{2}[,.]\d{3})/;
+function parseSRT(rawText) {
+  const cues = [];
+  const errors = [];
+  if (!rawText || !rawText.trim()) {
+    return { cues, errors };
+  }
+  const cleanText = rawText.replace(/^\uFEFF/, "");
+  const normalized = cleanText.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+  const rawBlocks = normalized.trim().split(/\n\s*\n+/);
+  let fallbackIndex = 1;
+  for (let bIndex = 0; bIndex < rawBlocks.length; bIndex++) {
+    const rawBlock = rawBlocks[bIndex]?.trim();
+    if (!rawBlock) continue;
+    const lines = rawBlock.split("\n");
+    let id;
+    let timecodeLine;
+    let textLines;
+    if (lines[0] && ARROW_REGEX.test(lines[0])) {
+      id = String(fallbackIndex);
+      timecodeLine = lines[0];
+      textLines = lines.slice(1);
+    } else if (lines[1] && ARROW_REGEX.test(lines[1])) {
+      id = lines[0]?.trim() || String(fallbackIndex);
+      timecodeLine = lines[1];
+      textLines = lines.slice(2);
+    } else {
+      errors.push({
+        index: fallbackIndex,
+        rawBlock,
+        message: 'Invalid block format. Expected timecode arrow "-->" on line 1 or 2.'
+      });
+      continue;
+    }
+    const match = timecodeLine.match(ARROW_REGEX);
+    if (!match || !match[1] || !match[2]) {
+      errors.push({
+        index: fallbackIndex,
+        rawBlock,
+        message: `Failed to extract start and end timestamps from: "${timecodeLine}".`
+      });
+      continue;
+    }
+    try {
+      const start = timecodeToMs(match[1]);
+      const end = timecodeToMs(match[2]);
+      const text = textLines.join("\n").trim();
+      cues.push({
+        id,
+        start,
+        end,
+        text
+      });
+      fallbackIndex++;
+    } catch (err) {
+      errors.push({
+        index: fallbackIndex,
+        rawBlock,
+        message: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  return { cues, errors };
+}
+
+// src/serializer.ts
+function stringifySRT(cues) {
+  if (!cues || cues.length === 0) {
+    return "";
+  }
+  const blocks = cues.map((cue, idx) => {
+    const id = cue.id ? String(cue.id) : String(idx + 1);
+    const startStr = msToTimecode(cue.start, "srt");
+    const endStr = msToTimecode(cue.end, "srt");
+    const text = cue.text ?? "";
+    return `${id}
+${startStr} --> ${endStr}
+${text}`;
+  });
+  return blocks.join("\n\n") + "\n";
+}
+
+// src/linter.ts
+var DEFAULT_PROFILES = {
+  standardLatin: {
+    name: "Standard Latin (Netflix/BBC Style Guide)",
+    locale: "en",
+    maxCps: 20,
+    maxCpl: 42,
+    minDurationMs: 800,
+    maxDurationMs: 7e3,
+    includeSpaces: true
+  },
+  indicKannada: {
+    name: "Indic - Kannada Locale",
+    locale: "kn",
+    maxCps: 15,
+    maxCpl: 35,
+    minDurationMs: 800,
+    maxDurationMs: 7e3,
+    includeSpaces: true
+  }
+};
+function stripFormattingTags(text) {
+  return text.replace(/<[^>]*>/g, "");
+}
+function countGraphemes(text, locale = "en") {
+  if (!text) return 0;
+  if (typeof Intl !== "undefined" && "Segmenter" in Intl) {
+    const segmenter = new Intl.Segmenter(locale, { granularity: "grapheme" });
+    let count = 0;
+    for (const _ of segmenter.segment(text)) {
+      count++;
+    }
+    return count;
+  }
+  return [...text].length;
+}
+function lintCues(cues, customProfile) {
+  const diagnostics = [];
+  if (!cues || cues.length === 0) return diagnostics;
+  const profile = {
+    ...DEFAULT_PROFILES["standardLatin"],
+    ...customProfile
+  };
+  const {
+    locale = "en",
+    maxCps,
+    maxCpl,
+    minDurationMs,
+    maxDurationMs,
+    includeSpaces = true
+  } = profile;
+  for (let i = 0; i < cues.length; i++) {
+    const cue = cues[i];
+    if (!cue) continue;
+    const prevCue = i > 0 ? cues[i - 1] : void 0;
+    const duration = cue.end - cue.start;
+    if (prevCue && cue.start < prevCue.start) {
+      diagnostics.push({
+        cueId: cue.id,
+        rule: "out-of-order",
+        severity: "error",
+        message: `Cue starts at ${cue.start}ms before previous cue start of ${prevCue.start}ms.`,
+        expected: `start >= ${prevCue.start}`,
+        actual: `start = ${cue.start}`
+      });
+    }
+    if (cue.end <= cue.start) {
+      diagnostics.push({
+        cueId: cue.id,
+        rule: "zero-or-negative-duration",
+        severity: "error",
+        message: `Cue has invalid duration (${duration}ms). End timestamp must be greater than start timestamp.`,
+        expected: `end > ${cue.start}`,
+        actual: `end = ${cue.end}`
+      });
+    }
+    if (prevCue && cue.start < prevCue.end && cue.start >= prevCue.start) {
+      const overlapMs = prevCue.end - cue.start;
+      diagnostics.push({
+        cueId: cue.id,
+        rule: "overlap",
+        severity: "error",
+        message: `Cue overlaps with previous cue by ${overlapMs}ms.`,
+        expected: `start >= ${prevCue.end}`,
+        actual: `start = ${cue.start}`
+      });
+    }
+    if (duration > 0 && duration < minDurationMs) {
+      diagnostics.push({
+        cueId: cue.id,
+        rule: "min-duration",
+        severity: "warning",
+        message: `Cue duration of ${duration}ms is below the minimum threshold of ${minDurationMs}ms.`,
+        expected: minDurationMs,
+        actual: duration
+      });
+    }
+    if (duration > maxDurationMs) {
+      diagnostics.push({
+        cueId: cue.id,
+        rule: "max-duration",
+        severity: "warning",
+        message: `Cue duration of ${duration}ms exceeds the maximum threshold of ${maxDurationMs}ms.`,
+        expected: maxDurationMs,
+        actual: duration
+      });
+    }
+    const rawText = cue.text || "";
+    const cleanText = stripFormattingTags(rawText);
+    const lines = cleanText.split("\n");
+    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+      const line = lines[lineIndex];
+      if (!line) continue;
+      const cpl = countGraphemes(line, locale);
+      if (cpl > maxCpl) {
+        diagnostics.push({
+          cueId: cue.id,
+          rule: "max-cpl",
+          severity: "warning",
+          message: `Line ${lineIndex + 1} has ${cpl} characters, exceeding the maximum limit of ${maxCpl} CPL.`,
+          expected: maxCpl,
+          actual: cpl
+        });
+      }
+    }
+    if (duration > 0) {
+      const textToMeasure = includeSpaces ? cleanText : cleanText.replace(/\s+/g, "");
+      const totalGraphemes = countGraphemes(textToMeasure, locale);
+      const cps = Number((totalGraphemes / duration * 1e3).toFixed(1));
+      if (cps > maxCps) {
+        diagnostics.push({
+          cueId: cue.id,
+          rule: "max-cps",
+          severity: "warning",
+          message: `Reading speed of ${cps} CPS exceeds maximum limit of ${maxCps} CPS.`,
+          expected: maxCps,
+          actual: cps
+        });
+      }
+    }
+  }
+  return diagnostics;
+}
+
+exports.DEFAULT_PROFILES = DEFAULT_PROFILES;
+exports.countGraphemes = countGraphemes;
+exports.getCueDuration = getCueDuration;
+exports.lintCues = lintCues;
+exports.msToTimecode = msToTimecode;
+exports.parseSRT = parseSRT;
+exports.retime = retime;
+exports.shiftTimecodes = shiftTimecodes;
+exports.stringifySRT = stringifySRT;
+exports.stripFormattingTags = stripFormattingTags;
+exports.timecodeToMs = timecodeToMs;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/timecode.ts","../src/parser.ts","../src/serializer.ts","../src/linter.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Core normalized representation of a single subtitle cue.\n * Timestamps are strictly stored in integer milliseconds.\n */\nexport interface SubtitleCue {\n  /** Unique sequential identifier (e.g. \"1\", \"2\") */\n  id: string;\n  /** Start time in integer milliseconds */\n  start: number;\n  /** End time in integer milliseconds */\n  end: number;\n  /** Raw subtitle text content (may contain newlines) */\n  text: string;\n}\n\n/**\n * Calculates the duration of a cue in milliseconds.\n * Derived helper function to keep the core data model minimal and immutable.\n */\nexport const getCueDuration = (cue: SubtitleCue): number => cue.end - cue.start;\n\n/** Supported subtitle file formats */\nexport type TimecodeFormat = 'srt' | 'vtt';\n\n/**\n * Detailed error reported when a cue block fails parsing syntax rules.\n */\nexport interface ParseError {\n  index?: number;\n  rawBlock: string;\n  message: string;\n}\n\n/**\n * Resilient parser result returning successfully parsed cues\n * alongside any syntax errors encountered without throwing.\n */\nexport interface ParseResult {\n  cues: SubtitleCue[];\n  errors: ParseError[];\n}\n\n/** Severity levels for lint diagnostics */\nexport type LintSeverity = 'error' | 'warning';\n\n/** Quality rules enforced by the linter */\nexport type LintRule =\n  | 'out-of-order'\n  | 'overlap'\n  | 'zero-or-negative-duration'\n  | 'min-duration'\n  | 'max-duration'\n  | 'max-cpl'\n  | 'max-cps';\n\n/**\n * Diagnostic report produced when a cue violates a quality rule.\n */\nexport interface LintDiagnostic {\n  cueId: string;\n  rule: LintRule;\n  severity: LintSeverity;\n  message: string;\n  expected?: number | string;\n  actual?: number | string;\n}\n\n/**\n * Configuration options for locale-aware subtitle validation.\n */\nexport interface LintProfile {\n  name: string;\n  locale?: string;\n  maxCps: number;\n  maxCpl: number;\n  minDurationMs: number;\n  maxDurationMs: number;\n  includeSpaces?: boolean;\n}\n","import type { SubtitleCue, TimecodeFormat } from './types.js';\n\n/**\n * Regular expression to match both SRT (comma) and WebVTT (dot) timecodes.\n * Supports:\n * - HH:MM:SS,mmm or HH:MM:SS.mmm\n * - MM:SS.mmm (WebVTT short format)\n */\nconst TIMECODE_REGEX = /^(?:(?:(\\d{1,2}):)?(\\d{2}):)?(\\d{2})[,.](\\d{3})$/;\n\n/**\n * Converts a formatted timecode string into integer milliseconds.\n *\n * Supported formats:\n * - \"01:23:45,678\" (SRT standard)\n * - \"01:23:45.678\" (WebVTT standard)\n * - \"23:45.678\"    (WebVTT short form without hours)\n *\n * @throws {Error} if timecode format is invalid\n */\nexport function timecodeToMs(timecode: string): number {\n  const trimmed = timecode.trim();\n  const match = trimmed.match(TIMECODE_REGEX);\n\n  if (!match) {\n    throw new Error(\n      `Invalid timecode format: \"${timecode}\". Expected \"HH:MM:SS,mmm\" or \"HH:MM:SS.mmm\".`\n    );\n  }\n\n  const hours = match[1] ? parseInt(match[1], 10) : 0;\n  const minutes = match[2] ? parseInt(match[2], 10) : 0;\n  const seconds = parseInt(match[3] ?? '0', 10);\n  const milliseconds = parseInt(match[4] ?? '0', 10);\n\n  return (\n    hours * 3_600_000 +\n    minutes * 60_000 +\n    seconds * 1_000 +\n    milliseconds\n  );\n}\n\n/**\n * Converts integer milliseconds into a standard formatted timecode string.\n *\n * @param ms - Non-negative integer milliseconds (negative values clamped to 0)\n * @param format - 'srt' (uses comma delimiter) or 'vtt' (uses dot delimiter)\n *\n * @example\n * msToTimecode(83456, 'srt') // \"00:01:23,456\"\n * msToTimecode(83456, 'vtt') // \"00:01:23.456\"\n */\nexport function msToTimecode(ms: number, format: TimecodeFormat = 'srt'): string {\n  const safeMs = Math.max(0, Math.floor(ms));\n\n  const hours = Math.floor(safeMs / 3_600_000);\n  const minutes = Math.floor((safeMs % 3_600_000) / 60_000);\n  const seconds = Math.floor((safeMs % 60_000) / 1_000);\n  const remainderMs = safeMs % 1_000;\n\n  const hh = String(hours).padStart(2, '0');\n  const mm = String(minutes).padStart(2, '0');\n  const ss = String(seconds).padStart(2, '0');\n  const mmm = String(remainderMs).padStart(3, '0');\n\n  const delimiter = format === 'vtt' ? '.' : ',';\n  return `${hh}:${mm}:${ss}${delimiter}${mmm}`;\n}\n\n/**\n * Linearly shifts timecodes by a constant millisecond offset.\n * Used to correct audio-sync delay or advance.\n * Clamps negative results to 0.\n *\n * @param cues - Array of SubtitleCue objects\n * @param offsetMs - Offset in milliseconds (positive advances, negative delays)\n * @returns A new immutable array of shifted cues\n */\nexport function shiftTimecodes(\n  cues: readonly SubtitleCue[],\n  offsetMs: number\n): SubtitleCue[] {\n  return cues.map((cue) => ({\n    ...cue,\n    start: Math.max(0, cue.start + offsetMs),\n    end: Math.max(0, cue.end + offsetMs),\n  }));\n}\n\n/**\n * Scales all cue timecodes by a multiplicative ratio.\n * Used for frame-rate drift compensation between video standards.\n * All results are strictly rounded to integer milliseconds with Math.round.\n *\n * Direction definition:\n * targetTimestamp = Math.round(sourceTimestamp * ratio)\n *\n * @example\n * // 24 fps to 25 fps (PAL speed-up): video is ~4% faster, timecodes compress\n * const palCues = retime(filmCues, 24 / 25); // ratio = 0.96\n *\n * @example\n * // 25 fps to 24 fps (Slow-down): video is ~4% slower, timecodes stretch\n * const filmCues = retime(palCues, 25 / 24); // ratio = 1.04167\n *\n * @param cues - Array of SubtitleCue objects\n * @param ratio - Positive scaling multiplier (e.g., 24/25 or 25/24)\n * @returns A new immutable array of retimed cues\n */\nexport function retime(\n  cues: readonly SubtitleCue[],\n  ratio: number\n): SubtitleCue[] {\n  if (ratio <= 0) {\n    throw new Error(`Retime ratio must be greater than 0. Received: ${ratio}`);\n  }\n\n  return cues.map((cue) => ({\n    ...cue,\n    start: Math.round(cue.start * ratio),\n    end: Math.round(cue.end * ratio),\n  }));\n}\n","import { timecodeToMs } from './timecode.js';\nimport type { SubtitleCue, ParseError, ParseResult } from './types.js';\n\n/** Matches the standard SRT timestamp line: 00:00:00,000 --> 00:00:00,000 */\nconst ARROW_REGEX =\n  /((?:\\d{1,2}:)?\\d{2}:\\d{2}[,.]\\d{3})\\s*-->\\s*((?:\\d{1,2}:)?\\d{2}:\\d{2}[,.]\\d{3})/;\n\n/**\n * Parses raw SRT subtitle text into structured SubtitleCue objects.\n * Resilient parser that collects syntax errors without throwing unhandled exceptions.\n *\n * Handles:\n * - UTF-8 Byte Order Marks (BOM `\\uFEFF`)\n * - Windows (CRLF), Unix (LF), and legacy Mac (CR) line endings\n * - Optional or missing cue numeric index headers\n * - Multi-line subtitle texts\n * - Trailing and irregular blank lines\n *\n * @param rawText - Raw SRT file content as a string\n * @returns {ParseResult} Object containing successfully parsed cues and any block errors\n */\nexport function parseSRT(rawText: string): ParseResult {\n  const cues: SubtitleCue[] = [];\n  const errors: ParseError[] = [];\n\n  if (!rawText || !rawText.trim()) {\n    return { cues, errors };\n  }\n\n  // 1. Strip UTF-8 Byte Order Mark (BOM)\n  const cleanText = rawText.replace(/^\\uFEFF/, '');\n\n  // 2. Normalize CRLF and CR to standard Unix LF\n  const normalized = cleanText.replace(/\\r\\n/g, '\\n').replace(/\\r/g, '\\n');\n\n  // 3. Split by 2 or more consecutive newlines into cue blocks\n  const rawBlocks = normalized.trim().split(/\\n\\s*\\n+/);\n\n  let fallbackIndex = 1;\n\n  for (let bIndex = 0; bIndex < rawBlocks.length; bIndex++) {\n    const rawBlock = rawBlocks[bIndex]?.trim();\n    if (!rawBlock) continue;\n\n    const lines = rawBlock.split('\\n');\n\n    let id: string;\n    let timecodeLine: string;\n    let textLines: string[];\n\n    // Check if line 0 is the timecode arrow (missing numeric index)\n    if (lines[0] && ARROW_REGEX.test(lines[0])) {\n      id = String(fallbackIndex);\n      timecodeLine = lines[0];\n      textLines = lines.slice(1);\n    } else if (lines[1] && ARROW_REGEX.test(lines[1])) {\n      // Standard SRT: line 0 is ID, line 1 is timecode\n      id = lines[0]?.trim() || String(fallbackIndex);\n      timecodeLine = lines[1];\n      textLines = lines.slice(2);\n    } else {\n      errors.push({\n        index: fallbackIndex,\n        rawBlock,\n        message:\n          'Invalid block format. Expected timecode arrow \"-->\" on line 1 or 2.',\n      });\n      continue;\n    }\n\n    const match = timecodeLine.match(ARROW_REGEX);\n    if (!match || !match[1] || !match[2]) {\n      errors.push({\n        index: fallbackIndex,\n        rawBlock,\n        message: `Failed to extract start and end timestamps from: \"${timecodeLine}\".`,\n      });\n      continue;\n    }\n\n    try {\n      const start = timecodeToMs(match[1]);\n      const end = timecodeToMs(match[2]);\n      const text = textLines.join('\\n').trim();\n\n      cues.push({\n        id,\n        start,\n        end,\n        text,\n      });\n\n      fallbackIndex++;\n    } catch (err) {\n      errors.push({\n        index: fallbackIndex,\n        rawBlock,\n        message: err instanceof Error ? err.message : String(err),\n      });\n    }\n  }\n\n  return { cues, errors };\n}\n","import { msToTimecode } from './timecode.js';\nimport type { SubtitleCue } from './types.js';\n\n/**\n * Serializes an array of SubtitleCue objects into standard SRT file format.\n *\n * Output format:\n * 1\n * 00:00:20,000 --> 00:00:24,000\n * Subtitle text\n *\n * @param cues - Array of SubtitleCue objects to format\n * @returns Standard formatted SRT string\n */\nexport function stringifySRT(cues: readonly SubtitleCue[]): string {\n  if (!cues || cues.length === 0) {\n    return '';\n  }\n\n  const blocks = cues.map((cue, idx) => {\n    const id = cue.id ? String(cue.id) : String(idx + 1);\n    const startStr = msToTimecode(cue.start, 'srt');\n    const endStr = msToTimecode(cue.end, 'srt');\n    const text = cue.text ?? '';\n\n    return `${id}\\n${startStr} --> ${endStr}\\n${text}`;\n  });\n\n  return blocks.join('\\n\\n') + '\\n';\n}\n","import type {\n  SubtitleCue,\n  LintDiagnostic,\n  LintProfile,\n} from './types.js';\n\n/** Default quality profiles for subtitle verification */\nexport const DEFAULT_PROFILES: Record<string, LintProfile> = {\n  standardLatin: {\n    name: 'Standard Latin (Netflix/BBC Style Guide)',\n    locale: 'en',\n    maxCps: 20,\n    maxCpl: 42,\n    minDurationMs: 800,\n    maxDurationMs: 7000,\n    includeSpaces: true,\n  },\n  indicKannada: {\n    name: 'Indic - Kannada Locale',\n    locale: 'kn',\n    maxCps: 15,\n    maxCpl: 35,\n    minDurationMs: 800,\n    maxDurationMs: 7000,\n    includeSpaces: true,\n  },\n};\n\n/**\n * Strips HTML formatting tags from subtitle text before measuring character limits.\n * Handles <i>, <b>, <u>, <font color=\"...\">, etc.\n */\nexport function stripFormattingTags(text: string): string {\n  return text.replace(/<[^>]*>/g, '');\n}\n\n/**\n * Counts user-perceived grapheme clusters using native ECMAScript Intl.Segmenter.\n * Accurately measures multi-byte conjuncts and vowel modifiers in Indic scripts (Kannada, Hindi),\n * as well as emojis and complex Unicode characters without UTF-16 code unit inflation.\n */\nexport function countGraphemes(text: string, locale: string = 'en'): number {\n  if (!text) return 0;\n\n  if (typeof Intl !== 'undefined' && 'Segmenter' in Intl) {\n    const segmenter = new Intl.Segmenter(locale, { granularity: 'grapheme' });\n    let count = 0;\n    // Iterate over segments efficiently without allocating full array\n    for (const _ of segmenter.segment(text)) {\n      count++;\n    }\n    return count;\n  }\n\n  // Fallback for environments lacking Intl.Segmenter\n  return [...text].length;\n}\n\n/**\n * Inspects an array of SubtitleCues against timing, structural, and reading speed rules.\n *\n * Rules verified:\n * - out-of-order: Cues not in ascending chronological order\n * - zero-or-negative-duration: Cues where end <= start\n * - overlap: Cues overlapping chronologically with preceding cues\n * - min-duration: Cues flashing too fast for comprehension (< 800ms)\n * - max-duration: Cues remaining on screen too long (> 7000ms)\n * - max-cpl: Any line exceeding characters-per-line limit\n * - max-cps: Reading speed exceeding characters-per-second limit\n *\n * @param cues - Array of SubtitleCue objects to inspect\n * @param customProfile - Optional custom thresholds or language profile\n * @returns Array of LintDiagnostic reports\n */\nexport function lintCues(\n  cues: readonly SubtitleCue[],\n  customProfile?: Partial<LintProfile>\n): LintDiagnostic[] {\n  const diagnostics: LintDiagnostic[] = [];\n  if (!cues || cues.length === 0) return diagnostics;\n\n  const profile: LintProfile = {\n    ...DEFAULT_PROFILES['standardLatin']!,\n    ...customProfile,\n  };\n\n  const {\n    locale = 'en',\n    maxCps,\n    maxCpl,\n    minDurationMs,\n    maxDurationMs,\n    includeSpaces = true,\n  } = profile;\n\n  for (let i = 0; i < cues.length; i++) {\n    const cue = cues[i];\n    if (!cue) continue;\n\n    const prevCue = i > 0 ? cues[i - 1] : undefined;\n    const duration = cue.end - cue.start;\n\n    // --- TIMING RULES ---\n\n    // 1. Out-of-order check\n    if (prevCue && cue.start < prevCue.start) {\n      diagnostics.push({\n        cueId: cue.id,\n        rule: 'out-of-order',\n        severity: 'error',\n        message: `Cue starts at ${cue.start}ms before previous cue start of ${prevCue.start}ms.`,\n        expected: `start >= ${prevCue.start}`,\n        actual: `start = ${cue.start}`,\n      });\n    }\n\n    // 2. Zero or negative duration check\n    if (cue.end <= cue.start) {\n      diagnostics.push({\n        cueId: cue.id,\n        rule: 'zero-or-negative-duration',\n        severity: 'error',\n        message: `Cue has invalid duration (${duration}ms). End timestamp must be greater than start timestamp.`,\n        expected: `end > ${cue.start}`,\n        actual: `end = ${cue.end}`,\n      });\n    }\n\n    // 3. Overlap check (only if not out-of-order)\n    if (prevCue && cue.start < prevCue.end && cue.start >= prevCue.start) {\n      const overlapMs = prevCue.end - cue.start;\n      diagnostics.push({\n        cueId: cue.id,\n        rule: 'overlap',\n        severity: 'error',\n        message: `Cue overlaps with previous cue by ${overlapMs}ms.`,\n        expected: `start >= ${prevCue.end}`,\n        actual: `start = ${cue.start}`,\n      });\n    }\n\n    // 4. Min duration check (only if duration is positive)\n    if (duration > 0 && duration < minDurationMs) {\n      diagnostics.push({\n        cueId: cue.id,\n        rule: 'min-duration',\n        severity: 'warning',\n        message: `Cue duration of ${duration}ms is below the minimum threshold of ${minDurationMs}ms.`,\n        expected: minDurationMs,\n        actual: duration,\n      });\n    }\n\n    // 5. Max duration check\n    if (duration > maxDurationMs) {\n      diagnostics.push({\n        cueId: cue.id,\n        rule: 'max-duration',\n        severity: 'warning',\n        message: `Cue duration of ${duration}ms exceeds the maximum threshold of ${maxDurationMs}ms.`,\n        expected: maxDurationMs,\n        actual: duration,\n      });\n    }\n\n    // --- TEXT & PERCEPTION RULES ---\n\n    const rawText = cue.text || '';\n    const cleanText = stripFormattingTags(rawText);\n\n    // 6. Characters Per Line (CPL) check\n    const lines = cleanText.split('\\n');\n    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {\n      const line = lines[lineIndex];\n      if (!line) continue;\n\n      const cpl = countGraphemes(line, locale);\n      if (cpl > maxCpl) {\n        diagnostics.push({\n          cueId: cue.id,\n          rule: 'max-cpl',\n          severity: 'warning',\n          message: `Line ${lineIndex + 1} has ${cpl} characters, exceeding the maximum limit of ${maxCpl} CPL.`,\n          expected: maxCpl,\n          actual: cpl,\n        });\n      }\n    }\n\n    // 7. Characters Per Second (CPS) reading speed check\n    if (duration > 0) {\n      const textToMeasure = includeSpaces\n        ? cleanText\n        : cleanText.replace(/\\s+/g, '');\n\n      const totalGraphemes = countGraphemes(textToMeasure, locale);\n      const cps = Number(((totalGraphemes / duration) * 1000).toFixed(1));\n\n      if (cps > maxCps) {\n        diagnostics.push({\n          cueId: cue.id,\n          rule: 'max-cps',\n          severity: 'warning',\n          message: `Reading speed of ${cps} CPS exceeds maximum limit of ${maxCps} CPS.`,\n          expected: maxCps,\n          actual: cps,\n        });\n      }\n    }\n  }\n\n  return diagnostics;\n}\n"]}