@aim-packages/subtitle 0.3.2 → 0.5.0

package/dist/index.d.ts

@@ -67,6 +67,12 @@ export declare interface AimSegments {
 
 declare function assToAimSegments(text: string): Promise<AimSegments[]>;
 
+export declare type Chunk = {
+    content: string;
+    index: number;
+    count: number;
+};
+
 /**
  * 将字符串数组按字符限制分块
  *
@@ -107,6 +113,13 @@ declare function chunkArrayStrings(strings: string[], characterLimit: number): s
          indexResult: number[];
      };
 
+     /**
+      * Simple character-based chunker with overlap (mirrors main/embedding/chunker)
+      * - maxChars: max characters per chunk
+      * - overlap: overlapping characters between adjacent chunks to keep context
+      */
+     declare function chunkText(text: string, maxChars?: number, overlap?: number): Chunk[];
+
      /**
       * 清理时间显示格式，移除毫秒部分和多余的小时前缀
       *
@@ -497,6 +510,32 @@ declare function chunkArrayStrings(strings: string[], characterLimit: number): s
            */
           declare function padNumber(num: number, length?: number): string;
 
+          /**
+           * Parakeet 转写结果的类型定义
+           *
+           * Parakeet 是 Apple 提供的离线语音转写模型，输出的 JSON 包含：
+           * - 全文 text
+           * - 每个 sub-word token 的时间戳和置信度
+           */
+          declare interface ParakeetResult {
+              confidence: number;
+              duration: number;
+              processingTime: number;
+              rtfx: number;
+              text: string;
+              tokenTimings: Array<ParakeetToken>;
+          }
+
+          declare function parakeetToAimSegments(json: ParakeetResult): Promise<AimSegments[]>;
+
+          declare interface ParakeetToken {
+              confidence: number;
+              endTime: number;
+              startTime: number;
+              token: string;
+              tokenId: number;
+          }
+
           /**
            * Callback passed as the `onParse` callback to a parser
            *
@@ -556,6 +595,7 @@ declare function chunkArrayStrings(strings: string[], characterLimit: number): s
                   tingwuToAimSegments,
                   openaiToAimSegments,
                   whisperJsonToAimSegments,
+                  parakeetToAimSegments,
                   detectSubtitleType,
                   parseSubtitle,
                   create as createWhisperStreamParser,
@@ -662,6 +702,11 @@ declare function chunkArrayStrings(strings: string[], characterLimit: number): s
            */
           declare function shiftAimSegmentItems(segment: AimSegments, count?: number): AimSegments | undefined;
 
+          /**
+           * Optional paragraph-aware splitter: split by paragraph/sentence first, then pack.
+           */
+          declare function smartChunks(text: string, maxChars?: number, overlap?: number): Chunk[];
+
           export declare interface SpeakerData {
               settings: Record<string, {
                   spk: string;
@@ -834,6 +879,8 @@ declare function chunkArrayStrings(strings: string[], characterLimit: number): s
                   convertTimeToAssFormat,
                   convertHexColorToFFmpegFormat,
                   chunkArrayStrings,
+                  chunkText,
+                  smartChunks,
                   chunkSegmentStringsWithIndex,
                   consolidateSegments,
                   joinAimSegmentItems,