@design-edito/tools 0.5.6 → 0.5.8

package/agnostic/arrays/index.d.ts

@@ -1,6 +1,6 @@
 export * as dedupe from './dedupe/index.js'
 export * as findDuplicates from './find-duplicates/index.js'
-export * as isArrayOf from './is-array-of/index.js'
 export * as make from './make/index.js'
-export * as randomPick from './random-pick/index.js'
+export * as isArrayOf from './is-array-of/index.js'
 export * as shuffle from './shuffle/index.js'
+export * as randomPick from './random-pick/index.js'

package/agnostic/arrays/index.js

@@ -1,6 +1,6 @@
 export * as dedupe from './dedupe/index.js'
 export * as findDuplicates from './find-duplicates/index.js'
-export * as isArrayOf from './is-array-of/index.js'
 export * as make from './make/index.js'
-export * as randomPick from './random-pick/index.js'
+export * as isArrayOf from './is-array-of/index.js'
 export * as shuffle from './shuffle/index.js'
+export * as randomPick from './random-pick/index.js'

package/agnostic/colors/index.d.ts

@@ -4,9 +4,9 @@ export * as convert from './convert/index.js'
 export * as distance from './distance/index.js'
 export * as grayscale from './grayscale/index.js'
 export * as invert from './invert/index.js'
-export * as luminance from './luminance/index.js'
-export * as lerp from './lerp/index.js'
 export * as palette from './palette/index.js'
+export * as lerp from './lerp/index.js'
 export * as tidy from './tidy/index.js'
 export * as rotate from './rotate/index.js'
 export * as typechecks from './typechecks/index.js'
+export * as luminance from './luminance/index.js'

package/agnostic/colors/index.js

@@ -4,9 +4,9 @@ export * as convert from './convert/index.js'
 export * as distance from './distance/index.js'
 export * as grayscale from './grayscale/index.js'
 export * as invert from './invert/index.js'
-export * as luminance from './luminance/index.js'
-export * as lerp from './lerp/index.js'
 export * as palette from './palette/index.js'
+export * as lerp from './lerp/index.js'
 export * as tidy from './tidy/index.js'
 export * as rotate from './rotate/index.js'
 export * as typechecks from './typechecks/index.js'
+export * as luminance from './luminance/index.js'

package/agnostic/css/index.d.ts

@@ -1,6 +1,6 @@
 export * as bem from './bem/index.js'
-export * as clss from './clss/index.js'
 export * as generateNiceColor from './generate-nice-color/index.js'
 export * as isValidCssClassName from './is-valid-css-class-name/index.js'
+export * as clss from './clss/index.js'
 export * as scale from './scale/index.js'
 export * as stylesSet from './styles-set/index.js'

package/agnostic/css/index.js

@@ -1,6 +1,6 @@
 export * as bem from './bem/index.js'
-export * as clss from './clss/index.js'
 export * as generateNiceColor from './generate-nice-color/index.js'
 export * as isValidCssClassName from './is-valid-css-class-name/index.js'
+export * as clss from './clss/index.js'
 export * as scale from './scale/index.js'
 export * as stylesSet from './styles-set/index.js'

package/agnostic/html/hyper-json/smart-tags/coalesced/index.d.ts

@@ -1,38 +1,38 @@
 export * as add from './add/index.js'
 export * as addclass from './addclass/index.js'
 export * as and from './and/index.js'
-export * as append from './append/index.js'
-export * as clone from './clone/index.js'
 export * as at from './at/index.js'
+export * as append from './append/index.js'
 export * as call from './call/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
+export * as clone from './clone/index.js'
 export * as equals from './equals/index.js'
 export * as getattribute from './getattribute/index.js'
 export * as getproperties from './getproperties/index.js'
-export * as getproperty from './getproperty/index.js'
 export * as hjparse from './hjparse/index.js'
+export * as getproperty from './getproperty/index.js'
 export * as hjstringify from './hjstringify/index.js'
-export * as initialize from './initialize/index.js'
 export * as if from './if/index.js'
-export * as join from './join/index.js'
-export * as map from './map/index.js'
+export * as initialize from './initialize/index.js'
 export * as length from './length/index.js'
+export * as map from './map/index.js'
 export * as negate from './negate/index.js'
 export * as notrailing from './notrailing/index.js'
+export * as or from './or/index.js'
 export * as pickrandom from './pickrandom/index.js'
 export * as populate from './populate/index.js'
+export * as join from './join/index.js'
 export * as print from './print/index.js'
-export * as or from './or/index.js'
 export * as pusheach from './pusheach/index.js'
 export * as recordtoarray from './recordtoarray/index.js'
+export * as push from './push/index.js'
 export * as removeattribute from './removeattribute/index.js'
 export * as removeclass from './removeclass/index.js'
-export * as push from './push/index.js'
 export * as renameproperty from './renameproperty/index.js'
 export * as replace from './replace/index.js'
 export * as select from './select/index.js'
-export * as set from './set/index.js'
 export * as setattribute from './setattribute/index.js'
+export * as set from './set/index.js'
 export * as setproperty from './setproperty/index.js'
 export * as sorton from './sorton/index.js'
 export * as split from './split/index.js'
@@ -48,5 +48,5 @@ export * as torecord from './torecord/index.js'
 export * as toref from './toref/index.js'
 export * as tostring from './tostring/index.js'
 export * as totext from './totext/index.js'
-export * as trim from './trim/index.js'
 export * as transformselected from './transformselected/index.js'
+export * as trim from './trim/index.js'

package/agnostic/html/hyper-json/smart-tags/coalesced/index.js

@@ -1,38 +1,38 @@
 export * as add from './add/index.js'
 export * as addclass from './addclass/index.js'
 export * as and from './and/index.js'
-export * as append from './append/index.js'
-export * as clone from './clone/index.js'
 export * as at from './at/index.js'
+export * as append from './append/index.js'
 export * as call from './call/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
+export * as clone from './clone/index.js'
 export * as equals from './equals/index.js'
 export * as getattribute from './getattribute/index.js'
 export * as getproperties from './getproperties/index.js'
-export * as getproperty from './getproperty/index.js'
 export * as hjparse from './hjparse/index.js'
+export * as getproperty from './getproperty/index.js'
 export * as hjstringify from './hjstringify/index.js'
-export * as initialize from './initialize/index.js'
 export * as if from './if/index.js'
-export * as join from './join/index.js'
-export * as map from './map/index.js'
+export * as initialize from './initialize/index.js'
 export * as length from './length/index.js'
+export * as map from './map/index.js'
 export * as negate from './negate/index.js'
 export * as notrailing from './notrailing/index.js'
+export * as or from './or/index.js'
 export * as pickrandom from './pickrandom/index.js'
 export * as populate from './populate/index.js'
+export * as join from './join/index.js'
 export * as print from './print/index.js'
-export * as or from './or/index.js'
 export * as pusheach from './pusheach/index.js'
 export * as recordtoarray from './recordtoarray/index.js'
+export * as push from './push/index.js'
 export * as removeattribute from './removeattribute/index.js'
 export * as removeclass from './removeclass/index.js'
-export * as push from './push/index.js'
 export * as renameproperty from './renameproperty/index.js'
 export * as replace from './replace/index.js'
 export * as select from './select/index.js'
-export * as set from './set/index.js'
 export * as setattribute from './setattribute/index.js'
+export * as set from './set/index.js'
 export * as setproperty from './setproperty/index.js'
 export * as sorton from './sorton/index.js'
 export * as split from './split/index.js'
@@ -48,5 +48,5 @@ export * as torecord from './torecord/index.js'
 export * as toref from './toref/index.js'
 export * as tostring from './tostring/index.js'
 export * as totext from './totext/index.js'
-export * as trim from './trim/index.js'
 export * as transformselected from './transformselected/index.js'
+export * as trim from './trim/index.js'

package/agnostic/html/hyper-json/smart-tags/isolated/index.d.ts

@@ -1,13 +1,13 @@
 export * as any from './any/index.js'
-export * as boolean from './boolean/index.js'
 export * as array from './array/index.js'
+export * as boolean from './boolean/index.js'
 export * as element from './element/index.js'
 export * as get from './get/index.js'
 export * as guess from './guess/index.js'
 export * as null from './null/index.js'
 export * as nodelist from './nodelist/index.js'
 export * as number from './number/index.js'
-export * as record from './record/index.js'
 export * as ref from './ref/index.js'
+export * as record from './record/index.js'
 export * as string from './string/index.js'
 export * as text from './text/index.js'

package/agnostic/html/hyper-json/smart-tags/isolated/index.js

@@ -1,13 +1,13 @@
 export * as any from './any/index.js'
-export * as boolean from './boolean/index.js'
 export * as array from './array/index.js'
+export * as boolean from './boolean/index.js'
 export * as element from './element/index.js'
 export * as get from './get/index.js'
 export * as guess from './guess/index.js'
 export * as null from './null/index.js'
 export * as nodelist from './nodelist/index.js'
 export * as number from './number/index.js'
-export * as record from './record/index.js'
 export * as ref from './ref/index.js'
+export * as record from './record/index.js'
 export * as string from './string/index.js'
 export * as text from './text/index.js'

package/agnostic/html/index.d.ts

@@ -1,8 +1,8 @@
 export * as deepSelect from './deep-select/index.js'
-export * as getNodeAncestors from './get-node-ancestors/index.js'
 export * as getPositionInsideParent from './get-position-inside-parent/index.js'
 export * as hyperJson from './hyper-json/index.js'
 export * as insertNode from './insert-node/index.js'
+export * as getNodeAncestors from './get-node-ancestors/index.js'
 export * as placeholders from './placeholders/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
 export * as selectorToElement from './selector-to-element/index.js'

package/agnostic/html/index.js

@@ -1,8 +1,8 @@
 export * as deepSelect from './deep-select/index.js'
-export * as getNodeAncestors from './get-node-ancestors/index.js'
 export * as getPositionInsideParent from './get-position-inside-parent/index.js'
 export * as hyperJson from './hyper-json/index.js'
 export * as insertNode from './insert-node/index.js'
+export * as getNodeAncestors from './get-node-ancestors/index.js'
 export * as placeholders from './placeholders/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
 export * as selectorToElement from './selector-to-element/index.js'

package/agnostic/index.d.ts

@@ -1,16 +1,17 @@
 export * as arrays from './arrays/index.js'
 export * as booleans from './booleans/index.js'
-export * as colors from './colors/index.js'
 export * as css from './css/index.js'
 export * as errors from './errors/index.js'
 export * as html from './html/index.js'
-export * as misc from './misc/index.js'
 export * as numbers from './numbers/index.js'
+export * as misc from './misc/index.js'
 export * as objects from './objects/index.js'
+export * as colors from './colors/index.js'
 export * as optim from './optim/index.js'
-export * as random from './random/index.js'
 export * as regexps from './regexps/index.js'
+export * as random from './random/index.js'
 export * as sanitization from './sanitization/index.js'
 export * as strings from './strings/index.js'
-export * as time from './time/index.js'
+export * as subtitles from './subtitles/index.js'
 export * as typescript from './typescript/index.js'
+export * as time from './time/index.js'

package/agnostic/index.js

@@ -1,16 +1,17 @@
 export * as arrays from './arrays/index.js'
 export * as booleans from './booleans/index.js'
-export * as colors from './colors/index.js'
 export * as css from './css/index.js'
 export * as errors from './errors/index.js'
 export * as html from './html/index.js'
-export * as misc from './misc/index.js'
 export * as numbers from './numbers/index.js'
+export * as misc from './misc/index.js'
 export * as objects from './objects/index.js'
+export * as colors from './colors/index.js'
 export * as optim from './optim/index.js'
-export * as random from './random/index.js'
 export * as regexps from './regexps/index.js'
+export * as random from './random/index.js'
 export * as sanitization from './sanitization/index.js'
 export * as strings from './strings/index.js'
-export * as time from './time/index.js'
+export * as subtitles from './subtitles/index.js'
 export * as typescript from './typescript/index.js'
+export * as time from './time/index.js'

package/agnostic/misc/index.d.ts

@@ -1,12 +1,12 @@
 export * as assert from './assert/index.js'
-export * as connection from './connection/index.js'
+export * as cast from './cast/index.js'
 export * as crawler from './crawler/index.js'
 export * as crossenv from './crossenv/index.js'
+export * as connection from './connection/index.js'
 export * as dataSize from './data-size/index.js'
 export * as isConstructorFunction from './is-constructor-function/index.js'
 export * as isNullish from './is-nullish/index.js'
-export * as cast from './cast/index.js'
 export * as logs from './logs/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
-export * as normalizeExtension from './normalize-extension/index.js'
 export * as outcome from './outcome/index.js'
+export * as normalizeExtension from './normalize-extension/index.js'

package/agnostic/misc/index.js

@@ -1,12 +1,12 @@
 export * as assert from './assert/index.js'
-export * as connection from './connection/index.js'
+export * as cast from './cast/index.js'
 export * as crawler from './crawler/index.js'
 export * as crossenv from './crossenv/index.js'
+export * as connection from './connection/index.js'
 export * as dataSize from './data-size/index.js'
 export * as isConstructorFunction from './is-constructor-function/index.js'
 export * as isNullish from './is-nullish/index.js'
-export * as cast from './cast/index.js'
 export * as logs from './logs/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
-export * as normalizeExtension from './normalize-extension/index.js'
 export * as outcome from './outcome/index.js'
+export * as normalizeExtension from './normalize-extension/index.js'

package/agnostic/numbers/index.d.ts

@@ -1,6 +1,6 @@
 export * as absoluteModulo from './absolute-modulo/index.js'
-export * as clamp from './clamp/index.js'
 export * as approximateRational from './approximate-rational/index.js'
+export * as clamp from './clamp/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
 export * as interpolate from './interpolate/index.js'
 export * as round from './round/index.js'

package/agnostic/numbers/index.js

@@ -1,6 +1,6 @@
 export * as absoluteModulo from './absolute-modulo/index.js'
-export * as clamp from './clamp/index.js'
 export * as approximateRational from './approximate-rational/index.js'
+export * as clamp from './clamp/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
 export * as interpolate from './interpolate/index.js'
 export * as round from './round/index.js'

package/agnostic/objects/index.d.ts

@@ -1,9 +1,9 @@
 export * as deepGetProperty from './deep-get-property/index.js'
-export * as enums from './enums/index.js'
 export * as flattenGetters from './flatten-getters/index.js'
-export * as isRecord from './is-record/index.js'
 export * as isObject from './is-object/index.js'
 export * as recordFormat from './record-format/index.js'
+export * as isRecord from './is-record/index.js'
 export * as recordMap from './record-map/index.js'
+export * as enums from './enums/index.js'
 export * as sortKeys from './sort-keys/index.js'
 export * as validation from './validation/index.js'

package/agnostic/objects/index.js

@@ -1,9 +1,9 @@
 export * as deepGetProperty from './deep-get-property/index.js'
-export * as enums from './enums/index.js'
 export * as flattenGetters from './flatten-getters/index.js'
-export * as isRecord from './is-record/index.js'
 export * as isObject from './is-object/index.js'
 export * as recordFormat from './record-format/index.js'
+export * as isRecord from './is-record/index.js'
 export * as recordMap from './record-map/index.js'
+export * as enums from './enums/index.js'
 export * as sortKeys from './sort-keys/index.js'
 export * as validation from './validation/index.js'

package/agnostic/strings/index.d.ts

@@ -1,8 +1,8 @@
 export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
 export * as normalizeIndent from './normalize-indent/index.js'
+export * as replaceAll from './replace-all/index.js'
 export * as parseTable from './parse-table/index.js'
 export * as splitTrim from './split-trim/index.js'
 export * as toAlphanum from './to-alphanum/index.js'
 export * as trim from './trim/index.js'
-export * as replaceAll from './replace-all/index.js'

package/agnostic/strings/index.js

@@ -1,8 +1,8 @@
 export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
 export * as normalizeIndent from './normalize-indent/index.js'
+export * as replaceAll from './replace-all/index.js'
 export * as parseTable from './parse-table/index.js'
 export * as splitTrim from './split-trim/index.js'
 export * as toAlphanum from './to-alphanum/index.js'
 export * as trim from './trim/index.js'
-export * as replaceAll from './replace-all/index.js'

package/agnostic/subtitles/index.d.ts

@@ -0,0 +1,2 @@
+export * as parseSrt from './parse-srt/index.js'
+export * as srtTimecodeToMs from './srt-timecode-to-ms/index.js'

package/agnostic/subtitles/index.js

@@ -0,0 +1,2 @@
+export * as parseSrt from './parse-srt/index.js'
+export * as srtTimecodeToMs from './srt-timecode-to-ms/index.js'

package/agnostic/subtitles/parse-srt/index.d.ts

@@ -0,0 +1,17 @@
+import type { SrtCue } from './types.js';
+/**
+ * Parses an SRT subtitle file.
+ *
+ * Cues are delimited by blank lines, which is the format's only structural marker —
+ * reading line by line instead would leave the parser guessing, and a cue whose text
+ * is a bare number (`1914`) would read as the next cue's id.
+ *
+ * Line endings are normalised first, so a CRLF file — the format's de facto norm —
+ * parses like any other.
+ *
+ * @param rawSrt - The file's contents.
+ * @returns The cues that parsed, in file order. A block missing a usable timecode or
+ * any text is dropped rather than returned half-built, so the result never holds a
+ * cue a consumer has to check.
+ */
+export declare function parseSrt(rawSrt: string): SrtCue[];

package/agnostic/subtitles/parse-srt/index.js

@@ -0,0 +1,67 @@
+import { srtTimecodeToMs } from '../srt-timecode-to-ms/index.js';
+/** Splits on the blank line that separates two cues, whatever the line endings were. */
+const cueSeparatorRegexp = /\n[ \t]*\n/v;
+const idRegexp = /^\d+$/v;
+const cueArrow = '-->';
+/** Reads `hh:mm:ss,mmm --> hh:mm:ss,mmm`, or nothing. */
+function parseTimecodeLine(line) {
+    if (!line.includes(cueArrow))
+        return null;
+    const [rawStart = '', rawEnd = ''] = line.split(cueArrow);
+    const start = srtTimecodeToMs(rawStart);
+    const end = srtTimecodeToMs(rawEnd);
+    if (start === null || end === null)
+        return null;
+    return { start, end };
+}
+/** Turns one blank-line-delimited block into a cue, or drops it. */
+function parseCue(block, fallbackId) {
+    const lines = block.split('\n');
+    const firstLine = lines[0];
+    if (firstLine === undefined)
+        return null;
+    // The id line is optional: some writers leave it out, and skipping it here is what
+    // lets the timecode line be found either way.
+    const hasIdLine = idRegexp.test(firstLine.trim());
+    const id = hasIdLine ? parseInt(firstLine.trim(), 10) : fallbackId;
+    const rest = hasIdLine ? lines.slice(1) : lines;
+    const timecodeLine = rest[0];
+    if (timecodeLine === undefined)
+        return null;
+    const timecode = parseTimecodeLine(timecodeLine);
+    if (timecode === null)
+        return null;
+    const content = rest.slice(1).join('\n').trim();
+    if (content === '')
+        return null;
+    return { id, ...timecode, content };
+}
+/**
+ * Parses an SRT subtitle file.
+ *
+ * Cues are delimited by blank lines, which is the format's only structural marker —
+ * reading line by line instead would leave the parser guessing, and a cue whose text
+ * is a bare number (`1914`) would read as the next cue's id.
+ *
+ * Line endings are normalised first, so a CRLF file — the format's de facto norm —
+ * parses like any other.
+ *
+ * @param rawSrt - The file's contents.
+ * @returns The cues that parsed, in file order. A block missing a usable timecode or
+ * any text is dropped rather than returned half-built, so the result never holds a
+ * cue a consumer has to check.
+ */
+export function parseSrt(rawSrt) {
+    const cues = [];
+    const blocks = rawSrt
+        .replace(/\r\n?/gv, '\n')
+        .split(cueSeparatorRegexp);
+    for (const block of blocks) {
+        if (block.trim() === '')
+            continue;
+        const cue = parseCue(block, cues.length + 1);
+        if (cue !== null)
+            cues.push(cue);
+    }
+    return cues;
+}

package/agnostic/subtitles/parse-srt/index.test.d.ts

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

package/agnostic/subtitles/parse-srt/index.test.js

@@ -0,0 +1,94 @@
+import { describe, it, expect } from 'vitest';
+import { parseSrt } from './index.js';
+const twoCues = `1
+00:00:01,000 --> 00:00:02,000
+Bonjour
+
+2
+00:00:03,000 --> 00:00:04,000
+Au revoir`;
+describe('parseSrt', () => {
+    it('reads a cue whole', () => {
+        expect(parseSrt(twoCues)[0]).toMatchObject({
+            id: 1,
+            start: 1000,
+            end: 2000,
+            content: 'Bonjour'
+        });
+    });
+    it('keeps the file order', () => {
+        expect(parseSrt(twoCues).map(cue => cue.content)).toEqual(['Bonjour', 'Au revoir']);
+    });
+    describe('line endings', () => {
+        it('parses a CRLF file, the format de facto norm', () => {
+            expect(parseSrt(twoCues.replace(/\n/g, '\r\n'))).toHaveLength(2);
+        });
+        it('parses a lone-CR file', () => {
+            expect(parseSrt(twoCues.replace(/\n/g, '\r'))).toHaveLength(2);
+        });
+    });
+    describe('block delimiting', () => {
+        it('reads a bare number as text, not as the next cue id', () => {
+            const cues = parseSrt(`1
+00:00:01,000 --> 00:00:02,000
+1914
+
+2
+00:00:03,000 --> 00:00:04,000
+La guerre`);
+            expect(cues).toHaveLength(2);
+            expect(cues[0]?.content).toBe('1914');
+        });
+        it('keeps the newlines inside a multi-line cue', () => {
+            const cues = parseSrt(`1
+00:00:01,000 --> 00:00:02,000
+Première ligne
+Deuxième ligne`);
+            expect(cues[0]?.content).toBe('Première ligne\nDeuxième ligne');
+        });
+        it('tolerates a separator line holding spaces', () => {
+            expect(parseSrt(twoCues.replace('\n\n', '\n   \n'))).toHaveLength(2);
+        });
+        it('tolerates blank lines around the file', () => {
+            expect(parseSrt(`\n\n${twoCues}\n\n`)).toHaveLength(2);
+        });
+    });
+    describe('the id line', () => {
+        it('keeps the number written in the file, however it is numbered', () => {
+            const cues = parseSrt(`57
+00:00:01,000 --> 00:00:02,000
+Bonjour`);
+            expect(cues[0]?.id).toBe(57);
+        });
+        it('numbers a cue by its position when the file leaves the id out', () => {
+            const cues = parseSrt(`00:00:01,000 --> 00:00:02,000
+Bonjour
+
+00:00:03,000 --> 00:00:04,000
+Au revoir`);
+            expect(cues.map(cue => cue.id)).toEqual([1, 2]);
+        });
+    });
+    describe('dropping what cannot be read', () => {
+        it('drops a block whose timecode is malformed', () => {
+            const cues = parseSrt(`1
+00:00:01,000 -> 00:00:02,000
+Bonjour
+
+2
+00:00:03,000 --> 00:00:04,000
+Au revoir`);
+            expect(cues.map(cue => cue.content)).toEqual(['Au revoir']);
+        });
+        it('drops a block with a timecode but no text', () => {
+            expect(parseSrt(`1
+00:00:01,000 --> 00:00:02,000`)).toEqual([]);
+        });
+        it('returns nothing at all for an empty file', () => {
+            expect(parseSrt('')).toEqual([]);
+        });
+        it('returns nothing for a file that is not SRT', () => {
+            expect(parseSrt('<!doctype html><title>404</title>')).toEqual([]);
+        });
+    });
+});

package/agnostic/subtitles/parse-srt/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * One subtitle, complete.
+ *
+ * Every field is required: a cue missing its timecode or its text is not a cue the
+ * parser should be handing out, and a consumer shouldn't have to defend itself
+ * against the parser's own intermediate states.
+ *
+ * @property id - The cue number as written in the file. Kept because a consumer may
+ * want to show it, but it carries no meaning for the parser: a concatenated or
+ * hand-edited file numbers its cues however it likes. Order and identity come from
+ * the position in the returned array.
+ * @property start - Start position in milliseconds.
+ * @property end - End position in milliseconds.
+ * @property content - The cue's text, newlines preserved, surrounding whitespace
+ * trimmed.
+ */
+export type SrtCue = {
+    id: number;
+    start: number;
+    end: number;
+    content: string;
+};

package/agnostic/subtitles/parse-srt/types.js

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

package/agnostic/subtitles/srt-timecode-to-ms/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Converts an SRT timecode to milliseconds.
+ *
+ * @param timecode - A timecode in `hh:mm:ss,mmm` form. Surrounding whitespace is
+ * tolerated; anything else is not a timecode.
+ * @returns The position in milliseconds, or `null` when `timecode` doesn't parse —
+ * a caller reading a subtitle file needs to tell a malformed line from one that
+ * legitimately sits at zero.
+ *
+ * @example
+ * srtTimecodeToMs('00:00:01,500') // 1500
+ * srtTimecodeToMs('00:00:01,5')   // 1500, not 1005
+ */
+export declare function srtTimecodeToMs(timecode: string): number | null;