@aim-packages/subtitle 0.3.2 → 0.4.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[];
+
      /**
       * 清理时间显示格式，移除毫秒部分和多余的小时前缀
       *
@@ -662,6 +675,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 +852,8 @@ declare function chunkArrayStrings(strings: string[], characterLimit: number): s
                   convertTimeToAssFormat,
                   convertHexColorToFFmpegFormat,
                   chunkArrayStrings,
+                  chunkText,
+                  smartChunks,
                   chunkSegmentStringsWithIndex,
                   consolidateSegments,
                   joinAimSegmentItems,