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

Language as Infrastructure research note experiment writeup candidate score 18 .md

Full Public Reader

Cross-Script Bridge JavaScript SDK

Real-time translation between N'Ko (ߒߞߏ), Arabic (العربية), and Latin scripts.

Installation

bash
npm install cross-script-bridge

Quick 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'ko

Browser 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

ScriptCodeDirectionSample
N'Ko`nko`RTLߒߞߏ
Arabic`arabic`RTLالعربية
Latin`latin`LTRHello

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