@utilix-tech/sdk 0.23.0 → 0.24.0

package/dist/index.cjs

@@ -4467,12 +4467,15 @@ function detectFillerWords(text) {
 // src/tools/data.ts
 var data_exports = {};
 __export(data_exports, {
+  convertSubtitles: () => convertSubtitles,
   csvToJson: () => csvToJson2,
   detectDelimiter: () => detectDelimiter2,
+  detectSubtitleFormat: () => detectSubtitleFormat,
   diffEnvExample: () => diffEnvExample,
   envToExport: () => envToExport,
   envToJson: () => envToJson,
   formatNdjson: () => formatNdjson,
+  formatSubtitleTimestamp: () => formatSubtitleTimestamp,
   formatToml: () => formatToml,
   formatXml: () => formatXml,
   getSection: () => getSection,
@@ -4492,7 +4495,11 @@ __export(data_exports, {
   parseCsv: () => parseCsv,
   parseEnv: () => parseEnv,
   parseIni: () => parseIni,
+  parseSubtitleTimestamp: () => parseSubtitleTimestamp,
+  parseSubtitles: () => parseSubtitles,
   parseXmlToObject: () => parseXmlToObject,
+  serializeSubtitles: () => serializeSubtitles,
+  shiftSubtitles: () => shiftSubtitles,
   stringifyIni: () => stringifyIni,
   toCsvString: () => toCsvString,
   tomlToJson: () => tomlToJson,
@@ -5619,6 +5626,176 @@ function jsonArrayToNdjson(input) {
   if (!Array.isArray(parsed)) return { error: "Input must be a JSON array" };
   return parsed.map((item) => JSON.stringify(item)).join("\n");
 }
+var _SUBTITLE_TIMESTAMP_RE = /(\d+):(\d{1,2}):(\d{1,2})[.,](\d{1,3})|(\d{1,3}):(\d{1,2})[.,](\d{1,3})/;
+var _VTT_BLOCK_KEYWORDS = ["NOTE", "STYLE", "REGION"];
+function parseSubtitleTimestamp(raw) {
+  const m = _SUBTITLE_TIMESTAMP_RE.exec(raw.trim());
+  if (!m || m.index !== 0) return null;
+  let hours;
+  let minutes;
+  let seconds;
+  let millis;
+  if (m[1] !== void 0) {
+    hours = Number(m[1]);
+    minutes = Number(m[2]);
+    seconds = Number(m[3]);
+    millis = m[4];
+  } else {
+    hours = 0;
+    minutes = Number(m[5]);
+    seconds = Number(m[6]);
+    millis = m[7];
+  }
+  if (minutes > 59 || seconds > 59) return null;
+  return hours * 3600 + minutes * 60 + seconds + Number(millis.padEnd(3, "0")) / 1e3;
+}
+function formatSubtitleTimestamp(totalSeconds, format) {
+  const totalMs = Math.round(Math.max(0, totalSeconds) * 1e3);
+  const ms = totalMs % 1e3;
+  const totalSecs = Math.floor(totalMs / 1e3);
+  const pad = (n, width = 2) => String(n).padStart(width, "0");
+  return `${pad(Math.floor(totalSecs / 3600))}:${pad(Math.floor(totalSecs / 60) % 60)}:${pad(totalSecs % 60)}${format === "srt" ? "," : "."}${pad(ms, 3)}`;
+}
+function _stripBom(input) {
+  return input.charCodeAt(0) === 65279 ? input.slice(1) : input;
+}
+function detectSubtitleFormat(input) {
+  const text = _stripBom(input).trimStart();
+  if (/^WEBVTT/.test(text)) return "vtt";
+  const arrow = /(\d{1,3}):(\d{1,2})(?::(\d{1,2}))?([.,])(\d{1,3})\s*-->/.exec(text);
+  if (arrow && arrow[4] === ".") return "vtt";
+  return "srt";
+}
+function parseSubtitles(input, format) {
+  if (typeof input !== "string" || input.trim().length === 0) {
+    return { error: "Subtitle input is empty" };
+  }
+  const sourceFormat = format ?? detectSubtitleFormat(input);
+  const normalised = _stripBom(input).replace(/\r\n?/g, "\n");
+  const warnings = [];
+  let body = normalised;
+  if (sourceFormat === "vtt") {
+    const headerMatch = /^WEBVTT[^\n]*\n?/.exec(body.trimStart());
+    if (headerMatch) {
+      body = body.trimStart().slice(headerMatch[0].length);
+    } else {
+      warnings.push('WebVTT input is missing its "WEBVTT" header line');
+    }
+  }
+  const blocks = body.split(/\n[ \t]*\n+/).map((b) => b.trim()).filter((b) => b.length > 0);
+  const cues = [];
+  for (const block of blocks) {
+    const lines = block.split("\n");
+    const arrowIdx = lines.findIndex((l) => l.includes("-->"));
+    if (arrowIdx === -1) {
+      const keyword = _VTT_BLOCK_KEYWORDS.find((k) => lines[0] === k || lines[0].startsWith(`${k} `));
+      if (sourceFormat === "vtt" && keyword) {
+        warnings.push(`Dropped a WebVTT ${keyword} block, which has no SRT equivalent`);
+      } else {
+        warnings.push(`Skipped a block with no "-->" timing line: ${JSON.stringify(lines[0].slice(0, 40))}`);
+      }
+      continue;
+    }
+    const timingLine = lines[arrowIdx];
+    const parts = timingLine.split("-->");
+    const start = parseSubtitleTimestamp(parts[0] ?? "");
+    const rightTrimmed = (parts[1] ?? "").trim();
+    const end = parseSubtitleTimestamp(rightTrimmed);
+    if (start === null || end === null) {
+      warnings.push(`Skipped a cue with an unparseable timing line: ${JSON.stringify(timingLine.slice(0, 60))}`);
+      continue;
+    }
+    const endMatch = _SUBTITLE_TIMESTAMP_RE.exec(rightTrimmed);
+    const settings = endMatch ? rightTrimmed.slice(endMatch[0].length).trim() : "";
+    const idLines = lines.slice(0, arrowIdx).filter((l) => l.trim().length > 0);
+    const text = lines.slice(arrowIdx + 1).join("\n").trim();
+    const cue = { index: cues.length + 1, start, end, text };
+    if (sourceFormat === "vtt" && idLines.length > 0) cue.id = idLines[idLines.length - 1].trim();
+    if (settings.length > 0) cue.settings = settings;
+    if (end < start) warnings.push(`Cue ${cue.index} ends before it starts`);
+    if (text.length === 0) warnings.push(`Cue ${cue.index} has no text`);
+    if (cues.length > 0 && start < cues[cues.length - 1].end) {
+      warnings.push(`Cue ${cue.index} starts before cue ${cue.index - 1} ends (overlapping cues)`);
+    }
+    cues.push(cue);
+  }
+  if (cues.length === 0) {
+    return { error: "No subtitle cues found: check that the input is a valid SRT or WebVTT file" };
+  }
+  return {
+    format: sourceFormat,
+    cues,
+    cueCount: cues.length,
+    duration: Math.round(Math.max(...cues.map((c) => c.end)) * 1e3) / 1e3,
+    warnings
+  };
+}
+function serializeSubtitles(cues, format) {
+  const blocks = cues.map((cue, i) => {
+    const time = `${formatSubtitleTimestamp(cue.start, format)} --> ${formatSubtitleTimestamp(cue.end, format)}`;
+    if (format === "srt") return `${i + 1}
+${time}
+${cue.text}`;
+    const timing = cue.settings ? `${time} ${cue.settings}` : time;
+    return cue.id ? `${cue.id}
+${timing}
+${cue.text}` : `${timing}
+${cue.text}`;
+  });
+  const body = blocks.join("\n\n");
+  return format === "vtt" ? `WEBVTT
+
+${body}
+` : `${body}
+`;
+}
+function convertSubtitles(input, target, sourceFormat) {
+  if (target !== "srt" && target !== "vtt") return { error: 'target must be "srt" or "vtt"' };
+  const parsed = parseSubtitles(input, sourceFormat);
+  if ("error" in parsed) return parsed;
+  const warnings = [...parsed.warnings];
+  if (target === "srt") {
+    const droppedSettings = parsed.cues.filter((c) => c.settings).length;
+    const droppedIds = parsed.cues.filter((c) => c.id).length;
+    if (droppedSettings > 0) {
+      warnings.push(`Dropped WebVTT cue settings on ${droppedSettings} cue(s): SRT has no equivalent`);
+    }
+    if (droppedIds > 0) {
+      warnings.push(`Dropped ${droppedIds} WebVTT cue identifier(s): SRT numbers cues sequentially instead`);
+    }
+  }
+  return {
+    format: target,
+    sourceFormat: parsed.format,
+    output: serializeSubtitles(parsed.cues, target),
+    cueCount: parsed.cueCount,
+    duration: parsed.duration,
+    warnings
+  };
+}
+function shiftSubtitles(input, offsetSeconds, target) {
+  if (!Number.isFinite(offsetSeconds)) return { error: "offsetSeconds must be a finite number" };
+  const parsed = parseSubtitles(input);
+  if ("error" in parsed) return parsed;
+  const warnings = [...parsed.warnings];
+  let clamped = 0;
+  const shifted = parsed.cues.map((cue) => {
+    const start = cue.start + offsetSeconds;
+    const end = cue.end + offsetSeconds;
+    if (start < 0) clamped += 1;
+    return { ...cue, start: Math.max(0, start), end: Math.max(0, end) };
+  });
+  if (clamped > 0) warnings.push(`${clamped} cue(s) would start before zero and were clamped to 00:00:00`);
+  const outFormat = target ?? parsed.format;
+  return {
+    format: outFormat,
+    sourceFormat: parsed.format,
+    output: serializeSubtitles(shifted, outFormat),
+    cueCount: shifted.length,
+    duration: Math.round(Math.max(...shifted.map((c) => c.end)) * 1e3) / 1e3,
+    warnings
+  };
+}
 
 // src/tools/generators.ts
 var generators_exports = {};
@@ -6924,11 +7101,13 @@ __export(units_exports, {
   COMMON_TAX_RATES: () => COMMON_TAX_RATES,
   COMMON_TIP_PERCENTAGES: () => COMMON_TIP_PERCENTAGES,
   COMMON_VIEWPORTS: () => COMMON_VIEWPORTS,
+  applySuccessiveDiscounts: () => applySuccessiveDiscounts,
   autoFormat: () => autoFormat,
   bumpVersion: () => bumpVersion,
   calcAspectRatio: () => calcAspectRatio,
   calcSubnet: () => calcSubnet,
   calculateCompoundInterest: () => calculateCompoundInterest,
+  calculateDiscount: () => calculateDiscount,
   calculateLoan: () => calculateLoan,
   calculateMarginMarkup: () => calculateMarginMarkup,
   calculatePercentageChange: () => calculatePercentageChange,
@@ -8374,6 +8553,88 @@ function markupToMargin(markupPercent) {
   }
   return Math.round(markupPercent / (100 + markupPercent) * 100 * 1e4) / 1e4;
 }
+var _DISCOUNT_FIELDS = ["discountPercent", "discountAmount", "finalPrice"];
+function calculateDiscount(input) {
+  const provided = (v) => typeof v === "number" && Number.isFinite(v);
+  if (!provided(input.originalPrice)) {
+    return { error: "originalPrice is required and must be a finite number" };
+  }
+  const originalPrice = input.originalPrice;
+  if (originalPrice <= 0) return { error: "Original price must be greater than zero" };
+  const given = _DISCOUNT_FIELDS.filter((f) => provided(input[f]));
+  if (given.length !== 1) {
+    return { error: `Provide exactly one of discountPercent, discountAmount, finalPrice (got ${given.length})` };
+  }
+  const field = given[0];
+  let discountAmount;
+  if (field === "discountPercent") {
+    const pct = input.discountPercent;
+    if (pct < 0) return { error: "Discount percent cannot be negative" };
+    if (pct > 100) return { error: "Discount percent cannot exceed 100" };
+    discountAmount = originalPrice * (pct / 100);
+  } else if (field === "discountAmount") {
+    const amt = input.discountAmount;
+    if (amt < 0) return { error: "Discount amount cannot be negative" };
+    if (amt > originalPrice) return { error: "Discount amount cannot exceed the original price" };
+    discountAmount = amt;
+  } else {
+    const fin = input.finalPrice;
+    if (fin < 0) return { error: "Final price cannot be negative" };
+    if (fin > originalPrice) {
+      return { error: "Final price cannot exceed the original price: that is a price increase, not a discount" };
+    }
+    discountAmount = originalPrice - fin;
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const finalPrice = originalPrice - discountAmount;
+  return {
+    originalPrice: round4(originalPrice),
+    finalPrice: round4(finalPrice),
+    discountAmount: round4(discountAmount),
+    discountPercent: round4(discountAmount / originalPrice * 100),
+    given: field,
+    solvedFor: _DISCOUNT_FIELDS.filter((f) => f !== field)
+  };
+}
+function applySuccessiveDiscounts(originalPrice, discountPercents) {
+  if (!Number.isFinite(originalPrice) || originalPrice <= 0) {
+    return { error: "Original price must be a finite number greater than zero" };
+  }
+  if (!Array.isArray(discountPercents) || discountPercents.length === 0) {
+    return { error: "Provide at least one discount percent" };
+  }
+  if (discountPercents.length > 20) {
+    return { error: "Provide at most 20 successive discounts" };
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const steps = [];
+  let running = originalPrice;
+  let sumOfDiscountPercents = 0;
+  for (const pct of discountPercents) {
+    if (!Number.isFinite(pct)) return { error: "Every discount percent must be a finite number" };
+    if (pct < 0) return { error: "Discount percent cannot be negative" };
+    if (pct > 100) return { error: "Discount percent cannot exceed 100" };
+    const priceBefore = running;
+    const saved = priceBefore * (pct / 100);
+    running = priceBefore - saved;
+    sumOfDiscountPercents += pct;
+    steps.push({
+      discountPercent: round4(pct),
+      priceBefore: round4(priceBefore),
+      priceAfter: round4(running),
+      saved: round4(saved)
+    });
+  }
+  const totalSaved = originalPrice - running;
+  return {
+    originalPrice: round4(originalPrice),
+    finalPrice: round4(running),
+    totalSaved: round4(totalSaved),
+    effectiveDiscountPercent: round4(totalSaved / originalPrice * 100),
+    sumOfDiscountPercents: round4(sumOfDiscountPercents),
+    steps
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};

package/dist/index.d.cts

@@ -2,10 +2,10 @@ export { j as json } from './json-DEVFIpsC.cjs';
 export { e as encoding } from './encoding-Dk3wpmb3.cjs';
 export { h as hashing } from './hashing-CnetQFD_.cjs';
 export { t as text } from './text-DS70aMY5.cjs';
-export { d as data } from './data-D8XTI7Du.cjs';
+export { d as data } from './data-XRb0D7Zn.cjs';
 export { g as generators } from './generators-BGtRGpJZ.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
-export { u as units } from './units-h4rHQGp5.cjs';
+export { u as units } from './units-DAoSM2g8.cjs';
 export { n as network } from './network-BJOjJnmY.cjs';
 export { a as api } from './api-Xl7OzIgq.cjs';
 export { c as code } from './code-DaRvff2v.cjs';

package/dist/index.d.ts

@@ -2,10 +2,10 @@ export { j as json } from './json-DEVFIpsC.js';
 export { e as encoding } from './encoding-Dk3wpmb3.js';
 export { h as hashing } from './hashing-CnetQFD_.js';
 export { t as text } from './text-DS70aMY5.js';
-export { d as data } from './data-D8XTI7Du.js';
+export { d as data } from './data-XRb0D7Zn.js';
 export { g as generators } from './generators-BGtRGpJZ.js';
 export { t as time } from './time-KqJjdqII.js';
-export { u as units } from './units-h4rHQGp5.js';
+export { u as units } from './units-DAoSM2g8.js';
 export { n as network } from './network-BJOjJnmY.js';
 export { a as api } from './api-Xl7OzIgq.js';
 export { c as code } from './code-DaRvff2v.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 export { media_exports as media } from './chunk-XMKJYVKB.js';
-export { units_exports as units } from './chunk-AIKSKJ77.js';
+export { units_exports as units } from './chunk-HZIS2DMJ.js';
 export { network_exports as network } from './chunk-Y5OOP6WN.js';
 export { api_exports as api } from './chunk-Q3B3YWOA.js';
 export { code_exports as code } from './chunk-LXKIPPDG.js';
@@ -11,7 +11,7 @@ export { json_exports as json } from './chunk-WO3LJMVV.js';
 export { encoding_exports as encoding } from './chunk-DOWQZUTP.js';
 export { hashing_exports as hashing } from './chunk-GEFVMGZR.js';
 export { text_exports as text } from './chunk-2I4O5YCT.js';
-export { data_exports as data } from './chunk-TINQFTLO.js';
+export { data_exports as data } from './chunk-66QHV5KW.js';
 export { generators_exports as generators } from './chunk-2CJSLYWI.js';
 export { time_exports as time } from './chunk-IEPWZERQ.js';
 import './chunk-MLKGABMK.js';

package/dist/tools/data.cjs

@@ -1139,13 +1139,186 @@ function jsonArrayToNdjson(input) {
   if (!Array.isArray(parsed)) return { error: "Input must be a JSON array" };
   return parsed.map((item) => JSON.stringify(item)).join("\n");
 }
+var _SUBTITLE_TIMESTAMP_RE = /(\d+):(\d{1,2}):(\d{1,2})[.,](\d{1,3})|(\d{1,3}):(\d{1,2})[.,](\d{1,3})/;
+var _VTT_BLOCK_KEYWORDS = ["NOTE", "STYLE", "REGION"];
+function parseSubtitleTimestamp(raw) {
+  const m = _SUBTITLE_TIMESTAMP_RE.exec(raw.trim());
+  if (!m || m.index !== 0) return null;
+  let hours;
+  let minutes;
+  let seconds;
+  let millis;
+  if (m[1] !== void 0) {
+    hours = Number(m[1]);
+    minutes = Number(m[2]);
+    seconds = Number(m[3]);
+    millis = m[4];
+  } else {
+    hours = 0;
+    minutes = Number(m[5]);
+    seconds = Number(m[6]);
+    millis = m[7];
+  }
+  if (minutes > 59 || seconds > 59) return null;
+  return hours * 3600 + minutes * 60 + seconds + Number(millis.padEnd(3, "0")) / 1e3;
+}
+function formatSubtitleTimestamp(totalSeconds, format) {
+  const totalMs = Math.round(Math.max(0, totalSeconds) * 1e3);
+  const ms = totalMs % 1e3;
+  const totalSecs = Math.floor(totalMs / 1e3);
+  const pad = (n, width = 2) => String(n).padStart(width, "0");
+  return `${pad(Math.floor(totalSecs / 3600))}:${pad(Math.floor(totalSecs / 60) % 60)}:${pad(totalSecs % 60)}${format === "srt" ? "," : "."}${pad(ms, 3)}`;
+}
+function _stripBom(input) {
+  return input.charCodeAt(0) === 65279 ? input.slice(1) : input;
+}
+function detectSubtitleFormat(input) {
+  const text = _stripBom(input).trimStart();
+  if (/^WEBVTT/.test(text)) return "vtt";
+  const arrow = /(\d{1,3}):(\d{1,2})(?::(\d{1,2}))?([.,])(\d{1,3})\s*-->/.exec(text);
+  if (arrow && arrow[4] === ".") return "vtt";
+  return "srt";
+}
+function parseSubtitles(input, format) {
+  if (typeof input !== "string" || input.trim().length === 0) {
+    return { error: "Subtitle input is empty" };
+  }
+  const sourceFormat = format ?? detectSubtitleFormat(input);
+  const normalised = _stripBom(input).replace(/\r\n?/g, "\n");
+  const warnings = [];
+  let body = normalised;
+  if (sourceFormat === "vtt") {
+    const headerMatch = /^WEBVTT[^\n]*\n?/.exec(body.trimStart());
+    if (headerMatch) {
+      body = body.trimStart().slice(headerMatch[0].length);
+    } else {
+      warnings.push('WebVTT input is missing its "WEBVTT" header line');
+    }
+  }
+  const blocks = body.split(/\n[ \t]*\n+/).map((b) => b.trim()).filter((b) => b.length > 0);
+  const cues = [];
+  for (const block of blocks) {
+    const lines = block.split("\n");
+    const arrowIdx = lines.findIndex((l) => l.includes("-->"));
+    if (arrowIdx === -1) {
+      const keyword = _VTT_BLOCK_KEYWORDS.find((k) => lines[0] === k || lines[0].startsWith(`${k} `));
+      if (sourceFormat === "vtt" && keyword) {
+        warnings.push(`Dropped a WebVTT ${keyword} block, which has no SRT equivalent`);
+      } else {
+        warnings.push(`Skipped a block with no "-->" timing line: ${JSON.stringify(lines[0].slice(0, 40))}`);
+      }
+      continue;
+    }
+    const timingLine = lines[arrowIdx];
+    const parts = timingLine.split("-->");
+    const start = parseSubtitleTimestamp(parts[0] ?? "");
+    const rightTrimmed = (parts[1] ?? "").trim();
+    const end = parseSubtitleTimestamp(rightTrimmed);
+    if (start === null || end === null) {
+      warnings.push(`Skipped a cue with an unparseable timing line: ${JSON.stringify(timingLine.slice(0, 60))}`);
+      continue;
+    }
+    const endMatch = _SUBTITLE_TIMESTAMP_RE.exec(rightTrimmed);
+    const settings = endMatch ? rightTrimmed.slice(endMatch[0].length).trim() : "";
+    const idLines = lines.slice(0, arrowIdx).filter((l) => l.trim().length > 0);
+    const text = lines.slice(arrowIdx + 1).join("\n").trim();
+    const cue = { index: cues.length + 1, start, end, text };
+    if (sourceFormat === "vtt" && idLines.length > 0) cue.id = idLines[idLines.length - 1].trim();
+    if (settings.length > 0) cue.settings = settings;
+    if (end < start) warnings.push(`Cue ${cue.index} ends before it starts`);
+    if (text.length === 0) warnings.push(`Cue ${cue.index} has no text`);
+    if (cues.length > 0 && start < cues[cues.length - 1].end) {
+      warnings.push(`Cue ${cue.index} starts before cue ${cue.index - 1} ends (overlapping cues)`);
+    }
+    cues.push(cue);
+  }
+  if (cues.length === 0) {
+    return { error: "No subtitle cues found: check that the input is a valid SRT or WebVTT file" };
+  }
+  return {
+    format: sourceFormat,
+    cues,
+    cueCount: cues.length,
+    duration: Math.round(Math.max(...cues.map((c) => c.end)) * 1e3) / 1e3,
+    warnings
+  };
+}
+function serializeSubtitles(cues, format) {
+  const blocks = cues.map((cue, i) => {
+    const time = `${formatSubtitleTimestamp(cue.start, format)} --> ${formatSubtitleTimestamp(cue.end, format)}`;
+    if (format === "srt") return `${i + 1}
+${time}
+${cue.text}`;
+    const timing = cue.settings ? `${time} ${cue.settings}` : time;
+    return cue.id ? `${cue.id}
+${timing}
+${cue.text}` : `${timing}
+${cue.text}`;
+  });
+  const body = blocks.join("\n\n");
+  return format === "vtt" ? `WEBVTT
+
+${body}
+` : `${body}
+`;
+}
+function convertSubtitles(input, target, sourceFormat) {
+  if (target !== "srt" && target !== "vtt") return { error: 'target must be "srt" or "vtt"' };
+  const parsed = parseSubtitles(input, sourceFormat);
+  if ("error" in parsed) return parsed;
+  const warnings = [...parsed.warnings];
+  if (target === "srt") {
+    const droppedSettings = parsed.cues.filter((c) => c.settings).length;
+    const droppedIds = parsed.cues.filter((c) => c.id).length;
+    if (droppedSettings > 0) {
+      warnings.push(`Dropped WebVTT cue settings on ${droppedSettings} cue(s): SRT has no equivalent`);
+    }
+    if (droppedIds > 0) {
+      warnings.push(`Dropped ${droppedIds} WebVTT cue identifier(s): SRT numbers cues sequentially instead`);
+    }
+  }
+  return {
+    format: target,
+    sourceFormat: parsed.format,
+    output: serializeSubtitles(parsed.cues, target),
+    cueCount: parsed.cueCount,
+    duration: parsed.duration,
+    warnings
+  };
+}
+function shiftSubtitles(input, offsetSeconds, target) {
+  if (!Number.isFinite(offsetSeconds)) return { error: "offsetSeconds must be a finite number" };
+  const parsed = parseSubtitles(input);
+  if ("error" in parsed) return parsed;
+  const warnings = [...parsed.warnings];
+  let clamped = 0;
+  const shifted = parsed.cues.map((cue) => {
+    const start = cue.start + offsetSeconds;
+    const end = cue.end + offsetSeconds;
+    if (start < 0) clamped += 1;
+    return { ...cue, start: Math.max(0, start), end: Math.max(0, end) };
+  });
+  if (clamped > 0) warnings.push(`${clamped} cue(s) would start before zero and were clamped to 00:00:00`);
+  const outFormat = target ?? parsed.format;
+  return {
+    format: outFormat,
+    sourceFormat: parsed.format,
+    output: serializeSubtitles(shifted, outFormat),
+    cueCount: shifted.length,
+    duration: Math.round(Math.max(...shifted.map((c) => c.end)) * 1e3) / 1e3,
+    warnings
+  };
+}
 
+exports.convertSubtitles = convertSubtitles;
 exports.csvToJson = csvToJson;
 exports.detectDelimiter = detectDelimiter;
+exports.detectSubtitleFormat = detectSubtitleFormat;
 exports.diffEnvExample = diffEnvExample;
 exports.envToExport = envToExport;
 exports.envToJson = envToJson;
 exports.formatNdjson = formatNdjson;
+exports.formatSubtitleTimestamp = formatSubtitleTimestamp;
 exports.formatToml = formatToml;
 exports.formatXml = formatXml;
 exports.getSection = getSection;
@@ -1165,7 +1338,11 @@ exports.ndjsonToJsonArray = ndjsonToJsonArray;
 exports.parseCsv = parseCsv;
 exports.parseEnv = parseEnv;
 exports.parseIni = parseIni;
+exports.parseSubtitleTimestamp = parseSubtitleTimestamp;
+exports.parseSubtitles = parseSubtitles;
 exports.parseXmlToObject = parseXmlToObject;
+exports.serializeSubtitles = serializeSubtitles;
+exports.shiftSubtitles = shiftSubtitles;
 exports.stringifyIni = stringifyIni;
 exports.toCsvString = toCsvString;
 exports.tomlToJson = tomlToJson;

package/dist/tools/data.d.cts

@@ -1 +1 @@
-export { C as CsvParseResult, E as EnvDiffError, a as EnvDiffResult, b as EnvEntry, c as EnvParseResult, I as IniSection, N as NdjsonLineResult, e as NdjsonValidateResult, P as ParseOptions, f as ParsedIni, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, g as XmlToJsonOptions, h as csvToJson, i as detectDelimiter, j as diffEnvExample, k as envToExport, l as envToJson, m as formatNdjson, n as formatToml, o as formatXml, p as getSection, q as getSectionNames, r as getTomlStats, s as getXmlStats, t as getYamlStats, u as iniToJson, v as jsonArrayToNdjson, w as jsonToIni, x as jsonToToml, y as jsonToXml, z as minifyNdjson, A as minifyToml, B as minifyXml, D as ndjsonToJsonArray, F as parseCsv, G as parseEnv, H as parseIni, J as parseXmlToObject, K as stringifyIni, L as toCsvString, M as tomlToJson, O as validateEnvKey, Q as validateIni, R as validateNdjson, S as validateToml, U as validateXml, W as validateYaml, Y as xmlToJson } from '../data-D8XTI7Du.cjs';
+export { C as ConvertedSubtitles, a as CsvParseResult, E as EnvDiffError, b as EnvDiffResult, c as EnvEntry, e as EnvParseResult, I as IniSection, N as NdjsonLineResult, f as NdjsonValidateResult, P as ParseOptions, g as ParsedIni, h as ParsedSubtitles, S as SubtitleCue, i as SubtitleFormat, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, j as XmlToJsonOptions, k as convertSubtitles, l as csvToJson, m as detectDelimiter, n as detectSubtitleFormat, o as diffEnvExample, p as envToExport, q as envToJson, r as formatNdjson, s as formatSubtitleTimestamp, t as formatToml, u as formatXml, v as getSection, w as getSectionNames, x as getTomlStats, y as getXmlStats, z as getYamlStats, A as iniToJson, B as jsonArrayToNdjson, D as jsonToIni, F as jsonToToml, G as jsonToXml, H as minifyNdjson, J as minifyToml, K as minifyXml, L as ndjsonToJsonArray, M as parseCsv, O as parseEnv, Q as parseIni, R as parseSubtitleTimestamp, U as parseSubtitles, W as parseXmlToObject, Y as serializeSubtitles, Z as shiftSubtitles, _ as stringifyIni, $ as toCsvString, a0 as tomlToJson, a1 as validateEnvKey, a2 as validateIni, a3 as validateNdjson, a4 as validateToml, a5 as validateXml, a6 as validateYaml, a7 as xmlToJson } from '../data-XRb0D7Zn.cjs';

package/dist/tools/data.d.ts

@@ -1 +1 @@
-export { C as CsvParseResult, E as EnvDiffError, a as EnvDiffResult, b as EnvEntry, c as EnvParseResult, I as IniSection, N as NdjsonLineResult, e as NdjsonValidateResult, P as ParseOptions, f as ParsedIni, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, g as XmlToJsonOptions, h as csvToJson, i as detectDelimiter, j as diffEnvExample, k as envToExport, l as envToJson, m as formatNdjson, n as formatToml, o as formatXml, p as getSection, q as getSectionNames, r as getTomlStats, s as getXmlStats, t as getYamlStats, u as iniToJson, v as jsonArrayToNdjson, w as jsonToIni, x as jsonToToml, y as jsonToXml, z as minifyNdjson, A as minifyToml, B as minifyXml, D as ndjsonToJsonArray, F as parseCsv, G as parseEnv, H as parseIni, J as parseXmlToObject, K as stringifyIni, L as toCsvString, M as tomlToJson, O as validateEnvKey, Q as validateIni, R as validateNdjson, S as validateToml, U as validateXml, W as validateYaml, Y as xmlToJson } from '../data-D8XTI7Du.js';
+export { C as ConvertedSubtitles, a as CsvParseResult, E as EnvDiffError, b as EnvDiffResult, c as EnvEntry, e as EnvParseResult, I as IniSection, N as NdjsonLineResult, f as NdjsonValidateResult, P as ParseOptions, g as ParsedIni, h as ParsedSubtitles, S as SubtitleCue, i as SubtitleFormat, T as TomlFormatResult, V as ValidationResult, X as XmlFormatResult, j as XmlToJsonOptions, k as convertSubtitles, l as csvToJson, m as detectDelimiter, n as detectSubtitleFormat, o as diffEnvExample, p as envToExport, q as envToJson, r as formatNdjson, s as formatSubtitleTimestamp, t as formatToml, u as formatXml, v as getSection, w as getSectionNames, x as getTomlStats, y as getXmlStats, z as getYamlStats, A as iniToJson, B as jsonArrayToNdjson, D as jsonToIni, F as jsonToToml, G as jsonToXml, H as minifyNdjson, J as minifyToml, K as minifyXml, L as ndjsonToJsonArray, M as parseCsv, O as parseEnv, Q as parseIni, R as parseSubtitleTimestamp, U as parseSubtitles, W as parseXmlToObject, Y as serializeSubtitles, Z as shiftSubtitles, _ as stringifyIni, $ as toCsvString, a0 as tomlToJson, a1 as validateEnvKey, a2 as validateIni, a3 as validateNdjson, a4 as validateToml, a5 as validateXml, a6 as validateYaml, a7 as xmlToJson } from '../data-XRb0D7Zn.js';

package/dist/tools/data.js

@@ -1,2 +1,2 @@
-export { csvToJson, detectDelimiter, diffEnvExample, envToExport, envToJson, formatNdjson, formatToml, formatXml, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToJsonArray, parseCsv, parseEnv, parseIni, parseXmlToObject, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson } from '../chunk-TINQFTLO.js';
+export { convertSubtitles, csvToJson, detectDelimiter, detectSubtitleFormat, diffEnvExample, envToExport, envToJson, formatNdjson, formatSubtitleTimestamp, formatToml, formatXml, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToJsonArray, parseCsv, parseEnv, parseIni, parseSubtitleTimestamp, parseSubtitles, parseXmlToObject, serializeSubtitles, shiftSubtitles, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson } from '../chunk-66QHV5KW.js';
 import '../chunk-MLKGABMK.js';