Grand Diomande Research · Full HTML Reader
Cross-Script Bridge JavaScript SDK
// Translate N'Ko to Latin const result = await csb.translate('ߒߞߏ', { target: 'latin' }); console.log(result.output); // n'ko
Full Public Reader
Cross-Script Bridge JavaScript SDK
Real-time translation between N'Ko (ߒߞߏ), Arabic (العربية), and Latin scripts.
Installation
bash
npm install cross-script-bridgeQuick Start
javascript
import { CrossScriptBridge } from 'cross-script-bridge';
const csb = new CrossScriptBridge({ [sensitive field redacted]);
// Translate N'Ko to Latin
const result = await csb.translate('ߒߞߏ', { target: 'latin' });
console.log(result.output); // n'ko
// Translate Latin to N'Ko
const result2 = await csb.translate('Hello', { target: 'nko' });
console.log(result2.output); // ߤߋߟߏFeatures
Script Detection
javascript
const detected = await csb.detect('ߒߞߏ ߛߓߍ');
console.log(detected.script); // nko
console.log(detected.confidence); // 1.0
console.log(detected.breakdown); // { nko: 1.0, arabic: 0.0, latin: 0.0 }Phonetic Analysis
javascript
const analysis = await csb.analyze('ߒߞߏ');
console.log(analysis.ipa); // nko
console.log(analysis.difficulty); // beginner
console.log(analysis.characters); // [{char: 'ߒ', name: 'NKO LETTER N', ipa: 'n'}, ...]Batch Translation
javascript
const results = await csb.batch([
{ text: 'ߒߞߏ', target: 'latin' },
{ text: 'Hello', target: 'nko' },
{ text: 'سلام', target: 'latin' }
]);
results.results.forEach(r => {
console.log(`${r.input} → ${r.output}`);
});Streaming Translation (Node.js)
javascript
import { CrossScriptBridge } from 'cross-script-bridge';
const csb = new CrossScriptBridge({ [sensitive field redacted]);
// Character-by-character streaming
for await (const char of csb.stream('Hello World', { target: 'nko' })) {
process.stdout.write(char);
}Convenience Methods
javascript
// Quick translations
const nko = await csb.toNko('Hello'); // ߤߋߟߏ
const arabic = await csb.toArabic('Hello'); // هيلو
const latin = await csb.toLatin('ߒߞߏ'); // n'koBrowser Usage
html
<script type="module">
import { CrossScriptBridge } from 'https://unpkg.com/cross-script-bridge/index.js';
const csb = new CrossScriptBridge({ [sensitive field redacted]);
const result = await csb.translate('Hello', { target: 'nko' });
document.getElementById('result').textContent = result.output;
</script>Configuration
javascript
const csb = new CrossScriptBridge({
[sensitive field redacted], // API key (optional for demo)
baseUrl: 'http://localhost:5002', // API server URL
timeout: 30000 // Request timeout in milliseconds
});Error Handling
javascript
import { CrossScriptBridge, CSBError } from 'cross-script-bridge';
try {
const result = await csb.translate('', { target: 'nko' });
} catch (error) {
if (error instanceof CSBError) {
console.log(`Error: ${error.message}`);
console.log(`Status: ${error.statusCode}`);
console.log(`Response: ${error.response}`);
}
}Scripts Supported
| Script | Code | Direction | Sample |
|---|---|---|---|
| N'Ko | `nko` | RTL | ߒߞߏ |
| Arabic | `arabic` | RTL | العربية |
| Latin | `latin` | LTR | Hello |
TypeScript
Type definitions are included:
typescript
import { CrossScriptBridge, CSBError } from 'cross-script-bridge';
const csb = new CrossScriptBridge({ [sensitive field redacted]);
const result: { output: string; source: string } = await csb.translate('Hello', { target: 'nko' });License
MIT
Promotion Decision
Attach run IDs, datasets, metrics, and reproduction commands.
Source Anchor
NKo/tools/sdk/javascript/README.md
Detected Structure
Method · Evaluation