Class AstericsGridProcessor

Hierarchy (View Summary)

BaseProcessor
- AstericsGridProcessor

Index

Constructors

Properties

Methods

addAudioToElement addToExtractedMap createAudioEnhancedGridFile extractStringsWithMetadata extractStringsWithMetadataGeneric extractTexts filterPageButtons generateTranslatedDownload generateTranslatedDownloadGeneric generateTranslatedOutputPath getElementIds hasAudioRecording loadIntoTree processTexts saveFromTree shouldFilterButton validate?

Constructors

constructor

new AstericsGridProcessor(
options?: ProcessorOptions & { loadAudio?: boolean },
): AstericsGridProcessor
Parameters
- options: ProcessorOptions & { loadAudio?: boolean } = {}
Returns AstericsGridProcessor
Overrides BaseProcessor.constructor
- Defined in src/processors/astericsGridProcessor.ts:720

Properties

`Protected`options

options: ProcessorOptions

Methods

addAudioToElement

addAudioToElement(
    filePath: string,
    elementId: string,
    audioData: Buffer,
    metadata?: string,
): void
Add audio recording to a specific grid element
Parameters
- filePath: string
- elementId: string
- audioData: Buffer
- Optionalmetadata: string
Returns void
- Defined in src/processors/astericsGridProcessor.ts:1601

`Protected`addToExtractedMap

addToExtractedMap(
    extractedMap: Map<string, ExtractedString>,
    key: string,
    originalString: string,
    vocabLocation: VocabLocation,
): void
Helper method to add extracted strings to the map, handling duplicates
Parameters
- extractedMap: Map<string, ExtractedString>
  Map to store extracted strings
- key: string
  Lowercase key for deduplication
- originalString: string
  Original string with proper casing
- vocabLocation: VocabLocation
  Metadata about where the string was found
Returns void
Inherited from BaseProcessor.addToExtractedMap
- Defined in src/core/baseProcessor.ts:377

createAudioEnhancedGridFile

createAudioEnhancedGridFile(
    sourceFilePath: string,
    targetFilePath: string,
    audioMappings: Map<string, { audioData: Buffer; metadata?: string }>,
): void
Create a copy of the grid file with audio recordings added
Parameters
- sourceFilePath: string
- targetFilePath: string
- audioMappings: Map<string, { audioData: Buffer; metadata?: string }>
Returns void
- Defined in src/processors/astericsGridProcessor.ts:1664

extractStringsWithMetadata

extractStringsWithMetadata(filePath: string): Promise<ExtractStringsResult>
Extract strings with metadata for aac-tools-platform compatibility Uses the generic implementation from BaseProcessor
Parameters
- filePath: string
Returns Promise<ExtractStringsResult>
Overrides BaseProcessor.extractStringsWithMetadata
- Defined in src/processors/astericsGridProcessor.ts:1747

`Protected`extractStringsWithMetadataGeneric

extractStringsWithMetadataGeneric(
filePath: string,
): Promise<ExtractStringsResult>
Generic implementation for extracting strings with metadata Can be used by any processor that doesn't need format-specific logic
Parameters
- filePath: string
  Path to the AAC file
Returns Promise<ExtractStringsResult>
Promise with extracted strings and metadata
Inherited from BaseProcessor.extractStringsWithMetadataGeneric
- Defined in src/core/baseProcessor.ts:254

extractTexts

extractTexts(filePathOrBuffer: string | Buffer): string[]
Parameters
- filePathOrBuffer: string | Buffer
Returns string[]
Overrides BaseProcessor.extractTexts
- Defined in src/processors/astericsGridProcessor.ts:725

`Protected`filterPageButtons

filterPageButtons(buttons: AACButton[]): AACButton[]
Parameters
- buttons: AACButton[]
Returns AACButton[]
Inherited from BaseProcessor.filterPageButtons
- Defined in src/core/baseProcessor.ts:244

generateTranslatedDownload

generateTranslatedDownload(
    filePath: string,
    translatedStrings: TranslatedString[],
    sourceStrings: SourceString[],
): Promise<string>
Generate translated download for aac-tools-platform compatibility Uses the generic implementation from BaseProcessor
Parameters
- filePath: string
- translatedStrings: TranslatedString[]
- sourceStrings: SourceString[]
Returns Promise<string>
Overrides BaseProcessor.generateTranslatedDownload
- Defined in src/processors/astericsGridProcessor.ts:1755

`Protected`generateTranslatedDownloadGeneric

generateTranslatedDownloadGeneric(
    filePath: string,
    translatedStrings: TranslatedString[],
    sourceStrings: SourceString[],
): Promise<string>
Generic implementation for generating translated downloads Can be used by any processor that doesn't need format-specific logic
Parameters
- filePath: string
  Path to the original AAC file
- translatedStrings: TranslatedString[]
  Array of translated string data
- sourceStrings: SourceString[]
  Array of source string data
Returns Promise<string>
Promise with path to the generated translated file
Inherited from BaseProcessor.generateTranslatedDownloadGeneric
- Defined in src/core/baseProcessor.ts:331

`Protected`generateTranslatedOutputPath

generateTranslatedOutputPath(filePath: string): string
Generate output path for translated file based on input file extension
Parameters
- filePath: string
  Original file path
Returns string
Path for the translated output file
Inherited from BaseProcessor.generateTranslatedOutputPath
- Defined in src/core/baseProcessor.ts:401

getElementIds

getElementIds(filePathOrBuffer: string | Buffer): string[]
Extract all element IDs from the grid file for audio mapping
Parameters
- filePathOrBuffer: string | Buffer
Returns string[]
- Defined in src/processors/astericsGridProcessor.ts:1686

hasAudioRecording

hasAudioRecording(filePathOrBuffer: string | Buffer, elementId: string): boolean
Check if an element has audio recording
Parameters
- filePathOrBuffer: string | Buffer
- elementId: string
Returns boolean
- Defined in src/processors/astericsGridProcessor.ts:1716

loadIntoTree

loadIntoTree(filePathOrBuffer: string | Buffer): AACTree
Parameters
- filePathOrBuffer: string | Buffer
Returns AACTree
Overrides BaseProcessor.loadIntoTree
- Defined in src/processors/astericsGridProcessor.ts:838

processTexts

processTexts(
    filePathOrBuffer: string | Buffer,
    translations: Map<string, string>,
    outputPath: string,
): Buffer
Parameters
- filePathOrBuffer: string | Buffer
- translations: Map<string, string>
- outputPath: string
Returns Buffer
Overrides BaseProcessor.processTexts
- Defined in src/processors/astericsGridProcessor.ts:1246

saveFromTree

saveFromTree(tree: AACTree, outputPath: string): void
Parameters
- tree: AACTree
- outputPath: string
Returns void
Overrides BaseProcessor.saveFromTree
- Defined in src/processors/astericsGridProcessor.ts:1388

`Protected`shouldFilterButton

shouldFilterButton(button: AACButton): boolean
Parameters
- button: AACButton
Returns boolean
Inherited from BaseProcessor.shouldFilterButton
- Defined in src/core/baseProcessor.ts:170

`Optional`validate

validate?(filePath: string): Promise<ValidationResult>
Parameters
- filePath: string
Returns Promise<ValidationResult>
Inherited from BaseProcessor.validate
- Defined in src/core/baseProcessor.ts:144

Class AstericsGridProcessor

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns AstericsGridProcessor

Properties

Protectedoptions

Methods

addAudioToElement

Parameters

Returns void

ProtectedaddToExtractedMap

Parameters

Returns void

createAudioEnhancedGridFile

Parameters

Returns void

extractStringsWithMetadata

Parameters

Returns Promise<ExtractStringsResult>

ProtectedextractStringsWithMetadataGeneric

Parameters

Returns Promise<ExtractStringsResult>

extractTexts

Parameters

Returns string[]

ProtectedfilterPageButtons

Parameters

Returns AACButton[]

generateTranslatedDownload

Parameters

Returns Promise<string>

ProtectedgenerateTranslatedDownloadGeneric

Parameters

Returns Promise<string>

ProtectedgenerateTranslatedOutputPath

Parameters

Returns string

getElementIds

Parameters

Returns string[]

hasAudioRecording

Parameters

Returns boolean

loadIntoTree

Parameters

Returns AACTree

processTexts

Parameters

Returns Buffer

saveFromTree

Parameters

Returns void

ProtectedshouldFilterButton

Parameters

Returns boolean

Optionalvalidate

Parameters

Returns Promise<ValidationResult>

Settings

On This Page

`Protected`options

`Protected`addToExtractedMap

`Protected`extractStringsWithMetadataGeneric

`Protected`filterPageButtons

`Protected`generateTranslatedDownloadGeneric

`Protected`generateTranslatedOutputPath

`Protected`shouldFilterButton

`Optional`validate